Définition des étiquettes de charte (tags.xml)

Le fichier tags.xml se trouvant dans le dossier cms/skins/[skinName]/conf permet de définir les étiquettes de charte.

Pour plus d'information concernant l'utilisation de ces étiquettes, consulter la page Étiquettes de chartes

Les étiquettes définies dans ce fichier apparaissent sous la catégorie Charte graphique du panneau étiquettes du CMS.

La structure de base du fichier tags.xml est :

tags.xml

<?xml version="1.0" encoding="UTF-8"?>
<tags>
	<!-- Liste des étiquettes de charte -->
</tags>

Étiquettes

Chaque étiquette est définie par :

  • un identifiant unique,
  • un libellé (internationalisé),
  • une description (internationalisée),
  • une portée (attribut target): "PAGE" pour une étiquette de page ou "CONTENT" pour une étiquette de contenu
  • une visibilité: l'attribut private permet de privatiser l'étiquette. Les étiquettes privées ne peuvent être affectées que par des "super" utilisateurs ayant le droit adéquat

Chaque étiquette peut contenir des sous-étiquettes afin de les hiérarchiser.

Exemple de fichier tags.xml

<?xml version="1.0" encoding="UTF-8"?>
<tags>
    <tag id="SPECIAL_PAGES" target="PAGE">
        <label i18n="true">SKIN_BO_TAG_SPECIALPAGES_LABEL</label>
        <description i18n="true">SKIN_BO_TAG_SPECIALPAGES_DESCRIPTION</description>
        
        <tag id="FOOTER_LINKS" target="PAGE">
            <label i18n="true">SKIN_BO_TAG_SPECIALPAGES_TAG_FOOTERLINK_LABEL</label>
            <description i18n="true">SKIN_BO_TAG_SPECIALPAGES_TAG_FOOTERLINK_DESCRIPTION</description>
        </tag>
        <tag id="INVISIBLE" target="PAGE" private="true">
            <label i18n="true">SKIN_BO_TAG_SPECIALPAGES_TAG_HIDDEN_LABEL</label>
            <description i18n="true">SKIN_BO_TAG_SPECIALPAGES_TAG_HIDDEN_DESCRIPTION</description>
        </tag>                        
        <tag id="SEARCH" target="PAGE" private="true">
            <label i18n="true">SKIN_BO_TAG_SPECIALPAGES_TAG_SEARCH_LABEL</label>
            <description i18n="true">SKIN_BO_TAG_SPECIALPAGES_TAG_SEARCH_DESCRIPTION</description>
        </tag>
        <tag id="NEWSLETTER_MAIN" target="PAGE" private="true">
            <label i18n="true">SKIN_BO_TAG_SPECIALPAGES_TAG_NEWSLETTER_MAIN_LABEL</label>
            <description i18n="true">SKIN_BO_TAG_SPECIALPAGES_TAG_NEWSLETTER_MAIN_DESCRIPTION</description>
        </tag>
        <tag id="DIRECTACCESS" target="PAGE" private="true">
            <label i18n="true">SKIN_BO_TAG_SPECIALPAGES_TAG_DIRECTACCESS_LABEL</label>
            <description i18n="true">SKIN_BO_TAG_SPECIALPAGES_TAG_DIRECTACCESS_DESCRIPTION</description>
        </tag>
    </tag>
    <tag id="SECTION" target="PAGE">
        <label i18n="true">SKIN_BO_TAGS_TAG_MAINSECTION_LABEL</label>
        <description i18n="true">SKIN_BO_TAGS_TAG_MAINSECTION_DESCRIPTION</description>
    </tag>
    <tag id="SUBSECTION" target="PAGE">
        <label i18n="true">SKIN_BO_TAGS_TAG_SUBSECTION_LABEL</label>
        <description i18n="true">SKIN_BO_TAGS_TAG_SUBSECTION_DESCRIPTION</description>
    </tag>    
</tags>

L'exemple ci-dessus définit 8 étiquettes de charte graphique. Toutes les étiquettes définies sont des étiquettes de page.
L'étiquette "Pages spéciales" est une "super" étiquette possédant 5 sous-étiquettes (Page cachée, Page de recherche, ...)

Cette définition utilise l'internationalisation. Pour plus d'information, consulter la page Internationalisation (i18n).