Extended Inputbox

Extension MediaWiki qui ajoute des formulaires en fenêtre modale aux balises <inputbox> de l'extension InputBox. Elle permet notamment de recueillir plusieurs valeurs avant de créer ou modifier une page, de précharger un modèle et de personnaliser le bouton.

Compatible avec MediaWiki 1.39+ et avec l'extension InputBox.

Prérequis

• MediaWiki 1.39 ou supérieur
• Extension InputBox installée et activée

---

Installation

1. Installez et activez l'extension InputBox.

2. Téléchargez ou clonez ce dépôt dans le dossier extensions/ de votre installation MediaWiki :

   cd extensions/
   git clone https://github.com/Janusdevikidia/Extended-Inputbox.git

3. Ajoutez la ligne suivante dans LocalSettings.php :

   wfLoadExtension( 'Extended-Inputbox' );

4. Lancez la maintenance de MediaWiki si votre installation le demande, puis purgez une page de test (?action=purge).

Exemple minimal

Cet exemple ouvre un formulaire, demande le titre de la nouvelle page et crée la page sous le préfixe Brouillon:. Le premier champ correspond à $1 ; page=$1 est donc remplacé par sa valeur.

<inputbox>
type=create
prefix=Brouillon:
page=$1
buttonlabel=Créer un brouillon
popup-title=Créer un brouillon
popup-field=titre|text|Titre du brouillon|||yes
</inputbox>

La valeur des champs n'est pas interpolée par MediaWiki dans page= : utilisez $1, $2, etc. ou définissez l'ordre avec preload-params.

Exemple avec liste, condition et préchargement

Le modèle Modèle:Préchargement fiche peut employer $1 et $2. Ici, ils reçoivent respectivement titre et categorie, car cet ordre est déclaré explicitement.

<inputbox>
type=create
page=$1
preload=Modèle:Préchargement fiche
preload-params=titre,categorie
buttonlabel=Créer la fiche
popup-title=Nouvelle fiche
popup-text=Renseignez les informations ci-dessous.
popup-field=titre|text|Titre|||yes
popup-field=categorie|select|Catégorie|Histoire,Géographie,Sciences||yes
popup-field=periode|text|Période||show-if:categorie=Histoire|non
</inputbox>

Dans le dernier champ, show-if:categorie=Histoire le rend visible seulement lorsque « Histoire » est sélectionné. popup-text est un texte d'introduction et doit être associé à popup-title ou à au moins un popup-field.

Exemple avec cases à cocher et champs obligatoires

<inputbox>
type=create
page=$1
buttonlabel=Signaler un problème
popup-title=Signaler un problème
popup-field=titre|text|Titre du signalement|||yes
popup-field=categories|checkbox|Catégories concernées|Contenu,Mise en forme,Source
popup-field=details|textarea|Détails
</inputbox>

Ici, categories est une case à cocher multiple : les valeurs sélectionnées sont toujours jointes avec , dans la variable correspondante. titre est obligatoire (required=yes) ; details est facultatif.

