Skip to main content

​
Introduction

While Filament comes with virtually any tool you’ll need to build great apps, sometimes you’ll need to add your own functionality either for just your app or as redistributable packages that other developers can include in their own apps. This is why Filament offers a plugin system that allows you to extend its functionality. Before we dive in, it’s important to understand the different contexts in which plugins can be used. There are two main contexts:
  1. Panel Plugins: These are plugins that are used with Panel Builders. They are typically used only to add functionality when used inside a Panel or as a complete Panel in and of itself. Examples of this are:
    1. A plugin that adds specific functionality to the dashboard in the form of Widgets.
    2. A plugin that adds a set of Resources / functionality to an app like a Blog or User Management feature.
  2. Standalone Plugins: These are plugins that are used in any context outside a Panel Builder. Examples of this are:
    1. A plugin that adds custom fields to be used with the Form Builders.
    2. A plugin that adds custom columns or filters to the Table Builders.
Although these are two different mental contexts to keep in mind when building plugins, they can be used together inside the same plugin. They do not have to be mutually exclusive.

​
Important concepts

Before we dive into the specifics of building plugins, there are a few concepts that are important to understand. You should familiarize yourself with the following before building a plugin:
  1. Laravel Package Development
  2. Spatie Package Tools
  3. Filament Asset Management

​
The Plugin object

Filament introduces the concept of a Plugin object that is used to configure the plugin. This object is a simple PHP class that implements the Filament\Contracts\Plugin interface. This class is used to configure the plugin and is the main entry point for the plugin. It is also used to register Resources and Icons that might be used by your plugin. While the plugin object is extremely helpful, it is not required to build a plugin. You can still build plugins without using the plugin object as you can see in the building a panel plugin tutorial.
The Plugin object is only used for Panel Providers. Standalone Plugins do not use this object. All configuration for Standalone Plugins should be handled in the plugin’s service provider.

​
Registering assets

Register assets shared by standalone components, including lazily loaded CSS, JavaScript, and Alpine components, in the plugin service provider’s packageBooted() method. For assets that should load on every page of a particular panel, use $panel->assets() in the plugin object’s register() method. This avoids loading panel-specific assets in panels that do not use your plugin.

​
Creating a plugin

While you can certainly build plugins from scratch, we recommend using the Filament Plugin Skeleton to quickly get started. This skeleton includes all the necessary boilerplate to get you up and running quickly.

​
Usage

To use the skeleton, simply go to the GitHub repo and click the “Use this template” button. This will create a new repo in your account with the skeleton code. After that, you can clone the repo to your machine. Once you have the code on your machine, navigate to the root of the project and run the following command:
This will ask you a series of questions to configure the plugin. Once you’ve answered all the questions, the script will stub out a new plugin for you, and you can begin to build your amazing new extension for Filament.

​
Upgrading existing plugins

To update a plugin from Filament 3 to 4, follow the upgrade guide for the packages your plugin uses. Update its Composer constraints and test it in a Filament 4 application, including any custom views, styles, and JavaScript. Please read this guide in its entirety before upgrading your plugin. It will help you understand the concepts and how to build your plugin.
  1. Filament Asset Management
  2. Panel Plugin Development
  3. Icon Management
  4. Colors Management
  5. CSS Hooks