Vorlagen

Vorlagen

Präsentationsvorlagen-Tags

Eine Liste von Site-Suchen/Merchandising-Tags und -Attributen 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.

Siehe Vorlagen.

Sie können aus den folgenden Präsentations-Tag-Gruppen auswählen:

Deklarationen

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-declare>

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 Content-Type 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 ergibt die folgende Ausgabe in Ihrem XML-Dokument:

<?xml version="1.0" encoding="charset-name" standalone="yes" ?>

Ergebnisse

Tag

Beschreibung

3

<guided-results></guided-results>

Das Tag mit geführten Ergebnissen definiert die Grenzen einer Ergebnisschleife. Auf alle Ergebnisse kann zugegriffen werden, indem ein gsname -Attribut angegeben wird. Wenn kein gsname angegeben ist, werden die Standardsuchergebnisse angezeigt.

2

<guided-result-link></guided-result-link>

Um einen Link zu einem bestimmten Ergebnis zu erstellen, verwenden Sie das Tag guided-result-link . Durch Definieren des Attributs gsname 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. class und Zielgruppe, können ebenfalls übergeben werden, die im resultierenden Anker-Tag ausgegeben werden.

3

<guided-result-img gsname="fieldname">

Das <guided-result-img> -Tag hilft beim Erstellen von Bild-Tags, anstatt Variablen in ein unbearbeitetes -img -Tag einzubetten.

Geben Sie das für den Bildpfad zu verwendende Feld im Attribut gsname an. Das Ergebnis ist ein img -Tag mit allen standardmäßigen HTML-Attributen, die Sie definiert haben und die übergeben wurden. Das folgende Beispiel:

<guided-result-img gsname="thumbnail"  class="thumb" border="0"/>%20%3C/code%3E%20%3C/p%3E%20%3Cp%3Ebecomes:%20%3C/p%3E%20%3Cp%3E%20%3Ccode%20class=?lang=de"syntax html"> <img src="prod8172.jpg" class="thumb"  border="0"/>%20%3C/code%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%3C/tr%3E%20%20%20%3Ctr%3E%20%20%20%20%3Ctd%20colname=?lang=de"col01">

4

<guided-result-field gsname="fieldname">

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 ein. 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></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 "true"ist, wird am Ende des Ergebnisses HTML hinzugefügt, um die Zeile abzuschließen und eine neue Beginn zu erstellen. 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>

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>

Gibt die Gesamtanzahl der Ergebnisse im angegebenen Ergebnissatz zurück. Geht von der Standardsuche aus, wenn kein gsname angegeben wird.

9

<guided-results-lower>

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>

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;/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 Felds für die Titeltransportvorlage an, das mit -Transport-Tag angegeben wird.

13

<guided-result-description />

Das <guided-result-description> -Tag gibt den Wert des mit <description> -transport-Tags angegebenen Felds der Beschreibungstransportvorlage an.

14

<guided-result-loc />

Das < -Tag guided-result-loc> gibt den Wert des Felds der LOC-Transportvorlage an, das mit <loc> -Transport-Tag angegeben wird.

15

&amp;lt;/guided-if-result-field&amp;gt;   &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"/>%20%20%20%20%20%20%20<guided-else-result-field>%20%20%20%20%20%20%20     <img src=?lang=de"nothumb.jpg" class="nothumb"/>%20%20%20%20%20%20%20</guided-if-result-field>%20%3C/code%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%3C/tr%3E%20%20%20%3Ctr%3E%20%20%20%20%3Ctd%20colname=?lang=de"col01">

16

<guided-result-attribute-table gsname="tablename">

Dieses Tag stellt eine Schleife durch die Attributtabelle bereit, die in der Transportvorlage mit dem Tag 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 plain guided-result-field innerhalb der Schleife für die Anzeige anderer Ergebnisfelder zu verwenden.

17

<guided-result-attribute-table-field gsname="fieldname">

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;&amp;lt;li&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;a&amp;nbsp;href=&quot;&amp;lt;guided -attribute-table-field&amp;nbsp;gsname=&quot;download_link&quot;&amp;nbsp;/&amp;gt;&quot;&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;guided-result-attribute-table-field&amp;nbsp;gsname=&quot;geleitet download_title&quot;&amp;nbsp;/&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&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;
&amp;gt;&amp;lt;/guided-result-attribute-table&amp;gt;

&amp;lt;/ul&amp;gt;

..

&amp;lt;/guided-results&amp;gt;   &lt;/p>  &lt;/td>

18

<guided-trace>

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 ist, wird default 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 Über Facets.

Weitere Informationen finden Sie unter Info zu Facet Rail.

Siehe Dynamische Facets.

Tag

Beschreibung

1

<guided-dynamic-facets></guided-dynamic-facets>

Ein Schleifenkontext für dynamische Facetten einer bestimmten Suche.

Das <guided-facet> -Tag der 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.

Das folgende Beispiel zeigt eine Facettenleiste:

<guided-facet-rail>   <guided-facet>     <guided-facet-display-name/>     ...     </guided-facet>   </guided-facet-rail>

Beachten Sie, dass folgende Tags das Attribut gsname nicht benötigen, wenn sich innerhalb des <guided-facet-rail> -Tags ein Wert befindet, da dieser zum Suchzeitpunkt 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 Seite Facet Rail bestimmen die Position der Facetten. Sie können die Sortierreihenfolge aus der Dropdown-Liste "Facets-Sortiermethode"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 die Aktion Push-Facette X in der Facet-Leiste '_dynamic_facets' angezeigt, um Y zu positionieren."

