OpenCart 3中如何添加自定义信息页面布局？

看起来你已经走对了第一步，但OpenCart的MVC结构有几个容易遗漏的关键环节，导致页面没生效。我帮你梳理完整的正确步骤，排查可能的问题：

一、完整的自定义页面创建流程 #

1. 复制并修改控制器 #

• 复制 catalog/controller/information/information.php 到 catalog/controller/information/custom_page.php
• 把控制器类名改成对应路径：

  class ControllerInformationCustomPage extends Controller {
      // 保留原index方法的核心逻辑，只做以下修改
      public function index() {
          // 1. 加载自定义语言文件（可选，也可以直接硬编码标题）
          $this->load->language('information/custom_page');
          $this->document->setTitle($this->language->get('heading_title'));
  
          // 2. 加载自定义CSS和脚本
          $this->document->addStyle('catalog/view/theme/你的主题名/stylesheet/custom_page.css');
          $this->document->addScript('catalog/view/javascript/custom_page.js');
  
          // 3. 传递页面专属脚本到模板（如果需要在主体插入）
          $data['custom_body_script'] = '<script>
              $(document).ready(function(){
                  console.log("自定义页面专属脚本执行");
              });
          </script>';
  
          // 4. 修改模板加载路径，指向你的自定义模板
          $this->response->setOutput($this->load->view('information/custom_page', $data));
      }
  }
  

2. 复制并修改模板文件 #

• 复制 catalog/view/theme/你的主题名/template/information/information.twig 到 catalog/view/theme/你的主题名/template/information/custom_page.twig
• 在模板的合适位置（比如</body>标签前）插入专属脚本变量：

  {{ custom_body_script }}
  

• 确保模板保留原信息页面的布局结构（{{ header }}、{{ column_left }}等标签不要删），保证布局一致。

3. 语言文件配置（可选） #

• 复制 catalog/language/en-gb/information/information.php 到 catalog/language/en-gb/information/custom_page.php
• 修改语言变量，比如：

  $_['heading_title'] = '我的自定义页面';
  

4. 后台路由与布局设置 #

• URL路由配置：进入后台「系统 > 设计 > URL管理」，添加新路由：
  • 路由：information/custom_page
  • 关键词：custom-page（用户访问时的友好URL，比如你的域名/custom-page）
• 布局关联：进入后台「系统 > 设计 > 布局」，创建新布局（比如命名为“自定义信息页”），编辑时在「路由」选项中选择information/custom_page，并配置和原information页面相同的侧边栏模块，保证布局一致。

二、排查你可能遗漏的关键问题 #

1. 缓存未清除：OpenCart的缓存会导致修改不生效，必须手动清除：
   • 后台「系统 > 设置 > 编辑商店 > 服务器」，点击“清除缓存”
   • 手动删除 system/storage/cache 和 system/storage/cache/template 下的所有文件
2. 路由匹配错误：你创建的新布局必须严格匹配自定义控制器的路由（information/custom_page），否则布局不会应用到页面
3. 文件路径错误：检查控制器中CSS、脚本、模板的路径是否正确（比如主题名拼写错误）
4. 文件权限问题：确保自定义的控制器、模板文件权限为755（目录）或644（文件），服务器能正常读取

完成以上步骤后，访问你设置的友好URL（或直接访问你的域名/index.php?route=information/custom_page），就能看到和原信息页面布局一致，但加载了自定义资源的页面了。

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