Download the PHP package brickx/maintenance-switch without Composer

Filament Maintenance Switch Plugin

This plugin allows you to easily toggle maintenance mode from your Filament Panels. You can also set a custom secret token to bypass the maintenance mode.

Table of contents

• Installation
• Setup
• Usage
  • Secret Token
  • Refresh Interval
  • Visibility
  • Placement
  • Theming

Installation

You can install the package via composer:

You can publish the config file with:

This is the contents of the published config file:

You can publish the translations with:

Optionally, you can publish the views using:

Setup

First, instantiate the plugin in your Panel's configuration:

Laravel 11 does not come with the PreventRequestsDuringMaintenance middleware any more. You can create one with:

Then fill it with the content below:

If you are using other versions of Laravel, you can just edit the existing one.

In Laravel 11, you also need to add this middleware to the relevant routes. Consider using route groups to control which routes to apply the middleware to.

Here is an example of ./routes/web.php:

Usage

The plugin will add a toggle button to your Filament Admin Panel, left to the global search bar.

Clicking it will trigger the php artisan down command if the website is live, and the php artisan up command otherwise.

Secret Token

You can set a secret token in the config file. If you do so, you will be able to bypass the maintenance mode by visiting the following URL: https://your-domain.test/{secret}.

If the secret key is set to null, a random one will be generated on the fly each time the maintenance mode is activated. Be sure to copy it somewhere, or you will have to manually trigger the php artisan up command if something goes wrong.

Refresh Interval

If you want to instruct browsers to refresh pages after a certain amount of time, you can set the refresh key in the config file.

When set to false, no Refresh HTTP header will be sent. You can specify an integer to define the number of seconds before reloading pages under maintenance mode.

Visibility

By default, any logged-in user will be able to toggle the maintenance mode.

If you want to restrict this feature to specific users, you can set the permissions key in the config file.

The plugin will use Laravel's default authorization system to check for permissions, via the can method on the User model. It will also work well with Spatie's Laravel Permission package.

Placement

The toggle button will be placed before the global search bar by default. If you want to change this, you can tweak the render_hook key in the config file.

You can use any of the render hooks provided by Filament.

Theming

The default styling of the toggle button will work well with the default Filament theme. However, for extra colors and further customization you can add this plugin's path to the content array of your panels' tailwind.config.js file:

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Keysaw
• All Contributors

License

The MIT License (MIT). Please see License File for more information.