forked from ryanwelcher/advanced-query-loop
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
186 lines (137 loc) · 6.49 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
=== Advanced Query Loop ===
Contributors: welcher
Tags: Query Loop, Custom Queries
Requires at least: 6.2
Tested up to: 6.5.2
Stable tag: 3.2.0
Requires PHP: 7.4
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
A Query Loop block variation that provides controls to build more complicated queries.
== Description ==
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](https://wordpress.org/support/plugin/advanced-query-loop/) forum or the [official repository](https://github.com/ryanwelcher/advanced-query-loop) for any questions or to log issues.
=== Available Controls ===
==== Disable Pagination ====
Improve the performance of the query by disabling pagination
==== 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.
==== Exclude posts by category ====
Choose to exclude posts from a list of categories
==== 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.
2. Create complicated queries for post types with registered post meta.x
3. Query posts before a date, after a date or between two dates.
== Changelog ==
= 3.2.0 =
* Adds the ability to exclude posts by category (props @ghost-ng)
* Adds the ability to disable pagination.
* Deprecate controls that were moved into the Query Loop block in Gutenberg 19.
* Fix fatal error when post include array was empty.
= 3.1.1 =
* Add better SVG that works in all usages
* Change ranges to allow to not include the current date
* Trim whitespace from title.rendered
= 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.