Catégorie:Modules

De Wiki.

Les différents modules intégrés à Adéquat'WEBSITE permettent de bénéficier avec un minimum de mise en place de fonctionnalités complexe.

Ils sont tous construits selon un modèle de conception MVC (Model-View-Controller) qui permet de reporter la majorité du travail restant à produire sur l'intégration. Ce travail consiste à produire les différentes Vues possibles pour chaque action du module.

Il ne reste plus ensuite qu'à appeler le contrôleur adéquat en lui fournissant la vue désirée et il s'occupe du reste.

Voici les modules actuellement disponibles :


Quelques règles

Concernant la construction et la mise en place de modules conçus selon le modèle MVC dans Adéquat'Website, quelques règles doivent être suivies.

  • L'ensemble des interactions avec la BDD dépend du Modèle. Il peut être complété au besoin de fonctionnalités supplémentaires, mais il est le seul à devoir traiter les données en BDD.
  • Le Contrôleur est le point d'entrée de toute action, que ce soit pour l'affichage d'une vue ou pour le traitement de données soumises au moyen d'un formulaire, ou les deux.
  • Le Contrôleur est aussi le point de contact entre la Vue choisie et le Modèle traitant les données. Il peut à ce titre se voir ajouter des méthodes "passerelles" permettant d'atteindre le Modèle ; en effet, la Vue n'a connaissance que du Contrôleur qui la pilote.
  • La Vue est renseignée à propos du Contrôleur qui la pilote et doit obligatoirement implémenter une méthode render() qui sera lancée par ce Contrôler. Elle doit aussi passer par lui pour tout besoin de données spécifiques allant outre celles qui lui sont transmisses à l'appel de sa méthode render().
  • Le Modèle est unique mais peut être complété ou étendu (préférable) à une autre classe Modèle pour les besoins d'un projet.
  • De même un Contrôleur peut implémenter de nouvelles méthodes ou être étendu (préférable) pour les besoins d'un projet.
  • A AUCUN MOMENT la Vue ne doit effectuer directement un traitement de données.

Structure

Les Modèles et Contrôleurs standard pour chaque module sont disponibles dans un dossier au nom du module sous /include/cms-inc/. Il sont ainsi invariables et partagés par tous les projets. Les Vues, responsables de toute restitution à l'utilisateur, dépendent du projet et sont par convention rangées dans /modules/<nom_du_module>/custom/ et appelées class.render<MaVueSpécifique>.php.

Les Modèles et Contrôleurs étendus spécifiquement pour les besoins d'un projet seront rangés dans /modules/<nom_du_module>/core/.

Le ou les fichiers d'accès/configuration du type process.php ou refresh.php (gestion de session) sont aussi rangées dans /module/<nom_du_module>/core/.

Enfin, les librairies php ou js liées au module sont par convention aussi rangées dans /module/<nom_du_module>/core/.

Mise en place

Plusieurs options de mise en place se présentent :

  • Le module prend place dans une brique CMS invariable.

Sous-catégories

Cette catégorie comprend 4 sous-catégories, dont les 4 ci-dessous.

M

Pages dans la catégorie « Modules »

Cette catégorie contient 11 pages, dont les 11 ci-dessous.

A

C

C (suite)

F

G

M

O

S

W