Drupal9自定义主题搜索功能的9大进阶配置

　　按照《Drupal8自定义主题下搜索功能的实现》的说明完成search模块的基本配置，在默认主题或者自定义主题变动不太大的情况下，上述配置可以让搜索功能正常使用。但是，在自定义主题环境下，实际应用中还是会遇到不少问题：区块复用、模板修改、表单配置、变量应用、按钮设置、日期格式的调试等。

 

　　一、search区块复用

 

　　search模块安装、启动后，会在content区域下生成一个search区块，该区块可以在其他任何区域调用，即：调试好一个search区块的样式后，该区块可以在其它任何区域调用、复用，从而减少开发成本，提高工作效率。

 

　　二、搜索模板使用

 

　　另外，与搜索模块密切相关的模板有两个，一是搜索页面模板page--search.html.twig，主要用来布局搜索页面的基本样式，通过{{page.content}}变量连接搜索结果；二是搜索结果模板search-result.html.twig，主要是用来输出标题、描述、发布日期等节点内容。

 

　　三、搜索变量调用

 

　　在搜索结果模板中search-result.html.twig中，有标题{{title}}、描述{{snippet}}、发布日期{{info_split.date}}3个常用的变量，其它变量可根据模板说明详细了解。

 

　　四、日期格式修改

 

　　默认情况下，搜索结果中的发布日期{{info_split.date}}字段按照“01/12/2022-16:20”格式显示。可以在“管理->配置->日期->Default_short_date”中重新定义发布日期字段的格式。例如，设置“Default_short_date”为“Y-m-d”格式，则搜索结果中的发布日期字段显示为“2022-01-12”形式，依次类推。

 

　　五、form表单配置

 

　　Drupal的search功能要想生效，必须在form表单中指定action="/search/node"，即：<form name="searchForm" id="searchForm" action="/search/node" method="GET"> </form>，其它参数根据实际需要配置即可。

 

　　六、搜索按钮修改

 

　　最后是搜索按钮的修改。查找了search模块的很多模板也没有找到修改搜索按钮的变量。最后在一个英文网站上找到了方法：通过一个函数ThemeName_form_search_block_form_alter来修改input的value值，进而实现修改搜索按钮样式/图标的目标。具体来说，在自定义主题下，新建一个/themes/ThemeName/ThemeName.theme文件之后，把下面的代码放进去，点击保存，重建缓存，即可将搜索按钮修改成“搜索”或者你想要实现的目标字体。

function ThemeName_form_search_block_form_alter(&$form, &$form_state) {
  $form['keys']['#attributes']['placeholder'][] = t('请输入关键词');
  $form['actions']['submit']['#value'] = html_entity_decode('搜索');
  $form['actions']['submit']['#attributes']['class'][] = 'search-button';
}

　　这段代码，需要说明4点：

 

　　ThemeName：表示自定义主题的名称，一定要修改，否则函数不生效；

 

　　代码第一行：修改input的placeholder值；

 

　　代码第二行：把drupal默认搜索图标修改成“搜索”文字，如果“搜索”文字不显示，则去掉input中的class类即可显示；

 

　　代码第三行：给搜索按钮添加一个类search-button，用来重新定义搜索按钮的样式。

　　八、搜索分页功能

 

　　配置好普通列表的分页功能后，搜索结果列表页也会自动调用分页功能。可以在搜索结果的分页模板中，直接修改上一页，下一页，首页，末页等信息；需要注意的是，为了确保搜索功能正常使用，在布局搜索功能前，不要动去动搜索相关的任何模板、参数，甚至标签；等有测试数据的时候，能搜索出来结果时，再根据搜索结果页面调用搜索结果页面就行了。另外，搜索结果列表中，可以调用自定义字段的，也可以调用默认字段，具体格式根据模板的解说使用即可。