Content Switcher

Content Switcher vous permet d'insérer facilement dans les articles, pages et widgets de votre site Web des nombres aléatoires, ainsi que des contenus aléatoires ou variables. Vous pouvez l'utiliser, par exemple, pour afficher des images aléatoires ou des contenus spécifiques aux inscrits de votre newsletter. Content Switcher vous permet également d'optimiser votre site Web avec Google Optimize et d'ajouter le code de suivi Google Analytics à chaque page de votre site Web.

Télécharger Content Switcher gratuitement

Sommaire

  1. Installation
  2. Mise à Jour
  3. Nombres Aléatoires [+]
    1. Nombres Aléatoires entre Deux Entiers
    2. Nombres Aléatoires dans un Ensemble
    3. Affichage des Nombres Aléatoires
    4. L'Attribut filter
  4. Contenus Aléatoires [+]
    1. L'Attribut filter
    2. Affichage Multiple d'une Chaîne de Caractères
  5. Variables [+]
    1. L'Attribut default
    2. L'Attribut filter
  6. Contenus Variables [+]
    1. L'Attribut filter
    2. Nom de la Variable
    3. Valeurs de la Variable
    4. Affichage d'une Variable
  7. Google
  8. Affichage des Options [+]
    1. L'Attribut default
    2. L'Attribut filter
  9. Personnalisation Avancée [+]
    1. Fichiers Personnalisés
    2. Langues Personnalisées
  10. FAQ [+]
    1. Pourquoi Google Optimize ne fonctionne-t-il pas sur mon site Web ?
    2. Comment puis-je utiliser des cotillons dans mon thème WordPress ?
    3. Comment puis-je utiliser des cotillons dans les commentaires ?
    4. Comment puis-je utiliser des cotillons dans les attributs des cotillons ?
    5. Comment puis-je imbriquer plusieurs cotillons identiques ?

1. Installation

Vous pouvez installer Content Switcher via la page Ajouter des extensions du menu Extensions de WordPress (Extensions => Ajouter => Téléverser une extension). Envoyez le fichier du plugin sans le dézipper. Vous pouvez aussi l'installer comme ceci :

  1. Dézippez le fichier du plugin.
  2. Uploadez via votre logiciel FTP le dossier content-switcher, et uniquement ce dossier, dans le répertoire des plugins de votre site Web (ce devrait être wp-content/plugins).

Lorsque vous avez installé Content Switcher :

  1. Activez le plugin via le menu Extensions de WordPress.
  2. Configurez le plugin via la page d'options de Content Switcher.

2. Mise à Jour

Mettre à jour Content Switcher ne vous fait perdre aucun réglage, ni aucune donnée.

Vous pouvez mettre à jour Content Switcher via le menu Extensions de WordPress, et via la page Mises à jour de WordPress du menu Tableau de bord de WordPress (Tableau de bord => Mises à jour), ou encore via la page Ajouter des extensions du menu Extensions de WordPress (Extensions => Ajouter => Téléverser une extension, envoyez le fichier du plugin sans le dézipper). Vous pouvez aussi le mettre à jour comme ceci :

  1. Dézippez le fichier du plugin.
  2. Uploadez via votre logiciel FTP le dossier content-switcher, et uniquement ce dossier, dans le répertoire des plugins de votre site Web (ce devrait être wp-content/plugins), sans supprimer le dossier content-switcher déjà présent dans ce répertoire.

Vous n'avez pas besoin de désactiver puis réactiver le plugin.

3. Nombres Aléatoires

3.1 Nombres Aléatoires entre Deux Entiers

Pour afficher un nombre aléatoire compris entre 0 et M inclus, insérez dans vos articles/pages/widgets un cotillon comme celui-ci :

[random-number max=M]

Exemple (nombre aléatoire compris entre 0 et 5) :

[random-number max=5]

Résultat (avec un peu de mise en forme) :

4

Pour afficher un nombre aléatoire compris entre m et M inclus (m et M entiers relatifs), insérez dans vos articles/pages/widgets un cotillon comme celui-ci :

[random-number min=m max=M]

Exemple (nombre aléatoire compris entre -3 et 8) :

[random-number min=-3 max=8]

Résultat (avec un peu de mise en forme) :

4

3.2 Nombres Aléatoires dans un Ensemble

Pour afficher un nombre aléatoire appartenant à un ensemble, insérez dans vos articles/pages/widgets un cotillon comme celui-ci :

[random-number set=a/b/c/…]

Exemple (nombre aléatoire appartenant à { 34; 5; -3; 8; -21 }) :

[random-number set=34/5/-3/8/-21]

Résultat (avec un peu de mise en forme) :

-3

3.3 Affichage des Nombres Aléatoires

Vous pouvez utiliser l'attribut digits pour afficher un nombre aléatoire avec un minimum de d chiffres :

[random-number min=m max=M digits=d]

Exemple (nombre aléatoire compris entre 0 et 144, affiché en utilisant au minimum 3 chiffres) :

[random-number max=144 digits=3]

Résultat (avec un peu de mise en forme) :

059

Autre exemple (image aléatoire extraite du court métrage Big Buck Bunny) :

<img src="/medias/images/big-buck-bunny/screenshots/[random-number min=1 max=30 digits=2].webp" alt="Image aléatoire extraite du court métrage Big Buck Bunny" title="Image aléatoire extraite du court métrage Big Buck Bunny" />

Résultat :

Image aléatoire extraite du court métrage Big Buck Bunny
Copyright © Blender Foundation | Peach.Blender.org

3.4 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée au nombre avant que celui-ci soit affiché, en utilisant l'attribut filter, comme ceci :

[random-number min=m max=M filter=fonction]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[random-number min=m max=M  filter=fonction1/fonction2/…/fonctionN]

Les fonctions seront appliquées dans l'ordre indiqué.

4. Contenus Aléatoires

Pour afficher un contenu aléatoire, insérez dans vos articles/pages/widgets un cotillon comme celui-ci :

[random-content]
Premier contenu aléatoire[other]
Deuxième contenu aléatoire[other]
Troisième contenu aléatoire[other]

[/random-content]

Exemple :

[random-content]
Somewhere over the rainbow, way up high[other]
There's a land that I heard of, once in a lullaby[other]
Somewhere over the rainbow, skies are blue[other]
And the dreams that you dare to dream, really do come true
[/random-content]

Résultat (avec un peu de mise en forme) :

Somewhere over the rainbow, skies are blue

4.1 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée au contenu avant que celui-ci soit affiché, en utilisant l'attribut filter, comme ceci :

[random-content filter=fonction]
Contenu 1[other]Contenu 2[other]…[other]Contenu K[/random-content]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[random-content filter=fonction1/fonction2/…/fonctionN]
Contenu 1[other]Contenu 2[other]…[other]Contenu K[/random-content]

Les fonctions seront appliquées dans l'ordre indiqué.

4.2 Affichage Multiple d'une Chaîne de Caractères

Il est possible d'afficher plusieurs fois une même chaîne de caractères, aléatoire ou non, grâce à l'attribut string. Vous pouvez entrer n'importe quelle chaîne de caractères pour cet attribut, y compris des cotillons, à condition de remplacer [ par ( et ] par ). Et n'oubliez pas les guillemets au début et à la fin de la chaîne :

[random-content string="(random-content)Première chaîne aléatoire(other)Deuxième chaîne aléatoire(other)Troisième chaîne aléatoire(other)(/random-content)"]
[string][string][string][/random-content]

Le cotillon [string] permet d'afficher la chaîne de caractères. Les attributs default (défini ici) et filter (défini ici) sont disponibles pour ce cotillon.

Exemple (image aléatoire extraite du court métrage Big Buck Bunny) :

[random-content string="(random-number min=1 max=30 digits=2)"]
<a href="/medias/images/big-buck-bunny/screenshots/[string].webp"><img src="/medias/images/big-buck-bunny/screenshots/320/[string].webp" alt="Image aléatoire extraite du court métrage Big Buck Bunny" title="Image aléatoire extraite du court métrage Big Buck Bunny" /></a>
[/random-content]

Résultat (avec un peu de mise en forme) :

Image aléatoire extraite du court métrage Big Buck Bunny
Copyright © Blender Foundation | Peach.Blender.org

5. Variables

Pour afficher une variable COOKIE, ENV, GET, GLOBALS, POST, REQUEST, SERVER ou SESSION, insérez dans vos articles/pages/widgets un cotillon comme celui-ci :

[variable-string type=type name=nom]

L'attribut type peut prendre les valeurs cookie, env, get, globals, post, request, server ou session. Sa valeur par défaut est get. L'attribut name est simplement le nom de la variable.

Exemple :

Votre adresse IP est [variable-string type=server name=REMOTE_ADDR].

Résultat :

Votre adresse IP est 44.222.104.49.

5.1 L'Attribut default

Vous pouvez spécifier un texte qui sera affiché à la place de la variable lorsque celle-ci est vide, en utilisant l'attribut default, comme ceci :

[variable-string type=type name=nom default="texte"]

N'oubliez pas les guillemets au début et à la fin de la valeur de l'attribut default.

5.2 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée à la variable avant que celle-ci soit affichée, en utilisant l'attribut filter, comme ceci :

[variable-string type=type name=nom filter=fonction]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[variable-string type=type name=nom filter=fonction1/fonction2/…/fonctionN]

Les fonctions seront appliquées dans l'ordre indiqué.

6. Contenus Variables

Pour afficher un contenu variable, insérez dans vos articles/pages/widgets un cotillon comme celui-ci :

[variable-content]
Contenu par défaut[other]
Premier contenu alternatif[other]
Deuxième contenu alternatif[other]

[/variable-content]

Le contenu affiché n'est pas aléatoire, mais est déterminé par l'URL de la page.

Pages affichant le contenu par défaut :

https://www.kleor.com/content-switcher/fr/

https://www.kleor.com/content-switcher/fr/?content=0

Page affichant le premier contenu alternatif :

https://www.kleor.com/content-switcher/fr/?content=1

Page affichant le deuxième contenu alternatif :

https://www.kleor.com/content-switcher/fr/?content=2

C'est la valeur de la variable content de l'URL qui détermine le contenu affiché. Si sa valeur :

Exemple :

[variable-content]
Somewhere over the rainbow, way up high[other]
There's a land that I heard of, once in a lullaby[other]
Somewhere over the rainbow, skies are blue[other]
And the dreams that you dare to dream, really do come true
[/variable-content]

Résultat (avec un peu de mise en forme) :

Somewhere over the rainbow, way up high

Pages affichant la parole par défaut :

https://www.kleor.com/content-switcher/fr/

https://www.kleor.com/content-switcher/fr/?content=0

Page affichant la première parole alternative :

https://www.kleor.com/content-switcher/fr/?content=1

Page affichant la deuxième parole alternative :

https://www.kleor.com/content-switcher/fr/?content=2

Page affichant la troisième parole alternative :

https://www.kleor.com/content-switcher/fr/?content=3

Si vous ne souhaitez pas utiliser une variable GET pour l'affichage du contenu variable, vous pouvez aussi le faire avec une variable COOKIE, ENV, GLOBALS, POST, REQUEST, SERVER ou SESSION en utilisant l'attribut type et en lui attribuant respectivement les valeurs cookie, env, post, server ou session.

6.1 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée au contenu avant que celui-ci soit affiché, en utilisant l'attribut filter, comme ceci :

[variable-content filter=fonction]
Contenu 1[other]Contenu 2[other]…[other]Contenu K[/variable-content]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[variable-content filter=fonction1/fonction2/…/fonctionN]
Contenu 1[other]Contenu 2[other]…[other]Contenu K[/variable-content]

Les fonctions seront appliquées dans l'ordre indiqué.

6.2 Nom de la Variable

Vous pouvez spécifier un nom autre que content pour la variable en utilisant l'attribut name :

Exemple :

[variable-content name=lyric]
Somewhere over the rainbow, way up high[other]
There's a land that I heard of, once in a lullaby[other]
Somewhere over the rainbow, skies are blue[other]
And the dreams that you dare to dream, really do come true
[/variable-content]

Résultat (avec un peu de mise en forme) :

Somewhere over the rainbow, skies are blue

Pages affichant la parole par défaut :

https://www.kleor.com/content-switcher/fr/

https://www.kleor.com/content-switcher/fr/?lyric=0

Page affichant la première parole alternative :

https://www.kleor.com/content-switcher/fr/?lyric=1

Page affichant la deuxième parole alternative :

https://www.kleor.com/content-switcher/fr/?lyric=2

Page affichant la troisième parole alternative :

https://www.kleor.com/content-switcher/fr/?lyric=3

6.3 Valeurs de la Variable

Vous pouvez spécifier des valeurs autres que des nombres pour les valeurs de la variable en utilisant l'attribut values.

Exemple :

[variable-content name=lyric values=first/second/third/fourth]
Somewhere over the rainbow, way up high[other]
There's a land that I heard of, once in a lullaby[other]
Somewhere over the rainbow, skies are blue[other]
And the dreams that you dare to dream, really do come true
[/variable-content]

Résultat (avec un peu de mise en forme) :

Somewhere over the rainbow, way up high

Pages affichant la première parole :

https://www.kleor.com/content-switcher/fr/

https://www.kleor.com/content-switcher/fr/?lyric=first

Page affichant la deuxième parole :

https://www.kleor.com/content-switcher/fr/?lyric=second

Page affichant la troisième parole :

https://www.kleor.com/content-switcher/fr/?lyric=third

Page affichant la quatrième parole :

https://www.kleor.com/content-switcher/fr/?lyric=fourth

6.4 Affichage d'une Variable

Vous pouvez aussi afficher la valeur de la variable. Pour cela, il vous suffit d'utiliser uniquement le contenu par défaut sans spécifier aucun contenu alternatif. Si la valeur de la variable n'est pas spécifiée dans l'URL, c'est le contenu par défaut qui sera affiché :

[variable-content name=nom]Contenu par défaut[/variable-content]

Exemple :

Bienvenue [variable-content name=prenom]à vous[/variable-content] !

Résultat :

Bienvenue à vous !

Page affichant votre prénom :

https://www.kleor.com/content-switcher/fr/?prenom=votre-prenom

7. Google

Si vous avez un compte Google Analytics, vous pouvez analyser le trafic de votre site Web en complétant le champ ID de suivi de votre compte Google Analytics. Le code de suivi de Google Analytics ne sera pas ajouté aux pages de votre site tant que vous ne l'aurez pas complété. Votre ID de suivi est mentionné dans le tableau de bord de votre compte Google Analytics.

Si vous avez aussi un compte Google Optimize, vous pouvez optimiser votre site Web en complétant le champ ID du conteneur de votre compte Google Optimize. Le code de suivi de Google Optimize ne sera pas ajouté aux pages de votre site tant que vous ne l'aurez pas complété. Votre ID de conteneur est mentionné dans le tableau de bord de votre compte Google Optimize.

8. Affichage des Options

Pour afficher une option de Content Switcher, insérez dans vos articles/pages/widgets un cotillon comme celui-ci :

[content-switcher option]

en remplaçant option par :

Exemple :

ID de suivi de mon compte Google Analytics : [content-switcher analytics-tracking-id]

Résultat :

ID de suivi de mon compte Google Analytics : UA-16184215-1

8.1 L'Attribut default

Vous pouvez spécifier un texte qui sera affiché à la place de l'option lorsque celle-ci est vide, en utilisant l'attribut default, comme ceci :

[content-switcher option default="texte"]

N'oubliez pas les guillemets au début et à la fin de la valeur de l'attribut default.

8.2 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée à l'option avant que celle-ci soit affichée, en utilisant l'attribut filter, comme ceci :

[content-switcher option filter=fonction]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Parfois, l'option est un mot anglais. Vous pouvez alors le traduire dans la langue de votre site Web en entrant i18n comme valeur pour l'attribut filter.

Exemple :

JavaScript activé : [content-switcher javascript-enabled filter=i18n]

