When they search, make sure they find you!
Popular

ID Post Grid

A flexible post grid for WPBakery with search, category filter, and load more functionality.

v1.0.1 Free Documentation

Description

Display your WordPress posts in a beautiful, responsive grid layout with real-time search, category filtering, and load more pagination. ID Post Grid gives you four professionally designed templates and full control over every detail — all through a simple shortcode, ID Visual Editor block or WPBakery Page Builder element.

Four Templates, One Shortcode

Choose from four distinct visual styles to match your site’s design:

  • Card — The classic blog grid. Featured image on top, content below, with a clean bordered card treatment and hover elevation effect.
  • Overlay — Bold and visual. Content overlays the featured image with a gradient backdrop, perfect for photography blogs and portfolio sites.
  • Minimal — No borders, no shadows, no distractions. Just images and text with a clean editorial feel.
  • Horizontal — Image on the left, content on the right. Ideal for news-style layouts and content-heavy blogs.

Built-In Search and Filtering

Every grid includes optional real-time search and category filter buttons. As visitors type or select a category, posts filter instantly via AJAX — no page reload, no waiting. The search input uses intelligent debouncing so results update smoothly without overwhelming the server.

Load More Pagination

Instead of traditional numbered pagination that breaks the browsing flow, Post Grid uses a “Load More” button that appends the next batch of posts below the existing ones. Visitors stay on the page and keep scrolling. You control how many posts load initially and with each click.

Featured Post Support

Highlight your most important content by enabling the featured post option. The most recent post (or a specific post you choose) spans the full grid width with a larger image and title treatment, drawing attention before the regular grid begins.

CSS Variables for Easy Theming

Post Grid uses CSS custom properties for all its colors, spacing, and transitions. Override a handful of variables in your theme’s stylesheet and the entire grid adapts — buttons, hover states, borders, and backgrounds all update consistently without fighting specificity battles.

Page Builder Integration

ID Post Grid integrates with both ID Visual Editor and WPBakery Page Builder. In WPBakery, the grid registers as a native element with a full options panel organized into tabs: General, Layout, Features, Display, and Style. In ID Visual Editor, a dedicated block with a live settings panel gives you the same level of control. Every shortcode attribute is available as a visual control in both builders, so you can configure the grid without touching any code.

Key Features

  • Four templates: Card, Overlay, Minimal, and Horizontal layouts
  • Real-time AJAX search with intelligent debouncing
  • Category filter buttons with smooth AJAX loading
  • Load more pagination — no page reloads, just seamless content loading
  • Featured post support — highlight the most recent or a specific post
  • Responsive CSS grid with configurable columns (1-4) and gap spacing
  • Customizable display options: image, title, excerpt, date, category, read more
  • Three button styles: square, rounded, and pill
  • Custom button color support via CSS variables
  • Featured image size selection with WordPress registered sizes
  • Configurable excerpt length in words
  • Controls alignment options: left, center, or right
  • Full WPBakery Page Builder integration with visual options panel
  • CSS custom properties for easy theming without specificity conflicts
  • Lightweight and conflict-free — works with any WordPress theme

Requirements

WordPress 5.0+
PHP 7.4+
Tested Up To 6.9

Changelog

# Changelog

All notable changes to ID Post Grid will be documented in this file.

## 1.0.1 — 2026-02-14

- Escaped `$wrapper_style`, `$featured_html`, and `render_grid_item()` output with `esc_attr()` / `wp_kses_post()`.
- Added `wp_unslash()` and `sanitize_text_field()` to all `$_POST` data in AJAX handler.
- Removed deprecated `load_plugin_textdomain()` call.
- Added `phpcs:ignore` for `tax_query` and `post__not_in` warnings.
- Added `phpcs:disable` for template variable prefixing.
- Reduced readme tags from 6 to 5.
- Updated Tested up to 6.9.

## 1.0.0 — 2025-02-11

- Initial release.
- Four templates: Card, Overlay, Minimal, Horizontal.
- Real-time AJAX search with debounce.
- Category filter with smooth AJAX loading.
- Load more pagination.
- Featured post support (most recent or specific post).
- Full WPBakery Page Builder integration.
- IDVE editor integration.
- Customizable via CSS variables.
- Responsive grid with configurable columns and gap.
- Configurable display options: image, title, excerpt, date, category, read more.
- Button style options: square, rounded, pill.
- Custom button color support.
- Controls alignment (left, center, right).