You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Magento 2商品列表上下显示长短分类描述的实现方法问询

实现Magento 2分类描述拆分显示(短描述在上,长SEO描述在下)

刚好我之前也碰到过一模一样的需求,不想折腾新增字段改数据库,就沿用了你WooCommerce里的字符串拆分思路,完全不用装第三方模块,下面是具体操作步骤:

1. 先给分类描述加分隔标记

在后台编辑分类描述时,用<!--more-->作为短描述和长描述的拆分线:

举个例子:
这是要显示在商品列表上方的短分类描述,突出核心卖点 这里是用于SEO的长分类描述,可以详细介绍分类特点、适用场景、相关知识等,方便搜索引擎抓取

2. 重写分类列表模板文件

别直接改Magento核心文件,在你的主题目录下创建(或复制)分类视图模板:
app/design/frontend/[你的Vendor]/[你的Theme]/Magento_Catalog/templates/category/view.phtml

3. 修改模板代码实现拆分显示

找到模板里原本输出分类描述的代码(通常是<?= /* @noEscape */ $block->getCurrentCategory()->getDescription() ?>这类),替换成以下逻辑:

<?php
$category = $block->getCurrentCategory();
$fullDescription = $category->getDescription();
// 用分隔符拆分描述内容
$descriptionParts = explode('<!--more-->', $fullDescription, 2);
$shortDescription = isset($descriptionParts[0]) ? trim($descriptionParts[0]) : '';
$longDescription = isset($descriptionParts[1]) ? trim($descriptionParts[1]) : '';
?>

<!-- 在商品列表上方输出短描述 -->
<?php if ($shortDescription): ?>
    <div class="category-short-description">
        <?= /* @noEscape */ $this->helper('Magento\Catalog\Helper\Output')->categoryAttribute($category, $shortDescription, 'description') ?>
    </div>
<?php endif; ?>

<!-- 保留原有的商品列表渲染代码 -->
<?= $block->getProductListHtml() ?>

<!-- 在商品列表下方输出长SEO描述 -->
<?php if ($longDescription): ?>
    <div class="category-long-description seo-content">
        <?= /* @noEscape */ $this->helper('Magento\Catalog\Helper\Output')->categoryAttribute($category, $longDescription, 'description') ?>
    </div>
<?php endif; ?>

4. 自定义样式(可选)

可以在主题的CSS文件里给两个描述块加样式,让显示更合理:

.category-short-description {
    font-size: 1.2rem;
    margin-bottom: 2rem;
    color: #333;
}

.category-long-description.seo-content {
    font-size: 1rem;
    margin-top: 3rem;
    color: #666;
    line-height: 1.6;
}

额外说明

  • 如果某个分类没加<!--more-->分隔符,默认会把整个描述作为短描述显示在列表上方,长描述为空,不会破坏原有逻辑
  • 用Magento\Catalog\Helper\Output的方法处理描述,能保留后台编辑时的HTML格式(比如换行、加粗),同时保证输出安全

内容的提问来源于stack exchange,提问作者Jason

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.14 07:34:33