Résultat :

JavaScript activé : non

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[content-switcher option filter=fonction1/fonction2/…/fonctionN]

Les fonctions seront appliquées dans l'ordre indiqué.

9. Personnalisation Avancée

9.1 Fichiers Personnalisés

Vous pouvez remplacer tous les fichiers de Content Switcher (sauf content-switcher.php) par vos propres fichiers. Pour cela, créez le dossier content-switcher-custom-files dans le répertoire des plugins (celui dans lequel vous avez installé Content Switcher) de votre site Web.

Par exemple, si vous souhaitez remplacer le fichier includes/data.php de Content Switcher par un fichier que vous avez personnalisé, créez le dossier includes dans le dossier content-switcher-custom-files, et uploadez votre fichier data.php dans ce dossier.

Vous pouvez définir vous-même le répertoire dans lequel sont stockés vos fichiers personnalisés, en insérant cette ligne :

define('CONTENT_SWITCHER_CUSTOM_FILES_PATH', ABSPATH.'custom-files/content-switcher/');

juste après :

if ( !defined('ABSPATH') )
	define('ABSPATH', dirname(__FILE__) . '/');

dans votre fichier wp-config.php.

Remplacez custom-files/content-switcher par ce que vous voulez. La valeur de CONTENT_SWITCHER_CUSTOM_FILES_PATH doit se terminer par un /.

9.2 Langues Personnalisées

Content Switcher est développé en anglais et contient des fichiers qui le traduisent en français. Si vous le souhaitez, vous pouvez le traduire dans une autre langue.

Pour cela, créez votre répertoire de fichiers personnalisés en suivant ces indications. Créez le dossier languages à l'intérieur de celui-ci, et uploadez vos fichiers de traduction dans ce dossier.

Vous pouvez créer vos fichiers de traduction grâce au fichier languages/content-switcher.pot du plugin, et en utilisant le logiciel gratuit Poedit. Vos deux fichiers de traduction MO et PO doivent être nommés comme ceci :

content-switcher-ll_CC.mo
content-switcher-ll_CC.po

ll_CC est la valeur affichée par cette ligne de cotillon :

echo get_locale();

lorsqu'elle est exécutée dans l'un des fichiers de votre site WordPress.

10. FAQ

10.1 Pourquoi Google Optimize ne fonctionne-t-il pas sur mon site Web ?

Vérifiez que la case Ajouter le code JavaScript de la page d'options de Content Switcher est cochée. Vérifiez aussi le champ ID du conteneur de votre compte Google Optimize dans cette même page. Vérifiez le fichier header.php de votre thème WordPress. Assurez-vous qu'il contient un appel à la fonction wp_head.

10.2 Comment puis-je utiliser des cotillons dans mon thème WordPress ?

Insérez dans les fichiers PHP de votre thème un cotillon comme celui-ci :

<?php echo do_shortcode('[votre-cotillon]'); ?>

10.3 Comment puis-je utiliser des cotillons dans les commentaires ?

Modifiez le fichier functions.php (créez-le s'il n'existe pas) de votre thème WordPress et ajoutez cette ligne de cotillon :

add_filter('comment_text', 'do_shortcode');

10.4 Comment puis-je utiliser des cotillons dans les attributs des cotillons ?

Vous pouvez entrer des cotillons pour la plupart des attributs des cotillons de Content Switcher, à condition de remplacer [ par ( et ] par ), comme ceci :

[votre-cotillon attribut='(votre-autre-cotillon)']

N'oubliez pas les guillemets simples au début et à la fin du cotillon.

10.5 Comment puis-je imbriquer plusieurs cotillons identiques ?

Lorsque vous imbriquez plusieurs cotillons identiques, vous devez ajouter un nombre entier entre 1 et 3 à la fin des tags de ces cotillons afin qu'ils fonctionnent correctement, comme ceci :

[variable-content…]…
[variable-content1…]…
[variable-content2…]…
[variable-content3…]…
[/variable-content3]…
[/variable-content2]…
[/variable-content1]…
[/variable-content]

Traducteurs