README

This is a CMS template for Laravel 12 using Bootstrap 5 as the frontend toolkit.
It includes all routes, controllers, requests, policies, views, ...
for User and Role management, together with a Post model and all it's CRUD functionality.
An excellent basic starting point for every application not using React, Vue, Livewire, ...
only Blade and a little KISS 💋

Installation

You can install the package via composer.

composer require voorhof/cms

Run the artisan command to install the CMS structure,
this will copy all necessary files to your app and update existing ones (a backup option is available).

php artisan cms:install

After installation, the database will automatically be refreshed and seeded with factory data;
you can always customize the CmsSeeder file to your development needs.

Although it is not required for installing this CMS package,
ideally a user authentication for registering, login,... should be present in your project.
If you don't have auth scaffolding installed, Voorhof Bries is available in this package.
When you choose to use Bries, be sure to execute this artisan command before calling cms:install

php artisan bries:install

To make things even easier, you can install both Bries and CMS with one single command.
Please take note this uses the default installation options for both Bries and CMS.
If you want to customize the Bries installation using your preferred options,
install the packages separately as described above.

php artisan cms:bries

Under the hood Laravel Permission from Spatie is used for authorization.
Everything needed for this template is already in place after installation,
but if you feel the need to re-publish the config file and database migration in the future, do so with this command.
Keep in mind that the default Spatie Role model has been extended, so you will probably have to update that again in the permissions.php config file.

php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"

Testing

After installation there will be a new set of test files present in your project.
Make sure you run the composer tests and check everything is working properly.

php artisan test

Credits

• David Carton
• All Contributors

License

The MIT License (MIT). Please see License File for more information.