分类信息排序系统 - 版主操作指引
<h2>一、系统概述</h2><h3>1.1 功能说明</h3>
<p>本系统通过 Discuz 分类信息功能，实现文档帖子在<strong>目录树</strong>和<strong>版块列表页</strong>的统一排序，确保两处展示顺序一致。</p>
<h3>1.2 核心配置</h3>
<table>
<thead>
<tr>
<th>配置项</th>
<th>说明</th>
<th>值</th>
</tr>
</thead>
<tbody>
<tr>
<td>分类信息</td>
<td>文档管理</td>
<td>sortid=5</td>
</tr>
<tr>
<td>排序权重</td>
<td>控制帖子排序</td>
<td>optionid=21 (sort_order)</td>
</tr>
<tr>
<td>配置帖标识</td>
<td>判断是否为配置帖</td>
<td>optionid=22 (is_config)</td>
</tr>
<tr>
<td>目录树展示</td>
<td>配置帖是否展示在目录树</td>
<td>optionid=23 (show_in_tree)</td>
</tr>
</tbody>
</table>
<p><strong>选项值说明</strong>：</p>
<ul>
<li>is_config：<code>配置文档</code> / <code>普通文档</code></li>
<li>show_in_tree：<code>展示在目录</code> / <code>不展示</code></li>
</ul>
<h3>1.3 帖子分类逻辑</h3>
<pre><code>┌─────────────────────────────────────────────────────────────┐
│ 帖子类型判断流程 │
└─────────────────────────────────────────────────────────────┘
帖子置顶状态 (displayorder > 0)
│
├── 是配置帖 (is_config = 配置文档)
│ ├── show_in_tree = 展示在目录 → 展示在 0 级目录（可控制）
│ └── show_in_tree = 不展示 → 不展示在目录树（隐藏配置）
│
├── 非配置帖 (is_config = 普通文档)
│ └── → 自动展示在 0 级目录（置顶说明帖）
│
└── 普通帖子 (displayorder = 0)
└── → 按 sort_order 排序归入对应目录
</code></pre>
<hr />
<h2>二、发帖操作指南</h2>
<h3>2.1 发布置顶说明帖（0 级目录）</h3>
<p><strong>适用场景</strong>：发布版块说明、使用指南、公告等需要展示在顶级目录的帖子</p>
<p><strong>操作步骤</strong>：</p>
<ol>
<li>点击"发表帖子"</li>
<li>选择分类信息：<strong>文档管理</strong></li>
<li>设置各选项：
<ul>
<li><strong>排序权重</strong> (sort_order)：<code>0</code>（或不填，置顶帖排序优先级高）</li>
<li><strong>是否为配置帖</strong> (is_config)：<strong>普通文档</strong></li>
<li><strong>是否展示在目录树</strong> (show_in_tree)：<code>不展示</code>（此项对非配置帖无效，可不填）</li>
</ul>
</li>
<li>设置<strong>置顶</strong>：选择"显示置顶"</li>
<li>填写帖子标题和内容，发布</li>
</ol>
<p><strong>效果</strong>：帖子自动展示在目录树 0 级目录（最顶层）</p>
<hr />
<h3>2.2 发布配置帖</h3>
<p><strong>适用场景</strong>：发布目录配置帖（使用 <code></code> 前缀和 <code></code> 标签的配置内容）</p>
<p><strong>操作步骤</strong>：</p>
<ol>
<li>点击"发表帖子"</li>
<li>选择分类信息：<strong>文档管理</strong></li>
<li>设置各选项：
<ul>
<li><strong>排序权重</strong> (sort_order)：<code>0</code>（或不填）</li>
<li><strong>是否为配置帖</strong> (is_config)：<strong>配置文档</strong></li>
<li><strong>是否展示在目录树</strong> (show_in_tree)：根据需求选择
<ul>
<li><code>展示在目录</code> → 配置帖本身展示在 0 级目录</li>
<li><code>不展示</code> → 配置帖不展示在目录树（仅配置作用）</li>
</ul>
</li>
</ul>
</li>
<li>设置<strong>置顶</strong>：选择"显示置顶"</li>
<li>帖子标题：建议使用 <code></code> 前缀标识（方便识别）</li>
<li>帖子内容：使用 <code></code> 标签定义目录结构</li>
</ol>
<p><strong>配置帖内容示例</strong>：</p>
<pre><code>
1 = 开发维护 = 网站开发维护
1-1 = 社创开发 = 社创官网和社区开发
1-2 = 利智官网 = 北京利智官网
2 = 产品文档 = 产品相关文档
社创开发 = tid:118,tid:140,tid:137
</code></pre>
<p><strong>效果</strong>：</p>
<ul>
<li>show_in_tree=1：配置帖展示在 0 级目录</li>
<li>show_in_tree=0：配置帖不展示在目录树</li>
</ul>
<hr />
<h3>2.3 发布普通文档帖</h3>
<p><strong>适用场景</strong>：发布具体的文档内容帖子</p>
<p><strong>操作步骤</strong>：</p>
<ol>
<li>点击"发表帖子"</li>
<li>选择分类信息：<strong>文档管理</strong></li>
<li>设置各选项：
<ul>
<li><strong>排序权重</strong> (sort_order)：填写数字，<strong>数字越小越靠前</strong>
<ul>
<li>如：<code>1</code>、<code>2</code>、<code>3</code>...</li>
<li>不填则默认为 <code>99</code>（排在最后）</li>
</ul>
</li>
<li><strong>是否为配置帖</strong> (is_config)：<strong>普通文档</strong></li>
<li><strong>是否展示在目录树</strong> (show_in_tree)：<code>不展示</code>（此项对普通帖子无效，可不填）</li>
</ul>
</li>
<li><strong>不需要置顶</strong>（保持默认）</li>
<li>添加标签：<code>#目录_xxx</code>（xxx 与配置帖中的标签名一致）</li>
<li>填写帖子标题和内容，发布</li>
</ol>
<p><strong>效果</strong>：帖子按 sort_order 值排序，归入对应的目录</p>
<hr />
<h2>三、编辑帖子操作</h2>
<h3>3.1 修改帖子排序</h3>
<p><strong>适用场景</strong>：调整帖子在目录中的展示顺序</p>
<p><strong>操作步骤</strong>：</p>
<ol>
<li>进入帖子，点击"编辑"</li>
<li>在分类信息区域修改<strong>排序权重</strong> (sort_order)</li>
<li>提交保存</li>
</ol>
<p><strong>注意</strong>：修改后目录树和版块列表页的排序会同步更新</p>
<hr />
<h3>3.2 切换帖子类型</h3>
<p><strong>将普通帖子改为配置帖</strong>：</p>
<ol>
<li>进入帖子，点击"编辑"</li>
<li>修改<strong>是否为配置帖</strong> (is_config) 为"配置文档"</li>
<li>设置<strong>置顶</strong>状态</li>
<li>提交保存</li>
</ol>
<p><strong>将配置帖改为普通帖子</strong>：</p>
<ol>
<li>进入帖子，点击"编辑"</li>
<li>修改<strong>是否为配置帖</strong> (is_config) 为"普通文档"</li>
<li>取消<strong>置顶</strong>状态</li>
<li>提交保存</li>
</ol>
<hr />
<h3>3.3 控制配置帖展示</h3>
<p><strong>适用场景</strong>：配置帖只想保留配置功能，不想展示在目录树中</p>
<p><strong>操作步骤</strong>：</p>
<ol>
<li>进入配置帖，点击"编辑"</li>
<li>修改<strong>是否展示在目录树</strong> (show_in_tree) 为"不展示"</li>
<li>提交保存</li>
</ol>
<p><strong>效果</strong>：配置帖不再展示在目录树 0 级目录，但配置功能仍然有效</p>
<hr />
<h2>四、批量操作</h2>
<h3>4.1 批量修改排序</h3>
<p><strong>适用场景</strong>：批量调整一批帖子的排序</p>
<p><strong>操作方法</strong>：</p>
<ol>
<li>进入版块帖子列表</li>
<li>勾选需要修改的帖子</li>
<li>点击"批量管理"</li>
<li>选择"移动帖子"或其他操作（分类信息需要单独编辑）</li>
</ol>
<p><strong>建议</strong>：批量修改分类信息需要逐个编辑，建议提前规划好排序值</p>
<hr />
<h3>4.2 批量迁移现有帖子</h3>
<p>如果已有大量帖子需要添加分类信息，可使用数据迁移脚本：</p>
<ol>
<li>访问：<code>http://您的域名/tools/migrate_classification_data.php</code></li>
<li>脚本会自动为所有帖子初始化分类信息</li>
<li>执行完成后删除脚本</li>
</ol>
<p><strong>初始化规则</strong>：</p>
<ul>
<li><code></code> 开头的置顶帖 → is_config=配置文档，show_in_tree=展示在目录，sort_order=0</li>
<li>其他置顶帖 → is_config=普通文档，sort_order=0</li>
<li>普通帖子 → is_config=普通文档，sort_order=99, show_in_tree=不展示</li>
</ul>
<hr />
<h2>五、常见问题</h2>
<h3>Q1：帖子在目录树中找不到？</h3>
<p><strong>检查项</strong>：</p>
<ol>
<li>帖子是否添加了正确的标签（如 <code>#目录_社创开发</code>）</li>
<li>配置帖中是否定义了该标签对应的目录</li>
<li>帖子是否被错误地设置为配置帖（is_config=配置文档 会变成 0 级目录）</li>
</ol>
<hr />
<h3>Q2：目录树和版块列表页排序不一致？</h3>
<p><strong>检查项</strong>：</p>
<ol>
<li>确认帖子是否设置了 sort_order 值</li>
<li>确认置顶状态是否正确</li>
<li>清除缓存后重试</li>
</ol>
<hr />
<h3>Q3：配置帖修改后目录树没有更新？</h3>
<p><strong>检查项</strong>：</p>
<ol>
<li>清除论坛缓存</li>
<li>确认配置帖内容格式正确</li>
<li>确认配置帖是否为置顶状态</li>
</ol>
<hr />
<h3>Q4：如何隐藏配置帖本身？</h3>
<p><strong>操作方法</strong>：</p>
<ol>
<li>编辑配置帖</li>
<li>将 <strong>是否展示在目录树</strong> (show_in_tree) 设置为"否"</li>
<li>提交保存</li>
</ol>
<hr />
<h3>Q5：sort_order 值相同怎么办？</h3>
<p><strong>处理方式</strong>：</p>
<ul>
<li>sort_order 相同的帖子，按发帖时间排序</li>
<li>建议为每个帖子设置唯一的 sort_order 值</li>
</ul>
<hr />
<h2>六、权限说明</h2>
<h3>6.1 权限控制</h3>
<table>
<thead>
<tr>
<th>操作</th>
<th>版主</th>
<th>管理员</th>
<th>普通用户</th>
</tr>
</thead>
<tbody>
<tr>
<td>设置 sort_order</td>
<td>✓</td>
<td>✓</td>
<td>✓</td>
</tr>
<tr>
<td>设置 is_config</td>
<td>✗</td>
<td>✓</td>
<td>✗</td>
</tr>
<tr>
<td>设置 show_in_tree</td>
<td>✗</td>
<td>✓</td>
<td>✗</td>
</tr>
<tr>
<td>编辑他人帖子分类信息</td>
<td>✓</td>
<td>✓</td>
<td>✗</td>
</tr>
</tbody>
</table>
<p><strong>注意</strong>：<code>show_in_tree</code> 和 <code>is_config</code> 建议设置为仅管理员可修改，避免配置混乱</p>
<hr />
<h2>七、最佳实践</h2>
<h3>7.1 排序值规划建议</h3>
<pre><code>sort_order 值范围建议：
置顶说明帖：0
配置帖：0
普通文档帖：10, 20, 30, 40...（预留间隔，方便后续插入）
</code></pre>
<h3>7.2 配置帖管理建议</h3>
<ol>
<li><strong>固定配置帖</strong>：每个版块只设置一个配置帖</li>
<li><strong>标识清晰</strong>：配置帖标题使用 <code></code> 前缀</li>
<li><strong>show_in_tree=0</strong>：配置帖建议设置为不展示，保持目录简洁</li>
<li><strong>定期备份</strong>：配置帖内容定期备份，避免误删</li>
</ol>
<h3>7.3 标签命名规范</h3>
<pre><code>推荐格式：#目录_分类名
示例：
#目录_开发维护
#目录_产品文档
#目录_用户手册
#目录_技术手册
</code></pre>
<hr />
<h2>八、附录</h2>
<h3>8.1 数据表结构</h3>
<ul>
<li><code>pre_forum_typeoptionvar</code>：存储分类信息值</li>
<li><code>pre_forum_typeoption</code>：分类信息选项定义</li>
<li><code>pre_forum_thread</code>：帖子表</li>
</ul>
<p><em>文档版本：1.0</em><br />
<em>更新日期：2026-02-28</em></p>
页:
[1]