Weitere Informationen finden Sie unter Info zu Facet Rail .

Siehe auch Über dynamische Facets .

4

<guided-facet gsname=" facetname " height=" 60px " width=" 120px "></guided-facet>

Verwenden Sie das Tag mit einer geführten Facette , 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. Wenn sich der Name jedoch außerhalb der Facette befindet, können Sie den Namen nur ausblenden, wenn ein -Tag oder ein -Tag mit einem geführten-falls-facet-visible -Tag um ihn herum umschlossen ist.

5

<guided-if></guided-if>

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 Benutzeroberflächenelement 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 Kontexts eines Blocks mit dem Namen guided-facet verwenden, indem Sie direkt über das Attribut gsname auf eine bestimmte Facette verweisen.

<guided-if-facet-long gsname="category">     The category facet is very long! </guided-if-facet-long>

6

<guided-if></guided-if>

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 Kontexts eines Blocks mit dem Namen guided-facet verwenden, indem Sie direkt über das Attribut gsname auf eine bestimmte Facette verweisen.

<guided-if-facet-selected gsname="category">     The category facet is selected! </guided-if-facet-selected>

7

<guided-if></guided-if>

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 Kontexts eines Blocks mit dem Namen guided-facet verwenden, indem Sie direkt über das Attribut gsname auf eine bestimmte Facette verweisen.

<guided-if-facet-single gsname="category">     There is only one value in the category facet! </guided-if-facet-single>

8

<guided-if></guided-if>

Dieses Bedingungs-Tag ist "true", wenn die Facette mehrseitig ausgewählt ist. Verwenden Sie das Tag, um die Anzeige der Facette innerhalb der Tags <guided-facet-rail> oder <guided-dynamic-facets> zu ä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;&amp;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;/p>  &lt;/td>

9

<guided-facet-values> facetname "]></guided-facet-values>

Dies ist das Tag des Iterators für den Facettenwert. Sie können sie im Kontext eines Blocks mit dem Namen guided-facet definieren. In diesem Fall können Sie gsname weglassen. Sie können sie auch außerhalb eines beliebigen geführten-facets -Blocks definieren. Das -gsname -Attribut muss jedoch angegeben werden, welche Facettenwerte angezeigt werden.

Sie können dieses Tag auch verwenden, um die Facettenwerte außerhalb des Kontexts eines mit dem Namen geführten Facets 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>

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></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;/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

<guided-if-facet-long [gsname="facetname"]> <guided-else-facet-long></guided-if-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 Benutzeroberflächenelement 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 Kontexts eines Blocks mit dem Namen guided-facet verwenden, indem Sie direkt auf eine bestimmte Facette verweisen, indem Sie das gsname -Attribut verwenden.

<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 Kontexts eines Blocks mit dem Namen guided-facet verwenden, indem Sie direkt über das Attribut gsname auf eine bestimmte Facette verweisen.

<guided-if-facet-selected gsname="category">      The category facet is selected! </guided-if-facet-selected>

18

<guided-if-facet-single [gsname="facetname"]> <guided-else-facet-single></guided-if-facet-single>

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 Kontexts eines Blocks mit dem Namen guided-facet verwenden, indem Sie direkt auf eine bestimmte Facette verweisen, indem Sie das gsname -Attribut verwenden.

<guided-if-facet-single gsname="category">      There is only one value in the category facet! </guided-if-facet-single>

19

<guided-if-facet-has-values [gsname="facetname"]> <guided-else-facet-has-values></guided-if-facet-has-values>

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=" associated custom facet value ">

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> 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>

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-children></guided-facet-value-children>

Während <guided-facet-values> durch jeden Facettenwert iteriert wird, 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-Children> zu 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;/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;/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> , wodurch die Auswahl aller ausgewählten Werte aufgehoben wird.

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 guided-facet-values -Schleife.

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 zum Erstellen Ihres eigenen Rückgängig-Links gibt.

32

<guided-if-facet-value-matches facetname="facetname" value="value"><guided-else-facet-value-matches> </guided-if-facet-value-matches>

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-behavior gsname=" facetname " />

Legen Sie das Verhalten einer Facette fest, z. B. normal, sticky oder multi-select. 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;/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

Siehe Info zu Breadcrumbs.

Tag

Beschreibung

3

<guided-breadcrumb> breadcrumbname "]></guided-breadcrumb>

Das Schleife-Tag für den Breadcrumb. Alle zwischen öffnenden und schließenden Tags liegenden Inhalte werden für jede Abfrage des aktuellen Status iteriert.

Wenn gsname weggelassen wird, wird die Breadcrumb namens "default"verwendet.

2

<guided-breadcrumb-link></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. Sie wird nur im Kontext eines guided-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. Sie wird nur im Kontext eines guided-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. Sie wird nur im Kontext eines guided-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>

Wird zum Erstellen eines eigenen Breadcrumb-Links verwendet.

Menüs

Siehe Menüs.

Tag

Beschreibung

3

<guided-menu gsname="menuname"></guided-menu>

Dies ist das Menü-Wert-Schleifeniterator-Tag. Verwenden Sie das Attribut gsname , um herauszufinden, welcher Satz von Menüelementen angezeigt wird.

2

<guided-menu-item-link></guided-menu-item-link>

Gibt Ihnen die URL zum Verfeinern der aktuellen Suche nach dem Menüelement.

1

<guided-menu-item-option>

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 mit dem Menü verknüpften Werts zurück.

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></guided-page-link>

Erstellt einen Link in der Seitennavigation.

3

<guided-page-link gsname="first|prev|next|last|viewall|viewpages"></guided-page-link>