Publication directe (sans écran d'édition)

Ajoutez popup-skip-edit=yes pour publier à la validation de la fenêtre. Il est recommandé de fournir un preload : son contenu est récupéré, puis les variables $1, $2, etc. y sont remplacées avant l'enregistrement.

<inputbox>
type=create
page=$1
preload=Modèle:Préchargement annonce
preload-params=titre,texte
popup-skip-edit=yes
buttonlabel=Publier l'annonce
popup-title=Nouvelle annonce
popup-field=titre|text|Titre|||yes
popup-field=texte|textarea|Texte|||yes
</inputbox>

Sans popup-skip-edit=yes, l'utilisateur est redirigé vers l'éditeur MediaWiki ; le préchargement et les paramètres restent alors disponibles via le mécanisme standard d'InputBox.

Paramètres ajoutés

Les paramètres standards d'InputBox (type, page, prefix, preload, buttonlabel, default, summary, etc.) restent disponibles.

Paramètre	Description
popup-title	Titre de la fenêtre modale.
popup-text	Texte affiché au début de la fenêtre.
popup-field	Ajoute un champ ; son format est détaillé ci-dessous.
skip-edit=yes	Publie directement la page après validation de la fenêtre. Nécessite une popup.
required-marker=(obligatoire)	Remplace le marqueur visuel des champs requis pour cette popup. Laissez la valeur vide pour ne pas l'afficher ; le défaut est défini par la traduction du wiki. Alias : popup-required-marker.
preload-params=a,b,c	Associe $1, $2, $3 aux champs nommés a, b, c. Alias : popup-preload-params, preloadparams.
button-bgcolor ou button-bg	Couleur CSS de fond du bouton.
button-border-color ou button-border	Couleur CSS de bordure du bouton.

popup-preload est obsolète : utilisez le paramètre standard preload.

Format de popup-field

popup-field=nom|type|libellé|options|show-if|required

Seuls nom, type et libellé sont obligatoires. Conservez les séparateurs vides (||) pour atteindre un paramètre situé plus loin dans la liste.

Position	Nom	Description
1	nom	Identifiant du champ ; sert dans show-if et preload-params. Évitez les doublons.
2	type	text, textarea, select, radio, checkbox ou checkboxes.
3	libellé	Libellé affiché dans le formulaire.
4	options	Liste séparée par des virgules pour select, radio et checkbox ; valeur initiale pour text et textarea.
5	show-if	Condition de visibilité, sous la forme show-if:champ=valeur. & signifie ET, , signifie OU.
6	required	yes rend le champ obligatoire. Toute autre valeur (ou l'absence de segment) le laisse facultatif.

Les virgules séparent les options et les barres verticales séparent les segments : une option ne peut donc pas contenir ces caractères tels quels.

Ce format volontairement court n'offre pas de valeur présélectionnée pour select/radio/checkbox, pas de texte indicatif (« placeholder »), pas d'aide contextuelle, pas de contrainte de longueur (minlength/maxlength) et pas de séparateur personnalisable pour les cases cochées :

• un select ou un radio s'ouvre toujours sur son premier choix ;
• un checkbox démarre toujours sans case cochée ;
• les valeurs cochées d'un checkbox sont toujours jointes avec , ;
• text et textarea peuvent toujours recevoir une valeur initiale via options (4ᵉ segment), qui est alors un texte simple plutôt qu'une liste.

Couleurs de bouton

<inputbox>
type=create
buttonlabel=Créer une page
button-bgcolor=#3366cc
button-border-color=#1a3d7c
</inputbox>

Les formats usuels de couleur CSS sont acceptés (#3366cc, rgb(...), hsl(...) et les noms CSS). Une couleur invalide laisse le formulaire utilisable et affiche une erreur sous celui-ci.

Performances et fonctionnement

Les configurations sont analysées côté serveur pendant le rendu : les couleurs et les attributs nécessaires à la popup sont donc déjà présents dans le HTML. Le module OOUI, plus lourd, n'est chargé que lorsqu'au moins une popup est réellement configurée. Aucun appel API client n'est fait pour une InputBox présente dans le rendu initial.

Un petit module de secours reste chargé sur les pages contenant une InputBox : il couvre les formulaires ajoutés dynamiquement (prévisualisation, gadget, VisualEditor). Dans ce cas rare, il lit la configuration de la page via l'API.

Mots magiques dans preload et default

Les mots magiques {{CURRENTYEAR}}, {{CURRENTTIME}}, etc. sont toujours exprimés en UTC, comme dans MediaWiki natif. Les variantes {{LOCALYEAR}}, {{LOCALTIME}}, etc. reflètent le fuseau horaire configuré par $wgLocaltimezone sur le wiki — pas le fuseau du navigateur de la personne qui remplit le formulaire. Si $wgLocaltimezone n'est pas défini (valeur par défaut UTC), LOCAL* et CURRENT* sont identiques.

Migration depuis la v2

La v2.5 simplifie le format de popup-field en retirant les segments default, separator, placeholder, maxlength, minlength et help. Le format passe de 12 à 6 segments :

# v2
popup-field=nom|type|libellé|options|show-if|default|separator|required|placeholder|maxlength|minlength|help

# v2.5
popup-field=nom|type|libellé|options|show-if|required

required change donc de position (8ᵉ segment en v2, 6ᵉ en v2.5). Pour mettre à jour une InputBox existante :

1. repérez la valeur du 8ᵉ segment (required, yes ou vide) ;
2. reconstruisez la ligne avec seulement les 6 premiers rôles : nom|type|libellé|options|show-if|required ;
3. si vous utilisiez default pour présélectionner un select/radio/checkbox, cette présélection n'est plus possible : le champ s'ouvrira sur son état initial natif (premier choix pour select/radio, aucune case cochée pour checkbox) ;
4. si vous utilisiez placeholder, help, minlength ou maxlength, ces indications doivent être déplacées dans popup-text ou dans le libellé du champ, si elles restent nécessaires ;
5. si vous utilisiez separator pour joindre les cases cochées, le séparateur est désormais toujours , .

Après une mise à jour, purgez les pages qui utilisent l'extension. Testez en particulier les InputBox générées par des modèles, ainsi que les pages comportant plusieurs InputBox : la correspondance est faite dans leur ordre d'apparition.