Upgrading

This guide covers the upgrade from 2.x to 3.x. Version 3.x exists for filament 4.

This is the biggest step in the history of the package. The field was rewritten, so the namespace, the setup and most of the options changed.

Upgrade filament

Please follow the filament upgrade guide first.

Bump the constraint

composer require guava/filament-icon-picker:"^3.0"

Change your imports

The namespace changed from Guava\FilamentIconPicker to Guava\IconPicker, and both classes moved:

// Before
use Guava\FilamentIconPicker\Forms\IconPicker;
use Guava\FilamentIconPicker\Tables\IconColumn;

// After
use Guava\IconPicker\Forms\Components\IconPicker;
use Guava\IconPicker\Tables\Columns\IconColumn;

Publish the assets

The field now ships its own JS, so you need to publish the package assets:

php artisan filament:assets

Add a custom theme

A custom filament theme is now required. If you don't have one, please read the filament documentation on how to create one.

Then add the following to your theme.css file:

@source '../../../../vendor/guava/filament-icon-picker/resources/**/*';

If you skip this, the picker renders without any styling.

Remove the config file

config/icon-picker.php is not used anymore and can be deleted. Everything is configured on the field itself.

Options that are gone

The following options were removed and have no replacement:

Options that stayed

sets() works exactly the same:

IconPicker::make('icon')
    ->sets(['heroicons']);

Found an issue?

If you find a step that is missing here, please open a PR and modify this file. We will review it and merge it.