Modèles

Modèles

Balises de modèle de présentation

Liste de balises et d’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 sur le site/le marchandisage. Ces balises indiquent le format des résultats de recherche affichés par les clients.

Voir A propos des modèles.

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 la 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 gsname n'est spécifié, les résultats de la 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 la classe et la cible, 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. Voici l’exemple :

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

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 <guidé-result-field> (sauf lors de l’utilisation de balises générées automatiquement, telles que la balise <guidé-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 protégé par une séquence d’échappement différente de celle spécifiée dans le modèle de transport.

Ce codage est appliqué en plus du codage spécifié dans le modèle de transport.

5

<guided-if[-not]-result-field gsname="fieldname></guided-if-result-field>

Cet ensemble de balises conditionnelles est vrai si le contenu du champ spécifique doit être affiché. Si aucun contenu n’existe, la condition est définie sur false. Vous pouvez utiliser 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>

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ébut une nouvelle. Lorsqu’il s’agit de la dernière ligne, aucune nouvelle ligne n’est démarrée.

Voir <guidé-si-pas-dernier> 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 gsname 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 le jeu de résultats spécifié. Suppose la recherche par défaut lorsqu'aucun nom de domaine 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 de domaine 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 de domaine 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 détectés. Ou, n'affiche 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 la balise de transport <title> .

13

<guided-result-description/>

La balise <guided-result-description> donne la valeur du champ de modèle de transport de description spécifié avec la balise de transport <description> .

14

<guided-result-loc/>

La balise < guided-result-loc> donne la valeur du champ de modèle de transport loc spécifié avec la balise de transport <loc> .

15

&amp;lt;/guided-if-result-field&amp;gt; &lt;/code> &lt;/p> &lt;/td>

True si le champ spécifique contient du contenu à afficher. Si aucun contenu n’existe, la condition est définie sur 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"/>%20%20%20%20%20%20%20<guided-else-result-field>%20%20%20%20%20%20%20     <img src=?lang=fr"nothumb.jpg" class="nothumb"/>%20%20%20%20%20%20%20</guided-if-result-field>%20%3C/code%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%3C/tr%3E%20%20%20%3Ctr%3E%20%20%20%20%3Ctd%20colname=?lang=fr"col01">

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 l’affichage des 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="fieldname" [escape="html|url|js|json|0"]/>

Affiche le champ de 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;nbsp;nbsp;nbsp;nbamp;li&amp;gt;
&amp;nbsp;nbsp;nbsp;nbsp; sp ;&amp;amp ; nbsp ;&amp;amp ; lt ; a&amp;amp ; nbsp ; href=&quot;&amp;amp ; lt ; guided-result-attribute-table-field&amp;amp ; nbsp ; gsname=&quot;download_link&quot;&amp;amp ; nbsp ;/&amp;amp ; gt ; gt ;
&amp;amp ; nbsp ;&amp;amp ; nbsp ; nbsp ;&amp;amp ; nbsp ;;nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; lt ; guidé-result-attribute-table-field&amp;amp ; nbsp ; gsname=&quot;download_title&quot;&amp;amp ; nbsp ; gt;
&amp;amp ; nbsp ; nbsp ; amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; lt ; /a&amp;amp ; gt ;&amp;amp ; nbsp ;(&amp;amp ; lt ; guided-result field&amp;amp ; nbsp ; gsname=&quot;title&quot;/&amp;amp ; gt ;)
&amp;amp ; nbsp ; nbsp ;&amp;nbsp ; nlt ; /lp ; gt ;;
&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="searchname"]/>

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 facette pour afficher diverses facettes sur votre modèle de présentation. Vous référencez les facettes par nom.

Voir A propos des facettes.

Voir A propos de la rampe de facettes.

Voir A propos des facettesdynamiques.

Baliser

Description

1

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

Contexte de boucle pour toute facette dynamique pour une recherche donnée.

La balise de modèle de présentation <guidé-facet> est modifiée de sorte que l’attribut gsname soit automatiquement fourni par le contexte de boucle <guidé-dynamic-facets>.

2

<guided-facet-display-name gsname=" facetname "/>%20%3C/span%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%20%3Ctd%20colname=?lang=fr"col2">

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 l’étiquette.

3

<rail-facettes-guidé></rail-facettes-guidé>

Définit une section du modèle de présentation qui est utilisée comme modèle de répétition 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> car la valeur est déterminée de manière dynamique au moment de la recherche et remplacée correctement :

  • facette guidée
  • guidé-facette-nom-affichage
  • guidé-facette-total-count
  • guidé-facette-annuler-lien
  • guidé-facette-annulation-chemin
  • guidé-facette-comportement

Les critères de tri sur la page Facet Rail déterminent la position des facettes. Vous pouvez choisir l’ordre de tri dans la liste déroulante Méthode de tri des facettes.

Cette balise peut éventuellement accepter une valeur d’attribut gsname de _dynamic_facets , qui fournit un contexte de boucle pour toute facette dynamique de cette recherche. Ce rail de facettes prédéfini est également exposé dans l’interface utilisateur Règles métier pour l’action de la facette Push X dans le rail de facettes "_dynamic_facets" à la position Y ".

Voir A propos de la rampe de facettes .

