Show Menu
SUJETS×

Modèles

Modèles

Balises de modèle de présentation

Liste des balises et attributs de recherche/marchandisage de site pour les modèles de présentation.
Un modèle de présentation est un fichier HTML qui comprend des balises de modèle de présentation définies par la recherche/le marchandisage sur le site. Ces balises indiquent le format des résultats de recherche affichés par les clients.
Vous pouvez sélectionner l’un des groupes de balises de présentation suivants :

Déclarations

Les déclarations sont des balises de déclaration guidée spéciales que vous pouvez définir en haut d’un modèle de présentation de niveau supérieur. Toutes les déclarations suivantes sont ignorées, y compris les déclarations dans les modèles inclus.
Baliser
Description
1
<guided-content-type-header content="content-type">
Par défaut, le modèle de présentation est renvoyé avec un type MIME de texte/html. Vous pouvez modifier le type de contenu utilisé avec cette balise.
Déclarez cette balise aussi haut que possible dans votre modèle de présentation. N’ajoutez pas d’autre texte sur la même ligne avec cette balise.
2
<guided-xml-statement [charset="charset"]>
Si vous renvoyez du code XML, vous pouvez utiliser cette balise pour créer la déclaration XML. Faites de cette balise la première ligne du modèle de présentation. Lorsque vous utilisez cette balise, le type de contenu est automatiquement défini sur text/xml, sauf si vous le remplacez par <guided-content-type-header> dans la première ligne. Si vous ne spécifiez pas de jeu de caractères, la valeur par défaut est UTF-8. Cette balise génère la sortie suivante dans votre document XML :
<?xml version="1.0" encoding="nom_jeu" standalone="yes" ?>

Résultats

Baliser
Description
1
<guided-results [gsname="searchname"]></guided-results>
La balise guided-results définit les limites d’une boucle de résultats. Tout jeu de résultats est accessible en spécifiant un attribut gsname . Si aucun nom de domaine n'est donné, les résultats de recherche par défaut s'affichent.
2
<guided-result-link [gsname="fieldname"] [attr="value"]+></guided-result-link>
Pour créer un lien vers un résultat donné, utilisez la balise de lien de résultat guidé. En définissant un attribut gsname , vous pouvez utiliser un champ de l’index au lieu de la balise "loc" standard qui fait référence à "search-url". Tous les autres attributs, tels que class et target, peuvent également être transmis, qui sont générés dans la balise d’ancrage résultante.
3
<guided-result-img gsname="fieldname" [attr="value"]+>
La balise <guided-result-img> permet de créer des balises d’image plutôt que d’incorporer des variables dans une balise img brute .
Spécifiez le champ à utiliser pour le chemin d’accès à l’image dans l’attribut gsname . Le résultat est une balise img avec tous les attributs HTML standard que vous avez définis, transmis. Ainsi, l’exemple suivant :
<guided-result-img gsname="thumbnail"  class="thumb" border="0"/>
becomes:
<img src="prod8172.jpg" class="thumb"  border="0"/>
4
<guided-result-field gsname="fieldname" [escape="html|url|js|json|ijson|0"]/>
Toute information à présenter dans les résultats s’affiche sous la forme d’une balise <guided-result-field> (sauf lors de l’utilisation de balises de génération automatique telles que la balise <guided-result-img> ).
Indiquez le nom du champ d’index de recherche dans gsname . La chaîne exacte transmise est générée dans le modèle.
Vous pouvez spécifier une option d’échappement si vous souhaitez que ce champ soit séparé de ce qui a été spécifié dans le modèle de transport.
Ce codage est appliqué au-dessus du codage spécifié dans le modèle de transport.
5
<guided-if[-not]-result-field gsname="nom_champ></guided-if-résultat-field>
Cet ensemble de balises conditionnelles est vrai s’il existe du contenu dans le champ spécifique à afficher. Si aucun contenu n’existe, la condition est false. Vous pouvez utiliser les balises pour décider si le code HTML environnant est affiché ou non si une valeur n’existe pas, ou si une autre image est affichée, etc.
<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>
Lors de l’affichage des résultats dans des colonnes, cette balise permet d’identifier si le résultat actuel marque la fin d’une colonne.
Lorsque la condition booléenne est vraie, du code HTML est ajouté à la fin du résultat pour terminer la ligne et en démarrer une nouvelle. Lorsqu’il s’agit de la dernière ligne, aucune nouvelle ligne n’est démarrée.
Voir <guided-if-not-last> pour en savoir plus sur cette balise.
<guided-if-result-wrap>      </div>      <guided-if-not-last>          <div>      </guided-if-not-last>  </guided-if-result-wrap>
7
<guided-results-found [gsname="searchname"]/>
Renvoie une valeur de 1 si la requête de recherche principale renvoyait des résultats et de 0 dans le cas contraire. Si aucun nom de domaine n’est spécifié, la balise suppose la recherche principale. Cette balise est utile pour transmettre la logique aux routines JavaScript.
8
<guided-results-total [gsname="searchname"]/>
Renvoie le nombre total de résultats dans l’ensemble de résultats spécifié. Suppose la recherche par défaut lorsqu’aucun nom gsname n’est donné.
9
<guided-results-lower [gsname="searchname"]/>
Renvoie le numéro de résultat du résultat inférieur sur la page pour le jeu de résultats spécifié. Suppose la recherche par défaut lorsqu’aucun nom gsname n’est donné.
10
<guided-results-upper [gsname="searchname"]/>
Renvoie le numéro de résultat du résultat supérieur sur la page pour le jeu de résultats spécifié. Suppose la recherche par défaut lorsqu’aucun nom gsname n’est donné.
11
&amp;lt;/guided-if[-not]-results-found&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Affiche le contenu lorsque les résultats sont trouvés. Ou, ne montre aucun résultat HTML lorsque les résultats sont introuvables.
<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/>
La balise <guided-result-title> donne la valeur du champ de modèle de transport de titre spécifié avec <title> balise de transport.
13
<guided-result-description/>
La balise <guided-result-description> donne la valeur du champ de modèle de transport de description spécifié avec <description> balise de transport.
14
<guided-result-loc/>
La balise < guided-result-loc> donne la valeur du champ de modèle de transport loc spécifié avec <loc> balise de transport.
15
&amp;lt;/guided-if-result-field&amp;gt; &lt;/code> &lt;/p> &lt;/td>

True s’il existe du contenu dans le champ spécifique à afficher. Si aucun contenu n’existe, la condition est false. Utilisez les balises pour déterminer si le code HTML environnant est affiché ou non si une valeur n’existe pas, ou si une autre image est affichée, etc.
<guided-if-result-field gsname="thumbnail">      <guided-result-img gsname="thumbnail" class="thumb"/> <guided-else-result-field>      <img src="nothumb.jpg" class="nothumb"/> </guided-if-result-field>
16
<guided-result-attribute-table gsname="nom_table">
Cette balise fournit une boucle à travers la table d’attributs définie dans le modèle de transport avec la balise de transport <attribute_table> . Il existe une balise <guided-result-attribute-table-field> pour afficher les valeurs de champ de table d’attributs. Il est également possible d’utiliser une balise de champ de résultats guidés ordinaire dans une boucle pour afficher d’autres champs de résultats.
17
<guided-result-attribute-table-field gsname="nom du champ" [escape="html|url|js|json|0"]/>
Affiche le champ de la table d’attributs tel que défini dans le modèle de transport.
...
    
    &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;
    &amp;nbsp;&amp;nbsp;nbsp;nbsp; sp;&amp;nbsp;&amp;lt;a&amp;nbsp;href=&quot;&amp;lt;guided-result-attribute-table-field&amp;nbsp;gsname=&quot;download_link&quot;&amp;nbsp;/&amp;gt;gt;gt;
    &amp;nbsp;&amp;nbsp;&amp;nbsp;;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;guided-result-attribute-table-field&amp;nbsp;gsname=&quot;download_title&quot;&amp;nbsp;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;/li&amp;;
    &amp;lt;/guided-result-attribute-table&amp;gt;&amp;lt;/ul&amp;gt;...
    
    &amp;lt;/guided-results&amp;gt; &lt;/code> &lt;/p> &lt;/td>

18
<guided-trace [gsname="nom_recherche"]/>
Génère les informations de trace trouvées dans les données de trace dans la section générale de la sortie des données JSON par le modèle de transport pour la recherche donnée.
Si aucun nom de recherche n’est spécifié, la valeur par défaut est utilisée.
19
<guided-result-trace/>
Génère le contenu JSON trouvé dans les résultats > informations de trace de la sortie de données JSON par le modèle de transport pour le résultat de recherche actuel.
Cette balise n’est valide que dans la boucle <guided-results></guided-results> .

Facettes

Les facettes sont des composants de navigation qui vous permettent d’analyser les résultats de la recherche. Vous pouvez utiliser les balises facet pour afficher diverses facettes sur votre modèle de présentation. Vous référencez les facettes par nom.
Voir A propos des facettes dynamiques.
Baliser
Description
1
<guided-dynamic-facets></guided-dynamic-facets>
Contexte de boucle pour toutes les facettes dynamiques d’une recherche donnée.
La balise de modèle de présentation <guided-facet> est modifiée de sorte que l’attribut gsname soit automatiquement fourni par le contexte de boucle <guided-dynamic-facets> .
2
<guided-facet-display-name gsname=" facetname "/>
Renvoie le libellé d’affichage de la facette.
Si la facette utilise la balise <display-name> sur le modèle de transport, le contenu de cette balise devient le libellé.
3
<guided-facet-rail></guided-facet-rail>
Définit une section du modèle de présentation utilisée comme modèle répété pour chaque facette du rail de facettes.
Chaque facette appartenant au rail de facettes utilise cette section pour évaluer sa sortie.
Voici un exemple de rail de facettes :
<guided-facet-rail>   <guided-facet>     <guided-facet-display-name/>     ...     </guided-facet>   </guided-facet-rail>
Notez que les balises suivantes n’ont pas besoin de l’attribut gsname lorsqu’elles se trouvent à l’intérieur de la balise <guided-facet-rail> comme une valeur déterminée dynamiquement au moment de la recherche et correctement substituée :
  • guidé-facette
  • guided-facet-display-name
  • guidé-facette-total-count
  • guided-facet-undo-link
  • guided-facet-undo-path
  • guidé-facette-comportement
Les critères de tri sur la page du rail de facettes déterminent la position des facettes. Vous pouvez choisir l’ordre de tri dans la liste déroulante Méthode de facettes de tri.
Cette balise peut éventuellement accepter une valeur d’attribut gsname de _dynamic_facets , qui fournit un contexte de boucle pour toutes les facettes dynamiques de cette recherche. Ce rail de facettes prédéfini est également exposé dans l’interface utilisateur des règles de fonctionnement pour que la facette Push X de l’action dans le rail de facettes '_dynamic_facets' soit positionnée Y ".
4
<guided-facet gsname=" facetname " height=" 60px " width=" 120px "></guided-facet>
Utilisez la balise de facette guidée pour définir une zone dans laquelle toutes les balises de facette se rapportent à une facette spécifique. Cette balise est également une balise booléenne qui masque tout le contenu s’il n’existe aucune valeur dans la facette. Dans ce cas, il n’y a aucun intérêt à extraire les valeurs de facette).
Les attributs de hauteur et de largeur sont facultatifs et les dimensions sont spécifiées en pixels (px). Le Créateur de règles visuel (VRB) utilise ces deux attributs et affiche une zone en pointillés sous forme d’espace réservé interactif lorsque la facette est masquée.
Lorsque le nom d’affichage se trouve dans la facette et que celle-ci est masquée, le nom est également masqué. Cependant, si le nom se trouve en dehors de la facette, vous ne pouvez masquer le nom que si une balise de zone ou une balise visible par -facette est entourée d’une balise .
5
<guided-if[-not]-facet-long [gsname="facetname"]></guided-if[-not]-facet-long>
Cette balise conditionnelle est vraie lorsque le nombre de valeurs de facette dépasse le seuil de longueur défini dans la configuration. Utilisez-la pour afficher une facette sous la forme d’un élément d’interface utilisateur différent (comme une liste tronquée ou une zone de défilement) lorsque la liste est trop longue.
<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>
Vous pouvez également utiliser cette condition en dehors du contexte d’un bloc de facettes guidées nommé en référençant une facette spécifique directement à l’aide de l’ attribut gsname .
<guided-if-facet-long gsname="category">     The category facet is very long! </guided-if-facet-long>
6
<guided-if[-not]-facet-selected [gsname="facetname"]></guided-if[-not]-facet-selected>
Cette balise conditionnelle est vraie lorsque l’utilisateur clique au moins une fois sur la facette et qu’une valeur de facette est actuellement sélectionnée. Il est utilisé pour afficher ou masquer les balises HTML ou gs selon qu’une facette a été cliquée ou non.
<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>
Vous pouvez également utiliser cette condition en dehors du contexte d’un bloc de facettes guidées nommé en référençant une facette spécifique directement à l’aide de l’ attribut gsname .
<guided-if-facet-selected gsname="category">     The category facet is selected! </guided-if-facet-selected>
7
<guided-if[-not]-facet-single [gsname="facetname"]></guided-if[-not]-facet-single>
Cette balise conditionnelle est vraie lorsqu’il n’existe qu’une seule valeur de facette. Utilisez la balise pour modifier l’affichage de la facette lorsqu’elle n’est pas en mesure d’affiner les résultats.
<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>
Vous pouvez également utiliser cette condition en dehors du contexte d’un bloc de facettes guidées nommé en référençant une facette spécifique directement à l’aide de l’ attribut gsname .
<guided-if-facet-single gsname="category">     There is only one value in the category facet! </guided-if-facet-single>
8
<guided-if[-not]-facet-multiselect [gsname="facetname"]></guided-if[-not]-facet-multiselect>
Cette balise conditionnelle est vraie lorsque la facette est à sélection multiple. Utilisez la balise pour modifier l’affichage de la facette à l’intérieur des balises <guided-facet-rail> ou <guided-dynamic-facets> .
&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;nbsp;&amp;lt;/guided-facet&amp;gt;
    &amp;nbsp;&amp;nbsp;&amp;lt;/guided-facet-rail&amp;gt; &lt;/code> &lt;/p> &lt;/td>

9
<guided-facet-values [gsname=" facetname "]></guided-facet-values>
Il s’agit de la balise d’itérateur de boucle de valeur de facette. Vous pouvez le définir dans le contexte d’un bloc de facettes guidées nommé, auquel cas vous pouvez omettre le nom de gsname . Vous pouvez également le définir en dehors de tout bloc de facettes guidées, mais l’ attribut gsname est nécessaire pour identifier le jeu de valeurs de facettes affiché.
Vous pouvez également utiliser cette balise pour afficher les valeurs de facette en dehors du contexte d’un bloc de facettes guidées nommé. Vous référencez directement une facette spécifique à l’aide de l’ attribut gsname.
<script>      registerFacetValues('category', '<guided-facet-values gsname="category"><guided-facet-value/>,</guided-facet-values>'); </script>
10
<guided-facet-value [escape="html|url|js|json|0"]/>
Renvoie la chaîne de la valeur de facette actuelle.
Par défaut, la valeur est séquence d’échappement HTML. Vous pouvez utiliser l’option d’échappement pour modifier le mode d’échappement de la valeur.
11
<guided-facet-count/>
Génère le nombre de résultats correspondant à la valeur de facette actuelle.
12
<guided-facet-value-link [attr="valeur"]+></guided-facet-value-link>
Crée un lien autour de la chaîne de valeur de facette sur laquelle le visiteur du site doit cliquer. Le chemin est généré automatiquement pour restreindre les résultats en fonction de la valeur de facette actuelle. Il prend en charge le transfert direct de tout attribut à la balise d’ancrage.
<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>
Modifie l’affichage de la valeur de facette lorsqu’elle est actuellement sélectionnée. S'il a déjà été choisi, il n'est plus possible de le lier dans la plupart des cas.
<guided-facet-values>      <guided-if-facet-value-selected>          <b><guided-facet-value/></b>      <guided-else-facet-value-selected>          <guided-facet-link><guided-facet-value/></guided-facet-link>         </guided-if-facet-value-selected> </guided-facet-values>
14
&amp;lt;/guided-if[-not]-facet-value-ghost&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Modifie l’affichage de la valeur de facette lorsqu’il s’agit d’une valeur fantôme. Lorsqu’une valeur de facette est une valeur fantôme, elle est généralement affichée en italique pour indiquer que la valeur est absente ou "fantôme".
L’extrait de code suivant est un exemple de bloc de facettes :
<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>
Affiche un lien d’annulation pour une facette donnée. S’il existe des facettes à sélection multiple, ce lien désélectionne toutes les valeurs de facette donnée. Donnez un nom à la facette. Si la facette n’est pas actuellement sélectionnée, le lien est le chemin d’accès actif.
Voici un exemple d’utilisation de cette balise :
<guided-if-facet-selected gsname="category">     <guided-facet-undo-link gsname="category">Undo Category</guided-facet-undo-link> </guided-if-facet-selected>
16
Cette balise conditionnelle est vraie lorsque le nombre de valeurs de facette dépasse le seuil de longueur défini dans la configuration. Utilisez-la pour afficher une facette en tant qu’élément d’interface utilisateur différent (comme une liste tronquée ou une zone de défilement) lorsque la liste est trop longue.
<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>
Vous pouvez également utiliser cette condition en dehors du contexte d’un bloc de facettes guidées nommé en référençant une facette spécifique directement à l’aide de l’ attribut gsname.
<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>
Cette balise conditionnelle est vraie lorsque l’utilisateur clique au moins une fois sur la facette et qu’une valeur de facette est actuellement sélectionnée. Il peut être utilisé pour afficher ou masquer des balises HTML ou gs selon qu’une facette est cliquée ou non.
<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>
Vous pouvez également utiliser cette condition en dehors du contexte d’un bloc de facettes guidées nommé en référençant une facette spécifique directement à l’aide de l’ attribut gsname .
<guided-if-facet-selected gsname="category">      The category facet is selected! </guided-if-facet-selected>
18
Cette balise conditionnelle est vraie lorsqu’il n’existe qu’une seule valeur de facette. Il peut être utilisé pour modifier l’affichage de la facette lorsqu’il n’est pas en mesure d’affiner les résultats.
<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>
Vous pouvez également utiliser cette condition en dehors du contexte d’un bloc de facettes guidées nommé en référençant une facette spécifique directement à l’aide de l’ attribut gsname.
<guided-if-facet-single gsname="category">      There is only one value in the category facet! </guided-if-facet-single>
19
Cette condition vous permet de vérifier si la facette spécifiée comporte des valeurs. Vous pouvez l’utiliser pour afficher une autre facette au lieu d’une facette vide.
20
<guided-facet-total-count gsname=" facetname "/>
Génère le nombre total de résultats qui se trouvent dans la facette donnée.
21
<guided-facet-value gsname=" valeur de facette personnalisée associée " [escape="html|url|js|json|0"]/>
Renvoie la chaîne d’une valeur associée à la facette. Vous pouvez associer 0 ou plusieurs champs à une facette. Le fait d’avoir des champs associés est rare et pour ce faire, vous devez configurer le modèle de transport.
22
<Guided-if-facet-value gsname=" valeur de facette personnalisée "/><guidé-else-facet-value></guidé-if-facet-value>
Teste si la valeur de facette est associée à une valeur de champ.
23
<guided-facet-link [attr=" value "]+></guided-facet-link>
Crée un lien autour de la chaîne de valeur de facette sur laquelle le client doit cliquer. Le chemin est généré automatiquement pour restreindre les résultats en fonction de la valeur de facette actuelle. Il prend en charge le transfert direct de tout attribut à la balise d’ancrage.
<guided-facet-values>      <guided-facet-link class="facetlink"><guided-facet-value/></guided-facet-link> </guided-facet-values>
24
<guided-facet-value-path [escape="html|url|js|json|0"]/>
Crée votre propre lien vers une valeur de facette.
<guided-facet-values>      <guided-lt/>a href="<guided-facet-value-path/>"<guided-gt/><guided-facet-value/></a> </guided-facet-values>
Par défaut, la valeur est Coupée d’une séquence d’échappement d’URL. Vous pouvez toutefois ajouter un autre calque de codage en spécifiant le mode d’échappement à utiliser au moyen du paramètre d’échappement.
25
<guided-facet-value-children></guided-facet-value-children>
Alors que <guided-facet-values> effectue une itération sur chaque valeur de facette, cette balise effectue une itération sur toutes les valeurs enfants d’une facette imbriquée. Dans cette balise, utilisez les balises de facette standard pour créer des liens, créer des liens d’annulation et afficher les valeurs de facette. Cette balise doit se trouver à l’intérieur de <guided-facet-values> , car elle ne bouge pas imbriquée.
Voici un exemple d’utilisation de cette balise :
<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>
Vérifie si la valeur de facette actuelle comporte des valeurs enfants. Il est recommandé d’utiliser avant d’utiliser les balises <guided-facet-value-children> . La clause "else" est facultative.
27
&amp;lt;guided-else[-not]-facet-value-au-dessus de la longueur-seuil&amp;gt;
    
    &amp;lt;/guided-if[-not]-facet-value-au-dessus de la longueur-seuil&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Détermine si la valeur de facette actuelle dans la boucle facet-values est supérieure au seuil de longueur. Il est généralement utilisé pour afficher uniquement les valeurs inférieures au seuil sur une longue facette (à moins que l’utilisateur ait précédemment sélectionné un lien "Voir plus" affiché sous la facette).
28
&amp;lt;guidé-else[-not]-facet-value-equals-length-seuil&amp;gt;
    
    &amp;lt;/guidé-if[-not]-facet-value-equals-length-seuil&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Détermine si la valeur de facette actuelle dans la boucle facet-values est égale au seuil de longueur.
29
<guided-facet-value-undo-link></guided-facet-value-undo-link>
Affiche un lien d’annulation pour une valeur de facette sélectionnée donnée. Utilisez-la pour afficher un lien Annuler en regard d’une valeur de facette sélectionnée. Comme ce lien d’annulation annule uniquement cette valeur sélectionnée particulière, il diffère de <guided-facet-undo-link> qui désélectionne toutes les valeurs sélectionnées.
Remarque : Si la facette n’a pas de comportement de sélection multiple, les deux liens d’annulation ont le même comportement. Autrement dit, la facette ne peut avoir qu’une seule valeur sélectionnée.
Si la facette n’est pas actuellement sélectionnée, le lien est le chemin d’accès actif. Utilisez cette balise uniquement dans une boucle guidé-facette-values .
30
<guided-facet-value-undo-path/>
Créez votre propre lien d’annulation de valeur de facette.
31
<guided-facet-undo-path gsname=" facetname "/>
Créez votre propre lien d’annulation de facette.
Semblable à la balise <guided-facet-undo-link> , sauf qu’elle vous donne le chemin brut pour créer votre propre lien d’annulation.
32
Affichage conditionnel du code HTML lorsque la facette donnée a la valeur "value" sélectionnée ou unique. Cet ensemble de balises est souvent utilisé pour afficher une facette en fonction de la valeur sélectionnée dans une autre facette.
33
<guided-facet-comportement gsname=" facetname "/>
Déterminez le comportement d’une facette (normal, collant ou à sélection multiple, par exemple). Il est utile pour les clients qui reçoivent des résultats XML et souhaitent modifier dynamiquement la manière dont la facette est affichée en fonction de son comportement.
34
&amp;lt;/guided-if-facet[-not]-visible&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Le contenu encapsulé par cette balise est masqué ou affiché en fonction de l’état de visibilité de la facette. Si une règle de fonctionnement masque ou révèle directement la facette, tout contenu de la facette est masqué ou révélé. Il n’est pas nécessaire que ces balises entourent la facette.
Cette balise est couramment utilisée pour masquer le nom d’affichage lorsque le nom se trouve en dehors de la facette. Lorsque vous placez cette balise autour du nom d’affichage, le nom disparaît lorsque la facette est masquée.
Cette balise remplace la zone et présente plusieurs des mêmes avantages en termes de performances que l’utilisation de zones.

Chemin de navigation

Baliser
Description
1
<guided-breadcrumb [gsname=" breadcrumbname "]></guided-breadcrumb>
Balise de boucle du chemin de navigation. Tout contenu entre les balises d’ouverture et de fermeture est itéré pour chaque numéro de requête de l’état actuel.
Si gsname est omis, le chemin de navigation nommé "default" est utilisé.
2
<guided-breadcrumb-link [gsname="goto|remove|drop"] [attr="value"]+></guided-breadcrumb-link>
Crée un lien dans le chemin de navigation. Le comportement par défaut est le comportement "goto". Si le lien se comporte différemment, utilisez l’attribut gsname facultatif pour spécifier "remove" ou "drop". Tout attribut inclus dans la balise est transmis à la balise d’ancrage résultante.
<guided-breadcrumb>      <guided-breadcrumb-link gsname="remove" class="bc_link">          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>
3
<guided-breadcrumb-value />
La balise value imprime la valeur transformée de l’itération du chemin de navigation actuelle. Il est utilisé uniquement dans le contexte d’un bloc de chemin de navigation guidé.
<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>
4
<guided-breadcrumb-label />
La balise d’étiquette génère un libellé pour une valeur de chemin de navigation qui détaille la facette sélectionnée pour générer cet élément de chemin de navigation. Elle est uniquement utilisée dans le contexte d’un bloc de chemin de navigation guidé.
<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 />
Cette balise conditionnelle est utilisée pour afficher sous condition le contenu si la valeur actuelle du chemin de navigation comporte une étiquette. Il est utilisé pour afficher uniquement les étiquettes et le contenu associé lorsqu’une étiquette existe réellement. Elle est uniquement utilisée dans le contexte d’un bloc de chemin de navigation guidé.
<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-if-breadcrumb-label>              <guided-breadcrumb-label/>:          </guided-if-breadcrumb-label>      <guided-breadcrumb-value/></guided-breadcrumb-link> </guided-breadcrumb>
6
<guided-breadcrumb-path [gsname="goto|remove|drop"]/>
Utilisé pour créer votre propre lien de chemin de navigation.

Menus

Baliser
Description
1
<guided-menu gsname="menuname"></guided-menu>
Il s’agit de la balise d’itérateur de boucle de valeur de menu. Utilisez l'attribut gsname pour identifier le jeu d'éléments de menu qui s'affiche.
2
<guided-menu-item-link [attr="valeur"]+></guided-menu-item-link>
Donne l'URL pour affiner la recherche actuelle de l'option de menu.
3
<guided-menu-item-option [attr="valeur"]+ />
En règle générale, un menu s’affiche dans un contrôle de sélection sur un modèle. Cette balise facilite la création du contrôle select, car elle génère le code HTML permettant de générer l’option du contrôle select.
Par exemple, le bloc de code suivant :
<select name="sort" onchange="gcGo(this);"> <guided-menu gsname="sort"> <guided-menu-item-option/> </guided-menu> </select>
Peut générer du code HTML comme suit :
<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 />
Renvoie la chaîne de la valeur associée au menu.
5
<guided-menu-item-label />
Renvoie la chaîne de l’étiquette associée au menu.
6
<guided-menu-item-path />
Renvoie la chaîne de chemin. Utilisez la balise si vous souhaitez ajouter un paramètre au chemin et créer un lien personnalisé.
7
<guided-if-menu-item-selected> <guided-else-menu- item-selected> </guided-if-menu-item-selected>
Renvoie 1 ou 0 pour indiquer si l’option de menu active est sélectionnée.

Pagenav

