MODX3.0.2中SimpleSearch3.0.0始终调用默认SearchResults块求助

原因分析 #

SimpleSearch 3.x处理模板（Tpl）时，默认优先从组件的core/components/simplesearch/elements/chunks/目录加载文件形式的块，哪怕数据库里有同名自定义块也会被覆盖。而$modx->getChunk()的查找逻辑是优先数据库，所以测试代码能正常获取自定义块，但组件本身的加载逻辑不同。

解决方案 #

方法1：重命名自定义块并指定参数 #

避开和默认块同名，把数据库里的自定义块改名为CustomSearchResults这类独特名称，然后调用SimpleSearch时明确指定模板参数：

[[!SimpleSearch? &containerTpl=`CustomSearchResults`]]

该方法不用修改组件核心代码，安全性高，适合不想改动组件文件的场景。

方法2：调整组件块加载逻辑 #

找到core/components/simplesearch/src/SimpleSearch.php文件，定位到加载容器模板的代码段，修改为优先读取数据库块：

• 找到类似$chunk = $this->modx->getChunk($this->getOption('containerTpl'), $placeholders);的代码
• 替换为以下逻辑：

  $chunkObj = $this->modx->getObject('modChunk', array('name' => $this->getOption('containerTpl')));
  if ($chunkObj) {
      $chunk = $chunkObj->getContent();
      $chunk = $this->modx->parseChunk($chunk, $placeholders);
  } else {
      // 找不到数据库块时 fallback到文件块
      $chunk = $this->modx->getChunk($this->getOption('containerTpl'), $placeholders);
  }
  

方法3：重命名默认文件块 #

直接把core/components/simplesearch/elements/chunks/SearchResults.chunk.tpl重命名为SearchResults_default.chunk.tpl，SimpleSearch找不到原文件块时，就会自动去数据库查找同名块。
注意：组件更新后这个修改会被覆盖，需要重新操作。

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