WPMazic WPMazic

Maintenance Mode

Product: Admin Framework Pro

The Maintenance Mode module lets you display a customizable maintenance page while working on your WordPress site. It replaces normal pages for visitors, optionally restricts wp-admin access, and includes branding options for headline, text, logo, and background—making downtime clear and professional.

How to use

To enable the Maintenance Mode module:

  1. Click on the “Admin Tools” category
  2. Search or scroll to locate the Maintenance Mode module
  3. Click on the switch to enable

Use the “Preview” link in the module header to view the maintenance page without logging out.

What’s next?

When active, this module shows a customizable maintenance page to visitors and can restrict wp-admin access for non-authorized users. You can customize headline, body, footer, logo, and background styles.

Where it applies:

  • Front end: Replaces normal pages with a maintenance screen for visitors
  • Admin: Optionally redirects unauthorized users from wp-admin during maintenance
  • Admin bar: Shows a notice when maintenance is active

1. Customize the maintenance page

  1. Go to the module’s “Customisation” tab
  2. Configure:
    • Headline Settings:
      • Headline text, color
    • Body Settings:
      • Body text (rich editor), color
    • Footer Settings:
      • Footer text, color
    • Logo Settings:
      • Enable Logo (Yes/No), Logo image, Logo width (px)
    • Background Settings:
      • Background color
      • Enable Background Image and choose image (optional)
  3. Save settings
  4. Click “Preview” in the module header links to verify

Notes:

  • The page title and meta description default to “Maintenance Mode” with your site name; can be extended in Pro
  • Background image overlays the background color if enabled

2. Control who can access the site (Pro)

  • Choose the maintenance type/status (e.g., “Maintenance Mode (503)”)
  • Configure who can bypass the page (e.g., by user roles)
  • Add custom CSS injected into the maintenance page head
  • Select additional layouts (if provided)

Best Practices

  • Use 503 status for genuine maintenance to inform search engines the downtime is temporary
  • Whitelist appropriate roles (e.g., Administrators) so your team can continue working
  • Keep the page concise: clear headline, short message, and light styling

Troubleshooting

  • Still seeing the normal site:
    • Ensure the module is enabled
    • Clear caches (page, CDN, browser)
    • In Pro, confirm “is active” conditions and allowed roles aren’t bypassing the page
  • Locked out of wp-admin:
    • Log in as a user with the correct role (Pro), or temporarily disable the module via file access if needed
  • Styles not applying:
    • Verify colors/images are saved
    • If using Pro custom CSS, confirm it’s valid and preview again

Compatibility & Notes

  • Outputs a full-page template with optional logo and background image
  • Includes an admin bar indicator when active
  • Provides a one-click Preview link
  • Sends appropriate headers for maintenance (configurable in Pro)

Developer hooks

  • Filters:
    • WPMazic/maintenance-mode/is_active — programmatically toggle maintenance mode
    • WPMazic/maintenance-mode/show_maintenance_page — decide when to show the page
    • WPMazic/maintenance-mode/layout_data — extend layout data passed to the template
    • WPMazic/maintenance-mode/layout — choose/override layout file
    • WPMazic/maintenance-mode/page_header — set response status and headers (e.g., 503)
    • WPMazic/maintenance-mode/admin_bar_title — customize admin bar label
    • WPMazic/maintenance-mode/header_links — add header action links (e.g., Preview)
    • WPMazic/maintenance-mode/register_settings (Pro) — extend settings schema
    • WPMazic/maintenance-mode/user_roles (Pro) — alter selectable roles
  • Actions:
    • WPMazic/maintenance-mode/head — print assets or CSS in the
    • WPMazic/maintenance-mode/before_footer and WPMazic/maintenance-mode/after_footer — extend the page content

This module is perfect for:

  • Temporary maintenance windows and safe deployments
  • “Coming soon” or staged rollouts (with Pro controls)
  • Displaying a branded downtime message