Extension:InputBox

Manuel des extensions MediaWiki

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)	Erik Möller Leonardo Pimenta Rob Church Trevor Parscal Daniel Schuba
Dernière version	Continuous updates
MediaWiki	>= 1.45
Modifie la base de données	Non
Licence	Licence MIT
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (Phabricator · GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source
Balises <inputbox>
Accroches utilisées MediaWikiPerformAction ParserFirstCallInit SpecialPageBeforeExecute
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

Cette extension est fournie avec MediaWiki 1.21 et supérieur. Les instructions de configuration restantes doivent encore être suivies.

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé InputBox 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/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 = 30px   <!-- with unit of measurement -->
break = no
placeholder = Page title
</inputbox>

Syntaxe générale

Les boîtes de saisie sont construites comme ceci :

<inputbox>
type              = <!-- <input> type  ==  search search2 create comment commenttitle fulltext move -->
bgcolor           = <!-- Background color of parent <form>. -->
width             = <!-- Width of text field (searchbox) in 'characters'. Unit: Characters #Default: 50 -->
page              = <!-- Wiki pagename (i.e. page title) to post comment to, or move page to. No [[X]]. -->
default           = <!-- Initial value of the text field. -->
preload           = <!-- Content to prepopulate the source editor with for a new topic/comment, or new page. -->
editintro         = <!-- Wiki pagename of page to be transcluded as 'help text' shown above source editor window. -->

hidden            = <!-- Any value will hide the text field, but not buttons whose links will still work. -->
searchbuttonlabel = <!-- Visual label for "Search full text" in type == search == fulltext. -->
searchengine      = <!-- optionally "MediaSearch" (Extension:MediaSearch) "Search" #Default: local wiki default. -->
fulltextbutton    = <!-- Visual label for "Search full text" -->
labeltext         = <!-- labeltext -->
break             = <!-- break -->
namespaces        = <!-- namespaces -->
prefix            = <!-- prefix -->
placeholder       = <!-- placeholder -->
minor             = <!-- minor -->
nosummary         = <!-- nosummary -->
summary           = <!-- summary -->
id                = <!-- id -->
inline            = <!-- inline -->
dir               = <!-- dir -->
preloadparams[]   = <!-- preloadparams[] -->
searchfilter      = <!-- searchfilter -->
useve             = <!-- useve -->
usedt             = <!-- usedt -->
arialabel         = <!-- arialabel -->
buttonlabel       = <!-- Visual label for primary search button. -->
</inputbox>

Buttons are not exposed to assistive technology: currently the button elements generated by this template have no accessible label. Screen readers therefore announce only the element role (for example, "Button.") rather than a meaningful label. There is no reliable way to add an accessible label without access to the HTML code.

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= . Dans certains cas cela ne fonctionne pas lorsque l'extension est appelée avec {{#tag}}; utiliser ‎<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	Résultat	Exemple	Compatibilité
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 Voir ARIA : attribut aria-label.	Tous les types		<inputbox> type=search arialabel=Search the wiki </inputbox>	≥ 1.35 Gerrit change 572050
bgcolor=	Initialise la couleur de fond de la table (valeurs de couleur HTML). Ne pas utiliser d'apostrophes.	Tout type		<inputbox> type=search bgcolor=gray </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 « default », qui n’est plus une valeur par défaut actuellement, mais la valeur fixe du nom de la page. Toute valeur signifie « yes » ou « true ».	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>	?
searchengine=	Si Extension:MediaSearch est installé, ce paramètre définit la page spéciale de recherche à Search ou à MediaSearch. Si ce paramètre n'est pas utilisé, on prendra les préférences de l'utilisateur (ou les valeurs par défaut du wiki).	search, search2		<inputbox> type=search searchengine=MediaSearch </inputbox>	Version de MediaWiki : 1.45 Gerrit change 1167841
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	Chercher :	<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 « Main** », l'espace de noms des articles principaux est coché par défaut.	search, fulltext	Main Help	<inputbox> type=search namespaces=Main**,Help </inputbox>	?
prefix=	Restreindre la recherche aux pages commençant avec un préfixe donné. Remarquez que ceci ne fonctionne qu'avec certain serveurs, actuellement seulement Extension:CirrusSearch/fr . Chaîne vide par défaut (recherche sur toutes les pages). Crée une nouvelle page commençant avec un préfixe donné. Dans type=move, le préfixe est ajouté avant le début du paramètre par défaut. Remarque : les caractères souligné '_' ne sont pas reconnus en tant qu'espaces.	search, fulltext, create	Le bouton ci-dessous préfixe le nom avec Special:Mypage/.	<inputbox> type=search prefix={{FULLPAGENAME}}/Archive </inputbox>	?
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>	≥ 1.19
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>	≥ 1.23 for some types
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 :	Texte ici : <inputbox> type=search2 inline=true width=10 </inputbox>
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>	≥ 1.25
searchfilter=	Spécifiez les paramètres à ajouter à la recherche	search, fulltext		<inputbox> type=search searchfilter=insource:foo </inputbox>	≥ 1.30
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.

Customizing with CSS

You can customize the inputbox in templates using CSS. First, wrap the inputbox in ‎<div> tags with an unique ID then use CSS selectors to change its appearance. You could also give the inputbox itself an ID and use the ID in the CSS selectors. You could also add a custom search button or icon.

Template:Exampleinputbox

<templatestyles src="Template:Example/styles.css"/><div id = "inputbox-search-wrapper">
{{#tag: inputbox|
type        = search
id          = inputbox-search
placeholder = Search all pages
namespaces  = Main**,Help**
}}<div class = "inputbox-search-icon"></div>
</div>

Exampleinputbox/styles.css

#inputbox-search-wrapper {
	box-sizing: border-box;
    height: 32px;
    display: flex;
    border: 1px solid var(--border-color-base, #a2a9b1);
    border-radius: 10px;
}

#inputbox-search-wrapper input {
	all: unset;
    padding-left: 8px;
    padding-top: 6px;
    padding-bottom: 6px;
    width: 180px !important;
	font-family: 'Helvetica Neue', 'Helvetica', 'Liberation Sans', 'Arial', sans-serif;;
    font-size: 14px;
    line-height: 20px;
    color: var(--color-base--subtle, #72777d);
}

#inputbox-search-wrapper input::placeholder {
	font-family: 'Helvetica Neue', 'Helvetica', 'Liberation Sans', 'Arial', sans-serif;;
    font-size: 14px;
    line-height: 20px;
    color: var(--color-base--subtle, #72777d);
}

#inputbox-search-wrapper input.mw-ui-button,
.searchbox .cdx-checkbox--inline,
#inputbox-search-wrapper .cdx-button,
#inputbox-search-wrapper div.mw-ui-checkbox {
	display: none;
}

.inputbox-search-icon {
    padding-left: 8px;
    width: 25px;
    background-image: url("https://upload.wikimedia.org/wikipedia/commons/thumb/7/7e/Vector_search_icon.svg/18px-Vector_search_icon.svg.png");
    background-repeat: no-repeat;
    background-position: center;
    cursor: pointer;
}

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 :

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 que si la balise ‎<inputbox>...‎</inputbox> est utilisée via la fonction d'analyse syntaxique #tag avec {{#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

• Extension:Create Page