Extension:RandomSelection

Manuel des extensions MediaWiki

RandomSelection État de la version : stable
Implémentation	Balise , Fonction d'analyseur
Description	Affiche une option aléatoire de l'ensemble donné
Auteur(s)	Ross McClure Jack Phoenix
Dernière version	3.0.0 (2018-09-09)
MediaWiki	1.43+
Modifie la base de données	Non
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source
Exemple	Exemple sur Mises Wiki
Balises ‎<choose> ‎<option> ‎<choicetemplate>
Accroches utilisées MagicWordwgVariableIDs ParserFirstCallInit
Traduire l’extension RandomSelection sur translatewiki.net si elle y est disponible

L'extension RandomSelection permet de générer un contenu aléatoire dans votre wiki, par exemple des images tournantes, des messages d'accueil aléatoires, etc.

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé RandomSelection dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RandomSelection
  

• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'RandomSelection' );
  

• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Usage

Balises

Pour choisir entre une ou plusieurs options, il suffit de placer chaque option à l'intérieur d'une balise ‎<option>, elles-mêmes placées à l'intérieur de balises ‎<choose>, comme suit :

<choose>
<option>Ceci est le premier choix.</option>
<option>Ceci est le second choix.</option>
<option>Et ainsi de suite...</option>
</choose>

Dans chaque ensemble de balises ‎<choose>, une balise ‎<option> sera choisie au hasard et son contenu sera affiché. N’importe quoi peut être placé à l’intérieur des balises d’option : des liens, des images et même des modèles.

Toutefois, les arguments du modèle ne seront pas étendus en raison de la valeur de T4257.

Vous pouvez également faire en sorte que ce qui est placé à l'intérieur des balises d'option soit envoyé comme argument à un modèle avec la balise ‎<choicetemplate>, par exemple :

<choose>
<option>Template:Featured article/Elephant</option>
<option>Template:Featured article/Giraffe</option>
<option>Template:Featured article/Rhinoceros</option>
<choicetemplate>PageWithEditButton</choicetemplate>
</choose>

Vous pouvez ensuite créer [[Template:PageWithEditButton]] avec ces contenus :

[{{canonicalurl:{{{1}}}|action=edit}} Edit] {{{{{1}}}}}

Cette fonction est utile si vous souhaitez mettre en place des articles vedettes à rotation aléatoire et disposer d'un bouton d'édition permettant à l'utilisateur de modifier le texte de l'article vedette.

Paramètres à choose

Paramètres	Description
uncached	Désactiver la mise en cache pour l'option choisie
before	Mettez ce texte avant l’option choisie
after	Mettez ce texte après le texte choisie

Depuis la version 2.2.2, la mise en cache dans la balise ‎<choose> n'est désactivée que si l'utilisateur spécifie ‎<choose uncached>. Auparavant, la mise en cache était désactivée par défaut.

Si vous voulez désactiver la mise en cache pour les options, vous devez ajouter le paramètre uncached.

<choose uncached>
<option>Ceci est le premier choix.</option>
<option>Ceci est le second choix.</option>
<option>Et ainsi de suite...</option>
</choose>

Si vous souhaitez afficher l'une des trois vidéos YouTube, vous pouvez essayer ceci (Extension:Widgets et Extension:YouTube requis) :

<choose before="{{#widget: YouTube|id=" after="}}">
<option>eR7-AUmiNcA</option><!--King of Anything-->
<option>cSCi7kCXKDA</option><!--Slipping Through My Fingers-->
<option>7n2d9XPsmmE</option><!--When Death Note Music Plays in My Car-->
</choose>

Paramètres à option

Paramètres	Description
weight	Poids de l’option

Si vous souhaitez que certaines options soient affichées plus souvent que d'autres, vous pouvez ajouter un poids aux balises d'option, comme suit :

<choose>
<option weight="2">Cette option sera affichée deux fois plus souvent qu’une option normale.</option>
<option>Par défaut, les options ont un poids de 1.</option>
<option weight="1.5">Cette option a aussi un poids de 1. Les fractions sont ignorées.</option>
</choose>

Fonctions d'analyse

Pour choisir entre une ou plusieurs options, il suffit de placer chaque option à l'intérieur de la fonction d'analyseur #choose:, comme suit :

{{#choose:
 |Ceci est le premier choix.
 |Ceci est le second choix.
 |Et ainsi de suite...
}}

Pour chaque choix divisé par un tuyau, un choix précis sera sélectionné au hasard et son contenu sera affiché. N’importe quoi peut être placé à l’intérieur : des liens, des images et même des modèles.

Voir aussi

• Extension:RandomImage — Permet la randomisation de contenu multimédia sur une page