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

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> sur 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="charset-name" standalone="yes" ?>

Résultats

Baliser

Description

1

<guided-results></guided-results>

La balise guided-results définit les limites d’une boucle de résultats. Tout jeu de résultats est accessible en spécifiant un attribut gsname . Si aucun nom de fichier gsname n'est donné, les résultats de recherche par défaut s'affichent.

2

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

Pour créer un lien vers un résultat donné, utilisez la balise guided-result-link . En définissant un attribut gsname , vous pouvez utiliser un champ de l'index à la place 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">

La balise <guidé-result-img> permet de créer des balises d’image plutôt que d’incorporer des variables dans une balise brute img .

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

Toute information à présenter dans les résultats s’affiche sous la forme d’une balise <champ-résultat-guidé> (sauf si vous utilisez des balises générées automatiquement telles que la balise <a3/> <guidé-result-img>).

Spécifiez 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></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é-if-not-last> pour en savoir plus sur cette balise.

<guided-if-result-wrap>      </div>      <guided-if-not-last>          <div>      </guided-if-not-last>  </guided-if-result-wrap>

7

<guided-results-found>

Renvoie une valeur de 1 si la requête de recherche principale renvoyait des résultats et de 0 dans le cas contraire. Si aucun nom_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>

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>

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>

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;/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 <guidé-result-title> donne la valeur du champ de modèle de transport de titre spécifié avec <title> balise de transport.

13

<guided-result-description />

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

14

<guided-result-loc />

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

15

&amp;lt;/guided-if-result-field&amp;gt;   &lt;/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="tablename">

Cette balise fournit une boucle à travers la table d'attributs définie dans le modèle de transport avec la balise de transport <table_attributs> . Il existe une balise <guided-result-attribute-table-field> pour afficher les valeurs des champs de table d'attributs. Il est également possible d’utiliser la balise plain guided-result-field dans la boucle pour afficher d’autres champs de résultats.

17

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

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;&amp;nbsp;&amp;nbsp;li&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;a&amp;nbsp;href=&quot;&amp;lt-result attribute-table-field&amp;nbsp;gsname=&quot;download_link&quot;&amp;nbsp;/&amp;gt;&quot;&amp;gt;
&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nlt;guided-result-attribute-table-field&amp;nbsp;gssp;gssp=&quot;download_title&quot;&amp;nbsp;/&amp;gt;
&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;/a&amp;gt ;&amp;nbsp ;(&amp;lt ; guided-result-field&amp;nbsp ; gsname=&quot;title&quot;/&amp;gt ;)
&amp;nbsp ;&amp;nbsp ;&amp;nbsp ; gt;
&amp;lt;/guided-result-attribute-table&amp;gt;&amp;lt;/ul&amp;gt;...

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




</tr> 

18

<guided-trace>

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 donné, est supposé par défaut.

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

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 <a1/> est modifiée de sorte que l’attribut gsname soit automatiquement fourni par le contexte de boucle <a3/>.

2

<guided-facet-display-name gsname=" facetname " />

Renvoie le libellé d’affichage de la facette.

Si la facette utilise la balise <nom-affichage> sur le modèle de transport, le contenu de cette balise devient l’étiquette.

1

<guided-facet-rail></guided-facet-rail>

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 dans la balise <a3/> comme valeur déterminée dynamiquement au moment de la recherche et correctement substituée :

  • 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 de 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 toutes les facettes dynamiques de cette recherche. Ce rail de facettes prédéfini est également exposé dans l'interface utilisateur des règles métier pour que l'action facette Push X dans le rail de facettes '_dynamic_facets' puisse positionner 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 guided-facet 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 zone ou guidé-if-facet-visible est entourée d’une balise.

5

<guided-if></guided-if>

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 facette guidée 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></guided-if>

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 facette guidée 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></guided-if>

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 facette guidée 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></guided-if>

Cette balise conditionnelle est vraie lorsque la facette est à sélection multiple. Utilisez la balise pour modifier l’affichage de la facette dans les balises <a1/> ou <a3/>.