Les balises de navigation de la page peuvent être utilisées pour créer un ensemble de liens permettant à un utilisateur de parcourir les résultats de la recherche.
Baliser
Description
1
<pages guidées></pages guidées>
Balise de boucle pour la navigation dans la page. Tout contenu entre les balises d’ouverture et de fermeture est itéré pour chaque page.
2
<guided-page-link [attr="value"]+></guided-page-link>
Crée un lien dans le volet de navigation de la page.
3
<guided-page-link gsname="first|prev|next|last|viewall|viewpages" [attr="value"]+></guided-page-link>
Crée un lien vers la première, la précédente, la suivante ou la dernière page. Il peut également créer un lien pour afficher toutes les pages d’une page.
4
<guided-page-number />
Renvoie une chaîne avec le numéro de page actuel.
5
<guided-if-page-selected> <guided-else-page- selected> </guided-if-page-selected>
Cet ensemble de balises conditionnelles est true si la page sur laquelle l’itération est effectuée est sélectionnée. Il est généralement utilisé pour afficher différemment le numéro de page dans le contrôle de navigation par page.
6
<guided-if[-not]-page-prev> <guided-else-page- prev> </guided-if[-not]-page-prev>
Cet ensemble de balises conditionnelles est vrai si la page active comporte une page précédente. Il est généralement utilisé pour afficher un lien précédent dans la navigation de la page, lorsqu’il est logique.
7
<guided-if[-not]-page-next> <guided-else-page- next> </guided-if[-not]-page-next>
Cet ensemble de balises conditionnelles est vrai si la page active comporte une page suivante. Il est généralement utilisé pour afficher un lien précédent dans la navigation de la page, lorsqu’il est logique.
8
<guided-if[-not]-page-viewall> <guided-else-page- viewall> </guided-if[-not]-page-viewall>
Lorsqu'une recherche renvoie un jeu de résultats volumineux, vous ne souhaiterez peut-être pas offrir la possibilité d'afficher tous les résultats. Par conséquent, vous pouvez utiliser cet ensemble de balises conditionnelles pour déterminer quand afficher le lien Afficher tout.
9
<guided-if[-not]-page-viewpages> <guided-else-page- viewpages> </guided-if[-not]-page-viewpages>
Vous pouvez utiliser cet ensemble de balises conditionnelles pour déterminer quand afficher le lien Afficher les pages. Il est généralement utilisé pour permettre à un client d’afficher certaines pages.
10
&amp;lt;guided-else-page-link&amp;gt;
    &amp;lt;/guided-if[-not]-page-link&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Teste si la navigation de la page comporte une première page, une page précédente, une page suivante, etc.
11
<guided-page-total />
Renvoie une chaîne avec le nombre total de pages des résultats de la recherche.
12
<guided-pagination gsname= "pagination_name"></guided-pagination>
Utilisez la balise de pagination guidée pour définir une zone dans laquelle toutes les balises de pagination se rapportent à un paramètre de pagination spécifique si vous avez défini quelques paramètres de navigation de page.
13
next|last|viewall|viewpages]/&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Crée votre propre lien dans le volet de navigation de la page.
14
<guided-if-page-high-eq-last> <guided-else-page- high-eq-last> </guided-if-page-high-eq-last>
Teste si la page la plus élevée dans la navigation de la page est égale au nombre total de pages.
15
<guided-if-page-low-eq-first> <guided-else-page-low-eq-first> </guided-if-page-low-eq-first>
Teste si la page la plus basse du volet de navigation de la page est égale à celle-ci.
16
<guided-if-page-is-multipage> <guided-else-page-is-multipage> </guided-if-page-is-multipage>
Teste s’il existe une page de résultats unique ou plusieurs pages de résultats.

Recherches récentes

Vous pouvez utiliser des balises de recherche récentes pour créer un ensemble de liens permettant à un utilisateur d’exécuter rapidement une recherche précédente, comme dans l’exemple suivant :
<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>

Baliser
Description
1
<guided-récent-searches></guided-récent-searches>
Balise de boucle pour les recherches récentes. Tout contenu entre les balises d’ouverture et de fermeture est itéré pour chaque page.
2
<guided-recent-searches-link [attr="value"]+> </guided-recent-searches-link>
Permet de créer un lien vers une recherche récente. Il prend en charge le transfert direct des attributs HTML vers la balise d’ancrage.
3
<guided-récent-searches-path/>
Vous permet de saisir le chemin d’URL relatif pour une recherche récente, dans une boucle de recherche récente guidée. En règle générale, vous utiliseriez le lien guidé-récent-recherche-lien . Cependant, si vous souhaitez créer votre propre lien, vous pouvez utiliser cette balise. Voici un exemple :
<guided-lt/>a&nbsp;href="<guided_recent_searches_path>"><guided-recent-searches-value></a>
4
<guided-récent-searches-value>
Permet de saisir le terme de requête associé à une recherche récente.
5
<guided-récent-searches-clear-link [attr="valeur"]+></guided-new-searches-clear-link>
Vous permet d’offrir à vos clients la possibilité d’effacer les recherches enregistrées récemment.
6
<guided-récent-searches-clear-path/>
Renvoie le chemin utilisé par <guided-new-searches-clear-link> afin que vous puissiez créer votre propre lien.
7
&amp;lt;/guided-if-récent-searches&amp;gt; &lt;/code> &lt;/p> &lt;/td>

Vous permet d’afficher les recherches récentes lorsqu’un client a effectué une recherche récente.

Voulez-vous dire

Vous pouvez utiliser les balises Voulez-vous dire pour créer un ensemble de liens vers des suggestions lorsqu’une recherche ne renvoie aucun résultat et que le terme de recherche ne figure pas dans le dictionnaire du compte. Voici un exemple d’utilisation des balises Did You Mean :
<guided-if-suggestions> 
    <span>Did You Mean?</span><br/> 
    <guided-suggestions> 
        <guided-suggestion-link><guided-suggestion/></guided-suggestion-link><br/> 
    </guided-suggestions> 
</guided-if-suggestions>

Baliser
Description
1
<Guided-Suggestions></Guided-Suggestions>
Il s’agit de la balise de boucle permettant de parcourir les suggestions en boucle.
2
<guided-suggestion-link [attr="value"]+></guided-suggestion-link>
Crée un lien vers la suggestion donnée.
3
<guided-suggestion-value />
4
<guided-if[-not]-suggestions><guided-else[-not]- suggestions></guided-if[-not]-suggestions>
Vous permet de tester s’il existe des suggestions.
5
<guided-suggestion-path/>
Renvoie la chaîne de chemin vers la suggestion. Vous pouvez l’utiliser pour créer votre propre balise d’ancrage. En règle générale, le lien-suggestion-guidé est utilisé à la place.
6
<guided-suggestion/>
Une suggestion.
7
<guided-suggestion-result-count/>
Nombre de résultats pour la suggestion.
8
<guided-if[-not]-suggestion-autosearch> <guided-else[-not]-suggestion-autosearch> </guided-if[-not]-suggestion-autosearch>
Permet de tester si la recherche automatique par suggestion sur zéro résultat a été effectuée, au cas où cette fonction serait activée.
9
<guided-suggestion-original-query/>
Renvoie la requête d’origine si une recherche automatique a été effectuée.
Exemple d’utilisation :
<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>
Cette condition est vraie si des suggestions sont faites en raison d’un faible nombre de résultats, au cas où cette fonctionnalité serait activée.
Voici un exemple d’utilisation de cette balise :
<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>

Remplissage automatique

Les balises suivantes peuvent être utilisées pour ajouter la saisie automatique à votre formulaire de recherche. Les balises head-content et form-content sont requises pour que la saisie automatique fonctionne correctement. Il est recommandé d’utiliser les balises plutôt que de coder en dur le code JavaScript et le code CSS à saisie automatique dans le modèle de présentation. La raison en est que les balises permettent à vos modèles de sélectionner de nouveaux ID de cache d’échec chaque fois que vous modifiez vos paramètres de saisie automatique sans avoir à mettre à jour manuellement votre modèle.
Voir A propos du remplissage automatique.
Baliser
Description
1
<guided-if-autocomplete> <guided-else-autocomplete> </guided-if-autocomplete>
Détecte si la fonction de saisie automatique est activée. Vous pouvez utiliser les balises pour sélectionner éventuellement le contenu de l’en-tête et du formulaire requis pour la saisie automatique. Cela vous permet d’activer ou de désactiver la fonction et de ne pas avoir à modifier les modèles de présentation.
2
<guided-ac-css/>
Utilisé dans la section head du modèle de présentation et remplacé par le script CSS approprié pour la saisie automatique.
3
<guided-ac-form-content/>
Utilisé dans le formulaire de recherche (entre les balises <form> et </form> ) du modèle de présentation au lieu de coder en dur les balises de saisie automatique dans le formulaire. Les balises sont remplacées par le code HTML approprié requis pour que la saisie automatique fonctionne.
4
<guided-ac-javascript/>
Génère les liens vers le code JavaScript de saisie semi-automatique. Pour de meilleures performances, il est recommandé de placer cette balise près du bas de la page avant la balise de fermeture "body".

Store

Utilisez les balises suivantes pour tester et afficher la boutique dans laquelle se trouve actuellement un utilisateur.
Baliser
Description
1
<guided-store/>
Génère le magasin actuel.
2
<guided-if-store-defined> <guided-else-store-defined> </guided-if-store-defined>
Détecte si l’utilisateur se trouve dans un magasin.
3
<guided-if-store gsname="store"> <guided-else-store> </guided-if-store>
Détecte si l’utilisateur se trouve dans le magasin spécifié par le paramètre gsname .

Zones

Baliser
Description
1
<Guided-zone gsname="zone area" [search="recherche associée"] [facet="facette associée"] [width="xx" height="yy"]>
Vous pouvez placer n’importe quel contenu dans des balises de zone pour créer une zone en dehors de cette zone. Vous pouvez ainsi utiliser des règles de fonctionnement pour afficher la zone selon vos besoins. Par défaut, les zones sont toujours affichées. Vous pouvez utiliser les paramètres facultatifs de recherche et de facette pour indiquer la recherche ou la facette associée à la zone. Cette fonctionnalité permet au logiciel de sauter les recherches ou les facettes lorsqu’une zone est masquée, améliorant ainsi les performances en temps de recherche. Les attributs de hauteur et de largeur sont facultatifs et sont utilisés pour configurer l’affichage de l’espace réservé dans le Créateur de règles visuel lorsqu’une zone est supprimée.
Dans la mesure du possible, utilisez la balise guidé-if-facet[-not]-visible au lieu de la zone. Il simplifie le modèle de présentation.
2
<guided-if-zone gsname="zone"> <guided-else-zone> </guided-if-zone>
Cet ensemble de balises permet de tester si une zone est actuellement affichée. Il est utile lorsque vous avez du contenu ailleurs sur la page que vous souhaitez afficher uniquement lorsque la zone est affichée.

Indicateurs de boucle

Vous pouvez utiliser chacun des indicateurs de boucle suivants dans l’un de ces blocs de boucle :
  • guidé-résultats
  • valeurs de facette guidée
  • chemin de navigation guidé
  • guidé-menu-éléments
  • pages guidées
Baliser
Description
1
<guided-if[-not]-first><guided-else[-not]-first> </guided-if[-not]-first>
Cette condition est vraie lorsque l’itération actuelle est la première itération de la boucle. Cela ne signifie pas nécessairement le premier résultat ou la première page, mais la première. Si le visiteur du site se trouve sur la page 2 d’un jeu de résultats de 10 par page, la première itération est le résultat 11.
2
<guided-if[-not]-last><guided-else[-not]-last> </guided-if[-not]-last>
Cette condition est vraie lorsque l’itération actuelle est la dernière itération de la boucle. Cela ne signifie pas nécessairement le dernier résultat ou la dernière page, mais le dernier dans le contexte actuel (page). Si le visiteur du site se trouve sur la page 1 d’un jeu de résultats qui contient 200 résultats, mais qui ne contient que 10 résultats par page, la dernière itération est le résultat 10 au lieu du résultat 200.
3
<guided-if[-not]-odd><guided-else[-not]-odd> </guided-if[-not]-odd>
Cette condition est vraie lorsque l’itération actuelle est une itération impaire de la boucle (par rapport à une itération paire). Cela s’avère utile pour afficher des couleurs de rangées variables.
4
<guided-if[-not]-even><guided-else[-not]-even> </guided-if[-not]-even>
Cette condition est vraie lorsque l’itération actuelle est une itération paire de la boucle (par rapport à une itération impaire). Cela s’avère utile pour afficher des couleurs de rangées variables.
5
<guided-if[-not]-alt><guided-else[-not]-alt> </guided-if[-not]-alt>
Cette condition est vraie lorsque l’itération actuelle est une itération paire de la boucle. Cela s’avère utile pour afficher des couleurs de rangées variables.
6
<guided-if[-not]-inner><guided-else[-not]-inner> </guided-if[-not]-inner>
Inclut le texte entre eux si l’itération actuelle n’est ni la première ni la dernière.
7
<guided-if[-not]-outer><guided-else[-not]-outer> </guided-if[-not]-outer>
Inclut le texte entre eux si l’itération actuelle est la première ou la dernière.
8
<guided-loop-index>
Entier (commençant par 0) dont la valeur est incrémentée pour chaque itération de la boucle.
9
<guided-loop-compteur>
Entier (commençant par 1) dont la valeur est incrémentée pour chaque itération de la boucle.

Langue diverse

Les balises suivantes sont disponibles pour vous permettre d’effectuer des tâches plus avancées avec votre modèle, comme la création de votre propre mini-facette.
Baliser
Description
1
<guided-current-path [escape="html|url|js|json|0"] />
Vous donne le chemin actuel utilisé. Il est généralement utilisé pour créer un lien qui ajoute un nouveau paramètre à la recherche existante. Par défaut, le chemin d’accès est une séquence d’échappement d’URL. Vous pouvez spécifier le mode d’échappement à utiliser au moyen du paramètre d’échappement.
Exemple :
<a href="<guided-current-path />&lang=fr"> French Version
Dans cet exemple, une règle de traitement de recherche utilise lang pour sélectionner la version française.
Le chemin actuel comporte toujours au moins un paramètre de requête. S’il n’existe aucun autre paramètre de requête, il est défini sur q=* ce qui facilite l’ajout de paramètres supplémentaires.
2
Chemin de base
Si vous souhaitez créer un lien à l'aide du chemin de base, utilisez / au début de votre href et ajoutez des paramètres.
<a href="/">All Products</a> Would create a link "All Products" to your basepath, for example https://search.mycompany.com/
3
<guided-query-param gsname="query_parameter" [escape="html|url"] />
Permet de saisir la valeur existante d’un paramètre de requête figurant sur l’URL. Si votre paramètre n’existe pas, cette balise renvoie une chaîne vide. Si vous ne spécifiez pas d’option d’échappement, la chaîne renvoyée est automatiquement une séquence d’échappement HTML, vous pouvez spécifier une séquence d’échappement HTML ou URL.
Exemple :
&amp;lt;guided-query-param&amp;nbsp;gsname=&quot;q&quot;&amp;nbsp;/&amp;gt;
    donnees&amp;nbsp;you&amp;nbsp;the&amp;nbsp;value&amp;nbsp;pantalon
    
    &amp;lt;guided-query-param&amp;nbsp;gsname&quot; lang&quot;&amp;nbsp;/&amp;gt;
    donne&amp;nbsp;you&amp;nbsp;the&amp;nbsp;value&amp;nbsp;en
    
    &amp;lt;guided-query-param&amp;nbsp;gsname=&quot;test&quot;&amp;nbsp;/&amp;gt;
    don&amp;namp;nbsp bsp;you&amp;nbsp;an&amp;nbsp;empty&amp;nbsp;string
    &amp;nbsp;
    &amp;nbsp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;nbsp;nbsp;&amp;nbsp;nbsp; &lt;/code> &lt;/p> &lt;/td>

