Skip to content

Commit e41b2cf

Browse files
ryanwelcherryanwelcher
committed
AI-ify the readme.
1 parent d651a10 commit e41b2cf

File tree

1 file changed

+116
-36
lines changed

1 file changed

+116
-36
lines changed

‎readme.txt‎

Lines changed: 116 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,71 +1,151 @@
11
=== Advanced Query Loop ===
22
Contributors: welcher
3-
Tags: Query Loop, Custom Queries
3+
Tags: Query Loop, Custom Queries, Advanced Queries, Post Meta, Taxonomy, Date Queries
44
Requires at least: 6.2
55
Tested up to: 6.8.1
66
Stable tag: 4.2.0
77
Requires PHP: 7.4
88
License: GPL v2 or later
99
License URI: https://www.gnu.org/licenses/gpl-2.0.html
1010

11-
A Query Loop block variation that provides controls to build more complicated queries.
11+
Transform your Query Loop blocks into powerful, flexible content engines! 🚀
1212

1313
== Description ==
14-
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
1514

16-
=== Support/Issues ===
17-
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.
15+
**Supercharge your queries without any code**
1816

19-
=== Available Controls ===
17+
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.
2018

21-
==== Taxonomy queries ====
19+
**What makes Advanced Query Loop special?**
2220

23-
Built complicated taxonomy queries!
21+
* **No coding required** - Everything works through an intuitive visual interface
22+
* **Powerful query building** - Create complex queries that would normally require custom code
23+
* **Flexible and extensible** - Built with developers in mind, but accessible to everyone
24+
* **Performance optimized** - Smart caching and efficient queries keep your site fast
2425

25-
==== Multiple post types ====
26+
=== Support & Community ===
2627

27-
Select additional post types for your query!
28+
Need help? We've got you covered!
2829

29-
==== Include Posts ====
30+
* **WordPress.org Support Forum**: [Get help here](https://wordpress.org/support/plugin/advanced-query-loop/)
31+
* **GitHub Repository**: [Report issues & contribute](https://github.com/ryanwelcher/advanced-query-loop)
3032

31-
Choose the posts you want to display manually or only the children of the current content.
33+
=== Powerful Features at Your Fingertips ===
3234

33-
==== Exclude current post ====
35+
==== 🏷️ Advanced Taxonomy Queries ====
3436

35-
Remove the current post from the query.
37+
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.
3638

37-
==== Exclude posts by category ====
39+
==== 📝 Multiple Post Types ====
3840

39-
Choose to exclude posts from a list of categories.
41+
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.
4042

41-
==== Post Meta Query ====
43+
==== 🎯 Smart Post Inclusion ====
4244

43-
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).
45+
Take full control over which posts appear in your query:
46+
* **Manual selection**: Choose specific posts by title or ID
47+
* **Child items only**: Show only child posts of the current content
48+
* **Dynamic filtering**: Combine multiple inclusion rules
4449

45-
==== Date Query ====
50+
==== 🚫 Intelligent Post Exclusion ====
4651

47-
Query items before/after the current or selected or choose to show the post from the last 1, 3, 6 and 12 months.
52+
Keep your queries clean and relevant:
53+
* **Exclude current post**: Automatically hide the post being viewed
54+
* **Category filtering**: Exclude posts from specific categories
55+
* **Smart defaults**: Built-in logic to avoid duplicate content
4856

49-
==== Post Order controls ====
57+
==== 🔍 Advanced Post Meta Queries ====
5058

51-
Sort in ascending or descending order by:
59+
Create powerful meta queries without touching code:
60+
* **Multiple conditions**: Combine different meta fields and values
61+
* **Flexible comparisons**: Use equals, not equals, greater than, less than, and more
62+
* **Logical operators**: Combine queries with AND/OR logic
63+
* **ACF integration**: Works seamlessly with Advanced Custom Fields
5264

53-
- Author
54-
- Date
55-
- Last Modified Date
56-
- Title
57-
- Meta Value
58-
- Meta Value Num
59-
- Random
60-
- Menu Order (props to @jvanja)
61-
- Name (props @philbee)
62-
- Post ID (props to @markhowellsmead)
65+
==== 📅 Dynamic Date Queries ====
6366

64-
**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**
67+
Time-based content has never been easier:
68+
* **Relative dates**: Show content from last 1, 3, 6, or 12 months
69+
* **Before/after current**: Display content relative to the current date
70+
* **Custom date ranges**: Set specific start and end dates
71+
* **Multiple date conditions**: Combine different date rules
6572

66-
==== Disable Pagination ====
73+
==== 📊 Flexible Sorting Options ====
6774

68-
Improve the performance of the query by disabling pagination.
75+
Sort your content exactly how you want:
76+
* **Author**: Sort by post author
77+
* **Date**: Sort by publication date
78+
* **Last Modified**: Sort by last update
79+
* **Title**: Alphabetical sorting
80+
* **Meta Values**: Sort by custom field values
81+
* **Random**: Shuffle your content
82+
* **Menu Order**: Use custom ordering
83+
* **Name**: Sort by post slug
84+
* **Post ID**: Sort by post ID
85+
* **Comment Count**: Sort by engagement
86+
87+
==== ⚡ Performance Optimization ====
88+
89+
* **Smart pagination**: Automatically disable pagination when not needed
90+
* **Efficient queries**: Optimized database queries for better performance
91+
* **Caching friendly**: Works seamlessly with popular caching plugins
92+
93+
=== Customization & Extensibility ===
94+
95+
==== Filter Available Controls ====
96+
97+
Don't need all the features? No problem! You can easily hide specific controls using the `aql_allowed_controls` filter:
98+
99+
`
100+
add_filter(
101+
'aql_allowed_controls',
102+
function( $controls ) {
103+
// Remove specific controls you don't need
104+
$to_exclude = array( 'additional_post_types', 'taxonomy_query_builder' );
105+
return array_filter( $controls, function( $control ) use ( $to_exclude ) {
106+
return ! in_array( $control, $to_exclude, true );
107+
} );
108+
}
109+
);
110+
`
111+
112+
==== Available Control Identifiers ====
113+
114+
* `'additional_post_types'` - Multiple post type selection
115+
* `'taxonomy_query_builder'` - Advanced taxonomy queries
116+
* `'post_meta_query'` - Meta field queries
117+
* `'post_order'` - Sorting options
118+
* `'exclude_current_post'` - Current post exclusion
119+
* `'include_posts'` - Manual post inclusion
120+
* `'child_items_only'` - Child post filtering
121+
* `'date_query_dynamic_range'` - Date range queries
122+
* `'date_query_relationship'` - Date query logic
123+
* `'pagination'` - Pagination controls
124+
125+
==== Developer-Friendly ====
126+
127+
Advanced Query Loop is built with developers in mind:
128+
* **Extensible architecture**: Add your own custom controls
129+
* **Well-documented hooks**: Easy integration with your themes and plugins
130+
* **Clean code**: Follows WordPress coding standards
131+
* **Comprehensive testing**: Thoroughly tested for reliability
132+
133+
=== Getting Started ===
134+
135+
1. **Install and activate** the plugin
136+
2. **Add a Query Loop block** to your page or post
137+
3. **Look for the "Advanced Query Loop" variation** in the block inserter
138+
4. **Configure your query** using the intuitive controls
139+
5. **Preview and publish** your dynamic content!
140+
141+
=== Perfect For ===
142+
143+
* **Portfolio websites** - Showcase work with sophisticated filtering
144+
* **News and magazine sites** - Display content by category, date, and more
145+
* **E-commerce sites** - Filter products by custom fields and taxonomies
146+
* **Educational platforms** - Organize content by course, level, or topic
147+
* **Real estate sites** - Filter properties by location, price, and features
148+
* **Any site needing advanced content queries** - The possibilities are endless!
69149

70150
== Screenshots ==
71151

@@ -80,7 +160,7 @@ Improve the performance of the query by disabling pagination.
80160

81161
= 4.1.2=
82162
* Harden up the code to remove a warning.
83-
* Resurrect the disable pagination toggle.
163+
* Resurrect the disable pagination toggl
84164

85165
= 4.1.1=
86166
* Allow extended orderby values for all publicly queryable post types (props @ocean90)

0 commit comments

Comments
 (0)