Erstellt einen Link zur ersten, vorherigen, nächsten oder letzten Seite. Sie können auch einen Link zur Ansicht aller Seiten auf einer Seite erstellen.

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 zur Ansicht aller Ergebnisse Angebot haben. Daher können Sie diesen Satz bedingter Tags verwenden, um zu bestimmen, wann der Link "Ansicht - Alle"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 "Ansichten-Seiten"angezeigt werden soll. Es wird normalerweise verwendet, um einem Kunden die Ansicht bestimmter Seiten zu ermöglichen.

10

&amp;lt;guided-else-page-link&amp;gt;
&amp;lt;/guided-if[-not]-page-link&amp;gt;   &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 geführte Paginierung , um einen Bereich zu definieren, in dem alle Paginierungs-Tags mit einer bestimmten Paginierungseinstellung in Verbindung stehen, falls Sie nur wenige Seitennavigationseinstellungen definiert haben.

13

next|last|viewall|viewpages&rbrack;/&amp;gt;   &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.

Kürzliche 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>

Siehe Konfigurieren aktueller Suchvorgänge.

Tag

Beschreibung

1

<guided-recent-searches></guided-recent-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-recent-searches-path />

Ermöglicht Ihnen das Abrufen des relativen URL-Pfads für eine kürzlich durchgeführte Suche in einer geführten/kürzlich durchgeführten Suche -Schleife. Normalerweise würden Sie guided-previous-search-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-recent-searches-value>

Ermöglicht die Erfassung des Begriffs "Abfrage", der mit einer kürzlich durchgeführten Suche verknüpft ist.

5

<guided-recent-searches-clear-link></guided-recent-searches-clear-link>

Ermöglicht Ihnen das Angebot Ihrer Kunden, kürzlich gespeicherte Suchen zu löschen.

6

<guided-recent-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;/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>

Siehe Info zu „Meinten Sie“.

Tag

Beschreibung

3

<guided-suggestions></guided-suggestions>

Dies ist das Schleife-Tag für Schleifen über die Vorschläge.

2

<guided-suggestion-link></guided-suggestion-link>

Erstellt einen Link zu der angegebenen Empfehlung.

1

<guided-suggestion-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-suggestion-path />

Gibt die Pfadzeichenfolge für die Empfehlung zurück. Sie können es verwenden, um ein eigenes Anker-Tag zu erstellen. Normalerweise wird guided-recommendations-link stattdessen verwendet.

6

<guided-suggestion />

Ein Vorschlag.

7

<guided-suggestion-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-suggestion-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>

Automatische Vervollständigung

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.

Siehe Info zum automatischen Ausfüllen.

Tag

Beschreibung

3

<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 automatisch ausgefüllten Tags 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.

Speicher

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.

1

<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">

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 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.

Schleifenindikatoren

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

3

<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. Wenn sich der Site-Besucher auf Seite 2 eines Ergebnissatzes befindet, 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). Wenn sich der Site-Besucher auf Seite 1 eines Ergebnissatzes befindet, der 200 Ergebnisse enthält, aber nur 10 Ergebnisse pro Seite hat, lautet die letzte Iteration result 10 anstelle von result 200.

1

<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

3

<guided-current-path>

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 Parameter für die Abfrage. Wenn keine anderen Parameter für die Abfrage 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 Beginn Ihrer href und fügen Sie einen Parameter hinzu.

<a href="/">All Products</a> Would create a link "All Products" to your basepath, for example https://search.mycompany.com/

1

<guided-query-param gsname="query_parameter">

Ermöglicht das Erfassen des vorhandenen Werts eines Abfrage-Parameters, der sich auf 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-Abfrage-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-Abfrage-param&amp;nbsp;gsname=&quot;lang&quot;&amp;nbsp;
&amp;nbsp;

gibt&amp;nbsp;g;g;g;g;g;g;g;g&amp;nbsp;g;g;g;g;g;gsname=&quot;g;g;g;g;g;g;g;g;g;g;g&amp;nbsp;g&amp;nbsp;g&amp;nbsp;g;g&amp;nbsp;g;g;g;g;g;g;g;g;g;g;g;g;g;g;g;g;g;g;g;g;g;g;
nbsp;g;g;g;g;g;g;g;g;g you&amp;nbsp;the&amp;nbsp;value&amp;nbsp;en
&amp;lt;guided-Abfrage-param&amp;nbsp;gsname=&quot;test&quot;&amp;nbsp;/&amp;gt;
gibts&amp;nbsp;you&amp;nbsp;an&amp;nbsp;empty&amp;nbsp;string&amp;nbsp;&amp;nbsp;&amp;nbsp; p;&amp;nbsp;&amp;nbsp;&amp;nbsp;   &lt;/p>  &lt;/td>

4

<guided-query-param-name gsname="param#" offset="offset_number" />

Die geführte Suche hat den Begriff einer Abfrage, die im Breadcrumb-Steuerelement verwendet wird. Mit guided-Abfrage-param-name können Sie Parameter als Teil eines Links in der Präsentationsvorlage definieren, bei dem die geführte Suche die richtige Abfrage für Sie ermittelt. Das gsname enthält ein "x", das durch die geführte Suche durch die richtige Zahl ersetzt wird. Der Versatzwert kann zwischen 0 und 15 liegen, wobei 0 bedeutet, dass die nächste verfügbare Abfrage verwendet wird. Eine 1 gibt an, dass Sie 1 hinzufügen möchten usw.

In Kombination mit geführte-current-path 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 badcrumbs und facets eingeschlossen:

