Description

MRZ Display Post Exp is a generic, minimalist plugin to display any post type — standard posts or custom post types — together with their ACF fields. Each item is rendered from a customizable HTML template using placeholders (ACF fields, taxonomies, title, thumbnail…). Everything is configured from the WordPress admin — no theme code required — and styled to match the site through the theme CSS.

Features

Multiple display blocks via a dedicated Custom Post Type — each block has its own configuration and shortcode.
Three display formats: list, grid and a dependency-free native CSS slider.
Customizable HTML item template with ACF / taxonomy / post placeholders and conditionals.
Client-side filters by taxonomy and by ACF field, in dropdown / radio / checkbox mode, with OR / AND logic.
Optional client-side text search on titles (and selected ACF text fields).
Optional URL filter synchronization — share a pre-filtered link.
Responsive layout — filters above, left or right; collapsible filters on mobile.
Shortcode with optional forced filter: [mrz_display_post_exp id="X" filter_taxonomy="genre" filter_term="42"].
Translation-ready (text-domain mrz-display-post-exp, .pot file provided).

Requirements

WordPress 6.3 or later, PHP 7.4 or later.
Advanced Custom Fields (Pro recommended) — for the ACF field placeholders and filters.

Privacy / external calls

MRZ Display Post Exp makes no external HTTP calls, loads no remote resources, and collects no telemetry. Everything runs locally on your site.

Source code and contributions

Development happens publicly on GitHub: https://github.com/m0r3z/mrz-display-post-exp

Installation

Install and activate Advanced Custom Fields (Pro recommended).
Upload the plugin to /wp-content/plugins/mrz-display-post-exp and activate it.
Open the “MRZ Display Post” menu, create a display block, configure its source, template, filters and format.
Copy the generated shortcode and paste it into any page or post.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“MRZ Display Post Exp” is open source software. The following people have contributed to this plugin.

m0r3z

Translate “MRZ Display Post Exp” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1.0

Renamed the internal PHP prefix to “mrzdpe” (constants, namespace, functions, hooks, shortcode, CPT, meta keys) to meet WordPress.org’s unique-prefix requirement. The public shortcode is now [mrzdpe]. A one-time automatic migration updates existing blocks and shortcodes on upgrade — no manual action needed. CSS classes and the text domain are unchanged.

1.0.6

WordPress.org release preparation: public plugin name set to “MRZ Display Post Exp” (slug mrz-display-post-exp), contributor updated. No functional change.

1.0.5

New: drag-and-drop reordering of the taxonomy and ACF filters in the admin — the front displays them in the chosen order (taxonomy group stays above the ACF group).

1.0.4

New: option to restrict the list to the current context’s category (related-posts mode) — on a single it keeps only posts sharing the current category and excludes the current post; on a category archive it restricts to that category. The context taxonomy is configurable.

1.0.3

{acf_date} now outputs the spans in month / day / year order.

1.0.2

Fix: the shortcode forced filter (filter_taxonomy / filter_term) now works even when the taxonomy is not enabled as a front filter (uses has_term on each post).

1.0.1

New placeholder {acf_date:field} — splits an ACF date field into day/month/year spans, with an optional month format (m, n, F, M).
Admin: the template placeholder help is now displayed below the item template, inside a collapsible toggle, with a dedicated date-format section.

1.0.0

First stable release.
Three display formats: list, grid and a dependency-free native CSS slider (configurable per-view, gap, speed, autoplay, loop, arrow position).
Customizable HTML item template with placeholders: {post_title}, {post_url}, {post_excerpt}, {post_excerpt:N} (word-limited), {post_thumbnail}, {%acf_field%}, {taxonomy:slug} (each term in its own span), conditionals {#if}.
Client-side filters (taxonomy + ACF, OR/AND), text search, optional URL filter sync, mobile filter toggle.
Sort by an ACF date field with an upcoming/past server-side filter (agenda use-case).
CSS aspect-ratio option for the featured image (object-fit, no file cropping).
Configurable grid column min-width and gap.

0.1.0

Initial beta — list / grid / slider display of posts and custom posts with ACF placeholders, client-side filters and search.