Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 5 additions & 6 deletions docs/user-guide/client-management/frontend-account-blocks.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,19 +18,18 @@ widgets, adjust their settings, or replace the surrounding layout with your own.
:::important Release compatibility
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 a release that includes them on production.
released in v2.20.0: styled iframe previews, correctly typed settings, and early
detection of settings inside Groups/Columns. Use v2.20.0 or later 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.
customer whose membership has a payment gateway, including Free. It is fixed in
v2.20.0. On v2.19.0 or earlier, update, or leave the Payment Methods block off the
page until you do.
:::

## 1. Insert the native account blocks
Expand Down
8 changes: 4 additions & 4 deletions docs/user-guide/client-management/frontend-account-page.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@ blocks, plus a native Checkout block page.
![Desktop customer account workspace with sidebar navigation, membership and plan controls](/img/frontend-account/01-overview.png)

:::important Compatibility and release status
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.
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), released in v2.20.0. v2.19.0 and earlier do not include them, so on those releases some installations may not provide the same recovery states, Manage focus, resubscription, cancellation validation or Stripe return behavior. Update to v2.20.0 or later.

**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.
**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. It is fixed in v2.20.0. On v2.19.0 or earlier, update, or leave the Payment Methods widget off the account page until you do.
:::

## 1. Understand the two account views
Expand Down Expand Up @@ -189,7 +189,7 @@ 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. 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.20.0 and later:** 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).
Expand Down Expand Up @@ -258,7 +258,7 @@ 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 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 still Pending but the membership is On Hold (upgrade) or Cancelled (reactivation) | On v2.20.0 or later, 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. |
Expand Down