build-mode/readme.txt at main · webtions/build-mode · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
=== Build Mode – Maintenance Mode & Coming Soon Page ===
Contributors: hchouhan, themeist
Donate link: https://themeist.com/plugins/build-mode/
Tags: maintenance mode, maintenance page, coming soon page, under construction, coming soon
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.1.0
Requires PHP: 7.4
License: GPL-3.0
License URI: http://www.gnu.org/licenses/gpl-3.0.txt

Maintenance Mode & Coming Soon Made Easy – Display any page as your maintenance or coming-soon screen, no coding required.

== Description ==

**Build Mode** lets you put your WordPress site into **maintenance mode** or display a **coming‑soon page** / **under‑construction page** with one click. Instead of a generic message, you can select and display any page you’ve built — with the Block Editor, Classic Editor, or a page builder. Visitors will see your chosen **maintenance or coming‑soon page**, styled using your theme’s CSS and JS, while logged‑in administrators continue working behind the scenes.

When Build Mode is active, only the content area of your chosen maintenance page is displayed. The header, footer and navigation are automatically removed.

### Features
- Enable or disable Build Mode from the **Admin Bar**
- Choose any page as your custom **maintenance**, **coming‑soon** or **under‑construction** screen
- **Five-Second Setup:** Click "Create Maintenance Page" to automatically generate a styled "Under Construction" page.
- Logged‑in admins bypass maintenance mode automatically
- Choose between **503 Service Unavailable** (maintenance windows) or **200 OK** (coming‑soon / teaser pages) — configurable via a simple setting
- Lightweight and secure, built with WordPress best practices
- Compatible with classic and block themes
- Translation‑ready

### Use cases
- Show a custom **under‑maintenance** or **coming‑soon** screen while you redesign or update your site
- Let search engines know your downtime is temporary with proper HTTP headers
- Keep working on your site privately without showing a broken layout to visitors

[Plugin Page on Themeist](https://themeist.com/plugins/build-mode/)
[GitHub Repo](https://github.com/webtions/build-mode)

https://www.youtube.com/watch?v=w8S94TE6FV4

== Screenshots ==

1. Plugin Settings - One-click maintenance page setup.
2. Block Editor - Customizing the maintenance page pattern.
3. Admin Bar - Quickly toggling Build Mode on/off.
4. Visitor View - What your users see (Maintenance/Coming Soon page).

== Installation ==

1. Go to **Plugins → Add New** in your WordPress dashboard.
2. Search for **Build Mode**, then click **Install Now** → **Activate**.
3. Go to **Settings → Build Mode**.
4. Click **Create Maintenance Page** (or select an existing page).
5. Check the **Enable Build Mode** box and click **Save**.

== Frequently Asked Questions ==

= Can I design my own maintenance or coming‑soon page? =
Yes — use any page built with the Block Editor, Classic Editor or a page builder.

= Will administrators still see the full site? =
Yes. Logged‑in users with the required capability (default: `manage_options`) bypass Build Mode.

= Does this impact SEO? =
By default, Build Mode sends **HTTP 503 + `Retry-After`** headers to signal temporary downtime. If you're running a coming‑soon or teaser page and want search engines to index it normally, uncheck **"Send 503 status code"** in the settings to serve a `200 OK` response instead.

= Can I use Build Mode for a coming‑soon or under‑construction page? =
Yes. By selecting a specific page in the plugin settings, you can show a custom coming‑soon or under‑construction screen while you build or redesign your site.

= Can editors manage Build Mode? =
By default, only Administrators can toggle it. Developers can change this using the `build_mode_capability` filter.

= For developers: are there filters available? =
Yes, Build Mode provides two filters.

1. `build_mode_capability` — Change the capability required to manage Build Mode.
   Example (allow Editors):
   ```
   add_filter( 'build_mode_capability', function () {
       return 'edit_pages';
   } );
   ```

2. `build_mode_retry_after` — Control the Retry‑After header value (in seconds).
   Default is 24 hours (`DAY_IN_SECONDS`). Example (set to 1 hour):
   ```
   add_filter( 'build_mode_retry_after', function () {
       return HOUR_IN_SECONDS;
   } );
   ```

= Where can I get help? =
You can ask your question in the [WordPress.org Support Forum](https://wordpress.org/support/plugin/build-mode/)

== Changelog ==

= 1.1.0 – (12 Apr 2026) =
* Feature: Added optional "Send 503 status code" setting — uncheck to serve a 200 OK response for coming-soon or teaser pages.
* Localization: Added Japanese, German, and Dutch translations.

= 1.0.0 – (5 Jan 2026) =
* Feature: Added "Create Maintenance Page" button for one-click setup.
* Feature: Added "Maintenance (Minimal)" block pattern.
* Enhancement: Improved settings UI with quick actions.

= 0.2.0 – (16 Dec 2025) =
* Fix: Allowed query strings in static asset URLs to prevent 404/MIME type errors.
* Feature: Added "Edit Page" shortcut link in settings.

= 0.1.0 – (8 Sep 2025) =
* Initial release