This plugin adds a new icon picker form field and a corresponding table column. You can use it to select from any blade-icons kit that you have installed. By default, heroicons are supported since it is shipped with Filament.
This can be useful for when you want to customize icons rendered on your frontend, if you want your users to be able to customize navigation icons, add small icons to their models for easy recognition and similar.
The full documentation is available at guava.cz.
| Filament version | Plugin version |
|---|---|
| 2.x | 1.x |
| 3.x | 2.x |
| 4.x | 3.x |
| 5.x | 4.x |
For older filament versions, please check the branch of the respective version.
You can install the package via composer:
composer require guava/filament-icon-pickerMake sure to publish the package assets using:
php artisan filament:assetsFinally, make sure you have a custom filament theme (read here how to create one) and add the following to your theme.css file so the CSS is properly built:
@source '../../../../vendor/guava/filament-icon-picker/resources/**/*';For the remaining setup steps, please see the installation docs.
Add the icon picker to any form schema:
use Guava\IconPicker\Forms\Components\IconPicker;
IconPicker::make('icon');And the column to any table:
// Make sure this is the correct import, not the filament one
use Guava\IconPicker\Tables\Columns\IconColumn;
IconColumn::make('icon');Everything else, including search result views, limiting icon sets and letting your users upload their own icons, is covered in the documentation.
composer testPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.