PHPackages ninshiki-project/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. [Utility & Helpers](/categories/utility) 4. / 5. ninshiki-project/general-settings ActiveLibrary[Utility & Helpers](/categories/utility) ninshiki-project/general-settings ================================= Filament package to manage general settings 1.0.7(1y ago)08901MITPHPPHP ^8.1 Since Feb 9Pushed 1y agoCompare [ Source](https://github.com/ninshiki-project/general-settings)[ Packagist](https://packagist.org/packages/ninshiki-project/general-settings)[ Docs](https://github.com/ninshiki-project/general-settings)[ RSS](/packages/ninshiki-project-general-settings/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (8)Dependencies (13)Versions (9)Used By (1) Filament General Settings ========================= [](#filament-general-settings) Create really fast and easily general settings for your Laravel Filament project. This is heavily customized for [ninshiki-project/Ninshiki-backend-community](https://github.com/ninshiki-project/Ninshiki-backend-community) [![Screenshot of Application Feature](https://raw.githubusercontent.com/joaopaulolndev/filament-general-settings/main/art/joaopaulolndev-filament-general-settings.jpg)](https://raw.githubusercontent.com/joaopaulolndev/filament-general-settings/main/art/joaopaulolndev-filament-general-settings.jpg) Installation ------------ [](#installation) You can install the package via composer: ``` composer require ninshiki-project/general-settings ``` You can publish and run the migrations with: ``` php artisan vendor:publish --tag="general-settings-migrations" php artisan migrate ``` You can publish the config file with: ``` php artisan vendor:publish --tag="general-settings-config" ``` Optionally, you can publish the views using ``` php artisan vendor:publish --tag="general-settings-views" ``` Optionally, you can publish the translations using ``` php artisan vendor:publish --tag="general-settings-translations" ``` Optionally, you can publish the assets using. Ex: to show images in default email providers. ``` php artisan vendor:publish --tag="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 ninshikiProject\GeneralSettings\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="general-settings-migrations" php artisan migrate ``` 2. Publish the configuration file: ``` php artisan vendor:publish --tag="general-settings-config" ``` 3. Open the published configuration file config/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 ninshikiProject\GeneralSettings\GeneralSettingsPlugin; ... ->plugins([ GeneralSettingsPlugin::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: ``` ->plugins([ GeneralSettingsPlugin::make() ->canAccess(fn() => auth()->user()->id === 1) ->setSort(3) ->setIcon('heroicon-o-cog') ->setNavigationGroup('Settings') ->setTitle('General Settings') ->setNavigationParentItem('Settings') ->setNavigationLabel('General Settings'), ]) ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Credits ------- [](#credits) - Original Developer: [João Paulo Leite Nascimento](https://github.com/joaopaulolndev) - Original Package Repo: License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 34 — LowBetter than 77% of packages Maintenance45 Moderate activity, may be stable Popularity16 Limited adoption so far Community16 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 55.8% of commits — single point of failure 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 ~4 days Total 8 Last Release 432d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/2fe4f462400792289dae3a62fc6af21c37ff3c59f80d108ffa436b7eaf1b7a90?d=identicon)[marjose](/maintainers/marjose) --- Top Contributors [![joaopaulolndev](https://avatars.githubusercontent.com/u/11706937?v=4)](https://github.com/joaopaulolndev "joaopaulolndev (43 commits)")[![MarJose123](https://avatars.githubusercontent.com/u/18107626?v=4)](https://github.com/MarJose123 "MarJose123 (16 commits)")[![zhinea](https://avatars.githubusercontent.com/u/79736504?v=4)](https://github.com/zhinea "zhinea (4 commits)")[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (4 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![KaramNassar](https://avatars.githubusercontent.com/u/43961632?v=4)](https://github.com/KaramNassar "KaramNassar (3 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (2 commits)")[![emmanpbarrameda](https://avatars.githubusercontent.com/u/67356375?v=4)](https://github.com/emmanpbarrameda "emmanpbarrameda (1 commits)")[![edeoliv](https://avatars.githubusercontent.com/u/76831154?v=4)](https://github.com/edeoliv "edeoliv (1 commits)") --- Tags laravelfilament-general-settingsninshiki-project ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/ninshiki-project-general-settings/health.svg) ``` [![Health](https://phpackages.com/badges/ninshiki-project-general-settings/health.svg)](https://phpackages.com/packages/ninshiki-project-general-settings) ``` ### Alternatives [joaopaulolndev/filament-general-settings Filament package to manage general settings 18129.7k](/packages/joaopaulolndev-filament-general-settings)[guava/calendar Adds support for vkurko/calendar to Filament PHP. 298241.0k3](/packages/guava-calendar)[bezhansalleh/filament-google-analytics Google Analytics integration for FilamentPHP 205144.8k5](/packages/bezhansalleh-filament-google-analytics)[jibaymcs/filament-tour Bring the power of DriverJs to your Filament panels and start a tour ! 12247.8k](/packages/jibaymcs-filament-tour)[marcelweidum/filament-expiration-notice Customize the livewire expiration notice 9169.0k4](/packages/marcelweidum-filament-expiration-notice)[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)