Les balises

---

prevent_cache

Empêche la bibliothèque en cours de rendu d'être mise en cache. Ceci est utile si l'on interagit avec la base de données ou des données dynamiques.

Il est également possible de définir un argument maxAge pour simplement limiter la durée du cache. La valeur doit être exprimée en minutes.

Usage

{# Pour que la page ne soit jamais mise en cache #}
{% prevent_cache %}

{# Pour que la page soit mise en cache 24 heures. #}
{% prevent_cache 1440 %}

---

exit

Permet de terminer l'execution d'une requête.

Usage

{# Termine la requète est renvoi le code de statut 404 #}
{% exit 404 %}

---

canonical_url

Permet de définir une URL canonique.

Usage

{% canonical_url 'https://www.example.com' %}

---

header

Permet de définir une en-tête HTTP.

Usage

{# Demande au navigateur de mettre en cache la page 30 jours #}
{% set expiry = now|date_modify('+30 days') %}

{% header "Cache-Control: max-age=" ~ (expiry.timestamp - now.timestamp) %}
{% header "Pragma: cache" %}
{% header "Expires: " ~ expiry|date('D, d M Y H:i:s', 'GMT') ~ " GMT" %}

---

inject_js_env_var

Ajoute des variables JavaScript global pendant le rendu de la page. Ceci est utile lorsque l'on souhaite récupérer des données dynamiques tout en permettant la mise en cache de la page.

Liste des variables disponible (voir la classe Env pour plus de détails) :

• httpPostVars
• httpGetVars
• currentDateTime
• currentDate
• currentTime
• currentTimestamp
• isContactConnected
• connectedContact
• isUserConnected
• connectedUser

Usage

{% inject_js_env_var 'httpPostVars' %}

{% inject_js_env_var 'isContactConnected' %}

Les variables peuvent ensuite être récupérées en JavaScript de la manière suivante :

var postVars = ENV.httpPostVars;

var isContactConnected = ENV.isContactConnected;

---

include_package_file

Permet d'inclure un fichier d'un package bower. Seuls les fichiers ayant pour extension: css, js ou html sont supportés.

Usage

{% include_package_file 'css/font-awesome.min.css' fromPackage 'font-awesome#4.6.3' %}

---

include_external_library

Permet d'inclure un fichier d'une source externe. Seuls les fichiers ayant pour extension: css, js sont supportés.

{% include_external_library 'https://api.mapbox.com/mapbox-gl-js/v0.54.0/mapbox-gl.js' %}

---

include_font

Permets d'inclure une police.

Toutes les polices Google Font sont supportés. La syntaxe à utiliser est la même que celle de Google Font.

L'intérêt d'utiliser include_font plutôt que d'utilisé @import est que la définition de la police est directement incluse dans le CSS ce qui évite une requête vers les serveurs de Google et donc accélère grandement le chargement de la police.

Usage

{% include_font 'family=Open+Sans:400italic,800italic,400,800' %}

---

include_library

Permet d'inclure des bibliothèques dans l'en tête de la page.

Bibliothèques disponibles :

• facebookSDK
• twitterSDK
• googlePlusSDK
• disqusSDK

Usage

{% include_library 'facebookSDK' %}