README

Prevents duplicate posts across multiple Query Loop blocks on the same page.

Opt-in per block via a toggle in the block editor. Supports custom queries, inherited queries, and arbitrary custom blocks via a resolver filter. Includes editor-side preview, PHP filters for per-block overrides, and an exclude_duplicates WP_Query arg for ad-hoc lists.

Features

See docs/deduplication.md for the full feature guide.

Installation

Manual Installation

1. Download the latest release ZIP from the Releases page.
2. Go to Plugins > Add New > Upload Plugin in your WordPress admin area.
3. Upload the ZIP file and click Install Now.
4. Activate the plugin.

Install with Composer

To include this plugin as a dependency in your Composer-managed WordPress project:

1. Add the plugin to your project using the following command:

composer require outstand/query-loop-dedup

1. Run composer install.
2. Activate the plugin from your WordPress admin area or using WP-CLI.

Quick start

1. Add multiple Query Loop blocks to a page.
2. Enable Exclude duplicate posts in the block sidebar under the Deduplication panel.
3. Each subsequent block will skip posts already shown by previous blocks.

Requirements

• WordPress 6.7 or higher
• PHP 8.2 or higher

Tests

JS tests run locally via Jest:

npm run test:js

PHP tests run inside a wp-env container:

npm run test:setup   # first time only — starts Docker WP + test DB
npm run test:unit

Changelog

All notable changes to this project are documented in CHANGELOG.md.

License

This project is licensed under the GPL-3.0-or-later.