dnadesign/silverstripe-googlesitesearch

将Google Site Search添加到您的SilverStripe网站。

安装次数: 6,166

依赖项: 0

建议者: 0

安全性: 0

星标: 9

关注者: 14

分支: 10

开放问题: 1

类型:silverstripe-vendormodule

1.0.0 2016-08-11 23:03 UTC

This package is not auto-updated.

Last update: 2024-09-19 11:54:06 UTC


README

需求

  • SilverStripe 4

文档

为用户添加通过Google Site Search搜索网站的能力。这是通过CMS中的一个新页面(GoogleSiteSearchPage)完成的,并且结果通过ajax从Google获取。搜索表单和结果可以通过CSS自由样式化。

  1. 注册www.google.com/sitesearch

  2. 将此模块安装到您的网站根目录下的googlesitesearch文件夹中

  3. 使用dev/build重建您的数据库

  4. 在CMS中,在新增的GoogleSiteSearchPage的一个新实例下或通过配置标志GoogleSiteSearchPage.cse_keyGoogleSiteSearchPage.cse_cx分别输入您的Google CSE CX和key值。

  5. 将默认搜索表单添加到您的控制器中(或使用您自己的扩展进行样式化/更改表单)。在mysite/_config/googlesitesearch.yml中添加以下内容

    控制器: 扩展

    • GoogleSiteSearchDefaultFormExtension
  6. 将搜索表单添加到您的Page.ss模板的$GoogleSiteSearchForm

在安装模块之前,请确保您已阅读Google自定义搜索条款并同意这些条款和条件 https://www.google.co.nz/cse/docs/tos.html

定制

通过在页面上提供自定义的GoogleSiteSearchPage模板,可以完全控制HTML。由于结果是通过AJAX加载的,因此使用了John Resig的Micro Templating来提供基本的结果、页眉和页脚模板。

默认情况下,提供基本的页眉信息和页脚分页,但您可以根据需要自由修改页面。有关可输出到模板的数据的更多文档(如文件信息),请参阅developers.google.com/custom-search/v1/using_rest