4
<guided-query-param-name gsname="param#" offset="offset_number"/>
La recherche guidée a la notion d’un numéro de requête, qui est utilisé dans le contrôle de chemin de navigation. guidé-query-param-name permet de définir des paramètres dans le cadre d’un lien du modèle de présentation dans lequel la recherche guidée détermine le numéro de requête correct pour vous. Le nom de fichier contient un "x", que la recherche guidée remplace par le nombre correct. La valeur de décalage peut être comprise entre 0 et 15, où 0 indique que le prochain numéro de requête disponible est utilisé. Une valeur 1 indique que vous souhaitez ajouter 1 à cette valeur, etc.
Combiné à un chemin guidé-courant , vous pouvez créer votre propre lien de mini facette ou autoriser un niveau d’exploration supplémentaire.
Exemple :
<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="nom_fichier" />
Vous permet d’inclure d’autres fichiers de modèle. Cela signifie que vous pouvez créer plusieurs modèles à l’aide de sous-modèles sous forme de modules.
Dans l’exemple suivant, les chemins de navigation et les fichiers de facettes sont inclus :
<guided-include gsfile='breadcrumbs.tmpl' /> <guided-include gsfile='facets.tmpl' />
Les inclusions dynamiques ne sont pas prises en charge. En d’autres termes, gsfile ne peut pas être une variable.
6
<guided-search-time>
Identifie la durée de la recherche. La valeur de temps de recherche renvoyée est spécifiée en ms.
7
<guided-fall-through-searches>
Renvoie le nombre de recherches de noyaux utilisées pour créer la page des résultats de la recherche.
8
<guided-if-fall-through-search></guided-if-fall-through-search>
Teste si le nombre de recherches principales est supérieur à un.
9
<guided-if[-not]-even><guided-else[-not]-even> </guided-if[-not]-even>
Cette condition est vraie lorsque l’itération actuelle est une itération paire de la boucle (par rapport à une itération impaire). Cela s’avère utile pour afficher des couleurs de rangées variables.
10
<guided-if[-not]-alt><guided-else[-not]-alt> </guided-if[-not]-alt>
Cette condition est vraie lorsque l’itération actuelle est une itération paire de la boucle. Cela s’avère utile pour afficher des couleurs de rangées variables.
11
<guided-if[-not]-inner><guided-else[-not]-inner> </guided-if[-not]-inner>
Inclut le texte entre eux si l’itération actuelle n’est ni la première ni la dernière.
12
<guided-if[-not]-outer><guided-else[-not]-outer> </guided-if[-not]-outer>
Inclut le texte entre eux si l’itération actuelle est la première ou la dernière.
13
<guided-if-first-search><guided-else-first-search> </guided-if-first-search>
Vous permet de vérifier si vous êtes sur la recherche initiale ou non (la requête était le résultat d'une recherche dans la zone de recherche).
14
<guided-search-url/>
Vous pouvez utiliser cette balise dans votre modèle pour vous empêcher de figer l’action du formulaire de recherche. Il détecte lorsque vous êtes dans l’environnement d’évaluation ou de production et change en conséquence.
15
<guided-if-query-param-defined gsname="query_parameter"> <guided-else-query-param-defined> </guided-if-query-param-defined>
Cet ensemble de balises vous permet de tester les paramètres CGI définis dans le chemin de recherche. Vous pouvez tester les valeurs des paramètres uniquement si elles sont définies.
16
<guided-next-query-number [gsname="offset"] />
Le moteur de recherche guidée qui conduit le modèle a la notion de nombres de requêtes flottants où chaque nouveau lien généré par le moteur utilise le prochain numéro de requête disponible. Cette balise vous permet de saisir le ou les décalages suivants de la requête afin de créer des liens personnalisés qui explorent le jeu de résultats. Le décalage vous permet de décaler dans le numéro de requête suivant. Par exemple, si vous avez sélectionné une facette, le numéro de requête suivant est 2, avec un décalage de 1, le numéro de requête renvoyé est 3.
17
<guided-custom-var gsname="custom_variable" [escape="html|url|js|json|0"]/>
Permet de saisir la valeur existante d’une variable personnalisée définie par vos règles de traitement. Si vous ne spécifiez pas d’option d’échappement, la chaîne renvoyée est automatiquement une séquence d’échappement HTML, vous pouvez spécifier html , url , js ou 0 . Si vous utilisez une règle de traitement pour copier un paramètre CGI entrant dans une variable personnalisée, puis l’afficher ou l’utiliser dans votre modèle avec l’option d’échappement définie sur none ou js, vous pouvez créer une vulnérabilité XSS dans votre recherche.
18
<guided-if-custom-var-defined gsname="custom_variable"> <guided-else-custom-var-defined> </guided-if-custom-var-defined>
Active le test si une variable personnalisée est définie dans les règles de traitement (nettoyage des requêtes, traitement avant recherche et post-recherche).
19
<guided-general-field gsname="nom_recherche" field="nom_champ" [escape="html|url|js|json|0"]/>
Permet d’afficher le contenu d’un champ général défini dans le modèle de transport. Si vous ne spécifiez pas d’option d’échappement, la chaîne renvoyée est codée au format que vous avez spécifié dans le modèle de transport pour ce champ. La spécification d’une option d’échappement s’applique au-dessus du format de codage du champ tel que celui de votre modèle de transport. Vous pouvez spécifier html , url , js , json ou 0 .
20
<guided-if-general-field gsname="nom_recherche" field="nom_champ"> <guidé-else-general-field> </guidé-if-general-field>
Active le test si le contenu d’un champ général, tel que défini dans le modèle de transport, existe.
21
<guided-cookie-value gsname="nom_cookie" [escape="html|url|js|json|0"]/>
Vous permet de saisir la valeur d’un cookie, en supposant qu’il soit disponible. Si vous ne spécifiez pas d’option d’échappement, la chaîne renvoyée est automatiquement une séquence d’échappement HTML, vous pouvez spécifier html , url , js , json ou 0 .
22
<guided-if-cookie gsname="nom_cookie"> <cookie-else> </guided-if-cookie>
Active le test s’il existe un cookie.
23
<guided-banner gsname="bannière area" [escape="html|url|js|json|0"] [width="xx" height="yy"]/>
Génère la bannière pour une zone donnée. Les attributs facultatifs de largeur et de hauteur sont utilisés dans le Créateur de règles visuel pour permettre l’affichage d’un espace réservé significatif permettant aux utilisateurs de sélectionner une bannière. Par défaut, les bannières ne sont pas ignorées. Vous souhaitez plutôt injecter du code HTML dans le modèle de présentation. Cependant, si vous créez un modèle JSON, pensez à utiliser l’option d’échappement js.
Exemple :
<guided-banner gsname="top" width="400px"  height="50px"/>
24
<guided-if-banner-set gsname="bannière-zone"> <guided-else-banner-set> </guided-if-banner-set>
Active le test si une zone de bannière est définie.
25
<guided-if-simulator-mode> <guided-else-simulator-mode> </guided-if-simulator-mode>
Permet de détecter le moment où vous affichez votre recherche dans le simulateur ou le créateur de règles visuel. Il est normalement utilisé pour afficher des informations de débogage supplémentaires pour vous.
26
<guided-if-tnt-business-rule> <guided-else-tnt-business-rule> </guided-if-tnt-business-rule>
Permet de détecter si vous avez des règles de fonctionnement référençant une campagne Adobe Target. Il est généralement utilisé dans le cadre de l’intégration à Adobe Target afin d’empêcher l’accès aux serveurs Target lorsque cela n’est pas nécessaire.
27
<guided-redirect/>
Par défaut, les redirections sont exécutées automatiquement. Cependant, si vous avez configuré la recherche/marchandisage de site pour renvoyer une réponse XML ou JSON à votre application Web, vous pouvez soit analyser la réponse 302/301 dans votre application Web, soit vous faire passer la redirection dans le jeu de résultats. Si vous transmettez la redirection dans le cadre du jeu de résultats, cette balise peut être utilisée dans le modèle pour générer l’emplacement de redirection.
28
<guided-if-redirect> <guided-else-redirect> </guided-if-redirect>
Lorsque vous avez configuré la recherche/marchandisage du site pour renvoyer des redirections dans le jeu de résultats, cet ensemble de balises peut être utilisé pour déterminer s’il existe une redirection vers la sortie.
29
<guided-lt/> <guided-gt/>
Cet ensemble de balises vous permet d’incorporer des balises de modèle guidées dans des attributs HTML.
Exemple :
<guided-lt/>div <guided-if-facet-long>         style="height: 125px; overflow:         auto;"</guided-if-facet-long><guided-gt/>

Balises de modèle de transport

Les modèles de transport sont des modèles XML qui transmettent les données de la recherche principale à la couche de présentation Recherche guidée.
Dans la couche de présentation, vous pouvez disposer d’un modèle de présentation unique qui présente les résultats de plusieurs recherches. Chaque recherche peut utiliser le même modèle de transport ou un modèle de transport personnalisé pour transmettre les données à la couche de présentation.
Le modèle de transport étant uniquement utilisé pour transmettre des données à la couche de présentation, il ne comporte aucun code HTML qui se préoccupe de l’affichage des résultats de la recherche. Le modèle de transport utilise des balises XML de modèle de transport pour transmettre les résultats de la recherche afin de renseigner les composants de recherche guidée, tels que les facettes, les chemins de navigation et les menus. Dans ces balises, les balises de modèle de recherche standard sont utilisées pour afficher les valeurs réelles.
Voir Rechercher des balises de modèle.
Balise de modèle de transport
Description
<guided-xml></guided-xml>
Balises XML racine utilisées par la couche de présentation pour détecter ce qui est analysé à partir du modèle de transport.
<general></general>
Les balises entourent les balises de modèle de recherche qui fournissent des données de résumé basées sur le jeu de résultats. En règle générale, ces balises contiennent des balises de recherche pour le nombre total de résultats, le résultat inférieur et le résultat supérieur. Vous pouvez définir un nombre illimité de champs globaux supplémentaires à l’aide de la balise general-field , comme dans l’exemple suivant :
<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>
Les balises sont entourées des résultats de la recherche, de sorte que la recherche guidée sache où les rechercher.
<result></result>
Les balises sont entourées de chaque résultat de recherche, de sorte que la recherche guidée identifie où commence et se termine le contenu d’un seul résultat de recherche, comme dans l’exemple suivant :
<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="nom_table">
Permet de parcourir chaque élément d’une liste à plusieurs valeurs en boucle pour obtenir un seul résultat. N’utilisez cette balise que dans un résultat. Son objectif est de vous permettre d’effectuer une itération sur les attributs appartenant à un champ de résultat, comme dans l’exemple suivant :
<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>
<facettes></facettes>
Transmet les résultats qui renseignent les facettes.
<facette dynamique></facette dynamique>
Vous pouvez désigner une facette comme une facette dynamique et comme membre d’un rail de facettes. Toutefois, leur traitement est indépendant par rapport aux balises de modèle de présentation associées.
En d’autres termes, l’imbrication d’un contexte de boucle de rail de facettes dans un contexte de boucle de facettes dynamique, ou vice versa, n’est pas autorisée.
Pour les facettes dynamiques et échouées, seules les facettes dynamiques renvoyées pour une recherche donnée sont visibles dans le contexte de boucle du rail de facettes.
<facet name="name"></facet>
Chaque facette possède ses propres balises de facette où le paramètre name correspond au nom de la facette. Les balises de recherche sont utilisées dans les balises de facette pour les valeurs de facette, comme dans l’exemple suivant :
<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>
Les comptes utilisant des facettes en pointillés peuvent utiliser la balise dynamique et la balise display-names. Ces deux balises facilitent le mappage entre les facettes en pointillés et les facettes réelles lors de la création de règles de fonctionnement.
<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=",">
L’attribut Separator permet de modifier le délimiteur utilisé lors de la sortie des données de champ de recherche-affichage-de-recherche pour les listes. La valeur par défaut est une virgule.
En règle générale, le délimiteur que vous utilisez doit être quelque chose qui n’apparaît pas facilement dans le contenu du champ.
<suggestions></suggestions>
Encapsulez vos suggestions Voulez-vous dire avec des balises afin que la recherche guidée identifie les noeuds XML qui contiennent des suggestions.
<suggestion></suggestion>
Encapsulez chaque suggestion Voulez-vous dire avec des balises, comme dans l’exemple suivant :
<search-if-suggestions>   <suggestions>     <search-suggestions>       <suggestion><search-suggestion-text /></suggestion>     </search-suggestions>   </suggestions> </search-if-suggestions>

Rechercher des balises de modèle

Un modèle de recherche est un fichier HTML qui comprend des balises de modèle définies par la recherche sur le site/le marchandisage. Ces balises indiquent le format des résultats de la recherche. La référence suivante contient une brève description de chaque balise de modèle de recherche et de ses attributs.
Utilisez uniquement des balises de modèle de recherche dans les fichiers de modèle de transport (.tpl).
Vous pouvez sélectionner l’un des groupes de balises de modèle de recherche et le matériel de référence suivants.
Les balises valides uniquement dans la boucle de résultats sont les suivantes :
Les balises valides dans tout le modèle sont les suivantes :
Rechercher dans les rubriques de référence des modèles

A propos des balises de boucle Résultats

La balise de boucle de résultats est le cheval de travail du système de modèles. Lorsque la balise est rencontrée lors d’une recherche, le code HTML est répété et d’autres balises entre les balises de boucle de résultats de début et de fin, remplaçant ainsi toutes les autres balises par les résultats de la recherche.
<search-results> ... </search-results>
Les balises de boucle de résultats entourent le code HTML qui affiche les résultats de la recherche. Le code HTML entre les balises est répété pour chaque résultat et s’affiche sur la page.
Les balises suivantes ne sont valides que dans la boucle de résultats :

Balises de chaîne de boucle de résultats

Les balises suivantes renvoient une chaîne.
Voir A propos des balises de boucle Résultats.
Baliser
Description
1
<search-index>
Renvoie l’index numérique du résultat actuel.
2
<search-title length="XX">
Renvoie le titre de la page du résultat actuel. L’attribut de longueur facultatif est utilisé pour limiter la longueur des chaînes affichées, avec une valeur par défaut de 80 caractères.
3
<searchbody-text length="XX" encoding="html/javascript/json/perl/url/none" >
Renvoie le texte du corps à partir du haut de la page. Les termes pertinents sont indiqués en caractères gras. L’attribut de longueur facultatif est utilisé pour limiter la longueur des chaînes affichées, avec une valeur par défaut de 80 caractères. L’attribut encoding est facultatif et peut coder les caractères de sortie avec le codage HTML (par défaut), le codage JavaScript, le codage Perl ou aucun.
4
<search-description length="XX" encoding="html/javascript/json/perl/url/none">
Renvoie la description du résultat actuel. Si la balise meta description existe et que l’attribut content n’est pas vide, ce texte s’affiche. Sinon, le début du corps du texte de la page s’affiche. L’attribut de longueur facultatif est utilisé pour limiter la longueur des chaînes affichées, avec une valeur par défaut de 80 caractères.
L’attribut facultatif encoding contrôle si la sortie est codée au format HTML, JavaScript, Perl, URL ou non codée, pour la sortie sur la page de résultats. La valeur par défaut du codage est html . Normalement, vous n’avez pas besoin de spécifier l’attribut de codage.
5
<score de recherche grade="dynamic/static/dynamic-raw/static-raw/final-raw" précision="XX">
Renvoie le score du résultat actuel, qui est un nombre compris entre 0 et 100. Si vous avez défini un champ de classement sous Options > Métadonnées > Définitions , vous pouvez afficher le classement dynamique des pages en définissant l’attribut de classement sur dynamique ( <score de recherche ="dynamique"> ). Vous pouvez afficher le classement de page statique en définissant l'attribut de classement sur statique ( <score de recherche grade="statique"> ). Vous pouvez utiliser l’attribut de précision facultatif pour spécifier le nombre de décimales à afficher. La valeur par défaut est 0, ce qui affiche le score entier).
6
<search-date length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id">
Renvoie la date du résultat actuel. La valeur de texte facultative "aucun" s’affiche si aucune date n’est associée au résultat actuel. Si la valeur facultative "aucun" n’est pas indiquée, le texte "Aucune date" s’affiche si aucune date n’est associée au résultat actuel.
L’attribut "date-format" utilise une chaîne de format de date de style UNIX telle que "%A, %B %d, %Y" (pour "Lundi, 25 juillet 2016"). "gmt" est défini par défaut sur "yes" et contrôle si la partie "time" de la chaîne de date doit être générée en GMT ("yes") ou le fuseau horaire du compte ("no").
L’attribut "language" contrôle les conventions de langue et de paramètres régionaux de la chaîne de date de sortie. "0" (valeur par défaut) signifie "Utiliser la langue du compte". "2" signifie "Utiliser la langue du document". La valeur "langue" "1" est réservée pour une utilisation ultérieure. Toute autre valeur "language" est interprétée comme un identifiant de langue spécifique, par exemple, "en_US" signifie "English (United States)".
L’attribut de longueur facultatif est utilisé pour limiter la longueur des chaînes affichées, avec une valeur par défaut de 80 caractères.
7
<search-size>
Renvoie la taille du résultat actuel en octets.
8
<search-url length="XX" encoding="html/javascript/json/perl/url/none" >
Renvoie l’URL du résultat actuel.
Utilisez l’attribut facultatif length pour limiter la longueur des chaînes affichées, avec un nombre par défaut de caractères illimités.
L’ attribut encoding est facultatif et peut coder les caractères de sortie avec le codage HTML, le codage JavaScript, le codage Perl ou aucun.
9
<search-url-path-query length="XX">
Renvoie les parties chemin et requête, y compris le point d’interrogation de l’URL du résultat actuel.
Utilisez l’attribut facultatif length pour limiter la longueur des chaînes affichées, avec un nombre par défaut de caractères illimités.
10
<search-context length="XX" encoding="html/javascript/json/perl/url/none" >
Renvoie la ligne de contexte suivante pour le terme recherché. Les termes pertinents sont indiqués en caractères gras. Appelez cette balise plusieurs fois pour afficher plusieurs lignes contextuelles pour le résultat actuel.
Utilisez l’attribut facultatif length pour limiter la longueur des chaînes affichées, avec une valeur par défaut de 80 caractères. L’attribut length est ignoré si cette balise est entourée soit <search-if-context> , soit <search-if-any-context> jeux de balises qui contiennent un attribut length.
L’ attribut encoding est facultatif et peut coder les caractères de sortie avec le codage HTML (par défaut), le codage JavaScript, le codage Perl ou aucun.
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" Guillemets="yes/no" virgules="yes/no" units="miles/kilomètres" séparateurs""|">
Cette balise avancée affiche le contenu du champ de métadonnées (url, title, desc, keys, target, body, alt, date, charset et la langue ou des champs définis sous Options > Métadonnées > Définitions) spécifié dans l’attribut de nom , pour le résultat actuel. Par exemple :
<search-display-field name="title" length="70" none="aucun titre">
Génère le titre de la page pour un résultat de recherche. Si l’attribut facultatif none est spécifié, sa valeur s’affiche dans la page de résultats uniquement si aucun contenu n’est associé au champ.
Les attributs de format de date , gmt et de langue ne sont pertinents que si le type de contenu du champ spécifié est le de date.
L'attribut format de date prend une chaîne de format de date de style UNIX, telle que %A, %B %d, %Y (pour le lundi 25 juillet 2016). gmt utilise par défaut yes et contrôle si la partie "time" de la chaîne de date est générée en GMT ( oui ) ou le fuseau horaire du compte ( non ).
Voir Chaînes de format de date.
L’ attribut de langue contrôle les conventions de langue et de paramètres régionaux de la chaîne de date de sortie. 0 (valeur par défaut) signifie "Utiliser la langue du compte". 2 signifie "Utiliser la langue du document". La valeur de langue 1 est réservée pour une utilisation ultérieure). Toute autre valeur de langue est interprétée comme un identifiant de langue spécifique, par exemple en_US signifie "Anglais (Etats-Unis)".
Voir Identifiants de langue.
L’attribut de longueur facultatif permet de limiter la longueur des chaînes affichées, avec une valeur par défaut de 80 caractères.
L’attribut facultatif encoding contrôle si la sortie est codée au format HTML, JavaScript, Perl, URL ou non codée, pour la sortie sur la page de résultats. La valeur par défaut du codage est html . Normalement, vous n’avez pas besoin de spécifier l’attribut de codage.
L’attribut de guillemets facultatifs contrôle si la sortie des éléments individuels est entourée de guillemets doubles (ou de guillemets simples, si encoding=perl ). La valeur par défaut des guillemets est non .
L’attribut facultatif virgules contrôle si la sortie des éléments individuels est séparée par des virgules. La valeur par défaut des virgules est yes . L’attribut virgules est ignoré pour les champs non de type liste.
L’attribut Unités facultatives contrôle les unités de distance appliquées à un champ de sortie de recherche de proximité. La valeur par défaut des unités est déterminée à partir du paramètre "Unités par défaut" du champ location-type associé au champ de sortie de recherche de proximité donné.
Voir A propos de la recherche de proximité.
L’attribut facultatif Separator définit le caractère unique, ou délimiteur, inséré entre les valeurs de la sortie pour les champs de type liste.
12
<search-display-field-values name="field-name"> ...<search-display-field-values>
Cette balise crée une boucle pour l’énumération des valeurs de champ de métadonnées (url, title, desc, keys, target, body, alt, date, charset et langue ou des champs définis sous Options > Métadonnées > Définitions ) pour le résultat actuel. N’imbriquez pas cette balise dans une autre <search-display-field-values> . L’ attribut name spécifie le nom du champ contenant les valeurs à énumérer. Cette balise est particulièrement utile lorsque l’attribut Autoriser les listes est coché (sous Options > Métadonnées > Définitions ).
13
<search-display-field-value date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none">
Cette balise génère la valeur du champ de métadonnées (url, title, desc, keys, target, body, alt, date, charset et langue ou des champs définis sous Options > Métadonnées > Définitions ) pour l’itération de la boucle active <search-display-field-values> . Cette balise n’est valide que dans une boucle <search-display-field-values> . Les attributs de format de date , gmt et de langue ne sont pertinents que si le type de contenu du nom de champ spécifié dans la balise <search-display-field-values> est date . L’attribut format-date utilise une chaîne de format de date de style UNIX, telle que "%A , %B %d , %Y " (pour "Lundi, 25 juillet 2016"). L’attribut gmt prend par défaut la valeur oui et contrôle si la partie Heure de la chaîne de date est générée en GMT ( oui ) ou le fuseau horaire du compte ( pas de ).
L’ attribut de langue contrôle les conventions de langue et de paramètres régionaux de la chaîne de date de sortie. 0 (valeur par défaut) signifie "Utiliser la langue du compte". Toute autre valeur de langue est interprétée comme un identifiant de langue spécifique, par exemple en_US signifie "Anglais (Etats-Unis)".
L’attribut facultatif encoding contrôle si la sortie est codée au format HTML, JavaScript, Perl, URL ou non codée, pour la sortie sur la page de résultats. La valeur par défaut du codage est html . Normalement, vous n’avez pas besoin de spécifier l’attribut de codage.
14
<search-display-field-value-count name="field-name">
Génère le nombre total de valeurs dans le résultat actuel pour le champ de métadonnées (url, title, desc, keys, target, body, alt, date, charset et langue ou les champs définis sous Options > Métadonnées > Définitions ) spécifiés avec l’attribut name. Cette balise peut apparaître n’importe où dans la boucle de résultats.
15
<search-display-field-value-compteur>
Génère le compteur ordinal (1, 2, 3, etc.) pour l’itération en boucle actuelle de <search-display-field-values>. Cette balise n’est valide que dans une boucle <search-display-field-values> .
16
<search-dynamic-facet-fields>
Commence un contexte de boucle pour les champs de facettes dynamiques renvoyés pour cette recherche.
17
<search-dynamic-facet-field-name>
Génère le nom du champ de facette dynamique actuel pour cette itération de boucle.
18
<search-result-trace encoding="html/javascript/ json/perl/url/none">
Génère des informations relatives à l’emplacement du résultat actuel, par exemple, toute action basée sur les résultats qui affecte la position du résultat.
Le format de sortie de cette balise est JSON, comme dans l’exemple suivant :
{   "sliceID": 5,   "indexID": 5894,   "finalScore": 98.5,   "dynamicScore": 15.3,   "staticScore": 55.456,   "position": 1,   "rbtaActionListID": 117,   "rbtaActionID": 57 }
L’ attribut de codage est facultatif ; la valeur par défaut est html .
Remarque : Cette balise n’a de sortie que si sp_trace=1 est spécifié avec les paramètres de requête de recherche principaux.
Reportez-vous à la ligne 48 du tableau figurant dans les paramètres Paramètres CGI de recherche principale CGI de recherche en arrière-plan.

