Repository navigation
Open
Labels
auto-dispatchdocumentationImprovements or additions to documentationImprovements or additions to documentationneeds-updateNeeds documentation updateNeeds documentation updateorigin:interactiveAuto-created by pulse labelless backfill (t2112)Auto-created by pulse labelless backfill (t2112)status:availableTask is available for claimingTask is available for claimingtier:standardAuto-created by pulse labelless backfill (t2112)Auto-created by pulse labelless backfill (t2112)
Description
Release
Ultimate Multisite v2.20.0, released 2026-11-21. Release PR: Ultimate-Multisite/ultimate-multisite#2142 (tag v2.20.0).
Treat the plugin source at tag v2.20.0 as the source of truth. The paths and PR numbers below say where each behaviour lives. Check every statement you write against that source.
Required doc updates
-
docs/user-guide/domain-mapping/how-to-configure-domain-mapping.md: the section "Making sure the domain DNS settings are properly configured" only describes an A record to the Network IP, and the "Add Domain" modal description predates the new instructions text. Update both for plugin PR #2073 (inc/managers/class-domain-manager.php):- New setting Recommended DNS Target (
domain_mapping_dns_target). It is shown when domain mapping and custom domains are enabled. Tooltip: "The hostname customers should point their custom domains to. Leave empty to use the network domain." Default is the network domain. - The domain mapping instructions field accepts the placeholders
%NETWORK_DOMAIN%,%NETWORK_IP%and%DNS_TARGET%(HTML is allowed). - The new default instructions cover: root domain (CNAME to
%DNS_TARGET%, or an A record to%NETWORK_IP%when the registrar does not allow a root CNAME), subdomain (CNAME for the exact hostname), the optionalwwwalias (CNAME to%DNS_TARGET%), removing conflicting A, AAAA or CNAME records, Cloudflare ("DNS only" grey cloud until verified, then SSL/TLS "Full (strict)" if proxying), and DNS and SSL propagation time. - If the DNS target sits behind a load balancer, the
wu_get_network_public_ipfilter should return its public ingress IP for the A-record fallback.
- New setting Recommended DNS Target (
-
docs/user-guide/payment-gateways/manual-payments.md: update the section "Confirming manual payments" for plugin PR #2133 (inc/gateways/class-manual-gateway.php,inc/admin-pages/class-payment-edit-admin-page.php):- The Activate Membership? toggle only appears when a pending payment is being set to Completed on a membership that is neither active nor trialing.
- Confirming a manual payment for a cancelled or expired membership reactivates it (the cancellation date is cleared and the reactivation hooks run).
- Confirming a manual add-on payment activates the membership without extending the plan period or changing its bill count.
- A manually paid upgrade moves the membership to the Manual gateway and turns off auto-renew on the previous gateway.
-
docs/user-guide/client-management/frontend-account-page.md: the page says its screenshots were captured with "frontend-account fixes proposed in plugin PR #2086" (closed unmerged) and that "newer versions" show a chooser/recovery state. State the real minimum version, Ultimate Multisite 2.20.0, and remove the PR #2086 reference. Then verify the page against 2.20.0 (plugin PR #2133): Account Summary sign-in, site-selection and recovery states; Resubscribe opens the existing membership's checkout with the previous plan selected; the Stripe Billing Portal returns to the originating account page; email change; primary-site selection; cancellation confirmation. Fix any statement that no longer matches. Checkdocs/user-guide/client-management/frontend-account-blocks.mdanddocs/user-guide/client-management/shortcodes.mdfor the same version and behaviour statements.
Files Scope
docs/user-guide/domain-mapping/how-to-configure-domain-mapping.mddocs/user-guide/payment-gateways/manual-payments.mddocs/user-guide/client-management/frontend-account-page.mddocs/user-guide/client-management/frontend-account-blocks.mddocs/user-guide/client-management/shortcodes.md
Reference pattern
Follow the structure of the neighbouring pages in the same folder (headings, admonitions, /img/... image paths). No new screenshots are required; do not reference screenshots that do not exist.
Not needed
docs/developer/hooks/is auto-generated from the plugin source.- The removed setting "Optimize the front-end My Sites toolbar" (plugin PR #2076) is not documented anywhere under
docs/user-guideordocs/developer, so there is nothing to remove. - The WooCommerce Subscriptions staging fix and the login code wording changes need no doc change. No page documents the email login code or passkey flows; adding one is optional and out of scope here.
Verification
npm run buildcompletes without MDX or broken-link errors.- Updated pages keep their YAML frontmatter (
title,sidebar_position) and use the product name "Ultimate Multisite". i18n/is untouched (translations are auto-generated).- Every changed statement matches the plugin source at tag
v2.20.0.
Changelog entry
Version [2.20.0] - Released on 2026-11-21
- New: Domain mapping instructions cover root and www records, conflicting records, Cloudflare, and DNS and SSL propagation, and a new Recommended DNS Target setting with a %DNS_TARGET% placeholder sets the hostname customers point their domains to.
- Fix: Billing address and edit site forms in the customer account check that the customer owns the record before showing its details.
- Fix: Stale or mistyped cancel, resubscribe, and delete site links show a message instead of a critical error.
- Fix: Confirming a manual payment reactivates a cancelled or expired membership properly, clearing its cancellation date, and a manually paid upgrade moves the membership to the Manual gateway.
- Fix: Confirming a manual add-on payment activates the membership without extending the plan's billing period or bill count, and the Activate Membership option only appears when it can take effect.
- Fix: Change payment method, cancel, and resubscribe links keep the account page's own query string, and the Stripe Billing Portal returns customers to the page they came from.
- Fix: WooCommerce Subscriptions staging mode is reset after a new site finishes initializing instead of before its tables exist.
- Improved: The front-end account shortcodes and blocks work together on a main-site customer account page, with sign-in, site selection, and recovery states in the account summary, reliable email changes, validated primary site choices, and a Resubscribe link that opens the existing membership's checkout with the previous plan selected.
- Improved: The My Sites toolbar loads your sites when the menu is opened instead of preparing every site on each request, so the "Optimize the front-end My Sites toolbar" setting is removed.
- Improved: The email login code step is clearer, and the login page is simpler, with a narrow bordered card and password links after the email field.
Opened by /wp-release for the 2.20.0 release.
aidevops.sh v3.39.189 plugin for OpenCode
Metadata
Metadata
Assignees
Labels
auto-dispatchdocumentationImprovements or additions to documentationImprovements or additions to documentationneeds-updateNeeds documentation updateNeeds documentation updateorigin:interactiveAuto-created by pulse labelless backfill (t2112)Auto-created by pulse labelless backfill (t2112)status:availableTask is available for claimingTask is available for claimingtier:standardAuto-created by pulse labelless backfill (t2112)Auto-created by pulse labelless backfill (t2112)
Activity