GH#127: docs: update Ultimate Multisite 2.13.0 docs

[superdav42]

Summary

Updated the v2.13.0 release notes and documented sovereign-tenant main-site customer flows, checkout-form base domains, automatic domain-record behavior, renewal credential handling, and developer extension points.

Files Changed

docs/developer/addon-development/getting-started.md,docs/developer/integration-guide/custom-gateway.md,docs/developer/integration-guide/multi-tenancy.md,docs/user-guide/client-management/account-page.md,docs/user-guide/configuration/checkout-forms.md,docs/user-guide/configuration/multi-tenancy-isolation.md,docs/user-guide/domain-mapping/how-to-configure-domain-mapping.md,docs/user-guide/getting-started/release-notes.md,docs/user-guide/payment-gateways/getting-paid.md

Runtime Testing

• Risk level: Low (agent prompts / infrastructure scripts)
• Verification: npm ci; npm run build (fails during MDX compilation on pre-existing missing image assets: /img/installation/install-wizard.png, /img/frontend/broadcast-customer-dashboard.png, /img/config/payments-force-auto-renew.png, /img/frontend/manual-thank-you.png, /img/admin/addons-page-vat.png).

Resolves #127

---

aidevops.sh v3.20.18 plugin for OpenCode v1.16.2 with gpt-5.5 spent 13d 23h and 218,809 tokens on this as a headless worker.

Summary by CodeRabbit

• Documentation
  • Added comprehensive guidance for Ultimate Multisite v2.13.0 features, including sovereign-tenant customer management flows, SSO integration patterns, renewal credential verification for payment gateways, checkout-form base domain handling, and domain mapping auto-creation logic.
  • Updated integration guides covering custom gateway renewal-credential reporting and multi-tenancy URL generation.
  • Added v2.13.0 release notes.

[superdav42]

Completion Summary

• What: Updated the v2.13.0 release notes and documented sovereign-tenant main-site customer flows, checkout-form base domains, automatic domain-record behavior, renewal credential handling, and developer extension points.
• Issue: Docs update: Ultimate Multisite v2.13.0 #127
• Files changed: docs/developer/addon-development/getting-started.md,docs/developer/integration-guide/custom-gateway.md,docs/developer/integration-guide/multi-tenancy.md,docs/user-guide/client-management/account-page.md,docs/user-guide/configuration/checkout-forms.md,docs/user-guide/configuration/multi-tenancy-isolation.md,docs/user-guide/domain-mapping/how-to-configure-domain-mapping.md,docs/user-guide/getting-started/release-notes.md,docs/user-guide/payment-gateways/getting-paid.md
• Testing: npm ci; npm run build (fails during MDX compilation on pre-existing missing image assets: /img/installation/install-wizard.png, /img/frontend/broadcast-customer-dashboard.png, /img/config/payments-force-auto-renew.png, /img/frontend/manual-thank-you.png, /img/admin/addons-page-vat.png).
• Key decisions: none

---

aidevops.sh v3.20.18 plugin for OpenCode v1.16.2 with gpt-5.5 spent 13d 23h and 218,809 tokens on this as a headless worker.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This PR adds documentation for Ultimate Multisite v2.13.0 across developer guides, user guides, and release notes. Changes describe sovereign-tenant customer routing, payment-gateway renewal-credential checks, checkout-form base-domain behavior, domain mapping, and new developer extension points.

Changes

Ultimate Multisite v2.13.0 Documentation

Layer / File(s)	Summary
Sovereign-tenant customer management flows docs/user-guide/configuration/multi-tenancy-isolation.md, docs/user-guide/client-management/account-page.md, docs/developer/integration-guide/multi-tenancy.md	Documents how customer actions (account, checkout, billing, invoices, site management, template switching, domain mapping) are routed from sovereign tenants back to the main site. Describes wu_with_sso() SSO-wrapper generation, the wu_sso_url filter for customization, and return-link validation to prevent arbitrary redirects.
Payment gateway renewal credential handling docs/developer/integration-guide/custom-gateway.md, docs/user-guide/payment-gateways/getting-paid.md	Documents the wu_membership_has_renewal_credential filter contract (return true, false, or null), the behavior when gateways report missing credentials (auto-renewal disabled, marker saved for admin prompt), and integrator requirements to store reusable credentials and clear the marker after re-authorization.
Checkout-form base domains and domain mapping docs/user-guide/configuration/checkout-forms.md, docs/user-guide/domain-mapping/how-to-configure-domain-mapping.md	Explains that domains set in checkout-form Site URL fields are treated as shared network base domains (not per-site custom mappings), automatic per-site domain records skip creation for these base domains and the network primary domain, and host-provider integrations enqueue provider-side DNS/subdomain tasks for new sites.
Developer extension points and release summary docs/developer/addon-development/getting-started.md, docs/user-guide/getting-started/release-notes.md	Provides reference documentation for three new extension points: wu_with_sso/wu_sso_url (SSO URL generation and customization), wu_checkout_form_base_domains, and wu_should_create_domain_record_for_site (automatic domain-record suppression). Includes comprehensive v2.13.0 release notes covering sovereign-tenant support, renewal-credential checks, loopback publishing, SSO reliability, pending-site recovery, domain-mapping fixes, and various checkout/membership/dashboard edge-case improvements.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related issues

• #127: Docs update: Ultimate Multisite v2.13.0 — This PR fully implements all the required documentation updates checklist from the linked issue, including sovereign-tenant customer flows, renewal-credential handling, checkout-form base domains, domain-mapping behavior, payment-gateway guidance, and new developer extension points.

Suggested labels

documentation

Poem

🐰 A tale of v2.13.0 spread far and wide,
Where sovereigns route customers back with pride,
Gateways check credentials with filter's gleam,
Base domains unite in a checkout dream,
And docs bloom bright with extension points new—
The knowledge rabbit hops straight to you! 🌱

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title clearly identifies the main change as documentation updates for Ultimate Multisite v2.13.0 and references the related issue #127.
Linked Issues check	✅ Passed	All documentation objectives from issue #127 have been addressed: sovereign-tenant flows, checkout-form base domains, automatic domain-record behavior, renewal credentials, SSO/multi-tenancy patterns, and developer extension points are documented across the specified files, plus release notes were updated.
Out of Scope Changes check	✅ Passed	All changes are documentation-only updates directly aligned with issue #127 objectives; no code changes or out-of-scope additions were introduced.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/auto-20260606-104134-gh127

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}