README

Query Loop Post Picker adds editor controls for selecting specific posts and filtering event queries in the WordPress block editor.

Features

• Select posts for a Query block with a searchable token field.
• Preserve the selected post order with the Query block's include ordering.
• Filter event queries by a quick date range or custom start dates.
• Show only events related to the current staff member when editing staff templates.
• Loads only in the block editor and uses WordPress core data and components.

Requirements

• WordPress 6.1 or newer
• PHP 8.1 or newer
• The WordPress REST API must expose the selected post type.

Installation

1. Download or clone this repository into wp-content/plugins/query-loop-post-picker.
2. Run npm install and npm run build if the built assets are not included in your package.
3. Activate Query Loop Post Picker from the WordPress Plugins screen.
4. Add or edit a Query Loop block in the block editor.

The plugin does not add a frontend asset. Its controls are registered through enqueue_block_editor_assets.

Development

Install dependencies and build the editor script:

npm install
npm run build

For watch mode during development:

npm start

The generated files are written to build/.

Query Attributes

The picker writes these attributes to the Query block when applicable:

• include and orderBy: "include" for selected posts.
• eventDateRange for a predefined event date range.
• eventStartAfter and eventStartBefore for custom event dates.
• showRelatedEventsOfStaff for staff-related event queries.

The related-events option only appears for event queries in a staff context and is intended to be paired with a server-side query filter that handles this attribute.

License

GPL-2.0-or-later