Manuel de paramétrage et d'intégration

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 :

 

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 :

  • plugins : contient les plugins par défaut du projet ainsi que ceux qui sont redéfinis
  • skins : contient le ou les gabarits de site, c'est-à-dire les chartes graphiques. Ce répertoire est uniquement présent dans le cas d'un projet Web.
  • WEB-INF : contient le paramétrage de l'application
    • config : contient les fichiers de configuration de l'application
    • data : contient éventuellement les données du site. Dans l'application téléchargée on y trouve la base de contenus (repository), la base de donnée derby (db) et les fichiers indexation (index)
    • i18n : contient les fichiers d'internationalisation de l'application
    • lib : contient les librairies nécessaires à l'application (.jar)
    • logs : contient les fichiers de logs de l'application
    • param : contient les fichiers de paramétrage de l'application
    • scripts : contient un répertoire par type de base de données (Oracle, MySQL, Derby, PostgreSQL), contenant chacun les scripts de création et/ou de mise à jour des tables SQL nécessaire à l'application

Le répertoire site contient les fichiers de l'application site. Il est constitué des répertoires suivants (relativement proches de ceux du CMS) :

  • plugins : contient les plugins par défaut du projet ainsi que ceux qui sont redéfinis 
  • WEB-INF : contient le paramétrage de l'application
    • config : contient les fichiers de configuration de l'application
    • data : contient les données de l'application, notamment le cache des pages statiques
    • i18n : contient les fichiers d'internationalisation de l'application
    • lib : contient les librairies nécessaires à l'application (.jar)
    • logs : contient les fichiers de logs de l'application
    • param : contient les fichiers de paramétrage de l'application