Préambule
Afin d'utiliser le CMS Ametys au plus près de vos besoins et de profiter de toutes ses fonctionnalités, vous devez le personnaliser en fonction de votre environnement graphique, fonctionnel et technique.
Concrètement cela signifie :
- sélectionner et installer les modules complémentaires (plugins) ;
- paramétrer l'application et les plugins ;
- appliquer votre charte graphique à tous les éléments affichés.
Il est conseillé avant toute chose de lire le manuel utilisateur et de parcourir l'application pour se familiariser avec les fonctionnalités qu'elle propose.
Avant de commencer la personnalisation d'Ametys, il est recommandé de connaître son architecture logicielle. Ametys étant un logiciel modulaire, chaque application peut utiliser, outre le socle logiciel, un certain nombre de modules (dans le vocabulaire Ametys, ils sont appelés "plugins"), qui sont eux-mêmes pour la plupart paramétrables.
Pour paramétrer et personnaliser (notamment graphiquement) ces plugins, il faut se référer à leurs documentations. Pour tous les plugins fournis en standard par Ametys, elles se trouvent dans l'espace de documentation des plugins.
Ce manuel couvre uniquement le socle Ametys, sans les plugins supplémentaires.
Prérequis techniques
Ce manuel de paramétrage et d'intégration couvre toute la personnalisation d'Ametys ne nécessitant pas de compétences de développement. Il ne s'agit donc pas d'ajouter de nouvelles fonctionnalités, mais d'agir sur les nombreuses possibilités de personnalisation offertes par les fonctionnalités existantes.
Les compétences mises en œuvres sont la modification de fichiers XML (pour le paramétrage) et les feuilles de style XSLT (pour l'intégration graphique). Des connaissances XHTML/CSS sont évidemment nécessaires pour le rendu, mais Ametys n'apporte aucune restriction de ce côté là.
Création du projet
La 1ère étape d'intégration du CMS Ametys consiste à créer votre projet.
Pour une prise en main rapide, téléchargez l'exécutable de l'application de démonstration en version Windows (.exe) ou en version Linux (.sh), ou encore en version Java. Cette version contient de nombreux plugins, deux chartes graphiques ("demo" et "blog") ainsi que des contenus d'exemples.
Version windows
Installez l'application en double-cliquant sur le fichier téléchargé ; par défaut l'installation s'effectue dans le répertoire C:/Ametys.
Vous travaillerez alors dans les répertoires C:/Ametys/webapp/cms pour l'application back-office et C:/Ametys/webapp/site pour l'application front-office.
Version linux
Exécuter le fichier .sh téléchargé.
#chmod u+x ametys-3.X.X.sh #./ametys-3.X.X.sh
Pour aller plus loin
Pour les plus avertis qui souhaitent utiliser leur propre serveur d'applications, vous pouvez récupérer le zip de l'application de déploiement.
Il faut ensuite le dézipper sur votre serveur ; il contient 2 répertoires : cms et site. De nombreux plugins sont déjà compris dans cette version, ainsi que deux skins ("demo" et "blog").
Pour continuer, suivez le manuel d'installation (il est conseillé de le lire entièrement avant de s'y atteler afin de valider les prérequis par exemple). Dans le cadre de l'intégration, la mise en place d'Apache n'est pas nécessaire.
Organisation du projet
Un projet Ametys s'organise de la manière suivante :
 |
Le répertoire cms contient les fichiers de l'application CMS, c'est-à-dire l'application utilisée par les contributeurs. Il est constitué des répertoires suivants :
|
|
Le répertoire site contient les fichiers de l'application site. Il est constitué des répertoires suivants (relativement proches de ceux du CMS) :
|
Retour en haut