Différences
Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.
codeur:module:arborescence [2007/03/17 14:31] tito créée |
codeur:module:arborescence [2008/03/18 09:43] (Version actuelle) jmsixt |
||
---|---|---|---|
Ligne 3: | Ligne 3: | ||
Le but de cette page n'est donc pas de présenter le fonctionnement de tous les répertoires mais bien les règles de normalisation de ceux-ci. | Le but de cette page n'est donc pas de présenter le fonctionnement de tous les répertoires mais bien les règles de normalisation de ceux-ci. | ||
+ | |||
+ | |||
+ | |||
===== Répertoires nécessaires ===== | ===== Répertoires nécessaires ===== | ||
Ligne 9: | Ligne 12: | ||
* Un répertoire **images** : contient les images de données du module. | * Un répertoire **images** : contient les images de données du module. | ||
* Un répertoire **lang** : contient les fichiers nécessaires au multi langue. | * Un répertoire **lang** : contient les fichiers nécessaires au multi langue. | ||
- | * Un répertoire **Install** : contient les sous-répertoires suivant : | + | * Un répertoire **install** : contient les sous-répertoires suivant : |
- | * Un répertoire sql : contenant les fichiers SQL pour le bon fonctionnement du module | + | * Un répertoire **sql** : contient les fichiers SQL pour le bon fonctionnement du module |
- | * Un répertoire doc : contenant la licence.txt, et le fichier d’install.txt (fichier d’explication de l’installation manuel du module) | + | * Un répertoire **doc** : contient la licence.txt, et le fichier d’install.txt (fichier d’explication de l’installation manuel du module) |
- | * Un répertoire meta (futur utilisation(Dune)) : contenant les métas et leurs explications | + | * Un répertoire **meta** : contient les métas et leurs explications. //Ce dossier sera utilisé dans une future version de NPDS// |
- | * Un répertoire theme (futur utilisation(Dune)) : contenant les fichiers html qui iront dans le thème de l’utilisateur, pour utiliser les métas et voila pas plus d’explication pour l’instant. | + | * Un répertoire **theme** : contient les fichiers html qui iront dans le thème de l’utilisateur. //Ce dossier sera utilisé dans une future version de NPDS// |
- | * Un répertoire css (optionnel et en évolution) : contenant la css à fusionner avec celle du thème | + | * Un répertoire **css** : contient la css à fusionner avec celle du thème. //Ce système est en évolution// |
===== Répertoires facultatifs ===== | ===== Répertoires facultatifs ===== | ||
Ligne 20: | Ligne 23: | ||
* Un répertoire **bloc** (optionnel) : contenant les différents blocs du module. | * Un répertoire **bloc** (optionnel) : contenant les différents blocs du module. | ||
* Un répertoire **js** (optionnel) : contenant les fichiers JavaScript. | * Un répertoire **js** (optionnel) : contenant les fichiers JavaScript. | ||
+ | |||
+ | |||
+ | |||
+ | ===== Installation manuelle ===== | ||
+ | Pour permettre une installation manuelle du module, certains fichiers de documentation sont obligatoires! | ||
+ | * extend-modules.txt (détail de la syntaxe du fichier [[Extend-modules]]) localisé dans le sous répertoire install contenant les informations classiques à un appel de l’admin du module via plugin (si nécessaire), placé dans le répertoire doc | ||
+ | * Un fichier de licence en Français et un en Anglais. Ces fichiers sont disponible [[http://modules.npds.org/modules/nmig/licences.zip|ici]]. | ||
+ | * Un fichier reprenant la méthode d'installation. Il est le plus souvent nommé INSTALL.TXT. Voici un exemple de fichier install.txt : | ||
+ | |||
+ | ################################################################################### | ||
+ | ## Nom: Nom de votre application | ||
+ | ## Version: Version | ||
+ | ## Date: Date de publication | ||
+ | ## Auteur: Votre nom ou Pseudo | ||
+ | ## | ||
+ | ## Description: Description rapide de votre application | ||
+ | ## | ||
+ | ################################################################################### | ||
+ | ## INSTALLATION | ||
+ | ## Décrire ici les étapes de l'installation | ||
+ | ## | ||
+ | ## CONFIGURATION | ||
+ | ## Si votre application dispose d'une configuration, indiqué ici la marche à suivre. | ||
+ | ## | ||
+ | ## UTILISATION | ||
+ | ## Appel grace à une URL du type : | ||
+ | ## Pour un module : | ||
+ | ## MON MODULE | ||
+ | ## Pour un Add-On : | ||
+ | ## Mon Add-On | ||
+ | ## | ||
+ | ## ADMINISTRATION DU MODULE | ||
+ | ## Si votre application dispose d'une administration, indiqué comment y accéder. | ||
+ | ## | ||
+ | ################################################################################### | ||
+ | |||
+ | |||
+ | Il faut aussi préciser dans le fichier install.txt les répertoires à supprimer une fois l’installation manuel effectuer (exemple : sql, css, theme, doc, etc.). | ||
===== Index.html ===== | ===== Index.html ===== | ||
- | Il est vivement recommandé de mettre un fichier **index.html** vide dans chaque répertoire et sous-répertoire. Cela permet d'éviter que n'importe qui puisse lister le contenu des répertoires. | + | Il est vivement recommandé de mettre un fichier **index.html** vide dans chaque répertoire et sous-répertoire. Cela permet d'éviter que n'importe qui puisse lister le contenu des répertoires (moins performant qu’un .htaccess mais plus simple à utiliser). |