<guided-include gsfile='breadcrumbs.tmpl' /> <guided-include gsfile='facets.tmpl' />

Dynamische Includes werden nicht unterstützt. Das heißt, 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 die erste Suche durchführen (die Abfrage ist 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>

Die Guided Search Engine, die die Vorlage steuert, hat die Vorstellung von Gleitkommazahlen, bei denen jeder neue Link, den die Engine generiert, die nächste verfügbare Abfrage verwendet. Mit diesem Tag können Sie die Anzahl der nächsten Abfragen oder Offsets erfassen, sodass Sie benutzerspezifische Links erstellen können, die in die Ergebnismenge vordringen. Mit dem Offset können Sie die nächste Abfrage einstellen. Wenn Sie beispielsweise eine Facette ausgewählt haben, ist die nächste Abfrage 2, bei einem Offset von 1 ist die zurückgegebene Abfrage 3.

17

<guided-custom-var gsname="custom_variable">

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 (Abfrage bereinigen, Vorsuchverarbeitung und Nachsuchverarbeitung).

19

<guided-general-field gsname="searchname" field="fieldname">

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">

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">

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"/>%20%3C/code%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%3C/tr%3E%20%20%20%3Ctr%3E%20%20%20%20%3Ctd%20colname=?lang=de"col01">

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, festzustellen, ob Geschäftsregeln auf eine Adobe Target -Kampagne verweisen. Es wird normalerweise im Rahmen der Integration mit Adobe Target verwendet, um zu verhindern, dass die -Zielgruppe -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.

Siehe Bearbeiten einer Präsentation oder einer Transportvorlage.

Siehe Suchvorlagen-Tags.

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 definieren, die Sie mit dem Tag general-field verwenden möchten, 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 Beginn und endet, wie im folgenden Beispiel:

<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=",">

Das -Trennzeichen ermöglicht die Änderung des Trennzeichens, das verwendet wird, wenn Sie Daten aus dem Suchfeld für Listen ausgeben. Die Standardeinstellung ist ein Komma.

Im Allgemeinen sollte das verwendete Trennzeichen etwas sein, das im Feldinhalt nicht leicht angezeigt wird.

<suggestions></suggestions>

Schließen Sie Ihre "Meinten Sie"-Vorschläge mit Tags ein, damit die geführte Suche erkennt, welche XML-Knoten Vorschläge enthalten.

Siehe Info zu „Meinten Sie“.

<suggestion></suggestion>

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>

Siehe Info zu „Meinten Sie“.

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.

NOTE

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 - Schleifentags

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:

Ergebnisse-Schleife-Zeichenfolgen-Tags

Die folgenden Tags geben eine Zeichenfolge zurück.

Siehe Informationen zu den Tags der Ergebnisschleife.

Tag

Beschreibung

3

<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 Attribut encoding bestimmt, 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-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 ein Rangfeld unter Optionen > Metadaten > Definitionen definiert haben, können Sie den dynamischen Seitenstrang anzeigen, indem Sie das rank-Attribut auf dynamisch ( <search-score rank="dynamic"> ) setzen. Sie können den Rang der statischen Seite anzeigen, indem Sie das Rang-Attribut auf statisch ( <search-score rank="static"> ) setzen. 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 "Dokument-Sprache 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 Attribut length , um die Länge der angezeigten Zeichenfolgen zu begrenzen, wobei die Standardeinstellung unbegrenzte Zeichen ist.

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 Abfrage einschließlich des Fragezeichens der URL des aktuellen Ergebnisses zurück.

Verwenden Sie das optionale Attribut length , um die Länge der angezeigten Zeichenfolgen zu begrenzen, wobei die Standardeinstellung unbegrenzte Zeichen ist.

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 Attribut length , um die Länge der angezeigten Zeichenfolgen mit einer Standardlänge von 80 Zeichen zu beschränken. 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" units="miles/kilometers" separator="|">

Dieses erweiterte Tag zeigt den Inhalt des Metadatenfelds (URL, Titel, Desc, Schlüssel, Zielgruppe, Textkörper, Alt, Datum, Zeichensatz und Sprache oder Felder, die unter Optionen > Metadaten > Definitionen definiert sind) an, das für das aktuelle Ergebnis im Attribut name angegeben ist. 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 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 auf yes und steuert, ob der Zeitabschnitt der Datums-Zeichenfolge in GMT ( yes ) oder in der Zeitzone des Kontos ( no ) ausgegeben wird.

Siehe Datumsformat-Zeichenfolgen.

Das -Attribut language steuert die Konventionen für Sprache und Gebietsschema der Ausgabedatumszeichenfolge. 0 (Standard) bedeutet "Kontosprache verwenden". 2 bedeutet "Dokument-Sprache verwenden". Die Sprache Wert 1 ist für die zukünftige Verwendung reserviert). Jeder andere -Wert wird als spezifischer Sprachbezeichner interpretiert, z. B. en_US bedeutet "Englisch (USA)".

Siehe Sprachkennungen.

Das optionale Attribut length wird verwendet, um die Länge der angezeigten Zeichenfolgen zu begrenzen, wobei der Standardwert 80 Zeichen ist.

Das optionale Attribut encoding bestimmt, 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.

Das optionale Attribut gibt an, ob die einzelnen Elemente von Anführungszeichen (oder einfachen Anführungszeichen, wenn encoding=perl ) umgeben sind. Der Standardwert von Anführungszeichen ist nein .

