diff --git a/DESIGN.md b/DESIGN.md
index c98aa03ac..a4b8f9535 100644
--- a/DESIGN.md
+++ b/DESIGN.md
@@ -31,6 +31,10 @@ page markup and scoped CSS together in the downloadable package.
- Guests see sign-in/recovery guidance, not empty private widgets. Exclude all
account/checkout routes from upstream caching as well as sending no-cache
headers. Presentation gating never replaces model ownership checks.
+- Guest sign-in and recovery preserve the validated local request path and query,
+ including selected-site and membership context; do not accept external returns.
+- Remove only completely empty example-owned card wrappers after native content
+ renders. Never hide populated cards based on internal widget class names.
Screenshot assets show synthetic data and actual rendered product states,
not reconstructed UI. Use viewport captures (at most 1568px on the longest
diff --git a/docs/user-guide/client-management/frontend-account-blocks.md b/docs/user-guide/client-management/frontend-account-blocks.md
index b4e7b7ce3..4727f086e 100644
--- a/docs/user-guide/client-management/frontend-account-blocks.md
+++ b/docs/user-guide/client-management/frontend-account-blocks.md
@@ -16,12 +16,21 @@ The page content remains editable block by block: change headings, move account
widgets, adjust their settings, or replace the surrounding layout with your own.
:::important Release compatibility
-The screenshots and verification use the native-block repairs proposed in
-[plugin PR #2086](https://github.com/Ultimate-Multisite/ultimate-multisite/pull/2086):
+The screenshots and verification use the native-block repairs from
+[plugin PR #2133](https://github.com/Ultimate-Multisite/ultimate-multisite/pull/2133),
+merged to `main` after v2.19.0 and shipping in the next release:
styled iframe previews, correctly typed settings, and early detection of settings
-inside Groups/Columns. Use the release containing these fixes on production.
+inside Groups/Columns. Use a release that includes them on production.
The block editor shows sample preview data, not the account of the administrator
editing the page. Test the published page as a customer before launch.
+
+**Payment Methods fatal error on v2.4.12 through v2.19.0.** The Payment Methods
+block calls a gateway method that does not exist. The editor preview looks normal,
+because its sample membership has no gateway, but the published page breaks with
+`Call to undefined method WP_Ultimo\Gateways\Free_Gateway::get_title()` for any
+customer whose membership has a payment gateway, including Free. Plugin PR #2133
+fixes it. Until you run a release that includes it, leave the Payment Methods block
+off the page.
:::
## 1. Insert the native account blocks
diff --git a/docs/user-guide/client-management/frontend-account-example-source.md b/docs/user-guide/client-management/frontend-account-example-source.md
index 66f34ebd4..c32eed2c5 100644
--- a/docs/user-guide/client-management/frontend-account-example-source.md
+++ b/docs/user-guide/client-management/frontend-account-example-source.md
@@ -20,7 +20,7 @@ build step is required. Do not put PHP in page content or edit Ultimate Multisit
/**
* Plugin Name: Ultimate Multisite Account Page Example
* Description: An optional presentation layer for native Ultimate Multisite shortcodes.
- * Version: 1.0.0
+ * Version: 1.0.1
* License: GPL-2.0-or-later
* Text Domain: ums-account-example
*/
@@ -47,9 +47,18 @@ add_action('template_redirect', function () {
add_action('wp_enqueue_scripts', function () {
if (ums_account_example_is_page()) {
- wp_enqueue_style('ums-account-example', plugins_url('portal.css', __FILE__), [], '1.0.0');
+ wp_enqueue_style('ums-account-example', plugins_url('portal.css', __FILE__), [], '1.0.1');
}
});
+
+add_filter('the_content', function ($content) {
+ if (!ums_account_example_is_page()) {
+ return $content;
+ }
+
+ // After blocks/shortcodes render, omit only our own completely empty cards.
+ return preg_replace('/
]*\sclass="[^"]*\bums-card\b[^"]*"[^>]*>\s*<\/div>/', '', $content);
+}, 20);
```
### `canvas.php`
@@ -79,12 +88,13 @@ defined('ABSPATH') || exit;
+
-
-
+
+
@@ -132,10 +142,8 @@ body.ums-account-canvas { margin: 0; background: #f7f8f5; }
.ums-section-heading > span { color: var(--muted); font-size: 10px; font-weight: 700; letter-spacing: .13em; }
.ums-section-copy { color: var(--muted); margin: -4px 0 20px; font-size: 14px; max-width: 640px; }
.ums-card { background: var(--paper); border: 1px solid var(--line); border-radius: 12px; overflow-wrap: anywhere; min-width: 0; }
-.ums-card:empty { display: none; }
.ums-detail-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 20px; }
.ums-site-detail { display: grid; gap: 20px; margin-top: 20px; }
-.ums-site-detail > .ums-card:not(:has(.wu-current-site)), .ums-detail-grid > .ums-card:not(:has(.wu-styling)), .ums-invoices:not(:has(.wu-invoices)) { display: none; }
.ums-invoices { margin-top: 20px; }
.ums-portal .wu-styling { font-family: inherit; font-size: 14px; line-height: 1.6; }
.ums-portal .wu-styling h3 { font-size: 16px; color: var(--ink); }
diff --git a/docs/user-guide/client-management/frontend-account-page.md b/docs/user-guide/client-management/frontend-account-page.md
index e22a51de7..f7cfa9344 100644
--- a/docs/user-guide/client-management/frontend-account-page.md
+++ b/docs/user-guide/client-management/frontend-account-page.md
@@ -18,7 +18,9 @@ blocks, plus a native Checkout block page.

:::important Compatibility and release status
-The screenshots were captured on a local WordPress Multisite installation with the frontend-account fixes proposed in [plugin PR #2086](https://github.com/Ultimate-Multisite/ultimate-multisite/pull/2086). The version string alone does not establish that those fixes are installed. Until that PR is released, some older installations may not provide the same recovery states, Manage focus, resubscription, cancellation validation or Stripe return behavior. Use the release containing those fixes for production; do not install an unreviewed development branch on a live network.
+The screenshots were captured on a local WordPress Multisite installation with the frontend-account fixes from [plugin PR #2133](https://github.com/Ultimate-Multisite/ultimate-multisite/pull/2133). That PR is merged to `main` after v2.19.0 and ships in the next release, so v2.19.0 and earlier do not include it. The version string alone does not establish that those fixes are installed. Until you run a release that includes it, some installations may not provide the same recovery states, Manage focus, resubscription, cancellation validation or Stripe return behavior. Do not install an unreleased development branch on a live network.
+
+**Payment Methods fatal error on v2.4.12 through v2.19.0.** The Payment Methods widget (`[wu_payment_methods]` or the Payment Methods block) calls a gateway method that does not exist. It breaks the page with `Call to undefined method WP_Ultimo\Gateways\Free_Gateway::get_title()` for any customer whose membership has a payment gateway, which includes the Free gateway used by free plans and trials without a card. Plugin PR #2133 fixes it. Until you run a release that includes it, leave the Payment Methods widget off the account page.
:::
## 1. Understand the two account views
@@ -185,7 +187,10 @@ Billing Address opens the native address form. Payment Method shows the actual c

-**Manual/Free:** an online card-change link is not expected for a gateway that does not support it. Manual paid upgrades/reactivations can remain On Hold until an administrator confirms payment and explicitly activates the membership in the payment editor.
+**Manual/Free:** an online card-change link is not expected for a gateway that does not support it. A Manual paid upgrade stays On Hold, and a reactivation stays Cancelled, until an administrator confirms the payment. How the administrator activates the membership depends on the release:
+
+- **Releases that include plugin PR #2133:** set the payment to Completed in the payment editor and turn on **Activate Membership?** when you save. A reactivation is not restored earlier, because On Hold counts as an active membership. An add-on payment is confirmed the same way, but it only lifts the hold: it does not extend the plan's period.
+- **v2.19.0 and earlier:** the payment editor offers **Activate Membership?** only while the membership is Pending, so it never appears for an On Hold upgrade or a Cancelled reactivation. Activate the membership in the membership editor instead, as described in the troubleshooting table below.
**Stripe:** enable **Use Stripe Billing Portal** for the membership's Stripe gateway and configure the correct test/live credentials. The membership needs valid Stripe customer/subscription references. The portal opens on Stripe's own domain and returns to the originating account page. The card display must respect a subscription-specific card when set, or the customer's default when the portal removes that override. See [Stripe](../payment-gateways/stripe.md).
@@ -253,7 +258,8 @@ The example canvas does not render account widgets for guests. Instead, it shows
| Checkout asks for a new site during resubscription | Preserve the native membership-context link and use the release containing the corrected resubscription flow. |
| No Change link under Payment Method | Check gateway support, Stripe Billing Portal setting, credentials and membership gateway references. Manual/Free do not have an online card-change flow. |
| Card changes in Stripe but the widget loses card details | Use the fixed gateway that reads the effective customer default when there is no subscription override. |
-| Manual payment says Completed but membership is On Hold | In the administrator payment editor, explicitly activate the membership when confirming the offline payment. |
+| Manual payment is still Pending but the membership is On Hold (upgrade) or Cancelled (reactivation) | On a release that includes plugin PR #2133, set the payment to Completed and turn on **Activate Membership?** before you save. |
+| Manual payment is already Completed, or you run v2.19.0 or earlier, and the membership is still On Hold or Cancelled | The payment editor does not offer **Activate Membership?** in this case. Open the membership under **Memberships** in the network admin and set **Status** to Active. For a reactivation, also set **Expires at** in the Important Timestamps box to the end of the period the customer paid for, clear **Cancelled at**, and set **Gateway** to `manual` so the account page shows how it was paid. If **Expires at** is left more than three days (the default grace period) in the past, the daily expiry check marks the membership Expired again. |
| CSS/layout differs from these screenshots | Confirm the example plugin is active, the Account workspace template is selected and cached CSS is cleared. Inspect inherited theme styles. |
| A previous customer's information appears | Stop using the cached page, purge it and repair the cache/ownership issue before reopening access. Do not hide the symptom with CSS. |
diff --git a/static/downloads/frontend-account-example.zip b/static/downloads/frontend-account-example.zip
index 5e69cb8f5..065735697 100644
Binary files a/static/downloads/frontend-account-example.zip and b/static/downloads/frontend-account-example.zip differ
diff --git a/static/downloads/frontend-account/canvas.php b/static/downloads/frontend-account/canvas.php
index 15214858e..cea7e0534 100644
--- a/static/downloads/frontend-account/canvas.php
+++ b/static/downloads/frontend-account/canvas.php
@@ -22,12 +22,13 @@
+
-
-
+
+
diff --git a/static/downloads/frontend-account/portal.css b/static/downloads/frontend-account/portal.css
index 93d041f7f..730aa36c6 100644
--- a/static/downloads/frontend-account/portal.css
+++ b/static/downloads/frontend-account/portal.css
@@ -33,10 +33,8 @@ body.ums-account-canvas { margin: 0; background: #f7f8f5; }
.ums-section-heading > span { color: var(--muted); font-size: 10px; font-weight: 700; letter-spacing: .13em; }
.ums-section-copy { color: var(--muted); margin: -4px 0 20px; font-size: 14px; max-width: 640px; }
.ums-card { background: var(--paper); border: 1px solid var(--line); border-radius: 12px; overflow-wrap: anywhere; min-width: 0; }
-.ums-card:empty { display: none; }
.ums-detail-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 20px; }
.ums-site-detail { display: grid; gap: 20px; margin-top: 20px; }
-.ums-site-detail > .ums-card:not(:has(.wu-current-site)), .ums-detail-grid > .ums-card:not(:has(.wu-styling)), .ums-invoices:not(:has(.wu-invoices)) { display: none; }
.ums-invoices { margin-top: 20px; }
.ums-portal .wu-styling { font-family: inherit; font-size: 14px; line-height: 1.6; }
.ums-portal .wu-styling h3 { font-size: 16px; color: var(--ink); }
diff --git a/static/downloads/frontend-account/ums-account-example.php b/static/downloads/frontend-account/ums-account-example.php
index 17e51de14..a87b25571 100644
--- a/static/downloads/frontend-account/ums-account-example.php
+++ b/static/downloads/frontend-account/ums-account-example.php
@@ -2,7 +2,7 @@
/**
* Plugin Name: Ultimate Multisite Account Page Example
* Description: An optional presentation layer for native Ultimate Multisite shortcodes.
- * Version: 1.0.0
+ * Version: 1.0.1
* License: GPL-2.0-or-later
* Text Domain: ums-account-example
*/
@@ -29,6 +29,15 @@ function ums_account_example_is_page() {
add_action('wp_enqueue_scripts', function () {
if (ums_account_example_is_page()) {
- wp_enqueue_style('ums-account-example', plugins_url('portal.css', __FILE__), [], '1.0.0');
+ wp_enqueue_style('ums-account-example', plugins_url('portal.css', __FILE__), [], '1.0.1');
}
});
+
+add_filter('the_content', function ($content) {
+ if (!ums_account_example_is_page()) {
+ return $content;
+ }
+
+ // After blocks/shortcodes render, omit only our own completely empty cards.
+ return preg_replace('/
]*\sclass="[^"]*\bums-card\b[^"]*"[^>]*>\s*<\/div>/', '', $content);
+}, 20);