Balises conditionnelles de boucle de résultats

Les balises suivantes incluent de manière conditionnelle le code HTML entre elles.
Voir A propos des balises de boucle Résultats.
Baliser
Description
1
<search-if-title> ... </search-if-title>
<search-if-not-title>... </search-if-not-title>
Ces balises comprennent le code HTML entre elles si l’appel suivant à <search-title> renvoie (ou ne renvoie pas) du texte du titre du document.
2
<search-if-description length="XX"> ... /search-if-description>
<search-if-not-description>... </search-if-not-description>
Ces balises comprennent le code HTML entre elles si l’appel suivant à <search-description> renvoie (ou ne renvoie pas) du texte de la description du document.
3
<search-if-body-text>... </search-if-body-text>
<search-if-not-body-text>... </search-if-not-body-text>
Ces balises comprennent le code HTML entre elles si l’appel suivant à <search-body text> renvoie (ou ne renvoie pas) du texte du corps du document.
4
<search-if-context length="XX"> ... </search-if-context>
<search-if-not-context> ... </search-if-not-context>
Ces balises comprennent le code HTML entre elles si l’appel suivant à <search-context> renvoie (ou ne renvoie pas) une chaîne de contexte non vide. L’attribut length remplace l’attribut length sur toute balise <search-context> .
5
<search-if-any-context length="XX"> ... /search-if-any-context>
<search-if-not-any-context> ... </search-if-not-any-context>
Ces balises incluent le code HTML entre elles s’il existe (ou n’est pas) une chaîne contextuelle associée au résultat. L’attribut length remplace l’attribut length sur toute balise <search-context> .
6
<search-if-score lower="XX" upper="yy" level="dynamic/static-raw/static-raw/static-raw/final-raw">... </search-if-score>
<search-if-not-score lower=XX upper=yy grade="dynamic/static">>... </search-if-not-score>
Ces balises incluent le code HTML entre elles si le score du résultat actuel est (ou n’est pas) compris entre XX et YY. Utile pour ajouter des puces ou des graphiques afin de montrer à quel point le résultat est pertinent. Si vous avez défini un champ de type de classement sous Options > Métadonnées > Définitions , vous pouvez vérifier le classement dynamique des pages en définissant l’attribut de classement sur dynamique ( <search-if-score grade="dynamic" lower=XX upper=YY> ). Vous pouvez vérifier le classement des pages statiques en définissant l’attribut de classement sur statique ( <search-if-score grade="static" lower=XX upper=YY> ).
7
<search-if-field name="field-name" value="value"> ... </search-if-field>
<search-if-not-field name="field-name" value="value"> ... </search-if-not-field>
Ces balises avancées incluent le code HTML entre elles selon que le champ spécifié dans l’attribut "name" contient ou non du contenu. Si l’attribut "value" facultatif est spécifié, les balises incluent le code HTML entre elles selon que la valeur donnée correspond (ou non) à la valeur du champ dans le résultat actuel. Ces balises fonctionnent uniquement dans la boucle de résultats (entre les balises <search-results> et </search-results> ).

Balises de lien d’ancrage de boucle de résultats

