Advanced Query Loop

🚫 Intelligent Post Exclusion

Keep your queries clean and relevant: * Exclude current post : Automatically hide the post being viewed * Exclude a list of posts : Curate a list of posts to exclude from the query

🔍 Advanced Post Meta Queries

Create powerful meta queries without touching code: * Multiple conditions : Combine different meta fields and values * Flexible comparisons : Use equals, not equals, greater than, less than, and more * Logical operators : Combine queries with AND/OR logic * ACF integration : Works seamlessly with Advanced Custom Fields

📅 Dynamic Date Queries

Time-based content has never been easier: * Relative dates : Show content from last 1, 3, 6, or 12 months * Before/after current : Display content relative to the current date * Custom date ranges : Set specific start and end dates * Multiple date conditions : Combine different date rules

📊 Flexible Sorting Options

Sort your content exactly how you want: * Author : Sort by post author * Date : Sort by publication date * Last Modified : Sort by last update * Title : Alphabetical sorting * Meta Values : Sort by custom field values * Random : Shuffle your content * Menu Order : Use custom ordering * Name : Sort by post slug * Post ID : Sort by post ID * Comment Count : Sort by engagement * Included Posts : Sort by post inclusion order * Multi-property ordering : Order by multiple properties (primary + secondary sort), including meta values; posts without the meta key sort last in descending order. Applies to non-inherited queries only

⚡ Performance Optimization

• Disable pagination : Reduce query overhead by turning off pagination when it is not needed
• Enable caching : Store query results in a transient for one hour to reduce database load on subsequent page loads. The caching toggle is unavailable when the order is set to Random, and switching to Random order will clear any existing caching setting
• Efficient queries : Optimized database queries for better performance

🆔 Query Identifier

Give any AQL block a unique Query ID from the AQL: Advanced panel. Developers can then target that specific block with the aql_query_vars filter to modify its query arguments in code without affecting other Query Loop blocks on the page.

Customization & Extensibility

Filter Available Controls

Don’t need all the features? No problem! You can easily hide specific controls using the aql_allowed_controls filter:

add_filter( 'aql_allowed_controls', function( $controls ) { // Remove specific controls you don't need $to_exclude = array( 'additional_post_types', 'taxonomy_query_builder' ); return array_filter( $controls, function( $control ) use ( $to_exclude ) { return ! in_array( $control, $to_exclude, true ); } ); } );

Available Control Identifiers

• 'additional_post_types' – Multiple post type selection
• 'taxonomy_query_builder' – Advanced taxonomy queries
• 'post_meta_query' – Meta field queries
• 'post_order' – Sorting options
• 'exclude_current_post' – Current post exclusion
• 'exclude_posts' – Exclude a curated list of posts
• 'include_posts' – Manual post inclusion
• 'child_items_only' – Child post filtering
• 'date_query_dynamic_range' – Date range queries
• 'date_query_relationship' – Date query logic
• 'pagination' – Pagination controls
• 'enable_caching' – Query result caching
• 'query_id' – Query identifier for targeting a specific block in the aql_query_vars filter

Developer-Friendly

Advanced Query Loop is built with developers in mind: * Extensible architecture : Add your own custom controls * Well-documented hooks : Easy integration with your themes and plugins * Clean code : Follows WordPress coding standards * Comprehensive testing : Thoroughly tested for reliability

Getting Started

1. 01Install and activate the plugin
2. 02Add a Query Loop block to your page or post
3. 03Look for the “Advanced Query Loop” variation in the block inserter
4. 04Configure your query using the intuitive controls
5. 05Preview and publish your dynamic content!

Perfect For

• Portfolio websites – Showcase work with sophisticated filtering
• News and magazine sites – Display content by category, date, and more
• E-commerce sites – Filter products by custom fields and taxonomies
• Educational platforms – Organize content by course, level, or topic
• Real estate sites – Filter properties by location, price, and features
• Any site needing advanced content queries – The possibilities are endless!