Skip to content

Yoast SEO 28.1 — docs(customization-free): Document new MyYoast OAuth redirect URI filters#412

Open
claude[bot] wants to merge 1 commit into
mainfrom
rc-sync/wordpress-seo/28.1-RC1/customization-free
Open

Yoast SEO 28.1 — docs(customization-free): Document new MyYoast OAuth redirect URI filters#412
claude[bot] wants to merge 1 commit into
mainfrom
rc-sync/wordpress-seo/28.1-RC1/customization-free

Conversation

@claude

@claude claude Bot commented Jul 8, 2026

Copy link
Copy Markdown

RC docs sync — 28.1-RC1

Product: wordpress-seo
Area: customization-free
Source evidence:

  • src/myyoast-client/infrastructure/wordpress/redirect-uri-provider.php: wpseo_myyoast_redirect_uris — filters the list of OAuth redirect URIs registered with MyYoast for this site; introduced alongside the new MyYoast connection card on the Integrations page
  • src/myyoast-client/infrastructure/wordpress/redirect-uri-provider.php: wpseo_myyoast_authorization_redirect_uri — filters the single redirect URI embedded in each MyYoast authorization request; must be one of the already-registered URIs

Changes in this PR

  • docs/customization/yoast-seo/filters/myyoast-oauth-redirect-uri-filters.md (new): documents both filters with parameter tables and usage examples for reverse-proxy / multi-host setups
  • sidebars.js (updated): adds a navigation entry for the new page under the Yoast SEO customization section

Verification

  • yarn build passes locally in this workflow.
  • yarn lint clean for files touched by this PR.

Reviewer notes

  • Both filters are public: no @internal annotation, neutral file path (src/myyoast-client/infrastructure/wordpress/), and no admin capability check (they are apply_filters calls, not REST routes).
  • The REST routes introduced alongside this feature (yoast/v1/bulk_editor/*, yoast/v1/myyoast/*) all require wpseo_manage_options with no unauthenticated branch and live under user-interface/ paths — they are treated as internal and are not documented here. See run summary on issue RC docs-sync audit log — Yoast SEO #390 for the full "Internal surface skipped" list.
  • The wpseo_ai_auth_method filter introduced in the same RC is marked @internal in its PHPDoc and is also excluded.
  • The example callback path in wpseo_myyoast_redirect_uris (admin-post.php?action=yoast_myyoast_oauth_callback) is derived from how OAuth_Callback_Integration::get_callback_url() constructs the canonical URL; if the action slug changes in a future RC, update this page accordingly.

Authored by the RC docs-sync agent. Not auto-merged — requires human review. Run: https://github.com/Yoast/developer/actions/runs/28923795968

…ters

Adds documentation for two new filters introduced in Yoast SEO 28.1-RC1
that allow developers to customize OAuth callback URL registration for
non-standard hosting setups (reverse proxies, alternate admin URLs).

RC: 28.1-RC1
@claude claude Bot added rc-doc-sync RC documentation sync PR product/wordpress-seo Related to Yoast SEO for WordPress area/customization-free Related to customization of Yoast SEO (free) rc/28.1-RC1 RC docs sync for Yoast SEO 28.1-RC1 labels Jul 8, 2026
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying yoast-developer with  Cloudflare Pages  Cloudflare Pages

Latest commit: 87c7a7f
Status: ✅  Deploy successful!
Preview URL: https://1070e911.yoast-developer.pages.dev
Branch Preview URL: https://rc-sync-wordpress-seo-28-1-r.yoast-developer.pages.dev

View logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/customization-free Related to customization of Yoast SEO (free) product/wordpress-seo Related to Yoast SEO for WordPress rc/28.1-RC1 RC docs sync for Yoast SEO 28.1-RC1 rc-doc-sync RC documentation sync PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants