Show Menu
THEMEN×

Vorlagen

Vorlagen

Tags für Präsentationsvorlagen

Eine Liste der Tags und Attribute für die Site-Suche/das Merchandising für Präsentationsvorlagen.
Eine Präsentationsvorlage ist eine HTML-Datei, die Präsentationsvorlagen-Tags enthält, die von Site-Suche/Merchandising definiert werden. Diese Tags geben an, wie die Suchergebnisse, die Kunden sehen, formatiert sind.
Sie können aus den folgenden Präsentations-Tag-Gruppen auswählen:

Erklärungen

Deklarationen sind spezielle Tags mit geführter Deklaration, die Sie oben in einer Präsentationsvorlage auf der obersten Ebene festlegen können. Alle nachfolgenden Deklarationen werden ignoriert, einschließlich Deklarationen in eingeschlossenen Vorlagen.
Tag
Beschreibung
1
<guided-content-type-header content="content-type">
Standardmäßig wird die Präsentationsvorlage mit einem Mime-Typ von text/html zurückgesendet. Sie können den Inhaltstyp für dieses Tag ändern.
Deklarieren Sie dieses Tag in Ihrer Präsentationsvorlage so hoch wie möglich. Fügen Sie mit diesem Tag keinen anderen Text in derselben Zeile hinzu.
2
<guided-xml-de[charset="charset"]>
Wenn Sie XML zurückgeben, können Sie mit diesem Tag die XML-Deklaration erstellen. Machen Sie dieses Tag zur ersten Zeile in Ihrer Präsentationsvorlage. Wenn Sie dieses Tag verwenden, wird der Inhaltstyp automatisch auf text/xml eingestellt, es sei denn, Sie überschreiben ihn mit <guided-content-type-header> in der ersten Zeile. Wenn Sie keine Zeichensätze angeben, wird standardmäßig UTF-8 verwendet. Dieses Tag gibt die folgende Ausgabe in Ihrem XML-Dokument aus:
<?xml version="1.0" encoding="charset-name" standalone="yes" ?>

Ergebnisse

Tag
Beschreibung
1
<guided-results [gsname="searchname"]></guided-results>
Das Tag mit geführten Ergebnissen definiert die Grenzen einer Ergebnisschleife. Auf alle Ergebnisse kann durch Angabe eines gsname- Attributs zugegriffen werden. Wenn kein gsname angegeben wird, werden die standardmäßigen Suchergebnisse angezeigt.
2
<guided-result-link [gsname="fieldname"] [attr="value"]+></guided-result-link>
Um einen Link zu einem bestimmten Ergebnis zu erstellen, verwenden Sie das Tag mit dem Link-geführten Ergebnis . Durch die Definition eines gsname- Attributs können Sie ein Feld aus dem Index anstelle des standardmäßigen "loc"-Tags verwenden, das auf die "search-url" verweist. Alle anderen Attribute, z. B. Klasse und Ziel, können ebenfalls übergeben werden, die im resultierenden Anker-Tag ausgegeben werden.
3
<guided-result-img gsname="fieldname" [attr="value"]+>
Das <guided-result-img>- Tag hilft beim Erstellen von Bild-Tags, anstatt Variablen in ein img- Tag einzubetten.
Geben Sie im gsname- Attribut das für den Bildpfad zu verwendende Feld an. Das Ergebnis ist ein img- Tag mit allen standardmäßigen HTML-Attributen, die Sie definiert und übergeben haben. Das folgende Beispiel:
<guided-result-img gsname="thumbnail"  class="thumb" border="0"/>
becomes:
<img src="prod8172.jpg" class="thumb"  border="0"/>
4
<guided-result-field gsname="fieldname" [escape="html|url|js|json|ijson|0"]/>
Alle Informationen, die in den Ergebnissen angezeigt werden sollen, werden als <guided-result-field> -Tag angezeigt (es sei denn, es werden automatisch generierende Tags wie das <guided-result-img>- Tag verwendet).
Geben Sie den Namen des Suchindexfelds in gsname an . Die exakte übergebene Zeichenfolge wird in der Vorlage ausgegeben.
Sie können eine Escape-Option angeben, wenn dieses Feld anders als in der Transportvorlage angegeben auskommentiert werden soll.
Diese Kodierung wird auf jede Kodierung angewendet, die in der Transportvorlage angegeben wurde.
5
<guided-if[-not]-result-field gsname="fieldname></guided-if-result-field>
Dieser Satz von bedingten Tags ist "true", wenn im jeweiligen Feld Inhalte angezeigt werden sollen. Wenn kein Inhalt vorhanden ist, lautet die Bedingung "false". Mithilfe der Tags können Sie festlegen, ob umgebendes HTML angezeigt oder nicht angezeigt wird, wenn kein Wert vorhanden ist, ein anderes Bild angezeigt wird usw.
<guided-if-result-field gsname="thumbnail">     <guided-result-img gsname="thumbnail" class="thumb" /> <guided-else-result-field>     <img src="nothumb.jpg" class="nothumb" /> </guided-if-result-field>
6
<guided-if[-not]-result-wrap> <guided-else-result-wrap> </guided-if[-not]-result-wrap>
Bei der Anzeige der Ergebnisse in Spalten wird mit diesem Tag ermittelt, ob das aktuelle Ergebnis das Ende einer Spalte markiert.
Wenn die boolesche Bedingung wahr ist, wird am Ende des Ergebnisses HTML hinzugefügt, um die Zeile abzuschließen und eine neue zu starten. Wenn es sich um die letzte Zeile handelt, wird keine neue Zeile gestartet.
Weitere Informationen zu diesem Tag finden Sie unter <guided-if-not-last> .
<guided-if-result-wrap>      </div>      <guided-if-not-last>          <div>      </guided-if-not-last>  </guided-if-result-wrap>
7
<guided-results-found [gsname="searchname"]/>
Gibt eine 1 zurück, wenn die Back-End-Suchanfrage Ergebnisse zurückgegeben hat, und 0, wenn dies nicht der Fall war. Wenn kein gsname angegeben ist, geht das Tag von der primären Suche aus. Dieses Tag ist nützlich, um Logik an JavaScript-Routinen zu übergeben.
8
<guided-results-total [gsname="searchname"]/>
Gibt die Gesamtanzahl der Ergebnisse im angegebenen Ergebnissatz zurück. Geht von der Standardsuche aus, wenn kein gsname angegeben wird.
9
<guided-results-lower [gsname="searchname"]/>
Gibt die Ergebnisnummer des unteren Ergebnisses auf der Seite für den angegebenen Ergebnissatz zurück. Geht von der Standardsuche aus, wenn kein gsname angegeben wird.
10
<guided-results-upper [gsname="searchname"]/>
Gibt die Ergebnisnummer des oberen Ergebnisses auf der Seite für den angegebenen Ergebnissatz zurück. Geht von der Standardsuche aus, wenn kein gsname angegeben wird.
11
&amp;lt;/guided-if[-not]-results-found&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Zeigt Inhalt an, wenn Ergebnisse gefunden werden. Zeigt auch keine HTML-Ergebnisse an, wenn keine Ergebnisse gefunden werden.
<guided-if-results-found gsname="products">     <guided-results gsname="products">         ...     </guided-results> <guided-else-results-found>      No results were found. </guided-if-results-found>
12
<guided-result-title/>
Das <guided-result-title>- -Tag gibt den Wert des mit <title> -Transport-Tag angegebenen Vorlagenfelds des Titels an.
13
<guided-result-description/>
Das <guided-result-description>- -Tag gibt den Wert des mit <description> transport-Tag angegebenen Felds der Beschreibungstransportvorlage an.
14
<guided-result-loc/>
Das < guided-result-loc>- Tag gibt den Wert des Felds der LOC Transport-Vorlage an, das mit <loc> transport-Tag angegeben wurde.
15
&amp;lt;/guided-if-result-field&amp;gt; &lt;/code> &lt;/p> &lt;/td>

"True", wenn im jeweiligen Feld Inhalt angezeigt wird. Wenn kein Inhalt vorhanden ist, lautet die Bedingung "false". Verwenden Sie die Tags, um festzulegen, ob umliegende HTML-Elemente angezeigt werden, wenn kein Wert vorhanden ist, ein anderes Bild angezeigt wird usw.
<guided-if-result-field gsname="thumbnail">      <guided-result-img gsname="thumbnail" class="thumb"/> <guided-else-result-field>      <img src="nothumb.jpg" class="nothumb"/> </guided-if-result-field>
16
<guided-result-attribute-table gsname="tablename">
Dieses Tag stellt eine Schleife durch Attribut-Tabelle bereit, die in der Transportvorlage mit dem Tag <attribute_table> transport definiert ist. Für die Anzeige der Attributfeldwerte steht das Tag <guided-result-attribute-table-field> zur Verfügung. Es ist auch möglich, das Tag mit geführten Ergebnissen innerhalb einer Schleife für die Anzeige anderer Ergebnisfelder zu verwenden.
17
<guided-result-attribute-table-field gsname="fieldname" [escape="html|url|js|json|0"]/>
Zeigt das Attributtabellenfeld an, wie in der Transportvorlage definiert.
...
    
    &amp;lt;ul&amp;gt;
    
    &amp;lt;guided-result-attribute-table&amp;nbsp;gsname=&quot;downloads&quot;&amp;gt;
    &amp;nbsp;&amp;nbsp;lt;li&amp;gt;
    &amp;nbsp;nbsp;nbsp;nbsp;nbsp;nbsp;&amp;nbsp;nbsp;;&amp;nbsp;&amp;lt;a&amp;nbsp;href=&quot;&amp;lt;guided-result-attribute-table-field&amp;nbsp;gsname=&quot;download_link&quot;&amp;nbsp;/&amp;
    &amp;nbsp;
    &amp;nbsp;&amp;nbsp;&amp;nbsp; bsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;nbsp;nbsp;nbsp;&amp;lt;guided-result-attribute-table-field&amp;nbsp;gsname=&quot;download_title&quot;&amp;nbsp;/&amp;
    &amp;nbsp;nbsp;nbsp;nbsp;&amp;nbsp; bsp;&amp;nbsp;&amp;nbsp;&amp;lt;/a&amp;gt;&amp;nbsp;(&amp;lt;guided-result-field&amp;nbsp;gsname=&quot;title&quot;/&amp;gt;)
    &amp;nbsp;&amp;nbsp;&amp;lt;/li>
    
    ;lt;/guided-result-attribute-table&amp;gt;
    
    &amp;lt;/ul&amp;gt;...
    
    &amp;lt;/guided-results&amp;gt; &lt;/code> &lt;/p> &lt;/td>

18
<guided-trace [gsname="searchname"]/>
Gibt die in den Trace-Daten im allgemeinen Abschnitt der JSON-Datenausgabe enthaltenen Ablaufverfolgungsinformationen von der Transportvorlage für die jeweilige Suche aus.
Wenn kein Suchname angegeben wird, wird die Standardeinstellung angenommen.
19
<guided-result-trace/>
Gibt den JSON-Inhalt aus, der in den Ergebnissen > Ablaufverfolgungsinformationen der JSON-Datenausgabe durch die Transportvorlage für das aktuelle Suchergebnis gefunden wird.
Dieses Tag ist nur in der <guided-results></guided-results>- Schleife gültig.

Facets

Facets sind Navigationskomponenten, mit denen Sie in die Suchergebnisse vordringen können. Mithilfe der Facetten-Tags können Sie verschiedene Facetten Ihrer Präsentationsvorlage anzeigen. Sie verweisen auf Facetten anhand des Namens.
Siehe Grundlagen .
Weitere Informationen finden Sie unter Info zu Facet Rail .
Tag
Beschreibung
1
<guided-dynamic-facets></guided-dynamic-facets>
Ein Schleifenkontext für dynamische Facetten einer bestimmten Suche.
Das Tag für die Präsentationsvorlage wird so bearbeitet, dass das gsname-Attribut automatisch vom <guided-dynamic-facets>- Schleifenkontext bereitgestellt wird.
2
<guided-facet-display-name gsname=" facetname "/>
Gibt die Anzeigenbezeichnung der Facette zurück.
Wenn die Facette das <display-name>- Tag in der Transportvorlage verwendet, wird der Inhalt dieses Tags zur Beschriftung.
3
<guided-facet-rail></guided-facet-rail>
Definiert einen Abschnitt in der Präsentationsvorlage, der als sich wiederholendes Muster für jede Facette in der Facettenleiste verwendet wird.
Jede Facette, die zur Facettenleiste gehört, verwendet diesen Abschnitt, um ihre Ausgabe zu bewerten.
Im Folgenden finden Sie ein Beispiel für eine Facettenleiste:
<guided-facet-rail>   <guided-facet>     <guided-facet-display-name/>     ...     </guided-facet>   </guided-facet-rail>
Beachten Sie, dass die folgenden Tags kein gsname- Attribut benötigen, wenn innerhalb des <guided-facet-rail>- Tags ein Wert vorhanden ist, da dieser zur Suchzeit dynamisch bestimmt wird und korrekt ersetzt wird:
  • guided-facet
  • guided-facet-display-name
  • guided-facet-total-count
  • guided-facet-undo-link
  • guided-facet-undo-path
  • guided-facet-verhalten
Die Sortierkriterien auf der Facet Rail- Seite bestimmen die Position der Facetten. Sie können die Sortierreihenfolge aus der Dropdown-Liste "Facets-Methode sortieren"auswählen.
Dieses Tag kann optional einen gsname-Attributwert von _dynamic_facets annehmen, der einen Schleifenkontext für alle dynamischen Facetten für diese Suche bereitstellt . Diese vordefinierte Facet-Leiste wird auch in der Business Rules-Benutzeroberfläche für Action Push Facet X in der Facet-Leiste '_dynamic_facets' zur Positionierung von Y angezeigt ".
Weitere Informationen finden Sie unter Info zu Facet Rail .
4
<guided-facet gsname=" facetname " height=" 60px " width=" 120px "></guided-facet>
Verwenden Sie das Tag mit der Facette- Zeichenfolge, um einen Bereich zu definieren, in dem sich alle Facetten-Tags auf eine bestimmte Facette beziehen. Dieses Tag ist auch ein boolescher Tag, der den gesamten Inhalt verbirgt, wenn keine Werte in der Facette vorhanden sind. In diesem Fall hat es keinen Sinn, die Facettenwerte auszugeben.
Die Attribute für Höhe und Breite sind optional und die Abmessungen werden in Pixel (px) angegeben. Der Visual Rule Builder (VRB) verwendet diese beiden Attribute und zeigt ein gepunktetes Feld als interaktiven Platzhalter an, wenn die Facette ausgeblendet wird.
Wenn sich der Anzeigename in der Facette befindet und die Facette ausgeblendet ist, wird auch der Name ausgeblendet. Befindet sich der Name jedoch außerhalb der Facette, können Sie ihn nur ausblenden, wenn ein zone-Tag oder ein geführte, wenn Facetten-sichtbares Tag umschlossen ist.
5
<guided-if[-not]-facet-long [gsname="facetname"]></guided-if[-not]-facet-long>
Dieses bedingte Tag ist "true", wenn die Anzahl der Facettenwerte über dem in der Konfiguration definierten Längenschwellenwert liegt. Verwenden Sie sie, um eine Facette als anderes UI-Element anzuzeigen (z. B. eine abgeschnittene Liste oder ein Bildlauffeld), wenn die Liste zu lang ist.
<guided-facet name="category">     <guided-if-facet-long>         <select>             <guided-facet-values>                 <guided-facet-option />             </guided-facet-values>         </select>     <guided-else-facet-long>         <guided-facet-values>             <guided-facet-value-link><guided-facet-value /></guided-facet-link>         </guided-facet-values>     </guided-if-facet-long> </guided-facet>
Sie können diese Bedingung auch außerhalb des Kontextes eines benannten geführten Facet- Blocks verwenden, indem Sie eine bestimmte Facette direkt über das gsname- Attribut referenzieren.
<guided-if-facet-long gsname="category">     The category facet is very long! </guided-if-facet-long>
6
<guided-if[-not]-facet-selected [gsname="facetname"]></guided-if[-not]-facet-selected>
Dieses bedingte Tag ist "true", wenn auf die Facette mindestens einmal geklickt wird und derzeit ein Facettenwert ausgewählt ist. Es wird zum Anzeigen oder Ausblenden von HTML- oder gs-Tags verwendet, je nachdem, ob auf eine Facette geklickt wurde.
<guided-facet name="category">     <guided-if-facet-selected>         This facet has been selected.  You can no longer refine it.     <guided-else-facet-selected>     <guided-facet-values>         <guided-facet-value-link><guided-facet-value /></guided-facet-link>     </guided-facet-values>     </guided-if-facet-selected> </guided-facet>
Sie können diese Bedingung auch außerhalb des Kontextes eines benannten geführten Facet- Blocks verwenden, indem Sie eine bestimmte Facette direkt über das gsname- Attribut referenzieren.
<guided-if-facet-selected gsname="category">     The category facet is selected! </guided-if-facet-selected>
7
<guided-if[-not]-facet-single [gsname="facetname"]></guided-if[-not]-facet-single>
Dieses bedingte Tag ist "true", wenn nur ein Facet-Wert vorhanden ist. Verwenden Sie das Tag, um die Anzeige der Facette zu ändern, wenn sie nicht in der Lage ist, die Ergebnisse zu verfeinern.
<guided-facet name="category">     <guided-if-facet-single>         Facet is not refinable.     <guided-else-facet-single>         <guided-facet-values>             <guided-facet-value-link><guided-facet-value /></guided-facet-link>         </guided-facet-values>     </guided-if-facet-single> </guided-facet>
Sie können diese Bedingung auch außerhalb des Kontextes eines benannten geführten Facet- Blocks verwenden, indem Sie eine bestimmte Facette direkt über das gsname- Attribut referenzieren.
<guided-if-facet-single gsname="category">     There is only one value in the category facet! </guided-if-facet-single>
8
<guided-if[-not]-facet-multiselect [gsname="facetname"]></guided-if[-not]-facet-multiselect>
Dieses Bedingungs-Tag ist "true", wenn die Facette mehrseitig ausgewählt ist. Mit dem Tag können Sie die Darstellung der Facette in <guided-facet-rail>- oder <guided-dynamic-facets>- -Tags ändern.
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;guided-if-facet-multiselect&amp;gt;
    &amp;nbsp;..
    &amp;nbsp;&amp;lt;guided-else-facet-multiselect&amp;gt;
    &amp;nbsp;..
    &amp;nbsp;&amp;lt;/guided-if-facet-multiselect&amp;gt;
    &amp;nbsp;&amp;nbsp;&amp;nbsp;nbsp;nbsp;..
    &amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;/guided-facet&amp;gt;
    &amp;nbsp;&amp;nbsp;&amp;lt;/guided-facet-rail&amp;gt; &lt;/code> &lt;/p> &lt;/td>

9
<guided-facet-values [gsname=" facetname "]></guided-facet-values>
Dies ist das Tag des Iterators für den Facettenwert. Sie können sie im Kontext eines benannten Geführte-Facet- Blocks definieren. In diesem Fall können Sie den gsname weglassen . Sie können sie auch außerhalb eines Geführte-Facetten- Blocks definieren. Es wäre jedoch erforderlich, dass das gsname- Attribut identifiziert, um welche Facettenwerte angezeigt werden.
Sie können dieses Tag auch verwenden, um die Facettenwerte außerhalb des Kontexts eines benannten Facettenblocks anzuzeigen. Sie referenzieren eine bestimmte Facette direkt mit dem gsname- Attribut .
<script>      registerFacetValues('category', '<guided-facet-values gsname="category"><guided-facet-value/>,</guided-facet-values>'); </script>
10
<guided-facet-value [escape="html|url|js|json|0"]/>
Gibt die Zeichenfolge des aktuellen Facet-Werts aus.
Standardmäßig ist der Wert HTML-Escape-Zeichen. Mit der Escape-Option können Sie die Escape-Methode ändern, mit der der Wert Escapezeichen verwendet wird.
11
<guided-facet-count/>
Gibt die Anzahl der Ergebnisse aus, die mit dem aktuellen Facet-Wert übereinstimmen.
12
<guided-facet-value-link [attr="value"]+></guided-facet-value-link>
Erstellt einen Link um die Facet-Wertzeichenfolge, auf den der Besucher der Site klicken kann. Der Pfad wird automatisch generiert, um die Ergebnisse um den aktuellen Facettenwert einzugrenzen. Es unterstützt die direkte Übergabe jedes Attributs an das Anker-Tag.
<guided-facet-values>     <guided-facet-value-link class="facetlink"><guided-facet-value /></guided-facet-value-link> </guided-facet-values>
13
<guided-if-facet-value-selected> <guided-else-facet- value-selected> </guided-if-facet-value-selected>
Ändert die Anzeige des Facettenwerts, wenn er aktuell ausgewählt ist. Wenn sie bereits ausgewählt wurde, ist sie in den meisten Fällen nicht mehr miteinander verknüpft.
<guided-facet-values>      <guided-if-facet-value-selected>          <b><guided-facet-value/></b>      <guided-else-facet-value-selected>          <guided-facet-link><guided-facet-value/></guided-facet-link>         </guided-if-facet-value-selected> </guided-facet-values>
14
&amp;lt;/guided-if[-not]-facet-value-ghost&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Ändert die Anzeige des Facettenwerts, wenn es sich um einen Ghost-Wert handelt. Wenn ein Facettenwert ein Ghost-Wert ist, wird er normalerweise in kursiver Form angezeigt, um anzugeben, dass der Wert fehlt oder "gehostet"ist.
Der folgende Codeausschnitt ist ein Beispiel für einen Facettenblock:
<guided-facet-values>     <guided-if-facet-value-selected>         <b><guided-facet-value /> (<guided-facet-count />)</b>             <guided-else-facet-value-selected>                 <guided-if-facet-value-ghost>                     <i><guided-facet-value /> (0)</i>                 <guided-else-facet-value-ghost>             <guided-facet-link class="link"><guided-facet-value /></guided-facet-link> (<guided-facet-count />)         </guided-if-facet-value-ghost>     </guided-if-facet-value-selected> </guided-facet-values>
15
<guided-facet-undo-link gsname=" facetname "></guided-facet-undo-link>
Zeigt einen Link zum Rückgängigmachen für eine bestimmte Facette an. Wenn mehrere ausgewählte Facetten vorhanden sind, hebt dieser Link die Auswahl aller Werte der jeweiligen Facette auf. Geben Sie dem Facetten einen Namen. Wenn die Facette derzeit nicht ausgewählt ist, ist der Link der aktuelle Pfad.
Im Folgenden finden Sie ein Beispiel für die Verwendung dieses Tags:
<guided-if-facet-selected gsname="category">     <guided-facet-undo-link gsname="category">Undo Category</guided-facet-undo-link> </guided-if-facet-selected>
16
Dieses bedingte Tag ist "true", wenn die Anzahl der Facettenwerte über dem in der Konfiguration definierten Längenschwellenwert liegt. Verwenden Sie sie, um eine Facette als anderes Element der Benutzeroberfläche anzuzeigen (z. B. eine abgeschnittene Liste oder ein Bildlauffeld), wenn die Liste zu lang ist.
<guided-facet gsname="category">      <guided-if-facet-long>          <div class="long_facet">              <guided-facet-values>                  <guided-facet-link><guided-facet-value/></guided-facet-link>              </guided-facet-values>          </div>      <guided-else-facet-long>          <div class="facet">              <guided-facet-values>                  <guided-facet-link><guided-facet-value/></guided-facet-link>              </guided-facet-values>          </div>      </guided-if-facet-long>  </guided-facet>
Sie können diese Bedingung auch außerhalb des Kontextes eines benannten geführten Facet- Blocks verwenden, indem Sie eine bestimmte Facette direkt über das gsname- Attribut referenzieren.
<guided-if-facet-long gsname="category">      The category facet is very long! </guided-if-facet-long>
17
<guided-if-facet-selected [gsname="facetname"]> <guided-else-facet-selected></guided-if-facet-selected>
Dieses bedingte Tag ist "true", wenn auf die Facette mindestens einmal geklickt wird und derzeit ein Facettenwert ausgewählt ist. Sie kann zum Anzeigen oder Ausblenden von HTML- oder gs-Tags verwendet werden, je nachdem, ob auf eine Facette geklickt wird.
<guided-facet gsname="category">      <guided-if-facet-selected>          This facet has been selected.  You can no longer refine it.      <guided-else-facet-selected>          <guided-facet-values>              <guided-facet-link><guided-facet-value/></guided-facet-link>          </guided-facet-values>      </guided-if-facet-selected> </guided-facet>
Sie können diese Bedingung auch außerhalb des Kontextes eines benannten geführten Facet- Blocks verwenden, indem Sie eine bestimmte Facette direkt über das gsname- Attribut referenzieren.
<guided-if-facet-selected gsname="category">      The category facet is selected! </guided-if-facet-selected>
18
Dieses bedingte Tag ist "true", wenn nur ein Facet-Wert vorhanden ist. Sie kann verwendet werden, um die Darstellung der Facette zu ändern, wenn sie nicht in der Lage ist, die Ergebnisse zu verfeinern.
<guided-facet gsname="category">      <guided-if-facet-single>          Facet is not refinable.      <guided-else-facet-single>          <guided-facet-values>              <guided-facet-link><guided-facet-value/></guided-facet-link>          </guided-facet-values>      </guided-if-facet-single> </guided-facet>
Sie können diese Bedingung auch außerhalb des Kontextes eines benannten geführten Facet- Blocks verwenden, indem Sie eine bestimmte Facette direkt über das gsname- Attribut referenzieren.
<guided-if-facet-single gsname="category">      There is only one value in the category facet! </guided-if-facet-single>
19
Mit dieser Bedingung können Sie überprüfen, ob die angegebene Facette überhaupt Werte enthält. Sie können ihn verwenden, um anstelle einer leeren Facette eine andere Facette anzuzeigen.
20
<guided-facet-total-count gsname=" facetname "/>
Gibt die Gesamtanzahl der Ergebnisse aus, die innerhalb der angegebenen Facette liegen.
21
<guided-facet-value gsname=" Zugehöriger benutzerdefinierter Facet-Wert " [escape="html|url|js|json|0"]/>
Gibt die Zeichenfolge eines Werts aus, der der Facette zugeordnet ist. Einer Facette können 0 oder mehr Felder zugeordnet sein. Verknüpfte Felder sind selten vorhanden. Zur Unterstützung dieser Felder konfigurieren Sie die Transportvorlage.
22
<guided-if-facet-value gsname=" associated custom facet value "/><guided-else-facet-value></guided-if-facet-value>
Prüft, ob der Facet-Wert einen zugewiesenen Feldwert hat.
23
<guided-facet-link [attr=" value "]+></guided-facet-link>
Erstellt einen Link um die Facet-Wertzeichenfolge, auf den der Kunde klicken kann. Der Pfad wird automatisch generiert, um die Ergebnisse um den aktuellen Facettenwert einzugrenzen. Es unterstützt die direkte Übergabe jedes Attributs an das Anker-Tag.
<guided-facet-values>      <guided-facet-link class="facetlink"><guided-facet-value/></guided-facet-link> </guided-facet-values>
24
<guided-facet-value-path [escape="html|url|js|json|0"]/>
Erstellt einen eigenen Link zu einem Facettenwert.
<guided-facet-values>      <guided-lt/>a href="<guided-facet-value-path/>"<guided-gt/><guided-facet-value/></a> </guided-facet-values>
Standardmäßig ist der Wert mit einem Escape-Zeichen versehen. Sie können jedoch eine weitere Kodierungsebene hinzufügen, indem Sie angeben, welcher Escape-Modus Sie mithilfe des Escape-Parameters verwenden möchten.
25
<guided-facet-value-child></guided-facet-value-Children>
Während <guided-facet-values> jeden Facettenwert durchlaufen, durchläuft dieses Tag alle untergeordneten Werte einer verschachtelten Facette. Verwenden Sie in diesem Tag die typischen facettierten Tags, um Links zu erstellen, Links rückgängig zu machen und Facettenwerte anzuzeigen. Dieses Tag muss sich innerhalb von <guided-facet-values> befinden, da es verschachtelte Schleifen ausführt.
Ein Beispiel für die Verwendung dieses Tags ist Folgendes:
<guided-facet-values>   <guided-facet-link title='<guided-facet-value />'><guided-facet-value /> (<guided-facet-count />)</guided-facet-link>   <guided-if-facet-value-has-children>    <guided-facet-value-children>     <guided-facet-link title='<guided-facet-value />'><guided-facet-value /> (<guided-facet-count />)</guided-facet-link>    </guided-facet-value-children>   </guided-if-facet-value-has-children> </guided-facet-values>
26
<guided-if-facet-value-has-children> <guided-else-facet- value-has-children> </guided-if-facet-value-has-children>
Prüft, ob der aktuelle Facet-Wert untergeordnete Werte hat. Es wird empfohlen, die Tags <guided-facet-value-child> zu verwenden, bevor Sie sie verwenden . Die "else"-Klausel ist optional.
27
&amp;lt;guided-else[-not]-facet-value-over-length-Schwellenwert&amp;gt;
    
    &amp;lt;/guided-if[-not]-facet-value-over-length-Schwellenwert&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Bestimmt, ob der aktuelle Facet-Wert in der Facettenwertschleife über dem Längenschwellenwert liegt. Normalerweise wird er verwendet, um Werte unterhalb des Schwellenwerts auf einer langen Facette anzuzeigen (es sei denn, der Benutzer hat zuvor einen Link "Mehr anzeigen"unter der Facette ausgewählt).
28
&amp;lt;guided-else[-not]-facet-value-equals-length-Schwellenwert&amp;gt;
    
    &amp;lt;/guided-if[-not]-facet-value-equals-length-Schwellenwert&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Stellt fest, ob der aktuelle Facettenwert in der Facettenwertschleife dem Längenschwellenwert entspricht.
29
<guided-facet-value-undo-link></guided-facet-value-undo-link>
Zeigt einen Link zum Rückgängigmachen für eine bestimmte Facette an. Verwenden Sie ihn, um einen Link zum Rückgängigmachen neben einem ausgewählten Facettenwert anzuzeigen. Da dieser Link zum Rückgängigmachen nur diesen ausgewählten Wert rückgängig macht, unterscheidet er sich von <guided-facet-undo-link>, das die Auswahl aller ausgewählten Werte aufhebt.
Hinweis: Wenn die Facette nicht über ein Mehrfachauswahlverhalten verfügt, haben die beiden Rückgängig-Links dasselbe Verhalten. Das heißt, die Facette kann nur einen ausgewählten Wert haben.
Wenn die Facette derzeit nicht ausgewählt ist, ist der Link der aktuelle Pfad. Verwenden Sie dieses Tag nur in einer geführten Facettenwertschleife .
30
<guided-facet-value-undo-path/>
Erstellen Sie einen eigenen Link zum Rückgängigmachen des Facet-Werts.
31
<guided-facet-undo-path gsname=" facetname "/>
Erstellen Sie einen eigenen Facettenrückgängig-Link.
Ähnlich wie das <guided-facet-undo-link>- Tag, außer dass es Ihnen den Rohpfad gibt, um einen eigenen Rückgängig-Link zu erstellen.
32
HTML wird bedingt angezeigt, wenn die angegebene Facette den ausgewählten oder einen einzelnen Wert "value"hat. Dieser Tag-Satz wird häufig verwendet, um eine Facette anzuzeigen, die auf dem in einer anderen Facette ausgewählten Wert basiert.
33
<guided-facet-verhalten gsname=" facetname "/>
Legen Sie das Verhalten einer Facette fest, z. B. normal, haftbar oder Mehrfachauswahl. Es ist nützlich für Kunden, die XML-Ergebnisse erhalten und die die Darstellung der Facette je nach Verhalten dynamisch ändern möchten.
34
&amp;lt;/guided-if-facet[-not]-visible&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Der Inhalt, den dieses Tag umschließt, wird je nach Sichtbarkeitsstatus der Facette ausgeblendet oder offen gelegt. Wenn eine Geschäftsregel die Facette direkt ausblendet oder einblendet, wird jeder Inhalt innerhalb der Facette ausgeblendet oder eingeblendet. Es ist nicht erforderlich, dass diese Tags die Facette umschließen.
Normalerweise wird dieser Tag verwendet, um den Anzeigenamen auszublenden, wenn der Name außerhalb der Facette liegt. Wenn Sie dieses Tag um den Anzeigenamen verschieben, wird der Name ausgeblendet, wenn die Facette ausgeblendet wird.
Dieses Tag ersetzt die Zone und hat viele der gleichen Leistungsvorteile wie die Verwendung von Zonen.

Breadcrumb

Tag
Beschreibung
1
<guided-breadcrumb [gsname=" breadcrumbname "]></guided-breadcrumb>
Das Schleife-Tag für den Breadcrumb. Alle Inhalte zwischen öffnenden und schließenden Tags werden für jede Abfragenummer des aktuellen Status iteriert.
Wenn gsname weggelassen wird, wird der Breadcrumb mit dem Namen "default"verwendet.
2
<guided-breadcrumb-link [gsname="goto|remove|drop"] [attr="value"]+></guided-breadcrumb-link>
Erstellt einen Link im Breadcrumb. Das Standardverhalten ist "goto". Wenn sich der Link anders verhält, verwenden Sie das optionale Attribut gsname , um "remove"oder "drop"anzugeben. Alle im Tag enthaltenen Attribute werden an das resultierende Anker-Tag weitergeleitet.
<guided-breadcrumb>      <guided-breadcrumb-link gsname="remove" class="bc_link">          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>
3
<guided-breadcrumb-value />
Der Wert-Tag gibt den transformierten Wert der aktuellen Breadcrumb-Iteration aus. Es wird nur im Kontext eines Breadcrumb- Blocks verwendet.
<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>
4
<guided-breadcrumb-label />
Das label-Tag gibt eine Beschriftung für einen Breadcrumb-Wert aus, in der angegeben wird, welche Facette ausgewählt wurde, um dieses Breadcrumb-Element zu generieren. Es wird nur im Kontext eines Breadcrumb- Blocks verwendet.
<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-breadcrumb-label/>: <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>
5
<guided-if-breadcrumb-label> <guided-else- breadcrumb-label> <guided-if-breadcrumb-label />
Mit diesem bedingten Tag wird Inhalt bedingt angezeigt, wenn der aktuelle Breadcrumb-Wert eine Beschriftung enthält. Es wird verwendet, um nur Beschriftungen und damit zusammenhängenden Inhalt anzuzeigen, wenn ein Etikett tatsächlich existiert. Es wird nur im Kontext eines Breadcrumb- Blocks verwendet.
<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-if-breadcrumb-label>              <guided-breadcrumb-label/>:          </guided-if-breadcrumb-label>      <guided-breadcrumb-value/></guided-breadcrumb-link> </guided-breadcrumb>
6
<guided-breadcrumb-path [gsname="goto|remove|drop"]/>
Wird zum Erstellen eines eigenen Breadcrumb-Links verwendet.

Menüs

