Repository navigation
Docs: Explain that switch_to_blog() does not switch registered post types - #14888
bluefairydevelopment wants to merge 2 commits into
Conversation
…ypes. Document on WP_Query's post_type argument that 'any' uses the post types registered on the original site after switch_to_blog(), and on switch_to_blog() that post types and taxonomies do not switch. See #63768.
|
The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. Core Committers: Use this line as a base for the props when committing in SVN: To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook. Props Bot commandsYou can trigger Props Bot actions by commenting on this PR:
|
Test using WordPress PlaygroundThe changes in this pull request can previewed and tested using a WordPress Playground instance. WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser. Some things to be aware of
For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation. |
Per review, the note on registered post types and taxonomies belongs with switch_to_blog(), which causes the effect, rather than WP_Query.
|
Thanks @peterwilsoncc, that makes sense. I've removed the |
Documentation only. After
switch_to_blog(), registered post types and taxonomies still reflect the site handling the request, soWP_Querywith'post_type' => 'any'builds itspost_type IN (...)list from the original site. As noted in comment 3 on the ticket, the root cause is the same as #20541 (closed invalid), so this documents the behaviour rather than changingWP_Query.switch_to_blog()docblock: post types, taxonomies and other registries do not switch, which affectsget_post_types(),post_type_exists(),taxonomy_exists()andWP_Querywith'any'or atax_query.No code changes.
php -land phpcs are clean forms-blogs.php.Trac ticket: https://core.trac.wordpress.org/ticket/63768
Use of AI Tools
AI assistance: Yes
Tool(s): Claude Code
Model(s): Claude Opus 5.5
Used for: reading the ticket and the code, and drafting the documentation wording. Submitted by Blue Fairy Development, who are responsible for the change.
This Pull Request is for code review only. Please keep all other discussion in the Trac ticket. Do not merge this Pull Request. See GitHub Pull Requests for Code Review in the Core Handbook for more details.