Voir aussi A propos des facettes dynamiques .

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 à générer 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 en tant qu’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 guidé-si-facet-visible est entourée de celle-ci.

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 en tant qu’élément d’interface utilisateur différent (par exemple, 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 si l’utilisateur a cliqué sur une facette.

<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 <guidé-facet-rail> ou <guidé-dynamic-facets> .

&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; lt ; guided-if-facet-multiselect&amp;amp ; gt;
&amp;amp ; nbsp ; ...
&amp;amp ; nbsp ;&amp;amp ; lt ; guided-else-facet-multiselect&amp;amp ; gt;
&amp;amp ; nbsp ; ...
&amp;amp ; nbsp ;&amp;amp ; lt ;/guidé-if-facet-multiselect&amp;amp ; gt;
&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ; nbsp ;&amp;amp ; nbsp ; nbsp ; ...
&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; lt ; /guided-facet&amp;amp ; gt;
&amp;amp ; nbsp ;&amp;amp ; nbsp ;&amp;amp ; lt ; /guided-facet-rail&amp;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 gsname . Vous pouvez également le définir en dehors de tout bloc de facettes guidées, mais il faudrait que l’ attribut gsname identifie l’ensemble de valeurs de facettes qui s’affichent.

Vous pouvez également utiliser cette balise pour afficher les valeurs de facette en dehors du contexte d’un bloc de facettes guidé 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"]/>

Sort la chaîne de la valeur de facette actuelle.

Par défaut, la valeur est HTML escape. Vous pouvez utiliser l’option d’échappement pour modifier le mode d’échappement de la valeur.

11

<guided-facet-count/>

Sort le nombre de résultats correspondant à la valeur de facette actuelle.

12

<guided-facet-value-link [attr="value"]+></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 d’accès 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, dans la plupart des cas, il ne peut plus être lié.

<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 manquante 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ées. Attribuez un nom à la facette. Si la facette n’est pas actuellement sélectionnée, le lien correspond au 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

<guided-if-facet-long [gsname="facetname"]> <guided-else-facet-long></guided-if-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 en tant qu’élément d’interface utilisateur différent (par exemple, 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 si l’utilisateur clique sur une facette.

<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

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

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

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

Cette condition vous permet de vérifier si la facette spécifiée contient des valeurs. Vous pouvez l’utiliser pour afficher une autre facette plutôt qu’une facette vide.

20

<guided-facet-total-count gsname=" facetname "/>%20%3C/span%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%20%3Ctd%20colname=?lang=fr"col2">

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

Sort la chaîne d’une valeur associée à la facette. Au moins 0 champ peut être associé à une facette. Il est rare d’avoir des champs associés et, pour ce faire, vous pouvez configurer le modèle de transport.

22

<guided-if-facet-value gsname=" valeur de facette personnalisée associée "/><guided-else-facet-value></guided-if-facet-value>%20%3C/span%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%20%3Ctd%20colname=?lang=fr"col2">

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 d’accès 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 "séquence d’échappement" de l’URL. Vous pouvez toutefois ajouter un autre calque de codage en spécifiant le mode d’échappement à utiliser au moyen du paramètre escape.

25

<guided-facet-value-children></guided-facet-value-children>

À mesure 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 est imbriquée en boucle.

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 contient des valeurs enfants. Recommandé pour une utilisation avant d’utiliser les balises <guided-facet-value-children>. La clause "else" est facultative.

27

&amp;lt;guidé-else[-not]-facet-value-above-length-seuil&amp;gt;

&amp;lt;/guided-if[-not]-facet-value-above-length-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;guided-else[-not]-facet-value-equals-length-seuil&amp;gt;

&amp;lt;/guided-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 d’annulation en regard d’une valeur de facette sélectionnée. Ce lien d’annulation n’annulant que cette valeur sélectionnée, il diffère de <guidé-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 correspond au chemin d’accès actif. N’utilisez cette balise que dans une boucle guidée facet-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 "/>%20%3C/span%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%20%3Ctd%20colname=?lang=fr"col2">

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

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

Affichage conditionnel du code HTML lorsque la facette donnée comporte la valeur "value" sélectionnée ou une seule valeur. 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 "/>%20%3C/span%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%20%3Ctd%20colname=?lang=fr"col2">

Déterminez le comportement d’une facette (normale, collante ou à sélection multiple, par exemple). Il s’avère utile pour les clients qui reçoivent des résultats XML et qui 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 s’encapsulent autour de la facette.

Cette balise sert généralement à 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 de nombreux avantages en termes de performances par rapport à l’utilisation de zones.

Chemin de navigation

Voir A propos des chemins de navigation.

Baliser

Description

1

<guided-breadcrumb [gsname=" breadcrumbname "]></guided-breadcrumb>

Balise de boucle de la barre 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, la barre de navigation nommée "default" est utilisée.

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" (supprimer) ou "drop" (déposer). 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

<valeur-chemin-de-navigation-guidé />

La balise value imprime la valeur transformée de l’itération de chemin de navigation actuelle. Il n'est utilisé que dans le contexte d'un bloc de chemin de fer guidé.

<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>

4

<guidé-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. Il n'est utilisé que dans le contexte d'un bloc de chemin de fer 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 de chemin de navigation actuelle comporte une étiquette. Il est utilisé uniquement pour afficher les étiquettes et le contenu correspondant lorsqu'une étiquette existe réellement. Il n'est utilisé que dans le contexte d'un bloc de chemin de fer 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

Voir A propos des menus.

Baliser

Description

1

<menu guidé gsname="menuname"></menu guidé>

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'élément de menu.

3

<guided-menu-item-option [attr="value"]+ />

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 construction de la commande select, car elle génère le code HTML permettant de générer l’option de la commande 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 de la manière suivante :

<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 vue de toutes les pages d’une même 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.

6

<guided-if[-not]-page-prev> <guided-else-page- prev> </guided-if[-not]-page-prev>

Cet ensemble de balises conditionnelles est true 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 true 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 offre la possibilité de vue de tous les résultats. Par conséquent, vous pouvez utiliser cet ensemble de balises conditionnelles pour déterminer quand afficher le lien Tout Vue.

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 Pages de Vue. Il est généralement utilisé pour permettre à un client de vue 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 contenant 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 sur les pages.

13

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

<guidé-si-page-est-multipage> <guidé-else-page-is-multipage> </guidé-si-page-est-multipage>

Teste s’il existe une seule page de résultats 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>

Voir Configuration des recherchesrécentes.

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 de tout attribut HTML directement à la balise d’ancrage.

3

<guided-récent-searches-path/>

Permet de saisir le chemin d’URL relatif pour une recherche récente, dans une boucle de recherches guidées-récentes. En règle générale, vous utilisez un lien de recherche guidé-récent- . 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>

Vous permet de saisir le terme de requête associé à une recherche récente.

5

<guidé-récent-searches-clear-link [attr="valeur"]+></guided-récent-searches-clear-link>

Vous permet d’offre vos clients à la possibilité d’effacer les recherches récemment enregistrées.

6

<guided-récent-searches-clear-path/>

Renvoie le chemin d’accès 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>

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

Voir A propos de Vouliez-vous dire

Baliser

Description

1

<suggestions-guides></suggestions-guides>

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>

Permet de tester s’il existe des suggestions.

5

<guided-suggestion-path/>

Renvoie la chaîne de chemin d’accès à 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

<guidé-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-requête/>

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

Fin automatique

Vous pouvez utiliser les balises suivantes pour ajouter la saisie automatique à votre formulaire de recherche. Les balises head-content et form-content sont nécessaires 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 de la saisie semi-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 d’en-tête et de formulaire requis pour la saisie automatique. Cela vous permet d’activer et de désactiver la fonction et de ne pas avoir à modifier les modèles de présentation.

2

<guided-ac-css/>

Utilisé dans l’en-tête du modèle de présentation et remplacé par le script CSS approprié inclut 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".

Boutique

Utilisez les balises suivantes pour tester et afficher le magasin dans lequel se trouve actuellement un utilisateur.

Baliser

Description

1

<guidé-store/>

Sort le magasin actuel.

2

<guidé-si-store-defined> <guidé-else-store-defined> </guidé-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="linked search"] [facet="facet 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 quelle recherche ou facette est associée à la zone. Cette fonctionnalité permet au logiciel d’ignorer les recherches ou les facettes lorsqu’une zone est masquée, améliorant ainsi les performances de recherche en temps réel. 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 à la place 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 souhaitez afficher du contenu à un autre emplacement de la page 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-facettes-guidées
  • 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 le premier affiché. Si le visiteur du site se trouve à la page 2 d’un jeu de résultats qui est 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 affiché dans le contexte actuel (page). Si le visiteur du site se trouve à la page 1 d’un jeu de résultats qui contient 200 résultats mais n’en a que 10 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 augmente pour chaque itération de la boucle.

9

<guidée-boucle-compteur>

Entier (commençant par 1) dont la valeur augmente 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, telles que la création de votre propre mini-facette.

Baliser

Description

1

<guided-current-path [escape="html|url|js|json|0"] />

Donne le chemin d’accès 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 un chemin d’accès avec échappement d’URL. Vous pouvez spécifier le mode d’échappement à utiliser au moyen du paramètre escape.

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. Si aucun autre paramètre de requête n'existe, 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 d'accès basepath, utilisez / en 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-requête-param gsname="paramètre_requête" [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-requête-param&amp;nbsp;gsname=&quot;q&quot;&amp;nbsp;/&amp;gt;
Give&amp;nbsp;you&amp;nbsp;the&amp;nbsp;value&amp;nbsp;pantalon

&amp;lt;guided-requête-param&amp;nbsp;nbsp=&quot;lang&quot;&amp;nbsp;/&amp;gt;
Give&amp;nbsp;you&amp;nbsp;the&amp;nbsp;value&amp;nbsp;en

&amp;lt;guided-requête-param&amp;nbsp;gsname=&quot;test&quot;&amp;nbsp;/>
Give amp;nbsp;you&amp;nbsp;an&amp;nbsp;empty&amp;nbsp;nbsp;string
&amp;nbsp;
&amp;nbsp;nbsp;nbsp;nbsp;nbamp;nbsp;nbsp;nbsp;nbamp;nbsp;nbsp;nbsp; &lt;/code> &lt;/p> &lt;/td>

4

<guided-requête-param-name gsname="param#" offset="offset_number"/>%20%3C/span%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%20%3Ctd%20colname=?lang=fr"col2">

La recherche guidée comporte la notion de numéro de requête, qui est utilisée dans le contrôle de chemin de navigation. guidé-requête-param-name vous permet de définir des paramètres dans le cadre d’un lien dans le modèle de présentation où Guided Search identifie le numéro de requête correct pour vous. Le gsname contient un "x", que la recherche guidée remplace par le numéro 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é. La valeur 1 indique que vous souhaitez y ajouter 1, etc.

Combiné à un chemin de courant guidé , 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. Cette fonctionnalité signifie que vous pouvez créer plusieurs modèles à l’aide de sous-modèles en tant que 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 coeurs 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 de base 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>

Permet de vérifier si vous effectuez la recherche initiale ou non (la requête est le résultat d’une recherche effectuée à partir de la zone de recherche).

14

<guided-search-url/>

Vous pouvez utiliser cette balise dans votre modèle pour vous empêcher de figer dans le codage l’action du formulaire de recherche. Il détecte quand vous êtes dans l’environnement en direct ou par étape et change en conséquence.

15

<guided-if-requête-param-defined gsname="paramètre_requête"> <guided-else-requête-param-defined> </guided-if-requête-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-requête-number [gsname="offset"] />

Le moteur de recherche guidée qui conduit le modèle a la notion de nombre de requêtes flottantes 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 de requête suivants 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"]/>

Vous 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 que vous affichez ou utilisez cette variable dans votre modèle avec une séquence 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 traitement après recherche).

19

<guided-general-field gsname="searchname" field="fieldname" [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 par-dessus le 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="searchname" field="fieldname"> <guided-else-general-field> </guided-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-cookie> </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"/>%20%3C/code%3E%20%3C/p%3E%20%3C/td%3E%20%20%20%3C/tr%3E%20%20%20%3Ctr%3E%20%20%20%20%3Ctd%20colname=?lang=fr"col01">

24

<guided-if-banner-set gsname="bannière area"> <guided-else-banner-set> </guided-if-banner-set>

Active le test si une zone de bannière est définie.

25

<guidé-si-simulateur-mode> <guidé-else-simulator-mode> </guidé-if-simulator-mode>

Permet de détecter le moment où vous consultez votre recherche dans Simulator ou dans 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-Rules> <guided-else-tnt-business-rules> </guided-if-tnt-business-Rules>

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 avec Adobe Target pour empêcher que des attaques sur les serveurs de Cible ne se produisent 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 choisir d’analyser la réponse 302/301 dans votre application Web ou de faire passer la redirection à vous 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

<guidé-if-redirect> <guidé-else-redirect> </guidé-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

<guidé-lt/> <guidé-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 des 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 n'étant utilisé que pour transmettre des données à la couche de présentation, il ne contient aucun code HTML qui s'intéresse à 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 pour 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 Modification d’une présentation ou d’un modèlede transport.

Voir Balises de modèle derecherche.

Balise de modèle de transport

Description

<guided-xml></guided-xml>

Les 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 le plus faible et le résultat le plus élevé. Vous pouvez définir un nombre illimité de champs globaux supplémentaires avec 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>

<résultats></résultats>

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ù se trouve le contenu d’un seul début de résultats de recherche et où se termine cette 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>

<nom_table_attributs="nom_table">

Permet de parcourir en boucle chaque élément dans une liste à plusieurs valeurs pour 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 qui appartiennent à 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. Cependant, leur traitement est indépendant par rapport aux balises de modèle de présentation connexes.

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 à la fois dynamiques et grisé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 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é peuvent utiliser la balise dynamique et la balise display-names. Ces deux balises facilitent le mappage entre facettes en pointillés et 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 de séparateur permet de modifier le délimiteur utilisé lors de la sortie de données de champ d’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 de votre champ.

<suggestions></suggestions>

Encapsulez vos suggestions Voulez-vous dire avec des balises afin que la recherche guidée reconnaisse quels noeuds XML contiennent des suggestions.

Voir A propos de Vouliez-vous dire

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

Voir A propos de Vouliez-vous dire

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 de vos résultats de recherche. La référence suivante contient une brève description de chaque balise de modèle de recherche et de ses attributs.

Remarque

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 suivants et le matériel de référence.

Les balises valides uniquement dans la boucle de résultats sont les suivantes :

Les balises valides dans tout le modèle sont les suivantes :

Rubriques de référence de modèle de recherche

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 toute autre balise 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 balisesde boucle Résultats.

Baliser

Description

1

<index-recherche>

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

<search-bodytext length="XX" encoding="html/javascript/json/perl/url/none" >

Renvoie le corps du texte à partir du haut de la page. Les termes pertinents sont indiqués en 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 des caractères de sortie avec un encodage HTML (par défaut), JavaScript, Perl encoding ou none.

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 de 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 de codage facultatif contrôle si la sortie est encodée au format HTML, JavaScript, Perl, URL encodée ou non, 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 de page dynamique en définissant l’attribut de classement sur dynamique ( <score de recherche rang="dynamique"> ). Vous pouvez afficher le classement de page statique en définissant l’attribut de classement sur statique ( <score de recherche rang="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 facultative de texte "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 "format de date" utilise une chaîne de format de date de style UNIX telle que "%A, %B %d, %Y" (pour "lundi, 25 juillet 2016"). "gmt" prend par défaut la valeur "yes" et contrôle si la partie horaire de la chaîne de date doit être affichée en GMT ("yes") ou le fuseau horaire du compte ("no").

L’attribut "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 "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 length facultatif pour limiter la longueur des chaînes affichées, avec un nombre par défaut de caractères illimités.

L’ attribut de codage est facultatif et peut coder des caractères de sortie avec encodage HTML, JavaScript, Perl encoding ou none.

9

<search-url-path-requête 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 length facultatif 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 gras. Appelez cette balise à plusieurs reprises pour afficher plusieurs lignes contextuelles pour le résultat actuel.

Utilisez l’attribut de longueur facultatif pour limiter la longueur des chaînes affichées, avec par défaut 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 il peut coder les caractères de sortie avec le codage HTML (par défaut), le codage JavaScript, le codage Perl ou aucun.

11

<nom-champ-affichage-recherche="nom-champ" length="XX" none="texte" format-date="chaîne-format-date" gmt="oui/non" langue="0/2/language-id" encoding="html/javascript/json/perl/url/none" guillemets="oui/non" virgules="oui/non" unités="miles/kilomètres" séparateurs""|">

Cette balise avancée affiche le contenu du champ de métadonnées (url, title, desc, keys, cible, body, alt, date, charset et langue ou des champs définis sous Options > Métadonnées > Définitions) spécifié dans l’attribut name , 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 aucun est spécifié, sa valeur s’affiche sur la page de résultats uniquement si aucun contenu n’est associé au champ.

Les attributs de format de date , de gmt et de langue ne sont pertinents que si le type de contenu du champ spécifié est date.

L'attribut format de date utilise une chaîne de format de date de style UNIX telle que %A, %B %d, %Y (pour le lundi 25 juillet 2016). gmt prend par défaut la valeur yes 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 ( non ).

Voir Chaînesde 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 Identifiantsde langue.

L’attribut length facultatif est utilisé pour limiter la longueur des chaînes affichées, avec une valeur par défaut de 80 caractères.

L’attribut de codage facultatif contrôle si la sortie est encodée au format HTML, JavaScript, Perl, URL encodée ou non, 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 Guillemets facultatif contrôle si les éléments individuels sortis sont entourés de guillemets de doublon (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 oui . 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 de type emplacement associé au champ de sortie de recherche de proximité donné.

Voir A propos de la recherchede proximité.

L’ attribut de séparateur facultatif 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, keys, cible, body, alt, date, charset et langue ou 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 avec les champs dont l’attribut Listes autorisées est coché (sous Options > Métadonnées > Définitions ).

13

<search-display-field-value-format-date="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, cible, body, alt, date, charset et langue ou champs définis sous Options > Métadonnées > Définitions ) pour l’itération de la boucle en cours <search-display-field-values> . Cette balise n’est valide que dans une boucle <search-display-field-values> . Les attributs de format de date , de gmt et de langue ne sont pertinents que si le type de contenu du nom de champ spécifié dans la balise de <search-display-field-values> encadrée est date . L'attribut format de 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 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 ( non ).

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 de codage facultatif contrôle si la sortie est encodée au format HTML, JavaScript, Perl, URL encodée ou non, 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, keys, cible, body, alt, date, charset et langue ou champs définis sous Options > Métadonnées > Définitions ) spécifié avec l’attribut name. Cette balise peut apparaître n’importe où dans la boucle de résultats.

15

<recherche-affichage-champ-valeur-compteur>

Sort le compteur ordinal (1, 2, 3, etc.) pour l’itération de boucle <search-display-field-values> en cours. Cette balise n’est valide que dans une boucle <search-display-field-values> .

16

<search-dynamic-facet-fields>

Commence un contexte de boucle pour tous les champs de facettes dynamiques renvoyés pour cette recherche.

17

<search-dynamic-facet-field-name>

Génère le nom du champ de facettes dynamiques 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 encoding 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 de base.

Voir la ligne 48 du tableau figurant dans les paramètres CGI de rechercheen 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 balisesde boucle Résultats.

Baliser

Description

1

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

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

Ces balises incluent 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 incluent 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-bodytext> ... </search-if-bodytext>

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

Ces balises incluent 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 incluent 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> insérée.

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’existe pas) une chaîne contextuelle associée au résultat. L’attribut length remplace l’attribut length sur toute balise <search-context> insérée.

6

<search-if-score lower="XX" upper="yy" grade="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 rank="dynamic" lower=XX upper=YY> ). Vous pouvez vérifier le classement statique des pages en définissant l’attribut de classement sur static ( <search-if-score grade="static" lower=XX upper=YY> ).

7

<search-if-field name="field-name" value="value"> ... </search-if-field>

<nom-du-champ-recherche="nom-champ" valeur="valeur"> ... </search-if-not-field>

Ces balises avancées incluent le code HTML entre elles en fonction du contenu ou non du champ spécifié dans l’attribut "name". Si l’attribut facultatif "value" est spécifié, les balises incluent le code HTML entre elles selon si la valeur donnée correspond (ou ne correspond pas) à 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 balisesde boucle Résultats.

Baliser

Description

1

<cible du lien de recherche="nom-cadre" hbx-enable="yes/no" hbx-linkid-name="nom-champ" hbx-linkid-none="texte" hbx-linkid-length="XX" > ... </lien-recherche>

Cette paire de balises crée un lien d’ancrage autour du code HTML entre elles. Lorsque vous cliquez sur le lien, la page de résultats s’affiche. Un attribut de cible facultatif spécifie la fenêtre nommée dans laquelle les navigateurs capables d’afficher les cadres 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 du 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 cible="nom-cadre" hbx-enable="yes/no" hbx-linkid-name="nom-champ" hbx-linkid-none="texte" hbx-linkid-length="XX"> ... </search-smart link>

Cette paire de balises est similaire aux balises <lien de recherche> ... </lien de recherche> . 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, le lecteur Acrobat affiche la page qui contient le résultat. Un attribut de cible facultatif spécifie la fenêtre nommée dans laquelle les navigateurs capables d’afficher les cadres 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 du 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>

<extension_de_recherche-si-non-lien> ... </search-if-not-link-extension>

Ces balises incluent le code HTML entre elles si un attribut de valeur spécifie une extension qui correspond à la fin de l’URL pour le 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 (séparées par des espaces) comme suit : VALUE=".pdf" ou VALUE=".html.htm".

Balises conditionnelles de position de boucle

Les balises suivantes incluent conditionnellement le texte entre elles. Ils ne peuvent apparaître qu’à l’intérieur des balises "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 balisesde 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 <résultats de recherche> ) ou la première valeur de champ (lorsqu’il est utilisé dans <valeurs de champ de recherche> ).

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 <résultats de recherche> ) ou la dernière valeur de champ (lorsqu’il est utilisé dans <valeurs de champ de recherche> ). Cette balise peut être utilisée pour insérer un séparateur entre les résultats. Par exemple, ceci insère une balise <hr> 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 de 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 (utilisé dans <résultats de recherche> ) ou une autre valeur de champ (utilisée dans <valeurs de champ de recherche> ). 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 que la balise <search-if-alt> soit placée "à l’intérieur" de 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 (utilisé dans <résultats de recherche> ) ou une valeur de champ pair (utilisée dans <valeurs de champ de recherche> ). Un résultat de recherche est pair si sa valeur <search-index> est paire. En d'autres termes, si sa position dans l'ensemble des résultats est égale. Il peut s’agir d’une différence par rapport à <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 la différence :

Première page, sp_n=1

Index

Résultats

Même ?

Alt ?

1

Premier résultat

Non

Non

2

Deuxième 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> la valeur des champs de recherche est toujours la même que celle <search-if-alt> des champs de recherche, car les valeurs des champs ne sont pas paginées.

Balises de liste de valeur de champ

Les balises avancées suivantes génèrent des valeurs de champ et des données associées provenant 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" guillas="oui/non" virgules="oui/non" data="valeurs/counts/résultats" separator="X" sortby="aucun/valeurs/counts/results" max-items="XX" format-date="chaîne-format-date" gmt="oui/non" langue="0/language-id"="jhtml" avascript/json/perl/url/none">

Cette balise affiche une liste de valeurs de champ uniques, de valeurs ou de nombres de résultats dans l’ensemble du jeu de résultats.

Cette balise ne produit que la sortie des champs spécifiés par les paramètres CGI sp_sfvl_field dans la requête de recherche. L’attribut "guillemets" facultatif contrôle si la sortie des éléments individuels est entourée de guillemets de doublon (ou guillemets simples, si encoding=perl). La valeur par défaut des guillemets 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 facultatif "data" contrôle si chaque valeur de champ unique est output (data="values"), le nombre total de chaque valeur de champ unique est output (data="counts") ou le nombre de résultats contenant chaque valeur unique (data="results") est output. 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 trier par valeurs de champ (dans l'ordre croissant ou décroissant selon la propriété Tri du champ), sortby="counts" signifie trier dans l'ordre décroissant des valeurs de champ et sortby="results" signifie trier 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 de type liste. 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 "format de date" utilise une chaîne de format de date de style UNIX telle que "%A, %B %d, %Y" (pour "lundi, 25 juillet 2016"). "gmt" prend par défaut la valeur "yes" et contrôle si la partie horaire de la chaîne de date doit être affichée en GMT ("yes") ou le fuseau horaire du compte ("no").

Voir Chaînesde format de date.

L’attribut "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 "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 encodés au format HTML, JavaScript, Perl, URL ou non, pour la sortie sur la page de résultats. La valeur par défaut de "encoding" est "html".

Voir Identifiantsde langue.

2

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

Cette balise affiche les informations sur le nombre pour une liste de valeur-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 des résultats (pour results="no"), soit le nombre total de résultats contenant la valeur donnée dans l’ensemble des résultats (pour results="yes"). La valeur par défaut de "results" est "no". Remarque : Pour les champs non 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 produit que la sortie des champs spécifiés par les paramètres CGI du champ sp-sfvl dans la requête de recherche.

3

<search-if-field-value-liste-count name="field-name" value="field-value"> ... </search-if-field-value-liste-count>

<search-if-not-field-value-liste-count name="field-name" value="field-value"> ... </search-if-not-field-value-liste-count>

Ces balises affichent le code HTML entre elles si l’appel équivalent à <search-field-value-liste-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-liste-count name="field-name"> ... </search-if-single-field-value-liste-count>

Ces balises affichent le contenu entre elles si l’appel équivalent à <search-field-value-liste-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 valeur de champ

Les balises avancées suivantes énumèrent et extraient les valeurs des champs et les données associées de l'ensemble des résultats de recherche à l'aide d'un concept 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> . L’attribut "name" spécifie le nom du champ contenant les valeurs à énumérer. L’attribut facultatif "sortby" contrôle l’ordre de é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é Tri du champ), sortby="counts" signifie le tri par ordre décroissant de valeurs de champ, et sortby="results" signifie le tri par ordre décroissant du nombre de résultats contenant chaque valeur.

Notez que sortby="counts" et sortby="results" sont équivalents pour les champs non de type liste. . 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" (énumérer toutes les valeurs).

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 de champ pour l’itération de boucle <search-field-values> en cours. Cette balise n’est valide que dans une boucle <search-field-values> . Les attributs "date-format", "gmt" et "langue" ne sont pertinents que si le type de contenu du nom de champ spécifié dans la balise <search-field-values> encadrée est "date". L'attribut "format de date" utilise une chaîne de format de date de style UNIX telle que "%A, %B %d, %Y" (pour "lundi, 25 juillet 2020").

Voir Chaînesde format de date.

L’attribut "encoding" facultatif contrôle si les caractères de la chaîne de sortie sont encodés au format HTML, JavaScript, Perl, URL ou non, pour la 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" prend par défaut la valeur "yes" et contrôle si la partie horaire de la chaîne de date doit être affichée en GMT ("yes") ou le fuseau horaire du compte ("no"). L’attribut "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 "language" est interprétée comme un identifiant de langue spécifique, par exemple, "en_US" signifie "English (United States)".

Voir Identifiantsde 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 de résultats contenant la valeur du champ (results="yes"), soit le nombre total de résultats de la valeur du champ dans l'ensemble des résultats. La valeur par défaut de "results" est "no".

Pour les champs non 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 <search-field-values> en cours. 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.

Remarque

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 toute balise de modèle "Suggérer", telle que <suggestion de recherche> , <lien de suggestion de recherche> , etc. Si la recherche génère des suggestions, le moteur de recherche génère et traite tout entre la balise d'ouverture et la balise de fermeture. Si la recherche ne génère pas de suggestions, aucun du contenu imbriqué n’est généré.

2

<suggestions de recherche>... </suggestions de recherche>

Cette balise génère la boucle "Suggérer", qui contient une liste de termes de recherche suggérés (par exemple, "intention", "intention" et "intention", pour une requête initialement saisie comme "intention"). Lors de la génération de la liste des 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 s’afficher 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 obtenus.

Imbriquez la balise <search-suggestions> entre les balises d’ouverture et de fermeture <search-if-suggestions> .

3

<lien de suggestion de recherche> ... </lien de suggestion de recherche>

Cette balise génère un lien vers la requête de recherche d’origine en utilisant le terme de recherche suggéré sélectionné au lieu du terme d’origine. La balise accepte et imprime simplement tout attribut HTML tel que la classe, la cible et le 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 initialement saisie comme "intention"). 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 du 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 si le terme suggéré est le premier terme de la boucle Suggérer. Les balises doivent s’afficher 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 si le terme suggéré est le dernier terme de la boucle Suggérer. Les balises doivent s’afficher entre les balises open et close <search-suggestion> .

8

<index-suggestion-recherche>

Cette balise renvoie l’index numérique du terme de recherche suggéré actuel. La balise doit s’afficher 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 s’afficher 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 s’afficher 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 corps HTML contenant tous les paramètres de couleur de lien de recherche définis par la section Aspect de base 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 des liens de recherche définis par la section Aspect de base.

2

<en-tête de recherche>

Code HTML de l’en-tête des résultats de la 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

<numéro-requête-requête-recherche="XX" encoding="html/javascript/json/perl/url/none">

Requête entrée par le visiteur. L’attribut avancé optionnel "numéro de requête" contrôle quelle chaîne de requête numérotée est générée par cette balise. Par exemple, <search-requête requête-number=1> génère le contenu du paramètre cgi sp_q_1. Si "numéro-requête" n’est pas spécifié ou si le numéro-requête est "0", la requête principale ( sp_q ) est output. L’attribut "encoding" facultatif contrôle si la sortie est encodée au format HTML, JavaScript, Perl, URL ou non, 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

<recherche-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 signalé pour cette page.

8

<search-upper>

Numéro du dernier résultat signalé 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

<temps de recherche>

Durée en secondes de cette recherche.

12

<logo-recherche>

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 l'instant, 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 votre numéro de compte.

16

<search-input-gallery>

Insère une balise d’entrée de formulaire qui spécifie le numéro de la galerie.

17

<search-input-requête-requête-number="XX">

Insère une balise d’entrée de formulaire qui spécifie la chaîne de requête. L’attribut avancé optionnel "numéro de requête" contrôle la requête numérotée utilisée pour la balise d’entrée de formulaire. Par exemple, <search-input-requête requête-number=1> génère une balise d'entrée de formulaire pour la requête sp_q_1. Si "numéro-requête" n'est pas spécifié ou si "numéro-requête" est "0", une balise d'entrée pour la requête principale sp_q 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 à partir 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 rendu 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 à partir 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 rendu 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 demande de recherche actuelle. L’attribut "encoding" facultatif contrôle si la sortie est encodée au format HTML, JavaScript, Perl, URL ou non, 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 encoding 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 de base.

Voir la ligne 48 du tableau figurant dans les paramètres CGI de rechercheen arrière-plan.

Modèle de balises de lien d’ancrage

Les balises suivantes provoquent l’entourage du code HTML par un lien d’ancrage. 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" avancé facultatif contrôle le domaine vers lequel le lien associé est dirigé. Par défaut, le domaine est https://search.atomz.com/search/défini, 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

<URL de recherche-tri-par-date="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

<URL="https://search.yourdomain.com/search/"> ... </search-show-résumés>

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

Affiche ou masque les résumés.

Modèle 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 aucun).

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 ou n’est pas triée par pertinence ou par date.

4

<search-if-show-résumés> ... </search-if-show-résumés>

<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 non valide ou non.

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

<nom_de_la_recherche_par_champ="nom_champ"> ... </search-if-not-sort-by-field>

Ces balises avancées incluent le code HTML entre elles si la page active est triée selon le nom de champ donné ou non.

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 cases de liste au sein d’une page <form> du 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 . Ainsi, 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 actuelle.

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

Si la chaîne de paramètre CGI pour 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>... </option de recherche>

Les zones de liste déroulante d’une balise <form> sont démarré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 de 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 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 standard 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 la <search-option...> à la place de la <option...> et de la </search-option> à la place de la place de la place de la /option> .

3

<nom_tri_par_champ="nom_champ" count="XX"> ... </search-sort-par-champ>

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

Voir A propos des mots et de la langue.

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

Voir A propos des mots et de la langue.

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

Voir A propos des mots et de la langue.

%b

Correspond à la représentation nationale du nom abrégé du mois, où l’abréviation est les trois premiers caractères, par exemple "juin". Le paramètre dans Linguistique > Mots et langues > Langue détermine la représentation nationale.

Voir A propos des mots et de la langue.

%D

Équivalent à "%m/%d/%y", par exemple "25/07/13".

%d

Correspond au jour du mois sous la forme d’un nombre décimal (01-31).

%e

Correspond au jour du mois sous la forme d’un nombre décimal (1-31). Un blanc précède des chiffres.

%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 forme de nombre décimal (01-12).

%j

Correspond au jour de l’année sous la forme d’un 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.

%l

Correspond à l’horloge de 12 heures sous la forme d’un nombre décimal (1-12). Un blanc précède des chiffres.

%M

Correspond à la minute sous la forme d’un nombre décimal (00-59).

%m

Correspond au mois sous la forme d’un nombre décimal (01-12).

%p

Correspond à la représentation nationale de "ante meridiem" ou de "post meridiem" selon le cas, par exemple "PM". Le paramètre dans Linguistique > Mots et langues > Langue détermine la représentation nationale.

Voir A propos des mots et de la langue.

%R

Équivalent à "%H:%M", par exemple, "13:23".

%r

Équivalent à "%I :%M :%S %p", par exemple, "01:23:45 PM".

%S

Représente la seconde par un 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) en tant que 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

