如何在OpenCart 1.5.6.4特价商品页添加文本并设置元标题元描述

以下操作适配OpenCart 1.5.6.4版本，可直接按步骤实现需求：

一、设置Meta标题与描述 #

操作文件：catalog\controller\product\special.php

• 打开文件找到index()方法，在方法内、加载模板代码的前序位置（建议放在面包屑配置代码之后）添加如下代码：

// 设置自定义Meta标题
$this->document->setTitle('你的自定义特价页Meta标题');
// 设置自定义Meta描述
$this->document->setDescription('你的特价页Meta描述内容，可加入业务相关关键词提升SEO效果');
// 可选：设置Meta关键词
$this->document->setKeywords('促销商品,特价优惠,限时折扣');

• 若需要多语言适配，可先在对应语言包文件catalog/language/你的语言目录/product/special.php中添加语言项：

$_['meta_title'] = '特价商品';
$_['meta_description'] = '全站特价商品汇总，限时优惠不容错过';
$_['meta_keyword'] = '特价,促销,优惠';

再将控制器中的代码替换为调用语言项的写法即可：

$this->document->setTitle($this->language->get('meta_title'));
$this->document->setDescription($this->language->get('meta_description'));
$this->document->setKeywords($this->language->get('meta_keyword'));

二、添加页面自定义文本 #

需要同时修改控制器和模板文件，步骤如下：

步骤1：控制器传递自定义内容变量 #

操作文件：catalog\controller\product\special.php

• 仍在index()方法内，找到$this->data['heading_title'] = $this->language->get('heading_title');代码行附近，添加变量传递代码：

// 固定内容写法
$this->data['custom_special_text'] = '你要显示的自定义提示内容，支持HTML标签，可直接插入图片、链接、列表等元素';
// 多语言适配写法：同样先在语言包加custom_special_text的语言项，再调用
// $this->data['custom_special_text'] = $this->language->get('custom_special_text');

步骤2：模板文件渲染自定义内容 #

操作文件：catalog/view/theme/default/template/product/specials.tpl

• 根据你需要的显示位置插入渲染代码即可：
  • 显示在页面顶部、标题下方：找到<h1><?php echo $heading_title; ?></h1>代码行，在下方插入：

    <div class="custom-notice" style="margin: 16px 0; padding: 12px; background: #f8f9fa; border-radius: 4px;">
        <?php echo $custom_special_text; ?>
    </div>
    

  • 显示在页面底部、商品列表下方：找到分页代码<?php echo $pagination; ?>，在其上方或下方插入上述相同代码即可。
• 若你使用的是非默认主题，需要修改对应主题目录下的product/specials.tpl文件，而非默认主题路径的文件。

注意事项 #

• 修改代码前请提前备份对应文件，出现异常可直接还原备份
• 自定义文本支持全量HTML语法，可根据业务需求自由调整样式和内容

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