https://github.com/tappnetwork/filament-form-builder
Generate forms for collecting user data using Filament PHP
https://github.com/tappnetwork/filament-form-builder
Last synced: 5 months ago
JSON representation
Generate forms for collecting user data using Filament PHP
- Host: GitHub
- URL: https://github.com/tappnetwork/filament-form-builder
- Owner: TappNetwork
- License: mit
- Created: 2024-04-26T20:02:56.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-02T15:28:11.000Z (7 months ago)
- Last Synced: 2025-12-05T16:12:28.833Z (7 months ago)
- Language: PHP
- Size: 262 KB
- Stars: 12
- Watchers: 4
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# Filament Forms
[](https://packagist.org/packages/tapp/filament-form-builder)
[](https://packagist.org/packages/tapp/filament-form-builder)
A Filament plugin and package that allows the creation of forms via the admin panel for collecting user data on the front end. Forms are composed of filament field components and support all Laravel validation rules. Form responses can be rendered on the front end of exported to .csv.
## Requirements
- PHP 8.2+
- Laravel 11.0+
- [Filament 3.0+](https://github.com/laravel-filament/filament)
## Dependencies
- [maatwebsite/excel](https://github.com/SpartnerNL/Laravel-Excel)
- [spatie/eloquent-sortable](https://github.com/spatie/eloquent-sortable)
### Installing the Filament Forms Package
Install the plugin via Composer:
This package is not yet on packagist. Add the repository to your composer.json
```json
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/TappNetwork/Filament-Form-Builder"
}
],
}
```
```bash
composer require tapp/filament-form-builder
```
public and run migrations with
```bash
php artisan vendor:publish --tag="filament-form-builder-migrations"
```
#### Optional: Publish the package's views, translations, and config
You can publish the view file with:
```bash
php artisan vendor:publish --tag="filament-form-builder-views"
```
You can publish the config file with:
```bash
php artisan vendor:publish --tag="filament-form-builder-config"
```
### Adding the plugin to a panel
Add this plugin to a panel on `plugins()` method (e.g. in `app/Providers/Filament/AdminPanelProvider.php`).
```php
use Tapp\FilamentFormBuilder\FilamentFormBuilderPlugin;
public function panel(Panel $panel): Panel
{
return $panel
// ...
->plugins([
FilamentFormBuilderPlugin::make(),
//...
]);
}
```
### Configuring Tailwind:
Add this to your tailwind.config.js content section:
```
content: [
...
"./vendor/tapp/**/*.blade.php",
],
```
### Disabling Redirect
You can disable the redirect when including the Form/Show component inside of another component by passing the 'blockRedirect' prop as follows
```
@livewire('tapp.filament-form-builder.livewire.filament-form.show', ['form' => $test->form, 'blockRedirect' => true])
```
### Events
#### Livewire
The FilamentForm/Show component emits an 'entrySaved' event when a form entry is saved. You can handle this event in a parent component to as follows.
```
class ParentComponent extends Component
{
protected $listeners = ['entrySaved'];
public function entrySaved(FilamentFormUser $survey)
{
// custom logic you would like to add to form entry saving logic
}
}
```
#### Laravel
The component also emits a Laravel event that you can listen to in your event service provider
```php
// In your EventServiceProvider.php
protected $listen = [
\Tapp\FilamentFormBuilder\Events\EntrySaved::class => [
\App\Listeners\HandleFormSubmission::class,
],
];
// Create a listener class
namespace App\Listeners;
use Tapp\FilamentFormBuilder\Events\EntrySaved;
class HandleFormSubmission
{
public function handle(EntrySaved $event): void
{
// Access the form entry
$entry = $event->entry;
// Perform actions with the form data
// For example, send notifications, update other records, etc.
}
}
```