Stable tag: 0.3.1
Requires at least: 5.9
Tested up to: 6.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: maintenance-mode, maintenance
Contributors: wpcomvip, automattic, benoitchantre, emrikol, philipjohn, GaryJ
Shut down your site for a little while and do some maintenance on it!
Easily provide a holding maintenance page, including with a custom template, to site visitors.
To add a custom template and messaging:
- Create a template in your theme's root folder named
template-maintenance-mode.php
. - This should be a simple HTML page that includes the message you want to show your visitors.
- Note: the template should include
wp_head()
andwp_footer()
calls.
You can also use the vip_maintenance_mode_template_args
filter to adjust the file name and location of the custom template within your theme.
For instance, if you want it to live at wp-content/themes/my-theme/plugin-templates/maintenance-mode-alt.php
, then add code like:
add_filter(
'vip_maintenance_mode_template_args',
function( $args ) {
$args['slug'] = 'plugin-templates/maintenance-mode';
$args['name'] = 'alt';
return $args;
}
);
This also allows the third array key to be used to pass in custom arguments to the template.
Using filters and conditionals, you can customize the behavior of the Maintenance Mode plugin based on your needs. These options rely on the plugin being installed as described above.
Configure Maintenance Mode to only display for a specific network site. Code similar to this example must be added to the vip-config/vip-config.php
file:
$site_name = $_SERVER['SERVER_NAME'];
$lockdown = false;
if ( false !== strpos( $site_name, 'url-to-enable-maintentance-mode' ) ) {
// Set lockdown
$lockdown = true;
}
// Set maintenance plugin
define( 'VIP_MAINTENANCE_MODE', $lockdown );
Configure Maintenance Mode to keep the WordPress REST API enabled even though the rest of the site is not accessible. Note that this code should be added to a file located within the client-mu-plugins
directory:
// Generally allow API access
add_filter( 'vip_maintenance_mode_restrict_rest_api', '__return_false' );
You can also choose to enable the REST API only in more narrow use-cases:
add_filter( 'vip_maintenance_mode_restrict_rest_api', 'x_mm_allow_api' );
function x_mm_allow_api( $default ) {
if ( my_check() ) {
return false;
}
return true;
}
- Add the plugin to the
/plugins
directory of an application's GitHub repository. - Define the
VIP_MAINTENANCE_MODE
constant as true invip-config/vip-config.php
. - Activate the plugin in the WordPress Admin dashboard Plugins screen.
See the changelog.