SilverStripe Maintenance Mode Module. Allows an administrator to put site in offline mode with 503 status to display a 'Coming Soon', 'Under Construction' or 'Down for Maintenance' Page to regular visitors, whilst allowing a logged in admin user to browse and make changes to the site.
Maintainance/Offline Mode Module for SilverStripe. Allows an
administrator to put site in offline mode with 503 status to display a
'Coming Soon', 'Under Construction' or 'Down for Maintenance' Page to
regular visitors, whilst allowing a logged in admin user to browse and
make changes to the site.
<darrenleejoseph (at) gmail (dot) com>
This branch will aim for compatibility with SilverStripe 4.x.
For SilverStripe 3.x, please see the compatible branch.
Installation can be done either by composer or by manually downloading a release.
composer require "dljoseph/silverstripe-maintenance-mode:*"
<yoursite.com>/dev/build/?flushto rebuild the database.
A "Maintenance Mode" checkbox will be added to the SiteConfig Access settings;
from there you can activate maintenance mode to take the site offline - and a
new Utility Page will be added to the SiteTree in the Pages section of the CMS.
You can edit the content of the Utility Page and/or manually override which
theme template SilverStripe uses to render the page for display.
To override the default UtilityPage template, add a template called
UtilityPage.ss in the templates folder of your theme (above Layouts) and then
flush the template cache.
If you wish to use a different template for the UtilityPage, there are no
restrictions, simply create a new SilverStripe template file, be sure to place
it directly in the templates folder (above Layouts) and visit /?flush
to flush the template cache. Afterwards, you must go to the UtilityPage in the
CMS and select the manually select the template from the dropdown to tell
SilverStripe which template to use to render the page for display.
By default, the current functionality is to redirect users to a separate URL which you can configure within the CMS (e.g.
/offline/), however it may be useful for you to simply display the maintenance message at any URL that the user may visit (to ensure user does not lose the page that they're currently at, in case maintenance window is very short).
To disable redirects, drop the following lines into your site's
UtilityPage: DisableRedirect: true
You can toggle maintenance mode either
off via the command line easily by simply running the
MaintenanceMode task. For example:
# Via Sake: sake dev/tasks/MaintenanceMode on # Via the CLI script directly: php framework/cli-script.php dev/tasks/MaintenanceMode on
You can configure the module to also allow specific IP addresses pass the maintenance page.
To add IP's add the following lines into your site's
Page_Controller: allowed_ips: - '127.0.0.1' - '::1'
There are no known issues.
Module rating system helping users find modules that are well supported. For more on how the rating system works visit Module standards
Score not correct? Let us know there is a problem