Gérer les assets

Les fichiers publics de votre thème doivent être placés dans le dossiers "assets", mais leur structure à l'intérieur de ce dossier est libre.

Fichiers appelés par défaut

Deux fichiers de thèmes sont appelés par défaut dans le template "templates/front/base.html.twig", mais ces appels peuvent être supprimés si vous ne les utilisez pas :

"css/knacss.css" : Les thèmes de Nina développés par la couleur du zèbre utilisent le framework css Knacss, compilé à partir de fichiers scss.
"js/script.js", qui contient les scripts principaux des thèmes Nina.

Les autres scripts et fichiers css appelés par le template "base.html.twig" sont également utilisés par le back-office et par les blocs, ils est donc déconseillé de les supprimer.

Vous pouvez utiliser les scripts suivants sans les ajouter à votre thème :

jQuery
SlickSlider : sliders
Fancybox : lightboxes
jsCookie : gestion des cookies
jsTree : création d'arborescences interactives

Appeler de nouveaux fichiers

Placez votre fichier dans le dossiers "assets" de votre thème.

Vous pouvez maintenant l'appeler dans votre template grâce à la fonction Twig "asset". Le dossier "public/theme" est en réalité un lien symbolique vers le dossier "assets" du thème actif, vous pouvez donc écrire "theme" à la place de "themes/votreTheme/assets" :

<link rel="stylesheet" href="{{ asset('theme/css/monFichierCss.css') }}" type="text/css"><script src="{{ asset('theme/js/monFichierJavascript.js') }}"></script>

Si vous souhaitez appeler votre fichier sur toutes les pages du site, ajoutez-le au fichier "front/base.html.twig".

Si vous souhaitez l'ajouter sur une route en particulier, ajoutez-le au fichier de template lié, dans le bloc "stylesheets" pour les fichiers css, "javascripts" pour les fichiers javascript.

Ex :

{% block javascripts %} <script type="text/javascript"> <script src="{{ asset('theme/js/monFichierJavascript.js') }}"></script> {{ parent() }} {% endblock %}

La fonction Twig parent() permet d'appeler les autres fichiers du fichier base.html.twig, n'oubliez pas de l'ajouter sous peine de bugs relatifs à des fichiers manquants