Documentation
Pour les utilisateurs
Pour les développeurs
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