artefice主题

Artefice 主题使用说明

适用版本：1.0.0 ｜ 环境要求：WordPress 6.6+，PHP 8.1+，需安装插件 Secure Custom Fields (SCF)

一、安装与启用

1. 上传主题：后台「外观 → 主题 → 安装新主题 → 上传主题」，选择 Artefice 的 zip 包安装并启用。
2. 安装必需插件：后台「插件 → 安装插件」搜索并启用 Secure Custom Fields（所有主题设置面板依赖它）。
3. 固定链接：到「设置 → 固定链接」点击一次保存（无需修改任何选项）。课程 / 师资 / 作品等自定义文章类型的归档页与分类页依赖重写规则，这一步保证它们不出现 404。
4. 创建菜单：「外观 → 菜单」建两个菜单，分别勾选位置 主导航（primary） 与 页脚导航（footer）。

启用后，后台左侧会出现 「主题设置」 菜单，包含五个子页：基础 / 浮动面板 / 首页 / 分享 / 底部。首页内容、页脚内容、品牌配色全部在这里配置——改设置即改前台，不需要进模板。

二、基础设置（主题设置 → 基础）

「头部/底部自定义代码」字段仅管理员可保存，且保存时二次校验——防止被低权限账号注入脚本。

三、首页配置（主题设置 → 首页）

首页由 9 个模块按固定顺序排列，每个模块独立开关：

轮播 → 数据统计 → 学校简介 → 热门课程 → 师资团队 → 学生作品 → 校园环境 → 特色课程横幅 → 新闻动态

通用规则：

• 模块关闭、或没有任何有效条目时，前台整个模块消失（不留空白区域），下方模块自动顶上。
• 相邻模块带之间有一条 8–12px 的灰色分隔线，属首页设计语言，不是故障。

3.1 轮播图（hero）

条目 repeater：图片（建议 1600×900 横图）、主/副标题、按钮文字与链接、跳转目标。电脑与手机共用同一张图，由浏览器按屏幕清晰度自动选档；轮播自动播放，触屏可左右滑动，鼠标悬停暂停。

3.2 数据统计

每行：数字、单位后缀、标签、说明。前台会做「从 0 滚动到目标值」的动画（尊重系统「减弱动态效果」设置）。

3.3 学校简介

开关 + 标题 + 按钮文字/链接；正文在设置里维护，留空时回退到模板里的演示文案。

3.4 热门课程 / 师资团队 / 学生作品

这三个模块读取对应的内容类型（课程 / 师资作品见下文），设置里只控制：开关、标题、显示数量、按钮。卡片顺序：课程与师资按「编辑页 → 页面属性 → 顺序」排列。

3.5 校园环境

照片 repeater：直接上传图片即可，前台为响应式照片网格。

3.6 特色课程横幅

单张横幅图 + 标题 + 简介 + 按钮。横幅宽度（40–100%，默认满宽）和高度（像素，默认 320）可在设置里调；小于 100% 时自动居中并在两侧留白。

3.7 新闻动态

读取最新发布的文章（Posts）。设置：开关、主/副标题、数量（1–12）、查看更多文案与链接。留空时「查看更多」自动指向「设置 → 阅读」指定的文章页，其次回退到文章最多的分类。发新文章即自动出现在首页，无需回主题设置维护。

四、内容发布

主题内置三种内容类型（CPT），后台左侧各有独立菜单：

4.1 课程（course）

• 归档地址：/kecheng/；详情地址：/kecheng/{别名}/
• Featured Image（特色图）建议 600×400 横图——首页与列表卡片按 3:2 裁切展示。
• 「页面属性 → 顺序」控制首页热门课程的先后。

4.2 师资（teacher）+ 师资分类（teacher_cat）

• 归档：/shizi/，分类页：/shizi-fenlei/{分类}/
• 编辑页有 「职称」 字段（如：首席造型师），显示在姓名下方。
• 头像建议 400×400 正方形。

4.3 学生作品（student-work）+ 作品分类（work_cat）

• 归档：/xuesheng-zuopin/，分类页：/zuopin-fenlei/{分类}/
• 首页「学生作品」以跑马灯形式滚动展示，少于 2 件自动退化为普通网格。

4.4 文章（Posts）

• 详情页为「正文卡 + 右侧栏」两栏版式：右侧栏自动生成 分类导航 / 标签 / 推荐文章（同分类优先，最新补齐），无需维护。
• 摘要框：只有在编辑页右侧「摘要」栏手动填写摘要时才会显示（带「摘要：」标签）；不填则不显示，不会截取正文凑数。
• 正文底部自动带：标签 chips、「分享本文」按钮、上下篇导航、评论区（站点允许评论时）。
• 「推荐文章」与首页「新闻动态」自动取最新/同分类文章，保持更新即可。

4.5 页面（Pages）

• 每个页面的编辑页有 「页面横幅」 字段组：背景图、标题、副标题、彩色标签胶囊（横幅标题留空自动用页面标题；横幅图留空使用主色渐变兜底，文字仍然清晰）。
• 页面右侧栏自动列出 「其他页面」（本站其它已发布页面，首页除外），顺序同样受「页面属性 → 顺序」控制。

五、分类横幅（归档页顶部大图）

每个分类（含师资分类、作品分类）的编辑页有「归档横幅」字段组：

• 横幅图（建议 1920×500 横图）、主标题、副标题、彩色标签行。
• 留空时使用主色渐变兜底 + 分类名，横幅不会空白。
• 文章页顶部横幅自动取第一个分类的这套字段。

六、SEO

三级覆盖，优先级：单篇文章 → 分类 → 全站默认。

• 全站：「主题设置 → 基础」内的 SEO 区。
• 单篇/页面：编辑页下方「SEO」字段组（标题/描述/关键词/是否屏蔽收录）。
• 分类：分类编辑页同名字段。
• 标题、描述、关键词、Open Graph、canonical 全部自动输出；面包屑附带结构化数据（BreadcrumbList），有利搜索引擎展示。

七、分享设置（主题设置 → 分享）

• 总开关：关闭后所有分享入口消失。
• 分享目标：微博 / QQ / 微信 / 复制链接，逐项开关。
• 展示入口：文章页底部 / 页面底部，独立开关。
• 按钮文字：默认「分享本文」，可改。

微信二维码由本站服务器直接生成（不请求任何外部服务）：点击「微信」出现当前页链接的二维码，手机微信扫码后在微信内打开转发。二维码加载失败时按钮组自动提示改用「复制链接」。

八、页脚配置（主题设置 → 底部）

九、浮动面板（主题设置 → 浮动面板）

屏幕右侧的浮动客服区（桌面显示）：

• 客服渠道 repeater：图标（内置图标选择器，可选上传自定义）、名称、电话号/链接地址。电话自动转成 tel: 一键拨打。
• 开关控制整块显示与「回到顶部」按钮。

手机端对应能力在底部快捷栏（页脚配置）里维护。

十、外观个性化

主题是全站编辑（FSE）主题：

• 「外观 → 编辑器」可改模板结构（首页/文章页/归档页等 7 个模板）与页头页脚。
• 注意：在编辑器里保存过的模板会形成数据库覆盖，此后主题文件更新将不再反映到该模板。若升级主题后发现页面样式「不跟随」，到「编辑器 → 模板 → 对应模板 → ⋯ → 重置为已安装版本」即可恢复。
• 明暗模式：页头的太阳/月亮按钮切换，选择会记忆；未手动切换时跟随系统偏好。

十一、常见问题

Q：新上传的图片在手机上很模糊 / 首页轮播发虚？
A：中间尺寸是按注册尺寸新上传时才生成的。老图缺 artefice-hero/course/teacher 档，请安装 Regenerate Thumbnails 类插件重生成一次。

Q：后台改了设置，前台没变？
A：依次排查——① 清页面/对象缓存；② 若页面在编辑器里保存过模板覆盖（见第十条）；③ 硬刷新（Ctrl+F5）。

Q：课程/师资详情页 404？
A：「设置 → 固定链接」重新保存一次。

Q：某个首页模块不出现？
A：检查该模块开关是否开启、条目是否至少有一条有效数据（例如 repeater 里有行但图片/文字全空 = 视为无内容，模块自动隐藏）。

Q：需要 Node.js 才能用吗？
A：不需要。发布包内已包含编译好的资源；仅修改主题源码开发时才需要。