Marqueurs de template pour Dotclear

Au fil du temps, de mes lectures et de mes besoins, j'ai enrichi le thème (l'apparence) de ce blog d'un certain nombre de fonctions poétiquement baptisées en dotclearien "marqueurs de template".

Pensant que ça pouvait intéresser d'autres utilisateurs de cet excellent moteur de blog qu'est Dotclear, j'avais déjà proposé certains de ces marqueurs de manière à pouvoir être insérés individuellement dans le fichier _public d'un thème. Mais ce morcellement me semble être, à présent, plus une contrainte qu'un avantage.

Je préfère donc vous proposer l'ensemble de mes marqueurs en un seul fichier au format zip. Libre à vous de piocher dedans en ne prenant que ce qui vous intéresse.

Version actuellement proposée au téléchargement (voir annexe) : la v1.0.0  (20/03/2016)

Préambule

Il est conseillé de lire ou relire ce billet avant de commencer.

Si vous n'avez pas de fichier _public.php dans le thème de votre blog, le fichier proposé en annexe peut être directement ajouté après avoir été dé-zippé. Bien entendu, les manipulations nécessaires pour un ajout (complet ou partiel) demande des connaissances techniques et quelques précautions... dont celle de sauvegarder l'existant avant d'intervenir.

Behaviors

  • altTagTpl
    permet l'utilisation d'un fichier de contexte différent de tag.html.
    Le nom du fichier devra être de la forme tag-xxx.html où xxx sera le mot-clé en minuscules, sans espaces, ni caractères accentués.
    Si ce fichier n'existe pas, alors c'est le contexte standard qui sera utilisé
  • altCategoryTpl
    permet l'utilisation d'un fichier de contexte différent de category.html.
    Le nom du fichier devra être...
    - de la forme category-xxx.html (xxx = ID de la catégorie)
    - de la forme category-zzz.html (zzz = nom de la catégorie en minuscules, sans espaces, ni caractères accentués).
    Si category-xxx.html n'existe pas, alors recherche de la présence de category-zzz.html.
    Si aucun de ces 2 fichiers n'existe, alors le contexte standard sera utilisé.

