README

A WordPress plugin that adds a Show only terms of the current post option to Terms Query blocks.

When enabled, a Terms Query block displays only terms assigned to the post currently being viewed. The editor preview and rendered block output use the same filtering behavior.

Requirements

WordPress 6.1 or later
PHP 8.1 or later

Installation

Install the plugin with Composer:

composer require ralfhortt/current-post-terms-query

Alternatively, download or clone this repository into wp-content/plugins/current-post-terms-query.

If you are building from source, install the JavaScript dependencies:

npm install

Build the editor assets:

npm run build

Finally, activate Current Post Terms Query in WordPress.

Usage

Add a Terms Query block to a template or post.
Select a taxonomy.
Enable Show only terms of the current post in the block settings.

If the Terms Query has configured included term IDs, the result is limited to the intersection of those IDs and the current post's terms.

In the Site Editor, the preview skips template and template-part editing contexts so it does not treat the template itself as the current post. On the server, filtering only runs when an explicit postId is available in block context; template parts without post context remain unfiltered.

Development

Build the production editor bundle:

npm run build

Start the development watcher:

npm run start

The PHP filter is implemented in src/CurrentPostTermsQueryFilter.php. Editor controls and preview behavior are implemented in src/js/editor/.

Author

Ralf Hortt

License

GPL-2.0-or-later. See the GNU General Public License.

ralfhortt / current-post-terms-query

Maintainers

Package info

Statistics

Security