Formulaire sémantique

Semantic forms Médiawiki

Installation

Dans un premier temps, vous pouvez installer le formulaire suivant https://www.mediawiki.org/wiki/Special:ExtensionDistributor/SemanticForms. Si vous êtes à l'aise avec l'anglais et l'installation de module suivez ces instruction https://www.mediawiki.org/wiki/Extension:Semantic_Forms/Download_and_installation sinon vous pouvez suivre les quelques instructions ci-dessous. La logique d'installation est la la même pour les autres extensions.

Installation :

1. Télécharger le dossier et décompressez-le

2. Insérer le dossier dans la partie extension (de votre dossier médiawiki), changez le nom du dossier en "SemanticForms"

3. Ajouter la ligne suivante dans votre fichier LocalSettings.php (en fin de fichier)

include_once "$IP/extensions/SemanticForms/SemanticForms.php";

4. Accéder au dossier maintenance ( cd maintenance) à travers la ligne de commande (vous pouvez utiliser putty) et lancer la commande suivante

php update.php

Création d'un modèle

Pour créer un nouveau modèle, il faut rechercher le page que l'on veut créer avec la barre de recherche du wiki. Le nom doit être de la forme suivante

"Modèle:Nom_du_modèle"

ou

"Template:Nom_du_modèle"

(template est le nom anglais pour modèle)

Lorsque vous arrivez sur la nouvelle page, vous pouvez la modifier et commencer à entrer votre code.

En créant et en utilisant un modèle, vous pourrez créer une forme fixe qui pourra être utilisée dans d'autres pages. Vous pouvez également insérer des champs qui pourront être demandés dans des formulaires (présentés ci-dessous).

Pour indiquer un champ, il suffit de noter le nom du champ entre {{{ }}}. Ce nom est à retenir car c'est celui qui sera utilisé dans le formulaire.

Exemple:

* {{{date}}} 

donnera

• {{{date}}} dans le modèle final.

Afficher l'onglet "modifier avec formulaire"

Afficher l'onglet sur une simple page

Pour afficher l'onglet "Modifier avec formulaire", il suffit de rajouter la ligne:

{{#default_form:Nom_du_formulaire}}

Il faut remplacer "Nom_du_formulaire" par le nom du formulaire que vous voulez utiliser avec la page en question.

Afficher l'onglet sur toutes les pages d'une catégorie

Pour que toutes les pages d'une même catégorie soient modifiables avec le même formulaire, il faut rajouter la ligne suivante dans la page de la catégorie:

{{#default_form:Nom_du_formulaire}}

Lorsque vous enregistrez la page de catégorie, vous devriez voir un message du genre "Cette catégorie utilise le formulaire « Nom_du_formulaire »"

Création d'un formulaire

Pour créer un nouveau formulaire, il faut rechercher le page que l'on veut créer avec la barre de recherche du wiki. Le nom doit être de la forme suivante :

"Formulaire:Nom_du_formulaire"

ou

"Form:Nom_du_formulaire"

(Form est le nom anglais pour fomulaire)

Lorsque vous arrivez sur la nouvelle page, vous pouvez la modifier et commencer à entrer votre code.

Exemple

Voici un exemple complet pour demander des informations générales:

 {{{info|add title=Créer/Modifier les informations générales |edit title=Créer/Modifier les informations générales}}}
{{{for template|InfosGénérales}}}
{| class="formtable"
! Date d'entrée dans l'UAT:
| {{{field|dateentree|input type=datepicker}}}
|-
! Date de naissance:
| {{{field|datenaissance|input type=datepicker}}}
|-
! Syndrome:
| {{{field|syndrome|input type=free text}}}
|}
{{{end template}}}

Plus précisément

* {{{info|add title=Créer/Modifier le formulaire |edit title=Créer/Modifier le formulaire}}} 

Permet de définir le titre de la page formulaire.

{{{for template|Nom_du_modèle}}}

Permet de faire appel au modèle (template) créé auparavant.

{| class="formtable"

Permet d'ouvrir un tableau.

! la_demande:
| {{{field|nom_définit_dans_le_modèle|input type=mettre_le_type_d'input}}}
|-

On définit ce qui va directement apparaitre dans le formulaire (la_demande:). puis on va rechercher le nom préalablement définit dans le modèle sélectionné. Enfin on définit le type d'input.

Les différents types d'input

• datepicker = permet de générer un petit calendrier permettant à l'utilisateur de choisir la date
• textearea = définit une zone de texte

Résultats

Une fois les modifications enregistrées, visuellement, sur la page du formulaire, cela donnera :

InfosGénérales Date d'entrée dans l'UAT: dateentree Date de naissance: datenaissance Syndrome: syndrome {{{end template}}}

Sur la page "modifier avec formulaire", cela donnera: