Download the PHP package neevalt/acad-template-bundle without Composer
On this page you can find all versions of the php package neevalt/acad-template-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package acad-template-bundle
Bundle de templating de l'académie de Créteil
Installer le bundle
Depuis la console :
Importer les routes
Grâce à Symfony Flex, le bundle est activé automatiquement. Pour bénéficier des routes, il faut importer celles-ci
dans config/routes.yaml :
Utiliser et configurer le template
Utiliser le template
Pour utiliser ce template, il est vivement conseillé de gérer les dépendances via Webpack Encore. Vous bénéficierez ainsi d'une personnalisation plus avancée.
Installez celles-ci :
Puis créez vos assets, par exemple comme suit :
Nb : le fichier _variables.scss n'est nécessaire que si vous souhaitez modifier les différentes variables Sass du
template (les couleurs, les tailles, ...)
Faites les imports nécessaires :
Compilez vos assets via webpack :
Même si la configuration ci-dessus fonctionne, il est plutôt conseillé d'utiliser des chunks partagés pour profiter du cache navigateur :
Enfin, étendez le template du bundle dans le votre :
Pour un exemple fonctionnel :
Important : Certains éléments (comme les modals Bootstap) nécessitent d'être en dehors du contexte
donné par le template. Un block after_page est défini à cet effet.
Configurer le template
Variables twig
La configuration du template se fait directement dans le votre via des variables twig. Les valeurs par défaut sont :
Apparence
Si vous souhaitez modifier l'apparence du template, comme les couleurs, les hauteurs des footer / navbar, etc..., des variables Sass sont disponibles. Les valeurs par défaut sont :
Pour les modifier, il suffit de les réécrire dans le fichier _variables.scss mentionné plus haut.
Il est aussi possible de redéfinir les breakpoints Bootstrap :
Si vous changez ces valeurs et que vous avez utilisé les chunks partagés, pensez à en créer un qui ne servira qu'à redéfinir ces variables avec les imports nécessaires (qui ne doivent donc plus constituer des chunks).
Redéfinir le template
Pour redéfinir le template, consultez la documentation officielle.
Les toasts
Le template vient avec des messages toasts javascript qui affichent par défaut les flash messages de Symfony :
Il est aussi possible de les générer soi-même avec du js, cela peut être utile notamment pour de l'ajax.
Dans app.js :
Le premier argument de la fonction acadAlert(type, message) détermine la couleur du toast.
Les couleurs sont celles de Bootstrap.
Pour ajouter un titre au toast, respecter la syntaxe de message suivante : #Titre#Le message.
Rendu
L'ensemble des extraits de code montrés ci-dessus donne le rendu suivant :
Utilisation sans Webpack
Il est déconseillé de se passer de Webpack pour utiliser ce bundle. Si vous décidez néanmoins de le faire, il suffit de ne pas écraser les blocks assets du template :
