Title: Captain Advance Filter
Author: Devang Vachheta
Published: <strong>2026-يىلى 1-ئىيۇل</strong>
Last modified: 2026-يىلى 30-ئىيۇل

---

قىستۇرما ئىزدە

![](https://ps.w.org/captain-advance-filter/assets/banner-772x250.png?rev=3592667)

![](https://ps.w.org/captain-advance-filter/assets/icon-256x256.png?rev=3592667)

# Captain Advance Filter

 يازغۇچى [Devang Vachheta](https://profiles.wordpress.org/devangvachheta/)

[چۈشۈر](https://downloads.wordpress.org/plugin/captain-advance-filter.1.2.0.zip)

 * [تەپسىلاتلار](https://ug.wordpress.org/plugins/captain-advance-filter/#description)
 * [باھالاشلار](https://ug.wordpress.org/plugins/captain-advance-filter/#reviews)
 *  [ئورنىتىش](https://ug.wordpress.org/plugins/captain-advance-filter/#installation)
 * [ئىجادىيەت](https://ug.wordpress.org/plugins/captain-advance-filter/#developers)

 [قوللاش](https://wordpress.org/support/plugin/captain-advance-filter/)

## چۈشەندۈرۈش

Captain Advance Filter lets you build AJAX-powered filter and search experiences
for any post type. Create custom queries and filter sets — then embed them via shortcodes,
Gutenberg blocks, or Elementor widgets. No coding required.

**Core Features:**

 * AJAX filtering and pagination — no page reload
 * Visual Query Builder — pick a post type, set ordering, and define which content
   gets shown
 * Filter Set Builder — combine multiple filter fields and link them to a query
 * Filter types: Checkbox, Radio, Dropdown, Range (slider), Search, A-Z alphabetical,
   Date Picker, and Woo Rating (WooCommerce star rating)
 * Display styles for Checkbox/Radio: plain list, pill Buttons, Color Swatches, 
   or Image Swatches
 * Taxonomy and meta-based filtering with WP_Query under the hood (tax_query / meta_query)
 * Pagination styles: numbered pagination, load more button, and infinite scroll
 * Optional result caching via WordPress transients for faster repeated queries
 * React-powered admin dashboard with a clean, modern UI, including Dark Mode

**WooCommerce Compatibility:**

 * Woo Rating filter — filter products by «N stars & up» using WooCommerce’s stored
   average rating
 * Color Swatch and Image Swatch display styles for product attribute filters (e.
   g. color, brand), with automatic fallback when no swatch plugin data is set
 * WooCommerce-aware «Shop Card» result card style — shows price, sale badge, and
   an Add to Cart button
 * `{{price}}`, `{{sale_badge}}`, and `{{add_to_cart}}` tokens available in custom
   card templates when filtering Products

**Shortcodes:**

 * `[captaf-filter id="1"]` — render a filter set
 * `[captaf-grid query="query_key"]` — render the filtered content grid
 * `[captaf-pagination query="query_key"]` — render pagination controls
 * `[captaf-count query="query_key"]` — render the result count

**Builder Integrations:**

 * Elementor — dedicated widgets for Filter, Grid, and Pagination, fully stylable
   in the Elementor editor
 * Gutenberg — native blocks for Filter, Grid, and Pagination
 * Bricks Builder — support coming soon

**Performance:**

 * Lightweight — admin and frontend assets load only on the pages that actually 
   use the plugin
 * No jQuery dependency on the frontend

## ئېكران كەسمىسى

[⌊Dashboard overview⌉⌊Dashboard overview⌉[

Dashboard overview

[⌊Query builder⌉⌊Query builder⌉[

Query builder

## بۆلەك

بۇ قىستۇرما 3 بۆلەك تەمىنلەيدۇ.

 *   Filter
 *   Grid
 *   Pagination

## ئورنىتىش

 1. Upload the plugin folder to `/wp-content/plugins/`
 2. Activate the plugin from the **Plugins** screen in WordPress
 3. Go to **Captain Advance Filter** in your admin menu
 4. Create a Query, then a Filter Set linked to that query
 5. Embed using `[captaf-filter id="1"]` and `[captaf-grid query="your_query_key"]`

## FAQ

### Does it work without Elementor?

Yes. Shortcodes and Gutenberg blocks are supported out of the box. Elementor is 
an optional integration.

### Does it work with WooCommerce?

Yes. Filter Products by attribute (with Color/Image Swatch or Button display styles),
price (Range filter), and star rating (Woo Rating filter). The «Shop Card» result
style also shows price, sale badge, and an Add to Cart button. WooCommerce is optional—
the plugin works on any post type without it.

### Can I filter custom post types?

Yes. Any publicly viewable post type registered in WordPress can be used as a query
source.

### Are the public REST endpoints secure?

Yes. The `/filter` endpoint verifies that the queried post type is publicly viewable
before returning results. The `/filter-options` endpoint only exposes options for
publicly queryable taxonomies. No private data is accessible through these endpoints.

### Do I need to know how to code?

No. Everything — queries and filter sets — is configured through the visual admin
dashboard. Shortcodes are provided automatically once you create a query or filter
set.

### Will this slow down my site?

No. Plugin assets are only enqueued on pages where you actually use a shortcode,
Gutenberg block, or Elementor widget from Captain Advance Filter.

## باھالاشلار

بۇ قىستۇرمىغا تېخى باھا يېزىلمىدى.

## تۆھپىكار ۋە ئىجادكار

«Captain Advance Filter» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا
تۆھپە قوشقان.

تۆھپىكار

 *   [ Devang Vachheta ](https://profiles.wordpress.org/devangvachheta/)

«Captain Advance Filter» 9 تىلغا تەرجىمە قىلىنغان. [تەرجىمانلار](https://translate.wordpress.org/projects/wp-plugins/captain-advance-filter/contributors)
نىڭ تۆھپىسى ئۈچۈن رەھمەت.

[«Captain Advance Filter» نى تىلىڭىزغا تەرجىمە قىلىڭ](https://translate.wordpress.org/projects/wp-plugins/captain-advance-filter)

### ئىجادىيەتكە قىزىقامسىز؟

[كودقا كۆز يۈگۈرتۈپ](https://plugins.trac.wordpress.org/browser/captain-advance-filter/)،
[SVN خەزىنە](https://plugins.svn.wordpress.org/captain-advance-filter/) تەكشۈرۈپ
ياكى [RSS](https://plugins.trac.wordpress.org/log/captain-advance-filter/?limit=100&mode=stop_on_copy&format=rss)
ئارقىلىق [ئىجادىيەت خاتىرىسى](https://plugins.trac.wordpress.org/log/captain-advance-filter/)
گە مۇشتەرى بولغىلى بولىدۇ.

## ئۆزگىرىش خاتىرىسى

#### 1.2.0

**New filter types, WooCommerce compatibility, and Dark Mode fixes.**

 * Added: New «Date Picker» filter type — start/end date range filtering against
   the publish date.
 * Added: New «Woo Rating» filter type — «N stars & up» filtering against WooCommerce’s
   stored product average rating (requires WooCommerce).
 * Added: New «Display Style» option for Checkbox and Radio filters — render the
   same taxonomy options as a plain List (default), pill-style Buttons, Color Swatches,
   or Image Swatches, instead of adding separate filter types for each. Color/Image
   swatches automatically pick up swatch data from common WooCommerce attribute-
   swatch plugin term meta, with a graceful fallback (auto-generated color, or label
   text) when none is set.
 * Fixed: Range filter’s Min/Max values were never actually sent to the results 
   query — the values you typed had no effect. They’re now correctly applied, and
   only sent once you actually narrow the range away from its full bounds.
 * Fixed: Admin dashboard toggle switches (e.g. Settings  Enable Query Cache) used
   a hardcoded light-gray track color, so they still looked washed-out/white in 
   Dark Mode instead of adapting to the theme.
 * Fixed: Disabled fields (e.g. «Cache TTL» when «Enable Query Cache» is off) had
   no disabled styling at all — no dimming, no «not-allowed» cursor — so they looked
   editable even though clicking/typing did nothing.
 * Fixed: The active tab indicator on Settings and Docs pages (e.g. «General» vs«
   Performance») relied on a drop shadow to show which tab was selected — invisible
   in Dark Mode, making it unclear which tab was active. Active tabs now get a clearly
   visible tinted background and border in Dark Mode.
 * Fixed: The divider line under toggle rows was hardcoded to a near-white color,
   showing as a bright white line in Dark Mode instead of a subtle divider.
 * Fixed: Tab hover state in Dark Mode showed a bright white flash (inherited from
   the Light Mode hover style) instead of a subtle highlight.
 * Fixed: Toggle row description text didn’t have a Dark Mode color override.
 * Fixed (frontend result cards — Classic, Minimal, Shop Card, Dark Overlay): card
   title, excerpt, and meta text colors were hardcoded instead of using the theme-
   aware card tokens, so they could become unreadable (dark text on a dark card)
   when a visitor’s OS/browser was in Dark Mode.
 * Fixed (frontend result cards): posts with no featured image rendered a completely
   unstyled, invisible placeholder box, making the grid look broken. Now shows a
   proper icon placeholder tile.
 * Fixed (frontend result cards): the meta separator dot’s CSS class didn’t match
   the class actually rendered by the JS, so it was never styled.
 * Fixed (frontend result cards): the card border color was set but no border width/
   style was ever defined, so it had no visible effect.
 * Improved: Completed translation-readiness (`wp.i18n`) coverage across the admin
   dashboard — previously only partially applied to one screen, now covers every
   page, component, and error message.
 * Improved (frontend result cards): new cards appended via Load More / Infinite
   Scroll now fade and rise into place instead of popping in abruptly.
 * Improved (frontend result cards): general visual polish across all four card 
   styles — refined shadows, sale badge, price layout, buttons, and Dark Overlay
   gradient.
 * Improved: Button/Color/Image display styles track their selected state via both
   CSS and JS, so the highlight still works correctly on older browsers without `:
   has()` support.

Not included in this release (planned for later): a «Tabbing» category-switcher 
display style, and wishlist add/remove — both are on the roadmap.

#### 1.1.0

**WooCommerce-aware card styles, split filters across the page, and a mobile-friendly
admin dashboard.**

 * Added: New «Card Style» tab in the Query editor — choose between Classic, Minimal,
   Shop Card (WooCommerce-aware, with price/sale badge/Add to Cart), and Dark Overlay
   layouts per query.
 * Added: WooCommerce product data (price, sale status, Add to Cart) is now available
   to grid cards and custom card templates when the connected query targets Products.
 * Added: `{{price}}`, `{{sale_badge}}`, and `{{add_to_cart}}` tokens for custom
   card templates.
 * Added: `only` attribute on `[captaf-filter]` (and matching «Only These Filters»
   fields in the Elementor widget and Gutenberg block) — show just specific filter(
   s) from a Filter Set. Place pieces of one filter set independently anywhere on
   the page (e.g. a dropdown in the header, checkboxes in the sidebar) — every piece
   still updates the same results grid.
 * Added: Filter Sets list now has a «Split into N individual shortcodes» toggle
   per row — expands to show each filter’s own ready-made shortcode (with `only=`
   already filled in) plus a Copy button, so you don’t need to remember or type 
   filter keys by hand. The same per-filter shortcode also shows inline in the Filter
   Set editor, next to each filter’s Label/Key fields.
 * Added: Responsive mobile navigation for the admin dashboard — a hamburger menu
   opens an off-canvas sidebar on small screens.
 * Changed: Filter Sets editor is now an inline page (matching Queries) instead 
   of a popup modal — title swaps to «Edit Filter Set», action button becomes «Back».
 * Fixed: Elementor widgets and Gutenberg blocks did not load their CSS/JS on the
   live frontend — only shortcode usage was detected before, so filters rendered
   unstyled and without AJAX on pages built with the Elementor widgets or Gutenberg
   blocks. Asset loading now also detects Gutenberg blocks and Elementor widget 
   data correctly.
 * Fixed: Plugin description referenced Bricks Builder as a supported integration
   without qualification. Updated to clearly state Bricks support is coming soon,
   matching the Builder Integrations section.
 * Removed: Unused «Layouts» feature (database table, REST endpoint, and related
   Layout ID fields in the Elementor widget and Gutenberg block) that had no admin
   UI to create layouts and could never be used.
 * Improved: All admin dashboard, block editor, and frontend JS strings are now 
   translation-ready via `wp.i18n`.
 * Improved: Deduplicated the compiled admin dashboard stylesheet, cutting its size
   by roughly 30% and fixing a broken CSS selector left over from a previous patch.
 * Improved: Redesigned the per-filter shortcode callout to be properly theme-aware(
   fixes it looking broken/mismatched in dark mode) and visually clearer.
 * Improved: Cleaned up redundant code in admin menu registration.

#### 1.0.0

**Initial stable release.**

 * Added six filter types: Checkbox, Radio, Dropdown, Range Slider, Search, A–Z 
   Alphabetical
 * Added three pagination modes: Numbered Pagination, Load More, Infinite Scroll
 * Added Elementor widgets.
 * Added Gutenberg blocks.
 * Added Visual Query Builder for creating reusable post queries.
 * Added Filter Set Builder with support for multiple filters.
 * Added customizable grid layouts with column switcher support.
 * Added AJAX filtering with live result updates.
 * Added live result count shortcode.
 * Added four frontend shortcodes: `[captaf-filter]`, `[captaf-grid]`, `[captaf-
   pagination]`, `[captaf-count]`
 * Added caching support for improved performance.
 * Added React-powered admin dashboard.
 * Added integrations page and plugin settings.
 * Added REST API for frontend filtering and admin management.
 * Added conditional asset loading for better frontend performance.
 * Added security hardening and input sanitization.
 * Added dark and light theme groundwork for the admin dashboard (theme switcher
   UI present, coming soon).

## Meta

 *  Version **1.2.0**
 *  ئاخىرقى يېڭىلانغان ۋاقىت **4 كۈن بۇرۇن**
 *  ئاكتىپ ئورنىتىش سانى **10 دىن ئاز**
 *  WordPress نەشرى ** 6.0 ياكى يۇقىرى **
 *  **7.0.2** دا سىنالغان
 *  PHP نەشرى ** 7.4 ياكى يۇقىرى **
 *  تىل
 * [Bhojpuri](https://bho.wordpress.org/plugins/captain-advance-filter/)، [Dutch](https://nl.wordpress.org/plugins/captain-advance-filter/)،
   [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/captain-advance-filter/)،
   [Emoji](https://emoji.wordpress.org/plugins/captain-advance-filter/)، [English (US)](https://wordpress.org/plugins/captain-advance-filter/)،
   [Gujarati](https://gu.wordpress.org/plugins/captain-advance-filter/)، [Hindi](https://hi.wordpress.org/plugins/captain-advance-filter/)،
   [Marathi](https://mr.wordpress.org/plugins/captain-advance-filter/)، [Panjabi (India)](https://pan.wordpress.org/plugins/captain-advance-filter/)
   ۋە [Russian](https://ru.wordpress.org/plugins/captain-advance-filter/).
 *  [تىلىڭىزغا تەرجىمە قىلىڭ](https://translate.wordpress.org/projects/wp-plugins/captain-advance-filter)
 * بەلگە
 * [ajax filter](https://ug.wordpress.org/plugins/tags/ajax-filter/)[elementor](https://ug.wordpress.org/plugins/tags/elementor/)
   [gutenberg](https://ug.wordpress.org/plugins/tags/gutenberg/)[product filter](https://ug.wordpress.org/plugins/tags/product-filter/)
   [woocommerce filter](https://ug.wordpress.org/plugins/tags/woocommerce-filter/)
 *  [ئالىي كۆرۈنۈش](https://ug.wordpress.org/plugins/captain-advance-filter/advanced/)

## دەرىجە

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/captain-advance-filter/reviews/#new-post)

[بارلىق ئىنكاسنى كۆرسەت](https://wordpress.org/support/plugin/captain-advance-filter/reviews/)

## تۆھپىكار

 *   [ Devang Vachheta ](https://profiles.wordpress.org/devangvachheta/)

## قوللاش

چۈشەندۈرۈشىڭىز بارمۇ؟ ياردەم لازىممۇ؟

 [قوللاش مۇنبىرىنى كۆرسەت](https://wordpress.org/support/plugin/captain-advance-filter/)