- Search&Promote檔案總覽
- 發行說明
- Search&Promote 18.1.1發行說明(02/13/2018)
- Search&Promote 17.11.1發行說明(10/31/2017)
- Search&Promote 15.3.1發行說明(03/24/2015)
- Search&Promote 15.1.1發行說明(01/15/2015)
- Search&Promote 8.17.0發行說明(10/30/2014)
- Search&Promote 8.16.0發行說明(9/18/2014)
- Search&Promote 8.15.0發行說明(06/19/2014)
- Search&Promote 8.14.0發行說明(05/22/2014)
- Search&Promote 8.13.0發行說明(04/16/2014)
- Search&Promote 8.12.0發行說明(01/16/2014)
- Search&Promote 8.11.0發行說明(10/29/2013)
- Search&Promote 8.10.1發行說明(07/18/2013)
- Search&Promote 8.9.8發行說明(05/23/2013)
- Search&Promote 8.9.6發行說明(03/21/2013)
- Search&Promote 8.9.5發行說明(02/21/2013)
- Search&Promote 8.9.4發行說明(01/17/2013)
- Search&Promote 8.9.3發行說明(11/01/2012)
- Search&Promote 8.9.2發行說明(09/13/2012)
- Search&Promote 8.9.1發行說明(08/16/2012)
- Search&Promote 8.9發行說明(07/19/2012)
- Search&Promote 8.8.1發行說明
- Search&Promote 8.8發行說明
- Search&Promote 8.7.2發行說明
- Search&Promote 8.7.1發行說明
- Search&Promote 8.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> 傳輸標籤指定的description傳輸模板欄位的值。 |
||
| 14 |
<guided-result-loc /> |
< guided-result-loc> 標籤提供了loc transport模板欄位的值，該欄位用 <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> 循環中有效。 |
Facets
Facet是導覽元件，可讓您深入探索搜尋結果。 您可以使用Facet標籤在您的簡報範本上顯示各種Facet。 您可依名稱參照Facet。
請參閱關於Facets。
請參閱關於 Facet 軌。
請參閱關於動態面。
| 標記 |
說明 |
|
|---|---|---|
| 1 |
<guided-dynamic-facets></guided-dynamic-facets> |
特定搜尋之任何動態Facet的循環內容。 編輯 <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提供循環內容。此預先定義的Facet邊欄也會在Business Rules使用者介面中公開，以便在Facet邊欄「_dynamic_facets」中執行推送Facet X，以定位Y 」。 請參閱關於 Facet 軌。 另請參閱關於動態面。 |
| 4 |
<guided-facet gsname=" facetname " height=" 60px " width=" 120px "></guided-facet> |
使用 guided-facet 標籤來定義所有facet標籤與特定facet相關的區域。 此標籤也是布林標籤，如果Facet中沒有值，則會隱藏所有內容。 在這種情況下，沒有輸出刻面值的點)。 高度和寬度屬性是可選的，尺寸以像素(px)指定。 「視覺化規則產生器」(VRB)會使用這兩個屬性，並在Facet隱藏時，將虛線方塊顯示為互動預留位置。 當顯示名稱位於Facet中且Facet已隱藏時，名稱也會隱藏。 但是，如果名稱不在Facet外，則只有在區域標籤或 guided-if-facet-visible 標籤被包住時，您才能隱藏名稱。 |
| 5 |
<guided-if></guided-if> |
當Facet值數量超過設定中定義的長度臨界值時，此條件標籤為true。 當清單過長時，可使用它將Facet顯示為不同的UI元素（例如截斷的清單或捲動方塊）。 您也可以在名為的guided-facet 區塊的上下文外使用此條件，方法是直接使用 gsname 屬性來參照特定facet。 |
| 6 |
<guided-if></guided-if> |
當Facet至少被點按一次且目前已選取Facet值時，此條件標籤為true。 它會用來顯示或隱藏HTML或gs標籤，視點按Facet而定。 您也可以在名為的guided-facet 區塊的上下文外使用此條件，方法是直接使用 gsname 屬性來參照特定facet。 |
| 7 |
<guided-if></guided-if> |
當只有一個Facet值時，此條件標籤為true。 當Facet無法調整結果時，使用標籤來變更其顯示。 您也可以在名為的guided-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值循環迭代器標籤。 您可在名為的guided-facet 區塊的內容中定義它，在此情況下，您可以省略 gsname 。 或者，您可以在任何引導-facet 區塊外定義它，但它需要 gsname 屬性來識別顯示哪組facet值。 您也可以使用此標籤，在名為 guided-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 |
|
變更當前選取多面值時的顯示。 如果它已經被選中，在大多數情況下，它不再可連結。 |
| 14 |
| 變更刻面值是重影值時的顯示。 當Facet值是重影值時，它通常以斜體文字顯示，以指出該值遺失或是「重影」。 以下程式碼摘錄是Facet區塊的範例： |
| 15 |
<guided-facet-undo-link gsname=" facetname "></guided-facet-undo-link> |
顯示指定Facet的還原連結。 如果有多選刻面，此連結會取消選取所有指定刻面的值。 為Facet命名。 如果Facet目前未選取，則連結是目前路徑。 以下是此標籤用法的範例： |
| 16 |
|
當Facet值數量超過設定中定義的長度臨界值時，此條件標籤為true。 當清單過長時，使用它可將Facet顯示為不同的使用者介面元素（例如截斷的清單或捲動方塊）。 您也可以在名為的guided-facet 區塊的上下文外使用此條件，方法是直接使用 gsname 屬性來參照特定Facet。 |
| 17 |
|
當Facet至少被點按一次且目前已選取Facet值時，此條件標籤為true。 它可用來顯示或隱藏HTML或gs標籤，視點按Facet而定。 您也可以在名為的guided-facet 區塊的上下文外使用此條件，方法是直接使用 gsname 屬性來參照特定facet。 |
| 18 |
|
當只有一個Facet值時，此條件標籤為true。 當Facet無法調整結果時，它可用來變更Facet的顯示。 您也可以在名為的guided-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值的還原連結。 使用它可在選取的Facet值旁顯示還原連結。 由於此還原連結只會解除該特定選取的值，因此與 <guided-facet-undo-link> 不同，<a1/>會取消選取所有選取的值。
注意： 如果Facet沒有多選行為，則兩個還原連結有相同的行為。 也就是說，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有選取或單一值「值」時，有條件地顯示HTML。 這組標籤通常用於根據在其他Facet中選取的值來顯示Facet。 |
| 33 |
<guided-facet-behavior gsname=" facetname " /> |
判斷Facet的行為，例如一般、自黏或多選。 對於收到XML結果並想要根據Facet的行為動態變更其顯示方式的客戶而言，這非常有用。 |
| 34 |
| 此標籤所包住的內容會根據Facet的可見性狀態而隱藏或顯示。 如果業務規則直接隱藏或揭示Facet，則Facet內的任何內容都會隱藏或揭示。 這些標籤不必包住Facet。 此標籤的常見用途是當名稱位於Facet外時隱藏顯示名稱。 將此標籤包住顯示名稱，會在Facet隱藏時使名稱消失。 此標籤會取代區域，而且其許多效能優點與使用區域相同。 |
階層連結
請參閱關於Breadcrumbs。
| 標記 |
說明 |
|
|---|---|---|
| 3 |
<guided-breadcrumb> breadcrumbname "></guided-breadcrumb> |
階層連結的循環標籤。 對於當前狀態的每個查詢編號，會迭代在開始和結束標籤之間的任何內容。 如果省略 gsname ，則使用名為"default"的導覽路徑標示。 |
| 2 |
<guided-breadcrumb-link></guided-breadcrumb-link> |
在階層連結中建立連結。 預設行為是「goto」行為。 如果連結的運作方式不同，請使用 gsname 選用屬性來指定"remove"或"drop"。 標籤中包含的任何屬性都會傳遞至產生的錨點標籤。 |
| 1 |
<guided-breadcrumb-value /> |
值標籤會列出目前階層連結小版本的轉換值。 它僅用於引導式導覽路徑標示區塊的內容。 |
| 4 |
<guided-breadcrumb-label /> |
標籤標籤會輸出階層連結值的標籤，其中詳述選取要產生該階層連結項目的階層連結值。 它僅用於引導式導覽路徑標示區塊的內容。 |
| 5 |
|
如果目前的階層連結值有標籤，則此條件標籤會用來有條件地顯示內容。 它僅用於在標籤實際存在時顯示標籤和關聯內容。 它僅用於引導式導覽路徑標示區塊的內容。 |
| 6 |
<guided-breadcrumb-path> |
用於建立您自己的網站導覽路徑標示連結。 |
菜單
請參閱關於菜單。
| 標記 |
說明 |
|
|---|---|---|
| 1 |
<guided-menu gsname="menuname"></guided-menu> |
這是功能表值循環迭代器標籤。 使用 gsname 屬性來識別顯示哪組菜單項。 |
| 2 |
<guided-menu-item-link></guided-menu-item-link> |
提供URL，以調整目前功能表項目的搜尋。 |
| 3 |
<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> |
在頁面導覽中建立連結。 |
| 1 |
<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屬性直接傳遞至錨點標籤。 |
| 1 |
<guided-recent-searches-path /> |
可讓您擷取最近搜尋的相對URL路徑，位於 guided-recent-searches 回圈中。 通常，您會使用 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標籤的範例：
<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>
請參閱關於您的意思是。
| 標記 |
說明 |
|
|---|---|---|
| 1 |
<guided-suggestions></guided-suggestions> |
這是循環標籤，可循環顯示建議。 |
| 2 |
<guided-suggestion-link></guided-suggestion-link> |
建立指向指定建議的連結。 |
| 1 |
<guided-suggestion-value /> |
|
| 4 |
|
可讓您測試是否有任何建議。 |
| 5 |
<guided-suggestion-path /> |
傳回建議的路徑字串。 您可使用它建立自己的錨點標籤。 通常會改用 guided-sembuction-link 。 |
| 6 |
<guided-suggestion /> |
建議。 |
| 7 |
<guided-suggestion-result-count /> |
建議的結果計數。 |
| 8 |
|
可讓您測試是否已對零結果執行依建議的自動搜尋，以防此功能開啟。 |
| 9 |
<guided-suggestion-original-query /> |
如果已執行自動搜索，則返回原始查詢。 使用範例： |
| 10 |
|
如果因為結果計數低而有建議，則此條件成立，以防此功能開啟。 以下是使用此標籤的範例： |
自動完成
下列標籤可用來將自動完成新增至您的搜尋表單。 必須有head-content和form-content標籤，才能使自動完成功能正確。 建議您使用標籤，而非將自動完成的Javascript和CSS硬式編碼至簡報範本。 原因在於，只要您變更自動完成設定，而不需要手動更新範本，標籤就可讓範本擷取任何新的失敗快取ID。
請參閱關於自動完成。
| 標記 |
說明 |
|
|---|---|---|
| 3 |
<guided-if-autocomplete> <guided-else-autocomplete> </guided-if-autocomplete> |
檢測是否啟用了自動完成功能。 您可以使用標籤來挑選自動完成所需的標題和表單內容。 反過來，這可讓您開啟或關閉功能，而不必變更簡報範本。 |
| 2 |
<guided-ac-css /> |
在簡報範本的標題中使用，並由自動完成的適當CSS指令碼所取代。 |
| 3 |
<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"> |
您可以包覆區域標籤中的任何內容，以建立區域。 這可讓您使用業務規則來視需要顯示區域。 預設情況下，始終顯示區域。 您可以使用可選的搜尋和刻面參數來指出與區域關聯的搜尋或刻面。 這類功能可讓軟體在隱藏區域時略過搜尋或刻面，以改善搜尋時的效能。 高度和寬度屬性是可選的，用來設定移除區域時，預留位置顯示器在視覺化規則產生器中的顯示方式。 使用 guided-if-facet[-not]-visible 標籤，而不是盡可能使用區域。 它可簡化簡報範本。 |
| 2 |
<guided-if-zone gsname="zone area"> <guided-else-zone> </guided-if-zone> |
這組標籤可啟用當前是否顯示區域的測試。 當頁面上的其他位置有您只想在顯示區域時顯示的內容時，此功能很實用。 |
循環指示燈
您可以在下列任何循環塊中使用下列每個循環指示符：
- 引導結果
- guided-facet-values
- guided-breadcrumb
- guided-menu-items
- 引導式頁面
| 標記 |
說明 |
|
|---|---|---|
| 3 |
|
當當前小版本是循環的第一個小版本時，此條件為真。 這不一定表示第一個結果或第一個頁面，但是第一個顯示的頁面。 如果網站訪客位於每頁10的結果集第2頁，則第一個小版本為結果11。 |
| 2 |
|
當當前小版本是循環的最後一個小版本時，此條件為真。 這並不一定表示最後一個結果或最後一頁，而是目前內容（頁面）中顯示的最後一個結果。 如果網站訪客位於包含200個結果但每頁僅有10個結果的結果集第1頁，則最後一個小版本會是結果10，而非結果200。 |
| 3 |
|
當當前小版本是循環的奇數小版本（與偶數小版本相比）時，此條件是正確的。 這有助於顯示各種行顏色。 |
| 4 |
|
當當前小版本是環的偶數小版本（與奇數小版本相比）時，此條件是正確的。 這有助於顯示各種行顏色。 |
| 5 |
|
當當前小版本是循環的偶數小版本時，此條件是正確的。 這有助於顯示各種行顏色。 |
| 6 |
|
如果當前小版本不是第一個小版本或最後一個小版本，則在它們之間包含文本。 |
| 7 |
|
如果當前小版本是第一個小版本或最後一個小版本，則在它們之間包含文本。 |
| 8 |
<guided-loop-index> |
一個整數（從0開始），其值會隨循環的每個迭代而遞增。 |
| 9 |
<guided-loop-counter> |
一個整數（從1開始），其值會隨循環的每個迭代而遞增。 |
其他語言
以下標籤可讓您使用範本執行更多進階的工作，例如建立您自己的mini-facet。
| 標記 |
說明 |
|||
|---|---|---|---|---|
| 1 |
<guided-current-path> |
提供您目前使用的路徑。 通常，它用於建立新增參數至現有搜尋的連結。 依預設，路徑為URL逸出。 您可以指定要通過轉義參數使用的轉義模式。 範例: 在此範例中，搜尋處理規則使用lang來選取法文版本。 目前路徑一律至少有一個查詢參數。 如果沒有其他查詢參數，則將其設定為 q=* ，以便更輕鬆地添加更多參數。 |
||
| 2 |
基本路徑 |
如果要使用基本路徑建立連結，請在 href 開頭使用 / 並添加參數。 |
||
| 3 |
<guided-query-param gsname="query_parameter"> |
可讓您擷取URL上查詢參數的現有值。 如果您的參數不存在，此標籤會傳回空字串。 如果您未指定逸出選項，傳回的字串會自動HTML逸出，您可以指定HTML或URL逸出。 範例:
| ||
| 4 |
<guided-query-param-name gsname="param#" offset="offset_number" /> |
引導式搜尋的概念是查詢編號，用於階層連結控制項。 guided-query-param-name可讓您將參 數定義為簡報範本中連結的一部分，其中「guided Search」會為您找出正確的查詢編號。 gsname 中有"x",「引導式搜尋」會以正確的數字取代。 偏移值可以是0 - 15，其中0表示使用了下一個可用的查詢編號。 1表示您要新增1到它，依此類推。 結合 guided-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 |
|
當當前小版本是循環的偶數小版本時，此條件是正確的。 這有助於顯示各種行顏色。 |
||
| 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 整合的一部分，以防止在不需要時點擊 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> |
傳遞填入Facet的結果。 |
| <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> 使用槽刻面的帳戶可以使用動態標籤和顯示名稱標籤。 這兩個標籤都有助於在建立業務規則時，在槽刻刻面和實際刻面之間建立對應。 <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節點包含建議。 請參閱關於您的意思是。 |
| <suggestion></suggestion> |
以標籤包住每個Did You Mean建議，如下列範例所示： <search-if-suggestions>
<suggestions>
<search-suggestions>
<suggestion><search-suggestion-text /></suggestion>
</search-suggestions>
</suggestions>
</search-if-suggestions> 請參閱關於您的意思是。 |
搜尋範本標籤
搜尋範本是HTML檔案，包含網站搜尋／銷售所定義的範本標籤。 這些標籤表示搜索結果的格式。 以下參考包含每個搜索模板標籤及其屬性的簡要說明。
僅在傳輸範本檔案(.tpl)中使用搜尋範本標籤。
您可以從下列搜尋範本標籤群組和參考資料中選取。
僅在結果回圈內有效的標籤包括：
在整個範本中有效的標籤包括：
搜尋範本參考主題
關於結果循環標籤
結果loop標籤是模板系統的主要功能。 在搜尋期間遇到標籤時，會重複HTML，而開始和結束結果循環標籤之間會有其他標籤，以您的搜尋結果取代任何其他標籤。
<search-results> ... </search-results>
結果循環標籤環繞顯示搜尋結果的HTML。 標籤之間的HTML會針對每個結果重複，並顯示在頁面上。
下列標籤僅在結果循環中有效：
結果循環字串標籤
下列標籤會傳回字串。
請參閱關於結果循環標籤。
| 標記 |
說明 |
|
|---|---|---|
| 1 |
<search-index> |
返回當前結果的數值索引。 |
| 2 |
<search-title length="XX"> |
傳回目前結果的頁面標題。 選用的length屬性可用來限制顯示的字串長度，預設值為80個字元。 |
| 1 |
<search-bodytext length="XX" encoding="html/javascript/json/perl/url/none"> |
傳回從頁面頂端開始的內文文字。 相關詞語以粗體顯示。 選用的length屬性可用來限制顯示的字串長度，預設值為80個字元。 編碼屬性是選用的，可以使用HTML編碼（預設值）、Javascript編碼、Perl編碼或無來編碼輸出字元。 |
| 4 |
<search-description length="XX" encoding="html/javascript/json/perl/url/none"> |
返回當前結果的說明。 如果元描述標籤存在且內容屬性不為空，則會顯示該文本。 否則，將顯示頁面的正文文本的開頭。 選用的length屬性可用來限制顯示的字串長度，預設值為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"> )，以顯示動態頁面排名。 您可將排名屬性設為靜態( <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」意指「英文（美國）」。 選用的length屬性可用來限制顯示的字串長度，預設值為80個字元。 |
| 7 |
<search-size> |
傳回目前結果的大小（以位元組為單位）。 |
| 8 |
<search-url length="XX" encoding="html/javascript/json/perl/url/none"> |
傳回目前結果的URL。 使用可選 length 屬性來限制顯示的字串長度，預設值為不限個字元。 encoding 屬性是可選的，它可以使用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> 標籤集包含長度屬性，則忽略長度屬性。 encoding 屬性是可選的，它可以使用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、title、desc、keys、target、body、alt、date、charset，以及在選項 > 中繼資料 >定義）中定義的語言或欄位，這些欄位在名稱屬性中。 例如: <search-display-field name="title" length="70" none="no title"> 輸出搜尋結果的頁面標題。 如果指定了可選的無屬性，則僅當沒有與欄位關聯的內容時，其值才會顯示在結果頁上。 日期格式、 gmt 和語言屬性只有在指定欄位的內容類型為日期時才相關。 date-format 屬性採用UNIX樣式的日期格式字串，如 %A, %B %d, %Y （2016年7月25日星期一）。 gmt 預設 為 yes，並控制日期字串的時間部分是以GMT( yes )或帳戶的時區( no )輸出。 請參閱日期格式字串。 language 屬性控制輸出日期字串的語言和地區設定慣例。 0 （預設值）表示「使用帳戶語言」。 2 意指「使用檔案語言」。語言值 1 保留供將來使用)。 其他任何語言值都會解譯為特定語言識別碼，例如， en_US 表示"English(United States)"。 請參閱語言標識符。 可選的 length 屬性用於限制顯示的字串長度，預設值為80個字元。 可選的編碼屬性控制輸出是否為HTML編碼、JavaScript編碼、Perl編碼、URL編碼或未編碼，以便在結果頁上輸出。 編碼的預設值為 html 。 通常，您不需要指定編碼屬性。 可選的引號屬性控制個別項目輸出是否用雙引號（如果 encoding=perl ，則為單引號）。 引號的預設值為 no 。 選用的逗號屬性可控制個別輸出項目是否以逗號分隔。 逗號的預設值為 yes 。 對於非清單類型欄位，將忽略逗號屬性。 可選的單位屬性控制應用於鄰近搜索輸出欄位的距離單位。 單位的預設值是根據與給定鄰近搜索輸出欄位相關聯的位置類型欄位的「預設單位」設定確定的。 可選的分隔符屬性定義了在清單類型欄位的輸出值之間插入的單個字元或分隔符。 |
| 12 |
<search-display-field-values name="field-name"> ...<search-display-field-values> |
此標籤會建立循環，以列舉目前結果的中繼資料欄位值(url、title、desc、keys、target、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、target、body、alt、date、charset和在選項 > 元資料 > 定義下定義的語言或欄位。 此標籤僅在 <search-display-field-values> 循環內有效。 日期格式、 gmt 和語言屬性只有在<search-display-field-values>標籤為日期的欄位名稱的內容類型時才相關。 date-format 屬性採用UNIX樣式的日期格式字串，如 "%A , %B %d , %Y "（對於"Monday, July 25, 2016」）。 gmt 屬性預設為是，並控制日期字串的時間部分是以GMT輸出（是）還是帳戶的時區（否）。 language 屬性控制輸出日期字串的語言和地區設定慣例。 0 （預設值）表示「使用帳戶語言」。其他任何語言值都會解譯為特定語言識別碼，例如， en_US 表示"English(United States)"。 可選的編碼屬性控制輸出是否為HTML編碼、JavaScript編碼、Perl編碼、URL編碼或未編碼，以便在結果頁上輸出。 編碼的預設值為 html 。 通常，您不需要指定編碼屬性。 |
| 14 |
<search-display-field-value-count name="field-name"> |
輸出當前結果中以名稱屬性指定的元資料欄位(url、title、desc、keys、target、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> |
開始此搜尋所傳回之任何動態Facet欄位的循環內容。 |
| 17 |
<search-dynamic-facet-field-name> |
輸出此循環迭代的當前動態Facet-field的名稱。 |
| 18 |
<search-result-trace encoding="html/javascript/ json/perl/url/none"> |
輸出與當前結果的放置有關的資訊，例如影響結果位置的任何基於結果的操作。 此標籤的輸出格式為JSON，如下列範例所示： encoding 屬性是可選的；預設值為 html 。
注意： 只有在核心搜索查詢參數中指定了 sp_trace=1 時，此標籤才具有輸出。 請參見 Backend search CGI parameters中表中的第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=Y> )，以檢查動態頁面排名。 您可以將排名屬性設為靜態( <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。 如果指定了可選的"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周圍建立錨點連結。 點按連結時，會顯示結果頁面。 選用的target屬性會指定可畫格瀏覽器應顯示結果頁面的指定視窗。 將hbx-enable屬性設為"yes"，以運用HBX提供的分析。 將hbx-linkid-name設為您要追蹤的中繼資料欄位名稱。 例如，若要依SKU編號追蹤搜尋結果，請將hbx-linkid-name設為包含SKU資訊的中繼資料欄位名稱。 目前不支援日期類型欄位。 hbx-linkid-name的值會附加至產生之錨點的連結ID。 每當命名的Meta-data欄位空白時，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檢視器會顯示包含結果的頁面。 選用的target屬性會指定可畫格瀏覽器應顯示結果頁面的指定視窗。 將hbx-enable屬性設為"yes"，以運用HBX提供的分析。 將hbx-linkid-name設為您要追蹤的中繼資料欄位名稱。 例如，若要依SKU編號追蹤搜尋結果，請將hbx-linkid-name設為包含SKU資訊的中繼資料欄位名稱。 目前不支援日期類型欄位。 hbx-linkid-name的值會附加至產生之錨點的連結ID。 每當命名的Meta-data欄位空白時，hbx-linkid-none屬性的值會附加至連結ID。 hbx-linkid-length的值會限制從Meta標籤擷取和顯示的字元數。 預設字元數為12。 |
| 3 |
<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>。 它們用於測試當前結果在結果集中的位置。
請參閱關於結果循環標籤。
| 標記 |
說明 |
|
|---|---|---|
| 3 |
<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 |
第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）括住。 「引號」的預設值為「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"對於非清單類型欄位是等效的。 選用的「最大項目」屬性會限制要輸出的項目數。 「最大項目」的預設值為-1，這表示「輸出所有項目」。 最大項目的絕對限制為100。 「日期格式」、「gmt」和「語言」屬性只有在指定欄位的內容類型為「日期」時才相關。 「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"屬性，此標籤會輸出整個結果集內給定值的總計數(for results="no")，或包含整個結果集中給定值的總計數(for 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-list-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-list-count name="field-name" value="field-value"> 等等效呼叫傳回單一值，這些標籤會顯示它們之間的內容。 這通常用於帳戶使用刻面槽時。 有了Facet槽，您通常只想在關聯的名稱槽包含單一項目時顯示值槽。 在傳輸範本中執行此檢查比在表現層中執行檢查更有效。 |
欄位值清單循環標籤
下列進階標籤會使用循環結構，從整個搜尋結果集列舉和輸出欄位值及相關資料。 這些標籤僅針對搜索查詢中的sp-sfvl-field CGI參數所指定的欄位產生輸出。
| 標記 |
說明 |
|
|---|---|---|
| 3 |
<search-field-values name="field-name" sortby="none/values/counts/results" max-items="XX"> ... </search-field-values> |
此標籤會建立一個循環，用於枚舉整個結果集中特定欄位的欄位值和相關資料。 請勿將此標籤巢狀內嵌在其他 <search-field-values> 標籤中。 "name"屬性指定包含要枚舉的值的欄位的名稱。 可選的"sortby"屬性控制枚舉順序：「無」意指無特定順序，「值」意指依欄位值排序（依欄位的「排序」屬性以遞增或遞減順序排序）,sortby="counts"意指依欄位值計數的遞減順序排序，而sortby="results"意指依包含每個值之結果數的遞減順序排序。 請注意，sortby="counts"和sortby="results"對於非清單類型欄位是等效的。. 可選的「最大項目」屬性將迭代次數限制為給定值。 「最大項目」的預設值為-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> 循環小版本關聯的計數。 輸出計數是包含欄位值的整個結果集中的結果數(results="yes")，或整個結果集中欄位值的總計。 「results」的預設值為「no」。 對於非清單類型欄位，results="yes"和results="no"是相等的。 此標籤僅在 <search-field-values> 循環內有效。 |
| 4 |
<search-field-value-counter> |
此標籤輸出當前 <search-field-values> 循環迭代的序數計數器。 此標籤僅在 <search-field-values> 循環內有效。 |
建議標籤
Sempless提供方便使用的「您是指？」 服務，以建議替代搜尋詞。 例如，如果使用者拼錯搜尋詞，建議可協助使用者建議正確的拼字來尋找結果。 系統也可以建議相關關鍵字，協助使用者發現結果。 產生建議時，建議服務會使用兩本字典：一種是根據帳戶語言（在Indexing > Words and Languages > Language下設定），另一種是根據帳戶索引中的關鍵字唯一建立。
「建議」服務不適用於中文、日文或韓文。
| 標記 |
說明 |
|
|---|---|---|
| 1 |
<search-if-suggestions> ... </search-if-suggestions> |
使用任何「建議」範本標籤來包住這些標籤，例如 <search-seccuption> 、 <search-suckement-link> 等。 如果搜尋產生建議，搜尋引擎會輸出並處理開啟與關閉標籤之間的一切。 如果搜尋未產生建議，則不會輸出任何巢狀內容。 |
| 2 |
<search-suggestions> ... </search-suggestions> |
此標籤會產生「建議」回圈，其中包含建議搜尋詞的清單（例如，「打算」、「預期」和「打算」，以原始輸入為「意向」的查詢）。 產生詞語清單時，搜尋引擎最多重複5次巢狀內嵌的HTML和／或範本標籤，這是建議的最大數目。 使用count屬性來指定產生的建議數（介於0-5之間）。 <search-explications> 標籤可在頁面上多次顯示，以重複建議清單。 根據每個產量的結果數來排序多個建議。 在開啟與關閉 <search-if-effications> 標籤之間巢狀內嵌 <search-expiliations> 標籤。 |
| 3 |
<search-suggestion-link> ... </search-suggestion-link> |
此標籤會使用選取的建議搜尋詞來產生原始搜尋查詢的連結，而非原始搜尋詞。 標籤接受並只列印任何HTML屬性，例如類別、目標和樣式。 標籤也可以接受URL屬性，其值將用作所產生連結的基本URL。 標籤只能出現在 <search-expiliations> 回圈中。 |
| 4 |
<search-suggestion-text /> |
此標籤會列出目前建議的查詢詞語（例如，「打算」原本輸入為「意向」的查詢）。 標籤沒有屬性，只能顯示在 <search-explications> 循環中。 |
| 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> |
此標籤會傳回目前建議搜尋詞的數值索引。 標籤必須出現在open和close <search-seccuption> 標籤之間。 |
| 9 |
<search-suggestion-total> |
此標籤會傳回產生的建議搜尋詞總數。 標籤必須出現在open和close <search-seccuption> 標籤之間。 |
| 10 |
<search-suggestion-result-count> |
此標籤會傳回建議搜尋詞的結果總數。 標籤必須出現在open和close <search-seccuption> 標籤之間。 |
範本字串標籤
下列標籤會在範本中該點將字串輸出至HTML。
| 標記 |
說明 |
|
|---|---|---|
| 1 |
<search-body> |
HTML body標籤，內含「基本外觀」區段在「範本」連結下所設定的任何「搜尋連結色彩」設定。 新增背景屬性至此標籤，以在結果頁面上顯示背景影像。 任何新增至此標籤的顏色屬性都會覆寫「基本外觀」區段所設定的「搜尋連結顏色」設定。 |
| 2 |
<search-header> |
在「範本」連結下的「基本外觀」區段中設定的「搜尋結果標題」HTML。 |
| 1 |
<search-cdata> ... </search-cdata> |
search-cdata標籤將替換為其XML等效標籤： <search-cdata> 已更換為 <![CDATA["和</search-cdata> 標籤被" ]]> "替換。 XML剖析器不會剖析開啟與關閉標籤之間的任何資訊。 |
| 4 |
<search-query query-number="XX" encoding="html/javascript/json/perl/url/none"> |
訪客輸入的查詢。 進階的可選「query-number」屬性可控制此標籤輸出的編號查詢字串。 例如， <search-query-number=1> 會輸出 sp_q_1 cgi參數的內容。 如果未指定"query-number"，或如果query-number是"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> |
插入開始和結束表單標籤。 將方法和操作屬性插入begin form標籤中。 接受其他屬性，包括語言的dir="RTL"屬性，以及與JavaScript相關的"name"和"onSubmit"屬性。 |
| 15 |
<search-input-account> |
插入指定帳號的表單輸入標籤。 |
| 16 |
<search-input-gallery> |
插入指定圖庫編號的表單輸入標籤。 |
| 17 |
<search-input-query query-number="XX"> |
插入指定查詢字串的表單輸入標籤。 進階的可選「query-number」屬性會控制表單輸入標籤使用的編號查詢。 例如， <search-input-query query-number=1> 輸出 sp_q_1 查詢的表單輸入標籤。 如果未指定"query-number"，或如果"query-number"是"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"> |
encoding 屬性是可選的；預設值為 json 。
注意： 只有在核心搜索查詢參數中指定了 sp_trace=1 時，此標籤才具有輸出。 請參見 Backend search CGI parameters中表中的第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的標籤。
| 標記 |
說明 |
|
|---|---|---|
| 3 |
<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> |
這些進階標籤會根據「name」屬性中指定的CGI參數是否具有「value」屬性中指定的值，在它們之間包含HTML。 |
| 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> 標籤。 當標籤寫入瀏覽器時，輸入的字詞會取代 search-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的值值<a9/>被列為CGI參數，則在傳送至瀏覽器的 <option> 標籤的末尾自動添加選定的參數會列為特定 <search-option> 標籤中的值。 這樣，您就可以自動讓搜尋結果中的預設清單方塊選擇與目前查詢相同。 例如，典型清單框如下所示： 該清單框的相應模板代碼如下： 如果要將清單框添加到搜索模板的 <form> 中，請使用 <search-select...> 代替 <select...> 、 </search-select> </select> 、 <search-option...> 取代 <option...> 和 </search-option> 取代 </option> ... |
| 1 |
<search-sort-by-field name="field-name" count="XX"> ... </search-sort-by-field> |
這些進階標籤會在它們之間的HTML周圍建立錨點連結。 按一下此錨點時，會顯示在指定欄位上排序結果的頁面。 可選的計數屬性指定要在結果頁上顯示的結果數。 如果省略計數，則會使用目前頁面上使用的計數。 |
日期格式字串
您可以在日期格式字串中使用下列轉換規格：
| 日期格式字串 |
說明 |
|---|---|
| %A |
相符項目：完整工作日名稱的國家代表，例如「星期一」。 語言學 > 字詞與語言 > 語言中的設定確定國家代表。 請參閱關於字詞和語言。 |
| %a |
相符項目：縮寫工作日名稱的國家代表，其中縮寫是前三個字元，例如"Mon"。 語言學 > 字詞與語言 > 語言中的設定確定國家代表。 請參閱關於字詞和語言。 |
| %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.請參閱結果循環字串tags。
-
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 |
| 英文（加拿大） |
en_CA |
| 英文（大不列顛） |
en_GB |
| 英文（美國） |
en_US |
| 法文（比利時） |
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 header
您可以使用下列標籤來指定「內容類型」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屬性，則不會將charset值寫入content-type標題。
如果指定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"。
您可以選擇將<search-xml-decl>標籤取代為您自己的?xml標籤。
在另一個中包括搜索模板
要將一個搜索模板包含在另一個中，請使用<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">
當客戶點按包含此行代碼的標準表單時，會顯示「清倉」搜尋傳輸範本及其搜尋結果。
請參閱在搜尋表單中使用系列。
請參閱使用框架與表單。
請參閱範例進階搜尋表單。