PHPackages                             bezhansalleh/filament-plugin-essentials - 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. [Framework](/categories/framework)
4. /
5. bezhansalleh/filament-plugin-essentials

ActiveLibrary[Framework](/categories/framework)

bezhansalleh/filament-plugin-essentials
=======================================

A collection of essential traits that streamline Filament plugin development by taking care of the boilerplate, so you can focus on shipping real features faster

1.2.1(1mo ago)27584.7k—0.8%14[1 PRs](https://github.com/bezhanSalleh/filament-plugin-essentials/pulls)11MITPHPPHP ^8.2|^8.3CI passing

Since Jul 12Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/bezhanSalleh/filament-plugin-essentials)[ Packagist](https://packagist.org/packages/bezhansalleh/filament-plugin-essentials)[ Docs](https://github.com/bezhansalleh/filament-plugin-essentials)[ GitHub Sponsors](https://github.com/bezhanSalleh)[ RSS](/packages/bezhansalleh-filament-plugin-essentials/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (32)Versions (7)Used By (11)

[![filament-plugin-essentials-art](https://repository-images.githubusercontent.com/1014100295/abe541e0-1f7e-4c9d-9120-ad49806f15b1)](https://github.com/bezhansalleh/filament-plugin-essentials) [ ![FILAMENT 4.x](https://camo.githubusercontent.com/13befbe0cffd101b2484ce1cdd985dabcddcbf1176d17a675674d53af99cfdbc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46494c414d454e542d342e782d4542423330343f7374796c653d666f722d7468652d6261646765) ](https://filamentphp.com/docs/4.x/introduction/installation) [ ![FILAMENT 5.x](https://camo.githubusercontent.com/3ec960aa304b803da9f1192f01e82da976a3d220ea85931fec930003e0532c77/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46494c414d454e542d352e782d4542423330343f7374796c653d666f722d7468652d6261646765) ](https://filamentphp.com/docs/5.x/introduction/installation) [ ![Packagist](https://camo.githubusercontent.com/619c9acd905e16f7465db48d3538a258037d2b5df61d7e311a7eb7733de26f22/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62657a68616e73616c6c65682f66696c616d656e742d706c7567696e2d657373656e7469616c732e7376673f7374796c653d666f722d7468652d6261646765266c6f676f3d7061636b6167697374) ](https://packagist.org/packages/bezhansalleh/filament-plugin-essentials) [ ![Tests Passing](https://camo.githubusercontent.com/9399a09b514ae7ea5796af8a1cc242b2192f54ed9dd0e426d2a00ca849f0dfc3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f62657a68616e73616c6c65682f66696c616d656e742d706c7567696e2d657373656e7469616c732f72756e2d74657374732e796d6c3f7374796c653d666f722d7468652d6261646765266c6f676f3d676974687562266c6162656c3d7465737473) ](https://github.com/bezhansalleh/filament-plugin-essentials/actions?query=workflow%3Arun-tests+branch%3Amain) [ ![Code Style Passing](https://camo.githubusercontent.com/685a260a01846b3f28d10647fd481cfb7d89aeb6579b72e4a16b7c2b114ccd8f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f62657a68616e73616c6c65682f66696c616d656e742d706c7567696e2d657373656e7469616c732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f7374796c653d666f722d7468652d6261646765266c6f676f3d676974687562266c6162656c3d636f64652532307374796c65) ](https://github.com/bezhansalleh/filament-plugin-essentials/actions?query=workflow%3A)[ ![Downloads](https://camo.githubusercontent.com/a279e91f53c5e87b3e2c5ba2184d8399eae1a57bfea0cf9ba1eb70c09b4edb42/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f62657a68616e73616c6c65682f66696c616d656e742d706c7567696e2d657373656e7469616c732e7376673f7374796c653d666f722d7468652d6261646765) ](https://packagist.org/packages/bezhansalleh/filament-plugin-essentials)

Filament Plugin Essentials
==========================

[](#filament-plugin-essentials)

A collection of essential traits that streamline Filament plugin development by taking care of the boilerplate, so you can focus on shipping real features faster

Table of Contents
-----------------

[](#table-of-contents)

- [Filament Plugin Essentials](#filament-plugin-essentials)
    - [Table of Contents](#table-of-contents)
    - [Features](#features)
    - [Requirements](#requirements)
    - [Installation](#installation)
    - [For Plugin Developers](#for-plugin-developers)
        - [1. Add traits to your plugin class](#1-add-traits-to-your-plugin-class)
        - [2. Add matching traits to your forResource classes](#2-add-matching-traits-to-your-forresource-classes)
        - [3. Set defaults for your plugin (optional)](#3-set-defaults-for-your-plugin-optional)
    - [How Plugin Users Can Configure Your Plugin](#how-plugin-users-can-configure-your-plugin)
        - [Multi-forResource configuration](#multi-forresource-configuration)
        - [Dynamic values with closures](#dynamic-values-with-closures)
    - [Plugin & Resource Trait Mapping](#plugin--resource-trait-mapping)
    - [Configuration Options Provided by Each Trait](#configuration-options-provided-by-each-trait)
        - [`HasNavigation`](#hasnavigation)
        - [`HasLabels`](#haslabels)
        - [`HasGlobalSearch`](#hasglobalsearch)
        - [`BelongsToParent`](#belongstoparent)
        - [`BelongsToTenant`](#belongstotenant)
        - [`WithMultipleResourceSupport`](#withmultipleresourcesupport)
    - [Todo](#todo)
    - [Testing](#testing)
    - [Changelog](#changelog)
    - [Contributing](#contributing)
    - [Security Vulnerabilities](#security-vulnerabilities)
    - [Credits](#credits)
    - [License](#license)

Features
--------

[](#features)

- **Easily Configure**
    - **🎯 Navigation** - Complete control over resource navigation (labels, icons, groups, sorting, badges)
    - **🏷️ Label** - Model labels, plural forms, title attributes, and casing options
    - **🔍 Global Search** - Searchability controls, result limits, and case sensitivity options
    - **👥 Resource Tenant options** - Tenant scoping and relationship configuration
    - **🔗 Parent Resource** - Hierarchical resource relationships
- **⚙️ Multi-Resource Configuration** - Different settings per `Resource` in a single plugin
- **📦 3-Tier Default System** - User overrides → Plugin defaults → Filament defaults
- **🔄 Dynamic Values** - Closure support for conditional logic and real-time data
- **🛠️ Developer-Friendly** - Minimal boilerplate with maximum customization

Requirements
------------

[](#requirements)

- Filament [4.x](https://filamentphp.com/docs/4.x/introduction/installation) & [5.x](https://filamentphp.com/docs/5.x/introduction/installation)
- PHP 8.2+

Installation
------------

[](#installation)

```
composer require bezhansalleh/filament-plugin-essentials
```

For Plugin Developers
---------------------

[](#for-plugin-developers)

### 1. Add traits to your plugin class

[](#1-add-traits-to-your-plugin-class)

```