Skip to content

Yoast SEO 28.9 — docs(sitemaps): Update sitemap stylesheet documentation from XSL to CSS - #433

Open
claude[bot] wants to merge 1 commit into
mainfrom
rc-sync/wordpress-seo/28.9-RC2/sitemaps
Open

claude[bot] wants to merge 1 commit into
mainfrom
rc-sync/wordpress-seo/28.9-RC2/sitemaps

Conversation

@claude

@claude claude Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

RC docs sync — 28.9-RC2

Product: wordpress-seo
Area: sitemaps
Source evidence:

  • css/main-sitemap.xsl: deleted — XSL stylesheet removed
  • css/main-sitemap.css: added — CSS stylesheet replaces it
  • inc/sitemaps/class-sitemaps-renderer.php: processing instruction changed from type="text/xsl" to type="text/css"; get_xsl_url() deprecated in favour of get_stylesheet_url()
  • inc/sitemaps/class-sitemaps-router.php: new main-sitemap.css rewrite rule and query var yoast-sitemap-css
  • inc/sitemaps/class-sitemaps.php: new css_output() method; wpseo_sitemap_public_url filter now receives a .css URL by default

Changes in this PR

  • docs/features/xml-sitemaps/functional-specification.md: replaces the "XSL stylesheets" subsection with a "Stylesheet" subsection reflecting the CSS change; notes that video/news sitemaps retain their XSL stylesheets
  • docs/features/xml-sitemaps/api.md: updates the wpseo_sitemap_public_url filter example and description from "XSL URL" to "stylesheet URL", with a corrected example value pointing to main-sitemap.css

Verification

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

Reviewer notes

  • The get_xsl_url() method deprecation (@deprecated 28.9) is a PHP method, not a filter or hook, so it is not added to the deprecations page.
  • The wpseo_sitemap_public_url filter itself is unchanged (still in the symbol index); only the default value it receives changed from a .xsl to a .css path. Existing filter implementations that hard-code an XSL URL will silently break; this is worth a note in release communication (out of scope for doc-sync).

Sibling PRs from this RC


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

🤖 Generated with Claude Code

RC: 28.9-RC2

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying yoast-developer with  Cloudflare Pages  Cloudflare Pages

Latest commit: a409eca
Status: ✅  Deploy successful!
Preview URL: https://0c74e124.yoast-developer.pages.dev
Branch Preview URL: https://rc-sync-wordpress-seo-28-9-r-97wc.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/sitemaps Related to XML sitemaps feature product/wordpress-seo Related to Yoast SEO for WordPress rc/28.9-RC2 rc-doc-sync RC documentation sync PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants