萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> CMS 教學

Discuz! X3.0 面包屑導航移除 forum.php 鏈接完整教程

需求背景

Discuz! X3.0 默認面包屑導航包含 forum.php 鏈接,導致 URL 不美觀、SEO 權重分散。通過綁定論壇應用域名並修改模板/核心文件,可將面包屑中的 forum.php 替換為裸域名或相對路徑,實現乾淨 URL 結構。

前置條件:綁定論壇應用域名

  1. 後台 → 全局 → 域名設置 → 應用域名。
  2. 論壇應用綁定域名,例如 bbs.example.com 或 www.example.com/forum(視服務器配置)。
  3. 保存並更新緩存。

域名綁定示例

模板文件批量替換(核心步驟)

需修改默認風格 template/default/forum/ 下多個模板文件,將所有 <a href="forum.php" 替換為動態域名變量。

替換規則

查找:<a href="forum.php"
替換:<a href="https://{$_G['setting']['domain']['app']['forum']}/"

涉及文件清單(共 6 個文件,7 處)

  1. template/default/forum/discuz.htm(約第 18 行,導航主入口)
  2. template/default/forum/forumdisplay.htm(2 處)
  3. template/default/forum/forumdisplay_sort.htm(1 處)
  4. template/default/forum/forumdisplay_list.htm(1 處)
  5. template/default/forum/viewthread.htm(2 處)
技巧:使用編輯器「全局搜索替換」功能,一次性完成所有文件修改。

核心 PHP 文件修正(生成式導航)

部分導航由 PHP 動態生成,需同步修改源碼:

1. source/module/forum/forum_misc.php

查找:<a href="forum.php"
替換:<a href="./"

2. source/module/forum/forum_post.php

查找:<a href="forum.php"
替換:<a href="./"

3. source/archiver/forum/discuz.php(歸檔/靜態頁)

查找:<a href="../forum.php"
替換:<a href="../f"

說明:歸檔目錄結構通常為 /archiver/forum/,../f 對應論壇首頁短鏈接。

驗證效果

  1. 更新後台緩存:工具 → 更新緩存。
  2. 前台訪問論壇首頁、版塊頁、帖子頁,檢查面包屑導航:
  • 首頁導航:站點名稱 » 論壇名稱(無 forum.php)
  • 版塊頁:站點名稱 » 論壇名稱 » 版塊名稱
  • 帖子頁:站點名稱 » 論壇名稱 » 版塊名稱 » 標題
  1. 懸停鏈接查看目標 URL,應為綁定的應用域名(如 https://bbs.example.com/)。

常見問題

  • 替換後鏈接 404:檢查應用域名綁定是否生效、服務器偽靜態規則是否支持裸域名訪問。
  • 模板更新覆蓋:升級/切換模板後需重新執行替換,建議將修改記錄至部署文檔。
  • 多風格站點:需對每套風格的 forum/ 目錄分別操作。

總結

通過「域名綁定 + 模板批量替換 + 核心文件修正」三步走,徹底移除面包屑中的 forum.php,實現語義化、利於 SEO 的導航結構。操作屬模板與配置層面,不涉及數據庫變更,安全可逆。

copyright © 萬盛學電腦網 all rights reserved