kate522/wordpress-theme-aksrt
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(admin): replicate reference post-page settings page 1:1

Browse Source 
- rewrite post_list.page schema (JS+PHP 2.0.0) with the reference field set:
  three cover types with option fieldsets (image 20-200% / slide CFS_Module::slide
  full config with nested dependsOn / video 0-200%), hide-time, p_indent,
  breadcrumbs (home-text as switcher), prevnext, authordesc, maxheight slider,
  yiyan block, copyright, button toptext, front/after content, related posts
- migrate share_s to share page basic group and post_rewards_* to users
  features rewards group (runtime keys unchanged)
- remap get_post_page_settings() to reference keys, normalize slide cover
  option, hardcode non-reference runtime flags (reading progress, favorites,
  author card), drop dual-path legacy aliases
- wire slide option into aksrt_render_slider (effect/direction/spaceBetween/
  speed/interval/loop/autoplay/nav/pagination, scale vs fixed-height modes),
  clamp image scale 20-200 and video scale 0-200 with 16:9 fallback,
  wire p_indent container class + CSS, resync frontend-tags fallback and
  FacadeBulk fallback, remap PostMetaBox cover keys
- add post-page reference contract test; update stale cover-height and
  user-features contract tests

Validation: node --test 464/464 pass, audit-admin-contracts errors=0,
vite build ok, build-public-assets ok, php -l clean.
This commit is contained in:
kate522
2026-09-24 16:13:00 +08:00
parent a8060fa71d
commit 66f8bb933d
17 changed files with 797 additions and 267 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/Admin/Schema/SchemaPostList.php
+76 -73
View File
@@ -46,83 +46,83 @@ class SchemaPostList {
'page' => [
'key' => 'page',
'title' => '文章页面',
'version' => '1.0.0',
'version' => '2.0.0',
'option_key' => 'aksrt_settings',
'groups' => [
['key' => 'navigation', 'title' => '文章导航', 'fields' => [
['key' => 'post_reading_progress', 'label' => '阅读进度条', 'type' => 'switch', 'default' => true],
['key' => 'breadcrumbs_single_s', 'label' => '面包屑导航', 'type' => 'switch', 'default' => true],
['key' => 'breadcrumbs_home_text', 'label' => '面包屑首页文字', 'type' => 'input', 'default' => '首页', 'depends_on' => 'breadcrumbs_single_s'],
['key' => 'breadcrumbs_single_text', 'label' => '末项显示「正文」', 'type' => 'switch', 'default' => true, 'depends_on' => 'breadcrumbs_single_s', 'description' => '关闭后末项显示文章标题'],
['key' => 'post_prevnext_s', 'label' => '上一篇/下一篇', 'type' => 'switch', 'default' => true],
['key' => 'post_authordesc_s', 'label' => '作者简介', 'type' => 'switch', 'default' => true],
['key' => 'post_author_card_limit', 'label' => '作者卡文章数', 'type' => 'number', 'default' => 6, 'min' => 0, 'max' => 12],
['key' => 'post_author_card_orderby', 'label' => '作者卡文章排序', 'type' => 'select', 'default' => 'views', 'options' => [
['label' => '浏览量', 'value' => 'views'],
['label' => '发布时间', 'value' => 'date'],
['label' => '更新时间', 'value' => 'modified'],
['label' => '评论数', 'value' => 'comment_count'],
['key' => 'post_page', 'title' => '文章页面', 'fields' => [
['key' => 'article_image_cover', 'label' => '图片封面', 'type' => 'switcher', 'default' => true, 'description' => '允许设置文章页顶部显示封面图'],
['key' => 'article_image_cover_option', 'label' => ' ', 'type' => 'fieldset', 'default' => ['scale' => 35], 'dependsOn' => ['key' => 'article_image_cover', 'value' => true], 'description' => '图片封面配置', 'fields' => [
['key' => 'scale', 'label' => '图片长宽比例', 'type' => 'number', 'default' => 35, 'min' => 20, 'max' => 200, 'step' => 5, 'unit' => '%'],
]],
['key' => 'post_author_card_style', 'label' => '作者卡文章样式', 'type' => 'radio', 'default' => 'card', 'options' => [
['label' => '卡片', 'value' => 'card'],
['key' => 'article_slide_cover', 'label' => '幻灯片封面', 'type' => 'switcher', 'default' => true, 'description' => '允许设置幻灯片为文章封面'],
['key' => 'article_slide_cover_option', 'label' => ' ', 'type' => 'fieldset', 'default' => [
'direction' => 'horizontal', 'loop' => true, 'button' => false, 'pagination' => true, 'effect' => 'slide',
'scale_height' => true, 'scale' => 35, 'auto_height' => false, 'max_height' => 500, 'min_height' => 180,
'pc_height' => 380, 'm_height' => 180, 'spacebetween' => 15, 'speed' => 0, 'autoplay' => true, 'interval' => 4,
], 'dependsOn' => ['key' => 'article_slide_cover', 'value' => true], 'fields' => [
['key' => 'direction', 'label' => '幻灯片方向', 'type' => 'radio', 'default' => 'horizontal', 'options' => [
['label' => '左右切换', 'value' => 'horizontal'],
['label' => '上下切换', 'value' => 'vertical'],
]],
['key' => 'loop', 'label' => '循环切换', 'type' => 'switch', 'default' => true],
['key' => 'button', 'label' => '显示翻页按钮', 'type' => 'switch', 'default' => false],
['key' => 'pagination', 'label' => '显示指示器', 'type' => 'switch', 'default' => true],
['key' => 'effect', 'label' => '切换动画', 'type' => 'select', 'default' => 'slide', 'options' => [
['label' => '滑动', 'value' => 'slide'],
['label' => '淡出淡入', 'value' => 'fade'],
['label' => '3D方块', 'value' => 'cube'],
['label' => '3D滑入', 'value' => 'coverflow'],
['label' => '3D翻转', 'value' => 'flip'],
]],
['key' => 'scale_height', 'label' => '按比例自动高度', 'type' => 'switch', 'default' => true, 'dependsOn' => ['key' => 'direction', 'not' => 'vertical']],
['key' => 'scale', 'label' => '长宽比例', 'type' => 'number', 'default' => 35, 'min' => 10, 'max' => 300, 'step' => 5, 'unit' => '%', 'dependsOn' => ['all' => [['key' => 'direction', 'not' => 'vertical'], ['key' => 'scale_height', 'value' => true]]]],
['key' => 'auto_height', 'label' => '自动高度', 'type' => 'switch', 'default' => false, 'dependsOn' => ['all' => [['key' => 'direction', 'not' => 'vertical'], ['key' => 'scale_height', 'value' => false]]]],
['key' => 'max_height', 'label' => '最大高度', 'type' => 'number', 'default' => 500, 'min' => 120, 'max' => 800, 'step' => 20, 'unit' => 'PX', 'dependsOn' => ['all' => [['key' => 'auto_height', 'value' => true], ['key' => 'direction', 'not' => 'vertical'], ['key' => 'scale_height', 'value' => false]]]],
['key' => 'min_height', 'label' => '最小高度', 'type' => 'number', 'default' => 180, 'min' => 100, 'max' => 500, 'step' => 20, 'unit' => 'PX', 'dependsOn' => ['all' => [['key' => 'auto_height', 'value' => true], ['key' => 'direction', 'not' => 'vertical'], ['key' => 'scale_height', 'value' => false]]]],
['key' => 'pc_height', 'label' => '电脑端高度', 'type' => 'number', 'default' => 380, 'min' => 120, 'max' => 800, 'step' => 20, 'unit' => 'PX'],
['key' => 'm_height', 'label' => '移动端高度', 'type' => 'number', 'default' => 180, 'min' => 100, 'max' => 500, 'step' => 20, 'unit' => 'PX'],
['key' => 'spacebetween', 'label' => '幻灯片间距', 'type' => 'number', 'default' => 15, 'min' => 0, 'max' => 500, 'step' => 5, 'unit' => 'PX'],
['key' => 'speed', 'label' => '切换速度', 'type' => 'number', 'default' => 0, 'min' => 0, 'max' => 3000, 'step' => 100, 'unit' => '毫秒', 'description' => '切换过程的时间(越小越快)，设置为0则为自动模式'],
['key' => 'autoplay', 'label' => '自动播放', 'type' => 'switch', 'default' => true],
['key' => 'interval', 'label' => '停顿时间', 'type' => 'number', 'default' => 4, 'min' => 0, 'max' => 20, 'step' => 1, 'unit' => '秒', 'dependsOn' => ['key' => 'autoplay', 'value' => true], 'description' => '自动切换的时间间隔(越小越快)'],
]],
['key' => 'article_video_cover', 'label' => '视频封面', 'type' => 'switcher', 'default' => true, 'description' => '允许设置视频为文章封面'],
['key' => 'article_video_cover_option', 'label' => ' ', 'type' => 'fieldset', 'default' => ['scale' => 0], 'dependsOn' => ['key' => 'article_video_cover', 'value' => true], 'description' => '视频封面配置', 'fields' => [
['key' => 'scale', 'label' => '固定长宽比例', 'type' => 'number', 'default' => 0, 'min' => 0, 'max' => 200, 'step' => 5, 'unit' => '%', 'description' => '为0则不固定长宽比例'],
]],
['key' => 'post_single_hide_time_s', 'label' => '隐藏时间', 'type' => 'switcher', 'default' => false, 'description' => '隐藏文章的更新及发布时间显示'],
['key' => 'post_p_indent_s', 'label' => '内容段落缩进', 'type' => 'switcher', 'default' => false, 'description' => '开启后文章内容每一个段落首行将向右偏移2个文字距离'],
['key' => 'breadcrumbs_single_s', 'label' => '面包屑导航', 'type' => 'switcher', 'default' => true],
['key' => 'breadcrumbs_home_text', 'label' => '面包屑导航用“首页”替代网站名称', 'type' => 'switcher', 'default' => true, 'dependsOn' => ['key' => 'breadcrumbs_single_s', 'value' => true]],
['key' => 'post_prevnext_s', 'label' => '上一页、下一页版块', 'type' => 'switcher', 'default' => true],
['key' => 'post_authordesc_s', 'label' => '作者信息版块', 'type' => 'switcher', 'default' => true],
['key' => 'article_maxheight_kg', 'label' => '内容高度限制', 'type' => 'switcher', 'default' => false, 'description' => '此处为全局设置，每篇文章可单独设置', 'help' => '全局开关'],
['key' => 'article_maxheight', 'label' => '限制的最大高度', 'type' => 'slider', 'default' => 1000, 'min' => 600, 'max' => 3000, 'step' => 100, 'unit' => 'px', 'dependsOn' => ['key' => 'article_maxheight_kg', 'value' => true], 'description' => '开启后如果文章高度超过设定值则会显示展开阅读全文的按钮。每篇文章可单独开启此功能'],
['key' => 'yiyan_single_content_header', 'label' => '文章内容头部显示一言', 'type' => 'switcher', 'default' => false],
['key' => 'yiyan_single_content_footer', 'label' => '文章内容尾部显示一言', 'type' => 'switcher', 'default' => false],
['key' => 'yiyan_single_box', 'label' => '文章页面下方独立一言版块', 'type' => 'switcher', 'default' => false],
['key' => 'post_copyright_s', 'label' => '版权声明', 'type' => 'switcher', 'default' => true],
['key' => 'post_copyright', 'label' => '版权提示内容', 'type' => 'textarea', 'default' => '文章版权归作者所有，未经允许请勿转载。', 'rows' => 2, 'dependsOn' => ['key' => 'post_copyright_s', 'value' => true], 'description' => '支持HTML代码，请注意代码规范及标签闭合'],
['key' => 'post_button_toptext', 'label' => '文章页脚文案', 'type' => 'input', 'default' => '喜欢就支持一下吧', 'description' => '文章底部打赏、分享按钮上面的文字'],
['key' => 'post_front_content', 'label' => '在文章内容前-插入内容', 'type' => 'textarea', 'default' => '', 'rows' => 3],
['key' => 'post_after_content', 'label' => '在文章内容后-插入内容', 'type' => 'textarea', 'default' => '', 'rows' => 3, 'description' => '在每篇文章顶部和尾部插入内容，可以插入广告或者文章说明等内容。支持HTML代码，请注意代码规范及标签闭合'],
['key' => 'post_related_s', 'label' => '相关文章版块', 'type' => 'switcher', 'default' => true],
['key' => 'post_related_type', 'label' => '显示样式', 'type' => 'image_select', 'default' => 'img', 'dependsOn' => ['key' => 'post_related_s', 'value' => true], 'options' => [
['label' => '图文卡片', 'value' => 'img'],
['label' => '列表', 'value' => 'list'],
['label' => '纯文字', 'value' => 'text'],
]],
['key' => 'related_title', 'label' => '版块标题', 'type' => 'input', 'default' => '相关推荐', 'dependsOn' => ['key' => 'post_related_s', 'value' => true]],
['key' => 'post_related_n', 'label' => '显示数量', 'type' => 'number', 'default' => 6, 'min' => 4, 'max' => 12, 'step' => 2, 'unit' => '篇', 'dependsOn' => ['key' => 'post_related_s', 'value' => true]],
['key' => 'post_related_orderby', 'label' => '排序方式', 'type' => 'select', 'default' => 'views', 'dependsOn' => ['key' => 'post_related_s', 'value' => true], 'options' => [
['label' => '更新时间', 'value' => 'modified'],
['label' => '发布时间', 'value' => 'date'],
['label' => '浏览量', 'value' => 'views'],
['label' => '点赞量', 'value' => 'like'],
['label' => '评论量', 'value' => 'comment_count'],
['label' => '收藏数量', 'value' => 'favorite'],
['label' => '随机', 'value' => 'rand'],
]],
['key' => 'post_single_hide_time_s', 'label' => '隐藏文章时间', 'type' => 'switch', 'default' => false],
]],
['key' => 'cover', 'title' => '封面展示', 'fields' => [
['key' => 'post_article_image_cover', 'label' => '图片封面', 'type' => 'switch', 'default' => true, 'description' => '文章有特色图时自动展示封面'],
['key' => 'post_article_image_cover_scale', 'label' => '封面高度比例(%)', 'type' => 'number', 'default' => 35, 'min' => 10, 'max' => 100],
['key' => 'post_article_slide_cover', 'label' => '幻灯片封面', 'type' => 'switch', 'default' => true, 'description' => '文章有图集时以轮播形式展示封面'],
['key' => 'post_article_video_cover', 'label' => '视频封面', 'type' => 'switch', 'default' => true, 'description' => '文章有视频时以视频播放器作为封面'],
['key' => 'post_article_video_cover_scale', 'label' => '视频封面高度比例(%)', 'type' => 'number', 'default' => 56, 'min' => 20, 'max' => 100],
]],
['key' => 'related', 'title' => '相关推荐', 'fields' => [
['key' => 'post_related_s', 'label' => '显示相关推荐', 'type' => 'switch', 'default' => true],
['key' => 'post_related_type', 'label' => '展示样式', 'type' => 'radio', 'default' => 'img', 'options' => [
['label' => '图文卡片', 'value' => 'img'],
['label' => '列表', 'value' => 'list'],
['label' => '纯文字', 'value' => 'text'],
]],
['key' => 'related_title', 'label' => '推荐标题', 'type' => 'input', 'default' => '相关推荐'],
['key' => 'post_related_n', 'label' => '推荐数量', 'type' => 'number', 'default' => 6, 'min' => 4, 'max' => 12, 'step' => 2],
['key' => 'post_related_orderby', 'label' => '推荐排序', 'type' => 'select', 'default' => 'views', 'options' => [
['label' => '更新时间', 'value' => 'modified'],
['label' => '发布时间', 'value' => 'date'],
['label' => '浏览量', 'value' => 'views'],
['label' => '点赞量', 'value' => 'like'],
['label' => '评论量', 'value' => 'comment_count'],
['label' => '收藏数量', 'value' => 'favorite'],
['label' => '随机', 'value' => 'rand'],
]],
]],
['key' => 'interactions', 'title' => '互动功能', 'fields' => [
['key' => 'post_favorite_enabled', 'label' => '收藏', 'type' => 'switch', 'default' => true],
['key' => 'share_s', 'label' => '分享按钮', 'type' => 'switch', 'default' => true],
['key' => 'post_copyright_enabled', 'label' => '版权信息', 'type' => 'switch', 'default' => true],
['key' => 'post_copyright_text', 'label' => '版权默认文案', 'type' => 'textarea', 'default' => '', 'description' => '留空则自动生成"本文由 XX 原创发布"'],
['key' => 'post_wechat_share', 'label' => '微信分享', 'type' => 'switch', 'default' => false],
['key' => 'post_rewards_s', 'label' => '用户打赏', 'type' => 'switch', 'default' => false],
['key' => 'post_rewards_text', 'label' => '打赏按钮文案', 'type' => 'input', 'default' => '赞赏'],
['key' => 'post_rewards_amounts', 'label' => '快捷金额', 'type' => 'input', 'default' => '5,10,20,50,100', 'description' => '英文逗号分隔，赞赏直接进入作者站内余额'],
['key' => 'post_rewards_custom', 'label' => '允许自定义金额', 'type' => 'switch', 'default' => true],
['key' => 'post_rewards_min', 'label' => '最低金额', 'type' => 'input', 'sanitize_type' => 'money_decimal', 'default' => '1.00', 'min' => 0.01, 'max' => 1000, 'step' => 0.01],
['key' => 'post_rewards_max', 'label' => '最高金额', 'type' => 'input', 'sanitize_type' => 'money_decimal', 'default' => '1000.00', 'min' => 1, 'max' => 100000, 'step' => 0.01],
['key' => 'post_button_toptext', 'label' => '按钮上方文案', 'type' => 'input', 'default' => '喜欢就支持一下吧'],
]],
['key' => 'content', 'title' => '内容处理', 'fields' => [
['key' => 'post_p_indent', 'label' => '段落缩进', 'type' => 'switch', 'default' => false],
['key' => 'post_maxheight_kg', 'label' => '内容高度限制', 'type' => 'switch', 'default' => false],
['key' => 'post_maxheight', 'label' => '最大高度', 'type' => 'number', 'default' => 1000, 'min' => 600, 'max' => 3000],
['key' => 'post_front_content', 'label' => '文章头部内容', 'type' => 'textarea', 'default' => ''],
['key' => 'post_after_content', 'label' => '文章底部内容', 'type' => 'textarea', 'default' => ''],
]],
['key' => 'yiyan', 'title' => '一言', 'fields' => [
['key' => 'post_yiyan_header', 'label' => '文章头部一言', 'type' => 'switch', 'default' => false],
['key' => 'post_yiyan_footer', 'label' => '文章底部一言', 'type' => 'switch', 'default' => false],
['key' => 'post_yiyan_box', 'label' => '一言盒子', 'type' => 'switch', 'default' => false],
]],
['key' => 'meta', 'title' => 'Meta设置', 'fields' => [
['key' => 'post_views_s', 'label' => '浏览统计', 'type' => 'switch', 'default' => true],
]],
],
],
@@ -286,7 +286,10 @@ class SchemaPostList {
'version' => '1.0.0',
'option_key' => 'aksrt_settings',
'groups' => [
['key' => 'basic', 'title' => '分享设置', 'fields' => [
['key' => 'basic', 'title' => '分享按钮', 'fields' => [
['key' => 'share_s', 'label' => '分享按钮', 'type' => 'switcher', 'default' => true, 'help' => '关闭后，在文章页面将不显示分享按钮，论坛及商城不受影响'],
]],
['key' => 'wechat', 'title' => '微信分享', 'fields' => [
['key' => 'share_wechat_s', 'label' => '微信分享', 'type' => 'switch', 'default' => false],
['key' => 'share_wechat_appid', 'label' => 'AppID', 'type' => 'input', 'default' => ''],
['key' => 'share_wechat_app_secret', 'label' => 'AppSecret', 'type' => 'input', 'default' => ''],
src/Admin/Schema/SchemaUsers.php
+8
View File
@@ -525,6 +525,14 @@ class SchemaUsers {
['key' => 'user_cover_img', 'label' => '用户默认封面', 'type' => 'media', 'default' => get_theme_file_uri('assets/img/user_t.jpg'), 'help' => '建议尺寸 1000×400；用户未设置封面时显示此图。'],
['key' => 'user_desc_std', 'label' => '用户默认签名', 'type' => 'input', 'default' => '这家伙很懒，什么都没有写...', 'help' => '用户未设置个人简介时显示的默认文案。'],
]],
['key' => 'rewards', 'title' => '打赏', 'fields' => [
['key' => 'post_rewards_s', 'label' => '用户打赏功能', 'type' => 'switcher', 'default' => true, 'help' => '开启后，登录用户可使用站内余额赞赏作者，金额直接进入作者余额。'],
['key' => 'post_rewards_text', 'label' => '打赏按钮文案', 'type' => 'input', 'default' => '赞赏', 'dependsOn' => ['key' => 'post_rewards_s', 'value' => true], 'help' => '自定义打赏按钮文字'],
['key' => 'post_rewards_amounts', 'label' => '快捷金额', 'type' => 'input', 'default' => '5,10,20,50,100', 'dependsOn' => ['key' => 'post_rewards_s', 'value' => true], 'help' => '使用英文逗号分隔'],
['key' => 'post_rewards_custom', 'label' => '允许自定义金额', 'type' => 'switcher', 'default' => true, 'dependsOn' => ['key' => 'post_rewards_s', 'value' => true]],
['key' => 'post_rewards_min', 'label' => '最低金额', 'type' => 'input', 'sanitize_type' => 'money_decimal', 'default' => '1.00', 'min' => 0.01, 'max' => 1000, 'step' => 0.01, 'dependsOn' => ['key' => 'post_rewards_s', 'value' => true]],
['key' => 'post_rewards_max', 'label' => '最高金额', 'type' => 'input', 'sanitize_type' => 'money_decimal', 'default' => '1000.00', 'min' => 1, 'max' => 100000, 'step' => 0.01, 'dependsOn' => ['key' => 'post_rewards_s', 'value' => true]],
]],
],
],
'verify' => [