Diverses conventions doivent etre respectées pour un bon fonctionnement du AlternC WebInstaller
L'archive à intégrer doit etre soit au format tar.bz2, soit au format tar.gz. De plus, son nom doit etre structuré comme suit : nomappli-vversion.tar{bz2|gz}
Le fichier de configuration de l'application doit avoir un nom semblable a l'archive : nomappli-vversion.xml
Ce fichier doit comporter divers elements comme suit :
<name> : nom du programme,aucun paramètre, unique
<categorie lang="langue"> : catégorie à laquelle appartient le programme, peut prendre la langue en paramètre, au format type fr_FR, us_US, us_EN, ..., possibilité d'en avoir plusieurs
<version> : numero de la version du programme, ne contient aucun espace, doit permettre de retrouver l'ordre des versions, unique
<url> : url du site du programme, unique
<desc_courte lang="langue"> : courte description du programme, prend la langue en paramètre (non nécessaire), possibilité d'en définir plusieurs
<desc lang="langue"> : description longue du programme, prend la langue en paramètre (non nécessaire), possibilité d'en avoir plusieurs
<archive lang="fr"> : archive du programme, il peut y avoir une archive par langue (paramètre lang exprimé) ou non, possibilité d'en avoir plusieurs
<file_install> <file_suppr> <file_maj> : fichiers réalisant l'installation, la suppression, la mise à jour de l'application, ces fichiers sont créé par l'"admin" qui s'occupe d'intégrer un nouvel applicatif, ces fichiers sont uniques, il n'y a pas de dinstinction selon la langue (car prise en compte avec _() ), ils contiennent des appels aux fonctions de la classe m_webinstaller
Voici un exemple de fichier de configuration (wikini) :
<webinstaller>
<description>
<name> </name>
<categorie lang="langue"> </categorie>
<version> </version>
<url> </url>
<desc_courte lang="langue"> </desc_courte>
<desc lang="langue"> </desc>
<archive lang="langue"> </archive>
</description>
<install>
<file_install> </file_install>
</install>
<suppr>
<file_suppr> </file_suppr>
</suppr>
<maj>
<file_maj> </file_maj>
</maj>
</webinstaller>
Divers fichiers doivent être ajoutés à l'archive de l'application pour pouvoir être installable :
nomappli-vversion.xml : fichier de configuration de l'application
fichiers d'installation, de suppression, ...
Ces fichiers sont créés lors de l'ajout d'une nouvelle application. Ils contiennent l'ensemble du déroullement des actions sous plusieurs formes :
actions directement codées en php (modification des droits par exemple)
appels à des fonctions de la classe websintaller (par exemple paramètrage MySQL?) (pour des actions systématiques ou pour des actions pour lesquelles l'utilisateur n'en a pas les droits)
formulaire de saisie des paramètres par l'utilisateur (si possible avec style AlternC)
appel à des fonctions de l'applicatif, reprise des fonction des fichiers initiaux
Rq : les fichiers sont des fichiers écrit en php, utilisant si possible le style d'AlternC, et ne comportant aucun entête, pied de page, ... Ceci permet de les intégrer dans la page réalisant l'acton désirée au sein du WebInstaller. En outre, pour une installation par exemple, la page comportera le choix du répertoire d'installation (page WebInstaller) sous lequel sera inséré le fichier apartenant à l'application. La variable du répertoire par exemple sera ensuite disponible pour ce dit fichier.