Description
Filterable Post Gallery shows your published posts or WooCommerce products in a grid with filter buttons. A visitor clicks a button to see only the items in one category or tag.
You can use it as a filterable portfolio, a post grid, or a WooCommerce product grid with a category filter.
You do not add gallery items by hand. The gallery gets its items from your posts or products. When you publish or update a post or product, the gallery shows the change.
You can add the gallery with the block in the WordPress block editor, or with the widget in Elementor.
Features
- The gallery gets its items from your posts or WooCommerce products.
- The filter buttons can use categories, tags, or any other taxonomy (a group of labels for content) on your site.
- The grid changes its size to fit phones, tablets, and computers.
- You can change the colors of the buttons and the cards in the block editor.
- You can show the image, title, and excerpt, or show only the image.
- Posts without a featured image get a placeholder image.
- You can show 2 to 16 items for each filter.
- You can add more than one gallery to a page. Each gallery has its own settings.
Tools for AI assistants
The plugin adds three tools that an AI assistant can use. The assistant connects to your site through MCP (Model Context Protocol, a standard way for AI apps to work with your site).
- Preview Gallery: Shows the filter buttons and the items that a gallery shows for posts or products.
- Clear Gallery Cache: Removes the saved gallery results. Each gallery makes new results the next time that a visitor opens it.
- Create Shop Page: Makes a new draft page with a product gallery. You can choose the block editor or Elementor for the page.
The assistant can only do what its WordPress user account can do. The Preview Gallery and Clear Gallery Cache tools need a user who can edit posts. The Create Shop Page tool needs a user who can edit pages. It also needs WooCommerce, and the Elementor option needs Elementor.
Good for these websites
- Portfolio websites that show projects by type.
- Photo blogs that show pictures by event or style.
- Business websites that show services or team members.
- Blogs that want posts to be easier to find.
- Online stores that show products by category.
- News websites that show articles by topic.
- School websites that show courses or resources by subject.
- Real estate websites that show properties by type or location.
Add the gallery in the block editor
- Open a page in the editor.
- Click the + button to add a block.
- Search for “Filterable Post Gallery” and add the block.
- Choose Posts or Products as the source.
- Choose how to group the filter buttons, for example by category.
- If you want different colors, change them in the block settings.
- Save the page.
Add the gallery in Elementor
- Open a page in Elementor.
- Search for “Filterable Post Gallery” in the widget list.
- Drag the widget onto the page.
- In the widget settings, choose Posts or Products in Source.
- In Filter by, choose how to group the filter buttons.
- Click Publish or Update.
Tutorial
Watch the full walkthrough on YouTube:
Requirements
Your website needs:
- WordPress 6.9 or newer.
- PHP 8.2.35 or newer.
- MySQL 5.6 or newer.
To show products, you need WooCommerce. To use the widget, you need Elementor.
The gallery works in these browsers:
- Chrome 90 and newer.
- Firefox 88 and newer.
- Safari 14 and newer.
- Edge 90 and newer.
- Mobile browsers on iPhone and Android.
You do not need to write code. You only need to know how to add a block in the WordPress editor, and how posts and categories work.
Compatibility
The plugin works with:
- Block themes and classic themes.
- WooCommerce.
- Elementor.
- Caching plugins.
- Security plugins.
You can translate the plugin into other languages.
Privacy
The plugin does not collect personal information from your visitors.
The plugin sends data to pluximo.com only when you use the Support form on the Pluximo page:
- To find out if you already have an open ticket, it sends your email address.
- When you send a ticket, it sends your email address, your message, and your site address.
- If you choose to include system information, it also sends your PHP, WordPress, theme, and plugin versions, your memory limit, and your server software name.
If you connect an AI assistant through MCP, the assistant can read the gallery titles, links, and images that the tools return.
Need Help?
If you need help, ask in the WordPress.org support forum for this plugin.
Installation
Install from your WordPress admin
- Go to your WordPress admin area.
- Click Plugins > Add New Plugin.
- Search for “Filterable Post Gallery”.
- Click Install Now, and then click Activate.
Install by hand
- Download the plugin ZIP file.
- Unzip the file and upload the
filterable-post-gallery-blockfolder to/wp-content/plugins/. - Go to Plugins in your WordPress admin and click Activate.
Use the gallery with an AI assistant (optional)
You can ask an AI app, such as VS Code, Cursor, or Claude Code, to preview your galleries, clear the gallery cache, and make shop pages. Only an administrator can connect an AI app.
Before you start, you need an administrator account and a secure site address that starts with https://. If your site does not have a secure address, ask your host to turn on SSL.
To connect your AI app, do these steps one time:
- In your WordPress admin, click Pluximo in the left menu.
- Open the Connect AI tab.
- If you see Install MCP Adapter, click it. This adds a free plugin that lets AI apps talk to your site.
- Click Connect AI.
- Click Add to VS Code or Add to Cursor. For Claude Code, copy the line under “Claude Code: paste this in your terminal.” and paste it in your terminal.
Do step 5 right away. Pluximo shows these links one time only. If you leave the page first, disconnect and connect again.
To make sure that the connection works, ask the assistant: “Preview the gallery for my posts.” If the assistant shows your posts, the connection works.
To see what a gallery shows, you can ask:
- “Preview the gallery for my posts.”
- “Preview the gallery for my posts, filtered by tags.”
- “Preview the product gallery, filtered by product categories.”
- “Preview the product gallery, filtered by product tags, with 8 items for each filter.”
- “Show me the first 20 items in the post gallery.”
- “Which filter buttons does my product gallery show?”
- “Which posts in the gallery have no featured image?”
To clear the gallery cache, you can ask:
- “Clear the gallery cache.”
- “I changed some products. Clear the gallery cache so that the gallery shows my changes.”
To make a shop page, you can ask:
- “Create a shop page with a product gallery.”
- “Create a shop page called Our Products, filtered by product tags.”
- “Create a shop page with 8 products for each filter.”
- “Create a shop page in Elementor.”
- “Create an Elementor shop page called New Arrivals, filtered by product tags, with 16 products for each filter.”
The assistant makes a new draft page with the gallery. Visitors cannot see a draft. In your WordPress admin, go to Pages and open the new draft. If the gallery looks right, click Publish.
The assistant can preview only posts and products. It can filter posts by categories or tags, and products by product categories or product tags. A preview shows up to 100 items. A shop page needs WooCommerce, and an Elementor shop page also needs Elementor.
The assistant does not change your existing pages. To disconnect an AI app, go to Pluximo → Connect AI and click Disconnect next to the app in the “Connected AI apps” list.
FAQ
Why not use a normal gallery block?
A normal gallery block needs you to add and manage each item by hand. This gallery gets its items from your posts or WooCommerce products. When you publish new content, the gallery shows it.
Does it work with Elementor?
Yes. Add the Filterable Post Gallery widget to an Elementor page. In the widget, you can choose the source, the filter group, and the number of items for each filter. You can also choose the default filter and the alignment of the filter buttons.
The widget can also show an “All” button, the post content, placeholder images, and an image lightbox (a larger view of the image that opens over the page). The color settings are only in the block editor.
Can an AI assistant change my existing pages?
No. The Create Shop Page tool only makes new draft pages. It does not change your existing pages. A draft page is not public until you publish it.
Which types of content can I show?
You can show these types of content:
- Regular WordPress posts.
- WooCommerce products.
Which filters can I use?
The filter buttons can use any taxonomy on your site:
- Post categories.
- Product categories from WooCommerce.
- Tags.
- Custom taxonomies from your theme or other plugins.
Does it work on mobile phones?
Yes. The grid changes to fit phones, tablets, and computers. It works in all modern web browsers.
Will it make my website slow?
No. The plugin does not load files from other websites. It saves gallery results for one hour, so pages with a gallery load faster. When you save a post, the plugin removes the saved results, and the gallery shows your change.
How can I change how it looks?
In the block editor, you can change these settings:
- Button colors: background, text, hover, and active.
- Card colors: background, title, and excerpt.
- Display: the image with the title and excerpt, or the image only.
- Items: 2 to 16 items for each filter.
- Placeholder images for posts without a featured image.
Does it work with my WordPress theme?
Yes. It works with block themes and classic themes.
Is it good for Google search?
The gallery puts your titles, excerpts, and links in the page itself. Search engines can read them like other content on the page.
Can I have more than one gallery on a page?
Yes. You can add as many galleries as you want to a page. Each gallery has its own settings.
What happens if I turn off the plugin?
Your posts and products do not change. The galleries stop showing on your pages until you turn the plugin on again.
Can I get help if I have a problem?
Yes. Ask in the WordPress.org support forum for this plugin. We also release updates that fix problems and support new WordPress versions.
Changelog
1.2.0 – 08.11.2026
- New: Add the gallery to Elementor pages with the Filterable Post Gallery widget.
- New: AI assistants that connect through MCP can preview a gallery, clear the gallery cache, and make a draft shop page.
- Improved: The gallery shows up-to-date items right after you update the plugin.
- Fix: A security problem with image captions in the lightbox.
- Fix: The gallery no longer shows hidden products, or out-of-stock products when your shop hides them.
1.1.0
- Improved: The editor now chooses a default source and filter for you.
- Improved: The gallery shows a clear message when the filter is not valid or no items match.
1.0.1
- Improved: Galleries load faster because the plugin saves recent results.
- Improved: Galleries show your changes as soon as you save a post.
- Improved: The block is easier to use in the editor.
1.0.0
- Initial release: Show your posts or products in a gallery with filter buttons.