&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;lt ; guidé-if-facet-multiselect&amp;gt ; 
&amp;nbsp ; ...
&amp;nbsp ;&amp;lt ; guidé-else-facet-multiselect&amp;gt;
&amp;nbsp ; ...
&amp;nbsp ;&amp;lt ;/guided-if-facet-multiselect&amp;gt;
&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;...
&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;lt ;/guided-facet&amp;gt;
&amp;nbsp ;&amp;nbsp ;&amp;lt ;/guided-facet-rail&amp;gt ;   &lt;/p>  &lt;/td>

9

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

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 facette guidée nommé, auquel cas vous pouvez omettre le nom_gsname . Vous pouvez également le définir en dehors de tout bloc de facette guidée , mais il faudrait l'attribut gsname pour identifier l'ensemble de valeurs de facette qui s'affichent.

Vous pouvez également utiliser cette balise pour afficher les valeurs de facette en dehors du contexte d’un bloc guidé-facet nommé. Vous référencez directement une facette spécifique en utilisant l'attribut gsname .

<script>      registerFacetValues('category', '<guided-facet-values gsname="category"><guided-facet-value/>,</guided-facet-values>'); </script>

10

<guided-facet-value>

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></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;/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 facette guidée 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 facette guidée 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 facette guidée 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 " />

Génère le nombre total de résultats qui se trouvent dans la facette donnée.

21

<guided-facet-value gsname=" associated custom facet value ">

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=" associated custom facet value " /><guided-else-facet-value></guided-if-facet-value>

Teste si la valeur de facette est associée à une valeur de champ.

23

<guided-facet-link> 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>

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>

Comme <guided-facet-values> itère 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 dans <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 <guidé-facet-value-children> . La clause "else" est facultative.

27

&amp;lt;guidé-else&lbrack;-facet-value-above-length-seuil&amp;gt;

&amp;lt;/guidé-if[-not]-facet-value-above-length-seuil&amp;gt;   &lt;/p>  &lt;/td>

Détermine si la valeur de facette actuelle dans la boucle facet-values est supérieure au seuil de longueur. Il est généralement utilisé pour afficher uniquement les valeurs inférieures au seuil sur une longue facette (à moins que l’utilisateur ait précédemment sélectionné un lien "Voir plus" affiché sous la facette).

28

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

&amp;lt;/guidé-if[-not]-facet-facet-value-equals-length-seuil&amp;gt;   &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. Comme ce lien d’annulation annule uniquement 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 guided-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 " />

Créez votre propre lien d’annulation de facette.

Semblable à la balise <guidé-facet-undo-link> , sauf qu’elle vous donne le chemin d’accès 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-behavior gsname=" facetname " />

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

3

<guided-breadcrumb> nom_grand-mère "]></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, le chemin de navigation nommé "default" est utilisé.

2

<guided-breadcrumb-link></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 facultatif gsname pour spécifier "remove" ou "drop". Tout attribut inclus dans la balise est transmis à la balise d’ancrage résultante.

<guided-breadcrumb>      <guided-breadcrumb-link gsname="remove" class="bc_link">          <guided-breadcrumb-value/>      </guided-breadcrumb-link> </guided-breadcrumb>

1

<guided-breadcrumb-value />

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

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

4

<guided-breadcrumb-label />

La balise d’étiquette génère un libellé pour une valeur de chemin de navigation qui détaille la facette sélectionnée pour générer cet élément de chemin de navigation. Il n'est utilisé que dans le contexte d'un bloc de chemin de navigation guidé .

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

5

<guided-if-breadcrumb-label> <guided-else- breadcrumb-label> <guided-if-breadcrumb-label />

Cette balise conditionnelle est utilisée pour afficher sous condition le contenu si la valeur 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 navigation guidé .

<guided-breadcrumb>      <guided-breadcrumb-link>          <guided-if-breadcrumb-label>              <guided-breadcrumb-label/>:          </guided-if-breadcrumb-label>      <guided-breadcrumb-value/></guided-breadcrumb-link> </guided-breadcrumb>

6

<guided-breadcrumb-path>

Utilisé pour créer votre propre lien de chemin de navigation.

Menus

Voir Menus.

Baliser

Description

1

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

Il s'agit de la balise d'itérateur de boucle de valeur de menu. Utilisez l'attribut gsname pour identifier le jeu d'éléments de menu qui s'affiche.

2

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

Donne l'URL pour affiner la recherche actuelle de l'élément de menu.

1

<guided-menu-item-option>

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

<guided-pages></guided-pages>

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

Crée un lien dans le volet de navigation de la page.

1

<guided-page-link gsname="first|prev|next|last|viewall|viewpages"></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;guidé-else-page-link&amp;gt;
&amp;lt;/guidé-if[-not]-page-link&amp;gt;   &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 des pages.

13

next|last|viewall|viewpages&rbrack;/&amp;gt;   &lt;/p>  &lt;/td>

Crée votre propre lien dans le volet de navigation de la page.

14

<guided-if-page-high-eq-last> <guided-else-page- high-eq-last> </guided-if-page-high-eq-last>

Teste si la page la plus élevée dans la navigation de la page est égale au nombre total de pages.

15

<guided-if-page-low-eq-first> <guided-else-page-low-eq-first> </guided-if-page-low-eq-first>

Teste si la page la plus basse du volet de navigation de la page est égale à celle-ci.

16

<guided-if-page-is-multipage> <guided-else-page-is-multipage> </guided-if-page-is-multipage>

Teste s’il existe une 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 recherches récentes.

Baliser

Description

1

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

1

<guided-recent-searches-path />

Permet de saisir le chemin d’URL relatif pour une recherche récente, dans une boucle guided-récent-searches . En règle générale, vous utiliseriez guidé-récent-search-link . 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-recent-searches-value>

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

5

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

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

6

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

Renvoie le chemin d’accès utilisé par <guidé-récent-searches-clear-link> afin que vous puissiez créer votre propre lien.

7

&amp;lt;/guided-if-récent-searches&amp;gt;   &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

3

<guided-suggestions></guided-suggestions>

Il s’agit de la balise de boucle permettant de parcourir les suggestions en boucle.

2

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

Crée un lien vers la suggestion donnée.

1

<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, guided-suggestion-link est utilisé à la place.

6

<guided-suggestion />

Une suggestion.

7

<guided-suggestion-result-count />

Nombre de résultats pour la suggestion.

8

<guided-if[-not]-suggestion-autosearch> <guided-else[-not]-suggestion-autosearch> </guided-if[-not]-suggestion-autosearch>

Permet de tester si la recherche automatique par suggestion sur zéro résultat a été effectuée, au cas où cette fonction serait activée.

9

<guided-suggestion-original-query />

Renvoie la requête d’origine si une recherche automatique a été effectuée.

Exemple d’utilisation :

<guided-if-suggestion-autosearch>     Search for <guided-query-param gsname="q" /> instead of <guided-suggestion-original-query /> </guided-if-suggestion-autosearch>

10

<guided-if[-not]-suggestion-low-results> <guided-else[-not]-suggestion-low-results> </guided-if[-not]-suggestion-low-results>

Cette condition est vraie si des suggestions sont faites en raison d’un faible nombre de résultats, au cas où cette 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>

Compléter automatiquement

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

<guided-store />

Sort le magasin actuel.

2

<guided-if-store-defined> <guided-else-store-defined> </guided-if-store-defined>

Détecte si l’utilisateur se trouve dans un magasin.

1

<guided-if-store gsname="store"> <guided-else-store> </guided-if-store>

Détecte si l'utilisateur se trouve dans le magasin que le paramètre gsname spécifie.

Zones

Baliser

Description

3

<guided-zone gsname="zone area">

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 guided-if-facet[-not]-visible au lieu de la zone. Il simplifie le modèle de présentation.

2

<guided-if-zone gsname="zone area"> <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

3

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

1

<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

<guided-loop-counter>

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>

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 de base, 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-query-param gsname="query_parameter">

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;
donne&amp;nbsp;you&amp;nbsp;the&amp;nbsp;value&amp;nbsp;pants

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

&amp;lt;guid-requête-param&amp;nbsp;gsname=&quot;test&quot;&amp;nbsp;/&amp;gt;
donne&amp;nbsp;you&amp;nbsp;an&amp;nbsp;empty&amp;nbsp;string
&amp;nbsp;
&amp;nbsp; ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;&amp;nbsp ;   &lt;/p>  &lt;/td>

4

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

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 permet de définir des paramètres dans le cadre d’un lien du modèle de présentation dans lequel la recherche guidée détermine le numéro de requête correct pour vous. Le nom_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é à chemin-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="filename" />

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 fichiers de facettes et de chemins de navigation et 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-query-param-defined gsname="query_parameter"> <guided-else-query-param-defined> </guided-if-query-param-defined>

Cet ensemble de balises vous permet de tester les paramètres CGI définis dans le chemin de recherche. Vous pouvez tester les valeurs des paramètres uniquement si elles sont définies.

16

<guided-next-query-number>

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

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 pour la chaîne renvoyée, 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">

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

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 pour la chaîne renvoyée, vous pouvez spécifier html , url , js , json ou 0 .

22

<guided-if-cookie gsname="cookie_name"> <guided-else-cookie> </guided-if-cookie>

Active le test s’il existe un cookie.

23

<guided-banner gsname="banner area">

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="banner area"> <guided-else-banner-set> </guided-if-banner-set>

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

25

<guided-if-simulator-mode> <guided-else-simulator-mode> </guided-if-simulator-mode>

Permet de détecter le moment où vous 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 normalement utilisé dans le cadre de l'intégration avec Adobe Target pour empêcher d'atteindre les serveurs de Cible 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

<guided-if-redirect> <guided-else-redirect> </guided-if-redirect>

Lorsque vous avez configuré la recherche/marchandisage du site pour renvoyer des redirections dans le jeu de résultats, cet ensemble de balises peut être utilisé pour déterminer s’il existe une redirection vers la sortie.

29

<guided-lt /> <guided-gt />

Cet ensemble de balises vous permet d’incorporer des balises de modèle guidées dans des attributs HTML.

Exemple :

<guided-lt/>div <guided-if-facet-long>         style="height: 125px; overflow:         auto;"</guided-if-facet-long><guided-gt/>

Balises de modèle de transport

Les modèles de transport sont des modèles XML qui transmettent 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èle de transport.

Voir Rechercher des balises de modèle.

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 le nombre de champs globaux supplémentaires que vous souhaitez 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>

<results></results>

Les balises sont entourées des résultats de la recherche, de sorte que la recherche guidée sache où les rechercher.

<result></result>

Les balises sont entourées de chaque résultat de recherche, de sorte que la recherche guidée identifie où 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>

<attribute-table name="tablename">

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>

<facets></facets>

Transmet les résultats qui renseignent les facettes.

<dynamic-facet></dynamic-facet>

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

À 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 balises de boucle Résultats.

Baliser

Description

1

<search-index>

Renvoie l’index numérique du résultat actuel.

2

<search-title length="XX">

Renvoie le titre de la page du résultat actuel. L’attribut de longueur facultatif est utilisé pour limiter la longueur des chaînes affichées, avec une valeur par défaut de 80 caractères.

3

<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 facultatif de codage 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

<search-score rank="dynamic/static/dynamic-raw/static-raw/final-raw" precision="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 dynamic ( <a6/> <a7/>). Vous pouvez afficher le classement de page statique en définissant l’attribut de classement sur statique ( <search-score grade="static"> ). 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 facultatif length pour limiter la longueur des chaînes affichées, avec par défaut un nombre illimité de caractères.

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

9

<search-url-path-query length="XX">

Renvoie les parties chemin et requête, y compris le point d’interrogation de l’URL du résultat actuel.

Utilisez l'attribut facultatif length pour limiter la longueur des chaînes affichées, avec par défaut un nombre illimité de caractères.

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 facultatif length pour limiter la longueur des chaînes affichées, avec une valeur par défaut de 80 caractères. L'attribut length est ignoré si cette balise est entourée soit de <search-if-context> soit de <search-if-any-context> jeux de balises qui contiennent un attribut length.

L'attribut de codage 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

<search-display-field name="field-name" length="XX" none="text" date-format="date-format-string" gmt="yes/no" language="0/2/language-id" encoding="html/javascript/json/perl/url/none" quotes="yes/no" commas="yes/no" units="miles/kilometers" separator="|">

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és dans l'attribut nom pour le résultat actuel. Par exemple :

<search-display-field name="title" length="70" none="no title">

Génère le titre de la page pour un résultat de recherche. Si l'attribut facultatif none est spécifié, sa valeur s'affiche sur la page de résultats uniquement si aucun contenu n'est associé au champ.

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

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

