3.5.4.2 Ajouter du code HTML personnalisé

Une bonne pratique, si vous envisagez de diffuser votre thème est de permettre aux utilisateurs finaux de personnaliser l'entête ou le pied de page avec du code HTML.

Nous allons voir ici comment inclure du contenu HTML dans le pied de page, mais ce qui va suivre fonctionne évidemment aussi dans l'entête.

Dans l'exemple ci-dessous, ce sont les lignes 5, 6 et 7 qui nous intéressent :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

        <footer>
            .:GetBlogMetadataIfExists::loading_image::
                <img id="__VENC_LOADING__" src=".:GetRelativeRoot:./{value}" />
            :.
            .:IncludeFileIfExists::
                .:GetBlogMetadataIfNotNull::include_in_footer:.        
            :.
        </footer>
    </body>
</html>

IncludeFileIfExists permet d'inclure un fichier du type de votre choix. Généralement, il s'agira d'un fichier contenant du code HTML.

Ici le seul argument de la fonction est retourné par GetBlogMetadataIfNotNull, qui permet de récupérer le nom du fichier à inclure s'il est défini dans le fichier de configuration du blog.

Dans le cas où le nom de fichier n'est pas défini, la fonction renvoie une chaîne de caractères vide transférée à IncludeFileIfExists, qui sera ignorée en conséquence.