Objectifs
Dans les précédents tutoriels, nous avons directement modifié les éléments du module default.
Ce module default correspond au module exécuté par défaut lorsqu'aucune information n'est indiquée à Copix.
Il est temps pour vous d'être initié à la création de module, modules qui vous permettront de distribuer vos applications sur les plateformes réalisées avec Copix.
Choisir un emplacement
Par défaut, Copix est livré pré-configuré avec deux emplacements de modules par défaut (une sorte de include_path). Ces emplacements sont project/modules/public/stable/standard et project/modules/publis/devel/webtools.
Lorsque vous parcourez la page d'administration dans la section "ajouter / supprimer des modules", c'est ce que Copix vous rappelle en bas de page.
Vous pouvez créer votre module dans l'un de ces emplacements ou ajouter votre propre emplacement de module.
Etape 1 - Création du répertoire
Pour ce tutoriel, créons notre module dans project/module/public/devel/webtools/monmodule.
Créer le répertoire n'est pas suffisant pour qu'il soit considéré comme un module, il va falloir également créer un fichier module.xml.
Etape 2 - Création du fichier module.xml
Créez le fichier project/module/public/devel/webtools/monmodule/module.xml avec le contenu suivant :
<?xml version="1.0" encoding="UTF-8"?>
<moduledefinition>
<general>
<default name="monmodule" description="Mon premier module"
longdescription="Mon premier module de test pour jouer avec Copix" />
</general>
</moduledefinition>
A partir de maintenant, ça y est, votre module va apparaitre dans la liste des modules dans l'interface d'ajout/suppression de modules !
Après l'avoir installé, vous ne devriez maintenant pas avoir de mal à reproduire les étapes du tutoriel Hello You ! pour réaliser votre première page dans votre module.
Plus loin avec les modules
Plus tard, vous verrez que Copix est capable de gérer les dépendances entre les modules, que vos modules peuvent être multilingues, vous verrez également qu'il est possible de rendre vos modules paramétrables, qu'il est possible lors de leur installation / suppression de lancer un ensemble de scripts SQL, ...