PHPackages                             mattakorn-limkool/filament-general-settings - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. mattakorn-limkool/filament-general-settings

ActiveLibrary

mattakorn-limkool/filament-general-settings
===========================================

Filament package to manage general settings

v3.0.2(3mo ago)09MITPHPPHP ^8.1

Since Jan 20Pushed 2mo agoCompare

[ Source](https://github.com/mattakorn-limkool/filament-general-settings)[ Packagist](https://packagist.org/packages/mattakorn-limkool/filament-general-settings)[ GitHub Sponsors](https://github.com/joaopaulolndev)[ RSS](/packages/mattakorn-limkool-filament-general-settings/feed)WikiDiscussions featured Synced 1mo ago

READMEChangelogDependencies (13)Versions (4)Used By (0)

Filament General Settings
=========================

[](#filament-general-settings)

[![Latest Version on Packagist](https://camo.githubusercontent.com/23a19e1df7d5804a21d57cc3e7636d8955c0bb775e7abc8476a1f873396fd14e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a6f616f7061756c6f6c6e6465762f66696c616d656e742d67656e6572616c2d73657474696e67732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/joaopaulolndev/filament-general-settings)[![GitHub Tests Action Status](https://camo.githubusercontent.com/a2fdcf31dcf1a94c429d5079c2b0fb160b4d3abaa1c7943d6aa0e42e0e3fdf00/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6f616f7061756c6f6c6e6465762f66696c616d656e742d67656e6572616c2d73657474696e67732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/joaopaulolndev/filament-general-settings/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/03c806395740ac38b977c9ed7c9c8b883b5f4b3ccfb1fdf5250e100dc3fc5e2f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6f616f7061756c6f6c6e6465762f66696c616d656e742d67656e6572616c2d73657474696e67732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/joaopaulolndev/filament-general-settings/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/5ee6f67821e7f175d3acb00dd86ac6f4d7d069c4e18f4cba6e77f86649c6b46e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6f616f7061756c6f6c6e6465762f66696c616d656e742d67656e6572616c2d73657474696e67732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/joaopaulolndev/filament-general-settings)

Create really fast and easily general settings for your Laravel Filament project.

[![Screenshot of Application Feature](https://raw.githubusercontent.com/joaopaulolndev/filament-general-settings/2.x/art/joaopaulolndev-filament-general-settings.jpg)](https://raw.githubusercontent.com/joaopaulolndev/filament-general-settings/2.x/art/joaopaulolndev-filament-general-settings.jpg)

Features &amp; Screenshots
--------------------------

[](#features--screenshots)

- **Application:** Manage your system general settings, such as title, description, and theme color.
- **Analytics:** Add your Google Analytics tracking code to your system.
- **SEO Meta:** Manage your SEO meta tags, such as title, description, and keywords.
- **Email:** Manage your email settings, such as SMTP server, port, and credentials.
- **Social Media Network:** Manage your social media network links, such as Facebook, Twitter, Instagram, and LINE.
- **Logo &amp; Favicon:** Upload and manage your site logo and favicon with image editor support.
- **Multi-language Support:** Available in English, Arabic, Spanish, French, Dutch, Portuguese, Portuguese (Brazil), and Thai.
- **Support**: [Laravel 11](https://laravel.com) and [Filament 5.x](https://filamentphp.com)

Compatibility
-------------

[](#compatibility)

Package VersionFilament Version1.x3.x2.x4.x3.x5.xInstallation
------------

[](#installation)

You can install the package via composer:

```
composer require joaopaulolndev/filament-general-settings:^3.0
```

**Filament V4** - if you are using Filament v4.x, you can use [this section](https://github.com/joaopaulolndev/filament-general-settings/tree/2.x)**Filament V3** - if you are using Filament v3.x, you can use [this section](https://github.com/joaopaulolndev/filament-general-settings/tree/main)

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"
```

[![Screenshot of Default Email Providers](https://raw.githubusercontent.com/joaopaulolndev/filament-general-settings/main/art/default_email_provider_images.png)](https://raw.githubusercontent.com/joaopaulolndev/filament-general-settings/main/art/default_email_provider_images.png)

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'
                ],
            ]
        ],
    ]
];
```

### Enabling Logo and Favicon Feature

[](#enabling-logo-and-favicon-feature)

To enable the feature for choosing a logo and favicon within the application tab, you need the following steps:

1. 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
```

2. Publish the configuration file:

```
php artisan vendor:publish --tag="filament-general-settings-config"
```

3. 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,
];
```

Usage
-----

[](#usage)

Add in AdminPanelProvider.php

```
use Joaopaulolndev\FilamentGeneralSettings\FilamentGeneralSettingsPlugin;

...

->plugins([
    FilamentGeneralSettingsPlugin::make()
])
```

### Basic Configuration

[](#basic-configuration)

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:

```
->plugins([
    FilamentGeneralSettingsPlugin::make()
        ->canAccess(fn() => auth()->user()->id === 1)
        ->setSort(3)
        ->setIcon('heroicon-o-cog')
        ->setNavigationGroup('Settings')
        ->setTitle('General Settings')
        ->setNavigationLabel('General Settings'),
    ])
```

### Permission-Based Access Control (with laravel-permission)

[](#permission-based-access-control-with-laravel-permission)

You can integrate with `laravel-permission` to control access using roles and permissions:

```
->plugins([
    FilamentGeneralSettingsPlugin::make()
        ->permission('View:GeneralSettingsPage')  // Requires the user to have this permission
        ->setSort(3)
        ->setIcon('heroicon-o-cog')
        ->setNavigationGroup('Settings'),
    ])
```

To use this feature with **filament-shield** + **laravel-permission**:

1. Ensure you have both packages installed in your main application:

```
composer require spatie/laravel-permission
composer require bezhansalleh/filament-shield
```

2. Create the permission in your application:

```
php artisan shield:generate
```

3. Configure the plugin with the permission name and the `canAccess()` method will automatically check it.

**Note:** The `permission()` method is optional and only works when `laravel-permission` is installed in your main application. The plugin itself does not require it as a dependency.

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [João Paulo Leite Nascimento](https://github.com/joaopaulolndev)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance84

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~9 days

Total

3

Last Release

94d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/054f8bdf28f055e662bd59a707db6c9263bbfd93cb6e0b5c165d82616c55e626?d=identicon)[obbz](/maintainers/obbz)

---

Top Contributors

[![joaopaulolndev](https://avatars.githubusercontent.com/u/11706937?v=4)](https://github.com/joaopaulolndev "joaopaulolndev (52 commits)")[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (28 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (6 commits)")[![mattakorn-limkool](https://avatars.githubusercontent.com/u/241083986?v=4)](https://github.com/mattakorn-limkool "mattakorn-limkool (5 commits)")[![zhinea](https://avatars.githubusercontent.com/u/79736504?v=4)](https://github.com/zhinea "zhinea (4 commits)")[![sampiron](https://avatars.githubusercontent.com/u/6353766?v=4)](https://github.com/sampiron "sampiron (4 commits)")[![KaramNassar](https://avatars.githubusercontent.com/u/43961632?v=4)](https://github.com/KaramNassar "KaramNassar (3 commits)")[![emmanpbarrameda](https://avatars.githubusercontent.com/u/67356375?v=4)](https://github.com/emmanpbarrameda "emmanpbarrameda (1 commits)")[![HafizMDanish](https://avatars.githubusercontent.com/u/69752748?v=4)](https://github.com/HafizMDanish "HafizMDanish (1 commits)")[![edeoliv](https://avatars.githubusercontent.com/u/76831154?v=4)](https://github.com/edeoliv "edeoliv (1 commits)")

---

Tags

laravelfilament-general-settingsmattakorn-limkool

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/mattakorn-limkool-filament-general-settings/health.svg)

```
[![Health](https://phpackages.com/badges/mattakorn-limkool-filament-general-settings/health.svg)](https://phpackages.com/packages/mattakorn-limkool-filament-general-settings)
```

###  Alternatives

[joaopaulolndev/filament-general-settings

Filament package to manage general settings

18129.7k](/packages/joaopaulolndev-filament-general-settings)[joaopaulolndev/filament-edit-profile

Filament package to edit profile

250258.1k34](/packages/joaopaulolndev-filament-edit-profile)[guava/filament-knowledge-base

A filament plugin that adds a knowledge base and help to your filament panel(s).

206120.5k1](/packages/guava-filament-knowledge-base)[marcelweidum/filament-expiration-notice

Customize the livewire expiration notice

9169.0k4](/packages/marcelweidum-filament-expiration-notice)[guava/filament-modal-relation-managers

Allows you to embed relation managers inside filament modals.

7565.0k4](/packages/guava-filament-modal-relation-managers)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
