Define template assignment rules

The template_assignment.xml file in the cms/skins/[skinName]/conf folder is used to condition the use of templates by the contributor.

Defining conditions

Template assignment rules can be defined. For example, a template created specifically for the home page can only be assigned to a page whoseURL is /index.html. This is described in the example below.

template_assignment.xml

<?xml version="1.0" encoding="UTF-8" ?>
<templates>
    <list mode="exclude">
        <template name="login" />
    </list>
    <conditions>
        <condition template="index">
            <page regexp_path="index" />
        </condition>
        <condition template="*">
            <page reverse_regexp_path="index" />
        </condition>
    </conditions>
</templates>

<?xml version="1.0" encoding="UTF-8" ?>
<templates>
    <list mode="exclude">
        <template name="login" />
    </list>
    <conditions>
        <condition template="index">
            <page regexp_path="index" />
        </condition>
        <condition template="*">
            <page reverse_regexp_path="index" />
        </condition>
    </conditions>
</templates>

<?xml version="1.0" encoding="UTF-8" ?>
<templates>
    <list mode="exclude">
        <template name="login" />
    </list>
    <conditions>
        <condition template="index">
            <page regexp_path="index" />
        </condition>
        <condition template="*">
            <page reverse_regexp_path="index" />
        </condition>
    </conditions>
</templates>

Restrict the list of available templates

Dans la balise <list> l'attribut "exclude" permet d'exclure les gabarits cités dans cette balise, de la liste des gabarits mis à disposition du contributeur. Dans cet exemple, le gabarit Login n'apparait pas dans la liste des gabarits proposés au contributeur. Néanmoins, le gabarit login existe, il est utilisé par le CMS pour afficher une page d'authentification. Si ce gabarit n'existe pas, c'est automatiquement le gabarit page qui est utilisé. Généralement, les gabarits non utilisables par le contributeur sont utilisés par des plugins.