NB: Je ne vous parlerais ici que des balises de template qui servent à remplacer des liens, la page publique dédiée de dcMiniUrl ainsi que les autres balises feront l'objet d'un autre billet.


Le plugin dcMiniUrl est livré avec plusieurs balises de template, leur nombre augmentera avec le temps. Vous devez activer l'extension dans sa partie administration pour pouvoir utiliser ces balises.

Le but de ses balises est de remplacer des balises existantes pour utiliser des liens raccourcis à leurs places et également avoir accès à un compteur de clic sur ces liens.
Ses balises sont accompagnées de bloc de conditions utiles suivant le mode d'utilisation de l'extension.

Deux exemples pour mieux comprendre:

Le plus simple est le mode d'autocréation de mini liens, pour cela il faut activer l'option "Activer la création automatique de lien court coté public" dans l'administration de l'extension, alors il suffit de remplacer les balises {{tpl:EntryURL}} par {{tpl:EntryMiniURL}} dans les templates pour que les liens courts soient utilisés (et créés automatiquement si ils n'existent pas.

Sur la page d'accueil (home.html), on pourrait remplacer :

<h2 class="post-title">
 <a href="{{tpl:EntryURL}}">{{tpl:EntryTitle encode_html="1"}}</a>
</h2>

par :

<h2 class="post-title">
 <a href="{{tpl:EntryMiniURL}}">{{tpl:EntryTitle encode_html="1"}}</a>
</h2>

L'autre mode est l'utilisation de liens courts uniquement si ils existent, c'est à dire avec l'option de création automatique coté publique désactivée. Il faut alors vérifier que le lien existe avant de l'afficher. Cela se fait avec le bloc de template nommé "xxxMiniIf" ou xxx est le nom de la balise associée. Suivant que l'on veuille la condition positive ou négative il faut utiliser l'attribut "has_miniurl" ou "has_customurl" avec la valeur "1" ou "0". Ses blocs supportent les operateurs de condition pour faire un "et" ou un "ou". Pour l'instant il n'y a que deux type de liens courts: les "miniurl" qui sont générés par incrémentation, et les "customurl" qui sont créés depuis l'interface d'aministration de l'extension.

Sur la page d'un billet (post.html), de la même manière qu'avec la balise Category on peut avoir:

<p class="post-info">
 <a href="{{tpl:EntryURL}}">{{tpl:lang Permalink}}</a>
</p>

avec en plus:

<p class="post-info">
 <a href="{{tpl:EntryURL}}">{{tpl:lang Permalink}}</a>
 <tpl:EntryMiniIf operator="or" has_miniurl="1" has_customurl="1">
  - <a href="{{tpl:EntryMiniURL}}">{{tpl:lang Mini URL}}</a>
 </tpl:EntryMiniIf>
</p>

Liste des balises supportées :

  • AttachmentURL : AttachmentMiniURL : AttachmentMiniIf
  • MediaURL : MediaMiniURL : MediaMiniIf
  • EntryAuthorURL : EntryAuthorMiniURL : EntryAuthorMiniIf
  • EntryURL : EntryMiniURL : EntryMiniIf
  • CommentAuthorURL : CommentAuthorMiniURL : CommentAuthorMiniIf
  • CommentPostURL : CommentPostMiniURL : CommentPostMiniIf

D'autres balises viendront s'ajouter à cette liste suivant vos besoins!