Personnalisation avec CSS

De FphAdmin.

La façon la plus simple de personnaliser l'interface de Sympa est de modifier la feuille de style CSS. Ce travail peut être fait sur un autre serveur que celui de Sympa et cela dispense donc de devoir donner l'accès au serveur Oware à des intervenants extérieurs.

Par défaut, les feuilles de style utilisées par Sympa sont générées automatiquement. Sympa offre la possibilité de pointer vers des feuilles de style statique. Sympa le conseille d'ailleurs pour des raisons de performance, il n'a pas ainsi à recalculer le CSS à chaque appel de passage.

La configuration se fait avec deux paramètres : css_path et css_url : css_path définit le chemin réel du répertoire dans lequel se trouvent les fichiers CSS et 'css_url le lien pour y accéder via le web. Pour des raisons obscures, css_url ne peut pas être utilisé seul (pour pointer sur une feuille de style hébergé sur un autre serveur notamment). Nous allons faire appel à une série de manipulations pour parvenir à nos fins.


1) dans /home/fphfph/sympa (cela aurait pu être n'importe où ailleurs), créer un répertoire avec le nom de domaine. Exemple :

/home/fphfph/sympa/forums.desmodo.net

Ce répertoire doit être accessible en écriture à Sympa.


2) dans le fichier robot.conf de configuration du nom de domaine, rajouter les lignes suivantes :

css_path /home/fphfph/sympa/forums.desmodo.net
css_url http://www.desmodo.net/sympa

La valeur css_url peut être n'importe laquelle URL pointant vers un répertoire dans lequel sont stockés les quatre fichiers CSS de Sympa.


3) Relancer Sympa


4) Avec les droits d'un listmaster, aller dans « Admin Sympa » -> « Administration des skins ». Si tout s'est bien passé, il devrait apparaitre le texte suivant vers la fin de la page :

Le paramètre css_path est défini, sa valeur est /home/fphfph/sympa/forums.desmodo.net
le paramétrage actuel pour les CSS (paramètre css_url) est http://www.desmodo.net/sympa


5) Cliquer alors sur « Installer la feuille de style statique ». Cette action va générer les quatre fichiers CSS dans le répertoire css_path. Ces quatre fichiers (en fait, seul style.css est intéressant, les autres sont vides) peuvent alors être placés dans le répertoire vers lequel pointe css_url. La feuille de style style.css peut ainsi être travaillée sans avoir accès au serveur Sympa.


Note : Sympa propose également le paramètre logo_html_definition qui permet d'indiquer du code HTML à insérer au début de la page. Ce paramètre présente le défaut d'être enregistré dans le fichier robot.conf et donc il ne peut être modifié que par les administrateurs. La directive CSS background-image permet de résoudre la question de l'insertion du logo (même si bien sûr le logo n'est pas cliquable).