Skip to content

Docs update: Ultimate Multisite v2.20.0 #208

Open

Description

@superdav42

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 optional www alias (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_ip filter should return its public ingress IP for the A-record fallback.
  • 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. Check docs/user-guide/client-management/frontend-account-blocks.md and docs/user-guide/client-management/shortcodes.md for the same version and behaviour statements.

Files Scope

  • docs/user-guide/domain-mapping/how-to-configure-domain-mapping.md
  • docs/user-guide/payment-gateways/manual-payments.md
  • docs/user-guide/client-management/frontend-account-page.md
  • docs/user-guide/client-management/frontend-account-blocks.md
  • docs/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-guide or docs/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 build completes 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

Activity

  1. locked as resolved and limited conversation to collaborators on Nov 21, 2026
  2. added
    documentationImprovements or additions to documentation
    origin:interactiveAuto-created by pulse labelless backfill (t2112)
    tier:standardAuto-created by pulse labelless backfill (t2112)
    needs-updateNeeds documentation update
    on Nov 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    auto-dispatchdocumentationImprovements or additions to documentationneeds-updateNeeds documentation updateorigin:interactiveAuto-created by pulse labelless backfill (t2112)status:availableTask is available for claimingtier:standardAuto-created by pulse labelless backfill (t2112)

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions