PrestaShop 1.7模块链接跳转无模板页面问题求助

DevOps 小满

2026-5-28

解决PrestaShop 1.7模块跳转后仅显示纯文本的问题

看起来你遇到的核心问题是模块前端控制器没有被PrestaShop正确识别，导致系统没有加载主题的布局（页眉、页脚等），只输出了模板的纯文本内容。结合你提供的代码，我整理了具体的修复步骤：

1. 修正前端控制器的类名（最关键）

PrestaShop对控制器类名有严格的驼峰式命名要求，格式为[模块名首字母大写][控制器名首字母大写]ModuleFrontController。你的控制器类名全小写，导致系统无法识别它：

错误代码（controller/front/display.php）：

class mymoduledisplayModuleFrontController extends ModuleFrontController

修正后的代码：

class MymoduleDisplayModuleFrontController extends ModuleFrontController

2. 确保模板文件路径正确且存在

检查你的模板文件是否放在了正确的位置：modules/mymodule/views/templates/front/display.tpl，并且文件名和路径的大小写与控制器中的调用一致（Linux服务器区分大小写）。

你可以给display.tpl添加测试内容方便验证：

<h2>{l s='My Module Page' mod='mymodule'}</h2>
<p>{l s='Hello' mod='mymodule'}, {$my_module_name}!</p>
<p>{$my_module_message}</p>

3. 完善控制器的变量赋值（可选但推荐）

为了让模板能正确获取模块的配置变量，建议在控制器的initContent()方法中添加变量赋值：

public function initContent() {
    parent::initContent();
    // 传递变量到模板
    $this->context->smarty->assign(array(
        'my_module_name' => Configuration::get('MYMODULE_NAME'),
        'my_module_message' => $this->module->l('This is a simple text message')
    ));
    $this->setTemplate('module:mymodule/views/templates/front/display.tpl');
}