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 extensive custom fields (Text, Select, Checkbox, Radio, Date, Time, File Upload, etc.).
• Secure password fields with automatic hashing and confirm password validation.
• 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')
                ->panelAccess(true)  // Optional: Enable granular panel access controls
                ->translations(true) // Optional: Enable spatie/laravel-translatable fields
        );
}

Note on Translations: If you enable ->translations(true), ensure you have defined your desired locales in the config/filament-custom-forms.php under the locales key.

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:

1. Update CHANGELOG.md.
2. Commit your changes.
3. Tag the release: git tag v1.0.1.
4. Push the tag: git push origin v1.0.1.

Usage

1. Form Creation: Navigate to the Custom Forms resource to create dynamic forms using the builder.
2. Data Collection: Users can submit entries through the generated forms.
3. Entry Management: View and export entries in the Custom Form Entries resource.
4. Data Exporting: Export the data grid to JSON, heavily formatted Excel files, or instantly as beautifully formatted PDF tables.

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

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