- Search&Promote文档概述
- 发行说明
- Search&Promote18.1.1发行说明(02/13/2018)
- Search&Promote17.11.1发行说明(10/31/2017)
- Search&Promote15.3.1发行说明(03/24/2015)
- Search&Promote15.1.1发行说明(01/15/2015)
- Search&Promote8.17.0发行说明(10/30/2014)
- Search&Promote8.16.0发行说明（2014年9月18日）
- Search&Promote8.15.0发行说明(06/19/2014)
- Search&Promote8.14.0发行说明(05/22/2014)
- Search&Promote8.13.0发行说明(04/16/2014)
- Search&Promote8.12.0发行说明(01/16/2014)
- Search&Promote8.11.0发行说明（2013年10月29日）
- Search&Promote8.10.1发行说明(07/18/2013)
- Search&Promote8.9.8发行说明(05/23/2013)
- Search&Promote8.9.6发行说明(03/21/2013)
- Search&Promote8.9.5发行说明(02/21/2013)
- Search&Promote8.9.4发行说明(01/17/2013)
- Search&Promote8.9.3发行说明（2012年11月1日）
- Search&Promote8.9.2发行说明(09/13/2012)
- Search&Promote8.9.1发行说明(08/16/2012)
- Search&Promote8.9发行说明(07/19/2012)
- Search&Promote8.8.1发行说明
- Search&Promote8.8发行说明
- Search&Promote8.7.2发行说明
- Search&Promote8.7.1发行说明
- Search&Promote8.7发行说明
- Search&Promote入门
- 主页
- 使用历史记录
- 设计搜索
- 应用搜索规则
- 使用搜索语言
- 模拟器
- 暂存
- 生成搜索报告
- 为内容
- 配置设置
- 使用Search&Promote帐户
- 附录
模板
模板
演示文稿模板标记
网站搜索／销售标记和演示文稿模板属性的列表。
演示文稿模板是包含站点搜索／销售定义的演示文稿模板标记的HTML文件。 这些标记指示客户看到的搜索结果的格式。
请参阅关于模板。
您可以从以下演示文稿标记组中进行选择：
声明
声明是特殊的指引式声明标记，您可以在顶级演示文稿模板的顶部设置这些标记。 将忽略任何后续声明，包括包含的模板中的声明。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<guided-content-type-header content="content-type"> |
默认情况下，演示文稿模板会以mime类型的text/html发回。 您可以更改此标记使用的内容类型。 在演示文稿模板中尽可能高地声明此标记。 请勿在此标签的同一行上添加其他文本。 |
| 2 |
<guided-xml-declare> |
如果要返回XML，则可以使用此标签创建XML声明。 使此标记成为演示文稿模板中的第一行。 使用此标记时，content-type将自动设置为text/xml，除非在第一行中用 <guided-content-type-header> 覆盖它。 如果不指定字符集，则默认为UTF-8。 此标签在您的XML文档中生成以下输出： <?xml version="1.0" encoding="charset-name" standalone="yes" ?> |
结果
| 标记 |
描述 |
|||
|---|---|---|---|---|
| 1 |
<guided-results></guided-results> |
向导式结果标签定义结果循环的边界。 通过指定 gsname 属性，可以访问任何结果集。 如果未提供 gsname ，则显示默认搜索结果。 |
||
| 2 |
<guided-result-link></guided-result-link> |
要创建指向给定结果的链接，请使用 guided-result-link 标签。 通过定义 gsname 属性，您可以使用索引中的字段而不是引用“search-url”的标准“loc”标记。 任何其他属性(如类和目标)也可以传递，这些属性在生成的锚点标签中输出。 |
||
| 3 |
<guided-result-img gsname="fieldname"> |
<guided-result-img> 标记有助于创建图像标记，而不是将变量嵌入到原始 img 标记中。 在 gsname 属性中指定用于图像路径的字段。 结果是一个 img 标记，其中包含您定义并传递的任何标准HTML属性。 因此，以下示例： 4 |
<guided-result-field gsname="fieldname"> |
结果中显示的任何信息均显示为 <guided-result-field> 标记（使用自动生成标记时除外，如 <guided-result-img> 标记）。 在 gsname 中指定搜索索引字段的名称。 传递的确切字符串将输出到模板中。 如果希望此字段以不同方式转义，则可以指定转义选项。 此编码应用于传输模板中指定的任何编码。 |
| 5 |
<guided-if></guided-if-result-field> |
如果特定字段中有要显示的内容，则此条件标记集为true。 如果不存在内容，则条件为false。 您可以使用标记来决定在不存在值或显示其他图像等情况下是否显示周围的HTML。 |
||
| 6 |
|
在列中显示结果时，此标记用于标识当前结果是否标记列的结尾。 当布尔条件为true时，将HTML添加到结果末尾，以结束行并开始新行。 当它是最后一行时，不会启动新行。 请参阅 <guided-if-not-last> 以详细了解该标签。 |
||
| 7 |
<guided-results-found> |
如果后端搜索请求返回结果，则返回1；如果未返回，则返回0。 如果未指定 gsname ，则标记将假定主搜索。 此标签有助于将逻辑传递给JavaScript例程。 |
||
| 8 |
<guided-results-total> |
返回指定结果集中的结果总数。 当未提供 gsname 时，假定默认搜索。 |
||
| 9 |
<guided-results-lower> |
返回指定结果集页面上较低结果的结果编号。 当未提供 gsname 时，假定默认搜索。 |
||
| 10 |
<guided-results-upper> |
返回指定结果集页面上上结果的结果编号。 当未提供 gsname 时，假定默认搜索。 |
||
| 11 |
| 在找到结果时显示内容。 或者，在找不到结果时不显示结果HTML。 |
||
| 12 |
<guided-result-title /> |
<guided-result-title> 标签提供了使用 <title> 传输标签指定的标题传输模板字段的值。 |
||
| 13 |
<guided-result-description /> |
<guided-result-description> 标签提供了使用 <description> 传输标签指定的描述传输模板字段的值。 |
||
| 14 |
<guided-result-loc /> |
< guided-result-loc> 标签提供了使用 <loc> 传输标签指定的loc传输模板字段的值。 |
||
| 15 |
| 如果特定字段中有要显示的内容，则为true。 如果不存在内容，则条件为false。 使用标记来决定是否显示周围的HTML（如果不存在值，或者是否显示其他图像等）。 16 |
<guided-result-attribute-table gsname="tablename"> |
此标签提供在传输模板中定义的遍历属性表的循环，该属性表具有 <attribute_table> 传输标签。 有 <guided-result-attribute-table-field> 标签用于显示属性表字段值。 还可以在循环内使用plain guided-result-field 标签来显示其他结果字段。 |
| 17 |
<guided-result-attribute-table-field gsname="fieldname"> |
显示在传输模板中定义的属性表字段。
| ||
| 18 |
<guided-trace> |
输出在给定搜索的传输模板输出的JSON数据的常规部分内跟踪数据中找到的跟踪信息。 如果未提供搜索名称，则假定默认值。 |
||
| 19 |
<guided-result-trace /> |
输出在当前搜索结果的传输模板输出的JSON数据的结果>跟踪信息中找到的JSON内容。 此标记仅在 <guided-results></guided-results> 循环中有效。 |
彩块化
彩块化是可以深入搜索结果的导航组件。 您可以使用facet标签在您的演示文稿模板上显示各种facet。 您可以按名称引用彩块化。
请参阅关于Facet。
请参阅关于 Facet Rail。
请参阅关于动态彩块化。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<guided-dynamic-facets></guided-dynamic-facets> |
给定搜索的任何动态彩块化的循环上下文。 编辑 <guided-facet> 演示文稿模板标记，以便 <guided-dynamic-facets> 循环上下文自动提供gsname属性。 |
| 2 |
<guided-facet-display-name gsname=" facetname " /> |
返回facet的显示标签。 如果facet在传输模板上使用 <display-name> 标签，则该标签的内容将成为标签。 |
| 1 |
<guided-facet-rail></guided-facet-rail> |
定义演示文稿模板上的一个部分，该部分用作facet边栏中每个facet的重复图案。 属于facet边栏的每个facet都使用此部分来评估其输出。 以下是facet边栏的示例： 请注意，当 <guided-facet-rail> 标记内部的值在搜索时动态确定并正确替换时，以下标记不需要 gsname 属性：
Facet Rail 页上的排序条件确定facet的位置。 您可以从“排序彩块化方法”下拉列表中选择排序顺序。 此标记可以选择接受_dynamic_facets的 gsname属性值 ，该属性值为此搜索的任何动态彩块化提供循环上下文。此预定义的facet边栏也会显示在Business Rules用户界面中，以便操作在facet边栏“_dynamic_facets”中推送facet X以定位Y ”。 请参阅关于 Facet Rail。 另请参阅关于动态彩块化。 |
| 4 |
<guided-facet gsname=" facetname " height=" 60px " width=" 120px "></guided-facet> |
使用引导-facet 标签可定义一个区域，在该区域内，所有facet标签都与特定facet相关。 此标记也是布尔标记，如果facet中不存在任何值，则会隐藏所有内容。 在这种情况下，没有输出小平面值的点)。 高度和宽度属性是可选的，尺寸以像素(px)表示。 可视规则生成器(VRB)使用这两个属性，并在隐藏facet时将虚线框显示为交互式占位符。 当显示名称位于facet中且facet处于隐藏状态时，该名称也会隐藏。 但是，如果名称位于facet之外，则仅当区域标记或 guided-if-facet-visible 标记绕排时，才能隐藏该名称。 |
| 5 |
<guided-if></guided-if> |
当facet值的数量超过配置中定义的长度阈值时，此条件标记为true。 当列表过长时，使用它将facet显示为不同的UI元素(如截断的列表或滚动框)。 您还可以在名为的向导-facet 块的上下文之外使用此条件，方法是直接使用 gsname 属性引用特定facet。 |
| 6 |
<guided-if></guided-if> |
当点击facet至少一次且当前已选择facet值时，此条件标记为true。 它用于显示或隐藏HTML或gs标记，具体取决于是否单击了彩块化。 您还可以在名为的向导-facet 块的上下文之外使用此条件，方法是直接使用 gsname 属性引用特定facet。 |
| 7 |
<guided-if></guided-if> |
当只有一个facet值时，此条件标记为true。 当无法优化结果时，使用标记更改facet的显示。 您还可以在名为的向导-facet 块的上下文之外使用此条件，方法是直接使用 gsname 属性引用特定facet。 |
| 8 |
<guided-if></guided-if> |
当facet为多选时，此条件标记为true。 使用标记可更改 <guided-facet-rail> 或 <guided-dynamic-facets> 标记内facet的显示。
|
| 9 |
<guided-facet-values> facetname "]></guided-facet-values> |
这是facet value循环迭代器标签。 您可以在名为的向导facet 块的上下文中定义它，在这种情况下，可以忽略 gsname 。 或者，您可以在任何向导facet 块外定义它，但它需要 gsname 属性来标识显示哪组facet值。 您还可以使用此标记在命名为的向导-facet 块的上下文外显示facet值。 使用 gsname 属性直接引用特定facet。 |
| 10 |
<guided-facet-value> |
输出当前facet值的字符串。 默认情况下，该值为HTML转义。 您可以使用转义选项更改转义值的方式。 |
| 11 |
<guided-facet-count /> |
输出与当前facet值匹配的结果数。 |
| 12 |
<guided-facet-value-link></guided-facet-value-link> |
为要单击的站点访客在facet值字符串周围创建链接。 将自动生成路径，以按当前facet值缩小结果范围。 它支持将任何属性直接传递到锚点标签。 |
| 13 |
|
更改当前选定facet值时的显示。 如果它已经被选中，在大多数情况下，它不再可链接。 |
| 14 |
| 当facet值为重影值时，更改facet值的显示。 当facet值是重影值时，它通常以斜体文本显示，以指示该值缺失或“重影”。 以下代码摘录是facet块的示例： |
| 15 |
<guided-facet-undo-link gsname=" facetname "></guided-facet-undo-link> |
显示给定小平面的撤消链接。 如果存在多选彩块化，则此链接将取消选择给定彩块化的所有值。 为facet命名。 如果当前未选择facet，则链接为当前路径。 以下是此标记用法的示例： |
| 16 |
|
当facet值的数量超过配置中定义的长度阈值时，此条件标记为true。 当列表过长时，使用它将facet显示为不同的用户界面元素(如截断的列表或滚动框)。 您还可以在名为的向导-facet 块的上下文之外使用此条件，方法是直接使用 gsname 属性引用特定facet。 |
| 17 |
|
当点击facet至少一次且当前已选择facet值时，此条件标记为true。 它可用于显示或隐藏HTML或gs标记，具体取决于是否单击了彩块化。 您还可以在名为的向导-facet 块的上下文之外使用此条件，方法是直接使用 gsname 属性引用特定facet。 |
| 18 |
|
当只有一个facet值时，此条件标记为true。 当它无法优化结果时，它可用于更改facet的显示。 您还可以在名为的向导-facet 块的上下文之外使用此条件，方法是直接使用 gsname 属性引用特定facet。 |
| 19 |
|
此条件允许您检查指定的facet是否具有任何值。 您可以使用它来显示另一个facet而不是空的facet。 |
| 20 |
<guided-facet-total-count gsname=" facetname " /> |
输出给定facet内的结果总数。 |
| 21 |
<guided-facet-value gsname=" associated custom facet value "> |
输出与facet关联的值的字符串。 您可以有0个或多个与facet关联的字段。 具有关联字段很少见，因此您需要配置传输模板。 |
| 22 |
<guided-if-facet-value gsname=" associated custom facet value " /><guided-else-facet-value></guided-if-facet-value> |
测试facet值是否具有关联的字段值。 |
| 23 |
<guided-facet-link> value "+></guided-facet-link> |
在facet值字符串周围创建一个链接，供客户单击。 将自动生成路径，以按当前facet值缩小结果范围。 它支持将任何属性直接传递到锚点标签。 |
| 24 |
<guided-facet-value-path> |
创建指向facet值的您自己的链接。 默认情况下，该值为URL转义。 但是，可以通过指定要通过转义参数使用的转义模式，来添加另一个编码层。 |
| 25 |
<guided-facet-value-children></guided-facet-value-children> |
由于 <guided-facet-values> 迭代每个facet值，此标签迭代嵌套facet的所有子值。 在此标记中，使用典型的facet标记创建链接、创建撤消链接和显示facet值。 此标记必须位于 <guided-facet-values> 内，因为它进行嵌套循环。 使用此标记的示例如下： |
| 26 |
|
测试当前facet值是否具有子值。 建议在使用 <guided-facet-value-children> 标签之前使用。 “else”子句是可选的。 |
| 27 |
| 确定facet-values循环中的当前facet值是否高于长度阈值。 它通常用于在长彩块面上仅显示低于阈值的值（除非用户先前选择了在彩块面下方显示的“查看更多”链接）。 |
| 28 |
| 确定facet-values循环中的当前facet值是否等于长度阈值。 |
| 29 |
<guided-facet-value-undo-link></guided-facet-value-undo-link> |
显示给定选定的彩块化值的撤消链接。 使用它可在选定的facet值旁边显示撤消链接。 由于此撤消链接仅取消该特定选定值，因此它与 <guided-facet-undo-link> 不同，后者取消选择所有选定值。
注意： 如果facet没有多选行为，则两个撤消链接具有相同的行为。 即，彩块化只能有一个选定值。 如果当前未选择facet，则链接为当前路径。 仅在 guided-facet-values 循环中使用此标记。 |
| 30 |
<guided-facet-value-undo-path /> |
创建您自己的facet值撤消链接。 |
| 31 |
<guided-facet-undo-path gsname=" facetname " /> |
创建您自己的facet撤消链接。 与 <guided-facet-undo-link> 标签相似，只是它为您提供了构建自己的撤消链接的原始路径。 |
| 32 |
|
当给定facet具有选定值或单个值“value”时，有条件地显示HTML。 此标签集通常用于根据在另一个facet中选定的值显示facet。 |
| 33 |
<guided-facet-behavior gsname=" facetname " /> |
确定彩块化的行为，如正常、粘滞或多选。 对于收到XML结果并希望根据facet的行为动态更改facet显示方式的客户来说，此功能非常有用。 |
| 34 |
| 此标记所包裹的内容会根据facet的可见性状态进行隐藏或显示。 如果业务规则直接隐藏或显示facet，则facet内的任何内容将被隐藏或显示。 这些标记不必用facet来换行。 此标记的常用用途是当名称位于facet之外时隐藏显示名称。 在显示名称周围环绕此标记会在facet隐藏时使名称消失。 此标签替换区域，具有与使用区域相同的许多性能优势。 |
痕迹导航
请参阅关于痕迹导航。
| 标记 |
描述 |
|
|---|---|---|
| 3 |
<guided-breadcrumb> 痕迹 名称"></guided-breadcrumb> |
痕迹导航的循环标签。 对于当前状态的每个查询数，在开始标记和结束标记之间的任何内容都会重复。 如果省略 gsname ，则使用名为“default”的痕迹导航。 |
| 2 |
<guided-breadcrumb-link></guided-breadcrumb-link> |
在痕迹导航中创建链接。 默认行为是“goto”行为。 如果链接行为不同，请使用 gsname 可选属性指定“remove”或“drop”。 标记中包含的任何属性都会传递到生成的锚点标记。 |
| 1 |
<guided-breadcrumb-value /> |
值标签将打印出当前痕迹导航小版本的转换值。 它仅用于向导痕迹导航块的上下文。 |
| 4 |
<guided-breadcrumb-label /> |
标签标签输出痕迹导航值的标签，详细描述选择哪个facet来生成痕迹导航项。 它仅用于向导痕迹导航块的上下文。 |
| 5 |
|
如果当前痕迹导航值具有标签，则此条件标记用于有条件地显示内容。 它仅用于在标签实际存在时显示标签和相关内容。 它仅用于向导痕迹导航块的上下文。 |
| 6 |
<guided-breadcrumb-path> |
用于构建您自己的痕迹导航链接。 |
菜单
请参阅关于菜单。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<guided-menu gsname="menuname"></guided-menu> |
这是菜单值循环迭代器标签。 使用 gsname 属性来标识显示的菜单项集。 |
| 2 |
<guided-menu-item-link></guided-menu-item-link> |
为您提供用于优化当前菜单项搜索的URL。 |
| 1 |
<guided-menu-item-option> |
通常，菜单显示在模板上的选择控件中。 此标签使构建选择控件变得更简单，因为它生成用于为选择控件生成选项的HTML。 例如，以下代码块： 可以生成如下HTML: |
| 4 |
<guided-menu-item-value /> |
返回与菜单关联的值的字符串。 |
| 5 |
<guided-menu-item-label /> |
返回与菜单关联的标签的字符串。 |
| 6 |
<guided-menu-item-path /> |
返回路径字符串。 如果要向路径中添加参数并创建自定义链接，请使用标记。 |
| 7 |
|
返回1或0，指示是否选择了当前菜单项。 |
Pagenav
页面导航标记可用于构建一组链接，允许用户通过搜索结果进行页面。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<guided-pages></guided-pages> |
页面导航的循环标签。 每个页面都会重复出现开始标记和结束标记之间的任何内容。 |
| 2 |
<guided-page-link></guided-page-link> |
在页面导航中创建链接。 |
| 3 |
<guided-page-link gsname="first|prev|next|last|viewall|viewpages"></guided-page-link> |
创建指向第一页、上一页、下一页或最后一页的链接。 它还可以创建一个链接，用于视图一个页面上的所有页面。 |
| 4 |
<guided-page-number /> |
返回具有当前页码的字符串。 |
| 5 |
|
如果选择了当前重复的页面，则此条件标记集为true。 它通常用于在页面导航控件中以不同方式显示页码。 |
| 6 |
|
如果当前页面有上一页，则此条件标记集为true。 它通常用于显示页面导航中的上一个链接（如果有意义）。 |
| 7 |
|
如果当前页面有下一页，则此条件标记集为true。 它通常用于显示页面导航中的上一个链接（如果有意义）。 |
| 8 |
|
当搜索返回大的结果集时，您可能不想优惠视图所有结果的能力。 因此，您可以使用这组条件标签确定何时显示视图全部链接。 |
| 9 |
|
您可以使用这组条件标签确定何时显示视图页链接。 它通常用于允许客户视图特定页面。 |
| 10 |
| 测试页面导航是否有第一页、上一页、下一页等。 |
| 11 |
<guided-page-total /> |
返回包含搜索结果总页数的字符串。 |
| 12 |
|
使用引导式分页标签可定义一个区域，在您定义的页面导航设置很少的情况下，所有分页标签都与特定分页设置相关。 |
| 13 |
| 在页面导航中创建您自己的链接。 |
| 14 |
|
测试页面导航中的最高页面是否等于页面总数。 |
| 15 |
|
测试页面导航中的最低页面是否等于该页面。 |
| 16 |
<guided-if-page-is-multipage> <guided-else-page-is-multipage> </guided-if-page-is-multipage> |
测试是否有一页结果或多页结果。 |
最近搜索
您可以使用最近搜索标记构建一组链接，让用户快速运行以前的搜索，如下例所示：
<guided-if-recent-searches>
<span>Recent Searches</span><br/>
<guided-recent-searches>
<guided-recent-searches-link><guided-recent-searches-value></guided-recent-searches-link><br/>
</guided-recent-searches>
<guided-recent-searches-clear-link>Clear Recent Searches</guided-recent-searches-clear-link>
</guided-if-recent-searches>
请参阅配置最近搜索。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<guided-recent-searches></guided-recent-searches> |
最近搜索的循环标签。 每个页面都会重复出现开始标记和结束标记之间的任何内容。 |
| 2 |
|
允许您构建指向最近搜索的链接。 它支持将任何HTML属性直接传递到锚点标签。 |
| 3 |
<guided-recent-searches-path /> |
允许您在向导——最近搜索循环中获取最近搜索的相对URL路径。 通常，您会使用 guided-recent-search-link 。 但是，如果要构建自己的链接，可以使用此标签。 以下是一个示例： |
| 4 |
<guided-recent-searches-value> |
允许您获取与最近搜索关联的查询词。 |
| 5 |
<guided-recent-searches-clear-link></guided-recent-searches-clear-link> |
允许您优惠客户清除最近保存的搜索。 |
| 6 |
<guided-recent-searches-clear-path /> |
返回 <guided-recent-searches-clear-link> 使用的路径，以便您能够构建自己的链接。 |
| 7 |
| 允许您在客户执行最近搜索时显示最近搜索。 |
Did You Mean
当搜索未返回任何结果且搜索词未在帐户的词典中时，您可以使用“是否是真”标记来构建指向建议的链接集。 以下是使用Did You Mean标记的示例：
<guided-if-suggestions>
<span>Did You Mean?</span><br/>
<guided-suggestions>
<guided-suggestion-link><guided-suggestion/></guided-suggestion-link><br/>
</guided-suggestions>
</guided-if-suggestions>
请参阅关于 Did You Mean。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<guided-suggestions></guided-suggestions> |
这是用于循环查看建议的循环标记。 |
| 2 |
<guided-suggestion-link></guided-suggestion-link> |
创建指向给定建议的链接。 |
| 1 |
<guided-suggestion-value /> |
|
| 4 |
|
允许您测试是否有任何建议。 |
| 5 |
<guided-suggestion-path /> |
返回建议的路径字符串。 您可以使用它构建自己的锚点标签。 通常，使用向导建议链接。 |
| 6 |
<guided-suggestion /> |
建议。 |
| 7 |
<guided-suggestion-result-count /> |
建议的结果计数。 |
| 8 |
|
允许您测试是否执行了根据建议对零结果进行自动搜索（如果此功能已启用）。 |
| 9 |
<guided-suggestion-original-query /> |
如果执行了自动搜索，则返回原始查询。 使用示例： |
| 10 |
|
如果由于结果计数不足而有建议，则此条件为真，如果此功能已打开。 以下是使用此标记的示例： |
自动完成
以下标记可用于向搜索表单添加自动完成功能。 需要头内容和表单内容标签才能正确实现自动完成功能。 建议您使用标记，而不是将自动完成的Javascript和CSS硬编码到演示文稿模板中。 原因在于，每当您更改自动完成设置时，标记使您的模板能够拾取任何新的失败缓存ID，而无需手动更新模板。
请参阅关于自动完成。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<guided-if-autocomplete> <guided-else-autocomplete> </guided-if-autocomplete> |
检测是否启用自动完成功能。 您可以使用标记来选择自动完成所需的头部和表单内容。 反过来，这又允许您打开和关闭功能，无需更改演示文稿模板。 |
| 2 |
<guided-ac-css /> |
用在演示文稿模板的标题中，并替换为相应的CSS脚本，其中包括自动完成。 |
| 1 |
<guided-ac-form-content /> |
用于演示文稿模板的搜索表单（位于 <form> 和 </form> 标记之间），而不是硬编码表单中的自动完成标记。 标记将替换为完成自动完成工作所需的相应HTML。 |
| 4 |
<guided-ac-javascript /> |
生成自动完成JavaScript的链接。 为获得最佳性能，建议将此标记放在页面底部附近的结束“body”标记之前。 |
存储
使用以下标记测试和显示用户当前所在的商店。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<guided-store /> |
输出当前存储。 |
| 2 |
<guided-if-store-defined> <guided-else-store-defined> </guided-if-store-defined> |
检测用户是否在商店中。 |
| 1 |
<guided-if-store gsname="store"> <guided-else-store> </guided-if-store> |
检测用户是否在商店中， gsname 参数指定。 |
区域
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<guided-zone gsname="zone area"> |
您可以用区域标签中的任何内容来创建区域。 这允许您使用业务规则根据需要显示区域。 默认情况下，始终显示区域。 您可以使用可选的搜索和facet参数来指示与区域关联的搜索或facet。 此类功能可让软件在隐藏区域时跳过搜索或彩块化，从而提高搜索时间性能。 高度和宽度属性是可选的，用于配置删除区域时占位符在可视规则生成器中的显示方式。 使用 guided-if-facet[-not]-visible 标记，而不是尽可能使用区域。 它简化了演示文稿模板。 |
| 2 |
<guided-if-zone gsname="zone area"> <guided-else-zone> </guided-if-zone> |
这组标记允许测试当前是否显示区域。 当您在页面上的其他位置有内容并且仅希望在显示区域时显示时，此功能非常有用。 |
循环指示器
您可以在以下任何循环块中使用以下每个循环指示符：
- 引导结果
- 向导彩块化值
- 引导痕迹导航
- 向导菜单项
- 向导页面
| 标记 |
描述 |
|
|---|---|---|
| 1 |
|
当当前迭代是循环的第一次迭代时，此条件为true。 这并不一定意味着第一个结果或第一页，而是显示的第一个结果。 如果站点访客位于每页10的结果集的第2页，则第一个小版本为结果11。 |
| 2 |
|
当当前迭代是循环的上次迭代时，此条件为true。 这不一定意味着最后一个结果或最后一页，而是当前上下文（页面）中显示的最后一个结果。 如果站点访客位于包含200个结果但每页只有10个结果的结果集的第1页，则上次迭代的结果为10，而不是结果200。 |
| 1 |
|
当当前迭代是循环的奇数迭代（与偶数迭代相比）时，此条件为真。 这有助于显示不同的行颜色。 |
| 4 |
|
当当前迭代是循环的偶次迭代（与奇次迭代相比）时，此条件为真。 这有助于显示不同的行颜色。 |
| 5 |
|
当当前迭代是循环的偶次迭代时，此条件为true。 这有助于显示不同的行颜色。 |
| 6 |
|
如果当前小版本既不是第一个小版本，也不是最后一个小版本，则包括它们之间的文本。 |
| 7 |
|
如果当前小版本是第一个或最后一个，则包括它们之间的文本。 |
| 8 |
<guided-loop-index> |
一个整数（从0开始），其值递增循环的每次迭代。 |
| 9 |
<guided-loop-counter> |
整数（从1开始），其值为循环的每次迭代递增。 |
其他语言
以下标记可用于使用模板执行更高级的操作，如构建自己的微型facet。
| 标记 |
描述 |
|||
|---|---|---|---|---|
| 1 |
<guided-current-path> |
为您提供当前使用的路径。 通常，它用于创建一个链接，该链接将新参数添加到现有搜索中。 默认情况下，路径为URL转义。 您可以通过转义参数指定要使用的转义模式。 示例： 在此示例中，搜索处理规则使用lang来选择法语版本。 当前路径始终至少具有一个查询参数。 如果不存在其他查询参数，则将其设置为 q=* ，以便更轻松地添加更多参数。 |
||
| 2 |
基本路径 |
如果要使用basepath创建链接，请在 href 的开始使用 / 并添加参数。 |
||
| 1 |
<guided-query-param gsname="query_parameter"> |
允许您获取URL上查询参数的现有值。 如果参数不存在，则此标记返回空字符串。 如果不指定转义选项，则返回的字符串将自动转义为HTML转义，则可以指定HTML转义或URL转义。 示例：
| ||
| 4 |
<guided-query-param-name gsname="param#" offset="offset_number" /> |
“引导搜索”具有查询编号的概念，用于痕迹导航控件。 guided-查询-param-name允许您 将参数定义为演示文稿模板中某个链接的一部分，在该链接中，“向导式搜索”会为您绘制正确的查询号。 gsname 中有一个“x”,“向导式搜索”将替换为正确的数字。 偏移值可以是0 - 15，其中0表示使用下一个可用查询号。 1表示您要向其添加1，依此类推。 结合向导-current-path ，您可以构建自己的迷你facet链接或允许额外的向下钻取级别。 示例： |
||
| 5 |
<guided-include gsfile="filename" /> |
允许您包含其他模板文件。 此功能意味着您可以使用子模板作为模块创建多个模板。 在以下示例中，包含痕迹导航和 facet 文件： 不支持动态包含。 换言之， gsfile 不能是变量。 |
||
| 6 |
<guided-search-time> |
标识搜索所花费的时间。 返回的搜索时间值以毫秒为单位指定。 |
||
| 7 |
<guided-fall-through-searches> |
返回用于构建搜索结果页面的核心搜索数。 |
||
| 8 |
<guided-if-fall-through-search></guided-if-fall-through-search> |
测试核心搜索的计数是否大于1。 |
||
| 9 |
|
当当前迭代是循环的偶次迭代（与奇次迭代相比）时，此条件为真。 这有助于显示不同的行颜色。 |
||
| 10 |
|
当当前迭代是循环的偶次迭代时，此条件为true。 这有助于显示不同的行颜色。 |
||
| 11 |
|
如果当前小版本既不是第一个小版本，也不是最后一个小版本，则包括它们之间的文本。 |
||
| 12 |
|
如果当前小版本是第一个或最后一个，则包括它们之间的文本。 |
||
| 13 |
|
允许您检查是否处于初始搜索状态(查询是搜索框中的搜索结果)。 |
||
| 14 |
<guided-search-url /> |
您可以在模板中使用此标记，以免硬编码搜索表单的操作。 它会检测您何时处于“暂存”或“实时”环境，并相应地进行更改。 |
||
| 15 |
<guided-if-query-param-defined gsname="query_parameter"> <guided-else-query-param-defined> </guided-if-query-param-defined> |
这组标签允许您测试在搜索路径中定义的CGI参数。 仅当参数的值已定义时，才能测试它们。 |
||
| 16 |
<guided-next-query-number> |
驱动模板的引导式搜索引擎的概念是浮动查询号，引擎生成的每个新链接都使用下一个可用查询号。 通过此标签，您可以获取下一个查询号或偏移，以便构建可钻入结果集的自定义链接。 偏移允许您偏移到下一个查询号。 例如，如果您选择了一个facet，则下一个查询号为2，偏移量为1，返回的查询号为3。 |
||
| 17 |
<guided-custom-var gsname="custom_variable"> |
允许您获取处理规则定义的自定义变量的现有值。 如果不指定转义选项，则返回的字符串将自动转义为HTML转义，可指定 html 、 url 、 js 或 0 。 如果您使用处理规则将传入的CGI参数复制到自定义变量，然后在模板中显示或使用该变量并将转义设置为无或js，那么您可以在搜索中创建XSS漏洞。 |
||
| 18 |
<guided-if-custom-var-defined gsname="custom_variable"> <guided-else-custom-var-defined> </guided-if-custom-var-defined> |
在处理规则(查询清理、搜索前处理和搜索后处理)中定义自定义变量时启用测试。 |
||
| 19 |
<guided-general-field gsname="searchname" field="fieldname"> |
用于显示传输模板中定义的常规字段的内容。 如果不指定转义选项，则返回的字符串将以您在该字段的传输模板中指定的格式进行编码。 指定转义选项适用于编码字段的任何格式（如传输模板中）。 您可以指定 html 、 url 、 js 、 json 或 0 。 |
||
| 20 |
<guided-if-general-field gsname="searchname" field="fieldname"> <guided-else-general-field> </guided-if-general-field> |
启用测试，如果传输模板中定义的常规字段的内容存在。 |
||
| 21 |
<guided-cookie-value gsname="cookie_name"> |
允许您获取Cookie的值（假定Cookie可用）。 如果不指定转义选项，则返回的字符串将自动转义为HTML转义，您可以指定 html 、 url 、 js 、 json 或 0 。 |
||
| 22 |
<guided-if-cookie gsname="cookie_name"> <guided-else-cookie> </guided-if-cookie> |
如果Cookie存在，则启用测试。 |
||
| 23 |
<guided-banner gsname="banner area"> |
输出给定区域的横幅。 可视规则生成器中使用可选的宽度和高度属性，以显示有意义的占位符，让用户选择横幅。 默认情况下，横幅不会转义。 而是要将HTML插入演示文稿模板。 但是，如果要构建JSON模板，请考虑使用js转义选项。 示例： 24 |
<guided-if-banner-set gsname="banner area"> <guided-else-banner-set> </guided-if-banner-set> |
在设置横幅区域时启用测试。 |
| 25 |
<guided-if-simulator-mode> <guided-else-simulator-mode> </guided-if-simulator-mode> |
允许您检测在模拟器或可视规则生成器中查看搜索的时间。 它通常用于显示额外的调试信息。 |
||
| 26 |
<guided-if-tnt-business-rules> <guided-else-tnt-business-rules> </guided-if-tnt-business-rules> |
允许您检测是否有任何引用Adobe Target活动的业务规则。 它通常用作与Adobe Target集成的一部分，以防止在不需要时对目标服务器进行攻击。 |
||
| 27 |
<guided-redirect /> |
默认情况下，会自动执行重定向。 但是，如果您已配置网站搜索／销售以将XML或JSON响应返回给Web应用程序，则可以选择在Web应用程序中解析302/301响应，或将重定向作为结果集的一部分传递给您。 如果您作为结果集的一部分传递重定向，则可以在模板中使用此标签来输出重定向位置。 |
||
| 28 |
<guided-if-redirect> <guided-else-redirect> </guided-if-redirect> |
当您在结果集中配置了网站搜索／销售以返回重定向时，可以使用这组标记来确定是否存在指向输出的重定向。 |
||
| 29 |
<guided-lt /> <guided-gt /> |
这组标记允许您在HTML属性中嵌入引导模板标记。 示例： |
传输模板标记
传输模板是XML模板，可将数据从后端搜索传递到引导式搜索表示层。
在表示层中，您可以有一个表示多个搜索结果的单一表示模板。 每个搜索都可以使用相同的传输模板或自定义传输模板将数据传递到表示层。
由于传输模板仅用于向表示层传递数据，因此它没有任何与显示搜索结果相关的HTML。 传输模板使用传输模板XML标记传递搜索结果以填充引导搜索组件，如彩块化、痕迹导航和菜单。 在这些标记中，标准搜索模板标记用于显示实际值。
请参阅编辑演示文稿或传输模板。
请参阅搜索模板标记。
| 传输模板标签 |
描述 |
|---|---|
| <guided-xml></guided-xml> |
表示层用来检测从传输模板中解析的内容的根XML标签。 |
| <general></general> |
标记环绕搜索模板标记，这些标记根据结果集提供摘要数据。 通常，这些标记包含搜索标记，用于搜索结果总数、较低结果和最高结果。 您可以使用 general-field 标记定义所需的任意数量的附加全局字段，如下例所示： |
| <results></results> |
标记会打包在搜索结果周围，这样“向导式搜索”就知道在何处查找它们。 |
| <result></result> |
标记会围绕每个搜索结果进行包装，以便“向导式搜索”能够识别单个搜索结果开始和结尾的内容的位置，如下例所示： <results>
<search-results>
<result>
<index><search-index /></index>
<loc><search-cdata><search-url length="500" /></search-cdata></loc>
</result>
</search-results>
</results> |
| <attribute-table name="tablename"> |
允许您在多值列表中循环查看每个项目，以获得单个结果。 仅在结果中使用此标记。 其目的是让您对属于结果字段的属性进行迭代，如下例所示： <results>
<search-results>
<result>
<index><search-index /></index>
<loc><search-url /></loc>
<title><search-title /></title>
<attribute-table name="downloads">
<field name="download_title"><search-display-field name="download_title" /></field>
<field name="download_link" delimiter="|"><search-display-field name="download_link" /></field>
</attribute-table>
</result>
</search-results>
</results> |
| <facets></facets> |
传递填充彩块化的结果。 |
| <dynamic-facet></dynamic-facet> |
您可以将一个彩块化指定为动态彩块化和彩块化栏的成员。 但是，在相关的演示模板标签方面，他们的待遇是独立的。 换言之，不允许在动态facet循环上下文中嵌套facet边栏循环上下文，反之亦然。 对于动态和有栏的彩块化，只有为给定搜索返回的那些动态彩块化才会显示在彩块化循环上下文中。 |
| <facet name="name"></facet> |
每个facet都有其自己的facet标记，其中name参数与facet名称匹配。 搜索标记在facet值的facet标记中使用，如下例所示： <facets>
<facet name="brand">
<values><search-field-value-list name="brand" quotes="no" commas="yes" data="values" sortby="values" /></values>
<counts><search-field-value-list name="brand" quotes="no" commas="yes" data="counts" sortby="values" /></counts>
</facet>
<facet name="category">
<values><search-field-value-list name="category" quotes="no" commas="yes" data="values" sortby="values" /></values>
<counts><search-field-value-list name="category" quotes="no" commas="yes" data="counts" sortby="values" /></counts>
</facet>
</facets> 使用时隙facet的帐户可以使用动态标记和显示名称标记。 这两个标签有助于在创建业务规则时在时隙彩块化和实际彩块化之间进行映射。 <facets>
<facet name="facet_values01">
<dynamic>1</dynamic>
<display-names><search-field-value-list name="facet_names01" quotes="no" commas="yes" data="values" sortby="values" /></display-names>
<values><search-field-value-list name="facet_values01" quotes="no" commas="yes" data="values" sortby="values" /></values>
<counts><search-field-value-list name="facet_values01" quotes="no" commas="yes" data="counts" sortby="values" /></counts>
</facet> |
| <search-display-field separator=","> |
使用分隔符属性，可以更改在输出列表的search-display-field数据时使用的分隔符。 默认值为逗号。 通常，您使用的分隔符应该是字段内容中不易出现的分隔符。 |
| <suggestions></suggestions> |
将您的意思包含在标签中，这样“向导式搜索”可以识别哪些XML节点包含建议。 请参阅关于 Did You Mean。 |
| <suggestion></suggestion> |
将每个“您的意思”建议用标记括起来，如下例所示： <search-if-suggestions>
<suggestions>
<search-suggestions>
<suggestion><search-suggestion-text /></suggestion>
</search-suggestions>
</suggestions>
</search-if-suggestions> 请参阅关于 Did You Mean。 |
搜索模板标记
搜索模板是包含站点搜索／销售定义的模板标记的HTML文件。 这些标记指示搜索结果的格式。 以下参考内容包含每个搜索模板标记及其属性的简要说明。
仅在传输模板文件(.tpl)中使用搜索模板标记。
您可以从以下搜索模板标记组和参考材料中进行选择。
仅在结果循环中有效的标记包括：
在整个模板中有效的标记包括：
搜索模板引用主题
关于结果循环标签
结果循环标签是模板系统的主要功能。 在搜索过程中遇到标记时，HTML会重复出现，开始和结束结果循环标记之间会有其他标记，用搜索结果替换任何其他标记。
<search-results> ... </search-results>
显示搜索结果的HTML周围有结果循环标签。 标记之间的HTML会针对每个结果重复，并显示在页面上。
以下标记仅在结果循环中有效：
结果循环字符串标记
以下标签返回字符串。
请参阅关于结果循环标签。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-index> |
返回当前结果的数值索引。 |
| 2 |
<search-title length="XX"> |
返回当前结果的页面标题。 可选长度属性用于限制显示的字符串长度，默认长度为80个字符。 |
| 3 |
<search-bodytext length="XX" encoding="html/javascript/json/perl/url/none"> |
返回从页面顶部开始的正文文本。 相关术语以粗体显示。 可选长度属性用于限制显示的字符串长度，默认长度为80个字符。 编码属性是可选的，它可以使用HTML编码（默认）、Javascript编码、Perl编码或无编码对输出字符进行编码。 |
| 4 |
<search-description length="XX" encoding="html/javascript/json/perl/url/none"> |
返回当前结果的描述。 如果元描述标签存在且内容属性不为空，则显示该文本。 否则，将显示页面正文文本的开头。 可选长度属性用于限制显示的字符串长度，默认长度为80个字符。 可选的编码属性控制输出是否是HTML编码、JavaScript编码、Perl编码、URL编码或未编码，以在结果页上输出。 编码的的默认值为 html 。 通常，您无需指定编码属性。 |
| 5 |
<search-score rank="dynamic/static/dynamic-raw/static-raw/final-raw" precision="XX"> |
返回当前结果的得分，即数字0 - 100。 如果已在选项 > 元数据 > 定义下定义了排名字段，则可以通过将排名属性设置为动态( <search-score rank="dynamic"> )来显示动态页面排名。 通过将rank属性设置为static( <search-score rank="static"> )，可以显示静态页面排名。 您可以使用可选的precision属性指定要显示的小数位数。 默认值为0，显示整数得分)。 |
| 6 |
<search-date length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id"> |
返回当前结果的日期。 如果没有与当前结果关联的日期，则显示可选的“无”文本值。 如果未提供可选的“无”值，则如果没有与当前结果关联的日期，则显示文本“无日期”。 “date-format”属性采用UNIX样式的日期格式字符串，如“%A, %B %d, %Y”（对于“2016年7月25日，星期一”）。 "gmt"默认为"yes"，并控制日期字符串的时间部分应以GMT("yes")还是帐户的时区("no")输出。 “语言”属性控制输出日期字符串的语言和区域设置约定。 “0”（默认）表示“使用帐户语言”。 “2”指“使用文档语”。 “语言”值“1”保留供将来使用。 任何其他“语言”值都解释为特定语言标识符，例如，“en_US”表示“英语（美国）”。 可选长度属性用于限制显示的字符串长度，默认长度为80个字符。 |
| 7 |
<search-size> |
返回当前结果的大小（以字节为单位）。 |
| 8 |
<search-url length="XX" encoding="html/javascript/json/perl/url/none"> |
返回当前结果的URL。 使用可选的 length 属性限制显示的字符串长度，默认字符数不限。 编码属性是可选的，它可以使用HTML编码、Javascript编码、Perl编码或无编码对输出字符进行编码。 |
| 9 |
<search-url-path-query length="XX"> |
返回路径和查询部分，包括当前结果URL的问号。 使用可选的 length 属性限制显示的字符串长度，默认字符数不限。 |
| 10 |
<search-context length="XX" encoding="html/javascript/json/perl/url/none"> |
返回搜索词的下一行上下文。 相关术语以粗体显示。 重复调用此标记可显示当前结果的多个上下文行。 使用可选的 length 属性限制显示的字符串长度，默认长度为80个字符。 如果此标记由 <search-if-context> 或 <search-if-any-context> 标记集包含，则忽略长度属性。 编码属性是可选的，它可以使用HTML编码（默认）、Javascript编码、Perl编码或无编码对输出字符进行编码。 |
| 11 |
<search-display-field name="field-name" length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id" encoding="html/javascript/json/perl/url/none" quotes="yes/no" commas="yes/no" units="miles/kilometers" separator="|"> |
此高级标记显示当前结果中在名称属性中指定的元数据字段(url、标题、desc、键、目标、正文、alt、日期、字符集和语言或字段)的内容。 例如： <search-display-field name="title" length="70" none="no title"> 输出搜索结果的页面标题。 如果未指定可选的属性，则只有在没有与字段关联的内容的情况下，才会在结果页上显示其值。 日期格式、 gmt 和语言属性仅在指定字段的内容类型为日期时才相关。 日期格式属性采用UNIX样式日期格式字符串，如 %A、%B %d、%Y （2016年7月25日星期一）。 gmt 默 认 为是，并控制日期字符串的时间部分是以GMT( 是 )还是以帐户的时区( 否 )输出。 请参阅日期格式字符串。 语言属性控制输出日期字符串的语言和区域设置约定。 0(默 认)表示“使用帐户语言”。 2 表示“使用文档语”。语言值 1 保留供将来使用)。 任何其他语言值都解释为特定语言标识符，例如， en_US 表示“英语（美国）”。 请参阅语言标识符。 可选的 length 属性用于限制显示的字符串长度，默认值为80个字符。 可选的编码属性控制输出是否是HTML编码、JavaScript编码、Perl编码、URL编码或未编码，以在结果页上输出。 编码的的默认值为 html 。 通常，您无需指定编码属性。 可选的引号属性控制各个项目的输出是否用多次引号（如果 encoding=perl ，则为单引号）。 引号的默认值为 no 。 可选的逗号属性控制各个项目输出是否以逗号分隔。 逗号的默认值为是。 对于非列表类型字段，将忽略逗号属性。 可选的单位属性控制应用于邻近搜索输出字段的距离单位。 单位的默认值是根据与给定邻近搜索输出字段关联的位置类型字段的“默认单位”设置确定的。 可选的分隔符属性定义在列表类型字段的输出值之间插入的单个字符或分隔符。 |
| 12 |
<search-display-field-values name="field-name"> ...<search-display-field-values> |
此标记创建一个循环，用于枚举当前结果的元数据字段值(url、title、desc、keys、目标、body、alt、date、charset和在选项 > 元数据 > 定义下定义的语言或字段)。 请勿将此标记嵌套在另一个 <search-display-field-values> 标记中。 名称属性指定包含要枚举的值的字段的名称。 此标记对于选中允许列表属性的字段最有用（在选项 > 元数据 > 定义下）。 |
| 13 |
<search-display-field-value date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none"> |
此标签输出当前 <search-display-field-values> 循环迭代的元数据字段值(url、title、desc、keys、目标、body、alt、date、charset和在选项 > 元数据 > 定义下定义的语言或字段。 此标记仅在 <search-display-field-values> 循环中有效。 日期格式、 gmt 和语言属性仅在封闭 <search-display-field-values> 标签中指定字段名称的内容类型为日期时才相关。 日期格式属性采用UNIX样式日期格式字符串，如 "%A , %B %d , %Y "（201年7月25日"星期一）6”)。 gmt 属性默认为是，并控制日期字符串的时间部分是以GMT（是）输出还是以帐户的时区（否）输出。 语言属性控制输出日期字符串的语言和区域设置约定。 0(默 认)表示“使用帐户语言”。任何其他语言值都解释为特定语言标识符，例如， en_US 表示“英语（美国）”。 可选的编码属性控制输出是否是HTML编码、JavaScript编码、Perl编码、URL编码或未编码，以在结果页上输出。 编码的的默认值为 html 。 通常，您无需指定编码属性。 |
| 14 |
<search-display-field-value-count name="field-name"> |
输出当前结果中使用名称属性指定的元数据字段(url、title、desc、keys、目标、body、alt、date、charset和语言或字段在选项 > 元数据 > 定义下定义的值总数。 此标签可显示在结果循环中的任意位置。 |
| 15 |
<search-display-field-value-counter> |
输出当前 <search-display-field-values> 循环迭代的序数计数器（1、2、3等）。 此标记仅在 <search-display-field-values> 循环中有效。 |
| 16 |
<search-dynamic-facet-fields> |
为此搜索返回的任何动态彩块化字段开始循环上下文。 |
| 17 |
<search-dynamic-facet-field-name> |
输出此循环迭代的当前动态彩块化字段的名称。 |
| 18 |
<search-result-trace encoding="html/javascript/ json/perl/url/none"> |
输出与当前结果的位置相关的信息，例如影响结果位置的任何基于结果的操作。 此标记的输出格式为JSON，如下例所示： 编码属性是可选的；默认值为 html 。
注意： 仅当使用核心搜索查询参数指定 sp_trace=1 时，此标记才具有输出。 请参见后端搜索CGI参数中的表中的第48行。 |
结果循环条件标签
以下标记有条件地包括它们之间的HTML。
请参阅关于结果循环标签。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-if-title> ... </search-if-title> <search-if-not-title> ... </search-if-not-title> |
如果对 <search-title> 的下次调用从文档标题返回（或不返回）文本，则这些标记包括它们之间的HTML。 |
| 2 |
<search-if-description length="XX"> ... /search-if-description> <search-if-not-description> ... </search-if-not-description> |
如果对 <search-description> 的下次调用从文档描述返回（或不返回）文本，则这些标记包括它们之间的HTML。 |
| 1 |
<search-if-bodytext> ... </search-if-bodytext> <search-if-not-bodytext> ... </search-if-not-bodytext> |
如果对 <search-bodytext> 的下次调用从文档正文返回（或不返回）文本，则这些标签包括它们之间的HTML。 |
| 4 |
<search-if-context length="XX"> ... </search-if-context> <search-if-not-context> ... </search-if-not-context> |
如果对 <search-context> 的下次调用返回（或不返回）非空的上下文字符串，则这些标记包括它们之间的HTML。 length属性覆盖任何包含的 <search-context> 标签上的length属性。 |
| 5 |
<search-if-any-context length="XX"> ... /search-if-any-context> <search-if-not-any-context> ... </search-if-not-any-context> |
如果存在（或不存在）与结果关联的上下文字符串，则这些标签包括它们之间的HTML。 length属性覆盖任何包含的 <search-context> 标签上的length属性。 |
| 6 |
<search-if-score lower="XX" upper="yy" rank="dynamic/static/dynamic-raw/static-raw/final-raw"> ... </search-if-score> <search-if-not-score lower="XX" upper="yy" rank="dynamic/static"> ... </search-if-not-score> |
如果当前结果的得分在XX和YY之间（或不在），则这些标记包括它们之间的HTML。 对于添加项目符号或图形来显示结果的相关性非常有用。 如果已在选项 > 元数据 > 定义下定义了排名类型字段，则可以通过将排名属性设置为动态( <search-if-score rank="dynamic" lower=XX upper=YY> )来检查动态页面的排名。 通过将rank属性设置为static( <search-if-score rank="static" lower=XX upper=YY> )，可以检查静态页面排名。 |
| 7 |
<search-if-field name="field-name" value="value"> ... </search-if-field> <search-if-not-field name="field-name" value="value"> ... </search-if-not-field> |
这些高级标记包括它们之间的HTML，这取决于在“name”属性中指定的字段是否包含内容。 如果指定了可选的“value”属性，则根据给定值是否与当前结果中字段的值匹配（或不匹配），标记将在它们之间包含HTML。 这些标记仅在结果循环中起作用（在 <search-results> 和 </search-results> 标记之间）。 |
结果循环锚点链接标签
请参阅关于结果循环标签。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-link target="frame-name" hbx-enable="yes/no" hbx-linkid-name="field-name" hbx-linkid-none="text" hbx-linkid-length="XX"> ... </search-link> |
这对标签在它们之间围绕HTML创建锚点链接。 单击链接后，将显示结果页。 可选的目标属性指定了指定窗口，在该窗口中，支持帧的浏览器应显示结果页。 将hbx-enable属性设置为“是”，以利用通过HBX提供的分析。 将hbx-linkid-name设置为要跟踪的元数据字段的名称。 例如，要按SKU编号跟踪搜索结果，请将hbx-linkid-name设置为包含SKU信息的元数据字段的名称。 当前不支持日期类型字段。 hbx-linkid-name的值将附加到生成的锚点中的链接ID。 只要命名的元数据字段为空，hbx-linkid-none属性的值就会附加到链接ID。 hbx-linkid-length的值限制从Meta标记获取和显示的字符数。 默认字符数为12。 |
| 2 |
<search-smart-link target="frame-name" hbx-enable="yes/no" hbx-linkid-name="field-name" hbx-linkid-none="text" hbx-linkid-length="XX"> ... </search-smart-link> |
这对标记类似于 <search-link> ... </search-link> 标记。 单击生成的锚点链接时，将显示结果页，但页面滚动到结果前最近的锚点标签。 对于PDF链接，Acrobat查看器显示包含结果的页面。 可选的目标属性指定了指定窗口，在该窗口中，支持帧的浏览器应显示结果页。 将hbx-enable属性设置为“是”，以利用通过HBX提供的分析。 将hbx-linkid-name设置为要跟踪的元数据字段的名称。 例如，要按SKU编号跟踪搜索结果，请将hbx-linkid-name设置为包含SKU信息的元数据字段的名称。 当前不支持日期类型字段。 hbx-linkid-name的值将附加到生成的锚点中的链接ID。 只要命名的元数据字段为空，hbx-linkid-none属性的值就会附加到链接ID。 hbx-linkid-length的值限制从Meta标记获取和显示的字符数。 默认字符数为12。 |
| 1 |
<search-if-link-extension> ... </search-if-link-extension> <search-if-not-link-extension> ... </search-if-not-link-extension> |
如果值属性指定的扩展与结果的URL结尾匹配，则这些标签包括它们之间的HTML。 此标记对于在基于链接扩展的搜索结果中包含图形很有用。 value属性是一个或多个扩展（空格分隔）的列表，如下所示：VALUE="。pdf"或VALUE="。html .htm"。 |
循环位置条件标签
以下标记有条件地包括它们之间的文本。 它们只能显示在“循环”标记中：search-results>和<search-field-values>。 它们用于测试当前结果在结果集中的位置。
请参阅关于结果循环标签。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-if-first> ... </search-if-first> <search-if-not-first> ... </search-if-not-first> |
如果当前结果是（或不是）页面上的第一个结果（在 <search-results> 中使用）或第一个字段值（在 <search-field-values> 中使用），则这些标记包括它们之间的文本。 |
| 2 |
<search-if-last> ... </search-if-last> <search-if-not-last> ... </search-if-not-last> |
如果当前结果是（或不是）页面上的最后一个结果（在 <search-results> 中使用）或最后一个字段值（在 <search-field-values> 中使用），则这些标记包括它们之间的文本。 此标签可用于在结果之间插入分隔符。 例如，这会在结果之间插入 <hr> 标签： |
| 1 |
<search-if-inner> ... </search-if-inner> <search-if-not-inner> ... </search-if-not-inner> |
如果当前结果不是页面上的第一个或最后一个结果（在 <search-results> 中使用），或者不是第一个或最后一个字段值（在 <search-field-values> 中使用），则这些标记包括它们之间的文本。 标签的not版本测试结果是第一个还是最后一个。 |
| 4 |
<search-if-alt> ... </search-if-alt> <search-if-not-alt> ... </search-if-not-alt> |
如果当前结果是（或不是）页面上的替代结果（在 <search-results> 中使用）或替代字段值（在 <search-field-values> 中使用），则这些标记包括它们之间的文本。 “备选”结果为页面上的第二、第四、第六等。 此示例对替代表行应用不同的类。 请注意，使用 <search-lt> 和 <search-gt> 可将 <search-if-alt> 标签放在 <tr> 标签的“内部”。 |
| 5 |
<search-if-even> ... </search-if-even> <search-if-not-even> ... </search-if-not-even> |
如果当前结果是（或不是）偶数编号结果（在 <search-results> 中使用）或偶数编号字段值（在 <search-field-values> 中使用），则这些标记包括它们之间的文本。 如果搜索结果的 <search-index> 值为偶数，则搜索结果为偶数。 换句话说，如果它在整个结果集中的位置是均匀的。 这可能与 <search-if-alt> 不同，后者测试结果在页面上的位置，而不是在整个结果集中。 以下两个表说明了差异： |
第一页，sp_n=1
| 索引 |
结果 |
扯平？ |
Alt? |
|---|---|---|---|
| 1 |
第一个结果 |
否 |
否 |
| 2 |
第二个结果 |
是 |
是 |
| 1 |
第三个结果 |
否 |
否 |
| 4 |
第四个结果 |
是 |
是 |
| 5 |
第五个结果 |
否 |
否 |
稍后页，sp_n=10
| 索引 |
结果 |
扯平？ |
Alt? |
|---|---|---|---|
| 10 |
第十个结果 |
是 |
否 |
| 11 |
第11个结果 |
否 |
是 |
| 12 |
第十二个结果 |
是 |
否 |
| 13 |
第十三个结果 |
否 |
是 |
| 14 |
第十四个结果 |
是 |
否 |
最后，请注意<search-if-even>与搜索字段值的<search-if-alt>始终相同，因为字段值不分页。
字段值列表标记
以下高级标记输出字段值以及整个搜索结果集中的相关数据。 这些标记仅针对搜索查询中的sp-sfvl-field CGI参数指定的字段生成输出。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-field-value-list name="field-name" quotes="yes/no" commas="yes/no" data="values/counts/results" separator="X" sortby="none/values/counts/results" max-items="XX" date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none"> |
此标签显示整个结果集中唯一字段值、值计数或结果计数的列表。 此标签仅为搜索查询中的 sp_sfvl_field CGI参数指定的字段生成输出。 可选的“quotes”属性控制各个项目输出是否用多次引号（或单引号，如果encoding=perl）括起来。 “quotes”的默认值为“yes”。 可选的“逗号”属性控制各个项目输出是否以逗号分隔。 “逗号”的默认值为“是”。 可选的“data”属性控制是输出每个唯一字段值(data="values")，输出每个唯一字段值的总计数(data="counts")，还是输出包含每个唯一值的结果数(data="results")。 “data”的默认值为“values”。 对于非列表类型字段，data="counts"和data="results"是等效的。 分隔符属性定义要在输出值之间插入的单个字符或分隔符。 可选的“sortby”属性控制输出的顺序；sortby="none"表示没有特定顺序，sortby="values"表示按字段值排序（根据字段的“排序”属性以升序或降序排序）,sortby="counts"表示按字段值计数的降序排序，sortby="results"表示按包含每个值的结果数的降序排序。 请注意，sortby="counts"和sortby="results"对于非列表类型字段是等效的。 可选的“max-items”属性限制了要输出的项目数。 “max-items”的默认值为-1，表示“输出所有项目”。 最大项目的绝对限制为100。 仅当指定字段的内容类型为“date”时，“date-format”、“gmt”和“language”属性才相关。 “date-format”属性采用UNIX样式的日期格式字符串，如“%A, %B %d, %Y”（对于“2016年7月25日，星期一”）。 "gmt"默认为"yes"，并控制日期字符串的时间部分应以GMT("yes")还是帐户的时区("no")输出。 请参阅日期格式字符串。 “语言”属性控制输出日期字符串的语言和区域设置约定。 “0”（默认）表示“使用帐户语言”。 任何其他“语言”值都解释为特定语言标识符，例如，“en_US”表示“英语（美国）”。 可选的“encoding”属性控制输出字符串字符是HTML编码、JavaScript编码、Perl编码、URL编码还是未编码，以在结果页上输出。 “encoding”的默认值为“html”。 请参阅语言标识符。 |
| 2 |
<search-field-value-list-count name="field-name" value="field-value" results="yes/no"> |
此标记显示给定搜索字段值列表的计数信息。 此标签有三种不同的用途。 如果仅提供“name”属性，则此标记将输出整个结果集中指定字段的唯一值数。 如果同时提供“name”和“value”属性，则此标记将输出整个结果集中给定值的总计数（对于results="no"），或者输出包含整个结果集中给定值的结果的总计数（对于results="yes"）。 “results”的默认值为“no”。 注意：对于非列表类型字段，results="yes"和results="no"是等效的。 如果未提供“value”属性，则忽略“results”的值。 此标签仅为搜索查询中的 sp-sfvl-field CGI参数指定的字段生成输出。 |
| 1 |
<search-if-field-value-list-count name="field-name" value="field-value"> ... </search-if-field-value-list-count> <search-if-not-field-value-list-count name="field-name" value="field-value"> ... </search-if-not-field-value-list-count> |
如果具有给定属性的对 <search-field-value-列表-count name="field-name" value="field-value"> 的等效调用将（或不会）返回大于零的值，则这些标记会显示它们之间的HTML。 |
| 4 |
<search-if-single-field-value-list-count name="field-name"> ... </search-if-single-field-value-list-count> |
如果具有给定属性的对 <search-field-value-列表-count name="field-name" value="field-value"> 的等效调用将（或不会）返回单个值，则这些标记会显示它们之间的内容。 这通常在帐户使用facet插槽时使用。 对于facet槽，您通常只希望在关联的名称槽具有单个项目时显示值槽。 在传输模板中进行此检查比在表示层中进行检查更有效。 |
字段值列表循环标记
以下高级标签使用循环构造枚举和输出字段值以及整个搜索结果集中的相关数据。 这些标记仅针对搜索查询中的sp-sfvl-field CGI参数指定的字段生成输出。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-field-values name="field-name" sortby="none/values/counts/results" max-items="XX"> ... </search-field-values> |
此标签创建一个循环，用于枚举整个结果集中特定字段的字段值和相关数据。 请勿将此标记嵌套在另一个 <search-field-values> 标记中。 “name”属性指定包含要枚举的值的字段的名称。 可选的“sortby”属性控制明细列表顺序：“none”表示没有特定顺序，“values”表示按字段值排序（根据字段的“排序”属性以升序或降序排序）,sortby=“counts”表示按字段值计数的降序排序，sortby=“results”表示按包含每个值的结果数的降序排序。 请注意，sortby="counts"和sortby="results"对于非列表类型字段是等效的。. 可选的“max-items”属性将迭代次数限制为给定值。 “max-items”的默认值为-1，表示“枚举所有值”。 |
| 2 |
<search-field-value date-format="date-format-string" encoding="html/javascript/json/perl/url/none" gmt="yes/no" language="0/language-id"> |
此标签输出当前<search-field-values>循环迭代的字段值。 此标记仅在 <search-field-values> 循环中有效。 仅当封闭<search-field-values>标记中指定的字段名称的内容类型为“date”时，“date-format”、“gmt”和“language”属性才相关。 “date-format”属性采用UNIX样式的日期格式字符串，如“%A, %B %d, %Y”（对于“2020年7月25日，星期一”）。 请参阅日期格式字符串。 可选的“encoding”属性控制输出字符串字符是HTML编码、JavaScript编码、Perl编码、URL编码还是未编码，以在结果页上输出。 “encoding”的默认值为“none”。 通常，您无需指定编码属性。 "gmt"默认为"yes"，并控制日期字符串的时间部分应以GMT("yes")还是帐户的时区("no")输出。 “语言”属性控制输出日期字符串的语言和区域设置约定。 “0”（默认）表示“使用帐户语言”。 任何其他“语言”值都解释为特定语言标识符，例如，“en_US”表示“英语（美国）”。 请参阅语言标识符。 |
| 1 |
<search-field-value-count results="yes/no"> |
此标签输出与当前 <search-field-values> 循环迭代关联的计数。 输出计数是包含字段值的整个结果集中的结果数（结果="yes"），或整个结果集中字段值的总计数。 “results”的默认值为“no”。 对于非列表类型字段，results="yes"和results="no"是等效的。 此标记仅在 <search-field-values> 循环中有效。 |
| 4 |
<search-field-value-counter> |
此标签输出当前 <search-field-values> 循环迭代的序数计数器。 此标记仅在 <search-field-values> 循环中有效。 |
建议标记
建议提供用户友好的“您是不是意思？” 用于建议替代搜索词的服务。 例如，如果用户拼写错误搜索词，“建议”可以通过建议正确的拼写帮助用户查找结果。 系统还可以建议相关关键字，它们有助于用户发现结果。 在生成建议时，建议服务使用两个词典：一个基于帐户语言（设置在Indexing > Words and Languages > Language下），另一个基于帐户索引中的关键字唯一生成。
建议服务不适用于中文、日文或韩文。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-if-suggestions> ... </search-if-suggestions> |
在这些标记周围添加任何“建议”模板标记，如 <search-seccuption> 、 <search-seccuption-link> 等。 如果搜索生成建议，则搜索引擎输出并处理打开和关闭标记之间的所有内容。 如果搜索未生成建议，则不会输出任何嵌套内容。 |
| 2 |
<search-suggestions> ... </search-suggestions> |
此标记生成“建议”循环，该循环包含建议搜索词的列表(例如，“打算”、“预期”和“打算”，对于最初输入为“意向”的查询)。 在生成术语列表时，搜索引擎最多重复五次任何嵌套的HTML和／或模板标记，这是建议的最大数目。 使用count属性指定生成的建议数（0到5）。 <search-segmenties> 标记可在页面上多次显示以重复建议的列表。 根据每个结果的结果数对多个建议进行排序。 在打开和关闭 <search-if-seffications> 标记之间嵌套 <search-seffications> 标记。 |
| 1 |
<search-suggestion-link> ... </search-suggestion-link> |
此标记使用所选的建议搜索词而不是原始词生成指向原始搜索查询的链接。 标签接受并直接打印任何HTML属性，如类、目标和样式。 标记还可以接受URL属性，其值用作生成链接的基本URL。 标记只能显示在 <search-secumbines> 循环中。 |
| 4 |
<search-suggestion-text /> |
此标记将打印当前建议的查询术语(例如，最初作为“意向”输入的查询的“打算”)。 标记没有属性，只能显示在 <search-sequisings> 循环中。 |
| 5 |
<search-if-not-suggestions> ... </search-if-not-suggestions> |
如果搜索未生成任何建议，则搜索引擎输出并处理打开和关闭标记之间的所有内容。 如果搜索生成建议，则不会输出任何嵌套内容。 |
| 6 |
<search-if> ... </search-if> |
这些条件标记包括它们之间的HTML，这取决于建议的术语是否是建议循环中的第一个术语。 标记必须显示在打开和关闭 <search-seccuption> 标记之间。 |
| 7 |
<search-if> ... </search-if> |
这些条件标记包括它们之间的HTML，这取决于建议的术语是否是建议循环中的最后一个术语。 标记必须显示在打开和关闭 <search-seccuption> 标记之间。 |
| 8 |
<search-suggestion-index> |
此标记返回当前建议搜索词的数值索引。 标记必须显示在打开和关闭 <search-seccuption> 标记之间。 |
| 9 |
<search-suggestion-total> |
此标记返回生成的建议搜索词的总数。 标记必须显示在打开和关闭 <search-seccuption> 标记之间。 |
| 10 |
<search-suggestion-result-count> |
此标记返回建议搜索词的结果总数。 标记必须显示在打开和关闭 <search-seccuption> 标记之间。 |
模板字符串标签
以下标签将字符串输出到模板中该点的HTML中。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-body> |
带有“基本外观”部分在“模板”链接下设置的任何“搜索链接颜色”设置的HTML正文标记。 向此标签添加背景属性以在结果页上显示背景图像。 添加到此标签的任何颜色属性都会覆盖“基本外观”部分设置的“搜索链接颜色”设置。 |
| 2 |
<search-header> |
在“模板”链接下的“基本外观”部分中设置的搜索结果标题的HTML。 |
| 1 |
<search-cdata> ... </search-cdata> |
search-cdata标记将替换为其XML等效标记： <search/cdata> 替换为 <![CDATA["和</search-cdata> 标记替换为" ]]> "。 XML分析器不解析open和close标签之间的任何信息。 |
| 4 |
<search-query query-number="XX" encoding="html/javascript/json/perl/url/none"> |
访客输入的查询。 高级、可选的“查询编号”属性控制此标签输出哪些编号查询字符串。 例如， <search-查询查询编号=1> 输出 sp_q_1 cgi参数的内容。 如果未指定“查询号”，或查询号为“0”，则输出主查询( sp_q )。 可选的“encoding”属性控制输出是否是HTML编码、JavaScript编码、Perl编码、URL编码或未编码，以在结果页上输出。 “encoding”的默认值为“html”。 通常，您无需指定编码属性。 |
| 5 |
<search-total> |
此搜索的结果总数。 |
| 6 |
<search-count> |
此页面报告的结果计数。 |
| 7 |
<search-lower> |
为此页面报告的第一个结果的编号。 |
| 8 |
<search-upper> |
为此页面报告的最后一个结果的编号。 |
| 9 |
<search-prev-count> |
上一页报告的结果数。 |
| 10 |
<search-next-count> |
为下一页报告的结果数。 |
| 11 |
<search-time> |
此搜索的时间（以秒为单位）。 |
| 12 |
<search-logo> |
为您的帐户配置的“搜索”徽标的HTML（如果有）。 此徽标是让网站搜索／销售归功于它的图像 目前，大多数帐户没有关联的搜索标志。 |
| 13 |
<search-collection all="name"> |
此搜索的结果集合。 可选的“all”属性用于指定表示整个网站的集合名称。 |
| 14 |
<search-form> ...</search-form> |
插入开始和结束表单标记。 将方法和操作属性插入开始表单标签中。 接受其他属性，包括语言的dir="RTL"属性以及与JavaScript相关的“name”和“onSubmit”属性。 |
| 15 |
<search-input-account> |
插入指定帐户号的表单输入标记。 |
| 16 |
<search-input-gallery> |
插入指定库编号的表单输入标记。 |
| 17 |
<search-input-query query-number="XX"> |
插入指定查询字符串的表单输入标记。 高级、可选的“查询编号”属性控件用于表单输入标记的编号查询。 例如， <search-input-查询查询编号=1> 输出 sp_q_1 查询的表单输入标签。 如果未指定“查询号”或“查询号”为“0”，则插入主 sp_q 查询的输入标记。 |
| 18 |
<search-input-collections all="name"> |
插入一个表单选择标记和关联的HTML，它们显示集合选择菜单。 可选的“all”属性用于指定表示整个网站的集合名称。 |
| 19 |
<search-lt> |
在结果页上的其他HTML或模板标记中插入一个“搜索”模板标记的输出。 <search-lt> 插入小于字符。使用 <search-lt> 和 <search-gt> 提供了一种转义标记定义的方法，以便您可以使用“搜索”模板标记作为属性值。 当响应搜索呈现模板时，小于号(<)将替换 <search-lt> 标签。 例如， <search-link> 等效于 <search-lt>a href="<search-url>"<search-gt> 。 |
| 20 |
<search-gt> |
在结果页上的其他HTML或模板标记中插入一个“搜索”模板标记的输出。 <search-gt> 插入大于字符。使用 <search-lt> 和 <search-gt> 提供了一种转义标记定义的方法，以便您可以使用其他模板标记作为属性值。 当响应搜索呈现模板时，大于号(>)将替换 <search-gt> 标记。 例如， <search-link> 等效于 <search-lt>a href="<search-url>"<search-gt> 。 |
| 21 |
<search-param name="param-name" length="XX" encoding="html/javascript/json/perl/url/none"> |
返回当前搜索请求中名为“param-name”的cgi参数的值。 可选的“encoding”属性控制输出是否是HTML编码、JavaScript编码、Perl编码、URL编码或未编码，以在结果页上输出。 “encoding”的默认值为“html”。 通常，您无需指定编码属性。 |
| 22 |
<search-trace encoding="html/javascript/ json/perl/url/none"> |
编码属性是可选的；默认值为json 。
注意： 仅当使用核心搜索查询参数指定 sp_trace=1 时，此标记才具有输出。 请参见后端搜索CGI参数中的表中的第48行。 |
模板锚点链接标记
以下是导致锚点链接在它们之间环绕HTML的标记。 单击锚点链接后，将请求显示另一页结果。 可选属性“count”请求页面上显示许多结果。 如果未指定，则使用当前页面上请求的计数。 高级、可选的“URL”属性控制关联链接指向的域。 默认情况下，域为https://search.atomz.com/search/，但可以使用URL属性更改此域。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-next URL="https://search.yourdomain.com/search/"> ... </search-next> <search-prev URL="https://search.yourdomain.com/search/"> ... </search-prev> |
显示结果的下一页或上一页。 |
| 2 |
<search-sort-by-date URL="https://search.yourdomain.com/search/"> ... </search-sort-by-date> <search-sort-by-score URL="https://search.yourdomain.com/search/"> ... </search-sort-by-score> |
按日期或相关性对结果排序。 |
| 1 |
<search-show-summaries URL="https://search.yourdomain.com/search/"> ... </search-show-summaries> <search-hide-summaries URL="https://search.yourdomain.com/search/"> ... </search-hide-summaries> |
显示或隐藏摘要。 |
模板条件标记
用于在它们之间有条件地包含HTML的标记。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-if-results> ... </search-if-results> <search-if-not-results> ...</search-if-not-results> |
如果当前页面包含任何（或无）搜索结果，则这些标记包括HTML。 |
| 2 |
<search-if-prev-count> ... </search-if-prev-count> <search-if-not-prev-count> ... </search-if-not-prev-count> <search-if-next-count> ... </search-if-next-count> <search-if-not-next-count> ... </search-if-not-next-count> |
如果上一页或下一页具有与其关联的任何（或无）结果，则这些标记包括HTML。 |
| 1 |
<search-if-sort-by-score> ... </search-if-sort-by-score> <search-if-not-sort-by-score> ... </search-if-not-sort-by-score> <search-if-sort-by-date> ... </search-if-sort-by-date> <search-if-not-sort-by-date> ... </search-if-not-sort-by-date> |
如果当前页面是否按相关或日期排序，则这些标记包括HTML。 |
| 4 |
<search-if-show-summaries> ... </search-if-show-summaries> <search-if-hide-summaries> ... </search-if-hide-summaries> |
如果当前页面显示或隐藏摘要，则这些标记包括HTML。 您可以使用这些标记包含或排除搜索结果的任何部分。 |
| 5 |
<search-if-input-collections> ... </search-if-input-collections> <search-if-not-input-collections> ... </search-if-not-input-collections> |
如果在生成当前页面的搜索结果时指定了集合，则这些标记包括HTML。 |
| 6 |
<search-if-advanced> ... </search-if-advanced> <search-if-not-advanced> ... </search-if-not-advanced> |
如果为搜索查询指定了 sp_advanced=1 CGI参数，则这些标签包括HTML。 |
| 7 |
<search-if-bad-param name="parameter-name"> ... </search-if-bad-param> <search-if-not-bad-param name="parameter-name"> ... </search-if-not-bad-param> |
如果给定参数无效或无效，则这些标签会包括或排除它们之间的HTML。 目前仅支持 sp_q_location[_#] 参数。 |
| 8 |
<search-if-param name="param-name" value="param-value"> ... </search-if-param> <search-if-not-param name="param-name" value="param-value"> ... </search-if-not-param> |
这些高级标签包括它们之间的HTML，这取决于在“name”属性中指定的CGI参数是否具有在“value”属性中指定的值。 |
| 9 |
<search-if-sort-by-field name="field-name"> ... </search-if-sort-by-field> <search-if-not-sort-by-field name="field-name"> ... </search-if-not-sort-by-field> |
如果当前页面是否按给定字段名称排序，则这些高级标记包括它们之间的HTML。 |
模板表单控件标签
用于控制搜索模板<form>中复选框、单选按钮和列表框的默认选择状态的标记。
| 标记 |
描述 |
|
|---|---|---|
| 1 |
<search-input> |
在模板中用于代替 <input> 标记。 将标记写入浏览器时，单词输入将替换搜索输入，并且标记中的所有其他信息将按原样输出。 此外，如果标签中指定的名称作为CGI参数列出，并且标签中指定的值是该CGI参数的值，则标签末尾会添加检查的一词。 这样，您就可以自动使搜索结果中的默认单选按钮或复选框状态与当前查询相同。 例如，复选框的HTML代码可能如下所示： <input type="checkbox" name="sp_w" value="exact">无相似声音匹配 该复选框的相应模板代码如下： <search-input type="checkbox" name="sp_w" value="exact">无相似声音匹配 如果查询的CGI参数字符串包含 sp_w=exact ，则用搜索结果写入浏览器的标签如下（检查的字词插入到标签末尾）: <input type="checkbox" name="sp_w" value="exact" checked="">无相似声音匹配 如果查询的CGI参数字符串不包含 sp_w=exact ，则写入浏览器并且搜索结果的标记如下所示（标记中未列出检查的一词）: <input type="checkbox" name="sp_w" value="exact">无相似声音匹配 <search-input> 标记可用于将复选框和单选按钮放入搜索模板中。 如果要在搜索模板中向 <form> 添加复选框或单选按钮，请使用 <search-input...> 代替 <input...> 。 |
| 2 |
<search-select> ... </search-select> <search-option> ... </search-option> |
<form> 标记中的下拉列表框以 <select> 标记开头，以 </select> 标记结尾。 关联的CGI参数的名称列在 <select> 标签中。 在 <select> 标记后面是 <option> 标记的列表，这些标记指定要在列表框中显示的值。 <search-select> 、 <search-select> 、 <search-option> 和 <search-option> 标签提供与 <search-input> 标签类似的功能。 即，如果 <search-select> 标签中的名称被列为CGI参数，且该CGI的值，则所选字会自动添加到发送到浏览器的 <option> 标签的末尾参数作为值在特定 <search-option> 标记中列出。 这样，您就可以在搜索结果中自动选择默认列表框，使其与当前查询相同。 例如，典型的列表框如下所示： 该列表框的相应模板代码如下： 如果要在搜索模板中向 <form> 添加列表框，请使用 <search-select...> 代替 <select...> 、 </search-select> a9/>、 <search-option...> 代替 <option...> ，和 </search-option> 代替 </option> 。 |
| 1 |
<search-sort-by-field name="field-name" count="XX"> ... </search-sort-by-field> |
这些高级标签在它们之间围绕HTML创建锚点链接。 单击此锚点时，将显示在给定字段上排序的结果页。 可选的计数属性指定要在结果页上显示的结果数。 如果忽略计数，则使用当前页上使用的计数。 |
日期格式字符串
您可以在日期格式字符串中使用以下转换规范：
| 日期格式字符串 |
描述 |
|---|---|
| %同类群组 |
匹配完整工作日名称的国家代表，例如“星期一”。 语言学 > 单词和语言 > 语言中的设置决定国家代表。 请参阅关于单词和语言。 |
| %a |
匹配缩写工作日名称的国家代表，其中缩写是前三个字符，例如“周一”。 语言学 > 单词和语言 > 语言中的设置决定国家代表。 请参阅关于单词和语言。 |
| %B |
匹配整月名称的国家代表，例如“June”。 语言学 > 单词和语言 > 语言中的设置决定国家代表。 请参阅关于单词和语言。 |
| %b |
匹配缩写月份名称的国家代表，其中缩写是前三个字符，例如“Jun”。 语言学 > 单词和语言 > 语言中的设置决定国家代表。 请参阅关于单词和语言。 |
| %D |
等效于“%m/%d/%y”，例如“07/25/13”。 |
| %d |
将月中的某天与小数(01-31)匹配。 |
| %e |
将月日与小数(1-31)匹配。 单位数前留空。 |
| %H |
将24小时时钟与小数(00-23)匹配。 |
| %h |
匹配缩写月份名称的国家代表，其中缩写是前三个字符，例如“Jun”（与%b相同）。 |
| %I |
将12小时时钟与小数(01-12)匹配。 |
| %j |
将年中的某天与小数(001-366)匹配。 |
| %k |
将(24小时时钟作为十进制数字(0-23)匹配。 单位数前留空。 |
| %l |
将12小时时钟与十进制数字(1-12)匹配。 单位数前留空。 |
| %M |
将分钟数与十进制数字(00-59)匹配。 |
| %m |
将月份与十进制数字(01-12)匹配。 |
| %p |
根据需要匹配“ante meridiem”或“post meridiem”的国家代表，例如“PM”。 语言学 > 单词和语言 > 语言中的设置决定国家代表。 请参阅关于单词和语言。 |
| %R |
等效于“%H:%M”，例如“13:23”。 |
| %r |
等效于“%I:%M:%S %p”，例如“01:23:45 PM”。 |
| %S |
将第二个数字与十进制数字(00-60)匹配。 |
| %T |
等效于“%H:%M:%S”，例如“13:26:47”。 |
| %U |
将年份的周数（星期日作为周的第一天）与小数(00-53)匹配。 |
| %v |
等效于“%e-%b-%Y”，例如“2013年7月25日”。 |
| %Y |
将年份与世纪作为小数，例如“2013”。 |
| %y |
以小数(00-99)形式匹配没有世纪的年份。 |
| %Z |
匹配时区名称。 |
| %% |
匹配 "%". |
语言标识符
下表包含每个支持语言的语言标识符。 您可以在以下模板标记中将这些标识符用作可选“语言”属性的值：
-
search-date和search-display-field.请参阅结果循环字符串标记。
-
search-field-value-list请参 阅字段值列表标记。 -
search-field-value请参 阅字段值列表循环标记。
| 语言 |
语言 identifier |
|---|---|
| 保加利亚语（保加利亚） |
bg_BG |
| 中文（中国） |
zh_CN |
| 中文（香港） |
zh_HK |
| 中文（新加坡） |
zh_SG |
| 中文（台湾） |
zh_TW |
| 捷克语（捷克共和国） |
cs_CZ |
| 丹麦语（丹麦） |
da_DK |
| 荷兰语（比利时） |
nl_BE |
| 荷兰语（荷兰） |
nl_NL |
| 英语（澳大利亚） |
en_AU |
| 英语（加拿大） |
zh_CA |
| 英语（大不列颠） |
zh_GB |
| 英语（美国） |
zh_CN |
| 法语（比利时） |
fr_BE |
| 法语（加拿大） |
fr_CA |
| 芬兰语（芬兰） |
fi_FI |
| 法语（法国） |
fr_FR |
| 法语（瑞士） |
fr_CH |
| 德语（奥地利） |
de_AT |
| 德语（德国） |
de_DE |
| 德语（瑞士） |
de_CH |
| 希腊语（希腊） |
el_GR |
| 爱尔兰盖尔语（爱尔兰） |
ga_IE |
| 意大利语（意大利） |
it_IT |
| 日语（日本） |
ja_JP |
| 朝鲜语（韩国） |
ko_KR |
| 挪威语（挪威） |
no_NO |
| 波兰语（波兰） |
pl_PL |
| 葡萄牙语（巴西） |
pt_BR |
| 葡萄牙语（葡萄牙） |
pt_PT |
| 俄语(前苏联合并) |
ru_SU |
| 斯洛伐克语（斯洛伐克） |
sk_SK |
| 斯洛伐克语（斯洛文尼亚） |
sl_SI |
| 西班牙语（墨西哥） |
es_MX |
| 西班牙语（西班牙） |
es_ES |
| 瑞典语（瑞典） |
sv_SE |
指定content-type HTTP头
可以使用以下标记指定Content-Type HTTP响应头：
<search-content-type-header [content="MIME-type"] [charset="charset-name"]>
content和charset属性是可选的。 此标记应尽早显示在模板中。 还建议在<search-html-meta-charset>或<search-xml-decl>之前显示该标签，因为它会影响这些标签的行为。
如果未指定content属性，则MIME-type的值将默认为在Settings > Crawling > Content Types中设置的值。 如果指定content属性，则它将用作<search-html-meta-charset>标签的默认content属性。
如果未指定charset属性，则不向content-type头写入charset值。
如果指定charset="1"，则charset-name的实际值是sp_f CGI参数的值。 如果搜索中未提交sp_f CGI参数，则会从帐户设置中读取charset-name的实际值。 您可以在Settings > My Profile > Personal Information > Character Encoding下视图或更改与您的帐户关联的字符集。
请参阅配置您的个人用户信息。
您可以通过将特定字符集名称列为charset值（如charset="iso-8859-1"或charset="Shift-JIS"）来选择该字符集名称。
如果指定charset属性，则它将用作<search-html-meta-charset>和<search-xml-decl>标签的默认charset属性，并输出到content-type标题。
在HTML模板中指定字符集
默认的HTML搜索结果模板通过以下标记指定与当前帐户关联的字符集：
<search-html-meta-charset [content="MIME-type"] [charset="charset-name"]>
内容和字符集属性是可选的。 此标记必须显示在模板的HTML <head>部分。 此标记在从模板生成的HTML页面上生成以下标记：
<meta http-equiv="content-type" content="MIME-type; charset=charset-name">
如果不指定内容属性，则MIME-type的实际值将默认为两个值之一。 如果<search-content-type-header>标签指定了content属性，则使用该值。 否则，使用的值是Templates > Settings > Content Type选项卡中的值集。
如果不指定charset属性，则实际值charset-name默认为两个值之一。 如果<search-content-type-header>标签指定了charset属性，则使用该值。 否则，将从帐户设置中读取charset-name的实际值。 您可以在Settings > My Profile > Personal Information > Character Encoding下视图或更改与您的帐户关联的字符集。
请参阅配置您的个人用户信息。
如果指定charset="1"，则charset-name的实际值是sp_f CGI参数的值。 如果搜索中未提交sp_f CGI参数，则charset-name的实际值是在<search-content-type-header>标签中设置的值（如果已指定），或在帐户设置中设置的值。
可以指定特定字符集名称，如charset="charset-name"中所示。 例如，charset="iso-8859-1"或charset="Shift-JIS"。
<search-html-meta-charset>标记是可选的。 如果删除它，浏览器将采用content-type的默认值，如下所示：content="text/html; charset=ISO-8859-1"。 您还可以选择将<search-html-meta-charset>标记替换为您自己的http-equiv标记。
在XML模板中指定字符集
默认的XML搜索结果模板通过以下标记指定与当前帐户关联的字符集：
<search-xml-decl [charset="charset-name"]>
charset属性是可选的。 此标记必须显示在模板顶部，但位于任何<search-content-type-header>标记之后。 此标签在从模板生成的XML文档上生成以下标签：
<?xml version="1.0" encoding="charset-name" standalone="yes" ?>
如果不指定charset，则实际值charset-name默认为两个值之一。 如果<search-content-type-header>指定了charset属性，则使用该值。 否则，将从帐户设置中读取charset-name的实际值。 您可以在Settings > My Profile > Personal Information > Character Encoding下视图或更改与您的帐户关联的字符集。
请参阅配置您的个人用户信息。
如果指定charset="1"，则charset-name的实际值是sp_f CGI参数的值。 如果搜索中未提交sp_f CGI参数，则charset-name的实际值是在<search-content-type-header>标签中设置的值（如果已指定），或在帐户设置中设置的值。
如果需要，可以指定特定字符集名称，如charset="charset-name"中所示。 例如，charset="iso-8859-1" or charset="Shift-JIS"。
您可以选择用您自己的?xml标签替换<search-xml-decl>标签。
在另一个中包括搜索模板
要将一个搜索模板包含在另一个中，请使用<search-include>标记，将文件属性设置为要包括的模板文件的名称，如下例所示：
<search-include file="seo/seo_search_title.tpl" />
SEO搜索模板段位于seo/子文件夹中，普通搜索模板位于templates/子文件夹中。 只有。tpl文件有意包含在此上下文中。
管理网站的多个传输模板
您可以通过为每个区域使用不同的搜索传输模板来控制网站中搜索结果的外观。
要实现这种搜索功能，您可以在站点搜索／推销中管理传输模板。 或者，您也可以在发布中管理传输模板。 与网站搜索／销售一样，“发布”允许您编辑、预览和发布多个搜索传输模板。
要设置搜索表单以使用特定传输模板（默认模板除外），请使用sp_t查询参数。 例如，假定您有一个名为“清除”的搜索模板，用于您网站的标记销售区域。 您将标准HTML搜索表单与以下其他表单代码一起使用：
<input type=hidden name="sp_t" value="clearance">
当客户单击包含此行代码的标准表单时，将显示“清除”搜索传输模板及其搜索结果。
请参阅在搜索表单中使用集合。
请参阅使用带有表单的帧。
请参阅高级搜索表单示例。