Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/indranil-mondal/filterable-gallery-elementor-pro-v1/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
This plugin adds a Filterable Gallery widget to Elementor that lets you display posts from any post type with hierarchical category filtering, live search, video support and AJAX pagination. It was designed to work without a full page reload and to be configurable from within Elementor.
Features
- Post Type & Taxonomy Selection – Choose which post type to query (e.g. posts, pages, products) and specify the taxonomy slug used for categories (e.g.
category,genre). Only public post types are listed. - Dynamic Filter Bar – The widget initially shows top‑level terms from the chosen taxonomy. Selecting a term will replace the list with its child terms, allowing you to drill down through categories. An All link resets the filter.
- Live Search – A search box filters the results as you type. Search queries, term selection and pagination all work together.
- AJAX Pagination – When there are more posts than fit on one page, numbered pagination links appear. Clicking a page number fetches the next set of posts without reloading.
- Video Lightbox – If your posts contain a custom field (meta key) with a video URL (e.g. created via ACF), clicking an item opens a modal showing the video along with the post’s title, description and tags.
- Customisable Cards – Each card shows the post’s featured image (or a placeholder), title and inherits global colours/typography from your theme. (Loop template support is not implemented in this version.)
Installation
- In your WordPress admin, go to Plugins → Add New → Upload Plugin.
- Upload the ZIP file provided (
filterable-gallery-elementor-pro-v2.1.3.zip). - Activate the plugin.
- Ensure you have Elementor installed and activated. Elementor Pro is not strictly required, but ACF or a similar plugin is needed if you wish to use a video meta field.
Usage
- Edit a page with Elementor.
- Drag the Filterable Gallery widget (under the General category) into your layout.
- In the widget’s Content settings you can configure:
- Items per page – Number of posts to show per page.
- Post Type – Choose which post type to query (e.g. post, page, product).
- Taxonomy Slug – The taxonomy used for categories (default:
category). This must be hierarchical for the sub‑term filter to work. - Video Meta Key – (Optional) The custom field key storing the video URL. When provided, clicking a card opens a lightbox showing the video and post details.
- Loop Template ID – (Optional) Placeholder for future support of Elementor loop templates. This version does not use it.
- Style the filter bar, items and modal via the widget’s Style tab or through your theme’s CSS.
Creating a Video Meta Field
To display a video in the lightbox, you’ll need a custom field storing the video URL on each post:
- Install and activate the Advanced Custom Fields (ACF) plugin (or similar).
- Create a field group, assign it to your chosen post type and add a URL field named for example
video_url. - In the widget settings, set Video Meta Key to
video_url(or your chosen name). - When editing posts, enter a valid video URL (YouTube/Vimeo/MP4). Supported hosts embed via `