Advanced Query Loop

外掛說明

Supercharge your queries without any code

Tired of the limitations of standard Query Loop blocks? Advanced Query Loop gives you the superpowers you need to create sophisticated, dynamic content queries that go far beyond the basics. Whether you’re building a portfolio, news site, or complex content hub, this plugin puts you in complete control of your content display.

What makes Advanced Query Loop special?

• No coding required – Everything works through an intuitive visual interface
• Powerful query building – Create complex queries that would normally require custom code
• Flexible and extensible – Built with developers in mind, but accessible to everyone
• Performance optimized – Smart caching and efficient queries keep your site fast

Support & Community

Need help? We’ve got you covered!

• WordPress.org Support Forum: Get help here
• GitHub Repository: Report issues & contribute

Powerful Features at Your Fingertips

🏷️ Advanced Taxonomy Queries

Build sophisticated taxonomy queries that let you filter content by multiple categories, tags, or custom taxonomies. Create complex relationships between different taxonomy terms to display exactly the content you want.

📝 Multiple Post Types

Don’t limit yourself to just posts! Query across multiple post types simultaneously. Perfect for portfolios, news sites, or any site that needs to display different types of content together.

🎯 Smart Post Inclusion

Take full control over which posts appear in your query:
* Manual selection: Choose specific posts by title or ID
* Child items only: Show only child posts of the current content
* Dynamic filtering: Combine multiple inclusion rules

🚫 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
* Category filtering: Exclude posts from specific categories

🔍 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

⚡ Performance Optimization

• Smart pagination: Automatically disable pagination when not needed
• Efficient queries: Optimized database queries for better performance
• Caching friendly: Works seamlessly with popular caching plugins

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
• '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

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. Install and activate the plugin
2. Add a Query Loop block to your page or post
3. Look for the “Advanced Query Loop” variation in the block inserter
4. Configure your query using the intuitive controls
5. Preview 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!