Plug-ins d'utilisateur

Les plug-ins d'utilisateur sont utilisés avec le contexte utilisateur en cours. Cette rubrique contient des informations supplémentaires pour certains de ces plug-ins.

Plug-in de rendu Locale

Utilisez le plug-in de rendu Locale pour ajouter des informations sur un environnement local à votre contenu web ou pour insérer un marquage dans votre contenu web, en fonction de l'environnement local en cours. Ce plug-in détermine l'environnement local préféré pris en charge dans le contexte en cours.

Le plug-in de rendu Locale utilise les attributs suivants :

acceptLanguage

Définit un ou plusieurs environnements locaux préférés qui peuvent être sélectionnés par le portail dans un contexte spécifique. Les valeurs d'attribut doivent respecter la spécification de syntaxe de la zone d'en-tête Accept-Language du protocole HTTP/1.1. Pour plus d'informations sur cette zone d'en-tête, voir la section Accept-Language de la spécification RFC2616.

Si l'attribut acceptLanguage n'est pas défini, le portail considère que tous les environnements locaux pris en charge sont également acceptables lors de la détermination de l'environnement local préféré pris en charge pour le contexte sélectionné.

pattern

Définit le format de sortie pour l'environnement local qui est imprimé par le plug-in Locale plug-in.

Les valeurs d'attribut spécifient un modèle qui peut inclure les marques de réservation suivantes :

{language} : emplacement de la minuscule, code de langue à deux lettres d'un environnement local tel qu'il est défini par la norme ISO-639.
{country} : emplacement de la majuscule, code de pays à deux lettres d'un environnement local tel qu'il est défini par la norme ISO-3166.
{variant} : emplacement de la variante d'un environnement local, propre au fournisseur ou au navigateur.

Si l'attribut pattern n'est pas défini, le pattern suivant est utilisé : {language}-{country}-{variant}.

printLocale

Indique si l'environnement local préféré déterminé par le plug-in Locale est inséré dans votre contenu Web. Cet attribut peut prendre les valeurs suivantes :

true : l'environnement local préféré pris en charge est écrit dans le marquage de la page.
false : l'environnement local préféré pris en charge n'est pas écrit dans le marquage de la page.

En combinant cet attribut à l'attribut acceptLanguage, les utilisateurs peuvent définir un contenu à afficher uniquement dans les cas suivants :

Si un environnement local spécifique s'applique au contexte en cours
Si un environnement local d'un ensemble spécifique d'environnements locaux s'applique au contexte en cours

Bien que le corps de la balise Plugin soit imprimé si un environnement local admissible est pris en charge, l'environnement local préféré pris en charge ne s'affiche pas lorsque cet attribut a pour valeur false.

Si l'attribut printLocale n'est pas défini, la valeur true est utilisée.

key

Au lieu d'utiliser les attributs répertoriés précédemment, vous pouvez utiliser l'attribut de clé permettant d'extraire les données d'environnement local supplémentaires. Les valeurs prises en charge sont les suivantes :

direction : écrit la direction du texte de base pour l'environnement local pris en charge préféré de la demande vers votre contenu Web. Par exemple: "ltr".
xmlLocale : écrit la représentation de chaîne de l'environnement local pris en charge préféré de la demande conformément à ce qui est défini par IETF BCP 47 vers votre contenu Web. Par exemple: "en".

Si le plug-in Locale indique le contenu du corps, le marquage compris entre les balises de début et de fin est rendu uniquement si l'environnement local préféré pris en charge est déterminé. Si aucun environnement local ne s'applique dans le contexte actuel, le plug-in Locale n'insère pas de marquage dans le contenu.

Exemples :

Lorsque vous ajoutez le plug-in Locale sans définir d'attributs supplémentaires, l'environnement local pris en charge préféré dans le contexte en cours est inséré dans votre contenu Web. Le format par défaut de {language}-{country}-{variant} est utilisé (par exemple, es-ES-WIN) :
```
[Plugin:Locale]
```
L'attribut pattern définit le format de sortie de l'environnement local pris en charge préféré. L'exemple suivant affiche l'environnement local avec un format personnalisé et omet l'élément variante (par exemple, es_ES) :
```
[Plugin:Locale pattern="{language}_{country}"]
```
L'exemple suivant affiche le code de langue de l'environnement local pris en charge préféré dans le contexte en cours (par exemple, da). Seules les langues des pays nordiques sont acceptées comme résultat. Si aucun des environnements locaux spécifiés n'est pris en charge dans le contexte en cours, rien n'est imprimé sur votre contenu Web. Par exemple, si l'utilisateur configure le navigateur Web ou le profil utilisateur de portail de manière à utiliser uniquement l'anglais (en), le plug-in Locale ne renvoie aucun environnement local.
```
[Plugin:Locale acceptLanguage="da,fo;q=0.8,fi;q=0.6,is;q=0.4,no;q=0.2,sv;q=0.2" 
pattern="{language}"]
```
Vous pouvez empêcher le rendu de l'environnement local préféré pris en charge à l'aide de l'attribut printLocale. Cet exemple insère le corps de la balise Plugin dans le contenu Web uniquement si l'environnement local pris en charge préféré correspond à l'une des langues nordiques spécifiées. L'environnement local déterminé n'est pas ajouté au contenu Web.
```
[Plugin:Locale acceptLanguage="da,fo;q=0.8,fi;q=0.6,is;q=0.4,no;q=0.2,sv;q=0.2" 
printLocale="false"]
     <div>This markup is displayed only if the current context supports a locale 
     that represents one of the specified Nordic languages.</div>
 [/Plugin:Locale]
```

