Jump to content

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 de l'ensemble donné
Auteur(s)
Dernière version 3.0.0 (2018-09-09)
MediaWiki 1.39+
Modifie la base
de données
Non
Licence Licence publique générale GNU v2.0 ou supérieur
Téléchargement
Exemple

  • ‎<choose>
  • ‎<option>
  • ‎<choicetemplate>
Téléchargements trimestriels 28 (Ranked 98th)
Utilisé par les wikis publics 7,190 (Ranked 23rd)
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' );
    
  • 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 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 tâche 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.

<span id="Parameters_to_‎<choose>">

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>

<span id="Parameters_to_‎<option>">

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