-
Notifications
You must be signed in to change notification settings - Fork 6
/
README.txt
400 lines (257 loc) · 12.1 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
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
=== Query Wrangler ===
Contributors: daggerhart
Donate link: https://www.daggerhart.com/
Tags: query, pages, widget, admin, widgets, administration, manage, views, loop
Requires at least: 4
Tested up to: 6.2
Stable tag: trunk
Query Wrangler provides an intuitive interface for creating complex WP queries as shortcodes and widgets. UI based on Drupal Views.
== Description ==
This plugin lets you create new WP queries as widgets and use shortcodes for queries on your pages. It also allows you to override the way category and tag pages display.
Query Wrangler's interface is highly intuitive way to create queries and will be second nature for any Drupal Views user.
This plugin will bring extreme flexibility to WordPress users with its ability to create custom queries using the WP_Query class with a user interface.
Supports:
* Most post data, including meta fields
* Taxonomy data
* Advanced Custom Fields
* Custom Content Type Manager
* Some exposed filters
Some examples of how you would use this plugin include:
* Create a list posts with featured images
* Create a list of pages or posts within a specific category or tag
* Create an image gallery
* Modify the way your category pages look
== Installation ==
1. Upload `query-wrangler` to the `/wp-content/plugins/` directory
1. Activate the plugin
1. Visit the Query Wrangler Menu to begin creating your custom queries
== Frequently Asked Questions ==
= How do I use query shortcodes? =
Easy, the code you're looking for is like this. [query id=2] , where the number 2 is the query id. This can be found on the Query Wrangler page eside each query.
* By slug: [query slug="my-query"]
* Customize WP_Query arguments: [query id=2 args="posts_per_page=1&post_type=page"]
* Customize WP_Query arguments with contextual data: [query id=1 args="author={{post:post_author}}&post_type={{post:post_type}}"]
= Developer & Usage =
* [Meta Field Display Handler: Advanced Custom Fields](https://wordpress.org/support/topic/how-to-get-he-image-url-instead-of-image-id?replies=5#post-5411991 "Meta Field Display Handler: Advanced Custom Fields")
* [Sort by Meta value](https://wordpress.org/support/topic/orderby-meta_value-1#post-6719953 "Sort a query by meta values")
* [Meta Field Display Handler: Custom Content Type Manager](http://wordpress.org/support/topic/cant-put-php-code-into-rewrite-results-field?replies=4#post-5411970 "Meta Field Display Handler: Custom Content Type Manager")
* [Custom field example](https://gist.github.com/daggerhart/10417309 "Custom field example")
* [Field callback usage: wp_get_attachment_url](http://wordpress.org/support/topic/add-php-in-rewrite-output-of-this-field?replies=3#post-5480638 "Callback field usage")
* [Field callback usage: the_tags](http://wordpress.org/support/topic/callback-field-plugin-version-1524?replies=1#post-5487515 "Callback field usage 2")
* [Filter callback usage: ](https://wordpress.org/support/topic/filter-by-subquery?replies=3#post-6719945 "Filter Callback usage")
* [Query Slideshow](http://wordpress.org/extend/plugins/query-slideshow/ "Query Slideshow") - Example of creating a custom style. Turn your queries into slideshows using jquery.cycle
= What are overrides and how do I use them? =
Overrides allow you to alter the display and information given on category and tag pages.
For a simple example, add a new query and chose the type `override`. Choose how you want the content to display, then examine the `Overrides` box.
Select a category or multiple categories to override. Save the query, then visit that category page.
== Screenshots ==
1. Drupal Views Editor Theme
== Changelog ==
= 1.5.53 =
* Bug fix on post type archive override page when dealing with multiple post types.
= 1.5.52 =
* New setting to allow caching of meta keys.
= 1.5.51 =
* Tested up to WordPress 5.8-RC4.
* Minor style improvement on editor form.
= 1.5.50 =
* Bug fix: Regression in 1.5.49. Redundant dispatch of qw_pre_render broke QW widgets.
= 1.5.49 =
* Feature: Setting to hide header or footer when no results are found.
= 1.5.48 =
* Bug fix: Fix regression with pagination vs offset.
= 1.5.46 =
* Bug fix: removing debugging function.
* Bug fix: Pagination vs offset. WP_Query doesn't handle this, so we do it manually.
* Bug fix: Caching for expensive meta keys query on large sites.
= 1.5.45 =
* Bug fix: Pagination vs offset. WP_Query doesn't handle this, so we do it manually.
* Bug fix: @jpSimkins - Caching for expensive meta keys query on large sites.
= 1.5.43 =
* Bug fix: Using array_replace instead of array_merge in a few places.
* Bug fix: Removing deprecated preg_replace eval flag for PHP 7 support.
= 1.5.42 =
* Feature: Search box on query list page
* Feature: Strip tags on Group by field
* Feature: Added query shortcode by ID on edit page
* Bug fix: Maintain token settings in later fields
* Bug fix: Query data doesn't unserialize correctly in some environments
* Bug fix: Query wasn't retaining Group by field in editor
* Bug fix: JSON export may not load correctly
= 1.5.41 =
* Feature: Contextual tokens allowed in callback text parameters
* Change: Now using json for export & import to avoid eval. Warning, his will make existing saved exports useless.
* Change: HTML span tag around file attachments for styling
* Bug fix: Providing simple array polyfills for PHP5.2-
* Bug fix: Some php notices on query creation & save
* Bug fix: Query data doesn't appear to save. Unserialize method was sometimes failing when loading a query in the editor.
* Bug fix: Allow nested limited terms in filters
= 1.5.40 =
* Bug fix: New meta field setting compared too strictly
* Bug fix: Exposed Taxonomy filter not showing values when unlimited.
= 1.5.39 =
* Bug fix: Pagination
* Bug fix: Tag & Category override data storage
* Bug fix: Meta value filter compare field value
* Bug fix: Taxonomy exposed filter retaining values after submit
* Feature: Shortcode compatibility for conflicts on the "query" shortcode
* Feature: Contextual tokens on post_id filter
= 1.5.38 =
* Upkeep: Renaming .inc files to .php
* Upkeep: Changing source whitespace
* Bug fix: Better restriction for admin_head hook
* Feature: new row classes query-row-first, query-row-last
= 1.5.37 =
* PHP updated for WP 4.3
= 1.5.36 =
* Feature: New meta_value field handler as a setting. Autocomplete on the field.
= 1.5.35 =
* Bug fix: missing jQuery ui css
* Bug fix: not-linked avatar field
* Bug fix: first field weight
* Feature: custom classes on fields
= 1.5.34 =
* Feature: "active-item" class on rows whose post is currently being viewed.
* Feature: Group by field in Row Style > Field Settings (requires saving the query before choosing)
= 1.5.33 =
* Cleaned up a lot of PHP warnings and notices
= 1.5.32 =
* Better Overrides
* Feature: meta_query filter
* Feature: Override entire taxonomy
* Feature: Extended callback field to include text parameters
* Feature: Callback filter
* UI bug fixes with rearranging handler items and field tokens
* UI bug fix regarding canceling and new handler items dialog
= 1.5.31 =
* Feature: Fields can now be hidden if empty
* Feature: New setting "Show silent meta" allow for custom fields that start with underscores.
* Feature: post_id filter can now use a callback to provide an array of post ids
* Feature: New sort "meta_value" - for sorting strings
* Feature: New sort "Meta_value_num" - for sorting numbers
* Feature: New filter "Search" - for searching
* Changed get_category_ids() to get_terms()
* Minor UI improvements
= 1.5.30 =
* Feature: post content and post excerpt fields have new option to apply the_content filter
* Feature: new sort option: post__in to sort by order of post__in filter array
* New shortcode hooks for custom attributes and query options
* Bug fix: is_array check for missing override value
* Bug fix: category__not_in needs term ids as array
= 1.5.26 =
* Bug fix: Admin UI fix on WP 4.1
= 1.5.25 =
* Bug fix: qw_pre_query & qw_pre_render hooks
* Bug fix: Plugin activation warnings
* Bug fix: Import textarea CSS
* Bug fix: Live Preview error on new query
* Feature: Show Display Title on widget with or without theme compatibility
* Feature: Arguments field on widgets
= 1.5.24 =
* New: Callback field - Use any function to provide a field value.
* New: Shortcode argument contextual tokens. eg, [query id=1 args="author={{post:post_author}}&post_type={{post:post_type}}"] - returns the query showing only posts by the author of the current page being viewed, and of the post type of the current post_type being viewed.
* Fix: index on query_override_terms table
= 1.5.23 =
* New: Shortcode arguments. eg, [query id=1 args="posts_per_page=1&post_type=page"]
* New: Support for "Advanced Custom Fields" fields as settings for meta_values
* New: Support for "Custom Content Type Manager" fields as settings for meta_values
= 1.5rc22 =
* Bug fix: Empty request_uri causing issues.
= 1.5rc21 =
* New: Field - Featured Image
* New: Exposed filter - Post IDs
* New: Exposed filter - Post Parent
* New: Exposed filter - Post Types
* New: Exposed filter - Taxonomies
* New: Setting - Live Preview default
* Fix: Image field style setting
= 1.5rc20 =
* Updating template wrangler to use apply_filters instead of do_action_ref_array
= 1.5rc19 =
* Feature: New author filter
= 1.5rc18 =
* Fix: Pagination bug when using Page numbers.
= 1.5rc17 =
* Fix: post_parent filter
= 1.5rc16 =
* Feature: New taxonomies filter
* Feature: Featured Image setting for "Image Attachment" field
* Fix: Making js better
* Fix: New handler item weight bug
* Fix: New field tokens bug
* Remove: tabs editor
* Refactoring a lot
= 1.5rc15 =
* Compatibility issues with Widget Wrangler
* Feature: Template suggestions in preview.
= 1.5rc14 =
* Fix: Child theme page templating
* Fix: Comment disabling works on pages with shortcodes
* Feature/Fix: Theme compatibility for widgets - enable in QW settings.
= 1.5rc13 =
* Fix: Shortcode & Widget paging - but can't have 2 independent pagers on 1 page yet.
* Fix: Unserialize bug - http://wordpress.org/support/topic/bug-that-wipes-all-settings-of-query-after-excluding-fields-from-display?replies=2
* Fix: 3.7 problem - according to - http://wordpress.org/support/topic/update-has-broken-site#post-4868397
* Fix: Row style settings form bug
* More complete default query according to WP_Query defaults
* Feature: PHP WP_Query in preview
= 1.5rc12 =
* New page routing with hook parse_request
= 1.5rc11 =
* Chasing WP 3.7 related bugs
= 1.5rc10 =
* UI fixes and improvements.
= 1.5rc9 =
* Fix: Wordpress 3.7 update redirecting from custom pages
= 1.5rc8 =
* Fix: Fixing sortable jquery ui issue. QW UI working w/ WP 3.5
= 1.5rc7 =
* Fix: No longer relying on external jquery sources, working to fix views ui
= 1.5rc6 =
* Fix: WP update broke jquery and jquery ui. now relying on external sources
= 1.5rc5 =
* Fix: bug, javascript sometimes enqueuing in wrong order (Google Libraries)
= 1.5rc4 =
* Fix: bug, custom label and rewrite output fields not showing up.
= 1.5rc3 =
* Fix: bug in looking for a query page's path
= 1.5rc2 =
* Fix: meta field returning array
* Fix: page links missing starting slash
= 1.5rc1 =
* Major API enhancements
* New simpler editor theme
* Lots of Refactoring
= 1.4.1beta =
* Template preprocess fix
= 1.4beta =
* Fixed override pagination
* UI Improvements
* Template hierarchy solidification
* Live Preview
* Meta Key / Value Filters
* Filter Api
= 1.3.2beta =
* Fixed template-wrangler comments bug
* Fixed display style bug
* Refactored javascript some
= 1.3beta1 =
* Added Wordpress hooks for fields, field styles, filters, and pagers
* Fixed some bugs with replacement tokens and rewriting output
* Fixed some templates from displaying excluded fields
* Determined methodology for field callbacks and arguments
* Shortcode support for fields
= 1.2beta3 =
* Bug fix for empty category and tag pages
* Bug fix for query shortcodes
= 1.2beta2 =
* Added shortcode support
= 1.2beta1 =
* Added Wordpress page overrides for categories and tags.
* Fixed query edit page js bug.
= 1.1beta =
* Bug with canceling forms. Changed use of jQuery unserializeForm
= 1.0beta =
* Initial Release
== Upgrade Notice ==
1.5.53 Bug fix on post type archive override page when dealing with multiple post types.