Downloads
Stars
Version
Ce package fonctionne avec Laravel Nova, veillez donc à l'installer avant de poursuivre. Retrouver la documentation et les instructions d'installation de Laravel Nova sur leur page officielle
Il est également préférable d'utiliser le css jolimardi pour assurer un bon fonctionnement. jolimardi-css GitHub
composer require jolimardi/laravel-sections
php artisan vendor:publish --provider="JoliMardi\MySections\MySectionsServiceProvider"
Il est également possible de publish le package en plusieurs fois en ajoutant différents tags, selon les besoins :
php artisan vendor:publish --provider="JoliMardi\MySections\MySectionsServiceProvider" --tag="nova"
- Publish aussi les models
php artisan vendor:publish --provider="JoliMardi\MySections\MySectionsServiceProvider" --tag="migrations"
php artisan vendor:publish --provider="JoliMardi\MySections\MySectionsServiceProvider" --tag="assets"
php artisan vendor:publish --provider="JoliMardi\MySections\MySectionsServiceProvider" --tag="views"
php artisan migrate`
Ajoutez JoliMardi\MySections\MySectionsServiceProvider::class
à votre fichier config/app.php
, seulement si cela s'avère nécessaire. Cette étape peut être requise si le package ne respecte pas la convention PSR-4 ou s'il est mal implémenté dans le composer.json
autoload.
Importez le fichier CSS du package dans app.css
en ajoutant la ligne suivante (Recommandé avec Vite.js):
@import "../../public/vendor/mysections/sections.css";
En développement, on préferera utiliser
@import "../../vendor/jolimardi/laravel-mysections/dist/sections.css";
pour ne pas avoir à publish les assets à chaque sauvegarde.
Afin que tout fonctionne bien lors de la création de section sur Nova. Il faudt également installer Nova CKEditor :
https://jolimardi.github.io/documentation/docs/laravel/Features/add-ckeditor
Utilisez la fonction mySection($data, $key)
dans une views pour insérer une section. Pour passer des données spécifiques à la section ainsi que sa clé correspondante.
Il est possible d'utiliser le composant <x-section>
dans une views afin de définir des règles CSS pré-établies pour les sections. Voici un exemple :
<x-layout>
@mySection($sections, 'home.about')
<x-section maxWidth="large" bg="gray">
<x-list-icon />
</x-section>
</x-layout>
Après avoir éxécuter la commande :
php artisan vendor:publish --provider="JoliMardi\MySections\MySectionsServiceProvider" --tag="views"
Retrouver dans resources/views/vendor/laravel-sections
les vues des différentes sections qui sont utiliser pour render respectivement chaque section par défaut.
Voici les étapes à suivre pour créer une nouvelle section :
Si vous avez ajouter une nouvelle section au packages, pensez à vous rentre sur "Sections templates" en amont pour lui donner un nom afin de pouvoir l'utiliser lors de la sélection du template
Remarque : Ces instructions supposent que vous êtes déjà familiarisé avec l'utilisation de Nova et de Laravel. Si ce n'est pas le cas, je vous recommande de consulter la documentation officielle pour plus d'informations.
Il est possible d'update le package à sa guise.
composer install
npm install
dist/sections.css
npx mix watch
Ou mettre à jour une fois en utilisant :
npx mix
Remarque : Si vous modifier le contenu de
/dist
et que vous avez publish les assets. Il faut supprimer le fichiersection.css
danspublic/vendor/mysections
et relancer la commande pour publish le nouveaux fichier. (Voir Installation -> Tags)
Ajouter une nouvelle vue : Créez et ajoutez une nouvelle vue dans le dossier src/views
.
Ajouter un fichier CSS : Créez et ajoutez un fichier CSS correspondant dans le dossier src/css
.
Mettre à jour le fichier webpack.mix.js
: Ajoutez le fichier CSS à la configuration du webpack.mix.js
.
Compilation des assets : Exécutez la commande npx mix pour recompiler les assets et actualiser le dossier dist
.
Mise à jour du submodule : Si vous utilisez ce package en tant que submodule dans un autre projet, assurez-vous de mettre à jour le submodule.
Référence : Ensuite, reportez-vous à la section 'Création d'une nouvelle section' pour plus de détails sur la création d'une nouvelle section.
Note : Si on ajoute un fichier css, il faut l'ajouter au webpack.mix.js
et relancé la commande npx mix watch
.
Puis mettre à jour le dépôt et de mettre à jour votre projet avec les nouvelles modifications.
<x-section><x-section />
sans avoir besoin de jolimardi-css