Manuel:Formulaires
 | Please note: Some techniques recommended in this article require the use of extensions. Exercise caution when using them, as the status of each extension is self-assigned by its maintainer, and does not reflect the opinion of the MediaWiki development team.
Rappelez vous : certaines techniques recommandées dans cet article nécessitent l'utilisation d'extensions. Faites preuve de prudence lors de leur utilisation car le statut de chaque extension est auto-attribué par son mainteneur et ne reflète pas le point de vue de l'équipe de développement de MediaWiki. |
Dans l'écosystème Mediawiki le concept de formulaire peut avoir 3 sens différents :
- Les formulaires inclus dans le logiciel Mediawiki à l'aide desquels les utilisateurs peuvent s'inscrire ou se connecter, éditer le wikicode des pages, et même réaliser des recherches structurées via un large éventail de pages spéciales
- Les formulaires de saisie qui permettent aux administrateurs de wiki d'obtenir les données générées par les visiteurs, se trouvant dans les articles usuels du wiki ou les pages spéciales.
- Les formulaires situés soit dans les articles wiki standard et les pages spéciales par lesquels les utilisateurs peuvent entrer des données structurées pour créer un nouvel article du wiki et précharger de tels articles avec les données saisies (ces types de formulaires sont connus comme des formulaires de page)
Formulaires prédéfinis
MediaWiki lorsqu'il est utilisé en local, utilise des entrées de données basées sur les formulaires pour une variété de fonctions sur les pages de maintenance et administratives. Les articles MediaWiki eux-mêmes sont créés en utilisant du wikicode de forme libre. Comme la plupart des autres fonctionnalités de MediaWiki, il existe de nombreuses adaptations possibles.
Adapter les formulaires prédéfinis
Veuillez lire les articles suivants :
- Manuel:Interface, Messages système – décrit comment personnaliser ou traduire le texte qui apparaît dans les formulaires inclus utilisés par MediaWiki.
Formulaires de saisie
Les formulaires de saisie sont des formulaires standard placés soit dans les articles wiki ou sur les pages spéciales où les visiteurs peuvent saisir des données structurées (telles que les informations de contact) et les administrateurs peuvent accéder aux données envoyées facilement et en toute sécurité. Parce qu'un MediaWiki local ne fournit pas cette fonctionnalité, voici une liste d'extensions qui l'implémentent :
- Extension:ContactPage – implémente un simple formulaire de contact à l'intérieur d'une page spéciale fixe
- Extension:EmailPage – permet d'envoyer les articles générés entièrement avec le CSS inclus, vers des utilisateurs, des groupes, ou des listes de contacts
- Extension:CIForms – formulaires avec auto-validation, questionnaires à choix multiple et tests à trous.
- Extension:FlexForm – permet aux utilisateurs de définir des formulaires pour créer et modifier les pages, et pour envoyer des courriels
- Extension:QuickSurveys – les sondages apparaissant sur les articles basés sur une configuration PHP
- LimeSurvey – cela peut être un service payant, s'exécutant dans un environnement externe
Formulaires de page
Les formulaire de page sont des formulaires situés soit dans les articles wiki standard ou sur les pages spéciales, par lesquels les utilisateurs peuvent entrer des données structurées pour créer et (ou) pour éditer des articles du wiki, et précharger de tels articles avec les données saisies. La différence comparée avec les formulaires de saisie, est que ces derniers envoient les données directement vers une adresse courriel fournie (habituellement celle de l'administrateur système), ou rangent les envois dans la base de données de où ils pourront être consultés par les utilisateurs autorisés. En comparaison, page forms utilise l'envoi de formulaire pour remplir un article wiki standard (accessible publiquement sur le wiki) avec quelques données structurées. Voici une liste d'extensions qui implémentent cette fonctionnalité :
- Extension:InputBox – extension pour créer ou renommer les pages, insérer des commentaires et rechercher du texte
- Extension:Page Forms – Extension pour créer et modifier des pages avec le modèle de style boîte d'information via des formulaires
- Extension:FlexForm – permet aux utilisateurs de définir des formulaires pour créer et modifier des pages, et envoyer des courriels
- Extension:Form – Extension qui permet aux utilisateurs de créer de nouveaux articles via un formulaire
- Extension:VisualData – environnement de gestion complet des métadonnées basé sur un schéma JSON capable d'enregistrer, d'organiser et de consulter facilement la collecte des données sur votre wiki
Consulter Extension:Page Forms/Extensions liées pour d'autres informations sur ce type de formulaires.
Créer ou modifier des articles avec des données structurées
Certains articles contiennent un mélange de données structurées et de texte sous forme libre. Par exemple, un article contenant une description d'un contact commercial ou d'un rapport de bogue aurait normalement un ensemble de questions qui doivent toujours être répondues pour créer un article complet. Dans ce cas, un formulaire ou un article avec du wikicode préchargé peut être plus adapté. Autres informations sur cette approche, voir Manuel:Création de pages avec du texte préchargé.
Maîtrise du processus d'édition
Si vous développez une extension et que vous souhaitez qu'elle intercepte le processus d'édition, voyez l'utilisation des accroches :
- AlternateEdit – est appelé sur action=edit. Cela permet aux installations MediaWiki une opportunité pour fournir une réponse alternative à l'action d'éditer.
- EditPage::showEditForm:initial – est appelé quand la fenêtre textuelle utilisée pour saisir le wikicode est affichée. Cela donne aux développeurs d'extensions la possibilité de définir une alternative à la simple boîte d'édition. Liste des extensions qui utilisent cette accroche, voir Catégorie:Extensions liées à EditPage::showEditForm:initial.