{"id":22866809,"url":"https://github.com/robertdevore/maintenance-mode-for-wordpress","last_synced_at":"2025-05-05T17:58:54.914Z","repository":{"id":267896610,"uuid":"888221428","full_name":"robertdevore/maintenance-mode-for-wordpress","owner":"robertdevore","description":"A free WordPress® plugin that enables a fully customizable maintenance mode with a dedicated landing page.","archived":false,"fork":false,"pushed_at":"2025-02-08T06:47:18.000Z","size":189,"stargazers_count":28,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-03T00:01:59.370Z","etag":null,"topics":["wordpress","wordpress-development","wordpress-plugin"],"latest_commit_sha":null,"homepage":"https://robertdevore.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robertdevore.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-11-14T02:43:51.000Z","updated_at":"2025-04-10T06:58:48.000Z","dependencies_parsed_at":"2025-02-08T07:23:57.374Z","dependency_job_id":"35fb6830-fc02-4df1-8ae9-a6712cfded87","html_url":"https://github.com/robertdevore/maintenance-mode-for-wordpress","commit_stats":null,"previous_names":["robertdevore/maintenance-mode-for-wordpress"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdevore%2Fmaintenance-mode-for-wordpress","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdevore%2Fmaintenance-mode-for-wordpress/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdevore%2Fmaintenance-mode-for-wordpress/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertdevore%2Fmaintenance-mode-for-wordpress/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robertdevore","download_url":"https://codeload.github.com/robertdevore/maintenance-mode-for-wordpress/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252548479,"owners_count":21766185,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["wordpress","wordpress-development","wordpress-plugin"],"created_at":"2024-12-13T12:17:07.190Z","updated_at":"2025-05-05T17:58:54.906Z","avatar_url":"https://github.com/robertdevore.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Maintenance Mode for WordPress®\n\nA free WordPress® plugin that enables a fully customizable **Maintenance Mode** and **Coming Soon Mode** with dedicated landing pages.\n\nBuilt with the WordPress® core editor, this plugin locks down access to the frontend for non-logged-in users while keeping administrators in control.\n\n## Features\n\n- **Custom Maintenance \u0026 Coming Soon Pages:** Create and edit pages using the WordPress block editor.\n- **Maintenance Mode (503 Status):** Displays a maintenance page and sends a `503 Service Unavailable` HTTP status to notify search engines of temporary downtime.\n- **Coming Soon Mode (200 Status):** Displays a coming soon page without restricting access to search engines, useful for pre-launch SEO.\n- **Admin-Only Access:** Allow logged-in administrators to bypass maintenance and coming soon mode.\n- **REST API Control:** Restrict REST API access for non-logged-in users during maintenance mode.\n- **Launch Scheduling:** Set an optional launch date for automatic mode deactivation.\n- **Customizable Frontend Appearance:** Use the block editor to style your maintenance or coming soon page.\n* * *\n\n## Installation\n\n1. Download the plugin files from the [GitHub repository](https://github.com/robertdevore/maintenance-mode-for-wordpress/).\n2. Upload the plugin to your WordPress® installation via **Plugins \u003e Add New \u003e Upload Plugin**.\n3. Activate the plugin via the **Plugins** screen in WordPress®.\n\n## Usage\n\n### 1. Enable Maintenance or Coming Soon Mode\n\n1. Navigate to **Maintenance \u003e Settings** in your WordPress® admin panel.\n2. Check the box for either:\n   - **Enable Maintenance Mode** (restricts site access with a `503` response).\n   - **Enable Coming Soon Mode** (displays a coming soon page with a `200` response).\n3. Only one mode can be active at a time.\n\n### 2. Set a Maintenance or Coming Soon Page\n\n1. Go to **Maintenance** in the WordPress® admin panel.\n2. Create or select a page using the block editor.\n3. Assign the page in **Maintenance \u003e Settings** under **Maintenance Mode Page**.\n\n### 3. Schedule a Launch Date (Optional)\n\n1. In **Maintenance \u003e Settings**, enter a date under **Launch Date**.\n2. Save your settings.\n\nIf a launch date is specified, the active mode will automatically end on that date.\n\n## Developer Notes\n\n### Actions and Filters\n\n- **Actions:**\n    - `template_redirect`: Restricts frontend access for non-logged-in users when maintenance mode is enabled.\n    - `rest_api_init`: Blocks REST API access for non-logged-in users during maintenance mode.\n- **Filters:**\n    - `the_content`: Used to render the content of the assigned maintenance or coming soon page.\n\n### Code Highlights\n\n- **Custom Post Type:**\n    - Maintenance \u0026 Coming Soon pages are created as a custom post type `maintenance_page`.\n    - They support title and editor fields.\n- **HTTP Status Codes:**\n    - **Maintenance Mode:** Sends a `503 Service Unavailable` status code to indicate temporary downtime.\n    - **Coming Soon Mode:** Sends a `200 OK` status code, allowing search engines to index the page.\n- **REST API Restriction:**\n    - Non-logged-in users receive a `403 Forbidden` response when attempting to access the REST API (only in Maintenance Mode).\n\n## FAQs\n\n### What's the difference between Maintenance Mode and Coming Soon Mode?\n\n- **Maintenance Mode:** Temporarily restricts access to your site and sends a `503` status code to prevent search engines from indexing during downtime.\n- **Coming Soon Mode:** Allows you to display a coming soon page **without** restricting search engine access (sends a `200` status).\n\n### Why can't I see the maintenance or coming soon page?\n\nMake sure you've assigned a published page under **Maintenance \u003e Settings \u003e Maintenance Mode Page**.\n\n### How do I bypass Maintenance or Coming Soon Mode?\n\nLog in to WordPress® as an administrator. The restrictions do not apply to logged-in users.\n\n### Will this affect my site's SEO?\n\n- **Maintenance Mode:** Sends a `503` status, notifying search engines that the downtime is temporary (recommended for short-term maintenance).\n- **Coming Soon Mode:** Sends a `200` status, allowing indexing (recommended for site pre-launch).\n\n## Troubleshooting\n\n1. **Settings Not Saving:**\n    - Ensure your WordPress installation has sufficient permissions to save plugin options.\n\n2. **REST API Issues:**\n    - Check that you are logged in as an administrator if you need REST API access during maintenance mode.\n\n3. **Maintenance Mode Not Enforcing a 503 Response:**\n    - Some caching plugins may interfere with HTTP response headers. Try clearing your cache.\n\n## Contributing\n\n1. Fork the repository on [GitHub](https://github.com/robertdevore/maintenance-mode-for-wordpress/).\n2. Create a feature branch for your changes.\n3. Submit a pull request for review.\n\n## License\n\nThis plugin is licensed under the [GPL-2.0+ License](http://www.gnu.org/licenses/gpl-2.0.txt).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertdevore%2Fmaintenance-mode-for-wordpress","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobertdevore%2Fmaintenance-mode-for-wordpress","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertdevore%2Fmaintenance-mode-for-wordpress/lists"}