Voir A propos des balises de boucle Résultats.
Baliser
Description
1
<search-link target="frame-name" hbx-enable="yes/no" hbx-linkid-name="field-name" hbx-linkid-none="text" hbx-linkid-length="XX" > ... </search-link>
Cette paire de balises crée un lien d’ancrage autour du code HTML entre ces deux balises. Lorsque vous cliquez sur le lien, la page des résultats s’affiche. Un attribut cible facultatif spécifie la fenêtre nommée dans laquelle les navigateurs capables d’afficher les images doivent afficher la page de résultats.
Définissez l’attribut hbx-enable sur "yes" pour tirer parti des analyses disponibles via HBX. Définissez hbx-linkid-name sur le nom d’un champ de métadonnées dont vous souhaitez effectuer le suivi. Par exemple, pour suivre les résultats de la recherche par numéro de SKU, définissez hbx-linkid-name sur le nom du champ Meta-data qui contient les informations de SKU.
Les champs de type de date ne sont actuellement pas pris en charge. La valeur de hbx-linkid-name est ajoutée à l’ID de lien dans l’ancre générée. La valeur de l’attribut hbx-linkid-none est ajoutée à l’ID de lien chaque fois que le champ Meta-data nommé est vide. La valeur de hbx-linkid-length limite le nombre de caractères récupérés et affichés à partir de la balise Meta. Le nombre de caractères par défaut est 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>
Cette paire de balises est similaire au <lien de recherche> ... </search-link> balises. Lorsque vous cliquez sur les liens d’ancrage générés, la page de résultats s’affiche, mais avec le défilement de la page vers la balise d’ancrage la plus proche précédant le résultat. Pour les liens PDF, la visionneuse Acrobat affiche la page qui contient le résultat. Un attribut cible facultatif spécifie la fenêtre nommée dans laquelle les navigateurs capables d’afficher les images doivent afficher la page de résultats.
Définissez l’attribut hbx-enable sur "yes" pour tirer parti des analyses disponibles via HBX. Définissez hbx-linkid-name sur le nom d’un champ de métadonnées dont vous souhaitez effectuer le suivi. Par exemple, pour suivre les résultats de la recherche par numéro de SKU, définissez hbx-linkid-name sur le nom du champ Meta-data qui contient les informations de SKU.
Les champs de type de date ne sont actuellement pas pris en charge. La valeur de hbx-linkid-name est ajoutée à l’ID de lien dans l’ancre générée. La valeur de l’attribut hbx-linkid-none est ajoutée à l’ID de lien chaque fois que le champ Meta-data nommé est vide. La valeur de hbx-linkid-length limite le nombre de caractères récupérés et affichés à partir de la balise Meta. Le nombre de caractères par défaut est 12.
3
<search-if-link-extension>... </search-if-link-extension>
<search-if-not-link-extension>... </search-if-not-link-extension>
Ces balises comprennent le code HTML entre elles si un attribut de valeur spécifie une extension qui correspond à la fin de l’URL du résultat. Cette balise est utile pour inclure un graphique dans les résultats de la recherche en fonction de l’extension du lien. L’attribut value est une liste d’une ou de plusieurs extensions (espacement), comme suit : VALUE=".pdf" ou VALUE=".html.htm".

Balises conditionnelles de position de boucle

Les balises suivantes incluent de manière conditionnelle le texte entre elles. Ils ne peuvent apparaître qu’à l’intérieur des balises de boucle : < search-results> et <search-field-values> . Ils sont utilisés pour tester la position du résultat actuel dans le jeu de résultats.
Voir A propos des balises de boucle Résultats.
Baliser
Description
1
<search-if-first> ... </search-if-first>
<search-if-not-first> ... </search-if-not-first>
Ces balises comprennent le texte entre elles si le résultat actuel est (ou n’est pas) le premier résultat sur la page (lorsqu’il est utilisé dans <search-results> ) ou la première valeur de champ (lorsqu’il est utilisé dans <search-field-values> ).
2
<search-if-last> ... </search-if-last>
<search-if-not-last> ... </search-if-not-last>
Ces balises comprennent le texte entre elles si le résultat actuel est (ou n’est pas) le dernier résultat sur la page (lorsqu’il est utilisé dans <search-results> ) ou la dernière valeur de champ (lorsqu’il est utilisé dans <search-field-values> ). Cette balise peut être utilisée pour insérer un séparateur entre les résultats. Par exemple, une balise <hr> est insérée entre les résultats :
<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>
Ces balises comprennent le texte entre elles si le résultat actuel n’est ni le premier ni le dernier résultat de la page (lorsqu’il est utilisé dans <search-results> ), ni la première ni la dernière valeur du champ (lorsqu’il est utilisé dans <search-field-values> ). La version "not" de la balise teste si le résultat est le premier ou le dernier.
4
<search-if-alt>... </search-if-alt>
<search-if-not-alt> ... </search-if-not-alt>
Ces balises comprennent le texte entre elles si le résultat actuel est (ou n’est pas) un résultat alternatif sur la page (lorsqu’il est utilisé dans <search-results> ) ou une autre valeur de champ (lorsqu’il est utilisé dans <search-field-values> ). Les résultats "alternatifs" sont les deuxième, quatrième, sixième, etc., sur la page. Cet exemple applique une classe différente aux rangées de tableau de remplacement. Notez l’utilisation des balises <search-lt> et <search-gt> pour permettre de placer la balise <search-if-alt> dans la balise <tr> .
    <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>
Ces balises comprennent le texte entre elles si le résultat actuel est (ou n’est pas) un résultat pair (lorsqu’il est utilisé à l’intérieur de <search-results> ) ou une valeur de champ pair (lorsqu’il est utilisé à l’intérieur de <search-field-values> ). Un résultat de recherche est pair si sa valeur <search-index> est paire. En d’autres termes, si sa position dans l’ensemble du jeu de résultats est égale. Cela peut être différent de <search-if-alt> qui teste la position d’un résultat sur la page et non dans l’ensemble du jeu de résultats. Les deux tableaux suivants illustrent cette différence :

Première page, sp_n=1

Index
Résultats
Même ?
Alt ?
1
Premier résultat
Non
Non
2
Second résultat
Oui
Oui
3
Troisième résultat
Non
Non
4
Quatrième résultat
Oui
Oui
5
Cinquième résultat
Non
Non

Page suivante, sp_n=10

Index
Résultats
Même ?
Alt ?
10
Dixième résultat
Oui
Non
11
Onzième résultat
Non
Oui
12
Douzième résultat
Oui
Non
13
Treizième résultat
Non
Oui
14
Quatorzième résultat
Oui
Non
Enfin, notez que <search-if-even> c’est toujours la même chose que <search-if-alt> pour les valeurs de champ de recherche, car les valeurs de champ ne sont pas paginées.

Balises de liste de valeurs de champ

Les balises avancées suivantes génèrent des valeurs de champ et des données associées à partir de l’ensemble des résultats de recherche. Ces balises ne génèrent que des résultats pour les champs spécifiés par les paramètres sp-sfvl-field CGI dans la requête de recherche.
Baliser
Description
1
<nom-champ-valeur-liste-nom-champ="nom-champ" guillemets="oui/non" virgules="oui/non" data="valeurs/nombres/résultats" separator="X" sortby="aucun/valeurs/nombres/résultats" max-items="XX" format-date="chaîne-format-date" gmt="oui/non" language="0/language-id" html="encodage" ascript/json/perl/url/none">
Cette balise affiche une liste de valeurs de champ uniques, de valeurs ou de résultats dans l’ensemble du jeu de résultats.
Cette balise ne génère une sortie que pour les champs spécifiés par les paramètres sp_sfvl_field CGI dans la requête de recherche. L’attribut "guillemets" facultatif contrôle si la sortie des éléments individuels est entourée de guillemets doubles (ou de guillemets simples, si encoding=perl). La valeur par défaut de "quotes" est "yes". L’attribut facultatif "virgules" contrôle si la sortie des éléments individuels est séparée par des virgules. La valeur par défaut de "virgules" est "yes". L’attribut "data" facultatif contrôle si chaque valeur de champ unique est une sortie (data="valeurs"), le nombre total de chaque valeur de champ unique est une sortie (data="counts") ou le nombre de résultats contenant chaque valeur unique (data="results") est une sortie. La valeur par défaut de "data" est "values". Pour les champs non de type liste, data="counts" et data="results" sont équivalents. L’attribut separator définit le caractère unique, ou délimiteur, à insérer entre les valeurs de la sortie. L'attribut facultatif "sortby" contrôle l'ordre de la sortie; sortby="none" signifie aucun ordre particulier, sortby="valeurs" signifie le tri par valeurs de champ (dans l’ordre croissant ou décroissant selon la propriété de tri du champ), sortby="counts" signifie le tri dans l’ordre décroissant des valeurs de champ et sortby="results" signifie le tri dans l’ordre décroissant du nombre de résultats contenant chaque valeur.
Notez que sortby="counts" et sortby="results" sont équivalents pour les champs non-list-type. L’attribut facultatif "max-items" limite le nombre d’éléments à générer. La valeur par défaut de "max-items" est -1, ce qui signifie "output all items".
Il existe une limite absolue de 100 pour les éléments max.. Les attributs "date-format", "gmt" et "langue" ne sont pertinents que si le type de contenu du champ spécifié est "date". L’attribut "date-format" utilise une chaîne de format de date de style UNIX telle que "%A, %B %d, %Y" (pour "Lundi, 25 juillet 2016"). "gmt" est défini par défaut sur "yes" et contrôle si la partie "time" de la chaîne de date doit être générée en GMT ("yes") ou le fuseau horaire du compte ("no").
Voir Chaînes de format de date.
L’attribut "language" contrôle les conventions de langue et de paramètres régionaux de la chaîne de date de sortie. "0" (valeur par défaut) signifie "Utiliser la langue du compte". Toute autre valeur "language" est interprétée comme un identifiant de langue spécifique, par exemple, "en_US" signifie "English (United States)". L’attribut "encoding" facultatif contrôle si les caractères de la chaîne de sortie sont codés au format HTML, JavaScript, Perl, URL ou non codés, pour une sortie sur la page de résultats. La valeur par défaut de "encoding" est "html".
Voir Identifiants de langue.
2
<nom-champ-valeur-liste-nom-champ="nom-champ" valeur="valeur-champ" résultats="oui/non">
Cette balise affiche les informations de nombre pour une liste de valeurs de champ de recherche donnée. Il existe trois utilisations distinctes pour cette balise. Si seul l’attribut "name" est fourni, cette balise génère le nombre de valeurs uniques pour le champ nommé dans l’ensemble des résultats. Si les attributs "name" et "value" sont tous deux fournis, cette balise indique soit le nombre total de la valeur donnée dans l’ensemble du jeu de résultats (pour results="no"), soit le nombre total de résultats contenant la valeur donnée dans l’ensemble du jeu de résultats (pour results="yes"). La valeur par défaut de "results" est "no". Remarque : Pour les champs qui ne sont pas de type liste, les résultats="yes" et les résultats="no" sont équivalents. La valeur de "results" est ignorée si l’attribut "value" n’est pas fourni. Cette balise ne génère une sortie que pour les champs spécifiés par les paramètres sp-sfvl-field CGI dans la requête de recherche.
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>
Ces balises affichent le code HTML entre elles si l’appel équivalent à <search-field-value-list-count name="field-name" value="field-value"> avec les attributs donnés renvoie (ou ne renvoie pas) une valeur supérieure à zéro.
4
<search-if-single-field-value-list-count name="field-name">> ... </search-if-single-field-value-list-count>
Ces balises affichent le contenu entre elles si l’appel équivalent à <search-field-value-list-count name="field-name" value="field-value"> avec les attributs donnés renvoie (ou ne renvoie pas) une seule valeur. Cette méthode est généralement utilisée lorsqu’un compte utilise des emplacements de facettes. Avec les emplacements de facette, vous ne souhaitez généralement afficher l’emplacement de valeur que lorsque l’emplacement de nom associé comporte un seul élément. Cette vérification dans le modèle de transport est plus efficace que dans la couche de présentation.

Balises de boucle de liste de valeurs de champ

Les balises avancées suivantes énumèrent et génèrent les valeurs des champs et les données associées de l’ensemble des résultats de recherche à l’aide d’une méthode de boucle. Ces balises ne génèrent que des résultats pour les champs spécifiés par les paramètres sp-sfvl-field CGI dans la requête de recherche.
Baliser
Description
1
<search-field-values name="field-name" sortby="none/values/counts/results" max-items="XX"> ... </search-field-values>
Cette balise crée une boucle pour l’énumération des valeurs de champ et des données associées pour un champ particulier dans l’ensemble des résultats. N’imbriquez pas cette balise dans une autre <search-field-values> balise . L’attribut "name" spécifie le nom du champ contenant les valeurs à énumérer. L’attribut facultatif "sortby" contrôle l’ordre d’énumération : "none" signifie pas d’ordre particulier, "values" signifie le tri par valeurs de champ (dans l’ordre croissant ou décroissant selon la propriété de tri du champ), sortby="counts" signifie le tri dans l’ordre décroissant des valeurs de champ, et sortby="results" signifie le tri dans l’ordre décroissant du nombre de résultats contenant chaque valeur.
Notez que sortby="counts" et sortby="results" sont équivalents pour les champs non-list-type. . L’attribut facultatif "max-items" limite le nombre d’itérations à la valeur donnée. La valeur par défaut de "max-items" est -1, ce qui signifie "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">
Cette balise génère la valeur du champ pour l’itération de boucle <search-field-values> actuelle. Cette balise n’est valide que dans une boucle <search-field-values> . Les attributs "date-format", "gmt" et "language" ne sont pertinents que si le type de contenu du nom de champ spécifié dans la balise <search-field-values> englobante est "date". L’attribut "date-format" utilise une chaîne de format de date de style UNIX telle que "%A, %B %d, %Y" (pour "Lundi, 25 juillet 2020").
Voir Chaînes de format de date.
L’attribut "encoding" facultatif contrôle si les caractères de la chaîne de sortie sont codés au format HTML, JavaScript, Perl, URL ou non codés, pour une sortie sur la page de résultats. La valeur par défaut de "encoding" est "none". Normalement, vous n’avez pas besoin de spécifier l’attribut de codage. "gmt" est défini par défaut sur "yes" et contrôle si la partie "time" de la chaîne de date doit être générée en GMT ("yes") ou le fuseau horaire du compte ("no"). L’attribut "language" contrôle les conventions de langue et de paramètres régionaux de la chaîne de date de sortie. "0" (valeur par défaut) signifie "Utiliser la langue du compte". Toute autre valeur "language" est interprétée comme un identifiant de langue spécifique, par exemple, "en_US" signifie "English (United States)".
Voir Identifiants de langue.
3
<search-field-value-count results="yes/no">
Cette balise génère le nombre associé à l’itération de boucle <search-field-values> en cours. Le nombre de résultats est soit le nombre de résultats dans l’ensemble des résultats contenant la valeur du champ (results="yes"), soit le nombre total de la valeur du champ dans l’ensemble des résultats. La valeur par défaut de "results" est "no".
Pour les champs qui ne sont pas de type liste, les résultats="yes" et les résultats="no" sont équivalents. Cette balise n’est valide que dans une boucle <search-field-values> .
4
<search-field-value-compteur>
Cette balise génère le compteur ordinal pour l’itération de boucle actuelle <search-field-values>. Cette balise n’est valide que dans une boucle <search-field-values> .

