chanthoeun / filament-custom-forms
A FilamentPHP plugin to manage and submit custom forms.
Package info
github.com/Chanthoeun/filament-custom-forms
pkg:composer/chanthoeun/filament-custom-forms
Requires
- php: ^8.2
- filament/filament: ^4.0|^5.0
- filament/schemas: ^4.0|^5.0
Requires (Dev)
- orchestra/testbench: ^9.0|^10.0
- phpunit/phpunit: ^11.0
README
A powerful and simplified FilamentPHP plugin to manage and submit dynamic custom forms. Refactored for speed and ease of use in standalone environments.
Features
- Dynamic form builder with custom fields.
- Submission management with a clean interface.
- Support for Filament v4 and v5.
- Easy integration as a standalone package.
Installation
1. Requirements
- PHP 8.2+
- Filament v4.0 or v5.0
2. Install via Composer
composer require chanthoeun/filament-custom-forms
3. Publish Assets
php artisan vendor:publish --tag="filament-custom-forms-config" php artisan vendor:publish --tag="filament-custom-forms-migrations"
4. Run Migrations
php artisan migrate
5. Register the Plugin
Add the plugin to your Filament Panel provider:
use Chanthoeun\FilamentCustomForms\CustomFormPlugin; public function panel(Panel $panel): Panel { return $panel ->plugin( CustomFormPlugin::make() ->navigationGroup('Form Builder') ->navigationFormIcon('heroicon-o-document-duplicate') ->navigationEntryIcon('heroicon-o-clipboard-document-list') ); }
Updates
To update the package to the latest version, run:
composer update chanthoeun/filament-custom-forms
If the update includes new migrations or changes to published assets, you may need to re-publish or run:
php artisan migrate
Versioning
This project follows Semantic Versioning. We use Git tags to manage releases.
To release a new version:
- Update
CHANGELOG.md. - Commit your changes.
- Tag the release:
git tag v1.0.1. - Push the tag:
git push origin v1.0.1.
Usage
- Form Creation: Navigate to the Custom Forms resource to create dynamic forms using the builder.
- Data Collection: Users can submit entries through the generated forms.
- Entry Management: View and export entries in the Custom Form Entries resource.
Changelog
Please see CHANGELOG for more information on what has changed recently.
License
The MIT License (MIT). Please see License File for more information.