PrestaShop 8.1简单模块问题：跳转异常及Admin视图无法显示

问题描述 #

开发一个简单模块，要求在Admin面板和用户账户页面显示“TEST”字样，模块已成功安装并出现在/modules标签页，但存在以下问题：

• 前端视图（/front/test.tpl）中的链接跳转地址为localhost:8080/en/module/testmodule/test，不符合预期；
• Admin端无法正常跳转至对应视图，曾出现500状态码及商店操作错误。

模块文件结构 #

• controllers/admin/AdminTestController.php
• controllers/front/TestController.php
• views/templates/admin/test.tpl
• views/templates/front/test.tpl
• testmodule.php

代码文件详情 #

controllers/admin/AdminTestController.php #

<?php

class AdminTestController extends ModuleAdminController
{
    public function __construct()
    {
        parent::__construct();
    }

    public function initContent()
    {
        parent::initContent();
        $this->setTemplate('test.tpl');
    }
}

controllers/front/TestController.php #

<?php

use PrestaShop\PrestaShop\Core\Module\WidgetInterface;

class TestModuleTestModuleTestController extends ModuleFrontController
{
    public function initContent()
    {
        parent::initContent();

        $this->context->smarty->assign([
            'message' => 'TEST'
        ]);

        $this->setTemplate('module:testmodule/views/templates/front/test.tpl');
    }
}

views/templates/admin/test.tpl #

<h1>TEST</h1>

views/templates/front/test.tpl #

<!-- modules/testmodule/views/templates/front/test.tpl -->
<div>
    <a href="{$link->getModuleLink('testmodule', 'test')}">SEE DATA</a>
</div>

testmodule.php #

<?php

if (!defined('_PS_VERSION_')) {
    exit;
}

class TestModule extends Module
{
    public function __construct()
    {
        $this->name = 'testmodule';
        $this->tab = 'front_office_features';
        $this->version = '1.0.0';
        $this->author = 'Your Name';
        $this->need_instance = 0;
        $this->bootstrap = true;

        parent::__construct();

        $this->displayName = $this->l('Test Module');
        $this->description = $this->l('A simple module to display TEST on both admin and user pages.');

        $this->ps_versions_compliancy = array('min' => '1.7', 'max' => _PS_VERSION_);
    }

    public function install()
    {
        return parent::install() &&
            $this->registerHook('displayCustomerAccount') &&
            $this->registerHook('displayAdminProductsMainStepLeftColumnMiddle');
    }

    public function hookDisplayCustomerAccount($params)
    {
        $link = $this->context->link->getModuleLink('testmodule', 'test');
        return '<a href="' . $link . '">SEE DATA</a>';
    }
}

环境信息 #

环境：Docker（Windows 10）
PrestaShop版本：8.1

问题解决思路 #

问题1：前端链接跳转异常 #

1. 修正控制器类名：前端控制器类名TestModuleTestModuleTestController违反PrestaShop命名规范，正确格式应为[模块名首字母大写+其余小写][控制器名首字母大写]Controller，即TestmoduleTestController。修正后代码：

<?php

class TestmoduleTestController extends ModuleFrontController
{
    public function initContent()
    {
        parent::initContent();

        $this->context->smarty->assign([
            'message' => 'TEST'
        ]);

        $this->setTemplate('module:testmodule/views/templates/front/test.tpl');
    }
}

2. 修正模板文件夹路径：原模板文件夹名为views/template/，不符合PrestaShop规范（正确应为views/templates/，复数形式），需将文件夹重命名为templates，否则系统无法加载模板文件。

问题2：Admin端跳转失败与500错误 #

1. 完善Admin控制器配置：在AdminTestController的构造函数中添加模块关联及基础配置，确保系统识别这是模块的Admin控制器：

public function __construct()
{
    $this->module = Module::getInstanceByName('testmodule');
    $this->bootstrap = true; // 启用Bootstrap样式适配后台
    parent::__construct();
}

2. 修正Admin模板路径：同前端模板，将views/template/admin/改为views/templates/admin/，确保模板能被正确加载。
3. 实现Admin钩子内容：当前hookDisplayAdminProductsMainStepLeftColumnMiddle钩子没有返回内容，添加代码以在Admin面板显示“TEST”：

public function hookDisplayAdminProductsMainStepLeftColumnMiddle($params)
{
    return '<h1>TEST</h1>';
}

4. 排查500错误：查看var/logs/目录下的prod.log或dev.log，获取具体错误信息（通常是类未找到、模板不存在或权限问题），针对性修复。
5. Admin控制器访问路径：正确的Admin控制器访问地址应为：

/admin/index.php?controller=AdminTest&module=testmodule

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