Suggérer des balises

Suggest fournit un "Voulez-vous dire ?" convivial pour suggérer d’autres termes de recherche. Si un utilisateur a mal orthographié un terme de recherche, par exemple, Suggérer peut l’aider à trouver des résultats en suggérant une orthographe correcte. Le système peut également suggérer des mots-clés apparentés qui peuvent aider un utilisateur à découvrir des résultats. Lors de la génération de suggestions, le service Suggestion utilise deux dictionnaires : l’une basée sur la langue du compte (définie sous Indexing > Words and Languages > Language ) et l’autre créée de manière unique à partir des mots-clés de l’index du compte.
Le service Suggest ne fonctionne pas pour le chinois, le japonais ou le coréen.
Baliser
Description
1
<search-if-suggestions>... </search-if-suggestions>
Entourez ces balises avec les balises de modèle "Suggérer", telles que <suggestion-recherche> , <lien-suggestion-recherche> , etc. Si la recherche génère des suggestions, le moteur de recherche génère et traite tout entre les balises open et close. Si la recherche ne génère pas de suggestions, aucun contenu imbriqué n’est généré.
2
<search-suggestions>... </search-suggestions>
Cette balise génère la boucle "Suggérer", qui contient une liste de termes de recherche suggérés (par exemple, "compte", "intention" et "intention", pour une requête saisie à l’origine comme "intentions"). Lors de la génération de la liste de termes, le moteur de recherche répète jusqu’à cinq fois les balises HTML et/ou de modèle imbriquées, ce qui correspond au nombre maximum de suggestions. Utilisez l’attribut count pour spécifier le nombre de suggestions générées (entre 0 et 5).
La balise <search-suggestions> peut apparaître plusieurs fois sur la page pour répéter la liste des suggestions. Plusieurs suggestions sont triées en fonction du nombre de résultats que chacun produit.
Imbriquez la balise <search-suggestions> entre les balises open et close <search-if-suggestions> .
3
<search-suggestion-link> ... </search-suggestion-link>
Cette balise génère un lien vers la requête de recherche d’origine à l’aide du terme de recherche suggéré sélectionné au lieu du terme d’origine. La balise accepte et imprime simplement tout attribut HTML tel que class, target et style. La balise peut également accepter un attribut d’URL, dont la valeur est utilisée comme URL de base pour le lien généré. Les balises ne peuvent apparaître qu’à l’intérieur de la boucle <search-suggestions> .
4
<search-suggestion-text/>
Cette balise imprime le terme de requête actuellement suggéré (par exemple, "compte" pour une requête saisie à l’origine comme "compte"). La balise n’a aucun attribut et ne peut apparaître qu’à l’intérieur de la boucle <search-suggestions> .
5
<search-if-not-suggestions>... </search-if-not-suggestions>
Si la recherche ne génère aucune suggestion, le moteur de recherche génère et traite tout entre la balise d'ouverture et la balise de fermeture. Si la recherche génère des suggestions, aucun contenu imbriqué n’est généré.
6
<search-if[-not]-first-suggestion>... </search-if[-not]-first-suggestion>
Ces balises conditionnelles incluent le code HTML entre elles selon que le terme suggéré est le premier terme de la boucle Suggérer. Les balises doivent apparaître entre les balises open et close <search-suggestion> .
7
<search-if[-not]-last-suggestion>... </search-if[-not]-last-suggestion>
Ces balises conditionnelles incluent le code HTML entre elles selon que le terme suggéré est le dernier terme de la boucle Suggérer. Les balises doivent apparaître entre les balises open et close <search-suggestion> .
8
<search-suggestion-index>
Cette balise renvoie l’index numérique du terme de recherche suggéré actuel. La balise doit apparaître entre les balises open et close <search-suggestion> .
9
<search-suggestion-total>
Cette balise renvoie le nombre total de termes de recherche suggérés générés. La balise doit apparaître entre les balises open et close <search-suggestion> .
10
<search-suggestion-result-count>
Cette balise renvoie le nombre total de résultats pour le terme de recherche suggéré. La balise doit apparaître entre les balises open et close <search-suggestion> .

Balises de chaîne de modèle

Les balises suivantes génèrent une chaîne dans le code HTML à ce stade du modèle.
Baliser
Description
1
<search-body>
Balise de contenu HTML avec les paramètres de couleur du lien de recherche que la section Aspect de base définit sous le lien Modèle. Ajoutez un attribut d’arrière-plan à cette balise pour afficher les images d’arrière-plan sur la page de résultats. Les attributs de couleur ajoutés à cette balise remplacent les paramètres de couleur du lien de recherche définis par la section Aspect de base.
2
<search-header>
Code HTML de l’en-tête des résultats de recherche tel que défini dans la section Aspect de base sous le lien Modèle.
3
<search-cdata> ... </search-cdata>
Les balises search-data sont remplacées par leurs équivalents XML : <search-cdata> est remplacé par <![CDATA[" et la balise </search-cdata> est remplacée par " ]]> ". Un analyseur XML n’analyse aucune information entre les balises open et close.
4
<search-query-query-number="XX" encoding="html/javascript/json/perl/url/none">
Requête saisie par le visiteur. L’attribut avancé facultatif "query-number" contrôle quelle chaîne de requête numérotée est générée par cette balise. Par exemple, <search-query query-query-number=1> génère le contenu du paramètre cgi sp_q_1. Si "query-number" n’est pas spécifié ou si query-number est "0", la requête principale ( sp_q ) est générée. L’attribut "encoding" facultatif contrôle si la sortie est codée au format HTML, JavaScript, Perl, URL ou non codée, pour la sortie sur la page de résultats. La valeur par défaut de "encoding" est "html". Normalement, vous n’avez pas besoin de spécifier l’attribut de codage.
5
<search-total>
Nombre total de résultats pour cette recherche.
6
<search-count>
Nombre de résultats signalés pour cette page.
7
<search-lower>
Numéro du premier résultat rapporté pour cette page.
8
<search-upper>
Numéro du dernier résultat rapporté pour cette page.
9
<search-prev-count>
Nombre de résultats signalés pour la page précédente.
10
<search-next-count>
Nombre de résultats signalés pour la page suivante.
11
<search-time>
Temps en secondes pour cette recherche.
12
<search-logo>
Code HTML du logo de recherche configuré pour votre compte, le cas échéant. Ce logo est l'image qui attribue du crédit à la recherche/marchandisage sur le site
Pour le moment, la plupart des comptes n’ont pas de logo de recherche associé.
13
<search-collection all="name">
Collection des résultats de cette recherche. L’attribut facultatif "all" est utilisé pour indiquer le nom de la collection qui représente l’ensemble du site Web.
14
<search-form>...</search-form>
Insère les balises de formulaire de début et de fin. Insère les attributs de méthode et d’action dans la balise de début de formulaire. Accepte d’autres attributs, notamment l’attribut dir="RTL" pour le langage, ainsi que les attributs "name" et "onSubmit" liés à JavaScript.
15
<search-input-account>
Insère une balise d’entrée de formulaire qui spécifie le numéro de compte.
16
<search-input-gallerie>
Insère une balise d’entrée de formulaire qui spécifie le numéro de la galerie.
17
<search-input-query-query-number="XX">
Insère une balise d’entrée de formulaire qui spécifie la chaîne de requête. L’attribut avancé facultatif "query-number" contrôle quelle requête numérotée est utilisée pour la balise d’entrée de formulaire. Par exemple, <search-input-query-query-number=1> génère une balise d’entrée de formulaire pour la requête sp_q_1. Si "query-number" n’est pas spécifié ou si "query-number" est "0", une balise d’entrée pour la requête sp_q principale est insérée.
18
<search-input-collections all="name">
Insère une balise de sélection de formulaire et le code HTML associé qui affiche le menu de sélection des collections. L’attribut facultatif "all" est utilisé pour indiquer le nom de la collection qui représente l’ensemble du site Web.
19
<search-lt>
Insère la sortie de l’une des balises de modèle Rechercher dans d’autres balises HTML ou de modèle sur la page de résultats. <search-lt> insère un caractère inférieur à. L’utilisation de <search-lt> et <search-gt> permet d’échapper à la définition d’une balise afin que vous puissiez utiliser les balises de modèle de recherche comme valeurs d’attribut. Lorsque le modèle est généré en réponse à une recherche, un signe inférieur à (<) remplace la balise <search-lt> . Par exemple, <search-link> est équivalent à <search-lt>a href="<search-url>"<search-gt> .
20
<search-gt>
Insère la sortie de l’une des balises de modèle Rechercher dans d’autres balises HTML ou de modèle sur la page de résultats. <search-gt> insère un caractère supérieur à. L’utilisation de <search-lt> et <search-gt> permet d’échapper à la définition d’une balise afin que vous puissiez utiliser d’autres balises de modèle comme valeurs d’attribut. Lorsque le modèle est généré en réponse à une recherche, un signe supérieur à (>) remplace la balise <search-gt> . Par exemple, <search-link> est équivalent à <search-lt>a href="<search-url>"<search-gt> .
21
<search-param name="param-name" length="XX" encoding="html/javascript/json/perl/url/none">
Renvoie la valeur du paramètre cgi nommé "param-name" de la requête de recherche active. L’attribut "encoding" facultatif contrôle si la sortie est codée au format HTML, JavaScript, Perl, URL ou non codée, pour la sortie sur la page de résultats. La valeur par défaut de "encoding" est "html". Normalement, vous n’avez pas besoin de spécifier l’attribut de codage.
22
<search-trace encoding="html/javascript/ json/perl/url/none">
L’ attribut de codage est facultatif ; la valeur par défaut est json .
Remarque : Cette balise n’a de sortie que si sp_trace=1 est spécifié avec les paramètres de requête de recherche principaux.
Reportez-vous à la ligne 48 du tableau figurant dans les paramètres Paramètres CGI de recherche principale CGI de recherche en arrière-plan.

Balises de lien d’ancrage de modèle

Les balises suivantes sont des balises qui provoquent un lien d’ancrage entourant le code HTML entre elles. Lorsque vous cliquez dessus, le lien d’ancrage demande l’affichage d’une autre page de résultats. L’attribut facultatif "count" demande que de nombreux résultats de la page s’affichent. Si elle n’est pas spécifiée, le nombre demandé sur la page active est utilisé. L’attribut "URL" facultatif avancé contrôle le domaine vers lequel le lien associé est dirigé. Par défaut, le domaine est https://search.atomz.com/search/ , mais vous pouvez le modifier à l’aide de l’attribut URL.
Baliser
Description
1
<search-next URL="https://search.yourdomain.com/search/">... </search-next>
<search-prev URL="https://search.yourdomain.com/search/"> ... </search-prev>
Affiche la page suivante ou précédente des résultats.
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>
Trie les résultats par date ou par pertinence.
3
<search-show-summary URL="https://search.yourdomain.com/search/"> ... </search-show-summary>
<search-hide-summary URL="https://search.yourdomain.com/search/"> ... </search-hide-summary>
Affiche ou masque les résumés.

Modèles de balises conditionnelles

