Skip to content

Docs update: Ultimate Multisite v2.18.0 #192

Open

Description

@superdav42

Release

Ultimate Multisite v2.18.0 — release dated 2026-10-27. Publication follows the core plugin's GitHub and WordPress.org workflow, not the addon WooCommerce workflow.

Required doc updates

  • docs/user-guide/host-integrations/bigscoots.md (new page) — document BigScoots setup and automatic domain mapping. Follow the existing GridPane host integration guide. Source: inc/integrations/providers/bigscoots/ in the core plugin.
  • docs/user-guide/configuration/checkout-forms.md — document opt-in provisioning progress, host-history ETA, signed site handoff, and legacy-flow defaults. Verify options against core checkout and inc/provisioning/; do not imply every form enables these features automatically.
  • docs/user-guide/administration/managing-system-emails.md — explain delayed scheduling, product targeting, trial-expiring events, and the per-email network-name subject prefix. Sources: core inc/admin-pages/class-email-edit-admin-page.php, inc/managers/class-email-manager.php, and inc/models/class-email.php.
  • docs/user-guide/administration/managing-payments-and-invoices.md — describe supported invoice writing systems, bundled fonts, Arabic/CJK handling, font selection, and errors for unsupported scripts. Sources: core inc/invoices/ and the invoice font assets; list only scripts actually shipped.
  • docs/developer/addon-development/getting-started.md — add a practical add-on catalog extension example, following core inc/class-addon-repository.php and the catalog extension points introduced in core PR #1941. Hook references are generated; do not hand-edit those pages.
  • docs/developer/integration-guide/index.md — explain custom provisioning pipelines and progress reporting using core inc/functions/provisioning.php and inc/provisioning/class-provisioning-progress.php; document signed handoff integration only after verifying its current contract.
  • docs/user-guide/domain-mapping/how-to-configure-domain-mapping.md — explain permanent HTTP 301 primary-domain redirects, read-only DNS lookup diagnostics, and displayed nameservers. Cross-reference the generated wu_domain_mapping_fallback hook rather than manually editing its generated reference.

Documentation assessment

Manual updates are required for all five New changelog entries (hosting, checkout/handoff, system emails, invoice fonts, and developer extensions). Delayed-email behavior, redirect defaults, and DNS UI guidance also need the updates above. The remaining fixes preserve intended behavior; editor/statistics performance, source asset freshness, dependency updates, and internal verification do not need manual pages. No new REST endpoint is claimed without source verification. Generated hook references and changelogs remain owned by the documentation generation pipeline.

Verification

Check every option and API example against the v2.18.0 core source. Build the docs with the repository's existing documented build command, verify links/sidebar reachability, and ensure generated hooks/changelogs are not hand-edited. The paths above were discovered from the docs repository tree; BigScoots is explicitly a new page. Do not invent other paths if additional pages are needed: discover them first.

Changelog entry

Version [2.18.0] - Released on 2026-10-27
- New: BigScoots hosting integration supports automatic domain mapping.
- New: Checkout can show step-by-step site provisioning progress with estimated completion times and a signed handoff to the new site.
- New: System emails support product targeting, a trial-expiring event, and an optional network-name subject prefix.
- New: Invoice PDFs include bundled fonts for more languages and writing systems.
- New: Developers can extend the add-on catalog and customize fallback domain lookup.
- Fix: Stripe checkout handles multi-step forms, free recurring plans, cart currencies, discounts, trials, and initial payment expiration more reliably.
- Fix: Outstanding invoices on active memberships and refunds with fractional discount totals now work correctly.
- Fix: Paid checkout publishes pending sites reliably, customer panels isolate pending sites, and orphaned pending sites can be deleted safely.
- Fix: Bulk site deletion no longer risks deleting unrelated sites whose IDs match pending memberships.
- Fix: Secondary networks initialize their tables reliably and use the correct network's metadata, limits, pending sites, and model events.
- Fix: Site duplication preserves destination URLs after retries and retains the structure of runtime-only tables.
- Fix: Arabic and CJK invoice PDFs render more reliably, and PDF generation failures provide clearer errors.
- Fix: Delayed system emails now send reliably with current membership details.
- Fix: Primary-domain redirects use HTTP 301 by default, and blocked or demo-mode site frontends return HTTP 403 instead of 500.
- Fix: Embedded browsing contexts no longer trigger SSO flows, and domain-removal integrations retain their enqueue filter.
- Fix: Configuration changes invalidate cached PHP code and support custom wp-config.php insertion points.
- Fix: OCI Email Delivery sender verification and DKIM details use the correct API paths.
- Fix: Legacy pricing tables tolerate missing products, and page selectors retain the correct current-page choices.
- Improved: Checkout and block-editor page selectors load choices on demand, reducing unnecessary editor and page-cache work.
- Improved: DNS diagnostics clarify that lookups are read-only and display nameservers; logs identify SSL certificate failures more clearly.
- Improved: Membership and revenue statistics avoid unnecessary plan and product loading.
- Improved: Source installations include current minified assets, and dependency security updates improve reliability.

Auto-generated by /wp-release


aidevops.sh v3.39.49 plugin for OpenCode

Activity

  1. self-assigned this
    on Oct 28, 2026
  2. added
    documentationImprovements or additions to documentation
    origin:interactiveAuto-created by pulse labelless backfill (t2112)
    needs-updateNeeds documentation update
    on Oct 28, 2026
  3. removed their assignment
    on Oct 28, 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

    documentationImprovements or additions to documentationneeds-updateNeeds documentation updateorigin:interactiveAuto-created by pulse labelless backfill (t2112)status:availableTask is available for claiming

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions