Jump to content
MediaWiki

Extension:RandomSelection

From mediawiki.org
This page is a translated version of the page Extension:RandomSelection and the translation is 100% complete.
Manuel des extensions MediaWiki
RandomSelection
État de la version : stable
Implémentation Balise , Fonction d'analyseur
Description Affiche une option aléatoire parmi un ensemble donné
Auteur(s)
Dernière version 3.0.0 (2018年09月09日)
MediaWiki 1.43+
Modifie la base
de données 		Non
  • $wgRandomSelectionAllowUncached
  • ‎<choose>
  • ‎<option>
  • ‎<choicetemplate>
Licence Licence publique générale GNU v2.0 ou ultérieur
Téléchargement
Exemple
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 changeantes, 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:
    cdextensions/
gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/RandomSelection
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  : 
    wfLoadExtension( 'RandomSelection' );
  • Yes 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 simplement chaque option à l'intérieur de balises ‎<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> spécifique sera choisie au hasard et son contenu sera affiché. Le contenu des balises d’option est quelconque. Vous pouvez y placer 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 un modèle [[Template:PageWithEditButton]] avec ce contenu : 

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

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

Paramètres de choose

Paramètres Description
uncached désactiver la mise en cache pour l'option choisie
before mettre ce texte avant l’option choisie
after mettre ce texte après l'option 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 de 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 s'affichera 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 décimales 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'analyse #choose:, comme suit : 

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

Pour chaque choix séparé par la barre verticale, un choix précis sera sélectionné au hasard et son contenu sera affiché.

Si vous souhaitez que certaines options apparaissent plus souvent que d'autres, vous pouvez leur affecter un poids comme nom de paramètres de cette façon : 

{{#choose:
 2=Cette option apparaîtra deux fois plus souvent qu’une option normale.
 |Par défaut, les options ont pour poids <code>1</code>.
 |1.5=Cette option a également un poids de 1. Les décimales sont ignorées.
}}

Si l'option contient =, vous devez l'échapper soit en la remplaçant par {{=}} ou en la préfixant avec 1=.

MediaWiki traite le premier paramètre différemment : il est étendu avant d'être passé à la fonction d'analyse. Par conséquent, si le résultat étendu contient =, vous devez l'échapper avec 1= ({{=}} ne fonctionne pas).

Exemple :

  • {{#choose:2 + 2 = 4}} → 4
  • {{#choose:2 + 2 {{=}} 4}} → 4
  • {{#choose:1=2 + 2 = 4}} → 2 + 2 = 4

Voir aussi

Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets :

AltStyle によって変換されたページ (->オリジナル) /