Balises qui vous permettent d’inclure du code HTML de manière conditionnelle entre elles.
Baliser
Description
1
<search-if-results> ... </search-if-results>
<search-if-not-results>...</search-if-not-results>
Ces balises incluent du code HTML si la page active contient des résultats de recherche (ou pas).
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>
Ces balises incluent du code HTML si la page précédente ou suivante est associée à des résultats (ou aucun).
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>
Ces balises comprennent du code HTML si la page active est triée par pertinence ou par date.
4
<search-if-show-summary>... </search-if-show-summary>
<search-if-hide-summary>... </search-if-hide-summary>
Ces balises comprennent du code HTML si la page active affiche ou masque des résumés. Vous pouvez utiliser ces balises pour inclure ou exclure n’importe quelle partie des résultats de la recherche.
5
<search-if-input-collections>... </search-if-input-collections>
<search-if-not-input-collections>... </search-if-not-input-collections>
Ces balises incluent du code HTML si une collection a été spécifiée dans la génération des résultats de recherche pour la page active.
6
<search-if-advanced>... </search-if-advanced>
<search-if-not-advanced>... </search-if-not-advanced>
Ces balises incluent du code HTML si le paramètre sp_advanced=1 CGI a été spécifié pour la requête de recherche.
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>
Ces balises incluent ou excluent le code HTML entre elles si le paramètre donné est, ou non, non valide.
Actuellement, seul le paramètre sp_q_location[_#] est pris en charge.
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>
Ces balises avancées incluent le code HTML entre elles selon que le paramètre CGI spécifié dans l’attribut "name" a la valeur spécifiée dans l’attribut "value".
9
<search-if-sort-by-field name="field-name"> ... </search-if-sort-by-field>
<search-if-not-sort-by-field name="field-name"> ... </search-if-not-sort-by-field>
Ces balises avancées incluent le code HTML entre elles si la page active est ou n’est pas triée selon le nom de champ donné.

Modèles de balises de contrôle de formulaire

Balises qui vous permettent de contrôler l’état de sélection par défaut des cases à cocher, des boutons radio et des zones de liste dans un <form> modèle de recherche.
Baliser
Description
1
<search-input>
Utilisé dans un modèle à la place d’une balise <input> . Lorsque la balise est écrite dans le navigateur, le mot input remplace -search-input et toutes les autres informations de la balise sont output as-is. En outre, si le nom spécifié dans la balise est répertorié comme paramètre CGI et si la valeur spécifiée dans la balise est la valeur de ce paramètre CGI, le mot coché est ajouté à la fin de la balise . De cette manière, vous pouvez automatiquement définir l’état par défaut du bouton radio ou de la case à cocher dans le résultat de la recherche, de la même manière que la requête active.
Par exemple, le code HTML d’une case à cocher peut ressembler à ce qui suit :
<input type=checkbox name="sp_w" value="exact">Aucune correspondance de type son
Le code de modèle correspondant à cette case à cocher est le suivant :
<search-input type=checkbox name="sp_w" value="exact">Aucune correspondance de type son
Si la chaîne de paramètre CGI de la requête contient sp_w=exact , la balise écrite dans le navigateur avec les résultats de la recherche ressemble à ce qui suit (le mot coché est inséré à la fin de la balise) :
<input type=checkbox name="sp_w" value="exact" check>Aucune correspondance de type son
Si la chaîne de paramètre CGI de la requête ne contient pas sp_w=exact , la balise écrite dans le navigateur avec les résultats de la recherche ressemble à ce qui suit (le mot coché n’est pas répertorié dans la balise) :
<input type=checkbox name="sp_w" value="exact">Aucune correspondance de type son
La balise <search-input> est utile pour placer des cases à cocher et des boutons radio dans votre modèle de recherche. Si vous souhaitez ajouter des cases à cocher ou des boutons radio au <formulaire> dans votre modèle de recherche, utilisez <search-input...> à la place de <input...> .
2
<search-select>... </search-select>
<option de recherche>... </search-option>
Les zones de liste déroulante d’une balise <form> sont lancées avec une balise <select> et se terminent par une balise </select> . Le nom du paramètre CGI associé est répertorié dans la balise <select> . La balise <select> suivante est une liste de balises <option> qui spécifient les valeurs à afficher dans la zone de liste.
Les balises <search-select> , </search-select> , <search-option> et </search-option> offrent des fonctionnalités similaires à la balise <search-input> . En d’autres termes, le mot sélectionné est automatiquement ajouté à la fin de la balise <option> envoyée au navigateur si le nom dans la balise <search-select> est répertorié comme paramètre CGI et si la valeur de ce paramètre CGI est répertoriée comme valeur de dans une balise de <search-option> particulière. Ainsi, vous pouvez automatiquement faire en sorte que le choix de la zone de liste par défaut dans le résultat de la recherche soit identique à celui de la requête active.
Par exemple, une zone de liste type se présente comme suit :
<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>
Le code de modèle correspondant à cette zone de liste est le suivant :
<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>
Si vous souhaitez ajouter des zones de liste au <formulaire> dans votre modèle de recherche, utilisez <search-select...> à la place de <select...> , </search-select> à la place de </select> , de l'<search-option...> à la place du <option...> et du </search-option> à la place du </fr option>.
3
<nom_tri_par_champ="nom_champ" count="XX"> ... </search-sort-by-field>
Ces balises avancées créent un lien d’ancrage autour du code HTML entre elles. Lorsque vous cliquez sur cette ancre, une page de résultats triée sur le champ donné s’affiche. L’ attribut facultatif count spécifie le nombre de résultats à afficher sur la page de résultats. Si count est omis, le nombre utilisé sur la page active est utilisé.

Chaînes de format de date

Vous pouvez utiliser les spécifications de conversion suivantes dans les chaînes de format de date :
Chaîne de format de date
Description
%Une
Correspond à la représentation nationale du nom complet du jour de la semaine, par exemple "Lundi". Le paramètre dans Linguistique > Mots et langues > Langue détermine la représentation nationale.
%a
Correspond à la représentation nationale du nom abrégé du jour de la semaine, où l’abréviation est les trois premiers caractères, par exemple "Mon". Le paramètre dans Linguistique > Mots et langues > Langue détermine la représentation nationale.
%B
Correspond à la représentation nationale du nom complet du mois, par exemple "Juin". Le paramètre dans Linguistique > Mots et langues > Langue détermine la représentation nationale.
%b
Correspond à la représentation nationale du nom du mois abrégé, où l’abréviation est les trois premiers caractères, par exemple "Jun". Le paramètre dans Linguistique > Mots et langues > Langue détermine la représentation nationale.
%D
Équivalent à "%m/%d/%y", par exemple "25/07/13".
%d
Correspond au jour du mois en tant que nombre décimal (01-31).
%e
Correspond au jour du mois en tant que nombre décimal (1-31). Un blanc précède des chiffres uniques.
%H
Correspond à l’horloge de 24 heures sous la forme d’un nombre décimal (00-23).
%h
Correspond à la représentation nationale du nom abrégé du mois, où l’abréviation est les trois premiers caractères, par exemple "Jun" (identique à %b).
%I
Correspond à l’horloge de 12 heures sous la forme d’un nombre décimal (01-12).
%j
Correspond au jour de l’année sous forme de nombre décimal (001-366).
%k
Correspond à l’horloge (24 heures) sous la forme d’un nombre décimal (0-23). Un blanc précède des chiffres uniques.
%l
Correspond à l’horloge de 12 heures sous la forme d’un nombre décimal (1-12). Un blanc précède des chiffres uniques.
%M
Correspond à la minute sous forme de nombre décimal (00-59).
%m
Correspond au mois sous forme de nombre décimal (01-12).
%p
Correspond à la représentation nationale de "ante meridiem" ou "post meridiem" selon le cas, par exemple "PM". Le paramètre dans Linguistique > Mots et langues > Langue détermine la représentation nationale.
%R
Équivalent à "%H:%M", par exemple, "13:23".
%r
Équivalent à "%I:%M:%S %p", par exemple, "01:23:45 PM".
%S
Correspond au second nombre décimal (00-60).
%T
Équivalent à "%H:%M:%S", par exemple, "13:26:47".
%U
Correspond au numéro de semaine de l’année (dimanche comme premier jour de la semaine) sous forme de nombre décimal (00-53).
%v
Équivalent à "%e-%b-%Y", par exemple, "25-Jul-2013".
%O
Correspond à l’année avec le siècle comme nombre décimal, par exemple "2013".
%y
Correspond à l’année sans siècle comme nombre décimal (00-99).
%Z
Correspond au nom du fuseau horaire.
%%
Correspond à "%".

Identifiants de langue

Le tableau suivant contient les identifiants de langue pour chaque langue prise en charge. Vous pouvez utiliser ces identifiants comme valeurs pour l’attribut facultatif "language" dans les balises de modèle suivantes :
Langue
Identifiant de langue
Bulgare (Bulgarie)
bg_BG
Chinois (Chine)
zh_CN
Chinois (Hong Kong)
zh_HK
Chinois (Singapour)
zh_SG
Chinois (Taïwan)
zh_TW
Tchèque (République tchèque)
cs_CZ
Danois (Danemark)
da_DK
Néerlandais (Belgique)
nl_BE
Néerlandais (Pays-Bas)
nl_NL
Anglais (Australie)
en_AU
Anglais (Canada)
en_CA
Anglais (Grande-Bretagne)
en_GB
Anglais (États-Unis)
en_US
Français (Belgique)
fr_BE
Français (Canada)
fr_CA
Finnois (Finlande)
fi_FI
Français (France)
fr_FR
Français (Suisse)
fr_CH
Allemand (Autriche)
de_AT
Allemand (Allemagne)
de_DE
Allemand (Suisse)
de_CH
Grec (Grèce)
el_GR
Irlandais gaélique (Irlande)
ga_IE
Italien (Italie)
it_IT
Japonais (Japon)
ja_JP
Coréen (Corée)
ko_KR
Norvégien (Norvège)
no_NO
Polonais (Pologne)
pl_PL
Portugais (Brésil)
pt_BR
Portugais (Portugal)
pt_PT
Russe (ex-Union soviétique)
ru_SU
Slovaque (Slovaquie)
sk_SK
Slovaque (Slovénie)
sl_SI
Espagnol (Mexique)
es_MX
Espagnol (Espagne)
es_ES
Suédois (Suède)
sv_SE

Spécification de l’en-tête HTTP de type de contenu

Vous pouvez spécifier l’en-tête de réponse HTTP Content-Type à l’aide de la balise suivante :
<search-content-type-header [content="MIME-type"] [charset="charset-name"]>
Les attributs content et charset sont facultatifs. Cette balise doit apparaître le plus tôt possible dans le modèle. Il est également recommandé de l’afficher avant <search-html-meta-charset> ou <search-xml-decl> , car cela affecte le comportement de ces balises.
Si vous ne spécifiez pas l’ content attribut, la valeur de MIME-type est définie par défaut dans Settings > Crawling > Content Types . Si vous spécifiez un content attribut, il est utilisé comme content attribut par défaut pour la <search-html-meta-charset> balise .
Si vous ne spécifiez pas l’ charset attribut, aucune charset valeur n’est écrite dans l’ content-type en-tête.
Si vous spécifiez charset="1" alors la valeur réelle de charset-name est la valeur du paramètre sp_f CGI. Si aucun paramètre sp_f CGI n’est envoyé avec la recherche, la valeur réelle de charset-name est lue à partir des paramètres de votre compte. Vous pouvez afficher ou modifier le jeu de caractères associé à votre compte sous Settings > My Profile > Personal Information > Character Encoding .
Voir Configuration de vos informations d’utilisateur personnelles.
Vous pouvez choisir un nom de jeu de caractères spécifique en le répertoriant comme charset valeur, par exemple charset="iso-8859-1" ou charset="Shift-JIS" .
Si vous spécifiez un charset attribut, il est utilisé comme charset attribut par défaut pour les balises <search-html-meta-charset> et <search-xml-decl> , ainsi que comme sortie dans l’ content-type en-tête.

Spécification d’un jeu de caractères dans un modèle HTML

Les modèles de résultats de recherche HTML par défaut spécifient le jeu de caractères associé au compte actuel au moyen de la balise suivante :
<search-html-meta-charset [content="MIME-type"] [charset="charset-name"]>
Les attributs de contenu et de jeu de caractères sont facultatifs. Cette balise doit apparaître dans la section HTML <head> du modèle. Cette balise génère la balise suivante sur la page HTML générée à partir du modèle :
<meta http-equiv="content-type" content="MIME-type; charset=charset-name">
Si vous ne spécifiez pas l’attribut de contenu, la valeur réelle de MIME-type l’une des deux valeurs par défaut est l’une des deux. Si la <search-content-type-header> balise a spécifié un content attribut, cette valeur est utilisée. Sinon, la valeur utilisée est celle définie dans l’onglet Templates > Settings > Content Type .
Si vous ne spécifiez pas l’ charset attribut, la valeur réelle de charset-name l’attribut est définie par défaut sur l’une des deux valeurs. Si la <search-content-type-header> balise a spécifié un charset attribut, cette valeur est utilisée. Sinon, la valeur réelle de charset-name est lue à partir des paramètres de votre compte. Vous pouvez afficher ou modifier le jeu de caractères associé à votre compte sous Settings > My Profile > Personal Information > Character Encoding .
Voir Configuration de vos informations d’utilisateur personnelles.
Si vous spécifiez charset="1" alors la valeur réelle de charset-name est la valeur du paramètre sp_f CGI. Si aucun paramètre sp_f CGI n’est envoyé avec la recherche, la valeur réelle de charset-name est soit la valeur définie dans la <search-content-type-header> balise si elle a été spécifiée, soit la valeur définie dans les paramètres de votre compte.
Vous pouvez spécifier un nom de jeu de caractères spécifique, comme dans charset="charset-name" . For example, charset="iso-8859-1" or charset="Shift-JIS" .
La <search-html-meta-charset> balise est facultative. Si vous le supprimez, le navigateur utilise les valeurs par défaut pour content-type , à savoir : content="text/html; charset=ISO-8859-1" . Vous pouvez également choisir de remplacer la <search-html-meta-charset> balise par votre propre http-equiv balise.

Spécification d’un jeu de caractères dans un modèle XML

Le modèle de résultat de recherche XML par défaut spécifie le jeu de caractères associé au compte actuel au moyen de la balise suivante :
<search-xml-decl [charset="charset-name"]>
L’ charset attribut est facultatif. Cette balise doit apparaître en haut du modèle, mais après n’importe quelle <search-content-type-header> balise. Cette balise génère la balise suivante sur le document XML généré à partir du modèle :
<?xml version="1.0" encoding="charset-name" standalone="yes" ?>
Si vous ne spécifiez pas le charset , la valeur réelle de charset-name la variable est définie par défaut sur l’une des deux valeurs. Si <search-content-type-header> vous avez spécifié un charset attribut, cette valeur est utilisée. Sinon, la valeur réelle de charset-name est lue à partir des paramètres de votre compte. Vous pouvez afficher ou modifier le jeu de caractères associé à votre compte sous Settings > My Profile > Personal Information > Character Encoding .
Voir Configuration de vos informations d’utilisateur personnelles.
Si vous spécifiez charset="1" alors la valeur réelle de charset-name est la valeur du paramètre sp_f CGI. Si aucun paramètre sp_f CGI n’est envoyé avec la recherche, la valeur réelle de charset-name est soit la valeur définie dans la <search-content-type-header> balise si elle a été spécifiée, soit la valeur définie dans les paramètres de votre compte.
Vous pouvez spécifier un nom de jeu de caractères spécifique, comme dans charset="charset-name" le cas échéant. Par exemple, charset="iso-8859-1" or charset="Shift-JIS" .
Vous pouvez choisir de remplacer la <search-xml-decl> balise par votre propre ?xml balise.

Inclusion d’un modèle de recherche dans un autre

Pour inclure un modèle de recherche dans un autre, utilisez la <search-include> balise , en définissant l’attribut de fichier sur le nom du fichier de modèle à inclure, comme dans l’exemple suivant :
<search-include file="seo/seo_search_title.tpl" />
Les segments de modèles de recherche SEO se trouvent dans le seo/ sous-dossier et les modèles de recherche standard dans le templates/ sous-dossier. Seuls les fichiers .tpl sont significatifs à inclure dans ce contexte.

Gestion de plusieurs modèles de transport pour votre site Web

Vous pouvez contrôler l'apparence des résultats de recherche sur votre site Web en utilisant différents modèles de transport de recherche pour chaque zone.
Pour ce type de fonctionnalité de recherche, vous pouvez gérer vos modèles de transport dans la recherche/marchandisage de site. Vous pouvez également gérer vos modèles de transport dans Publier. Tout comme la recherche/le marchandisage sur le site, Publier vous permet de modifier, prévisualiser et publier plusieurs modèles de transport de recherche.
Pour configurer vos formulaires de recherche pour utiliser un modèle de transport spécifique (autre que le modèle par défaut), utilisez le paramètre de sp_t requête. Supposons, par exemple, que vous disposiez d’un modèle de recherche appelé "autorisation" pour la zone de vente délimitée de votre site Web. Vous utilisez le formulaire de recherche HTML standard avec le code de formulaire supplémentaire suivant :
<input type=hidden name="sp_t" value="clearance">
Lorsqu’un client clique sur un formulaire standard qui contient cette ligne de code, le modèle de transport de recherche "d’autorisation" s’affiche avec ses résultats de recherche.
Voir Exemple de formulaire de recherche avancée.