如何在Joomla 4中禁用面包屑？自定义模板下求助

1. 检查模板布局文件 #

自定义模板大概率是把面包屑直接硬编码在模板的核心布局文件里，而非通过模块输出，所以后台找不到对应模块。重点检查以下几个文件：

• templates/[你的模板名]/index.php（模板主文件）
• templates/[你的模板名]/html/com_content/article/default.php（文章详情页布局）
• templates/[你的模板名]/html/com_content/category/blog.php（分类博客页布局）

找到类似这些代码片段：

<?php echo $this->loadTemplate('breadcrumb'); ?>

或者直接调用Joomla面包屑的代码：

<?php if ($this->params->get('show_breadcrumbs')) : ?>
    <div class="breadcrumb">
        <?php echo $this->breadcrumb; ?>
    </div>
<?php endif; ?>

直接注释（用//或/* */）或删除这段代码即可。

2. 用CSS全局隐藏（无需改代码） #

如果不想碰PHP代码，直接通过自定义CSS隐藏：

1. 后台进入「系统」→「模板样式」，点击当前激活模板的「模板选项」
2. 找到「自定义CSS」/「用户CSS」输入框，添加：

.breadcrumb {
    display: none !important;
}

如果你的模板面包屑不是用breadcrumb类，按F12打开浏览器开发者工具，查看面包屑元素的实际类名替换即可。

3. 排查模板XML参数 #

部分自定义模板会把面包屑开关藏在XML参数里，只是你没找到：

1. 后台进入「扩展」→「模板」，点击当前模板的「编辑」按钮
2. 切换到「XML」标签，查找类似这段的参数定义：

<field
    name="show_breadcrumbs"
    type="radio"
    label="显示面包屑"
    description="是否全站显示面包屑"
    default="1"
    class="btn-group btn-group-yesno"
>
    <option value="1">是</option>
    <option value="0">否</option>
</field>

如果存在，回到模板选项页面仔细找对应的开关，设为「否」就行。

4. 用系统插件强制禁用 #

以上方法都无效的话，做个简单的系统插件：

1. 后台进入「扩展」→「插件」→「新建」，选择「系统」类型插件
2. 在代码编辑器里粘贴以下内容：

<?php
defined('_JEXEC') or die;

use Joomla\CMS\Plugin\CMSPlugin;

class PlgSystemDisableBreadcrumbs extends CMSPlugin
{
    public function onBeforeRender()
    {
        $app = JFactory::getApplication();
        if (!$app->isClient('site')) {
            return;
        }
        
        $doc = JFactory::getDocument();
        // 清空面包屑数据
        if (isset($doc->breadcrumbs)) {
            $doc->breadcrumbs = array();
        }
    }
}

3. 保存并启用插件，就能全局清空面包屑数据，前端自然不会显示。

内容的提问来源于stack exchange，提问作者Andrea Caponnetto