BugWP logo BugWP
Back to Community
Home / Community / Plugin → Maintenance

Resolving Admin Bar and WooCommerce Password Link Conflicts with the Maintenance Plugin

22 threads Sep 16, 2025 Plugin → Maintenance

Content

Many WordPress users rely on the Maintenance plugin to create elegant coming soon and maintenance mode pages. However, a review of community support threads reveals two recurring issues that can cause significant headaches: unexpected Admin Bar behavior and broken WooCommerce password reset links.

This guide will explain why these problems occur and provide the most effective solutions, based on community-discovered fixes and official plugin updates.

Common Problem 1: Unwanted Admin Bar Display

The Problem: Users report that the WordPress Admin Bar appears for all user roles (including customers and subscribers) when the Maintenance plugin is active, even if they have code in their theme's functions.php file or user profile settings meant to hide it.

Why It Happens: The Maintenance plugin has its own setting to control the Admin Bar. Historically, this setting could override a site's default behavior. The plugin's function hooks into the show_admin_bar filter, and depending on its configuration and the user's role, it can force the bar to be visible.

How to Fix It:

  1. Check the Plugin's Setting: The first and easiest step is to navigate to Maintenance → Settings in your WordPress dashboard. Look for an option labeled "Show admin bar" or similar and ensure it is unchecked. This is the most common solution.
  2. Plugin Version Matters: Some older versions of the plugin had a bug where this setting did not save correctly. If toggling the setting doesn't work, ensure your plugin is updated to the latest version.
  3. User Role Conflicts: In some cases, particularly with WooCommerce 'customer' roles, the plugin's logic for determining who sees the Admin Bar may need adjustment. If the problem persists after checking the setting, it may require a code update from the plugin developers.

Common Problem 2: WooCommerce Password Reset Links Break

The Problem: When the Maintenance plugin is active (even if maintenance mode is turned OFF), the "Lost your password?" link on the WooCommerce My Account page stops pointing to the custom WooCommerce page (/my-account/lost-password/) and instead redirects users to the default WordPress login URL (/wp-login.php?action=lostpassword). This is a poor user experience for customers.

Why It Happens: This is a technical conflict. The Maintenance plugin hooks into the lostpassword_url filter with a very high priority (often 999). This hook is always active while the plugin is installed and activated, not just when maintenance mode is enabled. It intercepts the URL generation process before WooCommerce can, resulting in the wrong link.

How to Fix It:

  1. Update the Plugin: The Maintenance team has acknowledged this bug and released fixes in newer versions (e.g., version 2.7.1 and later). Updating the plugin to the latest version is the recommended and most reliable solution.
  2. Temporary Workaround: If an update is not immediately available or does not resolve the issue for your specific setup, the only surefire workaround is to deactivate the Maintenance plugin until you actually need to put your site into maintenance mode. This confirms the plugin's hook is the source of the conflict.

By understanding the root causes of these issues—a plugin setting that overrides site defaults and an overly aggressive filter hook—you can quickly diagnose and resolve them. Always ensure you are running the latest version of the Maintenance plugin to benefit from past bug fixes.

Related Support Threads Support