Identificateur 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

Gaelic irlandais (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 (ancienne 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 l’attribut 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 pour 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 vue ou modifier le jeu de caractères associé à votre compte sous Settings > My Profile > Personal Information > Character Encoding.

Voir Configuration de vos informationsd’utilisateur personnelles.

Vous pouvez choisir un nom de jeu de caractères spécifique en l’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 attribut par défaut charset 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 actif 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’attribut de contenu est définie par défaut sur l’une des deux valeurs. 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 vue ou modifier le jeu de caractères associé à votre compte sous Settings > My Profile > Personal Information > Character Encoding.

Voir Configuration de vos informationsd’utilisateur personnelles.

Si vous spécifiez charset="1" alors la valeur réelle pour 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 la supprimez, le navigateur utilise les valeurs par défaut pour content-type: 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 actif au moyen de la balise suivante :

<search-xml-decl [charset="charset-name"]>

L’ charset attribut est facultatif. Cette balise doit s’afficher 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 n’indiquez pas la valeur 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> un attribut est spécifié charset , cette valeur est utilisée. Sinon, la valeur réelle de charset-name est lue à partir des paramètres de votre compte. Vous pouvez vue ou modifier le jeu de caractères associé à votre compte sous Settings > My Profile > Personal Information > Character Encoding.

Voir Configuration de vos informationsd’utilisateur personnelles.

Si vous spécifiez charset="1" alors la valeur réelle pour 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", si vous le souhaitez. 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 des 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 ont un sens à inclure dans ce contexte.

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

Vous pouvez contrôler l’aspect 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/le marchandisage sur site. Vous pouvez également gérer vos modèles de transport dans Publier. Tout comme la recherche sur site/le marchandisage, Publier vous permet de modifier, de prévisualisation et de 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 sp_t requête. Supposons, par exemple, que vous disposiez d’un modèle de recherche appelé "liquidation" pour la zone de vente marqué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 Utilisation des collections dans les formulairesde recherche.

Voir Utilisation de cadres avec des formulaires.

Voir Exemple de formulairede recherche avancée.

Sur cette page