Advanced Query Loop

June 24, 2024

Advanced Query Loop Plugin

A Query Loop block variation that provides controls to build more complicated queries.

This plugin introduces a Query Loop block variation that will empower users to be able to do much more complicated queries with the Query Loop block, such number of posts to display and post meta

Support/Issues

Please use the either the support forum or the official repository for any questions or to log issues.

Available Controls

Multiple post types

Select additional post types for your query!

Post Count

Set the number of items you want to display (up to 50).

Include Posts

Choose the posts you want to display manually.

Exclude current post

Remove the current post from the query.

Offset

Choose whether you want to start at the first or 100th!

Post Meta Query

Generate complicated post meta queries using an interface that allows you to create a query based on meta_key, meta_value and the compare options. Combine multiple queries and determine if they combine results (OR) or narrow them down (AND).

Date Query

Query items before a date, after a date or between two dates or choose to show the post from the last 1, 3, 6 and 12 months.

Post Order controls

Sort in ascending or descending order by:

  • Author
  • Date
  • Last Modified Date
  • Title
  • Meta Value
  • Meta Value Num
  • Random
  • Menu Order (props to @jvanja)
  • Name (props @philbee)
  • Post ID (props to @markhowellsmead)

Please note that this is a slight duplication of the existing sorting controls. They both work interchangeably but it just looks a bit odd in the UI

Screenshots

  1. Select how many posts you want to display and the number to start at.

    Select how many posts you want to display and the number to start at.

  2. Create complicated queries for post types with registered post meta.x

    Create complicated queries for post types with registered post meta.x

  3. Query posts before a date, after a date or between two dates.

    Query posts before a date, after a date or between two dates.

Changelog

3.1.0

  • Add dynamic date ranges to see posts from the last 1, 3, 6 and 12 months.
  • Insert a new instance by typing “AQL” or “aql” and pressing enter.
  • Adds sorting by Name (props @philbee).
  • Bug fixes.

3.0.1

  • Addresses some PHP fatal errors caused by type hinting.

3.0.0

  • Add Sorting by Included Posts IDs.
  • Add sorting by Comment Count.
  • Major restructure for processing the query params.
  • Add release-drafter workflow.

2.2.5

  • Fixes issue with Exclude Current Post not being correctly set on templates.

2.2.4

  • Fixes an issue with the Exclude Current Post toggle causing the block to crash in some circumstances

2.2.3

  • Adds a Include Posts tool to allow manual curation of content to display (@props jenniferfarhat)

2.1.3

  • Fixes issues in PHP 8 and the date query. (props @krokodok)

2.1.2

  • Fixes issue with empty search parameter causing incorrect template to load (props @StreetDog71)
  • Fixes issue with all post type not being loaded ( props @aaronware)

2.1.1

  • Fixes issue with multiple AQL instances having settings leaked to each other.

2.1.0

  • ACF custom fields now show in the auto-complete dropdown list for Post Meta Queries ( props to @jvanja )
  • Adds sort by Post ID ( props to @markhowellsmead )
  • Fixes a typo in the Order By label.
  • Fixes a bug where a second AQL instances was getting post meta query values from the first.

2.0.0

  • Due to a change in core, Post Count can no longer be overridden when the block is set to inherit the query.
  • Adds Exclude current post option. Props to @Pulsar-X
  • Bump Tested Up To for 6.4
  • Adds better instructions for creating extension plugins.

1.5.1

  • Adds EXISTS as a compare option for Post Meta Queries.

1.5

  • Moves all controls into a single panel titled “Advanced Query Settings”.
  • Exposes SlotFills and filters to allow extension of plugin to add any featured you want.
  • Minor PHP warning fixes.

1.4.3

  • Addresses translations from https://translate.wordpress.org/ not loading. HUGE thank you to @himaartwp for opening the issue and to everyone that helped with the Japanese translation!
  • Fixes minor php warnings in the editor

1.4.2

  • Addresses an issue where noindex was being added incorrectly due to an empty parameter. Props to @pedjas for reporting.
  • Small fixes to address some PHP warnings.

1.4.1

  • Small fixes to address some PHP warnings.

1.4.0

  • Adds Menu Order to the sort by options. Props to @jvanja for the Pull Request *

1.3.0

  • Adds support for sorting by Meta Value, Meta Value Num, and Random.
  • Adds transform to convert existing Query Loop instances into Advanced Query Loop blocks.
  • Adds a release command.
  • Adds support for querying multiple post types.

1.2.1

  • Fixes missing controls when not inheriting the query. Props to @cvladan for opening the support thread.

1.2.0

  • Introduce Post Order controls to sort by Author, Date, Last Modified Date, or Title in ascending or descending order. Props to @asterix for the suggestion of adding Last Modified Date.
  • Enable Post Count and Post Order controls even when inheriting the query.

1.1.0

  • Allow manual input of post meta. Props to @svenl77 for opening the support thread.

1.0.5

  • PRO TIP: Include the PHP files when you release the plugin :/

1.0.4

  • Adds custom icon.
  • Under the hood restructuring of code.

1.0.3

  • Small fix for PHP 8. Props to @markus9312 for opening the support thread.

1.0.2

  • Fix various PHP notices. Props to @wildworks for opening the support thread.
  • Add some information to the readmes.

1.0.1

  • Small fix to no longer show an empty pattern after inserting the block.

1.0.0

  • Initial release with support for post count, offset, post meta, and date queries.

Details

  • Version: 3.1.0
  • Active installations: 1,000
  • WordPress Version: 6.2
  • Tested up to: 6.5.5
  • PHP Version: 7.4

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars