Extension:InputBox
 État de la version : stable |
|
|---|---|
 |
|
| Implémentation | Balise, Action de page, Rechercher |
| Description | Autorise les utilisateurs à ajouter des formulaires HTML prédéfinis aux pages wiki |
| Auteur(s) |
|
| Dernière version | Continuous updates |
| MediaWiki | >= 1.43 |
| Modifie la base de données |
Non |
| Licence | Licence MIT |
| Téléchargement | |
| Exemple | |
|
|
| Téléchargements trimestriels | 239 (Ranked 23rd) |
| Utilisé par les wikis publics | 10,897 (Ranked 10th) |
| Traduire l’extension InputBox sur translatewiki.net si elle y est disponible | |
| Problèmes | Tâches ouvertes · Signaler un bogue |
L'extension InputBox ajoute des formulaires HTML déjà créés aux pages wiki. Les utilisateurs peuvent “compléter” un formulaire (en saisissant du texte, en sélectionnant des éléments de menu, etc.) en saisissant du texte dans la boîte.
InputBox a été créé initialement par Erik Möller dans le but d'ajouter une boîte Créer un article à Wikinews.
Installation
- Téléchargez et placez le(s) fichier(s) dans un répertoire appelé
InputBoxdans 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/InputBox - Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
wfLoadExtension( 'InputBox' );
Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.
Exemple
Boîte pour initier un nouvel article.
Code wiki
<inputbox>
type=create
width=30
break=no
</inputbox>
Résultat
Syntaxe générale
Les boîtes de saisie sont construites comme ceci :
<inputbox>
type=
bgcolor=
width=
page=
default=
preload=
editintro=
buttonlabel=
hidden=
searchbuttonlabel=
fulltextbutton=
labeltext=
break=
namespaces=
prefix=
placeholder=
minor=
nosummary=
summary=
id=
inline=
dir=
preloadparams[]=
searchfilter=
useve=
usedt=
arialabel=
</inputbox>
Le paramètre type est obligatoire.
Tous les autres paramètres sont optionnels.
preloadparams[] peut apparaître plusieurs fois.
Types de boîtes
La position par défaut (du ou) des boutons de type Soumettre est en-dessous de la boîte de saisie.
Le bouton Soumettre peut être déplacé vers la droite en utilisant le paramètre de retour à la ligne afin d'éliminer le retour à la ligne entre la boîte et le bouton : break=no.
Le fait d'avoir le bouton Soumettre à droite est utile pour les boîtes de recherche si les suggestions de recherche venaient à couvrir le bouton de recherche sous la boîte de recherche.
| type | Exemple | Description |
|---|---|---|
| search | Crée une boîte de recherche par défaut avec 50 caractères. Information ajoutée à la boîte de texte et sur laquelle porte la recherche soit pour la page exacte (1er bouton) ou le texte dans les articles (2nd bouton). | |
| create | Crée une nouvelle page. L'information ajoutée à la boîte de texte est le nom de la page à créer (ou la page à modifier si elle existe déjà). | |
| comment | Ajoute une nouvelle section en bas de la page spécifiée dans la boîte de texte (crée la page si elle n'existe pas). | |
| commenttitle | Ajoute une nouvelle section dont l'entête est ce qui est entré dans la boîte de texte. Le titre peut être spécifié avec le paramètre default= . La page doit être spécifiée avec le paramètre page= . For some reason this does NOT work when using the extension by invoking it with {{#tag}}, only when using <inputbox>. (introduit dans rev:47203)
| |
| fulltext | Rechercher uniquement avec le bouton de recherche dans le texte complet, sans le bouton de recherche exacte (bouton Consulter). (introduit dans rev:45269) | |
| move | Renommer une page sous un nom différent. This also doesn't work when creating it by invoking a tag. (introduit dans gerrit:97559) |
Pour type=search2, la position par défaut du bouton de recherche est en ligne, sur la droite.
Actuellement il ne semble pas possible d'ajouter des paramètres à ce type de boîte de saisie.
Cette boîte de recherche opère sur la totalité du wiki dans lequel elle se trouve.
| type | Exemple |
|---|---|
| search2 |
Paramètres
| Paramètre | Description | Couverture | Compatibilité | Exemple | Résultat | |
|---|---|---|---|---|---|---|
| arialabel= | Renseigner l'attribut aria-label dans la boîte de saisie permet au balisage généré d'être accessible aux lecteurs d'écrans | Tous les types |
|
<inputbox>
type=search
arialabel=Search the Wiki
</inputbox>
|
||
| bgcolor= | Initialise la couleur de fond de la table (valeurs de couleur HTML). Ne pas utiliser d'apostrophes. | Tout type | ? | <inputbox>
type=search
bgcolor=#eeeeff
</inputbox>
|
||
| width= | Initialise la largeur de la boîte de saisie en nombre de caractères. | Tout type | ? | <inputbox>
type=create
width=24
</inputbox>
|
||
| default= | Texte par défaut à placer dans la boîte de saisie. | Tout type | ? | <inputbox>
type=comment
default=User talk:Eloquence
</inputbox>
|
||
| preload= | La page qui a ce titre sera pré-chargée (voir Manuel:Création de pages avec du texte préchargé) dans la boîte d'édition vierge lorsqu'une nouvelle page sera créée. | create, comment, commenttitle | ? | <inputbox>
type=create
preload=Log
</inputbox>
|
||
| Entrez dans les boîtes de saisie d'exemple de cette page, le titre d'une page qui n'existe pas, et cliquez sur "Créer une page" ou "Nouvelle section" respectivement pour tester cet effet. | ||||||
| editintro= | La page référencée par ce paramètre sera affichée, selon les instructions, au-dessus de la fenêtre d'édition. | create, comment | ? | <inputbox>
type=comment
editintro=MediaWiki:Missingcommenttext
</inputbox>
|
||
| buttonlabel= | Cette étiquette sera utilisée pour le bouton principal du formulaire. | Tout type | ? | <inputbox>
type=comment
buttonlabel=Ajouter une nouvelle rumeur
</inputbox>
|
||
| hidden= | Ceci indique qu'il n'existe pas de boîte de saisie.
Il est utilisé avec le paramètre « |
create, comment | ? | <inputbox>
type=comment
editintro=Extension:InputBox/editintro comment
preload=Extension:InputBox/preload
hidden=yes
default=Extension talk:InputBox
buttonlabel=Publier un commentaire sur la page de discussion.
</inputbox>
|
||
| searchbuttonlabel= | Cette étiquette sera utilisée pour le bouton de "Recherche de texte complet" du formulaire de recherche. | search, fulltext | ? | <inputbox>
type=search
searchbuttonlabel=Creuser un peu plus
</inputbox>
|
||
| fulltextbutton= | Affiche le bouton de recherche de texte complet sur le formulaire search2 | search2 | ? | <inputbox>
type=search2
searchbuttonlabel=Creuser un peu plus
fulltextbutton=true
</inputbox>
|
||
| labeltext= | Texte à afficher à côté du bouton | search2 | ? | <inputbox>
type=search2
searchbuttonlabel=Creuser un peu plus
labeltext=Chercher :
</inputbox>
|
||
| break= | Indique s'il faut ou non insérer un retour à la ligne entre la boîte de saisie et le/les bouton(s). Par défault à yes (utilise un retour à la ligne). | Tout type | ? | <inputbox>
type=create
width=24
break=no
</inputbox>
|
||
| namespaces= | Prise en charge des cases à cocher pour les espaces de noms lors des recherches de texte complet.
Avec « |
search, fulltext | ? | <inputbox>
type=search
namespaces=Main**,Help
</inputbox>
|
||
| prefix= |
Remarque : les caractères souligné '_' ne sont pas reconnus en tant qu'espaces. |
search, fulltext, create | ? | <inputbox>
type=search
prefix={{FULLPAGENAME}}/Archive
</inputbox>
|
Le bouton ci-dessous préfixe le nom avec | |
| placeholder= | Définir un texte de remplacement à afficher dans la boîte de saisie lorsqu'elle est vide. | Tout type |
|
<inputbox>
type=search
placeholder=Chercher sur ce Wiki
</inputbox>
|
||
| page= | Page pour publier les commentaires, ou page à renommer. | comment, move | <inputbox>
type=comment
page=Project:Sandbox
</inputbox>
|
|||
| minor= | Modification mineure. | comment, create | <inputbox>
type=comment
page=Project:Sandbox
minor=true
</inputbox>
|
|||
| nosummary= | Modifier le résumé (titre); n'est pas obligatoire pour les nouveaux commentaires. | comment | <inputbox>
type=commenttitle
page=Special:Mypage/inputbox test
nosummary=true
</inputbox>
|
|||
| summary= | Résumé des modifications ou motif du renommage. | create, move | <inputbox>
type=create
default=Special:Mypage/inputbox test
summary=Foo
</inputbox>
|
|||
| id= | Attribut ID de <form>. | Tout type |
|
<inputbox>
type=comment
page=Project:Sandbox
summary=Foo
id=bar
</inputbox>
|
||
| inline= | Fait en sorte que l’InputBox soit un élément en ligne (sans saut de ligne au début). Toute valeur signifie « yes » ou « true ». | search2 | Texte ici : <inputbox>
type=search2
inline=true
width=10
</inputbox>
|
Texte ici : | ||
| dir= | De la droite vers la gauche (right to left - rtl) ou de la gauche vers la droite (left to right - ltr). Par défaut, il s'agit de la direction utilisée par la langue de la page. | Tout type | <inputbox>
dir=rtl
type=comment
page=Project:Sandbox
summary=Foo
</inputbox>
|
|||
| preloadparams[]= | Précisez les paramètres du texte à pré-charger. Voir Créer des pages avec un texte préchargé. | create, comment, commenttitle |
|
<inputbox>
type=create
preload=Log
preloadparams[]=param1
preloadparams[]=param2
</inputbox>
|
||
| searchfilter= | Spécifiez les paramètres à ajouter à la recherche | search, fulltext |
|
<inputbox>
type=search
searchfilter=insource:foo
</inputbox>
|
||
| useve= | En créant une page, la boîte de saisie utilisera le nouvel Editeur Visuel, si cette extension est installée, et que ce paramètre a une valeur quelconque. | create, comment | <inputbox>
type=create
break=no
useve=true
</inputbox>
|
|||
| usedt= | Lorsque vous ajoutez une nouvelle section, la boîte de saisie va ouvrir l'outil nouvel article de DiscussionTools, si l'extension est installée et que ce paramètre a une valeur quelconque. | comment, commenttitle | <inputbox>
type=commenttitle
page=Project:Sandbox
usedt=true
</inputbox>
|
|||
Appliquer create à une page existante appelle simplement la page de l'éditeur.
Dans ce cas preload est ignoré.
Appliquer comment fonctionne pour une nouvelle page.
Les textes pris dans l'espace de noms MediaWiki: ne sont bien sûr que des exemples; toute page existante peut être utilisée pour editintro ou preload.
Malheureusement preload ne fonctionne pas encore pour le résumé des téléversements.
Alignement
Pour créer une boîte de saisie alignée sur le bord droit de la page, essayez ceci :
<div style="float:right; width:42em">
<inputbox>
type=create
</inputbox>
</div>
Donne :
Fonction de l'analyseur syntaxique
Utiliser InputBox dans un modèle
Afin de créer des boîtes de saisie similaires, InputBox peut être utilisé dans un modèle.
Mais, le fait de passer des paramètres de modèle aux paramètres de InputBox ne fonctionne seulemnt que si la balise <inputbox>...</inputbox> est déclarée comme {{#tag:inputbox | ...}} à l'intérieur du modèle.
L'exemple suivant est un modèle pour créer une nouvelle page wiki à partir d'un modèle nommé :
{{#tag:inputbox |
type=create
buttonlabel=Créer un nouvel {{{1|article}}}
preload={{{2|Template:Article}}} }}
Lors de l'instanciation du modèle, le premier paramètre donne l'élément qui est créé (par défaut: article) comme indiqué sur le bouton, le second paramètre donne le nom du modèle utilisé pour créer l'élément (par défaut: Template:Article).
Par exemple, le code d'une boîte de saisie pour créer un nouveau projet à partir d'un modèle de projet pourrait ressembler à ceci :
{{Template:CreateNew|project|Template:Project}}
Voir aussi
| Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki. |
| 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. |