PHPackages                             mt-settings/laravel-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 &amp; Helpers](/categories/utility)
4. /
5. mt-settings/laravel-settings

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

mt-settings/laravel-settings
============================

A simple settings management system for Laravel applications with RTL support

v1.0.0(1y ago)00MITPHPPHP ^8.1|^8.2

Since May 8Pushed 1y ago1 watchersCompare

[ Source](https://github.com/mahmoudtrageh/mt-settings)[ Packagist](https://packagist.org/packages/mt-settings/laravel-settings)[ RSS](/packages/mt-settings-laravel-settings/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

Laravel Settings
================

[](#laravel-settings)

A simple and elegant settings management system for Laravel applications.

[![Laravel Settings](https://camo.githubusercontent.com/021092c0a7af21205e835c52afbf738b80b61b1ec2cf61da0049e8752f3928d6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d53657474696e67732d7265642e737667)](https://camo.githubusercontent.com/021092c0a7af21205e835c52afbf738b80b61b1ec2cf61da0049e8752f3928d6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d53657474696e67732d7265642e737667)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)[![Version](https://camo.githubusercontent.com/7526daf42e824e3c4cda02602bf8c2240cbfb8fac41f5751142651ce8fe496f1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302d677265656e2e737667)](https://camo.githubusercontent.com/7526daf42e824e3c4cda02602bf8c2240cbfb8fac41f5751142651ce8fe496f1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302d677265656e2e737667)

✨ Features
----------

[](#-features)

- 🚀 Easy to install and use
- 🔒 Secure and optimized for performance
- 💾 Cached settings for better performance
- 🧩 Organized settings by categories
- 🔄 Simple API to get/set settings in your application

📦 Installation
--------------

[](#-installation)

You can install the package via composer:

```
composer require mt-settings/laravel-settings
```

### Manual Installation

[](#manual-installation)

1. Publish the configuration:

```
php artisan vendor:publish --tag=laravel-settings-config
```

2. Publish the migrations:

```
php artisan vendor:publish --tag=laravel-settings-migrations
```

3. Run the migrations:

```
php artisan migrate
```

📝 Usage
-------

[](#-usage)

### In Controllers

[](#in-controllers)

```
use MtSettings\LaravelSettings\Facades\Settings;

// Get a setting with a default value
$siteName = Settings::get('site_name', 'Default Site Name');

// Set a setting
Settings::set('maintenance_mode', true);

// Check if a setting exists
if (Settings::has('meta_title')) {
    // Do something
}

// Get all settings
$allSettings = Settings::getAll();

// Clear settings cache
Settings::clearCache();
```

### In Blade Templates

[](#in-blade-templates)

```
{{-- Get a setting with a default value --}}
{{ Settings::get('site_name', config('app.name')) }}

{{-- Check if a setting exists and use it --}}
@if(Settings::has('meta_description'))

@endif

{{-- Use a setting with a condition --}}
@if(Settings::get('maintenance_mode', false))

        The site is currently in maintenance mode

@endif
```

### Admin Panel

[](#admin-panel)

The package includes a complete admin panel for managing settings. By default, it's accessible at:

```
/admin/settings

```

You can customize the route prefix and middleware in the configuration file.

⚙️ Configuration
----------------

[](#️-configuration)

You can customize the package behavior by modifying the published configuration file:

```
// config/settings.php

return [
    'route_prefix' => 'admin',
    'middleware' => ['web', 'auth'],
    // ...
];
```

📋 Available Settings
--------------------

[](#-available-settings)

The package comes with predefined settings categories:

CategorySettings**General**site\_name, items\_per\_page, maintenance\_mode**SEO**meta\_title, meta\_description, meta\_keywords**Contact**contact\_email, phone\_number, address**Social Media**facebook\_url, twitter\_url, instagram\_url, linkedin\_url**Advanced**cache\_enabled, cache\_expiration, google\_analytics\_id, custom\_header\_scripts### General

[](#general)

- **site\_name**: Your site name
- **items\_per\_page**: Default number of items per page
- **maintenance\_mode**: Enable/disable maintenance mode

### SEO

[](#seo)

- **meta\_title**: Default meta title
- **meta\_description**: Default meta description
- **meta\_keywords**: Default meta keywords

### Contact

[](#contact)

- **contact\_email**: Contact email address
- **phone\_number**: Contact phone number
- **address**: Physical address

### Social Media

[](#social-media)

- **facebook\_url**: Facebook page URL
- **twitter\_url**: Twitter profile URL
- **instagram\_url**: Instagram profile URL
- **linkedin\_url**: LinkedIn profile URL

### Advanced

[](#advanced)

- **cache\_enabled**: Enable/disable settings cache
- **cache\_expiration**: Cache expiration time in seconds
- **google\_analytics\_id**: Google Analytics tracking ID
- **custom\_header\_scripts**: Custom scripts to include in the header

🎨 Customization
---------------

[](#-customization)

### Views

[](#views)

If you published the views, you can customize them at:

```
resources/views/vendor/laravel-settings

```

### Translations

[](#translations)

The package supports translations through Laravel's localization system. To publish translations:

```
php artisan vendor:publish --tag=laravel-settings-translations
```

🧪 Testing
---------

[](#-testing)

```
composer test
```

📄 License
---------

[](#-license)

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

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance49

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

375d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2b58e628f5e6b5879369492b9888777502dfd8963f0ec62c5d2924ff7c3fd4c8?d=identicon)[mahmoudtrageh](/maintainers/mahmoudtrageh)

---

Top Contributors

[![mahmoudtrageh](https://avatars.githubusercontent.com/u/46347515?v=4)](https://github.com/mahmoudtrageh "mahmoudtrageh (6 commits)")

### Embed Badge

![Health badge](/badges/mt-settings-laravel-settings/health.svg)

```
[![Health](https://phpackages.com/badges/mt-settings-laravel-settings/health.svg)](https://phpackages.com/packages/mt-settings-laravel-settings)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[orchestra/canvas

Code Generators for Laravel Applications and Packages

21017.2M158](/packages/orchestra-canvas)[illuminate/pipeline

The Illuminate Pipeline package.

9446.6M213](/packages/illuminate-pipeline)[illuminate/pagination

The Illuminate Pagination package.

10532.5M862](/packages/illuminate-pagination)[spatie/laravel-pjax

A pjax middleware for Laravel 5

513371.8k11](/packages/spatie-laravel-pjax)[spatie/laravel-mix-preload

Add preload and prefetch links based your Mix manifest

169176.0k2](/packages/spatie-laravel-mix-preload)

PHPackages © 2026

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