Présentation

Non du plugin:

formulaire

Objet du plugin:

Le plugin a 2 objectifs :

1. un principal : la génération de formulaires qui seront ensuite insérés dans des pages du site au travers de fonctions.  Sans ce plugin, modifier un écran de saisie d'information oblige de modifier le script php. L'objectif est d'avoir un script fixe qui appelle le formulaire qui pourra être modifié séparément par simple paramétrage. Les formulaires générés peuvent servir pour d'autres plugins ou pour des pages autonomes (des exemples de page autonome sont fournis).
2. un secondaire : la gestion de fiches basées sur des formulaires précédemment définis. Exemples d'utilisation: liste des membres d'une association, inventaire des biens.

Description sommaire

Chaque formulaire est identifié par un numéro (créé automatiquement en séquence) et par un nom (dans les 2 langues). Les caractéristiques du formulaires et la description des champs sont contenues dans 2 fichiers différents du répertoire /data/plugins/formulaire.

L'utilisation du formulaire dans une page se fait par l'intermédiaire de fonctions spécifiques au plugin:

• RecupForm: crée une table avec les noms de champs du formulaire et sa valeur saisie par l'internaute
• DebutForm: initialise le formulaire affiché
• AfficheForm: crée les différents champs sur l'écran en fonction des paramètres enregistrés et des valeurs passées en paramètre.
• FinForm: termine le formulaire affiché

La gestion de fiches permet de lister un "index" de toutes les fiches présentes. L'index est construit sur la base de 3 champs choisis par l'administrateur. L'internaute peut trier l'index sur ces champs, peut appliquer des filtres, peut effectuer une recherche. L'affichage est subordonné à des "droits" gérés par l'administrateur"; voir l'article spécifique à la gestion des droits.

Pour la petite histoire

Au départ, je ne voulais faire que les fonctions d'utilisation des formulaires et fournir dans le répertoire pages/ un ou deux exemples simples d'utilisation. Je me suis vite rendu compte que les exemples simples n'étaient pas suffisants, et c'est ainsi que j'ai développé l'objectif secondaire qui, en terme de développement, est le plus lourd et finalement est devenu l'objectif principal.