Das optionale Attribut Kommas bestimmt, ob die einzelnen Elemente durch Kommas getrennt werden. Der Standardwert von Kommas ist yes . Das -Komma -Attribut wird bei Feldern ohne Liste ignoriert.

Das optionale Attribut unit steuert die Entfernungseinheiten, die auf ein Ausgabefeld für die Suche nach der Nähe angewendet werden. Der Standardwert von Einheiten wird aus der Einstellung "Standardeinheiten"des Felds "Standort-Typ"bestimmt, das mit dem angegebenen Ausgabefeld für die Suche nach räumlicher Nähe verknüpft ist.

Siehe Näherungssuche.

Das optionale -Trennzeichen definiert das Einzelzeichen oder Trennzeichen, das zwischen den Werten der Ausgabe für Listen 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, Zielgruppe, Textkörper, Alt, Datum, Zeichensatz und Sprache oder Felder, die unter Optionen > Metadaten > Definitionen definiert sind) für das aktuelle Ergebnis. Verschachteln Sie dieses Tag nicht in einem anderen <search-display-field-values> -Tag. Das -Attribut gibt den Namen des Felds an, das die aufzuzählenden Werte enthält. Dieses Tag ist besonders nützlich bei Feldern, in denen das Attribut der Zulassungslisten markiert 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, title, desc, keys, Zielgruppe, body, alt, date, charset und language oder die unter Options > Metadata > Definitions definierten Felder) für die aktuelle <search-display-field-values>-Schleife aus. Dieses Tag ist nur innerhalb einer <search-display-field-values> -Schleife gültig. Die Attribute des Datumsformats , gmt und und sind nur relevant, wenn der Inhaltstyp des im umschließenden <a7/>-Tag <a7/> angegebenen Feldnamens datums <a9/> ist. Das -Datumsformat nimmt eine Datumsformat-Zeichenfolge im UNIX-Stil wie "%A , %B %d , %Y "(für "Montag, 25. Juli 2016"). Das Attribut gmt ist standardmäßig auf yes festgelegt und steuert, ob der Zeitabschnitt der Datums-Zeichenfolge in GMT ( yes ) oder in der Zeitzone des Kontos ( no ) ausgegeben wird.

Das -Attribut language steuert die Konventionen für Sprache und Gebietsschema der Ausgabedatumszeichenfolge. 0 (Standard) bedeutet "Kontosprache verwenden". Jeder andere -Wert wird als spezifischer Sprachbezeichner interpretiert, z. B. en_US bedeutet "Englisch (USA)".

Das optionale Attribut encoding bestimmt, 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.

14

<search-display-field-value-count name="field-name">

Gibt die Gesamtanzahl der Werte im aktuellen Ergebnis für das Metadatenfeld aus (URL, Titel, Desc, Schlüssel, Zielgruppe, Textkörper, Alt, Datum, Zeichensatz und Sprache oder Felder, die unter Optionen > Metadaten > Definitionen definiert sind), die mit dem Namensattribut angegeben wurden. Dieses Tag kann an einer beliebigen Stelle in der Ergebnisschleife erscheinen.

15

<search-display-field-value-counter>

Gibt den Zähler für die Ordinalschleife (1, 2, 3 usw.) für die aktuelle <search-display-field-values> 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 dann über eine Ausgabe, wenn sp_trace=1 mit den Hauptparametern für die Abfrage der Suche 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

3

<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> der Dokument-Titel den Text zurückgibt (oder nicht zurückgibt).

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> der Dokument aus der Beschreibung zurückgegeben wird (oder nicht zurückgegeben wird).

3

<search-if-bodytext> ... </search-if-bodytext>

<search-if-not-bodytext> ... </search-if-not-bodytext>

Diese Tags enthalten den HTML-Code zwischen ihnen, wenn beim nächsten Aufruf von <search-body-text> der Dokument-Textkö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 setzt das Attribut length bei jedem geschlossenen <search-context> -Tag außer Kraft.

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 setzt das Attribut length bei jedem geschlossenen <search-context> -Tag außer Kraft.

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 ein Feld vom Typ Rang unter Optionen > Metadaten > Definitionen definiert haben, können Sie den dynamischen Seitenstrang überprüfen, indem Sie das Attribut rank auf dynamisch ( <search-if-score-rank="dynamic" lower=XX top=YY> ) setzen. Sie können den Rang der statischen Seite überprüfen, indem Sie das Rang-Attribut auf statisch ( <search-if-score rank="static" lower=XX upper=YY> ) setzen.

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 in der Ergebnisschleife (zwischen <search-results> und </search-results> ).

Verankerungs-Link-Tags für die Ergebnisschleife

Siehe Informationen zu den Tags der Ergebnisschleife.

Tag

Beschreibung

3

<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 Zielgruppe-Attribut 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 Zielgruppe-Attribut 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.

1

<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 enthalten den Text zwischen ihnen, wenn das aktuelle Ergebnis das erste Ergebnis auf der Seite ist (oder nicht) (wenn es innerhalb von <a1/> verwendet wird) oder der erste Feldwert (wenn es innerhalb von <a3/> verwendet wird).

2

<search-if-last> ... </search-if-last>

<search-if-not-last> ... </search-if-not-last>

Diese Tags enthalten den Text zwischen ihnen, wenn das aktuelle Ergebnis das letzte Ergebnis auf der Seite ist (oder nicht) (wenn es innerhalb von <a1/> verwendet wird) oder der letzte Feldwert (wenn es innerhalb von <a3/> verwendet wird). Dieses Tag kann verwendet werden, um eine Trennlinie zwischen den Ergebnissen einzufügen. Dadurch wird beispielsweise ein <hr> -Tag zwischen den Ergebnissen 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 enthalten den Text zwischen ihnen, wenn das aktuelle Ergebnis weder das erste noch das letzte Ergebnis auf der Seite ist (wenn es innerhalb von <a1/> verwendet wird) oder nicht der erste oder letzte Feldwert ist (wenn es innerhalb von <a3/> 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 <a1/> verwendet wird) oder ein alternativer Feldwert (wenn es innerhalb von <a3/> 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 geraden Ergebnis ist (oder nicht) (wenn es innerhalb von verwendet wird) oder ein gerader Feldwert (wenn es innerhalb von <a3/> 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?

3

Erstes Ergebnis

Nein

Nein

2

Zweites Ergebnis

Ja

Ja

1

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> für Suchfeldwerte immer mit <search-if-alt> identisch ist, da Feldwerte nicht paginiert werden.

Liste der 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 sp-sfvl-field in der Abfrage "Suchen"angegeben werden.

Tag

Beschreibung

3

<search-field-value-list name="field-name" quotes="yes/no" commas="yes/no" data="values/counts/results" separator="X" sortby="none/values/counts/results" max-items="XX" date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none">

Dieses Tag zeigt eine Liste mit eindeutigen Feldwerten, Wertzählungen oder Ergebniszahlen innerhalb des gesamten Ergebnissatzes an.

Dieses Tag liefert nur die Ausgabe für Felder, die von den CGI-Parametern sp_sfvl_field in der Abfrage "Suchen"angegeben werden. Das optionale Attribut "Anführungszeichen"steuert, ob die einzelnen Elemente von 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 ohne Liste sind data="counts" und data="results" identisch. 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 Liste 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.

Siehe Datumsformat-Zeichenfolgen.

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".

Siehe Sprachkennungen.

2

<search-field-value-list-count name="field-name" value="field-value" results="yes/no">

Dieses Tag zeigt die Zählungsinformationen für eine bestimmte Liste des Suchfelds 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 ohne Liste 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 sp-sfvl-field in der Abfrage "Suchen"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-Liste-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 entsprechende Aufruf von <search-field-value-Liste-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.

Feldwert-Liste-Schleifentags

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 sp-sfvl-field in der Abfrage "Suchen"angegeben 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 Reihenfolge der Auflistungen: "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 Liste 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").

Siehe Datumsformat-Zeichenfolgen.

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)".

Siehe Sprachkennungen.

3

<search-field-value-count results="yes/no">

Dieses Tag gibt die mit der aktuellen <search-field-values> -Schleifenitation 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 ohne Liste 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.

NOTE

Der Suggest-Dienst funktioniert nicht für Chinesisch, Japanisch oder Koreanisch.

Tag

Beschreibung

3

<search-if-suggestions> ... </search-if-suggestions>

Umschließen Sie diese Tags mit beliebigen Vorlagen-Tags vom Typ "Vorschlagen", wie <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-suggestions> ... </search-suggestions>

Dieses Tag generiert die "Suggest"-Schleife, die eine Liste von vorgeschlagenen Suchbegriffen enthält (z. B. "beabsichtigen", "beabsichtigen" und "beabsichtigt" für eine Abfrage, die ursprünglich als "beabsichtigte" eingegeben wurde). Bei der Generierung der Liste von Begriffen wiederholt die Suchmaschine verschachtelte HTML- und/oder Vorlagen-Tags bis zum Fünffachen, was der maximalen Anzahl von 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 open und close <search-if-recommendations> -Tags.

3

<search-suggestion-link> ... </search-suggestion-link>

Dieses Tag generiert eine Verknüpfung zur ursprünglichen Suchbegriff-Abfrage, wobei der ausgewählte vorgeschlagene Suchbegriff anstelle des ursprünglichen Begriffs verwendet wird. Das Tag akzeptiert und druckt einfach jedes beliebige HTML-Attribut wie Klasse, Zielgruppe 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-suggestion-text />

Dieses Tag gibt den derzeit vorgeschlagenen Begriff für die Abfrage aus (z. B. "planen"für eine Abfrage, die ursprünglich als "beabsichtigte"eingegeben wurde). Das Tag hat keine Attribute und kann nur in der <search-recommendations> -Schleife angezeigt werden.

5

<search-if-not-suggestions> ... </search-if-not-suggestions>

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> ... </search-if>

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 Tags open und close <search-recommendations> stehen.

7

<search-if> ... </search-if>

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 Tags open und close <search-recommendations> stehen.

8

<search-suggestion-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-suggestion-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-suggestion-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

3

<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. hinzufügen Sie diesem Tag ein Hintergrundattribut, 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-cdata> ... </search-cdata>

Die Tags search-data werden durch ihre XML-Entsprechungen ersetzt: <search-cdata> wird durch <![CDATA[" und das </search-data> -Tag werden durch " ]]> "ersetzt. Ein XML-Parser analysiert keine Informationen zwischen dem open- und close-Tag.

4

<search-query query-number="XX" encoding="html/javascript/json/perl/url/none">

