saade / filament-autograph
A Filament package to manage signatures.
Fund package maintenance!
saade
Installs: 93 732
Dependents: 0
Suggesters: 0
Security: 0
Stars: 69
Watchers: 2
Forks: 19
Open Issues: 7
Requires
- php: ^8.1
- filament/filament: ^4.0
- filament/forms: ^4.0
- spatie/laravel-package-tools: ^1.15.0
Requires (Dev)
- laravel/pint: ^1.0
- nunomaduro/collision: ^8.0
- nunomaduro/larastan: ^3.0
- orchestra/testbench: ^9.0
- pestphp/pest: ^3.0
- pestphp/pest-plugin-arch: ^3.0
- pestphp/pest-plugin-laravel: ^3.0
- phpstan/extension-installer: ^1.1
- phpstan/phpstan-deprecation-rules: ^2.0
- phpstan/phpstan-phpunit: ^2.0
- spatie/laravel-ray: ^1.26
README
Installation
1. You can install the package via composer:
composer require saade/filament-autograph
2. Setup the plugin styles:
Important
If you have not set up a custom theme and are using Filament Panels follow the instructions in the Filament Docs first.
After setting up a custom theme add the plugin's views to your theme css file or your app's css file if using the standalone packages.
@source '../../../../vendor/saade/filament-autograph/resources/views/**/*.blade.php';
Usage
use Saade\FilamentAutograph\Forms\Components\SignaturePad; SignaturePad::make('signature')
Configuration
SignaturePad options.
For reference: https://github.com/szimek/signature_pad#options
use Saade\FilamentAutograph\Forms\Components\SignaturePad; SignaturePad::make('signature') ->label(__('Sign here')) ->dotSize(2.0) ->lineMinWidth(0.5) ->lineMaxWidth(2.5) ->throttle(16) ->minDistance(5) ->velocityFilterWeight(0.7)
Customizing the pad background and pen color.
use Saade\FilamentAutograph\Forms\Components\SignaturePad; SignaturePad::make('signature') ->backgroundColor('rgba(0,0,0,0)') // Background color on light mode ->backgroundColorOnDark('#f0a') // Background color on dark mode (defaults to backgroundColor) ->exportBackgroundColor('#f00') // Background color on export (defaults to backgroundColor) ->penColor('#000') // Pen color on light mode ->penColorOnDark('#fff') // Pen color on dark mode (defaults to penColor) ->exportPenColor('#0f0') // Pen color on export (defaults to penColor)
Allow download of the signature.
use Saade\FilamentAutograph\Forms\Components\SignaturePad; use Saade\FilamentAutograph\Forms\Components\Enums\DownloadableFormat; SignaturePad::make('signature') ->filename('autograph') // Filename of the downloaded file (defaults to 'signature') ->downloadable() // Allow download of the signature (defaults to false) ->downloadableFormats([ // Available formats for download (defaults to all) DownloadableFormat::PNG, DownloadableFormat::JPG, DownloadableFormat::SVG, ]) ->downloadActionDropdownPlacement('center-end') // Dropdown placement of the download action (defaults to 'bottom-end')
Disabling clear, download, undo and done actions.
use Saade\FilamentAutograph\Forms\Components\SignaturePad; SignaturePad::make('signature') ->clearable(false) ->downloadable(false) ->undoable(false) ->confirmable(false)
Requiring confirmation (Done button).
SignaturePad::make('signature') ->confirmable() // Requires user to click on 'Done' (defaults to false)
Customizing actions
use Saade\FilamentAutograph\Forms\Components\SignaturePad; use Filament\Forms\Actions\Action; SignaturePad::make('signature') ->clearAction(fn (Action $action) => $action->button()) ->downloadAction(fn (Action $action) => $action->color('primary')) ->undoAction(fn (Action $action) => $action->icon('heroicon-o-ctrl-z')) ->doneAction(fn (Action $action) => $action->iconButton()->icon('heroicon-o-thumbs-up'))
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
License
The MIT License (MIT). Please see License File for more information.