PHPackages                             ralfhortt/query-loop-post-picker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. ralfhortt/query-loop-post-picker

ActiveWordpress-plugin

ralfhortt/query-loop-post-picker
================================

A WordPress plugin that adds post selection and event date controls to Query blocks.

v1.0.0(1mo ago)01GPL-2.0-or-laterTypeScriptPHP >=8.1

Since Jul 13Pushed 1mo agoCompare

[ Source](https://github.com/Horttcore/query-loop-post-picker)[ Packagist](https://packagist.org/packages/ralfhortt/query-loop-post-picker)[ RSS](/packages/ralfhortt-query-loop-post-picker/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

Query Loop Post Picker
======================

[](#query-loop-post-picker)

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

Features
--------

[](#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
------------

[](#requirements)

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

Installation
------------

[](#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
-----------

[](#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
----------------

[](#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
-------

[](#license)

GPL-2.0-or-later

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance90

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

48d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/45d54752dcf3da868ffe4a5ad2b876d6acb911fd914700b52e4d4777ff7d4a02?d=identicon)[Ralf Hortt](/maintainers/Ralf%20Hortt)

---

Top Contributors

[![Horttcore](https://avatars.githubusercontent.com/u/503252?v=4)](https://github.com/Horttcore "Horttcore (2 commits)")

---

Tags

block-editorquery-blockwordpress

### Embed Badge

![Health badge](/badges/ralfhortt-query-loop-post-picker/health.svg)

```
[![Health](https://phpackages.com/badges/ralfhortt-query-loop-post-picker/health.svg)](https://phpackages.com/packages/ralfhortt-query-loop-post-picker)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)