Surcharge des couleurs

Le CMS Ametys propose différentes fonctionnalités utilisant une palette de couleurs. Toutes ces palettes sont surchargeables par projet et pour certaines par charte graphique.

1. Format XML d'une palette de couleurs:
2. Surcharge de la palette de couleurs
3. Différentes utilisations des palettes
   1. Etiquettes du CMS
   2. Catégorie d'un projet
   3. Configuration du site
   4. Annuaire de lien
   5. Etiquettes d'un projet
   6. Section du module tâche

Format XML d'une palette de couleurs:

Toutes les palettes de couleurs sont sous le format XML suivant :     

<colors default="4" css-class="sitescolors">
    <color id="1">
        <main>#FF66FF</main>
        <text>#FFFFFF</text>
    </color>
    <color id="2">
        <main>#CC33CC</main>
        <text>#FFFFFF</text>
    </color>
  ...
    <color id="28">
        <main>#000000</main>
        <text>#FFFFFF</text>
    </color>
</colors>

<colors default="4" css-class="sitescolors">
    <color id="1">
        <main>#FF66FF</main>
        <text>#FFFFFF</text>
    </color>
    <color id="2">
        <main>#CC33CC</main>
        <text>#FFFFFF</text>
    </color>
  ...
    <color id="28">
        <main>#000000</main>
        <text>#FFFFFF</text>
    </color>
</colors>

<colors default="4" css-class="sitescolors">
    <color id="1">
        <main>#FF66FF</main>
        <text>#FFFFFF</text>
    </color>
    <color id="2">
        <main>#CC33CC</main>
        <text>#FFFFFF</text>
    </color>
  ...
    <color id="28">
        <main>#000000</main>
        <text>#FFFFFF</text>
    </color>
</colors>

• Balise colors: La balise racine
  • Attribut default: La couleur par défaut qui sera proposée dans la palette
  • Attribut css-class: La classe CSS utilisée pour effectuer le rendu de la couleur dans l'outil représentant la palette. Il est donc utilisé avec un fichier xsl qui génère une CSS avec la liste des couleurs de la palette. (Souvent à ignorer côté intégration graphique)
  • Balise color: Il faut ajouter une balise color pour chaque couleur que vous voulez dans la palette
    • Attribut id: Il correspond à l'identifiant unique de la couleur. C'est lui qui est stocké la plupart du temps et permet d'avoir les informations associées à la couleur. 
    • Balise main: Le code héxadécimal de la couleur principale
    • Balise text: Le code héxadécimal de la couleur du texte

Surcharge de la palette de couleurs

Par défaut Ametys propose une palette de couleurs. Mais elles sont toutes surchargeables.

• Surcharge par projet
  • Trouver le nom du fichier XML associé à la palette qu'on veut surcharger (nomDuFichier.xml)
  • Redéfinir ce fichier XML dans {AmetysHome}/WEB-INF/param/nomDuFichier.xml
• Surcharge par charte graphique (toutes les palettes ne sont pas surchargeables par charte graphique)
  • Trouver le nom du fichier XML associé à la palette qu'on veut surcharger (nomDuFichier.xml)
  • Redéfinir ce fichier XML dans {skin}/conf/nomDuFichier.xml

Différentes utilisations des palettes

Pour les étiquettes, il est possible de récupérer la couleur à partir d'étiquettes via un helper XSL tagColor.

Etiquettes du CMS

• Nom du fichier à surcharger: tag-colors.xml
• Surcharge côté skin: non

Catégorie d'un projet

• Nom du fichier à surcharger: project-category-colors.xml
• Surcharge côté skin: non

Configuration du site

• Nom du fichier à surcharger: site-colors.xml
• Surcharge côté skin: non

Annuaire de lien

• Nom du fichier à surcharger: linkdirectory-colors.xml
• Surcharge côté skin: oui

Etiquettes d'un projet

• Nom du fichier à surcharger: project-tags-colors.xml
• Surcharge côté skin: oui

Section du module tâche

• Nom du fichier à surcharger: tasks-list-colors.xml
• Surcharge côté skin: oui