Siehe Menüs .
Tag
Beschreibung
1
<guided-menu gsname="menuname"></guided-menu>
Dies ist das Menü-Wert-Schleifeniterator-Tag. Verwenden Sie das gsname- Attribut, um herauszufinden, welche Menüelemente angezeigt werden.
2
<guided-menu-item-link [attr="value"]+></guided-menu-item-link>
Gibt Ihnen die URL zum Verfeinern der aktuellen Suche nach dem Menüelement.
3
<guided-menu-item-option [attr="value"]+ />
Normalerweise wird ein Menü in einem Auswahlsteuerelement auf einer Vorlage angezeigt. Dieses Tag erleichtert die Erstellung des Select-Steuerelements, da es den HTML-Code zur Generierung der Option für das select-Steuerelement generiert.
Beispielsweise der folgende Codeblock:
<select name="sort" onchange="gcGo(this);"> <guided-menu gsname="sort"> <guided-menu-item-option/> </guided-menu> </select>
Kann HTML wie folgt generieren:
<select name="sort" onchange="gcGo(this);">   <option value="?sort=relevance;sp_sfvl_field=product-type|category|size;" selected="selected">Sort by Relevance</option>   <option value="?sort=avail-code;sp_sfvl_field=product-type|category|size;">Sort by Availability</option>   <option value="?sort=price;sp_sfvl_field=product-type|category|size;">Sort by Price</option> </select>
4
<guided-menu-item-value />
Gibt die Zeichenfolge des Werts zurück, der mit dem Menü verknüpft ist.
5
<guided-menu-item-label />
Gibt die Zeichenfolge der mit dem Menü verknüpften Beschriftung zurück.
6
<guided-menu-item-path />
Gibt die Pfadzeichenfolge zurück. Verwenden Sie das Tag, wenn Sie dem Pfad einen Parameter hinzufügen und einen benutzerspezifischen Link erstellen möchten.
7
<guided-if-menu-item-selected> <guided-else-menu- item-selected> </guided-if-menu-item-selected>
Gibt eine 1 oder 0 zurück, die angibt, ob das aktuelle Menüelement ausgewählt ist.

Pagenav

Die Seitennavigations-Tags können verwendet werden, um eine Reihe von Links zu erstellen, die es einem Benutzer ermöglichen, die Suchergebnisse zu durchblättern.
Tag
Beschreibung
1
<guided-pages></guided-pages>
Das loop-Tag für die Seitennavigation. Jeder Inhalt zwischen den öffnenden und schließenden Tags wird für jede Seite iteriert.
2
<guided-page-link [attr="value"]+></guided-page-link>
Erstellt einen Link in der Seitennavigation.
3
<guided-page-link gsname="first|prev|next|last|viewall|viewpages" [attr="value"]+></guided-page-link>
Erstellt einen Link zur ersten, vorherigen, nächsten oder letzten Seite. Sie können auch einen Link erstellen, um alle Seiten auf einer Seite anzuzeigen.
4
<guided-page-number />
Gibt eine Zeichenfolge mit der aktuellen Seitenzahl zurück.
5
<guided-if-page-selected> <guided-else-page- selected> </guided-if-page-selected>
Dieser Satz von bedingten Tags ist "true", wenn die Seite, die derzeit durchlaufen wird, ausgewählt ist. Normalerweise wird die Seitenzahl im Seitennavigationssteuerelement unterschiedlich angezeigt.
6
<guided-if[-not]-page-prev> <guided-else-page- prev> </guided-if[-not]-page-prev>
Dieser Satz von bedingten Tags ist wahr, wenn die aktuelle Seite eine vorherige Seite hat. Es wird normalerweise dazu verwendet, einen vorherigen Link in der Seitennavigation anzuzeigen, wenn dies sinnvoll ist.
7
<guided-if[-not]-page-next> <guided-else-page- next> </guided-if[-not]-page-next>
Dieser Satz von bedingten Tags ist wahr, wenn die aktuelle Seite eine nächste Seite hat. Es wird normalerweise dazu verwendet, einen vorherigen Link in der Seitennavigation anzuzeigen, wenn dies sinnvoll ist.
8
<guided-if[-not]-page-viewall> <guided-else-page- viewall> </guided-if[-not]-page-viewall>
Wenn eine Suche eine große Ergebnismenge zurückgibt, möchten Sie möglicherweise nicht die Möglichkeit bieten, alle Ergebnisse anzuzeigen. Daher können Sie diesen Satz bedingter Tags verwenden, um zu bestimmen, wann der Link "Alle anzeigen"angezeigt werden soll.
9
<guided-if[-not]-page-viewpages> <guided-else-page- viewpages> </guided-if[-not]-page-viewpages>
Mit diesem Satz bedingter Tags können Sie festlegen, wann der Link "Seiten anzeigen"angezeigt werden soll. Es wird normalerweise verwendet, um einem Kunden das Anzeigen bestimmter Seiten zu ermöglichen.
10
&amp;lt;guided-else-page-link&amp;gt;
    &amp;lt;/guided-if[-not]-page-link&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Prüft, ob die Seitennavigation eine erste Seite, eine vorherige Seite, eine nächste Seite usw. hat.
11
<guided-page-total />
Gibt eine Zeichenfolge mit der Gesamtanzahl der Seiten der Suchergebnisse zurück.
12
<guided-pagination gsname= "pagination_name"></guided-pagination>
Verwenden Sie das Tag für die geführte Paginierung, um einen Bereich zu definieren, in dem sich alle Paginierungs-Tags auf eine bestimmte Paginierungseinstellung beziehen, falls Sie nur wenige Seitennavigationseinstellungen definiert haben.
13
next|last|viewall|viewpages]/&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Erstellt einen eigenen Link in der Seitennavigation.
14
<guided-if-page-high-eq-last> <guided-else-page- high-eq-last> </guided-if-page-high-eq-last>
Prüft, ob die höchste Seite in der Seitennavigation der Gesamtanzahl der Seiten entspricht.
15
<guided-if-page-low-eq-first> <guided-else-page-low-eq-first> </guided-if-page-low-eq-first>
Prüft, ob die niedrigste Seite in der Seitennavigation mit der niedrigsten Seite identisch ist.
16
<guided-if-page-is-multipage> <guided-else-page-is-multipage> </guided-if-page-is-multipage>
Prüft, ob eine einzelne Ergebnisseite oder mehrere Ergebnisseiten vorhanden sind.

Letzte Suchvorgänge

Sie können die Tags der letzten Suchen verwenden, um eine Reihe von Links zu erstellen, über die ein Benutzer schnell eine vorherige Suche ausführen kann, wie im folgenden Beispiel:
<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>

Tag
Beschreibung
1
<guided-previous-searches></guided-new-searches>
Das loop-Tag für die letzten Suchen. Jeder Inhalt zwischen den öffnenden und schließenden Tags wird für jede Seite iteriert.
2
<guided-recent-searches-link [attr="value"]+> </guided-recent-searches-link>
Ermöglicht den Aufbau eines Links zu einer kürzlich durchgeführten Suche. Es unterstützt die Übergabe von HTML-Attributen direkt an das Anker-Tag.
3
<guided-previous-searches-path/>
Ermöglicht Ihnen das Abrufen des relativen URL-Pfads für eine kürzlich durchgeführte Suche in einer geführten Suchschleife. In der Regel würden Sie den Link "geführte-kürzlich-Suche-Link"verwenden . Wenn Sie jedoch einen eigenen Link erstellen möchten, können Sie dieses Tag verwenden. Hier ein Beispiel:
<guided-lt/>a&nbsp;href="<guided_recent_searches_path>"><guided-recent-searches-value></a>
4
<guided-previous-searches-value>
Ermöglicht die Erfassung des Abfragebegriffs, der mit einer kürzlich durchgeführten Suche verknüpft ist.
5
<guided-previous-searches-clear-link [attr="value"]+></guided-previous-searches-clear-link>
Ermöglicht es Ihnen, Ihren Kunden die Möglichkeit zu geben, kürzlich gespeicherte Suchen zu löschen.
6
<guided-previous-searches-clear-path/>
Gibt den Pfad zurück, den <guided-previous-searches-clear-link> verwendet, damit Sie einen eigenen Link erstellen können.
7
&amp;lt;/guided-if-last-searches&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Ermöglicht die Anzeige der letzten Suchen, wenn ein Kunde eine kürzlich durchgeführte Suche durchgeführt hat.

„Meinten Sie“-

Mit den Tags "Meinten Sie"können Sie Links zu Vorschlägen erstellen, wenn eine Suche keine Ergebnisse zurückgibt und der Suchbegriff nicht im Kontowörterbuch steht. Im Folgenden finden Sie ein Beispiel für die Verwendung der Tags "Meinten Sie":
<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>

Tag
Beschreibung
1
<guided-recommendations></guided-recommendations>
Dies ist das Schleife-Tag für Schleifen über die Vorschläge.
2
<guided-recommendations-link [attr="value"]+></guided-recommendations-link>
Erstellt einen Link zu der angegebenen Empfehlung.
3
<guided-recommendations-value />
4
<guided-if[-not]-suggestions><guided-else[-not]- suggestions></guided-if[-not]-suggestions>
Ermöglicht den Test, wenn Vorschläge vorhanden sind.
5
<guided-recommendations-path/>
Gibt die Pfadzeichenfolge für die Empfehlung zurück. Sie können es verwenden, um ein eigenes Anker-Tag zu erstellen. Normalerweise wird stattdessen der Link "guided-recommendations-link"verwendet .
6
<guided-recommendations/>
Ein Vorschlag.
7
<guided-recommendations-result-count/>
Ergebniszählung für die Empfehlung.
8
<guided-if[-not]-suggestion-autosearch> <guided-else[-not]-suggestion-autosearch> </guided-if[-not]-suggestion-autosearch>
Ermöglicht den Test, ob die automatische Suche nach Vorschlägen für null Ergebnisse durchgeführt wurde, falls diese Funktion aktiviert ist.
9
<guided-recommendations-original-query/>
Gibt die ursprüngliche Abfrage zurück, wenn die automatische Suche durchgeführt wurde.
Verwendungsbeispiel:
<guided-if-suggestion-autosearch>     Search for <guided-query-param gsname="q" /> instead of <guided-suggestion-original-query /> </guided-if-suggestion-autosearch>
10
<guided-if[-not]-suggestion-low-results> <guided-else[-not]-suggestion-low-results> </guided-if[-not]-suggestion-low-results>
Diese Bedingung ist wahr, wenn Vorschläge aufgrund einer niedrigen Ergebniszahl vorliegen, falls diese Funktion aktiviert ist.
Das folgende Beispiel zeigt die Verwendung dieses Tags:
<guided-if-suggestion-low-results>    You have a low result count for <guided-query-param gsname="q" />.    Did you mean: <guided-suggestions>        <guided-suggestion-link>           <guided-suggestion />        </guided-suggestion-link><guided-if-not-last>, </guided-if-not-last>    </guided-suggestions> </guided-if-suggestion-low-results>

Autom.

Die folgenden Tags können verwendet werden, um dem Suchformular automatisch gefüllt zu werden. Die Tags für den Kopfteil- und Formularinhalt sind erforderlich, damit die Funktion für die automatische Vervollständigung korrekt ausgeführt werden kann. Es wird empfohlen, die Tags anstelle der Hartkodierung der autocomplete JavaScript und CSS in Ihrer Präsentationsvorlage zu verwenden. Der Grund dafür ist, dass Tags es Ihren Vorlagen ermöglichen, alle neuen Cache-IDs für die Niederlage aufzunehmen, sobald Sie die Einstellungen für die automatische Vervollständigung ändern, ohne dass die Vorlage manuell aktualisiert werden muss.
Tag
Beschreibung
1
<guided-if-autocomplete> <guided-else-autocomplete> </guided-if-autocomplete>
Erkennt, ob die Funktion zum automatischen Ausfüllen aktiviert ist. Sie können die Tags verwenden, um optional den Kopf- und Formularinhalt aufzunehmen, der für das automatische Ausfüllen erforderlich ist. Auf diese Weise können Sie die Funktion aktivieren und deaktivieren und müssen Ihre Präsentationsvorlagen nicht ändern.
2
<guided-ac-css/>
Wird im Kopf der Präsentationsvorlage verwendet und durch das entsprechende CSS-Skript ersetzt, das automatisch ausgefüllt wird.
3
<guided-ac-form-content/>
Wird im Suchformular (zwischen den Tags <form> und </form> ) der Präsentationsvorlage verwendet, anstatt die Tags zum automatischen Ausfüllen im Formular fest zu kodieren. Die Tags werden durch den entsprechenden HTML-Code ersetzt, der erforderlich ist, damit die automatische Vervollständigung funktioniert.
4
<guided-ac-javascript/>
Generiert die Links zum automatischen Vervollständigen-JavaScript. Für eine optimale Leistung wird empfohlen, dieses Tag am unteren Rand der Seite vor dem schließenden "body"-Tag zu platzieren.

Store

Verwenden Sie die folgenden Tags, um den Store, in dem sich ein Benutzer befindet, zu testen und anzuzeigen.
Tag
Beschreibung
1
<guided-store/>
Gibt den aktuellen Store aus.
2
<guided-if-store-defined> <guided-else-store-defined> </guided-if-store-defined>
Erkennt, ob sich der Benutzer in einem Store befindet.
3
<guided-if-store gsname="store"> <guided-else-store> </guided-if-store>
Erkennt, ob sich der Benutzer im Store befindet, den der Parameter gsname angibt.

Zonen

Tag
Beschreibung
1
<guided-zone gsname="zone area" [search="associated search"] [facet="associated facet"] [width="xx" height="yy"]>
Sie können alle Inhalte in die Zonen-Tags einschließen, um eine Zone aus diesem Bereich zu erstellen. Auf diese Weise können Sie Geschäftsregeln verwenden, um die Zone nach Bedarf anzuzeigen. Standardmäßig werden Zonen immer angezeigt. Sie können die optionalen Such- und Facettenparameter verwenden, um anzugeben, welche Suche oder Facette mit der Zone verbunden ist. Mit dieser Funktion kann die Software Suchvorgänge oder Facetten überspringen, wenn eine Zone ausgeblendet wird, was die Suchleistung verbessert. Die Attribute für Höhe und Breite sind optional und werden verwendet, um zu konfigurieren, wie der Platzhalter im Visual Rule Builder angezeigt wird, wenn eine Zone entfernt wird.
Verwenden Sie nach Möglichkeit das Tag mit dem Namen "guided-if-facet[-not]-visible"anstelle der Zone . Die Präsentationsvorlage wird vereinfacht.
2
<guided-if-zone gsname="zone area"> <guided-else-zone> </guided-if-zone>
Mit diesem Tag-Satz können Sie testen, ob derzeit eine Zone angezeigt wird. Es ist nützlich, wenn Sie Inhalte an einer anderen Stelle auf der Seite haben, die nur angezeigt werden sollen, wenn die Zone angezeigt wird.

Loopindikatoren

Sie können die folgenden Loopindikatoren in einem dieser Loopblöcke verwenden:
  • guided-results
  • guided-facet-values
  • geführten Breadcrumb
  • guided-menu-items
  • guided-pages
Tag
Beschreibung
1
<guided-if[-not]-first><guided-else[-not]-first> </guided-if[-not]-first>
Diese Bedingung ist wahr, wenn die aktuelle Iteration die erste Iteration der Schleife ist. Das bedeutet nicht unbedingt das erste Ergebnis oder die erste Seite, sondern das erste. Befindet sich der Site-Besucher auf Seite 2 eines Ergebnissatzes, der 10 pro Seite beträgt, ist die erste Iteration das Ergebnis 11.
2
<guided-if[-not]-last><guided-else[-not]-last> </guided-if[-not]-last>
Diese Bedingung ist wahr, wenn die aktuelle Iteration die letzte Iteration der Schleife ist. Das bedeutet nicht unbedingt das letzte Ergebnis oder die letzte Seite, sondern das letzte Ergebnis im aktuellen Kontext (Seite). Befindet sich der Site-Besucher auf Seite 1 eines Ergebnissatzes, der 200 Ergebnisse enthält, aber nur 10 Ergebnisse pro Seite hat, lautet die letzte Iteration das Ergebnis 10 anstelle des Ergebnisses 200.
3
<guided-if[-not]-odd><guided-else[-not]-odd> </guided-if[-not]-odd>
Diese Bedingung ist wahr, wenn die aktuelle Iteration eine ungerade Iteration der Schleife ist (im Gegensatz zu einer geraden Iteration). Dies ist hilfreich, um unterschiedliche Zeilenfarben anzuzeigen.
4
<guided-if[-not]-even><guided-else[-not]-even> </guided-if[-not]-even>
Diese Bedingung ist wahr, wenn die aktuelle Iteration eine gerade Iteration der Schleife ist (im Gegensatz zu einer ungeraden Iteration). Dies ist hilfreich, um unterschiedliche Zeilenfarben anzuzeigen.
5
<guided-if[-not]-alt><guided-else[-not]-alt> </guided-if[-not]-alt>
Diese Bedingung ist wahr, wenn die aktuelle Iteration eine gerade Iteration der Schleife ist. Dies ist hilfreich, um unterschiedliche Zeilenfarben anzuzeigen.
6
<guided-if[-not]-inner><guided-else[-not]-inner> </guided-if[-not]-inner>
Umfasst den Text zwischen ihnen, wenn die aktuelle Iteration weder die erste noch die letzte ist.
7
<guided-if[-not]-outer><guided-else[-not]-outer> </guided-if[-not]-outer>
Bezieht den Text zwischen ihnen ein, wenn die aktuelle Iteration die erste oder letzte ist.
8
<guided-loop-index>
Eine Ganzzahl (beginnend mit 0), deren Wert für jede Iteration der Schleife inkrementiert wird.
9
<guided-loop-counter>
Eine Ganzzahl (beginnend mit 1), deren Wert für jede Iteration der Schleife inkrementiert wird.

Verschiedene Sprachen

Die folgenden Tags stehen zur Verfügung, damit Sie mit Ihrer Vorlage komplexere Dinge durchführen können, z. B. Ihre eigene Mini-Facette.
Tag
Beschreibung
1
<guided-current-path [escape="html|url|js|json|0"] />
Gibt Ihnen den aktuellen Pfad an, der verwendet wird. Normalerweise wird er verwendet, um einen Link zu erstellen, der einen neuen Parameter zur vorhandenen Suche hinzufügt. Standardmäßig ist der Pfad mit URL-Escape-Zeichen versehen. Mit dem Parameter escape können Sie angeben, welcher Escape-Modus verwendet werden soll.
Beispiel:
<a href="<guided-current-path />&lang=fr"> French Version
In diesem Beispiel verwendet eine Suchverarbeitungsregel lang, um die französische Version auszuwählen.
Der aktuelle Pfad hat immer mindestens einen Abfrageparameter. Wenn keine anderen Abfrageparameter vorhanden sind, wird sie auf q=* gesetzt, was das Hinzufügen weiterer Parameter erleichtert .
2
Basispfad
Wenn Sie einen Link mit dem Basepath erstellen möchten, verwenden Sie / am Anfang Ihres href und fügen Sie Parameter hinzu.
<a href="/">All Products</a> Would create a link "All Products" to your basepath, for example https://search.mycompany.com/
3
<guided-query-param gsname="query_parameter" [escape="html|url"] />
Ermöglicht das Erfassen des vorhandenen Werts eines Abfrageparameters, der sich in der URL befindet. Wenn Ihr Parameter nicht vorhanden ist, gibt dieses Tag eine leere Zeichenfolge zurück. Wenn Sie keine Escape-Option angeben, wird die zurückgegebene Zeichenfolge automatisch mit einem HTML-Escapezeichen versehen, können Sie HTML- oder URL-Escapezeichen angeben.
Beispiel:
&amp;lt;guided-query-param&amp;nbsp;gsname=&quot;q&quot;&amp;nbsp;/&amp;gt;
    gibts&amp;nbsp;you&amp;nbsp;the&amp;nbsp;value&amp;nbsp;pants
    
    &amp;lt;guided-query-param&amp;nbsp;gsname=&quot;&quot;&amp;nbsp;/&amp;gt;
    gibt&amp;nbsp;you&amp;nbsp;the&amp;nbsp;value&amp;nbsp;en
    
    &amp;lt;guided-query&amp;nbsp;nbsp;g;
    you&amp;nbsp;an&amp;nbsp;empty&amp;nbsp;string
    &amp;nbsp;
    &amp;nbsp;&amp;nbsp;&amp;nbsp;nbsp;nbsp;nbsp;nbsp;&amp;nbsp; &lt;/code> &lt;/p> &lt;/td>

4
<guided-query-param-name gsname="param#" offset="offset_number"/>
Die geführte Suche hat den Begriff einer Abfragenummer, die im Breadcrumb-Steuerelement verwendet wird. Mit guided-query-param-name können Sie Parameter als Teil eines Links in der Präsentationsvorlage definieren, bei dem die geführte Suche die richtige Abfragenummer für Sie ermittelt. Der gsname enthält ein "x", das durch die geführte Suche durch die richtige Nummer ersetzt wird. Der Offset-Wert kann zwischen 0 und 15 liegen, wobei 0 bedeutet, dass die nächste verfügbare Abfragenummer verwendet wird. Eine 1 gibt an, dass Sie 1 hinzufügen möchten usw.
In Kombination mit geführten-aktuellen Pfaden können Sie einen eigenen Mini-Facet-Link erstellen oder eine zusätzliche Drilldown-Ebene zulassen.
Beispiel:
<a href="<guided-current-path         />&<guided-query-param-name gsname="q#" offset="0"         />=mens&<guided-query-param-name gsname="x#" offset="0"         />=category" >Category:Men</a>        
<a href="<guided-current-path         />&<guided-query-param-name gsname="sp_q_exact_#" offset="0"         />=mens&<guided-query-param-name gsname="sp_x_#" offset="0"         />=category&<guided-query-param-name gsname="sp_q_exact_#" offset="1"         />=Jeans&<guided-query-param-name gsname="sp_x_#" offset="1"         />=product-type" >Cat:Men - Product:Jeans</a>
5
<guided-include gsfile="filename" />
Hiermit können Sie andere Vorlagendateien einschließen. Diese Funktion bedeutet, dass Sie mehrere Vorlagen mit Untervorlagen als Module erstellen können.
Im folgenden Beispiel werden die Dateien "Breadcrumbs" und " facets" eingeschlossen:
<guided-include gsfile='breadcrumbs.tmpl' /> <guided-include gsfile='facets.tmpl' />
Dynamische Includes werden nicht unterstützt. Mit anderen Worten, gsfile kann keine Variable sein.
6
<guided-search-time>
Gibt an, wie lange die Suche dauerte. Der zurückgegebene Suchzeitwert wird in ms angegeben.
7
<guided-fall-through-searches>
Gibt die Anzahl der Kernelsuchvorgänge zurück, mit denen die Seite der Suchergebnisse erstellt wird.
8
<guided-if-fall-through-search></guided-if-fall-through-search>
Prüft, ob die Anzahl der Hauptsuchvorgänge größer als eine ist.
9
<guided-if[-not]-even><guided-else[-not]-even> </guided-if[-not]-even>
Diese Bedingung ist wahr, wenn die aktuelle Iteration eine gerade Iteration der Schleife ist (im Gegensatz zu einer ungeraden Iteration). Dies ist hilfreich, um unterschiedliche Zeilenfarben anzuzeigen.
10
<guided-if[-not]-alt><guided-else[-not]-alt> </guided-if[-not]-alt>
Diese Bedingung ist wahr, wenn die aktuelle Iteration eine gerade Iteration der Schleife ist. Dies ist hilfreich, um unterschiedliche Zeilenfarben anzuzeigen.
11
<guided-if[-not]-inner><guided-else[-not]-inner> </guided-if[-not]-inner>
Umfasst den Text zwischen ihnen, wenn die aktuelle Iteration weder die erste noch die letzte ist.
12
<guided-if[-not]-outer><guided-else[-not]-outer> </guided-if[-not]-outer>
Bezieht den Text zwischen ihnen ein, wenn die aktuelle Iteration die erste oder letzte ist.
13
<guided-if-first-search><guided-else-first-search> </guided-if-first-search>
Ermöglicht die Überprüfung, ob Sie sich bei der ersten Suche befinden (die Abfrage war das Ergebnis einer Suche aus dem Suchfeld).
14
<guided-search-url/>
Sie können dieses Tag in Ihrer Vorlage verwenden, um die Aktion des Suchformulars vor der Hartkodierung zu speichern. Es erkennt, wann Sie sich in der Staged- oder Live-Umgebung befinden und ändert sich entsprechend.
15
<guided-if-query-param-defined gsname="query_parameter"> <guided-else-query-param-defined> </guided-if-query-param-defined>
Mit diesem Tag-Satz können Sie testen, welche CGI-Parameter im Suchpfad definiert sind. Sie können die Werte der Parameter nur dann testen, wenn sie definiert sind.
16
<guided-next-query-number [gsname="offset"] />
Die geführte Suchmaschine, die die Vorlage antreibt, hat die Vorstellung von schwebenden Abfragenummern, bei denen jeder neue Link, den die Engine generiert, die nächste verfügbare Abfragenummer verwendet. Mit diesem Tag können Sie die nächste Abfragenummer oder die nächsten Offsets erfassen, damit Sie benutzerspezifische Links erstellen können, die in die Ergebnismenge vordringen. Mit dem Offset können Sie die nächste Abfragenummer eingeben. Wenn Sie beispielsweise eine Facette ausgewählt haben, lautet die nächste Abfragenummer 2, bei einem Offset von 1 ist die zurückgegebene Abfragenummer 3.
17
<guided-custom-var gsname="custom_variable" [escape="html|url|js|json|0"]/>
Hiermit können Sie den vorhandenen Wert einer benutzerspezifischen Variablen erfassen, die Ihre Verarbeitungsregeln definieren. Wenn Sie keine Escape-Option angeben, wird die zurückgegebene Zeichenfolge automatisch HTML-Escapezeichen zurückgegeben, können Sie entweder html, url , js oder 0 angeben . Wenn Sie eine Verarbeitungsregel verwenden, um einen eingehenden CGI-Parameter in eine benutzerdefinierte Variable zu kopieren und diese Variable dann in Ihrer Vorlage mit Escapeeinstellung "none"oder "js"anzuzeigen oder zu verwenden, können Sie eine XSS-Verwundbarkeit in Ihrer Suche erstellen.
18
<guided-if-custom-var-defined gsname="custom_variable"> <guided-else-custom-var-defined> </guided-if-custom-var-defined>
Aktiviert das Testen, wenn eine benutzerdefinierte Variable in den Verarbeitungsregeln definiert ist (Abfragebereinigung, Verarbeitung vor der Suche und Verarbeitung nach der Suche).
19
<guided-general-field gsname="searchname" field="fieldname" [escape="html|url|js|json|0"]/>
Hiermit können Sie den Inhalt eines allgemeinen Felds anzeigen, das in der Transportvorlage definiert ist. Wenn Sie keine Escape-Option angeben, wird die zurückgegebene Zeichenfolge in dem Format kodiert, das Sie in der Transportvorlage für dieses Feld angegeben haben. Die Angabe einer Escape-Option wird auf jedes Format angewendet, das Sie wie in Ihrer Transportvorlage kodieren. Sie können entweder html, url , js , json oder 0 angeben .
20
<guided-if-general-field gsname="searchname" field="fieldname"> <guided-else-general-field> </guided-if-general-field>
Aktiviert das Testen, wenn der Inhalt eines allgemeinen Felds, wie in der Transportvorlage definiert, vorhanden ist.
21
<guided-cookie-value gsname="cookie_name" [escape="html|url|js|json|0"]/>
Ermöglicht das Erfassen des Werts eines Cookies, vorausgesetzt, das Cookie ist verfügbar. Wenn Sie keine Escape-Option angeben, wird die zurückgegebene Zeichenfolge automatisch HTML-Escapezeichen zurückgegeben, können Sie entweder html, url , js , json oder 0 angeben .
22
<guided-if-cookie gsname="cookie_name"> <guided-else-cookie> </guided-if-cookie>
Aktiviert das Testen, wenn ein Cookie vorhanden ist.
23
<guided-banner gsname="banner area" [escape="html|url|js|json|0"] [width="xx" height="yy"]/>
Gibt das Banner für einen bestimmten Bereich aus. Die optionalen Attribute für Breite und Höhe werden im Visual Rule Builder verwendet, um die Anzeige eines aussagekräftigen Platzhalters zu ermöglichen, damit Benutzer ein Banner auswählen können. Standardmäßig sind Banner nicht mit Escape-Zeichen versehen. Stattdessen sollten Sie HTML in die Präsentationsvorlage einfügen. Wenn Sie jedoch eine JSON-Vorlage erstellen, sollten Sie die Option "js escaping"verwenden.
Beispiel:
<guided-banner gsname="top" width="400px"  height="50px"/>
24
<guided-if-banner-set gsname="banner area"> <guided-else-banner-set> </guided-if-banner-set>
Aktiviert Tests, wenn ein Bannerbereich festgelegt ist.
25
<guided-if-simulator-mode> <guided-else-simulator-mode> </guided-if-simulator-mode>
Ermöglicht Ihnen die Erkennung, wann Sie Ihre Suche im Simulator oder im Visual Rule Builder anzeigen. Normalerweise wird er verwendet, um zusätzliche Debugging-Informationen für Sie anzuzeigen.
26
<guided-if-tnt-business-rules> <guided-else-tnt-business-rules> </guided-if-tnt-business-rules>
Ermöglicht Ihnen die Erkennung von Geschäftsregeln, die auf eine Adobe Target- Kampagne verweisen. Es wird normalerweise im Rahmen der Integration mit Adobe Target verwendet, um zu verhindern, dass die Target- Server erreicht werden, wenn dies nicht erforderlich ist.
27
<guided-redirect/>
Standardmäßig werden Umleitungen automatisch ausgeführt. Wenn Sie jedoch die Site-Suche/das Merchandising so konfiguriert haben, dass eine XML- oder JSON-Antwort an Ihre Webanwendung zurückgegeben wird, können Sie entweder die 302/301-Antwort in Ihrer Webanwendung analysieren oder die Weiterleitung als Teil der Ergebnismenge an Sie weiterleiten lassen. Wenn Sie die Umleitung als Teil des Ergebnissatzes weiterleiten, kann dieses Tag in der Vorlage verwendet werden, um die Umleitungsposition auszugeben.
28
<guided-if-redirect> <guided-else-redirect> </guided-if-redirect>
Wenn Sie die Site-Suche/das Merchandising konfiguriert haben, um Umleitungen in der Ergebnismenge zurückzugeben, können Sie mit diesem Tag-Satz feststellen, ob eine Umleitung zur Ausgabe erfolgt.
29
<guided-lt/> <guided-gt/>
Mit diesem Tag-Satz können Sie geführte Vorlagen-Tags in HTML-Attribute einbetten.
Beispiel:
<guided-lt/>div <guided-if-facet-long>         style="height: 125px; overflow:         auto;"</guided-if-facet-long><guided-gt/>

Transportvorlagen-Tags

Transportvorlagen sind XML-Vorlagen, die Daten aus der Backend-Suche an die Präsentationsebene der geführten Suche weiterleiten.
In Ihrer Präsentationsebene können Sie über eine einzelne Präsentationsvorlage verfügen, die die Ergebnisse mehrerer Suchen darstellt. Bei jeder Suche kann dieselbe Transportvorlage oder eine benutzerdefinierte Transportvorlage verwendet werden, um die Daten an die Präsentationsebene zu übergeben.
Da die Transportvorlage nur zum Übermitteln von Daten an die Präsentationsebene verwendet wird, enthält sie keinerlei HTML, das die Anzeige der Suchergebnisse betrifft. Die Transportvorlage verwendet XML-Tags der Transportvorlage, um die Suchergebnisse zum Füllen der Komponenten der geführten Suche, wie Facetten, Breadcrumbs und Menüs, weiterzugeben. Innerhalb dieser Tags werden standardmäßige Tags für Suchvorlagen verwendet, um die tatsächlichen Werte anzuzeigen.
Transportvorlagen-Tag
Beschreibung
<guided-xml></guided-xml>
Die XML-Stamm-Tags, die die Präsentationsebene verwendet, um zu erkennen, was aus der Transportvorlage analysiert wird.
<general></general>
Tags umschließen Suchvorlagen-Tags, die Zusammenfassungsdaten basierend auf der Ergebnismenge bereitstellen. Normalerweise enthalten diese Tags Suchtags für die Gesamtanzahl der Ergebnisse, das niedrigere Ergebnis und das höchste Ergebnis. Sie können eine beliebige Anzahl zusätzlicher globaler Felder mit dem allgemeinen field- Tag definieren, wie im folgenden Beispiel:
<general>   <total><search-total /></total>   <lower><search-lower /></lower>   <upper><search-upper /></upper>   <general-field name="my_custom_field">Some global content</general-field> </general>
<results></results>
Tags werden um die Suchergebnisse herum umschlossen, sodass die geführte Suche weiß, wo sie gesucht werden soll.
<result></result>
Tags werden um jedes Suchergebnis herum umschlossen, sodass die geführte Suche erkennt, wo der Inhalt für ein einzelnes Suchergebnis beginnt und endet, wie im folgenden Beispiel dargestellt:
<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">
Ermöglicht die Schleife jedes Elements in einer Liste mit mehreren Werten für ein einzelnes Ergebnis. Verwenden Sie dieses Tag nur in einem Ergebnis. Der Zweck besteht darin, dass Sie über Attribute, die zu einem Ergebnisfeld gehören, iterieren können, wie im folgenden Beispiel:
<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>
Gibt die Ergebnisse weiter, die die Facetten ausfüllen.
<dynamic-facet></dynamic-facet>
Sie können eine Facette sowohl als dynamische Facette als auch als Mitglied einer Facettenleiste festlegen. Ihre Behandlung ist jedoch unabhängig von den entsprechenden Präsentationsvorlagen-Tags.
Mit anderen Worten, das Verschachteln eines Facettenschienenschleiferkontexts in einem dynamischen Facettenschleiferkontext oder umgekehrt ist nicht zulässig.
Bei Facetten, die sowohl dynamisch als auch per Schiene sind, sind nur die dynamischen Facetten sichtbar, die für eine bestimmte Suche zurückgegeben wurden.
<facet name="name"></facet>
Jede Facette verfügt über eigene Facetten-Tags, bei denen der Parameter name mit dem Facettennamen übereinstimmt. Suchtags werden für die Facettenwerte innerhalb der Facetten-Tags verwendet, wie im folgenden Beispiel:
<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>
Konten mit formatierten Facetten können das dynamische Tag und das Tag der Anzeigenamen verwenden. Beide Tags erleichtern die Zuordnung zwischen formatierten Facetten und echten Facetten bei der Erstellung von Geschäftsregeln.
<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=",">
Mit dem Attribut "separator" können Sie das Trennzeichen ändern, das verwendet wird, wenn Sie Daten aus Suchfeld-Feldern für Listen ausgeben. Die Standardeinstellung ist ein Komma.
Im Allgemeinen sollte das verwendete Trennzeichen etwas sein, das im Feldinhalt nicht leicht angezeigt wird.
<recommendations></recommendations>
Schließen Sie Ihre "Meinten Sie"-Vorschläge mit Tags ein, damit die geführte Suche erkennt, welche XML-Knoten Vorschläge enthalten.
<recommendations></recommendations>
Fügen Sie jeden der "Meinten Sie"-Vorschläge mit Tags ein, wie im folgenden Beispiel:
<search-if-suggestions>   <suggestions>     <search-suggestions>       <suggestion><search-suggestion-text /></suggestion>     </search-suggestions>   </suggestions> </search-if-suggestions>