Die Abfrage, die der Besucher eingegeben hat. Das erweiterte, optionale Attribut "Abfrage-Nummer"steuert, welche Zeichenfolge für nummerierte Abfragen von diesem Tag ausgegeben wird. Beispiel: <search-Abfrage Abfrage-number=1> gibt den Inhalt des Parameters sp_q_1 cgi aus. Wenn "Abfrage-Nummer"nicht angegeben ist oder die Abfrage-Nummer "0"ist, wird die Hauptausgabe ( 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 query-number="XX">

Fügt ein Formulareingabe-Tag ein, das die Abfrage-Zeichenfolge angibt. Das erweiterte, optionale Attribut "Abfrage-Nummer"steuert, welche nummerierte Abfrage für das Formulareingabe-Tag verwendet wird. Beispiel: <search-input-Abfrage Abfrage-number=1> gibt ein Formulareingabe-Tag für die sp_q_1 -Abfrage aus. Wenn "Abfrage-Nummer"nicht angegeben ist oder "Abfrage-Nummer"den Wert "0"hat, wird ein Eingabetag für die Abfrage sp_q 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 dann über eine Ausgabe, wenn sp_trace=1 mit den Hauptparametern für die Abfrage der Suche angegeben wird.

Siehe Zeile 48 in der Tabelle unter CGI-Parameter für die Backend-Suche.

Vorlagenankerlink-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/, Sie können dies jedoch mithilfe des URL-Attributs ändern.

Tag

Beschreibung

3

<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-summaries>

<search-hide-summaries URL="https://search.yourdomain.com/search/"> ... </search-hide-summaries>

Blendet die Zusammenfassungen ein oder aus.

Vorlagen für bedingte Tags

Tags, die es Ihnen ermöglichen, HTML zwischen ihnen bedingt einzuschließen.

Tag

Beschreibung

3

<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-summaries>

<search-if-hide-summaries> ... </search-if-hide-summaries>

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 beinhalten HTML, wenn der CGI-Parameter sp_advanced=1 für die Abfrage der Suche 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.

Vorlagenformularsteuerungs-Tags

Tags, mit denen Sie den Standardauswahlstatus für Kontrollkästchen, Optionsfelder und Listen innerhalb eines <form> in der Suchvorlage 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 search-input und alle anderen Informationen im Tag werden unverändert ausgegeben. Wenn außerdem der im Tag angegebene Name als CGI-Parameter aufgelistet ist und der im Tag angegebene -Wert den Wert für diesen CGI-Parameter darstellt, wird am Ende des Tags das Wort , das markiert ist, 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 Übereinstimmung mit Geräuschen

Der entsprechende Vorlagencode für dieses Kontrollkästchen lautet wie folgt:

<search-input type="checkbox" name="sp_w" value="exact">Keine Übereinstimmung mit Geräuschen

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 (am Ende des Tags wird das Wort markiert eingefügt):

<input type="checkbox" name="sp_w" value="exact" checked="">Keine Übereinstimmung mit Geräuschen

Wenn die CGI-Parameterzeichenfolge für die Abfrage nicht sp_w=exact enthält, sieht das in den Browser mit den Suchergebnissen geschriebene Tag wie folgt aus (das Wort , das markiert ist, wird im Tag nicht aufgelistet):

<input type="checkbox" name="sp_w" value="exact">Keine Übereinstimmung mit Geräuschen

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 der <form> in Ihrer Suchvorlage hinzufügen möchten, verwenden Sie <search-input...> anstelle von <input...> .

2

<search-select> ... </search-select>

<search-option> ... </search-option>

Dropdown-Listen in einem <form> -Tag werden mit einem <select> -Tag gestartet und mit einem </select> -Tag beendet. Der -Name für den verknüpften CGI-Parameter wird im -Tag aufgelistet. Nach dem -Tag ist eine Liste von -Tags, die die Werte angeben, die im Feld "Liste"angezeigt werden sollen.

Die Tags <search-select> , </search-select> , <search-option> und </search-option> bieten eine ähnliche Funktionalität wie das <search-input> -Tag. Das heißt, das Wort ausgewählt wird automatisch am Ende des -Tags hinzugefügt, das an den Browser gesendet wird, wenn der -Name im <search-select> -Tag als CGI-Parameter aufgelistet ist und der -Wert des CGI-Parameters angegeben ist. als Wert in einem bestimmten <search-option> -Tag aufgeführt. Auf diese Weise können Sie die standardmäßige Liste in Ihrem Suchergebnis automatisch mit der aktuellen Abfrage identisch machen.

Ein typisches Feld für die Liste 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 das Feld "Liste"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 Listen-Felder haben, die Sie der <form> in Ihrer Suchvorlage hinzufügen möchten, verwenden Sie <search-select...> anstelle von , </search-select> <a7/> </select> <a7/>.9/>, <search-option...> anstelle von <option...> und </search-option> anstelle von </option> .

1

<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 Attribut count gibt die Anzahl der Ergebnisse an, die auf der Ergebnisseite angezeigt werden sollen. Wenn count 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 in Linguistik > Wörter und Sprachen > Sprache bestimmt die nationale Vertretung.

Siehe Info zu Wörtern und Sprachen.

%a

Entspricht der nationalen Darstellung des abgekürzten Wochentagsnamens, wobei die Abkürzung die ersten drei Zeichen (z. B. "Mon") umfasst. Die Einstellung in Linguistik > Wörter und Sprachen > Sprache bestimmt die nationale Vertretung.

Siehe Info zu Wörtern und Sprachen.

%B

Entspricht der nationalen Darstellung des vollständigen Monatsnamens, z. B. "Juni". Die Einstellung in Linguistik > Wörter und Sprachen > Sprache bestimmt die nationale Vertretung.

Siehe Info zu Wörtern und Sprachen.

%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 in Linguistik > Wörter und Sprachen > Sprache bestimmt die nationale Vertretung.

Siehe Info zu Wörtern und Sprachen.

%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

Stimmt mit dem Tag des Jahres als Dezimalzahl (001-366) überein.

%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 in Linguistik > Wörter und Sprachen > Sprache bestimmt die nationale Vertretung.

Siehe Info zu Wörtern und Sprachen.

%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 "%".

Sprachkennungen

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

Tschechisch (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ösich (Belgien)

fr_BE

Französisch (Kanada)

fr_CA

Finnisch (Finnland)

fi_FI

Französich (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 sowjetische Vereinigung)

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-Headerangeben

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 sind optional. Dieses Tag sollte so früh wie möglich in der Vorlage erscheinen. Es wird außerdem empfohlen, dass sie vor <search-html-meta-charset> oder <search-xml-decl> angezeigt wird, da dies das Verhalten dieser Tags beeinflusst.

Wenn Sie das Attribut content nicht angeben, wird für den Wert von MIME-type standardmäßig der Wert festgelegt, der unter Settings > Crawling > Content Types festgelegt wird. Wenn Sie ein content-Attribut angeben, wird es als standardmäßiges content-Attribut für das <search-html-meta-charset>-Tag verwendet.

Wenn Sie das Attribut charset nicht angeben, wird kein charset-Wert in die content-type-Kopfzeile geschrieben.

Wenn Sie charset="1" angeben, ist der tatsächliche Wert für charset-name der Wert des sp_f-CGI-Parameters. Wenn bei der Suche kein sp_f-CGI-Parameter gesendet wird, wird der tatsächliche Wert für charset-name aus Ihren Kontoeinstellungen gelesen. Sie können den mit Ihrem Konto verknüpften Zeichensatz unter Settings > My Profile > Personal Information > Character Encoding > <a3/> Ansicht oder ändern.

Siehe Konfigurieren Ihrer persönlichen Benutzerinformationen.

Sie können einen bestimmten Zeichensatznamen auswählen, indem Sie ihn als charset-Wert angeben, z. B. charset="iso-8859-1" oder charset="Shift-JIS".

Wenn Sie ein charset-Attribut angeben, wird es als standardmäßiges charset-Attribut für die <search-html-meta-charset>- und <search-xml-decl>-Tags verwendet und in die content-type-Kopfzeile ausgegeben.

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-Abschnitt <head> 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 der tatsächliche Wert von MIME-type standardmäßig auf einen von zwei Werten gesetzt. 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 Attribut charset 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 charset-name aus Ihren Kontoeinstellungen gelesen. Sie können den mit Ihrem Konto verknüpften Zeichensatz unter Settings > My Profile > Personal Information > Character Encoding > <a3/> Ansicht oder ändern.

Siehe Konfigurieren Ihrer persönlichen Benutzerinformationen.

Wenn Sie charset="1" angeben, ist der tatsächliche Wert für charset-name der Wert des sp_f-CGI-Parameters. Wenn bei der Suche kein sp_f-CGI-Parameter gesendet wird, ist der tatsächliche Wert für charset-name entweder der im <search-content-type-header>-Tag eingestellte Wert, falls er angegeben wurde, oder der Wert, der in Ihren Kontoeinstellungen festgelegt wird.

Sie können einen bestimmten Zeichensatznamen wie in charset="charset-name" angeben. Beispiel: charset="iso-8859-1" oder charset="Shift-JIS".

Das <search-html-meta-charset>-Tag ist optional. Wenn Sie sie entfernen, nimmt der Browser die Standardwerte für content-type an, und zwar die folgenden: content="text/html; charset=ISO-8859-1". Sie können auch festlegen, dass das <search-html-meta-charset>-Tag durch Ihr 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 Attribut charset 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 nicht charset angeben, wird der tatsächliche Wert von charset-name standardmäßig auf einen von zwei Werten gesetzt. Wenn <search-content-type-header> ein charset-Attribut angegeben hat, wird dieser Wert verwendet. Andernfalls wird der tatsächliche Wert für charset-name aus Ihren Kontoeinstellungen gelesen. Sie können den mit Ihrem Konto verknüpften Zeichensatz unter Settings > My Profile > Personal Information > Character Encoding > <a3/> Ansicht oder ändern.

Siehe Konfigurieren Ihrer persönlichen Benutzerinformationen.

Wenn Sie charset="1" angeben, ist der tatsächliche Wert für charset-name der Wert des sp_f-CGI-Parameters. 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 wird, wenn er angegeben wurde, oder der Wert, der in Ihren Kontoeinstellungen festgelegt wird.

Sie können einen bestimmten Zeichensatznamen wie in charset="charset-name" angeben, wenn Sie dies wünschen. Beispiel, charset="iso-8859-1" or charset="Shift-JIS".

Sie können das <search-xml-decl>-Tag durch Ihr eigenes ?xml-Tag ersetzen.

Hinzufügen einer Suchvorlage in einem anderen

Um eine Suchvorlage in eine andere einzuschließen, verwenden Sie das Tag <search-include> und setzen Sie das Dateiattribut auf den Namen der Vorlagendatei, die Sie einschließen möchten, wie im folgenden Beispiel dargestellt:

<search-include file="seo/seo_search_title.tpl" />

SEO-Suchvorlagensegmente befinden sich im Unterordner seo/ und normale Suchvorlagen befinden sich im Unterordner templates/. 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 die Site-Suche/das Merchandising können Sie mit "Veröffentlichen"mehrere Suchtransportvorlagen bearbeiten, Vorschauen erstellen und veröffentlichen.

Verwenden Sie den Parameter sp_t, 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.

Siehe Verwenden von Sammlungen in Suchformularen.

Siehe Verwenden von Frames mit Formularen.

Siehe Beispiel für ein erweitertes Suchformular.

Auf dieser Seite