Vous pouvez également combiner le plug-in Locale et d'autres plug-ins. L'exemple ci-après montre comment utiliser le plug-in Matches avec le plug-in Locale. Le marquage dans le corps du plug-in Matches est rendu dans votre contenu uniquement si l'environnement local pris en charge préféré représente la langue espagnole.

[Plugin:Matches pattern="es(.*)" text="[Plugin:Locale]"] 
    <div>This markup appears only if the preferred supported locale in the 
    current context represents a Spanish language. Neither the country code 
    nor the variant are important as long as the language code of the 
    locale is "es".</div>
[/Plugin:Matches]

Pour écrire la direction du texte de base pour l'environnement local pris en charge préféré de la demande vers votre contenu Web, par exemple, "ltr", utilisez l'attribut de clé avec la direction de valeur :
```
[Plugin:Locale key="direction"]
```
Pour écrire la représentation de chaîne de l'environnement local pris en charge préféré de la demande conformément à ce qui est défini par IETF BCP 47 vers votre contenu Web, par exemple, "en", utilisez l'attribut de clé avec la valeur xmlLocale :
```
[Plugin:Locale key="xmlLocale"]
```

Plug-ins `If Device` et `If Not Device`

Utilisez les plug-ins If Device et If Not Device pour afficher le contenu de façon sélective, en fonction de la classe d'appareil Portal d'un utilisateur. Vous pouvez utiliser ces plug-ins pour basculer vers les composants mobiles, comme un diaporama ou un carrousel optimisé pour les appareils mobiles, lorsqu'un utilisateur visite le site sur un smartphone ou une tablette.

L'attribut de classe est défini par les classifications d'unité pour les clients pris en charge dans HCL Digital Experience. Connectez-vous à HCL en tant qu'administrateur et cliquez sur l'icône du menu Administration dans la barre d'outils. Cliquez ensuite sur Paramètres du portail > Clients pris en charge. Modifiez un client sélectionné afin d'afficher les classes qui lui sont déjà associées. Vous pouvez ajouter ou supprimer des classes par le biais de cette page.

Vous pouvez vérifier qu'un appareil spécifique est utilisé avec le format suivant :

[Plugin:ifDevice class="DEVICE1" class="DEVICE2"]
Text to render if current device is DEVICE1 or DEVICE2.
[/Plugin:ifDevice]

Vous pouvez vérifier qu'une unité spécifique n'est pas utilisée avec le format suivant :

[Plugin:ifNotDevice class="DEVICE1" class="DEVICE2"]
Text to render if current device is not DEVICE1 or DEVICE2.
[/Plugin:ifDevice]

Utilisé pour rendre le texte si aucun appareil n'est défini :

[Plugin:ifDevice class=""]
Text to render if the device is not set.
[/Plugin:ifDevice]

Pour spécifier un appareil ou un autre appareil, utilisez la syntaxe suivante :

[Plugin:ifDevice class="DEVICE1|DEVICE2"]
Text to render if current device is DEVICE1 or DEVICE2.
[/Plugin:ifDevice]

Pour spécifier un appareil et un autre appareil, utilisez la syntaxe suivante :

[Plugin:ifDevice class="DEVICE1+DEVICE2"]
Text to render if current device is DEVICE1 and DEVICE2.
[/Plugin:ifDevice]

Pour spécifier un appareil, mais pas l'autre appareil, utilisez la syntaxe suivante :

[Plugin:ifDevice class="DEVICE1+!DEVICE2"]
Text to render if current device is DEVICE1 but not DEVICE2.
[/Plugin:ifDevice]

Plug-ins d'utilisateur

Plug-in de rendu Locale

Plug-ins If Device et If Not Device

Plug-ins `If Device` et `If Not Device`