Marqueurs

  • Add_CSS
    {{tpl:Add_CSS file="xxx.xx" type="zzz" blog="x"}} insère un appel au fichier CSS "xxx.xx" si ce fichier existe dans le thème parent puis insère un appel au fichier CSS "xxx.xx" si ce fichier existe dans le thème actif.
    "zzz" (facultatif) précise le type de media (par défaut = screen)
    "x" précise s'il faut prendre en compte (x=1) ou pas (x=0 ou absent) les thèmes 'xxx_zzz' puis 'yyy_zzz' (xxx = thème parent, yyy = thème actif) propres au blog (zzz = ID du blog).

  • Add_JS
    {{tpl:Add_JS file="xxx.xx"}} insère un appel au fichier JS "xxx.xx" si ce fichier existe dans le thème actif, sinon insère un appel au fichier JS "xxx.xx" si ce fichier existe dans le thème parent.

  • CategoryID
    {{tpl:CategoryID}} renvoie l'ID d'une catégorie, même en dehors d'une boucle <tpl:Entries>, ce que ne fait pas {{tpl:EntryCategoryID}}.

  • EntryIfNotFirst
    si l'entrée n'est pas la première dans une boucle <tpl:Entries>, {{tpl:EntryIfNotFirst return="zzz"}} renvoie 'zzz'.
    par défaut  zzz = 'next'.

  • EntryIfNotOdd
    si l'entrée est de rang pair dans une boucle <tpl:Entries>, {{tpl:EntryIfNotOdd return="zzz"}} renvoie 'zzz'.
    par défaut zzz = 'even'.

  • EntryNotes
    {{tpl:EntryNotes}} affiche le contenu du champ "post_notes".

  • IfAllowComments
    Si les commentaires sont autorisés (is absent ou is="1") ou non (is="0") pour tout le blog (global absent ou global="1"), <tpl:IfAllowComments is="x" global="x">  affiche ce qui est placé entre <tpl:IfAllowComments> et </tpl:IfAllowComments>.
    Si global="0" (à n'utiliser que dans post.html et page.html) alors n'affiche ce qui est placé entre <tpl:IfAllowComments> et </tpl:IfAllowComments> que si les commentaires ne sont pas fermés individuellement pour un billet/page.

  • IfBlogDesc
    Si le blog a une description, affiche ce qui est placé entre <tpl:IfBlogDesc> et </tpl:IfBlogDesc>

  • IfCategoryDesc
    Si la catégorie a une description, affiche ce qui est placé entre <tpl:IfCategoryDesc> et </tpl:IfCategoryDesc>

  • IfCommentsWikibar
    Si le plugin commentsWikibar est installé et activé, affiche ce qui est placé entre <tpl:IfCommentsWikibar> et </tpl:IfCommentsWikibar>

  • IfEntryNotes
    <tpl:IfEntryNotes is="x"> teste la présence dans le champ "post_notes" de données dont le premier caractère est "<" (is absent ou is="1") ou pas (is="0").
    Exemples d'utilisation :
    - afficher "OUI" si test ok : <tpl:IfEntryNotes is="1"><p>OUI</p></tpl:IfEntryNotes>
    - afficher "NON" si test ko : <tpl:IfEntryNotes is="0"><p>NON</p></tpl:IfEntryNotes>

  • IfFormatImage
    <tpl:IfFormatImage is="x" size="z"> teste la présence (is absent ou is="1") d'une valeur de taille d'image (size) > 0 dans les paramètres du blog ou son absence (is="0") et affiche ce qui est placé entre <tpl:IfFormatImage> et </tpl:IfFormatImage>.
    size="t" correspond au format thumbnail (miniature)
    size="s" correspond au format small (petite)
    size="m" correspond au format medium (moyenne)

  • IfModeration
    <tpl:IfModeration is="x"> teste si les commentaires sont modérés (is absent ou is="1") ou non (is="0").
    Exemples d'utilisation :
    - afficher "OUI" si modération des commentaires : <tpl:IfModeration is="1"><p>OUI</p></tpl:IfModeration>
    - afficher "NON" si pas de modération des commentaires : <tpl:IfModeration is="0"><p>NON</p></tpl:IfModeration>

  • IfMyMetaNotExist
    Si le plugin "MyMeta" est absent/désactivé et si le type "x" n'existe pas ou est désactivé, <tpl:IfMyMetaNotExist type="x"> affiche ce qui est placé entre <tpl:IfMyMetaNotExist> et </tpl:IfMyMetaNotExist>

  • IfWikiComments
    Si "Autoriser la syntaxe wiki pour les commentaires" est coché dans les paramètres du blog, affiche ce qui est placé entre <tpl:IfWikiComments> et </tpl:IfWikiComments>

  • PackedCategoryName
    {{tpl:PackedCategoryName}} renvoie le nom de la catégorie en minuscules, sans espaces, ni caractères accentués.

  • PackedTagName
    {{tpl:PackedTagName}} renvoie le mot-clé en minuscules, sans espaces, ni caractères accentués.
    utilisable dans la liste des billets selon un mot-clé (tag.html)

  • TagEntriesCount
    {{tpl:TagEntriesCount}} renvoie le nombre de billets correspondant à un tag.
    utilisable dans tags.html, tag.html ou une boucle <tpl:Tag>

Remarque

Cette liste des marqueurs, syntaxes et fonctionnalités est également présente en début du fichier _public.php.

Annexes

Ajouter un commentaire

Le code HTML est affiché comme du texte et les adresses web sont automatiquement transformées. Vous pouvez utiliser une syntaxe wiki simplifiée en vous aidant des boutons de mise en forme au-dessus du champ de saisie du commentaire. Votre adresse email ne sera pas rendue publique.

Haut de page