Extension:Page Forms

Manuel des extensions MediaWiki

Page Forms État de la version : stable
Implémentation	Page spéciale , API
Description	Une extension qui peut être utilisée avec Semantic MediaWiki ou Cargo (ou par elle-même), qui permet aux utilisateurs de créer des formulaires pour ajouter et modifier des pages qui utilisent des modèles de style infobox. Les formulaires sont définis dans des pages wiki, écrits dans un langage de balisage personnalisé et sont analysés à la volée lorsqu'un formulaire est affiché.
Auteur(s)	Yaron Koren <yaron57@gmail.com>, Stephan Gambke et autres
Dernière version	5.8.1 (octobre 2024)
Politique de compatibilité	Le master conserve la compatibilité arrière.
MediaWiki	1.38+
Composer	mediawiki/page-forms
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (Phabricator · GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code
Exemple	Formulaire généré automatiquement permettant à l'utilisateur de modifier un article d'opinion
Paramètres $wgPageForms24HourTime $wgPageFormsAutocompleteCacheTimeout $wgPageFormsAutocompleteOnAllChars $wgPageFormsAutoeditNamespaces $wgPageFormsCacheAutocompleteValues $wgPageFormsCacheFormDefinitions $wgPageFormsCheckboxesSelectAllMinimum $wgPageFormsDisableOutsideServices $wgPageFormsEmbedQueryCacheTTL $wgPageFormsGoogleMapsKey $wgPageFormsHeightForMinimizingInstances $wgPageFormsIgnoreTitlePattern $wgPageFormsLinkAllRedLinksToForms $wgPageFormsListSeparator $wgPageFormsMainFormsMinimum $wgPageFormsMaxAutocompleteValues $wgPageFormsMaxLocalAutocompleteValues $wgPageFormsRenameEditTabs $wgPageFormsRenameMainEditTab $wgPageFormsShowExpandAllLink $wgPageFormsShowTabsForAllHelperForms $wgPageFormsSimpleUpload $wgPageFormsUseDisplayTitle $wgPageFormsVisualEditorMaxHeight
Droits ajoutés viewedittab editrestrictedfields createclass multipageedit
Accroches utilisées AdminLinks ArticlePurge BeforePageDisplay CanonicalNamespaces CargoTablesActionLinks CargoTablesSetActionLinks CargoTablesSetAllowedActions EditPage::importFormData HtmlPageLinkRendererEnd MakeGlobalVariablesScript MultiContentSave PageSaveComplete PageSchemasRegisterHandlers ParserFirstCallInit ResourceLoaderRegisterModules SkinTemplateNavigation::Universal TinyMCEDisable
Accroches fournies PageForms::AddRLModules PageForms::BeforeFreeTextSubst PageForms::CreateFormField PageForms::CreateTemplateText PageForms::EditFormInitialText PageForms::EditFormPreloadText PageForms::FormPrinterSetup PageForms::HTMLBeforeForm PageForms::PrintRedirectForm PageForms::RenderingEnd PageForms::SetTargetName PageForms::TemplateFieldEnd PageForms::TemplateFieldStart PageForms::UserCanEditPage PageForms::WritePageData
Traduire l’extension Page Forms
Rôle Vagrant	pageforms
Problèmes	Tâches ouvertes · Signaler un bogue

Page Forms (appelée Semantic Forms avant 2016) est une extension MediaWiki qui permet à l'utilisateur d'ajouter, d'éditer et de consulter des données à l'aide de formulaires. Elle a été créé à l'origine comme une branche de l'extension Semantic MediaWiki , pour pouvoir éditer des modèles qui stockent leurs paramètres via SMW, d'où le terme Semantic dans son nom. Cependant, elle peut maintenant fonctionner avec l'extension alternative Cargo , ou sans extension installée.

Très simplement, Page Form vous permet d'avoir des formulaires pour créer et éditer des pages sur votre wiki, ainsi que pour interroger des données, le tout sans programmation. Les formulaires peuvent être créés et édités par les administrateurs bien-sûr, mais aussi par les utilisateurs eux-mêmes.

Les principales composantes de la fonctionnalité de Page Form sont les pages de définition de formulaire, qui existent dans un espace de noms distinct, 'Form:' . Ces pages sont composées d'un codage balisé qui est analysé lorsqu'un utilisateur accède à un formulaire. Les formulaires étant définis strictement à travers ces pages de définition, les utilisateurs peuvent les créer et modifier eux-mêmes, sans avoir besoin d'aucune programmation réelle.

L'extension Page Form est surtout utilisée pour ajouter et modifier les appels aux modèles de type infobox dans les pages. Un formulaire permet à un utilisateur de remplir un ensemble prédéfini de modèles, ainsi que des sections de page, pour n'importe quelle page; Si Cargo ou Semantic MediaWiki sont utilisés, les données dans les modèles peuvent ensuite être stockées et interrogées.

Les formulaires peuvent également être utilisés pour modifier les données d'une page existante, et vous pouvez activer un onglet « éditer avec un formulaire » pour afficher sur n'importe quelle page.

Page Form prent également en charge l'autocomplétion des champs, afin que les utilisateurs puissent facilement voir les valeurs entrées précédemment pour un champ donné. Cela contribue grandement à éviter les problèmes de nommage ambigü, l'orthographe, etc.

Dans une page, les données qui ne correspondent pas au formulaire, telles que du texte libre de description du sujet, sont ignorées lorsque la page est éditée par formulaire ; bien plus, elles sont conservées dans une boîte d'entrée appelée « Texte libre » .

Page Form inclut par ailleurs une large variété de fonctionnalités relatives au formulaires.

Vous trouverez ci-dessous les liens vers la documentation complète.

• Téléchargement et installation

Comment télécharger Page Form via Git, téléchargement standard, ou comme package logiciel, et comment l'installer.

• Guide de démarrage rapide

Comment commencer tout de suite avec Page Form.

• Hébergement

Sites d'hébergement de Wiki supportant Page Forms, et Wikis publics permettant d'essayer le logiciel.

• Pages spéciales

Toutes les pages spéciales que Page Form définit : celles procurant des formulaires d'aide (Special:CreateProperty, Special:CreateTemplate, Special:CreateForm, Special:CreateCategory, Special:CreateClass), celles affichant des listes (Special:Templates, Special:Forms), celles utilisées pour afficher les formulaires existants (Special:FormEdit, Special:FormStart, Special:RunQuery, Special:UploadWindow) et une proposant une interface de type tableur pour éditer les pages multiples qui contiennent des modèles (Special:MultiPageEdit).

• Page Forms et modèles

La philosophie de Page Forms basée sur les modèles, plus l'information sur les quatre fonctions d'analyse syntaxique définies par Page Form pour les modèles : #template_params, #template_display, #arraymap et #arraymaptemplate.

• Définir des formulaires

Ceci est la première des sections majeures suivantes. Comment définir un formulaire via une page de l'espace de nommage « Form: » . Couvre la syntaxe entière de définition des formulaires, y compris les étiquettes {{{info}}}, {{{for template}}}, {{{end template}}}, {{{field}}}, {{{section}}} et {{{standard input}}}. Présente aussi comment ajouter des onglets et des bulles d'aide.

• Types d'entrée

Seconde section majeure. Une liste de tous les types d'entrée autorisés, ainsi que des paramètres de chacun, et le jeu de type de donnée SMW et Cargo que chacun peut utiliser.

• Valeurs, cartographies et autocomplétion

La troisième section majeure. Information sur la définition des valeurs possibles ou autorisées associées aux types d'entrée, la correspondance des valeurs et des noms affichés de manière conviviale, les options associées à l'autocomplétion, et le paramètre afficher si sélectionné.

• L'onglet « Éditer avec un formulaire »

Comment faire apparaître l'onglet « Éditer avec un formulaire » sur une page, en utilisant la fonction d'analyse syntaxique #default_form. Aussi, comment renommer l'onglet en Éditer, et comment supprimer (si nécessaire) l'onglet Éditer.

• Liens vers les formulaires

Comment amener les utilisateurs aux formulaires via les fonctions #forminput, #formlink, #formredlink et #queryformlink. Ausi, comment utiliser #formredlink pour la création automatique des liens en rouge vers les pages (manquantes). Et aussi, comment créer des liens modifiants directement une page via la fonction #autoedit.

• Créer des formulaires de requête

Création de formulaires de recherche de données, plutôt que de modifications de données, via la page Special:RunQuery.

• Problèmes courants

Problèmes communs rencontrés et leurs solutions, relativement aux formulaires, au design de structure de données, et utilisation de Page Forms avec d'autres extensions.

• Bogues connus et fonctionnalités planifiées

Bogues connus du logiciel, et contournements possibles : suivi des sujets planifiés dans la feuille de route.

• Obtenir de l'aide

Où poser vos questions, soumettre les rapports de bogue, de fonctionnalité, vos corrections et ajouter de nouvelles traductions.

• Documentation pour les développeurs

Information pour les développeurs qui veulent modifier Page Forms, ou créer une extension qui fonctionne en tandem avec lui.

• Auteurs et crédits

Les auteurs principaux et autres personnes qui ont contribué au code, ainsi que les crédits aux autres organisations et aux projets logiciels.

• Historique des versions

Un historique des versions de Page Forms, depuis mai 2007 jusqu'à aujourd'hui.

• Sites utilisant Page Forms

Un petit échantillon des wikis qui utilisent Page Forms, avec des liens vers des listes plus étendues.

• Autres extensions liées

Extensions qui ont besoin de Page Forms, extensions qui peuvent être utilisées ensemble avec Page Forms, et extensions similaires à Page Forms.

Antisèche
Liens	guide de référence Semantic Mediawiki · mémorandum Cargo · Bac à sable
Fonctions de l'analyseur syntaxique	{{#arraymap :value|delimiter|var|formula|new_delimiter|conjunction}} {{#arraymaptemplate :value|template|delimiter|new_delimiter}} {{#forminput :form=|size=|default value=|button text=|query string=|autocomplete on category=|autocomplete on namespace=|placeholder=|popup|no autofocus|namespace selector|query string parameters}} {{#formlink :form=|link text=|link type=|query string=|target=|tooltip=|popup|new window|query string parameters}} {{#formredlink :form=|link text=|existing page link text=|query string=|target=|popup|new window|create page|query string parameters}} {{#queryformlink :form=|link text=|link type=|query string=|tooltip=|popup|new window|query string parameters}} {{#template_params :}} {{#template_display :_format=|_title=}} {{#autoedit :form=|target=|link text=|link type=|minor|query string=|reload|tooltip=|redirect|bring to page=|summary=|confirm|query string parameters}} {{#autoedit_rating :form=|target=|value=|star width=|num stars=|allow half stars=|minor|reload|tooltip=|summary=|confirm|query string parameters}} {{#default_form :form name}}
Types d'entrée	text , textarea , tokens , combobox , date , datetime , year , datepicker , datetimepicker , checkbox , dropdown , radiobutton , checkboxes , listbox , tree , rating , regexp , googlemaps , leaflet , openlayers