Download the PHP package nckrtl/filament-resource-templates without Composer
On this page you can find all versions of the php package nckrtl/filament-resource-templates. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nckrtl/filament-resource-templates
More information about nckrtl/filament-resource-templates
Files in nckrtl/filament-resource-templates
Package filament-resource-templates
Short Description This is my package filament-resource-templates
License MIT
Homepage https://github.com/nckrtl/filament-resource-templates
Informations about the package filament-resource-templates
Filament Resource Templates
This package allows you to add the concept of templates to your Filament Resources. By utilizing DTO's to define template sections and components we can apply more structure which is useful when we need to display the content in the frontend through auto completion. This is as well beneficial for Livewire frontends as for Inertia frontends that use typescript.
Use with cause
This package is still considered a work in progress. There are no tests yet and things are still likely to change. So use with caution as future changes might result in data loss when editing records in filament using the template feature of this package.
Installation
You can install the package via composer:
Usage
- Prepare your models and tables
Each resource you want to use templates for needs at least a template column that can contain a string (
$table->string('template')
) and content column that will contain the structered content in json format ($table->json('content')
). By default all data of your template will be stored in the content column, but if you need data that needs to sit in their own column that's also possible.
In the example below we'll use pages as an example and we'll store the title and slug in a separate column so we can display it more easily in the table on the resource list page.
- Create a template file. A template file is basically just a DTO:
Each template at least should have a name and a form definition. In addition you can add sections and properties. When you add class properties that are used in the form definition, then those properties will be stored in their own column. So make sure the columns are added to the table beforehand.
- Add sections The form definition in the template is the first section being displayed. You can add additional sections by defining them with a const:
This section is a separate DTO that may look like:
-
Update the class to extend TemplateResource
-
Define a list of templates:
- Now when you create a record you should see the template dropdown and the first template will be selected, while showing the form definition defined in the template.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Nick Retel
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of filament-resource-templates with dependencies
filament/filament Version ^3.2
filament/forms Version ^3.2
illuminate/contracts Version ^11.0
spatie/laravel-data Version ^4.6
spatie/laravel-package-tools Version ^1.16