flobbos / laravel-pagebuilder
Build content in your database with translations.
Installs: 1 154
Dependents: 0
Suggesters: 0
Security: 0
Stars: 15
Watchers: 4
Forks: 6
Open Issues: 0
Requires
- php: ^8.0|^8.1
- cocur/slugify: ^4.0
- flobbos/laravel-translatable-db: ^1.4
- illuminate/support: 9.*|10.*
- livewire/livewire: ^2.4
README
Docs
Installation
Install the package
composer require flobbos/laravel-pagebuilder
Install pagebuilder
Laravel 5.7+
php artisan pagebuilder:install
This will run all migrations and trigger the seeder for the initial elements and a language entry
Configuration
The only thing in the config file is the classes you wish to use with Pagebuilder.
You need to generate a model class first using the built in generator.
'builder_classes' => [ 'page' => App\Page::class, ]
Set additional classes that are supposed to run in a Pagebuilder controller. You can generate multiple controllers for multiple resources using the Pagebuilder.
$this->articles->setClass('page');
This setting in the generated controller will tell it which resource it needs to use for generating content.
Generators
You can generate the controller and views for creating pagebuilder based resources using the following generator commands:
php artisan pagebuilder:controller ArticleController --route=pagebuilder.pages --views=pagebuilder.pages
This will generate a complete resource controller named PageController where the routes and view calls are replaced with the values above. The views will always be prefixed with vendor.
php artisan pagebuilder:views pagebuilder.pages --route=pagebuilder.pages
Use the corresponding routes that you set with the controller and it will all work magically.
pagebuilder:model Page
This will generate a Page model that extends the BasePage model that comes with the package so all necessary relationships and translation options are included. This step is necessary to be able to generate content because the BasePage model should not be used as a resource directly.
Slugs
The pagebuilder is capable of generating translated URL slugs for you. All you need to do is uncomment the following line from your generated model:
//protected $slug_field = 'title';
This will tell the pagebuilder which field in the translations is supposed to generate the URL slug. The slug will automatically be regenerated when you change the named field.
Fields
There are some basic fields in the settings area for an resource but you are free to add as many additional fields as needed. These fields will be automatically saved in the database without further modifications to the DB structure.
JS Components
To use the pagebuilder you need to install its VueJS counterpart by running:
npm install @chrisbielak/vue-pagebuilder
All the needed documentation can be found here: Vue Pagebuilder