Extension: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 | |
|
|
|
| Téléchargements trimestriels | 28 (Ranked 116th) |
| 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é
RandomSelectiondans votre dossierextensions/.
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.
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 |
<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
- Extension:RandomImage — Permet la randomisation de contenu multimédia sur une page
| Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets : Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer. |