Suchvorlagen-Tags

Eine Suchvorlage ist eine HTML-Datei mit Vorlagen-Tags, die von Site-Suche/Merchandising definiert werden. Diese Tags geben an, wie die Suchergebnisse formatiert sind. Die folgende Referenz enthält eine kurze Beschreibung der einzelnen Suchvorlagen-Tags und ihrer Attribute.
Verwenden Sie nur Suchvorlagen-Tags in Transportvorlagendateien (.tpl).
Sie können aus den folgenden Suchvorlagen-Tag-Gruppen und Referenzmaterial auswählen.
Tags, die nur in der Ergebnisschleife gültig sind, umfassen Folgendes:
Zu den Tags, die für die gesamte Vorlage gültig sind, gehören:
Referenzthemen zur Suchvorlage

Ergebnisse-Schleife-Tags

Das Tag der Ergebnisschleife ist das Arbeitspferd des Vorlagensystems. Wenn das Tag während einer Suche auftritt, wird der HTML-Code wiederholt und andere Tags zwischen dem Start- und dem Ende der Ergebnisschleife-Tags. Dadurch werden alle anderen Tags durch Ihre Suchergebnisse ersetzt.
<search-results> ... </search-results>
Die Tags der Ergebnisschleife umschließen den HTML-Code, der die Suchergebnisse anzeigt. Der HTML-Code zwischen den Tags wird für jedes Ergebnis wiederholt und auf der Seite angezeigt.
Die folgenden Tags sind nur innerhalb der Ergebnisschleife gültig:

Tags der Ergebnisschleife

Die folgenden Tags geben eine Zeichenfolge zurück.
Siehe Informationen zu den Tags der Ergebnisschleife.
Tag
Beschreibung
1
<search-index>
Gibt den numerischen Index des aktuellen Ergebnisses zurück.
2
<search-title length="XX">
Gibt den Seitentitel des aktuellen Ergebnisses zurück. Das optionale Attribut length wird verwendet, um die Länge der angezeigten Zeichenfolgen zu begrenzen, wobei der Standardwert 80 Zeichen ist.
3
<search-bodytext length="XX" encoding="html/javascript/json/perl/url/none" >
Gibt den Texttext ab dem Anfang der Seite zurück. Relevante Begriffe werden fett dargestellt. Das optionale Attribut length wird verwendet, um die Länge der angezeigten Zeichenfolgen zu begrenzen, wobei der Standardwert 80 Zeichen ist. Das Attribut "encoding"ist optional und kann Ausgabezeichen mit HTML-Kodierung (Standard), JavaScript-Kodierung, Perl-Kodierung oder ohne Kodierung kodieren.
4
<search-description length="XX" encoding="html/javascript/json/perl/url/none">
Gibt die Beschreibung des aktuellen Ergebnisses zurück. Wenn das Meta-Beschreibungstag vorhanden ist und das Inhaltsattribut nicht leer ist, wird dieser Text angezeigt. Andernfalls wird der Anfang des Textes der Seite angezeigt. Das optionale Attribut length wird verwendet, um die Länge der angezeigten Zeichenfolgen zu begrenzen, wobei der Standardwert 80 Zeichen ist.
Das optionale Kodierungs- Attribut steuert, ob die Ausgabe HTML-kodiert, JavaScript-kodiert, Perl-kodiert, URL-kodiert oder nicht kodiert ist, für die Ausgabe auf der Ergebnisseite. Der Standardwert für die Kodierung ist html . Normalerweise müssen Sie das Kodierungsattribut nicht angeben.
5
<search-score rank="dynamic/static/dynamic-raw/static-raw/final-raw" Precision="XX">
Gibt das Ergebnis des aktuellen Ergebnisses zurück, das eine Zahl zwischen 0 und 100 ist. Wenn Sie unter Optionen > Metadaten > Definitionen ein Rangfeld definiert haben, können Sie den dynamischen Seitenrang anzeigen, indem Sie das Rangattribut auf dynamisch einstellen ( <search-score rank="dynamic"> ). Sie können den statischen Seitenrang anzeigen, indem Sie das rank-Attribut auf statisch einstellen ( <search-score rank="static"> ). Mit dem optionalen Präzisionsattribut können Sie die Anzahl der anzuzeigenden Dezimalstellen angeben. Der Standardwert ist 0, was das Ganzzahlergebnis anzeigt).
6
<search-date length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id">
Gibt das Datum des aktuellen Ergebnisses zurück. Der optionale Textwert "none"wird angezeigt, wenn kein Datum mit dem aktuellen Ergebnis verknüpft ist. Wenn der optionale Wert "none"nicht angegeben wird, wird der Text "No Date"angezeigt, wenn kein Datum mit dem aktuellen Ergebnis verknüpft ist.
Das Attribut "date-format"nimmt eine Datumsformat-Zeichenfolge im UNIX-Stil wie "%A", %B %d, %Y"(für "Montag, 25. Juli 2016"). "gmt"ist standardmäßig "yes"und steuert, ob der Zeitabschnitt der Datums-Zeichenfolge in GMT ("yes") oder in der Zeitzone des Kontos ("no") ausgegeben werden soll.
Das Attribut "language"steuert die Konventionen für Sprache und Gebietsschema der Ausgabedatumszeichenfolge. "0" (Standard) bedeutet "Kontosprache verwenden". "2" bedeutet "Dokumentsprache verwenden". Der Wert "language"1 ist für die zukünftige Verwendung reserviert. Jeder andere "language"-Wert wird als spezifischer Sprachbezeichner interpretiert, z. B. bedeutet "en_US" "Englisch (USA)".
Das optionale Attribut length wird verwendet, um die Länge der angezeigten Zeichenfolgen zu begrenzen, wobei der Standardwert 80 Zeichen ist.
7
<search-size>
Gibt die Größe des aktuellen Ergebnisses in Byte zurück.
8
<search-url length="XX" encoding="html/javascript/json/perl/url/none" >
Gibt die URL des aktuellen Ergebnisses zurück.
Verwenden Sie das optionale length- Attribut, um die Länge der angezeigten Zeichenfolgen zu begrenzen, wobei standardmäßig unbegrenzte Zeichen verwendet werden.
Das Attribut "encoding" ist optional und kann Ausgabezeichen mit HTML-Kodierung, JavaScript-Kodierung, Perl-Kodierung oder ohne Kodierung kodieren.
9
<search-url-path-query length="XX">
Gibt den Pfad und die Abfrageabschnitte einschließlich des Fragezeichens der URL des aktuellen Ergebnisses zurück.
Verwenden Sie das optionale length- Attribut, um die Länge der angezeigten Zeichenfolgen zu begrenzen, wobei standardmäßig unbegrenzte Zeichen verwendet werden.
10
<search-context length="XX" encoding="html/javascript/json/perl/url/none" >
Gibt die nächste Kontextzeile für den Suchbegriff zurück. Relevante Begriffe werden fett dargestellt. Rufen Sie dieses Tag wiederholt auf, um mehr als eine Kontextzeile für das aktuelle Ergebnis anzuzeigen.
Verwenden Sie das optionale length- Attribut, um die Länge der angezeigten Zeichenfolgen zu begrenzen, standardmäßig 80 Zeichen. Das Attribut length wird ignoriert, wenn dieses Tag von <search-if-context> - oder <search-if-any-context>- Tag-Sets eingeschlossen wird, die ein length-Attribut enthalten.
Das Attribut "encoding" ist optional und kann Ausgabezeichen mit HTML-Kodierung (Standard), JavaScript-Kodierung, Perl-Kodierung oder ohne Kodierung kodieren.
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" unit="miles/kilometers" separator"|">
Dieses erweiterte Tag zeigt den Inhalt des Metadatenfelds (URL, Titel, Desc, Schlüssel, Ziel, Text, alt, Datum, Zeichensatz und Sprache oder Felder, die unter Optionen > Metadaten > Definitionen definiert sind), das im Namensattribut angegeben ist, für das aktuelle Ergebnis an. Beispiel:
<search-display-field name="title" length="70" none="no title">
Gibt den Titel der Seite für ein Suchergebnis aus. Wenn das optionale Attribut " none"angegeben ist, wird der zugehörige Wert nur dann auf der Ergebnisseite angezeigt, wenn dem Feld kein Inhalt zugeordnet ist.
Die Attribute für Datumsformat , Gmt und Sprache sind nur relevant, wenn der Inhaltstyp des angegebenen Felds das Datum ist .
Das Datumsformat- Attribut nimmt eine Datumsformat-Zeichenfolge im UNIX-Stil wie %A, %B %d, %Y (für Montag, den 25. Juli 2016) an. gmt ist standardmäßig auf yes und steuert, ob der Zeitabschnitt der Datums-Zeichenfolge in GMT ( yes ) oder in der Zeitzone des Kontos ( no ) ausgegeben wird.
Das language- Attribut steuert die Konventionen für Sprache und Gebietsschema der Ausgabedatumszeichenfolge. 0 (Standard) bedeutet "Kontosprache verwenden". 2 bedeutet "Dokumentsprache verwenden". Der Sprachwert 1 ist für die zukünftige Verwendung reserviert. Jeder andere Sprachwert wird als spezifischer Sprachbezeichner interpretiert, z. B. en_US bedeutet "Englisch (USA)".
Das optionale length- Attribut wird verwendet, um die Länge der angezeigten Zeichenfolgen zu begrenzen, wobei der Standardwert 80 Zeichen ist.
Das optionale Kodierungs- Attribut steuert, ob die Ausgabe HTML-kodiert, JavaScript-kodiert, Perl-kodiert, URL-kodiert oder nicht kodiert ist, für die Ausgabe auf der Ergebnisseite. Der Standardwert für die Kodierung ist html . Normalerweise müssen Sie das Kodierungsattribut nicht angeben.
Das optionale Anführungszeichen- Attribut steuert, ob die einzelnen Elemente von doppelten Anführungszeichen (oder einfachen Anführungszeichen, wenn encoding=perl ) umgeben sind. Der Standardwert von Anführungszeichen ist "Nein" .
Das optionale Komma- Attribut steuert, ob die einzelnen Elemente durch Kommas getrennt werden. Der Standardwert für Kommas ist yes . Das Attribut "Kommas"wird für Felder ohne Listentyp ignoriert.
Das optionale Einheitenattribut steuert die Entfernungseinheiten, die auf ein Ausgabefeld für die Suche in der Nähe angewendet werden. Der Standardwert von Einheiten wird aus der Einstellung "Standardeinheiten"des Ortstypfelds bestimmt, das mit dem angegebenen Ausgabefeld für die Suche nach räumlicher Nähe verknüpft ist.
Siehe Info zur Suche in der Nähe.
Das optionale Trennzeichen- Attribut definiert das einzelne Zeichen oder Trennzeichen, das zwischen den Werten der Ausgabe für Listenfelder eingefügt wird.
12
<search-display-field-values name="field-name"> ...<search-display-field-values>
Dieses Tag erstellt eine Schleife zum Aufzählen von Metadatenfeldwerten (URL, Titel, Desc, Schlüssel, Ziel, Text, alt, Datum, Zeichensatz und Sprache oder Felder, die unter Optionen > Metadaten > Definitionen ) für das aktuelle Ergebnis definiert werden. Verschachteln Sie dieses Tag nicht in einem anderen <search-display-field-values> -Tag. Das Attribut name gibt den Namen des Felds an, das die aufzuzählenden Werte enthält. Dieses Tag ist am nützlichsten bei Feldern, bei denen das Attribut Listen zulassen aktiviert ist (unter Optionen > Metadaten > Definitionen ).
13
<search-display-field-value date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none">
Dieses Tag gibt den Metadatenfeldwert (URL, Titel, Desc, Schlüssel, Ziel, Haupttext, alt, Datum, Zeichensatz und Sprache oder Felder, die unter Optionen > Metadaten > Definitionen definiert sind ) für die aktuelle <search-display-field-values>- Schleifenitation aus. Dieses Tag ist nur innerhalb einer <search-display-field-values>- Schleife gültig. Die Attribute für Datumsformat, Gmt und Sprache sind nur relevant, wenn der Inhaltstyp des im einschließenden <search-display-field-values>- -Tag angegebenen Feldnamens das Datum ist . Das Datumsformat- Attribut nimmt eine Datumsformat-Zeichenfolge im UNIX-Stil wie "%A , %B %d , %Y "(für "Montag, 25. Juli 2016") an. Das gmt- Attribut ist standardmäßig yes und steuert, ob der Zeitabschnitt der Datums-Zeichenfolge in GMT ( yes ) oder in der Zeitzone des Kontos ( no ) ausgegeben wird.
Das language- Attribut steuert die Konventionen für Sprache und Gebietsschema der Ausgabedatumszeichenfolge. 0 (Standard) bedeutet "Kontosprache verwenden". Jeder andere Sprachwert wird als spezifischer Sprachbezeichner interpretiert, z. B. en_US bedeutet "Englisch (USA)".
Das optionale Kodierungs- Attribut steuert, ob die Ausgabe HTML-kodiert, JavaScript-kodiert, Perl-kodiert, URL-kodiert oder nicht kodiert ist, für die Ausgabe auf der Ergebnisseite. Der Standardwert für die Kodierung ist html . Normalerweise müssen Sie das Kodierungsattribut nicht angeben.
14
<search-display-field-value-count name="field-name">
Gibt die Gesamtanzahl der Werte im aktuellen Ergebnis für das mit dem Attribut name angegebene Metadatenfeld aus (URL, Titel, Desc, Schlüssel, Ziel, Text, alt, Datum, Zeichensatz und Sprache oder Felder, die unter Optionen > Metadaten > Definitionen definiert sind ). Dieses Tag kann an einer beliebigen Stelle in der Ergebnisschleife erscheinen.
15
<search-display-field-value-counter>
Gibt den Ordinalzähler (1, 2, 3 usw.) für die aktuelle <search-display-field-values>- Schleifenitation aus. Dieses Tag ist nur innerhalb einer <search-display-field-values>- Schleife gültig.
16
<search-dynamic-facet-fields>
Beginnt einen Schleifenkontext für alle dynamischen Facettenfelder, die für diese Suche zurückgegeben werden.
17
<search-dynamic-facet-field-name>
Gibt den Namen des aktuellen dynamischen Facet-Felds für diese Schleifeniteration aus.
18
<search-result-trace encoding="html/javascript/ json/perl/url/none">
Gibt Informationen zur Platzierung des aktuellen Ergebnisses aus, z. B. alle ergebnisbasierten Aktionen, die die Position des Ergebnisses beeinflussten.
Das Ausgabeformat dieses Tags ist JSON, wie im folgenden Beispiel:
{   "sliceID": 5,   "indexID": 5894,   "finalScore": 98.5,   "dynamicScore": 15.3,   "staticScore": 55.456,   "position": 1,   "rbtaActionListID": 117,   "rbtaActionID": 57 }
Das Attribut encoding ist optional. der Standardwert ist html .
Hinweis: Dieses Tag verfügt nur über eine Ausgabe, wenn sp_trace=1 mit den Hauptsuchabfrageparametern angegeben wird.
Siehe Zeile 48 in der Tabelle unter CGI-Parameter für die Backend-Suche .

Bedingte Tags für die Ergebnisschleife

Die folgenden Tags enthalten den HTML-Code zwischen ihnen.
Siehe Informationen zu den Tags der Ergebnisschleife.
Tag
Beschreibung
1
<search-if-title> ... </search-if-title>
<search-if-not-title> ... </search-if-not-title>
Diese Tags enthalten den HTML-Code zwischen ihnen, wenn beim nächsten Aufruf von <search-title> Text aus dem Dokumenttitel zurückgegeben wird (oder nicht zurückgegeben wird).
2
<search-if-description length="XX"> ... /search-if-description>
<search-if-not-description> ... </search-if-not-description>
Diese Tags enthalten den HTML-Code zwischen ihnen, wenn beim nächsten Aufruf von <search-description> Text aus der Dokumentbeschreibung zurückgegeben wird (oder nicht zurückgegeben wird).
3
<search-if-body> ... </search-if-body>
<search-if-not-body> ... </search-if-not-bodytext>
Diese Tags enthalten den HTML-Code zwischen ihnen, wenn beim nächsten Aufruf von <search-body> Text vom Dokumentkörper zurückgegeben wird (oder nicht zurückgegeben wird).
4
<search-if-context length="XX"> ... </search-if-context>
<search-if-not-context> ... </search-if-not-context>
Diese Tags enthalten den HTML-Code zwischen ihnen, wenn der nächste Aufruf von <search-context> eine nicht leere Kontextzeichenfolge zurückgibt (oder nicht zurückgibt). Das Attribut length überschreibt das Attribut length für jedes eingeschlossene <search-context>- Tag.
5
<search-if-any-context length="XX"> ... /search-if-any-context>
<search-if-not-any-context> ... </search-if-not-any-context>
Diese Tags enthalten den HTML-Code zwischen ihnen, wenn mit dem Ergebnis eine Kontextzeichenfolge verknüpft ist (oder nicht). Das Attribut length überschreibt das Attribut length für jedes eingeschlossene <search-context>- Tag.
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>
Diese Tags enthalten den HTML-Code zwischen ihnen, wenn das Ergebnis des aktuellen Ergebnisses zwischen XX und YY liegt (oder nicht). Nützlich zum Hinzufügen von Aufzählungszeichen oder Grafiken, um anzuzeigen, wie relevant das Ergebnis ist. Wenn Sie unter Optionen > Metadaten > Definitionen ein Feld vom Typ Rang definiert haben, können Sie den Rang der dynamischen Seite überprüfen, indem Sie das Rang-Attribut auf dynamisch einstellen ( <search-if-score rank="dynamic" lower=XX upper=YY> ). Sie können den Rang der statischen Seite überprüfen, indem Sie das Rang-Attribut auf statisch einstellen ( <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>
Diese erweiterten Tags enthalten den HTML-Code, je nachdem, ob das im Attribut "name"angegebene Feld Inhalt hat oder nicht. Wenn das optionale Attribut "value"angegeben ist, enthalten die Tags den HTML-Code zwischen ihnen, je nachdem, ob der angegebene Wert mit dem Wert für das Feld im aktuellen Ergebnis übereinstimmt (oder nicht übereinstimmt). Diese Tags funktionieren nur innerhalb der Ergebnisschleife (zwischen den Tags <search-results> und </search-results> ).

Ankerverknüpfungs-Tags der Ergebnisschleife

Siehe Informationen zu den Tags der Ergebnisschleife.
Tag
Beschreibung
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>
Dieses Tag-Paar erstellt einen Ankerlink um den HTML-Code zwischen ihnen. Wenn auf den Link geklickt wird, wird die Ergebnisseite angezeigt. Ein optionales Zielattribut gibt das benannte Fenster an, in dem Frame-fähige Browser die Ergebnisseite anzeigen sollen.
Setzen Sie das Attribut "hbx-enable"auf "yes", um die über HBX verfügbaren Analysen zu nutzen. Setzen Sie hbx-linkid-name auf den Namen eines Metadatenfelds, das Sie verfolgen möchten. Um beispielsweise Suchergebnisse nach SKU-Nummer zu verfolgen, setzen Sie hbx-linkid-name auf den Namen des Metadatenfelds, das SKU-Informationen enthält.
Datumsfelder werden derzeit nicht unterstützt. Der Wert von hbx-linkid-name wird an die Link-ID im generierten Anker angehängt. Der Wert des Attributs "hbx-linkid-none"wird an die Link-ID angehängt, wenn das benannte Metadatenfeld leer ist. Der Wert von hbx-linkid-length begrenzt die Anzahl der aus dem Meta-Tag abgerufenen und angezeigten Zeichen. Die Standardanzahl an Zeichen ist 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>
Dieses Tag-Paar ähnelt dem <search-link> ... </search-link>- Tags. Wenn auf die generierten Ankerlinks geklickt wird, wird die Ergebnisseite angezeigt, wobei jedoch ein Bildlauf zum nächsten Anker-Tag vor dem Ergebnis durchgeführt wird. Bei PDF-Verknüpfungen zeigt der Acrobat-Viewer die Seite mit dem Ergebnis an. Ein optionales Zielattribut gibt das benannte Fenster an, in dem Frame-fähige Browser die Ergebnisseite anzeigen sollen.
Setzen Sie das Attribut "hbx-enable"auf "yes", um die über HBX verfügbaren Analysen zu nutzen. Setzen Sie hbx-linkid-name auf den Namen eines Metadatenfelds, das Sie verfolgen möchten. Um beispielsweise Suchergebnisse nach SKU-Nummer zu verfolgen, setzen Sie hbx-linkid-name auf den Namen des Metadatenfelds, das SKU-Informationen enthält.
Datumsfelder werden derzeit nicht unterstützt. Der Wert von hbx-linkid-name wird an die Link-ID im generierten Anker angehängt. Der Wert des Attributs "hbx-linkid-none"wird an die Link-ID angehängt, wenn das benannte Metadatenfeld leer ist. Der Wert von hbx-linkid-length begrenzt die Anzahl der aus dem Meta-Tag abgerufenen und angezeigten Zeichen. Die Standardanzahl an Zeichen ist 12.
3
<search-if-link-extension> ... </search-if-link-extension>
<search-if-not-link-extension> ... </search-if-not-link-extension>
Diese Tags enthalten den HTML-Code zwischen ihnen, wenn ein Wertattribut eine Erweiterung angibt, die dem Ende der URL für das Ergebnis entspricht. Dieses Tag ist nützlich, um anhand der Linkerweiterung eine Grafik in die Suchergebnisse aufzunehmen. Das value-Attribut ist eine Liste einer oder mehrerer Erweiterungen (durch Leerzeichen getrennt) wie folgt: VALUE=".pdf" oder VALUE=".html .htm".

Bedingte Tags für Schleifenposition

Die folgenden Tags enthalten den Text zwischen ihnen bedingt. Sie können nur innerhalb der Tags "Schleife"angezeigt werden: < search-results> und <search-field-values> . Sie werden verwendet, um die Position des aktuellen Ergebnisses innerhalb der Ergebnismenge zu testen.
Siehe Informationen zu den Tags der Ergebnisschleife.
Tag
Beschreibung
1
<search-if-first> ... </search-if-first>
<search-if-not-first> ... </search-if-not-first>
Diese Tags beinhalten den Text zwischen ihnen, wenn das aktuelle Ergebnis das erste Ergebnis auf der Seite ist (oder nicht) (wenn es innerhalb von <search-results> verwendet wird) oder der erste Feldwert (wenn es in <search-field-values> verwendet wird) .
2
<search-if-last> ... </search-if-last>
<search-if-not-last> ... </search-if-not-last>
Diese Tags beinhalten den Text zwischen ihnen, wenn das aktuelle Ergebnis das letzte Ergebnis auf der Seite ist (oder nicht) (wenn es innerhalb von <search-results> verwendet wird) oder der letzte Feldwert (wenn es in <search-field-values> verwendet wird) . Dieses Tag kann verwendet werden, um eine Trennlinie zwischen den Ergebnissen einzufügen. So wird beispielsweise zwischen den Ergebnissen ein <hr>- Tag eingefügt:
<search-results>    <search-lt>tr<search-if-alt> class="alt"</search-if-alt><search-gt>       <td><search-url></td>    </tr> </search-results>
3
<search-if-inner> ... </search-if-inner>
<search-if-not-inner> ... </search-if-not-inner>
Diese Tags beinhalten den Text zwischen ihnen, wenn das aktuelle Ergebnis weder das erste noch das letzte Ergebnis auf der Seite ist (wenn es innerhalb von <search-results> verwendet wird) oder nicht der erste noch der letzte Feldwert ist (wenn es innerhalb <search-field-values> verwendet wird) . Die Nicht-Version des Tags prüft, ob das Ergebnis das erste oder das letzte ist.
4
<search-if-alt> ... </search-if-alt>
<search-if-not-alt> ... </search-if-not-alt>
Diese Tags beinhalten den Text zwischen ihnen, wenn das aktuelle Ergebnis ein alternatives Ergebnis auf der Seite ist (oder nicht) (wenn es innerhalb von <search-results> verwendet wird) oder ein alternativer Feldwert (wenn es innerhalb <search-field-values> verwendet wird) oder ein alternativer Feldwert (wenn es in <search-field-values> verwendet wird). Die "alternativen"Ergebnisse sind das zweite, vierte, sechste usw. auf der Seite. In diesem Beispiel wird eine andere Klasse auf alternative Tabellenzeilen angewendet. Beachten Sie die Verwendung von <search-lt> und <search-gt> , damit das <search-if-alt> -Tag "innerhalb"des <tr> -Tags platziert werden kann.
    <search-results>        <search-lt>tr<search-if-alt> class="alt"</search-if-alt><search-gt>           <td><search-url></td>        </tr>     </search-results>
5
<search-if-even> ... </search-if-even>
<search-if-not-even> ... </search-if-not-even>
Diese Tags beinhalten den Text zwischen ihnen, wenn das aktuelle Ergebnis ein gerader numerisches Ergebnis ist (oder nicht) (wenn es innerhalb <Suchergebnisse> verwendet wird) oder ein gerader Feldwert (wenn es innerhalb <Suchfeldwerte> verwendet wird) oder ein gerader nummerierter Wert (wenn es innerhalb <Suchfeldwerte> verwendet wird)). Ein Suchergebnis wird geradezu nummeriert, wenn der <search-index>- Wert gleich ist. Mit anderen Worten, wenn ihre Position innerhalb der gesamten Ergebnismenge gleich ist. Dies kann sich von <search-if-alt> unterscheiden, das die Position eines Ergebnisses auf der Seite testet, nicht innerhalb der gesamten Ergebnismenge. Die folgenden beiden Tabellen illustrieren den Unterschied:

Erste Seite, sp_n=1

Index
Ergebnis
Selbst?
Alt?
1
Erstes Ergebnis
Nein
Nein
2
Zweites Ergebnis
Ja
Ja
3
Drittes Ergebnis
Nein
Nein
4
Viertes Ergebnis
Ja
Ja
5
Fünftes Ergebnis
Nein
Nein

Später Seite, sp_n=10

Index
Ergebnis
Selbst?
Alt?
10
Zehntes Ergebnis
Ja
Nein
11
Elftes Ergebnis
Nein
Ja
12
Zwölftes Ergebnis
Ja
Nein
13
Dreizehntes Ergebnis
Nein
Ja
14
Vierzehntes Ergebnis
Ja
Nein
Beachten Sie schließlich, dass <search-if-even> dies immer mit <search-if-alt> den Suchfeldwerten identisch ist, da Feldwerte nicht paginiert werden.

Listentags für Feldwerte

Die folgenden erweiterten Tags geben Feldwerte und zugehörige Daten aus dem gesamten Satz der Suchergebnisse aus. Diese Tags liefern nur die Ausgabe für Felder, die von den CGI-Parametern in der Suchabfrage angegeben sp-sfvl-field werden.
Tag
Beschreibung
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 ascript/json/perl/url/none">
Dieses Tag zeigt eine Liste mit eindeutigen Feldwerten, Wertzählungen oder Ergebniszahlen innerhalb der gesamten Ergebnismenge an.
Dieses Tag liefert nur die Ausgabe für Felder, die von den CGI-Parametern sp_sfvl_field in der Suchabfrage angegeben werden. Das optionale Attribut "Anführungszeichen"steuert, ob die einzelnen Elemente von doppelten Anführungszeichen (oder von einfachen Anführungszeichen, wenn encoding=perl) umgeben sind. Der Standardwert von "Anführungszeichen"ist "Ja". Das optionale Attribut "Kommas"steuert, ob die einzelnen Elemente durch Kommas getrennt werden. Der Standardwert von "commas"ist "yes". Das optionale Attribut "data"steuert, ob jeder eindeutige Feldwert ausgegeben wird (data="values"), die Gesamtanzahl der einzelnen eindeutigen Feldwerte ausgegeben wird (data="counts") oder die Anzahl der Ergebnisse, die jeden eindeutigen Wert enthalten (data="results"), ausgegeben wird. Der Standardwert von "data"ist "values". Bei Feldern, die keine Listen sind, sind data="counts" und data="results" gleich. Das Attribut "separator"definiert das einzelne Zeichen oder Trennzeichen, das zwischen den Werten der Ausgabe eingefügt werden soll. Das optionale Attribut "sortby" steuert die Reihenfolge der Ausgabe; sortby="none" bedeutet keine bestimmte Reihenfolge, sortby="values" bedeutet Sortierung nach Feldwerten (in aufsteigender oder absteigender Reihenfolge entsprechend der Sorting-Eigenschaft des Felds), sortby="counts" bedeutet Sortierung in absteigender Reihenfolge der Feldwerte und sortby="results" bedeutet Sortierung in absteigender Reihenfolge der Anzahl der Ergebnisse, die jeden Wert enthalten.
Beachten Sie, dass sortby="counts" und sortby="results" für Felder ohne Listentyp gleichwertig sind. Das optionale Attribut "max-items"begrenzt die Anzahl der auszugebenden Elemente. Der Standardwert von "max-items"ist -1, d. h. "output all items".
Es gibt eine absolute Grenze von 100 für max. Elemente. Die Attribute "date-format", "gmt"und "language"sind nur relevant, wenn der Inhaltstyp des angegebenen Felds "date"ist. Das Attribut "date-format"nimmt eine Datumsformat-Zeichenfolge im UNIX-Stil wie "%A", %B %d, %Y"(für "Montag, 25. Juli 2016"). "gmt"ist standardmäßig "yes"und steuert, ob der Zeitabschnitt der Datums-Zeichenfolge in GMT ("yes") oder in der Zeitzone des Kontos ("no") ausgegeben werden soll.
Das Attribut "language"steuert die Konventionen für Sprache und Gebietsschema der Ausgabedatumszeichenfolge. "0" (Standard) bedeutet "Kontosprache verwenden". Jeder andere "language"-Wert wird als spezifischer Sprachbezeichner interpretiert, z. B. bedeutet "en_US" "Englisch (USA)". Das optionale Attribut "encoding"steuert, ob die Zeichen der Ausgabestrategie HTML-kodiert, JavaScript-kodiert, Perl-kodiert, URL-kodiert oder nicht kodiert sind, für die Ausgabe auf der Ergebnisseite. Der Standardwert von "encoding"ist "html".
2
<search-field-value-list-count name="field-name" value="field-value" results="yes/no">
Dieses Tag zeigt die Zählungsinformationen für eine angegebene Suchfeld-Wertliste an. Es gibt drei unterschiedliche Verwendungen für dieses Tag. Wenn nur das Attribut "name"angegeben ist, gibt dieses Tag die Anzahl der eindeutigen Werte für das benannte Feld innerhalb des gesamten Ergebnissatzes aus. Wenn beide Attribute "name"und "value"angegeben werden, gibt dieses Tag entweder die Gesamtanzahl des angegebenen Werts innerhalb des gesamten Ergebnissatzes (für results="no") oder die Gesamtanzahl der Ergebnisse mit dem angegebenen Wert im gesamten Ergebnissatz (für results="yes") aus. Der Standardwert von "results"ist "no". Hinweis: Bei Feldern, die keine Listen sind, sind results="yes"und results="no"gleichwertig. Der Wert von "results"wird ignoriert, wenn das Attribut "value"nicht angegeben wird. Dieses Tag liefert nur die Ausgabe für Felder, die von den CGI-Parametern des sp-sfvl-Felds in der Suchabfrage angegeben werden.
3
<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>
Diese Tags zeigen den HTML-Code zwischen ihnen an, wenn der äquivalente Aufruf von <search-field-value-list-count name="field-name" value="field-value"> mit den angegebenen Attributen einen Wert größer als null zurückgibt (oder nicht).
4
<search-if-single-field-value-list-count name="field-name"> ... </search-if-single-field-value-list-count>
Diese Tags zeigen den Inhalt zwischen ihnen an, wenn der äquivalente Aufruf von <search-field-value-list-count name="field-name" value="field-value"> mit den angegebenen Attributen einen einzelnen Wert zurückgibt (oder nicht). Dies wird in der Regel verwendet, wenn ein Konto Facetten-Slots verwendet. Bei Facettensteckplätzen ist es normalerweise nur sinnvoll, den Wertzeitpunkt anzuzeigen, wenn der zugehörige Namenseinschub ein einzelnes Element enthält. Diese Prüfung in der Transportvorlage ist effizienter als in der Präsentationsebene.

Feld-Wert-Listen-Tags

Die folgenden erweiterten Tags zählen Feldwerte und zugehörige Daten aus dem gesamten Satz von Suchergebnissen mit einem Schleifenkonstrukt auf und geben sie aus. Diese Tags liefern nur die Ausgabe für Felder, die von den CGI-Parametern in der Suchabfrage angegeben sp-sfvl-field werden.
Tag
Beschreibung
1
<search-field-values name="field-name" sortby="none/values/counts/results" max-items="XX"> ... </search-field-values>
Dieses Tag erstellt eine Schleife zum Aufzählen von Feldwerten und zugehörigen Daten für ein bestimmtes Feld innerhalb des gesamten Ergebnissatzes. Verschachteln Sie dieses Tag nicht in einem anderen <search-field-values>- -Tag. Das Attribut "name"gibt den Namen des Felds an, das die aufzuzählenden Werte enthält. Das optionale Attribut "sortby"steuert die Aufzählungsreihenfolge: "none"bedeutet keine bestimmte Reihenfolge, "werte"die Sortierung nach Feldwerten (in auf- oder absteigender Reihenfolge gemäß der Sorting-Eigenschaft des Felds), sortby="counts" die Sortierung in absteigender Reihenfolge der Feldwerte und sortby="results" die Sortierung in absteigender Reihenfolge der Anzahl der Ergebnisse, die jeden Wert enthalten.
Beachten Sie, dass sortby="counts" und sortby="results" für Felder ohne Listentyp gleichwertig sind. . Das optionale Attribut "max-items"begrenzt die Anzahl der Iterationen auf den angegebenen Wert. Der Standardwert für "max-items"ist -1, d. h. "enumerate all values".
2
<search-field-value date-format="date-format-string" encoding="html/javascript/json/perl/url/none" gmt="yes/no" language="0/language-id">
Dieses Tag gibt den Feldwert für die aktuelle <search-field-values> Schleifeniteration aus. Dieses Tag ist nur innerhalb einer <search-field-values>- Schleife gültig. Die Attribute "date-format", "gmt"und "language"sind nur relevant, wenn der Inhaltstyp des im umschließenden <search-field-values>-Tag angegebenen Feldnamens "date"ist. Das Attribut "date-format"nimmt eine Datumsformat-Zeichenfolge im UNIX-Stil wie "%A", %B %d, %Y"(für "Montag, 25. Juli 2020").
Das optionale Attribut "encoding"steuert, ob die Zeichen der Ausgabestrategie HTML-kodiert, JavaScript-kodiert, Perl-kodiert, URL-kodiert oder nicht kodiert sind, für die Ausgabe auf der Ergebnisseite. Der Standardwert von "encoding"ist "none". Normalerweise müssen Sie das Kodierungsattribut nicht angeben. "gmt"ist standardmäßig "yes"und steuert, ob der Zeitabschnitt der Datums-Zeichenfolge in GMT ("yes") oder in der Zeitzone des Kontos ("no") ausgegeben werden soll. Das Attribut "language"steuert die Konventionen für Sprache und Gebietsschema der Ausgabedatumszeichenfolge. "0" (Standard) bedeutet "Kontosprache verwenden". Jeder andere "language"-Wert wird als spezifischer Sprachbezeichner interpretiert, z. B. bedeutet "en_US" "Englisch (USA)".
3
<search-field-value-count results="yes/no">
Dieses Tag gibt die mit der aktuellen <search-field-values> -Schleifeniteration verknüpfte Anzahl aus. Die Ausgabenanzahl ist entweder die Anzahl der Ergebnisse im gesamten Ergebnissatz, der den Feldwert enthält (results="yes"), oder die Gesamtanzahl für den Feldwert im gesamten Ergebnissatz. Der Standardwert von "results"ist "no".
Bei Feldern, die keine Listen sind, sind results="yes"und results="no"gleichwertig. Dieses Tag ist nur innerhalb einer <search-field-values>- Schleife gültig.
4
<search-field-value-counter>
Dieses Tag gibt den Ordinalzähler für die aktuelle <search-field-values> -Schleifenitation aus. Dieses Tag ist nur innerhalb einer <search-field-values>- Schleife gültig.

Vorschlagen von Tags

Suggest bietet einen benutzerfreundlichen "Meinten Sie?" Dienst zum Vorschlagen alternativer Suchbegriffe. Wenn ein Benutzer beispielsweise einen Suchbegriff falsch geschrieben hat, kann Suggest dem Benutzer helfen, Ergebnisse zu finden, indem er eine korrekte Schreibweise vorschlägt. Das System kann auch zugehörige Suchbegriffe vorschlagen, die einem Benutzer helfen, Ergebnisse zu erkennen. Beim Generieren von Vorschlägen verwendet der Suggest-Dienst zwei Wörterbücher: eine auf Basis der Kontosprache (eingestellt unter Indexing > Words and Languages > Language ) und die andere auf Basis der Suchbegriffe im Kontoindex.
Der Suggest-Dienst funktioniert nicht für Chinesisch, Japanisch oder Koreanisch.
Tag
Beschreibung
1
<search-if-recommendations> ... </search-if-recommendations>
Umschließen Sie diese Tags mit beliebigen Vorlagen-Tags vom Typ "Vorschlagen", z. B. <search-recommendations> , <search-recommendations-link> usw. Wenn die Suche Vorschläge generiert, gibt die Suchmaschine alles zwischen dem Tag open und close aus und verarbeitet alles. Wenn die Suche keine Vorschläge generiert, wird keiner der verschachtelten Inhalte ausgegeben.
2
<search-recommendations> ... </search-recommendations>
Dieses Tag generiert die "Suggest"-Schleife, die eine Liste der vorgeschlagenen Suchbegriffe enthält (z. B. "beabsichtigen", "beabsichtigen" und "beabsichtigt" für eine Abfrage, die ursprünglich als "beabsichtigte"eingegeben wurde). Beim Generieren der Liste der Begriffe wiederholt die Suchmaschine verschachtelte HTML- und/oder Vorlagen-Tags bis zu fünf Mal, was der maximalen Anzahl an Vorschlägen entspricht. Verwenden Sie das Attribut count, um die Anzahl der generierten Vorschläge anzugeben (zwischen 0 und 5).
Das <search-recommendations>- Tag kann mehrmals auf der Seite angezeigt werden, um die Liste der Vorschläge zu wiederholen. Mehrere Vorschläge werden nach der Anzahl der Ergebnisse sortiert, die die einzelnen Erträge erbringen.
Verschachteln Sie das <search-recommendations>- Tag zwischen den <search-if-recommendations>- Tags.
3
<search-recommendations-link> ... </search-recommendations-link>
Dieses Tag generiert einen Link zur ursprünglichen Suchabfrage mit dem ausgewählten vorgeschlagenen Suchbegriff anstelle des ursprünglichen Begriffs. Das Tag akzeptiert und druckt einfach jedes beliebige HTML-Attribut wie Klasse, Ziel und Stil aus. Das Tag kann auch ein URL-Attribut akzeptieren, dessen Wert als Basis-URL für den generierten Link verwendet wird. Die Tags können nur innerhalb der <search-recommendations>- Schleife angezeigt werden.
4
<search-recommendations-text/>
Dieses Tag gibt den derzeit vorgeschlagenen Suchbegriff aus (z. B. "beabsichtigen" für eine Abfrage, die ursprünglich als "beabsichtigt" eingegeben wurde). Das Tag hat keine Attribute und kann nur in der <search-recommendations>- -Schleife angezeigt werden.
5
<search-if-not-recommendations> ... </search-if-not-recommendations>
Wenn die Suche keine Vorschläge generiert, gibt die Suchmaschine alles zwischen dem Tag open und close aus und verarbeitet alles. Wenn die Suche Vorschläge generiert, wird keiner der verschachtelten Inhalte ausgegeben.
6
<search-if[-not]-first-recommendations> ... </search-if[-not]-first-recommendations>
Diese bedingten Tags enthalten den HTML-Code zwischen ihnen, je nachdem, ob der vorgeschlagene Begriff der erste Begriff in der Vorschlagsschleife ist. Die Tags müssen zwischen den öffnenden und schließenden <search-recommendations>- Tags stehen.
7
<search-if[-not]-last-recommendations> ... </search-if[-not]-last-recommendations>
Diese bedingten Tags enthalten den HTML-Code zwischen ihnen, je nachdem, ob der vorgeschlagene Begriff der letzte Begriff in der Vorschlagsschleife ist. Die Tags müssen zwischen den öffnenden und schließenden <search-recommendations>- Tags stehen.
8
<search-recommendations-index>
Dieses Tag gibt den numerischen Index des aktuellen vorgeschlagenen Suchbegriffs zurück. Das Tag muss zwischen den Tags open und close <search-recommendations> stehen.
9
<search-recommendations-total>
Dieses Tag gibt die Gesamtanzahl der erstellten vorgeschlagenen Suchbegriffe zurück. Das Tag muss zwischen den Tags open und close <search-recommendations> stehen.
10
<search-recommendations-result-count>
Dieses Tag gibt die Gesamtanzahl der Ergebnisse für den vorgeschlagenen Suchbegriff zurück. Das Tag muss zwischen den Tags open und close <search-recommendations> stehen.

Vorlagen-Zeichenfolgen-Tags

Die folgenden Tags geben an diesem Punkt in der Vorlage eine Zeichenfolge in den HTML-Code aus.
Tag
Beschreibung
1
<search-body>
Das HTML-Body-Tag mit allen Einstellungen für die Farbe des Suchlinks, die vom Abschnitt "Grundlegendes Aussehen"unter dem Link "Vorlage"festgelegt werden. Fügen Sie diesem Tag ein Hintergrundattribut hinzu, um Hintergrundbilder auf der Ergebnisseite anzuzeigen. Alle diesem Tag hinzugefügten Farbattribute setzen die Einstellungen für die Farbe des Suchlinks außer Kraft, die im Abschnitt "Grundlegender Look"festgelegt werden.
2
<search-header>
Der HTML-Code für die Kopfzeile der Suchergebnisse, wie im Abschnitt "Grundlegender Look"unter dem Link "Vorlage"festgelegt.
3
<search-data> ... </search-cdata>
Die Tags search-data werden durch ihre XML-Entsprechungen ersetzt: <search-cdata> wird durch <![CDATA[" und das Tag </search-data> werden durch " ]]> "ersetzt. Ein XML-Parser analysiert keine Informationen zwischen dem open- und close-Tag.
4
<search-query-number="XX" encoding="html/javascript/json/perl/url/none">
Die vom Besucher eingegebene Abfrage. Das erweiterte, optionale Attribut "query-number"steuert, welche nummerierte Abfragezeichenfolge von diesem Tag ausgegeben wird. Beispiel: <search-query-number=1> gibt den Inhalt des Parameters sp_q_1 cgi aus. Wenn "query-number"nicht angegeben ist oder die Abfragenummer "0"ist, wird die Hauptabfrage ( sp_q ) ausgegeben. Das optionale Attribut "encoding"steuert, ob die Ausgabe HTML-kodiert, JavaScript-kodiert, Perl-kodiert, URL-kodiert oder nicht kodiert ist, für die Ausgabe auf der Ergebnisseite. Der Standardwert von "encoding"ist "html". Normalerweise müssen Sie das Kodierungsattribut nicht angeben.
5
<search-total>
Die Gesamtanzahl der Ergebnisse für diese Suche.
6
<search-count>
Die Anzahl der für diese Seite gemeldeten Ergebnisse.
7
<search-lower>
Die Anzahl des ersten Ergebnisses, das für diese Seite gemeldet wurde.
8
<search-upper>
Die Nummer des letzten Ergebnisses, das für diese Seite gemeldet wurde.
9
<search-prev-count>
Die Anzahl der Ergebnisse, die für die vorherige Seite gemeldet wurden.
10
<search-next-count>
Die Anzahl der für die nächste Seite gemeldeten Ergebnisse.
11
<search-time>
Die Zeit in Sekunden für diese Suche.
12
<search-logo>
Der HTML-Code für das Suchlogo, der für Ihr Konto konfiguriert ist, sofern vorhanden. Dieses Logo ist das Bild, das der Site-Suche/dem Merchandising gutgeschrieben wird.
Die meisten Konten haben derzeit kein Suchlogo.
13
<search-collection all="name">
Die Sammlung der Ergebnisse für diese Suche. Das optionale Attribut "all"wird verwendet, um den Namen der Sammlung anzugeben, die die gesamte Website darstellt.
14
<search-form> ...</search-form>
Fügt form-Tags vom Anfang bis zum Ende ein. Fügt die Attribute für Methode und Aktion in das Tag "begin form"ein. Akzeptiert zusätzliche Attribute, einschließlich des Attributs dir="RTL" für die Sprache sowie JavaScript-bezogene Attribute "name"und "onSubmit".
15
<search-input-account>
Fügt ein Formulareingabe-Tag ein, das Ihre Kontonummer angibt.
16
<search-input-gallery>
Fügt ein Formulareingabe-Tag ein, das die Galeriennummer angibt.
17
<search-input-query-number="XX">
Fügt ein Formulareingabe-Tag ein, das die Abfragezeichenfolge angibt. Das erweiterte, optionale Attribut "query-number"steuert, welche nummerierte Abfrage für das Formulareingabe-Tag verwendet wird. Beispiel: <search-input-query-number=1> gibt ein Formulareingabe-Tag für die sp_q_1- Abfrage aus. Wenn "query-number"nicht angegeben ist oder "query-number"den Wert "0"hat, wird ein input-Tag für die sp_q- Hauptabfrage eingefügt.
18
<search-input-collections all="name">
Fügt ein form select-Tag und das zugehörige HTML ein, um das Auswahlmenü für Sammlungen anzuzeigen. Das optionale Attribut "all"wird verwendet, um den Namen der Sammlung anzugeben, die die gesamte Website darstellt.
19
<search-lt>
Fügt die Ausgabe eines der Suchvorlagen-Tags in andere HTML- oder Vorlagen-Tags auf der Ergebnisseite ein. <search-lt> fügt ein Kleiner-als-Zeichen ein. Die Verwendung von <search-lt> und <search-gt> bietet eine Möglichkeit, der Definition eines Tags zu entkommen, sodass Sie Suchvorlagen-Tags als Attributwerte verwenden können. Wenn die Vorlage als Antwort auf eine Suche wiedergegeben wird, ersetzt ein Kleiner-als-Zeichen (<) das <search-lt> -Tag. Beispiel: <search-link> entspricht <search-lt>a href="<search-url>"<search-gt> .
20
<search-gt>
Fügt die Ausgabe eines der Suchvorlagen-Tags in andere HTML- oder Vorlagen-Tags auf der Ergebnisseite ein. <search-gt> fügt ein Größer-Zeichen ein. Die Verwendung von <search-lt> und <search-gt> bietet eine Möglichkeit, der Definition eines Tags zu entkommen, sodass Sie andere Vorlagen-Tags als Attributwerte verwenden können. Wenn die Vorlage als Antwort auf eine Suche wiedergegeben wird, ersetzt ein Größer-als-Zeichen (>) das <search-gt> -Tag. Beispiel: <search-link> entspricht <search-lt>a href="<search-url>"<search-gt> .
21
<search-param name="param-name" length="XX" encoding="html/javascript/json/perl/url/none">
Gibt den Wert des cgi-Parameters mit dem Namen "param-name"aus der aktuellen Suchanfrage zurück. Das optionale Attribut "encoding"steuert, ob die Ausgabe HTML-kodiert, JavaScript-kodiert, Perl-kodiert, URL-kodiert oder nicht kodiert ist, für die Ausgabe auf der Ergebnisseite. Der Standardwert von "encoding"ist "html". Normalerweise müssen Sie das Kodierungsattribut nicht angeben.
22
<search-trace encoding="html/javascript/ json/perl/url/none">
Das Attribut encoding ist optional. der Standardwert ist json .
Hinweis: Dieses Tag verfügt nur über eine Ausgabe, wenn sp_trace=1 mit den Hauptsuchabfrageparametern angegeben wird.
Siehe Zeile 48 in der Tabelle unter CGI-Parameter für die Backend-Suche .

Vorlagenanker-Verknüpfungs-Tags

Die folgenden Tags führen dazu, dass ein Ankerlink den HTML-Code zwischen beiden umschließt. Wenn auf den Ankerlink geklickt wird, wird eine weitere Ergebnisseite angezeigt. Das optionale Attribut "count"fordert, dass viele Ergebnisse auf der Seite angezeigt werden. Wenn nicht angegeben, wird die auf der aktuellen Seite angeforderte Anzahl verwendet. Das erweiterte optionale Attribut "URL"steuert die Domäne, an die der zugehörige Link weitergeleitet wird. Standardmäßig ist die Domäne https://search.atomz.com/search/ festgelegt, Sie können dies jedoch mithilfe des URL-Attributs ändern.
Tag
Beschreibung
1
<search-next URL="https://search.yourdomain.com/search/"> ... </search-next>
<search-prev URL="https://search.yourdomain.com/search/"> ... </search-prev>
Zeigt die nächste oder vorherige Seite der Ergebnisse an.
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>
Sortiert die Ergebnisse nach Datum oder Relevanz.
3
<search-show-summaries URL="https://search.yourdomain.com/search/"> ... </search-show-summary>
<search-hide-summaries URL="https://search.yourdomain.com/search/"> ... </search-hide-summaries>
Blendet die Zusammenfassungen ein oder aus.

Bedingte Tags für Vorlagen