Voir Chaînes de 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". 2 signifie "Utiliser la langue du Document". La valeur 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 (États-Unis)".

Voir Identifiants de langue.

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

L’attribut facultatif de codage 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 facultatif guillemets 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 de guillemets est no .

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 virgules est ignoré pour les champs non de type liste.

L'attribut facultatif units 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 type emplacement associé au champ de sortie de recherche de proximité donné.

Voir À propos de la recherche de proximité.

L'attribut facultatif séparateur 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 balise <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 date-format="date-format-string" gmt="yes/no" language="0/language-id" encoding="html/javascript/json/perl/url/none">

Cette balise produit la valeur du champ de métadonnées (url, titre, desc, clés, cible, corps, alt, date, charset et langue ou champs définis sous Options > Métadonnées > Définitions ) pour l'itération actuelle <search-display-field-values>. Cette balise n’est valide que dans une boucle <search-display-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 <a7/> encadrée est date . L'attribut date-format utilise une chaîne de format de date de style UNIX telle que "%A , %B %d , %Y " (pour "le lundi 25 juillet 2016"). L'attribut 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 ( 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 de langue est interprétée comme un identifiant de langue spécifique, par exemple, en_US signifie "Anglais (États-Unis)".

L’attribut facultatif de codage 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 les champs définis sous Options > Métadonnées > Définitions spécifiées avec l'attribut name. Cette balise peut apparaître n’importe où dans la boucle de résultats.

15

<search-display-field-value-counter>

Sort le compteur ordinal (1, 2, 3, etc.) pour l’itération de boucle <search-display-field-values> actuelle. 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 de codage est facultatif ; la valeur par défaut est html .

Remarque : Cette balise n'a une 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 recherche dorsale.

Balises conditionnelles de boucle de résultats

Les balises suivantes incluent de manière conditionnelle le code HTML entre elles.

Voir A propos des balises de boucle Résultats.

Baliser

Description

1

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

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

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

1

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

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

6

<search-if-score lower="XX" upper="yy" rank="dynamic/static/dynamic-raw/static-raw/final-raw"> ... </search-if-score>

<search-if-not-score lower="XX" upper="yy" rank="dynamic/static"> ... </search-if-not-score>

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 classement sous Options > Métadonnées > Définitions , vous pouvez vérifier le classement de page dynamique en définissant l'attribut de classement sur dynamic ( <search-if-score grade="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>

<search-if-not-field name="field-name" value="value"> ... </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 balises de boucle Résultats.

Baliser

Description

3

<search-link target="frame-name" hbx-enable="yes/no" hbx-linkid-name="field-name" hbx-linkid-none="text" hbx-linkid-length="XX"> ... </search-link>

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 target="frame-name" hbx-enable="yes/no" hbx-linkid-name="field-name" hbx-linkid-none="text" hbx-linkid-length="XX"> ... </search-smart-link>

Cette paire de balises est similaire aux balises <search-link> ... </search-link> . 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>

<search-if-not-link-extension> ... </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 balises de boucle Résultats.

Baliser

Description

1

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

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

Ces balises comprennent le texte entre elles si le résultat actuel est (ou n’est pas) le premier résultat sur la page (utilisé dans <résultats de la recherche> ) ou la première valeur de champ (utilisée dans <search-field-values> ).

2

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

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

Ces balises comprennent le texte entre elles si le résultat actuel est (ou n’est pas) le dernier résultat de la page (utilisé dans <résultats de la recherche> ) ou la dernière valeur de champ (utilisée dans <search-field-values> ). 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 (utilisé dans <search-results> ), ni la première ni la dernière valeur de champ (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 la recherche> ) ou une autre valeur de champ (utilisée dans <valeurs-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 de <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 <search-field-values> ). Un résultat de recherche est pair si sa valeur <search-index> est paire. En d'autres termes, si sa position dans l'ensemble des résultats est égale. Il peut s’agir de <search-if-alt> qui teste la position d’un résultat sur la page et non dans l’ensemble du jeu de résultats. Les deux tableaux suivants illustrent 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

1

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> est toujours identique à <search-if-alt> pour les valeurs de champ de recherche, car les valeurs de champ 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 CGI sp-sfvl-field dans la requête de recherche.

Baliser

Description

1

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

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înes de 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 Identifiants de langue.

