Favorites Bar - Advanced Tables

The Favorites Bar is home to all of a user’s favorite views as well as Quick Save and View Manager. The Favorites Bar can be customized in a variety of ways to match the needs of your application.

Favorites Bar configuration

Unless specified otherwise, these customizations can be configured directly on the AdvancedTablesPlugin object inside your PanelProvider.

Themes

Advanced Tables includes six different themes for the Favorites Bar:

Links
Simple links
Branded tabs
Tabs
Github (New, default)
Filament

You can change the theme with the ‘favoritesBarTheme()` method:

use Archilex\AdvancedTables\Enums\FavoritesBarTheme;

AdvancedTablesPlugin::make()
    ->favoritesBarTheme(FavoritesBarTheme::Filament)

Note: Since links-simple only has color to visually distinguish between active and in-active states, it is recommended you disable the ability to select a color for their User Views since it becomes difficult to know which link is active.

Size

You may change the size of the Favorites Bar links to allow more links to be shown with the favoritesBarSize() method:

use Filament\Support\Enums\ActionSize;

AdvancedTablesPlugin::make()
    ->favoritesBarSize(ActionSize::Small)

Available sizes are: ActionSize::Small and ActionSize::Medium.

Icon position

You may change the position of a view’s icon in the Favorites Bar using the favoritesBarIconPosition() method:

use Filament\Support\Enums\IconPosition;

AdvancedTablesPlugin::make()
    ->favoritesBarIconPosition(IconPosition::Before)

Disabling the Default View

By default, the Favorites Bar includes a Default View. Clicking this will completely reset the table back to its default settings. You may disable the Default View using the favoritesBarDefaultView() method:

AdvancedTablesPlugin::make()
    ->favoritesBarDefaultView(false)

You may also disable the Default View per resource by overriding the hasDefaultView() method in the class where you have added the AdvancedTables trait:

public function hasDefaultView(): bool
{
    return false;
}

Modifying the Default View

Behind the scenes, the default view is an internal Preset View that is injected at the front of the views. This means it is easy to modify the default view per resource by creating a Preset View with the key default:

public function getPresetViews(): array
{
    return [
        'default' => PresetView::make()
            ->modifyQueryUsing(fn (Builder $query) => $query->active())
            ->icon(Heroicon::Check)
            ->default()
            ->favorite()
    ];
}

Default View name

You may change the name of the Default View in the language file.

Default View icon

You may change the icon used for the Default View using the favoritesBarDefaultIcon() method:

AdvancedTablesPlugin::make()
    ->favoritesBarDefaultIcon('heroicon-o-home')

To remove the Default View icon, don’t pass anything to the method: favoritesBarDefaultIcon()

Divider

If using both Preset Views and User Views, it may be helpful to have a divider line to help users visually distinguish between the two. You may use the favoritesBarDivider() method to enable this:

AdvancedTablesPlugin::make()
    ->favoritesBarDivider()

For more ways to distinguish between Preset Views and Users Views, please read the section Distinguishing between Preset Views and Users Views

Loading Indicator

You may show a loading indicator when switching between views by using the favoritesBarLoadingIndicator() method:

AdvancedTablesPlugin::make()
    ->favoritesBarLoadingIndicator()

Disabling the Favorites Bar

You can disable the Favorites Bar globally (helpful if you only want to use reorderable columns) by passing false to the favoritesBarEnabled() method:

AdvancedTablesPlugin::make()
    ->favoritesBarEnabled(false)

You may also configure this per table by overriding the favoritesBarIsEnabled() method on your List page:

class ListOrders extends ListRecords
{
    use AdvancedTables; 

    public static function favoritesBarIsEnabled(): bool
    {
        return false;
    }
    ...

You may also disable Quick Save or the View Manager if needed.

​Favorites Bar configuration

​Themes

​Size

​Icon position

​Disabling the Default View

​Modifying the Default View

​Default View name

​Default View icon

​Divider

​Loading Indicator

​Disabling the Favorites Bar