Duplicate Post Exclusion for Query Loop Block
| 开发者 | itamarsilvacc |
|---|---|
| 更新时间 | 2026年7月17日 13:30 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
core/query (Query Loop) block so posts already shown by another Query Loop on the same page are not displayed again.
This is automatic deduplication for the block editor: when you place several Query Loops on one page (for example a featured list above a recent-posts list), each enabled loop skips the posts already rendered above it, keeping every post unique on the page.
How it works
- Edit a Query Loop block in the block editor.
- In the sidebar, enable Make posts unique on page.
- Enable the same option on any other Query Loops that should respect prior results.
- On the front end, each enabled loop excludes post IDs already rendered by previous enabled loops.
- Extends the core Query Loop block — no custom block or variation required.
- Uses official hooks:
query_loop_block_query_varsandrender_block. - No extra database queries; only adjusts existing query arguments.
- Per-request in-memory registry (no transients or options).
- Compatible with Query Loop variations such as Advanced Query Loop.
- WordPress 6.7 or later
- PHP 7.4 or later
安装:
- Upload the
silvaitamar-duplicate-post-exclusion-query-loopfolder to/wp-content/plugins/. - Activate the plugin through the Plugins screen in WordPress.
- Edit a Query Loop block and enable Make posts unique on page in the block sidebar.
常见问题:
How do I prevent duplicate posts in Query Loop blocks?
Edit each Query Loop block and enable Make posts unique on page in the block sidebar. On the front end, every enabled loop excludes the posts already shown by the loops above it, so each post appears only once on the page.
Do I need a separate block?
No. The plugin extends the native core/query block only.
Will it slow down my site?
No. The plugin adds no extra database queries. It only adjusts the post__not_in argument of the queries your Query Loops already run, using a per-request in-memory registry.
Does this affect the editor preview?
No. Cross-loop exclusion runs on the front end only. The editor preview uses the REST API and does not simulate exclusion between multiple loops on the same page.
Do Query Loops without the option participate?
No. Only loops with Make posts unique on page enabled register and exclude posts.
Does this work with Advanced Query Loop or other Query Loop variations?
Yes. Variations register on the native core/query block. This plugin extends the same block and uses official render hooks, so it works alongside extensions like Advanced Query Loop.
Does it work with "Inherit query from template"?
Partially. A Query Loop set to inherit the template query renders from the global query and does not pass through the query_loop_block_query_vars filter. Such an inherited loop still registers the posts it shows, so a later custom loop will exclude them. However, exclusion is not applied to the inherited loop itself (it will not hide posts shown by an earlier loop). Full support for inherited queries is planned for a future release.
更新日志:
- Documentation only: improved the readme for search discoverability (refined tags, short description, and description) and added two FAQ entries. No functional changes.
- Renamed the plugin display name to "Duplicate Post Exclusion for Query Loop Block". The plugin slug, text domain, and functionality are unchanged.
- Bundled the Spanish (Spain) translation.
- Initial release:
uniqueOnPageattribute, front-end exclusion, and rendered post registry.