Plug-ins de contenu

Les plug-ins de contenu sont utilisés avec l'objet de contenu en cours.

Plug-in Analytics Data

• Ce plug-in écrit des informations appropriées pour une analyse de site actif.
• Par exemple: [Plugin:AnalyticsData property="title" css-class="asa.wcm.content_item.title"]

Plug-in Copy Text

• Ce plug-in écrit du texte une ou plusieurs fois.
• La syntaxe du plug-in est [Plugin:CopyText text="" count="" separator="" format="trim | tolower | toupper" escape="xml | json | none"].

Plug-in If List Index

• Ce plug-in écrit la balise de corps placée entre guillemets en fonction du comptage où l'élément en cours est positionné dans le rendu d'un composant Menu, Navigateur, Recherche, Personnalisation ou Taxinomie. Le plug-in affiche le corps uniquement si le nombre en cours est compris entre les valeurs numériques indiquées, soumis à la valeur de 'by'. Le premier élément de la liste a pour valeur 1. Les valeurs 'from' et 'to' peuvent être omises si aucune limite inférieure ou supérieure n'est requise.
• Par exemple:
  • [Plugin:ifListIndex is='2'] affiche le corps pour le deuxième élément.
  • [Plugin:ifListIndex from='2'] affiche le corps pour tous les éléments à partir du deuxième élément.
  • [Plugin:ifListIndex to='3'] affiche le corps pour tous les éléments jusqu'au troisième élément.
  • [Plugin:ifListIndex from='2' to='8'] affiche le corps pour les éléments entre le deuxième et le huitième éléments.
  • [Plugin:ifListIndex from='1' by='2'] ou [Plugin:ifListIndex by='odd'] affiche le corps pour tous les éléments impairs.
  • [Plugin:ifListIndex from='2' by='2'] ou [Plugin:ifListIndex by='even'] affiche le corps pour tous les éléments pairs.

Plug-in If Count Index

• Ce plug-in est semblable au plug-in ifListIndex. Il écrit la balise de corps placée entre guillemets en fonction du comptage où l'élément en cours est positionné dans le rendu d'un composant Menu, Navigateur, Recherche, Personnalisation ou Taxinomie qui affiche le plug-in IfCountIndex mais compte uniquement les éléments visibles dans un composant Menu, Navigateur, Recherche, Personnalisation ou Taxinomie. Le plug-in affiche le corps uniquement si le nombre en cours est compris entre les valeurs numériques indiquées, soumis à la valeur de 'by'. Le premier élément de la liste a pour valeur 1. Les valeurs 'from' et 'to' peuvent être omises si aucune limite inférieure ou supérieure n'est requise.
• Par exemple:
  • [Plugin:ifCountIndex is='2'] affiche le corps pour le deuxième élément calculé.
  • [Plugin:ifCountIndex from='2'] affiche le corps pour tous les éléments calculés à partir du deuxième élément calculé.
  • [Plugin:ifCountIndex to='3'] affiche le corps pour tous les éléments calculés jusqu'au troisième élément calculé.
  • [Plugin:ifCountIndex from='2' to='8'] affiche le corps pour les éléments calculés entre le deuxième et le huitième éléments.
  • [Plugin:ifCountIndex from='1' by='2'] ou [Plugin:ifCountIndex by='odd'] affiche le corps pour tous les éléments impairs calculés.
  • [Plugin:ifCountIndex from='2' by='2'] ou [Plugin:ifCountIndex by='even'] affiche le corps pour tous les éléments pairs calculés.

Tableau 1.

Méthodes de comptage utilisées par les plug-ins If List Index et If Count Index

Elément	Balise IfCountIndex affichée dans une liste	Méthode de comptage utilisée par le plug-in If List Index	Méthode de comptage utilisée par le plug-in If Content Index
ElÚment 1	Non	1	Aucun
Elément 2	Oui	2	1
Elément 3	Oui	3	2
Elément 4	Non	4	2

Plug-in JavaScript and XML Encode

• Ce plug-in encode du code JavaScript ou XML.
• Par exemple: [Plugin:jsencode enc="js|xml|jsxml" value="myValue"]

Plug-in Ratings

• Ce plug-in fournit la prise en charge des options d'évaluation des objets de contenu.
• [Plugin:ratings]

Plug-in Remote Action

• Utilisé afin de créer une adresse URL pour une action de création à distance.
• Par exemple: [Plugin:RemoteAction action="edit" useCurrentContext="true" dialog="true"]

Plug-in Tags

• Ce plug-in fournit la prise en charge de l'étiquetage des objets de contenu.
• [Plugin:tags]

Plug-in Text Provider

• Utilisé pour écrire une valeur à partir d'un fournisseur de texte.
• La syntaxe du plug-in est [Plugin:TextProvider provider="" key="" defaultValue="" param.0="" param.1="" param.X=""] où le nom du fournisseur de texte doit être indiqué au paramètre "provider" et la clé à extraire doit être spécifiée au paramètre "key".
• Si aucun fournisseur n'est défini, le fournisseur de texte qui est défini pour le titre du contenu en cours est utilisé.
• Le paramètre facultatif "defaultValue" peut être utilisé pour définir une valeur qui est écrite si le fournisseur de texte ne renvoie aucun résultat. Faute de quoi, aucune donnée n'est écrite par ce plug-in.
• Les marques de réservation présentes dans le texte sont remplacées par les valeurs de tous les paramètres facultatifs définis dans la balise de plug-in.
• A compter du groupe de correctifs CF09, vous pouvez également utiliser l'alias de balise "Localize" pour cette balise. Cela s'applique davantage lorsque vous utilisez cette balise pour afficher du texte localisé. Par exemple: [Plugin:Localize provider="translated" key="title"].
• Si vous prévoyez d'utiliser la balise de plug-in TextProvider plus d'une fois dans une conception de composant ou une conception de modèle de présentation, vous pouvez spécifier le chemin de fournisseur de texte par défaut dans une balise :

  [Plugin:TextProvider defaultProvider="library/sitearea/contentitem"]

  Vous pouvez ensuite omettre le paramètre de fournisseur dans les balises qui suivent la balise de fournisseur par défaut :

  [Plugin:TextProvider defaultProvider="library/sitearea/contentitem"]
  [Plugin:TextProvider key="key1"]
  [Plugin:TextProvider key="key2"]
  [Plugin:TextProvider key="key3"]
  

  Le fournisseur par défaut est appliqué à tous les modèles de présentation et à toutes les conceptions de composant, y compris les conceptions de composant incluses à l'aide des balises, telles qu'une balise de composant.

  Pour retirer le fournisseur par défaut, utilisez ce qui suit :

  [Plugin:TextProvider defaultProvider=""]