Create really fast and easily general settings for your Laravel Filament project.
You can install the package via composer:
composer require joaopaulolndev/filament-general-settings
You can publish and run the migrations with:
php artisan vendor:publish --tag="filament-general-settings-migrations"
php artisan migrate
You can publish the config file with:
php artisan vendor:publish --tag="filament-general-settings-config"
Optionally, you can publish the views using
php artisan vendor:publish --tag="filament-general-settings-views"
Optionally, you can publish the translations using
php artisan vendor:publish --tag="filament-general-settings-translations"
Optionally, you can publish the assets using. Ex: to show images in default email providers.
php artisan vendor:publish --tag="filament-general-settings-assets"
This is the contents of the published config file:
return [
'show_application_tab' => true,
'show_analytics_tab' => true,
'show_seo_tab' => true,
'show_email_tab' => true,
'show_social_networks_tab' => true,
'expiration_cache_config_time' => 60,
];
Optionally, if you would like to add custom tabs and custom fields follow the example on configuration using the keys show_custom_tabs
and custom_tabs
.
use Joaopaulolndev\FilamentGeneralSettings\Enums\TypeFieldEnum;
return [
'show_application_tab' => true,
'show_analytics_tab' => true,
'show_seo_tab' => true,
'show_email_tab' => true,
'show_social_networks_tab' => true,
'expiration_cache_config_time' => 60,
'show_custom_tabs'=> true,
'custom_tabs' => [
'more_configs' => [
'label' => 'More Configs',
'icon' => 'heroicon-o-plus-circle',
'columns' => 1,
'fields' => [
'custom_field_1' => [
'type' => TypeFieldEnum::Text->value,
'label' => 'Custom Textfield 1',
'placeholder' => 'Custom Field 1',
'required' => true,
'rules' => 'required|string|max:255',
],
'custom_field_2' => [
'type' => TypeFieldEnum::Select->value,
'label' => 'Custom Select 2',
'placeholder' => 'Select',
'required' => true,
'options' => [
'option_1' => 'Option 1',
'option_2' => 'Option 2',
'option_3' => 'Option 3',
],
],
'custom_field_3' => [
'type' => TypeFieldEnum::Textarea->value,
'label' => 'Custom Textarea 3',
'placeholder' => 'Textarea',
'rows' => '3',
'required' => true,
],
'custom_field_4' => [
'type' => TypeFieldEnum::Datetime->value,
'label' => 'Custom Datetime 4',
'placeholder' => 'Datetime',
'seconds' => false,
],
'custom_field_5' => [
'type' => TypeFieldEnum::Boolean->value,
'label' => 'Custom Boolean 5',
'placeholder' => 'Boolean'
],
]
],
]
];
To enable the feature for choosing a logo and favicon within the application tab, you need the following steps:
Publish the migration file to add the site_logo
and site_favicon
fields to the general settings table (only if you have installed the package before this feature):
php artisan vendor:publish --tag="filament-general-settings-migrations"
php artisan migrate
Publish the configuration file:
php artisan vendor:publish --tag="filament-general-settings-config"
Open the published configuration file config/filament-general-settings.php and set the following key to true:
return [
// Other configuration settings...
'show_logo_and_favicon' => true,
];
Add in AdminPanelProvider.php
use Joaopaulolndev\FilamentGeneralSettings\FilamentGeneralSettingsPlugin;
...
->plugins([ FilamentGeneralSettingsPlugin::make() ])
if you want to show for specific parameters to sort, icon, title, navigation group, navigation label and can access, you can use the following example:
```php
->plugins([
FilamentGeneralSettingsPlugin::make()
->canAccess(fn() => auth()->user()->id === 1)
->setSort(3)
->setIcon('heroicon-o-cog')
->setNavigationGroup('Settings')
->setTitle('General Settings')
->setNavigationLabel('General Settings'),
])
composer test
Please 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.