Tags, die es Ihnen ermöglichen, HTML zwischen ihnen bedingt einzuschließen.
Tag
Beschreibung
1
<search-if-results> ... </search-if-results>
<search-if-not-results> ...</search-if-not-results>
Diese Tags enthalten HTML, wenn die aktuelle Seite Suchergebnisse enthält (oder keine).
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>
Diese Tags enthalten HTML, wenn der vorherigen oder der nächsten Seite irgendein (oder keines) Ergebnis zugeordnet ist.
3
<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>
Diese Tags enthalten HTML, wenn die aktuelle Seite nach Relevanz oder Datum sortiert ist oder nicht.
4
<search-if-show-summaries> ... </search-if-show-summary>
<search-if-hide-summaries> ... </search-if-hide-summary>
Diese Tags enthalten HTML, wenn die aktuelle Seite Zusammenfassungen ein- oder ausblendet. Mit diesen Tags können Sie einen beliebigen Teil des Suchergebnisses ein- oder ausschließen.
5
<search-if-input-collections> ... </search-if-input-collections>
<search-if-not-input-collections> ... </search-if-not-input-collections>
Diese Tags enthalten HTML, wenn eine Sammlung in der Generierung der Suchergebnisse für die aktuelle Seite angegeben wurde.
6
<search-if-advanced> ... </search-if-advanced>
<search-if-not-advanced> ... </search-if-not-advanced>
Diese Tags enthalten HTML, wenn der CGI-Parameter sp_advanced=1 für die Suchabfrage angegeben wurde.
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>
Diese Tags schließen den HTML-Code zwischen ihnen ein oder aus, wenn der angegebene Parameter ungültig ist oder nicht.
Derzeit wird nur der Parameter sp_q_location[_#] unterstützt.
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>
Diese erweiterten Tags enthalten den HTML-Code zwischen ihnen, je nachdem, ob der im Attribut "name"angegebene CGI-Parameter den im Attribut "value"angegebenen Wert hat.
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>
Diese erweiterten Tags enthalten den HTML-Code zwischen ihnen, wenn die aktuelle Seite nach dem angegebenen Feldnamen sortiert ist oder nicht.

Steuerelemente-Tags für Vorlagen

Tags, mit denen Sie den Standardauswahlstatus für Kontrollkästchen, Optionsfelder und Listenfelder in einer Suchvorlage <form> steuern können.
Tag
Beschreibung
1
<search-input>
Wird in einer Vorlage anstelle eines <input>- Tags verwendet. Wenn das Tag in den Browser geschrieben wird, ersetzt das Wort input die Sucheingabe und alle anderen Informationen im Tag werden unverändert ausgegeben. Wenn außerdem der im Tag angegebene Name als CGI-Parameter aufgeführt wird und der im Tag angegebene Wert der Wert für diesen CGI-Parameter ist, wird das markierte Wort am Ende des Tags hinzugefügt . Auf diese Weise können Sie automatisch den Standard-Optionsfeld- oder Kontrollkästchen-Status in Ihrem Suchergebnis mit der aktuellen Abfrage identisch machen.
Der HTML-Code für ein Kontrollkästchen könnte z. B. wie folgt aussehen:
<input type=checkbox name="sp_w" value="exact">Keine Klangübereinstimmung
Der entsprechende Vorlagencode für dieses Kontrollkästchen lautet wie folgt:
<search-input type=checkbox name="sp_w" value="exact">Keine Klangalike-Übereinstimmung
Wenn die CGI-Parameterzeichenfolge für die Abfrage sp_w=exact enthält , sieht das in den Browser mit den Suchergebnissen geschriebene Tag wie folgt aus (das markierte Wort wird am Ende des Tags eingefügt):
<input type=checkbox name="sp_w" value="exact" check>Keine Klangalike-Übereinstimmung
Wenn die CGI-Parameterzeichenfolge für die Abfrage sp_w=exact nicht enthält , sieht das in den Browser mit den Suchergebnissen geschriebene Tag wie folgt aus (das markierte Wort wird im Tag nicht aufgelistet):
<input type=checkbox name="sp_w" value="exact">Keine Klangübereinstimmung
Das <search-input>- -Tag ist hilfreich, um Kontrollkästchen und Optionsfelder in Ihre Suchvorlage einzufügen. Wenn Sie Kontrollkästchen oder Optionsfelder haben, die Sie dem <Formular> in Ihrer Suchvorlage hinzufügen möchten, verwenden Sie <search-input...> anstelle von <input...> .
2
<search-select> ... </search-select>
<search-option> ... </search-option>
Dropdown-Listenfelder in einem <form> -Tag werden mit einem <select>- Tag gestartet und mit einem </select>- Tag beendet. Der Name des zugehörigen CGI-Parameters wird im <select>- Tag aufgelistet. Nach dem Tag <select> befindet sich eine Liste mit <option>- Tags, die die Werte angeben, die im Listenfeld angezeigt werden sollen.
Die Tags <search-select>, </search-select> , <search-option> und </search-option> bieten eine ähnliche Funktionalität wie das Tag <search-input> . Das heißt, das ausgewählte Wort wird automatisch am Ende des <option>-Tags an den Browser gesendet, wenn der Name im <search-select>- -Tag als CGI-Parameter aufgelistet ist und der Wert dieses CGI-Parameters als der Wert in einem bestimmten <search-option>-Tag aufgeführt wird. Auf diese Weise können Sie die Standardliste im Suchergebnis automatisch mit der aktuellen Abfrage abgleichen.
Ein typisches Listenfeld sieht beispielsweise wie folgt aus:
<select name="sp_x" size=1> <option value="any" selected>Anywhere</option> <option value="title">Title</option> <option value="desc">Description</option> <option value="keys">Keywords</option> <option value="body">Body</option> <option value="alt">Alternate text</option> <option value="url">URL</option> <option value="target">Target</option> </select>
Der entsprechende Vorlagencode für dieses Listenfeld lautet wie folgt:
<search-select name="sp_x" size=1> <search-option value="any">Anywhere</search-option> <search-option value="title">Title</search-option> <search-option value="desc">Description</search-option> <search-option value="keys">Keywords</search-option> <search-option value="body">Body</search-option> <search-option value="alt">Alternate text</search-option> <search-option value="url">URL</search-option> <search-option value="target">Target</search-option> </search-select>
Wenn Sie Listenfelder haben, die Sie dem <Formular> in Ihrer Suchvorlage hinzufügen möchten, verwenden Sie <search-select...> anstelle von <select...> , </search-select> anstelle von </select> <search-option...> an der Stelle von <option...>, und </search-option> option>.
3
<search-sort-by-field name="field-name" count="XX"> ... </search-sort-by-field>
Diese erweiterten Tags erstellen einen Ankerlink um den HTML-Code zwischen ihnen. Wenn auf diesen Anker geklickt wird, wird eine Seite mit Ergebnissen angezeigt, die auf dem angegebenen Feld sortiert sind. Das optionale count- Attribut gibt die Anzahl der Ergebnisse an, die auf der Ergebnisseite angezeigt werden sollen. Wenn die Zählung weggelassen wird, wird die auf der aktuellen Seite verwendete Anzahl verwendet.

Datumsformat-Zeichenfolgen

Sie können die folgenden Konvertierungsspezifikationen in Datumsformat-Zeichenfolgen verwenden:
Datumsformat-Zeichenfolge
Beschreibung
%A
Entspricht der nationalen Darstellung des vollständigen Wochentagsnamens, z. B. "Montag". Die Einstellung unter Linguistik > Wörter und Sprachen > Sprache bestimmt die nationale Vertretung.
%a
Entspricht der nationalen Darstellung des abgekürzten Wochentagsnamens, wobei die Abkürzung die ersten drei Zeichen (z. B. "Mon") umfasst. Die Einstellung unter Linguistik > Wörter und Sprachen > Sprache bestimmt die nationale Vertretung.
%B
Entspricht der nationalen Darstellung des vollständigen Monatsnamens, z. B. "Juni". Die Einstellung unter Linguistik > Wörter und Sprachen > Sprache bestimmt die nationale Vertretung.
%b
Stimmt mit der nationalen Darstellung des abgekürzten Monatsnamens überein, wobei die Abkürzung die ersten drei Zeichen (z. B. "Jun") umfasst. Die Einstellung unter Linguistik > Wörter und Sprachen > Sprache bestimmt die nationale Vertretung.
%D
Entspricht "%m/%d/%y", z. B. "07/25/13".
%d
Entspricht dem Tag des Monats als Dezimalzahl (01-31).
%e
Entspricht dem Tag des Monats als Dezimalzahl (1-31). Vor einstelligen Ziffern ist ein Leerzeichen.
%H
Entspricht der 24-Stunden-Uhr als Dezimalzahl (00-23).
%h
Stimmt mit der nationalen Darstellung des abgekürzten Monatsnamens überein, wobei die Abkürzung die ersten drei Zeichen umfasst, z. B. "Jun"(identisch mit %b).
%I
Entspricht der 12-Stunden-Uhr als Dezimalzahl (01-12).
%j
Entspricht dem Tag des Jahres als Dezimalzahl (001-366).
%k
Entspricht der 24-Stunden-Uhr als Dezimalzahl (0-23). Vor einstelligen Ziffern ist ein Leerzeichen.
%l
Entspricht der 12-Stunden-Uhr als Dezimalzahl (1-12). Vor einstelligen Ziffern ist ein Leerzeichen.
%M
Stimmt mit der Minute als Dezimalzahl (00-59) überein.
%m
Entspricht dem Monat als Dezimalzahl (01-12).
%p
Entspricht der nationalen Darstellung von "ante meridiem"oder "post meridiem", z. B. "PM". Die Einstellung unter Linguistik > Wörter und Sprachen > Sprache bestimmt die nationale Vertretung.
%R
Entspricht "%H:%M", z. B. "13:23".
%r
Entspricht "%I:%M:%S %p", z. B. "01:23:45 PM".
%S
Entspricht der zweiten Zahl als Dezimalzahl (00-60).
%T
Entspricht "%H:%M:%S", z. B. "13:26:47".
%U
Stimmt mit der Wochennummer des Jahres (Sonntag als erster Wochentag) als Dezimalzahl (00-53) überein.
%v
Entspricht "%e-%b-%Y", z. B. "25-Juli-2013".
%Y
Entspricht dem Jahr mit dem Jahrhundert als Dezimalzahl, z. B. "2013".
%y
Entspricht dem Jahr ohne Jahrhundert als Dezimalzahl (00-99).
%Z
Stimmt mit dem Zeitzonennamen überein.
%%
Stimmt überein "%".

Sprachkennung

Die folgende Tabelle enthält die Sprachenkennungen für jede unterstützte Sprache. Sie können diese Bezeichner als Werte für das optionale Attribut "language"in den folgenden Vorlagen-Tags verwenden:
Sprache
Sprach-ID
Bulgarisch (Bulgarien)
bg_BG
Chinesisch (China)
zh_CN
Chinesisch (Hongkong)
zh_HK
Chinesisch (Singapur)
zh_SG
Chinesisch (Taiwan)
zh_TW
Tschechische Republik
cs_CZ
Dänisch (Dänemark)
da_DK
Niederländisch (Belgien)
nl_BE
Niederländisch (Niederlande)
nl_NL
Englisch (Australien)
en_AU
Englisch (Kanada)
en_CA
Englisch (Großbritannien)
en_GB
Englisch (USA)
en_US
Französisch (Belgien)
fr_BE
Französisch (Kanada)
fr_CA
Finnisch (Finnland)
fi_FI
Französisch (Frankreich)
fr_FR
Französisch (Schweiz)
fr_CH
Deutsch (Österreich)
de_AT
Deutsch (Deutschland)
de_DE
Deutsch (Schweiz)
de_CH
Griechisch (Griechenland)
el_GR
Irish Gäelic (Irland)
ga_IE
Italienisch (Italien)
it_IT
Japanisch (Japan)
ja_JP
Koreanisch (Korea)
ko_KR
Norwegisch (Norwegen)
no_NO
Polnisch (Polen)
pl_PL
Portugiesisch (Brasilien)
pt_BR
Portugiesisch (Portugal)
pt_PT
Russisch (ehemalige Sowjetunion)
ru_SU
Slowakisch (Slowakei)
sk_SK
Slowakisch (Slowenien)
sl_SI
Spanisch (Mexiko)
es_MX
Spanisch (Spanien)
es_ES
Schwedisch (Schweden)
sv_SE

Content-Type HTTP-Header angeben

Sie können den Content-Type HTTP-Antwortheader mithilfe des folgenden Tags angeben:
<search-content-type-header [content="MIME-type"] [charset="charset-name"]>
Die Attribute content und charset Attribute sind optional. Dieses Tag sollte so früh wie möglich in der Vorlage erscheinen. Es wird außerdem empfohlen, dass sie vor oder <search-html-meta-charset> <search-xml-decl> vor den Tags angezeigt wird, da sie sich auf das Verhalten dieser Tags auswirken.
Wenn Sie das content Attribut nicht angeben, wird für den Wert MIME-type standardmäßig der Wert unter Settings > Crawling > Content Types festgelegt. Wenn Sie ein content Attribut angeben, wird es als Standard- content Attribut für das <search-html-meta-charset> -Tag verwendet.
Wenn Sie das charset Attribut nicht angeben, wird kein charset Wert in die content-type Kopfzeile geschrieben.
Wenn Sie charset="1" dann den tatsächlichen Wert für charset-name den Wert des sp_f CGI-Parameters angeben. Wenn bei der Suche kein sp_f CGI-Parameter gesendet wird, wird der eigentliche Wert für aus Ihren Kontoeinstellungen gelesen charset-name . Sie können den mit Ihrem Konto verknüpften Zeichensatz unter Settings > My Profile > Personal Information > Character Encoding .
Sie können einen bestimmten Zeichensatznamen auswählen, indem Sie ihn als charset Wert angeben, "Gefällt mir" charset="iso-8859-1" oder charset="Shift-JIS" .
Wenn Sie ein charset Attribut angeben, wird es als Standard- charset Attribut für die <search-html-meta-charset> und <search-xml-decl> -Tags sowie als Ausgabe in der content-type Kopfzeile verwendet.

Festlegen eines Zeichensatzes in einer HTML-Vorlage

Die standardmäßigen HTML-Suchergebnisvorlagen geben den mit dem aktuellen Konto verknüpften Zeichensatz über das folgende Tag an:
<search-html-meta-charset [content="MIME-type"] [charset="charset-name"]>
Die Attribute für Inhalt und Zeichensatz sind optional. Dieses Tag muss im HTML- <head> Abschnitt der Vorlage angezeigt werden. Dieses Tag ergibt das folgende Tag auf der HTML-Seite, die aus der Vorlage generiert wurde:
<meta http-equiv="content-type" content="MIME-type; charset=charset-name">
Wenn Sie das Inhaltsattribut nicht angeben, wird als tatsächlicher Wert von MIME-type standardmäßig einer von zwei Werten verwendet. Wenn das <search-content-type-header> Tag ein content Attribut angegeben hat, wird dieser Wert verwendet. Andernfalls wird der Wert verwendet, der auf der Registerkarte Templates > Settings > Content Type festgelegt wurde.
Wenn Sie das charset Attribut nicht angeben, wird als tatsächlicher Wert von charset-name standardmäßig einer von zwei Werten verwendet. Wenn das <search-content-type-header> Tag ein charset Attribut angegeben hat, wird dieser Wert verwendet. Andernfalls wird der tatsächliche Wert für aus Ihren Kontoeinstellungen gelesen charset-name . Sie können den mit Ihrem Konto verknüpften Zeichensatz unter Settings > My Profile > Personal Information > Character Encoding .
Wenn Sie charset="1" dann den tatsächlichen Wert für charset-name den Wert des sp_f CGI-Parameters angeben. Wenn bei der Suche kein sp_f CGI-Parameter gesendet wird, ist der tatsächliche Wert für charset-name entweder der im Tag festgelegte Wert oder der in Ihren Kontoeinstellungen festgelegte <search-content-type-header> Wert.
Sie können einen bestimmten Zeichensatznamen wie in charset="charset-name" angeben. For example, charset="iso-8859-1" or charset="Shift-JIS" .
Das <search-html-meta-charset> -Tag ist optional. Wenn Sie ihn entfernen, nimmt der Browser die Standardwerte für content-type Folgendes an: content="text/html; charset=ISO-8859-1" . Sie können auch festlegen, dass das <search-html-meta-charset> Tag durch ein eigenes http-equiv Tag ersetzt wird.

Festlegen eines Zeichensatzes in einer XML-Vorlage

Die Standard-XML-Suchergebnisvorlage gibt den Zeichensatz an, der dem aktuellen Konto mithilfe des folgenden Tags zugeordnet ist:
<search-xml-decl [charset="charset-name"]>
Das charset Attribut ist optional. Dieses Tag muss oben in der Vorlage, aber nach jedem <search-content-type-header> Tag erscheinen. Dieses Tag führt zum folgenden Tag im XML-Dokument, das aus der Vorlage generiert wurde:
<?xml version="1.0" encoding="charset-name" standalone="yes" ?>
Wenn Sie den Wert nicht angeben charset , wird als tatsächlicher Wert charset-name standardmäßig einer von zwei Werten verwendet. Wenn <search-content-type-header> ein charset Attribut angegeben wurde, wird dieser Wert verwendet. Andernfalls wird der tatsächliche Wert für aus Ihren Kontoeinstellungen gelesen charset-name . Sie können den mit Ihrem Konto verknüpften Zeichensatz unter Settings > My Profile > Personal Information > Character Encoding .
Wenn Sie charset="1" dann den tatsächlichen Wert für charset-name den Wert des sp_f CGI-Parameters angeben. Wenn bei der Suche kein sp_f CGI-Parameter gesendet wird, ist der tatsächliche Wert für charset-name entweder der Wert, der im <search-content-type-header> -Tag festgelegt wurde, wenn er angegeben wurde, oder der Wert, der in Ihren Kontoeinstellungen festgelegt wurde.
Sie können einen bestimmten Zeichensatznamen wie in angeben, charset="charset-name" wenn Sie dies wünschen. Beispiel, charset="iso-8859-1" or charset="Shift-JIS" .
Sie können das <search-xml-decl> Tag durch ein eigenes ?xml Tag ersetzen.

Hinzufügen einer Suchvorlage in einer anderen

Um eine Suchvorlage in eine andere einzuschließen, verwenden Sie das <search-include> -Tag und legen Sie das Dateiattribut auf den Namen der Vorlagendatei fest, die Sie einschließen möchten, wie im folgenden Beispiel:
<search-include file="seo/seo_search_title.tpl" />
SEO-Suchvorlagensegmente befinden sich im seo/ Unterordner und normale Suchvorlagen befinden sich im templates/ Unterordner. Nur .tpl-Dateien sind aussagekräftig, um sie in diesen Kontext einzubeziehen.

Verwalten mehrerer Transportvorlagen für Ihre Website

Sie können das Erscheinungsbild der Suchergebnisse auf Ihrer Website steuern, indem Sie für jeden Bereich verschiedene Suchtransportvorlagen verwenden.
Um diese Art von Suchfunktion zu erreichen, können Sie Ihre Transportvorlagen in Site-Suche/Merchandising verwalten. Sie können auch Ihre Transportvorlagen in Publish verwalten. Wie beim Suchen/Merchandising auf der Site können Sie mit "Veröffentlichen"mehrere Suchtransportvorlagen bearbeiten, in der Vorschau anzeigen und veröffentlichen.
Verwenden Sie den sp_t Abfrageparameter, um Ihre Suchformulare so einzurichten, dass sie eine bestimmte Transportvorlage verwenden (die nicht standardmäßig verwendet wird). Angenommen, Sie haben eine Suchvorlage namens "Freigabe"für den markierten Verkaufsbereich Ihrer Website. Sie verwenden das standardmäßige HTML-Suchformular mit dem folgenden zusätzlichen Formularcode:
<input type=hidden name="sp_t" value="clearance">
Wenn ein Kunde auf ein Standardformular klickt, das diese Codezeile enthält, wird die Suchtransportvorlage mit den Suchergebnissen angezeigt.