Création d'une balise de plug-in

Les plug-ins d'affichage sont référencés à l'aide de la balise de plug-in. Sélectionnez un plug-in de rendu préinstallé ou sélectionnez vos propres plug-ins personnalisés.

Pourquoi et quand exécuter cette tâche

Le format d'une balise de plug-in est le suivant :

[plugin:pluginname paramKey="paramVal" compute=" " htmlencode=" " start=" " end=" "]
Tag Body Content
[/plugin:pluginname]

Pour créer une balise de plug-in :

Procédure

  1. Cliquez sur Insérer une balise dans un modèle de présentation, le composant ou la zone de conception d'élément. La boîte de dialogue Aide sur les balises s'ouvre.
  2. Sélectionnez Composant de plug-in comme type de balise.
  3. Sélectionnez un type de plug-in.
  4. Sélectionnez le plug-in à référencer. Des informations sur le plug-in et les paramètres corrects sont affichées.
  5. Indiquez si des sections de début et de fin doivent être incluses. Vous pouvez entrer du texte supplémentaire entre les sections de début et de fin de la balise et d'autres balises de contenu Web, telles qu'une balise de composant ou d'élément.
  6. Cliquez sur OK pour ajouter la balise à votre conception de navigateur.
  7. Vous pouvez ensuite ajouter des paramètres personnalisés à votre conception de balise.
    Après avoir ajouté la balise à votre conception, vous pouvez également ajouter les paramètres suivants à la balise :
    Tableau 1. Paramètres de balise supplémentairesCe tableau répertorie les autres paramètres qui peuvent être ajoutés manuellement à cette balise.
    Paramètres des balises Détails
    compute=" " S'il n'est pas spécifié, ce paramètre prend toujours la valeur par défaut "always", ce qui signifie que la valeur de la balise de plug-in est évaluée à chaque fois que la balise est affichée dans une liste, telle qu'un composant de menu ou de navigateur. Utilisez compute="once" pour évaluer la balise une seule fois.
    htmlencode=" " Si ce paramètre à pour valeur htmlencode="true", les caractères HTML réservés sont convertis en entités de caractère. Par exemple, '<' est converti en '&lt;'. Ce paramètre est utile si vous souhaitez empêcher les utilisateurs d'ajouter un code malveillant ou de modifier la présentation de leur texte à l'aide de balises HTML.

    Si ce paramètre n'est pas spécifié, la valeur par défaut qui est spécifiée par la propriété cmpnt.htmlEncodeDefault dans le service WCM WCMConfigService est utilisée. Par défaut, cette propriété est définie sur true.
    start=" "

    end=" "

    		 Les attributs start et end sont utilisés pour encapsuler les données renvoyées par d'autres balises, telles que les balises HTML. Ces attributs ne sont pas obligatoires.
    Balise simple
    Pour référencer un plug-in sans spécifier de paramètres ou de contenu de corps de balise :
    [plugin:pluginname]
    Balise abrégée

    Vous pouvez simplifier la balise de plug-in comme suit : [pluginname]

    Le plug-in abrégé ne peut pas remplacer une balise de contenu Web existante. Si, par exemple, vous avez créé un plug-in nommé "Property", vous devez utiliser la balise complète suivante : [Plugin:Property]. La balise [Property] est traitée comme une balise de propriété et non comme une balise de plug-in.

    Balise simple avec paramètres
    Pour référencer un plug-in avec des paramètres, mais sans contenu de corps de balise :
    [plugin:pluginname paramKey1="paramVal" paramKey2="paramVal" paramKey2="paramVal2"]
    Balise de plug-in avec balise de contenu Web comme paramètre
    [plugin:pluginname paramKey1="[IDCmpnt context='current' type='sitearea' field='id']"]
    Remarque : Vous devez utiliser des apostrophes dans la balise de contenu Web utilisée comme valeur de paramètre.
    Balise de plug-in avec contenu de corps
    Pour référencer un plug-in avec des paramètres et un contenu qui incluent une référence à un composant :
    [plugin:pluginname paramKey1="paramVal" paramKey2="paramVal" paramKey2="paramVal2"]
This is the tag body content.
<br>
[component name="test"]
<br>
More content.
[/plugin:pluginname]

Informations supplémentaires

Ces rubriques contiennent des informations sur les différents plug-ins.