PrestaShop 1.7.8.4模块无法加载自定义JS和CSS文件

• 模块已启用、功能正常，能加载模板文件，但CSS和JS始终无法生效
• 文件路径：
  • CSS：modules/dksearch/views/css/dksearch.css
  • JS：modules/dksearch/views/js/dksearch.js
• 已在Classic主题的header.tpl中通过{hook h='displayDKSearch'}调用模板，不确定是否需要手动挂载ActionFrontControllerSetMedia钩子

模块PHP代码：

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

class DkSearch extends Module {

    public function __construct() {
        $this->name = "dksearch";
        $this->tab = "front_office_features";
        $this->version = "1.0";
        $this->need_instance = 0;
        $this->ps_version_compliancy = [
            "min" => "1.7",
            "max" => _PS_VERSION_
        ];
        $this->bootstrap = true;
    
        parent::__construct();
    
        $this->displayName = "DKSearch";
        $this->description = "Lorem ipsum";
        $this->confirmUninstall = "Removed";
    }
    
    public function install() {
         return parent::install() && 
         $this->registerHook('registerDKSearch');
         $this->registerHook('actionFrontControllerSetMedia') &&
         Configuration::updateValue('dksearch', 'dksearch');
    }
    
    public function uninstall() : Bool
    {
        return parent::uninstall();
    }
    
    public function hookdisplayDKSearch() {
        return $this->display(__FILE__, 'views/templates/hook/dksearch.tpl');
    }
    
    public function hookActionFrontControllerSetMedia()
    {
        $this->context->controller->registerStylesheet(
            'dksearch-style',
            $this->_path.'views/css/dksearch.css',
            [
                'media' => 'all',
                'priority' => 1000,
            ]
        );
    
        $this->context->controller->registerJavascript(
            'dksearch-javascript',
            $this->_path.'views/js/dksearch.js',
            [
                'position' => 'bottom',
                'priority' => 1000,
            ]
        );
    }

}

问题排查与修复方案 #

1. 钩子注册语法错误
   install()方法里的return语句提前终止了代码执行，导致actionFrontControllerSetMedia钩子根本没注册。同时钩子名也写错了，应该和钩子方法名对应：
   修复后的install()方法：

   public function install() {
        return parent::install() 
            && $this->registerHook('displayDKSearch') 
            && $this->registerHook('actionFrontControllerSetMedia') 
            && Configuration::updateValue('dksearch', 'dksearch');
   }
   

2. 钩子方法命名规范
   建议把hookdisplayDKSearch改成hookDisplayDKSearch（首字母大写），符合PrestaShop的钩子方法命名规范，避免潜在兼容问题。

3. 核心钩子无需手动调用
   actionFrontControllerSetMedia是PrestaShop内置核心钩子，Classic主题默认会自动触发，不需要在模板里手动挂载。

4. 强制清理缓存
   修改代码后，必须执行：

   • 后台"高级参数>性能"页面清理系统缓存
   • 前端页面按Ctrl+F5强制刷新，清除浏览器缓存

验证步骤 #

1. 先卸载模块，再重新安装，确保钩子正确注册
2. 进入模块详情页的"钩子"标签，确认displayDKSearch和actionFrontControllerSetMedia已注册
3. 打开浏览器开发者工具（F12），在"网络"标签下查看CSS/JS是否被正常请求

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