README

本模块提供基本配置以及一个或两个搜索结果页面，用于展示来自Google自定义搜索引擎搜索的结果

Google索引

要有效地将GCSE作为站内搜索使用，站点的内容需要由Google索引。我们使用Drupal xmlsitemap模块提供站点地图，并将其提交给Google进行索引。这需要访问Google搜索控制台，可以通过digitalservices@humanitarianresponse.info进行申请

结果页面模板可以在子主题中覆盖，并且可以通过子主题库扩展样式。

common_design_subtheme.info.yml

libraries-extend:
  ocha_search/google-cse:
    - common_design_subtheme/google-cse

此模块还提供了一个用于搜索表单的Drupal区块。将此区块放置在头部搜索区域。当前搜索表单的标记依赖于Common Design基础主题的样式和javascript。

需要两套配置：'Google配置'在https://programmablesearchengine.google.com/controlpanel/all的Google网站上；'内部配置'在OCHA网站上的/admin/config/search/gcse-config

除非在'内部配置'中设置为其他路径，否则网站搜索结果将显示在/results。这是为了避免与/search冲突，因为该路径可能已经被其他模块定义。

默认情况下，OCHA全球搜索结果将显示在/ocha-wide-results。可以通过'启用OCHA全球结果选项卡'复选框将其关闭，并配置路径。这两个选项都在内部配置页面上。

网站搜索需要一个GCSE ID，该ID来自Google配置页面。必须在内部配置页面上添加该ID。

标准配置选项包含在gcse_config目录中的example-context-cse.xml文件中。该文件可以通过设置中的高级选项卡上传到自定义搜索引擎。名称和描述应相应编辑。

所有颜色首选项和其他样式选择都包含在模块中的css文件中，因此可以在Google界面中忽略这些配置。

网站搜索