具象树木录 插件安装说明书

具象页面目录树是一款为 WordPress 页面生成智能目录树的插件，自动提取页面标题，生成美观的章节导航，提升用户体验和阅读效率。

✨ 主要特点：
- 自动生成目录树：智能提取页面 H1-H6 标题，自动生成层级目录
- 精美设计：莫兰迪粉色系，简洁优雅，适配任何主题
- 滚动跟随：侧边栏目录随页面滚动，当前章节自动高亮
- 搜索过滤：支持章节关键词快速搜索定位
- 响应式布局：完美适配电脑、平板、手机
- 阅读进度：实时显示阅读进度百分比
- 折叠展开：支持多级目录折叠，节省空间
- 轻量高效：纯原生 JS/CSS，无额外依赖

🎯 适用场景：
- 文档型网站（帮助中心、产品手册）
- 知识库页面（FAQ、教程）
- 长文章页面（万字以上长文）
- 企业官网（产品介绍页、公司简介）

🔧 使用方法：
1. 进入 外观 → 小工具
2. 找到 具象页面目录树
3. 拖拽到侧边栏区域
4. 设置显示层级、是否显示搜索框等选项
5. 保存后访问页面即可看到效果

📌 小技巧：
- 建议只显示 H2-H4 层级，避免目录过于冗长
- 必须勾选「启用侧边栏滚动跟随」才能实现滚动时目录跟随
- 支持短代码 [page_toc] 可在任意位置插入目录树

📦 安装指南

方法一：WordPress 后台安装
1. 登录 WordPress 后台
2. 进入 插件 → 安装插件
3. 搜索"具象页面目录树"
4. 点击"现在安装"
5. 安装完成后点击"启用"

方法二：手动上传安装
1. 下载插件 zip 压缩包
2. 登录 WordPress 后台
3. 进入 插件 → 安装插件 → 上传插件
4. 选择下载的 zip 文件
5. 点击"现在安装"
6. 安装完成后点击"启用"

方法三：FTP 上传安装
1. 解压插件压缩包
2. 通过 FTP 上传至 /wp-content/plugins/ 目录
3. 登录 WordPress 后台
4. 进入 插件 → 已安装插件
5. 找到"具象页面目录树"并点击"启用"

🔧 使用步骤

1. 添加目录树到侧边栏
- 进入 外观 → 小工具
- 找到「📑 具象页面目录树」
- 拖拽到侧边栏区域
- 保存设置

2. 配置目录树选项
- 目录标题：自定义显示标题（留空不显示）
- 显示层级：选择 H2-H4（推荐）
- 最大嵌套深度：默认 6 层
- 启用滚动跟随：建议勾选
- 启用折叠展开：可选
- 显示搜索框：可选
- 显示阅读进度：可选

3. 在页面中使用
- 编辑页面时使用 H2、H3、H4 等标题标签
- 目录树会自动提取并生成导航
- 保存页面后前台即可看到效果

💡 短代码用法

在页面内容中插入短代码，可在任意位置显示目录树：

[page_toc]

支持自定义参数：
[page_toc custom_title="文章目录" show_level="h2-h4" show_stats="1" enable_search="0" enable_collapse="1" max_depth="6"]

参数说明：
- custom_title：目录标题
- show_level：显示层级（h1-h6 / h2-h4 / h2 / h3 / h4）
- show_stats：显示统计信息（1开启 0关闭）
- enable_search：显示搜索框（1开启 0关闭）
- enable_collapse：启用折叠（1开启 0关闭）
- max_depth：最大嵌套深度（1-6）

📌 注意事项

- 插件仅支持普通页面（Page），不支持文章页
- 页面必须包含 H2 及以上标题才会显示目录树
- 滚动跟随需要勾选对应选项才生效
- 建议只显示 H2-H4 层级，避免目录过于冗长

❓ 常见问题

一、基础问题

Q1：目录树不显示怎么办？
答：请按以下步骤排查：
1. 确认已添加目录树小工具到侧边栏（外观 → 小工具）
2. 确认当前访问的是普通页面（Page），不是文章页
3. 确认页面中使用了 H2、H3、H4 标题标签
4. 检查小工具设置中的显示层级是否包含页面中的标题层级
5. 清除浏览器缓存后重新访问

Q2：滚动时目录不高亮？
答：请检查小工具设置中是否勾选了「启用侧边栏滚动跟随」。必须勾选此项才能实现滚动高亮效果。

Q3：移动端显示异常怎么办？
答：本插件已适配响应式设计。如仍有问题，请尝试：
1. 清除网站缓存
2. 检查主题是否与插件冲突
3. 联系技术支持

二、使用问题

Q4：支持哪些标题层级？
答：支持 H1、H2、H3、H4、H5、H6 全部层级，可在小工具设置中选择显示范围。

Q5：为什么我的文章页不显示目录树？
答：当前版本仅支持普通页面（Page），不支持文章页。如有文章页需求，请联系客服。

Q6：如何自定义目录树样式？
答：可通过以下方式自定义：
1. 在主题的 additional CSS 中添加样式覆盖
2. 修改插件目录 /assets/style.css 文件
3. 使用浏览器开发者工具查看类名后自定义

Q7：短代码怎么用？
答：在页面内容中插入 [page_toc] 即可。支持自定义参数，示例：
[page_toc custom_title="目录" show_level="h2-h4" show_stats="1"]

三、授权更新问题

Q8：如何获得插件更新？
答：插件激活后会自动获取授权并接收更新。当有新版本时，WordPress 后台会显示红色"立即更新"按钮，点击即可自动更新。

Q9：授权有效期是多久？
答：授权有效期为30天，到期前5天会自动续期，无需手动操作。

Q10：插件停用后会丢失授权吗？
答：不会。重新启用插件后会自动恢复授权，无需重新配置。

Q11：多个网站可以使用同一个授权吗？
答：每个网站独立授权，授权与网站绑定。如需多个网站使用，请联系客服购买多站点授权。

四、技术问题

Q12：是否支持 PHP 8.0+？
答：支持 PHP 7.4 - 8.3，已在最新版本中测试通过。

Q13：是否支持古腾堡编辑器？
答：支持。古腾堡编辑器中的标题标签会自动被目录树识别。

Q14：与其他插件冲突怎么办？
答：请尝试：
1. 临时停用其他插件排查冲突
2. 联系技术支持提供冲突插件名称
3. 等待兼容性更新

Q15：如何彻底卸载插件？
答：在 WordPress 后台停用并删除插件即可，所有数据会自动清理。

五、联系支持

Q16：如何获取技术支持？
答：
- 支持论坛：https://orientalnexus.cn/support/2323.html
- 官方网站：https://orientalnexus.cn
- 作者邮箱：caton@orientalnexus.cn

Q17：如何反馈建议或报告Bug？
答：欢迎通过支持论坛或作者邮箱反馈，我们会认真对待每一条反馈。