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/muhammad-afaque/acf-flexible-filters/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.
A WordPress plugin that provides dynamic AJAX-powered filters for ACF Flexible Content fields with Redis caching integration.
Core Features
Filter System
- Dynamic AJAX-based filtering
- Real-time results without page reload
- Custom taxonomy (collection) support
- Flexible content field integration
- Search functionality within filter groups
Caching Architecture
- Redis caching integration
- Transient fallback system
- Pattern-based cache clearing
- Automatic cache invalidation
- Performance-optimized queries
Performance Features
- Lazy loading via AJAX
- Optimized database queries
- Cached filter results
- Memory-efficient processing
- Batch product processing
Technical Requirements
- WordPress 5.0+
- PHP 7.4+
- Advanced Custom Fields Pro
- Redis (recommended)
- WP Redis Object Cache plugin (for Redis integration)
Installation
- Upload plugin to
/wp-content/plugins/ - Activate through WordPress admin
- Configure Redis in wp-config.php (optional):
define('WP_REDIS_HOST', '127.0.0.1'); define('WP_REDIS_PORT', 6379); define('WP_REDIS_TIMEOUT', 1);
Cache Management
Automatic Cache Clearing
- On product save/update
- When collections are modified
- Through admin bar clear cache button
Cache Implementation
- Primary: Redis object cache
- Fallback: WordPress transients
- Cache key pattern:
acf_filter_sidebar_{term_id} - Pattern-based clearing:
acf_filter_result_*
Usage
Filter Implementation
// Add filters to template
echo acf_flexible_filters_render_groups($filters);
Available Hooks
// Filter rendering
add_filter('acf_flexible_filters_render', 'your_function');
// Cache duration
add_filter('acf_flexible_filters_cache_duration', 'your_function');
Admin Features
- Clear cache button in admin bar
- Automatic cache management
- Collection-specific filtering
Ajax Features
- Dynamic content loading
- Pagination support
- Real-time filter updates
- Search within filter groups
- Filter combination support
Performance Optimization
Query Optimization
- Uses WP_Query with specific field selection
- Cached results for repeated queries
- Optimized meta queries
- Efficient data structuring
Memory Management
- Batch processing for large datasets
- Garbage collection handling
- Memory limit considerations
- Cache compression
Support
For technical support and feature requests, please contact plugin developer.
License
GPL v2 or later
Note: Redis integration is recommended for optimal performance but not required. The plugin will fallback to WordPress transients when Redis is unavailable.