2

<search-field-value-list-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 sp-sfvl-field dans la requête de recherche.

1

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

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

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-list-count name="field-name"> ... </search-if-single-field-value-list-count>

Ces balises affichent le contenu entre elles si l’appel équivalent à <search-field-value-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 CGI sp-sfvl-field 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 balise <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înes de 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 Identifiants de langue.

1

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

Cette balise génère le nombre associé à l’itération de boucle <search-field-values> actuelle. 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-counter>

Cette balise génère le compteur ordinal pour l’itération de boucle <search-field-values> actuelle. 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 de 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 <search-suggestion> , <search-suggestion-link> , 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

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

Cette balise génère la boucle "Suggérer", qui contient une liste de termes de recherche suggérés (par exemple, "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 open et close <search-if-suggestions> .

1

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

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

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 apparaître entre les balises open et close <search-suggestion> .

7

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

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 apparaître entre les balises open et close <search-suggestion> .

8

<search-suggestion-index>

Cette balise renvoie l’index numérique du terme de recherche suggéré actuel. La balise doit apparaître entre les balises open et close <search-suggestion> .

9

<search-suggestion-total>

Cette balise renvoie le nombre total de termes de recherche suggérés générés. La balise doit apparaître entre les balises open et close <search-suggestion> .

10

<search-suggestion-result-count>

Cette balise renvoie le nombre total de résultats pour le terme de recherche suggéré. La balise doit apparaître entre les balises open et close <search-suggestion> .

Balises de chaîne de modèle

Les balises suivantes génèrent une chaîne dans le code HTML à ce stade du modèle.

Baliser

Description

1

<search-body>

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

<search-header>

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.

1

<search-cdata> ... </search-cdata>

Les balises search-data sont remplacées par leurs équivalents XML : <search-cdata> est remplacé par <![CDATA[" et la balise </search-cdata> est remplacée par " ]]> ". Un analyseur XML n’analyse aucune information entre les balises open et close.

4

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

Requête 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> renvoie le contenu du paramètre sp_q_1 cgi. 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

<search-total>

Nombre total de résultats pour cette recherche.

6

<search-count>

Nombre de résultats signalés pour cette page.

7

<search-lower>

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

<search-time>

Durée en secondes de cette recherche.

12

<search-logo>

Code HTML du logo de recherche configuré pour votre compte, le cas échéant. Ce logo est l'image qui attribue du crédit à la recherche/marchandisage sur le site.

Pour 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-query query-number="XX">

Insère une balise d’entrée de formulaire qui spécifie la chaîne de requête. L’attribut avancé 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, <lien-recherche> est équivalent à <search-lt>a href="<URL-recherche>"<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, <lien-recherche> est équivalent à <search-lt>a href="<URL-recherche>"<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 de codage est facultatif ; la valeur par défaut est json .

Remarque : Cette balise n'a une 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 recherche dorsale.

Balises de lien d’ancrage de modèle

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/, mais vous pouvez le modifier à l’aide de l’attribut URL.

Baliser

Description

1

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

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

Affiche la page suivante ou précédente des résultats.

2

<search-sort-by-date URL="https://search.yourdomain.com/search/"> ... </search-sort-by-date>

<search-sort-by-score URL="https://search.yourdomain.com/search/"> ... </search-sort-by-score>

Trie les résultats par date ou par pertinence.

3

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

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

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

3

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

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

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 comprennent du code HTML si le paramètre CGI sp_advanced=1 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>

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

Ces balises avancées incluent le code HTML entre elles si la page active est 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 dans une balise <form> du modèle de recherche.

Baliser

Description

3

<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 sorties en l'état. De plus, 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 sonore

Le code de modèle correspondant à cette case à cocher est le suivant :

<search-input type="checkbox" name="sp_w" value="exact">Aucune correspondance sonore

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" checked="">Aucune correspondance sonore

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 sonore

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 à <formulaire> dans votre modèle de recherche, utilisez <search-input...> à la place de <input..> .

2

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

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

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> est suivie d’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 la valeur dans une balise <option de recherche> 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 à <formulaire> dans votre modèle de recherche, utilisez <search-select...> à la place de <select...> , </search-select> à la place de </select <a>9/>, <option de recherche...> en lieu et place de <option...> et </option de recherche> en lieu et place de </option> <a17/ .

3

<search-sort-by-field name="field-name" count="XX"> ... </search-sort-by-field>

Ces balises avancées créent un lien d’ancrage autour du code HTML entre elles. Lorsque vous cliquez sur cette ancre, une page de résultats triée sur le champ donné s’affiche. L'attribut facultatif count spécifie le nombre de résultats à afficher sur la page de résultats. Si 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 de Linguistique > Mots et langues > Langue détermine la représentation nationale.

Voir À 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 de Linguistique > Mots et langues > Langue détermine la représentation nationale.

Voir À propos des mots et de la langue.

%B

Correspond à la représentation nationale du nom complet du mois, par exemple "Juin". Le paramètre de Linguistique > Mots et langues > Langue détermine la représentation nationale.

Voir À 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 de Linguistique > Mots et langues > Langue détermine la représentation nationale.

Voir À 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 de Linguistique > Mots et langues > Langue détermine la représentation nationale.

Voir À 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 (Etats-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'attribut content, la valeur de MIME-type prend par défaut la valeur définie dans Settings > Crawling > Content Types. Si vous spécifiez un attribut content, il est utilisé comme attribut content par défaut pour la balise <search-html-meta-charset>.

Si vous ne spécifiez pas l'attribut charset, aucune valeur charset n'est écrite dans l'en-tête content-type.

Si vous spécifiez charset="1", la valeur réelle de charset-name correspond à la valeur du paramètre CGI sp_f. Si aucun paramètre CGI sp_f 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 informations utilisateur personnelles.

Vous pouvez choisir un nom de jeu de caractères spécifique en l’répertoriant comme valeur charset, par exemple charset="iso-8859-1" ou charset="Shift-JIS".

Si vous spécifiez un attribut charset, il est utilisé comme attribut charset par défaut pour les balises <search-html-meta-charset> et <search-xml-decl>, ainsi que comme sortie dans l'en-tête content-type.

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 est définie par défaut sur l’une des deux valeurs. Si la balise <search-content-type-header> a spécifié un attribut content, 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'attribut charset, la valeur réelle de charset-name prend par défaut l'une des deux valeurs. Si la balise <search-content-type-header> a spécifié un attribut 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 informations utilisateur personnelles.

Si vous spécifiez charset="1", la valeur réelle de charset-name correspond à la valeur du paramètre CGI sp_f. Si aucun paramètre CGI sp_f n’est envoyé avec la recherche, la valeur réelle de charset-name est soit la valeur définie dans la balise <search-content-type-header> 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". Par exemple, charset="iso-8859-1" ou charset="Shift-JIS".

La balise <search-html-meta-charset> est facultative. Si vous la supprimez, le navigateur utilise les valeurs par défaut de content-type, qui sont les suivantes : content="text/html; charset=ISO-8859-1". Vous pouvez également remplacer la balise <search-html-meta-charset> par votre propre balise http-equiv.

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'attribut charset est facultatif. Cette balise doit apparaître en haut du modèle, mais après toute balise <search-content-type-header>. Cette balise génère la balise suivante sur le document XML généré à partir du modèle :

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

Si vous ne spécifiez pas charset, la valeur réelle de charset-name est définie par défaut sur l’une des deux valeurs. Si <search-content-type-header> a spécifié un attribut 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 informations utilisateur personnelles.

Si vous spécifiez charset="1", la valeur réelle de charset-name correspond à la valeur du paramètre CGI sp_f. Si aucun paramètre CGI sp_f n’est envoyé avec la recherche, la valeur réelle de charset-name est soit la valeur définie dans la balise <search-content-type-header> 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 remplacer la balise <search-xml-decl> par votre propre balise ?xml.

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

Pour inclure un modèle de recherche dans un autre, utilisez la balise <search-include>, en définissant l’attribut de fichier sur le nom du fichier de modèle à inclure, comme dans l’exemple suivant :

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

Les segments de modèles de recherche SEO se trouvent dans le sous-dossier seo/ et les modèles de recherche standard dans le sous-dossier templates/. 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 de requête sp_t. 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 formulaires de recherche.

Voir Utilisation de cadres avec des formulaires.

Voir Exemple de formulaire de recherche avancée.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free