=== Advanced Post Block – Showcase Posts with Grid, List, Card Layouts and Filters ===
Contributors: bplugins, abuhayat, charlescormier, farazi1, freemius
Donate link: https://www.buymeacoffee.com/abuhayat
Tags: block, post grid, post slider, post filter, post list
Requires at least: 6.5
Tested up to: 6.9
Requires PHP: 7.1
Stable tag: 2.2.0
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Advanced Post Block lets you add dynamic post grids, lists, sliders, and tickers. Filter content by category, tag, author, or custom post type.

== Description ==
**​The Ultimate Gutenberg Block to Display Posts, Pages, and Custom Content Beautifully**


[**Advanced Post Block**](https://bplugins.com/products/advanced-post-block/) | [**Documentation**](https://bplugins.com/docs/advanced-post-block/) | [**Pricing**](https://bplugins.com/products/advanced-post-block/pricing/) | [**Support**](https://bplugins.com/support/) | [**Demo**](https://bplugins.com/products/advanced-post-block/#demos)

[**Advanced Post Block**](https://bplugins.com/products/advanced-post-block/) is a Gutenberg blocks plugin for displaying posts, pages, and custom post types in WordPress with advanced query controls, filtering, and multiple layout options.

It supports grid, list, masonry, slider, ticker, and news-style layouts, allowing you to create dynamic post displays for blogs, magazines, and content-heavy websites. The plugin includes flexible query parameters such as category, tag, author, keyword search, and custom taxonomy filtering, along with query presets for faster setup.

Recent additions include AJAX-based post loading, pagination, load more, and infinite scroll, enabling seamless content browsing without page reloads. It also supports post view tracking and sorting by popularity, helping highlight trending or most-viewed content.

You can control the visibility and structure of post elements, including featured images, titles, metadata, excerpts, and read more links. Built for performance and responsiveness, the plugin integrates directly with the WordPress block editor to create structured, customizable content layouts without coding.


### Layout Options

Choose from various display styles:

- **Grid:** Arrange posts in a column-based format.

- **Masonry:** Automatically position posts in a staggered, flowing layout.

- **Slider:** Create carousel-style post sections.

- **Ticker:** Show content as a scrolling headline list.

Each layout includes sub-layouts such as Title Meta, Left or Right Image, and Overlay Content.


### Filtering and Query Controls

- Easily select and organize the content you want to display:

- Display standard posts, pages, or custom post types.

- Filter by categories, tags, or authors.

- Control post order and offset.


### Design Customization

Fine-tune the look and feel of your content listings:

- Show or hide featured images, and choose whether they link to the post.

- Customize post titles, excerpts, and read more links.

- Display post metadata such as date, author, and categories, with control over visibility and styling.


### Responsive and Performance-Focused

All layouts are optimized for mobile and desktop devices. The plugin is built to load efficiently and minimize impact on performance.


### Key Features – Free Version

Everything you need to build a professional and modern content display:

- **Core Layouts:** Choose from professional Grid, Masonry, Slider, Ticker and News Ticker views.

- **Flexible Sub-layouts:** Optimize displays with Default, Left/Right Image, Overlay, and Title-Meta layouts.

- **Slider Options:** Customize the slider layout with loop, touch move, autoplay, speed, effect, pagination and navigation with the customization and styling.

- **Dynamic Post Query:** Advanced filtering by post type, posts per page, categories, authors, taxonomy relation (AND/OR), post orders and more.

- **Element Visibility:** Full control to show or hide thumbnails, titles, metadata, excerpts, and read more buttons.

- **Feature Image Settings:** Toggle link, set dimensions (Width/Height), and adjust image fitting (Cover/Contain) for a polished look.

- **Title Control:** Customize post title with enable link, select tag, set typography, alignment, colors, and margin.

- **Flexible Metadata:** Show or hide post author, date, categories with position, and comment counts with typography, different colors and margin.

- **Dynamic Excerpt:** Display excerpt from post excerpt or content with limit, alignment, typography, colors, and margin.

- **Customized Read More:** Show Read More button with custom label and icon with link tab and style for alignment, typography, padding, colors, borders, shadows and hover animation.

- **Interactive Container Design:** Alignment, backgrounds, borders, and shadows with padding support for article blocks and content areas.

- **Shortcode Support:** Seamlessly display post blocks anywhere on your site using shortcodes.

- **Responsive Ready:** Fully optimized for a perfect experience on mobile, tablet, and desktop devices.

- **Developer Friendly:** Built with clean code following the best WordPress developmental standards.


### Pro Version – Unlock Premium Power
[**Advanced Post Block Pro**](https://bplugins.com/products/advanced-post-block/pricing/) adds precision filtering, layout enhancements, and deeper content control for high-performing websites.

**What’s Included in Pro:**

- **Exclusive Layouts:** Unlock the **Grid 1**, **Magazine 1**, and **Magazine 2** layouts and sub-layouts like **Overlay Content Box**, **Overlay Half Content**, and **List Even/Odd**.

- **Ticker Options:** Customize the Ticker layout with direction, speed, interval, height, and pause on mouse hover options.

- **News Ticker Pro:** Fine-tune News Ticker layout with label, theme, type, direction, speed, animation, and pause on mouse hover options.

- **Display Pages:** Showcase standard WordPress pages alongside your posts.

- **Query Presets:** Instant query configurations for **Popular**, **Random**, **Sticky**, **Most Comments**, **Related Posts**, and more.

- **Deeper Filtering:** Advanced posts query by **Tags**, **Custom Taxonomies**, **Search Queries** and more **Order By** options.

- **Post Precision:** Use **Offset** to skip the first "N" posts or manually **Include/Exclude** content by IDs, **Exclude current and sticky posts**.

- **Pagination & AJAX:** Modern **Pagination**, **Navigation**, **Infinite Scroll**, and **Load More** button to display more posts.

- **Sortable Elements:** Intuitive drag-and-drop interface to rearrange Post Title, Metadata, and Excerpt.

- **Title Control:** Set precise **Word/Character limits** with ellipsis to adjust title length.

- **Feature Image:** Define the image size, lazyload, and set default Placeholder image with normal-hover grayscale effects and hover radius styling.

- **Metadata Customization:** Set separator and gaps between meta items, reorder/sorting the meta items, set alignment for the metadata.

- **Meta Author:** Set the author link and set custom icon for the author meta.

- **Meta Date:** Set the date format, show date as time ago and set custom icon for the date meta.

- **Meta Category:** Set the category on image position, and set padding, border radius for the Badge display.

-**Tags and Custom Taxonomies:** Display tags and custom taxonomies in the meta with the custom icon.

- **Meta Reading Time:** Show post read time with seconds, label and custom icon.

- **Post View Count:** Enable post view count with custom to display the post views in meta area.

- **Excerpt Control:** Display the SEO Meta description from Yoast, Rank Math, or AIOSEO at the excerpt and display the ellipsis.

- **Advanced Read More:** Unlock more icons, set icon gap, and position with pulse animations.

- **Custom Query Hook:** Leverage the **`apb_query`** filter for deep developer-level control.


### How to Use – Step-by-Step Setup

Getting started is fast and beginner-friendly.

https://youtube.com/watch?v=milYZrqLJsE

You can set up your first post grid in just a few clicks.


**Step-by-Step Setup:**

- Install and activate the **Advanced Post Block** plugin.

- Open a post or page in the Gutenberg editor.

- Click the + icon.

- Find the block called **Advanced Post Block** under the **"Advanced Post Block"** category.

- Choose your layout style, post type, and configure display settings.

- Save and publish.

- That’s it!


**Gutenberg Block Support**
Using the Block Editor? You’re covered.

- Easily find the **Advanced Post Block** in the Gutenberg block library.

- Drag and drop to add dynamic post lists to any page or post.

- Customize layout and design using the right-hand block settings panel.


[**Live Demo**](https://bplugins.com/products/advanced-post-block/#demos) | [**Upgrade to Pro**](https://bplugins.com/products/advanced-post-block/pricing/)


### User Feedback

#### ⭐⭐⭐⭐⭐ [Excellent Plugin](https://wordpress.org/support/topic/excellent-plugin-8873/)

❛❛***Amazing plugin, with now option to showcase pages instead of posts as well. Just perfect!***❜❜

***-[sophibee](https://profiles.wordpress.org/sophibee/)***


#### ⭐⭐⭐⭐⭐ [It does what I need it to do very well](https://wordpress.org/support/topic/it-does-what-i-need-it-to-do-very-well/)

❛❛***This plugin works good, has many options and sounds like more to come. What I like best is the support. Nothing better then a quick reply and they were able help out too! Looking forward to much more style control maybe in a future update.***❜❜

***-[eMBurr](https://profiles.wordpress.org/emburr/)***


#### ⭐⭐⭐⭐⭐ [Great Job!](https://wordpress.org/support/topic/great-job-1273/)

❛❛***I love the layout! Makes things fast and easy.***❜❜

***-[Tori Chambers](https://profiles.wordpress.org/torichambers/)***


#### ⭐⭐⭐⭐⭐ [Wonderful plugin, exceptional support](https://wordpress.org/support/topic/wonderful-plugin-exceptional-support/)

❛❛***I’ll be completely honest, the level of support offered by the plugin creator is exceptional! This is the best plugin for your blog posts arrangement, it makes your blog look wonderful and well-organized.***❜❜

***-[husainghasra](https://profiles.wordpress.org/husainghasra/)***


#### - Did you like this plugin? Dislike it? Have a feature request? [Please share your feedback with us](mailto:support@bplugins.com 'Send feedback')


### Check out the Parent Plugin of this plugin-

[**B Blocks**](https://bblockswp.com) – A blocks collection and page building tool for Gutenberg.


### Check out our other WordPress Plugins-

[**Html5 Video Player**](https://bplugins.com/products/html5-video-player/) – Display videos as single and playlist in multiple skins.

[**PDF Poster**](https://bplugins.com/products/pdf-poster/) – Display/Embed PDF files with different styles.

[**Html5 Audio Player**](https://bplugins.com/products/html5-audio-player/) – Listen audios with awesome visuals.

[**StreamCast**](https://bplugins.com/products/streamcast-radio-player/) – Customizable radio player with different skins.

[**3D Viewer**](https://bplugins.com/products/3d-viewer/) – Embed 3D models and 3D products with interaction.


== Installation ==

### From Gutenberg Editor:
1. Go to the WordPress Block/Gutenberg Editor
2. Search For **Advanced Post Block**
3. Click on the **Advanced Post Block** to add the block

### Download & Upload:
1. Download the **Advanced Post Block** plugin (*.zip file*)
2. In your admin area, go to the Plugins menu and click on **Add New**
3. Click on **Upload Plugin** and choose the **`advanced-post-block.zip`** file and click on **Install Now**
4. Activate the plugin and Enjoy!

### Manually:
1. Download and upload the **Advanced Post Block** plugin to the **`/wp-content/plugins/`** directory
2. Activate the plugin through the Plugins menu in WordPress


== Frequently Asked Questions ==

= Does this plugin support custom post type? =

Yes! All the custom posts that come to your site. You just need to select that custom post from the right setting panel.

= I have a custom post type, but it's not showing up for selection! =

It's possible that your custom post type is not supported by the REST API. You can add REST API support for your custom content types by following the steps outlined in this article: [Adding REST API Support for Custom Content Types](https://developer.wordpress.org/rest-api/extending-the-rest-api/adding-rest-api-support-for-custom-content-types).

= What is available post queries? =

For the query, you can change the post type, filter by taxonomies(categories, tags or custom), post per page, post order by, post order, and post offset.

= Can I change post layouts? =

Yes! This plugin has five main layouts and multiple sub-layouts.

= I want to slide the post! Is it possible? =

Yes! There is a slider layout to slide the posts.

= Is this support responsive for different devices? =

Yes! You can set different columns for different devices.

= Does this plugin have pagination? =

Yes! This plugin has pagination, navigation, infinite scroll, and load more button to fetch more posts, but it will not for the slider and ticker layout.

= Can I visible or hide post elements? =

Yes! you can every element, you can show or hide the title, feature image, meta-data, excerpt, read more button, etc.

= Can I change the styles of the post elements? =

Yes! you can change content alignment, background, padding, and border. all element's(title, metadata, excerpt, read more button) typography, colors, and spacing.

= Where can I get support? =

You can post your questions on the [support forum here](https://wordpress.org/support/plugin/advanced-post-block/)


== Screenshots ==

1. Add "Advanced Posts" Block
2. General Configuration
3. Elements and Style Config
4. Preview - Grid Layout
5. Preview - Overlay Half Content
6. Preview - List Style
7. Preview - Overlay Box
8. Preview - Left Image
9. Preview - Masonry
10. Preview - Grid List


== Changelog ==

= 2.2.0 - 06 May 2026 =
* **New:** Advanced Title Customization: Choose specific SEO title tags, align text perfectly, and set custom hover colors for a professional look.
* **New:** Enhanced Image Controls: Set custom dimensions, adjust borders, radius, and shadows, and add smooth hover animations for better image presentation.
* **New:** Refined Metadata & Badges: Position categories above content, set custom hover colors, and adjust category badge margins.
* **New:** Interactive Container Design: Shadow effects, hover borders, and background hover support for article blocks and content areas.
* **New:** Engaging "Read More" Buttons: Sleek arrow icons and smooth hover animations to guide your visitors.
* **New:** Dynamic Excerpts: Custom hover color support for post excerpts to match your brand's style.

= 2.1.0 - 07 Apr 2026 =
* **New:** News Ticker Layout: Added a new professional news ticker layout (Free).
* **New:** News Ticker Options: Enhanced News Ticker with direction, speed, and animation controls (Pro).
* **New:** Magazine Layouts: Introduced Magazine 1 and Magazine 2 layouts for editorial-style post displays (Pro).
* **New:** Magazine Min Height: Added a responsive minimum height setting for the magazine hero post (Pro).

= 2.0.8 - 14 Mar 2026 =
* **New:** List - Left Even Odd Sub-Layout: Added a new alternating left-aligned list layout for visually distinct even/odd post rows.
* **New:** List - Right Even Odd Sub-Layout: Added a new alternating right-aligned list layout for visually distinct even/odd post rows.
* **Fix:** Fixed the issue of posts not loading in the frontend.

= 2.0.7 - 12 Mar 2026 =
* **New:** Query Preset: Introduced a query preset option to select from predefined query configurations, making it easier to set up common post queries.
* **New:** Taxonomy Relation: Added a new setting to select the relation (AND/OR) between different taxonomy filters, providing more advanced control over the post query.
* **New:** Search Query: Introduced a search field in the block settings to filter posts by a specific search term, allowing for more precise content display.
* **New:** Author Filter: Added the ability to filter posts by specific authors, allowing for more personalized content curation.
* **New:** Exclude Sticky Posts: Introduced an option to exclude sticky posts from the query, providing better control over post visibility.
* **New:** Post View Tracking: Introduced post view tracking to display posts by popularity.
* **Update:** AJAX Post Fetching: Implemented AJAX-based post fetching in the editor/backend for a more reliable and faster loading experience.
* **Fix:** Security Hardening: Enhanced security by restricting license access, improving XSS protection, and enforcing strict type casting for query parameters.

= 2.0.6 - 28 Feb 2026 =
* **New:** Added a Layout Selector for new blocks to improve the initial setup experience.
* **New:** Added helpful descriptions and tooltips to various complex settings in the block sidebar.
* **Fix:** Critical performance issue resolved in the editor by refactoring data-fetching logic to significantly reduce store calls and prevent infinite loops.
* **Update:** Optimized data retrieval for authors, taxonomies, and comments to improve overall editor responsiveness.
* **Fix:** Improved fallback Grid layout display to ensure blocks render correctly even if initial configuration is missing.

= 2.0.5 - 22 Feb 2026 =
* **Add:** ShortCode feature for free users - Easy shortcode support for displaying posts anywhere on your site.
* **Update:** Admin Dashboard - Improved UI with better navigation and clearer feature organization.
* **Fix:** Critical performance improvements and bug fixes.

= 2.0.4 - 22 Jan 2026 =
* **New:** Infinite Scroll - Auto-load posts as users scroll down.
* **New:** Navigation Pagination - Add next/previous buttons for manual browsing.
* **New:** Load More Button - On-demand post loading with a clickable button.

= 2.0.3 - 11 Dec 2025 =
* **Update:** Remove unwanted data from posts query

= 2.0.2 - 03 Dec 2025 =
* **Fix:** Fix offset query issue
* **Update:** Add more options in Order by Query.

= 2.0.1 - 01 Sep 2025 =
* **Update:** Custom Post type label
* **Update:** Add additional class for pagination page numbers

= 2.0.0 - 20 Aug 2025 =
* Fix Post Type Issues
* Update SDK
* Change UI
* Admin Dashboard

= 1.16.1 - 3 Jul 2025 =
* Fix Pagination issue

= 1.16.0 - 18 Jun 2025 =
* Update Upgrade Page
* Fix other users premium unlock issue
* Update SDK

= 1.15.4 - 28 Jan 2025 =
* Update SDK.

= 1.15.3 - 27 Jan 2025 =
* Update SDK.

= 1.15.2 - 19 Dec 2024 =
* Only load essential content or excerpt.

= 1.15.1 - 14 Dec 2024 =
* Current Post Exclude option for every condition.

= 1.15.0 - 30 Nov 2024 =
* Fix Pagination issue

= 1.14.9 - 2 Nov 2024 =
* Fix ShortCode Issue

= 1.14.8 - 29 Oct 2024 =
* Update SDK

= 1.14.7 - 19 Oct 2024 =
* Fix excerpt long word issue.

= 1.14.6 - 12 Sep 2024 =
* Update SDK

= 1.14.4 - 20 Aug 2024 =
* Remove new lines from the content.

= 1.14.3 - 18 Aug 2024 =
* Trim Words for the content.

= 1.14.2 - 17 Aug 2024 =
* Remove Script tag from the content.

= 1.14.1 - 13 Aug 2024 =
* Update Initial Posts render

= 1.14.0 - 12 Jun 2024 =
* Add Loading Placeholder

= 1.13.9 - 8 Jun 2024 =
* Fix the shortcode issue.

= 1.13.8 - 28 May 2024 =
* Fix bad Ajax request issue.

= 1.13.7 - 22 May 2024 =
* Display posts issue fixed.

= 1.13.6 - 16 May 2024 =
* Remove Ajax requests for posts.

= 1.13.5 - 5 May 2024 =
* set post status to publish

= 1.13.4 - 27 Apr 2024 =
* sanitized field

= 1.13.3 - 27 Apr 2024 =
* Update SDK

= 1.13.2 - 23 Apr 2024 =
* Remove Password filter query for security issues.

= 1.13.1 - 23 Mar 2024 =
* Add user filter on password filter query

= 1.13.0 - 9 Mar 2024 =
* Regular Update

= 1.12.9 - 5 Feb 2024 =
* Add Password Filter Query
* Fix nonce validation issue

= 1.12.8 - 25 Jan 2024 =
* Fix issues.

= 1.12.7 - 25 Jan 2024 =
* Add filter for excerpt or content.
* Option to show all excerpts or content.

= 1.12.6 - 18 Jan 2024 =
* Update FS SDK.
* General improvements and optimizations.

= 1.12.5 - 5 Dec 2023 =
* Fix issues.

= 1.12.4 - 4 Dec 2023 =
* Remove Promo

= 1.12.3 - 28 Nov 2023 =
* Fix issues.

= 1.12.2 - 19 Nov 2023 =
* Improvements

= 1.12.1 - 13 Nov 2023 =
* Update Library

= 1.12.0 - 31 Oct 2023 =
* Show Any Taxonomies on Meta Area
* Display Pages

= 1.11.4 - 02 Oct 2023 =
* Fix the Slider issue

= 1.11.3 - 23 Sep 2023 =
* Update SDK.

= 1.11.2 =
* Fix masonry layout

= 1.11.1 =
* Fix translation for the date.

= 1.11.0 =
* Add option to sort title and meta elements.

= 1.10.9 =
* before and after pseudo-elements effect.

= 1.10.8 =
* Add option to include or exclude posts

= 1.10.7 =
* Add option to exclude current post

= 1.10.6 =
* Add filter update system

= 1.10.5 =
* Fix the Pagination issue

= 1.10.4 =
* Add image alt from feature image

= 1.10.3 =
* Improve Accessibility.

= 1.10.2 =
* Option for adding ellipsis after the excerpt.

= 1.10.1 =
* Fix- multiple image tags appear

= 1.10.0 =
* Add content/text height option
* Add read more position option

= 1.9.9 =
* Fix target el is not dom el

= 1.9.8 =
* Fix the thumbnail issue

= 1.9.7 =
* Title h2 to h3

= 1.8.5 =
* Fixed for FSE

= 1.8.4 =
* Performance improvements

= 1.8.3 =
* Fix excerpt difference

= 1.8.2 =
* Fix side image layout

= 1.8.1 =
* Dynamic excerpt link
* Reduce CSS assets load

= 1.8.0 =
* Remove custom excerpt

= 1.7.9 =
* Default font family removed.

= 1.7.8 =
* Pro feature lists added.

= 1.7.7 =
* Fix free-pro activation conflict.

= 1.7.6 =
* Fix the issue.

= 1.7.5 =
* Fix post ID error.

= 1.7.4 =
* Fix for the reusable block.

= 1.7.3 =
* Fix encountered error.

= 1.7.2 =
* Add translate feature

= 1.7.1 =
* Feature image URL fix for the generated image

= 1.7.0 =
* Performance Improvements

= 1.6.9 =
* PHP code reduce
* Special char render fix

= 1.6.8 =
* Fix Categories Select Option

= 1.6.7 =
* Set thumbnail image size.
* Side image vertical in the mobile device.

= 1.6.6 =
* New settings for taxonomy selection.

= 1.6.5 =
* Regular update

= 1.6.4 =
* Fix ticker post-preview issue

= 1.6.3 =
* Set permalink as permalink settings

= 1.6.2 =
* Gradient Picker fixing

= 1.6.1 =
* Fix author issue.

= 1.6.0 =
* Add ticker post layout.
* Performance upgrade.

= 1.4.2 =
* Fix the hover color in meta elements on the image.

= 1.4.1 =
* Add color options for meta elements on the image.

= 1.4.1 =
* Performance Upgrade.

= 1.3.3 =
* Post excerpt content fix.

= 1.3.2 =
* Categories limit extended.
* Update style.

= 1.3.1 =
* Post types limit extended.

= 1.3 =
* Post Query fixing.

= 1.2 =
* Custom Typography with Google fonts.
* Compatible with block directory
* Fixing Issue.
* UI Change.

= 1.1 =
* Compatible with PHP 5.4

= 1.0 =
* Initial Release.


== Source Code ==

You can find the source code, report bugs, and contribute to the development of this plugin on our GitHub repository:
[**Advanced Post Block on GitHub**](https://github.com/bPlugins/advanced-post-block)

== Third-Party Libraries ==

This plugin bundles the following third-party JavaScript/PHP libraries.

= jQuery Easy Ticker =
* **Source:** https://github.com/vaakash/jquery-easy-ticker
* **GitHub:** https://github.com/vaakash/jquery-easy-ticker
* **License:** MIT – [https://github.com/vaakash/jquery-easy-ticker/blob/master/LICENSE](https://github.com/vaakash/jquery-easy-ticker/blob/master/LICENSE)
* **Purpose:** Provides smooth vertical scrolling for the News Ticker layout.

= Swiper =
* **Source:** https://swiperjs.com/
* **GitHub:** https://github.com/nolimits4web/swiper
* **License:** MIT – [https://github.com/nolimits4web/swiper/blob/master/LICENSE](https://github.com/nolimits4web/swiper/blob/master/LICENSE)
* **Purpose:** Modern touch slider used for Slider and News Ticker components.

= react-responsive-masonry =
* **Source:** https://www.npmjs.com/package/react-responsive-masonry
* **GitHub:** https://github.com/cedricdelpoux/react-responsive-masonry
* **License:** MIT – [https://github.com/cedricdelpoux/react-responsive-masonry/blob/master/LICENSE](https://github.com/cedricdelpoux/react-responsive-masonry/blob/master/LICENSE)
* **Purpose:** Handles responsive masonry layouts for post displays.

= Freemius Lite SDK (Custom) =
* **Purpose:** A custom-made version of the Freemius SDK that calls through api.bplugins.com to handle opt-in usage tracking and analytics to help improve the plugin.