Download the PHP package carlcs/craft-maintenance without Composer
On this page you can find all versions of the php package carlcs/craft-maintenance. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package craft-maintenance
Maintenance plugin for Craft CMS
The plugin provides tools to help you do maintenance on your Craft CMS website:
- Display a “Maintenance in progress” overlay in the Control Panel when the site is undergoing scheduled maintenance
- Announce upcoming maintenance on the dashboard and with notification banners
- Leave your users (maintenance related) messages on the dashboard widget
- Access maintenance related info from your templates using the provided template variables
Installation
The plugin is available on Packagist and can be installed using Composer. You can also download the latest release and copy the files into craft/plugins/maintenance/.
Maintenance Announcements
Set up maintenance announcements or messages from the plugin’s settings page. You can use markdown to add links, or to format the message. To configure scheduled maintenance you have to set a start date in the announcement’s settings and enable “Frontend Maintenance”.
Create a new “Maintenance Announcements” widget to display all notifications on the users’ Dashboards. Upcoming maintenance will also be announced with a banner notification.
Maintenance Modes
When backend maintenance mode is active, users navigating the Control Panel will be shown a full screen “Maintenance in progress” overlay. It informs them about the undergoing maintenance, in order to prevent from useless data entry.
The frontend maintenance mode redirects all (frontend) requests to /503, your “service unavailable” page. You can exclude URLs from being redirected and whitelist visitor IP addresses in the plugin settings.
Note: the plugin doesn’t do “content freeze” in a way, that it actually prevents data from being saved or changed in the database. That being said, there are template variables and plugins API provided.
Settings
The plugin can be configured from a craft/config/maintenance.php config file or from Settings/Maintenance.
In Settings/Users you can assign user permissions to configure the “Maintenance in progress” overlay or to grant access for individual user groups while frontend maintenance is carried out.
Template Variables
The plugin provides template variables to get the active announcement model, or to check whether the site is currently undergoing maintenance.
isCpMaintenance
Returns whether the Control Panel is currently undergoing maintenance.
isSiteMaintenance
Returns whether the site is currently undergoing maintenance.
getAnnouncement( timeInAdvance )
Returns the latest, either currently active or soon to be activated maintenance announcement.
Planned features
- Quick set up maintenance via environment variable