Skip to content

Yoast SEO 27.8 — docs(customization-free): Document new wpseo_custom_fields_pre_query filter#401

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

Yoast SEO 27.8 — docs(customization-free): Document new wpseo_custom_fields_pre_query filter#401
claude[bot] wants to merge 1 commit into
mainfrom
rc-sync/wordpress-seo/27.8-RC2/customization-free

Conversation

@claude
Copy link
Copy Markdown

@claude claude Bot commented May 28, 2026

RC docs sync — 27.8-RC2

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

  • inc/class-wpseo-custom-fields.php:95: apply_filters('wpseo_custom_fields_pre_query', null, $limit) — new filter introduced
  • Changelog entry: "Introduces the wpseo_custom_fields_pre_query filter, allowing sites to short-circuit the potentially expensive custom-fields lookup in Yoast settings, with a pre-computed list or a custom query."

Changes in this PR

  • docs/customization/yoast-seo/filters/custom-fields-pre-query-filter.md — new page documenting the wpseo_custom_fields_pre_query filter with usage examples
  • sidebars.js — added navigation entry for the new filter page under Yoast SEO customization

Verification

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

Note: yarn build and yarn lint were not run as part of this automated sync; Cloudflare Pages will validate the build on PR push.

Reviewer notes

The filter was introduced in inc/class-wpseo-custom-fields.php. The PHPDoc block in the source clearly describes @param string[]|null $custom_fields and @param int $limit, and confirms that returning a non-null array short-circuits the default SELECT DISTINCT meta_key query. The two examples (static list and cached list) cover the primary use cases from the PHPDoc description.


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

…filter

Introduced in Yoast SEO 27.8-RC2: new filter allows sites to short-circuit
the potentially expensive SELECT DISTINCT meta_key query on large postmeta
tables by supplying a pre-computed or alternative list of custom field keys.
@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/27.8-RC2 RC docs sync for Yoast SEO 27.8-RC2 labels May 28, 2026
@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying yoast-developer with  Cloudflare Pages  Cloudflare Pages

Latest commit: 5107a12
Status: ✅  Deploy successful!
Preview URL: https://e7a5b3a9.yoast-developer.pages.dev
Branch Preview URL: https://rc-sync-wordpress-seo-27-8-r-u323.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/27.8-RC2 RC docs sync for Yoast SEO 27.8-RC2 rc-doc-sync RC documentation sync PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants