Media Library Assistant - Version 1.60

Version Description

  • New: [mla_tag_cloud] shortcode. Enhanced tag cloud for any taxonomy, with "grid" format, full Display Content and custom template support along the lines of [mla_gallery]. Paginated clouds are also supported. Full details in the Other Notes section and on the Settings/Media Library Assistant Documentation tab.
  • New: MLA Text Widget. You can add widgets containing [mla_gallery], [mla_tag_cloud] or any shortcode to the sidebars on your site. More information in the Other Notes section.
  • New: For [mla_gallery], new 'page_ID' and 'page_url' substitution parameters for easier 'mla_link_href' composition.
  • New: For [mla_gallery], link=span and link=none let you replace the hyperlink enclosing each gallery thumbnail with non-link content.
  • New: For [mla_gallery], default Style and Markup templates conform to WordPress 3.7 conventions. The "orientation" attribute has been added to Attachment-specific substitution parameters and as a Data Source for custom field mapping.
  • New: Enhanced IPTC/EXIF Taxonomy term mapping. You can now separate multiple terms contained in a single IPTC/EXIF value by specifying one or more delimiters. For example, specify ";" to separate values like "tag1; tag2" into separate terms.
  • New: For [mla_gallery], Support for Other Gallery-generating Shortcodes now includes the "enclosing shortcode" form. You can pass content to the alternate shortcode by coding something like [mla_gallery ids="1230,1227" mla_alt_shortcode=fsg_link mla_alt_ids_name=include class=button]View the gallery[/mla_gallery]. New filters are provided for inspecting/modifying the content.
  • Fix: On the Media/Assistant submenu, where-used errors are no longer returned for XHTML-style self-closing shortcodes, i.e., ending with "/]", and for tax_query and meta_query parameters containing substitution parameters.
  • Fix: Hiding the Media/Library submenu is now more reliable. The Media/Library submenu is hidden with a CSS style, but is still available for use by plugins such as Enable Media Replace. The Media/Assistant submenu is automatically moved up to the top of the submenu list. Attempts to display the Media/Library submenu, e.g., after deleting an item from the Edit Media screen, are redirected to the Media/Assistant submenu.
  • Fix: For the Settings/Media Library Assistant "Custom Fields" and "IPTC/EXIF" tabs, the "Add Rule/Add Field and Map All Attachments" buttons now map values correctly. In previous MLA versions, the rule was added but the attachment values were not mapped.
  • Fix: For [mla_gallery], array values are now accepted in [+request:+] substitution parameters, and the ,export option is supported as well. Array values can be passed from the URL or HTML forms to parameters that accept a list of values, such as taxonomy queries.
Download this release

Release Info

Developer dglingren
Plugin Icon 128x128 Media Library Assistant
Version 1.60
Comparing to
See all releases

Code changes from version 1.52 to 1.60

css/mla-nolibrary.css ADDED
@@ -0,0 +1,8 @@
 
 
 
 
 
 
 
 
1
+ @charset "utf-8";
2
+ /**
3
+ * CSS Document
4
+ *
5
+ * This file contains styling attributes for hiding the Media/Library submenu entry.
6
+ */
7
+
8
+ li#menu-media > ul > li.wp-first-item + li { display: none; }
examples/mla-cloud-hooks-example.php.txt ADDED
@@ -0,0 +1,701 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+ /**
3
+ * Provides an example of hooking the filters provided by the [mla_tag_cloud] shortcode
4
+ *
5
+ * In this example, the CSS style attributes for each cloud item are modified to include a "color" attribute,
6
+ * giving each term a color related to its associated count. The example documents ALL the filters
7
+ * available in the [mla_tag_cloud] shortcode.
8
+ *
9
+ * @package MLA Tag Cloud Hooks Example
10
+ * @version 1.00
11
+ */
12
+
13
+ /*
14
+ Plugin Name: MLA Tag Cloud Hooks Example
15
+ Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
16
+ Description: Provides an example of hooking the filters provided by the [mla_tag_cloud] shortcode
17
+ Author: David Lingren
18
+ Version: 1.00
19
+ Author URI: http://fairtradejudaica.org/our-story/staff/
20
+
21
+ Copyright 2013 David Lingren
22
+
23
+ This program is free software; you can redistribute it and/or modify
24
+ it under the terms of the GNU General Public License as published by
25
+ the Free Software Foundation; either version 2 of the License, or
26
+ (at your option) any later version.
27
+
28
+ This program is distributed in the hope that it will be useful,
29
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
30
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
31
+ GNU General Public License for more details.
32
+
33
+ You can get a copy of the GNU General Public License by writing to the
34
+ Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
35
+ */
36
+
37
+ /**
38
+ * Class MLA Tag Cloud Hooks Example hooks all of the filters provided by the [mla_tag_cloud] shortcode
39
+ *
40
+ * Call it anything you want, but give it an unlikely and hopefully unique name. Hiding enerything
41
+ * else inside a class means this is the only name you have to worry about.
42
+ *
43
+ * @package MLA Tag Cloud Hooks Example
44
+ * @since 1.00
45
+ */
46
+ class MLATagCloudHooksExample {
47
+ /**
48
+ * Initialization function, similar to __construct()
49
+ *
50
+ * @since 1.00
51
+ *
52
+ * @return void
53
+ */
54
+ public static function initialize() {
55
+ /*
56
+ * The filters are only useful for front-end posts/pages; exit if in the admin section
57
+ */
58
+ if ( is_admin() )
59
+ return;
60
+
61
+ /*
62
+ * add_filter parameters:
63
+ * $tag - name of the hook you're filtering; defined by [mla_tag_cloud]
64
+ * $function_to_add - function to be called when [mla_tag_cloud] applies the filter
65
+ * $priority - default 10; lower runs earlier, higher runs later
66
+ * $accepted_args - number of arguments your function accepts
67
+ *
68
+ * Comment out the filters you don't need; save them for future use
69
+ */
70
+ add_filter( 'mla_tag_cloud_attributes', 'MLATagCloudHooksExample::mla_tag_cloud_attributes_filter', 10, 1 );
71
+ add_filter( 'mla_tag_cloud_arguments', 'MLATagCloudHooksExample::mla_tag_cloud_arguments_filter', 10, 1 );
72
+ add_filter( 'mla_get_terms_query_attributes', 'MLATagCloudHooksExample::mla_get_terms_query_attributes_filter', 10, 1 );
73
+ add_filter( 'mla_get_terms_query_arguments', 'MLATagCloudHooksExample::mla_get_terms_query_arguments_filter', 10, 1 );
74
+ add_filter( 'mla_get_terms_query_results', 'MLATagCloudHooksExample::mla_get_terms_query_results_filter', 10, 1 );
75
+
76
+ add_filter( 'mla_tag_cloud_scale', 'MLATagCloudHooksExample::mla_tag_cloud_scale_filter', 10, 4 );
77
+
78
+ add_filter( 'use_mla_tag_cloud_style', 'MLATagCloudHooksExample::use_mla_tag_cloud_style_filter', 10, 2 );
79
+
80
+ add_filter( 'mla_tag_cloud_style_values', 'MLATagCloudHooksExample::mla_tag_cloud_style_values_filter', 10, 1 );
81
+ add_filter( 'mla_tag_cloud_style_template', 'MLATagCloudHooksExample::mla_tag_cloud_style_template_filter', 10, 1 );
82
+ add_filter( 'mla_tag_cloud_style_parse', 'MLATagCloudHooksExample::mla_tag_cloud_style_parse_filter', 10, 3 );
83
+
84
+ add_filter( 'mla_tag_cloud_open_values', 'MLATagCloudHooksExample::mla_tag_cloud_open_values_filter', 10, 1 );
85
+ add_filter( 'mla_tag_cloud_open_template', 'MLATagCloudHooksExample::mla_tag_cloud_open_template_filter', 10, 1 );
86
+ add_filter( 'mla_tag_cloud_open_parse', 'MLATagCloudHooksExample::mla_tag_cloud_open_parse_filter', 10, 3 );
87
+
88
+ add_filter( 'mla_tag_cloud_row_open_values', 'MLATagCloudHooksExample::mla_tag_cloud_row_open_values_filter', 10, 1 );
89
+ add_filter( 'mla_tag_cloud_row_open_template', 'MLATagCloudHooksExample::mla_tag_cloud_row_open_template_filter', 10, 1 );
90
+ add_filter( 'mla_tag_cloud_row_open_parse', 'MLATagCloudHooksExample::mla_tag_cloud_row_open_parse_filter', 10, 3 );
91
+
92
+ add_filter( 'mla_tag_cloud_item_values', 'MLATagCloudHooksExample::mla_tag_cloud_item_values_filter', 10, 1 );
93
+ add_filter( 'mla_tag_cloud_item_template', 'MLATagCloudHooksExample::mla_tag_cloud_item_template_filter', 10, 1 );
94
+ add_filter( 'mla_tag_cloud_item_parse', 'MLATagCloudHooksExample::mla_tag_cloud_item_parse_filter', 10, 3 );
95
+
96
+ add_filter( 'mla_tag_cloud_row_close_values', 'MLATagCloudHooksExample::mla_tag_cloud_row_close_values_filter', 10, 1 );
97
+ add_filter( 'mla_tag_cloud_row_close_template', 'MLATagCloudHooksExample::mla_tag_cloud_row_close_template_filter', 10, 1 );
98
+ add_filter( 'mla_tag_cloud_row_close_parse', 'MLATagCloudHooksExample::mla_tag_cloud_row_close_parse_filter', 10, 3 );
99
+
100
+ add_filter( 'mla_tag_cloud_close_values', 'MLATagCloudHooksExample::mla_tag_cloud_close_values_filter', 10, 1 );
101
+ add_filter( 'mla_tag_cloud_close_template', 'MLATagCloudHooksExample::mla_tag_cloud_close_template_filter', 10, 1 );
102
+ add_filter( 'mla_tag_cloud_close_parse', 'MLATagCloudHooksExample::mla_tag_cloud_close_parse_filter', 10, 3 );
103
+ }
104
+
105
+ /**
106
+ * Save the shortcode attributes
107
+ *
108
+ * @since 1.00
109
+ *
110
+ * @var array
111
+ */
112
+ private static $shortcode_attributes = array();
113
+
114
+ /**
115
+ * MLA Tag Cloud (Display) Attributes
116
+ *
117
+ * This filter gives you an opportunity to record or modify the arguments passed in to the shortcode
118
+ * before they are merged with the default arguments used for the gallery display.
119
+ *
120
+ * The $shortcode_attributes array is where you will find any of your own parameters that are coded in the
121
+ * shortcode, e.g., [mla_tag_cloud my_parameter="my value"].
122
+ *
123
+ * @since 1.00
124
+ * @uses MLATagCloudHooksExample::$shortcode_attributes
125
+ *
126
+ * @param array the shortcode parameters passed in to the shortcode
127
+ *
128
+ * @return array updated shortcode attributes
129
+ */
130
+ public static function mla_tag_cloud_attributes_filter( $shortcode_attributes ) {
131
+ /*
132
+ * Uncomment the error_log statements in any of the filters to see what's passed in
133
+ */
134
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_attributes_filter $shortcode_attributes = ' . var_export( $shortcode_attributes, true ), 0 );
135
+
136
+ /*
137
+ * Save the attributes for use in the later filters
138
+ */
139
+ self::$shortcode_attributes = $shortcode_attributes;
140
+
141
+ /*
142
+ * Filters must return the first argument passed in, unchanged or updated
143
+ */
144
+ return $shortcode_attributes;
145
+ } // mla_tag_cloud_attributes_filter
146
+
147
+ /**
148
+ * Save the shortcode arguments
149
+ *
150
+ * @since 1.00
151
+ *
152
+ * @var array
153
+ */
154
+ private static $all_display_parameters = array();
155
+
156
+ /**
157
+ * MLA Tag Cloud (Display) Arguments
158
+ *
159
+ * This filter gives you an opportunity to record or modify the gallery display arguments
160
+ * after the shortcode attributes are merged with the default arguments.
161
+ *
162
+ * Note that the values in this array are input or default values, not the final computed values
163
+ * used for the gallery display. The computed values are in the $style_values, $markup_values and
164
+ * $item_values arrays passed to later filters below.
165
+ *
166
+ * @since 1.00
167
+ * @uses MLATagCloudHooksExample::$all_display_parameters
168
+ *
169
+ * @param array shortcode arguments merged with gallery display defaults, so every possible parameter is present
170
+ *
171
+ * @return array updated gallery display arguments
172
+ */
173
+ public static function mla_tag_cloud_arguments_filter( $all_display_parameters ) {
174
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_arguments_filter $all_display_parameters = ' . var_export( $all_display_parameters, true ), 0 );
175
+
176
+ self::$all_display_parameters = $all_display_parameters;
177
+ return $all_display_parameters;
178
+ } // mla_tag_cloud_arguments_filter
179
+
180
+ /**
181
+ * Save the query attributes
182
+ *
183
+ * @since 1.00
184
+ *
185
+ * @var array
186
+ */
187
+ private static $query_attributes = array();
188
+
189
+ /**
190
+ * MLA Tag Cloud Query Attributes
191
+ *
192
+ * This filter gives you an opportunity to record or modify the arguments passed in to the shortcode
193
+ * before they are merged with the default arguments used to select the attachments for the gallery.
194
+ *
195
+ * The query attributes passed in to this filter are the same as those passed through the
196
+ * "MLA Tag Cloud (Display) Attributes" filter above. This filter is provided so you can modify
197
+ * the data selection attributes without disturbing the attributes used for gallery display.
198
+ *
199
+ * @since 1.00
200
+ * @uses MLATagCloudHooksExample::$query_attributes
201
+ *
202
+ * @param array the shortcode parameters passed in to the shortcode
203
+ *
204
+ * @return array updated shortcode attributes
205
+ */
206
+ public static function mla_get_terms_query_attributes_filter( $query_attributes ) {
207
+ //error_log( 'MLATagCloudHooksExample::mla_get_terms_query_attributes_filter $query_attributes = ' . var_export( $query_attributes, true ), 0 );
208
+
209
+ self::$query_attributes = $query_attributes;
210
+ return $query_attributes;
211
+ } // mla_get_terms_query_attributes_filter
212
+
213
+ /**
214
+ * Save the query arguments
215
+ *
216
+ * @since 1.00
217
+ *
218
+ * @var array
219
+ */
220
+ private static $all_query_parameters = array();
221
+
222
+ /**
223
+ * MLA Tag Cloud Query Arguments
224
+ *
225
+ * This filter gives you an opportunity to record or modify the attachment query arguments
226
+ * after the shortcode attributes are merged with the default arguments.
227
+ *
228
+ * @since 1.00
229
+ * @uses MLATagCloudHooksExample::$all_query_parameters
230
+ *
231
+ * @param array shortcode arguments merged with attachment selection defaults, so every possible parameter is present
232
+ *
233
+ * @return array updated attachment query arguments
234
+ */
235
+ public static function mla_get_terms_query_arguments_filter( $all_query_parameters ) {
236
+ //error_log( 'MLATagCloudHooksExample::mla_get_terms_query_arguments_filter $all_query_parameters = ' . var_export( $all_query_parameters, true ), 0 );
237
+
238
+ self::$all_query_parameters = $all_query_parameters;
239
+ return $all_query_parameters;
240
+ } // mla_get_terms_query_arguments_filter
241
+
242
+ /**
243
+ * MLA Tag Cloud Query Results
244
+ *
245
+ * This action gives you an opportunity to inspect, save, modify, reorder, etc.
246
+ * the array of tag objects returned from the data selection process.
247
+ *
248
+ * @since 1.00
249
+ *
250
+ * @param array tag objects
251
+ *
252
+ * @return array updated tag objects
253
+ */
254
+ public static function mla_get_terms_query_results_filter( $tag_objects ) {
255
+ //error_log( 'MLATagCloudHooksExample::mla_get_terms_query_results_filter $tag_objects = ' . var_export( $tag_objects, true ), 0 );
256
+
257
+ return $tag_objects;
258
+ } // mla_get_terms_query_results_filter
259
+
260
+ /**
261
+ * MLA Tag Cloud scale filter
262
+ *
263
+ * This filter gives you an opportunity to record or modify the scaled count value,
264
+ * for determining the font size assigned to each cloud term.
265
+ * The default fomula for scaling the count is round(log10($tag->count + 1) * 100).
266
+ * This filter is called once for each filter as the item-specific substitution parameters
267
+ * are calculated.
268
+ *
269
+ * @since 1.00
270
+ *
271
+ * @param float default scaled count for the tag
272
+ * @param array the shortcode parameters passed in to the shortcode
273
+ * @param array shortcode arguments merged with gallery display defaults, so every possible parameter is present
274
+ * @param object tag object for the current item
275
+ *
276
+ * @return array updated scaled count
277
+ */
278
+ public static function mla_tag_cloud_scale_filter( $scaled_count, $shortcode_attributes, $all_display_parameters, $tag ) {
279
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_scale_filter $scaled_count = ' . var_export( $scaled_count, true ), 0 );
280
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_scale_filter $shortcode_attributes = ' . var_export( $shortcode_attributes, true ), 0 );
281
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_scale_filter $all_display_parameters = ' . var_export( $all_display_parameters, true ), 0 );
282
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_scale_filter $tag = ' . var_export( $tag, true ), 0 );
283
+
284
+ return $scaled_count;
285
+ } // mla_tag_cloud_scale_filter
286
+
287
+ /**
288
+ * Use MLA Tag Cloud Style
289
+ *
290
+ * You can use this filter to allow or suppress the inclusion of CSS styles in the
291
+ * gallery output. Return 'true' to allow the styles, false to suppress them. You can also
292
+ * suppress styles by returning an empty string from the mla_tag_cloud_style_parse_filter below.
293
+ *
294
+ * @since 1.00
295
+ *
296
+ * @param boolean true unless the mla_style parameter is "none"
297
+ * @param string value of the mla_style parameter
298
+ *
299
+ * @return boolean true to fetch and parse the style template, false to leave it empty
300
+ */
301
+ public static function use_mla_tag_cloud_style_filter( $use_style_template, $style_template_name ) {
302
+ //error_log( 'MLATagCloudHooksExample::use_mla_tag_cloud_style_filter $use_style_template = ' . var_export( $use_style_template, true ), 0 );
303
+ //error_log( 'MLATagCloudHooksExample::use_mla_tag_cloud_style_filter $style_template_name = ' . var_export( $style_template_name, true ), 0 );
304
+
305
+ return $use_style_template;
306
+ } // use_mla_tag_cloud_style_filter
307
+
308
+ /**
309
+ * MLA Tag Cloud Style Values
310
+ *
311
+ * The "Values" series of filters gives you a chance to modify the substitution parameter values
312
+ * before they are used to complete the associated template (in the corresponding "Parse" filter).
313
+ * It is called just before the values are used to parse the associated template.
314
+ * You can add, change or delete parameters as needed.
315
+ *
316
+ * @since 1.00
317
+ *
318
+ * @param array parameter_name => parameter_value pairs
319
+ *
320
+ * @return array updated substitution parameter name => value pairs
321
+ */
322
+ public static function mla_tag_cloud_style_values_filter( $style_values ) {
323
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_values_filter $style_values = ' . var_export( $style_values, true ), 0 );
324
+
325
+ /*
326
+ * You also have access to the PHP Super Globals, e.g., $_REQUEST, $_SERVER
327
+ */
328
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_values_filter $_REQUEST = ' . var_export( $_REQUEST, true ), 0 );
329
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_values_filter $_SERVER[ REQUEST_URI ] = ' . var_export( $_SERVER['REQUEST_URI'], true ), 0 );
330
+
331
+ /*
332
+ * You can use the WordPress globals like $wp_query, $wpdb and $table_prefix as well.
333
+ * Note that $wp_query contains values for the post/page query, NOT the [mla_tag_cloud] query.
334
+ */
335
+ global $wp_query;
336
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_values_filter $wp_query->query = ' . var_export( $wp_query->query, true ), 0 );
337
+
338
+ return $style_values;
339
+ } // mla_tag_cloud_style_values_filter
340
+
341
+ /**
342
+ * MLA Tag Cloud Style Template
343
+ *
344
+ * The "Template" series of filters gives you a chance to modify the template value before
345
+ * it is used to generate the HTML markup (in the corresponding "Parse" filter).
346
+ * It is called just before the template is used to generate the markup.
347
+ * You can modify the template as needed.
348
+ *
349
+ * @since 1.00
350
+ *
351
+ * @param string template used to generate the HTML markup
352
+ *
353
+ * @return string updated template
354
+ */
355
+ public static function mla_tag_cloud_style_template_filter( $style_template ) {
356
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_template_filter $style_template = ' . var_export( $style_template, true ), 0 );
357
+
358
+ return $style_template;
359
+ } // mla_tag_cloud_style_template_filter
360
+
361
+ /**
362
+ * MLA Tag Cloud Style Parse
363
+ *
364
+ * The "Parse" series of filters gives you a chance to modify or replace the HTML markup
365
+ * that will be added to the [mla_tag_cloud] output. It is called just after the values array
366
+ * (updated in the corresponding "Values" filter) is combined (parsed) with the template.
367
+ * You can modify the HTML markup already prepared or start over with the template and the
368
+ * substitution values.
369
+ *
370
+ * @since 1.00
371
+ *
372
+ * @param string HTML markup returned by the template parser
373
+ * @param string template used to generate the HTML markup
374
+ * @param array parameter_name => parameter_value pairs
375
+ *
376
+ * @return array updated HTML markup for gallery output
377
+ */
378
+ public static function mla_tag_cloud_style_parse_filter( $html_markup, $style_template, $style_values ) {
379
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
380
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_parse_filter $style_template = ' . var_export( $style_template, true ), 0 );
381
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_parse_filter $style_values = ' . var_export( $style_values, true ), 0 );
382
+
383
+ return $html_markup;
384
+ } // mla_tag_cloud_style_parse_filter
385
+
386
+ /**
387
+ * MLA Tag Cloud Open Values
388
+ *
389
+ * Note: The $markup_values array is shared among the open, row open, row close and close functions.
390
+ * It is also used to initialize the $item_values array.
391
+ *
392
+ * @since 1.00
393
+ *
394
+ * @param array parameter_name => parameter_value pairs
395
+ *
396
+ * @return array updated substitution parameter name => value pairs
397
+ */
398
+ public static function mla_tag_cloud_open_values_filter( $markup_values ) {
399
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_open_values_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
400
+
401
+ return $markup_values;
402
+ } // mla_tag_cloud_open_values_filter
403
+
404
+ /**
405
+ * MLA Tag Cloud Open Template
406
+ *
407
+ * @since 1.00
408
+ *
409
+ * @param string template used to generate the HTML markup
410
+ *
411
+ * @return string updated template
412
+ */
413
+ public static function mla_tag_cloud_open_template_filter( $open_template ) {
414
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_open_template_filter $open_template = ' . var_export( $open_template, true ), 0 );
415
+
416
+ return $open_template;
417
+ } // mla_tag_cloud_open_template_filter
418
+
419
+ /**
420
+ * MLA Tag Cloud Open Parse
421
+ *
422
+ * @since 1.00
423
+ *
424
+ * @param string HTML markup returned by the template parser
425
+ * @param string template used to generate the HTML markup
426
+ * @param array parameter_name => parameter_value pairs
427
+ *
428
+ * @return array updated HTML markup for gallery output
429
+ */
430
+ public static function mla_tag_cloud_open_parse_filter( $html_markup, $open_template, $markup_values ) {
431
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_open_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
432
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_open_parse_filter $open_template = ' . var_export( $open_template, true ), 0 );
433
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_open_parse_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
434
+
435
+ return $html_markup;
436
+ } // mla_tag_cloud_open_parse_filter
437
+
438
+ /**
439
+ * MLA Tag Cloud Style
440
+ *
441
+ * This is an old filter retained for compatibility with earlier MLA versions.
442
+ * You will probably find the "Values" and "Parse" filters more useful.
443
+ *
444
+ * @since 1.00
445
+ *
446
+ * @param string HTML markup for "gallery style" and "gallery open", combined
447
+ * @param array parameter_name => parameter_value pairs for gallery style
448
+ * @param array parameter_name => parameter_value pairs for gallery open
449
+ * @param string template used to generate the HTML markup for gallery style
450
+ * @param string template used to generate the HTML markup for gallery open
451
+ *
452
+ * @return array updated HTML markup for "gallery style" and "gallery open" output
453
+ */
454
+ public static function mla_tag_cloud_style_filter( $html_markup, $style_values, $open_values, $style_template, $open_template ) {
455
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
456
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_filter $style_values = ' . var_export( $style_values, true ), 0 );
457
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_filter $open_values = ' . var_export( $open_values, true ), 0 );
458
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_filter $style_template = ' . var_export( $style_template, true ), 0 );
459
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_style_filter $open_template = ' . var_export( $open_template, true ), 0 );
460
+
461
+ return $html_markup;
462
+ } // mla_tag_cloud_style_filter
463
+
464
+ /**
465
+ * MLA Tag Cloud Row Open Values
466
+ *
467
+ * @since 1.00
468
+ *
469
+ * @param array parameter_name => parameter_value pairs
470
+ *
471
+ * @return array updated substitution parameter name => value pairs
472
+ */
473
+ public static function mla_tag_cloud_row_open_values_filter( $markup_values ) {
474
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_row_open_values_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
475
+
476
+ return $markup_values;
477
+ } // mla_tag_cloud_row_open_values_filter
478
+
479
+ /**
480
+ * MLA Tag Cloud Row Open Template
481
+ *
482
+ * @since 1.00
483
+ *
484
+ * @param string template used to generate the HTML markup
485
+ *
486
+ * @return string updated template
487
+ */
488
+ public static function mla_tag_cloud_row_open_template_filter( $row_open_template ) {
489
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_row_open_template_filter $row_open_template = ' . var_export( $row_open_template, true ), 0 );
490
+
491
+ return $row_open_template;
492
+ } // mla_tag_cloud_row_open_template_filter
493
+
494
+ /**
495
+ * MLA Tag Cloud Row Open Parse
496
+ *
497
+ * @since 1.00
498
+ *
499
+ * @param string HTML markup returned by the template parser
500
+ * @param string template used to generate the HTML markup
501
+ * @param array parameter_name => parameter_value pairs
502
+ *
503
+ * @return array updated HTML markup for gallery output
504
+ */
505
+ public static function mla_tag_cloud_row_open_parse_filter( $html_markup, $row_open_template, $markup_values ) {
506
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_row_open_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
507
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_row_open_parse_filter $row_open_template = ' . var_export( $row_open_template, true ), 0 );
508
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_row_open_parse_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
509
+
510
+ return $html_markup;
511
+ } // mla_tag_cloud_row_open_parse_filter
512
+
513
+ /**
514
+ * MLA Tag Cloud Item Values
515
+ *
516
+ * @since 1.00
517
+ *
518
+ * @param array parameter_name => parameter_value pairs
519
+ *
520
+ * @return array updated substitution parameter name => value pairs
521
+ */
522
+ public static function mla_tag_cloud_item_values_filter( $item_values ) {
523
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_item_values_filter $item_values = ' . var_export( $item_values, true ), 0 );
524
+
525
+ /*
526
+ * For this example, we will color the "heat map" of cloud item size values. We use a shortcode parameter of our
527
+ * own to do this on a gallery-by-gallery basis, leaving other [mla_tag_cloud] instances untouched.
528
+ */
529
+ if ( isset( self::$shortcode_attributes['my_filter'] ) && 'color cloud' == self::$shortcode_attributes['my_filter'] ) {
530
+ /*
531
+ * Calculate red, green and blue so smallest items are red, middle items are green and biggest items are blue
532
+ */
533
+ $spread = (float) $item_values['max_scaled_count'] - $item_values['min_scaled_count'];
534
+ $half_spread = (float) $spread / 2;
535
+ $mid_point = (float) $item_values['min_scaled_count'] + $half_spread;
536
+ $scaled_count = (float) $item_values['scaled_count'];
537
+
538
+ $green = 255;
539
+ $red = $blue = 0;
540
+ if ( $half_spread ) {
541
+ $green = (integer) 255.0 - ( 255.0 * ( absint( $scaled_count - $mid_point ) / $half_spread ) );
542
+ if ( $scaled_count < $mid_point ) {
543
+ $red = (integer) 255.0 * ( ( $mid_point - $scaled_count ) / $half_spread );
544
+ } elseif ( $scaled_count > $mid_point ) {
545
+ $blue = (integer) 255.0 * ( ( $scaled_count - $mid_point ) / $half_spread );
546
+ }
547
+ }
548
+
549
+ /*
550
+ * 'editlink', 'viewlink' and 'thelink' are already composed at this point, so we must update all of them
551
+ */
552
+ $old_style = $item_values['link_style'];
553
+ $new_style = $old_style . sprintf( '; color: #%02x%02x%02x', $red, $green, $blue );
554
+ $item_values['link_style'] = $new_style;
555
+ $item_values['editlink'] = str_replace( $old_style, $new_style, $item_values['editlink'] );
556
+ $item_values['viewlink'] = str_replace( $old_style, $new_style, $item_values['viewlink'] );
557
+ $item_values['thelink'] = str_replace( $old_style, $new_style, $item_values['thelink'] );
558
+ }
559
+
560
+ return $item_values;
561
+ } // mla_tag_cloud_item_values_filter
562
+
563
+ /**
564
+ * MLA Tag Cloud Item Template
565
+ *
566
+ * @since 1.00
567
+ *
568
+ * @param string template used to generate the HTML markup
569
+ *
570
+ * @return string updated template
571
+ */
572
+ public static function mla_tag_cloud_item_template_filter( $item_template ) {
573
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_item_template_filter $item_template = ' . var_export( $item_template, true ), 0 );
574
+
575
+ return $item_template;
576
+ } // mla_tag_cloud_item_template_filter
577
+
578
+ /**
579
+ * MLA Tag Cloud Item Parse
580
+ *
581
+ * @since 1.00
582
+ *
583
+ * @param string HTML markup returned by the template parser
584
+ * @param string template used to generate the HTML markup
585
+ * @param array parameter_name => parameter_value pairs
586
+ *
587
+ * @return array updated HTML markup for gallery output
588
+ */
589
+ public static function mla_tag_cloud_item_parse_filter( $html_markup, $item_template, $item_values ) {
590
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_item_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
591
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_item_parse_filter $item_template = ' . var_export( $item_template, true ), 0 );
592
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_item_parse_filter $item_values = ' . var_export( $item_values, true ), 0 );
593
+
594
+ return $html_markup;
595
+ } // mla_tag_cloud_item_parse_filter
596
+
597
+ /**
598
+ * MLA Tag Cloud Row Close Values
599
+ *
600
+ * @since 1.00
601
+ *
602
+ * @param array parameter_name => parameter_value pairs
603
+ *
604
+ * @return array updated substitution parameter name => value pairs
605
+ */
606
+ public static function mla_tag_cloud_row_close_values_filter( $markup_values ) {
607
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_row_close_values_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
608
+
609
+ return $markup_values;
610
+ } // mla_tag_cloud_row_close_values_filter
611
+
612
+ /**
613
+ * MLA Tag Cloud Row Close Template
614
+ *
615
+ * @since 1.00
616
+ *
617
+ * @param string template used to generate the HTML markup
618
+ *
619
+ * @return string updated template
620
+ */
621
+ public static function mla_tag_cloud_row_close_template_filter( $row_close_template ) {
622
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_row_close_template_filter $row_close_template = ' . var_export( $row_close_template, true ), 0 );
623
+
624
+ return $row_close_template;
625
+ } // mla_tag_cloud_row_close_template_filter
626
+
627
+ /**
628
+ * MLA Tag Cloud Row Close Parse
629
+ *
630
+ * @since 1.00
631
+ *
632
+ * @param string HTML markup returned by the template parser
633
+ * @param string template used to generate the HTML markup
634
+ * @param array parameter_name => parameter_value pairs
635
+ *
636
+ * @return array updated HTML markup for gallery output
637
+ */
638
+ public static function mla_tag_cloud_row_close_parse_filter( $html_markup, $row_close_template, $markup_values ) {
639
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_row_close_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
640
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_row_close_parse_filter $row_close_template = ' . var_export( $row_close_template, true ), 0 );
641
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_row_close_parse_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
642
+
643
+ return $html_markup;
644
+ } // mla_tag_cloud_row_close_parse_filter
645
+
646
+ /**
647
+ * MLA Tag Cloud Close Values
648
+ *
649
+ * @since 1.00
650
+ *
651
+ * @param array parameter_name => parameter_value pairs
652
+ *
653
+ * @return array updated substitution parameter name => value pairs
654
+ */
655
+ public static function mla_tag_cloud_close_values_filter( $markup_values ) {
656
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_close_values_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
657
+
658
+ return $markup_values;
659
+ } // mla_tag_cloud_close_values_filter
660
+
661
+ /**
662
+ * MLA Tag Cloud Close Template
663
+ *
664
+ * @since 1.00
665
+ *
666
+ * @param string template used to generate the HTML markup
667
+ *
668
+ * @return string updated template
669
+ */
670
+ public static function mla_tag_cloud_close_template_filter( $close_template ) {
671
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_close_template_filter $close_template = ' . var_export( $close_template, true ), 0 );
672
+
673
+ return $close_template;
674
+ } // mla_tag_cloud_close_template_filter
675
+
676
+ /**
677
+ * MLA Tag Cloud Close Parse
678
+ *
679
+ * @since 1.00
680
+ *
681
+ * @param string HTML markup returned by the template parser
682
+ * @param string template used to generate the HTML markup
683
+ * @param array parameter_name => parameter_value pairs
684
+ *
685
+ * @return array updated HTML markup for gallery output
686
+ */
687
+ public static function mla_tag_cloud_close_parse_filter( $html_markup, $close_template, $markup_values ) {
688
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_close_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
689
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_close_parse_filter $close_template = ' . var_export( $close_template, true ), 0 );
690
+ //error_log( 'MLATagCloudHooksExample::mla_tag_cloud_close_parse_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
691
+
692
+ return $html_markup;
693
+ } // mla_tag_cloud_close_parse_filter
694
+
695
+ } // Class MLATagCloudHooksExample
696
+
697
+ /*
698
+ * Install the filters at an early opportunity
699
+ */
700
+ add_action('init', 'MLATagCloudHooksExample::initialize');
701
+ ?>
examples/mla-hooks-example.php.txt CHANGED
@@ -8,7 +8,7 @@
8
  * you can use to customize the gallery display.
9
  *
10
  * @package MLA Gallery Hooks Example
11
- * @version 1.00
12
  */
13
 
14
  /*
@@ -16,7 +16,7 @@ Plugin Name: MLA Gallery Hooks Example
16
  Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
17
  Description: Provides an example of hooking the filters provided by the [mla_gallery] shortcode
18
  Author: David Lingren
19
- Version: 1.00
20
  Author URI: http://fairtradejudaica.org/our-story/staff/
21
 
22
  Copyright 2013 David Lingren
@@ -69,10 +69,12 @@ class MLAGalleryHooksExample {
69
  * Comment out the filters you don't need; save them for future use
70
  */
71
  add_filter( 'mla_gallery_attributes', 'MLAGalleryHooksExample::mla_gallery_attributes_filter', 10, 1 );
 
72
  add_filter( 'mla_gallery_arguments', 'MLAGalleryHooksExample::mla_gallery_arguments_filter', 10, 1 );
73
  add_filter( 'mla_gallery_query_attributes', 'MLAGalleryHooksExample::mla_gallery_query_attributes_filter', 10, 1 );
74
  add_filter( 'mla_gallery_query_arguments', 'MLAGalleryHooksExample::mla_gallery_query_arguments_filter', 10, 1 );
75
  add_action( 'mla_gallery_wp_query_object', 'MLAGalleryHooksExample::mla_gallery_wp_query_object_action', 10, 1 );
 
76
 
77
  add_filter( 'use_mla_gallery_style', 'MLAGalleryHooksExample::use_mla_gallery_style_filter', 10, 2 );
78
 
@@ -141,6 +143,41 @@ class MLAGalleryHooksExample {
141
  return $shortcode_attributes;
142
  } // mla_gallery_attributes_filter
143
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
144
  /**
145
  * Save the shortcode arguments
146
  *
@@ -271,6 +308,26 @@ class MLAGalleryHooksExample {
271
  return;
272
  } // mla_gallery_wp_query_object_action
273
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
274
  /**
275
  * Use MLA Gallery Style
276
  *
@@ -512,6 +569,28 @@ class MLAGalleryHooksExample {
512
  public static function mla_gallery_item_values_filter( $item_values ) {
513
  //error_log( 'MLAGalleryHooksExample::mla_gallery_item_values_filter $item_values = ' . var_export( $item_values, true ), 0 );
514
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
515
  /*
516
  * For our example, we will add to the $item_values['caption'] value an unordered list
517
  * of the custom fields populated for each gallery item. We use a shortcode parameter of our
8
  * you can use to customize the gallery display.
9
  *
10
  * @package MLA Gallery Hooks Example
11
+ * @version 1.02
12
  */
13
 
14
  /*
16
  Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
17
  Description: Provides an example of hooking the filters provided by the [mla_gallery] shortcode
18
  Author: David Lingren
19
+ Version: 1.02
20
  Author URI: http://fairtradejudaica.org/our-story/staff/
21
 
22
  Copyright 2013 David Lingren
69
  * Comment out the filters you don't need; save them for future use
70
  */
71
  add_filter( 'mla_gallery_attributes', 'MLAGalleryHooksExample::mla_gallery_attributes_filter', 10, 1 );
72
+ add_filter( 'mla_gallery_initial_content', 'MLAGalleryHooksExample::mla_gallery_initial_content_filter', 10, 2 );
73
  add_filter( 'mla_gallery_arguments', 'MLAGalleryHooksExample::mla_gallery_arguments_filter', 10, 1 );
74
  add_filter( 'mla_gallery_query_attributes', 'MLAGalleryHooksExample::mla_gallery_query_attributes_filter', 10, 1 );
75
  add_filter( 'mla_gallery_query_arguments', 'MLAGalleryHooksExample::mla_gallery_query_arguments_filter', 10, 1 );
76
  add_action( 'mla_gallery_wp_query_object', 'MLAGalleryHooksExample::mla_gallery_wp_query_object_action', 10, 1 );
77
+ add_filter( 'mla_gallery_final_content', 'MLAGalleryHooksExample::mla_gallery_final_content_filter', 10, 1 );
78
 
79
  add_filter( 'use_mla_gallery_style', 'MLAGalleryHooksExample::use_mla_gallery_style_filter', 10, 2 );
80
 
143
  return $shortcode_attributes;
144
  } // mla_gallery_attributes_filter
145
 
146
+ /**
147
+ * Save the enclosed content
148
+ *
149
+ * @since 1.02
150
+ *
151
+ * @var NULL|string
152
+ */
153
+ private static $shortcode_content = NULL;
154
+
155
+ /**
156
+ * MLA Gallery Enclosed Content, initial filter
157
+ *
158
+ * This filter gives you an opportunity to record or modify the content enclosed by the shortcode
159
+ * when the [mla_gallery]content[/mla_gallery] form is used.
160
+ * This initial filter is called just after the 'mla_gallery_attributes' filter above.
161
+ *
162
+ * @since 1.02
163
+ *
164
+ * @param NULL|string content enclosed by the shortcode, if any
165
+ * @param array the shortcode parameters passed in to the shortcode
166
+ *
167
+ * @return array updated shortcode content
168
+ */
169
+ public static function mla_gallery_initial_content_filter( $shortcode_content, $shortcode_attributes ) {
170
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_initial_content_filter $shortcode_content = ' . var_export( $shortcode_content, true ), 0 );
171
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_initial_content_filter $shortcode_attributes = ' . var_export( $shortcode_attributes, true ), 0 );
172
+
173
+ /*
174
+ * Save the attributes for use in the later filters
175
+ */
176
+ self::$shortcode_content = $shortcode_content;
177
+
178
+ return $shortcode_content;
179
+ } // mla_gallery_initial_content_filter
180
+
181
  /**
182
  * Save the shortcode arguments
183
  *
308
  return;
309
  } // mla_gallery_wp_query_object_action
310
 
311
+ /**
312
+ * MLA Gallery Enclosed Content, final filter
313
+ *
314
+ * This filter gives you an opportunity to record or modify the content enclosed by the shortcode
315
+ * when the [mla_gallery]content[/mla_gallery] form is used.
316
+ * This final filter is called just after the WP_query and before control is passed
317
+ * to the alternate gallery shortcode.
318
+ *
319
+ * @since 1.02
320
+ *
321
+ * @param NULL|string content enclosed by the shortcode, if any
322
+ *
323
+ * @return array updated shortcode content
324
+ */
325
+ public static function mla_gallery_final_content_filter( $shortcode_content ) {
326
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_final_content_filter $shortcode_content = ' . var_export( $shortcode_content, true ), 0 );
327
+
328
+ return $shortcode_content;
329
+ } // mla_gallery_final_content_filter
330
+
331
  /**
332
  * Use MLA Gallery Style
333
  *
569
  public static function mla_gallery_item_values_filter( $item_values ) {
570
  //error_log( 'MLAGalleryHooksExample::mla_gallery_item_values_filter $item_values = ' . var_export( $item_values, true ), 0 );
571
 
572
+ /*
573
+ * For this first example, we will reformat the 'date' value as d/m/Y. We use a shortcode parameter of our
574
+ * own to do this on a gallery-by-gallery basis, leaving other [mla_gallery] instances untouched.
575
+ */
576
+ if ( isset( self::$shortcode_attributes['my_filter'] ) && 'format date' == self::$shortcode_attributes['my_filter'] ) {
577
+
578
+ /*
579
+ * Default format is YYYY-MM-DD HH:MM:SS (HH = 00 - 23), or 'Y-m-d H:i:s'
580
+ * Convert to UNIX timestamp so any reformat is possible
581
+ */
582
+ $old_date = $item_values['date'];
583
+ $timestamp = mktime( substr( $old_date, 11, 2 ), substr( $old_date, 14, 2 ), substr( $old_date, 17, 2 ), substr( $old_date, 5, 2 ), substr( $old_date, 8, 2 ), substr( $old_date, 0, 4 ) );
584
+
585
+ /*
586
+ * Update the $item_values and pass them back from the filter.
587
+ * We must also update the caption because it was composed before this filter is called.
588
+ */
589
+ $item_values['date'] = date( 'd/m/Y', $timestamp );
590
+ $item_values['caption'] = $item_values['description'] . $item_values['date'];
591
+ return $item_values;
592
+ }
593
+
594
  /*
595
  * For our example, we will add to the $item_values['caption'] value an unordered list
596
  * of the custom fields populated for each gallery item. We use a shortcode parameter of our
includes/class-mla-data.php CHANGED
@@ -797,10 +797,25 @@ class MLAData {
797
  break;
798
  case 'request':
799
  if ( isset( $_REQUEST[ $value['value'] ] ) )
800
- $markup_values[ $key ] = $_REQUEST[ $value['value'] ];
801
  else
802
- $markup_values[ $key ] = '';
803
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
804
  break;
805
  case 'terms':
806
  if ( 0 < $post_id )
@@ -866,7 +881,7 @@ class MLAData {
866
  $text = sanitize_text_field( (string) $record );
867
  elseif ( is_array( $record ) ) {
868
  if ( 'export' == $value['option'] )
869
- $text = sanitize_text_field( var_export( $haystack, true ) );
870
  else {
871
  $text = '';
872
  foreach ( $record as $term ) {
@@ -2502,11 +2517,13 @@ class MLAData {
2502
  */
2503
  if ( empty( $match ) || ( ' ' == substr( $match, 0, 1 ) ) ) {
2504
  $instance++;
2505
- $galleries_array[ $result_id ]['galleries'][ $instance ]['query'] = trim( $matches[1][$index] );
 
 
 
2506
  $galleries_array[ $result_id ]['galleries'][ $instance ]['results'] = array();
2507
-
2508
  $post = $result; // set global variable for mla_gallery_shortcode
2509
- $attachments = MLAShortcodes::mla_get_shortcode_attachments( $result_id, $galleries_array[ $result_id ]['galleries'][ $instance ]['query'] );
2510
 
2511
  if ( is_string( $attachments ) ) {
2512
  trigger_error( htmlentities( sprintf( '(%1$s) %2$s (ID %3$d) query "%4$s" failed, returning "%5$s"', $result->post_type, $result->post_title, $result->ID, $galleries_array[ $result_id ]['galleries'][ $instance ]['query'], $attachments) ), E_USER_WARNING );
797
  break;
798
  case 'request':
799
  if ( isset( $_REQUEST[ $value['value'] ] ) )
800
+ $record = $_REQUEST[ $value['value'] ];
801
  else
802
+ $record = '';
803
 
804
+ if ( is_scalar( $record ) )
805
+ $text = sanitize_text_field( (string) $record );
806
+ elseif ( is_array( $record ) ) {
807
+ if ( 'export' == $value['option'] )
808
+ $text = sanitize_text_field( var_export( $record, true ) );
809
+ else {
810
+ $text = '';
811
+ foreach ( $record as $term ) {
812
+ $term_name = sanitize_text_field( $term );
813
+ $text .= strlen( $text ) ? ',' . $term_name : $term_name;
814
+ }
815
+ }
816
+ } // is_array
817
+
818
+ $markup_values[ $key ] = $text;
819
  break;
820
  case 'terms':
821
  if ( 0 < $post_id )
881
  $text = sanitize_text_field( (string) $record );
882
  elseif ( is_array( $record ) ) {
883
  if ( 'export' == $value['option'] )
884
+ $text = sanitize_text_field( var_export( $record, true ) );
885
  else {
886
  $text = '';
887
  foreach ( $record as $term ) {
2517
  */
2518
  if ( empty( $match ) || ( ' ' == substr( $match, 0, 1 ) ) ) {
2519
  $instance++;
2520
+ /*
2521
+ * Remove trailing "/" from XHTML-style self-closing shortcodes
2522
+ */
2523
+ $galleries_array[ $result_id ]['galleries'][ $instance ]['query'] = trim( rtrim( $matches[1][$index], '/' ) );
2524
  $galleries_array[ $result_id ]['galleries'][ $instance ]['results'] = array();
 
2525
  $post = $result; // set global variable for mla_gallery_shortcode
2526
+ $attachments = MLAShortcodes::mla_get_shortcode_attachments( $result_id, $galleries_array[ $result_id ]['galleries'][ $instance ]['query'] . ' where_used_query=this-is-a-where-used-query' );
2527
 
2528
  if ( is_string( $attachments ) ) {
2529
  trigger_error( htmlentities( sprintf( '(%1$s) %2$s (ID %3$d) query "%4$s" failed, returning "%5$s"', $result->post_type, $result->post_title, $result->ID, $galleries_array[ $result_id ]['galleries'][ $instance ]['query'], $attachments) ), E_USER_WARNING );
includes/class-mla-list-table.php CHANGED
@@ -348,7 +348,7 @@ class MLA_List_Table extends WP_List_Table {
348
  }
349
 
350
  /**
351
- * Initializes some properties from $_REQUEST vairables, then
352
  * calls the parent constructor to set some default configs.
353
  *
354
  * @since 0.1
348
  }
349
 
350
  /**
351
+ * Initializes some properties from $_REQUEST variables, then
352
  * calls the parent constructor to set some default configs.
353
  *
354
  * @since 0.1
includes/class-mla-main.php CHANGED
@@ -38,7 +38,7 @@ class MLA {
38
  *
39
  * @var string
40
  */
41
- const CURRENT_MLA_VERSION = '1.52';
42
 
43
  /**
44
  * Slug for registering and enqueueing plugin style sheet
@@ -247,6 +247,11 @@ class MLA {
247
  public static function mla_admin_enqueue_scripts_action( $page_hook ) {
248
  $suffix = defined('SCRIPT_DEBUG') && SCRIPT_DEBUG ? '' : '.min';
249
 
 
 
 
 
 
250
  if( 'edit-tags.php' == $page_hook ) {
251
  wp_register_style( self::STYLESHEET_SLUG, MLA_PLUGIN_URL . 'css/mla-edit-tags-style.css', false, self::CURRENT_MLA_VERSION );
252
  wp_enqueue_style( self::STYLESHEET_SLUG );
@@ -308,9 +313,12 @@ class MLA {
308
  * @return void
309
  */
310
  public static function mla_admin_menu_action( ) {
311
- if ( 'checked' != MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_DISPLAY_LIBRARY ) )
312
- remove_submenu_page( 'upload.php', 'upload.php' );
313
 
 
 
 
314
  $page_title = MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_PAGE_TITLE );
315
  $menu_title = MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_MENU_TITLE );
316
  $hook = add_submenu_page( 'upload.php', $page_title, $menu_title, 'upload_files', self::ADMIN_PAGE_SLUG, 'MLA::mla_render_admin_page' );
@@ -342,7 +350,16 @@ class MLA {
342
  add_action( 'admin_head-edit-tags.php', 'MLA::mla_add_help_tab' );
343
  }
344
 
345
- if ( $menu_position = (integer) MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_ORDER ) ) {
 
 
 
 
 
 
 
 
 
346
  global $submenu_file, $submenu;
347
  foreach ( $submenu['upload.php'] as $menu_order => $menu_item ) {
348
  if ( self::ADMIN_PAGE_SLUG == $menu_item[2] ) {
@@ -357,6 +374,33 @@ class MLA {
357
  add_filter( 'parent_file', 'MLA::mla_parent_file_filter', 10, 1 );
358
  }
359
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
360
  /**
361
  * Add the "XX Entries per page" filter to the Screen Options tab
362
  *
@@ -555,29 +599,36 @@ class MLA {
555
  * @return string The updated top-level menu page
556
  */
557
  public static function mla_parent_file_filter( $parent_file ) {
558
- global $submenu_file, $submenu;
559
-
560
  /*
561
  * Make sure the "Assistant" submenu line is bolded if it's the default
562
  */
563
- if ( 'upload.php' == $parent_file && NULL == $submenu_file ) {
564
- reset( $submenu['upload.php'] );
565
- $current = current( $submenu['upload.php'] );
566
- if ( self::ADMIN_PAGE_SLUG == $current[2] )
567
- $submenu_file = self::ADMIN_PAGE_SLUG;
 
 
 
 
 
568
  }
569
 
570
  /*
571
  * Make sure the "Assistant" submenu line is bolded when we go to the Edit Media page
572
  */
573
- if ( isset( $_REQUEST['mla_source'] ) )
574
  $submenu_file = self::ADMIN_PAGE_SLUG;
 
575
 
576
  /*
577
  * WordPress 3.5 adds native support for taxonomies
578
  */
579
- if( MLATest::$wordpress_3point5_plus )
580
  return $parent_file;
 
581
 
582
  if ( isset( $_REQUEST['taxonomy'] ) ) {
583
  $taxonomies = get_object_taxonomies( 'attachment', 'objects' );
@@ -634,10 +685,14 @@ class MLA {
634
  }
635
 
636
  $page_content = array(
637
- 'message' => '',
638
  'body' => ''
639
  );
640
 
 
 
 
 
641
  /*
642
  * The category taxonomy (edit screens) is a special case because
643
  * post_categories_meta_box() changes the input name
@@ -664,7 +719,6 @@ class MLA {
664
  case 'edit':
665
  if ( !empty( $_REQUEST['bulk_custom_field_map'] ) ) {
666
  $updates = MLAOptions::mla_evaluate_custom_field_mapping( $post_id, 'single_attachment_mapping' );
667
-
668
  $item_content = MLAData::mla_update_single_item( $post_id, $updates );
669
  break;
670
  }
@@ -672,7 +726,6 @@ class MLA {
672
  if ( !empty( $_REQUEST['bulk_map'] ) ) {
673
  $item = get_post( $post_id );
674
  $updates = MLAOptions::mla_evaluate_iptc_exif_mapping( $item, 'iptc_exif_mapping' );
675
-
676
  $item_content = MLAData::mla_update_single_item( $post_id, $updates );
677
  break;
678
  }
38
  *
39
  * @var string
40
  */
41
+ const CURRENT_MLA_VERSION = '1.60';
42
 
43
  /**
44
  * Slug for registering and enqueueing plugin style sheet
247
  public static function mla_admin_enqueue_scripts_action( $page_hook ) {
248
  $suffix = defined('SCRIPT_DEBUG') && SCRIPT_DEBUG ? '' : '.min';
249
 
250
+ if ( 'checked' != MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_DISPLAY_LIBRARY ) ) {
251
+ wp_register_style( self::STYLESHEET_SLUG . '-nolibrary', MLA_PLUGIN_URL . 'css/mla-nolibrary.css', false, self::CURRENT_MLA_VERSION );
252
+ wp_enqueue_style( self::STYLESHEET_SLUG . '-nolibrary' );
253
+ }
254
+
255
  if( 'edit-tags.php' == $page_hook ) {
256
  wp_register_style( self::STYLESHEET_SLUG, MLA_PLUGIN_URL . 'css/mla-edit-tags-style.css', false, self::CURRENT_MLA_VERSION );
257
  wp_enqueue_style( self::STYLESHEET_SLUG );
313
  * @return void
314
  */
315
  public static function mla_admin_menu_action( ) {
316
+ // if ( 'checked' != MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_DISPLAY_LIBRARY ) )
317
+ // remove_submenu_page( 'upload.php', 'upload.php' );
318
 
319
+ if ( 'checked' != MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_DISPLAY_LIBRARY ) )
320
+ add_action( 'load-upload.php', 'MLA::mla_load_media_action' );
321
+
322
  $page_title = MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_PAGE_TITLE );
323
  $menu_title = MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_MENU_TITLE );
324
  $hook = add_submenu_page( 'upload.php', $page_title, $menu_title, 'upload_files', self::ADMIN_PAGE_SLUG, 'MLA::mla_render_admin_page' );
350
  add_action( 'admin_head-edit-tags.php', 'MLA::mla_add_help_tab' );
351
  }
352
 
353
+ /*
354
+ * If we are suppressing the Media/Library submenu, force Media/Assistant to come first
355
+ */
356
+ if ( 'checked' != MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_DISPLAY_LIBRARY ) ) {
357
+ $menu_position = 4;
358
+ } else {
359
+ $menu_position = (integer) MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_ORDER );
360
+ }
361
+
362
+ if ( $menu_position ) {
363
  global $submenu_file, $submenu;
364
  foreach ( $submenu['upload.php'] as $menu_order => $menu_item ) {
365
  if ( self::ADMIN_PAGE_SLUG == $menu_item[2] ) {
374
  add_filter( 'parent_file', 'MLA::mla_parent_file_filter', 10, 1 );
375
  }
376
 
377
+ /**
378
+ * Redirect to Media/Assistant if Media/Library is hidden
379
+ *
380
+ * @since 1.60
381
+ *
382
+ * @return void
383
+ */
384
+ public static function mla_load_media_action( ) {
385
+ if ( 'checked' != MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_DISPLAY_LIBRARY ) ) {
386
+ $query_args = '?page=mla-menu';
387
+
388
+ /*
389
+ * Compose a message if returning from the Edit Media screen
390
+ */
391
+ if ( ! empty( $_GET['deleted'] ) && $deleted = absint( $_GET['deleted'] ) ) {
392
+ $query_args .= '&mla_admin_message=' . urlencode( sprintf( _n( 'Item permanently deleted.', '%d items permanently deleted.', $deleted ), number_format_i18n( $_GET['deleted'] ) ) );
393
+ }
394
+
395
+ if ( ! empty( $_GET['trashed'] ) && $trashed = absint( $_GET['trashed'] ) ) {
396
+ $query_args .= '&mla_admin_message=' . urlencode( sprintf( 'Item $1%d: moved to Trash.', number_format_i18n( $_GET['ids'] ) ) );
397
+ }
398
+
399
+ wp_redirect( admin_url( 'upload.php' ) . $query_args, 302 );
400
+ exit;
401
+ }
402
+ }
403
+
404
  /**
405
  * Add the "XX Entries per page" filter to the Screen Options tab
406
  *
599
  * @return string The updated top-level menu page
600
  */
601
  public static function mla_parent_file_filter( $parent_file ) {
602
+ global $submenu_file, $submenu, $hook_suffix;
603
+
604
  /*
605
  * Make sure the "Assistant" submenu line is bolded if it's the default
606
  */
607
+ if ( 'media_page_' . self::ADMIN_PAGE_SLUG == $hook_suffix ) {
608
+ $submenu_file = self::ADMIN_PAGE_SLUG;
609
+ }
610
+
611
+ /*
612
+ * Make sure the "Assistant" submenu line is bolded if the Media/Library submenu is hidden
613
+ */
614
+ if ( 'checked' != MLAOptions::mla_get_option( MLAOptions::MLA_SCREEN_DISPLAY_LIBRARY ) &&
615
+ 'upload.php' == $parent_file && 'upload.php' == $submenu_file ) {
616
+ $submenu_file = self::ADMIN_PAGE_SLUG;
617
  }
618
 
619
  /*
620
  * Make sure the "Assistant" submenu line is bolded when we go to the Edit Media page
621
  */
622
+ if ( isset( $_REQUEST['mla_source'] ) ) {
623
  $submenu_file = self::ADMIN_PAGE_SLUG;
624
+ }
625
 
626
  /*
627
  * WordPress 3.5 adds native support for taxonomies
628
  */
629
+ if( MLATest::$wordpress_3point5_plus ) {
630
  return $parent_file;
631
+ }
632
 
633
  if ( isset( $_REQUEST['taxonomy'] ) ) {
634
  $taxonomies = get_object_taxonomies( 'attachment', 'objects' );
685
  }
686
 
687
  $page_content = array(
688
+ 'message' => '',
689
  'body' => ''
690
  );
691
 
692
+ if ( !empty( $_REQUEST['mla_admin_message'] ) ) {
693
+ $page_content['message'] = $_REQUEST['mla_admin_message'];
694
+ }
695
+
696
  /*
697
  * The category taxonomy (edit screens) is a special case because
698
  * post_categories_meta_box() changes the input name
719
  case 'edit':
720
  if ( !empty( $_REQUEST['bulk_custom_field_map'] ) ) {
721
  $updates = MLAOptions::mla_evaluate_custom_field_mapping( $post_id, 'single_attachment_mapping' );
 
722
  $item_content = MLAData::mla_update_single_item( $post_id, $updates );
723
  break;
724
  }
726
  if ( !empty( $_REQUEST['bulk_map'] ) ) {
727
  $item = get_post( $post_id );
728
  $updates = MLAOptions::mla_evaluate_iptc_exif_mapping( $item, 'iptc_exif_mapping' );
 
729
  $item_content = MLAData::mla_update_single_item( $post_id, $updates );
730
  break;
731
  }
includes/class-mla-objects.php CHANGED
@@ -1,6 +1,6 @@
1
  <?php
2
  /**
3
- * Media Library Assistant Custom Taxonomy objects
4
  *
5
  * @package Media Library Assistant
6
  * @since 0.1
@@ -197,4 +197,136 @@ class MLAObjects {
197
  array( 'page' => MLA::ADMIN_PAGE_SLUG, 'mla-tax' => $taxonomy, 'mla-term' => $term->slug, 'heading_suffix' => urlencode( $tax_object->label . ':' . $term->name ) ), 'upload.php' ) ), number_format_i18n( $results->post_count ) );
198
  }
199
  } //Class MLAObjects
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
200
  ?>
1
  <?php
2
  /**
3
+ * Media Library Assistant Custom Taxonomy and Widget objects
4
  *
5
  * @package Media Library Assistant
6
  * @since 0.1
197
  array( 'page' => MLA::ADMIN_PAGE_SLUG, 'mla-tax' => $taxonomy, 'mla-term' => $term->slug, 'heading_suffix' => urlencode( $tax_object->label . ':' . $term->name ) ), 'upload.php' ) ), number_format_i18n( $results->post_count ) );
198
  }
199
  } //Class MLAObjects
200
+
201
+ /**
202
+ * Class MLA (Media Library Assistant) Text Widget defines a shortcode-enabled version of the WordPress Text widget
203
+ *
204
+ * @package Media Library Assistant
205
+ * @since 1.60
206
+ */
207
+ class MLATextWidget extends WP_Widget {
208
+
209
+ /**
210
+ * Provides a unique name for the plugin text domain
211
+ */
212
+ const MLA_TEXT_DOMAIN = 'media_library_assistant';
213
+
214
+ /**
215
+ * Calls the parent constructor to set some defaults.
216
+ *
217
+ * @since 1.60
218
+ *
219
+ * @return void
220
+ */
221
+ function __construct() {
222
+ $widget_args = array(
223
+ 'classname' => 'mla_text_widget',
224
+ 'description' => __( 'Shortcode(s), HTML and/or Plain Text', self::MLA_TEXT_DOMAIN )
225
+ );
226
+
227
+ $control_args = array(
228
+ 'width' => 400,
229
+ 'height' => 350
230
+ );
231
+
232
+ parent::__construct( 'mla-text-widget', __( 'MLA Text', self::MLA_TEXT_DOMAIN ), $widget_args, $control_args );
233
+ }
234
+
235
+ /**
236
+ * Display the widget content - called from the WordPress "front end"
237
+ *
238
+ * @since 1.60
239
+ *
240
+ * @param array Widget arguments
241
+ * @param array Widget definition, from the database
242
+ *
243
+ * @return void Echoes widget output
244
+ */
245
+ function widget( $args, $instance ) {
246
+ $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
247
+ $text = do_shortcode( apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance ) );
248
+ echo $args['before_widget'];
249
+ if ( !empty( $title ) ) { echo $args['before_title'] . $title . $args['after_title']; } ?>
250
+ <div class="textwidget"><?php echo !empty( $instance['filter'] ) ? wpautop( $text ) : $text; ?></div>
251
+ <?php
252
+ echo $args['after_widget'];
253
+ }
254
+
255
+ /**
256
+ * Echo the "edit widget" form on the Appearance/Widgets admin screen
257
+ *
258
+ * @since 1.60
259
+ *
260
+ * @param array Previous definition values, from the database
261
+ *
262
+ * @return void Echoes "edit widget" form
263
+ */
264
+ function form( $instance ) {
265
+ $instance = wp_parse_args( (array) $instance, array( 'title' => '', 'text' => '' ) );
266
+ $title = strip_tags($instance['title']);
267
+ $text = esc_textarea($instance['text']);
268
+ ?>
269
+ <p><label for="<?php echo $this->get_field_id('title'); ?>"><?php _e('Title:', self::MLA_TEXT_DOMAIN); ?></label>
270
+ <input class="widefat" id="<?php echo $this->get_field_id('title'); ?>" name="<?php echo $this->get_field_name('title'); ?>" type="text" value="<?php echo esc_attr($title); ?>" /></p>
271
+
272
+ <textarea class="widefat" rows="16" cols="20" id="<?php echo $this->get_field_id('text'); ?>" name="<?php echo $this->get_field_name('text'); ?>"><?php echo $text; ?></textarea>
273
+
274
+ <p><input id="<?php echo $this->get_field_id('filter'); ?>" name="<?php echo $this->get_field_name('filter'); ?>" type="checkbox" <?php checked(isset($instance['filter']) ? $instance['filter'] : 0); ?> />&nbsp;<label for="<?php echo $this->get_field_id('filter'); ?>"><?php _e('Automatically add paragraphs', self::MLA_TEXT_DOMAIN); ?></label></p>
275
+ <?php
276
+ }
277
+
278
+ /**
279
+ * Sanitize widget definition as it is saved to the database
280
+ *
281
+ * @since 1.60
282
+ *
283
+ * @param array Current definition values, to be saved in the database
284
+ * @param array Previous definition values, from the database
285
+ *
286
+ * @return array Updated definition values to be saved in the database
287
+ */
288
+ function update( $new_instance, $old_instance ) {
289
+ $instance = $old_instance;
290
+ $instance['title'] = strip_tags($new_instance['title']);
291
+ if ( current_user_can('unfiltered_html') )
292
+ $instance['text'] = $new_instance['text'];
293
+ else
294
+ $instance['text'] = stripslashes( wp_filter_post_kses( addslashes($new_instance['text']) ) ); // wp_filter_post_kses() expects slashed
295
+ $instance['filter'] = isset($new_instance['filter']);
296
+ return $instance;
297
+ }
298
+
299
+ /**
300
+ * Register the widget with WordPress
301
+ *
302
+ * Defined as public because it's an action.
303
+ *
304
+ * @since 1.60
305
+ *
306
+ * @return void
307
+ */
308
+ public static function mla_text_widget_widgets_init_action(){
309
+ register_widget('MLATextWidget');
310
+ }
311
+
312
+ /**
313
+ * Load a plugin text domain
314
+ *
315
+ * Defined as public because it's an action.
316
+ *
317
+ * @since 1.60
318
+ *
319
+ * @return void
320
+ */
321
+ public static function mla_text_widget_plugins_loaded_action(){
322
+ load_plugin_textdomain( self::MLA_TEXT_DOMAIN, false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
323
+ }
324
+ } // Class MLATextWidget
325
+
326
+ /*
327
+ * Actions are added here, when the source file is loaded, because the MLATextWidget
328
+ * object(s) are created too late to be useful.
329
+ */
330
+ add_action('widgets_init','MLATextWidget::mla_text_widget_widgets_init_action');
331
+ add_action('plugins_loaded','MLATextWidget::mla_text_widget_plugins_loaded_action');
332
  ?>
includes/class-mla-options.php CHANGED
@@ -533,6 +533,48 @@ class MLAOptions {
533
  'name' => 'Default [mla_gallery] Templates and Settings',
534
  'type' => 'header'),
535
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
536
  'default_style' =>
537
  array('tab' => 'mla_gallery',
538
  'name' => 'Style Template',
@@ -1420,6 +1462,7 @@ class MLAOptions {
1420
  'extension' => '',
1421
  'width' => '',
1422
  'height' => '',
 
1423
  'hwstring_small' => '',
1424
  'sizes' => array()
1425
  );
@@ -1430,8 +1473,24 @@ class MLAOptions {
1430
  $attachment_metadata = isset( $wp_attachment_metadata[ $post_id ]->meta_value ) ? unserialize( $wp_attachment_metadata[ $post_id ]->meta_value ) : array();
1431
  if ( !empty( $attachment_metadata ) ) {
1432
  $sizes = isset( $attachment_metadata['sizes'] ) ? $attachment_metadata['sizes'] : array();
1433
- $results['width'] = isset( $attachment_metadata['width'] ) ? $attachment_metadata['width'] : '';;
1434
- $results['height'] = isset( $attachment_metadata['height'] ) ? $attachment_metadata['height'] : '';;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1435
  $results['hwstring_small'] = isset( $attachment_metadata['hwstring_small'] ) ? $attachment_metadata['hwstring_small'] : '';
1436
 
1437
  if ( isset( $attachment_metadata['image_meta'] ) ) {
@@ -1656,6 +1715,7 @@ class MLAOptions {
1656
  case 'extension':
1657
  case 'width':
1658
  case 'height':
 
1659
  case 'hwstring_small':
1660
  case 'aperture':
1661
  case 'credit':
@@ -2042,6 +2102,7 @@ class MLAOptions {
2042
  'pixels',
2043
  'width',
2044
  'height',
 
2045
  'hwstring_small',
2046
  'size_keys',
2047
  'size_names',
@@ -2664,6 +2725,34 @@ class MLAOptions {
2664
  else
2665
  $new_text = $iptc_value;
2666
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2667
  if ( !empty( $new_text ) ) {
2668
  if ( $new_value['hierarchical'] ) {
2669
  if ( is_string( $new_text ) )
@@ -2936,6 +3025,7 @@ class MLAOptions {
2936
  'exif_value' => '',
2937
  'iptc_first' => true,
2938
  'keep_existing' => true,
 
2939
  'parent' => 0
2940
  );
2941
  }
@@ -2981,6 +3071,12 @@ class MLAOptions {
2981
  $old_values['keep_existing'] = $boolean_value;
2982
  }
2983
 
 
 
 
 
 
 
2984
  if ( isset( $new_value['parent'] ) && ( $old_values['parent'] != $new_value['parent'] ) ) {
2985
  $any_setting_changed = true;
2986
  $message_list .= "<br>{$old_values['name']} changing Parent from {$old_values['parent']} to {$new_value['parent']}.\r\n";
@@ -2996,7 +3092,7 @@ class MLAOptions {
2996
  /*
2997
  * Uncomment this for debugging.
2998
  */
2999
- // $error_list .= $message_list;
3000
 
3001
  return array( 'message' => $error_list, 'values' => $current_values, 'changed' => $settings_changed );
3002
  } // _update_iptc_exif_taxonomy_mapping
@@ -3120,7 +3216,7 @@ class MLAOptions {
3120
  /*
3121
  * Uncomment this for debugging.
3122
  */
3123
- // $error_list .= $message_list;
3124
 
3125
  return array( 'message' => $error_list, 'values' => $current_values, 'changed' => $settings_changed );
3126
  } // _update_iptc_exif_custom_mapping
@@ -3240,6 +3336,8 @@ class MLAOptions {
3240
  'exif_selected' => '',
3241
  'keep_selected' => '',
3242
  'replace_selected' => '',
 
 
3243
  'parent_select' => ''
3244
  );
3245
 
@@ -3258,7 +3356,9 @@ class MLAOptions {
3258
  else
3259
  $row_values['replace_selected'] = 'selected="selected"';
3260
 
3261
- if ( $row_value->hierarchical ) {
 
 
3262
  $parent = ( isset( $current_value['parent'] ) ) ? (integer) $current_value['parent'] : 0;
3263
  $select_values = array (
3264
  'array' => 'taxonomy',
533
  'name' => 'Default [mla_gallery] Templates and Settings',
534
  'type' => 'header'),
535
 
536
+ 'default_tag_cloud_style' =>
537
+ array('tab' => '',
538
+ 'name' => 'Style Template',
539
+ 'type' => 'select',
540
+ 'std' => 'tag-cloud',
541
+ 'options' => array(),
542
+ 'texts' => array(),
543
+ 'help' => 'Select the default style template for your [mla_tag_cloud] shortcodes.'),
544
+
545
+ 'default_tag_cloud_markup' =>
546
+ array('tab' => '',
547
+ 'name' => 'Markup Template',
548
+ 'type' => 'select',
549
+ 'std' => 'tag-cloud',
550
+ 'options' => array(),
551
+ 'texts' => array(),
552
+ 'help' => 'Select the default markup template for your [mla_tag_cloud] shortcodes.'),
553
+
554
+ 'mla_tag_cloud_columns' =>
555
+ array('tab' => '',
556
+ 'name' => 'Default columns',
557
+ 'type' => 'text',
558
+ 'std' => '3',
559
+ 'size' => 3,
560
+ 'help' => 'Enter the number of [mla_tag_cloud] columns; must be a positive integer.'),
561
+
562
+ 'mla_tag_cloud_margin' =>
563
+ array('tab' => '',
564
+ 'name' => 'Default mla_margin',
565
+ 'type' => 'text',
566
+ 'std' => '1.5%',
567
+ 'size' => 10,
568
+ 'help' => 'Enter the CSS "margin" property value, in length (px, em, pt, etc.), percent (%), "auto" or "inherit".<br>&nbsp;&nbsp;Enter "none" to remove the property entirely.'),
569
+
570
+ 'mla_tag_cloud_itemwidth' =>
571
+ array('tab' => '',
572
+ 'name' => 'Default mla_itemwidth',
573
+ 'type' => 'text',
574
+ 'std' => 'calculate',
575
+ 'size' => 10,
576
+ 'help' => 'Enter the CSS "width" property value, in length (px, em, pt, etc.), percent (%), "auto" or "inherit".<br>&nbsp;&nbsp;Enter "calculate" (the default) to calculate the value taking the "margin" value into account.<br>&nbsp;&nbsp;Enter "exact" to calculate the value without considering the "margin" value.<br>&nbsp;&nbsp;Enter "none" to remove the property entirely.'),
577
+
578
  'default_style' =>
579
  array('tab' => 'mla_gallery',
580
  'name' => 'Style Template',
1462
  'extension' => '',
1463
  'width' => '',
1464
  'height' => '',
1465
+ 'orientation' => '',
1466
  'hwstring_small' => '',
1467
  'sizes' => array()
1468
  );
1473
  $attachment_metadata = isset( $wp_attachment_metadata[ $post_id ]->meta_value ) ? unserialize( $wp_attachment_metadata[ $post_id ]->meta_value ) : array();
1474
  if ( !empty( $attachment_metadata ) ) {
1475
  $sizes = isset( $attachment_metadata['sizes'] ) ? $attachment_metadata['sizes'] : array();
1476
+
1477
+ if ( isset( $attachment_metadata['width'] ) ) {
1478
+ $results['width'] = $attachment_metadata['width'];
1479
+ $width = absint( $results['width'] );
1480
+ }
1481
+ else
1482
+ $width = 0;
1483
+
1484
+ if ( isset( $attachment_metadata['height'] ) ) {
1485
+ $results['height'] = $attachment_metadata['height'];
1486
+ $height = absint( $results['height'] );
1487
+ }
1488
+ else
1489
+ $height = 0;
1490
+
1491
+ if ( $width && $height )
1492
+ $results['orientation'] = ( $height > $width ) ? 'portrait' : 'landscape';
1493
+
1494
  $results['hwstring_small'] = isset( $attachment_metadata['hwstring_small'] ) ? $attachment_metadata['hwstring_small'] : '';
1495
 
1496
  if ( isset( $attachment_metadata['image_meta'] ) ) {
1715
  case 'extension':
1716
  case 'width':
1717
  case 'height':
1718
+ case 'orientation':
1719
  case 'hwstring_small':
1720
  case 'aperture':
1721
  case 'credit':
2102
  'pixels',
2103
  'width',
2104
  'height',
2105
+ 'orientation',
2106
  'hwstring_small',
2107
  'size_keys',
2108
  'size_names',
2725
  else
2726
  $new_text = $iptc_value;
2727
 
2728
+ /*
2729
+ * Parse out individual terms if Delimiter(s) are present
2730
+ */
2731
+ if ( ! empty( $new_value['delimiters'] ) ) {
2732
+ $text = $new_value['delimiters'];
2733
+ $delimiters = array();
2734
+ while ( ! empty( $text ) ) {
2735
+ $delimiters[] = $text[0];
2736
+ $text = substr($text, 1);
2737
+ }
2738
+
2739
+ if ( is_scalar( $new_text ) )
2740
+ $new_text = array( $new_text );
2741
+
2742
+ foreach( $delimiters as $delimiter ) {
2743
+ $new_terms = array();
2744
+ foreach ( $new_text as $text ) {
2745
+ $fragments = explode( $delimiter, $text );
2746
+ foreach( $fragments as $fragment ) {
2747
+ $fragment = trim( $fragment );
2748
+ if ( ! empty( $fragment ) )
2749
+ $new_terms[] = $fragment;
2750
+ } // foreach fragment
2751
+ } // foreach $text
2752
+ $new_text = array_unique( $new_terms );
2753
+ } // foreach $delimiter
2754
+ }
2755
+
2756
  if ( !empty( $new_text ) ) {
2757
  if ( $new_value['hierarchical'] ) {
2758
  if ( is_string( $new_text ) )
3025
  'exif_value' => '',
3026
  'iptc_first' => true,
3027
  'keep_existing' => true,
3028
+ 'delimiters' => '',
3029
  'parent' => 0
3030
  );
3031
  }
3071
  $old_values['keep_existing'] = $boolean_value;
3072
  }
3073
 
3074
+ if ( $old_values['delimiters'] != $new_value['delimiters'] ) {
3075
+ $any_setting_changed = true;
3076
+ $message_list .= "<br>{$old_values['name']} changing Delimiter(s) from '{$old_values['delimiters']}' to '{$new_value['delimiters']}'.\r\n";
3077
+ $old_values['delimiters'] = $new_value['delimiters'];
3078
+ }
3079
+
3080
  if ( isset( $new_value['parent'] ) && ( $old_values['parent'] != $new_value['parent'] ) ) {
3081
  $any_setting_changed = true;
3082
  $message_list .= "<br>{$old_values['name']} changing Parent from {$old_values['parent']} to {$new_value['parent']}.\r\n";
3092
  /*
3093
  * Uncomment this for debugging.
3094
  */
3095
+ //$error_list .= $message_list;
3096
 
3097
  return array( 'message' => $error_list, 'values' => $current_values, 'changed' => $settings_changed );
3098
  } // _update_iptc_exif_taxonomy_mapping
3216
  /*
3217
  * Uncomment this for debugging.
3218
  */
3219
+ //$error_list .= $message_list;
3220
 
3221
  return array( 'message' => $error_list, 'values' => $current_values, 'changed' => $settings_changed );
3222
  } // _update_iptc_exif_custom_mapping
3336
  'exif_selected' => '',
3337
  'keep_selected' => '',
3338
  'replace_selected' => '',
3339
+ 'delimiters_size' => 4,
3340
+ 'delimiters_text' => '',
3341
  'parent_select' => ''
3342
  );
3343
 
3356
  else
3357
  $row_values['replace_selected'] = 'selected="selected"';
3358
 
3359
+ $row_values['delimiters_text'] = $current_value['delimiters'];
3360
+
3361
+ if ( $row_value->hierarchical ) {
3362
  $parent = ( isset( $current_value['parent'] ) ) ? (integer) $current_value['parent'] : 0;
3363
  $select_values = array (
3364
  'array' => 'taxonomy',
includes/class-mla-settings.php CHANGED
@@ -172,6 +172,22 @@ class MLASettings {
172
  MLAOptions::mla_update_option( 'custom_field_mapping', $new_values );
173
  } // version is less than 1.40
174
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
175
  MLAOptions::mla_update_option( MLAOptions::MLA_VERSION_OPTION, MLA::CURRENT_MLA_VERSION );
176
  }
177
 
@@ -1759,38 +1775,41 @@ class MLASettings {
1759
  $page_values['options_list'] = $options_list;
1760
 
1761
  /*
1762
- * Add style templates; default goes first
1763
  */
 
1764
  $style_options_list = '';
1765
  $templates = MLAOptions::mla_get_style_templates();
1766
 
1767
- $name = 'default';
1768
- $value =$templates['default'];
1769
- if ( ! empty( $value ) ) {
1770
- $template_values = array (
1771
- 'help' => 'The default template cannot be altered or deleted, but you can copy the styles.'
1772
- );
1773
- $control_cells = MLAData::mla_parse_template( self::$page_template_array['mla-gallery-default'], $template_values );
1774
-
1775
- $template_values = array (
1776
- 'readonly' => 'readonly="readonly"',
1777
- 'name_name' => 'mla_style_templates_name[default]',
1778
- 'name_id' => 'mla_style_templates_name_default',
1779
- 'name_text' => 'default',
1780
- 'control_cells' => $control_cells,
1781
- 'value_name' => 'mla_style_templates_value[default]',
1782
- 'value_id' => 'mla_style_templates_value_default',
1783
- 'value_text' => esc_textarea( $value ),
1784
- 'value_help' => 'List of substitution parameters, e.g., [+selector+], on Documentation tab.'
1785
- );
1786
-
1787
- $style_options_list .= MLAData::mla_parse_template( self::$page_template_array['mla-gallery-style'], $template_values );
1788
- } // $value
 
 
1789
 
1790
  foreach ( $templates as $name => $value ) {
1791
  $slug = sanitize_title( $name );
1792
 
1793
- if ( 'default' == $name )
1794
  continue; // already handled above
1795
 
1796
  $template_values = array (
@@ -1843,59 +1862,62 @@ class MLASettings {
1843
  $page_values['style_options_list'] = $style_options_list;
1844
 
1845
  /*
1846
- * Add markup templates; default goes first
1847
  */
 
1848
  $markup_options_list = '';
1849
  $templates = MLAOptions::mla_get_markup_templates();
1850
 
1851
- $name = 'default';
1852
- $value =$templates['default'];
1853
- if ( ! empty( $value ) ) {
1854
- $template_values = array (
1855
- 'help' => 'The default template cannot be altered or deleted, but you can copy the markup.'
1856
- );
1857
- $control_cells = MLAData::mla_parse_template( self::$page_template_array['mla-gallery-default'], $template_values );
1858
-
1859
- $template_values = array (
1860
- 'readonly' => 'readonly="readonly"',
1861
- 'name_name' => 'mla_markup_templates_name[default]',
1862
- 'name_id' => 'mla_markup_templates_name_default',
1863
- 'name_text' => 'default',
1864
- 'control_cells' => $control_cells,
1865
-
1866
- 'open_name' => 'mla_markup_templates_open[default]',
1867
- 'open_id' => 'mla_markup_templates_open_default',
1868
- 'open_text' => esc_textarea( $value['open'] ),
1869
- 'open_help' => 'Markup for the beginning of the gallery. List of parameters, e.g., [+selector+], on Documentation tab.',
1870
-
1871
- 'row_open_name' => 'mla_markup_templates_row_open[default]',
1872
- 'row_open_id' => 'mla_markup_templates_row_open_default',
1873
- 'row_open_text' => esc_textarea( $value['row-open'] ),
1874
- 'row_open_help' => 'Markup for the beginning of each row in the gallery.',
1875
-
1876
- 'item_name' => 'mla_markup_templates_item[default]',
1877
- 'item_id' => 'mla_markup_templates_item_default',
1878
- 'item_text' => esc_textarea( $value['item'] ),
1879
- 'item_help' => 'Markup for each item/cell of the gallery.',
1880
-
1881
- 'row_close_name' => 'mla_markup_templates_row_close[default]',
1882
- 'row_close_id' => 'mla_markup_templates_row_close_default',
1883
- 'row_close_text' => esc_textarea( $value['row-close'] ),
1884
- 'row_close_help' => 'Markup for the end of each row in the gallery.',
1885
-
1886
- 'close_name' => 'mla_markup_templates_close[default]',
1887
- 'close_id' => 'mla_markup_templates_close_default',
1888
- 'close_text' => esc_textarea( $value['close'] ),
1889
- 'close_help' => 'Markup for the end of the gallery.'
1890
- );
1891
-
1892
- $markup_options_list .= MLAData::mla_parse_template( self::$page_template_array['mla-gallery-markup'], $template_values );
1893
- } // $value
 
 
1894
 
1895
  foreach ( $templates as $name => $value ) {
1896
  $slug = sanitize_title( $name );
1897
 
1898
- if ( 'default' == $name )
1899
  continue; // already handled above
1900
 
1901
  $template_values = array (
@@ -2050,8 +2072,12 @@ class MLASettings {
2050
  case 'add_rule_map':
2051
  case 'add_field_map':
2052
  $page_content = self::_save_custom_field_settings( $settings );
2053
- $map_content = self::_process_custom_field_mapping( $settings );
2054
- $page_content['message'] .= '<br>&nbsp;<br>' . $map_content['message'];
 
 
 
 
2055
  break;
2056
  default:
2057
  // ignore everything else
@@ -2159,8 +2185,12 @@ class MLASettings {
2159
  case 'add_rule_map':
2160
  case 'add_field_map':
2161
  $page_content = self::_save_iptc_exif_custom_settings( $settings );
2162
- $map_content = self::_process_iptc_exif_custom( $settings );
2163
- $page_content['message'] .= '<br>&nbsp;<br>' . $map_content['message'];
 
 
 
 
2164
  break;
2165
  default:
2166
  // ignore everything else
@@ -2339,9 +2369,10 @@ class MLASettings {
2339
  /*
2340
  * Build new style template array, noting changes
2341
  */
 
2342
  $templates_changed = false;
2343
  foreach ( $new_names as $name => $new_name ) {
2344
- if ( 'default' == $name )
2345
  continue;
2346
 
2347
  if( array_key_exists( $name, $new_deletes ) ) {
@@ -2418,9 +2449,10 @@ class MLASettings {
2418
  /*
2419
  * Build new markup template array, noting changes
2420
  */
 
2421
  $templates_changed = false;
2422
  foreach ( $new_names as $name => $new_name ) {
2423
- if ( 'default' == $name )
2424
  continue;
2425
 
2426
  if( array_key_exists( $name, $new_deletes ) ) {
@@ -2458,11 +2490,6 @@ class MLASettings {
2458
  }
2459
 
2460
  if ( $new_slug != $name ) {
2461
- if( array_key_exists( $new_slug, $old_templates ) ) {
2462
- $error_list .= "<br>ERROR: duplicate new markup template name '{$new_slug}', reverting to '{$name}'.";
2463
- $new_slug = $name;
2464
- }
2465
-
2466
  if( array_key_exists( $new_slug, $old_templates ) ) {
2467
  $error_list .= "<br>ERROR: duplicate new markup template name '{$new_slug}', reverting to '{$name}'.";
2468
  $new_slug = $name;
172
  MLAOptions::mla_update_option( 'custom_field_mapping', $new_values );
173
  } // version is less than 1.40
174
 
175
+ if ( ((float)'1.60') > ((float)$current_version) ) {
176
+ /*
177
+ * Add delimiters values to taxonomy mapping rules
178
+ */
179
+ $option_value = MLAOptions::mla_get_option( 'iptc_exif_mapping' );
180
+ $new_values = array();
181
+
182
+ foreach ( $option_value['taxonomy'] as $key => $value ) {
183
+ $value['delimiters'] = isset( $value['delimiters'] ) ? $value['delimiters'] : '';
184
+ $new_values[ $key ] = $value;
185
+ }
186
+
187
+ $option_value['taxonomy'] = $new_values;
188
+ MLAOptions::mla_update_option( 'iptc_exif_mapping', $option_value );
189
+ } // version is less than 1.60
190
+
191
  MLAOptions::mla_update_option( MLAOptions::MLA_VERSION_OPTION, MLA::CURRENT_MLA_VERSION );
192
  }
193
 
1775
  $page_values['options_list'] = $options_list;
1776
 
1777
  /*
1778
+ * Add style templates; defaults go first
1779
  */
1780
+ $default_styles = array( 'default', 'tag-cloud' );
1781
  $style_options_list = '';
1782
  $templates = MLAOptions::mla_get_style_templates();
1783
 
1784
+ foreach ( $default_styles as $default ) {
1785
+ $name = $default;
1786
+ $value =$templates[$default];
1787
+ if ( ! empty( $value ) ) {
1788
+ $template_values = array (
1789
+ 'help' => 'This default template cannot be altered or deleted, but you can copy the styles.'
1790
+ );
1791
+ $control_cells = MLAData::mla_parse_template( self::$page_template_array['mla-gallery-default'], $template_values );
1792
+
1793
+ $template_values = array (
1794
+ 'readonly' => 'readonly="readonly"',
1795
+ 'name_name' => "mla_style_templates_name[{$default}]",
1796
+ 'name_id' => "mla_style_templates_name_{$default}",
1797
+ 'name_text' => $default,
1798
+ 'control_cells' => $control_cells,
1799
+ 'value_name' => "mla_style_templates_value[{$default}]",
1800
+ 'value_id' => "mla_style_templates_value_{$default}",
1801
+ 'value_text' => esc_textarea( $value ),
1802
+ 'value_help' => 'List of substitution parameters, e.g., [+selector+], on Documentation tab.'
1803
+ );
1804
+
1805
+ $style_options_list .= MLAData::mla_parse_template( self::$page_template_array['mla-gallery-style'], $template_values );
1806
+ } // $value
1807
+ } // foreach default
1808
 
1809
  foreach ( $templates as $name => $value ) {
1810
  $slug = sanitize_title( $name );
1811
 
1812
+ if ( in_array( $name, $default_styles ) )
1813
  continue; // already handled above
1814
 
1815
  $template_values = array (
1862
  $page_values['style_options_list'] = $style_options_list;
1863
 
1864
  /*
1865
+ * Add markup templates; defaults go first
1866
  */
1867
+ $default_markups = array( 'default', 'tag-cloud', 'tag-cloud-ul', 'tag-cloud-dl' );
1868
  $markup_options_list = '';
1869
  $templates = MLAOptions::mla_get_markup_templates();
1870
 
1871
+ foreach ( $default_markups as $default ) {
1872
+ $name = $default;
1873
+ $value =$templates[$default];
1874
+ if ( ! empty( $value ) ) {
1875
+ $template_values = array (
1876
+ 'help' => 'This default template cannot be altered or deleted, but you can copy the markup.'
1877
+ );
1878
+ $control_cells = MLAData::mla_parse_template( self::$page_template_array['mla-gallery-default'], $template_values );
1879
+
1880
+ $template_values = array (
1881
+ 'readonly' => 'readonly="readonly"',
1882
+ 'name_name' => "mla_markup_templates_name[{$default}]",
1883
+ 'name_id' => "mla_markup_templates_name_{$default}",
1884
+ 'name_text' => $default,
1885
+ 'control_cells' => $control_cells,
1886
+
1887
+ 'open_name' => "mla_markup_templates_open[{$default}]",
1888
+ 'open_id' => "mla_markup_templates_open_{$default}",
1889
+ 'open_text' => isset( $value['open'] ) ? esc_textarea( $value['open'] ) : '',
1890
+ 'open_help' => 'Markup for the beginning of the gallery. List of parameters, e.g., [+selector+], on Documentation tab.',
1891
+
1892
+ 'row_open_name' => "mla_markup_templates_row_open[{$default}]",
1893
+ 'row_open_id' => "mla_markup_templates_row_open_{$default}",
1894
+ 'row_open_text' => isset( $value['row-open'] ) ? esc_textarea( $value['row-open'] ) : '',
1895
+ 'row_open_help' => 'Markup for the beginning of each row in the gallery.',
1896
+
1897
+ 'item_name' => "mla_markup_templates_item[{$default}]",
1898
+ 'item_id' => "mla_markup_templates_item_{$default}",
1899
+ 'item_text' => isset( $value['item'] ) ? esc_textarea( $value['item'] ) : '',
1900
+ 'item_help' => 'Markup for each item/cell of the gallery.',
1901
+
1902
+ 'row_close_name' => "mla_markup_templates_row_close[{$default}]",
1903
+ 'row_close_id' => "mla_markup_templates_row_close_{$default}",
1904
+ 'row_close_text' => isset( $value['row-close'] ) ? esc_textarea( $value['row-close'] ) : '',
1905
+ 'row_close_help' => 'Markup for the end of each row in the gallery.',
1906
+
1907
+ 'close_name' => "mla_markup_templates_close[{$default}]",
1908
+ 'close_id' => "mla_markup_templates_close_{$default}",
1909
+ 'close_text' => isset( $value['close'] ) ? esc_textarea( $value['close'] ) : '',
1910
+ 'close_help' => 'Markup for the end of the gallery.'
1911
+ );
1912
+
1913
+ $markup_options_list .= MLAData::mla_parse_template( self::$page_template_array['mla-gallery-markup'], $template_values );
1914
+ } // $value
1915
+ } // foreach default
1916
 
1917
  foreach ( $templates as $name => $value ) {
1918
  $slug = sanitize_title( $name );
1919
 
1920
+ if ( in_array( $name, $default_markups ) )
1921
  continue; // already handled above
1922
 
1923
  $template_values = array (
2072
  case 'add_rule_map':
2073
  case 'add_field_map':
2074
  $page_content = self::_save_custom_field_settings( $settings );
2075
+ if ( false === strpos( $page_content['message'], 'ERROR:' ) ) {
2076
+ $current_values = MLAOptions::mla_get_option( 'custom_field_mapping' );
2077
+ $settings = array( $value['name'] => $current_values[$value['name']] );
2078
+ $map_content = self::_process_custom_field_mapping( $settings );
2079
+ $page_content['message'] .= '<br>&nbsp;<br>' . $map_content['message'];
2080
+ }
2081
  break;
2082
  default:
2083
  // ignore everything else
2185
  case 'add_rule_map':
2186
  case 'add_field_map':
2187
  $page_content = self::_save_iptc_exif_custom_settings( $settings );
2188
+ if ( false === strpos( $page_content['message'], 'ERROR:' ) ) {
2189
+ $current_values = MLAOptions::mla_get_option( 'iptc_exif_mapping' );
2190
+ $settings = array( 'custom' => array( $value['name'] => $current_values['custom'][$value['name']] ) );
2191
+ $map_content = self::_process_iptc_exif_custom( $settings );
2192
+ $page_content['message'] .= '<br>&nbsp;<br>' . $map_content['message'];
2193
+ }
2194
  break;
2195
  default:
2196
  // ignore everything else
2369
  /*
2370
  * Build new style template array, noting changes
2371
  */
2372
+ $default_styles = array( 'default', 'tag-cloud' );
2373
  $templates_changed = false;
2374
  foreach ( $new_names as $name => $new_name ) {
2375
+ if ( in_array( $name, $default_styles ) )
2376
  continue;
2377
 
2378
  if( array_key_exists( $name, $new_deletes ) ) {
2449
  /*
2450
  * Build new markup template array, noting changes
2451
  */
2452
+ $default_markups = array( 'default', 'tag-cloud', 'tag-cloud-ul', 'tag-cloud-dl' );
2453
  $templates_changed = false;
2454
  foreach ( $new_names as $name => $new_name ) {
2455
+ if ( in_array( $name, $default_markups ) )
2456
  continue;
2457
 
2458
  if( array_key_exists( $name, $new_deletes ) ) {
2490
  }
2491
 
2492
  if ( $new_slug != $name ) {
 
 
 
 
 
2493
  if( array_key_exists( $new_slug, $old_templates ) ) {
2494
  $error_list .= "<br>ERROR: duplicate new markup template name '{$new_slug}', reverting to '{$name}'.";
2495
  $new_slug = $name;
includes/class-mla-shortcodes.php CHANGED
@@ -23,6 +23,7 @@ class MLAShortcodes {
23
  public static function initialize() {
24
  add_shortcode( 'mla_attachment_list', 'MLAShortcodes::mla_attachment_list_shortcode' );
25
  add_shortcode( 'mla_gallery', 'MLAShortcodes::mla_gallery_shortcode' );
 
26
  }
27
 
28
  /**
@@ -151,11 +152,12 @@ class MLAShortcodes {
151
  *
152
  * @since .50
153
  *
154
- * @param array $attr Attributes of the shortcode.
 
155
  *
156
  * @return string HTML content to display gallery.
157
  */
158
- public static function mla_gallery_shortcode( $attr ) {
159
  global $post;
160
 
161
  /*
@@ -176,7 +178,7 @@ class MLAShortcodes {
176
  * The mla_paginate_current parameter can be changed to support multiple galleries per page.
177
  */
178
  if ( ! isset( $attr['mla_page_parameter'] ) )
179
- $attr['mla_page_parameter'] = 'mla_paginate_current';
180
 
181
  $mla_page_parameter = $attr['mla_page_parameter'];
182
 
@@ -188,19 +190,11 @@ class MLAShortcodes {
188
  if ( ! isset( $attr[ $mla_page_parameter ] ) )
189
  if ( isset( $_REQUEST[ $mla_page_parameter ] ) )
190
  $attr[ $mla_page_parameter ] = $_REQUEST[ $mla_page_parameter ];
191
- // else
192
- // $attr[ $mla_page_parameter ] = '';
193
 
194
  /*
195
  * These are the parameters for gallery display
196
  */
197
- $mla_arguments = array(
198
- 'mla_output' => 'gallery',
199
- 'mla_style' => MLAOptions::mla_get_option('default_style'),
200
- 'mla_markup' => MLAOptions::mla_get_option('default_markup'),
201
- 'mla_float' => is_rtl() ? 'right' : 'left',
202
- 'mla_itemwidth' => MLAOptions::mla_get_option('mla_gallery_itemwidth'),
203
- 'mla_margin' => MLAOptions::mla_get_option('mla_gallery_margin'),
204
  'mla_link_attributes' => '',
205
  'mla_link_class' => '',
206
  'mla_link_href' => '',
@@ -210,7 +204,16 @@ class MLAShortcodes {
210
  'mla_image_class' => '',
211
  'mla_image_alt' => '',
212
  'mla_image_attributes' => '',
213
- 'mla_caption' => '',
 
 
 
 
 
 
 
 
 
214
  'mla_target' => '',
215
  'mla_debug' => false,
216
  'mla_viewer' => false,
@@ -219,12 +222,19 @@ class MLAShortcodes {
219
  'mla_viewer_width' => '150',
220
  'mla_alt_shortcode' => NULL,
221
  'mla_alt_ids_name' => 'ids',
222
- // paginate_links arguments
 
 
 
 
 
 
223
  'mla_end_size'=> 1,
224
  'mla_mid_size' => 2,
225
  'mla_prev_text' => '&laquo; Previous',
226
  'mla_next_text' => 'Next &raquo;',
227
- 'mla_paginate_type' => 'plain'
 
228
  );
229
 
230
  $default_arguments = array_merge( array(
@@ -259,7 +269,7 @@ class MLAShortcodes {
259
  * attachment-specific Gallery Display Content parameters must be evaluated
260
  * later, when all of the information is available.
261
  */
262
- if ( in_array( $attr_key, array( 'mla_link_attributes', 'mla_link_class', 'mla_link_href', 'mla_link_text', 'mla_nolink_text', 'mla_rollover_text', 'mla_image_class', 'mla_image_alt', 'mla_image_attributes', 'mla_caption' ) ) )
263
  continue;
264
 
265
  $attr_value = str_replace( '{+', '[+', str_replace( '+}', '+]', $attr_value ) );
@@ -274,6 +284,7 @@ class MLAShortcodes {
274
  */
275
 
276
  $attr = apply_filters( 'mla_gallery_attributes', $attr );
 
277
  $arguments = shortcode_atts( $default_arguments, $attr );
278
  $arguments = apply_filters( 'mla_gallery_arguments', $arguments );
279
 
@@ -312,7 +323,7 @@ class MLAShortcodes {
312
  /*
313
  * Replace data-selection parameters with the "ids" list
314
  */
315
- $blacklist = array_merge( $mla_arguments, self::$data_selection_parameters );
316
  $new_args = '';
317
  foreach ( $attr as $key => $value ) {
318
  if ( array_key_exists( $key, $blacklist ) ) {
@@ -343,7 +354,12 @@ class MLAShortcodes {
343
  /*
344
  * Execute the alternate gallery shortcode with the new parameters
345
  */
346
- return $output . do_shortcode( sprintf( '[%1$s %2$s %3$s]', $arguments['mla_alt_shortcode'], $new_ids, $new_args ) );
 
 
 
 
 
347
  } // mla_alt_shortcode
348
 
349
  /*
@@ -503,11 +519,13 @@ class MLAShortcodes {
503
  $markup_values['site_url'] = site_url();
504
  $markup_values['base_url'] = $upload_dir['baseurl'];
505
  $markup_values['base_dir'] = $upload_dir['basedir'];
 
 
506
 
507
  $open_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-open', 'markup' );
508
  if ( false === $open_template ) {
509
- $markup_values['mla_markup'] = 'default';
510
- $open_template = MLAOptions::mla_fetch_gallery_template( 'default-open', 'markup' );
511
  }
512
  if ( empty( $open_template ) )
513
  $open_template = '';
@@ -547,12 +565,12 @@ class MLAShortcodes {
547
 
548
  $open_template = apply_filters( 'mla_gallery_open_template', $open_template );
549
  if ( empty( $open_template ) )
550
- $gallery_div = '';
551
  else
552
- $gallery_div = MLAData::mla_parse_template( $open_template, $markup_values );
553
 
554
- $gallery_div = apply_filters( 'mla_gallery_open_parse', $gallery_div, $open_template, $markup_values );
555
- $output .= apply_filters( 'mla_gallery_style', $gallery_style . $gallery_div, $style_values, $markup_values, $style_template, $open_template );
556
  }
557
  else {
558
  if ( ! isset( $attachments['found_rows'] ) )
@@ -569,13 +587,12 @@ class MLAShortcodes {
569
  }
570
 
571
  /*
572
- * For "previous_link" and "next_link", discard all of the $attachments except the appropriate choice
573
  */
574
  if ( ! $is_gallery ) {
575
- $is_previous = 'previous_link' == $output_parameters[0];
576
- $is_next = 'next_link' == $output_parameters[0];
577
 
578
- if ( ! ( $is_previous || $is_next ) )
579
  return ''; // unknown outtput type
580
 
581
  $is_wrap = isset( $output_parameters[1] ) && 'wrap' == $output_parameters[1];
@@ -586,21 +603,41 @@ class MLAShortcodes {
586
  break;
587
  }
588
 
589
- $target_id = $is_previous ? $id - 1 : $id + 1;
 
 
 
 
 
 
 
 
 
 
 
 
590
  if ( isset( $attachments[ $target_id ] ) ) {
591
- $attachments = array( $attachments[ $target_id ] );
592
  }
593
  elseif ( $is_wrap ) {
594
- if ( $is_next )
595
- $attachments = array( array_shift( $attachments ) );
596
- else
597
- $attachments = array( array_pop( $attachments ) );
 
 
 
598
  } // is_wrap
 
 
 
599
  elseif ( ! empty( $arguments['mla_nolink_text'] ) )
600
  return self::_process_shortcode_parameter( $arguments['mla_nolink_text'], $markup_values ) . '</a>';
601
  else
602
  return '';
603
  } // ! is_gallery
 
 
604
 
605
  $column_index = 0;
606
  foreach ( $attachments as $id => $attachment ) {
@@ -625,6 +662,7 @@ class MLAShortcodes {
625
  $item_values['slug'] = wptexturize( $attachment->post_name );
626
  $item_values['width'] = '';
627
  $item_values['height'] = '';
 
628
  $item_values['image_meta'] = '';
629
  $item_values['image_alt'] = '';
630
  $item_values['base_file'] = '';
@@ -644,10 +682,23 @@ class MLAShortcodes {
644
  $base_file = $post_meta['mla_wp_attached_file'];
645
  $sizes = isset( $post_meta['mla_wp_attachment_metadata']['sizes'] ) ? $post_meta['mla_wp_attachment_metadata']['sizes'] : array();
646
 
647
- if ( !empty( $post_meta['mla_wp_attachment_metadata']['width'] ) )
648
  $item_values['width'] = $post_meta['mla_wp_attachment_metadata']['width'];
649
- if ( !empty( $post_meta['mla_wp_attachment_metadata']['height'] ) )
 
 
 
 
 
650
  $item_values['height'] = $post_meta['mla_wp_attachment_metadata']['height'];
 
 
 
 
 
 
 
 
651
  if ( !empty( $post_meta['mla_wp_attachment_metadata']['image_meta'] ) )
652
  $item_values['image_meta'] = wptexturize( var_export( $post_meta['mla_wp_attachment_metadata']['image_meta'], true ) );
653
  if ( !empty( $post_meta['mla_wp_attachment_image_alt'] ) )
@@ -683,8 +734,11 @@ class MLAShortcodes {
683
  /*
684
  * Add attachment-specific field-level substitution parameters
685
  */
686
- $new_text = $item_template . str_replace( '{+', '[+', str_replace( '+}', '+]', $arguments['mla_link_attributes'] . $arguments['mla_link_class'] . $arguments['mla_link_href'] . $arguments['mla_link_text'] . $arguments['mla_nolink_text'] . $arguments['mla_rollover_text'] . $arguments['mla_image_class'] . $arguments['mla_image_alt'] . $arguments['mla_image_attributes'] . $arguments['mla_caption'] ) );
687
-
 
 
 
688
  $item_values = MLAData::mla_expand_field_level_parameters( $new_text, $attr, $item_values, $attachment->ID );
689
 
690
  if ( $item_values['captiontag'] ) {
@@ -823,146 +877,899 @@ class MLAShortcodes {
823
  else
824
  $item_values['filelink_url'] = '';
825
 
826
- $match_count = preg_match_all( '#href=\'([^\']+)\'#', $item_values['link'], $matches, PREG_OFFSET_CAPTURE );
827
- if ( ! ( ( $match_count == false ) || ( $match_count == 0 ) ) ) {
828
- $item_values['link_url'] = $matches[1][0][0];
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
829
  }
830
- else
831
- $item_values['link_url'] = '';
832
 
833
- /*
834
- * Override the link value; leave filelink and pagelink unchanged
835
- * Note that $link_href is used in the Google Viewer code below
836
- */
837
  if ( ! empty( $arguments['mla_link_href'] ) ) {
838
  $link_href = self::_process_shortcode_parameter( $arguments['mla_link_href'], $item_values );
839
-
840
- /*
841
- * Replace single- and double-quote delimited values
842
- */
843
- $item_values['link'] = preg_replace('# href=\'([^\']*)\'#', " href='{$link_href}'", $item_values['link'] );
844
- $item_values['link'] = preg_replace('# href=\"([^\"]*)\"#', " href=\"{$link_href}\"", $item_values['link'] );
845
  }
846
  else
847
  $link_href = '';
848
-
849
- $match_count = preg_match_all( '#\<a [^\>]+\>(.*)\</a\>#', $item_values['link'], $matches, PREG_OFFSET_CAPTURE );
850
- if ( ! ( ( $match_count == false ) || ( $match_count == 0 ) ) ) {
851
- $item_values['thumbnail_content'] = $matches[1][0][0];
852
  }
853
  else
854
- $item_values['thumbnail_content'] = '';
855
 
856
- $match_count = preg_match_all( '# width=\"([^\"]+)\" height=\"([^\"]+)\" src=\"([^\"]+)\" #', $item_values['link'], $matches, PREG_OFFSET_CAPTURE );
857
- if ( ! ( ( $match_count == false ) || ( $match_count == 0 ) ) ) {
858
- $item_values['thumbnail_width'] = $matches[1][0][0];
859
- $item_values['thumbnail_height'] = $matches[2][0][0];
860
- $item_values['thumbnail_url'] = $matches[3][0][0];
861
- }
862
- else {
863
- $item_values['thumbnail_width'] = '';
864
- $item_values['thumbnail_height'] = '';
865
- $item_values['thumbnail_url'] = '';
866
  }
 
 
867
 
868
  /*
869
- * Check for Google file viewer substitution, uses above-defined
870
- * $link_attributes (includes target), $rollover_text, $link_href (link only),
871
- * $image_attributes, $image_class, $image_alt
872
  */
873
- if ( $arguments['mla_viewer'] && empty( $item_values['thumbnail_url'] ) ) {
874
- $last_dot = strrpos( $item_values['file'], '.' );
875
- if ( !( false === $last_dot) ) {
876
- $extension = substr( $item_values['file'], $last_dot + 1 );
877
- if ( in_array( $extension, $arguments['mla_viewer_extensions'] ) ) {
878
- /*
879
- * <img> tag (thumbnail_text)
880
- */
881
- if ( ! empty( $image_class ) )
882
- $image_class = ' class="' . $image_class . '"';
883
-
884
- if ( ! empty( $image_alt ) )
885
- $image_alt = ' alt="' . $image_alt . '"';
886
- elseif ( ! empty( $item_values['caption'] ) )
887
- $image_alt = ' alt="' . $item_values['caption'] . '"';
888
-
889
- $item_values['thumbnail_content'] = sprintf( '<img %1$ssrc="http://docs.google.com/viewer?url=%2$s&a=bi&pagenumber=%3$d&w=%4$d"%5$s%6$s>', $image_attributes, $item_values['filelink_url'], $arguments['mla_viewer_page'], $arguments['mla_viewer_width'], $image_class, $image_alt );
890
-
891
- /*
892
- * Filelink, pagelink and link
893
- */
894
- $item_values['pagelink'] = sprintf( '<a %1$shref="%2$s" title="%3$s">%4$s</a>', $link_attributes, $item_values['pagelink_url'], $rollover_text, $item_values['thumbnail_content'] );
895
- $item_values['filelink'] = sprintf( '<a %1$shref="%2$s" title="%3$s">%4$s</a>', $link_attributes, $item_values['filelink_url'], $rollover_text, $item_values['thumbnail_content'] );
896
 
897
- if ( ! empty( $link_href ) )
898
- $item_values['link'] = sprintf( '<a %1$shref="%2$s" title="%3$s">%4$s</a>', $link_attributes, $link_href, $rollover_text, $item_values['thumbnail_content'] );
899
- elseif ( 'permalink' == $arguments['link'] )
900
- $item_values['link'] = $item_values['pagelink'];
901
- else
902
- $item_values['link'] = $item_values['filelink'];
903
- } // viewer extension
904
- } // has extension
905
- } // mla_viewer
906
-
907
- if ($is_gallery ) {
908
  /*
909
  * Start of row markup
910
  */
911
- if ( $markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 ) {
912
- $markup_values = apply_filters( 'mla_gallery_row_open_values', $markup_values );
913
- $row_open_template = apply_filters( 'mla_gallery_row_open_template', $row_open_template );
914
  $parse_value = MLAData::mla_parse_template( $row_open_template, $markup_values );
915
- $output .= apply_filters( 'mla_gallery_row_open_parse', $parse_value, $row_open_template, $markup_values );
916
  }
917
 
918
  /*
919
  * item markup
920
  */
921
  $column_index++;
922
- if ( $item_values['columns'] > 0 && $column_index % $item_values['columns'] == 0 )
923
- $item_values['last_in_row'] = 'last_in_row';
924
- else
925
- $item_values['last_in_row'] = '';
926
-
927
- $item_values = apply_filters( 'mla_gallery_item_values', $item_values );
928
- $item_template = apply_filters( 'mla_gallery_item_template', $item_template );
929
  $parse_value = MLAData::mla_parse_template( $item_template, $item_values );
930
- $output .= apply_filters( 'mla_gallery_item_parse', $parse_value, $item_template, $item_values );
931
 
932
  /*
933
  * End of row markup
934
  */
935
- if ( $markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 ) {
936
- $markup_values = apply_filters( 'mla_gallery_row_close_values', $markup_values );
937
- $row_close_template = apply_filters( 'mla_gallery_row_close_template', $row_close_template );
938
  $parse_value = MLAData::mla_parse_template( $row_close_template, $markup_values );
939
- $output .= apply_filters( 'mla_gallery_row_close_parse', $parse_value, $row_close_template, $markup_values );
940
  }
941
- } // is_gallery
942
- elseif ( ( $is_previous || $is_next ) )
943
- return $item_values['link'];
944
- } // foreach attachment
945
-
946
- if ($is_gallery ) {
 
 
 
 
 
947
  /*
948
  * Close out partial row
949
  */
950
- if ( ! ($markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 ) ) {
951
- $markup_values = apply_filters( 'mla_gallery_row_close_values', $markup_values );
952
- $row_close_template = apply_filters( 'mla_gallery_row_close_template', $row_close_template );
953
  $parse_value = MLAData::mla_parse_template( $row_close_template, $markup_values );
954
- $output .= apply_filters( 'mla_gallery_row_close_parse', $parse_value, $row_close_template, $markup_values );
955
  }
956
 
957
- $markup_values = apply_filters( 'mla_gallery_close_values', $markup_values );
958
- $close_template = apply_filters( 'mla_gallery_close_template', $close_template );
959
  $parse_value = MLAData::mla_parse_template( $close_template, $markup_values );
960
- $output .= apply_filters( 'mla_gallery_close_parse', $parse_value, $close_template, $markup_values );
961
- } // is_gallery
 
 
 
 
 
 
 
 
 
 
 
962
 
963
- return $output;
 
 
 
 
 
964
  }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
965
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
966
  /**
967
  * Handles brace/bracket escaping and parses template for a shortcode parameter
968
  *
@@ -1100,6 +1907,7 @@ class MLAShortcodes {
1100
  $results .= join("</li>\n\t<li>", $page_links);
1101
  $results .= "</li>\n</ul>\n";
1102
  break;
 
1103
  default:
1104
  $results = join("\n", $page_links);
1105
  } // mla_paginate_type
@@ -1128,7 +1936,7 @@ class MLAShortcodes {
1128
  /*
1129
  * Add data selection parameters to gallery-specific and mla_gallery-specific parameters
1130
  */
1131
- $arguments = array_merge( $arguments, shortcode_atts( self::$data_selection_parameters, $attr ) );
1132
  $posts_per_page = absint( $arguments['posts_per_page'] );
1133
  $mla_page_parameter = $arguments['mla_page_parameter'];
1134
 
@@ -1417,7 +2225,7 @@ class MLAShortcodes {
1417
  *
1418
  * @var array
1419
  */
1420
- private static $data_selection_parameters = array(
1421
  'order' => 'ASC', // or 'DESC' or 'RAND'
1422
  'orderby' => 'menu_order,ID',
1423
  'id' => NULL,
@@ -1513,6 +2321,18 @@ class MLAShortcodes {
1513
  elseif ( is_string( $attr ) )
1514
  $attr = shortcode_parse_atts( $attr );
1515
 
 
 
 
 
 
 
 
 
 
 
 
 
1516
  /*
1517
  * Merge input arguments with defaults, then extract the query arguments.
1518
  *
@@ -1522,7 +2342,7 @@ class MLAShortcodes {
1522
  if ( ! is_null( $return_found_rows ) )
1523
  $attr = apply_filters( 'mla_gallery_query_attributes', $attr );
1524
 
1525
- $arguments = shortcode_atts( self::$data_selection_parameters, $attr );
1526
  $mla_page_parameter = $arguments['mla_page_parameter'];
1527
  unset( $arguments['mla_page_parameter'] );
1528
 
@@ -1569,14 +2389,22 @@ class MLAShortcodes {
1569
  else {
1570
  $tax_query = NULL;
1571
  $value = self::_sanitize_query_specification( $value );
 
 
 
 
 
 
 
1572
  $function = @create_function('', 'return ' . $value . ';' );
1573
  if ( is_callable( $function ) )
1574
  $tax_query = $function();
1575
 
1576
  if ( is_array( $tax_query ) )
1577
  $query_arguments[ $key ] = $tax_query;
1578
- else
1579
  return '<p>ERROR: invalid mla_gallery tax_query = ' . var_export( $value, true ) . '</p>';
 
1580
  } // not array
1581
  } // tax_query
1582
  elseif ( array_key_exists( $key, $taxonomies ) ) {
@@ -1780,6 +2608,13 @@ class MLAShortcodes {
1780
  else {
1781
  $meta_query = NULL;
1782
  $value = self::_sanitize_query_specification( $value );
 
 
 
 
 
 
 
1783
  $function = @create_function('', 'return ' . $value . ';' );
1784
  if ( is_callable( $function ) )
1785
  $meta_query = $function();
@@ -2011,5 +2846,250 @@ class MLAShortcodes {
2011
 
2012
  return $pieces;
2013
  }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2014
  } // Class MLAShortcodes
2015
  ?>
23
  public static function initialize() {
24
  add_shortcode( 'mla_attachment_list', 'MLAShortcodes::mla_attachment_list_shortcode' );
25
  add_shortcode( 'mla_gallery', 'MLAShortcodes::mla_gallery_shortcode' );
26
+ add_shortcode( 'mla_tag_cloud', 'MLAShortcodes::mla_tag_cloud_shortcode' );
27
  }
28
 
29
  /**
152
  *
153
  * @since .50
154
  *
155
+ * @param array Attributes of the shortcode
156
+ * @param string Optional content for enclosing shortcodes; used with mla_alt_shortcode
157
  *
158
  * @return string HTML content to display gallery.
159
  */
160
+ public static function mla_gallery_shortcode( $attr, $content = NULL ) {
161
  global $post;
162
 
163
  /*
178
  * The mla_paginate_current parameter can be changed to support multiple galleries per page.
179
  */
180
  if ( ! isset( $attr['mla_page_parameter'] ) )
181
+ $attr['mla_page_parameter'] = self::$mla_get_shortcode_attachments_parameters['mla_page_parameter'];
182
 
183
  $mla_page_parameter = $attr['mla_page_parameter'];
184
 
190
  if ( ! isset( $attr[ $mla_page_parameter ] ) )
191
  if ( isset( $_REQUEST[ $mla_page_parameter ] ) )
192
  $attr[ $mla_page_parameter ] = $_REQUEST[ $mla_page_parameter ];
 
 
193
 
194
  /*
195
  * These are the parameters for gallery display
196
  */
197
+ $mla_item_specific_arguments = array(
 
 
 
 
 
 
198
  'mla_link_attributes' => '',
199
  'mla_link_class' => '',
200
  'mla_link_href' => '',
204
  'mla_image_class' => '',
205
  'mla_image_alt' => '',
206
  'mla_image_attributes' => '',
207
+ 'mla_caption' => ''
208
+ );
209
+
210
+ $mla_arguments = array_merge( array(
211
+ 'mla_output' => 'gallery',
212
+ 'mla_style' => MLAOptions::mla_get_option('default_style'),
213
+ 'mla_markup' => MLAOptions::mla_get_option('default_markup'),
214
+ 'mla_float' => is_rtl() ? 'right' : 'left',
215
+ 'mla_itemwidth' => MLAOptions::mla_get_option('mla_gallery_itemwidth'),
216
+ 'mla_margin' => MLAOptions::mla_get_option('mla_gallery_margin'),
217
  'mla_target' => '',
218
  'mla_debug' => false,
219
  'mla_viewer' => false,
222
  'mla_viewer_width' => '150',
223
  'mla_alt_shortcode' => NULL,
224
  'mla_alt_ids_name' => 'ids',
225
+
226
+ // paginatation arguments defined in $mla_get_shortcode_attachments_parameters
227
+ // 'mla_page_parameter' => 'mla_paginate_current', handled in code with $mla_page_parameter
228
+ // 'mla_paginate_current' => NULL,
229
+ // 'mla_paginate_total' => NULL,
230
+ // 'id' => NULL,
231
+
232
  'mla_end_size'=> 1,
233
  'mla_mid_size' => 2,
234
  'mla_prev_text' => '&laquo; Previous',
235
  'mla_next_text' => 'Next &raquo;',
236
+ 'mla_paginate_type' => 'plain'),
237
+ $mla_item_specific_arguments
238
  );
239
 
240
  $default_arguments = array_merge( array(
269
  * attachment-specific Gallery Display Content parameters must be evaluated
270
  * later, when all of the information is available.
271
  */
272
+ if ( in_array( $attr_key, $mla_item_specific_arguments ) )
273
  continue;
274
 
275
  $attr_value = str_replace( '{+', '[+', str_replace( '+}', '+]', $attr_value ) );
284
  */
285
 
286
  $attr = apply_filters( 'mla_gallery_attributes', $attr );
287
+ $content = apply_filters( 'mla_gallery_initial_content', $content, $attr );
288
  $arguments = shortcode_atts( $default_arguments, $attr );
289
  $arguments = apply_filters( 'mla_gallery_arguments', $arguments );
290
 
323
  /*
324
  * Replace data-selection parameters with the "ids" list
325
  */
326
+ $blacklist = array_merge( $mla_arguments, self::$mla_get_shortcode_attachments_parameters );
327
  $new_args = '';
328
  foreach ( $attr as $key => $value ) {
329
  if ( array_key_exists( $key, $blacklist ) ) {
354
  /*
355
  * Execute the alternate gallery shortcode with the new parameters
356
  */
357
+ $content = apply_filters( 'mla_gallery_final_content', $content );
358
+ if ( ! empty( $content ) ) {
359
+ return $output . do_shortcode( sprintf( '[%1$s %2$s %3$s]%4$s[/%5$s]', $arguments['mla_alt_shortcode'], $new_ids, $new_args, $content, $arguments['mla_alt_shortcode'] ) );
360
+ } else {
361
+ return $output . do_shortcode( sprintf( '[%1$s %2$s %3$s]', $arguments['mla_alt_shortcode'], $new_ids, $new_args ) );
362
+ }
363
  } // mla_alt_shortcode
364
 
365
  /*
519
  $markup_values['site_url'] = site_url();
520
  $markup_values['base_url'] = $upload_dir['baseurl'];
521
  $markup_values['base_dir'] = $upload_dir['basedir'];
522
+ $markup_values['page_ID'] = get_the_ID();
523
+ $markup_values['page_url'] = ( 0 < $markup_values['page_ID'] ) ? get_page_link() : '';
524
 
525
  $open_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-open', 'markup' );
526
  if ( false === $open_template ) {
527
+ $markup_values['mla_markup'] = 'tag-cloud';
528
+ $open_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-open', 'markup' );
529
  }
530
  if ( empty( $open_template ) )
531
  $open_template = '';
565
 
566
  $open_template = apply_filters( 'mla_gallery_open_template', $open_template );
567
  if ( empty( $open_template ) )
568
+ $gallery_open = '';
569
  else
570
+ $gallery_open = MLAData::mla_parse_template( $open_template, $markup_values );
571
 
572
+ $gallery_open = apply_filters( 'mla_gallery_open_parse', $gallery_open, $open_template, $markup_values );
573
+ $output .= apply_filters( 'mla_gallery_style', $gallery_style . $gallery_open, $style_values, $markup_values, $style_template, $open_template );
574
  }
575
  else {
576
  if ( ! isset( $attachments['found_rows'] ) )
587
  }
588
 
589
  /*
590
+ * For "previous_link", "current_link" and "next_link", discard all of the $attachments except the appropriate choice
591
  */
592
  if ( ! $is_gallery ) {
593
+ $link_type = $output_parameters[0];
 
594
 
595
+ if ( ! in_array( $link_type, array ( 'previous_link', 'current_link', 'next_link' ) ) )
596
  return ''; // unknown outtput type
597
 
598
  $is_wrap = isset( $output_parameters[1] ) && 'wrap' == $output_parameters[1];
603
  break;
604
  }
605
 
606
+ switch ( $link_type ) {
607
+ case 'previous_link':
608
+ $target_id = $id - 1;
609
+ break;
610
+ case 'next_link':
611
+ $target_id = $id + 1;
612
+ break;
613
+ case 'current_link':
614
+ default:
615
+ $target_id = $id;
616
+ } // link_type
617
+
618
+ $target = NULL;
619
  if ( isset( $attachments[ $target_id ] ) ) {
620
+ $target = $attachments[ $target_id ];
621
  }
622
  elseif ( $is_wrap ) {
623
+ switch ( $link_type ) {
624
+ case 'previous_link':
625
+ $target = array_pop( $attachments );
626
+ break;
627
+ case 'next_link':
628
+ $target = array_shift( $attachments );
629
+ } // link_type
630
  } // is_wrap
631
+
632
+ if ( isset( $target ) )
633
+ $attachments = array( $target );
634
  elseif ( ! empty( $arguments['mla_nolink_text'] ) )
635
  return self::_process_shortcode_parameter( $arguments['mla_nolink_text'], $markup_values ) . '</a>';
636
  else
637
  return '';
638
  } // ! is_gallery
639
+ else
640
+ $link_type= '';
641
 
642
  $column_index = 0;
643
  foreach ( $attachments as $id => $attachment ) {
662
  $item_values['slug'] = wptexturize( $attachment->post_name );
663
  $item_values['width'] = '';
664
  $item_values['height'] = '';
665
+ $item_values['orientation'] = '';
666
  $item_values['image_meta'] = '';
667
  $item_values['image_alt'] = '';
668
  $item_values['base_file'] = '';
682
  $base_file = $post_meta['mla_wp_attached_file'];
683
  $sizes = isset( $post_meta['mla_wp_attachment_metadata']['sizes'] ) ? $post_meta['mla_wp_attachment_metadata']['sizes'] : array();
684
 
685
+ if ( !empty( $post_meta['mla_wp_attachment_metadata']['width'] ) ) {
686
  $item_values['width'] = $post_meta['mla_wp_attachment_metadata']['width'];
687
+ $width = absint( $item_values['width'] );
688
+ }
689
+ else
690
+ $width = 0;
691
+
692
+ if ( !empty( $post_meta['mla_wp_attachment_metadata']['height'] ) ) {
693
  $item_values['height'] = $post_meta['mla_wp_attachment_metadata']['height'];
694
+ $height = absint( $item_values['height'] );
695
+ }
696
+ else
697
+ $height = 0;
698
+
699
+ if ( $width && $height )
700
+ $item_values['orientation'] = ( $height > $width ) ? 'portrait' : 'landscape';
701
+
702
  if ( !empty( $post_meta['mla_wp_attachment_metadata']['image_meta'] ) )
703
  $item_values['image_meta'] = wptexturize( var_export( $post_meta['mla_wp_attachment_metadata']['image_meta'], true ) );
704
  if ( !empty( $post_meta['mla_wp_attachment_image_alt'] ) )
734
  /*
735
  * Add attachment-specific field-level substitution parameters
736
  */
737
+ $new_text = isset( $item_template ) ? $item_template : '';
738
+ foreach( $mla_item_specific_arguments as $index => $value ) {
739
+ $new_text .= str_replace( '{+', '[+', str_replace( '+}', '+]', $arguments[ $index ] ) );
740
+ }
741
+
742
  $item_values = MLAData::mla_expand_field_level_parameters( $new_text, $attr, $item_values, $attachment->ID );
743
 
744
  if ( $item_values['captiontag'] ) {
877
  else
878
  $item_values['filelink_url'] = '';
879
 
880
+ $match_count = preg_match_all( '#href=\'([^\']+)\'#', $item_values['link'], $matches, PREG_OFFSET_CAPTURE );
881
+ if ( ! ( ( $match_count == false ) || ( $match_count == 0 ) ) ) {
882
+ $item_values['link_url'] = $matches[1][0][0];
883
+ }
884
+ else
885
+ $item_values['link_url'] = '';
886
+
887
+ /*
888
+ * Override the link value; leave filelink and pagelink unchanged
889
+ * Note that $link_href is used in the Google Viewer code below
890
+ */
891
+ if ( ! empty( $arguments['mla_link_href'] ) ) {
892
+ $link_href = self::_process_shortcode_parameter( $arguments['mla_link_href'], $item_values );
893
+
894
+ /*
895
+ * Replace single- and double-quote delimited values
896
+ */
897
+ $item_values['link'] = preg_replace('# href=\'([^\']*)\'#', " href='{$link_href}'", $item_values['link'] );
898
+ $item_values['link'] = preg_replace('# href=\"([^\"]*)\"#', " href=\"{$link_href}\"", $item_values['link'] );
899
+ }
900
+ else
901
+ $link_href = '';
902
+
903
+ $match_count = preg_match_all( '#\<a [^\>]+\>(.*)\</a\>#', $item_values['link'], $matches, PREG_OFFSET_CAPTURE );
904
+ if ( ! ( ( $match_count == false ) || ( $match_count == 0 ) ) ) {
905
+ $item_values['thumbnail_content'] = $matches[1][0][0];
906
+ }
907
+ else
908
+ $item_values['thumbnail_content'] = '';
909
+
910
+ $match_count = preg_match_all( '# width=\"([^\"]+)\" height=\"([^\"]+)\" src=\"([^\"]+)\" #', $item_values['link'], $matches, PREG_OFFSET_CAPTURE );
911
+ if ( ! ( ( $match_count == false ) || ( $match_count == 0 ) ) ) {
912
+ $item_values['thumbnail_width'] = $matches[1][0][0];
913
+ $item_values['thumbnail_height'] = $matches[2][0][0];
914
+ $item_values['thumbnail_url'] = $matches[3][0][0];
915
+ }
916
+ else {
917
+ $item_values['thumbnail_width'] = '';
918
+ $item_values['thumbnail_height'] = '';
919
+ $item_values['thumbnail_url'] = '';
920
+ }
921
+
922
+ /*
923
+ * Now that we have thumbnail_content we can check for 'span' and 'none'
924
+ */
925
+ if ( 'none' == $arguments['link'] )
926
+ $item_values['link'] = $item_values['thumbnail_content'];
927
+ elseif ( 'span' == $arguments['link'] )
928
+ $item_values['link'] = sprintf( '<span %1$s>%2$s</span>', $link_attributes, $item_values['thumbnail_content'] );
929
+
930
+ /*
931
+ * Check for Google file viewer substitution, uses above-defined
932
+ * $link_attributes (includes target), $rollover_text, $link_href (link only),
933
+ * $image_attributes, $image_class, $image_alt
934
+ */
935
+ if ( $arguments['mla_viewer'] && empty( $item_values['thumbnail_url'] ) ) {
936
+ $last_dot = strrpos( $item_values['file'], '.' );
937
+ if ( !( false === $last_dot) ) {
938
+ $extension = substr( $item_values['file'], $last_dot + 1 );
939
+ if ( in_array( $extension, $arguments['mla_viewer_extensions'] ) ) {
940
+ /*
941
+ * <img> tag (thumbnail_text)
942
+ */
943
+ if ( ! empty( $image_class ) )
944
+ $image_class = ' class="' . $image_class . '"';
945
+
946
+ if ( ! empty( $image_alt ) )
947
+ $image_alt = ' alt="' . $image_alt . '"';
948
+ elseif ( ! empty( $item_values['caption'] ) )
949
+ $image_alt = ' alt="' . $item_values['caption'] . '"';
950
+
951
+ $item_values['thumbnail_content'] = sprintf( '<img %1$ssrc="http://docs.google.com/viewer?url=%2$s&a=bi&pagenumber=%3$d&w=%4$d"%5$s%6$s>', $image_attributes, $item_values['filelink_url'], $arguments['mla_viewer_page'], $arguments['mla_viewer_width'], $image_class, $image_alt );
952
+
953
+ /*
954
+ * Filelink, pagelink and link
955
+ */
956
+ $item_values['pagelink'] = sprintf( '<a %1$shref="%2$s" title="%3$s">%4$s</a>', $link_attributes, $item_values['pagelink_url'], $rollover_text, $item_values['thumbnail_content'] );
957
+ $item_values['filelink'] = sprintf( '<a %1$shref="%2$s" title="%3$s">%4$s</a>', $link_attributes, $item_values['filelink_url'], $rollover_text, $item_values['thumbnail_content'] );
958
+
959
+ if ( ! empty( $link_href ) )
960
+ $item_values['link'] = sprintf( '<a %1$shref="%2$s" title="%3$s">%4$s</a>', $link_attributes, $link_href, $rollover_text, $item_values['thumbnail_content'] );
961
+ elseif ( 'permalink' == $arguments['link'] )
962
+ $item_values['link'] = $item_values['pagelink'];
963
+ elseif ( 'file' == $arguments['link'] )
964
+ $item_values['link'] = $item_values['filelink'];
965
+ elseif ( 'span' == $arguments['link'] )
966
+ $item_values['link'] = sprintf( '<a %1$s>%2$s</a>', $link_attributes, $item_values['thumbnail_content'] );
967
+ else
968
+ $item_values['link'] = $item_values['thumbnail_content'];
969
+ } // viewer extension
970
+ } // has extension
971
+ } // mla_viewer
972
+
973
+ if ($is_gallery ) {
974
+ /*
975
+ * Start of row markup
976
+ */
977
+ if ( $markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 ) {
978
+ $markup_values = apply_filters( 'mla_gallery_row_open_values', $markup_values );
979
+ $row_open_template = apply_filters( 'mla_gallery_row_open_template', $row_open_template );
980
+ $parse_value = MLAData::mla_parse_template( $row_open_template, $markup_values );
981
+ $output .= apply_filters( 'mla_gallery_row_open_parse', $parse_value, $row_open_template, $markup_values );
982
+ }
983
+
984
+ /*
985
+ * item markup
986
+ */
987
+ $column_index++;
988
+ if ( $item_values['columns'] > 0 && $column_index % $item_values['columns'] == 0 )
989
+ $item_values['last_in_row'] = 'last_in_row';
990
+ else
991
+ $item_values['last_in_row'] = '';
992
+
993
+ $item_values = apply_filters( 'mla_gallery_item_values', $item_values );
994
+ $item_template = apply_filters( 'mla_gallery_item_template', $item_template );
995
+ $parse_value = MLAData::mla_parse_template( $item_template, $item_values );
996
+ $output .= apply_filters( 'mla_gallery_item_parse', $parse_value, $item_template, $item_values );
997
+
998
+ /*
999
+ * End of row markup
1000
+ */
1001
+ if ( $markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 ) {
1002
+ $markup_values = apply_filters( 'mla_gallery_row_close_values', $markup_values );
1003
+ $row_close_template = apply_filters( 'mla_gallery_row_close_template', $row_close_template );
1004
+ $parse_value = MLAData::mla_parse_template( $row_close_template, $markup_values );
1005
+ $output .= apply_filters( 'mla_gallery_row_close_parse', $parse_value, $row_close_template, $markup_values );
1006
+ }
1007
+ } // is_gallery
1008
+ elseif ( ! empty( $link_type ) )
1009
+ return $item_values['link'];
1010
+ } // foreach attachment
1011
+
1012
+ if ($is_gallery ) {
1013
+ /*
1014
+ * Close out partial row
1015
+ */
1016
+ if ( ! ($markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 ) ) {
1017
+ $markup_values = apply_filters( 'mla_gallery_row_close_values', $markup_values );
1018
+ $row_close_template = apply_filters( 'mla_gallery_row_close_template', $row_close_template );
1019
+ $parse_value = MLAData::mla_parse_template( $row_close_template, $markup_values );
1020
+ $output .= apply_filters( 'mla_gallery_row_close_parse', $parse_value, $row_close_template, $markup_values );
1021
+ }
1022
+
1023
+ $markup_values = apply_filters( 'mla_gallery_close_values', $markup_values );
1024
+ $close_template = apply_filters( 'mla_gallery_close_template', $close_template );
1025
+ $parse_value = MLAData::mla_parse_template( $close_template, $markup_values );
1026
+ $output .= apply_filters( 'mla_gallery_close_parse', $parse_value, $close_template, $markup_values );
1027
+ } // is_gallery
1028
+
1029
+ return $output;
1030
+ }
1031
+
1032
+ /**
1033
+ * The MLA Tag Cloud support function.
1034
+ *
1035
+ * This is an alternative to the WordPress wp_tag_cloud function, with additional
1036
+ * options to customize the hyperlink behind each term.
1037
+ *
1038
+ * @since 1.60
1039
+ *
1040
+ * @param array $attr Attributes of the shortcode.
1041
+ *
1042
+ * @return string HTML content to display the tag cloud.
1043
+ */
1044
+ public static function mla_tag_cloud( $attr ) {
1045
+ /*
1046
+ * These are the default parameters for tag cloud display
1047
+ */
1048
+ $mla_item_specific_arguments = array(
1049
+ 'mla_link_attributes' => '',
1050
+ 'mla_link_class' => '',
1051
+ 'mla_link_style' => '',
1052
+ 'mla_link_href' => '',
1053
+ 'mla_link_text' => '',
1054
+ 'mla_nolink_text' => '',
1055
+ 'mla_rollover_text' => '',
1056
+ 'mla_caption' => ''
1057
+ );
1058
+
1059
+ $mla_arguments = array_merge( array(
1060
+ 'mla_output' => 'flat',
1061
+ 'mla_style' => NULL,
1062
+ 'mla_markup' => NULL,
1063
+ 'mla_float' => is_rtl() ? 'right' : 'left',
1064
+ 'mla_itemwidth' => MLAOptions::mla_get_option('mla_tag_cloud_itemwidth'),
1065
+ 'mla_margin' => MLAOptions::mla_get_option('mla_tag_cloud_margin'),
1066
+ 'mla_target' => '',
1067
+ 'mla_debug' => false,
1068
+
1069
+ // Pagination parameters
1070
+ 'term_id' => NULL,
1071
+ 'mla_end_size'=> 1,
1072
+ 'mla_mid_size' => 2,
1073
+ 'mla_prev_text' => '&laquo; Previous',
1074
+ 'mla_next_text' => 'Next &raquo;',
1075
+ 'mla_page_parameter' => 'mla_cloud_current',
1076
+ 'mla_cloud_current' => NULL,
1077
+ 'mla_paginate_total' => NULL,
1078
+ 'mla_paginate_type' => 'plain'),
1079
+ $mla_item_specific_arguments
1080
+ );
1081
+
1082
+ $defaults = array_merge(
1083
+ self::$mla_get_terms_parameters,
1084
+ array(
1085
+ 'smallest' => 8,
1086
+ 'largest' => 22,
1087
+ 'unit' => 'pt',
1088
+ 'separator' => "\n",
1089
+ 'single_text' => '%d item',
1090
+ 'multiple_text' => '%d items',
1091
+
1092
+ 'echo' => false,
1093
+ 'link' => 'view',
1094
+
1095
+ 'itemtag' => 'ul',
1096
+ 'termtag' => 'li',
1097
+ 'captiontag' => '',
1098
+ 'columns' => MLAOptions::mla_get_option('mla_tag_cloud_columns')
1099
+ ),
1100
+ $mla_arguments
1101
+ );
1102
+
1103
+ /*
1104
+ * The mla_paginate_current parameter can be changed to support multiple galleries per page.
1105
+ */
1106
+ if ( ! isset( $attr['mla_page_parameter'] ) )
1107
+ $attr['mla_page_parameter'] = $defaults['mla_page_parameter'];
1108
+
1109
+ $mla_page_parameter = $attr['mla_page_parameter'];
1110
+
1111
+ /*
1112
+ * Special handling of mla_page_parameter to make
1113
+ * "MLA pagination" easier. Look for this parameter in $_REQUEST
1114
+ * if it's not present in the shortcode itself.
1115
+ */
1116
+ if ( ! isset( $attr[ $mla_page_parameter ] ) )
1117
+ if ( isset( $_REQUEST[ $mla_page_parameter ] ) )
1118
+ $attr[ $mla_page_parameter ] = $_REQUEST[ $mla_page_parameter ];
1119
+
1120
+ /*
1121
+ * Look for 'request' substitution parameters,
1122
+ * which can be added to any input parameter
1123
+ */
1124
+ foreach ( $attr as $attr_key => $attr_value ) {
1125
+ /*
1126
+ * item-specific Display Content parameters must be evaluated
1127
+ * later, when all of the information is available.
1128
+ */
1129
+ if ( in_array( $attr_key, $mla_item_specific_arguments ) )
1130
+ continue;
1131
+
1132
+ $attr_value = str_replace( '{+', '[+', str_replace( '+}', '+]', $attr_value ) );
1133
+ $replacement_values = MLAData::mla_expand_field_level_parameters( $attr_value );
1134
+
1135
+ if ( ! empty( $replacement_values ) )
1136
+ $attr[ $attr_key ] = MLAData::mla_parse_template( $attr_value, $replacement_values );
1137
+ }
1138
+
1139
+ $attr = apply_filters( 'mla_tag_cloud_attributes', $attr );
1140
+ $arguments = shortcode_atts( $defaults, $attr );
1141
+
1142
+ /*
1143
+ * $mla_page_parameter, if non-default, doesn't make it through the shortcode_atts filter,
1144
+ * so we handle it separately
1145
+ */
1146
+ if ( ! isset( $arguments[ $mla_page_parameter ] ) )
1147
+ if ( isset( $attr[ $mla_page_parameter ] ) )
1148
+ $arguments[ $mla_page_parameter ] = $attr[ $mla_page_parameter ];
1149
+ else
1150
+ $arguments[ $mla_page_parameter ] = $defaults['mla_cloud_current'];
1151
+
1152
+ /*
1153
+ * Process the pagination parameter, if present
1154
+ */
1155
+ if ( isset( $arguments[ $mla_page_parameter ] ) ) {
1156
+ $arguments['offset'] = $arguments['limit'] * ( $arguments[ $mla_page_parameter ] - 1);
1157
+ }
1158
+
1159
+ $arguments = apply_filters( 'mla_tag_cloud_arguments', $arguments );
1160
+
1161
+ self::$mla_debug = !empty( $arguments['mla_debug'] ) && ( 'true' == strtolower( $arguments['mla_debug'] ) );
1162
+ if ( self::$mla_debug ) {
1163
+ self::$mla_debug_messages .= '<p><strong>mla_debug attributes</strong> = ' . var_export( $attr, true ) . '</p>';
1164
+ self::$mla_debug_messages .= '<p><strong>mla_debug arguments</strong> = ' . var_export( $arguments, true ) . '</p>';
1165
+ }
1166
+
1167
+ /*
1168
+ * Determine output type and templates
1169
+ */
1170
+ $output_parameters = array_map( 'strtolower', array_map( 'trim', explode( ',', $arguments['mla_output'] ) ) );
1171
+
1172
+ if ( $is_grid = 'grid' == $output_parameters[0] ) {
1173
+ $default_style = MLAOptions::mla_get_option('default_tag_cloud_style');
1174
+ $default_markup = MLAOptions::mla_get_option('default_tag_cloud_markup');
1175
+
1176
+ if ( NULL == $arguments['mla_style'] )
1177
+ $arguments['mla_style'] = $default_style;
1178
+
1179
+ if ( NULL == $arguments['mla_markup'] ) {
1180
+ $arguments['mla_markup'] = $default_markup;
1181
+ $arguments['itemtag'] = 'dl';
1182
+ $arguments['termtag'] = 'dt';
1183
+ $arguments['captiontag'] = 'dd';
1184
+ }
1185
+ }
1186
+
1187
+ if ( $is_list = 'list' == $output_parameters[0] ) {
1188
+ $default_style = 'none';
1189
+ if ( empty( $arguments['captiontag'] ) ) {
1190
+ $default_markup = 'tag-cloud-ul';
1191
+ } else {
1192
+ $default_markup = 'tag-cloud-dl';
1193
+
1194
+ if ( 'dd' == $arguments['captiontag'] ) {
1195
+ $arguments['itemtag'] = 'dl';
1196
+ $arguments['termtag'] = 'dt';
1197
+ }
1198
+ }
1199
+
1200
+ if ( NULL == $arguments['mla_style'] )
1201
+ $arguments['mla_style'] = $default_style;
1202
+
1203
+ if ( NULL == $arguments['mla_markup'] )
1204
+ $arguments['mla_markup'] = $default_markup;
1205
+ }
1206
+
1207
+ $is_pagination = in_array( $output_parameters[0], array( 'previous_link', 'current_link', 'next_link', 'previous_page', 'next_page', 'paginate_links' ) );
1208
+
1209
+ /*
1210
+ * Convert taxonomy list to an array
1211
+ */
1212
+ if ( is_string( $arguments['taxonomy'] ) )
1213
+ $arguments['taxonomy'] = explode( ',', $arguments['taxonomy'] );
1214
+
1215
+ $tags = self::mla_get_terms( $arguments );
1216
+
1217
+ if ( self::$mla_debug ) {
1218
+ $cloud = self::$mla_debug_messages;
1219
+ self::$mla_debug_messages = '';
1220
+ }
1221
+ else
1222
+ $cloud = '';
1223
+
1224
+ /*
1225
+ * Invalid taxonomy names return WP_Error
1226
+ */
1227
+ if ( is_wp_error( $tags ) ) {
1228
+ $cloud .= '<strong>ERROR: ' . $tags->get_error_message() . '</strong>, ' . $tags->get_error_data( $tags->get_error_code() );
1229
+
1230
+ if ( 'array' == $arguments['mla_output'] )
1231
+ return array( $cloud );
1232
+
1233
+ if ( empty($arguments['echo']) )
1234
+ return $cloud;
1235
+
1236
+ echo $cloud;
1237
+ return;
1238
+ }
1239
+
1240
+ if ( empty( $tags ) ) {
1241
+ if ( self::$mla_debug ) {
1242
+ $cloud .= '<p><strong>mla_debug empty cloud</strong>, query = ' . var_export( $arguments, true ) . '</p>';
1243
+ }
1244
+
1245
+ $cloud .= $arguments['mla_nolink_text'];
1246
+ if ( 'array' == $arguments['mla_output'] )
1247
+ return array( $cloud );
1248
+
1249
+ if ( empty($arguments['echo']) )
1250
+ return $cloud;
1251
+
1252
+ echo $cloud;
1253
+ return;
1254
+ }
1255
+
1256
+ /*
1257
+ * Fill in the item_specific link properties, calculate cloud parameters
1258
+ */
1259
+ if( isset( $tags['found_rows'] ) ) {
1260
+ $found_rows = $tags['found_rows'];
1261
+ unset( $tags['found_rows'] );
1262
+ } else
1263
+ $found_rows = count( $tags );
1264
+
1265
+ $min_count = 0x7FFFFFFF;
1266
+ $max_count = 0;
1267
+ $min_scaled_count = 0x7FFFFFFF;
1268
+ $max_scaled_count = 0;
1269
+ foreach ( $tags as $key => $tag ) {
1270
+ $tag->scaled_count = apply_filters( 'mla_tag_cloud_scale', round(log10($tag->count + 1) * 100), $attr, $arguments, $tag );
1271
+
1272
+ if ( $tag->count < $min_count )
1273
+ $min_count = $tag->count;
1274
+ if ( $tag->count > $max_count )
1275
+ $max_count = $tag->count;
1276
+
1277
+ if ( $tag->scaled_count < $min_scaled_count )
1278
+ $min_scaled_count = $tag->scaled_count;
1279
+ if ( $tag->scaled_count > $max_scaled_count )
1280
+ $max_scaled_count = $tag->scaled_count;
1281
+
1282
+ $link = get_edit_tag_link( $tag->term_id, $tag->taxonomy );
1283
+ if ( ! is_wp_error( $link ) ) {
1284
+ $tags[ $key ]->edit_link = $link;
1285
+ $link = get_term_link( intval($tag->term_id), $tag->taxonomy );
1286
+ $tags[ $key ]->term_link = $link;
1287
+ }
1288
+
1289
+ if ( is_wp_error( $link ) ) {
1290
+ $cloud = '<strong>ERROR: ' . $link->get_error_message() . '</strong>, ' . $link->get_error_data( $link->get_error_code() );
1291
+
1292
+ if ( 'array' == $arguments['mla_output'] )
1293
+ return array( $cloud );
1294
+
1295
+ if ( empty($arguments['echo']) )
1296
+ return $cloud;
1297
+
1298
+ echo $cloud;
1299
+ return;
1300
+ }
1301
+
1302
+ if ( 'edit' == $arguments['link'] )
1303
+ $tags[ $key ]->link = $tags[ $key ]->edit_link;
1304
+ else
1305
+ $tags[ $key ]->link = $tags[ $key ]->term_link;
1306
+ } // foreach tag
1307
+
1308
+ // $instance supports multiple clouds in one page/post
1309
+ static $instance = 0;
1310
+ $instance++;
1311
+
1312
+ /*
1313
+ * The default MLA style template includes "margin: 1.5%" to put a bit of
1314
+ * minimum space between the columns. "mla_margin" can be used to change
1315
+ * this. "mla_itemwidth" can be used with "columns=0" to achieve a
1316
+ * "responsive" layout.
1317
+ */
1318
+
1319
+ $columns = absint( $arguments['columns'] );
1320
+ $margin_string = strtolower( trim( $arguments['mla_margin'] ) );
1321
+
1322
+ if ( is_numeric( $margin_string ) && ( 0 != $margin_string) )
1323
+ $margin_string .= '%'; // Legacy values are always in percent
1324
+
1325
+ if ( '%' == substr( $margin_string, -1 ) )
1326
+ $margin_percent = (float) substr( $margin_string, 0, strlen( $margin_string ) - 1 );
1327
+ else
1328
+ $margin_percent = 0;
1329
+
1330
+ $width_string = strtolower( trim( $arguments['mla_itemwidth'] ) );
1331
+ if ( 'none' != $width_string ) {
1332
+ switch ( $width_string ) {
1333
+ case 'exact':
1334
+ $margin_percent = 0;
1335
+ /* fallthru */
1336
+ case 'calculate':
1337
+ $width_string = $columns > 0 ? (floor(1000/$columns)/10) - ( 2.0 * $margin_percent ) : 100 - ( 2.0 * $margin_percent );
1338
+ /* fallthru */
1339
+ default:
1340
+ if ( is_numeric( $width_string ) && ( 0 != $width_string) )
1341
+ $width_string .= '%'; // Legacy values are always in percent
1342
+ }
1343
+ } // $use_width
1344
+
1345
+ $float = strtolower( $arguments['mla_float'] );
1346
+ if ( ! in_array( $float, array( 'left', 'none', 'right' ) ) )
1347
+ $float = is_rtl() ? 'right' : 'left';
1348
+
1349
+ /*
1350
+ * Calculate cloud parameters
1351
+ */
1352
+ $spread = $max_scaled_count - $min_scaled_count;
1353
+ if ( $spread <= 0 )
1354
+ $spread = 1;
1355
+ $font_spread = $arguments['largest'] - $arguments['smallest'];
1356
+ if ( $font_spread < 0 )
1357
+ $font_spread = 1;
1358
+ $font_step = $font_spread / $spread;
1359
+
1360
+ $style_values = array(
1361
+ 'mla_output' => $arguments['mla_output'],
1362
+ 'mla_style' => $arguments['mla_style'],
1363
+ 'mla_markup' => $arguments['mla_markup'],
1364
+ 'instance' => $instance,
1365
+ 'taxonomy' => implode( '-', $arguments['taxonomy'] ),
1366
+ 'itemtag' => tag_escape( $arguments['itemtag'] ),
1367
+ 'termtag' => tag_escape( $arguments['termtag'] ),
1368
+ 'captiontag' => tag_escape( $arguments['captiontag'] ),
1369
+ 'columns' => $columns,
1370
+ 'itemwidth' => $width_string,
1371
+ 'margin' => $margin_string,
1372
+ 'float' => $float,
1373
+ 'selector' => "mla_tag_cloud-{$instance}",
1374
+ 'found_rows' => $found_rows,
1375
+ 'min_count' => $min_count,
1376
+ 'max_count' => $max_count,
1377
+ 'min_scaled_count' => $min_scaled_count,
1378
+ 'max_scaled_count' => $max_scaled_count,
1379
+ 'spread' => $spread,
1380
+ 'smallest' => $arguments['smallest'],
1381
+ 'largest' => $arguments['largest'],
1382
+ 'unit' => $arguments['unit'],
1383
+ 'font_spread' => $font_spread,
1384
+ 'font_step' => $font_step,
1385
+ 'separator' => $arguments['separator'],
1386
+ 'single_text' => $arguments['single_text'],
1387
+ 'multiple_text' => $arguments['multiple_text'],
1388
+ 'echo' => $arguments['echo'],
1389
+ 'link' => $arguments['link']
1390
+ );
1391
+
1392
+ $style_template = $gallery_style = '';
1393
+ $use_mla_tag_cloud_style = ( $is_grid || $is_list ) && ( 'none' != strtolower( $style_values['mla_style'] ) );
1394
+ if ( apply_filters( 'use_mla_tag_cloud_style', $use_mla_tag_cloud_style, $style_values['mla_style'] ) ) {
1395
+ $style_template = MLAOptions::mla_fetch_gallery_template( $style_values['mla_style'], 'style' );
1396
+ if ( empty( $style_template ) ) {
1397
+ $style_values['mla_style'] = $default_style;
1398
+ $style_template = MLAOptions::mla_fetch_gallery_template( $default_style, 'style' );
1399
+ }
1400
+
1401
+ if ( ! empty ( $style_template ) ) {
1402
+ /*
1403
+ * Look for 'query' and 'request' substitution parameters
1404
+ */
1405
+ $style_values = MLAData::mla_expand_field_level_parameters( $style_template, $attr, $style_values );
1406
+
1407
+ /*
1408
+ * Clean up the template to resolve width or margin == 'none'
1409
+ */
1410
+ if ( 'none' == $margin_string ) {
1411
+ $style_values['margin'] = '0';
1412
+ $style_template = preg_replace( '/margin:[\s]*\[\+margin\+\][\%]*[\;]*/', '', $style_template );
1413
+ }
1414
+
1415
+ if ( 'none' == $width_string ) {
1416
+ $style_values['itemwidth'] = 'auto';
1417
+ $style_template = preg_replace( '/width:[\s]*\[\+itemwidth\+\][\%]*[\;]*/', '', $style_template );
1418
+ }
1419
+
1420
+ $style_values = apply_filters( 'mla_tag_cloud_style_values', $style_values );
1421
+ $style_template = apply_filters( 'mla_tag_cloud_style_template', $style_template );
1422
+ $gallery_style = MLAData::mla_parse_template( $style_template, $style_values );
1423
+ $gallery_style = apply_filters( 'mla_tag_cloud_style_parse', $gallery_style, $style_template, $style_values );
1424
+ } // !empty template
1425
+ } // use_mla_tag_cloud_style
1426
+
1427
+ $upload_dir = wp_upload_dir();
1428
+ $markup_values = $style_values;
1429
+ $markup_values['site_url'] = site_url();
1430
+ $markup_values['page_ID'] = get_the_ID();
1431
+ $markup_values['page_url'] = ( 0 < $markup_values['page_ID'] ) ? get_page_link() : '';
1432
+
1433
+ if ( $is_grid || $is_list ) {
1434
+ $open_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-open', 'markup' );
1435
+ if ( false === $open_template ) {
1436
+ $markup_values['mla_markup'] = $default_markup;
1437
+ $open_template = MLAOptions::mla_fetch_gallery_template( $default_markup, 'markup' );
1438
+ }
1439
+ if ( empty( $open_template ) )
1440
+ $open_template = '';
1441
+
1442
+ if ( $is_grid ) {
1443
+ $row_open_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-row-open', 'markup' );
1444
+ if ( empty( $row_open_template ) )
1445
+ $row_open_template = '';
1446
+ }
1447
+ else
1448
+ $row_open_template = '';
1449
+
1450
+ $item_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-item', 'markup' );
1451
+ if ( empty( $item_template ) )
1452
+ $item_template = '';
1453
+
1454
+ if ( $is_grid ) {
1455
+ $row_close_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-row-close', 'markup' );
1456
+ if ( empty( $row_close_template ) )
1457
+ $row_close_template = '';
1458
+ }
1459
+ else
1460
+ $row_close_template = '';
1461
+
1462
+ $close_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-close', 'markup' );
1463
+ if ( empty( $close_template ) )
1464
+ $close_template = '';
1465
+
1466
+ /*
1467
+ * Look for gallery-level markup substitution parameters
1468
+ */
1469
+ $new_text = $open_template . $row_open_template . $row_close_template . $close_template;
1470
+ $markup_values = MLAData::mla_expand_field_level_parameters( $new_text, $attr, $markup_values );
1471
+
1472
+ $markup_values = apply_filters( 'mla_tag_cloud_open_values', $markup_values );
1473
+ $open_template = apply_filters( 'mla_tag_cloud_open_template', $open_template );
1474
+ if ( empty( $open_template ) )
1475
+ $gallery_open = '';
1476
+ else
1477
+ $gallery_open = MLAData::mla_parse_template( $open_template, $markup_values );
1478
+
1479
+ $gallery_open = apply_filters( 'mla_tag_cloud_open_parse', $gallery_open, $open_template, $markup_values );
1480
+ $cloud .= $gallery_style . $gallery_open;
1481
+ } // is_grid || is_list
1482
+ elseif ( $is_pagination ) {
1483
+ /*
1484
+ * Handle 'previous_page', 'next_page', and 'paginate_links'
1485
+ */
1486
+ if ( isset( $attr['limit'] ) )
1487
+ $attr['posts_per_page'] = $attr['limit'];
1488
+
1489
+ $pagination_result = self::_process_pagination_output_types( $output_parameters, $markup_values, $arguments, $attr, $found_rows, $output );
1490
+ if ( false !== $pagination_result )
1491
+ return $pagination_result;
1492
+
1493
+ /*
1494
+ * For "previous_link", "current_link" and "next_link", discard all of the $tags except the appropriate choice
1495
+ */
1496
+ $link_type = $output_parameters[0];
1497
+
1498
+ if ( ! in_array( $link_type, array ( 'previous_link', 'current_link', 'next_link' ) ) )
1499
+ return ''; // unknown outtput type
1500
+
1501
+ $is_wrap = isset( $output_parameters[1] ) && 'wrap' == $output_parameters[1];
1502
+ if ( empty( $arguments['term_id'] ) ) {
1503
+ $target_id = -2; // won't match anything
1504
+ }
1505
+ else {
1506
+ $current_id = $arguments['term_id'];
1507
+
1508
+ foreach ( $tags as $id => $tag ) {
1509
+ if ( $tag->term_id == $current_id )
1510
+ break;
1511
+ }
1512
+
1513
+ switch ( $link_type ) {
1514
+ case 'previous_link':
1515
+ $target_id = $id - 1;
1516
+ break;
1517
+ case 'next_link':
1518
+ $target_id = $id + 1;
1519
+ break;
1520
+ case 'current_link':
1521
+ default:
1522
+ $target_id = $id;
1523
+ } // link_type
1524
+ }
1525
+
1526
+ $target = NULL;
1527
+ if ( isset( $tags[ $target_id ] ) ) {
1528
+ $target = $tags[ $target_id ];
1529
+ }
1530
+ elseif ( $is_wrap ) {
1531
+ switch ( $link_type ) {
1532
+ case 'previous_link':
1533
+ $target = array_pop( $tags );
1534
+ break;
1535
+ case 'next_link':
1536
+ $target = array_shift( $tags );
1537
+ } // link_type
1538
+ } // is_wrap
1539
+
1540
+ if ( isset( $target ) )
1541
+ $tags = array( $target );
1542
+ elseif ( ! empty( $arguments['mla_nolink_text'] ) )
1543
+ return self::_process_shortcode_parameter( $arguments['mla_nolink_text'], $markup_values ) . '</a>';
1544
+ else
1545
+ return '';
1546
+ } // is_pagination
1547
+
1548
+ /*
1549
+ * Accumulate links for flat and array output
1550
+ */
1551
+ $tag_links = array();
1552
+
1553
+ $column_index = 0;
1554
+ foreach ( $tags as $key => $tag ) {
1555
+ $item_values = $markup_values;
1556
+
1557
+ /*
1558
+ * fill in item-specific elements
1559
+ */
1560
+ $item_values['index'] = (string) 1 + $column_index;
1561
+ if ( $item_values['columns'] > 0 && ( 1 + $column_index ) % $item_values['columns'] == 0 )
1562
+ $item_values['last_in_row'] = 'last_in_row';
1563
+ else
1564
+ $item_values['last_in_row'] = '';
1565
+
1566
+ $item_values['key'] = $key;
1567
+ $item_values['term_id'] = $tag->term_id;
1568
+ $item_values['name'] = wptexturize( $tag->name );
1569
+ $item_values['slug'] = wptexturize( $tag->slug );
1570
+ $item_values['term_group'] = $tag->term_group;
1571
+ $item_values['term_taxonomy_id'] = $tag->term_taxonomy_id;
1572
+ $item_values['taxonomy'] = wptexturize( $tag->taxonomy );
1573
+ $item_values['description'] = wptexturize( $tag->description );
1574
+ $item_values['parent'] = $tag->parent;
1575
+ $item_values['count'] = $tag->count;
1576
+ $item_values['scaled_count'] = $tag->scaled_count;
1577
+ $item_values['font_size'] = str_replace( ',', '.', ( $item_values['smallest'] + ( ( $item_values['scaled_count'] - $item_values['min_scaled_count'] ) * $item_values['font_step'] ) ) );
1578
+ $item_values['link_url'] = $tag->link;
1579
+ $item_values['editlink_url'] = $tag->edit_link;
1580
+ $item_values['termlink_url'] = $tag->term_link;
1581
+ // Added in the code below:
1582
+ // 'caption', 'link_attributes', 'rollover_text', 'link_style', 'link_text', 'editlink', 'termlink', 'thelink'
1583
+
1584
+ /*
1585
+ * Add item_specific field-level substitution parameters
1586
+ */
1587
+ $new_text = isset( $item_template ) ? $item_template : '';
1588
+ foreach( $mla_item_specific_arguments as $index => $value ) {
1589
+ $new_text .= str_replace( '{+', '[+', str_replace( '+}', '+]', $arguments[ $index ] ) );
1590
+ }
1591
+
1592
+ $item_values = MLAData::mla_expand_field_level_parameters( $new_text, $attr, $item_values );
1593
+
1594
+ if ( $item_values['captiontag'] ) {
1595
+ $item_values['caption'] = wptexturize( $tag->description );
1596
+ if ( ! empty( $arguments['mla_caption'] ) )
1597
+ $item_values['caption'] = wptexturize( self::_process_shortcode_parameter( $arguments['mla_caption'], $item_values ) );
1598
+ }
1599
+ else
1600
+ $item_values['caption'] = '';
1601
+
1602
+ if ( ! empty( $arguments['mla_link_text'] ) )
1603
+ $link_text = self::_process_shortcode_parameter( $arguments['mla_link_text'], $item_values );
1604
+ else
1605
+ $link_text = false;
1606
+
1607
+ /*
1608
+ * Apply the Display Content parameters.
1609
+ */
1610
+ if ( ! empty( $arguments['mla_target'] ) )
1611
+ $link_attributes = 'target="' . $arguments['mla_target'] . '" ';
1612
+ else
1613
+ $link_attributes = '';
1614
+
1615
+ if ( ! empty( $arguments['mla_link_attributes'] ) )
1616
+ $link_attributes .= self::_process_shortcode_parameter( $arguments['mla_link_attributes'], $item_values ) . ' ';
1617
+
1618
+ if ( ! empty( $arguments['mla_link_class'] ) )
1619
+ $link_attributes .= 'class="' . self::_process_shortcode_parameter( $arguments['mla_link_class'], $item_values ) . '" ';
1620
+
1621
+ $item_values['link_attributes'] = $link_attributes;
1622
+
1623
+ $item_values['rollover_text'] = sprintf( _n( $item_values['single_text'], $item_values['multiple_text'], $item_values['count'] ), number_format_i18n( $item_values['count'] ) );
1624
+ if ( ! empty( $arguments['mla_rollover_text'] ) ) {
1625
+ $item_values['rollover_text'] = esc_attr( self::_process_shortcode_parameter( $arguments['mla_rollover_text'], $item_values ) );
1626
  }
 
 
1627
 
 
 
 
 
1628
  if ( ! empty( $arguments['mla_link_href'] ) ) {
1629
  $link_href = self::_process_shortcode_parameter( $arguments['mla_link_href'], $item_values );
1630
+ $item_values['link_url'] = $link_href;
 
 
 
 
 
1631
  }
1632
  else
1633
  $link_href = '';
1634
+
1635
+ if ( ! empty( $arguments['mla_link_style'] ) ) {
1636
+ $item_values['link_style'] = esc_attr( self::_process_shortcode_parameter( $arguments['mla_link_style'], $item_values ) );
 
1637
  }
1638
  else
1639
+ $item_values['link_style'] = 'font-size: ' . $item_values['font_size'] . $item_values['unit'];
1640
 
1641
+ if ( ! empty( $arguments['mla_link_text'] ) ) {
1642
+ $item_values['link_text'] = esc_attr( self::_process_shortcode_parameter( $arguments['mla_link_text'], $item_values ) );
 
 
 
 
 
 
 
 
1643
  }
1644
+ else
1645
+ $item_values['link_text'] = $item_values['name'];
1646
 
1647
  /*
1648
+ * Editlink, termlink and thelink
 
 
1649
  */
1650
+ $item_values['editlink'] = sprintf( '<a %1$shref="%2$s" title="%3$s" style="%4$s">%5$s</a>', $link_attributes, $item_values['editlink_url'], $item_values['rollover_text'], $item_values['link_style'], $item_values['link_text'] );
1651
+ $item_values['termlink'] = sprintf( '<a %1$shref="%2$s" title="%3$s" style="%4$s">%5$s</a>', $link_attributes, $item_values['termlink_url'], $item_values['rollover_text'], $item_values['link_style'], $item_values['link_text'] );
1652
+
1653
+ if ( ! empty( $link_href ) )
1654
+ $item_values['thelink'] = sprintf( '<a %1$shref="%2$s" title="%3$s" style="%4$s">%5$s</a>', $link_attributes, $link_href, $item_values['rollover_text'], $item_values['link_style'], $item_values['link_text'] );
1655
+ elseif ( 'edit' == $arguments['link'] )
1656
+ $item_values['thelink'] = $item_values['editlink'];
1657
+ elseif ( 'view' == $arguments['link'] )
1658
+ $item_values['thelink'] = $item_values['termlink'];
1659
+ elseif ( 'span' == $arguments['link'] )
1660
+ $item_values['thelink'] = sprintf( '<span %1$sstyle="%2$s">%3$s</a>', $link_attributes, $item_values['link_style'], $item_values['link_text'] );
1661
+ else
1662
+ $item_values['thelink'] = $item_values['link_text'];
 
 
 
 
 
 
 
 
 
 
1663
 
1664
+ if ( $is_grid || $is_list ) {
 
 
 
 
 
 
 
 
 
 
1665
  /*
1666
  * Start of row markup
1667
  */
1668
+ if ( $is_grid && ( $markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 ) ) {
1669
+ $markup_values = apply_filters( 'mla_tag_cloud_row_open_values', $markup_values );
1670
+ $row_open_template = apply_filters( 'mla_tag_cloud_row_open_template', $row_open_template );
1671
  $parse_value = MLAData::mla_parse_template( $row_open_template, $markup_values );
1672
+ $cloud .= apply_filters( 'mla_tag_cloud_row_open_parse', $parse_value, $row_open_template, $markup_values );
1673
  }
1674
 
1675
  /*
1676
  * item markup
1677
  */
1678
  $column_index++;
1679
+ $item_values = apply_filters( 'mla_tag_cloud_item_values', $item_values );
1680
+ $item_template = apply_filters( 'mla_tag_cloud_item_template', $item_template );
 
 
 
 
 
1681
  $parse_value = MLAData::mla_parse_template( $item_template, $item_values );
1682
+ $cloud .= apply_filters( 'mla_tag_cloud_item_parse', $parse_value, $item_template, $item_values );
1683
 
1684
  /*
1685
  * End of row markup
1686
  */
1687
+ if ( $is_grid && ( $markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 ) ) {
1688
+ $markup_values = apply_filters( 'mla_tag_cloud_row_close_values', $markup_values );
1689
+ $row_close_template = apply_filters( 'mla_tag_cloud_row_close_template', $row_close_template );
1690
  $parse_value = MLAData::mla_parse_template( $row_close_template, $markup_values );
1691
+ $cloud .= apply_filters( 'mla_tag_cloud_row_close_parse', $parse_value, $row_close_template, $markup_values );
1692
  }
1693
+ } // is_grid || is_list
1694
+ elseif ( $is_pagination )
1695
+ return $item_values['thelink'];
1696
+ else {
1697
+ $column_index++;
1698
+ $item_values = apply_filters( 'mla_tag_cloud_item_values', $item_values );
1699
+ $tag_links[] = apply_filters( 'mla_tag_cloud_item_parse', $item_values['thelink'], NULL, $item_values );
1700
+ }
1701
+ } // foreach tag
1702
+
1703
+ if ($is_grid || $is_list ) {
1704
  /*
1705
  * Close out partial row
1706
  */
1707
+ if ( $is_grid && ( ! ($markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 ) ) ) {
1708
+ $markup_values = apply_filters( 'mla_tag_cloud_row_close_values', $markup_values );
1709
+ $row_close_template = apply_filters( 'mla_tag_cloud_row_close_template', $row_close_template );
1710
  $parse_value = MLAData::mla_parse_template( $row_close_template, $markup_values );
1711
+ $cloud .= apply_filters( 'mla_tag_cloud_row_close_parse', $parse_value, $row_close_template, $markup_values );
1712
  }
1713
 
1714
+ $markup_values = apply_filters( 'mla_tag_cloud_close_values', $markup_values );
1715
+ $close_template = apply_filters( 'mla_tag_cloud_close_template', $close_template );
1716
  $parse_value = MLAData::mla_parse_template( $close_template, $markup_values );
1717
+ $cloud .= apply_filters( 'mla_tag_cloud_close_parse', $parse_value, $close_template, $markup_values );
1718
+ } // is_grid || is_list
1719
+ else {
1720
+ switch ( $markup_values['mla_output'] ) {
1721
+ case 'array' :
1722
+ $cloud =& $tag_links;
1723
+ break;
1724
+ case 'flat' :
1725
+ default :
1726
+ $cloud .= join( $markup_values['separator'], $tag_links );
1727
+ break;
1728
+ } // switch format
1729
+ }
1730
 
1731
+ //$cloud = wp_generate_tag_cloud( $tags, $arguments );
1732
+
1733
+ if ( 'array' == $arguments['mla_output'] || empty($arguments['echo']) )
1734
+ return $cloud;
1735
+
1736
+ echo $cloud;
1737
  }
1738
+
1739
+ /**
1740
+ * The MLA Tag Cloud shortcode.
1741
+ *
1742
+ * This is an interface to the mla_tag_cloud function.
1743
+ *
1744
+ * @since 1.60
1745
+ *
1746
+ * @param array $attr Attributes of the shortcode.
1747
+ *
1748
+ * @return string HTML content to display the tag cloud.
1749
+ */
1750
+ public static function mla_tag_cloud_shortcode( $attr ) {
1751
+ /*
1752
+ * Make sure $attr is an array, even if it's empty
1753
+ */
1754
+ if ( empty( $attr ) )
1755
+ $attr = array();
1756
+ elseif ( is_string( $attr ) )
1757
+ $attr = shortcode_parse_atts( $attr );
1758
 
1759
+ /*
1760
+ * The 'array' format makes no sense in a shortcode
1761
+ */
1762
+ if ( isset( $attr['mla_output'] ) && 'array' == $attr['mla_output'] )
1763
+ $attr['mla_output'] = 'flat';
1764
+
1765
+ /*
1766
+ * A shortcode must return its content to the caller, so "echo" makes no sense
1767
+ */
1768
+ $attr['echo'] = false;
1769
+
1770
+ return self::mla_tag_cloud( $attr );
1771
+ }
1772
+
1773
  /**
1774
  * Handles brace/bracket escaping and parses template for a shortcode parameter
1775
  *
1907
  $results .= join("</li>\n\t<li>", $page_links);
1908
  $results .= "</li>\n</ul>\n";
1909
  break;
1910
+ case 'plain':
1911
  default:
1912
  $results = join("\n", $page_links);
1913
  } // mla_paginate_type
1936
  /*
1937
  * Add data selection parameters to gallery-specific and mla_gallery-specific parameters
1938
  */
1939
+ $arguments = array_merge( $arguments, shortcode_atts( self::$mla_get_shortcode_attachments_parameters, $attr ) );
1940
  $posts_per_page = absint( $arguments['posts_per_page'] );
1941
  $mla_page_parameter = $arguments['mla_page_parameter'];
1942
 
2225
  *
2226
  * @var array
2227
  */
2228
+ private static $mla_get_shortcode_attachments_parameters = array(
2229
  'order' => 'ASC', // or 'DESC' or 'RAND'
2230
  'orderby' => 'menu_order,ID',
2231
  'id' => NULL,
2321
  elseif ( is_string( $attr ) )
2322
  $attr = shortcode_parse_atts( $attr );
2323
 
2324
+ /*
2325
+ * The "where used" queries have no $_REQUEST context available to them,
2326
+ * so tax_ and meta_query evaluation will fail if they contain "{+request:"
2327
+ * parameters. Ignore these errors.
2328
+ */
2329
+ if ( isset( $attr['where_used_query'] ) && ( 'this-is-a-where-used-query' == $attr['where_used_query'] ) ) {
2330
+ $where_used_query = true;
2331
+ unset( $attr['where_used_query'] );
2332
+ }
2333
+ else
2334
+ $where_used_query = false;
2335
+
2336
  /*
2337
  * Merge input arguments with defaults, then extract the query arguments.
2338
  *
2342
  if ( ! is_null( $return_found_rows ) )
2343
  $attr = apply_filters( 'mla_gallery_query_attributes', $attr );
2344
 
2345
+ $arguments = shortcode_atts( self::$mla_get_shortcode_attachments_parameters, $attr );
2346
  $mla_page_parameter = $arguments['mla_page_parameter'];
2347
  unset( $arguments['mla_page_parameter'] );
2348
 
2389
  else {
2390
  $tax_query = NULL;
2391
  $value = self::_sanitize_query_specification( $value );
2392
+
2393
+ /*
2394
+ * Replace invalid queries from "where-used" callers with a harmless equivalent
2395
+ */
2396
+ if ( $where_used_query && ( false !== strpos( $value, '{+' ) ) )
2397
+ $value = "array( array( 'taxonomy' => 'none', 'field' => 'slug', 'terms' => 'none' ) )";
2398
+
2399
  $function = @create_function('', 'return ' . $value . ';' );
2400
  if ( is_callable( $function ) )
2401
  $tax_query = $function();
2402
 
2403
  if ( is_array( $tax_query ) )
2404
  $query_arguments[ $key ] = $tax_query;
2405
+ else {
2406
  return '<p>ERROR: invalid mla_gallery tax_query = ' . var_export( $value, true ) . '</p>';
2407
+ }
2408
  } // not array
2409
  } // tax_query
2410
  elseif ( array_key_exists( $key, $taxonomies ) ) {
2608
  else {
2609
  $meta_query = NULL;
2610
  $value = self::_sanitize_query_specification( $value );
2611
+
2612
+ /*
2613
+ * Replace invalid queries from "where-used" callers with a harmless equivalent
2614
+ */
2615
+ if ( $where_used_query && ( false !== strpos( $value, '{+' ) ) )
2616
+ $value = "array( array( 'key' => 'unlikely', 'value' => 'none or otherwise unlikely' ) )";
2617
+
2618
  $function = @create_function('', 'return ' . $value . ';' );
2619
  if ( is_callable( $function ) )
2620
  $meta_query = $function();
2846
 
2847
  return $pieces;
2848
  }
2849
+
2850
+ /**
2851
+ * Data selection parameters for [mla_tag_cloud]
2852
+ *
2853
+ * @since 1.60
2854
+ *
2855
+ * @var array
2856
+ */
2857
+ private static $mla_get_terms_parameters = array(
2858
+ 'taxonomy' => 'post_tag',
2859
+ 'include' => '',
2860
+ 'exclude' => '',
2861
+ 'parent' => '',
2862
+ 'minimum' => 0,
2863
+ 'number' => 45,
2864
+ 'orderby' => 'name',
2865
+ 'order' => 'ASC',
2866
+ 'preserve_case' => false,
2867
+ 'limit' => 0,
2868
+ 'offset' => 0
2869
+ );
2870
+
2871
+
2872
+ /**
2873
+ * Retrieve the terms in one or more taxonomies.
2874
+ *
2875
+ * Alternative to WordPress get_terms() function that provides
2876
+ * an accurate count of attachments associated with each term.
2877
+ *
2878
+ * taxonomy - string containing one or more (comma-delimited) taxonomy names
2879
+ * or an array of taxonomy names.
2880
+ *
2881
+ * include - An array, comma- or space-delimited string of term ids to include
2882
+ * in the return array.
2883
+ *
2884
+ * exclude - An array, comma- or space-delimited string of term ids to exclude
2885
+ * from the return array. If 'include' is non-empty, 'exclude' is ignored.
2886
+ *
2887
+ * parent - term_id of the terms' immediate parent; 0 for top-level terms.
2888
+ *
2889
+ * minimum - minimum number of attachments a term must have to be included.
2890
+ *
2891
+ * number - maximum number of term objects to return. Terms are ordered by count,
2892
+ * descending and then by term_id before this value is applied.
2893
+ *
2894
+ * orderby - 'count', 'id', 'name', 'none', 'random', 'slug'
2895
+ *
2896
+ * order - 'ASC', 'DESC'
2897
+ *
2898
+ * preserve_case - 'true', 'false' to make orderby case-sensitive.
2899
+ *
2900
+ * limit - final number of term objects to return, for pagination.
2901
+ *
2902
+ * offset - number of term objects to skip, for pagination.
2903
+ *
2904
+ * @since 1.60
2905
+ *
2906
+ * @param array taxonomies to search and query parameters
2907
+ *
2908
+ * @return array array of term objects, empty if none found
2909
+ */
2910
+ public static function mla_get_terms( $attr ) {
2911
+ global $wpdb;
2912
+
2913
+ /*
2914
+ * Make sure $attr is an array, even if it's empty
2915
+ */
2916
+ if ( empty( $attr ) )
2917
+ $attr = array();
2918
+ elseif ( is_string( $attr ) )
2919
+ $attr = shortcode_parse_atts( $attr );
2920
+
2921
+ /*
2922
+ * Merge input arguments with defaults
2923
+ */
2924
+ $attr = apply_filters( 'mla_get_terms_query_attributes', $attr );
2925
+ $arguments = shortcode_atts( self::$mla_get_terms_parameters, $attr );
2926
+ $arguments = apply_filters( 'mla_get_terms_query_arguments', $arguments );
2927
+
2928
+ $query = array();
2929
+ $query_parameters = array();
2930
+
2931
+ $query[] = 'SELECT t.term_id, t.name, t.slug, t.term_group, tt.term_taxonomy_id, tt.taxonomy, tt.description, tt.parent, COUNT(p.ID) AS `count`';
2932
+ $query[] = 'FROM `' . $wpdb->terms . '` AS t';
2933
+ $query[] = 'JOIN `' . $wpdb->term_taxonomy . '` AS tt ON t.term_id = tt.term_id';
2934
+ $query[] = 'LEFT JOIN `' . $wpdb->term_relationships . '` AS tr ON tt.term_taxonomy_id = tr.term_taxonomy_id';
2935
+ $query[] = 'LEFT JOIN `' . $wpdb->posts . '` AS p ON tr.object_id = p.ID';
2936
+ $query[] = "AND p.post_type IN ('attachment') AND p.post_status IN ('inherit')";
2937
+
2938
+ /*
2939
+ * Add taxonomy constraint
2940
+ */
2941
+ if ( is_array( $arguments['taxonomy'] ) )
2942
+ $taxonomies = $arguments['taxonomy'];
2943
+ else
2944
+ $taxonomies = array( $arguments['taxonomy'] );
2945
+
2946
+ foreach ( $taxonomies as $taxonomy ) {
2947
+ if ( ! taxonomy_exists( $taxonomy ) ) {
2948
+ $error = new WP_Error( 'invalid_taxonomy', __('Invalid taxonomy'), $taxonomy );
2949
+ return $error;
2950
+ }
2951
+ }
2952
+
2953
+ $placeholders = array();
2954
+ foreach ($taxonomies as $taxonomy) {
2955
+ $placeholders[] = '%s';
2956
+ $query_parameters[] = $taxonomy;
2957
+ }
2958
+
2959
+ $query[] = 'WHERE ( tt.taxonomy IN (' . join( ',', $placeholders ) . ')';
2960
+
2961
+ /*
2962
+ * Add include/exclude and parent constraints to WHERE cluse
2963
+ */
2964
+ if ( ! empty( $arguments['include'] ) ) {
2965
+ $placeholders = implode( "','", wp_parse_id_list( $arguments['include'] ) );
2966
+ $query[] = "AND t.term_id IN ( '{$placeholders}' )";
2967
+ }
2968
+ elseif ( ! empty( $arguments['exclude'] ) ) {
2969
+ $placeholders = implode( "','", wp_parse_id_list( $arguments['exclude'] ) );
2970
+ $query[] = "AND t.term_id NOT IN ( '{$placeholders}' )";
2971
+ }
2972
+
2973
+ if ( '' !== $arguments['parent'] ) {
2974
+ $parent = (int) $arguments['parent'];
2975
+ $query[] = "AND tt.parent = '{$parent}'";
2976
+ }
2977
+
2978
+ $query[] = ' ) GROUP BY tr.term_taxonomy_id';
2979
+
2980
+ if ( 0 < absint( $arguments['minimum'] ) ) {
2981
+ $query[] = 'HAVING count >= %d';
2982
+ $query_parameters[] = absint( $arguments['minimum'] );
2983
+ }
2984
+
2985
+ /*
2986
+ * For now, always select the most popular terms
2987
+ */
2988
+ $query[] = 'ORDER BY count DESC, t.term_id ASC';
2989
+
2990
+ /*
2991
+ * Limit the total number of terms returned
2992
+ */
2993
+ $terms_limit = absint( $arguments['number'] );
2994
+ if ( 0 < $terms_limit ) {
2995
+ $query[] = 'LIMIT %d';
2996
+ $query_parameters[] = $terms_limit;
2997
+ }
2998
+
2999
+ /*
3000
+ * $final_parameters, if present, require an SQL subquery
3001
+ */
3002
+ $final_parameters = array();
3003
+
3004
+ /*
3005
+ * Add sort order
3006
+ */
3007
+ $orderby = strtolower( $arguments['orderby'] );
3008
+ $order = strtoupper( $arguments['order'] );
3009
+ if ( 'DESC' != $order )
3010
+ $order = 'ASC';
3011
+
3012
+ /*
3013
+ * Count, Descending, is the default order so no further work
3014
+ * is needed unless a different order is specified
3015
+ */
3016
+ if ( 'count' != $orderby || 'DESC' != $order ) {
3017
+ $binary = ( 'true' == strtolower( $arguments['preserve_case'] ) ) ? 'BINARY ' : '';
3018
+
3019
+ switch ($orderby) {
3020
+ case 'count':
3021
+ $final_parameters[] = 'ORDER BY count ' . $order;
3022
+ break;
3023
+ case 'id':
3024
+ $final_parameters[] = 'ORDER BY term_id ' . $order;
3025
+ break;
3026
+ case 'name':
3027
+ $final_parameters[] = 'ORDER BY ' . $binary . 'name ' . $order;
3028
+ break;
3029
+ case 'none':
3030
+ break;
3031
+ case 'random':
3032
+ $final_parameters[] = 'ORDER BY RAND() ' . $order;
3033
+ break;
3034
+ case 'slug':
3035
+ $final_parameters[] = 'ORDER BY ' . $binary . 'slug ' . $order;
3036
+ break;
3037
+ }
3038
+ }
3039
+
3040
+ /*
3041
+ * Add pagination
3042
+ */
3043
+ $offset = absint( $arguments['offset'] );
3044
+ $limit = absint( $arguments['limit'] );
3045
+ if ( 0 < $offset && 0 < $limit ) {
3046
+ $final_parameters[] = 'LIMIT %d, %d';
3047
+ $query_parameters[] = $offset;
3048
+ $query_parameters[] = $limit;
3049
+ }
3050
+ elseif ( 0 < $limit ) {
3051
+ $final_parameters[] = 'LIMIT %d';
3052
+ $query_parameters[] = $limit;
3053
+ }
3054
+ elseif ( 0 < $offset ) {
3055
+ $final_parameters[] = 'LIMIT %d, %d';
3056
+ $query_parameters[] = $offset;
3057
+ $query_parameters[] = 0x7FFFFFFF; // big number!
3058
+ }
3059
+
3060
+ /*
3061
+ * If we're limiting the final results, we need to get an accurate total count first
3062
+ */
3063
+ if ( 0 < $offset || 0 < $limit ) {
3064
+ $count_query = 'SELECT COUNT(*) as count FROM (' . join(' ', $query) . ' ) as subQuery';
3065
+ $count = $wpdb->get_results( $wpdb->prepare( $count_query, $query_parameters ) );
3066
+ $found_rows = $count[0]->count;
3067
+ }
3068
+
3069
+ if ( ! empty( $final_parameters ) ) {
3070
+ array_unshift($query, 'SELECT * FROM (');
3071
+ $query[] = ') AS subQuery';
3072
+ $query = array_merge( $query, $final_parameters );
3073
+ }
3074
+
3075
+ $query = join(' ', $query);
3076
+
3077
+ $tags = $wpdb->get_results( $wpdb->prepare( $query, $query_parameters ) );
3078
+ if ( ! isset( $found_rows ) )
3079
+ $found_rows = $wpdb->num_rows;
3080
+
3081
+ if ( self::$mla_debug ) {
3082
+ self::$mla_debug_messages .= '<p><strong>mla_debug query arguments</strong> = ' . var_export( $arguments, true ) . '</p>';
3083
+ self::$mla_debug_messages .= '<p><strong>mla_debug last_query</strong> = ' . var_export( $wpdb->last_query, true ) . '</p>';
3084
+ self::$mla_debug_messages .= '<p><strong>mla_debug last_error</strong> = ' . var_export( $wpdb->last_error, true ) . '</p>';
3085
+ self::$mla_debug_messages .= '<p><strong>mla_debug num_rows</strong> = ' . var_export( $wpdb->num_rows, true ) . '</p>';
3086
+ self::$mla_debug_messages .= '<p><strong>mla_debug found_rows</strong> = ' . var_export( $found_rows, true ) . '</p>';
3087
+ }
3088
+
3089
+ $tags['found_rows'] = $found_rows;
3090
+ $tags = apply_filters( 'mla_get_terms_query_results', $tags );
3091
+
3092
+ return $tags;
3093
+ }
3094
  } // Class MLAShortcodes
3095
  ?>
index.php CHANGED
@@ -6,7 +6,7 @@
6
  * will the rest of the plugin be loaded and run.
7
  *
8
  * @package Media Library Assistant
9
- * @version 1.52
10
  */
11
 
12
  /*
@@ -14,7 +14,7 @@ Plugin Name: Media Library Assistant
14
  Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
15
  Description: Enhances the Media Library; powerful[mla_gallery], taxonomy support, IPTC/EXIF processing, bulk & quick edit actions and where-used reporting.
16
  Author: David Lingren
17
- Version: 1.52
18
  Author URI: http://fairtradejudaica.org/our-story/staff/
19
 
20
  Copyright 2011-2013 David Lingren
@@ -84,6 +84,7 @@ $mla_name_conflict_candidates =
84
  'MLAMime' => 'class',
85
  'MLAModal' => 'class',
86
  'MLAObjects' => 'class',
 
87
  'MLASettings' => 'class',
88
  'MLAShortcodes' => 'class',
89
  'MLATest' => 'class',
6
  * will the rest of the plugin be loaded and run.
7
  *
8
  * @package Media Library Assistant
9
+ * @version 1.60
10
  */
11
 
12
  /*
14
  Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
15
  Description: Enhances the Media Library; powerful[mla_gallery], taxonomy support, IPTC/EXIF processing, bulk & quick edit actions and where-used reporting.
16
  Author: David Lingren
17
+ Version: 1.60
18
  Author URI: http://fairtradejudaica.org/our-story/staff/
19
 
20
  Copyright 2011-2013 David Lingren
84
  'MLAMime' => 'class',
85
  'MLAModal' => 'class',
86
  'MLAObjects' => 'class',
87
+ 'MLATextWidget' => 'class',
88
  'MLASettings' => 'class',
89
  'MLAShortcodes' => 'class',
90
  'MLATest' => 'class',
phpDocs/classes.svg CHANGED
@@ -4,140 +4,157 @@
4
  <!-- Generated by graphviz version 2.28.0 (20110507.0327)
5
  -->
6
  <!-- Title: G Pages: 1 -->
7
- <svg width="460pt" height="798pt"
8
- viewBox="0.00 0.00 460.00 798.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
9
- <g id="graph1" class="graph" transform="scale(1 1) rotate(0) translate(4 794)">
10
  <title>G</title>
11
- <polygon fill="white" stroke="white" points="-4,5 -4,-794 457,-794 457,5 -4,5"/>
12
  <g id="graph2" class="cluster"><title>cluster_global</title>
13
  <polyline fill="none" stroke="gray" points="220,-8 432,-8 "/>
14
  <path fill="none" stroke="gray" d="M432,-8C438,-8 444,-14 444,-20"/>
15
- <polyline fill="none" stroke="gray" points="444,-20 444,-770 "/>
16
- <path fill="none" stroke="gray" d="M444,-770C444,-776 438,-782 432,-782"/>
17
- <polyline fill="none" stroke="gray" points="432,-782 220,-782 "/>
18
- <path fill="none" stroke="gray" d="M220,-782C214,-782 208,-776 208,-770"/>
19
- <polyline fill="none" stroke="gray" points="208,-770 208,-20 "/>
20
  <path fill="none" stroke="gray" d="M208,-20C208,-14 214,-8 220,-8"/>
21
- <text text-anchor="middle" x="326" y="-769.2" font-family="Times New Roman,serif" font-size="11.00" fill="gray">global</text>
22
  </g>
23
  <!-- \\MLAData -->
24
  <g id="node2" class="node"><title>\\MLAData</title>
25
  <a xlink:href="includes.class-mla-data.html" xlink:title="MLAData" target="_parent">
26
- <polygon fill="none" stroke="black" points="358,-754 294,-754 294,-718 358,-718 358,-754"/>
27
- <text text-anchor="middle" x="326" y="-733.2" font-family="Courier,monospace" font-size="11.00">MLAData</text>
28
  </a>
29
  </g>
30
  <!-- \\MLAEdit -->
31
  <g id="node3" class="node"><title>\\MLAEdit</title>
32
  <a xlink:href="includes.class-mla-edit-media.html" xlink:title="MLAEdit" target="_parent">
33
- <polygon fill="none" stroke="black" points="358,-700 294,-700 294,-664 358,-664 358,-700"/>
34
- <text text-anchor="middle" x="326" y="-679.2" font-family="Courier,monospace" font-size="11.00">MLAEdit</text>
35
  </a>
36
  </g>
37
  <!-- \\MLA_List_Table -->
38
  <g id="node4" class="node"><title>\\MLA_List_Table</title>
39
  <a xlink:href="includes.class-mla-list-table.html" xlink:title="MLA_List_Table" target="_parent">
40
- <polygon fill="none" stroke="black" points="381.5,-646 270.5,-646 270.5,-610 381.5,-610 381.5,-646"/>
41
- <text text-anchor="middle" x="326" y="-625.2" font-family="Courier,monospace" font-size="11.00">MLA_List_Table</text>
42
  </a>
43
  </g>
44
  <!-- \\WP_List_Table -->
45
- <g id="node17" class="node"><title>\\WP_List_Table</title>
46
- <ellipse fill="none" stroke="black" cx="72" cy="-169" rx="71.4873" ry="18"/>
47
- <text text-anchor="middle" x="72" y="-165.3" font-family="Times New Roman,serif" font-size="14.00" fill="gray">\WP_List_Table</text>
48
  </g>
49
  <!-- \\MLA_List_Table&#45;&gt;\\WP_List_Table -->
50
  <g id="edge3" class="edge"><title>\\MLA_List_Table&#45;&gt;\\WP_List_Table</title>
51
- <path fill="none" stroke="black" d="M270.355,-626.837C248.569,-623.698 224.743,-616.515 208,-601 88.2448,-490.027 73.9534,-274.607 72.8183,-197.394"/>
52
- <polygon fill="none" stroke="black" points="76.3154,-197.005 72.7353,-187.034 69.3156,-197.061 76.3154,-197.005"/>
53
  </g>
54
  <!-- \\MLA -->
55
  <g id="node5" class="node"><title>\\MLA</title>
56
  <a xlink:href="includes.class-mla-main.html" xlink:title="MLA" target="_parent">
57
- <polygon fill="none" stroke="black" points="353,-592 299,-592 299,-556 353,-556 353,-592"/>
58
- <text text-anchor="middle" x="326" y="-571.2" font-family="Courier,monospace" font-size="11.00">MLA</text>
59
  </a>
60
  </g>
61
  <!-- \\MLAModal -->
62
  <g id="node6" class="node"><title>\\MLAModal</title>
63
  <a xlink:href="includes.class-mla-media-modal.html" xlink:title="MLAModal" target="_parent">
64
- <polygon fill="none" stroke="black" points="361.5,-538 290.5,-538 290.5,-502 361.5,-502 361.5,-538"/>
65
- <text text-anchor="middle" x="326" y="-517.2" font-family="Courier,monospace" font-size="11.00">MLAModal</text>
66
  </a>
67
  </g>
68
  <!-- \\MLAMime -->
69
  <g id="node7" class="node"><title>\\MLAMime</title>
70
  <a xlink:href="includes.class-mla-mime-types.html" xlink:title="MLAMime" target="_parent">
71
- <polygon fill="none" stroke="black" points="358,-484 294,-484 294,-448 358,-448 358,-484"/>
72
- <text text-anchor="middle" x="326" y="-463.2" font-family="Courier,monospace" font-size="11.00">MLAMime</text>
73
  </a>
74
  </g>
75
  <!-- \\MLAObjects -->
76
  <g id="node8" class="node"><title>\\MLAObjects</title>
77
  <a xlink:href="includes.class-mla-objects.html" xlink:title="MLAObjects" target="_parent">
78
- <polygon fill="none" stroke="black" points="368,-430 284,-430 284,-394 368,-394 368,-430"/>
79
- <text text-anchor="middle" x="326" y="-409.2" font-family="Courier,monospace" font-size="11.00">MLAObjects</text>
 
 
 
 
 
 
 
80
  </a>
81
  </g>
 
 
 
 
 
 
 
 
 
 
82
  <!-- \\MLAOptions -->
83
- <g id="node9" class="node"><title>\\MLAOptions</title>
84
  <a xlink:href="includes.class-mla-options.html" xlink:title="MLAOptions" target="_parent">
85
  <polygon fill="none" stroke="black" points="368,-376 284,-376 284,-340 368,-340 368,-376"/>
86
  <text text-anchor="middle" x="326" y="-355.2" font-family="Courier,monospace" font-size="11.00">MLAOptions</text>
87
  </a>
88
  </g>
89
  <!-- \\MLASettings -->
90
- <g id="node10" class="node"><title>\\MLASettings</title>
91
  <a xlink:href="includes.class-mla-settings.html" xlink:title="MLASettings" target="_parent">
92
  <polygon fill="none" stroke="black" points="371.5,-322 280.5,-322 280.5,-286 371.5,-286 371.5,-322"/>
93
  <text text-anchor="middle" x="326" y="-301.2" font-family="Courier,monospace" font-size="11.00">MLASettings</text>
94
  </a>
95
  </g>
96
  <!-- \\MLAShortcodes -->
97
- <g id="node11" class="node"><title>\\MLAShortcodes</title>
98
  <a xlink:href="includes.class-mla-shortcodes.html" xlink:title="MLAShortcodes" target="_parent">
99
  <polygon fill="none" stroke="black" points="378,-268 274,-268 274,-232 378,-232 378,-268"/>
100
  <text text-anchor="middle" x="326" y="-247.2" font-family="Courier,monospace" font-size="11.00">MLAShortcodes</text>
101
  </a>
102
  </g>
103
  <!-- \\MLA_Upload_List_Table -->
104
- <g id="node12" class="node"><title>\\MLA_Upload_List_Table</title>
105
  <a xlink:href="includes.class-mla-upload-list-table.html" xlink:title="MLA_Upload_List_Table" target="_parent">
106
- <polygon fill="none" stroke="black" points="405,-214 247,-214 247,-178 405,-178 405,-214"/>
107
- <text text-anchor="middle" x="326" y="-193.2" font-family="Courier,monospace" font-size="11.00">MLA_Upload_List_Table</text>
108
  </a>
109
  </g>
110
  <!-- \\MLA_Upload_List_Table&#45;&gt;\\WP_List_Table -->
111
- <g id="edge5" class="edge"><title>\\MLA_Upload_List_Table&#45;&gt;\\WP_List_Table</title>
112
- <path fill="none" stroke="black" d="M246.991,-187.642C215.426,-184.26 179.137,-180.372 147.895,-177.024"/>
113
- <polygon fill="none" stroke="black" points="148.257,-173.543 137.941,-175.958 147.511,-180.503 148.257,-173.543"/>
114
  </g>
115
  <!-- \\MLA_Upload_Optional_List_Table -->
116
- <g id="node13" class="node"><title>\\MLA_Upload_Optional_List_Table</title>
117
  <a xlink:href="includes.class-mla-upload-optional-list-table.html" xlink:title="MLA_Upload_Optional_List_Table" target="_parent">
118
- <polygon fill="none" stroke="black" points="435.5,-160 216.5,-160 216.5,-124 435.5,-124 435.5,-160"/>
119
- <text text-anchor="middle" x="326" y="-139.2" font-family="Courier,monospace" font-size="11.00">MLA_Upload_Optional_List_Table</text>
120
  </a>
121
  </g>
122
  <!-- \\MLA_Upload_Optional_List_Table&#45;&gt;\\WP_List_Table -->
123
- <g id="edge7" class="edge"><title>\\MLA_Upload_Optional_List_Table&#45;&gt;\\WP_List_Table</title>
124
- <path fill="none" stroke="black" d="M216.301,-153.646C193.301,-156.111 169.518,-158.659 148.095,-160.954"/>
125
- <polygon fill="none" stroke="black" points="147.676,-157.479 138.106,-162.024 148.422,-164.439 147.676,-157.479"/>
126
  </g>
127
  <!-- \\MLA_View_List_Table -->
128
- <g id="node14" class="node"><title>\\MLA_View_List_Table</title>
129
  <a xlink:href="includes.class-mla-view-list-table.html" xlink:title="MLA_View_List_Table" target="_parent">
130
- <polygon fill="none" stroke="black" points="398.5,-106 253.5,-106 253.5,-70 398.5,-70 398.5,-106"/>
131
- <text text-anchor="middle" x="326" y="-85.2" font-family="Courier,monospace" font-size="11.00">MLA_View_List_Table</text>
132
  </a>
133
  </g>
134
  <!-- \\MLA_View_List_Table&#45;&gt;\\WP_List_Table -->
135
- <g id="edge9" class="edge"><title>\\MLA_View_List_Table&#45;&gt;\\WP_List_Table</title>
136
- <path fill="none" stroke="black" d="M253.377,-102.69C238.275,-106.299 222.522,-110.45 208,-115 177,-124.714 143.05,-138.308 116.952,-149.426"/>
137
- <polygon fill="none" stroke="black" points="115.516,-146.234 107.712,-153.399 118.281,-152.665 115.516,-146.234"/>
138
  </g>
139
  <!-- \\MLATest -->
140
- <g id="node15" class="node"><title>\\MLATest</title>
141
  <a xlink:href="tests.class-mla-tests.html" xlink:title="MLATest" target="_parent">
142
  <polygon fill="none" stroke="black" points="358,-52 294,-52 294,-16 358,-16 358,-52"/>
143
  <text text-anchor="middle" x="326" y="-31.2" font-family="Courier,monospace" font-size="11.00">MLATest</text>
4
  <!-- Generated by graphviz version 2.28.0 (20110507.0327)
5
  -->
6
  <!-- Title: G Pages: 1 -->
7
+ <svg width="460pt" height="852pt"
8
+ viewBox="0.00 0.00 460.00 852.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
9
+ <g id="graph1" class="graph" transform="scale(1 1) rotate(0) translate(4 848)">
10
  <title>G</title>
11
+ <polygon fill="white" stroke="white" points="-4,5 -4,-848 457,-848 457,5 -4,5"/>
12
  <g id="graph2" class="cluster"><title>cluster_global</title>
13
  <polyline fill="none" stroke="gray" points="220,-8 432,-8 "/>
14
  <path fill="none" stroke="gray" d="M432,-8C438,-8 444,-14 444,-20"/>
15
+ <polyline fill="none" stroke="gray" points="444,-20 444,-824 "/>
16
+ <path fill="none" stroke="gray" d="M444,-824C444,-830 438,-836 432,-836"/>
17
+ <polyline fill="none" stroke="gray" points="432,-836 220,-836 "/>
18
+ <path fill="none" stroke="gray" d="M220,-836C214,-836 208,-830 208,-824"/>
19
+ <polyline fill="none" stroke="gray" points="208,-824 208,-20 "/>
20
  <path fill="none" stroke="gray" d="M208,-20C208,-14 214,-8 220,-8"/>
21
+ <text text-anchor="middle" x="326" y="-823.2" font-family="Times New Roman,serif" font-size="11.00" fill="gray">global</text>
22
  </g>
23
  <!-- \\MLAData -->
24
  <g id="node2" class="node"><title>\\MLAData</title>
25
  <a xlink:href="includes.class-mla-data.html" xlink:title="MLAData" target="_parent">
26
+ <polygon fill="none" stroke="black" points="358,-808 294,-808 294,-772 358,-772 358,-808"/>
27
+ <text text-anchor="middle" x="326" y="-787.2" font-family="Courier,monospace" font-size="11.00">MLAData</text>
28
  </a>
29
  </g>
30
  <!-- \\MLAEdit -->
31
  <g id="node3" class="node"><title>\\MLAEdit</title>
32
  <a xlink:href="includes.class-mla-edit-media.html" xlink:title="MLAEdit" target="_parent">
33
+ <polygon fill="none" stroke="black" points="358,-754 294,-754 294,-718 358,-718 358,-754"/>
34
+ <text text-anchor="middle" x="326" y="-733.2" font-family="Courier,monospace" font-size="11.00">MLAEdit</text>
35
  </a>
36
  </g>
37
  <!-- \\MLA_List_Table -->
38
  <g id="node4" class="node"><title>\\MLA_List_Table</title>
39
  <a xlink:href="includes.class-mla-list-table.html" xlink:title="MLA_List_Table" target="_parent">
40
+ <polygon fill="none" stroke="black" points="381.5,-160 270.5,-160 270.5,-124 381.5,-124 381.5,-160"/>
41
+ <text text-anchor="middle" x="326" y="-139.2" font-family="Courier,monospace" font-size="11.00">MLA_List_Table</text>
42
  </a>
43
  </g>
44
  <!-- \\WP_List_Table -->
45
+ <g id="node18" class="node"><title>\\WP_List_Table</title>
46
+ <ellipse fill="none" stroke="black" cx="72" cy="-304" rx="71.4873" ry="18"/>
47
+ <text text-anchor="middle" x="72" y="-300.3" font-family="Times New Roman,serif" font-size="14.00" fill="gray">\WP_List_Table</text>
48
  </g>
49
  <!-- \\MLA_List_Table&#45;&gt;\\WP_List_Table -->
50
  <g id="edge3" class="edge"><title>\\MLA_List_Table&#45;&gt;\\WP_List_Table</title>
51
+ <path fill="none" stroke="black" d="M270.295,-148.137C249.827,-152.063 226.962,-158.49 208,-169 158.711,-196.318 115.347,-246.894 91.7775,-277.787"/>
52
+ <polygon fill="none" stroke="black" points="88.8618,-275.841 85.666,-285.943 94.4636,-280.039 88.8618,-275.841"/>
53
  </g>
54
  <!-- \\MLA -->
55
  <g id="node5" class="node"><title>\\MLA</title>
56
  <a xlink:href="includes.class-mla-main.html" xlink:title="MLA" target="_parent">
57
+ <polygon fill="none" stroke="black" points="353,-646 299,-646 299,-610 353,-610 353,-646"/>
58
+ <text text-anchor="middle" x="326" y="-625.2" font-family="Courier,monospace" font-size="11.00">MLA</text>
59
  </a>
60
  </g>
61
  <!-- \\MLAModal -->
62
  <g id="node6" class="node"><title>\\MLAModal</title>
63
  <a xlink:href="includes.class-mla-media-modal.html" xlink:title="MLAModal" target="_parent">
64
+ <polygon fill="none" stroke="black" points="361.5,-592 290.5,-592 290.5,-556 361.5,-556 361.5,-592"/>
65
+ <text text-anchor="middle" x="326" y="-571.2" font-family="Courier,monospace" font-size="11.00">MLAModal</text>
66
  </a>
67
  </g>
68
  <!-- \\MLAMime -->
69
  <g id="node7" class="node"><title>\\MLAMime</title>
70
  <a xlink:href="includes.class-mla-mime-types.html" xlink:title="MLAMime" target="_parent">
71
+ <polygon fill="none" stroke="black" points="358,-538 294,-538 294,-502 358,-502 358,-538"/>
72
+ <text text-anchor="middle" x="326" y="-517.2" font-family="Courier,monospace" font-size="11.00">MLAMime</text>
73
  </a>
74
  </g>
75
  <!-- \\MLAObjects -->
76
  <g id="node8" class="node"><title>\\MLAObjects</title>
77
  <a xlink:href="includes.class-mla-objects.html" xlink:title="MLAObjects" target="_parent">
78
+ <polygon fill="none" stroke="black" points="368,-484 284,-484 284,-448 368,-448 368,-484"/>
79
+ <text text-anchor="middle" x="326" y="-463.2" font-family="Courier,monospace" font-size="11.00">MLAObjects</text>
80
+ </a>
81
+ </g>
82
+ <!-- \\MLATextWidget -->
83
+ <g id="node9" class="node"><title>\\MLATextWidget</title>
84
+ <a xlink:href="includes.class-mla-objects.html" xlink:title="MLATextWidget" target="_parent">
85
+ <polygon fill="none" stroke="black" points="378,-106 274,-106 274,-70 378,-70 378,-106"/>
86
+ <text text-anchor="middle" x="326" y="-85.2" font-family="Courier,monospace" font-size="11.00">MLATextWidget</text>
87
  </a>
88
  </g>
89
+ <!-- \\WP_Widget -->
90
+ <g id="node20" class="node"><title>\\WP_Widget</title>
91
+ <ellipse fill="none" stroke="black" cx="72" cy="-88" rx="58.4896" ry="18"/>
92
+ <text text-anchor="middle" x="72" y="-84.3" font-family="Times New Roman,serif" font-size="14.00" fill="gray">\WP_Widget</text>
93
+ </g>
94
+ <!-- \\MLATextWidget&#45;&gt;\\WP_Widget -->
95
+ <g id="edge5" class="edge"><title>\\MLATextWidget&#45;&gt;\\WP_Widget</title>
96
+ <path fill="none" stroke="black" d="M273.7,-88C235.412,-88 182.72,-88 140.933,-88"/>
97
+ <polygon fill="none" stroke="black" points="140.834,-84.5001 130.834,-88 140.834,-91.5001 140.834,-84.5001"/>
98
+ </g>
99
  <!-- \\MLAOptions -->
100
+ <g id="node10" class="node"><title>\\MLAOptions</title>
101
  <a xlink:href="includes.class-mla-options.html" xlink:title="MLAOptions" target="_parent">
102
  <polygon fill="none" stroke="black" points="368,-376 284,-376 284,-340 368,-340 368,-376"/>
103
  <text text-anchor="middle" x="326" y="-355.2" font-family="Courier,monospace" font-size="11.00">MLAOptions</text>
104
  </a>
105
  </g>
106
  <!-- \\MLASettings -->
107
+ <g id="node11" class="node"><title>\\MLASettings</title>
108
  <a xlink:href="includes.class-mla-settings.html" xlink:title="MLASettings" target="_parent">
109
  <polygon fill="none" stroke="black" points="371.5,-322 280.5,-322 280.5,-286 371.5,-286 371.5,-322"/>
110
  <text text-anchor="middle" x="326" y="-301.2" font-family="Courier,monospace" font-size="11.00">MLASettings</text>
111
  </a>
112
  </g>
113
  <!-- \\MLAShortcodes -->
114
+ <g id="node12" class="node"><title>\\MLAShortcodes</title>
115
  <a xlink:href="includes.class-mla-shortcodes.html" xlink:title="MLAShortcodes" target="_parent">
116
  <polygon fill="none" stroke="black" points="378,-268 274,-268 274,-232 378,-232 378,-268"/>
117
  <text text-anchor="middle" x="326" y="-247.2" font-family="Courier,monospace" font-size="11.00">MLAShortcodes</text>
118
  </a>
119
  </g>
120
  <!-- \\MLA_Upload_List_Table -->
121
+ <g id="node13" class="node"><title>\\MLA_Upload_List_Table</title>
122
  <a xlink:href="includes.class-mla-upload-list-table.html" xlink:title="MLA_Upload_List_Table" target="_parent">
123
+ <polygon fill="none" stroke="black" points="405,-700 247,-700 247,-664 405,-664 405,-700"/>
124
+ <text text-anchor="middle" x="326" y="-679.2" font-family="Courier,monospace" font-size="11.00">MLA_Upload_List_Table</text>
125
  </a>
126
  </g>
127
  <!-- \\MLA_Upload_List_Table&#45;&gt;\\WP_List_Table -->
128
+ <g id="edge7" class="edge"><title>\\MLA_Upload_List_Table&#45;&gt;\\WP_List_Table</title>
129
+ <path fill="none" stroke="black" d="M246.906,-675.107C232.756,-670.924 219.017,-664.569 208,-655 108.314,-568.41 81.8784,-399.571 75.1716,-332.479"/>
130
+ <polygon fill="none" stroke="black" points="78.6318,-331.887 74.2256,-322.252 71.6616,-332.532 78.6318,-331.887"/>
131
  </g>
132
  <!-- \\MLA_Upload_Optional_List_Table -->
133
+ <g id="node14" class="node"><title>\\MLA_Upload_Optional_List_Table</title>
134
  <a xlink:href="includes.class-mla-upload-optional-list-table.html" xlink:title="MLA_Upload_Optional_List_Table" target="_parent">
135
+ <polygon fill="none" stroke="black" points="435.5,-430 216.5,-430 216.5,-394 435.5,-394 435.5,-430"/>
136
+ <text text-anchor="middle" x="326" y="-409.2" font-family="Courier,monospace" font-size="11.00">MLA_Upload_Optional_List_Table</text>
137
  </a>
138
  </g>
139
  <!-- \\MLA_Upload_Optional_List_Table&#45;&gt;\\WP_List_Table -->
140
+ <g id="edge9" class="edge"><title>\\MLA_Upload_Optional_List_Table&#45;&gt;\\WP_List_Table</title>
141
+ <path fill="none" stroke="black" d="M234.058,-393.997C225.133,-391.345 216.312,-388.355 208,-385 170.426,-369.835 131.1,-345.072 104.65,-326.912"/>
142
+ <polygon fill="none" stroke="black" points="106.402,-323.868 96.1943,-321.03 102.405,-329.614 106.402,-323.868"/>
143
  </g>
144
  <!-- \\MLA_View_List_Table -->
145
+ <g id="node15" class="node"><title>\\MLA_View_List_Table</title>
146
  <a xlink:href="includes.class-mla-view-list-table.html" xlink:title="MLA_View_List_Table" target="_parent">
147
+ <polygon fill="none" stroke="black" points="398.5,-214 253.5,-214 253.5,-178 398.5,-178 398.5,-214"/>
148
+ <text text-anchor="middle" x="326" y="-193.2" font-family="Courier,monospace" font-size="11.00">MLA_View_List_Table</text>
149
  </a>
150
  </g>
151
  <!-- \\MLA_View_List_Table&#45;&gt;\\WP_List_Table -->
152
+ <g id="edge11" class="edge"><title>\\MLA_View_List_Table&#45;&gt;\\WP_List_Table</title>
153
+ <path fill="none" stroke="black" d="M253.367,-208.782C238.116,-212.535 222.305,-217.226 208,-223 170.426,-238.165 131.1,-262.928 104.65,-281.088"/>
154
+ <polygon fill="none" stroke="black" points="102.405,-278.386 96.1943,-286.97 106.402,-284.132 102.405,-278.386"/>
155
  </g>
156
  <!-- \\MLATest -->
157
+ <g id="node16" class="node"><title>\\MLATest</title>
158
  <a xlink:href="tests.class-mla-tests.html" xlink:title="MLATest" target="_parent">
159
  <polygon fill="none" stroke="black" points="358,-52 294,-52 294,-16 358,-16 358,-52"/>
160
  <text text-anchor="middle" x="326" y="-31.2" font-family="Courier,monospace" font-size="11.00">MLATest</text>
phpDocs/classes/MLA.html CHANGED
@@ -62,6 +62,7 @@
62
  <li class="method public "><a href="#mla_admin_menu_action" title="mla_admin_menu_action :: Add the submenu pages"><span class="description">Add the submenu pages</span><pre>mla_admin_menu_action()</pre></a></li>
63
  <li class="method public "><a href="#mla_edit_tax_redirect" title="mla_edit_tax_redirect :: Redirect to the Edit Tags/Categories page"><span class="description">Redirect to the Edit Tags/Categories page</span><pre>mla_edit_tax_redirect()</pre></a></li>
64
  <li class="method public "><a href="#mla_inline_edit_action" title="mla_inline_edit_action :: Ajax handler for inline editing (quick and bulk edit)"><span class="description">Ajax handler for inline editing (quick and bulk edit)</span><pre>mla_inline_edit_action()</pre></a></li>
 
65
  <li class="method public "><a href="#mla_parent_file_filter" title="mla_parent_file_filter :: Cleanup menus for Edit Tags/Categories page"><span class="description">Cleanup menus for Edit Tags/Categories page</span><pre>mla_parent_file_filter()</pre></a></li>
66
  <li class="method public "><a href="#mla_render_admin_page" title='mla_render_admin_page :: Render the "Assistant" subpage in the Media section, using the list_table package'><span class="description">Render the "Assistant" subpage in the Media section, using the list_table package</span><pre>mla_render_admin_page()</pre></a></li>
67
  <li class="method public "><a href="#mla_screen_options_show_screen_filter" title="mla_screen_options_show_screen_filter :: Only show screen options on the table-list screen"><span class="description">Only show screen options on the table-list screen</span><pre>mla_screen_options_show_screen_filter()</pre></a></li>
@@ -237,6 +238,18 @@ The filter is not required for WordPress 3.5 and later.</p></p>
237
  </tr></table>
238
  </div></div>
239
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
240
  <a name="mla_parent_file_filter" id="mla_parent_file_filter"></a><div class="element clickable method public mla_parent_file_filter" data-toggle="collapse" data-target=".mla_parent_file_filter .collapse">
241
  <h2>Cleanup menus for Edit Tags/Categories page</h2>
242
  <pre>mla_parent_file_filter(array $parent_file) : string</pre>
@@ -675,7 +688,7 @@ change the meta data for a single attachment.</h2>
675
  <div class="row"><footer class="span12">
676
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
677
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
678
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
679
  </div>
680
  </body>
681
  </html>
62
  <li class="method public "><a href="#mla_admin_menu_action" title="mla_admin_menu_action :: Add the submenu pages"><span class="description">Add the submenu pages</span><pre>mla_admin_menu_action()</pre></a></li>
63
  <li class="method public "><a href="#mla_edit_tax_redirect" title="mla_edit_tax_redirect :: Redirect to the Edit Tags/Categories page"><span class="description">Redirect to the Edit Tags/Categories page</span><pre>mla_edit_tax_redirect()</pre></a></li>
64
  <li class="method public "><a href="#mla_inline_edit_action" title="mla_inline_edit_action :: Ajax handler for inline editing (quick and bulk edit)"><span class="description">Ajax handler for inline editing (quick and bulk edit)</span><pre>mla_inline_edit_action()</pre></a></li>
65
+ <li class="method public "><a href="#mla_load_media_action" title="mla_load_media_action :: Redirect to Media/Assistant if Media/Library is hidden"><span class="description">Redirect to Media/Assistant if Media/Library is hidden</span><pre>mla_load_media_action()</pre></a></li>
66
  <li class="method public "><a href="#mla_parent_file_filter" title="mla_parent_file_filter :: Cleanup menus for Edit Tags/Categories page"><span class="description">Cleanup menus for Edit Tags/Categories page</span><pre>mla_parent_file_filter()</pre></a></li>
67
  <li class="method public "><a href="#mla_render_admin_page" title='mla_render_admin_page :: Render the "Assistant" subpage in the Media section, using the list_table package'><span class="description">Render the "Assistant" subpage in the Media section, using the list_table package</span><pre>mla_render_admin_page()</pre></a></li>
68
  <li class="method public "><a href="#mla_screen_options_show_screen_filter" title="mla_screen_options_show_screen_filter :: Only show screen options on the table-list screen"><span class="description">Only show screen options on the table-list screen</span><pre>mla_screen_options_show_screen_filter()</pre></a></li>
238
  </tr></table>
239
  </div></div>
240
  </div>
241
+ <a name="mla_load_media_action" id="mla_load_media_action"></a><div class="element clickable method public mla_load_media_action" data-toggle="collapse" data-target=".mla_load_media_action .collapse">
242
+ <h2>Redirect to Media/Assistant if Media/Library is hidden</h2>
243
+ <pre>mla_load_media_action() : void</pre>
244
+ <div class="labels"></div>
245
+ <div class="row collapse"><div class="detail-description">
246
+ <p class="long_description"></p>
247
+ <table class="table table-bordered"><tr>
248
+ <th>since</th>
249
+ <td>1.60</td>
250
+ </tr></table>
251
+ </div></div>
252
+ </div>
253
  <a name="mla_parent_file_filter" id="mla_parent_file_filter"></a><div class="element clickable method public mla_parent_file_filter" data-toggle="collapse" data-target=".mla_parent_file_filter .collapse">
254
  <h2>Cleanup menus for Edit Tags/Categories page</h2>
255
  <pre>mla_parent_file_filter(array $parent_file) : string</pre>
688
  <div class="row"><footer class="span12">
689
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
690
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
691
+ generated on 2013-11-27T11:31:01-08:00.<br></footer></div>
692
  </div>
693
  </body>
694
  </html>
phpDocs/classes/MLAData.html CHANGED
@@ -78,6 +78,7 @@
78
  <li class="method public "><a href="#mla_query_posts_search_filter" title="mla_query_posts_search_filter :: Adds a keyword search to the WHERE clause, if required"><span class="description">Adds a keyword search to the WHERE clause, if required</span><pre>mla_query_posts_search_filter()</pre></a></li>
79
  <li class="method public "><a href="#mla_query_posts_where_filter" title="mla_query_posts_where_filter :: Adds a WHERE clause for detached items"><span class="description">Adds a WHERE clause for detached items</span><pre>mla_query_posts_where_filter()</pre></a></li>
80
  <li class="method public "><a href="#mla_save_post_action" title="mla_save_post_action :: Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates"><span class="description">Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates</span><pre>mla_save_post_action()</pre></a></li>
 
81
  <li class="method public "><a href="#mla_update_item_postmeta" title='mla_update_item_postmeta :: Update custom field and "meta:" data for a single attachment'><span class="description">Update custom field and "meta:" data for a single attachment</span><pre>mla_update_item_postmeta()</pre></a></li>
82
  <li class="method public "><a href="#mla_update_single_item" title='mla_update_single_item :: Update a single item; change the "post" data, taxonomy terms
83
  and meta data for a single attachment'><span class="description">Update a single item; change the "post" data, taxonomy terms
@@ -715,6 +716,25 @@ Defined as public because it's a filter.</p></p>
715
  </div>
716
  </div></div>
717
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
718
  <a name="mla_update_item_postmeta" id="mla_update_item_postmeta"></a><div class="element clickable method public mla_update_item_postmeta" data-toggle="collapse" data-target=".mla_update_item_postmeta .collapse">
719
  <h2>Update custom field and "meta:" data for a single attachment</h2>
720
  <pre>mla_update_item_postmeta(int $post_id, array $new_meta) : string</pre>
@@ -1702,7 +1722,7 @@ any further logic required to translate those values is contained in the filters
1702
  <div class="row"><footer class="span12">
1703
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
1704
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1705
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
1706
  </div>
1707
  </body>
1708
  </html>
78
  <li class="method public "><a href="#mla_query_posts_search_filter" title="mla_query_posts_search_filter :: Adds a keyword search to the WHERE clause, if required"><span class="description">Adds a keyword search to the WHERE clause, if required</span><pre>mla_query_posts_search_filter()</pre></a></li>
79
  <li class="method public "><a href="#mla_query_posts_where_filter" title="mla_query_posts_where_filter :: Adds a WHERE clause for detached items"><span class="description">Adds a WHERE clause for detached items</span><pre>mla_query_posts_where_filter()</pre></a></li>
80
  <li class="method public "><a href="#mla_save_post_action" title="mla_save_post_action :: Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates"><span class="description">Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates</span><pre>mla_save_post_action()</pre></a></li>
81
+ <li class="method public "><a href="#mla_search_terms_tidy" title="mla_search_terms_tidy :: Replaces a WordPress function deprecated in v3.7"><span class="description">Replaces a WordPress function deprecated in v3.7</span><pre>mla_search_terms_tidy()</pre></a></li>
82
  <li class="method public "><a href="#mla_update_item_postmeta" title='mla_update_item_postmeta :: Update custom field and "meta:" data for a single attachment'><span class="description">Update custom field and "meta:" data for a single attachment</span><pre>mla_update_item_postmeta()</pre></a></li>
83
  <li class="method public "><a href="#mla_update_single_item" title='mla_update_single_item :: Update a single item; change the "post" data, taxonomy terms
84
  and meta data for a single attachment'><span class="description">Update a single item; change the "post" data, taxonomy terms
716
  </div>
717
  </div></div>
718
  </div>
719
+ <a name="mla_search_terms_tidy" id="mla_search_terms_tidy"></a><div class="element clickable method public mla_search_terms_tidy" data-toggle="collapse" data-target=".mla_search_terms_tidy .collapse">
720
+ <h2>Replaces a WordPress function deprecated in v3.7</h2>
721
+ <pre>mla_search_terms_tidy(string $term) : string</pre>
722
+ <div class="labels"></div>
723
+ <div class="row collapse"><div class="detail-description">
724
+ <p class="long_description"><p>Defined as public because it's a callback from array_map().</p></p>
725
+ <table class="table table-bordered"><tr>
726
+ <th>since</th>
727
+ <td>1.51</td>
728
+ </tr></table>
729
+ <h3>Parameters</h3>
730
+ <div class="subelement argument">
731
+ <h4>$term</h4>
732
+ <code>string</code><p>search term before modification</p></div>
733
+ <h3>Returns</h3>
734
+ <div class="subelement response">
735
+ <code>string</code>cleaned up search term</div>
736
+ </div></div>
737
+ </div>
738
  <a name="mla_update_item_postmeta" id="mla_update_item_postmeta"></a><div class="element clickable method public mla_update_item_postmeta" data-toggle="collapse" data-target=".mla_update_item_postmeta .collapse">
739
  <h2>Update custom field and "meta:" data for a single attachment</h2>
740
  <pre>mla_update_item_postmeta(int $post_id, array $new_meta) : string</pre>
1722
  <div class="row"><footer class="span12">
1723
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
1724
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1725
+ generated on 2013-11-27T11:31:01-08:00.<br></footer></div>
1726
  </div>
1727
  </body>
1728
  </html>
phpDocs/classes/MLAEdit.html CHANGED
@@ -345,7 +345,7 @@ The array is built once each page load and cached for subsequent calls.</p></p>
345
  <div class="row"><footer class="span12">
346
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
347
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
348
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
349
  </div>
350
  </body>
351
  </html>
345
  <div class="row"><footer class="span12">
346
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
347
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
348
+ generated on 2013-11-27T11:31:01-08:00.<br></footer></div>
349
  </div>
350
  </body>
351
  </html>
phpDocs/classes/MLAMime.html CHANGED
@@ -1268,7 +1268,7 @@ Defined as public because it's a filter.</p></p>
1268
  <div class="row"><footer class="span12">
1269
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
1270
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1271
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
1272
  </div>
1273
  </body>
1274
  </html>
1268
  <div class="row"><footer class="span12">
1269
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
1270
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1271
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
1272
  </div>
1273
  </body>
1274
  </html>
phpDocs/classes/MLAModal.html CHANGED
@@ -309,7 +309,7 @@ and mla_print_media_templates_action</h2>
309
  <div class="row"><footer class="span12">
310
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
311
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
312
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
313
  </div>
314
  </body>
315
  </html>
309
  <div class="row"><footer class="span12">
310
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
311
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
312
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
313
  </div>
314
  </body>
315
  </html>
phpDocs/classes/MLAObjects.html CHANGED
@@ -169,7 +169,7 @@ which replaces the "Posts" column with an equivalent "Attachments" column.</h2>
169
  <div class="row"><footer class="span12">
170
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
171
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
172
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
173
  </div>
174
  </body>
175
  </html>
169
  <div class="row"><footer class="span12">
170
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
171
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
172
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
173
  </div>
174
  </body>
175
  </html>
phpDocs/classes/MLAOptions.html CHANGED
@@ -1261,7 +1261,7 @@ This option is for flat taxonomies, e.g., "Att.</h2>
1261
  <div class="row"><footer class="span12">
1262
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
1263
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1264
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
1265
  </div>
1266
  </body>
1267
  </html>
1261
  <div class="row"><footer class="span12">
1262
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
1263
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1264
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
1265
  </div>
1266
  </body>
1267
  </html>
phpDocs/classes/MLASettings.html CHANGED
@@ -1152,7 +1152,7 @@ each page load and cached for subsequent use.</p></p>
1152
  <div class="row"><footer class="span12">
1153
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
1154
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1155
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
1156
  </div>
1157
  </body>
1158
  </html>
1152
  <div class="row"><footer class="span12">
1153
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
1154
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1155
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
1156
  </div>
1157
  </body>
1158
  </html>
phpDocs/classes/MLAShortcodes.html CHANGED
@@ -58,10 +58,13 @@
58
  <li class="method public "><a href="#mla_attachment_list_shortcode" title="mla_attachment_list_shortcode :: WordPress Shortcode; renders a complete list of all attachments and references to them"><span class="description">WordPress Shortcode; renders a complete list of all attachments and references to them</span><pre>mla_attachment_list_shortcode()</pre></a></li>
59
  <li class="method public "><a href="#mla_gallery_shortcode" title="mla_gallery_shortcode :: The MLA Gallery shortcode."><span class="description">The MLA Gallery shortcode.</span><pre>mla_gallery_shortcode()</pre></a></li>
60
  <li class="method public "><a href="#mla_get_shortcode_attachments" title="mla_get_shortcode_attachments :: Parses shortcode parameters and returns the gallery objects"><span class="description">Parses shortcode parameters and returns the gallery objects</span><pre>mla_get_shortcode_attachments()</pre></a></li>
 
61
  <li class="method public "><a href="#mla_shortcode_query_posts_clauses_filter" title="mla_shortcode_query_posts_clauses_filter :: Filters all clauses for shortcode queries, pre caching plugins"><span class="description">Filters all clauses for shortcode queries, pre caching plugins</span><pre>mla_shortcode_query_posts_clauses_filter()</pre></a></li>
62
  <li class="method public "><a href="#mla_shortcode_query_posts_clauses_request_filter" title="mla_shortcode_query_posts_clauses_request_filter :: Filters all clauses for shortcode queries, post caching plugins"><span class="description">Filters all clauses for shortcode queries, post caching plugins</span><pre>mla_shortcode_query_posts_clauses_request_filter()</pre></a></li>
63
  <li class="method public "><a href="#mla_shortcode_query_posts_orderby_filter" title="mla_shortcode_query_posts_orderby_filter :: Filters the ORDERBY clause for shortcode queries"><span class="description">Filters the ORDERBY clause for shortcode queries</span><pre>mla_shortcode_query_posts_orderby_filter()</pre></a></li>
64
  <li class="method public "><a href="#mla_shortcode_query_posts_where_filter" title="mla_shortcode_query_posts_where_filter :: Filters the WHERE clause for shortcode queries"><span class="description">Filters the WHERE clause for shortcode queries</span><pre>mla_shortcode_query_posts_where_filter()</pre></a></li>
 
 
65
  <li class="nav-header private">» Private</li>
66
  <li class="method private "><a href="#_paginate_links" title="_paginate_links :: Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links'"><span class="description">Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links'</span><pre>_paginate_links()</pre></a></li>
67
  <li class="method private "><a href="#_process_pagination_output_types" title="_process_pagination_output_types :: Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links'"><span class="description">Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links'</span><pre>_process_pagination_output_types()</pre></a></li>
@@ -73,8 +76,9 @@
73
  <li class="property public "><a href="#%24mla_debug_messages" title="$mla_debug_messages :: Accumulates debug messages"><span class="description">Accumulates debug messages</span><pre>$mla_debug_messages</pre></a></li>
74
  <li class="property public "><a href="#%24mla_gallery_wp_query_object" title="$mla_gallery_wp_query_object :: The WP_Query object used to select items for the gallery."><span class="description">The WP_Query object used to select items for the gallery.</span><pre>$mla_gallery_wp_query_object</pre></a></li>
75
  <li class="nav-header private">» Private</li>
76
- <li class="property private "><a href="#%24data_selection_parameters" title="$data_selection_parameters :: Data selection parameters for the WP_Query in [mla_gallery]"><span class="description">Data selection parameters for the WP_Query in [mla_gallery]</span><pre>$data_selection_parameters</pre></a></li>
77
  <li class="property private "><a href="#%24mla_debug" title="$mla_debug :: Turn debug collection and display on or off"><span class="description">Turn debug collection and display on or off</span><pre>$mla_debug</pre></a></li>
 
 
78
  <li class="property private "><a href="#%24query_parameters" title='$query_parameters :: WP_Query filter "parameters"'><span class="description">WP_Query filter "parameters"</span><pre>$query_parameters</pre></a></li>
79
  </ul>
80
  </div>
@@ -130,7 +134,7 @@
130
  </div>
131
  <a name="mla_gallery_shortcode" id="mla_gallery_shortcode"></a><div class="element clickable method public mla_gallery_shortcode" data-toggle="collapse" data-target=".mla_gallery_shortcode .collapse">
132
  <h2>The MLA Gallery shortcode.</h2>
133
- <pre>mla_gallery_shortcode(array $attr) : string</pre>
134
  <div class="labels"></div>
135
  <div class="row collapse"><div class="detail-description">
136
  <p class="long_description"><p>This is a superset of the WordPress Gallery shortcode for displaying images on a post,
@@ -143,7 +147,10 @@ Enhancements include many additional selection parameters and full taxonomy supp
143
  <h3>Parameters</h3>
144
  <div class="subelement argument">
145
  <h4>$attr</h4>
146
- <code>array</code><p>Attributes of the shortcode.</p></div>
 
 
 
147
  <h3>Returns</h3>
148
  <div class="subelement response">
149
  <code>string</code>HTML content to display gallery.</div>
@@ -175,6 +182,52 @@ Enhancements include many additional selection parameters and full taxonomy supp
175
  <code>array</code>List of attachments returned from WP_Query</div>
176
  </div></div>
177
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
178
  <a name="mla_shortcode_query_posts_clauses_filter" id="mla_shortcode_query_posts_clauses_filter"></a><div class="element clickable method public mla_shortcode_query_posts_clauses_filter" data-toggle="collapse" data-target=".mla_shortcode_query_posts_clauses_filter .collapse">
179
  <h2>Filters all clauses for shortcode queries, pre caching plugins</h2>
180
  <pre>mla_shortcode_query_posts_clauses_filter(array $pieces) : array</pre>
@@ -257,6 +310,45 @@ Defined as public because it's a filter.</p></p>
257
  <code>string</code>query clause after modification</div>
258
  </div></div>
259
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
260
  <a name="_paginate_links" id="_paginate_links"></a><div class="element clickable method private _paginate_links" data-toggle="collapse" data-target="._paginate_links .collapse">
261
  <h2>Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links'</h2>
262
  <pre>_paginate_links(array $output_parameters, string $markup_values, string $arguments, integer $found_rows, string $output) : mixed</pre>
@@ -416,9 +508,21 @@ Enhanced version of /wp-includes/formatting.php function sanitize_sql_orderby().
416
  </tr></table>
417
  </div></div>
418
  </div>
419
- <a name="%24data_selection_parameters" id="$data_selection_parameters"> </a><div class="element clickable property private $data_selection_parameters" data-toggle="collapse" data-target=".$data_selection_parameters .collapse">
 
 
 
 
 
 
 
 
 
 
 
 
420
  <h2>Data selection parameters for the WP_Query in [mla_gallery]</h2>
421
- <pre>$data_selection_parameters : array</pre>
422
  <div class="labels"></div>
423
  <div class="row collapse"><div class="detail-description">
424
  <p class="long_description"></p>
@@ -428,15 +532,15 @@ Enhanced version of /wp-includes/formatting.php function sanitize_sql_orderby().
428
  </tr></table>
429
  </div></div>
430
  </div>
431
- <a name="%24mla_debug" id="$mla_debug"> </a><div class="element clickable property private $mla_debug" data-toggle="collapse" data-target=".$mla_debug .collapse">
432
- <h2>Turn debug collection and display on or off</h2>
433
- <pre>$mla_debug : boolean</pre>
434
  <div class="labels"></div>
435
  <div class="row collapse"><div class="detail-description">
436
  <p class="long_description"></p>
437
  <table class="table table-bordered"><tr>
438
  <th>since</th>
439
- <td>0.70</td>
440
  </tr></table>
441
  </div></div>
442
  </div>
@@ -464,7 +568,7 @@ any further logic required to translate those values is contained in the filter.
464
  <div class="row"><footer class="span12">
465
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
466
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
467
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
468
  </div>
469
  </body>
470
  </html>
58
  <li class="method public "><a href="#mla_attachment_list_shortcode" title="mla_attachment_list_shortcode :: WordPress Shortcode; renders a complete list of all attachments and references to them"><span class="description">WordPress Shortcode; renders a complete list of all attachments and references to them</span><pre>mla_attachment_list_shortcode()</pre></a></li>
59
  <li class="method public "><a href="#mla_gallery_shortcode" title="mla_gallery_shortcode :: The MLA Gallery shortcode."><span class="description">The MLA Gallery shortcode.</span><pre>mla_gallery_shortcode()</pre></a></li>
60
  <li class="method public "><a href="#mla_get_shortcode_attachments" title="mla_get_shortcode_attachments :: Parses shortcode parameters and returns the gallery objects"><span class="description">Parses shortcode parameters and returns the gallery objects</span><pre>mla_get_shortcode_attachments()</pre></a></li>
61
+ <li class="method public "><a href="#mla_get_terms" title="mla_get_terms :: Retrieve the terms in one or more taxonomies."><span class="description">Retrieve the terms in one or more taxonomies.</span><pre>mla_get_terms()</pre></a></li>
62
  <li class="method public "><a href="#mla_shortcode_query_posts_clauses_filter" title="mla_shortcode_query_posts_clauses_filter :: Filters all clauses for shortcode queries, pre caching plugins"><span class="description">Filters all clauses for shortcode queries, pre caching plugins</span><pre>mla_shortcode_query_posts_clauses_filter()</pre></a></li>
63
  <li class="method public "><a href="#mla_shortcode_query_posts_clauses_request_filter" title="mla_shortcode_query_posts_clauses_request_filter :: Filters all clauses for shortcode queries, post caching plugins"><span class="description">Filters all clauses for shortcode queries, post caching plugins</span><pre>mla_shortcode_query_posts_clauses_request_filter()</pre></a></li>
64
  <li class="method public "><a href="#mla_shortcode_query_posts_orderby_filter" title="mla_shortcode_query_posts_orderby_filter :: Filters the ORDERBY clause for shortcode queries"><span class="description">Filters the ORDERBY clause for shortcode queries</span><pre>mla_shortcode_query_posts_orderby_filter()</pre></a></li>
65
  <li class="method public "><a href="#mla_shortcode_query_posts_where_filter" title="mla_shortcode_query_posts_where_filter :: Filters the WHERE clause for shortcode queries"><span class="description">Filters the WHERE clause for shortcode queries</span><pre>mla_shortcode_query_posts_where_filter()</pre></a></li>
66
+ <li class="method public "><a href="#mla_tag_cloud" title="mla_tag_cloud :: The MLA Tag Cloud support function."><span class="description">The MLA Tag Cloud support function.</span><pre>mla_tag_cloud()</pre></a></li>
67
+ <li class="method public "><a href="#mla_tag_cloud_shortcode" title="mla_tag_cloud_shortcode :: The MLA Tag Cloud shortcode."><span class="description">The MLA Tag Cloud shortcode.</span><pre>mla_tag_cloud_shortcode()</pre></a></li>
68
  <li class="nav-header private">» Private</li>
69
  <li class="method private "><a href="#_paginate_links" title="_paginate_links :: Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links'"><span class="description">Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links'</span><pre>_paginate_links()</pre></a></li>
70
  <li class="method private "><a href="#_process_pagination_output_types" title="_process_pagination_output_types :: Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links'"><span class="description">Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links'</span><pre>_process_pagination_output_types()</pre></a></li>
76
  <li class="property public "><a href="#%24mla_debug_messages" title="$mla_debug_messages :: Accumulates debug messages"><span class="description">Accumulates debug messages</span><pre>$mla_debug_messages</pre></a></li>
77
  <li class="property public "><a href="#%24mla_gallery_wp_query_object" title="$mla_gallery_wp_query_object :: The WP_Query object used to select items for the gallery."><span class="description">The WP_Query object used to select items for the gallery.</span><pre>$mla_gallery_wp_query_object</pre></a></li>
78
  <li class="nav-header private">» Private</li>
 
79
  <li class="property private "><a href="#%24mla_debug" title="$mla_debug :: Turn debug collection and display on or off"><span class="description">Turn debug collection and display on or off</span><pre>$mla_debug</pre></a></li>
80
+ <li class="property private "><a href="#%24mla_get_shortcode_attachments_parameters" title="$mla_get_shortcode_attachments_parameters :: Data selection parameters for the WP_Query in [mla_gallery]"><span class="description">Data selection parameters for the WP_Query in [mla_gallery]</span><pre>$mla_get_shortcode_attachments_parameters</pre></a></li>
81
+ <li class="property private "><a href="#%24mla_get_terms_parameters" title="$mla_get_terms_parameters :: Data selection parameters for [mla_tag_cloud]"><span class="description">Data selection parameters for [mla_tag_cloud]</span><pre>$mla_get_terms_parameters</pre></a></li>
82
  <li class="property private "><a href="#%24query_parameters" title='$query_parameters :: WP_Query filter "parameters"'><span class="description">WP_Query filter "parameters"</span><pre>$query_parameters</pre></a></li>
83
  </ul>
84
  </div>
134
  </div>
135
  <a name="mla_gallery_shortcode" id="mla_gallery_shortcode"></a><div class="element clickable method public mla_gallery_shortcode" data-toggle="collapse" data-target=".mla_gallery_shortcode .collapse">
136
  <h2>The MLA Gallery shortcode.</h2>
137
+ <pre>mla_gallery_shortcode(array $attr, string $content) : string</pre>
138
  <div class="labels"></div>
139
  <div class="row collapse"><div class="detail-description">
140
  <p class="long_description"><p>This is a superset of the WordPress Gallery shortcode for displaying images on a post,
147
  <h3>Parameters</h3>
148
  <div class="subelement argument">
149
  <h4>$attr</h4>
150
+ <code>array</code><p>Attributes of the shortcode</p></div>
151
+ <div class="subelement argument">
152
+ <h4>$content</h4>
153
+ <code>string</code><p>Optional content for enclosing shortcodes; used with mla_alt_shortcode</p></div>
154
  <h3>Returns</h3>
155
  <div class="subelement response">
156
  <code>string</code>HTML content to display gallery.</div>
182
  <code>array</code>List of attachments returned from WP_Query</div>
183
  </div></div>
184
  </div>
185
+ <a name="mla_get_terms" id="mla_get_terms"></a><div class="element clickable method public mla_get_terms" data-toggle="collapse" data-target=".mla_get_terms .collapse">
186
+ <h2>Retrieve the terms in one or more taxonomies.</h2>
187
+ <pre>mla_get_terms(array $attr) : array</pre>
188
+ <div class="labels"></div>
189
+ <div class="row collapse"><div class="detail-description">
190
+ <p class="long_description"><p>Alternative to WordPress get_terms() function that provides
191
+ an accurate count of attachments associated with each term.</p>
192
+
193
+ <p>taxonomy - string containing one or more (comma-delimited) taxonomy names
194
+ or an array of taxonomy names.</p>
195
+
196
+ <p>include - An array, comma- or space-delimited string of term ids to include
197
+ in the return array.</p>
198
+
199
+ <p>exclude - An array, comma- or space-delimited string of term ids to exclude
200
+ from the return array. If 'include' is non-empty, 'exclude' is ignored.</p>
201
+
202
+ <p>parent - term_id of the terms' immediate parent; 0 for top-level terms.</p>
203
+
204
+ <p>minimum - minimum number of attachments a term must have to be included.</p>
205
+
206
+ <p>number - maximum number of term objects to return. Terms are ordered by count,
207
+ descending and then by term_id before this value is applied.</p>
208
+
209
+ <p>orderby - 'count', 'id', 'name', 'none', 'random', 'slug'</p>
210
+
211
+ <p>order - 'ASC', 'DESC'</p>
212
+
213
+ <p>preserve_case - 'true', 'false' to make orderby case-sensitive.</p>
214
+
215
+ <p>limit - final number of term objects to return, for pagination.</p>
216
+
217
+ <p>offset - number of term objects to skip, for pagination.</p></p>
218
+ <table class="table table-bordered"><tr>
219
+ <th>since</th>
220
+ <td>1.60</td>
221
+ </tr></table>
222
+ <h3>Parameters</h3>
223
+ <div class="subelement argument">
224
+ <h4>$attr</h4>
225
+ <code>array</code><p>taxonomies to search and query parameters</p></div>
226
+ <h3>Returns</h3>
227
+ <div class="subelement response">
228
+ <code>array</code>array of term objects, empty if none found</div>
229
+ </div></div>
230
+ </div>
231
  <a name="mla_shortcode_query_posts_clauses_filter" id="mla_shortcode_query_posts_clauses_filter"></a><div class="element clickable method public mla_shortcode_query_posts_clauses_filter" data-toggle="collapse" data-target=".mla_shortcode_query_posts_clauses_filter .collapse">
232
  <h2>Filters all clauses for shortcode queries, pre caching plugins</h2>
233
  <pre>mla_shortcode_query_posts_clauses_filter(array $pieces) : array</pre>
310
  <code>string</code>query clause after modification</div>
311
  </div></div>
312
  </div>
313
+ <a name="mla_tag_cloud" id="mla_tag_cloud"></a><div class="element clickable method public mla_tag_cloud" data-toggle="collapse" data-target=".mla_tag_cloud .collapse">
314
+ <h2>The MLA Tag Cloud support function.</h2>
315
+ <pre>mla_tag_cloud(array $attr) : string</pre>
316
+ <div class="labels"></div>
317
+ <div class="row collapse"><div class="detail-description">
318
+ <p class="long_description"><p>This is an alternative to the WordPress wp_tag_cloud function, with additional
319
+ options to customize the hyperlink behind each term.</p></p>
320
+ <table class="table table-bordered"><tr>
321
+ <th>since</th>
322
+ <td>1.60</td>
323
+ </tr></table>
324
+ <h3>Parameters</h3>
325
+ <div class="subelement argument">
326
+ <h4>$attr</h4>
327
+ <code>array</code><p>Attributes of the shortcode.</p></div>
328
+ <h3>Returns</h3>
329
+ <div class="subelement response">
330
+ <code>string</code>HTML content to display the tag cloud.</div>
331
+ </div></div>
332
+ </div>
333
+ <a name="mla_tag_cloud_shortcode" id="mla_tag_cloud_shortcode"></a><div class="element clickable method public mla_tag_cloud_shortcode" data-toggle="collapse" data-target=".mla_tag_cloud_shortcode .collapse">
334
+ <h2>The MLA Tag Cloud shortcode.</h2>
335
+ <pre>mla_tag_cloud_shortcode(array $attr) : string</pre>
336
+ <div class="labels"></div>
337
+ <div class="row collapse"><div class="detail-description">
338
+ <p class="long_description"><p>This is an interface to the mla_tag_cloud function.</p></p>
339
+ <table class="table table-bordered"><tr>
340
+ <th>since</th>
341
+ <td>1.60</td>
342
+ </tr></table>
343
+ <h3>Parameters</h3>
344
+ <div class="subelement argument">
345
+ <h4>$attr</h4>
346
+ <code>array</code><p>Attributes of the shortcode.</p></div>
347
+ <h3>Returns</h3>
348
+ <div class="subelement response">
349
+ <code>string</code>HTML content to display the tag cloud.</div>
350
+ </div></div>
351
+ </div>
352
  <a name="_paginate_links" id="_paginate_links"></a><div class="element clickable method private _paginate_links" data-toggle="collapse" data-target="._paginate_links .collapse">
353
  <h2>Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links'</h2>
354
  <pre>_paginate_links(array $output_parameters, string $markup_values, string $arguments, integer $found_rows, string $output) : mixed</pre>
508
  </tr></table>
509
  </div></div>
510
  </div>
511
+ <a name="%24mla_debug" id="$mla_debug"> </a><div class="element clickable property private $mla_debug" data-toggle="collapse" data-target=".$mla_debug .collapse">
512
+ <h2>Turn debug collection and display on or off</h2>
513
+ <pre>$mla_debug : boolean</pre>
514
+ <div class="labels"></div>
515
+ <div class="row collapse"><div class="detail-description">
516
+ <p class="long_description"></p>
517
+ <table class="table table-bordered"><tr>
518
+ <th>since</th>
519
+ <td>0.70</td>
520
+ </tr></table>
521
+ </div></div>
522
+ </div>
523
+ <a name="%24mla_get_shortcode_attachments_parameters" id="$mla_get_shortcode_attachments_parameters"> </a><div class="element clickable property private $mla_get_shortcode_attachments_parameters" data-toggle="collapse" data-target=".$mla_get_shortcode_attachments_parameters .collapse">
524
  <h2>Data selection parameters for the WP_Query in [mla_gallery]</h2>
525
+ <pre>$mla_get_shortcode_attachments_parameters : array</pre>
526
  <div class="labels"></div>
527
  <div class="row collapse"><div class="detail-description">
528
  <p class="long_description"></p>
532
  </tr></table>
533
  </div></div>
534
  </div>
535
+ <a name="%24mla_get_terms_parameters" id="$mla_get_terms_parameters"> </a><div class="element clickable property private $mla_get_terms_parameters" data-toggle="collapse" data-target=".$mla_get_terms_parameters .collapse">
536
+ <h2>Data selection parameters for [mla_tag_cloud]</h2>
537
+ <pre>$mla_get_terms_parameters : array</pre>
538
  <div class="labels"></div>
539
  <div class="row collapse"><div class="detail-description">
540
  <p class="long_description"></p>
541
  <table class="table table-bordered"><tr>
542
  <th>since</th>
543
+ <td>1.60</td>
544
  </tr></table>
545
  </div></div>
546
  </div>
568
  <div class="row"><footer class="span12">
569
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
570
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
571
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
572
  </div>
573
  </body>
574
  </html>
phpDocs/classes/MLATest.html CHANGED
@@ -162,7 +162,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
162
  <div class="row"><footer class="span12">
163
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
164
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
165
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
166
  </div>
167
  </body>
168
  </html>
162
  <div class="row"><footer class="span12">
163
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
164
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
165
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
166
  </div>
167
  </body>
168
  </html>
phpDocs/classes/MLATextWidget.html ADDED
@@ -0,0 +1,205 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <!DOCTYPE html><html xmlns:date="http://exslt.org/dates-and-times" lang="en">
2
+ <head>
3
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4
+ <meta name="viewport" content="width=device-width; initial-scale=1.0; maximum-scale=1.0; user-scalable=0;">
5
+ <meta charset="utf-8">
6
+ <title>Media Library Assistant » \MLATextWidget</title>
7
+ <meta name="author" content="Mike van Riel">
8
+ <meta name="description" content="">
9
+ <link href="../css/template.css" rel="stylesheet" media="all">
10
+ <script src="../js/jquery-1.7.1.min.js" type="text/javascript"></script><script src="../js/jquery-ui-1.8.2.custom.min.js" type="text/javascript"></script><script src="../js/jquery.mousewheel.min.js" type="text/javascript"></script><script src="../js/bootstrap.js" type="text/javascript"></script><script src="../js/template.js" type="text/javascript"></script><script src="../js/prettify/prettify.min.js" type="text/javascript"></script><link rel="shortcut icon" href="../img/favicon.ico">
11
+ <link rel="apple-touch-icon" href="../img/apple-touch-icon.png">
12
+ <link rel="apple-touch-icon" sizes="72x72" href="../img/apple-touch-icon-72x72.png">
13
+ <link rel="apple-touch-icon" sizes="114x114" href="../img/apple-touch-icon-114x114.png">
14
+ </head>
15
+ <body>
16
+ <div class="navbar navbar-fixed-top">
17
+ <div class="navbar-inner"><div class="container">
18
+ <a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse"><span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span></a><a class="brand" href="../index.html">Media Library Assistant</a><div class="nav-collapse"><ul class="nav">
19
+ <li class="dropdown">
20
+ <a href="#api" class="dropdown-toggle" data-toggle="dropdown">
21
+ API Documentation <b class="caret"></b></a><ul class="dropdown-menu"></ul>
22
+ </li>
23
+ <li class="dropdown" id="charts-menu">
24
+ <a href="#charts" class="dropdown-toggle" data-toggle="dropdown">
25
+ Charts <b class="caret"></b></a><ul class="dropdown-menu"><li><a href="../graph_class.html"><i class="icon-list-alt"></i> Class hierarchy diagram</a></li></ul>
26
+ </li>
27
+ <li class="dropdown" id="reports-menu">
28
+ <a href="#reports" class="dropdown-toggle" data-toggle="dropdown">
29
+ Reports <b class="caret"></b></a><ul class="dropdown-menu">
30
+ <li><a href="../errors.html"><i class="icon-remove-sign"></i> Errors 
31
+ <span class="label label-info">0</span></a></li>
32
+ <li><a href="../markers.html"><i class="icon-map-marker"></i> Markers 
33
+ <ul><li>todo 
34
+ <span class="label label-info">1</span>
35
+ </li></ul></a></li>
36
+ <li><a href="../deprecated.html"><i class="icon-stop"></i> Deprecated elements 
37
+ <span class="label label-info">0</span></a></li>
38
+ </ul>
39
+ </li>
40
+ </ul></div>
41
+ </div></div>
42
+ <div class="go_to_top"><a href="#___" style="color: inherit">Back to top  <i class="icon-upload icon-white"></i></a></div>
43
+ </div>
44
+ <div id="___" class="container">
45
+ <noscript><div class="alert alert-warning">
46
+ Javascript is disabled; several features are only available
47
+ if Javascript is enabled.
48
+ </div></noscript>
49
+ <div class="row">
50
+ <div class="span4">
51
+ <span class="btn-group visibility" data-toggle="buttons-checkbox"><button class="btn public active" title="Show public elements">Public</button><button class="btn protected" title="Show protected elements">Protected</button><button class="btn private" title="Show private elements">Private</button><button class="btn inherited active" title="Show inherited elements">Inherited</button></span><div class="btn-group view pull-right" data-toggle="buttons-radio">
52
+ <button class="btn details" title="Show descriptions and method names"><i class="icon-list"></i></button><button class="btn simple" title="Show only method names"><i class="icon-align-justify"></i></button>
53
+ </div>
54
+ <ul class="side-nav nav nav-list">
55
+ <li class="nav-header">
56
+ <i class="icon-custom icon-method"></i> Methods</li>
57
+ <li class="method public "><a href="#__construct" title="__construct :: Calls the parent constructor to set some defaults."><span class="description">Calls the parent constructor to set some defaults.</span><pre>__construct()</pre></a></li>
58
+ <li class="method public "><a href="#form" title='form :: Echo the "edit widget" form on the Appearance/Widgets admin screen'><span class="description">Echo the "edit widget" form on the Appearance/Widgets admin screen</span><pre>form()</pre></a></li>
59
+ <li class="method public "><a href="#mla_text_widget_plugins_loaded_action" title="mla_text_widget_plugins_loaded_action :: Load a plugin text domain"><span class="description">Load a plugin text domain</span><pre>mla_text_widget_plugins_loaded_action()</pre></a></li>
60
+ <li class="method public "><a href="#mla_text_widget_widgets_init_action" title="mla_text_widget_widgets_init_action :: Register the widget with WordPress"><span class="description">Register the widget with WordPress</span><pre>mla_text_widget_widgets_init_action()</pre></a></li>
61
+ <li class="method public "><a href="#update" title="update :: Sanitize widget definition as it is saved to the database"><span class="description">Sanitize widget definition as it is saved to the database</span><pre>update()</pre></a></li>
62
+ <li class="method public "><a href="#widget" title='widget :: Display the widget content - called from the WordPress "front end"'><span class="description">Display the widget content - called from the WordPress "front end"</span><pre>widget()</pre></a></li>
63
+ <li class="nav-header">
64
+ <i class="icon-custom icon-constant"></i> Constants</li>
65
+ <li class="constant "><a href="#MLA_TEXT_DOMAIN" title="MLA_TEXT_DOMAIN :: Provides a unique name for the plugin text domain"><span class="description">Provides a unique name for the plugin text domain</span><pre>MLA_TEXT_DOMAIN</pre></a></li>
66
+ </ul>
67
+ </div>
68
+ <div class="span8">
69
+ <a name="%5CMLATextWidget" id="\MLATextWidget"></a><ul class="breadcrumb">
70
+ <li>
71
+ <a href="../index.html"><i class="icon-custom icon-class"></i></a><span class="divider">\</span>
72
+ </li>
73
+ <li><a href="../namespaces/global.html">global</a></li>
74
+ <li class="active">
75
+ <span class="divider">\</span><a href="../classes/MLATextWidget.html">MLATextWidget</a>
76
+ </li>
77
+ </ul>
78
+ <div href="../classes/MLATextWidget.html" class="element class">
79
+ <p class="short_description">Class MLA (Media Library Assistant) Text Widget defines a shortcode-enabled version of the WordPress Text widget</p>
80
+ <div class="details">
81
+ <p class="long_description"></p>
82
+ <table class="table table-bordered">
83
+ <tr>
84
+ <th>package</th>
85
+ <td><a href="../packages/Media%20Library%20Assistant.html">Media Library Assistant</a></td>
86
+ </tr>
87
+ <tr>
88
+ <th>since</th>
89
+ <td>1.60</td>
90
+ </tr>
91
+ </table>
92
+ <h3>
93
+ <i class="icon-custom icon-method"></i> Methods</h3>
94
+ <a name="__construct" id="__construct"></a><div class="element clickable method public __construct" data-toggle="collapse" data-target=".__construct .collapse">
95
+ <h2>Calls the parent constructor to set some defaults.</h2>
96
+ <pre>__construct() : void</pre>
97
+ <div class="labels"></div>
98
+ <div class="row collapse"><div class="detail-description">
99
+ <p class="long_description"></p>
100
+ <table class="table table-bordered"><tr>
101
+ <th>since</th>
102
+ <td>1.60</td>
103
+ </tr></table>
104
+ </div></div>
105
+ </div>
106
+ <a name="form" id="form"></a><div class="element clickable method public form" data-toggle="collapse" data-target=".form .collapse">
107
+ <h2>Echo the "edit widget" form on the Appearance/Widgets admin screen</h2>
108
+ <pre>form(array $instance) : void</pre>
109
+ <div class="labels"></div>
110
+ <div class="row collapse"><div class="detail-description">
111
+ <p class="long_description"></p>
112
+ <table class="table table-bordered"><tr>
113
+ <th>since</th>
114
+ <td>1.60</td>
115
+ </tr></table>
116
+ <h3>Parameters</h3>
117
+ <div class="subelement argument">
118
+ <h4>$instance</h4>
119
+ <code>array</code><p>Previous definition values, from the database</p></div>
120
+ </div></div>
121
+ </div>
122
+ <a name="mla_text_widget_plugins_loaded_action" id="mla_text_widget_plugins_loaded_action"></a><div class="element clickable method public mla_text_widget_plugins_loaded_action" data-toggle="collapse" data-target=".mla_text_widget_plugins_loaded_action .collapse">
123
+ <h2>Load a plugin text domain</h2>
124
+ <pre>mla_text_widget_plugins_loaded_action() : void</pre>
125
+ <div class="labels"></div>
126
+ <div class="row collapse"><div class="detail-description">
127
+ <p class="long_description"><p>Defined as public because it's an action.</p></p>
128
+ <table class="table table-bordered"><tr>
129
+ <th>since</th>
130
+ <td>1.60</td>
131
+ </tr></table>
132
+ </div></div>
133
+ </div>
134
+ <a name="mla_text_widget_widgets_init_action" id="mla_text_widget_widgets_init_action"></a><div class="element clickable method public mla_text_widget_widgets_init_action" data-toggle="collapse" data-target=".mla_text_widget_widgets_init_action .collapse">
135
+ <h2>Register the widget with WordPress</h2>
136
+ <pre>mla_text_widget_widgets_init_action() : void</pre>
137
+ <div class="labels"></div>
138
+ <div class="row collapse"><div class="detail-description">
139
+ <p class="long_description"><p>Defined as public because it's an action.</p></p>
140
+ <table class="table table-bordered"><tr>
141
+ <th>since</th>
142
+ <td>1.60</td>
143
+ </tr></table>
144
+ </div></div>
145
+ </div>
146
+ <a name="update" id="update"></a><div class="element clickable method public update" data-toggle="collapse" data-target=".update .collapse">
147
+ <h2>Sanitize widget definition as it is saved to the database</h2>
148
+ <pre>update(array $new_instance, array $old_instance) : array</pre>
149
+ <div class="labels"></div>
150
+ <div class="row collapse"><div class="detail-description">
151
+ <p class="long_description"></p>
152
+ <table class="table table-bordered"><tr>
153
+ <th>since</th>
154
+ <td>1.60</td>
155
+ </tr></table>
156
+ <h3>Parameters</h3>
157
+ <div class="subelement argument">
158
+ <h4>$new_instance</h4>
159
+ <code>array</code><p>Current definition values, to be saved in the database</p></div>
160
+ <div class="subelement argument">
161
+ <h4>$old_instance</h4>
162
+ <code>array</code><p>Previous definition values, from the database</p></div>
163
+ <h3>Returns</h3>
164
+ <div class="subelement response">
165
+ <code>array</code>Updated definition values to be saved in the database</div>
166
+ </div></div>
167
+ </div>
168
+ <a name="widget" id="widget"></a><div class="element clickable method public widget" data-toggle="collapse" data-target=".widget .collapse">
169
+ <h2>Display the widget content - called from the WordPress "front end"</h2>
170
+ <pre>widget(array $args, array $instance) : void</pre>
171
+ <div class="labels"></div>
172
+ <div class="row collapse"><div class="detail-description">
173
+ <p class="long_description"></p>
174
+ <table class="table table-bordered"><tr>
175
+ <th>since</th>
176
+ <td>1.60</td>
177
+ </tr></table>
178
+ <h3>Parameters</h3>
179
+ <div class="subelement argument">
180
+ <h4>$args</h4>
181
+ <code>array</code><p>Widget arguments</p></div>
182
+ <div class="subelement argument">
183
+ <h4>$instance</h4>
184
+ <code>array</code><p>Widget definition, from the database</p></div>
185
+ </div></div>
186
+ </div>
187
+ <h3>
188
+ <i class="icon-custom icon-constant"></i> Constants</h3>
189
+ <a name="MLA_TEXT_DOMAIN" id="MLA_TEXT_DOMAIN"> </a><div class="element clickable constant MLA_TEXT_DOMAIN" data-toggle="collapse" data-target=".MLA_TEXT_DOMAIN .collapse">
190
+ <h2>Provides a unique name for the plugin text domain</h2>
191
+ <pre>MLA_TEXT_DOMAIN </pre>
192
+ <div class="labels"></div>
193
+ <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
194
+ </div>
195
+ </div>
196
+ </div>
197
+ </div>
198
+ </div>
199
+ <div class="row"><footer class="span12">
200
+ Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
201
+ Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
202
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
203
+ </div>
204
+ </body>
205
+ </html>
phpDocs/classes/MLA_List_Table.html CHANGED
@@ -54,8 +54,8 @@
54
  <ul class="side-nav nav nav-list">
55
  <li class="nav-header">
56
  <i class="icon-custom icon-method"></i> Methods</li>
57
- <li class="method public "><a href="#__construct" title="__construct :: Initializes some properties from $_REQUEST vairables, then
58
- calls the parent constructor to set some default configs."><span class="description">Initializes some properties from $_REQUEST vairables, then
59
  calls the parent constructor to set some default configs.</span><pre>__construct()</pre></a></li>
60
  <li class="method public "><a href="#_get_view" title="_get_view :: Returns HTML markup for one view that can be used with this table"><span class="description">Returns HTML markup for one view that can be used with this table</span><pre>_get_view()</pre></a></li>
61
  <li class="method public "><a href="#column_ID_parent" title="column_ID_parent :: Supply the content for a custom column"><span class="description">Supply the content for a custom column</span><pre>column_ID_parent()</pre></a></li>
@@ -147,7 +147,7 @@ and the value is db column to sort by.</span><pre>get_sortable_columns()</pre></
147
  <h3>
148
  <i class="icon-custom icon-method"></i> Methods</h3>
149
  <a name="__construct" id="__construct"></a><div class="element clickable method public __construct" data-toggle="collapse" data-target=".__construct .collapse">
150
- <h2>Initializes some properties from $_REQUEST vairables, then
151
  calls the parent constructor to set some default configs.</h2>
152
  <pre>__construct() : void</pre>
153
  <div class="labels"></div>
@@ -1097,7 +1097,7 @@ Custom field columns are added to this array by mla_admin_init_action.</p></p>
1097
  <div class="row"><footer class="span12">
1098
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
1099
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1100
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
1101
  </div>
1102
  </body>
1103
  </html>
54
  <ul class="side-nav nav nav-list">
55
  <li class="nav-header">
56
  <i class="icon-custom icon-method"></i> Methods</li>
57
+ <li class="method public "><a href="#__construct" title="__construct :: Initializes some properties from $_REQUEST variables, then
58
+ calls the parent constructor to set some default configs."><span class="description">Initializes some properties from $_REQUEST variables, then
59
  calls the parent constructor to set some default configs.</span><pre>__construct()</pre></a></li>
60
  <li class="method public "><a href="#_get_view" title="_get_view :: Returns HTML markup for one view that can be used with this table"><span class="description">Returns HTML markup for one view that can be used with this table</span><pre>_get_view()</pre></a></li>
61
  <li class="method public "><a href="#column_ID_parent" title="column_ID_parent :: Supply the content for a custom column"><span class="description">Supply the content for a custom column</span><pre>column_ID_parent()</pre></a></li>
147
  <h3>
148
  <i class="icon-custom icon-method"></i> Methods</h3>
149
  <a name="__construct" id="__construct"></a><div class="element clickable method public __construct" data-toggle="collapse" data-target=".__construct .collapse">
150
+ <h2>Initializes some properties from $_REQUEST variables, then
151
  calls the parent constructor to set some default configs.</h2>
152
  <pre>__construct() : void</pre>
153
  <div class="labels"></div>
1097
  <div class="row"><footer class="span12">
1098
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
1099
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1100
+ generated on 2013-11-27T11:31:01-08:00.<br></footer></div>
1101
  </div>
1102
  </body>
1103
  </html>
phpDocs/classes/MLA_Upload_List_Table.html CHANGED
@@ -717,7 +717,7 @@ sorted by that column. This is computed each time the table is displayed.</p></p
717
  <div class="row"><footer class="span12">
718
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
719
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
720
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
721
  </div>
722
  </body>
723
  </html>
717
  <div class="row"><footer class="span12">
718
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
719
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
720
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
721
  </div>
722
  </body>
723
  </html>
phpDocs/classes/MLA_Upload_Optional_List_Table.html CHANGED
@@ -535,7 +535,7 @@ sorted by that column. This is computed each time the table is displayed.</p></p
535
  <div class="row"><footer class="span12">
536
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
537
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
538
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
539
  </div>
540
  </body>
541
  </html>
535
  <div class="row"><footer class="span12">
536
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
537
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
538
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
539
  </div>
540
  </body>
541
  </html>
phpDocs/classes/MLA_View_List_Table.html CHANGED
@@ -614,7 +614,7 @@ sorted by that column. This is computed each time the table is displayed.</p></p
614
  <div class="row"><footer class="span12">
615
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
616
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
617
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
618
  </div>
619
  </body>
620
  </html>
614
  <div class="row"><footer class="span12">
615
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
616
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
617
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
618
  </div>
619
  </body>
620
  </html>
phpDocs/deprecated.html CHANGED
@@ -64,7 +64,7 @@
64
  <div class="row"><footer class="span12">
65
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
66
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
67
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
68
  </div>
69
  </body>
70
  </html>
64
  <div class="row"><footer class="span12">
65
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
66
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
67
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
68
  </div>
69
  </body>
70
  </html>
phpDocs/errors.html CHANGED
@@ -83,7 +83,7 @@
83
  <div class="row"><footer class="span12">
84
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
85
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
86
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
87
  </div>
88
  </body>
89
  </html>
83
  <div class="row"><footer class="span12">
84
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
85
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
86
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
87
  </div>
88
  </body>
89
  </html>
phpDocs/graph_class.html CHANGED
@@ -61,7 +61,7 @@
61
  </script><div class="row"><footer class="span12">
62
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
63
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
64
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
65
  </div>
66
  </body>
67
  </html>
61
  </script><div class="row"><footer class="span12">
62
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
63
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
64
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
65
  </div>
66
  </body>
67
  </html>
phpDocs/index.html CHANGED
@@ -83,7 +83,7 @@
83
  <div class="row"><footer class="span12">
84
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
85
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
86
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
87
  </div>
88
  </body>
89
  </html>
83
  <div class="row"><footer class="span12">
84
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
85
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
86
+ generated on 2013-11-27T11:31:01-08:00.<br></footer></div>
87
  </div>
88
  </body>
89
  </html>
phpDocs/markers.html CHANGED
@@ -76,7 +76,7 @@
76
  </tr>
77
  <tr>
78
  <td>todo</td>
79
- <td>2901</td>
80
  <td>encode the rest</td>
81
  </tr>
82
  </table></div>
@@ -86,7 +86,7 @@
86
  <div class="row"><footer class="span12">
87
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
88
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
89
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
90
  </div>
91
  </body>
92
  </html>
76
  </tr>
77
  <tr>
78
  <td>todo</td>
79
+ <td>2937</td>
80
  <td>encode the rest</td>
81
  </tr>
82
  </table></div>
86
  <div class="row"><footer class="span12">
87
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
88
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
89
+ generated on 2013-11-27T11:31:02-08:00.<br></footer></div>
90
  </div>
91
  </body>
92
  </html>
phpDocs/namespaces/global.html CHANGED
@@ -169,6 +169,13 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
169
  <div class="details collapse"></div>
170
  <a href="../classes/MLATest.html" class="more">« More »</a>
171
  </div>
 
 
 
 
 
 
 
172
  <a name="MLA_List_Table" id="MLA_List_Table"></a><div class="element ajax clickable class" href="../classes/MLA_List_Table.html">
173
  <h1>MLA_List_Table<a href="../classes/MLA_List_Table.html">¶</a>
174
  </h1>
@@ -230,7 +237,7 @@ searchable database of exension/type associations for the "Uploads" admin settin
230
  <div class="row"><footer class="span12">
231
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
232
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
233
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
234
  </div>
235
  </body>
236
  </html>
169
  <div class="details collapse"></div>
170
  <a href="../classes/MLATest.html" class="more">« More »</a>
171
  </div>
172
+ <a name="MLATextWidget" id="MLATextWidget"></a><div class="element ajax clickable class" href="../classes/MLATextWidget.html">
173
+ <h1>MLATextWidget<a href="../classes/MLATextWidget.html">¶</a>
174
+ </h1>
175
+ <p class="short_description">Class MLA (Media Library Assistant) Text Widget defines a shortcode-enabled version of the WordPress Text widget</p>
176
+ <div class="details collapse"></div>
177
+ <a href="../classes/MLATextWidget.html" class="more">« More »</a>
178
+ </div>
179
  <a name="MLA_List_Table" id="MLA_List_Table"></a><div class="element ajax clickable class" href="../classes/MLA_List_Table.html">
180
  <h1>MLA_List_Table<a href="../classes/MLA_List_Table.html">¶</a>
181
  </h1>
237
  <div class="row"><footer class="span12">
238
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
239
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
240
+ generated on 2013-11-27T11:31:01-08:00.<br></footer></div>
241
  </div>
242
  </body>
243
  </html>
phpDocs/packages/Media Library Assistant.html CHANGED
@@ -72,6 +72,7 @@ of images and files held in the WordPress Media Library.">MLA</a></li>
72
  <li><a href="#MLAMime" title="Class MLA (Media Library Assistant) MIME filters WordPress MIME Type functions and supports
73
  the Views and Uploads Settings tabs">MLAMime</a></li>
74
  <li><a href="#MLAObjects" title="Class MLA (Media Library Assistant) Objects defines and manages custom taxonomies for Attachment Categories and Tags">MLAObjects</a></li>
 
75
  <li><a href="#MLAOptions" title="Class MLA (Media Library Assistant) Options manages the plugin option settings
76
  and provides functions to get and put them from/to WordPress option variables">MLAOptions</a></li>
77
  <li><a href="#MLASettings" title="Class MLA (Media Library Assistant) Settings provides the settings page to edit the plugin option settings">MLASettings</a></li>
@@ -200,6 +201,13 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
200
  <div class="details collapse"></div>
201
  <a href="../classes/MLATest.html" class="more">« More »</a>
202
  </div>
 
 
 
 
 
 
 
203
  <a name="MLA_List_Table" id="MLA_List_Table"></a><div class="element ajax clickable class" href="../classes/MLA_List_Table.html">
204
  <h1>MLA_List_Table<a href="../classes/MLA_List_Table.html">¶</a>
205
  </h1>
@@ -261,7 +269,7 @@ searchable database of exension/type associations for the "Uploads" admin settin
261
  <div class="row"><footer class="span12">
262
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
263
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
264
- generated on 2013-10-21T16:31:45-07:00.<br></footer></div>
265
  </div>
266
  </body>
267
  </html>
72
  <li><a href="#MLAMime" title="Class MLA (Media Library Assistant) MIME filters WordPress MIME Type functions and supports
73
  the Views and Uploads Settings tabs">MLAMime</a></li>
74
  <li><a href="#MLAObjects" title="Class MLA (Media Library Assistant) Objects defines and manages custom taxonomies for Attachment Categories and Tags">MLAObjects</a></li>
75
+ <li><a href="#MLATextWidget" title="Class MLA (Media Library Assistant) Text Widget defines a shortcode-enabled version of the WordPress Text widget">MLATextWidget</a></li>
76
  <li><a href="#MLAOptions" title="Class MLA (Media Library Assistant) Options manages the plugin option settings
77
  and provides functions to get and put them from/to WordPress option variables">MLAOptions</a></li>
78
  <li><a href="#MLASettings" title="Class MLA (Media Library Assistant) Settings provides the settings page to edit the plugin option settings">MLASettings</a></li>
201
  <div class="details collapse"></div>
202
  <a href="../classes/MLATest.html" class="more">« More »</a>
203
  </div>
204
+ <a name="MLATextWidget" id="MLATextWidget"></a><div class="element ajax clickable class" href="../classes/MLATextWidget.html">
205
+ <h1>MLATextWidget<a href="../classes/MLATextWidget.html">¶</a>
206
+ </h1>
207
+ <p class="short_description">Class MLA (Media Library Assistant) Text Widget defines a shortcode-enabled version of the WordPress Text widget</p>
208
+ <div class="details collapse"></div>
209
+ <a href="../classes/MLATextWidget.html" class="more">« More »</a>
210
+ </div>
211
  <a name="MLA_List_Table" id="MLA_List_Table"></a><div class="element ajax clickable class" href="../classes/MLA_List_Table.html">
212
  <h1>MLA_List_Table<a href="../classes/MLA_List_Table.html">¶</a>
213
  </h1>
269
  <div class="row"><footer class="span12">
270
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
271
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
272
+ generated on 2013-11-27T11:31:01-08:00.<br></footer></div>
273
  </div>
274
  </body>
275
  </html>
phpDocs/structure.xml CHANGED
@@ -1,6 +1,6 @@
1
  <?xml version="1.0" encoding="utf-8"?>
2
  <project version="2.0.0a8" title="Media Library Assistant">
3
- <file path="includes\class-mla-data.php" hash="68e2b18f25cc625f9fa345704375a6db" package="Media Library Assistant">
4
  <docblock line="2">
5
  <description><![CDATA[Database and template file access for MLA needs]]></description>
6
  <long-description><![CDATA[]]></long-description>
@@ -40,38 +40,38 @@ Templates separate HTML markup from PHP code for easier maintenance and localiza
40
  </tag>
41
  </docblock>
42
  </property>
43
- <property final="false" static="true" visibility="private" line="1026" namespace="global" package="Media Library Assistant">
44
  <name>$mla_list_table_items</name>
45
  <default><![CDATA[NULL]]></default>
46
- <docblock line="1019">
47
  <description><![CDATA[Cache the results of mla_count_list_table_items for reuse in mla_query_list_table_items]]></description>
48
  <long-description><![CDATA[]]></long-description>
49
- <tag line="1019" name="since" description="1.40"/>
50
- <tag line="1019" name="var" description="" type="array">
51
  <type by_reference="false">array</type>
52
  </tag>
53
  </docblock>
54
  </property>
55
- <property final="false" static="true" visibility="private" line="1132" namespace="global" package="Media Library Assistant">
56
  <name>$query_parameters</name>
57
  <default><![CDATA[array()]]></default>
58
- <docblock line="1119">
59
  <description><![CDATA[WP_Query filter "parameters"]]></description>
60
  <long-description><![CDATA[<p>This array defines parameters for the query's join, where and orderby filters.
61
  The parameters are set up in the _prepare_list_table_query function, and
62
  any further logic required to translate those values is contained in the filters.</p>
63
 
64
  <p>Array index values are: use_postmeta_view, postmeta_key, postmeta_value, patterns, detached, orderby, order, mla-metavalue, debug, s, mla_search_connector, mla_search_fields, sentence, exact</p>]]></long-description>
65
- <tag line="1119" name="since" description="0.30"/>
66
- <tag line="1119" name="var" description="" type="array">
67
  <type by_reference="false">array</type>
68
  </tag>
69
  </docblock>
70
  </property>
71
- <property final="false" static="true" visibility="private" line="2352" namespace="global" package="Media Library Assistant">
72
  <name>$galleries</name>
73
  <default><![CDATA[null]]></default>
74
- <docblock line="2333">
75
  <description><![CDATA[Objects containing [gallery] shortcodes]]></description>
76
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [gallery] shortcodes
77
  and array(s) of which attachments each [gallery] contains. The arrays are built once
@@ -84,113 +84,113 @@ each page load and cached for subsequent calls.</p>
84
  ['galleries'] array of [gallery] entries numbered from one (1), containing:
85
  galleries[X]['query'] contains a string with the arguments of the [gallery],
86
  galleries[X]['results'] contains an array ( ID ) of post_ids for the objects in the gallery.</p>]]></long-description>
87
- <tag line="2333" name="since" description="0.70"/>
88
- <tag line="2333" name="var" description="" type="array">
89
  <type by_reference="false">array</type>
90
  </tag>
91
  </docblock>
92
  </property>
93
- <property final="false" static="true" visibility="private" line="2365" namespace="global" package="Media Library Assistant">
94
  <name>$mla_galleries</name>
95
  <default><![CDATA[null]]></default>
96
- <docblock line="2354">
97
  <description><![CDATA[Objects containing [mla_gallery] shortcodes]]></description>
98
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [mla_gallery] shortcodes
99
  and array(s) of which attachments each [mla_gallery] contains. The arrays are built once
100
  each page load and cached for subsequent calls.</p>]]></long-description>
101
- <tag line="2354" name="since" description="0.70"/>
102
- <tag line="2354" name="var" description="" type="array">
103
  <type by_reference="false">array</type>
104
  </tag>
105
  </docblock>
106
  </property>
107
- <property final="false" static="true" visibility="private" line="2550" namespace="global" package="Media Library Assistant">
108
  <name>$pdf_indirect_objects</name>
109
  <default><![CDATA[NULL]]></default>
110
- <docblock line="2539">
111
  <description><![CDATA[Array of PDF indirect objects]]></description>
112
  <long-description><![CDATA[<p>This array contains all of the indirect object offsets and lengths.
113
  The array key is ( object ID * 1000 ) + object generation.
114
  The array value is array( number, generation, start, optional /length )</p>]]></long-description>
115
- <tag line="2539" name="since" description="1.50"/>
116
- <tag line="2539" name="var" description="" type="array">
117
  <type by_reference="false">array</type>
118
  </tag>
119
  </docblock>
120
  </property>
121
- <property final="false" static="true" visibility="private" line="3618" namespace="global" package="Media Library Assistant">
122
  <name>$utf8_chars</name>
123
  <default><![CDATA[array("\xC2\x80", "\xC2\x81", "\xC2\x82", "\xC2\x83", "\xC2\x84", "\xC2\x85", "\xC2\x86", "\xC2\x87", "\xC2\x88", "\xC2\x89", "\xC2\x8A", "\xC2\x8B", "\xC2\x8C", "\xC2\x8D", "\xC2\x8E", "\xC2\x8F", "\xC2\x90", "\xC2\x91", "\xC2\x92", "\xC2\x93", "\xC2\x94", "\xC2\x95", "\xC2\x96", "\xC2\x97", "\xC2\x98", "\xC2\x99", "\xC2\x9A", "\xC2\x9B", "\xC2\x9C", "\xC2\x9D", "\xC2\x9E", "\xC2\x9F", "\xC2\xA0", "\xC2\xA1", "\xC2\xA2", "\xC2\xA3", "\xC2\xA4", "\xC2\xA5", "\xC2\xA6", "\xC2\xA7", "\xC2\xA8", "\xC2\xA9", "\xC2\xAA", "\xC2\xAB", "\xC2\xAC", "\xC2\xAD", "\xC2\xAE", "\xC2\xAF", "\xC2\xB0", "\xC2\xB1", "\xC2\xB2", "\xC2\xB3", "\xC2\xB4", "\xC2\xB5", "\xC2\xB6", "\xC2\xB7", "\xC2\xB8", "\xC2\xB9", "\xC2\xBA", "\xC2\xBB", "\xC2\xBC", "\xC2\xBD", "\xC2\xBE", "\xC2\xBF", "\xC3\x80", "\xC3\x81", "\xC3\x82", "\xC3\x83", "\xC3\x84", "\xC3\x85", "\xC3\x86", "\xC3\x87", "\xC3\x88", "\xC3\x89", "\xC3\x8A", "\xC3\x8B", "\xC3\x8C", "\xC3\x8D", "\xC3\x8E", "\xC3\x8F", "\xC3\x90", "\xC3\x91", "\xC3\x92", "\xC3\x93", "\xC3\x94", "\xC3\x95", "\xC3\x96", "\xC3\x97", "\xC3\x98", "\xC3\x99", "\xC3\x9A", "\xC3\x9B", "\xC3\x9C", "\xC3\x9D", "\xC3\x9E", "\xC3\x9F", "\xC3\xA0", "\xC3\xA1", "\xC3\xA2", "\xC3\xA3", "\xC3\xA4", "\xC3\xA5", "\xC3\xA6", "\xC3\xA7", "\xC3\xA8", "\xC3\xA9", "\xC3\xAA", "\xC3\xAB", "\xC3\xAC", "\xC3\xAD", "\xC3\xAE", "\xC3\xAF", "\xC3\xB0", "\xC3\xB1", "\xC3\xB2", "\xC3\xB3", "\xC3\xB4", "\xC3\xB5", "\xC3\xB6", "\xC3\xB7", "\xC3\xB8", "\xC3\xB9", "\xC3\xBA", "\xC3\xBB", "\xC3\xBC", "\xC3\xBD", "\xC3\xBE", "\xC3\xBF")]]></default>
124
- <docblock line="3611">
125
  <description><![CDATA[UTF-8 replacements for invalid SQL characters]]></description>
126
  <long-description><![CDATA[]]></long-description>
127
- <tag line="3611" name="since" description="1.41"/>
128
- <tag line="3611" name="var" description="" type="array">
129
  <type by_reference="false">array</type>
130
  </tag>
131
  </docblock>
132
  </property>
133
- <property final="false" static="true" visibility="private" line="3676" namespace="global" package="Media Library Assistant">
134
  <name>$mla_iptc_records</name>
135
  <default><![CDATA[array("1#000" => "Model Version", "1#005" => "Destination", "1#020" => "File Format", "1#022" => "File Format Version", "1#030" => "Service Identifier", "1#040" => "Envelope Number", "1#050" => "Product ID", "1#060" => "Envelope Priority", "1#070" => "Date Sent", "1#080" => "Time Sent", "1#090" => "Coded Character Set", "1#100" => "UNO", "1#120" => "ARM Identifier", "1#122" => "ARM Version", "2#000" => "Record Version", "2#003" => "Object Type Reference", "2#004" => "Object Attribute Reference", "2#005" => "Object Name", "2#007" => "Edit Status", "2#008" => "Editorial Update", "2#010" => "Urgency", "2#012" => "Subject Reference", "2#015" => "Category", "2#020" => "Supplemental Category", "2#022" => "Fixture Identifier", "2#025" => "Keywords", "2#026" => "Content Location Code", "2#027" => "Content Location Name", "2#030" => "Release Date", "2#035" => "Release Time", "2#037" => "Expiration Date", "2#038" => "Expiration Time", "2#040" => "Special Instructions", "2#042" => "Action Advised", "2#045" => "Reference Service", "2#047" => "Reference Date", "2#050" => "Reference Number", "2#055" => "Date Created", "2#060" => "Time Created", "2#062" => "Digital Creation Date", "2#063" => "Digital Creation Time", "2#065" => "Originating Program", "2#070" => "Program Version", "2#075" => "Object Cycle", "2#080" => "By-line", "2#085" => "By-line Title", "2#090" => "City", "2#092" => "Sub-location", "2#095" => "Province or State", "2#100" => "Country or Primary Location Code", "2#101" => "Country or Primary Location Name", "2#103" => "Original Transmission Reference", "2#105" => "Headline", "2#110" => "Credit", "2#115" => "Source", "2#116" => "Copyright Notice", "2#118" => "Contact", "2#120" => "Caption or Abstract", "2#122" => "Caption Writer or Editor", "2#125" => "Rasterized Caption", "2#130" => "Image Type", "2#131" => "Image Orientation", "2#135" => "Language Identifier", "2#150" => "Audio Type", "2#151" => "Audio Sampling Rate", "2#152" => "Audio Sampling Resolution", "2#153" => "Audio Duration", "2#154" => "Audio Outcue", "2#200" => "ObjectData Preview File Format", "2#201" => "ObjectData Preview File Format Version", "2#202" => "ObjectData Preview Data", "7#010" => "Size Mode", "7#020" => "Max Subfile Size", "7#090" => "ObjectData Size Announced", "7#095" => "Maximum ObjectData Size", "8#010" => "Subfile", "9#010" => "Confirmed ObjectData Size")]]></default>
136
- <docblock line="3666">
137
  <description><![CDATA[IPTC Dataset identifiers and names]]></description>
138
  <long-description><![CDATA[<p>This array contains the identifiers and names of Datasets defined in
139
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
140
- <tag line="3666" name="since" description="0.90"/>
141
- <tag line="3666" name="var" description="" type="array">
142
  <type by_reference="false">array</type>
143
  </tag>
144
  </docblock>
145
  </property>
146
- <property final="false" static="true" visibility="public" line="3775" namespace="global" package="Media Library Assistant">
147
  <name>$mla_iptc_keys</name>
148
  <default><![CDATA[array('model-version' => '1#000', 'destination' => '1#005', 'file-format' => '1#020', 'file-format-version' => '1#022', 'service-identifier' => '1#030', 'envelope-number' => '1#040', 'product-id' => '1#050', 'envelope-priority' => '1#060', 'date-sent' => '1#070', 'time-sent' => '1#080', 'coded-character-set' => '1#090', 'uno' => '1#100', 'arm-identifier' => '1#120', 'arm-version' => '1#122', 'record-version' => '2#000', 'object-type-reference' => '2#003', 'object-attribute-reference' => '2#004', 'object-name' => '2#005', 'edit-status' => '2#007', 'editorial-update' => '2#008', 'urgency' => '2#010', 'subject-reference' => '2#012', 'category' => '2#015', 'supplemental-category' => '2#020', 'fixture-identifier' => '2#022', 'keywords' => '2#025', 'content-location-code' => '2#026', 'content-location-name' => '2#027', 'release-date' => '2#030', 'release-time' => '2#035', 'expiration-date' => '2#037', 'expiration-time' => '2#038', 'special-instructions' => '2#040', 'action-advised' => '2#042', 'reference-service' => '2#045', 'reference-date' => '2#047', 'reference-number' => '2#050', 'date-created' => '2#055', 'time-created' => '2#060', 'digital-creation-date' => '2#062', 'digital-creation-time' => '2#063', 'originating-program' => '2#065', 'program-version' => '2#070', 'object-cycle' => '2#075', 'by-line' => '2#080', 'by-line-title' => '2#085', 'city' => '2#090', 'sub-location' => '2#092', 'province-or-state' => '2#095', 'country-or-primary-location-code' => '2#100', 'country-or-primary-location-name' => '2#101', 'original-transmission-reference' => '2#103', 'headline' => '2#105', 'credit' => '2#110', 'source' => '2#115', 'copyright-notice' => '2#116', 'contact' => '2#118', 'caption-or-abstract' => '2#120', 'caption-writer-or-editor' => '2#122', 'rasterized-caption' => '2#125', 'image-type' => '2#130', 'image-orientation' => '2#131', 'language-identifier' => '2#135', 'audio-type' => '2#150', 'audio-sampling-rate' => '2#151', 'audio-sampling-resolution' => '2#152', 'audio-duration' => '2#153', 'audio-outcue' => '2#154', 'objectdata-preview-file-format' => '2#200', 'objectdata-preview-file-format-version' => '2#201', 'objectdata-preview-data' => '2#202', 'size-mode' => '7#010', 'max-subfile-size' => '7#020', 'objectdata-size-announced' => '7#090', 'maximum-objectdata-size' => '7#095', 'subfile' => '8#010', 'confirmed-objectdata-size' => '9#010')]]></default>
149
- <docblock line="3765">
150
  <description><![CDATA[IPTC Dataset friendly name/slug and identifiers]]></description>
151
  <long-description><![CDATA[<p>This array contains the sanitized names and identifiers of Datasets defined in
152
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
153
- <tag line="3765" name="since" description="0.90"/>
154
- <tag line="3765" name="var" description="" type="array">
155
  <type by_reference="false">array</type>
156
  </tag>
157
  </docblock>
158
  </property>
159
- <property final="false" static="true" visibility="private" line="3874" namespace="global" package="Media Library Assistant">
160
  <name>$mla_iptc_descriptions</name>
161
  <default><![CDATA[array("1#000" => "2 octet binary IIM version number", "1#005" => "Max 1024 characters of Destination (ISO routing information); repeatable", "1#020" => "2 octet binary file format number, see IPTC-NAA V4 Appendix A", "1#022" => "2 octet binary file format version number", "1#030" => "Max 10 characters of Service Identifier and product", "1#040" => "8 Character Envelope Number", "1#050" => "Max 32 characters subset of provider's overall service; repeatable", "1#060" => "1 numeric character of envelope handling priority (not urgency)", "1#070" => "8 numeric characters of Date Sent by service - CCYYMMDD", "1#080" => "11 characters of Time Sent by service - HHMMSS±HHMM", "1#090" => "Max 32 characters of control functions, etc.", "1#100" => "14 to 80 characters of eternal, globally unique identification for objects", "1#120" => "2 octet binary Abstract Relationship Model Identifier", "1#122" => "2 octet binary Abstract Relationship Model Version", "2#000" => "2 octet binary Information Interchange Model, Part II version number", "2#003" => "3 to 67 Characters of Object Type Reference number and optional text", "2#004" => "3 to 67 Characters of Object Attribute Reference number and optional text; repeatable", "2#005" => "Max 64 characters of the object name or shorthand reference", "2#007" => "Max 64 characters of the status of the objectdata", "2#008" => "2 numeric characters of the type of update this object provides", "2#010" => "1 numeric character of the editorial urgency of content", "2#012" => "13 to 236 characters of a structured definition of the subject matter; repeatable", "2#015" => "Max 3 characters of the subject of the objectdata, DEPRECATED", "2#020" => "Max 32 characters (each) of further refinement of subject, DEPRECATED; repeatable", "2#022" => "Max 32 characters identifying recurring, predictable content", "2#025" => "Max 64 characters (each) of tags; repeatable", "2#026" => "3 characters of ISO3166 country code or IPTC-assigned code; repeatable", "2#027" => "Max 64 characters of publishable country/geographical location name; repeatable", "2#030" => "8 numeric characters of Release Date - CCYYMMDD", "2#035" => "11 characters of Release Time (earliest use) - HHMMSS±HHMM", "2#037" => "8 numeric characters of Expiration Date (latest use) - CCYYMDD", "2#038" => "11 characters of Expiration Time (latest use) - HHMMSS±HHMM", "2#040" => "Max 256 Characters of editorial instructions, e.g., embargoes and warnings", "2#042" => "2 numeric characters of type of action this object provides to a previous object", "2#045" => "Max 10 characters of the Service ID (1#030) of a prior envelope; repeatable", "2#047" => "8 numeric characters of prior envelope Reference Date (1#070) - CCYYMMDD; repeatable", "2#050" => "8 characters of prior envelope Reference Number (1#040); repeatable", "2#055" => "8 numeric characters of intellectual content Date Created - CCYYMMDD", "2#060" => "11 characters of intellectual content Time Created - HHMMSS±HHMM", "2#062" => "8 numeric characters of digital representation creation date - CCYYMMDD", "2#063" => "11 characters of digital representation creation time - HHMMSS±HHMM", "2#065" => "Max 32 characters of the program used to create the objectdata", "2#070" => "Program Version - Max 10 characters of the version of the program used to create the objectdata", "2#075" => "1 character where a=morning, p=evening, b=both", "2#080" => "Max 32 Characters of the name of the objectdata creator, e.g., the writer, photographer; repeatable", "2#085" => "Max 32 characters of the title of the objectdata creator; repeatable", "2#090" => "Max 32 Characters of the city of objectdata origin", "2#092" => "Max 32 Characters of the location within the city of objectdata origin", "2#095" => "Max 32 Characters of the objectdata origin Province or State", "2#100" => "3 characters of ISO3166 or IPTC-assigned code for Country of objectdata origin", "2#101" => "Max 64 characters of publishable country/geographical location name of objectdata origin", "2#103" => "Max 32 characters of a code representing the location of original transmission", "2#105" => "Max 256 Characters of a publishable entry providing a synopsis of the contents of the objectdata", "2#110" => "Max 32 Characters that identifies the provider of the objectdata (Vs the owner/creator)", "2#115" => "Max 32 Characters that identifies the original owner of the intellectual content", "2#116" => "Max 128 Characters that contains any necessary copyright notice", "2#118" => "Max 128 characters that identifies the person or organisation which can provide further background information; repeatable", "2#120" => "Max 2000 Characters of a textual description of the objectdata", "2#122" => "Max 32 Characters that the identifies the person involved in the writing, editing or correcting the objectdata or caption/abstract; repeatable", "2#125" => "7360 binary octets of the rasterized caption - 1 bit per pixel, 460x128-pixel image", "2#130" => "2 characters of color composition type and information", "2#131" => "1 alphabetic character indicating the image area layout - P=portrait, L=landscape, S=square", "2#135" => "2 or 3 aphabetic characters containing the major national language of the object, according to the ISO 639:1988 codes", "2#150" => "2 characters identifying monaural/stereo and exact type of audio content", "2#151" => "6 numeric characters representing the audio sampling rate in hertz (Hz)", "2#152" => "2 numeric characters representing the number of bits in each audio sample", "2#153" => "6 numeric characters of the Audio Duration - HHMMSS", "2#154" => "Max 64 characters of the content of the end of an audio objectdata", "2#200" => "2 octet binary file format of the ObjectData Preview", "2#201" => "2 octet binary particular version of the ObjectData Preview File Format", "2#202" => "Max 256000 binary octets containing the ObjectData Preview data", "7#010" => "1 numeric character - 0=objectdata size not known, 1=objectdata size known at beginning of transfer", "7#020" => "4 octet binary maximum subfile dataset(s) size", "7#090" => "4 octet binary objectdata size if known at beginning of transfer", "7#095" => "4 octet binary largest possible objectdata size", "8#010" => "Subfile DataSet containing the objectdata itself; repeatable", "9#010" => "4 octet binary total objectdata size")]]></default>
162
- <docblock line="3864">
163
  <description><![CDATA[IPTC Dataset descriptions]]></description>
164
  <long-description><![CDATA[<p>This array contains the descriptions of Datasets defined in
165
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
166
- <tag line="3864" name="since" description="0.90"/>
167
- <tag line="3864" name="var" description="" type="array">
168
  <type by_reference="false">array</type>
169
  </tag>
170
  </docblock>
171
  </property>
172
- <property final="false" static="true" visibility="private" line="3973" namespace="global" package="Media Library Assistant">
173
  <name>$mla_iptc_formats</name>
174
  <default><![CDATA[array(0 => "No ObjectData", 1 => "IPTC-NAA Digital Newsphoto Parameter Record", 2 => "IPTC7901 Recommended Message Format", 3 => "Tagged Image File Format (Adobe/Aldus Image data)", 4 => "Illustrator (Adobe Graphics data)", 5 => "AppleSingle (Apple Computer Inc)", 6 => "NAA 89-3 (ANPA 1312)", 7 => "MacBinary II", 0 => "IPTC Unstructured Character Oriented File Format (UCOFF)", 0 => "United Press International ANPA 1312 variant", 10 => "United Press International Down-Load Message", 11 => "JPEG File Interchange (JFIF)", 12 => "Photo-CD Image-Pac (Eastman Kodak)", 13 => "Microsoft Bit Mapped Graphics File [*.BMP]", 14 => "Digital Audio File [*.WAV] (Microsoft & Creative Labs)", 15 => "Audio plus Moving Video [*.AVI] (Microsoft)", 16 => "PC DOS/Windows Executable Files [*.COM][*.EXE]", 17 => "Compressed Binary File [*.ZIP] (PKWare Inc)", 18 => "Audio Interchange File Format AIFF (Apple Computer Inc)", 19 => "RIFF Wave (Microsoft Corporation)", 20 => "Freehand (Macromedia/Aldus)", 21 => "Hypertext Markup Language - HTML (The Internet Society)", 22 => "MPEG 2 Audio Layer 2 (Musicom), ISO/IEC", 23 => "MPEG 2 Audio Layer 3, ISO/IEC", 24 => "Portable Document File (*.PDF) Adobe", 25 => "News Industry Text Format (NITF)", 26 => "Tape Archive (*.TAR)", 27 => "Tidningarnas Telegrambyrå NITF version (TTNITF DTD)", 28 => "Ritzaus Bureau NITF version (RBNITF DTD)", 29 => "Corel Draw [*.CDR]")]]></default>
175
- <docblock line="3963">
176
  <description><![CDATA[IPTC file format identifiers and descriptions]]></description>
177
  <long-description><![CDATA[<p>This array contains the file format identifiers and descriptions defined in
178
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 1#020.</p>]]></long-description>
179
- <tag line="3963" name="since" description="0.90"/>
180
- <tag line="3963" name="var" description="" type="array">
181
  <type by_reference="false">array</type>
182
  </tag>
183
  </docblock>
184
  </property>
185
- <property final="false" static="true" visibility="private" line="4016" namespace="global" package="Media Library Assistant">
186
  <name>$mla_iptc_image_types</name>
187
  <default><![CDATA[array("M" => "Monochrome", "Y" => "Yellow Component", "M" => "Magenta Component", "C" => "Cyan Component", "K" => "Black Component", "R" => "Red Component", "G" => "Green Component", "B" => "Blue Component", "T" => "Text Only", "F" => "Full colour composite, frame sequential", "L" => "Full colour composite, line sequential", "P" => "Full colour composite, pixel sequential", "S" => "Full colour composite, special interleaving")]]></default>
188
- <docblock line="4006">
189
  <description><![CDATA[IPTC image type identifiers and descriptions]]></description>
190
  <long-description><![CDATA[<p>This array contains the image type identifiers and descriptions defined in
191
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 2#130, octet 2.</p>]]></long-description>
192
- <tag line="4006" name="since" description="0.90"/>
193
- <tag line="4006" name="var" description="" type="array">
194
  <type by_reference="false">array</type>
195
  </tag>
196
  </docblock>
@@ -543,1327 +543,1347 @@ All but request and query require an attachment ID.</p>]]></long-description>
543
  <type/>
544
  </argument>
545
  </method>
546
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="947" package="Media Library Assistant">
547
  <name>mla_get_template_placeholders</name>
548
  <full_name>mla_get_template_placeholders</full_name>
549
- <docblock line="936">
550
  <description><![CDATA[Analyze a template, returning an array of the placeholders it contains]]></description>
551
  <long-description><![CDATA[]]></long-description>
552
- <tag line="936" name="since" description="0.90"/>
553
- <tag line="936" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
554
  <type by_reference="false">string</type>
555
  </tag>
556
- <tag line="936" name="param" description="Optional: default option value" type="string" variable="$default_option">
557
  <type by_reference="false">string</type>
558
  </tag>
559
- <tag line="936" name="return" description="Placeholder information: each entry is an array with ['prefix'] =&gt; string, ['value'] =&gt; string, ['option'] =&gt; string 'text'|single'|'export'|'array'|'multi'" type="array">
560
  <type by_reference="false">array</type>
561
  </tag>
562
  </docblock>
563
- <argument line="947">
564
  <name>$tpl</name>
565
  <default><![CDATA[]]></default>
566
  <type/>
567
  </argument>
568
- <argument line="947">
569
  <name>$default_option</name>
570
  <default><![CDATA['text']]></default>
571
  <type/>
572
  </argument>
573
  </method>
574
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1039" package="Media Library Assistant">
575
  <name>mla_count_list_table_items</name>
576
  <full_name>mla_count_list_table_items</full_name>
577
- <docblock line="1028">
578
  <description><![CDATA[Get the total number of attachment posts]]></description>
579
  <long-description><![CDATA[]]></long-description>
580
- <tag line="1028" name="since" description="0.30"/>
581
- <tag line="1028" name="param" description="Query variables, e.g., from $_REQUEST" type="array" variable="$request">
582
  <type by_reference="false">array</type>
583
  </tag>
584
- <tag line="1028" name="param" description="(optional) number of rows to skip over to reach desired page" type="int" variable="$offset">
585
  <type by_reference="false">int</type>
586
  </tag>
587
- <tag line="1028" name="param" description="(optional) number of rows on each page" type="int" variable="$count">
588
  <type by_reference="false">int</type>
589
  </tag>
590
- <tag line="1028" name="return" description="Number of attachment posts" type="integer">
591
  <type by_reference="false">integer</type>
592
  </tag>
593
  </docblock>
594
- <argument line="1039">
595
  <name>$request</name>
596
  <default><![CDATA[]]></default>
597
  <type/>
598
  </argument>
599
- <argument line="1039">
600
  <name>$offset</name>
601
  <default><![CDATA[NULL]]></default>
602
  <type/>
603
  </argument>
604
- <argument line="1039">
605
  <name>$count</name>
606
  <default><![CDATA[NULL]]></default>
607
  <type/>
608
  </argument>
609
  </method>
610
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1068" package="Media Library Assistant">
611
  <name>mla_query_list_table_items</name>
612
  <full_name>mla_query_list_table_items</full_name>
613
- <docblock line="1054">
614
  <description><![CDATA[Retrieve attachment objects for list table display]]></description>
615
  <long-description><![CDATA[<p>Supports prepare_items in class-mla-list-table.php.
616
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
617
- <tag line="1054" name="since" description="0.1"/>
618
- <tag line="1054" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
619
  <type by_reference="false">array</type>
620
  </tag>
621
- <tag line="1054" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
622
  <type by_reference="false">int</type>
623
  </tag>
624
- <tag line="1054" name="param" description="number of rows on each page" type="int" variable="$count">
625
  <type by_reference="false">int</type>
626
  </tag>
627
- <tag line="1054" name="return" description="attachment objects (posts) including parent data, meta data and references" type="array">
628
  <type by_reference="false">array</type>
629
  </tag>
630
  </docblock>
631
- <argument line="1068">
632
  <name>$request</name>
633
  <default><![CDATA[]]></default>
634
  <type/>
635
  </argument>
636
- <argument line="1068">
637
  <name>$offset</name>
638
  <default><![CDATA[]]></default>
639
  <type/>
640
  </argument>
641
- <argument line="1068">
642
  <name>$count</name>
643
  <default><![CDATA[]]></default>
644
  <type/>
645
  </argument>
646
  </method>
647
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1114" package="Media Library Assistant">
648
  <name>mla_query_media_modal_items</name>
649
  <full_name>mla_query_media_modal_items</full_name>
650
- <docblock line="1101">
651
  <description><![CDATA[Retrieve attachment objects for the WordPress Media Manager]]></description>
652
  <long-description><![CDATA[<p>Supports month-year and taxonomy-term filters as well as the enhanced search box</p>]]></long-description>
653
- <tag line="1101" name="since" description="1.20"/>
654
- <tag line="1101" name="param" description="query parameters from Media Manager" type="array" variable="$request">
655
  <type by_reference="false">array</type>
656
  </tag>
657
- <tag line="1101" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
658
  <type by_reference="false">int</type>
659
  </tag>
660
- <tag line="1101" name="param" description="number of rows on each page" type="int" variable="$count">
661
  <type by_reference="false">int</type>
662
  </tag>
663
- <tag line="1101" name="return" description="attachment objects (posts)" type="array">
664
  <type by_reference="false">array</type>
665
  </tag>
666
  </docblock>
667
- <argument line="1114">
668
  <name>$request</name>
669
  <default><![CDATA[]]></default>
670
  <type/>
671
  </argument>
672
- <argument line="1114">
673
  <name>$offset</name>
674
  <default><![CDATA[]]></default>
675
  <type/>
676
  </argument>
677
- <argument line="1114">
678
  <name>$count</name>
679
  <default><![CDATA[]]></default>
680
  <type/>
681
  </argument>
682
  </method>
683
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1148" package="Media Library Assistant">
684
  <name>_prepare_list_table_query</name>
685
  <full_name>_prepare_list_table_query</full_name>
686
- <docblock line="1134">
687
  <description><![CDATA[Sanitize and expand query arguments from request variables]]></description>
688
  <long-description><![CDATA[<p>Prepare the arguments for WP_Query.
689
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
690
- <tag line="1134" name="since" description="0.1"/>
691
- <tag line="1134" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$raw_request">
692
  <type by_reference="false">array</type>
693
  </tag>
694
- <tag line="1134" name="param" description="Optional number of rows (default 0) to skip over to reach desired page" type="int" variable="$offset">
695
  <type by_reference="false">int</type>
696
  </tag>
697
- <tag line="1134" name="param" description="Optional number of rows on each page (0 = all rows, default)" type="int" variable="$count">
698
  <type by_reference="false">int</type>
699
  </tag>
700
- <tag line="1134" name="return" description="revised arguments suitable for WP_Query" type="array">
701
  <type by_reference="false">array</type>
702
  </tag>
703
  </docblock>
704
- <argument line="1148">
705
  <name>$raw_request</name>
706
  <default><![CDATA[]]></default>
707
  <type/>
708
  </argument>
709
- <argument line="1148">
710
  <name>$offset</name>
711
  <default><![CDATA[0]]></default>
712
  <type/>
713
  </argument>
714
- <argument line="1148">
715
  <name>$count</name>
716
  <default><![CDATA[0]]></default>
717
  <type/>
718
  </argument>
719
  </method>
720
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1475" package="Media Library Assistant">
721
  <name>_execute_list_table_query</name>
722
  <full_name>_execute_list_table_query</full_name>
723
- <docblock line="1466">
724
  <description><![CDATA[Add filters, run query, remove filters]]></description>
725
  <long-description><![CDATA[]]></long-description>
726
- <tag line="1466" name="since" description="0.30"/>
727
- <tag line="1466" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
728
  <type by_reference="false">array</type>
729
  </tag>
730
- <tag line="1466" name="return" description="WP_Query object with query results" type="object">
731
  <type by_reference="false">object</type>
732
  </tag>
733
  </docblock>
734
- <argument line="1475">
735
  <name>$request</name>
736
  <default><![CDATA[]]></default>
737
  <type/>
738
  </argument>
739
  </method>
740
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1552" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
741
  <name>mla_query_posts_search_filter</name>
742
  <full_name>mla_query_posts_search_filter</full_name>
743
- <docblock line="1540">
744
  <description><![CDATA[Adds a keyword search to the WHERE clause, if required]]></description>
745
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
746
- <tag line="1540" name="since" description="0.60"/>
747
- <tag line="1540" name="param" description="query clause before modification" type="string" variable="$search_string">
748
  <type by_reference="false">string</type>
749
  </tag>
750
- <tag line="1540" name="param" description="WP_Query object" type="object" variable="$query_object">
751
  <type by_reference="false">object</type>
752
  </tag>
753
- <tag line="1540" name="return" description="query clause after keyword search addition" type="string">
754
  <type by_reference="false">string</type>
755
  </tag>
756
  </docblock>
757
- <argument line="1552">
758
  <name>$search_string</name>
759
  <default><![CDATA[]]></default>
760
  <type/>
761
  </argument>
762
- <argument line="1552">
763
  <name>$query_object</name>
764
  <default><![CDATA[]]></default>
765
  <type/>
766
  </argument>
767
  </method>
768
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1663" package="Media Library Assistant">
769
  <name>mla_query_posts_join_filter</name>
770
  <full_name>mla_query_posts_join_filter</full_name>
771
- <docblock line="1652">
772
  <description><![CDATA[Adds a JOIN clause, if required, to handle sorting/searching on custom fields or ALT Text]]></description>
773
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
774
- <tag line="1652" name="since" description="0.30"/>
775
- <tag line="1652" name="param" description="query clause before modification" type="string" variable="$join_clause">
776
  <type by_reference="false">string</type>
777
  </tag>
778
- <tag line="1652" name="return" description="query clause after &quot;LEFT JOIN view ON post_id&quot; item modification" type="string">
779
  <type by_reference="false">string</type>
780
  </tag>
781
  </docblock>
782
- <argument line="1663">
783
  <name>$join_clause</name>
784
  <default><![CDATA[]]></default>
785
  <type/>
786
  </argument>
787
  </method>
788
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1690" package="Media Library Assistant">
789
  <name>mla_query_posts_where_filter</name>
790
  <full_name>mla_query_posts_where_filter</full_name>
791
- <docblock line="1678">
792
  <description><![CDATA[Adds a WHERE clause for detached items]]></description>
793
  <long-description><![CDATA[<p>Modeled after _edit_attachments_query_helper in wp-admin/post.php.
794
  Defined as public because it's a filter.</p>]]></long-description>
795
- <tag line="1678" name="since" description="0.1"/>
796
- <tag line="1678" name="param" description="query clause before modification" type="string" variable="$where_clause">
797
  <type by_reference="false">string</type>
798
  </tag>
799
- <tag line="1678" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
800
  <type by_reference="false">string</type>
801
  </tag>
802
  </docblock>
803
- <argument line="1690">
804
  <name>$where_clause</name>
805
  <default><![CDATA[]]></default>
806
  <type/>
807
  </argument>
808
  </method>
809
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1738" package="Media Library Assistant">
810
  <name>mla_query_posts_orderby_filter</name>
811
  <full_name>mla_query_posts_orderby_filter</full_name>
812
- <docblock line="1726">
813
  <description><![CDATA[Adds a ORDERBY clause, if required]]></description>
814
  <long-description><![CDATA[<p>Expands the range of sort options because the logic in WP_Query is limited.
815
  Defined as public because it's a filter.</p>]]></long-description>
816
- <tag line="1726" name="since" description="0.30"/>
817
- <tag line="1726" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
818
  <type by_reference="false">string</type>
819
  </tag>
820
- <tag line="1726" name="return" description="updated query clause" type="string">
821
  <type by_reference="false">string</type>
822
  </tag>
823
  </docblock>
824
- <argument line="1738">
825
  <name>$orderby_clause</name>
826
  <default><![CDATA[]]></default>
827
  <type/>
828
  </argument>
829
  </method>
830
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1797" package="Media Library Assistant">
831
  <name>mla_get_attachment_by_id</name>
832
  <full_name>mla_get_attachment_by_id</full_name>
833
- <docblock line="1785">
834
  <description><![CDATA[Retrieve an Attachment array given a $post_id]]></description>
835
  <long-description><![CDATA[<p>The (associative) array will contain every field that can be found in
836
  the posts and postmeta tables, and all references to the attachment.</p>]]></long-description>
837
- <tag line="1785" name="since" description="0.1"/>
838
- <tag line="1785" name="uses" description="\global\$post" refers="\global\$post"/>
839
- <tag line="1785" name="param" description="The ID of the attachment post" type="int" variable="$post_id">
840
  <type by_reference="false">int</type>
841
  </tag>
842
- <tag line="1785" name="return" description="NULL on failure else associative array" type="NULL|array">
843
  <type by_reference="false">NULL</type>
844
  <type by_reference="false">array</type>
845
  </tag>
846
  </docblock>
847
- <argument line="1797">
848
  <name>$post_id</name>
849
  <default><![CDATA[]]></default>
850
  <type/>
851
  </argument>
852
  </method>
853
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1851" package="Media Library Assistant">
854
  <name>mla_fetch_attachment_parent_data</name>
855
  <full_name>mla_fetch_attachment_parent_data</full_name>
856
- <docblock line="1842">
857
  <description><![CDATA[Returns information about an attachment's parent, if found]]></description>
858
  <long-description><![CDATA[]]></long-description>
859
- <tag line="1842" name="since" description="0.1"/>
860
- <tag line="1842" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent_id">
861
  <type by_reference="false">int</type>
862
  </tag>
863
- <tag line="1842" name="return" description="Parent information; post_date, post_title and post_type" type="array">
864
  <type by_reference="false">array</type>
865
  </tag>
866
  </docblock>
867
- <argument line="1851">
868
  <name>$parent_id</name>
869
  <default><![CDATA[]]></default>
870
  <type/>
871
  </argument>
872
  </method>
873
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1883" package="Media Library Assistant">
874
  <name>_set_array_element</name>
875
  <full_name>_set_array_element</full_name>
876
- <docblock line="1872">
877
  <description><![CDATA[Adds or replaces the value of a key in a possibly nested array structure]]></description>
878
  <long-description><![CDATA[]]></long-description>
879
- <tag line="1872" name="since" description="1.51"/>
880
- <tag line="1872" name="param" description="key value, e.g. array1.array2.element" type="string" variable="$needle">
881
  <type by_reference="false">string</type>
882
  </tag>
883
- <tag line="1872" name="param" description="replacement value, string or array, by reference" type="mixed" variable="$value">
884
  <type by_reference="false">mixed</type>
885
  </tag>
886
- <tag line="1872" name="param" description="PHP nested arrays, by reference" type="array" variable="$haystack">
887
  <type by_reference="false">array</type>
888
  </tag>
889
- <tag line="1872" name="return" description="true if $needle element set, false if not" type="boolean">
890
  <type by_reference="false">boolean</type>
891
  </tag>
892
  </docblock>
893
- <argument line="1883">
894
  <name>$needle</name>
895
  <default><![CDATA[]]></default>
896
  <type/>
897
  </argument>
898
- <argument line="1883">
899
  <name>$value</name>
900
  <default><![CDATA[]]></default>
901
  <type/>
902
  </argument>
903
- <argument line="1883">
904
  <name>$haystack</name>
905
  <default><![CDATA[]]></default>
906
  <type/>
907
  </argument>
908
  </method>
909
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1916" package="Media Library Assistant">
910
  <name>_unset_array_element</name>
911
  <full_name>_unset_array_element</full_name>
912
- <docblock line="1906">
913
  <description><![CDATA[Deletes the value of a key in a possibly nested array structure]]></description>
914
  <long-description><![CDATA[]]></long-description>
915
- <tag line="1906" name="since" description="1.51"/>
916
- <tag line="1906" name="param" description="key value, e.g. array1.array2.element" type="string" variable="$needle">
917
  <type by_reference="false">string</type>
918
  </tag>
919
- <tag line="1906" name="param" description="PHP nested arrays, by reference" type="array" variable="$haystack">
920
  <type by_reference="false">array</type>
921
  </tag>
922
- <tag line="1906" name="return" description="true if $needle element found, false if not" type="boolean">
923
  <type by_reference="false">boolean</type>
924
  </tag>
925
  </docblock>
926
- <argument line="1916">
927
  <name>$needle</name>
928
  <default><![CDATA[]]></default>
929
  <type/>
930
  </argument>
931
- <argument line="1916">
932
  <name>$haystack</name>
933
  <default><![CDATA[]]></default>
934
  <type/>
935
  </argument>
936
  </method>
937
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1950" package="Media Library Assistant">
938
  <name>mla_find_array_element</name>
939
  <full_name>mla_find_array_element</full_name>
940
- <docblock line="1935">
941
  <description><![CDATA[Finds the value of a key in a possibly nested array structure]]></description>
942
  <long-description><![CDATA[<p>Used primarily to extract fields from the _wp_attachment_metadata custom field.
943
  Could also be used with the ID3 metadata exposed in WordPress 3.6 and later.</p>]]></long-description>
944
- <tag line="1935" name="since" description="1.30"/>
945
- <tag line="1935" name="param" description="key value, e.g. array1.array2.element" type="string" variable="$needle">
946
  <type by_reference="false">string</type>
947
  </tag>
948
- <tag line="1935" name="param" description="PHP nested arrays" type="array" variable="$haystack">
949
  <type by_reference="false">array</type>
950
  </tag>
951
- <tag line="1935" name="param" description="data option 'text'|'single'|'export'|'array'|'multi'" type="string" variable="$option">
952
  <type by_reference="false">string</type>
953
  </tag>
954
- <tag line="1935" name="param" description="keep existing values - for 'multi' option" type="boolean" variable="$keep_existing">
955
  <type by_reference="false">boolean</type>
956
  </tag>
957
- <tag line="1935" name="return" description="string or array value matching key(.key ...) or ''" type="mixed">
958
  <type by_reference="false">mixed</type>
959
  </tag>
960
  </docblock>
961
- <argument line="1950">
962
  <name>$needle</name>
963
  <default><![CDATA[]]></default>
964
  <type/>
965
  </argument>
966
- <argument line="1950">
967
  <name>$haystack</name>
968
  <default><![CDATA[]]></default>
969
  <type/>
970
  </argument>
971
- <argument line="1950">
972
  <name>$option</name>
973
  <default><![CDATA[]]></default>
974
  <type/>
975
  </argument>
976
- <argument line="1950">
977
  <name>$keep_existing</name>
978
  <default><![CDATA[false]]></default>
979
  <type/>
980
  </argument>
981
  </method>
982
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2001" package="Media Library Assistant">
983
  <name>mla_fetch_attachment_metadata</name>
984
  <full_name>mla_fetch_attachment_metadata</full_name>
985
- <docblock line="1989">
986
  <description><![CDATA[Fetch and filter meta data for an attachment]]></description>
987
  <long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
988
  are stripped out or converted to an 'mla</em>' equivalent.</p>]]></long-description>
989
- <tag line="1989" name="since" description="0.1"/>
990
- <tag line="1989" name="param" description="post ID of attachment" type="int" variable="$post_id">
991
  <type by_reference="false">int</type>
992
  </tag>
993
- <tag line="1989" name="return" description="Meta data variables" type="array">
994
  <type by_reference="false">array</type>
995
  </tag>
996
  </docblock>
997
- <argument line="2001">
998
  <name>$post_id</name>
999
  <default><![CDATA[]]></default>
1000
  <type/>
1001
  </argument>
1002
  </method>
1003
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2079" package="Media Library Assistant">
1004
  <name>mla_fetch_attachment_references</name>
1005
  <full_name>mla_fetch_attachment_references</full_name>
1006
- <docblock line="2066">
1007
  <description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
1008
  <long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
1009
  as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
1010
- <tag line="2066" name="since" description="0.1"/>
1011
- <tag line="2066" name="param" description="post ID of attachment" type="int" variable="$ID">
1012
  <type by_reference="false">int</type>
1013
  </tag>
1014
- <tag line="2066" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent">
1015
  <type by_reference="false">int</type>
1016
  </tag>
1017
- <tag line="2066" name="return" description="Reference information; see $references array comments" type="array">
1018
  <type by_reference="false">array</type>
1019
  </tag>
1020
  </docblock>
1021
- <argument line="2079">
1022
  <name>$ID</name>
1023
  <default><![CDATA[]]></default>
1024
  <type/>
1025
  </argument>
1026
- <argument line="2079">
1027
  <name>$parent</name>
1028
  <default><![CDATA[]]></default>
1029
  <type/>
1030
  </argument>
1031
  </method>
1032
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2376" package="Media Library Assistant">
1033
  <name>mla_flush_mla_galleries</name>
1034
  <full_name>mla_flush_mla_galleries</full_name>
1035
- <docblock line="2367">
1036
  <description><![CDATA[Invalidates the $mla_galleries or $galleries array and cached values]]></description>
1037
  <long-description><![CDATA[]]></long-description>
1038
- <tag line="2367" name="since" description="1.00"/>
1039
- <tag line="2367" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
1040
  <type by_reference="false">string</type>
1041
  </tag>
1042
- <tag line="2367" name="return" description="" type="void">
1043
  <type by_reference="false">void</type>
1044
  </tag>
1045
  </docblock>
1046
- <argument line="2376">
1047
  <name>$option_name</name>
1048
  <default><![CDATA[]]></default>
1049
  <type/>
1050
  </argument>
1051
  </method>
1052
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2400" package="Media Library Assistant">
1053
  <name>mla_save_post_action</name>
1054
  <full_name>mla_save_post_action</full_name>
1055
- <docblock line="2391">
1056
  <description><![CDATA[Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates]]></description>
1057
  <long-description><![CDATA[]]></long-description>
1058
- <tag line="2391" name="since" description="1.00"/>
1059
- <tag line="2391" name="param" description="ID of post/page/attachment; not used at this time" type="integer" variable="$post_id">
1060
  <type by_reference="false">integer</type>
1061
  </tag>
1062
- <tag line="2391" name="return" description="" type="void">
1063
  <type by_reference="false">void</type>
1064
  </tag>
1065
  </docblock>
1066
- <argument line="2400">
1067
  <name>$post_id</name>
1068
  <default><![CDATA[]]></default>
1069
  <type/>
1070
  </argument>
1071
  </method>
1072
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2417" package="Media Library Assistant">
1073
  <name>_build_mla_galleries</name>
1074
  <full_name>_build_mla_galleries</full_name>
1075
- <docblock line="2405">
1076
  <description><![CDATA[Builds the $mla_galleries or $galleries array]]></description>
1077
  <long-description><![CDATA[]]></long-description>
1078
- <tag line="2405" name="since" description="0.70"/>
1079
- <tag line="2405" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
1080
  <type by_reference="false">string</type>
1081
  </tag>
1082
- <tag line="2405" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
1083
  <type by_reference="false">array</type>
1084
  </tag>
1085
- <tag line="2405" name="param" description="the shortcode to be searched for and processed" type="string" variable="$shortcode">
1086
  <type by_reference="false">string</type>
1087
  </tag>
1088
- <tag line="2405" name="param" description="true to exclude revisions from the search" type="boolean" variable="$exclude_revisions">
1089
  <type by_reference="false">boolean</type>
1090
  </tag>
1091
- <tag line="2405" name="return" description="true if the galleries array is not empty" type="boolean">
1092
  <type by_reference="false">boolean</type>
1093
  </tag>
1094
  </docblock>
1095
- <argument line="2417">
1096
  <name>$option_name</name>
1097
  <default><![CDATA[]]></default>
1098
  <type/>
1099
  </argument>
1100
- <argument line="2417">
1101
  <name>$galleries_array</name>
1102
  <default><![CDATA[]]></default>
1103
  <type/>
1104
  </argument>
1105
- <argument line="2417">
1106
  <name>$shortcode</name>
1107
  <default><![CDATA[]]></default>
1108
  <type/>
1109
  </argument>
1110
- <argument line="2417">
1111
  <name>$exclude_revisions</name>
1112
  <default><![CDATA[]]></default>
1113
  <type/>
1114
  </argument>
1115
  </method>
1116
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2526" package="Media Library Assistant">
1117
  <name>_search_mla_galleries</name>
1118
  <full_name>_search_mla_galleries</full_name>
1119
- <docblock line="2515">
1120
  <description><![CDATA[Search the $mla_galleries or $galleries array]]></description>
1121
  <long-description><![CDATA[]]></long-description>
1122
- <tag line="2515" name="since" description="0.70"/>
1123
- <tag line="2515" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
1124
  <type by_reference="false">array</type>
1125
  </tag>
1126
- <tag line="2515" name="param" description="the attachment ID to be searched for and processed" type="int" variable="$attachment_id">
1127
  <type by_reference="false">int</type>
1128
  </tag>
1129
- <tag line="2515" name="return" description="All posts/pages with one or more galleries that include the attachment. The array key is the parent_post ID; each entry contains post_title and post_type." type="array">
1130
  <type by_reference="false">array</type>
1131
  </tag>
1132
  </docblock>
1133
- <argument line="2526">
1134
  <name>$galleries_array</name>
1135
  <default><![CDATA[]]></default>
1136
  <type/>
1137
  </argument>
1138
- <argument line="2526">
1139
  <name>$attachment_id</name>
1140
  <default><![CDATA[]]></default>
1141
  <type/>
1142
  </argument>
1143
  </method>
1144
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2565" package="Media Library Assistant">
1145
  <name>_parse_pdf_xref_subsection</name>
1146
  <full_name>_parse_pdf_xref_subsection</full_name>
1147
- <docblock line="2552">
1148
  <description><![CDATA[Parse a cross-reference table subsection into the array of indirect object definitions]]></description>
1149
  <long-description><![CDATA[<p>A cross-reference subsection is a sequence of 20-byte entries, each with offset and generation values.</p>]]></long-description>
1150
- <tag line="2552" name="since" description="1.50"/>
1151
- <tag line="2552" name="param" description="buffer containing the subsection" type="string" variable="$xref_section">
1152
  <type by_reference="false">string</type>
1153
  </tag>
1154
- <tag line="2552" name="param" description="offset within the buffer of the first entry" type="integer" variable="$offset">
1155
  <type by_reference="false">integer</type>
1156
  </tag>
1157
- <tag line="2552" name="param" description="number of the first object in the subsection" type="integer" variable="$object_id">
1158
  <type by_reference="false">integer</type>
1159
  </tag>
1160
- <tag line="2552" name="param" description="number of entries in the subsection" type="integer" variable="$count">
1161
  <type by_reference="false">integer</type>
1162
  </tag>
1163
- <tag line="2552" name="return" description="" type="void">
1164
  <type by_reference="false">void</type>
1165
  </tag>
1166
  </docblock>
1167
- <argument line="2565">
1168
  <name>$xref_section</name>
1169
  <default><![CDATA[]]></default>
1170
  <type/>
1171
  </argument>
1172
- <argument line="2565">
1173
  <name>$offset</name>
1174
  <default><![CDATA[]]></default>
1175
  <type/>
1176
  </argument>
1177
- <argument line="2565">
1178
  <name>$object_id</name>
1179
  <default><![CDATA[]]></default>
1180
  <type/>
1181
  </argument>
1182
- <argument line="2565">
1183
  <name>$count</name>
1184
  <default><![CDATA[]]></default>
1185
  <type/>
1186
  </argument>
1187
  </method>
1188
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2595" package="Media Library Assistant">
1189
  <name>_parse_pdf_xref_section</name>
1190
  <full_name>_parse_pdf_xref_section</full_name>
1191
- <docblock line="2584">
1192
  <description><![CDATA[Parse a cross-reference table section into the array of indirect object definitions]]></description>
1193
  <long-description><![CDATA[<p>Creates the array of indirect object offsets and lengths</p>]]></long-description>
1194
- <tag line="2584" name="since" description="1.50"/>
1195
- <tag line="2584" name="param" description="full path and file name" type="string" variable="$file_name">
1196
  <type by_reference="false">string</type>
1197
  </tag>
1198
- <tag line="2584" name="param" description="offset within the file of the xref id and count entry" type="integer" variable="$file_offset">
1199
  <type by_reference="false">integer</type>
1200
  </tag>
1201
- <tag line="2584" name="return" description="length of the section" type="integer">
1202
  <type by_reference="false">integer</type>
1203
  </tag>
1204
  </docblock>
1205
- <argument line="2595">
1206
  <name>$file_name</name>
1207
  <default><![CDATA[]]></default>
1208
  <type/>
1209
  </argument>
1210
- <argument line="2595">
1211
  <name>$file_offset</name>
1212
  <default><![CDATA[]]></default>
1213
  <type/>
1214
  </argument>
1215
  </method>
1216
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2629" package="Media Library Assistant">
1217
  <name>_parse_pdf_xref_stream</name>
1218
  <full_name>_parse_pdf_xref_stream</full_name>
1219
- <docblock line="2617">
1220
  <description><![CDATA[Parse a cross-reference steam into the array of indirect object definitions]]></description>
1221
  <long-description><![CDATA[<p>Creates the array of indirect object offsets and lengths</p>]]></long-description>
1222
- <tag line="2617" name="since" description="1.50"/>
1223
- <tag line="2617" name="param" description="full path and file name" type="string" variable="$file_name">
1224
  <type by_reference="false">string</type>
1225
  </tag>
1226
- <tag line="2617" name="param" description="offset within the file of the xref id and count entry" type="integer" variable="$file_offset">
1227
  <type by_reference="false">integer</type>
1228
  </tag>
1229
- <tag line="2617" name="param" description="&quot;/W&quot; entry, representing the size of the fields in a single entry" type="string" variable="$entry_parms_string">
1230
  <type by_reference="false">string</type>
1231
  </tag>
1232
- <tag line="2617" name="return" description="length of the stream" type="integer">
1233
  <type by_reference="false">integer</type>
1234
  </tag>
1235
  </docblock>
1236
- <argument line="2629">
1237
  <name>$file_name</name>
1238
  <default><![CDATA[]]></default>
1239
  <type/>
1240
  </argument>
1241
- <argument line="2629">
1242
  <name>$file_offset</name>
1243
  <default><![CDATA[]]></default>
1244
  <type/>
1245
  </argument>
1246
- <argument line="2629">
1247
  <name>$entry_parms_string</name>
1248
  <default><![CDATA[]]></default>
1249
  <type/>
1250
  </argument>
1251
  </method>
1252
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2703" package="Media Library Assistant">
1253
  <name>_build_pdf_indirect_objects</name>
1254
  <full_name>_build_pdf_indirect_objects</full_name>
1255
- <docblock line="2693">
1256
  <description><![CDATA[Build an array of indirect object definitions]]></description>
1257
  <long-description><![CDATA[<p>Creates the array of indirect object offsets and lengths</p>]]></long-description>
1258
- <tag line="2693" name="since" description="1.50"/>
1259
- <tag line="2693" name="param" description="The entire PDF document, passsed by reference" type="string" variable="$string">
1260
  <type by_reference="false">string</type>
1261
  </tag>
1262
- <tag line="2693" name="return" description="" type="void">
1263
  <type by_reference="false">void</type>
1264
  </tag>
1265
  </docblock>
1266
- <argument line="2703">
1267
  <name>$string</name>
1268
  <default><![CDATA[]]></default>
1269
  <type/>
1270
  </argument>
1271
  </method>
1272
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2752" package="Media Library Assistant">
1273
  <name>_find_pdf_indirect_dictionary</name>
1274
  <full_name>_find_pdf_indirect_dictionary</full_name>
1275
- <docblock line="2738">
1276
  <description><![CDATA[Find the offset, length and contents of an indirect object containing a dictionary]]></description>
1277
  <long-description><![CDATA[<p>The function searches the entire file, if necessary, to find the last/most recent copy of the object.
1278
  This is required because Adobe Acrobat does NOT increment the generation number when it reuses an object.</p>]]></long-description>
1279
- <tag line="2738" name="since" description="1.50"/>
1280
- <tag line="2738" name="param" description="full path and file name" type="string" variable="$file_name">
1281
  <type by_reference="false">string</type>
1282
  </tag>
1283
- <tag line="2738" name="param" description="The object number" type="integer" variable="$object">
1284
  <type by_reference="false">integer</type>
1285
  </tag>
1286
- <tag line="2738" name="param" description="The object generation number; default zero (0)" type="integer" variable="$generation">
1287
  <type by_reference="false">integer</type>
1288
  </tag>
1289
- <tag line="2738" name="return" description="NULL on failure else array( 'start' =&gt; offset in the file, 'length' =&gt; object length, 'content' =&gt; dictionary contents )" type="mixed">
1290
  <type by_reference="false">mixed</type>
1291
  </tag>
1292
  </docblock>
1293
- <argument line="2752">
1294
  <name>$file_name</name>
1295
  <default><![CDATA[]]></default>
1296
  <type/>
1297
  </argument>
1298
- <argument line="2752">
1299
  <name>$object</name>
1300
  <default><![CDATA[]]></default>
1301
  <type/>
1302
  </argument>
1303
- <argument line="2752">
1304
  <name>$generation</name>
1305
  <default><![CDATA[0]]></default>
1306
  <type/>
1307
  </argument>
1308
  </method>
1309
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2848" package="Media Library Assistant">
1310
  <name>_parse_iso8601_date</name>
1311
  <full_name>_parse_iso8601_date</full_name>
1312
- <docblock line="2839">
1313
  <description><![CDATA[Parse a ISO 8601 Timestamp]]></description>
1314
  <long-description><![CDATA[]]></long-description>
1315
- <tag line="2839" name="since" description="1.50"/>
1316
- <tag line="2839" name="param" description="ISO string of the form YYYY-MM-DDTHH:MM:SS-HH:MM (inc time zone)" type="string" variable="$source_string">
1317
  <type by_reference="false">string</type>
1318
  </tag>
1319
- <tag line="2839" name="return" description="formatted date string YYYY-MM-DD HH:mm:SS" type="string">
1320
  <type by_reference="false">string</type>
1321
  </tag>
1322
  </docblock>
1323
- <argument line="2848">
1324
  <name>$source_string</name>
1325
  <default><![CDATA[]]></default>
1326
  <type/>
1327
  </argument>
1328
  </method>
1329
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2870" package="Media Library Assistant">
1330
  <name>_parse_pdf_date</name>
1331
  <full_name>_parse_pdf_date</full_name>
1332
- <docblock line="2861">
1333
  <description><![CDATA[Parse a PDF date string]]></description>
1334
  <long-description><![CDATA[]]></long-description>
1335
- <tag line="2861" name="since" description="1.50"/>
1336
- <tag line="2861" name="param" description="PDF date string of the form D:YYYYMMDDHHmmSSOHH'mm" type="string" variable="$source_string">
1337
  <type by_reference="false">string</type>
1338
  </tag>
1339
- <tag line="2861" name="return" description="formatted date string YYYY-MM-DD HH:mm:SS" type="string">
1340
  <type by_reference="false">string</type>
1341
  </tag>
1342
  </docblock>
1343
- <argument line="2870">
1344
  <name>$source_string</name>
1345
  <default><![CDATA[]]></default>
1346
  <type/>
1347
  </argument>
1348
  </method>
1349
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2892" package="Media Library Assistant">
1350
  <name>_parse_pdf_UTF16BE</name>
1351
  <full_name>_parse_pdf_UTF16BE</full_name>
1352
- <docblock line="2883">
1353
  <description><![CDATA[Parse a PDF Unicode (16-bit Big Endian) object]]></description>
1354
  <long-description><![CDATA[]]></long-description>
1355
- <tag line="2883" name="since" description="1.50"/>
1356
- <tag line="2883" name="param" description="PDF string of 16-bit characters" type="string" variable="$source_string">
1357
  <type by_reference="false">string</type>
1358
  </tag>
1359
- <tag line="2883" name="return" description="UTF-8 encoded string" type="string">
1360
  <type by_reference="false">string</type>
1361
  </tag>
1362
  </docblock>
1363
- <argument line="2892">
1364
  <name>$source_string</name>
1365
  <default><![CDATA[]]></default>
1366
  <type/>
1367
  </argument>
1368
  </method>
1369
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2921" package="Media Library Assistant">
1370
  <name>_parse_pdf_string</name>
1371
  <full_name>_parse_pdf_string</full_name>
1372
- <docblock line="2908">
1373
  <description><![CDATA[Parse a PDF string object]]></description>
1374
  <long-description><![CDATA[<p>Returns an array with one dictionary entry. The array also has a '/length' element containing
1375
  the number of bytes occupied by the string in the source string, including the enclosing parentheses.</p>]]></long-description>
1376
- <tag line="2908" name="since" description="1.50"/>
1377
- <tag line="2908" name="param" description="data within which the string occurs" type="string" variable="$source_string">
1378
  <type by_reference="false">string</type>
1379
  </tag>
1380
- <tag line="2908" name="param" description="offset within the source string of the opening '(' character." type="integer" variable="$offset">
1381
  <type by_reference="false">integer</type>
1382
  </tag>
1383
- <tag line="2908" name="return" description="( key =&gt; array( 'type' =&gt; type, 'value' =&gt; value, '/length' =&gt; length ) ) for the string" type="array">
1384
  <type by_reference="false">array</type>
1385
  </tag>
1386
  </docblock>
1387
- <argument line="2921">
1388
  <name>$source_string</name>
1389
  <default><![CDATA[]]></default>
1390
  <type/>
1391
  </argument>
1392
- <argument line="2921">
1393
  <name>$offset</name>
1394
  <default><![CDATA[]]></default>
1395
  <type/>
1396
  </argument>
1397
  </method>
1398
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3009" package="Media Library Assistant">
1399
  <name>_parse_pdf_LPD_dictionary</name>
1400
  <full_name>_parse_pdf_LPD_dictionary</full_name>
1401
- <docblock line="2995">
1402
  <description><![CDATA[Parse a PDF Linearization Parameter Dictionary object]]></description>
1403
  <long-description><![CDATA[<p>Returns an array of dictionary contents, classified by object type: boolean, numeric, string, hex (string),
1404
  indirect (object), name, array, dictionary, stream, and null.
1405
  The array also has a '/length' element containing the number of bytes occupied by the
1406
  dictionary in the source string, excluding the enclosing delimiters, if passed in.</p>]]></long-description>
1407
- <tag line="2995" name="since" description="1.50"/>
1408
- <tag line="2995" name="param" description="data within which the object occurs, typically the start of a PDF document" type="string" variable="$source_string">
1409
  <type by_reference="false">string</type>
1410
  </tag>
1411
- <tag line="2995" name="param" description="filesize of the PDF document, for validation purposes, or zero (0) to ignore filesize" type="integer" variable="$filesize">
1412
  <type by_reference="false">integer</type>
1413
  </tag>
1414
- <tag line="2995" name="return" description="array of dictionary objects on success, false on failure" type="mixed">
1415
  <type by_reference="false">mixed</type>
1416
  </tag>
1417
  </docblock>
1418
- <argument line="3009">
1419
  <name>$source_string</name>
1420
  <default><![CDATA[]]></default>
1421
  <type/>
1422
  </argument>
1423
- <argument line="3009">
1424
  <name>$filesize</name>
1425
  <default><![CDATA[]]></default>
1426
  <type/>
1427
  </argument>
1428
  </method>
1429
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3033" package="Media Library Assistant">
1430
  <name>_parse_pdf_dictionary</name>
1431
  <full_name>_parse_pdf_dictionary</full_name>
1432
- <docblock line="3019">
1433
  <description><![CDATA[Parse a PDF dictionary object]]></description>
1434
  <long-description><![CDATA[<p>Returns an array of dictionary contents, classified by object type: boolean, numeric, string, hex (string),
1435
  indirect (object), name, array, dictionary, stream, and null.
1436
  The array also has a '/length' element containing the number of bytes occupied by the
1437
  dictionary in the source string, excluding the enclosing delimiters.</p>]]></long-description>
1438
- <tag line="3019" name="since" description="1.50"/>
1439
- <tag line="3019" name="param" description="data within which the string occurs" type="string" variable="$source_string">
1440
  <type by_reference="false">string</type>
1441
  </tag>
1442
- <tag line="3019" name="param" description="offset within the source string of the opening '&lt;&lt;' characters or the first content character." type="integer" variable="$offset">
1443
  <type by_reference="false">integer</type>
1444
  </tag>
1445
- <tag line="3019" name="return" description="( '/length' =&gt; length, key =&gt; array( 'type' =&gt; type, 'value' =&gt; value ) ) for each dictionary field" type="array">
1446
  <type by_reference="false">array</type>
1447
  </tag>
1448
  </docblock>
1449
- <argument line="3033">
1450
  <name>$source_string</name>
1451
  <default><![CDATA[]]></default>
1452
  <type/>
1453
  </argument>
1454
- <argument line="3033">
1455
  <name>$offset</name>
1456
  <default><![CDATA[]]></default>
1457
  <type/>
1458
  </argument>
1459
  </method>
1460
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3167" package="Media Library Assistant">
1461
  <name>_parse_xmp_metadata</name>
1462
  <full_name>_parse_xmp_metadata</full_name>
1463
- <docblock line="3153">
1464
  <description><![CDATA[Parse an XMP object]]></description>
1465
  <long-description><![CDATA[<p>Returns an array of dictionary contents, classified by object type: boolean, numeric, string, hex (string),
1466
  indirect (object), name, array, dictionary, stream, and null.
1467
  The array also has a '/length' element containing the number of bytes occupied by the
1468
  dictionary in the source string, excluding the enclosing delimiters, if passed in.</p>]]></long-description>
1469
- <tag line="3153" name="since" description="1.50"/>
1470
- <tag line="3153" name="param" description="full path and file name" type="string" variable="$file_name">
1471
  <type by_reference="false">string</type>
1472
  </tag>
1473
- <tag line="3153" name="param" description="offset within the file of the search start point" type="integer" variable="$file_offset">
1474
  <type by_reference="false">integer</type>
1475
  </tag>
1476
- <tag line="3153" name="return" description="array of metadata values or NULL on failure" type="mixed">
1477
  <type by_reference="false">mixed</type>
1478
  </tag>
1479
  </docblock>
1480
- <argument line="3167">
1481
  <name>$file_name</name>
1482
  <default><![CDATA[]]></default>
1483
  <type/>
1484
  </argument>
1485
- <argument line="3167">
1486
  <name>$file_offset</name>
1487
  <default><![CDATA[]]></default>
1488
  <type/>
1489
  </argument>
1490
  </method>
1491
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3435" package="Media Library Assistant">
1492
  <name>_extract_pdf_trailer</name>
1493
  <full_name>_extract_pdf_trailer</full_name>
1494
- <docblock line="3425">
1495
  <description><![CDATA[Extract dictionary from traditional cross-reference + trailer documents]]></description>
1496
  <long-description><![CDATA[]]></long-description>
1497
- <tag line="3425" name="since" description="1.50"/>
1498
- <tag line="3425" name="param" description="full path to the desired file" type="string" variable="$file_name">
1499
  <type by_reference="false">string</type>
1500
  </tag>
1501
- <tag line="3425" name="param" description="offset within file of the cross-reference table" type="integer" variable="$file_offset">
1502
  <type by_reference="false">integer</type>
1503
  </tag>
1504
- <tag line="3425" name="return" description="array of &quot;PDF dictionary arrays&quot;, newest first, or NULL on failure" type="mixed">
1505
  <type by_reference="false">mixed</type>
1506
  </tag>
1507
  </docblock>
1508
- <argument line="3435">
1509
  <name>$file_name</name>
1510
  <default><![CDATA[]]></default>
1511
  <type/>
1512
  </argument>
1513
- <argument line="3435">
1514
  <name>$file_offset</name>
1515
  <default><![CDATA[]]></default>
1516
  <type/>
1517
  </argument>
1518
  </method>
1519
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3519" package="Media Library Assistant">
1520
  <name>_extract_pdf_metadata</name>
1521
  <full_name>_extract_pdf_metadata</full_name>
1522
- <docblock line="3510">
1523
  <description><![CDATA[Extract Metadata from a PDF file]]></description>
1524
  <long-description><![CDATA[]]></long-description>
1525
- <tag line="3510" name="since" description="1.50"/>
1526
- <tag line="3510" name="param" description="full path to the desired file" type="string" variable="$file_name">
1527
  <type by_reference="false">string</type>
1528
  </tag>
1529
- <tag line="3510" name="return" description="( key =&gt; value ) for each metadata field, in string format" type="array">
1530
  <type by_reference="false">array</type>
1531
  </tag>
1532
  </docblock>
1533
- <argument line="3519">
1534
  <name>$file_name</name>
1535
  <default><![CDATA[]]></default>
1536
  <type/>
1537
  </argument>
1538
  </method>
1539
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3646" package="Media Library Assistant">
1540
  <name>_bin_to_utf8</name>
1541
  <full_name>_bin_to_utf8</full_name>
1542
- <docblock line="3637">
1543
  <description><![CDATA[Replace SQL incorrect characters (0x80 - 0xFF) with their UTF-8 equivalents]]></description>
1544
  <long-description><![CDATA[]]></long-description>
1545
- <tag line="3637" name="since" description="1.41"/>
1546
- <tag line="3637" name="param" description="unencoded string" type="string" variable="$string">
1547
  <type by_reference="false">string</type>
1548
  </tag>
1549
- <tag line="3637" name="return" description="UTF-8 encoded string" type="string">
1550
  <type by_reference="false">string</type>
1551
  </tag>
1552
  </docblock>
1553
- <argument line="3646">
1554
  <name>$string</name>
1555
  <default><![CDATA[]]></default>
1556
  <type/>
1557
  </argument>
1558
  </method>
1559
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4042" package="Media Library Assistant">
1560
  <name>mla_iptc_metadata_value</name>
1561
  <full_name>mla_iptc_metadata_value</full_name>
1562
- <docblock line="4032">
1563
  <description><![CDATA[Parse one IPTC metadata field]]></description>
1564
  <long-description><![CDATA[]]></long-description>
1565
- <tag line="4032" name="since" description="1.41"/>
1566
- <tag line="4032" name="param" description="field name - IPTC Identifier or friendly name/slug" type="string" variable="$iptc_key">
1567
  <type by_reference="false">string</type>
1568
  </tag>
1569
- <tag line="4032" name="param" description="metadata array containing iptc, exif, and pdf metadata arrays" type="string" variable="$item_metadata">
1570
  <type by_reference="false">string</type>
1571
  </tag>
1572
- <tag line="4032" name="return" description="string/array representation of metadata value or an empty string" type="mixed">
1573
  <type by_reference="false">mixed</type>
1574
  </tag>
1575
  </docblock>
1576
- <argument line="4042">
1577
  <name>$iptc_key</name>
1578
  <default><![CDATA[]]></default>
1579
  <type/>
1580
  </argument>
1581
- <argument line="4042">
1582
  <name>$item_metadata</name>
1583
  <default><![CDATA[]]></default>
1584
  <type/>
1585
  </argument>
1586
  </method>
1587
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4074" package="Media Library Assistant">
1588
  <name>mla_exif_metadata_value</name>
1589
  <full_name>mla_exif_metadata_value</full_name>
1590
- <docblock line="4062">
1591
  <description><![CDATA[Parse one EXIF metadata field]]></description>
1592
  <long-description><![CDATA[<p>Also handles the special pseudo-values 'ALL_EXIF' and 'ALL_IPTC'.</p>]]></long-description>
1593
- <tag line="4062" name="since" description="1.13"/>
1594
- <tag line="4062" name="param" description="field name" type="string" variable="$exif_key">
1595
  <type by_reference="false">string</type>
1596
  </tag>
1597
- <tag line="4062" name="param" description="metadata array containing iptc, exif, and pdf metadata arrays" type="string" variable="$item_metadata">
1598
  <type by_reference="false">string</type>
1599
  </tag>
1600
- <tag line="4062" name="return" description="string/array representation of metadata value or an empty string" type="mixed">
1601
  <type by_reference="false">mixed</type>
1602
  </tag>
1603
  </docblock>
1604
- <argument line="4074">
1605
  <name>$exif_key</name>
1606
  <default><![CDATA[]]></default>
1607
  <type/>
1608
  </argument>
1609
- <argument line="4074">
1610
  <name>$item_metadata</name>
1611
  <default><![CDATA[]]></default>
1612
  <type/>
1613
  </argument>
1614
  </method>
1615
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4133" package="Media Library Assistant">
1616
  <name>mla_pdf_metadata_value</name>
1617
  <full_name>mla_pdf_metadata_value</full_name>
1618
- <docblock line="4121">
1619
  <description><![CDATA[Parse one PDF metadata field]]></description>
1620
  <long-description><![CDATA[<p>Also handles the special pseudo-value 'ALL_PDF'.</p>]]></long-description>
1621
- <tag line="4121" name="since" description="1.50"/>
1622
- <tag line="4121" name="param" description="field name" type="string" variable="$pdf_key">
1623
  <type by_reference="false">string</type>
1624
  </tag>
1625
- <tag line="4121" name="param" description="metadata array containing iptc, exif, and pdf metadata arrays" type="string" variable="$item_metadata">
1626
  <type by_reference="false">string</type>
1627
  </tag>
1628
- <tag line="4121" name="return" description="string/array representation of metadata value or an empty string" type="mixed">
1629
  <type by_reference="false">mixed</type>
1630
  </tag>
1631
  </docblock>
1632
- <argument line="4133">
1633
  <name>$pdf_key</name>
1634
  <default><![CDATA[]]></default>
1635
  <type/>
1636
  </argument>
1637
- <argument line="4133">
1638
  <name>$item_metadata</name>
1639
  <default><![CDATA[]]></default>
1640
  <type/>
1641
  </argument>
1642
  </method>
1643
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="4173" package="Media Library Assistant">
1644
  <name>_rational_to_decimal</name>
1645
  <full_name>_rational_to_decimal</full_name>
1646
- <docblock line="4164">
1647
  <description><![CDATA[Convert an EXIF GPS rational value to a PHP float value]]></description>
1648
  <long-description><![CDATA[]]></long-description>
1649
- <tag line="4164" name="since" description="1.50"/>
1650
- <tag line="4164" name="param" description="array( 0 =&gt; numerator, 1 =&gt; denominator )" type="array" variable="$rational">
1651
  <type by_reference="false">array</type>
1652
  </tag>
1653
- <tag line="4164" name="return" description="numerator/denominator" type="float">
1654
  <type by_reference="false">float</type>
1655
  </tag>
1656
  </docblock>
1657
- <argument line="4173">
1658
  <name>$rational</name>
1659
  <default><![CDATA[]]></default>
1660
  <type/>
1661
  </argument>
1662
  </method>
1663
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4188" package="Media Library Assistant">
1664
  <name>mla_fetch_attachment_image_metadata</name>
1665
  <full_name>mla_fetch_attachment_image_metadata</full_name>
1666
- <docblock line="4178">
1667
  <description><![CDATA[Fetch and filter IPTC and EXIF or PDF metadata for an image attachment]]></description>
1668
  <long-description><![CDATA[]]></long-description>
1669
- <tag line="4178" name="since" description="0.90"/>
1670
- <tag line="4178" name="param" description="post ID of attachment" type="int" variable="$post_id">
1671
  <type by_reference="false">int</type>
1672
  </tag>
1673
- <tag line="4178" name="param" description="optional; if $post_id is zero, path to the image file." type="string" variable="$path">
1674
  <type by_reference="false">string</type>
1675
  </tag>
1676
- <tag line="4178" name="return" description="Meta data variables, IPTC and EXIF or PDF" type="array">
1677
  <type by_reference="false">array</type>
1678
  </tag>
1679
  </docblock>
1680
- <argument line="4188">
1681
  <name>$post_id</name>
1682
  <default><![CDATA[]]></default>
1683
  <type/>
1684
  </argument>
1685
- <argument line="4188">
1686
  <name>$path</name>
1687
  <default><![CDATA['']]></default>
1688
  <type/>
1689
  </argument>
1690
  </method>
1691
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="4361" package="Media Library Assistant">
1692
  <name>_update_wp_attachment_metadata</name>
1693
  <full_name>_update_wp_attachment_metadata</full_name>
1694
- <docblock line="4351">
1695
  <description><![CDATA[Update one "meta:" data for a single attachment]]></description>
1696
  <long-description><![CDATA[]]></long-description>
1697
- <tag line="4351" name="since" description="1.51"/>
1698
- <tag line="4351" name="param" description="The current wp_attachment_metadata value" type="array" variable="$current_values">
1699
  <type by_reference="false">array</type>
1700
  </tag>
1701
- <tag line="4351" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_meta">
1702
  <type by_reference="false">array</type>
1703
  </tag>
1704
- <tag line="4351" name="return" description="success/failure message(s); empty string if no changes." type="string">
1705
  <type by_reference="false">string</type>
1706
  </tag>
1707
  </docblock>
1708
- <argument line="4361">
1709
  <name>$current_values</name>
1710
  <default><![CDATA[]]></default>
1711
  <type/>
1712
  </argument>
1713
- <argument line="4361">
1714
  <name>$new_meta</name>
1715
  <default><![CDATA[]]></default>
1716
  <type/>
1717
  </argument>
1718
  </method>
1719
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4433" package="Media Library Assistant">
1720
  <name>mla_update_item_postmeta</name>
1721
  <full_name>mla_update_item_postmeta</full_name>
1722
- <docblock line="4423">
1723
  <description><![CDATA[Update custom field and "meta:" data for a single attachment]]></description>
1724
  <long-description><![CDATA[]]></long-description>
1725
- <tag line="4423" name="since" description="1.40"/>
1726
- <tag line="4423" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
1727
  <type by_reference="false">int</type>
1728
  </tag>
1729
- <tag line="4423" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_meta">
1730
  <type by_reference="false">array</type>
1731
  </tag>
1732
- <tag line="4423" name="return" description="success/failure message(s)" type="string">
1733
  <type by_reference="false">string</type>
1734
  </tag>
1735
  </docblock>
1736
- <argument line="4433">
1737
  <name>$post_id</name>
1738
  <default><![CDATA[]]></default>
1739
  <type/>
1740
  </argument>
1741
- <argument line="4433">
1742
  <name>$new_meta</name>
1743
  <default><![CDATA[]]></default>
1744
  <type/>
1745
  </argument>
1746
  </method>
1747
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4580" package="Media Library Assistant">
1748
  <name>mla_update_single_item</name>
1749
  <full_name>mla_update_single_item</full_name>
1750
- <docblock line="4567">
1751
  <description><![CDATA[Update a single item; change the "post" data, taxonomy terms
1752
  and meta data for a single attachment]]></description>
1753
  <long-description><![CDATA[]]></long-description>
1754
- <tag line="4567" name="since" description="0.1"/>
1755
- <tag line="4567" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
1756
  <type by_reference="false">int</type>
1757
  </tag>
1758
- <tag line="4567" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_data">
1759
  <type by_reference="false">array</type>
1760
  </tag>
1761
- <tag line="4567" name="param" description="Optional taxonomy term values, default null" type="array" variable="$tax_input">
1762
  <type by_reference="false">array</type>
1763
  </tag>
1764
- <tag line="4567" name="param" description="Optional taxonomy actions (add, remove, replace), default null" type="array" variable="$tax_actions">
1765
  <type by_reference="false">array</type>
1766
  </tag>
1767
- <tag line="4567" name="return" description="success/failure message and NULL content" type="array">
1768
  <type by_reference="false">array</type>
1769
  </tag>
1770
  </docblock>
1771
- <argument line="4580">
1772
  <name>$post_id</name>
1773
  <default><![CDATA[]]></default>
1774
  <type/>
1775
  </argument>
1776
- <argument line="4580">
1777
  <name>$new_data</name>
1778
  <default><![CDATA[]]></default>
1779
  <type/>
1780
  </argument>
1781
- <argument line="4580">
1782
  <name>$tax_input</name>
1783
  <default><![CDATA[NULL]]></default>
1784
  <type/>
1785
  </argument>
1786
- <argument line="4580">
1787
  <name>$tax_actions</name>
1788
  <default><![CDATA[NULL]]></default>
1789
  <type/>
1790
  </argument>
1791
  </method>
1792
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="4793" package="Media Library Assistant">
1793
  <name>_remove_tags</name>
1794
  <full_name>_remove_tags</full_name>
1795
- <docblock line="4782">
1796
  <description><![CDATA[Remove tags from a term ids list]]></description>
1797
  <long-description><![CDATA[]]></long-description>
1798
- <tag line="4782" name="since" description="0.40"/>
1799
- <tag line="4782" name="param" description="The term ids currently assigned" type="array" variable="$terms_before">
1800
  <type by_reference="false">array</type>
1801
  </tag>
1802
- <tag line="4782" name="param" description="| string The term ids (array) or names (string) to remove" type="array" variable="$tags">
1803
  <type by_reference="false">array</type>
1804
  </tag>
1805
- <tag line="4782" name="param" description="The taxonomy object" type="object" variable="$taxonomy_obj">
1806
  <type by_reference="false">object</type>
1807
  </tag>
1808
- <tag line="4782" name="return" description="Term ids of the surviving tags" type="array">
1809
  <type by_reference="false">array</type>
1810
  </tag>
1811
  </docblock>
1812
- <argument line="4793">
1813
  <name>$terms_before</name>
1814
  <default><![CDATA[]]></default>
1815
  <type/>
1816
  </argument>
1817
- <argument line="4793">
1818
  <name>$tags</name>
1819
  <default><![CDATA[]]></default>
1820
  <type/>
1821
  </argument>
1822
- <argument line="4793">
1823
  <name>$taxonomy_obj</name>
1824
  <default><![CDATA[]]></default>
1825
  <type/>
1826
  </argument>
1827
  </method>
1828
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="4837" package="Media Library Assistant">
1829
  <name>_hex_dump</name>
1830
  <full_name>_hex_dump</full_name>
1831
- <docblock line="4825">
1832
  <description><![CDATA[Format printable version of binary data]]></description>
1833
  <long-description><![CDATA[]]></long-description>
1834
- <tag line="4825" name="since" description="0.90"/>
1835
- <tag line="4825" name="param" description="Binary data" type="string" variable="$data">
1836
  <type by_reference="false">string</type>
1837
  </tag>
1838
- <tag line="4825" name="param" description="Bytes to format, default = 0 (all bytes)" type="integer" variable="$limit">
1839
  <type by_reference="false">integer</type>
1840
  </tag>
1841
- <tag line="4825" name="param" description="Bytes to format on each line" type="\intger" variable="$bytes_per_row">
1842
  <type by_reference="false">\intger</type>
1843
  </tag>
1844
- <tag line="4825" name="param" description="offset of initial byte, or -1 to suppress printing offset information" type="integer" variable="$offset">
1845
  <type by_reference="false">integer</type>
1846
  </tag>
1847
- <tag line="4825" name="return" description="Printable representation of $data" type="string">
1848
  <type by_reference="false">string</type>
1849
  </tag>
1850
  </docblock>
1851
- <argument line="4837">
1852
  <name>$data</name>
1853
  <default><![CDATA[]]></default>
1854
  <type/>
1855
  </argument>
1856
- <argument line="4837">
1857
  <name>$limit</name>
1858
  <default><![CDATA[0]]></default>
1859
  <type/>
1860
  </argument>
1861
- <argument line="4837">
1862
  <name>$bytes_per_row</name>
1863
  <default><![CDATA[16]]></default>
1864
  <type/>
1865
  </argument>
1866
- <argument line="4837">
1867
  <name>$offset</name>
1868
  <default><![CDATA[-1]]></default>
1869
  <type/>
@@ -1871,7 +1891,7 @@ and meta data for a single attachment]]></description>
1871
  </method>
1872
  </class>
1873
  <markers>
1874
- <todo line="2901">encode the rest</todo>
1875
  </markers>
1876
  </file>
1877
  <file path="includes\class-mla-edit-media.php" hash="d577ae28826df9fbc9275e0e7d255780" package="Media Library Assistant">
@@ -2178,7 +2198,7 @@ The array is built once each page load and cached for subsequent calls.</p>]]></
2178
  </method>
2179
  </class>
2180
  </file>
2181
- <file path="includes\class-mla-list-table.php" hash="dde8c150dc6aa83604f579437e960e61" package="Media Library Assistant">
2182
  <docblock line="2">
2183
  <description><![CDATA[Media Library Assistant extended List Table class]]></description>
2184
  <long-description><![CDATA[]]></long-description>
@@ -2417,7 +2437,7 @@ created in time to affect the "screen options" setup.</p>]]></long-description>
2417
  <name>__construct</name>
2418
  <full_name>__construct</full_name>
2419
  <docblock line="350">
2420
- <description><![CDATA[Initializes some properties from $_REQUEST vairables, then
2421
  calls the parent constructor to set some default configs.]]></description>
2422
  <long-description><![CDATA[]]></long-description>
2423
  <tag line="350" name="since" description="0.1"/>
@@ -3152,7 +3172,7 @@ $this->set_pagination_args().</p>]]></long-description>
3152
  </method>
3153
  </class>
3154
  </file>
3155
- <file path="includes\class-mla-main.php" hash="79784bffd6778d8b898caad69d400743" package="Media Library Assistant">
3156
  <docblock line="2">
3157
  <description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
3158
  <long-description><![CDATA[]]></long-description>
@@ -3189,7 +3209,7 @@ of images and files held in the WordPress Media Library.]]></description>
3189
  <constant namespace="global" line="41" package="Media Library Assistant">
3190
  <name>CURRENT_MLA_VERSION</name>
3191
  <full_name>CURRENT_MLA_VERSION</full_name>
3192
- <value><![CDATA['1.51']]></value>
3193
  <docblock line="34">
3194
  <description><![CDATA[Current version number]]></description>
3195
  <long-description><![CDATA[]]></long-description>
@@ -3439,10 +3459,10 @@ set up the Assistant submenu.</p>]]></long-description>
3439
  <type/>
3440
  </argument>
3441
  </method>
3442
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="310" package="Media Library Assistant">
3443
  <name>mla_admin_menu_action</name>
3444
  <full_name>mla_admin_menu_action</full_name>
3445
- <docblock line="295">
3446
  <description><![CDATA[Add the submenu pages]]></description>
3447
  <long-description><![CDATA[<p>Add a submenu page in the "Media" section,
3448
  add settings page in the "Settings" section.
@@ -3451,119 +3471,131 @@ add settings link in the Plugins section entry for MLA.</p>
3451
  <p>For WordPress versions before 3.5,
3452
  add submenu page(s) for attachment taxonomies,
3453
  add filter to clean up taxonomy submenu labels.</p>]]></long-description>
3454
- <tag line="295" name="since" description="0.1"/>
3455
- <tag line="295" name="return" description="" type="void">
3456
  <type by_reference="false">void</type>
3457
  </tag>
3458
  </docblock>
3459
  </method>
3460
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="367" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
3461
  <name>mla_add_menu_options</name>
3462
  <full_name>mla_add_menu_options</full_name>
3463
- <docblock line="360">
3464
  <description><![CDATA[Add the "XX Entries per page" filter to the Screen Options tab]]></description>
3465
  <long-description><![CDATA[]]></long-description>
3466
- <tag line="360" name="since" description="0.1"/>
3467
- <tag line="360" name="return" description="" type="void">
3468
  <type by_reference="false">void</type>
3469
  </tag>
3470
  </docblock>
3471
  </method>
3472
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="386" package="Media Library Assistant">
3473
  <name>mla_add_help_tab</name>
3474
  <full_name>mla_add_help_tab</full_name>
3475
- <docblock line="379">
3476
  <description><![CDATA[Add contextual help tabs to all the MLA pages]]></description>
3477
  <long-description><![CDATA[]]></long-description>
3478
- <tag line="379" name="since" description="0.1"/>
3479
- <tag line="379" name="return" description="" type="void">
3480
  <type by_reference="false">void</type>
3481
  </tag>
3482
  </docblock>
3483
  </method>
3484
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="487" package="Media Library Assistant">
3485
  <name>mla_screen_options_show_screen_filter</name>
3486
  <full_name>mla_screen_options_show_screen_filter</full_name>
3487
- <docblock line="477">
3488
  <description><![CDATA[Only show screen options on the table-list screen]]></description>
3489
  <long-description><![CDATA[]]></long-description>
3490
- <tag line="477" name="since" description="0.1"/>
3491
- <tag line="477" name="param" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean" variable="$show_screen">
3492
  <type by_reference="false">boolean</type>
3493
  </tag>
3494
- <tag line="477" name="param" description="Name of the page being loaded" type="string" variable="$this_screen">
3495
  <type by_reference="false">string</type>
3496
  </tag>
3497
- <tag line="477" name="return" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean">
3498
  <type by_reference="false">boolean</type>
3499
  </tag>
3500
  </docblock>
3501
- <argument line="487">
3502
  <name>$show_screen</name>
3503
  <default><![CDATA[]]></default>
3504
  <type/>
3505
  </argument>
3506
- <argument line="487">
3507
  <name>$this_screen</name>
3508
  <default><![CDATA[]]></default>
3509
  <type/>
3510
  </argument>
3511
  </method>
3512
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="505" package="Media Library Assistant">
3513
  <name>mla_set_screen_option_filter</name>
3514
  <full_name>mla_set_screen_option_filter</full_name>
3515
- <docblock line="494">
3516
  <description><![CDATA[Save the "Entries per page" option set by this user]]></description>
3517
  <long-description><![CDATA[]]></long-description>
3518
- <tag line="494" name="since" description="0.1"/>
3519
- <tag line="494" name="param" description="false or value returned by previous filter" type="mixed" variable="$status">
3520
  <type by_reference="false">mixed</type>
3521
  </tag>
3522
- <tag line="494" name="param" description="Name of the option being changed" type="string" variable="$option">
3523
  <type by_reference="false">string</type>
3524
  </tag>
3525
- <tag line="494" name="param" description="New value of the option" type="string" variable="$value">
3526
  <type by_reference="false">string</type>
3527
  </tag>
3528
- <tag line="494" name="return" description="New value if this is our option, otherwise nothing" type="string|void">
3529
  <type by_reference="false">string</type>
3530
  <type by_reference="false">void</type>
3531
  </tag>
3532
  </docblock>
3533
- <argument line="505">
3534
  <name>$status</name>
3535
  <default><![CDATA[]]></default>
3536
  <type/>
3537
  </argument>
3538
- <argument line="505">
3539
  <name>$option</name>
3540
  <default><![CDATA[]]></default>
3541
  <type/>
3542
  </argument>
3543
- <argument line="505">
3544
  <name>$value</name>
3545
  <default><![CDATA[]]></default>
3546
  <type/>
3547
  </argument>
3548
  </method>
3549
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="524" package="Media Library Assistant">
3550
  <name>mla_edit_tax_redirect</name>
3551
  <full_name>mla_edit_tax_redirect</full_name>
3552
- <docblock line="513">
3553
  <description><![CDATA[Redirect to the Edit Tags/Categories page]]></description>
3554
  <long-description><![CDATA[<p>The custom taxonomy add/edit submenu entries go to "upload.php" by default.
3555
  This filter is the only way to redirect them to the correct WordPress page.
3556
  The filter is not required for WordPress 3.5 and later.</p>]]></long-description>
3557
- <tag line="513" name="since" description="0.1"/>
3558
- <tag line="513" name="return" description="" type="void">
3559
  <type by_reference="false">void</type>
3560
  </tag>
3561
  </docblock>
3562
  </method>
3563
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="557" package="Media Library Assistant">
3564
  <name>mla_parent_file_filter</name>
3565
  <full_name>mla_parent_file_filter</full_name>
3566
- <docblock line="541">
3567
  <description><![CDATA[Cleanup menus for Edit Tags/Categories page]]></description>
3568
  <long-description><![CDATA[<p>For WordPress before 3.5, the submenu entries for custom taxonomies
3569
  under the "Media" menu are not set up correctly by WordPress, so this
@@ -3571,190 +3603,190 @@ function cleans them up, redirecting the request to the right WordPress
3571
  page for editing/adding taxonomy terms.
3572
  For WordPress 3.5 and later, the function fixes the submenu bolding when
3573
  going to the Edit Media screen.</p>]]></long-description>
3574
- <tag line="541" name="since" description="0.1"/>
3575
- <tag line="541" name="param" description="The top-level menu page" type="array" variable="$parent_file">
3576
  <type by_reference="false">array</type>
3577
  </tag>
3578
- <tag line="541" name="return" description="The updated top-level menu page" type="string">
3579
  <type by_reference="false">string</type>
3580
  </tag>
3581
  </docblock>
3582
- <argument line="557">
3583
  <name>$parent_file</name>
3584
  <default><![CDATA[]]></default>
3585
  <type/>
3586
  </argument>
3587
  </method>
3588
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="610" package="Media Library Assistant">
3589
  <name>mla_render_admin_page</name>
3590
  <full_name>mla_render_admin_page</full_name>
3591
- <docblock line="603">
3592
  <description><![CDATA[Render the "Assistant" subpage in the Media section, using the list_table package]]></description>
3593
  <long-description><![CDATA[]]></long-description>
3594
- <tag line="603" name="since" description="0.1"/>
3595
- <tag line="603" name="return" description="" type="void">
3596
  <type by_reference="false">void</type>
3597
  </tag>
3598
  </docblock>
3599
  </method>
3600
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="981" package="Media Library Assistant">
3601
  <name>mla_inline_edit_action</name>
3602
  <full_name>mla_inline_edit_action</full_name>
3603
- <docblock line="972">
3604
  <description><![CDATA[Ajax handler for inline editing (quick and bulk edit)]]></description>
3605
  <long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
3606
- <tag line="972" name="since" description="0.20"/>
3607
- <tag line="972" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
3608
  <type by_reference="false">void</type>
3609
  </tag>
3610
  </docblock>
3611
  </method>
3612
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1075" package="Media Library Assistant">
3613
  <name>_build_inline_edit_form</name>
3614
  <full_name>_build_inline_edit_form</full_name>
3615
- <docblock line="1064">
3616
  <description><![CDATA[Build the hidden row templates for inline editing (quick and bulk edit)]]></description>
3617
  <long-description><![CDATA[<p>inspired by inline_edit() in wp-admin\includes\class-wp-posts-list-table.php.</p>]]></long-description>
3618
- <tag line="1064" name="since" description="0.20"/>
3619
- <tag line="1064" name="param" description="MLA List Table object" type="object" variable="$MLAListTable">
3620
  <type by_reference="false">object</type>
3621
  </tag>
3622
- <tag line="1064" name="return" description="HTML &lt;form&gt; markup for hidden rows" type="string">
3623
  <type by_reference="false">string</type>
3624
  </tag>
3625
  </docblock>
3626
- <argument line="1075">
3627
  <name>$MLAListTable</name>
3628
  <default><![CDATA[]]></default>
3629
  <type/>
3630
  </argument>
3631
  </method>
3632
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1232" package="Media Library Assistant">
3633
  <name>_authors_dropdown</name>
3634
  <full_name>_authors_dropdown</full_name>
3635
- <docblock line="1221">
3636
  <description><![CDATA[Get the edit Authors dropdown box, if user has suitable permissions]]></description>
3637
  <long-description><![CDATA[]]></long-description>
3638
- <tag line="1221" name="since" description="0.20"/>
3639
- <tag line="1221" name="param" description="Optional User ID of the current author, default 0" type="integer" variable="$author">
3640
  <type by_reference="false">integer</type>
3641
  </tag>
3642
- <tag line="1221" name="param" description="Optional HTML name attribute, default 'post_author'" type="string" variable="$name">
3643
  <type by_reference="false">string</type>
3644
  </tag>
3645
- <tag line="1221" name="param" description="Optional HTML class attribute, default 'authors'" type="string" variable="$class">
3646
  <type by_reference="false">string</type>
3647
  </tag>
3648
- <tag line="1221" name="return" description="HTML markup for the dropdown field or False" type="string|false">
3649
  <type by_reference="false">string</type>
3650
  <type by_reference="false">false</type>
3651
  </tag>
3652
  </docblock>
3653
- <argument line="1232">
3654
  <name>$author</name>
3655
  <default><![CDATA[0]]></default>
3656
  <type/>
3657
  </argument>
3658
- <argument line="1232">
3659
  <name>$name</name>
3660
  <default><![CDATA['post_author']]></default>
3661
  <type/>
3662
  </argument>
3663
- <argument line="1232">
3664
  <name>$class</name>
3665
  <default><![CDATA['authors']]></default>
3666
  <type/>
3667
  </argument>
3668
  </method>
3669
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1266" package="Media Library Assistant">
3670
  <name>_current_bulk_action</name>
3671
  <full_name>_current_bulk_action</full_name>
3672
- <docblock line="1259">
3673
  <description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
3674
  <long-description><![CDATA[]]></long-description>
3675
- <tag line="1259" name="since" description="0.1"/>
3676
- <tag line="1259" name="return" description="The action name or False if no action was selected" type="string|false">
3677
  <type by_reference="false">string</type>
3678
  <type by_reference="false">false</type>
3679
  </tag>
3680
  </docblock>
3681
  </method>
3682
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1295" package="Media Library Assistant">
3683
  <name>_delete_single_item</name>
3684
  <full_name>_delete_single_item</full_name>
3685
- <docblock line="1286">
3686
  <description><![CDATA[Delete a single item permanently]]></description>
3687
  <long-description><![CDATA[]]></long-description>
3688
- <tag line="1286" name="since" description="0.1"/>
3689
- <tag line="1286" name="param" description="The form POST data" type="array" variable="$post_id">
3690
  <type by_reference="false">array</type>
3691
  </tag>
3692
- <tag line="1286" name="return" description="success/failure message and NULL content" type="array">
3693
  <type by_reference="false">array</type>
3694
  </tag>
3695
  </docblock>
3696
- <argument line="1295">
3697
  <name>$post_id</name>
3698
  <default><![CDATA[]]></default>
3699
  <type/>
3700
  </argument>
3701
  </method>
3702
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1326" package="Media Library Assistant">
3703
  <name>_display_single_item</name>
3704
  <full_name>_display_single_item</full_name>
3705
- <docblock line="1314">
3706
  <description><![CDATA[Display a single item sub page; prepare the form to
3707
  change the meta data for a single attachment.]]></description>
3708
  <long-description><![CDATA[<p>This function is not used in WordPress 3.5 and later.</p>]]></long-description>
3709
- <tag line="1314" name="since" description="0.1"/>
3710
- <tag line="1314" name="param" description="The WordPress Post ID of the attachment item" type="int" variable="$post_id">
3711
  <type by_reference="false">int</type>
3712
  </tag>
3713
- <tag line="1314" name="return" description="message and/or HTML content" type="array">
3714
  <type by_reference="false">array</type>
3715
  </tag>
3716
  </docblock>
3717
- <argument line="1326">
3718
  <name>$post_id</name>
3719
  <default><![CDATA[]]></default>
3720
  <type/>
3721
  </argument>
3722
  </method>
3723
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1566" package="Media Library Assistant">
3724
  <name>_restore_single_item</name>
3725
  <full_name>_restore_single_item</full_name>
3726
- <docblock line="1557">
3727
  <description><![CDATA[Restore a single item from the Trash]]></description>
3728
  <long-description><![CDATA[]]></long-description>
3729
- <tag line="1557" name="since" description="0.1"/>
3730
- <tag line="1557" name="param" description="The form POST data" type="array" variable="$post_id">
3731
  <type by_reference="false">array</type>
3732
  </tag>
3733
- <tag line="1557" name="return" description="success/failure message and NULL content" type="array">
3734
  <type by_reference="false">array</type>
3735
  </tag>
3736
  </docblock>
3737
- <argument line="1566">
3738
  <name>$post_id</name>
3739
  <default><![CDATA[]]></default>
3740
  <type/>
3741
  </argument>
3742
  </method>
3743
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1602" package="Media Library Assistant">
3744
  <name>_trash_single_item</name>
3745
  <full_name>_trash_single_item</full_name>
3746
- <docblock line="1593">
3747
  <description><![CDATA[Move a single item to Trash]]></description>
3748
  <long-description><![CDATA[]]></long-description>
3749
- <tag line="1593" name="since" description="0.1"/>
3750
- <tag line="1593" name="param" description="The form POST data" type="array" variable="$post_id">
3751
  <type by_reference="false">array</type>
3752
  </tag>
3753
- <tag line="1593" name="return" description="success/failure message and NULL content" type="array">
3754
  <type by_reference="false">array</type>
3755
  </tag>
3756
  </docblock>
3757
- <argument line="1602">
3758
  <name>$post_id</name>
3759
  <default><![CDATA[]]></default>
3760
  <type/>
@@ -3762,7 +3794,7 @@ change the meta data for a single attachment.]]></description>
3762
  </method>
3763
  </class>
3764
  </file>
3765
- <file path="includes\class-mla-media-modal.php" hash="bdb162db5b8d77c403b9d74cf01bbcfc" package="Media Library Assistant">
3766
  <docblock line="2">
3767
  <description><![CDATA[Media Library Assistant Media Manager enhancements]]></description>
3768
  <long-description><![CDATA[]]></long-description>
@@ -3843,7 +3875,7 @@ and mla_print_media_templates_action]]></description>
3843
  </tag>
3844
  </docblock>
3845
  </method>
3846
- <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="87" package="Media Library Assistant">
3847
  <name>_months_dropdown</name>
3848
  <full_name>_months_dropdown</full_name>
3849
  <docblock line="76">
@@ -3863,7 +3895,7 @@ and mla_print_media_templates_action]]></description>
3863
  <type/>
3864
  </argument>
3865
  </method>
3866
- <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="126" package="Media Library Assistant">
3867
  <name>_terms_options</name>
3868
  <full_name>_terms_options</full_name>
3869
  <docblock line="117">
@@ -5215,9 +5247,9 @@ Defined as public because it's a filter.</p>]]></long-description>
5215
  </method>
5216
  </class>
5217
  </file>
5218
- <file path="includes\class-mla-objects.php" hash="f9722ede4bbbf4aa3061a18150e5ac46" package="Media Library Assistant">
5219
  <docblock line="2">
5220
- <description><![CDATA[Media Library Assistant Custom Taxonomy objects]]></description>
5221
  <long-description><![CDATA[]]></long-description>
5222
  <tag line="2" name="package" description="Media Library Assistant"/>
5223
  <tag line="2" name="since" description="0.1"/>
@@ -5315,8 +5347,140 @@ which returns a count of the attachments assigned a given term]]></description>
5315
  </argument>
5316
  </method>
5317
  </class>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
5318
  </file>
5319
- <file path="includes\class-mla-options.php" hash="9a254b54127133776d478df45a0d2910" package="Media Library Assistant">
5320
  <docblock line="2">
5321
  <description><![CDATA[Manages the plugin option settings]]></description>
5322
  <long-description><![CDATA[]]></long-description>
@@ -5683,7 +5847,7 @@ This option is for flat taxonomies, e.g., "Att.]]></description>
5683
  </property>
5684
  <property final="false" static="true" visibility="public" line="255" namespace="global" package="Media Library Assistant">
5685
  <name>$mla_option_definitions</name>
5686
- <default><![CDATA[array(self::MLA_VERSION_OPTION => array('tab' => '', 'type' => 'hidden', 'std' => '0'), 'attachment_category' => array('tab' => '', 'name' => 'Attachment Categories', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to add support for Attachment Categories.'), 'attachment_tag' => array('tab' => '', 'name' => 'Attachment Tags', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to add support for Attachment Tags.'), 'where_used_header' => array('tab' => 'general', 'name' => 'Where-used Reporting', 'type' => 'header'), self::MLA_EXCLUDE_REVISIONS => array('tab' => 'general', 'name' => 'Exclude Revisions', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to exclude revisions from where-used reporting.'), 'where_used_subheader' => array('tab' => 'general', 'name' => 'Where-used database access tuning', 'type' => 'subheader'), self::MLA_FEATURED_IN_TUNING => array('tab' => 'general', 'name' => 'Featured in', 'type' => 'select', 'std' => 'enabled', 'options' => array('enabled', 'disabled'), 'texts' => array('Enabled', 'Disabled'), 'help' => 'Search database posts and pages for Featured Image attachments.'), self::MLA_INSERTED_IN_TUNING => array('tab' => 'general', 'name' => 'Inserted in', 'type' => 'select', 'std' => 'base', 'options' => array('enabled', 'base', 'disabled'), 'texts' => array('Enabled', 'Base', 'Disabled'), 'help' => 'Search database posts and pages for attachments embedded in content.<br>&nbsp;&nbsp;Base = ignore intermediate size suffixes; use path, base name and extension only.'), self::MLA_GALLERY_IN_TUNING => array('tab' => 'general', 'name' => 'Gallery in', 'type' => 'select', 'std' => 'cached', 'options' => array('dynamic', 'refresh', 'cached', 'disabled'), 'texts' => array('Dynamic', 'Refresh', 'Cached', 'Disabled'), 'help' => 'Search database posts and pages for [gallery] shortcode results.<br>&nbsp;&nbsp;Dynamic = once every page load, Cached = once every login, Disabled = never.<br>&nbsp;&nbsp;Refresh = update references, then set to Cached.'), self::MLA_MLA_GALLERY_IN_TUNING => array('tab' => 'general', 'name' => 'MLA Gallery in', 'type' => 'select', 'std' => 'cached', 'options' => array('dynamic', 'refresh', 'cached', 'disabled'), 'texts' => array('Dynamic', 'Refresh', 'Cached', 'Disabled'), 'help' => 'Search database posts and pages for [mla_gallery] shortcode results.<br>&nbsp;&nbsp;Dynamic = once every page load, Cached = once every login, Disabled = never.<br>&nbsp;&nbsp;Refresh = update references, then set to Cached.'), 'taxonomy_header' => array('tab' => 'general', 'name' => 'Taxonomy Support', 'type' => 'header'), self::MLA_TAXONOMY_SUPPORT => array('tab' => 'general', 'help' => 'Check the "Support" box to add the taxonomy to the Assistant and the Edit Media screen.<br>Check the "Inline Edit" box to display the taxonomy in the Quick Edit and Bulk Edit areas.<br>Use the "List Filter" option to select the taxonomy on which to filter the Assistant table listing.', 'std' => array('tax_support' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_quick_edit' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_filter' => 'attachment_category'), 'type' => 'custom', 'render' => 'mla_taxonomy_option_handler', 'update' => 'mla_taxonomy_option_handler', 'delete' => 'mla_taxonomy_option_handler', 'reset' => 'mla_taxonomy_option_handler'), 'attachments_column' => array('tab' => '', 'name' => 'Attachments Column', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to replace the Posts column with the Attachments Column.'), 'media_assistant_header' => array('tab' => 'general', 'name' => 'Media/Assistant Screen Options', 'type' => 'header'), 'admin_sidebar_subheader' => array('tab' => 'general', 'name' => 'Admin Menu Options', 'type' => 'subheader'), self::MLA_SCREEN_PAGE_TITLE => array('tab' => 'general', 'name' => 'Page Title', 'type' => 'text', 'std' => 'Media Library Assistant', 'size' => 40, 'help' => 'Enter the title for the Media/Assistant submenu page'), self::MLA_SCREEN_MENU_TITLE => array('tab' => 'general', 'name' => 'Menu Title', 'type' => 'text', 'std' => 'Assistant', 'size' => 20, 'help' => 'Enter the title for the Media/Assistant submenu entry'), self::MLA_SCREEN_ORDER => array('tab' => 'general', 'name' => 'Submenu Order', 'type' => 'text', 'std' => '0', 'size' => 2, 'help' => 'Enter the position of the Media/Assistant submenu entry.<br>&nbsp;&nbsp;0 = natural order (at bottom),&nbsp;&nbsp;&nbsp;&nbsp;1 - 4 = at top<br>&nbsp;&nbsp;6-9 = after "Library",&nbsp;&nbsp;&nbsp;&nbsp;11-16 = after "Add New"'), self::MLA_SCREEN_DISPLAY_LIBRARY => array('tab' => 'general', 'name' => 'Display Media/Library', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to display/remove the WordPress Media/Library submenu entry.'), 'table_defaults_subheader' => array('tab' => 'general', 'name' => 'Table Defaults', 'type' => 'subheader'), self::MLA_DEFAULT_ORDERBY => array('tab' => 'general', 'name' => 'Order By', 'type' => 'select', 'std' => 'title_name', 'options' => array('none', 'title_name'), 'texts' => array('None', 'Title/Name'), 'help' => 'Select the column for the sort order of the Assistant table listing.'), self::MLA_DEFAULT_ORDER => array('tab' => 'general', 'name' => 'Order', 'type' => 'radio', 'std' => 'ASC', 'options' => array('ASC', 'DESC'), 'texts' => array('Ascending', 'Descending'), 'help' => 'Choose the sort order.'), self::MLA_TABLE_VIEWS_WIDTH => array('tab' => 'general', 'name' => 'Views Width', 'type' => 'text', 'std' => '', 'size' => 10, 'help' => 'Enter the width for the views list, in pixels (px) or percent (%)'), 'taxonomy_filter_subheader' => array('tab' => 'general', 'name' => 'Taxonomy Filter parameters', 'type' => 'subheader'), self::MLA_TAXONOMY_FILTER_DEPTH => array('tab' => 'general', 'name' => 'Maximum Depth', 'type' => 'text', 'std' => '3', 'size' => 2, 'help' => 'Enter the number of levels displayed for hierarchial taxonomies; enter zero for no limit.'), self::MLA_TAXONOMY_FILTER_INCLUDE_CHILDREN => array('tab' => 'general', 'name' => 'Include Children', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to include/exclude children for hierarchical taxonomies.'), 'media_modal_header' => array('tab' => 'general', 'name' => 'Media Manager Enhancements', 'type' => 'header'), self::MLA_MEDIA_MODAL_TOOLBAR => array('tab' => 'general', 'name' => 'Enable Media Manager Enhancements', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to enable/disable Media Manager Enhancements.'), self::MLA_MEDIA_MODAL_MIMETYPES => array('tab' => 'general', 'name' => 'Media Manager Enhanced MIME Type filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by more MIME Types, e.g., text, applications.'), self::MLA_MEDIA_MODAL_MONTHS => array('tab' => 'general', 'name' => 'Media Manager Month and Year filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by month and year uploaded.'), self::MLA_MEDIA_MODAL_TERMS => array('tab' => 'general', 'name' => 'Media Manager Category/Tag filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by taxonomy terms.'), self::MLA_MEDIA_MODAL_SEARCHBOX => array('tab' => 'general', 'name' => 'Media Manager Enhanced Search Media box', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to enable search box enhancements.'), self::MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX => array('tab' => 'general', 'name' => 'Media Manager Searchable Categories metaboxes', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable searchable metaboxes in the "ATTACHMENT DETAILS" pane.<br>&nbsp;&nbsp;This option is for <strong>hierarchical taxonomies, e.g., "Att. Categories".</strong><br>&nbsp;&nbsp;You must also install and activate the <strong>"Media Categories" plugin</strong> (by Eddie Moya) to implement this option.'), self::MLA_MEDIA_MODAL_DETAILS_TAG_METABOX => array('tab' => 'general', 'name' => 'Media Manager Searchable Tags metaboxes', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable searchable metaboxes in the "ATTACHMENT DETAILS" pane.<br>&nbsp;&nbsp;This option is for <strong>flat taxonomies, e.g., "Att. Tags".</strong><br>&nbsp;&nbsp;You must also install and activate the <strong>"Media Categories" plugin</strong> (by Eddie Moya) to implement this option.'), self::MLA_MEDIA_MODAL_ORDERBY => array('tab' => '', 'name' => 'Media Manager Order By', 'type' => 'select', 'std' => 'default', 'options' => array('default', 'none', 'title_name'), 'texts' => array(' -- Media Manager Default -- ', 'None', 'Title/Name'), 'help' => 'If you want to override the Media Manager default,<br>&nbsp;&nbsp;select a column for the sort order of the Media Library listing.'), self::MLA_MEDIA_MODAL_ORDER => array('tab' => '', 'name' => 'Media Manager Order', 'type' => 'radio', 'std' => 'default', 'options' => array('default', 'ASC', 'DESC'), 'texts' => array(' -- Media Manager Default -- ', 'Ascending', 'Descending'), 'help' => 'Choose the sort order.'), 'template_header' => array('tab' => 'mla_gallery', 'name' => 'Default [mla_gallery] Templates and Settings', 'type' => 'header'), 'default_style' => array('tab' => 'mla_gallery', 'name' => 'Style Template', 'type' => 'select', 'std' => 'default', 'options' => array(), 'texts' => array(), 'help' => 'Select the default style template for your [mla_gallery] shortcodes.'), 'default_markup' => array('tab' => 'mla_gallery', 'name' => 'Markup Template', 'type' => 'select', 'std' => 'default', 'options' => array(), 'texts' => array(), 'help' => 'Select the default markup template for your [mla_gallery] shortcodes.'), 'mla_gallery_columns' => array('tab' => 'mla_gallery', 'name' => 'Default columns', 'type' => 'text', 'std' => '3', 'size' => 3, 'help' => 'Enter the number of [mla_gallery] columns; must be a positive integer.'), 'mla_gallery_margin' => array('tab' => 'mla_gallery', 'name' => 'Default mla_margin', 'type' => 'text', 'std' => '1.5%', 'size' => 10, 'help' => 'Enter the CSS "margin" property value, in length (px, em, pt, etc.), percent (%), "auto" or "inherit".<br>&nbsp;&nbsp;Enter "none" to remove the property entirely.'), 'mla_gallery_itemwidth' => array('tab' => 'mla_gallery', 'name' => 'Default mla_itemwidth', 'type' => 'text', 'std' => 'calculate', 'size' => 10, 'help' => 'Enter the CSS "width" property value, in length (px, em, pt, etc.), percent (%), "auto" or "inherit".<br>&nbsp;&nbsp;Enter "calculate" (the default) to calculate the value taking the "margin" value into account.<br>&nbsp;&nbsp;Enter "exact" to calculate the value without considering the "margin" value.<br>&nbsp;&nbsp;Enter "none" to remove the property entirely.'), 'style_templates' => array('tab' => '', 'type' => 'hidden', 'std' => array()), 'markup_templates' => array('tab' => '', 'type' => 'hidden', 'std' => array()), 'enable_custom_field_mapping' => array('tab' => 'custom_field', 'name' => 'Enable custom field mapping when adding new media', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable mapping when uploading new media (attachments).<br>&nbsp;&nbsp;Click Save Changes at the bottom of the screen if you change this option.<br>&nbsp;&nbsp;Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'), 'custom_field_mapping' => array('tab' => '', 'help' => '&nbsp;<br>Update the custom field mapping values above, then click Save Changes to make the updates permanent.<br>You can also make temporary updates and click a Map All Attachments button to apply the rule(s) to all attachments without saving any rule changes.', 'std' => array(), 'type' => 'custom', 'render' => 'mla_custom_field_option_handler', 'update' => 'mla_custom_field_option_handler', 'delete' => 'mla_custom_field_option_handler', 'reset' => 'mla_custom_field_option_handler'), 'enable_iptc_exif_mapping' => array('tab' => 'iptc_exif', 'name' => 'Enable IPTC/EXIF Mapping when adding new media', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable mapping when uploading new media (attachments).<br>&nbsp;&nbsp;Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'), 'iptc_exif_standard_mapping' => array('tab' => '', 'help' => 'Update the standard field mapping values above, then click <strong>Save Changes</strong> to make the updates permanent.<br>You can also make temporary updates and click <strong>Map All Attachments, Standard Fields Now</strong> to apply the updates to all attachments without saving the rule changes.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_taxonomy_mapping' => array('tab' => '', 'help' => 'Update the taxonomy term mapping values above, then click <strong>Save Changes</strong> or <strong>Map All Attachments, Taxonomy Terms Now</strong>.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_custom_mapping' => array('tab' => '', 'help' => '<strong>Update</strong> individual custom field mapping values above, or make several updates and click <strong>Save Changes</strong> below to apply them all at once.<br>You can also <strong>add a new rule</strong> for an existing field or <strong>add a new field</strong> and rule.<br>You can make temporary updates and click <strong>Map All Attachments, Custom Fields Now</strong> to apply the updates to all attachments without saving the rule changes.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_mapping' => array('tab' => '', 'help' => 'IPTC/EXIF Mapping help', 'std' => array('standard' => array('post_title' => array('name' => 'Title', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_name' => array('name' => 'Name/Slug', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'image_alt' => array('name' => 'Alternate Text', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_excerpt' => array('name' => 'Caption', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_content' => array('name' => 'Description', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true)), 'taxonomy' => array(), 'custom' => array()), 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), self::MLA_ENABLE_POST_MIME_TYPES => array('tab' => 'view', 'name' => 'Enable View and Post MIME Type Support', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to enable/disable Post MIME Type Support, then click <strong>Save Changes</strong> to record the new setting.'), self::MLA_POST_MIME_TYPES => array('tab' => '', 'type' => 'custom', 'render' => 'mla_post_mime_types_option_handler', 'update' => 'mla_post_mime_types_option_handler', 'delete' => 'mla_post_mime_types_option_handler', 'reset' => 'mla_post_mime_types_option_handler', 'help' => 'Post MIME Types help.', 'std' => array('all' => array('singular' => 'All', 'plural' => 'All', 'specification' => '', 'post_mime_type' => false, 'table_view' => true, 'menu_order' => 0, 'description' => 'Built-in view'), 'image' => array('singular' => 'Image', 'plural' => 'Images', 'specification' => '', 'post_mime_type' => true, 'table_view' => true, 'menu_order' => 0, 'description' => 'All image subtypes'), 'audio' => array('singular' => 'Audio', 'plural' => 'Audio', 'specification' => '', 'post_mime_type' => true, 'table_view' => true, 'menu_order' => 0, 'description' => 'All audio subtypes'), 'video' => array('singular' => 'Video', 'plural' => 'Video', 'specification' => '', 'post_mime_type' => true, 'table_view' => true, 'menu_order' => 0, 'description' => 'All video subtypes'), 'text' => array('singular' => 'Text', 'plural' => 'Text', 'specification' => '', 'post_mime_type' => true, 'table_view' => true, 'menu_order' => 0, 'description' => 'All text subtypes'), 'application' => array('singular' => 'Application', 'plural' => 'Applications', 'specification' => '', 'post_mime_type' => true, 'table_view' => true, 'menu_order' => 0, 'description' => 'All application subtypes'), 'unattached' => array('singular' => 'Unattached', 'plural' => 'Unattached', 'specification' => '', 'post_mime_type' => false, 'table_view' => true, 'menu_order' => 0, 'description' => 'Built-in view'), 'trash' => array('singular' => 'Trash', 'plural' => 'Trash', 'specification' => '', 'post_mime_type' => false, 'table_view' => true, 'menu_order' => 0, 'description' => 'Built-in view'))), self::MLA_ENABLE_UPLOAD_MIMES => array('tab' => 'upload', 'name' => 'Enable Upload MIME Type Support', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to enable/disable Upload MIME Type Support, then click <strong>Save Changes</strong> to record the new setting.'), self::MLA_UPLOAD_MIMES => array('tab' => '', 'type' => 'custom', 'render' => 'mla_upload_mimes_option_handler', 'update' => 'mla_upload_mimes_option_handler', 'delete' => 'mla_upload_mimes_option_handler', 'reset' => 'mla_upload_mimes_option_handler', 'help' => 'Upload MIME Types help.', 'std' => false), self::MLA_ENABLE_MLA_ICONS => array('tab' => 'upload', 'name' => 'Enable MLA File Type Icons Support', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to enable/disable MLA File Type Icons Support, then click <strong>Save Changes</strong> to record the new setting.'))]]></default>
5687
  <docblock line="230">
5688
  <description><![CDATA[$mla_option_definitions defines the database options and admin page areas for setting/updating them.]]></description>
5689
  <long-description><![CDATA[<p>Each option is defined by an array with the following elements:</p>
@@ -5710,947 +5874,947 @@ reset => reset function for 'custom' options; returns nothing. Usage:
5710
  $message = ['reset']( 'reset', $key, $value, $_REQUEST );</p>]]></long-description>
5711
  </docblock>
5712
  </property>
5713
- <property final="false" static="true" visibility="private" line="859" namespace="global" package="Media Library Assistant">
5714
  <name>$mla_option_templates</name>
5715
  <default><![CDATA[null]]></default>
5716
- <docblock line="852">
5717
  <description><![CDATA[Style and Markup templates]]></description>
5718
  <long-description><![CDATA[]]></long-description>
5719
- <tag line="852" name="since" description="0.80"/>
5720
- <tag line="852" name="var" description="" type="array">
5721
  <type by_reference="false">array</type>
5722
  </tag>
5723
  </docblock>
5724
  </property>
5725
- <property final="false" static="true" visibility="private" line="2030" namespace="global" package="Media Library Assistant">
5726
  <name>$custom_field_data_sources</name>
5727
- <default><![CDATA[array('absolute_path', 'absolute_file_name', 'base_file', 'path', 'file_name', 'name_only', 'extension', 'file_size', 'upload_date', 'mime_type', 'dimensions', 'pixels', 'width', 'height', 'hwstring_small', 'size_keys', 'size_names', 'size_bytes', 'size_pixels', 'size_dimensions', 'size_name[size]', 'size_bytes[size]', 'size_pixels[size]', 'size_dimensions[size]', 'parent', 'parent_date', 'parent_type', 'parent_title', 'parent_issues', 'reference_issues', 'featured_in', 'featured_in_title', 'inserted_in', 'inserted_in_title', 'gallery_in', 'gallery_in_title', 'mla_gallery_in', 'mla_gallery_in_title', 'aperture', 'credit', 'camera', 'caption', 'created_timestamp', 'copyright', 'focal_length', 'iso', 'shutter_speed', 'title')]]></default>
5728
- <docblock line="2023">
5729
  <description><![CDATA[Array of Data Source names for custom field mapping]]></description>
5730
  <long-description><![CDATA[]]></long-description>
5731
- <tag line="2023" name="since" description="1.10"/>
5732
- <tag line="2023" name="var" description="" type="array">
5733
  <type by_reference="false">array</type>
5734
  </tag>
5735
  </docblock>
5736
  </property>
5737
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="833" package="Media Library Assistant">
5738
  <name>initialize</name>
5739
  <full_name>initialize</full_name>
5740
- <docblock line="826">
5741
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
5742
  <long-description><![CDATA[]]></long-description>
5743
- <tag line="826" name="since" description="1.00"/>
5744
- <tag line="826" name="return" description="" type="void">
5745
  <type by_reference="false">void</type>
5746
  </tag>
5747
  </docblock>
5748
  </method>
5749
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="868" package="Media Library Assistant">
5750
  <name>_load_option_templates</name>
5751
  <full_name>_load_option_templates</full_name>
5752
- <docblock line="861">
5753
  <description><![CDATA[Load style and markup templates to $mla_templates]]></description>
5754
  <long-description><![CDATA[]]></long-description>
5755
- <tag line="861" name="since" description="0.80"/>
5756
- <tag line="861" name="return" description="" type="void">
5757
  <type by_reference="false">void</type>
5758
  </tag>
5759
  </docblock>
5760
  </method>
5761
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="916" package="Media Library Assistant">
5762
  <name>mla_fetch_gallery_template</name>
5763
  <full_name>mla_fetch_gallery_template</full_name>
5764
- <docblock line="906">
5765
  <description><![CDATA[Fetch style or markup template from $mla_templates]]></description>
5766
  <long-description><![CDATA[]]></long-description>
5767
- <tag line="906" name="since" description="0.80"/>
5768
- <tag line="906" name="param" description="Template name" type="string" variable="$key">
5769
  <type by_reference="false">string</type>
5770
  </tag>
5771
- <tag line="906" name="param" description="Template type; 'style' (default) or 'markup'" type="string" variable="$type">
5772
  <type by_reference="false">string</type>
5773
  </tag>
5774
- <tag line="906" name="return" description="requested template, false if not found or null if no templates" type="string|boolean|null">
5775
  <type by_reference="false">string</type>
5776
  <type by_reference="false">boolean</type>
5777
  <type by_reference="false">null</type>
5778
  </tag>
5779
  </docblock>
5780
- <argument line="916">
5781
  <name>$key</name>
5782
  <default><![CDATA[]]></default>
5783
  <type/>
5784
  </argument>
5785
- <argument line="916">
5786
  <name>$type</name>
5787
  <default><![CDATA['style']]></default>
5788
  <type/>
5789
  </argument>
5790
  </method>
5791
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="939" package="Media Library Assistant">
5792
  <name>mla_get_style_templates</name>
5793
  <full_name>mla_get_style_templates</full_name>
5794
- <docblock line="932">
5795
  <description><![CDATA[Get ALL style templates from $mla_templates, including 'default']]></description>
5796
  <long-description><![CDATA[]]></long-description>
5797
- <tag line="932" name="since" description="0.80"/>
5798
- <tag line="932" name="return" description="name =&gt; value for all style templates or null if no templates" type="array|null">
5799
  <type by_reference="false">array</type>
5800
  <type by_reference="false">null</type>
5801
  </tag>
5802
  </docblock>
5803
  </method>
5804
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="965" package="Media Library Assistant">
5805
  <name>mla_put_style_templates</name>
5806
  <full_name>mla_put_style_templates</full_name>
5807
- <docblock line="957">
5808
  <description><![CDATA[Put user-defined style templates to $mla_templates and database]]></description>
5809
  <long-description><![CDATA[]]></long-description>
5810
- <tag line="957" name="since" description="0.80"/>
5811
- <tag line="957" name="param" description="name =&gt; value for all user-defined style templates" type="array" variable="$templates">
5812
  <type by_reference="false">array</type>
5813
  </tag>
5814
- <tag line="957" name="return" description="true if success, false if failure" type="boolean">
5815
  <type by_reference="false">boolean</type>
5816
  </tag>
5817
  </docblock>
5818
- <argument line="965">
5819
  <name>$templates</name>
5820
  <default><![CDATA[]]></default>
5821
  <type/>
5822
  </argument>
5823
  </method>
5824
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="981" package="Media Library Assistant">
5825
  <name>mla_get_markup_templates</name>
5826
  <full_name>mla_get_markup_templates</full_name>
5827
- <docblock line="974">
5828
  <description><![CDATA[Get ALL markup templates from $mla_templates, including 'default']]></description>
5829
  <long-description><![CDATA[]]></long-description>
5830
- <tag line="974" name="since" description="0.80"/>
5831
- <tag line="974" name="return" description="name =&gt; value for all markup templates or null if no templates" type="array|null">
5832
  <type by_reference="false">array</type>
5833
  <type by_reference="false">null</type>
5834
  </tag>
5835
  </docblock>
5836
  </method>
5837
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1036" package="Media Library Assistant">
5838
  <name>mla_put_markup_templates</name>
5839
  <full_name>mla_put_markup_templates</full_name>
5840
- <docblock line="1028">
5841
  <description><![CDATA[Put user-defined markup templates to $mla_templates and database]]></description>
5842
  <long-description><![CDATA[]]></long-description>
5843
- <tag line="1028" name="since" description="0.80"/>
5844
- <tag line="1028" name="param" description="name =&gt; value for all user-defined markup templates" type="array" variable="$templates">
5845
  <type by_reference="false">array</type>
5846
  </tag>
5847
- <tag line="1028" name="return" description="true if success, false if failure" type="boolean">
5848
  <type by_reference="false">boolean</type>
5849
  </tag>
5850
  </docblock>
5851
- <argument line="1036">
5852
  <name>$templates</name>
5853
  <default><![CDATA[]]></default>
5854
  <type/>
5855
  </argument>
5856
  </method>
5857
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1056" package="Media Library Assistant">
5858
  <name>mla_get_option</name>
5859
  <full_name>mla_get_option</full_name>
5860
- <docblock line="1045">
5861
  <description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
5862
  <long-description><![CDATA[]]></long-description>
5863
- <tag line="1045" name="since" description="0.1"/>
5864
- <tag line="1045" name="param" description="Name of the desired option" type="string" variable="$option">
5865
  <type by_reference="false">string</type>
5866
  </tag>
5867
- <tag line="1045" name="param" description="True to ignore current setting and return default values" type="boolean" variable="$get_default">
5868
  <type by_reference="false">boolean</type>
5869
  </tag>
5870
- <tag line="1045" name="param" description="True to ignore default values and return only stored values" type="boolean" variable="$get_stored">
5871
  <type by_reference="false">boolean</type>
5872
  </tag>
5873
- <tag line="1045" name="return" description="Value(s) for the option or false if the option is not a defined MLA option" type="mixed">
5874
  <type by_reference="false">mixed</type>
5875
  </tag>
5876
  </docblock>
5877
- <argument line="1056">
5878
  <name>$option</name>
5879
  <default><![CDATA[]]></default>
5880
  <type/>
5881
  </argument>
5882
- <argument line="1056">
5883
  <name>$get_default</name>
5884
  <default><![CDATA[false]]></default>
5885
  <type/>
5886
  </argument>
5887
- <argument line="1056">
5888
  <name>$get_stored</name>
5889
  <default><![CDATA[false]]></default>
5890
  <type/>
5891
  </argument>
5892
  </method>
5893
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1083" package="Media Library Assistant">
5894
  <name>mla_update_option</name>
5895
  <full_name>mla_update_option</full_name>
5896
- <docblock line="1073">
5897
  <description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
5898
  <long-description><![CDATA[]]></long-description>
5899
- <tag line="1073" name="since" description="0.1"/>
5900
- <tag line="1073" name="param" description="Name of the desired option" type="string" variable="$option">
5901
  <type by_reference="false">string</type>
5902
  </tag>
5903
- <tag line="1073" name="param" description="New value for the desired option" type="mixed" variable="$newvalue">
5904
  <type by_reference="false">mixed</type>
5905
  </tag>
5906
- <tag line="1073" name="return" description="True if the value was changed or false if the update failed" type="boolean">
5907
  <type by_reference="false">boolean</type>
5908
  </tag>
5909
  </docblock>
5910
- <argument line="1083">
5911
  <name>$option</name>
5912
  <default><![CDATA[]]></default>
5913
  <type/>
5914
  </argument>
5915
- <argument line="1083">
5916
  <name>$newvalue</name>
5917
  <default><![CDATA[]]></default>
5918
  <type/>
5919
  </argument>
5920
  </method>
5921
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1099" package="Media Library Assistant">
5922
  <name>mla_delete_option</name>
5923
  <full_name>mla_delete_option</full_name>
5924
- <docblock line="1090">
5925
  <description><![CDATA[Delete the stored value of a defined MLA option]]></description>
5926
  <long-description><![CDATA[]]></long-description>
5927
- <tag line="1090" name="since" description="0.1"/>
5928
- <tag line="1090" name="param" description="Name of the desired option" type="string" variable="$option">
5929
  <type by_reference="false">string</type>
5930
  </tag>
5931
- <tag line="1090" name="return" description="True if the option was deleted, otherwise false" type="boolean">
5932
  <type by_reference="false">boolean</type>
5933
  </tag>
5934
  </docblock>
5935
- <argument line="1099">
5936
  <name>$option</name>
5937
  <default><![CDATA[]]></default>
5938
  <type/>
5939
  </argument>
5940
  </method>
5941
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1120" package="Media Library Assistant">
5942
  <name>mla_taxonomy_support</name>
5943
  <full_name>mla_taxonomy_support</full_name>
5944
- <docblock line="1107">
5945
  <description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
5946
  settings are being updated or reset.]]></description>
5947
  <long-description><![CDATA[]]></long-description>
5948
- <tag line="1107" name="since" description="0.30"/>
5949
- <tag line="1107" name="param" description="Taxonomy name, e.g., attachment_category" type="string" variable="$tax_name">
5950
  <type by_reference="false">string</type>
5951
  </tag>
5952
- <tag line="1107" name="param" description="Optional. 'support' (default), 'quick-edit' or 'filter'" type="string" variable="$support_type">
5953
  <type by_reference="false">string</type>
5954
  </tag>
5955
- <tag line="1107" name="return" description="true if the taxonomy is supported in this way else false string if $tax_name is '' and $support_type is 'filter', returns the taxonomy to filter by" type="boolean|string">
5956
  <type by_reference="false">boolean</type>
5957
  <type by_reference="false">string</type>
5958
  </tag>
5959
  </docblock>
5960
- <argument line="1120">
5961
  <name>$tax_name</name>
5962
  <default><![CDATA[]]></default>
5963
  <type/>
5964
  </argument>
5965
- <argument line="1120">
5966
  <name>$support_type</name>
5967
  <default><![CDATA['support']]></default>
5968
  <type/>
5969
  </argument>
5970
  </method>
5971
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1196" package="Media Library Assistant">
5972
  <name>mla_taxonomy_option_handler</name>
5973
  <full_name>mla_taxonomy_option_handler</full_name>
5974
- <docblock line="1183">
5975
  <description><![CDATA[Render and manage taxonomy support options, e.g., Categories and Post Tags]]></description>
5976
  <long-description><![CDATA[]]></long-description>
5977
- <tag line="1183" name="since" description="0.30"/>
5978
- <tag line="1183" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
5979
- <tag line="1183" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
5980
  <type by_reference="false">string</type>
5981
  </tag>
5982
- <tag line="1183" name="param" description="option name, e.g., 'taxonomy_support'" type="string" variable="$key">
5983
  <type by_reference="false">string</type>
5984
  </tag>
5985
- <tag line="1183" name="param" description="option parameters" type="array" variable="$value">
5986
  <type by_reference="false">array</type>
5987
  </tag>
5988
- <tag line="1183" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
5989
  <type by_reference="false">array</type>
5990
  </tag>
5991
- <tag line="1183" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
5992
  <type by_reference="false">string</type>
5993
  </tag>
5994
  </docblock>
5995
- <argument line="1196">
5996
  <name>$action</name>
5997
  <default><![CDATA[]]></default>
5998
  <type/>
5999
  </argument>
6000
- <argument line="1196">
6001
  <name>$key</name>
6002
  <default><![CDATA[]]></default>
6003
  <type/>
6004
  </argument>
6005
- <argument line="1196">
6006
  <name>$value</name>
6007
  <default><![CDATA[]]></default>
6008
  <type/>
6009
  </argument>
6010
- <argument line="1196">
6011
  <name>$args</name>
6012
  <default><![CDATA[null]]></default>
6013
  <type/>
6014
  </argument>
6015
  </method>
6016
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1304" package="Media Library Assistant">
6017
  <name>mla_add_attachment_action</name>
6018
  <full_name>mla_add_attachment_action</full_name>
6019
- <docblock line="1295">
6020
  <description><![CDATA[Perform ITC/EXIF mapping on just-inserted attachment]]></description>
6021
  <long-description><![CDATA[]]></long-description>
6022
- <tag line="1295" name="since" description="1.00"/>
6023
- <tag line="1295" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
6024
  <type by_reference="false">integer</type>
6025
  </tag>
6026
- <tag line="1295" name="return" description="" type="void">
6027
  <type by_reference="false">void</type>
6028
  </tag>
6029
  </docblock>
6030
- <argument line="1304">
6031
  <name>$post_id</name>
6032
  <default><![CDATA[]]></default>
6033
  <type/>
6034
  </argument>
6035
  </method>
6036
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1324" package="Media Library Assistant">
6037
  <name>mla_update_attachment_metadata_filter</name>
6038
  <full_name>mla_update_attachment_metadata_filter</full_name>
6039
- <docblock line="1314">
6040
  <description><![CDATA[Perform Custom Field mapping on just-inserted or updated attachment]]></description>
6041
  <long-description><![CDATA[]]></long-description>
6042
- <tag line="1314" name="since" description="1.10"/>
6043
- <tag line="1314" name="param" description="Attachment metadata for just-inserted attachment" type="array" variable="$data">
6044
  <type by_reference="false">array</type>
6045
  </tag>
6046
- <tag line="1314" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
6047
  <type by_reference="false">integer</type>
6048
  </tag>
6049
- <tag line="1314" name="return" description="" type="void">
6050
  <type by_reference="false">void</type>
6051
  </tag>
6052
  </docblock>
6053
- <argument line="1324">
6054
  <name>$data</name>
6055
  <default><![CDATA[]]></default>
6056
  <type/>
6057
  </argument>
6058
- <argument line="1324">
6059
  <name>$post_id</name>
6060
  <default><![CDATA[]]></default>
6061
  <type/>
6062
  </argument>
6063
  </method>
6064
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1344" package="Media Library Assistant">
6065
  <name>mla_custom_field_option_value</name>
6066
  <full_name>mla_custom_field_option_value</full_name>
6067
- <docblock line="1335">
6068
  <description><![CDATA[Fetch custom field option value given a slug]]></description>
6069
  <long-description><![CDATA[]]></long-description>
6070
- <tag line="1335" name="since" description="1.10"/>
6071
- <tag line="1335" name="param" description="slug, e.g., 'c_file-size' for the 'File Size' field" type="string" variable="$slug">
6072
  <type by_reference="false">string</type>
6073
  </tag>
6074
- <tag line="1335" name="return" description="option value, e.g., array( 'name' =&gt; 'File Size', ... )" type="array">
6075
  <type by_reference="false">array</type>
6076
  </tag>
6077
  </docblock>
6078
- <argument line="1344">
6079
  <name>$slug</name>
6080
  <default><![CDATA[]]></default>
6081
  <type/>
6082
  </argument>
6083
  </method>
6084
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1364" package="Media Library Assistant">
6085
  <name>mla_custom_field_support</name>
6086
  <full_name>mla_custom_field_support</full_name>
6087
- <docblock line="1355">
6088
  <description><![CDATA[Evaluate file information for custom field mapping]]></description>
6089
  <long-description><![CDATA[]]></long-description>
6090
- <tag line="1355" name="since" description="1.10"/>
6091
- <tag line="1355" name="param" description="array format; 'default_columns' (default), 'default_hidden_columns', 'default_sortable_columns', 'quick_edit' or 'bulk_edit'" type="string" variable="$support_type">
6092
  <type by_reference="false">string</type>
6093
  </tag>
6094
- <tag line="1355" name="return" description="default, hidden, sortable quick_edit or bulk_edit colums in appropriate format" type="array">
6095
  <type by_reference="false">array</type>
6096
  </tag>
6097
  </docblock>
6098
- <argument line="1364">
6099
  <name>$support_type</name>
6100
  <default><![CDATA['default_columns']]></default>
6101
  <type/>
6102
  </argument>
6103
  </method>
6104
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1410" package="Media Library Assistant">
6105
  <name>_evaluate_file_information</name>
6106
  <full_name>_evaluate_file_information</full_name>
6107
- <docblock line="1398">
6108
  <description><![CDATA[Evaluate file information for custom field mapping]]></description>
6109
  <long-description><![CDATA[]]></long-description>
6110
- <tag line="1398" name="since" description="1.10"/>
6111
- <tag line="1398" name="param" description="absolute path the the uploads base directory" type="string" variable="$upload_dir">
6112
  <type by_reference="false">string</type>
6113
  </tag>
6114
- <tag line="1398" name="param" description="_wp_attached_file meta_value array, indexed by post_id" type="array" variable="$wp_attached_files">
6115
  <type by_reference="false">array</type>
6116
  </tag>
6117
- <tag line="1398" name="param" description="_wp_attachment_metadata meta_value array, indexed by post_id" type="array" variable="$wp_attachment_metadata">
6118
  <type by_reference="false">array</type>
6119
  </tag>
6120
- <tag line="1398" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
6121
  <type by_reference="false">integer</type>
6122
  </tag>
6123
- <tag line="1398" name="return" description="absolute_path_raw, absolute_path, absolute_file_name_raw, absolute_file_name, absolute_file, base_file, path, file_name, extension, dimensions, width, height, hwstring_small, array of intermediate sizes" type="array">
6124
  <type by_reference="false">array</type>
6125
  </tag>
6126
  </docblock>
6127
- <argument line="1410">
6128
  <name>$upload_dir</name>
6129
  <default><![CDATA[]]></default>
6130
  <type/>
6131
  </argument>
6132
- <argument line="1410">
6133
  <name>$wp_attached_files</name>
6134
  <default><![CDATA[]]></default>
6135
  <type/>
6136
  </argument>
6137
- <argument line="1410">
6138
  <name>$wp_attachment_metadata</name>
6139
  <default><![CDATA[]]></default>
6140
  <type/>
6141
  </argument>
6142
- <argument line="1410">
6143
  <name>$post_id</name>
6144
  <default><![CDATA[]]></default>
6145
  <type/>
6146
  </argument>
6147
  </method>
6148
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1479" package="Media Library Assistant">
6149
  <name>_evaluate_post_information</name>
6150
  <full_name>_evaluate_post_information</full_name>
6151
- <docblock line="1468">
6152
  <description><![CDATA[Evaluate post information for custom field mapping]]></description>
6153
  <long-description><![CDATA[]]></long-description>
6154
- <tag line="1468" name="since" description="1.40"/>
6155
- <tag line="1468" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
6156
  <type by_reference="false">integer</type>
6157
  </tag>
6158
- <tag line="1468" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
6159
  <type by_reference="false">string</type>
6160
  </tag>
6161
- <tag line="1468" name="param" description="data source name ( post_date or post_parent )" type="string" variable="$data_source">
6162
  <type by_reference="false">string</type>
6163
  </tag>
6164
- <tag line="1468" name="return" description="'post_date' =&gt; (string) upload date, 'post_parent' =&gt; (integer) ID of parent or zero )" type="mixed">
6165
  <type by_reference="false">mixed</type>
6166
  </tag>
6167
  </docblock>
6168
- <argument line="1479">
6169
  <name>$post_id</name>
6170
  <default><![CDATA[]]></default>
6171
  <type/>
6172
  </argument>
6173
- <argument line="1479">
6174
  <name>$category</name>
6175
  <default><![CDATA[]]></default>
6176
  <type/>
6177
  </argument>
6178
- <argument line="1479">
6179
  <name>$data_source</name>
6180
  <default><![CDATA[]]></default>
6181
  <type/>
6182
  </argument>
6183
  </method>
6184
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1515" package="Media Library Assistant">
6185
  <name>_evaluate_array_result</name>
6186
  <full_name>_evaluate_array_result</full_name>
6187
- <docblock line="1504">
6188
  <description><![CDATA[Evaluate post information for custom field mapping]]></description>
6189
  <long-description><![CDATA[]]></long-description>
6190
- <tag line="1504" name="since" description="1.40"/>
6191
- <tag line="1504" name="param" description="field value(s)" type="array" variable="$value">
6192
  <type by_reference="false">array</type>
6193
  </tag>
6194
- <tag line="1504" name="param" description="format option text|single|export|array|multi" type="string" variable="$option">
6195
  <type by_reference="false">string</type>
6196
  </tag>
6197
- <tag line="1504" name="param" description="keep existing value(s) - for 'multi' option" type="boolean" variable="$keep_existing">
6198
  <type by_reference="false">boolean</type>
6199
  </tag>
6200
- <tag line="1504" name="return" description="array for option = array|multi else string" type="mixed">
6201
  <type by_reference="false">mixed</type>
6202
  </tag>
6203
  </docblock>
6204
- <argument line="1515">
6205
  <name>$value</name>
6206
  <default><![CDATA[]]></default>
6207
  <type/>
6208
  </argument>
6209
- <argument line="1515">
6210
  <name>$option</name>
6211
  <default><![CDATA[]]></default>
6212
  <type/>
6213
  </argument>
6214
- <argument line="1515">
6215
  <name>$keep_existing</name>
6216
  <default><![CDATA[]]></default>
6217
  <type/>
6218
  </argument>
6219
  </method>
6220
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1551" package="Media Library Assistant">
6221
  <name>_evaluate_data_source</name>
6222
  <full_name>_evaluate_data_source</full_name>
6223
- <docblock line="1539">
6224
  <description><![CDATA[Evaluate custom field mapping data source]]></description>
6225
  <long-description><![CDATA[]]></long-description>
6226
- <tag line="1539" name="since" description="1.10"/>
6227
- <tag line="1539" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
6228
  <type by_reference="false">integer</type>
6229
  </tag>
6230
- <tag line="1539" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
6231
  <type by_reference="false">string</type>
6232
  </tag>
6233
- <tag line="1539" name="param" description="data source specification ( name, data_source, keep_existing, format, mla_column, quick_edit, bulk_edit, meta_name, no_null, option )" type="array" variable="$data_value">
6234
  <type by_reference="false">array</type>
6235
  </tag>
6236
- <tag line="1539" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
6237
  <type by_reference="false">array</type>
6238
  </tag>
6239
- <tag line="1539" name="return" description="data source value" type="string">
6240
  <type by_reference="false">string</type>
6241
  </tag>
6242
  </docblock>
6243
- <argument line="1551">
6244
  <name>$post_id</name>
6245
  <default><![CDATA[]]></default>
6246
  <type/>
6247
  </argument>
6248
- <argument line="1551">
6249
  <name>$category</name>
6250
  <default><![CDATA[]]></default>
6251
  <type/>
6252
  </argument>
6253
- <argument line="1551">
6254
  <name>$data_value</name>
6255
  <default><![CDATA[]]></default>
6256
  <type/>
6257
  </argument>
6258
- <argument line="1551">
6259
  <name>$attachment_metadata</name>
6260
  <default><![CDATA[NULL]]></default>
6261
  <type/>
6262
  </argument>
6263
  </method>
6264
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1918" package="Media Library Assistant">
6265
  <name>mla_evaluate_custom_field_mapping</name>
6266
  <full_name>mla_evaluate_custom_field_mapping</full_name>
6267
- <docblock line="1906">
6268
  <description><![CDATA[Evaluate custom field mapping updates for a post]]></description>
6269
  <long-description><![CDATA[]]></long-description>
6270
- <tag line="1906" name="since" description="1.10"/>
6271
- <tag line="1906" name="param" description="post ID to be evaluated" type="integer" variable="$post_id">
6272
  <type by_reference="false">integer</type>
6273
  </tag>
6274
- <tag line="1906" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
6275
  <type by_reference="false">string</type>
6276
  </tag>
6277
- <tag line="1906" name="param" description="(optional) custom_field_mapping values, default NULL (use current option value)" type="array" variable="$settings">
6278
  <type by_reference="false">array</type>
6279
  </tag>
6280
- <tag line="1906" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
6281
  <type by_reference="false">array</type>
6282
  </tag>
6283
- <tag line="1906" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
6284
  <type by_reference="false">array</type>
6285
  </tag>
6286
  </docblock>
6287
- <argument line="1918">
6288
  <name>$post_id</name>
6289
  <default><![CDATA[]]></default>
6290
  <type/>
6291
  </argument>
6292
- <argument line="1918">
6293
  <name>$category</name>
6294
  <default><![CDATA[]]></default>
6295
  <type/>
6296
  </argument>
6297
- <argument line="1918">
6298
  <name>$settings</name>
6299
  <default><![CDATA[NULL]]></default>
6300
  <type/>
6301
  </argument>
6302
- <argument line="1918">
6303
  <name>$attachment_metadata</name>
6304
  <default><![CDATA[NULL]]></default>
6305
  <type/>
6306
  </argument>
6307
  </method>
6308
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1997" package="Media Library Assistant">
6309
  <name>_compose_custom_field_option_list</name>
6310
  <full_name>_compose_custom_field_option_list</full_name>
6311
- <docblock line="1986">
6312
  <description><![CDATA[Compose a Custom Field Options list with current selection]]></description>
6313
  <long-description><![CDATA[]]></long-description>
6314
- <tag line="1986" name="since" description="1.10"/>
6315
- <tag line="1986" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6316
- <tag line="1986" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
6317
  <type by_reference="false">string</type>
6318
  </tag>
6319
- <tag line="1986" name="param" description="optional list of terms to exclude from the list" type="array" variable="$blacklist">
6320
  <type by_reference="false">array</type>
6321
  </tag>
6322
- <tag line="1986" name="return" description="HTML markup with select field options" type="string">
6323
  <type by_reference="false">string</type>
6324
  </tag>
6325
  </docblock>
6326
- <argument line="1997">
6327
  <name>$selection</name>
6328
  <default><![CDATA['none']]></default>
6329
  <type/>
6330
  </argument>
6331
- <argument line="1997">
6332
  <name>$blacklist</name>
6333
  <default><![CDATA[array()]]></default>
6334
  <type/>
6335
  </argument>
6336
  </method>
6337
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2091" package="Media Library Assistant">
6338
  <name>_compose_data_source_option_list</name>
6339
  <full_name>_compose_data_source_option_list</full_name>
6340
- <docblock line="2081">
6341
  <description><![CDATA[Compose a (Custom Field) Data Source Options list with current selection]]></description>
6342
  <long-description><![CDATA[]]></long-description>
6343
- <tag line="2081" name="since" description="1.10"/>
6344
- <tag line="2081" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6345
- <tag line="2081" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
6346
  <type by_reference="false">string</type>
6347
  </tag>
6348
- <tag line="2081" name="return" description="HTML markup with select field options" type="string">
6349
  <type by_reference="false">string</type>
6350
  </tag>
6351
  </docblock>
6352
- <argument line="2091">
6353
  <name>$selection</name>
6354
  <default><![CDATA['none']]></default>
6355
  <type/>
6356
  </argument>
6357
  </method>
6358
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2156" package="Media Library Assistant">
6359
  <name>_update_custom_field_mapping</name>
6360
  <full_name>_update_custom_field_mapping</full_name>
6361
- <docblock line="2146">
6362
  <description><![CDATA[Update custom field mappings]]></description>
6363
  <long-description><![CDATA[]]></long-description>
6364
- <tag line="2146" name="since" description="1.10"/>
6365
- <tag line="2146" name="param" description="current custom_field_mapping values" type="array" variable="$current_values">
6366
  <type by_reference="false">array</type>
6367
  </tag>
6368
- <tag line="2146" name="param" description="new values" type="array" variable="$new_values">
6369
  <type by_reference="false">array</type>
6370
  </tag>
6371
- <tag line="2146" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated custom_field_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
6372
  <type by_reference="false">array</type>
6373
  </tag>
6374
  </docblock>
6375
- <argument line="2156">
6376
  <name>$current_values</name>
6377
  <default><![CDATA[]]></default>
6378
  <type/>
6379
  </argument>
6380
- <argument line="2156">
6381
  <name>$new_values</name>
6382
  <default><![CDATA[]]></default>
6383
  <type/>
6384
  </argument>
6385
  </method>
6386
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2362" package="Media Library Assistant">
6387
  <name>mla_custom_field_option_handler</name>
6388
  <full_name>mla_custom_field_option_handler</full_name>
6389
- <docblock line="2349">
6390
  <description><![CDATA[Render and manage custom field mapping options]]></description>
6391
  <long-description><![CDATA[]]></long-description>
6392
- <tag line="2349" name="since" description="1.10"/>
6393
- <tag line="2349" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6394
- <tag line="2349" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
6395
  <type by_reference="false">string</type>
6396
  </tag>
6397
- <tag line="2349" name="param" description="option name, e.g., 'custom_field_mapping'" type="string" variable="$key">
6398
  <type by_reference="false">string</type>
6399
  </tag>
6400
- <tag line="2349" name="param" description="option parameters" type="array" variable="$value">
6401
  <type by_reference="false">array</type>
6402
  </tag>
6403
- <tag line="2349" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
6404
  <type by_reference="false">array</type>
6405
  </tag>
6406
- <tag line="2349" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
6407
  <type by_reference="false">string</type>
6408
  </tag>
6409
  </docblock>
6410
- <argument line="2362">
6411
  <name>$action</name>
6412
  <default><![CDATA[]]></default>
6413
  <type/>
6414
  </argument>
6415
- <argument line="2362">
6416
  <name>$key</name>
6417
  <default><![CDATA[]]></default>
6418
  <type/>
6419
  </argument>
6420
- <argument line="2362">
6421
  <name>$value</name>
6422
  <default><![CDATA[]]></default>
6423
  <type/>
6424
  </argument>
6425
- <argument line="2362">
6426
  <name>$args</name>
6427
  <default><![CDATA[null]]></default>
6428
  <type/>
6429
  </argument>
6430
  </method>
6431
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2554" package="Media Library Assistant">
6432
  <name>mla_evaluate_iptc_exif_mapping</name>
6433
  <full_name>mla_evaluate_iptc_exif_mapping</full_name>
6434
- <docblock line="2543">
6435
  <description><![CDATA[Evaluate IPTC/EXIF mapping updates for a post]]></description>
6436
  <long-description><![CDATA[]]></long-description>
6437
- <tag line="2543" name="since" description="1.00"/>
6438
- <tag line="2543" name="param" description="post object with current values" type="object" variable="$post">
6439
  <type by_reference="false">object</type>
6440
  </tag>
6441
- <tag line="2543" name="param" description="category to evaluate against, e.g., iptc_exif_standard_mapping or iptc_exif_mapping" type="string" variable="$category">
6442
  <type by_reference="false">string</type>
6443
  </tag>
6444
- <tag line="2543" name="param" description="(optional) iptc_exif_mapping values, default - current option value" type="array" variable="$settings">
6445
  <type by_reference="false">array</type>
6446
  </tag>
6447
- <tag line="2543" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
6448
  <type by_reference="false">array</type>
6449
  </tag>
6450
  </docblock>
6451
- <argument line="2554">
6452
  <name>$post</name>
6453
  <default><![CDATA[]]></default>
6454
  <type/>
6455
  </argument>
6456
- <argument line="2554">
6457
  <name>$category</name>
6458
  <default><![CDATA[]]></default>
6459
  <type/>
6460
  </argument>
6461
- <argument line="2554">
6462
  <name>$settings</name>
6463
  <default><![CDATA[NULL]]></default>
6464
  <type/>
6465
  </argument>
6466
  </method>
6467
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2776" package="Media Library Assistant">
6468
  <name>_compose_iptc_option_list</name>
6469
  <full_name>_compose_iptc_option_list</full_name>
6470
- <docblock line="2766">
6471
  <description><![CDATA[Compose an IPTC Options list with current selection]]></description>
6472
  <long-description><![CDATA[]]></long-description>
6473
- <tag line="2766" name="since" description="1.00"/>
6474
- <tag line="2766" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6475
- <tag line="2766" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
6476
  <type by_reference="false">string</type>
6477
  </tag>
6478
- <tag line="2766" name="return" description="HTML markup with select field options" type="string">
6479
  <type by_reference="false">string</type>
6480
  </tag>
6481
  </docblock>
6482
- <argument line="2776">
6483
  <name>$selection</name>
6484
  <default><![CDATA['none']]></default>
6485
  <type/>
6486
  </argument>
6487
  </method>
6488
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2809" package="Media Library Assistant">
6489
  <name>_compose_parent_option_list</name>
6490
  <full_name>_compose_parent_option_list</full_name>
6491
- <docblock line="2798">
6492
  <description><![CDATA[Compose an hierarchical taxonomy Parent options list with current selection]]></description>
6493
  <long-description><![CDATA[]]></long-description>
6494
- <tag line="2798" name="since" description="1.00"/>
6495
- <tag line="2798" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6496
- <tag line="2798" name="param" description="taxonomy slug" type="string" variable="$taxonomy">
6497
  <type by_reference="false">string</type>
6498
  </tag>
6499
- <tag line="2798" name="param" description="current selection or 0 (zero, default)" type="integer" variable="$selection">
6500
  <type by_reference="false">integer</type>
6501
  </tag>
6502
- <tag line="2798" name="return" description="HTML markup with select field options" type="string">
6503
  <type by_reference="false">string</type>
6504
  </tag>
6505
  </docblock>
6506
- <argument line="2809">
6507
  <name>$taxonomy</name>
6508
  <default><![CDATA[]]></default>
6509
  <type/>
6510
  </argument>
6511
- <argument line="2809">
6512
  <name>$selection</name>
6513
  <default><![CDATA[0]]></default>
6514
  <type/>
6515
  </argument>
6516
  </method>
6517
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2843" package="Media Library Assistant">
6518
  <name>_update_iptc_exif_standard_mapping</name>
6519
  <full_name>_update_iptc_exif_standard_mapping</full_name>
6520
- <docblock line="2833">
6521
  <description><![CDATA[Update Standard field portion of IPTC/EXIF mappings]]></description>
6522
  <long-description><![CDATA[]]></long-description>
6523
- <tag line="2833" name="since" description="1.00"/>
6524
- <tag line="2833" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
6525
  <type by_reference="false">array</type>
6526
  </tag>
6527
- <tag line="2833" name="param" description="new values" type="array" variable="$new_values">
6528
  <type by_reference="false">array</type>
6529
  </tag>
6530
- <tag line="2833" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
6531
  <type by_reference="false">array</type>
6532
  </tag>
6533
  </docblock>
6534
- <argument line="2843">
6535
  <name>$current_values</name>
6536
  <default><![CDATA[]]></default>
6537
  <type/>
6538
  </argument>
6539
- <argument line="2843">
6540
  <name>$new_values</name>
6541
  <default><![CDATA[]]></default>
6542
  <type/>
6543
  </argument>
6544
  </method>
6545
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2922" package="Media Library Assistant">
6546
  <name>_update_iptc_exif_taxonomy_mapping</name>
6547
  <full_name>_update_iptc_exif_taxonomy_mapping</full_name>
6548
- <docblock line="2912">
6549
  <description><![CDATA[Update Taxonomy term portion of IPTC/EXIF mappings]]></description>
6550
  <long-description><![CDATA[]]></long-description>
6551
- <tag line="2912" name="since" description="1.00"/>
6552
- <tag line="2912" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
6553
  <type by_reference="false">array</type>
6554
  </tag>
6555
- <tag line="2912" name="param" description="new values" type="array" variable="$new_values">
6556
  <type by_reference="false">array</type>
6557
  </tag>
6558
- <tag line="2912" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
6559
  <type by_reference="false">array</type>
6560
  </tag>
6561
  </docblock>
6562
- <argument line="2922">
6563
  <name>$current_values</name>
6564
  <default><![CDATA[]]></default>
6565
  <type/>
6566
  </argument>
6567
- <argument line="2922">
6568
  <name>$new_values</name>
6569
  <default><![CDATA[]]></default>
6570
  <type/>
6571
  </argument>
6572
  </method>
6573
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3014" package="Media Library Assistant">
6574
  <name>_update_iptc_exif_custom_mapping</name>
6575
  <full_name>_update_iptc_exif_custom_mapping</full_name>
6576
- <docblock line="3004">
6577
  <description><![CDATA[Update Custom field portion of IPTC/EXIF mappings]]></description>
6578
  <long-description><![CDATA[]]></long-description>
6579
- <tag line="3004" name="since" description="1.00"/>
6580
- <tag line="3004" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
6581
  <type by_reference="false">array</type>
6582
  </tag>
6583
- <tag line="3004" name="param" description="new values" type="array" variable="$new_values">
6584
  <type by_reference="false">array</type>
6585
  </tag>
6586
- <tag line="3004" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
6587
  <type by_reference="false">array</type>
6588
  </tag>
6589
  </docblock>
6590
- <argument line="3014">
6591
  <name>$current_values</name>
6592
  <default><![CDATA[]]></default>
6593
  <type/>
6594
  </argument>
6595
- <argument line="3014">
6596
  <name>$new_values</name>
6597
  <default><![CDATA[]]></default>
6598
  <type/>
6599
  </argument>
6600
  </method>
6601
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3138" package="Media Library Assistant">
6602
  <name>_get_custom_field_names</name>
6603
  <full_name>_get_custom_field_names</full_name>
6604
- <docblock line="3128">
6605
  <description><![CDATA[Generate a list of all (post) Custom Field names]]></description>
6606
  <long-description><![CDATA[<p>The list will include any Custom Field and IPTC/EXIF rules that
6607
  haven't been mapped to any attachments, yet.</p>]]></long-description>
6608
- <tag line="3128" name="since" description="1.00"/>
6609
- <tag line="3128" name="return" description="Custom field names from the postmeta table and MLA rules" type="array">
6610
  <type by_reference="false">array</type>
6611
  </tag>
6612
  </docblock>
6613
  </method>
6614
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="3182" package="Media Library Assistant">
6615
  <name>mla_iptc_exif_option_handler</name>
6616
  <full_name>mla_iptc_exif_option_handler</full_name>
6617
- <docblock line="3169">
6618
  <description><![CDATA[Render and manage iptc/exif support options]]></description>
6619
  <long-description><![CDATA[]]></long-description>
6620
- <tag line="3169" name="since" description="1.00"/>
6621
- <tag line="3169" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6622
- <tag line="3169" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
6623
  <type by_reference="false">string</type>
6624
  </tag>
6625
- <tag line="3169" name="param" description="option name, e.g., 'iptc_exif_mapping'" type="string" variable="$key">
6626
  <type by_reference="false">string</type>
6627
  </tag>
6628
- <tag line="3169" name="param" description="option parameters" type="array" variable="$value">
6629
  <type by_reference="false">array</type>
6630
  </tag>
6631
- <tag line="3169" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
6632
  <type by_reference="false">array</type>
6633
  </tag>
6634
- <tag line="3169" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
6635
  <type by_reference="false">string</type>
6636
  </tag>
6637
  </docblock>
6638
- <argument line="3182">
6639
  <name>$action</name>
6640
  <default><![CDATA[]]></default>
6641
  <type/>
6642
  </argument>
6643
- <argument line="3182">
6644
  <name>$key</name>
6645
  <default><![CDATA[]]></default>
6646
  <type/>
6647
  </argument>
6648
- <argument line="3182">
6649
  <name>$value</name>
6650
  <default><![CDATA[]]></default>
6651
  <type/>
6652
  </argument>
6653
- <argument line="3182">
6654
  <name>$args</name>
6655
  <default><![CDATA[null]]></default>
6656
  <type/>
@@ -6658,7 +6822,7 @@ haven't been mapped to any attachments, yet.</p>]]></long-description>
6658
  </method>
6659
  </class>
6660
  </file>
6661
- <file path="includes\class-mla-settings.php" hash="a5dbf24e70cdaab570b849d840b7daa7" package="Media Library Assistant">
6662
  <docblock line="2">
6663
  <description><![CDATA[Manages the settings page to edit the plugin option settings]]></description>
6664
  <long-description><![CDATA[]]></long-description>
@@ -6748,23 +6912,23 @@ haven't been mapped to any attachments, yet.</p>]]></long-description>
6748
  </tag>
6749
  </docblock>
6750
  </property>
6751
- <property final="false" static="true" visibility="private" line="803" namespace="global" package="Media Library Assistant">
6752
  <name>$page_template_array</name>
6753
  <default><![CDATA[null]]></default>
6754
- <docblock line="793">
6755
  <description><![CDATA[Template file for the Settings page(s) and parts]]></description>
6756
  <long-description><![CDATA[<p>This array contains all of the template parts for the Settings page(s). The array is built once
6757
  each page load and cached for subsequent use.</p>]]></long-description>
6758
- <tag line="793" name="since" description="0.80"/>
6759
- <tag line="793" name="var" description="" type="array">
6760
  <type by_reference="false">array</type>
6761
  </tag>
6762
  </docblock>
6763
  </property>
6764
- <property final="false" static="true" visibility="private" line="819" namespace="global" package="Media Library Assistant">
6765
  <name>$mla_tablist</name>
6766
  <default><![CDATA[array('general' => array('title' => 'General', 'render' => '_compose_general_tab'), 'view' => array('title' => 'Views', 'render' => '_compose_view_tab'), 'upload' => array('title' => 'Uploads', 'render' => '_compose_upload_tab'), 'mla_gallery' => array('title' => 'MLA Gallery', 'render' => '_compose_mla_gallery_tab'), 'custom_field' => array('title' => 'Custom Fields', 'render' => '_compose_custom_field_tab'), 'iptc_exif' => array('title' => 'IPTC/EXIF', 'render' => '_compose_iptc_exif_tab'), 'documentation' => array('title' => 'Documentation', 'render' => '_compose_documentation_tab'))]]></default>
6767
- <docblock line="805">
6768
  <description><![CDATA[Definitions for Settings page tab ids, titles and handlers
6769
  Each tab is defined by an array with the following elements:]]></description>
6770
  <long-description><![CDATA[<p>array key => HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)</p>
@@ -6772,8 +6936,8 @@ Each tab is defined by an array with the following elements:]]></description>
6772
  <p>title => tab label / heading text
6773
  render => rendering function for tab messages and content. Usage:
6774
  $tab_content = <a href="">'render'</a>;</p>]]></long-description>
6775
- <tag line="805" name="since" description="0.80"/>
6776
- <tag line="805" name="var" description="" type="array">
6777
  <type by_reference="false">array</type>
6778
  </tag>
6779
  </docblock>
@@ -6802,791 +6966,791 @@ render => rendering function for tab messages and content. Usage:
6802
  </tag>
6803
  </docblock>
6804
  </method>
6805
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="187" package="Media Library Assistant">
6806
  <name>mla_activation_hook</name>
6807
  <full_name>mla_activation_hook</full_name>
6808
- <docblock line="178">
6809
  <description><![CDATA[Perform one-time actions on plugin activation]]></description>
6810
  <long-description><![CDATA[<p>Adds a view to the database to support sorting the listing on 'ALT Text'.</p>]]></long-description>
6811
- <tag line="178" name="since" description="0.40"/>
6812
- <tag line="178" name="return" description="" type="void">
6813
  <type by_reference="false">void</type>
6814
  </tag>
6815
  </docblock>
6816
  </method>
6817
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="200" package="Media Library Assistant">
6818
  <name>mla_deactivation_hook</name>
6819
  <full_name>mla_deactivation_hook</full_name>
6820
- <docblock line="191">
6821
  <description><![CDATA[Perform one-time actions on plugin deactivation]]></description>
6822
  <long-description><![CDATA[<p>Removes (if present) a view from the database that supports sorting the listing on 'ALT Text'.</p>]]></long-description>
6823
- <tag line="191" name="since" description="0.40"/>
6824
- <tag line="191" name="return" description="" type="void">
6825
  <type by_reference="false">void</type>
6826
  </tag>
6827
  </docblock>
6828
  </method>
6829
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="247" package="Media Library Assistant">
6830
  <name>mla_admin_init_action</name>
6831
  <full_name>mla_admin_init_action</full_name>
6832
- <docblock line="240">
6833
  <description><![CDATA[Load the plugin's Ajax handler]]></description>
6834
  <long-description><![CDATA[]]></long-description>
6835
- <tag line="240" name="since" description="1.40"/>
6836
- <tag line="240" name="return" description="" type="void">
6837
  <type by_reference="false">void</type>
6838
  </tag>
6839
  </docblock>
6840
  </method>
6841
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="261" package="Media Library Assistant">
6842
  <name>mla_admin_enqueue_scripts_action</name>
6843
  <full_name>mla_admin_enqueue_scripts_action</full_name>
6844
- <docblock line="252">
6845
  <description><![CDATA[Load the plugin's Style Sheet and Javascript files]]></description>
6846
  <long-description><![CDATA[]]></long-description>
6847
- <tag line="252" name="since" description="1.40"/>
6848
- <tag line="252" name="param" description="Name of the page being loaded" type="string" variable="$page_hook">
6849
  <type by_reference="false">string</type>
6850
  </tag>
6851
- <tag line="252" name="return" description="" type="void">
6852
  <type by_reference="false">void</type>
6853
  </tag>
6854
  </docblock>
6855
- <argument line="261">
6856
  <name>$page_hook</name>
6857
  <default><![CDATA[]]></default>
6858
  <type/>
6859
  </argument>
6860
  </method>
6861
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="316" package="Media Library Assistant">
6862
  <name>mla_admin_menu_action</name>
6863
  <full_name>mla_admin_menu_action</full_name>
6864
- <docblock line="307">
6865
  <description><![CDATA[Add settings page in the "Settings" section,
6866
  add screen options and help tabs,
6867
  add settings link in the Plugins section entry for MLA.]]></description>
6868
  <long-description><![CDATA[]]></long-description>
6869
- <tag line="307" name="since" description="0.1"/>
6870
- <tag line="307" name="return" description="" type="void">
6871
  <type by_reference="false">void</type>
6872
  </tag>
6873
  </docblock>
6874
  </method>
6875
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="341" package="Media Library Assistant">
6876
  <name>mla_add_menu_options_action</name>
6877
  <full_name>mla_add_menu_options_action</full_name>
6878
- <docblock line="334">
6879
  <description><![CDATA[Add the "XX Entries per page" filter to the Screen Options tab]]></description>
6880
  <long-description><![CDATA[]]></long-description>
6881
- <tag line="334" name="since" description="1.40"/>
6882
- <tag line="334" name="return" description="" type="void">
6883
  <type by_reference="false">void</type>
6884
  </tag>
6885
  </docblock>
6886
  </method>
6887
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="386" package="Media Library Assistant">
6888
  <name>mla_add_help_tab_action</name>
6889
  <full_name>mla_add_help_tab_action</full_name>
6890
- <docblock line="379">
6891
  <description><![CDATA[Add contextual help tabs to all the MLA pages]]></description>
6892
  <long-description><![CDATA[]]></long-description>
6893
- <tag line="379" name="since" description="1.40"/>
6894
- <tag line="379" name="return" description="" type="void">
6895
  <type by_reference="false">void</type>
6896
  </tag>
6897
  </docblock>
6898
  </method>
6899
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="461" package="Media Library Assistant">
6900
  <name>mla_screen_options_show_screen_filter</name>
6901
  <full_name>mla_screen_options_show_screen_filter</full_name>
6902
- <docblock line="451">
6903
  <description><![CDATA[Only show screen options on the View and Upload tabs]]></description>
6904
  <long-description><![CDATA[]]></long-description>
6905
- <tag line="451" name="since" description="1.40"/>
6906
- <tag line="451" name="param" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean" variable="$show_screen">
6907
  <type by_reference="false">boolean</type>
6908
  </tag>
6909
- <tag line="451" name="param" description="Name of the page being loaded" type="string" variable="$this_screen">
6910
  <type by_reference="false">string</type>
6911
  </tag>
6912
- <tag line="451" name="return" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean">
6913
  <type by_reference="false">boolean</type>
6914
  </tag>
6915
  </docblock>
6916
- <argument line="461">
6917
  <name>$show_screen</name>
6918
  <default><![CDATA[]]></default>
6919
  <type/>
6920
  </argument>
6921
- <argument line="461">
6922
  <name>$this_screen</name>
6923
  <default><![CDATA[]]></default>
6924
  <type/>
6925
  </argument>
6926
  </method>
6927
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="481" package="Media Library Assistant">
6928
  <name>mla_set_screen_option_filter</name>
6929
  <full_name>mla_set_screen_option_filter</full_name>
6930
- <docblock line="470">
6931
  <description><![CDATA[Save the "Views/Uploads per page" option set by this user]]></description>
6932
  <long-description><![CDATA[]]></long-description>
6933
- <tag line="470" name="since" description="1.40"/>
6934
- <tag line="470" name="param" description="false or value returned by previous filter" type="mixed" variable="$status">
6935
  <type by_reference="false">mixed</type>
6936
  </tag>
6937
- <tag line="470" name="param" description="Name of the option being changed" type="string" variable="$option">
6938
  <type by_reference="false">string</type>
6939
  </tag>
6940
- <tag line="470" name="param" description="New value of the option" type="string" variable="$value">
6941
  <type by_reference="false">string</type>
6942
  </tag>
6943
- <tag line="470" name="return" description="New value if this is our option, otherwise nothing" type="string|void">
6944
  <type by_reference="false">string</type>
6945
  <type by_reference="false">void</type>
6946
  </tag>
6947
  </docblock>
6948
- <argument line="481">
6949
  <name>$status</name>
6950
  <default><![CDATA[]]></default>
6951
  <type/>
6952
  </argument>
6953
- <argument line="481">
6954
  <name>$option</name>
6955
  <default><![CDATA[]]></default>
6956
  <type/>
6957
  </argument>
6958
- <argument line="481">
6959
  <name>$value</name>
6960
  <default><![CDATA[]]></default>
6961
  <type/>
6962
  </argument>
6963
  </method>
6964
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="497" package="Media Library Assistant">
6965
  <name>mla_inline_edit_view_action</name>
6966
  <full_name>mla_inline_edit_view_action</full_name>
6967
- <docblock line="488">
6968
  <description><![CDATA[Ajax handler for Post MIME Types inline editing (quick and bulk edit)]]></description>
6969
  <long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
6970
- <tag line="488" name="since" description="1.40"/>
6971
- <tag line="488" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
6972
  <type by_reference="false">void</type>
6973
  </tag>
6974
  </docblock>
6975
  </method>
6976
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="539" package="Media Library Assistant">
6977
  <name>mla_inline_edit_upload_action</name>
6978
  <full_name>mla_inline_edit_upload_action</full_name>
6979
- <docblock line="530">
6980
  <description><![CDATA[Ajax handler for Upload MIME Types inline editing (quick and bulk edit)]]></description>
6981
  <long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
6982
- <tag line="530" name="since" description="1.40"/>
6983
- <tag line="530" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
6984
  <type by_reference="false">void</type>
6985
  </tag>
6986
  </docblock>
6987
  </method>
6988
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="578" package="Media Library Assistant">
6989
  <name>mla_add_plugin_settings_link_filter</name>
6990
  <full_name>mla_add_plugin_settings_link_filter</full_name>
6991
- <docblock line="568">
6992
  <description><![CDATA[Add the "Settings" link to the MLA entry in the Plugins section]]></description>
6993
  <long-description><![CDATA[]]></long-description>
6994
- <tag line="568" name="since" description="0.1"/>
6995
- <tag line="568" name="param" description="array of links for the Plugin, e.g., &quot;Activate&quot;" type="array" variable="$links">
6996
  <type by_reference="false">array</type>
6997
  </tag>
6998
- <tag line="568" name="param" description="Directory and name of the plugin Index file" type="string" variable="$file">
6999
  <type by_reference="false">string</type>
7000
  </tag>
7001
- <tag line="568" name="return" description="Updated array of links for the Plugin" type="array">
7002
  <type by_reference="false">array</type>
7003
  </tag>
7004
  </docblock>
7005
- <argument line="578">
7006
  <name>$links</name>
7007
  <default><![CDATA[]]></default>
7008
  <type/>
7009
  </argument>
7010
- <argument line="578">
7011
  <name>$file</name>
7012
  <default><![CDATA[]]></default>
7013
  <type/>
7014
  </argument>
7015
  </method>
7016
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="598" package="Media Library Assistant">
7017
  <name>_update_option_row</name>
7018
  <full_name>_update_option_row</full_name>
7019
- <docblock line="587">
7020
  <description><![CDATA[Update or delete a single MLA option value]]></description>
7021
  <long-description><![CDATA[]]></long-description>
7022
- <tag line="587" name="since" description="0.80"/>
7023
- <tag line="587" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7024
- <tag line="587" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
7025
  <type by_reference="false">string</type>
7026
  </tag>
7027
- <tag line="587" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
7028
  <type by_reference="false">array</type>
7029
  </tag>
7030
- <tag line="587" name="return" description="HTML markup for the option's table row" type="string">
7031
  <type by_reference="false">string</type>
7032
  </tag>
7033
  </docblock>
7034
- <argument line="598">
7035
  <name>$key</name>
7036
  <default><![CDATA[]]></default>
7037
  <type/>
7038
  </argument>
7039
- <argument line="598">
7040
  <name>$value</name>
7041
  <default><![CDATA[]]></default>
7042
  <type/>
7043
  </argument>
7044
  </method>
7045
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="676" package="Media Library Assistant">
7046
  <name>_compose_option_row</name>
7047
  <full_name>_compose_option_row</full_name>
7048
- <docblock line="665">
7049
  <description><![CDATA[Compose the table row for a single MLA option]]></description>
7050
  <long-description><![CDATA[]]></long-description>
7051
- <tag line="665" name="since" description="0.80"/>
7052
- <tag line="665" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7053
- <tag line="665" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
7054
  <type by_reference="false">string</type>
7055
  </tag>
7056
- <tag line="665" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
7057
  <type by_reference="false">array</type>
7058
  </tag>
7059
- <tag line="665" name="return" description="HTML markup for the option's table row" type="string">
7060
  <type by_reference="false">string</type>
7061
  </tag>
7062
  </docblock>
7063
- <argument line="676">
7064
  <name>$key</name>
7065
  <default><![CDATA[]]></default>
7066
  <type/>
7067
  </argument>
7068
- <argument line="676">
7069
  <name>$value</name>
7070
  <default><![CDATA[]]></default>
7071
  <type/>
7072
  </argument>
7073
  </method>
7074
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="839" package="Media Library Assistant">
7075
  <name>_compose_settings_tabs</name>
7076
  <full_name>_compose_settings_tabs</full_name>
7077
- <docblock line="829">
7078
  <description><![CDATA[Compose the navigation tabs for the Settings subpage]]></description>
7079
  <long-description><![CDATA[]]></long-description>
7080
- <tag line="829" name="since" description="0.80"/>
7081
- <tag line="829" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7082
- <tag line="829" name="param" description="Optional data-tab-id value for the active tab, default 'general'" type="string" variable="$active_tab">
7083
  <type by_reference="false">string</type>
7084
  </tag>
7085
- <tag line="829" name="return" description="HTML markup for the Settings subpage navigation tabs" type="string">
7086
  <type by_reference="false">string</type>
7087
  </tag>
7088
  </docblock>
7089
- <argument line="839">
7090
  <name>$active_tab</name>
7091
  <default><![CDATA['general']]></default>
7092
  <type/>
7093
  </argument>
7094
  </method>
7095
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="865" package="Media Library Assistant">
7096
  <name>_compose_general_tab</name>
7097
  <full_name>_compose_general_tab</full_name>
7098
- <docblock line="857">
7099
  <description><![CDATA[Compose the General tab content for the Settings subpage]]></description>
7100
  <long-description><![CDATA[]]></long-description>
7101
- <tag line="857" name="since" description="0.80"/>
7102
- <tag line="857" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7103
- <tag line="857" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7104
  <type by_reference="false">array</type>
7105
  </tag>
7106
  </docblock>
7107
  </method>
7108
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="995" package="Media Library Assistant">
7109
  <name>_current_bulk_action</name>
7110
  <full_name>_current_bulk_action</full_name>
7111
- <docblock line="988">
7112
  <description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
7113
  <long-description><![CDATA[]]></long-description>
7114
- <tag line="988" name="since" description="1.40"/>
7115
- <tag line="988" name="return" description="The action name or False if no action was selected" type="string|false">
7116
  <type by_reference="false">string</type>
7117
  <type by_reference="false">false</type>
7118
  </tag>
7119
  </docblock>
7120
  </method>
7121
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1025" package="Media Library Assistant">
7122
  <name>_compose_edit_view_tab</name>
7123
  <full_name>_compose_edit_view_tab</full_name>
7124
- <docblock line="1015">
7125
  <description><![CDATA[Compose the Edit View tab content for the Settings subpage]]></description>
7126
  <long-description><![CDATA[]]></long-description>
7127
- <tag line="1015" name="since" description="1.40"/>
7128
- <tag line="1015" name="param" description="data values for the item" type="array" variable="$view">
7129
  <type by_reference="false">array</type>
7130
  </tag>
7131
- <tag line="1015" name="param" description="Display template" type="string" variable="$template">
7132
  <type by_reference="false">string</type>
7133
  </tag>
7134
- <tag line="1015" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7135
  <type by_reference="false">array</type>
7136
  </tag>
7137
  </docblock>
7138
- <argument line="1025">
7139
  <name>$view</name>
7140
  <default><![CDATA[]]></default>
7141
  <type/>
7142
  </argument>
7143
- <argument line="1025">
7144
  <name>$template</name>
7145
  <default><![CDATA[]]></default>
7146
  <type/>
7147
  </argument>
7148
  </method>
7149
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1058" package="Media Library Assistant">
7150
  <name>_compose_view_tab</name>
7151
  <full_name>_compose_view_tab</full_name>
7152
- <docblock line="1051">
7153
  <description><![CDATA[Compose the Post MIME Type Views tab content for the Settings subpage]]></description>
7154
  <long-description><![CDATA[]]></long-description>
7155
- <tag line="1051" name="since" description="1.40"/>
7156
- <tag line="1051" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7157
  <type by_reference="false">array</type>
7158
  </tag>
7159
  </docblock>
7160
  </method>
7161
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1284" package="Media Library Assistant">
7162
  <name>mla_get_icon_type_dropdown</name>
7163
  <full_name>mla_get_icon_type_dropdown</full_name>
7164
- <docblock line="1273">
7165
  <description><![CDATA[Get an HTML select element representing a list of icon types]]></description>
7166
  <long-description><![CDATA[]]></long-description>
7167
- <tag line="1273" name="since" description="1.40"/>
7168
- <tag line="1273" name="param" description="Display template array" type="array" variable="$templates">
7169
  <type by_reference="false">array</type>
7170
  </tag>
7171
- <tag line="1273" name="param" description="HTML name attribute value" type="string" variable="$name">
7172
  <type by_reference="false">string</type>
7173
  </tag>
7174
- <tag line="1273" name="param" description="currently selected Icon Type" type="string" variable="$selection">
7175
  <type by_reference="false">string</type>
7176
  </tag>
7177
- <tag line="1273" name="return" description="HTML select element or empty string on failure." type="string">
7178
  <type by_reference="false">string</type>
7179
  </tag>
7180
  </docblock>
7181
- <argument line="1284">
7182
  <name>$templates</name>
7183
  <default><![CDATA[]]></default>
7184
  <type/>
7185
  </argument>
7186
- <argument line="1284">
7187
  <name>$name</name>
7188
  <default><![CDATA[]]></default>
7189
  <type/>
7190
  </argument>
7191
- <argument line="1284">
7192
  <name>$selection</name>
7193
  <default><![CDATA['.none.']]></default>
7194
  <type/>
7195
  </argument>
7196
  </method>
7197
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1325" package="Media Library Assistant">
7198
  <name>_compose_edit_upload_tab</name>
7199
  <full_name>_compose_edit_upload_tab</full_name>
7200
- <docblock line="1315">
7201
  <description><![CDATA[Compose the Edit Upload type tab content for the Settings subpage]]></description>
7202
  <long-description><![CDATA[]]></long-description>
7203
- <tag line="1315" name="since" description="1.40"/>
7204
- <tag line="1315" name="param" description="data values for the item" type="array" variable="$item">
7205
  <type by_reference="false">array</type>
7206
  </tag>
7207
- <tag line="1315" name="param" description="Display template array" type="string" variable="$templates">
7208
  <type by_reference="false">string</type>
7209
  </tag>
7210
- <tag line="1315" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7211
  <type by_reference="false">array</type>
7212
  </tag>
7213
  </docblock>
7214
- <argument line="1325">
7215
  <name>$item</name>
7216
  <default><![CDATA[]]></default>
7217
  <type/>
7218
  </argument>
7219
- <argument line="1325">
7220
  <name>$templates</name>
7221
  <default><![CDATA[]]></default>
7222
  <type/>
7223
  </argument>
7224
  </method>
7225
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1360" package="Media Library Assistant">
7226
  <name>_compose_optional_upload_tab</name>
7227
  <full_name>_compose_optional_upload_tab</full_name>
7228
- <docblock line="1351">
7229
  <description><![CDATA[Compose the Optional File Upload MIME Types tab content for the Settings subpage]]></description>
7230
  <long-description><![CDATA[]]></long-description>
7231
- <tag line="1351" name="since" description="1.40"/>
7232
- <tag line="1351" name="param" description="Display templates" type="string" variable="$page_template_array">
7233
  <type by_reference="false">string</type>
7234
  </tag>
7235
- <tag line="1351" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7236
  <type by_reference="false">array</type>
7237
  </tag>
7238
  </docblock>
7239
- <argument line="1360">
7240
  <name>$page_template_array</name>
7241
  <default><![CDATA[]]></default>
7242
  <type/>
7243
  </argument>
7244
  </method>
7245
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1426" package="Media Library Assistant">
7246
  <name>_process_optional_upload_mime</name>
7247
  <full_name>_process_optional_upload_mime</full_name>
7248
- <docblock line="1417">
7249
  <description><![CDATA[Process an Optional Upload MIME Type selection]]></description>
7250
  <long-description><![CDATA[]]></long-description>
7251
- <tag line="1417" name="since" description="1.40"/>
7252
- <tag line="1417" name="param" description="MLA Optional Upload MIME Type ID" type="\intger" variable="$ID">
7253
  <type by_reference="false">\intger</type>
7254
  </tag>
7255
- <tag line="1417" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7256
  <type by_reference="false">array</type>
7257
  </tag>
7258
  </docblock>
7259
- <argument line="1426">
7260
  <name>$ID</name>
7261
  <default><![CDATA[]]></default>
7262
  <type/>
7263
  </argument>
7264
  </method>
7265
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1446" package="Media Library Assistant">
7266
  <name>_compose_upload_tab</name>
7267
  <full_name>_compose_upload_tab</full_name>
7268
- <docblock line="1439">
7269
  <description><![CDATA[Compose the File Upload MIME Types tab content for the Settings subpage]]></description>
7270
  <long-description><![CDATA[]]></long-description>
7271
- <tag line="1439" name="since" description="1.40"/>
7272
- <tag line="1439" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7273
  <type by_reference="false">array</type>
7274
  </tag>
7275
  </docblock>
7276
  </method>
7277
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1701" package="Media Library Assistant">
7278
  <name>_compose_mla_gallery_tab</name>
7279
  <full_name>_compose_mla_gallery_tab</full_name>
7280
- <docblock line="1693">
7281
  <description><![CDATA[Compose the MLA Gallery tab content for the Settings subpage]]></description>
7282
  <long-description><![CDATA[]]></long-description>
7283
- <tag line="1693" name="since" description="0.80"/>
7284
- <tag line="1693" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7285
- <tag line="1693" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7286
  <type by_reference="false">array</type>
7287
  </tag>
7288
  </docblock>
7289
  </method>
7290
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2005" package="Media Library Assistant">
7291
  <name>_compose_custom_field_tab</name>
7292
  <full_name>_compose_custom_field_tab</full_name>
7293
- <docblock line="1997">
7294
  <description><![CDATA[Compose the Custom Field tab content for the Settings subpage]]></description>
7295
  <long-description><![CDATA[]]></long-description>
7296
- <tag line="1997" name="since" description="1.10"/>
7297
- <tag line="1997" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7298
- <tag line="1997" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7299
  <type by_reference="false">array</type>
7300
  </tag>
7301
  </docblock>
7302
  </method>
7303
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2112" package="Media Library Assistant">
7304
  <name>_compose_iptc_exif_tab</name>
7305
  <full_name>_compose_iptc_exif_tab</full_name>
7306
- <docblock line="2104">
7307
  <description><![CDATA[Compose the IPTC/EXIF tab content for the Settings subpage]]></description>
7308
  <long-description><![CDATA[]]></long-description>
7309
- <tag line="2104" name="since" description="1.00"/>
7310
- <tag line="2104" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7311
- <tag line="2104" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7312
  <type by_reference="false">array</type>
7313
  </tag>
7314
  </docblock>
7315
  </method>
7316
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2221" package="Media Library Assistant">
7317
  <name>_compose_documentation_tab</name>
7318
  <full_name>_compose_documentation_tab</full_name>
7319
- <docblock line="2213">
7320
  <description><![CDATA[Compose the Documentation tab content for the Settings subpage]]></description>
7321
  <long-description><![CDATA[]]></long-description>
7322
- <tag line="2213" name="since" description="0.80"/>
7323
- <tag line="2213" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7324
- <tag line="2213" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7325
  <type by_reference="false">array</type>
7326
  </tag>
7327
  </docblock>
7328
  </method>
7329
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2241" package="Media Library Assistant">
7330
  <name>mla_render_settings_page</name>
7331
  <full_name>mla_render_settings_page</full_name>
7332
- <docblock line="2234">
7333
  <description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
7334
  <long-description><![CDATA[]]></long-description>
7335
- <tag line="2234" name="since" description="0.1"/>
7336
- <tag line="2234" name="return" description="Echoes HTML markup for the Settings subpage" type="void">
7337
  <type by_reference="false">void</type>
7338
  </tag>
7339
  </docblock>
7340
  </method>
7341
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2300" package="Media Library Assistant">
7342
  <name>_save_gallery_settings</name>
7343
  <full_name>_save_gallery_settings</full_name>
7344
- <docblock line="2291">
7345
  <description><![CDATA[Save MLA Gallery settings to the options table]]></description>
7346
  <long-description><![CDATA[]]></long-description>
7347
- <tag line="2291" name="since" description="0.80"/>
7348
- <tag line="2291" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7349
- <tag line="2291" name="return" description="Message(s) reflecting the results of the operation" type="array">
7350
  <type by_reference="false">array</type>
7351
  </tag>
7352
  </docblock>
7353
  </method>
7354
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2543" package="Media Library Assistant">
7355
  <name>_save_view_settings</name>
7356
  <full_name>_save_view_settings</full_name>
7357
- <docblock line="2534">
7358
  <description><![CDATA[Save View settings to the options table]]></description>
7359
  <long-description><![CDATA[]]></long-description>
7360
- <tag line="2534" name="since" description="1.40"/>
7361
- <tag line="2534" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7362
- <tag line="2534" name="return" description="Message(s) reflecting the results of the operation" type="array">
7363
  <type by_reference="false">array</type>
7364
  </tag>
7365
  </docblock>
7366
  </method>
7367
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2574" package="Media Library Assistant">
7368
  <name>_save_upload_settings</name>
7369
  <full_name>_save_upload_settings</full_name>
7370
- <docblock line="2565">
7371
  <description><![CDATA[Save Upload settings to the options table]]></description>
7372
  <long-description><![CDATA[]]></long-description>
7373
- <tag line="2565" name="since" description="1.40"/>
7374
- <tag line="2565" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7375
- <tag line="2565" name="return" description="Message(s) reflecting the results of the operation" type="array">
7376
  <type by_reference="false">array</type>
7377
  </tag>
7378
  </docblock>
7379
  </method>
7380
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2610" package="Media Library Assistant">
7381
  <name>_process_custom_field_mapping</name>
7382
  <full_name>_process_custom_field_mapping</full_name>
7383
- <docblock line="2599">
7384
  <description><![CDATA[Process custom field settings against all image attachments
7385
  without saving the settings to the mla_option]]></description>
7386
  <long-description><![CDATA[]]></long-description>
7387
- <tag line="2599" name="since" description="1.10"/>
7388
- <tag line="2599" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7389
- <tag line="2599" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$settings">
7390
  <type by_reference="false">array</type>
7391
  </tag>
7392
- <tag line="2599" name="return" description="Message(s) reflecting the results of the operation" type="array">
7393
  <type by_reference="false">array</type>
7394
  </tag>
7395
  </docblock>
7396
- <argument line="2610">
7397
  <name>$settings</name>
7398
  <default><![CDATA[NULL]]></default>
7399
  <type/>
7400
  </argument>
7401
  </method>
7402
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2662" package="Media Library Assistant">
7403
  <name>_delete_custom_field</name>
7404
  <full_name>_delete_custom_field</full_name>
7405
- <docblock line="2653">
7406
  <description><![CDATA[Delete a custom field from the wp_postmeta table]]></description>
7407
  <long-description><![CDATA[]]></long-description>
7408
- <tag line="2653" name="since" description="1.10"/>
7409
- <tag line="2653" name="param" description="specific custom_field_mapping rule" type="array" variable="$value">
7410
  <type by_reference="false">array</type>
7411
  </tag>
7412
- <tag line="2653" name="return" description="Message(s) reflecting the results of the operation" type="array">
7413
  <type by_reference="false">array</type>
7414
  </tag>
7415
  </docblock>
7416
- <argument line="2662">
7417
  <name>$value</name>
7418
  <default><![CDATA[]]></default>
7419
  <type/>
7420
  </argument>
7421
  </method>
7422
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2686" package="Media Library Assistant">
7423
  <name>_save_custom_field_settings</name>
7424
  <full_name>_save_custom_field_settings</full_name>
7425
- <docblock line="2676">
7426
  <description><![CDATA[Save custom field settings to the options table]]></description>
7427
  <long-description><![CDATA[]]></long-description>
7428
- <tag line="2676" name="since" description="1.10"/>
7429
- <tag line="2676" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7430
- <tag line="2676" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$new_values">
7431
  <type by_reference="false">array</type>
7432
  </tag>
7433
- <tag line="2676" name="return" description="Message(s) reflecting the results of the operation" type="array">
7434
  <type by_reference="false">array</type>
7435
  </tag>
7436
  </docblock>
7437
- <argument line="2686">
7438
  <name>$new_values</name>
7439
  <default><![CDATA[NULL]]></default>
7440
  <type/>
7441
  </argument>
7442
  </method>
7443
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2726" package="Media Library Assistant">
7444
  <name>_process_iptc_exif_standard</name>
7445
  <full_name>_process_iptc_exif_standard</full_name>
7446
- <docblock line="2716">
7447
  <description><![CDATA[Process IPTC/EXIF standard field settings against all image attachments
7448
  without saving the settings to the mla_option]]></description>
7449
  <long-description><![CDATA[]]></long-description>
7450
- <tag line="2716" name="since" description="1.00"/>
7451
- <tag line="2716" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7452
- <tag line="2716" name="return" description="Message(s) reflecting the results of the operation" type="array">
7453
  <type by_reference="false">array</type>
7454
  </tag>
7455
  </docblock>
7456
  </method>
7457
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2778" package="Media Library Assistant">
7458
  <name>_process_iptc_exif_taxonomy</name>
7459
  <full_name>_process_iptc_exif_taxonomy</full_name>
7460
- <docblock line="2768">
7461
  <description><![CDATA[Process IPTC/EXIF taxonomy term settings against all image attachments
7462
  without saving the settings to the mla_option]]></description>
7463
  <long-description><![CDATA[]]></long-description>
7464
- <tag line="2768" name="since" description="1.00"/>
7465
- <tag line="2768" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7466
- <tag line="2768" name="return" description="Message(s) reflecting the results of the operation" type="array">
7467
  <type by_reference="false">array</type>
7468
  </tag>
7469
  </docblock>
7470
  </method>
7471
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2833" package="Media Library Assistant">
7472
  <name>_process_iptc_exif_custom</name>
7473
  <full_name>_process_iptc_exif_custom</full_name>
7474
- <docblock line="2821">
7475
  <description><![CDATA[Process IPTC/EXIF custom field settings against all image attachments
7476
  without saving the settings to the mla_option]]></description>
7477
  <long-description><![CDATA[]]></long-description>
7478
- <tag line="2821" name="since" description="1.00"/>
7479
- <tag line="2821" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7480
- <tag line="2821" name="param" description="| NULL specific iptc_exif_custom_mapping values" type="array" variable="$settings">
7481
  <type by_reference="false">array</type>
7482
  </tag>
7483
- <tag line="2821" name="return" description="Message(s) reflecting the results of the operation" type="array">
7484
  <type by_reference="false">array</type>
7485
  </tag>
7486
  </docblock>
7487
- <argument line="2833">
7488
  <name>$settings</name>
7489
  <default><![CDATA[NULL]]></default>
7490
  <type/>
7491
  </argument>
7492
  </method>
7493
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2893" package="Media Library Assistant">
7494
  <name>_save_iptc_exif_custom_settings</name>
7495
  <full_name>_save_iptc_exif_custom_settings</full_name>
7496
- <docblock line="2884">
7497
  <description><![CDATA[Save IPTC/EXIF custom field settings to the options table]]></description>
7498
  <long-description><![CDATA[]]></long-description>
7499
- <tag line="2884" name="since" description="1.30"/>
7500
- <tag line="2884" name="param" description="specific iptc_exif_custom_mapping values" type="array" variable="$new_values">
7501
  <type by_reference="false">array</type>
7502
  </tag>
7503
- <tag line="2884" name="return" description="Message(s) reflecting the results of the operation" type="array">
7504
  <type by_reference="false">array</type>
7505
  </tag>
7506
  </docblock>
7507
- <argument line="2893">
7508
  <name>$new_values</name>
7509
  <default><![CDATA[]]></default>
7510
  <type/>
7511
  </argument>
7512
  </method>
7513
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2909" package="Media Library Assistant">
7514
  <name>_save_iptc_exif_settings</name>
7515
  <full_name>_save_iptc_exif_settings</full_name>
7516
- <docblock line="2900">
7517
  <description><![CDATA[Save IPTC/EXIF settings to the options table]]></description>
7518
  <long-description><![CDATA[]]></long-description>
7519
- <tag line="2900" name="since" description="1.00"/>
7520
- <tag line="2900" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7521
- <tag line="2900" name="return" description="Message(s) reflecting the results of the operation" type="array">
7522
  <type by_reference="false">array</type>
7523
  </tag>
7524
  </docblock>
7525
  </method>
7526
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2946" package="Media Library Assistant">
7527
  <name>_save_general_settings</name>
7528
  <full_name>_save_general_settings</full_name>
7529
- <docblock line="2937">
7530
  <description><![CDATA[Save General settings to the options table]]></description>
7531
  <long-description><![CDATA[]]></long-description>
7532
- <tag line="2937" name="since" description="0.1"/>
7533
- <tag line="2937" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7534
- <tag line="2937" name="return" description="Message(s) reflecting the results of the operation" type="array">
7535
  <type by_reference="false">array</type>
7536
  </tag>
7537
  </docblock>
7538
  </method>
7539
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3004" package="Media Library Assistant">
7540
  <name>_reset_general_settings</name>
7541
  <full_name>_reset_general_settings</full_name>
7542
- <docblock line="2997">
7543
  <description><![CDATA[Delete saved settings, restoring default values]]></description>
7544
  <long-description><![CDATA[]]></long-description>
7545
- <tag line="2997" name="since" description="0.1"/>
7546
- <tag line="2997" name="return" description="Message(s) reflecting the results of the operation" type="array">
7547
  <type by_reference="false">array</type>
7548
  </tag>
7549
  </docblock>
7550
  </method>
7551
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3044" package="Media Library Assistant">
7552
  <name>_compose_import_settings</name>
7553
  <full_name>_compose_import_settings</full_name>
7554
- <docblock line="3037">
7555
  <description><![CDATA[Compose HTML markup for the import settings if any settings files exist]]></description>
7556
  <long-description><![CDATA[]]></long-description>
7557
- <tag line="3037" name="since" description="1.50"/>
7558
- <tag line="3037" name="return" description="HTML markup for the Import All Settings button and dropdown list, if any" type="string">
7559
  <type by_reference="false">string</type>
7560
  </tag>
7561
  </docblock>
7562
  </method>
7563
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3097" package="Media Library Assistant">
7564
  <name>_export_settings</name>
7565
  <full_name>_export_settings</full_name>
7566
- <docblock line="3088">
7567
  <description><![CDATA[Serialize option settings and write them to a file]]></description>
7568
  <long-description><![CDATA[<p>Options with a default value, i.e., not stored in the database are NOT written to the file.</p>]]></long-description>
7569
- <tag line="3088" name="since" description="1.50"/>
7570
- <tag line="3088" name="return" description="Message(s) reflecting the results of the operation" type="array">
7571
  <type by_reference="false">array</type>
7572
  </tag>
7573
  </docblock>
7574
  </method>
7575
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3177" package="Media Library Assistant">
7576
  <name>_import_settings</name>
7577
  <full_name>_import_settings</full_name>
7578
- <docblock line="3170">
7579
  <description><![CDATA[Read a serialized file of option settings and write them to the database]]></description>
7580
  <long-description><![CDATA[]]></long-description>
7581
- <tag line="3170" name="since" description="1.50"/>
7582
- <tag line="3170" name="return" description="Message(s) reflecting the results of the operation" type="array">
7583
  <type by_reference="false">array</type>
7584
  </tag>
7585
  </docblock>
7586
  </method>
7587
  </class>
7588
  </file>
7589
- <file path="includes\class-mla-shortcodes.php" hash="40e5a6902721eb61d6b4f44ed5055607" package="Media Library Assistant">
7590
  <docblock line="2">
7591
  <description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
7592
  <long-description><![CDATA[]]></long-description>
@@ -7603,34 +7767,34 @@ without saving the settings to the mla_option]]></description>
7603
  <tag line="9" name="package" description="Media Library Assistant"/>
7604
  <tag line="9" name="since" description="0.20"/>
7605
  </docblock>
7606
- <property final="false" static="true" visibility="public" line="134" namespace="global" package="Media Library Assistant">
7607
  <name>$mla_debug_messages</name>
7608
  <default><![CDATA['']]></default>
7609
- <docblock line="127">
7610
  <description><![CDATA[Accumulates debug messages]]></description>
7611
  <long-description><![CDATA[]]></long-description>
7612
- <tag line="127" name="since" description="0.60"/>
7613
- <tag line="127" name="var" description="" type="string">
7614
  <type by_reference="false">string</type>
7615
  </tag>
7616
  </docblock>
7617
  </property>
7618
- <property final="false" static="true" visibility="private" line="143" namespace="global" package="Media Library Assistant">
7619
  <name>$mla_debug</name>
7620
  <default><![CDATA[false]]></default>
7621
- <docblock line="136">
7622
  <description><![CDATA[Turn debug collection and display on or off]]></description>
7623
  <long-description><![CDATA[]]></long-description>
7624
- <tag line="136" name="since" description="0.70"/>
7625
- <tag line="136" name="var" description="" type="boolean">
7626
  <type by_reference="false">boolean</type>
7627
  </tag>
7628
  </docblock>
7629
  </property>
7630
- <property final="false" static="true" visibility="private" line="1311" namespace="global" package="Media Library Assistant">
7631
  <name>$query_parameters</name>
7632
  <default><![CDATA[array()]]></default>
7633
- <docblock line="1297">
7634
  <description><![CDATA[WP_Query filter "parameters"]]></description>
7635
  <long-description><![CDATA[<p>This array defines parameters for the query's where and orderby filters,
7636
  mla_shortcode_query_posts_where_filter and mla_shortcode_query_posts_orderby_filter.
@@ -7638,37 +7802,49 @@ The parameters are set up in the mla_get_shortcode_attachments function, and
7638
  any further logic required to translate those values is contained in the filter.</p>
7639
 
7640
  <p>Array index values are: orderby, post_parent</p>]]></long-description>
7641
- <tag line="1297" name="since" description="1.13"/>
7642
- <tag line="1297" name="var" description="" type="array">
7643
  <type by_reference="false">array</type>
7644
  </tag>
7645
  </docblock>
7646
  </property>
7647
- <property final="false" static="true" visibility="private" line="1420" namespace="global" package="Media Library Assistant">
7648
- <name>$data_selection_parameters</name>
7649
  <default><![CDATA[array('order' => 'ASC', 'orderby' => 'menu_order,ID', 'id' => NULL, 'ids' => array(), 'include' => array(), 'exclude' => array(), 'post_parent' => NULL, 'author' => NULL, 'author_name' => '', 'cat' => 0, 'category_name' => '', 'category__and' => array(), 'category__in' => array(), 'category__not_in' => array(), 'tag' => '', 'tag_id' => 0, 'tag__and' => array(), 'tag__in' => array(), 'tag__not_in' => array(), 'tag_slug__and' => array(), 'tag_slug__in' => array(), 'tax_operator' => '', 'tax_include_children' => true, 'post_type' => 'attachment', 'post_status' => 'inherit', 'post_mime_type' => 'image', 'nopaging' => true, 'numberposts' => 0, 'posts_per_page' => 0, 'posts_per_archive_page' => 0, 'paged' => NULL, 'offset' => NULL, 'mla_page_parameter' => 'mla_paginate_current', 'mla_paginate_current' => NULL, 'mla_paginate_total' => NULL, 'meta_key' => '', 'meta_value' => '', 'meta_value_num' => NULL, 'meta_compare' => '', 'meta_query' => '', 's' => '')]]></default>
7650
- <docblock line="1413">
7651
  <description><![CDATA[Data selection parameters for the WP_Query in [mla_gallery]]]></description>
7652
  <long-description><![CDATA[]]></long-description>
7653
- <tag line="1413" name="since" description="1.30"/>
7654
- <tag line="1413" name="var" description="" type="array">
7655
  <type by_reference="false">array</type>
7656
  </tag>
7657
  </docblock>
7658
  </property>
7659
- <property final="false" static="true" visibility="public" line="1487" namespace="global" package="Media Library Assistant">
7660
  <name>$mla_gallery_wp_query_object</name>
7661
  <default><![CDATA[NULL]]></default>
7662
- <docblock line="1477">
7663
  <description><![CDATA[The WP_Query object used to select items for the gallery.]]></description>
7664
  <long-description><![CDATA[<p>Defined as a public, static variable so it can be inspected from the
7665
  "mla_gallery_wp_query_object" action. Set to NULL at all other times.</p>]]></long-description>
7666
- <tag line="1477" name="since" description="1.51"/>
7667
- <tag line="1477" name="var" description="" type="object">
7668
  <type by_reference="false">object</type>
7669
  </tag>
7670
  </docblock>
7671
  </property>
 
 
 
 
 
 
 
 
 
 
 
 
7672
  <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="23" package="Media Library Assistant">
7673
  <name>initialize</name>
7674
  <full_name>initialize</full_name>
@@ -7681,344 +7857,440 @@ any further logic required to translate those values is contained in the filter.
7681
  </tag>
7682
  </docblock>
7683
  </method>
7684
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="35" package="Media Library Assistant">
7685
  <name>mla_attachment_list_shortcode</name>
7686
  <full_name>mla_attachment_list_shortcode</full_name>
7687
- <docblock line="28">
7688
  <description><![CDATA[WordPress Shortcode; renders a complete list of all attachments and references to them]]></description>
7689
  <long-description><![CDATA[]]></long-description>
7690
- <tag line="28" name="since" description="0.1"/>
7691
- <tag line="28" name="return" description="echoes HTML markup for the attachment list" type="void">
7692
  <type by_reference="false">void</type>
7693
  </tag>
7694
  </docblock>
7695
  </method>
7696
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="158" package="Media Library Assistant">
7697
  <name>mla_gallery_shortcode</name>
7698
  <full_name>mla_gallery_shortcode</full_name>
7699
- <docblock line="145">
7700
  <description><![CDATA[The MLA Gallery shortcode.]]></description>
7701
  <long-description><![CDATA[<p>This is a superset of the WordPress Gallery shortcode for displaying images on a post,
7702
  page or custom post type. It is adapted from /wp-includes/media.php gallery_shortcode.
7703
  Enhancements include many additional selection parameters and full taxonomy support.</p>]]></long-description>
7704
- <tag line="145" name="since" description=".50"/>
7705
- <tag line="145" name="param" description="Attributes of the shortcode." type="array" variable="$attr">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
7706
  <type by_reference="false">array</type>
7707
  </tag>
7708
- <tag line="145" name="return" description="HTML content to display gallery." type="string">
7709
  <type by_reference="false">string</type>
7710
  </tag>
7711
  </docblock>
7712
- <argument line="158">
7713
  <name>$attr</name>
7714
  <default><![CDATA[]]></default>
7715
  <type/>
7716
  </argument>
7717
  </method>
7718
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="976" package="Media Library Assistant">
7719
  <name>_process_shortcode_parameter</name>
7720
  <full_name>_process_shortcode_parameter</full_name>
7721
- <docblock line="966">
7722
  <description><![CDATA[Handles brace/bracket escaping and parses template for a shortcode parameter]]></description>
7723
  <long-description><![CDATA[]]></long-description>
7724
- <tag line="966" name="since" description="1.14"/>
7725
- <tag line="966" name="param" description="raw shortcode parameter, e.g., &quot;text {+field+} {brackets} \\{braces\\}&quot;" type="string" variable="$text">
7726
  <type by_reference="false">string</type>
7727
  </tag>
7728
- <tag line="966" name="param" description="template substitution values, e.g., ('instance' =&gt; '1', ... )" type="string" variable="$markup_values">
7729
  <type by_reference="false">string</type>
7730
  </tag>
7731
- <tag line="966" name="return" description="query specification with HTML escape sequences and line breaks removed" type="string">
7732
  <type by_reference="false">string</type>
7733
  </tag>
7734
  </docblock>
7735
- <argument line="976">
7736
  <name>$text</name>
7737
  <default><![CDATA[]]></default>
7738
  <type/>
7739
  </argument>
7740
- <argument line="976">
7741
  <name>$markup_values</name>
7742
  <default><![CDATA[]]></default>
7743
  <type/>
7744
  </argument>
7745
  </method>
7746
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="995" package="Media Library Assistant">
7747
  <name>_paginate_links</name>
7748
  <full_name>_paginate_links</full_name>
7749
- <docblock line="982">
7750
  <description><![CDATA[Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links']]></description>
7751
  <long-description><![CDATA[]]></long-description>
7752
- <tag line="982" name="since" description="1.42"/>
7753
- <tag line="982" name="param" description="value(s) for mla_output_type parameter" type="array" variable="$output_parameters">
7754
  <type by_reference="false">array</type>
7755
  </tag>
7756
- <tag line="982" name="param" description="template substitution values, e.g., ('instance' =&gt; '1', ... )" type="string" variable="$markup_values">
7757
  <type by_reference="false">string</type>
7758
  </tag>
7759
- <tag line="982" name="param" description="merged default and passed shortcode parameter values" type="string" variable="$arguments">
7760
  <type by_reference="false">string</type>
7761
  </tag>
7762
- <tag line="982" name="param" description="number of attachments in the gallery, without pagination" type="integer" variable="$found_rows">
7763
  <type by_reference="false">integer</type>
7764
  </tag>
7765
- <tag line="982" name="param" description="output text so far, may include debug values" type="string" variable="$output">
7766
  <type by_reference="false">string</type>
7767
  </tag>
7768
- <tag line="982" name="return" description="false or string with HTML for pagination output types" type="mixed">
7769
  <type by_reference="false">mixed</type>
7770
  </tag>
7771
  </docblock>
7772
- <argument line="995">
7773
  <name>$output_parameters</name>
7774
  <default><![CDATA[]]></default>
7775
  <type/>
7776
  </argument>
7777
- <argument line="995">
7778
  <name>$markup_values</name>
7779
  <default><![CDATA[]]></default>
7780
  <type/>
7781
  </argument>
7782
- <argument line="995">
7783
  <name>$arguments</name>
7784
  <default><![CDATA[]]></default>
7785
  <type/>
7786
  </argument>
7787
- <argument line="995">
7788
  <name>$found_rows</name>
7789
  <default><![CDATA[]]></default>
7790
  <type/>
7791
  </argument>
7792
- <argument line="995">
7793
  <name>$output</name>
7794
  <default><![CDATA['']]></default>
7795
  <type/>
7796
  </argument>
7797
  </method>
7798
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1124" package="Media Library Assistant">
7799
  <name>_process_pagination_output_types</name>
7800
  <full_name>_process_pagination_output_types</full_name>
7801
- <docblock line="1110">
7802
  <description><![CDATA[Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links']]></description>
7803
  <long-description><![CDATA[]]></long-description>
7804
- <tag line="1110" name="since" description="1.42"/>
7805
- <tag line="1110" name="param" description="value(s) for mla_output_type parameter" type="array" variable="$output_parameters">
7806
  <type by_reference="false">array</type>
7807
  </tag>
7808
- <tag line="1110" name="param" description="template substitution values, e.g., ('instance' =&gt; '1', ... )" type="string" variable="$markup_values">
7809
  <type by_reference="false">string</type>
7810
  </tag>
7811
- <tag line="1110" name="param" description="merged default and passed shortcode parameter values" type="string" variable="$arguments">
7812
  <type by_reference="false">string</type>
7813
  </tag>
7814
- <tag line="1110" name="param" description="raw passed shortcode parameter values" type="string" variable="$attr">
7815
  <type by_reference="false">string</type>
7816
  </tag>
7817
- <tag line="1110" name="param" description="number of attachments in the gallery, without pagination" type="integer" variable="$found_rows">
7818
  <type by_reference="false">integer</type>
7819
  </tag>
7820
- <tag line="1110" name="param" description="output text so far, may include debug values" type="string" variable="$output">
7821
  <type by_reference="false">string</type>
7822
  </tag>
7823
- <tag line="1110" name="return" description="false or string with HTML for pagination output types" type="mixed">
7824
  <type by_reference="false">mixed</type>
7825
  </tag>
7826
  </docblock>
7827
- <argument line="1124">
7828
  <name>$output_parameters</name>
7829
  <default><![CDATA[]]></default>
7830
  <type/>
7831
  </argument>
7832
- <argument line="1124">
7833
  <name>$markup_values</name>
7834
  <default><![CDATA[]]></default>
7835
  <type/>
7836
  </argument>
7837
- <argument line="1124">
7838
  <name>$arguments</name>
7839
  <default><![CDATA[]]></default>
7840
  <type/>
7841
  </argument>
7842
- <argument line="1124">
7843
  <name>$attr</name>
7844
  <default><![CDATA[]]></default>
7845
  <type/>
7846
  </argument>
7847
- <argument line="1124">
7848
  <name>$found_rows</name>
7849
  <default><![CDATA[]]></default>
7850
  <type/>
7851
  </argument>
7852
- <argument line="1124">
7853
  <name>$output</name>
7854
  <default><![CDATA['']]></default>
7855
  <type/>
7856
  </argument>
7857
  </method>
7858
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1322" package="Media Library Assistant">
7859
  <name>_sanitize_query_specification</name>
7860
  <full_name>_sanitize_query_specification</full_name>
7861
- <docblock line="1313">
7862
  <description><![CDATA[Cleans up damage caused by the Visual Editor to the tax_query and meta_query specifications]]></description>
7863
  <long-description><![CDATA[]]></long-description>
7864
- <tag line="1313" name="since" description="1.14"/>
7865
- <tag line="1313" name="param" description="query specification; PHP nested arrays" type="string" variable="$specification">
7866
  <type by_reference="false">string</type>
7867
  </tag>
7868
- <tag line="1313" name="return" description="query specification with HTML escape sequences and line breaks removed" type="string">
7869
  <type by_reference="false">string</type>
7870
  </tag>
7871
  </docblock>
7872
- <argument line="1322">
7873
  <name>$specification</name>
7874
  <default><![CDATA[]]></default>
7875
  <type/>
7876
  </argument>
7877
  </method>
7878
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1339" package="Media Library Assistant">
7879
  <name>_validate_sql_orderby</name>
7880
  <full_name>_validate_sql_orderby</full_name>
7881
- <docblock line="1328">
7882
  <description><![CDATA[Translates query parameters to a valid SQL order by clause.]]></description>
7883
  <long-description><![CDATA[<p>Accepts one or more valid columns, with or without ASC/DESC.
7884
  Enhanced version of /wp-includes/formatting.php function sanitize_sql_orderby().</p>]]></long-description>
7885
- <tag line="1328" name="since" description="1.20"/>
7886
- <tag line="1328" name="param" description="Validated query parameters" type="array" variable="$query_parameters">
7887
  <type by_reference="false">array</type>
7888
  </tag>
7889
- <tag line="1328" name="return" description="Returns the orderby clause if present, false otherwise." type="string|bool">
7890
  <type by_reference="false">string</type>
7891
  <type by_reference="false">bool</type>
7892
  </tag>
7893
  </docblock>
7894
- <argument line="1339">
7895
  <name>$query_parameters</name>
7896
  <default><![CDATA[]]></default>
7897
  <type/>
7898
  </argument>
7899
  </method>
7900
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1500" package="Media Library Assistant">
7901
  <name>mla_get_shortcode_attachments</name>
7902
  <full_name>mla_get_shortcode_attachments</full_name>
7903
- <docblock line="1489">
7904
  <description><![CDATA[Parses shortcode parameters and returns the gallery objects]]></description>
7905
  <long-description><![CDATA[]]></long-description>
7906
- <tag line="1489" name="since" description=".50"/>
7907
- <tag line="1489" name="param" description="Post ID of the parent" type="int" variable="$post_parent">
7908
  <type by_reference="false">int</type>
7909
  </tag>
7910
- <tag line="1489" name="param" description="Attributes of the shortcode" type="array" variable="$attr">
7911
  <type by_reference="false">array</type>
7912
  </tag>
7913
- <tag line="1489" name="param" description="true to calculate and return ['found_posts'] as an array element" type="boolean" variable="$return_found_rows">
7914
  <type by_reference="false">boolean</type>
7915
  </tag>
7916
- <tag line="1489" name="return" description="List of attachments returned from WP_Query" type="array">
7917
  <type by_reference="false">array</type>
7918
  </tag>
7919
  </docblock>
7920
- <argument line="1500">
7921
  <name>$post_parent</name>
7922
  <default><![CDATA[]]></default>
7923
  <type/>
7924
  </argument>
7925
- <argument line="1500">
7926
  <name>$attr</name>
7927
  <default><![CDATA[]]></default>
7928
  <type/>
7929
  </argument>
7930
- <argument line="1500">
7931
  <name>$return_found_rows</name>
7932
  <default><![CDATA[NULL]]></default>
7933
  <type/>
7934
  </argument>
7935
  </method>
7936
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1925" package="Media Library Assistant">
7937
  <name>mla_shortcode_query_posts_where_filter</name>
7938
  <full_name>mla_shortcode_query_posts_where_filter</full_name>
7939
- <docblock line="1911">
7940
  <description><![CDATA[Filters the WHERE clause for shortcode queries]]></description>
7941
  <long-description><![CDATA[<p>Captures debug information. Adds whitespace to the post_type = 'attachment'
7942
  phrase to circumvent subsequent Role Scoper modification of the clause.
7943
  Handles post_parent "any" and "none" cases.
7944
  Defined as public because it's a filter.</p>]]></long-description>
7945
- <tag line="1911" name="since" description="0.70"/>
7946
- <tag line="1911" name="param" description="query clause before modification" type="string" variable="$where_clause">
7947
  <type by_reference="false">string</type>
7948
  </tag>
7949
- <tag line="1911" name="return" description="query clause after modification" type="string">
7950
  <type by_reference="false">string</type>
7951
  </tag>
7952
  </docblock>
7953
- <argument line="1925">
7954
  <name>$where_clause</name>
7955
  <default><![CDATA[]]></default>
7956
  <type/>
7957
  </argument>
7958
  </method>
7959
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1966" package="Media Library Assistant">
7960
  <name>mla_shortcode_query_posts_orderby_filter</name>
7961
  <full_name>mla_shortcode_query_posts_orderby_filter</full_name>
7962
- <docblock line="1954">
7963
  <description><![CDATA[Filters the ORDERBY clause for shortcode queries]]></description>
7964
  <long-description><![CDATA[<p>This is an enhanced version of the code found in wp-includes/query.php, function get_posts.
7965
  Defined as public because it's a filter.</p>]]></long-description>
7966
- <tag line="1954" name="since" description="1.20"/>
7967
- <tag line="1954" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
7968
  <type by_reference="false">string</type>
7969
  </tag>
7970
- <tag line="1954" name="return" description="query clause after modification" type="string">
7971
  <type by_reference="false">string</type>
7972
  </tag>
7973
  </docblock>
7974
- <argument line="1966">
7975
  <name>$orderby_clause</name>
7976
  <default><![CDATA[]]></default>
7977
  <type/>
7978
  </argument>
7979
  </method>
7980
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1991" package="Media Library Assistant">
7981
  <name>mla_shortcode_query_posts_clauses_filter</name>
7982
  <full_name>mla_shortcode_query_posts_clauses_filter</full_name>
7983
- <docblock line="1979">
7984
  <description><![CDATA[Filters all clauses for shortcode queries, pre caching plugins]]></description>
7985
  <long-description><![CDATA[<p>This is for debug purposes only.
7986
  Defined as public because it's a filter.</p>]]></long-description>
7987
- <tag line="1979" name="since" description="1.30"/>
7988
- <tag line="1979" name="param" description="query clauses before modification" type="array" variable="$pieces">
7989
  <type by_reference="false">array</type>
7990
  </tag>
7991
- <tag line="1979" name="return" description="query clauses after modification (none)" type="array">
7992
  <type by_reference="false">array</type>
7993
  </tag>
7994
  </docblock>
7995
- <argument line="1991">
7996
  <name>$pieces</name>
7997
  <default><![CDATA[]]></default>
7998
  <type/>
7999
  </argument>
8000
  </method>
8001
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2009" package="Media Library Assistant">
8002
  <name>mla_shortcode_query_posts_clauses_request_filter</name>
8003
  <full_name>mla_shortcode_query_posts_clauses_request_filter</full_name>
8004
- <docblock line="1997">
8005
  <description><![CDATA[Filters all clauses for shortcode queries, post caching plugins]]></description>
8006
  <long-description><![CDATA[<p>This is for debug purposes only.
8007
  Defined as public because it's a filter.</p>]]></long-description>
8008
- <tag line="1997" name="since" description="1.30"/>
8009
- <tag line="1997" name="param" description="query clauses before modification" type="array" variable="$pieces">
8010
  <type by_reference="false">array</type>
8011
  </tag>
8012
- <tag line="1997" name="return" description="query clauses after modification (none)" type="array">
8013
  <type by_reference="false">array</type>
8014
  </tag>
8015
  </docblock>
8016
- <argument line="2009">
8017
  <name>$pieces</name>
8018
  <default><![CDATA[]]></default>
8019
  <type/>
8020
  </argument>
8021
  </method>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8022
  </class>
8023
  </file>
8024
  <file path="includes\class-mla-upload-list-table.php" hash="f7ba215328a778423cb7b855c72e5716" package="Media Library Assistant">
@@ -9670,15 +9942,15 @@ This file is only loaded if the naming conflict tests in index.php are passed.</
9670
  </docblock>
9671
  </function>
9672
  </file>
9673
- <file path="index.php" hash="dc02d0522c4193504c9aa0a1ead099a0" package="Media Library Assistant">
9674
  <docblock line="2">
9675
  <description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
9676
  <long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
9677
  will the rest of the plugin be loaded and run.</p>]]></long-description>
9678
  <tag line="2" name="package" description="Media Library Assistant"/>
9679
- <tag line="2" name="version" description="1.51"/>
9680
  </docblock>
9681
- <include line="134" type="Require Once" package="Media Library Assistant">
9682
  <name>includes/mla-plugin-loader.php</name>
9683
  </include>
9684
  <constant namespace="global" line="50" package="Media Library Assistant">
@@ -9704,13 +9976,13 @@ will the rest of the plugin be loaded and run.</p>]]></long-description>
9704
  <full_name>\MLA_BACKUP_DIR</full_name>
9705
  <value><![CDATA[$content_dir . '/mla-backup/']]></value>
9706
  </constant>
9707
- <function namespace="global" line="122" package="Media Library Assistant">
9708
  <name>mla_name_conflict_reporting_action</name>
9709
  <full_name>\mla_name_conflict_reporting_action</full_name>
9710
- <docblock line="117">
9711
  <description><![CDATA[Displays name conflict error messages at the top of the Dashboard]]></description>
9712
  <long-description><![CDATA[]]></long-description>
9713
- <tag line="117" name="since" description="0.20"/>
9714
  </docblock>
9715
  </function>
9716
  </file>
1
  <?xml version="1.0" encoding="utf-8"?>
2
  <project version="2.0.0a8" title="Media Library Assistant">
3
+ <file path="includes\class-mla-data.php" hash="2eee9355da57f60772df83fd26540b65" package="Media Library Assistant">
4
  <docblock line="2">
5
  <description><![CDATA[Database and template file access for MLA needs]]></description>
6
  <long-description><![CDATA[]]></long-description>
40
  </tag>
41
  </docblock>
42
  </property>
43
+ <property final="false" static="true" visibility="private" line="1041" namespace="global" package="Media Library Assistant">
44
  <name>$mla_list_table_items</name>
45
  <default><![CDATA[NULL]]></default>
46
+ <docblock line="1034">
47
  <description><![CDATA[Cache the results of mla_count_list_table_items for reuse in mla_query_list_table_items]]></description>
48
  <long-description><![CDATA[]]></long-description>
49
+ <tag line="1034" name="since" description="1.40"/>
50
+ <tag line="1034" name="var" description="" type="array">
51
  <type by_reference="false">array</type>
52
  </tag>
53
  </docblock>
54
  </property>
55
+ <property final="false" static="true" visibility="private" line="1147" namespace="global" package="Media Library Assistant">
56
  <name>$query_parameters</name>
57
  <default><![CDATA[array()]]></default>
58
+ <docblock line="1134">
59
  <description><![CDATA[WP_Query filter "parameters"]]></description>
60
  <long-description><![CDATA[<p>This array defines parameters for the query's join, where and orderby filters.
61
  The parameters are set up in the _prepare_list_table_query function, and
62
  any further logic required to translate those values is contained in the filters.</p>
63
 
64
  <p>Array index values are: use_postmeta_view, postmeta_key, postmeta_value, patterns, detached, orderby, order, mla-metavalue, debug, s, mla_search_connector, mla_search_fields, sentence, exact</p>]]></long-description>
65
+ <tag line="1134" name="since" description="0.30"/>
66
+ <tag line="1134" name="var" description="" type="array">
67
  <type by_reference="false">array</type>
68
  </tag>
69
  </docblock>
70
  </property>
71
+ <property final="false" static="true" visibility="private" line="2386" namespace="global" package="Media Library Assistant">
72
  <name>$galleries</name>
73
  <default><![CDATA[null]]></default>
74
+ <docblock line="2367">
75
  <description><![CDATA[Objects containing [gallery] shortcodes]]></description>
76
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [gallery] shortcodes
77
  and array(s) of which attachments each [gallery] contains. The arrays are built once
84
  ['galleries'] array of [gallery] entries numbered from one (1), containing:
85
  galleries[X]['query'] contains a string with the arguments of the [gallery],
86
  galleries[X]['results'] contains an array ( ID ) of post_ids for the objects in the gallery.</p>]]></long-description>
87
+ <tag line="2367" name="since" description="0.70"/>
88
+ <tag line="2367" name="var" description="" type="array">
89
  <type by_reference="false">array</type>
90
  </tag>
91
  </docblock>
92
  </property>
93
+ <property final="false" static="true" visibility="private" line="2399" namespace="global" package="Media Library Assistant">
94
  <name>$mla_galleries</name>
95
  <default><![CDATA[null]]></default>
96
+ <docblock line="2388">
97
  <description><![CDATA[Objects containing [mla_gallery] shortcodes]]></description>
98
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [mla_gallery] shortcodes
99
  and array(s) of which attachments each [mla_gallery] contains. The arrays are built once
100
  each page load and cached for subsequent calls.</p>]]></long-description>
101
+ <tag line="2388" name="since" description="0.70"/>
102
+ <tag line="2388" name="var" description="" type="array">
103
  <type by_reference="false">array</type>
104
  </tag>
105
  </docblock>
106
  </property>
107
+ <property final="false" static="true" visibility="private" line="2586" namespace="global" package="Media Library Assistant">
108
  <name>$pdf_indirect_objects</name>
109
  <default><![CDATA[NULL]]></default>
110
+ <docblock line="2575">
111
  <description><![CDATA[Array of PDF indirect objects]]></description>
112
  <long-description><![CDATA[<p>This array contains all of the indirect object offsets and lengths.
113
  The array key is ( object ID * 1000 ) + object generation.
114
  The array value is array( number, generation, start, optional /length )</p>]]></long-description>
115
+ <tag line="2575" name="since" description="1.50"/>
116
+ <tag line="2575" name="var" description="" type="array">
117
  <type by_reference="false">array</type>
118
  </tag>
119
  </docblock>
120
  </property>
121
+ <property final="false" static="true" visibility="private" line="3654" namespace="global" package="Media Library Assistant">
122
  <name>$utf8_chars</name>
123
  <default><![CDATA[array("\xC2\x80", "\xC2\x81", "\xC2\x82", "\xC2\x83", "\xC2\x84", "\xC2\x85", "\xC2\x86", "\xC2\x87", "\xC2\x88", "\xC2\x89", "\xC2\x8A", "\xC2\x8B", "\xC2\x8C", "\xC2\x8D", "\xC2\x8E", "\xC2\x8F", "\xC2\x90", "\xC2\x91", "\xC2\x92", "\xC2\x93", "\xC2\x94", "\xC2\x95", "\xC2\x96", "\xC2\x97", "\xC2\x98", "\xC2\x99", "\xC2\x9A", "\xC2\x9B", "\xC2\x9C", "\xC2\x9D", "\xC2\x9E", "\xC2\x9F", "\xC2\xA0", "\xC2\xA1", "\xC2\xA2", "\xC2\xA3", "\xC2\xA4", "\xC2\xA5", "\xC2\xA6", "\xC2\xA7", "\xC2\xA8", "\xC2\xA9", "\xC2\xAA", "\xC2\xAB", "\xC2\xAC", "\xC2\xAD", "\xC2\xAE", "\xC2\xAF", "\xC2\xB0", "\xC2\xB1", "\xC2\xB2", "\xC2\xB3", "\xC2\xB4", "\xC2\xB5", "\xC2\xB6", "\xC2\xB7", "\xC2\xB8", "\xC2\xB9", "\xC2\xBA", "\xC2\xBB", "\xC2\xBC", "\xC2\xBD", "\xC2\xBE", "\xC2\xBF", "\xC3\x80", "\xC3\x81", "\xC3\x82", "\xC3\x83", "\xC3\x84", "\xC3\x85", "\xC3\x86", "\xC3\x87", "\xC3\x88", "\xC3\x89", "\xC3\x8A", "\xC3\x8B", "\xC3\x8C", "\xC3\x8D", "\xC3\x8E", "\xC3\x8F", "\xC3\x90", "\xC3\x91", "\xC3\x92", "\xC3\x93", "\xC3\x94", "\xC3\x95", "\xC3\x96", "\xC3\x97", "\xC3\x98", "\xC3\x99", "\xC3\x9A", "\xC3\x9B", "\xC3\x9C", "\xC3\x9D", "\xC3\x9E", "\xC3\x9F", "\xC3\xA0", "\xC3\xA1", "\xC3\xA2", "\xC3\xA3", "\xC3\xA4", "\xC3\xA5", "\xC3\xA6", "\xC3\xA7", "\xC3\xA8", "\xC3\xA9", "\xC3\xAA", "\xC3\xAB", "\xC3\xAC", "\xC3\xAD", "\xC3\xAE", "\xC3\xAF", "\xC3\xB0", "\xC3\xB1", "\xC3\xB2", "\xC3\xB3", "\xC3\xB4", "\xC3\xB5", "\xC3\xB6", "\xC3\xB7", "\xC3\xB8", "\xC3\xB9", "\xC3\xBA", "\xC3\xBB", "\xC3\xBC", "\xC3\xBD", "\xC3\xBE", "\xC3\xBF")]]></default>
124
+ <docblock line="3647">
125
  <description><![CDATA[UTF-8 replacements for invalid SQL characters]]></description>
126
  <long-description><![CDATA[]]></long-description>
127
+ <tag line="3647" name="since" description="1.41"/>
128
+ <tag line="3647" name="var" description="" type="array">
129
  <type by_reference="false">array</type>
130
  </tag>
131
  </docblock>
132
  </property>
133
+ <property final="false" static="true" visibility="private" line="3712" namespace="global" package="Media Library Assistant">
134
  <name>$mla_iptc_records</name>
135
  <default><![CDATA[array("1#000" => "Model Version", "1#005" => "Destination", "1#020" => "File Format", "1#022" => "File Format Version", "1#030" => "Service Identifier", "1#040" => "Envelope Number", "1#050" => "Product ID", "1#060" => "Envelope Priority", "1#070" => "Date Sent", "1#080" => "Time Sent", "1#090" => "Coded Character Set", "1#100" => "UNO", "1#120" => "ARM Identifier", "1#122" => "ARM Version", "2#000" => "Record Version", "2#003" => "Object Type Reference", "2#004" => "Object Attribute Reference", "2#005" => "Object Name", "2#007" => "Edit Status", "2#008" => "Editorial Update", "2#010" => "Urgency", "2#012" => "Subject Reference", "2#015" => "Category", "2#020" => "Supplemental Category", "2#022" => "Fixture Identifier", "2#025" => "Keywords", "2#026" => "Content Location Code", "2#027" => "Content Location Name", "2#030" => "Release Date", "2#035" => "Release Time", "2#037" => "Expiration Date", "2#038" => "Expiration Time", "2#040" => "Special Instructions", "2#042" => "Action Advised", "2#045" => "Reference Service", "2#047" => "Reference Date", "2#050" => "Reference Number", "2#055" => "Date Created", "2#060" => "Time Created", "2#062" => "Digital Creation Date", "2#063" => "Digital Creation Time", "2#065" => "Originating Program", "2#070" => "Program Version", "2#075" => "Object Cycle", "2#080" => "By-line", "2#085" => "By-line Title", "2#090" => "City", "2#092" => "Sub-location", "2#095" => "Province or State", "2#100" => "Country or Primary Location Code", "2#101" => "Country or Primary Location Name", "2#103" => "Original Transmission Reference", "2#105" => "Headline", "2#110" => "Credit", "2#115" => "Source", "2#116" => "Copyright Notice", "2#118" => "Contact", "2#120" => "Caption or Abstract", "2#122" => "Caption Writer or Editor", "2#125" => "Rasterized Caption", "2#130" => "Image Type", "2#131" => "Image Orientation", "2#135" => "Language Identifier", "2#150" => "Audio Type", "2#151" => "Audio Sampling Rate", "2#152" => "Audio Sampling Resolution", "2#153" => "Audio Duration", "2#154" => "Audio Outcue", "2#200" => "ObjectData Preview File Format", "2#201" => "ObjectData Preview File Format Version", "2#202" => "ObjectData Preview Data", "7#010" => "Size Mode", "7#020" => "Max Subfile Size", "7#090" => "ObjectData Size Announced", "7#095" => "Maximum ObjectData Size", "8#010" => "Subfile", "9#010" => "Confirmed ObjectData Size")]]></default>
136
+ <docblock line="3702">
137
  <description><![CDATA[IPTC Dataset identifiers and names]]></description>
138
  <long-description><![CDATA[<p>This array contains the identifiers and names of Datasets defined in
139
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
140
+ <tag line="3702" name="since" description="0.90"/>
141
+ <tag line="3702" name="var" description="" type="array">
142
  <type by_reference="false">array</type>
143
  </tag>
144
  </docblock>
145
  </property>
146
+ <property final="false" static="true" visibility="public" line="3811" namespace="global" package="Media Library Assistant">
147
  <name>$mla_iptc_keys</name>
148
  <default><![CDATA[array('model-version' => '1#000', 'destination' => '1#005', 'file-format' => '1#020', 'file-format-version' => '1#022', 'service-identifier' => '1#030', 'envelope-number' => '1#040', 'product-id' => '1#050', 'envelope-priority' => '1#060', 'date-sent' => '1#070', 'time-sent' => '1#080', 'coded-character-set' => '1#090', 'uno' => '1#100', 'arm-identifier' => '1#120', 'arm-version' => '1#122', 'record-version' => '2#000', 'object-type-reference' => '2#003', 'object-attribute-reference' => '2#004', 'object-name' => '2#005', 'edit-status' => '2#007', 'editorial-update' => '2#008', 'urgency' => '2#010', 'subject-reference' => '2#012', 'category' => '2#015', 'supplemental-category' => '2#020', 'fixture-identifier' => '2#022', 'keywords' => '2#025', 'content-location-code' => '2#026', 'content-location-name' => '2#027', 'release-date' => '2#030', 'release-time' => '2#035', 'expiration-date' => '2#037', 'expiration-time' => '2#038', 'special-instructions' => '2#040', 'action-advised' => '2#042', 'reference-service' => '2#045', 'reference-date' => '2#047', 'reference-number' => '2#050', 'date-created' => '2#055', 'time-created' => '2#060', 'digital-creation-date' => '2#062', 'digital-creation-time' => '2#063', 'originating-program' => '2#065', 'program-version' => '2#070', 'object-cycle' => '2#075', 'by-line' => '2#080', 'by-line-title' => '2#085', 'city' => '2#090', 'sub-location' => '2#092', 'province-or-state' => '2#095', 'country-or-primary-location-code' => '2#100', 'country-or-primary-location-name' => '2#101', 'original-transmission-reference' => '2#103', 'headline' => '2#105', 'credit' => '2#110', 'source' => '2#115', 'copyright-notice' => '2#116', 'contact' => '2#118', 'caption-or-abstract' => '2#120', 'caption-writer-or-editor' => '2#122', 'rasterized-caption' => '2#125', 'image-type' => '2#130', 'image-orientation' => '2#131', 'language-identifier' => '2#135', 'audio-type' => '2#150', 'audio-sampling-rate' => '2#151', 'audio-sampling-resolution' => '2#152', 'audio-duration' => '2#153', 'audio-outcue' => '2#154', 'objectdata-preview-file-format' => '2#200', 'objectdata-preview-file-format-version' => '2#201', 'objectdata-preview-data' => '2#202', 'size-mode' => '7#010', 'max-subfile-size' => '7#020', 'objectdata-size-announced' => '7#090', 'maximum-objectdata-size' => '7#095', 'subfile' => '8#010', 'confirmed-objectdata-size' => '9#010')]]></default>
149
+ <docblock line="3801">
150
  <description><![CDATA[IPTC Dataset friendly name/slug and identifiers]]></description>
151
  <long-description><![CDATA[<p>This array contains the sanitized names and identifiers of Datasets defined in
152
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
153
+ <tag line="3801" name="since" description="0.90"/>
154
+ <tag line="3801" name="var" description="" type="array">
155
  <type by_reference="false">array</type>
156
  </tag>
157
  </docblock>
158
  </property>
159
+ <property final="false" static="true" visibility="private" line="3910" namespace="global" package="Media Library Assistant">
160
  <name>$mla_iptc_descriptions</name>
161
  <default><![CDATA[array("1#000" => "2 octet binary IIM version number", "1#005" => "Max 1024 characters of Destination (ISO routing information); repeatable", "1#020" => "2 octet binary file format number, see IPTC-NAA V4 Appendix A", "1#022" => "2 octet binary file format version number", "1#030" => "Max 10 characters of Service Identifier and product", "1#040" => "8 Character Envelope Number", "1#050" => "Max 32 characters subset of provider's overall service; repeatable", "1#060" => "1 numeric character of envelope handling priority (not urgency)", "1#070" => "8 numeric characters of Date Sent by service - CCYYMMDD", "1#080" => "11 characters of Time Sent by service - HHMMSS±HHMM", "1#090" => "Max 32 characters of control functions, etc.", "1#100" => "14 to 80 characters of eternal, globally unique identification for objects", "1#120" => "2 octet binary Abstract Relationship Model Identifier", "1#122" => "2 octet binary Abstract Relationship Model Version", "2#000" => "2 octet binary Information Interchange Model, Part II version number", "2#003" => "3 to 67 Characters of Object Type Reference number and optional text", "2#004" => "3 to 67 Characters of Object Attribute Reference number and optional text; repeatable", "2#005" => "Max 64 characters of the object name or shorthand reference", "2#007" => "Max 64 characters of the status of the objectdata", "2#008" => "2 numeric characters of the type of update this object provides", "2#010" => "1 numeric character of the editorial urgency of content", "2#012" => "13 to 236 characters of a structured definition of the subject matter; repeatable", "2#015" => "Max 3 characters of the subject of the objectdata, DEPRECATED", "2#020" => "Max 32 characters (each) of further refinement of subject, DEPRECATED; repeatable", "2#022" => "Max 32 characters identifying recurring, predictable content", "2#025" => "Max 64 characters (each) of tags; repeatable", "2#026" => "3 characters of ISO3166 country code or IPTC-assigned code; repeatable", "2#027" => "Max 64 characters of publishable country/geographical location name; repeatable", "2#030" => "8 numeric characters of Release Date - CCYYMMDD", "2#035" => "11 characters of Release Time (earliest use) - HHMMSS±HHMM", "2#037" => "8 numeric characters of Expiration Date (latest use) - CCYYMDD", "2#038" => "11 characters of Expiration Time (latest use) - HHMMSS±HHMM", "2#040" => "Max 256 Characters of editorial instructions, e.g., embargoes and warnings", "2#042" => "2 numeric characters of type of action this object provides to a previous object", "2#045" => "Max 10 characters of the Service ID (1#030) of a prior envelope; repeatable", "2#047" => "8 numeric characters of prior envelope Reference Date (1#070) - CCYYMMDD; repeatable", "2#050" => "8 characters of prior envelope Reference Number (1#040); repeatable", "2#055" => "8 numeric characters of intellectual content Date Created - CCYYMMDD", "2#060" => "11 characters of intellectual content Time Created - HHMMSS±HHMM", "2#062" => "8 numeric characters of digital representation creation date - CCYYMMDD", "2#063" => "11 characters of digital representation creation time - HHMMSS±HHMM", "2#065" => "Max 32 characters of the program used to create the objectdata", "2#070" => "Program Version - Max 10 characters of the version of the program used to create the objectdata", "2#075" => "1 character where a=morning, p=evening, b=both", "2#080" => "Max 32 Characters of the name of the objectdata creator, e.g., the writer, photographer; repeatable", "2#085" => "Max 32 characters of the title of the objectdata creator; repeatable", "2#090" => "Max 32 Characters of the city of objectdata origin", "2#092" => "Max 32 Characters of the location within the city of objectdata origin", "2#095" => "Max 32 Characters of the objectdata origin Province or State", "2#100" => "3 characters of ISO3166 or IPTC-assigned code for Country of objectdata origin", "2#101" => "Max 64 characters of publishable country/geographical location name of objectdata origin", "2#103" => "Max 32 characters of a code representing the location of original transmission", "2#105" => "Max 256 Characters of a publishable entry providing a synopsis of the contents of the objectdata", "2#110" => "Max 32 Characters that identifies the provider of the objectdata (Vs the owner/creator)", "2#115" => "Max 32 Characters that identifies the original owner of the intellectual content", "2#116" => "Max 128 Characters that contains any necessary copyright notice", "2#118" => "Max 128 characters that identifies the person or organisation which can provide further background information; repeatable", "2#120" => "Max 2000 Characters of a textual description of the objectdata", "2#122" => "Max 32 Characters that the identifies the person involved in the writing, editing or correcting the objectdata or caption/abstract; repeatable", "2#125" => "7360 binary octets of the rasterized caption - 1 bit per pixel, 460x128-pixel image", "2#130" => "2 characters of color composition type and information", "2#131" => "1 alphabetic character indicating the image area layout - P=portrait, L=landscape, S=square", "2#135" => "2 or 3 aphabetic characters containing the major national language of the object, according to the ISO 639:1988 codes", "2#150" => "2 characters identifying monaural/stereo and exact type of audio content", "2#151" => "6 numeric characters representing the audio sampling rate in hertz (Hz)", "2#152" => "2 numeric characters representing the number of bits in each audio sample", "2#153" => "6 numeric characters of the Audio Duration - HHMMSS", "2#154" => "Max 64 characters of the content of the end of an audio objectdata", "2#200" => "2 octet binary file format of the ObjectData Preview", "2#201" => "2 octet binary particular version of the ObjectData Preview File Format", "2#202" => "Max 256000 binary octets containing the ObjectData Preview data", "7#010" => "1 numeric character - 0=objectdata size not known, 1=objectdata size known at beginning of transfer", "7#020" => "4 octet binary maximum subfile dataset(s) size", "7#090" => "4 octet binary objectdata size if known at beginning of transfer", "7#095" => "4 octet binary largest possible objectdata size", "8#010" => "Subfile DataSet containing the objectdata itself; repeatable", "9#010" => "4 octet binary total objectdata size")]]></default>
162
+ <docblock line="3900">
163
  <description><![CDATA[IPTC Dataset descriptions]]></description>
164
  <long-description><![CDATA[<p>This array contains the descriptions of Datasets defined in
165
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
166
+ <tag line="3900" name="since" description="0.90"/>
167
+ <tag line="3900" name="var" description="" type="array">
168
  <type by_reference="false">array</type>
169
  </tag>
170
  </docblock>
171
  </property>
172
+ <property final="false" static="true" visibility="private" line="4009" namespace="global" package="Media Library Assistant">
173
  <name>$mla_iptc_formats</name>
174
  <default><![CDATA[array(0 => "No ObjectData", 1 => "IPTC-NAA Digital Newsphoto Parameter Record", 2 => "IPTC7901 Recommended Message Format", 3 => "Tagged Image File Format (Adobe/Aldus Image data)", 4 => "Illustrator (Adobe Graphics data)", 5 => "AppleSingle (Apple Computer Inc)", 6 => "NAA 89-3 (ANPA 1312)", 7 => "MacBinary II", 0 => "IPTC Unstructured Character Oriented File Format (UCOFF)", 0 => "United Press International ANPA 1312 variant", 10 => "United Press International Down-Load Message", 11 => "JPEG File Interchange (JFIF)", 12 => "Photo-CD Image-Pac (Eastman Kodak)", 13 => "Microsoft Bit Mapped Graphics File [*.BMP]", 14 => "Digital Audio File [*.WAV] (Microsoft & Creative Labs)", 15 => "Audio plus Moving Video [*.AVI] (Microsoft)", 16 => "PC DOS/Windows Executable Files [*.COM][*.EXE]", 17 => "Compressed Binary File [*.ZIP] (PKWare Inc)", 18 => "Audio Interchange File Format AIFF (Apple Computer Inc)", 19 => "RIFF Wave (Microsoft Corporation)", 20 => "Freehand (Macromedia/Aldus)", 21 => "Hypertext Markup Language - HTML (The Internet Society)", 22 => "MPEG 2 Audio Layer 2 (Musicom), ISO/IEC", 23 => "MPEG 2 Audio Layer 3, ISO/IEC", 24 => "Portable Document File (*.PDF) Adobe", 25 => "News Industry Text Format (NITF)", 26 => "Tape Archive (*.TAR)", 27 => "Tidningarnas Telegrambyrå NITF version (TTNITF DTD)", 28 => "Ritzaus Bureau NITF version (RBNITF DTD)", 29 => "Corel Draw [*.CDR]")]]></default>
175
+ <docblock line="3999">
176
  <description><![CDATA[IPTC file format identifiers and descriptions]]></description>
177
  <long-description><![CDATA[<p>This array contains the file format identifiers and descriptions defined in
178
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 1#020.</p>]]></long-description>
179
+ <tag line="3999" name="since" description="0.90"/>
180
+ <tag line="3999" name="var" description="" type="array">
181
  <type by_reference="false">array</type>
182
  </tag>
183
  </docblock>
184
  </property>
185
+ <property final="false" static="true" visibility="private" line="4052" namespace="global" package="Media Library Assistant">
186
  <name>$mla_iptc_image_types</name>
187
  <default><![CDATA[array("M" => "Monochrome", "Y" => "Yellow Component", "M" => "Magenta Component", "C" => "Cyan Component", "K" => "Black Component", "R" => "Red Component", "G" => "Green Component", "B" => "Blue Component", "T" => "Text Only", "F" => "Full colour composite, frame sequential", "L" => "Full colour composite, line sequential", "P" => "Full colour composite, pixel sequential", "S" => "Full colour composite, special interleaving")]]></default>
188
+ <docblock line="4042">
189
  <description><![CDATA[IPTC image type identifiers and descriptions]]></description>
190
  <long-description><![CDATA[<p>This array contains the image type identifiers and descriptions defined in
191
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 2#130, octet 2.</p>]]></long-description>
192
+ <tag line="4042" name="since" description="0.90"/>
193
+ <tag line="4042" name="var" description="" type="array">
194
  <type by_reference="false">array</type>
195
  </tag>
196
  </docblock>
543
  <type/>
544
  </argument>
545
  </method>
546
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="962" package="Media Library Assistant">
547
  <name>mla_get_template_placeholders</name>
548
  <full_name>mla_get_template_placeholders</full_name>
549
+ <docblock line="951">
550
  <description><![CDATA[Analyze a template, returning an array of the placeholders it contains]]></description>
551
  <long-description><![CDATA[]]></long-description>
552
+ <tag line="951" name="since" description="0.90"/>
553
+ <tag line="951" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
554
  <type by_reference="false">string</type>
555
  </tag>
556
+ <tag line="951" name="param" description="Optional: default option value" type="string" variable="$default_option">
557
  <type by_reference="false">string</type>
558
  </tag>
559
+ <tag line="951" name="return" description="Placeholder information: each entry is an array with ['prefix'] =&gt; string, ['value'] =&gt; string, ['option'] =&gt; string 'text'|single'|'export'|'array'|'multi'" type="array">
560
  <type by_reference="false">array</type>
561
  </tag>
562
  </docblock>
563
+ <argument line="962">
564
  <name>$tpl</name>
565
  <default><![CDATA[]]></default>
566
  <type/>
567
  </argument>
568
+ <argument line="962">
569
  <name>$default_option</name>
570
  <default><![CDATA['text']]></default>
571
  <type/>
572
  </argument>
573
  </method>
574
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1054" package="Media Library Assistant">
575
  <name>mla_count_list_table_items</name>
576
  <full_name>mla_count_list_table_items</full_name>
577
+ <docblock line="1043">
578
  <description><![CDATA[Get the total number of attachment posts]]></description>
579
  <long-description><![CDATA[]]></long-description>
580
+ <tag line="1043" name="since" description="0.30"/>
581
+ <tag line="1043" name="param" description="Query variables, e.g., from $_REQUEST" type="array" variable="$request">
582
  <type by_reference="false">array</type>
583
  </tag>
584
+ <tag line="1043" name="param" description="(optional) number of rows to skip over to reach desired page" type="int" variable="$offset">
585
  <type by_reference="false">int</type>
586
  </tag>
587
+ <tag line="1043" name="param" description="(optional) number of rows on each page" type="int" variable="$count">
588
  <type by_reference="false">int</type>
589
  </tag>
590
+ <tag line="1043" name="return" description="Number of attachment posts" type="integer">
591
  <type by_reference="false">integer</type>
592
  </tag>
593
  </docblock>
594
+ <argument line="1054">
595
  <name>$request</name>
596
  <default><![CDATA[]]></default>
597
  <type/>
598
  </argument>
599
+ <argument line="1054">
600
  <name>$offset</name>
601
  <default><![CDATA[NULL]]></default>
602
  <type/>
603
  </argument>
604
+ <argument line="1054">
605
  <name>$count</name>
606
  <default><![CDATA[NULL]]></default>
607
  <type/>
608
  </argument>
609
  </method>
610
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1083" package="Media Library Assistant">
611
  <name>mla_query_list_table_items</name>
612
  <full_name>mla_query_list_table_items</full_name>
613
+ <docblock line="1069">
614
  <description><![CDATA[Retrieve attachment objects for list table display]]></description>
615
  <long-description><![CDATA[<p>Supports prepare_items in class-mla-list-table.php.
616
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
617
+ <tag line="1069" name="since" description="0.1"/>
618
+ <tag line="1069" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
619
  <type by_reference="false">array</type>
620
  </tag>
621
+ <tag line="1069" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
622
  <type by_reference="false">int</type>
623
  </tag>
624
+ <tag line="1069" name="param" description="number of rows on each page" type="int" variable="$count">
625
  <type by_reference="false">int</type>
626
  </tag>
627
+ <tag line="1069" name="return" description="attachment objects (posts) including parent data, meta data and references" type="array">
628
  <type by_reference="false">array</type>
629
  </tag>
630
  </docblock>
631
+ <argument line="1083">
632
  <name>$request</name>
633
  <default><![CDATA[]]></default>
634
  <type/>
635
  </argument>
636
+ <argument line="1083">
637
  <name>$offset</name>
638
  <default><![CDATA[]]></default>
639
  <type/>
640
  </argument>
641
+ <argument line="1083">
642
  <name>$count</name>
643
  <default><![CDATA[]]></default>
644
  <type/>
645
  </argument>
646
  </method>
647
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1129" package="Media Library Assistant">
648
  <name>mla_query_media_modal_items</name>
649
  <full_name>mla_query_media_modal_items</full_name>
650
+ <docblock line="1116">
651
  <description><![CDATA[Retrieve attachment objects for the WordPress Media Manager]]></description>
652
  <long-description><![CDATA[<p>Supports month-year and taxonomy-term filters as well as the enhanced search box</p>]]></long-description>
653
+ <tag line="1116" name="since" description="1.20"/>
654
+ <tag line="1116" name="param" description="query parameters from Media Manager" type="array" variable="$request">
655
  <type by_reference="false">array</type>
656
  </tag>
657
+ <tag line="1116" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
658
  <type by_reference="false">int</type>
659
  </tag>
660
+ <tag line="1116" name="param" description="number of rows on each page" type="int" variable="$count">
661
  <type by_reference="false">int</type>
662
  </tag>
663
+ <tag line="1116" name="return" description="attachment objects (posts)" type="array">
664
  <type by_reference="false">array</type>
665
  </tag>
666
  </docblock>
667
+ <argument line="1129">
668
  <name>$request</name>
669
  <default><![CDATA[]]></default>
670
  <type/>
671
  </argument>
672
+ <argument line="1129">
673
  <name>$offset</name>
674
  <default><![CDATA[]]></default>
675
  <type/>
676
  </argument>
677
+ <argument line="1129">
678
  <name>$count</name>
679
  <default><![CDATA[]]></default>
680
  <type/>
681
  </argument>
682
  </method>
683
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1163" package="Media Library Assistant">
684
  <name>_prepare_list_table_query</name>
685
  <full_name>_prepare_list_table_query</full_name>
686
+ <docblock line="1149">
687
  <description><![CDATA[Sanitize and expand query arguments from request variables]]></description>
688
  <long-description><![CDATA[<p>Prepare the arguments for WP_Query.
689
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
690
+ <tag line="1149" name="since" description="0.1"/>
691
+ <tag line="1149" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$raw_request">
692
  <type by_reference="false">array</type>
693
  </tag>
694
+ <tag line="1149" name="param" description="Optional number of rows (default 0) to skip over to reach desired page" type="int" variable="$offset">
695
  <type by_reference="false">int</type>
696
  </tag>
697
+ <tag line="1149" name="param" description="Optional number of rows on each page (0 = all rows, default)" type="int" variable="$count">
698
  <type by_reference="false">int</type>
699
  </tag>
700
+ <tag line="1149" name="return" description="revised arguments suitable for WP_Query" type="array">
701
  <type by_reference="false">array</type>
702
  </tag>
703
  </docblock>
704
+ <argument line="1163">
705
  <name>$raw_request</name>
706
  <default><![CDATA[]]></default>
707
  <type/>
708
  </argument>
709
+ <argument line="1163">
710
  <name>$offset</name>
711
  <default><![CDATA[0]]></default>
712
  <type/>
713
  </argument>
714
+ <argument line="1163">
715
  <name>$count</name>
716
  <default><![CDATA[0]]></default>
717
  <type/>
718
  </argument>
719
  </method>
720
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1490" package="Media Library Assistant">
721
  <name>_execute_list_table_query</name>
722
  <full_name>_execute_list_table_query</full_name>
723
+ <docblock line="1481">
724
  <description><![CDATA[Add filters, run query, remove filters]]></description>
725
  <long-description><![CDATA[]]></long-description>
726
+ <tag line="1481" name="since" description="0.30"/>
727
+ <tag line="1481" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
728
  <type by_reference="false">array</type>
729
  </tag>
730
+ <tag line="1481" name="return" description="WP_Query object with query results" type="object">
731
  <type by_reference="false">object</type>
732
  </tag>
733
  </docblock>
734
+ <argument line="1490">
735
  <name>$request</name>
736
  <default><![CDATA[]]></default>
737
  <type/>
738
  </argument>
739
  </method>
740
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1566" package="Media Library Assistant">
741
+ <name>mla_search_terms_tidy</name>
742
+ <full_name>mla_search_terms_tidy</full_name>
743
+ <docblock line="1555">
744
+ <description><![CDATA[Replaces a WordPress function deprecated in v3.7]]></description>
745
+ <long-description><![CDATA[<p>Defined as public because it's a callback from array_map().</p>]]></long-description>
746
+ <tag line="1555" name="since" description="1.51"/>
747
+ <tag line="1555" name="param" description="search term before modification" type="string" variable="$term">
748
+ <type by_reference="false">string</type>
749
+ </tag>
750
+ <tag line="1555" name="return" description="cleaned up search term" type="string">
751
+ <type by_reference="false">string</type>
752
+ </tag>
753
+ </docblock>
754
+ <argument line="1566">
755
+ <name>$term</name>
756
+ <default><![CDATA[]]></default>
757
+ <type/>
758
+ </argument>
759
+ </method>
760
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1582" package="Media Library Assistant">
761
  <name>mla_query_posts_search_filter</name>
762
  <full_name>mla_query_posts_search_filter</full_name>
763
+ <docblock line="1570">
764
  <description><![CDATA[Adds a keyword search to the WHERE clause, if required]]></description>
765
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
766
+ <tag line="1570" name="since" description="0.60"/>
767
+ <tag line="1570" name="param" description="query clause before modification" type="string" variable="$search_string">
768
  <type by_reference="false">string</type>
769
  </tag>
770
+ <tag line="1570" name="param" description="WP_Query object" type="object" variable="$query_object">
771
  <type by_reference="false">object</type>
772
  </tag>
773
+ <tag line="1570" name="return" description="query clause after keyword search addition" type="string">
774
  <type by_reference="false">string</type>
775
  </tag>
776
  </docblock>
777
+ <argument line="1582">
778
  <name>$search_string</name>
779
  <default><![CDATA[]]></default>
780
  <type/>
781
  </argument>
782
+ <argument line="1582">
783
  <name>$query_object</name>
784
  <default><![CDATA[]]></default>
785
  <type/>
786
  </argument>
787
  </method>
788
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1697" package="Media Library Assistant">
789
  <name>mla_query_posts_join_filter</name>
790
  <full_name>mla_query_posts_join_filter</full_name>
791
+ <docblock line="1686">
792
  <description><![CDATA[Adds a JOIN clause, if required, to handle sorting/searching on custom fields or ALT Text]]></description>
793
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
794
+ <tag line="1686" name="since" description="0.30"/>
795
+ <tag line="1686" name="param" description="query clause before modification" type="string" variable="$join_clause">
796
  <type by_reference="false">string</type>
797
  </tag>
798
+ <tag line="1686" name="return" description="query clause after &quot;LEFT JOIN view ON post_id&quot; item modification" type="string">
799
  <type by_reference="false">string</type>
800
  </tag>
801
  </docblock>
802
+ <argument line="1697">
803
  <name>$join_clause</name>
804
  <default><![CDATA[]]></default>
805
  <type/>
806
  </argument>
807
  </method>
808
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1724" package="Media Library Assistant">
809
  <name>mla_query_posts_where_filter</name>
810
  <full_name>mla_query_posts_where_filter</full_name>
811
+ <docblock line="1712">
812
  <description><![CDATA[Adds a WHERE clause for detached items]]></description>
813
  <long-description><![CDATA[<p>Modeled after _edit_attachments_query_helper in wp-admin/post.php.
814
  Defined as public because it's a filter.</p>]]></long-description>
815
+ <tag line="1712" name="since" description="0.1"/>
816
+ <tag line="1712" name="param" description="query clause before modification" type="string" variable="$where_clause">
817
  <type by_reference="false">string</type>
818
  </tag>
819
+ <tag line="1712" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
820
  <type by_reference="false">string</type>
821
  </tag>
822
  </docblock>
823
+ <argument line="1724">
824
  <name>$where_clause</name>
825
  <default><![CDATA[]]></default>
826
  <type/>
827
  </argument>
828
  </method>
829
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1772" package="Media Library Assistant">
830
  <name>mla_query_posts_orderby_filter</name>
831
  <full_name>mla_query_posts_orderby_filter</full_name>
832
+ <docblock line="1760">
833
  <description><![CDATA[Adds a ORDERBY clause, if required]]></description>
834
  <long-description><![CDATA[<p>Expands the range of sort options because the logic in WP_Query is limited.
835
  Defined as public because it's a filter.</p>]]></long-description>
836
+ <tag line="1760" name="since" description="0.30"/>
837
+ <tag line="1760" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
838
  <type by_reference="false">string</type>
839
  </tag>
840
+ <tag line="1760" name="return" description="updated query clause" type="string">
841
  <type by_reference="false">string</type>
842
  </tag>
843
  </docblock>
844
+ <argument line="1772">
845
  <name>$orderby_clause</name>
846
  <default><![CDATA[]]></default>
847
  <type/>
848
  </argument>
849
  </method>
850
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1831" package="Media Library Assistant">
851
  <name>mla_get_attachment_by_id</name>
852
  <full_name>mla_get_attachment_by_id</full_name>
853
+ <docblock line="1819">
854
  <description><![CDATA[Retrieve an Attachment array given a $post_id]]></description>
855
  <long-description><![CDATA[<p>The (associative) array will contain every field that can be found in
856
  the posts and postmeta tables, and all references to the attachment.</p>]]></long-description>
857
+ <tag line="1819" name="since" description="0.1"/>
858
+ <tag line="1819" name="uses" description="\global\$post" refers="\global\$post"/>
859
+ <tag line="1819" name="param" description="The ID of the attachment post" type="int" variable="$post_id">
860
  <type by_reference="false">int</type>
861
  </tag>
862
+ <tag line="1819" name="return" description="NULL on failure else associative array" type="NULL|array">
863
  <type by_reference="false">NULL</type>
864
  <type by_reference="false">array</type>
865
  </tag>
866
  </docblock>
867
+ <argument line="1831">
868
  <name>$post_id</name>
869
  <default><![CDATA[]]></default>
870
  <type/>
871
  </argument>
872
  </method>
873
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1885" package="Media Library Assistant">
874
  <name>mla_fetch_attachment_parent_data</name>
875
  <full_name>mla_fetch_attachment_parent_data</full_name>
876
+ <docblock line="1876">
877
  <description><![CDATA[Returns information about an attachment's parent, if found]]></description>
878
  <long-description><![CDATA[]]></long-description>
879
+ <tag line="1876" name="since" description="0.1"/>
880
+ <tag line="1876" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent_id">
881
  <type by_reference="false">int</type>
882
  </tag>
883
+ <tag line="1876" name="return" description="Parent information; post_date, post_title and post_type" type="array">
884
  <type by_reference="false">array</type>
885
  </tag>
886
  </docblock>
887
+ <argument line="1885">
888
  <name>$parent_id</name>
889
  <default><![CDATA[]]></default>
890
  <type/>
891
  </argument>
892
  </method>
893
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1917" package="Media Library Assistant">
894
  <name>_set_array_element</name>
895
  <full_name>_set_array_element</full_name>
896
+ <docblock line="1906">
897
  <description><![CDATA[Adds or replaces the value of a key in a possibly nested array structure]]></description>
898
  <long-description><![CDATA[]]></long-description>
899
+ <tag line="1906" name="since" description="1.51"/>
900
+ <tag line="1906" name="param" description="key value, e.g. array1.array2.element" type="string" variable="$needle">
901
  <type by_reference="false">string</type>
902
  </tag>
903
+ <tag line="1906" name="param" description="replacement value, string or array, by reference" type="mixed" variable="$value">
904
  <type by_reference="false">mixed</type>
905
  </tag>
906
+ <tag line="1906" name="param" description="PHP nested arrays, by reference" type="array" variable="$haystack">
907
  <type by_reference="false">array</type>
908
  </tag>
909
+ <tag line="1906" name="return" description="true if $needle element set, false if not" type="boolean">
910
  <type by_reference="false">boolean</type>
911
  </tag>
912
  </docblock>
913
+ <argument line="1917">
914
  <name>$needle</name>
915
  <default><![CDATA[]]></default>
916
  <type/>
917
  </argument>
918
+ <argument line="1917">
919
  <name>$value</name>
920
  <default><![CDATA[]]></default>
921
  <type/>
922
  </argument>
923
+ <argument line="1917">
924
  <name>$haystack</name>
925
  <default><![CDATA[]]></default>
926
  <type/>
927
  </argument>
928
  </method>
929
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1950" package="Media Library Assistant">
930
  <name>_unset_array_element</name>
931
  <full_name>_unset_array_element</full_name>
932
+ <docblock line="1940">
933
  <description><![CDATA[Deletes the value of a key in a possibly nested array structure]]></description>
934
  <long-description><![CDATA[]]></long-description>
935
+ <tag line="1940" name="since" description="1.51"/>
936
+ <tag line="1940" name="param" description="key value, e.g. array1.array2.element" type="string" variable="$needle">
937
  <type by_reference="false">string</type>
938
  </tag>
939
+ <tag line="1940" name="param" description="PHP nested arrays, by reference" type="array" variable="$haystack">
940
  <type by_reference="false">array</type>
941
  </tag>
942
+ <tag line="1940" name="return" description="true if $needle element found, false if not" type="boolean">
943
  <type by_reference="false">boolean</type>
944
  </tag>
945
  </docblock>
946
+ <argument line="1950">
947
  <name>$needle</name>
948
  <default><![CDATA[]]></default>
949
  <type/>
950
  </argument>
951
+ <argument line="1950">
952
  <name>$haystack</name>
953
  <default><![CDATA[]]></default>
954
  <type/>
955
  </argument>
956
  </method>
957
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1984" package="Media Library Assistant">
958
  <name>mla_find_array_element</name>
959
  <full_name>mla_find_array_element</full_name>
960
+ <docblock line="1969">
961
  <description><![CDATA[Finds the value of a key in a possibly nested array structure]]></description>
962
  <long-description><![CDATA[<p>Used primarily to extract fields from the _wp_attachment_metadata custom field.
963
  Could also be used with the ID3 metadata exposed in WordPress 3.6 and later.</p>]]></long-description>
964
+ <tag line="1969" name="since" description="1.30"/>
965
+ <tag line="1969" name="param" description="key value, e.g. array1.array2.element" type="string" variable="$needle">
966
  <type by_reference="false">string</type>
967
  </tag>
968
+ <tag line="1969" name="param" description="PHP nested arrays" type="array" variable="$haystack">
969
  <type by_reference="false">array</type>
970
  </tag>
971
+ <tag line="1969" name="param" description="data option 'text'|'single'|'export'|'array'|'multi'" type="string" variable="$option">
972
  <type by_reference="false">string</type>
973
  </tag>
974
+ <tag line="1969" name="param" description="keep existing values - for 'multi' option" type="boolean" variable="$keep_existing">
975
  <type by_reference="false">boolean</type>
976
  </tag>
977
+ <tag line="1969" name="return" description="string or array value matching key(.key ...) or ''" type="mixed">
978
  <type by_reference="false">mixed</type>
979
  </tag>
980
  </docblock>
981
+ <argument line="1984">
982
  <name>$needle</name>
983
  <default><![CDATA[]]></default>
984
  <type/>
985
  </argument>
986
+ <argument line="1984">
987
  <name>$haystack</name>
988
  <default><![CDATA[]]></default>
989
  <type/>
990
  </argument>
991
+ <argument line="1984">
992
  <name>$option</name>
993
  <default><![CDATA[]]></default>
994
  <type/>
995
  </argument>
996
+ <argument line="1984">
997
  <name>$keep_existing</name>
998
  <default><![CDATA[false]]></default>
999
  <type/>
1000
  </argument>
1001
  </method>
1002
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2035" package="Media Library Assistant">
1003
  <name>mla_fetch_attachment_metadata</name>
1004
  <full_name>mla_fetch_attachment_metadata</full_name>
1005
+ <docblock line="2023">
1006
  <description><![CDATA[Fetch and filter meta data for an attachment]]></description>
1007
  <long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
1008
  are stripped out or converted to an 'mla</em>' equivalent.</p>]]></long-description>
1009
+ <tag line="2023" name="since" description="0.1"/>
1010
+ <tag line="2023" name="param" description="post ID of attachment" type="int" variable="$post_id">
1011
  <type by_reference="false">int</type>
1012
  </tag>
1013
+ <tag line="2023" name="return" description="Meta data variables" type="array">
1014
  <type by_reference="false">array</type>
1015
  </tag>
1016
  </docblock>
1017
+ <argument line="2035">
1018
  <name>$post_id</name>
1019
  <default><![CDATA[]]></default>
1020
  <type/>
1021
  </argument>
1022
  </method>
1023
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2113" package="Media Library Assistant">
1024
  <name>mla_fetch_attachment_references</name>
1025
  <full_name>mla_fetch_attachment_references</full_name>
1026
+ <docblock line="2100">
1027
  <description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
1028
  <long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
1029
  as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
1030
+ <tag line="2100" name="since" description="0.1"/>
1031
+ <tag line="2100" name="param" description="post ID of attachment" type="int" variable="$ID">
1032
  <type by_reference="false">int</type>
1033
  </tag>
1034
+ <tag line="2100" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent">
1035
  <type by_reference="false">int</type>
1036
  </tag>
1037
+ <tag line="2100" name="return" description="Reference information; see $references array comments" type="array">
1038
  <type by_reference="false">array</type>
1039
  </tag>
1040
  </docblock>
1041
+ <argument line="2113">
1042
  <name>$ID</name>
1043
  <default><![CDATA[]]></default>
1044
  <type/>
1045
  </argument>
1046
+ <argument line="2113">
1047
  <name>$parent</name>
1048
  <default><![CDATA[]]></default>
1049
  <type/>
1050
  </argument>
1051
  </method>
1052
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2410" package="Media Library Assistant">
1053
  <name>mla_flush_mla_galleries</name>
1054
  <full_name>mla_flush_mla_galleries</full_name>
1055
+ <docblock line="2401">
1056
  <description><![CDATA[Invalidates the $mla_galleries or $galleries array and cached values]]></description>
1057
  <long-description><![CDATA[]]></long-description>
1058
+ <tag line="2401" name="since" description="1.00"/>
1059
+ <tag line="2401" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
1060
  <type by_reference="false">string</type>
1061
  </tag>
1062
+ <tag line="2401" name="return" description="" type="void">
1063
  <type by_reference="false">void</type>
1064
  </tag>
1065
  </docblock>
1066
+ <argument line="2410">
1067
  <name>$option_name</name>
1068
  <default><![CDATA[]]></default>
1069
  <type/>
1070
  </argument>
1071
  </method>
1072
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2434" package="Media Library Assistant">
1073
  <name>mla_save_post_action</name>
1074
  <full_name>mla_save_post_action</full_name>
1075
+ <docblock line="2425">
1076
  <description><![CDATA[Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates]]></description>
1077
  <long-description><![CDATA[]]></long-description>
1078
+ <tag line="2425" name="since" description="1.00"/>
1079
+ <tag line="2425" name="param" description="ID of post/page/attachment; not used at this time" type="integer" variable="$post_id">
1080
  <type by_reference="false">integer</type>
1081
  </tag>
1082
+ <tag line="2425" name="return" description="" type="void">
1083
  <type by_reference="false">void</type>
1084
  </tag>
1085
  </docblock>
1086
+ <argument line="2434">
1087
  <name>$post_id</name>
1088
  <default><![CDATA[]]></default>
1089
  <type/>
1090
  </argument>
1091
  </method>
1092
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2451" package="Media Library Assistant">
1093
  <name>_build_mla_galleries</name>
1094
  <full_name>_build_mla_galleries</full_name>
1095
+ <docblock line="2439">
1096
  <description><![CDATA[Builds the $mla_galleries or $galleries array]]></description>
1097
  <long-description><![CDATA[]]></long-description>
1098
+ <tag line="2439" name="since" description="0.70"/>
1099
+ <tag line="2439" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
1100
  <type by_reference="false">string</type>
1101
  </tag>
1102
+ <tag line="2439" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
1103
  <type by_reference="false">array</type>
1104
  </tag>
1105
+ <tag line="2439" name="param" description="the shortcode to be searched for and processed" type="string" variable="$shortcode">
1106
  <type by_reference="false">string</type>
1107
  </tag>
1108
+ <tag line="2439" name="param" description="true to exclude revisions from the search" type="boolean" variable="$exclude_revisions">
1109
  <type by_reference="false">boolean</type>
1110
  </tag>
1111
+ <tag line="2439" name="return" description="true if the galleries array is not empty" type="boolean">
1112
  <type by_reference="false">boolean</type>
1113
  </tag>
1114
  </docblock>
1115
+ <argument line="2451">
1116
  <name>$option_name</name>
1117
  <default><![CDATA[]]></default>
1118
  <type/>
1119
  </argument>
1120
+ <argument line="2451">
1121
  <name>$galleries_array</name>
1122
  <default><![CDATA[]]></default>
1123
  <type/>
1124
  </argument>
1125
+ <argument line="2451">
1126
  <name>$shortcode</name>
1127
  <default><![CDATA[]]></default>
1128
  <type/>
1129
  </argument>
1130
+ <argument line="2451">
1131
  <name>$exclude_revisions</name>
1132
  <default><![CDATA[]]></default>
1133
  <type/>
1134
  </argument>
1135
  </method>
1136
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2562" package="Media Library Assistant">
1137
  <name>_search_mla_galleries</name>
1138
  <full_name>_search_mla_galleries</full_name>
1139
+ <docblock line="2551">
1140
  <description><![CDATA[Search the $mla_galleries or $galleries array]]></description>
1141
  <long-description><![CDATA[]]></long-description>
1142
+ <tag line="2551" name="since" description="0.70"/>
1143
+ <tag line="2551" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
1144
  <type by_reference="false">array</type>
1145
  </tag>
1146
+ <tag line="2551" name="param" description="the attachment ID to be searched for and processed" type="int" variable="$attachment_id">
1147
  <type by_reference="false">int</type>
1148
  </tag>
1149
+ <tag line="2551" name="return" description="All posts/pages with one or more galleries that include the attachment. The array key is the parent_post ID; each entry contains post_title and post_type." type="array">
1150
  <type by_reference="false">array</type>
1151
  </tag>
1152
  </docblock>
1153
+ <argument line="2562">
1154
  <name>$galleries_array</name>
1155
  <default><![CDATA[]]></default>
1156
  <type/>
1157
  </argument>
1158
+ <argument line="2562">
1159
  <name>$attachment_id</name>
1160
  <default><![CDATA[]]></default>
1161
  <type/>
1162
  </argument>
1163
  </method>
1164
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2601" package="Media Library Assistant">
1165
  <name>_parse_pdf_xref_subsection</name>
1166
  <full_name>_parse_pdf_xref_subsection</full_name>
1167
+ <docblock line="2588">
1168
  <description><![CDATA[Parse a cross-reference table subsection into the array of indirect object definitions]]></description>
1169
  <long-description><![CDATA[<p>A cross-reference subsection is a sequence of 20-byte entries, each with offset and generation values.</p>]]></long-description>
1170
+ <tag line="2588" name="since" description="1.50"/>
1171
+ <tag line="2588" name="param" description="buffer containing the subsection" type="string" variable="$xref_section">
1172
  <type by_reference="false">string</type>
1173
  </tag>
1174
+ <tag line="2588" name="param" description="offset within the buffer of the first entry" type="integer" variable="$offset">
1175
  <type by_reference="false">integer</type>
1176
  </tag>
1177
+ <tag line="2588" name="param" description="number of the first object in the subsection" type="integer" variable="$object_id">
1178
  <type by_reference="false">integer</type>
1179
  </tag>
1180
+ <tag line="2588" name="param" description="number of entries in the subsection" type="integer" variable="$count">
1181
  <type by_reference="false">integer</type>
1182
  </tag>
1183
+ <tag line="2588" name="return" description="" type="void">
1184
  <type by_reference="false">void</type>
1185
  </tag>
1186
  </docblock>
1187
+ <argument line="2601">
1188
  <name>$xref_section</name>
1189
  <default><![CDATA[]]></default>
1190
  <type/>
1191
  </argument>
1192
+ <argument line="2601">
1193
  <name>$offset</name>
1194
  <default><![CDATA[]]></default>
1195
  <type/>
1196
  </argument>
1197
+ <argument line="2601">
1198
  <name>$object_id</name>
1199
  <default><![CDATA[]]></default>
1200
  <type/>
1201
  </argument>
1202
+ <argument line="2601">
1203
  <name>$count</name>
1204
  <default><![CDATA[]]></default>
1205
  <type/>
1206
  </argument>
1207
  </method>
1208
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2631" package="Media Library Assistant">
1209
  <name>_parse_pdf_xref_section</name>
1210
  <full_name>_parse_pdf_xref_section</full_name>
1211
+ <docblock line="2620">
1212
  <description><![CDATA[Parse a cross-reference table section into the array of indirect object definitions]]></description>
1213
  <long-description><![CDATA[<p>Creates the array of indirect object offsets and lengths</p>]]></long-description>
1214
+ <tag line="2620" name="since" description="1.50"/>
1215
+ <tag line="2620" name="param" description="full path and file name" type="string" variable="$file_name">
1216
  <type by_reference="false">string</type>
1217
  </tag>
1218
+ <tag line="2620" name="param" description="offset within the file of the xref id and count entry" type="integer" variable="$file_offset">
1219
  <type by_reference="false">integer</type>
1220
  </tag>
1221
+ <tag line="2620" name="return" description="length of the section" type="integer">
1222
  <type by_reference="false">integer</type>
1223
  </tag>
1224
  </docblock>
1225
+ <argument line="2631">
1226
  <name>$file_name</name>
1227
  <default><![CDATA[]]></default>
1228
  <type/>
1229
  </argument>
1230
+ <argument line="2631">
1231
  <name>$file_offset</name>
1232
  <default><![CDATA[]]></default>
1233
  <type/>
1234
  </argument>
1235
  </method>
1236
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2665" package="Media Library Assistant">
1237
  <name>_parse_pdf_xref_stream</name>
1238
  <full_name>_parse_pdf_xref_stream</full_name>
1239
+ <docblock line="2653">
1240
  <description><![CDATA[Parse a cross-reference steam into the array of indirect object definitions]]></description>
1241
  <long-description><![CDATA[<p>Creates the array of indirect object offsets and lengths</p>]]></long-description>
1242
+ <tag line="2653" name="since" description="1.50"/>
1243
+ <tag line="2653" name="param" description="full path and file name" type="string" variable="$file_name">
1244
  <type by_reference="false">string</type>
1245
  </tag>
1246
+ <tag line="2653" name="param" description="offset within the file of the xref id and count entry" type="integer" variable="$file_offset">
1247
  <type by_reference="false">integer</type>
1248
  </tag>
1249
+ <tag line="2653" name="param" description="&quot;/W&quot; entry, representing the size of the fields in a single entry" type="string" variable="$entry_parms_string">
1250
  <type by_reference="false">string</type>
1251
  </tag>
1252
+ <tag line="2653" name="return" description="length of the stream" type="integer">
1253
  <type by_reference="false">integer</type>
1254
  </tag>
1255
  </docblock>
1256
+ <argument line="2665">
1257
  <name>$file_name</name>
1258
  <default><![CDATA[]]></default>
1259
  <type/>
1260
  </argument>
1261
+ <argument line="2665">
1262
  <name>$file_offset</name>
1263
  <default><![CDATA[]]></default>
1264
  <type/>
1265
  </argument>
1266
+ <argument line="2665">
1267
  <name>$entry_parms_string</name>
1268
  <default><![CDATA[]]></default>
1269
  <type/>
1270
  </argument>
1271
  </method>
1272
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2739" package="Media Library Assistant">
1273
  <name>_build_pdf_indirect_objects</name>
1274
  <full_name>_build_pdf_indirect_objects</full_name>
1275
+ <docblock line="2729">
1276
  <description><![CDATA[Build an array of indirect object definitions]]></description>
1277
  <long-description><![CDATA[<p>Creates the array of indirect object offsets and lengths</p>]]></long-description>
1278
+ <tag line="2729" name="since" description="1.50"/>
1279
+ <tag line="2729" name="param" description="The entire PDF document, passsed by reference" type="string" variable="$string">
1280
  <type by_reference="false">string</type>
1281
  </tag>
1282
+ <tag line="2729" name="return" description="" type="void">
1283
  <type by_reference="false">void</type>
1284
  </tag>
1285
  </docblock>
1286
+ <argument line="2739">
1287
  <name>$string</name>
1288
  <default><![CDATA[]]></default>
1289
  <type/>
1290
  </argument>
1291
  </method>
1292
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2788" package="Media Library Assistant">
1293
  <name>_find_pdf_indirect_dictionary</name>
1294
  <full_name>_find_pdf_indirect_dictionary</full_name>
1295
+ <docblock line="2774">
1296
  <description><![CDATA[Find the offset, length and contents of an indirect object containing a dictionary]]></description>
1297
  <long-description><![CDATA[<p>The function searches the entire file, if necessary, to find the last/most recent copy of the object.
1298
  This is required because Adobe Acrobat does NOT increment the generation number when it reuses an object.</p>]]></long-description>
1299
+ <tag line="2774" name="since" description="1.50"/>
1300
+ <tag line="2774" name="param" description="full path and file name" type="string" variable="$file_name">
1301
  <type by_reference="false">string</type>
1302
  </tag>
1303
+ <tag line="2774" name="param" description="The object number" type="integer" variable="$object">
1304
  <type by_reference="false">integer</type>
1305
  </tag>
1306
+ <tag line="2774" name="param" description="The object generation number; default zero (0)" type="integer" variable="$generation">
1307
  <type by_reference="false">integer</type>
1308
  </tag>
1309
+ <tag line="2774" name="return" description="NULL on failure else array( 'start' =&gt; offset in the file, 'length' =&gt; object length, 'content' =&gt; dictionary contents )" type="mixed">
1310
  <type by_reference="false">mixed</type>
1311
  </tag>
1312
  </docblock>
1313
+ <argument line="2788">
1314
  <name>$file_name</name>
1315
  <default><![CDATA[]]></default>
1316
  <type/>
1317
  </argument>
1318
+ <argument line="2788">
1319
  <name>$object</name>
1320
  <default><![CDATA[]]></default>
1321
  <type/>
1322
  </argument>
1323
+ <argument line="2788">
1324
  <name>$generation</name>
1325
  <default><![CDATA[0]]></default>
1326
  <type/>
1327
  </argument>
1328
  </method>
1329
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2884" package="Media Library Assistant">
1330
  <name>_parse_iso8601_date</name>
1331
  <full_name>_parse_iso8601_date</full_name>
1332
+ <docblock line="2875">
1333
  <description><![CDATA[Parse a ISO 8601 Timestamp]]></description>
1334
  <long-description><![CDATA[]]></long-description>
1335
+ <tag line="2875" name="since" description="1.50"/>
1336
+ <tag line="2875" name="param" description="ISO string of the form YYYY-MM-DDTHH:MM:SS-HH:MM (inc time zone)" type="string" variable="$source_string">
1337
  <type by_reference="false">string</type>
1338
  </tag>
1339
+ <tag line="2875" name="return" description="formatted date string YYYY-MM-DD HH:mm:SS" type="string">
1340
  <type by_reference="false">string</type>
1341
  </tag>
1342
  </docblock>
1343
+ <argument line="2884">
1344
  <name>$source_string</name>
1345
  <default><![CDATA[]]></default>
1346
  <type/>
1347
  </argument>
1348
  </method>
1349
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2906" package="Media Library Assistant">
1350
  <name>_parse_pdf_date</name>
1351
  <full_name>_parse_pdf_date</full_name>
1352
+ <docblock line="2897">
1353
  <description><![CDATA[Parse a PDF date string]]></description>
1354
  <long-description><![CDATA[]]></long-description>
1355
+ <tag line="2897" name="since" description="1.50"/>
1356
+ <tag line="2897" name="param" description="PDF date string of the form D:YYYYMMDDHHmmSSOHH'mm" type="string" variable="$source_string">
1357
  <type by_reference="false">string</type>
1358
  </tag>
1359
+ <tag line="2897" name="return" description="formatted date string YYYY-MM-DD HH:mm:SS" type="string">
1360
  <type by_reference="false">string</type>
1361
  </tag>
1362
  </docblock>
1363
+ <argument line="2906">
1364
  <name>$source_string</name>
1365
  <default><![CDATA[]]></default>
1366
  <type/>
1367
  </argument>
1368
  </method>
1369
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2928" package="Media Library Assistant">
1370
  <name>_parse_pdf_UTF16BE</name>
1371
  <full_name>_parse_pdf_UTF16BE</full_name>
1372
+ <docblock line="2919">
1373
  <description><![CDATA[Parse a PDF Unicode (16-bit Big Endian) object]]></description>
1374
  <long-description><![CDATA[]]></long-description>
1375
+ <tag line="2919" name="since" description="1.50"/>
1376
+ <tag line="2919" name="param" description="PDF string of 16-bit characters" type="string" variable="$source_string">
1377
  <type by_reference="false">string</type>
1378
  </tag>
1379
+ <tag line="2919" name="return" description="UTF-8 encoded string" type="string">
1380
  <type by_reference="false">string</type>
1381
  </tag>
1382
  </docblock>
1383
+ <argument line="2928">
1384
  <name>$source_string</name>
1385
  <default><![CDATA[]]></default>
1386
  <type/>
1387
  </argument>
1388
  </method>
1389
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2957" package="Media Library Assistant">
1390
  <name>_parse_pdf_string</name>
1391
  <full_name>_parse_pdf_string</full_name>
1392
+ <docblock line="2944">
1393
  <description><![CDATA[Parse a PDF string object]]></description>
1394
  <long-description><![CDATA[<p>Returns an array with one dictionary entry. The array also has a '/length' element containing
1395
  the number of bytes occupied by the string in the source string, including the enclosing parentheses.</p>]]></long-description>
1396
+ <tag line="2944" name="since" description="1.50"/>
1397
+ <tag line="2944" name="param" description="data within which the string occurs" type="string" variable="$source_string">
1398
  <type by_reference="false">string</type>
1399
  </tag>
1400
+ <tag line="2944" name="param" description="offset within the source string of the opening '(' character." type="integer" variable="$offset">
1401
  <type by_reference="false">integer</type>
1402
  </tag>
1403
+ <tag line="2944" name="return" description="( key =&gt; array( 'type' =&gt; type, 'value' =&gt; value, '/length' =&gt; length ) ) for the string" type="array">
1404
  <type by_reference="false">array</type>
1405
  </tag>
1406
  </docblock>
1407
+ <argument line="2957">
1408
  <name>$source_string</name>
1409
  <default><![CDATA[]]></default>
1410
  <type/>
1411
  </argument>
1412
+ <argument line="2957">
1413
  <name>$offset</name>
1414
  <default><![CDATA[]]></default>
1415
  <type/>
1416
  </argument>
1417
  </method>
1418
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3045" package="Media Library Assistant">
1419
  <name>_parse_pdf_LPD_dictionary</name>
1420
  <full_name>_parse_pdf_LPD_dictionary</full_name>
1421
+ <docblock line="3031">
1422
  <description><![CDATA[Parse a PDF Linearization Parameter Dictionary object]]></description>
1423
  <long-description><![CDATA[<p>Returns an array of dictionary contents, classified by object type: boolean, numeric, string, hex (string),
1424
  indirect (object), name, array, dictionary, stream, and null.
1425
  The array also has a '/length' element containing the number of bytes occupied by the
1426
  dictionary in the source string, excluding the enclosing delimiters, if passed in.</p>]]></long-description>
1427
+ <tag line="3031" name="since" description="1.50"/>
1428
+ <tag line="3031" name="param" description="data within which the object occurs, typically the start of a PDF document" type="string" variable="$source_string">
1429
  <type by_reference="false">string</type>
1430
  </tag>
1431
+ <tag line="3031" name="param" description="filesize of the PDF document, for validation purposes, or zero (0) to ignore filesize" type="integer" variable="$filesize">
1432
  <type by_reference="false">integer</type>
1433
  </tag>
1434
+ <tag line="3031" name="return" description="array of dictionary objects on success, false on failure" type="mixed">
1435
  <type by_reference="false">mixed</type>
1436
  </tag>
1437
  </docblock>
1438
+ <argument line="3045">
1439
  <name>$source_string</name>
1440
  <default><![CDATA[]]></default>
1441
  <type/>
1442
  </argument>
1443
+ <argument line="3045">
1444
  <name>$filesize</name>
1445
  <default><![CDATA[]]></default>
1446
  <type/>
1447
  </argument>
1448
  </method>
1449
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3069" package="Media Library Assistant">
1450
  <name>_parse_pdf_dictionary</name>
1451
  <full_name>_parse_pdf_dictionary</full_name>
1452
+ <docblock line="3055">
1453
  <description><![CDATA[Parse a PDF dictionary object]]></description>
1454
  <long-description><![CDATA[<p>Returns an array of dictionary contents, classified by object type: boolean, numeric, string, hex (string),
1455
  indirect (object), name, array, dictionary, stream, and null.
1456
  The array also has a '/length' element containing the number of bytes occupied by the
1457
  dictionary in the source string, excluding the enclosing delimiters.</p>]]></long-description>
1458
+ <tag line="3055" name="since" description="1.50"/>
1459
+ <tag line="3055" name="param" description="data within which the string occurs" type="string" variable="$source_string">
1460
  <type by_reference="false">string</type>
1461
  </tag>
1462
+ <tag line="3055" name="param" description="offset within the source string of the opening '&lt;&lt;' characters or the first content character." type="integer" variable="$offset">
1463
  <type by_reference="false">integer</type>
1464
  </tag>
1465
+ <tag line="3055" name="return" description="( '/length' =&gt; length, key =&gt; array( 'type' =&gt; type, 'value' =&gt; value ) ) for each dictionary field" type="array">
1466
  <type by_reference="false">array</type>
1467
  </tag>
1468
  </docblock>
1469
+ <argument line="3069">
1470
  <name>$source_string</name>
1471
  <default><![CDATA[]]></default>
1472
  <type/>
1473
  </argument>
1474
+ <argument line="3069">
1475
  <name>$offset</name>
1476
  <default><![CDATA[]]></default>
1477
  <type/>
1478
  </argument>
1479
  </method>
1480
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3203" package="Media Library Assistant">
1481
  <name>_parse_xmp_metadata</name>
1482
  <full_name>_parse_xmp_metadata</full_name>
1483
+ <docblock line="3189">
1484
  <description><![CDATA[Parse an XMP object]]></description>
1485
  <long-description><![CDATA[<p>Returns an array of dictionary contents, classified by object type: boolean, numeric, string, hex (string),
1486
  indirect (object), name, array, dictionary, stream, and null.
1487
  The array also has a '/length' element containing the number of bytes occupied by the
1488
  dictionary in the source string, excluding the enclosing delimiters, if passed in.</p>]]></long-description>
1489
+ <tag line="3189" name="since" description="1.50"/>
1490
+ <tag line="3189" name="param" description="full path and file name" type="string" variable="$file_name">
1491
  <type by_reference="false">string</type>
1492
  </tag>
1493
+ <tag line="3189" name="param" description="offset within the file of the search start point" type="integer" variable="$file_offset">
1494
  <type by_reference="false">integer</type>
1495
  </tag>
1496
+ <tag line="3189" name="return" description="array of metadata values or NULL on failure" type="mixed">
1497
  <type by_reference="false">mixed</type>
1498
  </tag>
1499
  </docblock>
1500
+ <argument line="3203">
1501
  <name>$file_name</name>
1502
  <default><![CDATA[]]></default>
1503
  <type/>
1504
  </argument>
1505
+ <argument line="3203">
1506
  <name>$file_offset</name>
1507
  <default><![CDATA[]]></default>
1508
  <type/>
1509
  </argument>
1510
  </method>
1511
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3471" package="Media Library Assistant">
1512
  <name>_extract_pdf_trailer</name>
1513
  <full_name>_extract_pdf_trailer</full_name>
1514
+ <docblock line="3461">
1515
  <description><![CDATA[Extract dictionary from traditional cross-reference + trailer documents]]></description>
1516
  <long-description><![CDATA[]]></long-description>
1517
+ <tag line="3461" name="since" description="1.50"/>
1518
+ <tag line="3461" name="param" description="full path to the desired file" type="string" variable="$file_name">
1519
  <type by_reference="false">string</type>
1520
  </tag>
1521
+ <tag line="3461" name="param" description="offset within file of the cross-reference table" type="integer" variable="$file_offset">
1522
  <type by_reference="false">integer</type>
1523
  </tag>
1524
+ <tag line="3461" name="return" description="array of &quot;PDF dictionary arrays&quot;, newest first, or NULL on failure" type="mixed">
1525
  <type by_reference="false">mixed</type>
1526
  </tag>
1527
  </docblock>
1528
+ <argument line="3471">
1529
  <name>$file_name</name>
1530
  <default><![CDATA[]]></default>
1531
  <type/>
1532
  </argument>
1533
+ <argument line="3471">
1534
  <name>$file_offset</name>
1535
  <default><![CDATA[]]></default>
1536
  <type/>
1537
  </argument>
1538
  </method>
1539
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3555" package="Media Library Assistant">
1540
  <name>_extract_pdf_metadata</name>
1541
  <full_name>_extract_pdf_metadata</full_name>
1542
+ <docblock line="3546">
1543
  <description><![CDATA[Extract Metadata from a PDF file]]></description>
1544
  <long-description><![CDATA[]]></long-description>
1545
+ <tag line="3546" name="since" description="1.50"/>
1546
+ <tag line="3546" name="param" description="full path to the desired file" type="string" variable="$file_name">
1547
  <type by_reference="false">string</type>
1548
  </tag>
1549
+ <tag line="3546" name="return" description="( key =&gt; value ) for each metadata field, in string format" type="array">
1550
  <type by_reference="false">array</type>
1551
  </tag>
1552
  </docblock>
1553
+ <argument line="3555">
1554
  <name>$file_name</name>
1555
  <default><![CDATA[]]></default>
1556
  <type/>
1557
  </argument>
1558
  </method>
1559
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3682" package="Media Library Assistant">
1560
  <name>_bin_to_utf8</name>
1561
  <full_name>_bin_to_utf8</full_name>
1562
+ <docblock line="3673">
1563
  <description><![CDATA[Replace SQL incorrect characters (0x80 - 0xFF) with their UTF-8 equivalents]]></description>
1564
  <long-description><![CDATA[]]></long-description>
1565
+ <tag line="3673" name="since" description="1.41"/>
1566
+ <tag line="3673" name="param" description="unencoded string" type="string" variable="$string">
1567
  <type by_reference="false">string</type>
1568
  </tag>
1569
+ <tag line="3673" name="return" description="UTF-8 encoded string" type="string">
1570
  <type by_reference="false">string</type>
1571
  </tag>
1572
  </docblock>
1573
+ <argument line="3682">
1574
  <name>$string</name>
1575
  <default><![CDATA[]]></default>
1576
  <type/>
1577
  </argument>
1578
  </method>
1579
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4078" package="Media Library Assistant">
1580
  <name>mla_iptc_metadata_value</name>
1581
  <full_name>mla_iptc_metadata_value</full_name>
1582
+ <docblock line="4068">
1583
  <description><![CDATA[Parse one IPTC metadata field]]></description>
1584
  <long-description><![CDATA[]]></long-description>
1585
+ <tag line="4068" name="since" description="1.41"/>
1586
+ <tag line="4068" name="param" description="field name - IPTC Identifier or friendly name/slug" type="string" variable="$iptc_key">
1587
  <type by_reference="false">string</type>
1588
  </tag>
1589
+ <tag line="4068" name="param" description="metadata array containing iptc, exif, and pdf metadata arrays" type="string" variable="$item_metadata">
1590
  <type by_reference="false">string</type>
1591
  </tag>
1592
+ <tag line="4068" name="return" description="string/array representation of metadata value or an empty string" type="mixed">
1593
  <type by_reference="false">mixed</type>
1594
  </tag>
1595
  </docblock>
1596
+ <argument line="4078">
1597
  <name>$iptc_key</name>
1598
  <default><![CDATA[]]></default>
1599
  <type/>
1600
  </argument>
1601
+ <argument line="4078">
1602
  <name>$item_metadata</name>
1603
  <default><![CDATA[]]></default>
1604
  <type/>
1605
  </argument>
1606
  </method>
1607
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4110" package="Media Library Assistant">
1608
  <name>mla_exif_metadata_value</name>
1609
  <full_name>mla_exif_metadata_value</full_name>
1610
+ <docblock line="4098">
1611
  <description><![CDATA[Parse one EXIF metadata field]]></description>
1612
  <long-description><![CDATA[<p>Also handles the special pseudo-values 'ALL_EXIF' and 'ALL_IPTC'.</p>]]></long-description>
1613
+ <tag line="4098" name="since" description="1.13"/>
1614
+ <tag line="4098" name="param" description="field name" type="string" variable="$exif_key">
1615
  <type by_reference="false">string</type>
1616
  </tag>
1617
+ <tag line="4098" name="param" description="metadata array containing iptc, exif, and pdf metadata arrays" type="string" variable="$item_metadata">
1618
  <type by_reference="false">string</type>
1619
  </tag>
1620
+ <tag line="4098" name="return" description="string/array representation of metadata value or an empty string" type="mixed">
1621
  <type by_reference="false">mixed</type>
1622
  </tag>
1623
  </docblock>
1624
+ <argument line="4110">
1625
  <name>$exif_key</name>
1626
  <default><![CDATA[]]></default>
1627
  <type/>
1628
  </argument>
1629
+ <argument line="4110">
1630
  <name>$item_metadata</name>
1631
  <default><![CDATA[]]></default>
1632
  <type/>
1633
  </argument>
1634
  </method>
1635
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4169" package="Media Library Assistant">
1636
  <name>mla_pdf_metadata_value</name>
1637
  <full_name>mla_pdf_metadata_value</full_name>
1638
+ <docblock line="4157">
1639
  <description><![CDATA[Parse one PDF metadata field]]></description>
1640
  <long-description><![CDATA[<p>Also handles the special pseudo-value 'ALL_PDF'.</p>]]></long-description>
1641
+ <tag line="4157" name="since" description="1.50"/>
1642
+ <tag line="4157" name="param" description="field name" type="string" variable="$pdf_key">
1643
  <type by_reference="false">string</type>
1644
  </tag>
1645
+ <tag line="4157" name="param" description="metadata array containing iptc, exif, and pdf metadata arrays" type="string" variable="$item_metadata">
1646
  <type by_reference="false">string</type>
1647
  </tag>
1648
+ <tag line="4157" name="return" description="string/array representation of metadata value or an empty string" type="mixed">
1649
  <type by_reference="false">mixed</type>
1650
  </tag>
1651
  </docblock>
1652
+ <argument line="4169">
1653
  <name>$pdf_key</name>
1654
  <default><![CDATA[]]></default>
1655
  <type/>
1656
  </argument>
1657
+ <argument line="4169">
1658
  <name>$item_metadata</name>
1659
  <default><![CDATA[]]></default>
1660
  <type/>
1661
  </argument>
1662
  </method>
1663
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="4209" package="Media Library Assistant">
1664
  <name>_rational_to_decimal</name>
1665
  <full_name>_rational_to_decimal</full_name>
1666
+ <docblock line="4200">
1667
  <description><![CDATA[Convert an EXIF GPS rational value to a PHP float value]]></description>
1668
  <long-description><![CDATA[]]></long-description>
1669
+ <tag line="4200" name="since" description="1.50"/>
1670
+ <tag line="4200" name="param" description="array( 0 =&gt; numerator, 1 =&gt; denominator )" type="array" variable="$rational">
1671
  <type by_reference="false">array</type>
1672
  </tag>
1673
+ <tag line="4200" name="return" description="numerator/denominator" type="float">
1674
  <type by_reference="false">float</type>
1675
  </tag>
1676
  </docblock>
1677
+ <argument line="4209">
1678
  <name>$rational</name>
1679
  <default><![CDATA[]]></default>
1680
  <type/>
1681
  </argument>
1682
  </method>
1683
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4224" package="Media Library Assistant">
1684
  <name>mla_fetch_attachment_image_metadata</name>
1685
  <full_name>mla_fetch_attachment_image_metadata</full_name>
1686
+ <docblock line="4214">
1687
  <description><![CDATA[Fetch and filter IPTC and EXIF or PDF metadata for an image attachment]]></description>
1688
  <long-description><![CDATA[]]></long-description>
1689
+ <tag line="4214" name="since" description="0.90"/>
1690
+ <tag line="4214" name="param" description="post ID of attachment" type="int" variable="$post_id">
1691
  <type by_reference="false">int</type>
1692
  </tag>
1693
+ <tag line="4214" name="param" description="optional; if $post_id is zero, path to the image file." type="string" variable="$path">
1694
  <type by_reference="false">string</type>
1695
  </tag>
1696
+ <tag line="4214" name="return" description="Meta data variables, IPTC and EXIF or PDF" type="array">
1697
  <type by_reference="false">array</type>
1698
  </tag>
1699
  </docblock>
1700
+ <argument line="4224">
1701
  <name>$post_id</name>
1702
  <default><![CDATA[]]></default>
1703
  <type/>
1704
  </argument>
1705
+ <argument line="4224">
1706
  <name>$path</name>
1707
  <default><![CDATA['']]></default>
1708
  <type/>
1709
  </argument>
1710
  </method>
1711
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="4397" package="Media Library Assistant">
1712
  <name>_update_wp_attachment_metadata</name>
1713
  <full_name>_update_wp_attachment_metadata</full_name>
1714
+ <docblock line="4387">
1715
  <description><![CDATA[Update one "meta:" data for a single attachment]]></description>
1716
  <long-description><![CDATA[]]></long-description>
1717
+ <tag line="4387" name="since" description="1.51"/>
1718
+ <tag line="4387" name="param" description="The current wp_attachment_metadata value" type="array" variable="$current_values">
1719
  <type by_reference="false">array</type>
1720
  </tag>
1721
+ <tag line="4387" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_meta">
1722
  <type by_reference="false">array</type>
1723
  </tag>
1724
+ <tag line="4387" name="return" description="success/failure message(s); empty string if no changes." type="string">
1725
  <type by_reference="false">string</type>
1726
  </tag>
1727
  </docblock>
1728
+ <argument line="4397">
1729
  <name>$current_values</name>
1730
  <default><![CDATA[]]></default>
1731
  <type/>
1732
  </argument>
1733
+ <argument line="4397">
1734
  <name>$new_meta</name>
1735
  <default><![CDATA[]]></default>
1736
  <type/>
1737
  </argument>
1738
  </method>
1739
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4469" package="Media Library Assistant">
1740
  <name>mla_update_item_postmeta</name>
1741
  <full_name>mla_update_item_postmeta</full_name>
1742
+ <docblock line="4459">
1743
  <description><![CDATA[Update custom field and "meta:" data for a single attachment]]></description>
1744
  <long-description><![CDATA[]]></long-description>
1745
+ <tag line="4459" name="since" description="1.40"/>
1746
+ <tag line="4459" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
1747
  <type by_reference="false">int</type>
1748
  </tag>
1749
+ <tag line="4459" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_meta">
1750
  <type by_reference="false">array</type>
1751
  </tag>
1752
+ <tag line="4459" name="return" description="success/failure message(s)" type="string">
1753
  <type by_reference="false">string</type>
1754
  </tag>
1755
  </docblock>
1756
+ <argument line="4469">
1757
  <name>$post_id</name>
1758
  <default><![CDATA[]]></default>
1759
  <type/>
1760
  </argument>
1761
+ <argument line="4469">
1762
  <name>$new_meta</name>
1763
  <default><![CDATA[]]></default>
1764
  <type/>
1765
  </argument>
1766
  </method>
1767
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4616" package="Media Library Assistant">
1768
  <name>mla_update_single_item</name>
1769
  <full_name>mla_update_single_item</full_name>
1770
+ <docblock line="4603">
1771
  <description><![CDATA[Update a single item; change the "post" data, taxonomy terms
1772
  and meta data for a single attachment]]></description>
1773
  <long-description><![CDATA[]]></long-description>
1774
+ <tag line="4603" name="since" description="0.1"/>
1775
+ <tag line="4603" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
1776
  <type by_reference="false">int</type>
1777
  </tag>
1778
+ <tag line="4603" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_data">
1779
  <type by_reference="false">array</type>
1780
  </tag>
1781
+ <tag line="4603" name="param" description="Optional taxonomy term values, default null" type="array" variable="$tax_input">
1782
  <type by_reference="false">array</type>
1783
  </tag>
1784
+ <tag line="4603" name="param" description="Optional taxonomy actions (add, remove, replace), default null" type="array" variable="$tax_actions">
1785
  <type by_reference="false">array</type>
1786
  </tag>
1787
+ <tag line="4603" name="return" description="success/failure message and NULL content" type="array">
1788
  <type by_reference="false">array</type>
1789
  </tag>
1790
  </docblock>
1791
+ <argument line="4616">
1792
  <name>$post_id</name>
1793
  <default><![CDATA[]]></default>
1794
  <type/>
1795
  </argument>
1796
+ <argument line="4616">
1797
  <name>$new_data</name>
1798
  <default><![CDATA[]]></default>
1799
  <type/>
1800
  </argument>
1801
+ <argument line="4616">
1802
  <name>$tax_input</name>
1803
  <default><![CDATA[NULL]]></default>
1804
  <type/>
1805
  </argument>
1806
+ <argument line="4616">
1807
  <name>$tax_actions</name>
1808
  <default><![CDATA[NULL]]></default>
1809
  <type/>
1810
  </argument>
1811
  </method>
1812
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="4829" package="Media Library Assistant">
1813
  <name>_remove_tags</name>
1814
  <full_name>_remove_tags</full_name>
1815
+ <docblock line="4818">
1816
  <description><![CDATA[Remove tags from a term ids list]]></description>
1817
  <long-description><![CDATA[]]></long-description>
1818
+ <tag line="4818" name="since" description="0.40"/>
1819
+ <tag line="4818" name="param" description="The term ids currently assigned" type="array" variable="$terms_before">
1820
  <type by_reference="false">array</type>
1821
  </tag>
1822
+ <tag line="4818" name="param" description="| string The term ids (array) or names (string) to remove" type="array" variable="$tags">
1823
  <type by_reference="false">array</type>
1824
  </tag>
1825
+ <tag line="4818" name="param" description="The taxonomy object" type="object" variable="$taxonomy_obj">
1826
  <type by_reference="false">object</type>
1827
  </tag>
1828
+ <tag line="4818" name="return" description="Term ids of the surviving tags" type="array">
1829
  <type by_reference="false">array</type>
1830
  </tag>
1831
  </docblock>
1832
+ <argument line="4829">
1833
  <name>$terms_before</name>
1834
  <default><![CDATA[]]></default>
1835
  <type/>
1836
  </argument>
1837
+ <argument line="4829">
1838
  <name>$tags</name>
1839
  <default><![CDATA[]]></default>
1840
  <type/>
1841
  </argument>
1842
+ <argument line="4829">
1843
  <name>$taxonomy_obj</name>
1844
  <default><![CDATA[]]></default>
1845
  <type/>
1846
  </argument>
1847
  </method>
1848
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="4873" package="Media Library Assistant">
1849
  <name>_hex_dump</name>
1850
  <full_name>_hex_dump</full_name>
1851
+ <docblock line="4861">
1852
  <description><![CDATA[Format printable version of binary data]]></description>
1853
  <long-description><![CDATA[]]></long-description>
1854
+ <tag line="4861" name="since" description="0.90"/>
1855
+ <tag line="4861" name="param" description="Binary data" type="string" variable="$data">
1856
  <type by_reference="false">string</type>
1857
  </tag>
1858
+ <tag line="4861" name="param" description="Bytes to format, default = 0 (all bytes)" type="integer" variable="$limit">
1859
  <type by_reference="false">integer</type>
1860
  </tag>
1861
+ <tag line="4861" name="param" description="Bytes to format on each line" type="\intger" variable="$bytes_per_row">
1862
  <type by_reference="false">\intger</type>
1863
  </tag>
1864
+ <tag line="4861" name="param" description="offset of initial byte, or -1 to suppress printing offset information" type="integer" variable="$offset">
1865
  <type by_reference="false">integer</type>
1866
  </tag>
1867
+ <tag line="4861" name="return" description="Printable representation of $data" type="string">
1868
  <type by_reference="false">string</type>
1869
  </tag>
1870
  </docblock>
1871
+ <argument line="4873">
1872
  <name>$data</name>
1873
  <default><![CDATA[]]></default>
1874
  <type/>
1875
  </argument>
1876
+ <argument line="4873">
1877
  <name>$limit</name>
1878
  <default><![CDATA[0]]></default>
1879
  <type/>
1880
  </argument>
1881
+ <argument line="4873">
1882
  <name>$bytes_per_row</name>
1883
  <default><![CDATA[16]]></default>
1884
  <type/>
1885
  </argument>
1886
+ <argument line="4873">
1887
  <name>$offset</name>
1888
  <default><![CDATA[-1]]></default>
1889
  <type/>
1891
  </method>
1892
  </class>
1893
  <markers>
1894
+ <todo line="2937">encode the rest</todo>
1895
  </markers>
1896
  </file>
1897
  <file path="includes\class-mla-edit-media.php" hash="d577ae28826df9fbc9275e0e7d255780" package="Media Library Assistant">
2198
  </method>
2199
  </class>
2200
  </file>
2201
+ <file path="includes\class-mla-list-table.php" hash="79b1d73b3979353850832d17ffc05706" package="Media Library Assistant">
2202
  <docblock line="2">
2203
  <description><![CDATA[Media Library Assistant extended List Table class]]></description>
2204
  <long-description><![CDATA[]]></long-description>
2437
  <name>__construct</name>
2438
  <full_name>__construct</full_name>
2439
  <docblock line="350">
2440
+ <description><![CDATA[Initializes some properties from $_REQUEST variables, then
2441
  calls the parent constructor to set some default configs.]]></description>
2442
  <long-description><![CDATA[]]></long-description>
2443
  <tag line="350" name="since" description="0.1"/>
3172
  </method>
3173
  </class>
3174
  </file>
3175
+ <file path="includes\class-mla-main.php" hash="1daf2ba9c34725188fc54439e1ae869c" package="Media Library Assistant">
3176
  <docblock line="2">
3177
  <description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
3178
  <long-description><![CDATA[]]></long-description>
3209
  <constant namespace="global" line="41" package="Media Library Assistant">
3210
  <name>CURRENT_MLA_VERSION</name>
3211
  <full_name>CURRENT_MLA_VERSION</full_name>
3212
+ <value><![CDATA['1.60']]></value>
3213
  <docblock line="34">
3214
  <description><![CDATA[Current version number]]></description>
3215
  <long-description><![CDATA[]]></long-description>
3459
  <type/>
3460
  </argument>
3461
  </method>
3462
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="315" package="Media Library Assistant">
3463
  <name>mla_admin_menu_action</name>
3464
  <full_name>mla_admin_menu_action</full_name>
3465
+ <docblock line="300">
3466
  <description><![CDATA[Add the submenu pages]]></description>
3467
  <long-description><![CDATA[<p>Add a submenu page in the "Media" section,
3468
  add settings page in the "Settings" section.
3471
  <p>For WordPress versions before 3.5,
3472
  add submenu page(s) for attachment taxonomies,
3473
  add filter to clean up taxonomy submenu labels.</p>]]></long-description>
3474
+ <tag line="300" name="since" description="0.1"/>
3475
+ <tag line="300" name="return" description="" type="void">
3476
  <type by_reference="false">void</type>
3477
  </tag>
3478
  </docblock>
3479
  </method>
3480
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="384" package="Media Library Assistant">
3481
+ <name>mla_load_media_action</name>
3482
+ <full_name>mla_load_media_action</full_name>
3483
+ <docblock line="377">
3484
+ <description><![CDATA[Redirect to Media/Assistant if Media/Library is hidden]]></description>
3485
+ <long-description><![CDATA[]]></long-description>
3486
+ <tag line="377" name="since" description="1.60"/>
3487
+ <tag line="377" name="return" description="" type="void">
3488
+ <type by_reference="false">void</type>
3489
+ </tag>
3490
+ </docblock>
3491
+ </method>
3492
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="411" package="Media Library Assistant">
3493
  <name>mla_add_menu_options</name>
3494
  <full_name>mla_add_menu_options</full_name>
3495
+ <docblock line="404">
3496
  <description><![CDATA[Add the "XX Entries per page" filter to the Screen Options tab]]></description>
3497
  <long-description><![CDATA[]]></long-description>
3498
+ <tag line="404" name="since" description="0.1"/>
3499
+ <tag line="404" name="return" description="" type="void">
3500
  <type by_reference="false">void</type>
3501
  </tag>
3502
  </docblock>
3503
  </method>
3504
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="430" package="Media Library Assistant">
3505
  <name>mla_add_help_tab</name>
3506
  <full_name>mla_add_help_tab</full_name>
3507
+ <docblock line="423">
3508
  <description><![CDATA[Add contextual help tabs to all the MLA pages]]></description>
3509
  <long-description><![CDATA[]]></long-description>
3510
+ <tag line="423" name="since" description="0.1"/>
3511
+ <tag line="423" name="return" description="" type="void">
3512
  <type by_reference="false">void</type>
3513
  </tag>
3514
  </docblock>
3515
  </method>
3516
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="531" package="Media Library Assistant">
3517
  <name>mla_screen_options_show_screen_filter</name>
3518
  <full_name>mla_screen_options_show_screen_filter</full_name>
3519
+ <docblock line="521">
3520
  <description><![CDATA[Only show screen options on the table-list screen]]></description>
3521
  <long-description><![CDATA[]]></long-description>
3522
+ <tag line="521" name="since" description="0.1"/>
3523
+ <tag line="521" name="param" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean" variable="$show_screen">
3524
  <type by_reference="false">boolean</type>
3525
  </tag>
3526
+ <tag line="521" name="param" description="Name of the page being loaded" type="string" variable="$this_screen">
3527
  <type by_reference="false">string</type>
3528
  </tag>
3529
+ <tag line="521" name="return" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean">
3530
  <type by_reference="false">boolean</type>
3531
  </tag>
3532
  </docblock>
3533
+ <argument line="531">
3534
  <name>$show_screen</name>
3535
  <default><![CDATA[]]></default>
3536
  <type/>
3537
  </argument>
3538
+ <argument line="531">
3539
  <name>$this_screen</name>
3540
  <default><![CDATA[]]></default>
3541
  <type/>
3542
  </argument>
3543
  </method>
3544
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="549" package="Media Library Assistant">
3545
  <name>mla_set_screen_option_filter</name>
3546
  <full_name>mla_set_screen_option_filter</full_name>
3547
+ <docblock line="538">
3548
  <description><![CDATA[Save the "Entries per page" option set by this user]]></description>
3549
  <long-description><![CDATA[]]></long-description>
3550
+ <tag line="538" name="since" description="0.1"/>
3551
+ <tag line="538" name="param" description="false or value returned by previous filter" type="mixed" variable="$status">
3552
  <type by_reference="false">mixed</type>
3553
  </tag>
3554
+ <tag line="538" name="param" description="Name of the option being changed" type="string" variable="$option">
3555
  <type by_reference="false">string</type>
3556
  </tag>
3557
+ <tag line="538" name="param" description="New value of the option" type="string" variable="$value">
3558
  <type by_reference="false">string</type>
3559
  </tag>
3560
+ <tag line="538" name="return" description="New value if this is our option, otherwise nothing" type="string|void">
3561
  <type by_reference="false">string</type>
3562
  <type by_reference="false">void</type>
3563
  </tag>
3564
  </docblock>
3565
+ <argument line="549">
3566
  <name>$status</name>
3567
  <default><![CDATA[]]></default>
3568
  <type/>
3569
  </argument>
3570
+ <argument line="549">
3571
  <name>$option</name>
3572
  <default><![CDATA[]]></default>
3573
  <type/>
3574
  </argument>
3575
+ <argument line="549">
3576
  <name>$value</name>
3577
  <default><![CDATA[]]></default>
3578
  <type/>
3579
  </argument>
3580
  </method>
3581
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="568" package="Media Library Assistant">
3582
  <name>mla_edit_tax_redirect</name>
3583
  <full_name>mla_edit_tax_redirect</full_name>
3584
+ <docblock line="557">
3585
  <description><![CDATA[Redirect to the Edit Tags/Categories page]]></description>
3586
  <long-description><![CDATA[<p>The custom taxonomy add/edit submenu entries go to "upload.php" by default.
3587
  This filter is the only way to redirect them to the correct WordPress page.
3588
  The filter is not required for WordPress 3.5 and later.</p>]]></long-description>
3589
+ <tag line="557" name="since" description="0.1"/>
3590
+ <tag line="557" name="return" description="" type="void">
3591
  <type by_reference="false">void</type>
3592
  </tag>
3593
  </docblock>
3594
  </method>
3595
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="601" package="Media Library Assistant">
3596
  <name>mla_parent_file_filter</name>
3597
  <full_name>mla_parent_file_filter</full_name>
3598
+ <docblock line="585">
3599
  <description><![CDATA[Cleanup menus for Edit Tags/Categories page]]></description>
3600
  <long-description><![CDATA[<p>For WordPress before 3.5, the submenu entries for custom taxonomies
3601
  under the "Media" menu are not set up correctly by WordPress, so this
3603
  page for editing/adding taxonomy terms.
3604
  For WordPress 3.5 and later, the function fixes the submenu bolding when
3605
  going to the Edit Media screen.</p>]]></long-description>
3606
+ <tag line="585" name="since" description="0.1"/>
3607
+ <tag line="585" name="param" description="The top-level menu page" type="array" variable="$parent_file">
3608
  <type by_reference="false">array</type>
3609
  </tag>
3610
+ <tag line="585" name="return" description="The updated top-level menu page" type="string">
3611
  <type by_reference="false">string</type>
3612
  </tag>
3613
  </docblock>
3614
+ <argument line="601">
3615
  <name>$parent_file</name>
3616
  <default><![CDATA[]]></default>
3617
  <type/>
3618
  </argument>
3619
  </method>
3620
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="661" package="Media Library Assistant">
3621
  <name>mla_render_admin_page</name>
3622
  <full_name>mla_render_admin_page</full_name>
3623
+ <docblock line="654">
3624
  <description><![CDATA[Render the "Assistant" subpage in the Media section, using the list_table package]]></description>
3625
  <long-description><![CDATA[]]></long-description>
3626
+ <tag line="654" name="since" description="0.1"/>
3627
+ <tag line="654" name="return" description="" type="void">
3628
  <type by_reference="false">void</type>
3629
  </tag>
3630
  </docblock>
3631
  </method>
3632
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1034" package="Media Library Assistant">
3633
  <name>mla_inline_edit_action</name>
3634
  <full_name>mla_inline_edit_action</full_name>
3635
+ <docblock line="1025">
3636
  <description><![CDATA[Ajax handler for inline editing (quick and bulk edit)]]></description>
3637
  <long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
3638
+ <tag line="1025" name="since" description="0.20"/>
3639
+ <tag line="1025" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
3640
  <type by_reference="false">void</type>
3641
  </tag>
3642
  </docblock>
3643
  </method>
3644
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1128" package="Media Library Assistant">
3645
  <name>_build_inline_edit_form</name>
3646
  <full_name>_build_inline_edit_form</full_name>
3647
+ <docblock line="1117">
3648
  <description><![CDATA[Build the hidden row templates for inline editing (quick and bulk edit)]]></description>
3649
  <long-description><![CDATA[<p>inspired by inline_edit() in wp-admin\includes\class-wp-posts-list-table.php.</p>]]></long-description>
3650
+ <tag line="1117" name="since" description="0.20"/>
3651
+ <tag line="1117" name="param" description="MLA List Table object" type="object" variable="$MLAListTable">
3652
  <type by_reference="false">object</type>
3653
  </tag>
3654
+ <tag line="1117" name="return" description="HTML &lt;form&gt; markup for hidden rows" type="string">
3655
  <type by_reference="false">string</type>
3656
  </tag>
3657
  </docblock>
3658
+ <argument line="1128">
3659
  <name>$MLAListTable</name>
3660
  <default><![CDATA[]]></default>
3661
  <type/>
3662
  </argument>
3663
  </method>
3664
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1285" package="Media Library Assistant">
3665
  <name>_authors_dropdown</name>
3666
  <full_name>_authors_dropdown</full_name>
3667
+ <docblock line="1274">
3668
  <description><![CDATA[Get the edit Authors dropdown box, if user has suitable permissions]]></description>
3669
  <long-description><![CDATA[]]></long-description>
3670
+ <tag line="1274" name="since" description="0.20"/>
3671
+ <tag line="1274" name="param" description="Optional User ID of the current author, default 0" type="integer" variable="$author">
3672
  <type by_reference="false">integer</type>
3673
  </tag>
3674
+ <tag line="1274" name="param" description="Optional HTML name attribute, default 'post_author'" type="string" variable="$name">
3675
  <type by_reference="false">string</type>
3676
  </tag>
3677
+ <tag line="1274" name="param" description="Optional HTML class attribute, default 'authors'" type="string" variable="$class">
3678
  <type by_reference="false">string</type>
3679
  </tag>
3680
+ <tag line="1274" name="return" description="HTML markup for the dropdown field or False" type="string|false">
3681
  <type by_reference="false">string</type>
3682
  <type by_reference="false">false</type>
3683
  </tag>
3684
  </docblock>
3685
+ <argument line="1285">
3686
  <name>$author</name>
3687
  <default><![CDATA[0]]></default>
3688
  <type/>
3689
  </argument>
3690
+ <argument line="1285">
3691
  <name>$name</name>
3692
  <default><![CDATA['post_author']]></default>
3693
  <type/>
3694
  </argument>
3695
+ <argument line="1285">
3696
  <name>$class</name>
3697
  <default><![CDATA['authors']]></default>
3698
  <type/>
3699
  </argument>
3700
  </method>
3701
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1319" package="Media Library Assistant">
3702
  <name>_current_bulk_action</name>
3703
  <full_name>_current_bulk_action</full_name>
3704
+ <docblock line="1312">
3705
  <description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
3706
  <long-description><![CDATA[]]></long-description>
3707
+ <tag line="1312" name="since" description="0.1"/>
3708
+ <tag line="1312" name="return" description="The action name or False if no action was selected" type="string|false">
3709
  <type by_reference="false">string</type>
3710
  <type by_reference="false">false</type>
3711
  </tag>
3712
  </docblock>
3713
  </method>
3714
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1348" package="Media Library Assistant">
3715
  <name>_delete_single_item</name>
3716
  <full_name>_delete_single_item</full_name>
3717
+ <docblock line="1339">
3718
  <description><![CDATA[Delete a single item permanently]]></description>
3719
  <long-description><![CDATA[]]></long-description>
3720
+ <tag line="1339" name="since" description="0.1"/>
3721
+ <tag line="1339" name="param" description="The form POST data" type="array" variable="$post_id">
3722
  <type by_reference="false">array</type>
3723
  </tag>
3724
+ <tag line="1339" name="return" description="success/failure message and NULL content" type="array">
3725
  <type by_reference="false">array</type>
3726
  </tag>
3727
  </docblock>
3728
+ <argument line="1348">
3729
  <name>$post_id</name>
3730
  <default><![CDATA[]]></default>
3731
  <type/>
3732
  </argument>
3733
  </method>
3734
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1379" package="Media Library Assistant">
3735
  <name>_display_single_item</name>
3736
  <full_name>_display_single_item</full_name>
3737
+ <docblock line="1367">
3738
  <description><![CDATA[Display a single item sub page; prepare the form to
3739
  change the meta data for a single attachment.]]></description>
3740
  <long-description><![CDATA[<p>This function is not used in WordPress 3.5 and later.</p>]]></long-description>
3741
+ <tag line="1367" name="since" description="0.1"/>
3742
+ <tag line="1367" name="param" description="The WordPress Post ID of the attachment item" type="int" variable="$post_id">
3743
  <type by_reference="false">int</type>
3744
  </tag>
3745
+ <tag line="1367" name="return" description="message and/or HTML content" type="array">
3746
  <type by_reference="false">array</type>
3747
  </tag>
3748
  </docblock>
3749
+ <argument line="1379">
3750
  <name>$post_id</name>
3751
  <default><![CDATA[]]></default>
3752
  <type/>
3753
  </argument>
3754
  </method>
3755
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1619" package="Media Library Assistant">
3756
  <name>_restore_single_item</name>
3757
  <full_name>_restore_single_item</full_name>
3758
+ <docblock line="1610">
3759
  <description><![CDATA[Restore a single item from the Trash]]></description>
3760
  <long-description><![CDATA[]]></long-description>
3761
+ <tag line="1610" name="since" description="0.1"/>
3762
+ <tag line="1610" name="param" description="The form POST data" type="array" variable="$post_id">
3763
  <type by_reference="false">array</type>
3764
  </tag>
3765
+ <tag line="1610" name="return" description="success/failure message and NULL content" type="array">
3766
  <type by_reference="false">array</type>
3767
  </tag>
3768
  </docblock>
3769
+ <argument line="1619">
3770
  <name>$post_id</name>
3771
  <default><![CDATA[]]></default>
3772
  <type/>
3773
  </argument>
3774
  </method>
3775
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1655" package="Media Library Assistant">
3776
  <name>_trash_single_item</name>
3777
  <full_name>_trash_single_item</full_name>
3778
+ <docblock line="1646">
3779
  <description><![CDATA[Move a single item to Trash]]></description>
3780
  <long-description><![CDATA[]]></long-description>
3781
+ <tag line="1646" name="since" description="0.1"/>
3782
+ <tag line="1646" name="param" description="The form POST data" type="array" variable="$post_id">
3783
  <type by_reference="false">array</type>
3784
  </tag>
3785
+ <tag line="1646" name="return" description="success/failure message and NULL content" type="array">
3786
  <type by_reference="false">array</type>
3787
  </tag>
3788
  </docblock>
3789
+ <argument line="1655">
3790
  <name>$post_id</name>
3791
  <default><![CDATA[]]></default>
3792
  <type/>
3794
  </method>
3795
  </class>
3796
  </file>
3797
+ <file path="includes\class-mla-media-modal.php" hash="dc4aebac5c762515bf5a062f62a32a03" package="Media Library Assistant">
3798
  <docblock line="2">
3799
  <description><![CDATA[Media Library Assistant Media Manager enhancements]]></description>
3800
  <long-description><![CDATA[]]></long-description>
3875
  </tag>
3876
  </docblock>
3877
  </method>
3878
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="87" package="Media Library Assistant">
3879
  <name>_months_dropdown</name>
3880
  <full_name>_months_dropdown</full_name>
3881
  <docblock line="76">
3895
  <type/>
3896
  </argument>
3897
  </method>
3898
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="126" package="Media Library Assistant">
3899
  <name>_terms_options</name>
3900
  <full_name>_terms_options</full_name>
3901
  <docblock line="117">
5247
  </method>
5248
  </class>
5249
  </file>
5250
+ <file path="includes\class-mla-objects.php" hash="f4d46fc2e8ef7b6e6c70853d09c87fbb" package="Media Library Assistant">
5251
  <docblock line="2">
5252
+ <description><![CDATA[Media Library Assistant Custom Taxonomy and Widget objects]]></description>
5253
  <long-description><![CDATA[]]></long-description>
5254
  <tag line="2" name="package" description="Media Library Assistant"/>
5255
  <tag line="2" name="since" description="0.1"/>
5347
  </argument>
5348
  </method>
5349
  </class>
5350
+ <class final="false" abstract="false" namespace="global" line="207" package="Media Library Assistant">
5351
+ <extends>\WP_Widget</extends>
5352
+ <name>MLATextWidget</name>
5353
+ <full_name>\MLATextWidget</full_name>
5354
+ <docblock line="201">
5355
+ <description><![CDATA[Class MLA (Media Library Assistant) Text Widget defines a shortcode-enabled version of the WordPress Text widget]]></description>
5356
+ <long-description><![CDATA[]]></long-description>
5357
+ <tag line="201" name="package" description="Media Library Assistant"/>
5358
+ <tag line="201" name="since" description="1.60"/>
5359
+ </docblock>
5360
+ <constant namespace="global" line="212" package="Media Library Assistant">
5361
+ <name>MLA_TEXT_DOMAIN</name>
5362
+ <full_name>MLA_TEXT_DOMAIN</full_name>
5363
+ <value><![CDATA['media_library_assistant']]></value>
5364
+ <docblock line="209">
5365
+ <description><![CDATA[Provides a unique name for the plugin text domain]]></description>
5366
+ <long-description><![CDATA[]]></long-description>
5367
+ </docblock>
5368
+ </constant>
5369
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="221" package="Media Library Assistant">
5370
+ <name>__construct</name>
5371
+ <full_name>__construct</full_name>
5372
+ <docblock line="214">
5373
+ <description><![CDATA[Calls the parent constructor to set some defaults.]]></description>
5374
+ <long-description><![CDATA[]]></long-description>
5375
+ <tag line="214" name="since" description="1.60"/>
5376
+ <tag line="214" name="return" description="" type="void">
5377
+ <type by_reference="false">void</type>
5378
+ </tag>
5379
+ </docblock>
5380
+ </method>
5381
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="245" package="Media Library Assistant">
5382
+ <name>widget</name>
5383
+ <full_name>widget</full_name>
5384
+ <docblock line="235">
5385
+ <description><![CDATA[Display the widget content - called from the WordPress "front end"]]></description>
5386
+ <long-description><![CDATA[]]></long-description>
5387
+ <tag line="235" name="since" description="1.60"/>
5388
+ <tag line="235" name="param" description="Widget arguments" type="array" variable="$args">
5389
+ <type by_reference="false">array</type>
5390
+ </tag>
5391
+ <tag line="235" name="param" description="Widget definition, from the database" type="array" variable="$instance">
5392
+ <type by_reference="false">array</type>
5393
+ </tag>
5394
+ <tag line="235" name="return" description="Echoes widget output" type="void">
5395
+ <type by_reference="false">void</type>
5396
+ </tag>
5397
+ </docblock>
5398
+ <argument line="245">
5399
+ <name>$args</name>
5400
+ <default><![CDATA[]]></default>
5401
+ <type/>
5402
+ </argument>
5403
+ <argument line="245">
5404
+ <name>$instance</name>
5405
+ <default><![CDATA[]]></default>
5406
+ <type/>
5407
+ </argument>
5408
+ </method>
5409
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="264" package="Media Library Assistant">
5410
+ <name>form</name>
5411
+ <full_name>form</full_name>
5412
+ <docblock line="255">
5413
+ <description><![CDATA[Echo the "edit widget" form on the Appearance/Widgets admin screen]]></description>
5414
+ <long-description><![CDATA[]]></long-description>
5415
+ <tag line="255" name="since" description="1.60"/>
5416
+ <tag line="255" name="param" description="Previous definition values, from the database" type="array" variable="$instance">
5417
+ <type by_reference="false">array</type>
5418
+ </tag>
5419
+ <tag line="255" name="return" description="Echoes &quot;edit widget&quot; form" type="void">
5420
+ <type by_reference="false">void</type>
5421
+ </tag>
5422
+ </docblock>
5423
+ <argument line="264">
5424
+ <name>$instance</name>
5425
+ <default><![CDATA[]]></default>
5426
+ <type/>
5427
+ </argument>
5428
+ </method>
5429
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="288" package="Media Library Assistant">
5430
+ <name>update</name>
5431
+ <full_name>update</full_name>
5432
+ <docblock line="278">
5433
+ <description><![CDATA[Sanitize widget definition as it is saved to the database]]></description>
5434
+ <long-description><![CDATA[]]></long-description>
5435
+ <tag line="278" name="since" description="1.60"/>
5436
+ <tag line="278" name="param" description="Current definition values, to be saved in the database" type="array" variable="$new_instance">
5437
+ <type by_reference="false">array</type>
5438
+ </tag>
5439
+ <tag line="278" name="param" description="Previous definition values, from the database" type="array" variable="$old_instance">
5440
+ <type by_reference="false">array</type>
5441
+ </tag>
5442
+ <tag line="278" name="return" description="Updated definition values to be saved in the database" type="array">
5443
+ <type by_reference="false">array</type>
5444
+ </tag>
5445
+ </docblock>
5446
+ <argument line="288">
5447
+ <name>$new_instance</name>
5448
+ <default><![CDATA[]]></default>
5449
+ <type/>
5450
+ </argument>
5451
+ <argument line="288">
5452
+ <name>$old_instance</name>
5453
+ <default><![CDATA[]]></default>
5454
+ <type/>
5455
+ </argument>
5456
+ </method>
5457
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="308" package="Media Library Assistant">
5458
+ <name>mla_text_widget_widgets_init_action</name>
5459
+ <full_name>mla_text_widget_widgets_init_action</full_name>
5460
+ <docblock line="299">
5461
+ <description><![CDATA[Register the widget with WordPress]]></description>
5462
+ <long-description><![CDATA[<p>Defined as public because it's an action.</p>]]></long-description>
5463
+ <tag line="299" name="since" description="1.60"/>
5464
+ <tag line="299" name="return" description="" type="void">
5465
+ <type by_reference="false">void</type>
5466
+ </tag>
5467
+ </docblock>
5468
+ </method>
5469
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="321" package="Media Library Assistant">
5470
+ <name>mla_text_widget_plugins_loaded_action</name>
5471
+ <full_name>mla_text_widget_plugins_loaded_action</full_name>
5472
+ <docblock line="312">
5473
+ <description><![CDATA[Load a plugin text domain]]></description>
5474
+ <long-description><![CDATA[<p>Defined as public because it's an action.</p>]]></long-description>
5475
+ <tag line="312" name="since" description="1.60"/>
5476
+ <tag line="312" name="return" description="" type="void">
5477
+ <type by_reference="false">void</type>
5478
+ </tag>
5479
+ </docblock>
5480
+ </method>
5481
+ </class>
5482
  </file>
5483
+ <file path="includes\class-mla-options.php" hash="04193794e36de316bd46f8aa390b867c" package="Media Library Assistant">
5484
  <docblock line="2">
5485
  <description><![CDATA[Manages the plugin option settings]]></description>
5486
  <long-description><![CDATA[]]></long-description>
5847
  </property>
5848
  <property final="false" static="true" visibility="public" line="255" namespace="global" package="Media Library Assistant">
5849
  <name>$mla_option_definitions</name>
5850
+ <default><![CDATA[array(self::MLA_VERSION_OPTION => array('tab' => '', 'type' => 'hidden', 'std' => '0'), 'attachment_category' => array('tab' => '', 'name' => 'Attachment Categories', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to add support for Attachment Categories.'), 'attachment_tag' => array('tab' => '', 'name' => 'Attachment Tags', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to add support for Attachment Tags.'), 'where_used_header' => array('tab' => 'general', 'name' => 'Where-used Reporting', 'type' => 'header'), self::MLA_EXCLUDE_REVISIONS => array('tab' => 'general', 'name' => 'Exclude Revisions', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to exclude revisions from where-used reporting.'), 'where_used_subheader' => array('tab' => 'general', 'name' => 'Where-used database access tuning', 'type' => 'subheader'), self::MLA_FEATURED_IN_TUNING => array('tab' => 'general', 'name' => 'Featured in', 'type' => 'select', 'std' => 'enabled', 'options' => array('enabled', 'disabled'), 'texts' => array('Enabled', 'Disabled'), 'help' => 'Search database posts and pages for Featured Image attachments.'), self::MLA_INSERTED_IN_TUNING => array('tab' => 'general', 'name' => 'Inserted in', 'type' => 'select', 'std' => 'base', 'options' => array('enabled', 'base', 'disabled'), 'texts' => array('Enabled', 'Base', 'Disabled'), 'help' => 'Search database posts and pages for attachments embedded in content.<br>&nbsp;&nbsp;Base = ignore intermediate size suffixes; use path, base name and extension only.'), self::MLA_GALLERY_IN_TUNING => array('tab' => 'general', 'name' => 'Gallery in', 'type' => 'select', 'std' => 'cached', 'options' => array('dynamic', 'refresh', 'cached', 'disabled'), 'texts' => array('Dynamic', 'Refresh', 'Cached', 'Disabled'), 'help' => 'Search database posts and pages for [gallery] shortcode results.<br>&nbsp;&nbsp;Dynamic = once every page load, Cached = once every login, Disabled = never.<br>&nbsp;&nbsp;Refresh = update references, then set to Cached.'), self::MLA_MLA_GALLERY_IN_TUNING => array('tab' => 'general', 'name' => 'MLA Gallery in', 'type' => 'select', 'std' => 'cached', 'options' => array('dynamic', 'refresh', 'cached', 'disabled'), 'texts' => array('Dynamic', 'Refresh', 'Cached', 'Disabled'), 'help' => 'Search database posts and pages for [mla_gallery] shortcode results.<br>&nbsp;&nbsp;Dynamic = once every page load, Cached = once every login, Disabled = never.<br>&nbsp;&nbsp;Refresh = update references, then set to Cached.'), 'taxonomy_header' => array('tab' => 'general', 'name' => 'Taxonomy Support', 'type' => 'header'), self::MLA_TAXONOMY_SUPPORT => array('tab' => 'general', 'help' => 'Check the "Support" box to add the taxonomy to the Assistant and the Edit Media screen.<br>Check the "Inline Edit" box to display the taxonomy in the Quick Edit and Bulk Edit areas.<br>Use the "List Filter" option to select the taxonomy on which to filter the Assistant table listing.', 'std' => array('tax_support' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_quick_edit' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_filter' => 'attachment_category'), 'type' => 'custom', 'render' => 'mla_taxonomy_option_handler', 'update' => 'mla_taxonomy_option_handler', 'delete' => 'mla_taxonomy_option_handler', 'reset' => 'mla_taxonomy_option_handler'), 'attachments_column' => array('tab' => '', 'name' => 'Attachments Column', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to replace the Posts column with the Attachments Column.'), 'media_assistant_header' => array('tab' => 'general', 'name' => 'Media/Assistant Screen Options', 'type' => 'header'), 'admin_sidebar_subheader' => array('tab' => 'general', 'name' => 'Admin Menu Options', 'type' => 'subheader'), self::MLA_SCREEN_PAGE_TITLE => array('tab' => 'general', 'name' => 'Page Title', 'type' => 'text', 'std' => 'Media Library Assistant', 'size' => 40, 'help' => 'Enter the title for the Media/Assistant submenu page'), self::MLA_SCREEN_MENU_TITLE => array('tab' => 'general', 'name' => 'Menu Title', 'type' => 'text', 'std' => 'Assistant', 'size' => 20, 'help' => 'Enter the title for the Media/Assistant submenu entry'), self::MLA_SCREEN_ORDER => array('tab' => 'general', 'name' => 'Submenu Order', 'type' => 'text', 'std' => '0', 'size' => 2, 'help' => 'Enter the position of the Media/Assistant submenu entry.<br>&nbsp;&nbsp;0 = natural order (at bottom),&nbsp;&nbsp;&nbsp;&nbsp;1 - 4 = at top<br>&nbsp;&nbsp;6-9 = after "Library",&nbsp;&nbsp;&nbsp;&nbsp;11-16 = after "Add New"'), self::MLA_SCREEN_DISPLAY_LIBRARY => array('tab' => 'general', 'name' => 'Display Media/Library', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to display/remove the WordPress Media/Library submenu entry.'), 'table_defaults_subheader' => array('tab' => 'general', 'name' => 'Table Defaults', 'type' => 'subheader'), self::MLA_DEFAULT_ORDERBY => array('tab' => 'general', 'name' => 'Order By', 'type' => 'select', 'std' => 'title_name', 'options' => array('none', 'title_name'), 'texts' => array('None', 'Title/Name'), 'help' => 'Select the column for the sort order of the Assistant table listing.'), self::MLA_DEFAULT_ORDER => array('tab' => 'general', 'name' => 'Order', 'type' => 'radio', 'std' => 'ASC', 'options' => array('ASC', 'DESC'), 'texts' => array('Ascending', 'Descending'), 'help' => 'Choose the sort order.'), self::MLA_TABLE_VIEWS_WIDTH => array('tab' => 'general', 'name' => 'Views Width', 'type' => 'text', 'std' => '', 'size' => 10, 'help' => 'Enter the width for the views list, in pixels (px) or percent (%)'), 'taxonomy_filter_subheader' => array('tab' => 'general', 'name' => 'Taxonomy Filter parameters', 'type' => 'subheader'), self::MLA_TAXONOMY_FILTER_DEPTH => array('tab' => 'general', 'name' => 'Maximum Depth', 'type' => 'text', 'std' => '3', 'size' => 2, 'help' => 'Enter the number of levels displayed for hierarchial taxonomies; enter zero for no limit.'), self::MLA_TAXONOMY_FILTER_INCLUDE_CHILDREN => array('tab' => 'general', 'name' => 'Include Children', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to include/exclude children for hierarchical taxonomies.'), 'media_modal_header' => array('tab' => 'general', 'name' => 'Media Manager Enhancements', 'type' => 'header'), self::MLA_MEDIA_MODAL_TOOLBAR => array('tab' => 'general', 'name' => 'Enable Media Manager Enhancements', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to enable/disable Media Manager Enhancements.'), self::MLA_MEDIA_MODAL_MIMETYPES => array('tab' => 'general', 'name' => 'Media Manager Enhanced MIME Type filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by more MIME Types, e.g., text, applications.'), self::MLA_MEDIA_MODAL_MONTHS => array('tab' => 'general', 'name' => 'Media Manager Month and Year filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by month and year uploaded.'), self::MLA_MEDIA_MODAL_TERMS => array('tab' => 'general', 'name' => 'Media Manager Category/Tag filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by taxonomy terms.'), self::MLA_MEDIA_MODAL_SEARCHBOX => array('tab' => 'general', 'name' => 'Media Manager Enhanced Search Media box', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to enable search box enhancements.'), self::MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX => array('tab' => 'general', 'name' => 'Media Manager Searchable Categories metaboxes', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable searchable metaboxes in the "ATTACHMENT DETAILS" pane.<br>&nbsp;&nbsp;This option is for <strong>hierarchical taxonomies, e.g., "Att. Categories".</strong><br>&nbsp;&nbsp;You must also install and activate the <strong>"Media Categories" plugin</strong> (by Eddie Moya) to implement this option.'), self::MLA_MEDIA_MODAL_DETAILS_TAG_METABOX => array('tab' => 'general', 'name' => 'Media Manager Searchable Tags metaboxes', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable searchable metaboxes in the "ATTACHMENT DETAILS" pane.<br>&nbsp;&nbsp;This option is for <strong>flat taxonomies, e.g., "Att. Tags".</strong><br>&nbsp;&nbsp;You must also install and activate the <strong>"Media Categories" plugin</strong> (by Eddie Moya) to implement this option.'), self::MLA_MEDIA_MODAL_ORDERBY => array('tab' => '', 'name' => 'Media Manager Order By', 'type' => 'select', 'std' => 'default', 'options' => array('default', 'none', 'title_name'), 'texts' => array(' -- Media Manager Default -- ', 'None', 'Title/Name'), 'help' => 'If you want to override the Media Manager default,<br>&nbsp;&nbsp;select a column for the sort order of the Media Library listing.'), self::MLA_MEDIA_MODAL_ORDER => array('tab' => '', 'name' => 'Media Manager Order', 'type' => 'radio', 'std' => 'default', 'options' => array('default', 'ASC', 'DESC'), 'texts' => array(' -- Media Manager Default -- ', 'Ascending', 'Descending'), 'help' => 'Choose the sort order.'), 'template_header' => array('tab' => 'mla_gallery', 'name' => 'Default [mla_gallery] Templates and Settings', 'type' => 'header'), 'default_tag_cloud_style' => array('tab' => '', 'name' => 'Style Template', 'type' => 'select', 'std' => 'tag-cloud', 'options' => array(), 'texts' => array(), 'help' => 'Select the default style template for your [mla_tag_cloud] shortcodes.'), 'default_tag_cloud_markup' => array('tab' => '', 'name' => 'Markup Template', 'type' => 'select', 'std' => 'tag-cloud', 'options' => array(), 'texts' => array(), 'help' => 'Select the default markup template for your [mla_tag_cloud] shortcodes.'), 'mla_tag_cloud_columns' => array('tab' => '', 'name' => 'Default columns', 'type' => 'text', 'std' => '3', 'size' => 3, 'help' => 'Enter the number of [mla_tag_cloud] columns; must be a positive integer.'), 'mla_tag_cloud_margin' => array('tab' => '', 'name' => 'Default mla_margin', 'type' => 'text', 'std' => '1.5%', 'size' => 10, 'help' => 'Enter the CSS "margin" property value, in length (px, em, pt, etc.), percent (%), "auto" or "inherit".<br>&nbsp;&nbsp;Enter "none" to remove the property entirely.'), 'mla_tag_cloud_itemwidth' => array('tab' => '', 'name' => 'Default mla_itemwidth', 'type' => 'text', 'std' => 'calculate', 'size' => 10, 'help' => 'Enter the CSS "width" property value, in length (px, em, pt, etc.), percent (%), "auto" or "inherit".<br>&nbsp;&nbsp;Enter "calculate" (the default) to calculate the value taking the "margin" value into account.<br>&nbsp;&nbsp;Enter "exact" to calculate the value without considering the "margin" value.<br>&nbsp;&nbsp;Enter "none" to remove the property entirely.'), 'default_style' => array('tab' => 'mla_gallery', 'name' => 'Style Template', 'type' => 'select', 'std' => 'default', 'options' => array(), 'texts' => array(), 'help' => 'Select the default style template for your [mla_gallery] shortcodes.'), 'default_markup' => array('tab' => 'mla_gallery', 'name' => 'Markup Template', 'type' => 'select', 'std' => 'default', 'options' => array(), 'texts' => array(), 'help' => 'Select the default markup template for your [mla_gallery] shortcodes.'), 'mla_gallery_columns' => array('tab' => 'mla_gallery', 'name' => 'Default columns', 'type' => 'text', 'std' => '3', 'size' => 3, 'help' => 'Enter the number of [mla_gallery] columns; must be a positive integer.'), 'mla_gallery_margin' => array('tab' => 'mla_gallery', 'name' => 'Default mla_margin', 'type' => 'text', 'std' => '1.5%', 'size' => 10, 'help' => 'Enter the CSS "margin" property value, in length (px, em, pt, etc.), percent (%), "auto" or "inherit".<br>&nbsp;&nbsp;Enter "none" to remove the property entirely.'), 'mla_gallery_itemwidth' => array('tab' => 'mla_gallery', 'name' => 'Default mla_itemwidth', 'type' => 'text', 'std' => 'calculate', 'size' => 10, 'help' => 'Enter the CSS "width" property value, in length (px, em, pt, etc.), percent (%), "auto" or "inherit".<br>&nbsp;&nbsp;Enter "calculate" (the default) to calculate the value taking the "margin" value into account.<br>&nbsp;&nbsp;Enter "exact" to calculate the value without considering the "margin" value.<br>&nbsp;&nbsp;Enter "none" to remove the property entirely.'), 'style_templates' => array('tab' => '', 'type' => 'hidden', 'std' => array()), 'markup_templates' => array('tab' => '', 'type' => 'hidden', 'std' => array()), 'enable_custom_field_mapping' => array('tab' => 'custom_field', 'name' => 'Enable custom field mapping when adding new media', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable mapping when uploading new media (attachments).<br>&nbsp;&nbsp;Click Save Changes at the bottom of the screen if you change this option.<br>&nbsp;&nbsp;Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'), 'custom_field_mapping' => array('tab' => '', 'help' => '&nbsp;<br>Update the custom field mapping values above, then click Save Changes to make the updates permanent.<br>You can also make temporary updates and click a Map All Attachments button to apply the rule(s) to all attachments without saving any rule changes.', 'std' => array(), 'type' => 'custom', 'render' => 'mla_custom_field_option_handler', 'update' => 'mla_custom_field_option_handler', 'delete' => 'mla_custom_field_option_handler', 'reset' => 'mla_custom_field_option_handler'), 'enable_iptc_exif_mapping' => array('tab' => 'iptc_exif', 'name' => 'Enable IPTC/EXIF Mapping when adding new media', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable mapping when uploading new media (attachments).<br>&nbsp;&nbsp;Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'), 'iptc_exif_standard_mapping' => array('tab' => '', 'help' => 'Update the standard field mapping values above, then click <strong>Save Changes</strong> to make the updates permanent.<br>You can also make temporary updates and click <strong>Map All Attachments, Standard Fields Now</strong> to apply the updates to all attachments without saving the rule changes.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_taxonomy_mapping' => array('tab' => '', 'help' => 'Update the taxonomy term mapping values above, then click <strong>Save Changes</strong> or <strong>Map All Attachments, Taxonomy Terms Now</strong>.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_custom_mapping' => array('tab' => '', 'help' => '<strong>Update</strong> individual custom field mapping values above, or make several updates and click <strong>Save Changes</strong> below to apply them all at once.<br>You can also <strong>add a new rule</strong> for an existing field or <strong>add a new field</strong> and rule.<br>You can make temporary updates and click <strong>Map All Attachments, Custom Fields Now</strong> to apply the updates to all attachments without saving the rule changes.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_mapping' => array('tab' => '', 'help' => 'IPTC/EXIF Mapping help', 'std' => array('standard' => array('post_title' => array('name' => 'Title', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_name' => array('name' => 'Name/Slug', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'image_alt' => array('name' => 'Alternate Text', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_excerpt' => array('name' => 'Caption', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_content' => array('name' => 'Description', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true)), 'taxonomy' => array(), 'custom' => array()), 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), self::MLA_ENABLE_POST_MIME_TYPES => array('tab' => 'view', 'name' => 'Enable View and Post MIME Type Support', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to enable/disable Post MIME Type Support, then click <strong>Save Changes</strong> to record the new setting.'), self::MLA_POST_MIME_TYPES => array('tab' => '', 'type' => 'custom', 'render' => 'mla_post_mime_types_option_handler', 'update' => 'mla_post_mime_types_option_handler', 'delete' => 'mla_post_mime_types_option_handler', 'reset' => 'mla_post_mime_types_option_handler', 'help' => 'Post MIME Types help.', 'std' => array('all' => array('singular' => 'All', 'plural' => 'All', 'specification' => '', 'post_mime_type' => false, 'table_view' => true, 'menu_order' => 0, 'description' => 'Built-in view'), 'image' => array('singular' => 'Image', 'plural' => 'Images', 'specification' => '', 'post_mime_type' => true, 'table_view' => true, 'menu_order' => 0, 'description' => 'All image subtypes'), 'audio' => array('singular' => 'Audio', 'plural' => 'Audio', 'specification' => '', 'post_mime_type' => true, 'table_view' => true, 'menu_order' => 0, 'description' => 'All audio subtypes'), 'video' => array('singular' => 'Video', 'plural' => 'Video', 'specification' => '', 'post_mime_type' => true, 'table_view' => true, 'menu_order' => 0, 'description' => 'All video subtypes'), 'text' => array('singular' => 'Text', 'plural' => 'Text', 'specification' => '', 'post_mime_type' => true, 'table_view' => true, 'menu_order' => 0, 'description' => 'All text subtypes'), 'application' => array('singular' => 'Application', 'plural' => 'Applications', 'specification' => '', 'post_mime_type' => true, 'table_view' => true, 'menu_order' => 0, 'description' => 'All application subtypes'), 'unattached' => array('singular' => 'Unattached', 'plural' => 'Unattached', 'specification' => '', 'post_mime_type' => false, 'table_view' => true, 'menu_order' => 0, 'description' => 'Built-in view'), 'trash' => array('singular' => 'Trash', 'plural' => 'Trash', 'specification' => '', 'post_mime_type' => false, 'table_view' => true, 'menu_order' => 0, 'description' => 'Built-in view'))), self::MLA_ENABLE_UPLOAD_MIMES => array('tab' => 'upload', 'name' => 'Enable Upload MIME Type Support', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to enable/disable Upload MIME Type Support, then click <strong>Save Changes</strong> to record the new setting.'), self::MLA_UPLOAD_MIMES => array('tab' => '', 'type' => 'custom', 'render' => 'mla_upload_mimes_option_handler', 'update' => 'mla_upload_mimes_option_handler', 'delete' => 'mla_upload_mimes_option_handler', 'reset' => 'mla_upload_mimes_option_handler', 'help' => 'Upload MIME Types help.', 'std' => false), self::MLA_ENABLE_MLA_ICONS => array('tab' => 'upload', 'name' => 'Enable MLA File Type Icons Support', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to enable/disable MLA File Type Icons Support, then click <strong>Save Changes</strong> to record the new setting.'))]]></default>
5851
  <docblock line="230">
5852
  <description><![CDATA[$mla_option_definitions defines the database options and admin page areas for setting/updating them.]]></description>
5853
  <long-description><![CDATA[<p>Each option is defined by an array with the following elements:</p>
5874
  $message = ['reset']( 'reset', $key, $value, $_REQUEST );</p>]]></long-description>
5875
  </docblock>
5876
  </property>
5877
+ <property final="false" static="true" visibility="private" line="901" namespace="global" package="Media Library Assistant">
5878
  <name>$mla_option_templates</name>
5879
  <default><![CDATA[null]]></default>
5880
+ <docblock line="894">
5881
  <description><![CDATA[Style and Markup templates]]></description>
5882
  <long-description><![CDATA[]]></long-description>
5883
+ <tag line="894" name="since" description="0.80"/>
5884
+ <tag line="894" name="var" description="" type="array">
5885
  <type by_reference="false">array</type>
5886
  </tag>
5887
  </docblock>
5888
  </property>
5889
+ <property final="false" static="true" visibility="private" line="2090" namespace="global" package="Media Library Assistant">
5890
  <name>$custom_field_data_sources</name>
5891
+ <default><![CDATA[array('absolute_path', 'absolute_file_name', 'base_file', 'path', 'file_name', 'name_only', 'extension', 'file_size', 'upload_date', 'mime_type', 'dimensions', 'pixels', 'width', 'height', 'orientation', 'hwstring_small', 'size_keys', 'size_names', 'size_bytes', 'size_pixels', 'size_dimensions', 'size_name[size]', 'size_bytes[size]', 'size_pixels[size]', 'size_dimensions[size]', 'parent', 'parent_date', 'parent_type', 'parent_title', 'parent_issues', 'reference_issues', 'featured_in', 'featured_in_title', 'inserted_in', 'inserted_in_title', 'gallery_in', 'gallery_in_title', 'mla_gallery_in', 'mla_gallery_in_title', 'aperture', 'credit', 'camera', 'caption', 'created_timestamp', 'copyright', 'focal_length', 'iso', 'shutter_speed', 'title')]]></default>
5892
+ <docblock line="2083">
5893
  <description><![CDATA[Array of Data Source names for custom field mapping]]></description>
5894
  <long-description><![CDATA[]]></long-description>
5895
+ <tag line="2083" name="since" description="1.10"/>
5896
+ <tag line="2083" name="var" description="" type="array">
5897
  <type by_reference="false">array</type>
5898
  </tag>
5899
  </docblock>
5900
  </property>
5901
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="875" package="Media Library Assistant">
5902
  <name>initialize</name>
5903
  <full_name>initialize</full_name>
5904
+ <docblock line="868">
5905
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
5906
  <long-description><![CDATA[]]></long-description>
5907
+ <tag line="868" name="since" description="1.00"/>
5908
+ <tag line="868" name="return" description="" type="void">
5909
  <type by_reference="false">void</type>
5910
  </tag>
5911
  </docblock>
5912
  </method>
5913
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="910" package="Media Library Assistant">
5914
  <name>_load_option_templates</name>
5915
  <full_name>_load_option_templates</full_name>
5916
+ <docblock line="903">
5917
  <description><![CDATA[Load style and markup templates to $mla_templates]]></description>
5918
  <long-description><![CDATA[]]></long-description>
5919
+ <tag line="903" name="since" description="0.80"/>
5920
+ <tag line="903" name="return" description="" type="void">
5921
  <type by_reference="false">void</type>
5922
  </tag>
5923
  </docblock>
5924
  </method>
5925
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="958" package="Media Library Assistant">
5926
  <name>mla_fetch_gallery_template</name>
5927
  <full_name>mla_fetch_gallery_template</full_name>
5928
+ <docblock line="948">
5929
  <description><![CDATA[Fetch style or markup template from $mla_templates]]></description>
5930
  <long-description><![CDATA[]]></long-description>
5931
+ <tag line="948" name="since" description="0.80"/>
5932
+ <tag line="948" name="param" description="Template name" type="string" variable="$key">
5933
  <type by_reference="false">string</type>
5934
  </tag>
5935
+ <tag line="948" name="param" description="Template type; 'style' (default) or 'markup'" type="string" variable="$type">
5936
  <type by_reference="false">string</type>
5937
  </tag>
5938
+ <tag line="948" name="return" description="requested template, false if not found or null if no templates" type="string|boolean|null">
5939
  <type by_reference="false">string</type>
5940
  <type by_reference="false">boolean</type>
5941
  <type by_reference="false">null</type>
5942
  </tag>
5943
  </docblock>
5944
+ <argument line="958">
5945
  <name>$key</name>
5946
  <default><![CDATA[]]></default>
5947
  <type/>
5948
  </argument>
5949
+ <argument line="958">
5950
  <name>$type</name>
5951
  <default><![CDATA['style']]></default>
5952
  <type/>
5953
  </argument>
5954
  </method>
5955
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="981" package="Media Library Assistant">
5956
  <name>mla_get_style_templates</name>
5957
  <full_name>mla_get_style_templates</full_name>
5958
+ <docblock line="974">
5959
  <description><![CDATA[Get ALL style templates from $mla_templates, including 'default']]></description>
5960
  <long-description><![CDATA[]]></long-description>
5961
+ <tag line="974" name="since" description="0.80"/>
5962
+ <tag line="974" name="return" description="name =&gt; value for all style templates or null if no templates" type="array|null">
5963
  <type by_reference="false">array</type>
5964
  <type by_reference="false">null</type>
5965
  </tag>
5966
  </docblock>
5967
  </method>
5968
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1007" package="Media Library Assistant">
5969
  <name>mla_put_style_templates</name>
5970
  <full_name>mla_put_style_templates</full_name>
5971
+ <docblock line="999">
5972
  <description><![CDATA[Put user-defined style templates to $mla_templates and database]]></description>
5973
  <long-description><![CDATA[]]></long-description>
5974
+ <tag line="999" name="since" description="0.80"/>
5975
+ <tag line="999" name="param" description="name =&gt; value for all user-defined style templates" type="array" variable="$templates">
5976
  <type by_reference="false">array</type>
5977
  </tag>
5978
+ <tag line="999" name="return" description="true if success, false if failure" type="boolean">
5979
  <type by_reference="false">boolean</type>
5980
  </tag>
5981
  </docblock>
5982
+ <argument line="1007">
5983
  <name>$templates</name>
5984
  <default><![CDATA[]]></default>
5985
  <type/>
5986
  </argument>
5987
  </method>
5988
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1023" package="Media Library Assistant">
5989
  <name>mla_get_markup_templates</name>
5990
  <full_name>mla_get_markup_templates</full_name>
5991
+ <docblock line="1016">
5992
  <description><![CDATA[Get ALL markup templates from $mla_templates, including 'default']]></description>
5993
  <long-description><![CDATA[]]></long-description>
5994
+ <tag line="1016" name="since" description="0.80"/>
5995
+ <tag line="1016" name="return" description="name =&gt; value for all markup templates or null if no templates" type="array|null">
5996
  <type by_reference="false">array</type>
5997
  <type by_reference="false">null</type>
5998
  </tag>
5999
  </docblock>
6000
  </method>
6001
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1078" package="Media Library Assistant">
6002
  <name>mla_put_markup_templates</name>
6003
  <full_name>mla_put_markup_templates</full_name>
6004
+ <docblock line="1070">
6005
  <description><![CDATA[Put user-defined markup templates to $mla_templates and database]]></description>
6006
  <long-description><![CDATA[]]></long-description>
6007
+ <tag line="1070" name="since" description="0.80"/>
6008
+ <tag line="1070" name="param" description="name =&gt; value for all user-defined markup templates" type="array" variable="$templates">
6009
  <type by_reference="false">array</type>
6010
  </tag>
6011
+ <tag line="1070" name="return" description="true if success, false if failure" type="boolean">
6012
  <type by_reference="false">boolean</type>
6013
  </tag>
6014
  </docblock>
6015
+ <argument line="1078">
6016
  <name>$templates</name>
6017
  <default><![CDATA[]]></default>
6018
  <type/>
6019
  </argument>
6020
  </method>
6021
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1098" package="Media Library Assistant">
6022
  <name>mla_get_option</name>
6023
  <full_name>mla_get_option</full_name>
6024
+ <docblock line="1087">
6025
  <description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
6026
  <long-description><![CDATA[]]></long-description>
6027
+ <tag line="1087" name="since" description="0.1"/>
6028
+ <tag line="1087" name="param" description="Name of the desired option" type="string" variable="$option">
6029
  <type by_reference="false">string</type>
6030
  </tag>
6031
+ <tag line="1087" name="param" description="True to ignore current setting and return default values" type="boolean" variable="$get_default">
6032
  <type by_reference="false">boolean</type>
6033
  </tag>
6034
+ <tag line="1087" name="param" description="True to ignore default values and return only stored values" type="boolean" variable="$get_stored">
6035
  <type by_reference="false">boolean</type>
6036
  </tag>
6037
+ <tag line="1087" name="return" description="Value(s) for the option or false if the option is not a defined MLA option" type="mixed">
6038
  <type by_reference="false">mixed</type>
6039
  </tag>
6040
  </docblock>
6041
+ <argument line="1098">
6042
  <name>$option</name>
6043
  <default><![CDATA[]]></default>
6044
  <type/>
6045
  </argument>
6046
+ <argument line="1098">
6047
  <name>$get_default</name>
6048
  <default><![CDATA[false]]></default>
6049
  <type/>
6050
  </argument>
6051
+ <argument line="1098">
6052
  <name>$get_stored</name>
6053
  <default><![CDATA[false]]></default>
6054
  <type/>
6055
  </argument>
6056
  </method>
6057
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1125" package="Media Library Assistant">
6058
  <name>mla_update_option</name>
6059
  <full_name>mla_update_option</full_name>
6060
+ <docblock line="1115">
6061
  <description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
6062
  <long-description><![CDATA[]]></long-description>
6063
+ <tag line="1115" name="since" description="0.1"/>
6064
+ <tag line="1115" name="param" description="Name of the desired option" type="string" variable="$option">
6065
  <type by_reference="false">string</type>
6066
  </tag>
6067
+ <tag line="1115" name="param" description="New value for the desired option" type="mixed" variable="$newvalue">
6068
  <type by_reference="false">mixed</type>
6069
  </tag>
6070
+ <tag line="1115" name="return" description="True if the value was changed or false if the update failed" type="boolean">
6071
  <type by_reference="false">boolean</type>
6072
  </tag>
6073
  </docblock>
6074
+ <argument line="1125">
6075
  <name>$option</name>
6076
  <default><![CDATA[]]></default>
6077
  <type/>
6078
  </argument>
6079
+ <argument line="1125">
6080
  <name>$newvalue</name>
6081
  <default><![CDATA[]]></default>
6082
  <type/>
6083
  </argument>
6084
  </method>
6085
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1141" package="Media Library Assistant">
6086
  <name>mla_delete_option</name>
6087
  <full_name>mla_delete_option</full_name>
6088
+ <docblock line="1132">
6089
  <description><![CDATA[Delete the stored value of a defined MLA option]]></description>
6090
  <long-description><![CDATA[]]></long-description>
6091
+ <tag line="1132" name="since" description="0.1"/>
6092
+ <tag line="1132" name="param" description="Name of the desired option" type="string" variable="$option">
6093
  <type by_reference="false">string</type>
6094
  </tag>
6095
+ <tag line="1132" name="return" description="True if the option was deleted, otherwise false" type="boolean">
6096
  <type by_reference="false">boolean</type>
6097
  </tag>
6098
  </docblock>
6099
+ <argument line="1141">
6100
  <name>$option</name>
6101
  <default><![CDATA[]]></default>
6102
  <type/>
6103
  </argument>
6104
  </method>
6105
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1162" package="Media Library Assistant">
6106
  <name>mla_taxonomy_support</name>
6107
  <full_name>mla_taxonomy_support</full_name>
6108
+ <docblock line="1149">
6109
  <description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
6110
  settings are being updated or reset.]]></description>
6111
  <long-description><![CDATA[]]></long-description>
6112
+ <tag line="1149" name="since" description="0.30"/>
6113
+ <tag line="1149" name="param" description="Taxonomy name, e.g., attachment_category" type="string" variable="$tax_name">
6114
  <type by_reference="false">string</type>
6115
  </tag>
6116
+ <tag line="1149" name="param" description="Optional. 'support' (default), 'quick-edit' or 'filter'" type="string" variable="$support_type">
6117
  <type by_reference="false">string</type>
6118
  </tag>
6119
+ <tag line="1149" name="return" description="true if the taxonomy is supported in this way else false string if $tax_name is '' and $support_type is 'filter', returns the taxonomy to filter by" type="boolean|string">
6120
  <type by_reference="false">boolean</type>
6121
  <type by_reference="false">string</type>
6122
  </tag>
6123
  </docblock>
6124
+ <argument line="1162">
6125
  <name>$tax_name</name>
6126
  <default><![CDATA[]]></default>
6127
  <type/>
6128
  </argument>
6129
+ <argument line="1162">
6130
  <name>$support_type</name>
6131
  <default><![CDATA['support']]></default>
6132
  <type/>
6133
  </argument>
6134
  </method>
6135
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1238" package="Media Library Assistant">
6136
  <name>mla_taxonomy_option_handler</name>
6137
  <full_name>mla_taxonomy_option_handler</full_name>
6138
+ <docblock line="1225">
6139
  <description><![CDATA[Render and manage taxonomy support options, e.g., Categories and Post Tags]]></description>
6140
  <long-description><![CDATA[]]></long-description>
6141
+ <tag line="1225" name="since" description="0.30"/>
6142
+ <tag line="1225" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6143
+ <tag line="1225" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
6144
  <type by_reference="false">string</type>
6145
  </tag>
6146
+ <tag line="1225" name="param" description="option name, e.g., 'taxonomy_support'" type="string" variable="$key">
6147
  <type by_reference="false">string</type>
6148
  </tag>
6149
+ <tag line="1225" name="param" description="option parameters" type="array" variable="$value">
6150
  <type by_reference="false">array</type>
6151
  </tag>
6152
+ <tag line="1225" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
6153
  <type by_reference="false">array</type>
6154
  </tag>
6155
+ <tag line="1225" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
6156
  <type by_reference="false">string</type>
6157
  </tag>
6158
  </docblock>
6159
+ <argument line="1238">
6160
  <name>$action</name>
6161
  <default><![CDATA[]]></default>
6162
  <type/>
6163
  </argument>
6164
+ <argument line="1238">
6165
  <name>$key</name>
6166
  <default><![CDATA[]]></default>
6167
  <type/>
6168
  </argument>
6169
+ <argument line="1238">
6170
  <name>$value</name>
6171
  <default><![CDATA[]]></default>
6172
  <type/>
6173
  </argument>
6174
+ <argument line="1238">
6175
  <name>$args</name>
6176
  <default><![CDATA[null]]></default>
6177
  <type/>
6178
  </argument>
6179
  </method>
6180
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1346" package="Media Library Assistant">
6181
  <name>mla_add_attachment_action</name>
6182
  <full_name>mla_add_attachment_action</full_name>
6183
+ <docblock line="1337">
6184
  <description><![CDATA[Perform ITC/EXIF mapping on just-inserted attachment]]></description>
6185
  <long-description><![CDATA[]]></long-description>
6186
+ <tag line="1337" name="since" description="1.00"/>
6187
+ <tag line="1337" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
6188
  <type by_reference="false">integer</type>
6189
  </tag>
6190
+ <tag line="1337" name="return" description="" type="void">
6191
  <type by_reference="false">void</type>
6192
  </tag>
6193
  </docblock>
6194
+ <argument line="1346">
6195
  <name>$post_id</name>
6196
  <default><![CDATA[]]></default>
6197
  <type/>
6198
  </argument>
6199
  </method>
6200
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1366" package="Media Library Assistant">
6201
  <name>mla_update_attachment_metadata_filter</name>
6202
  <full_name>mla_update_attachment_metadata_filter</full_name>
6203
+ <docblock line="1356">
6204
  <description><![CDATA[Perform Custom Field mapping on just-inserted or updated attachment]]></description>
6205
  <long-description><![CDATA[]]></long-description>
6206
+ <tag line="1356" name="since" description="1.10"/>
6207
+ <tag line="1356" name="param" description="Attachment metadata for just-inserted attachment" type="array" variable="$data">
6208
  <type by_reference="false">array</type>
6209
  </tag>
6210
+ <tag line="1356" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
6211
  <type by_reference="false">integer</type>
6212
  </tag>
6213
+ <tag line="1356" name="return" description="" type="void">
6214
  <type by_reference="false">void</type>
6215
  </tag>
6216
  </docblock>
6217
+ <argument line="1366">
6218
  <name>$data</name>
6219
  <default><![CDATA[]]></default>
6220
  <type/>
6221
  </argument>
6222
+ <argument line="1366">
6223
  <name>$post_id</name>
6224
  <default><![CDATA[]]></default>
6225
  <type/>
6226
  </argument>
6227
  </method>
6228
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1386" package="Media Library Assistant">
6229
  <name>mla_custom_field_option_value</name>
6230
  <full_name>mla_custom_field_option_value</full_name>
6231
+ <docblock line="1377">
6232
  <description><![CDATA[Fetch custom field option value given a slug]]></description>
6233
  <long-description><![CDATA[]]></long-description>
6234
+ <tag line="1377" name="since" description="1.10"/>
6235
+ <tag line="1377" name="param" description="slug, e.g., 'c_file-size' for the 'File Size' field" type="string" variable="$slug">
6236
  <type by_reference="false">string</type>
6237
  </tag>
6238
+ <tag line="1377" name="return" description="option value, e.g., array( 'name' =&gt; 'File Size', ... )" type="array">
6239
  <type by_reference="false">array</type>
6240
  </tag>
6241
  </docblock>
6242
+ <argument line="1386">
6243
  <name>$slug</name>
6244
  <default><![CDATA[]]></default>
6245
  <type/>
6246
  </argument>
6247
  </method>
6248
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1406" package="Media Library Assistant">
6249
  <name>mla_custom_field_support</name>
6250
  <full_name>mla_custom_field_support</full_name>
6251
+ <docblock line="1397">
6252
  <description><![CDATA[Evaluate file information for custom field mapping]]></description>
6253
  <long-description><![CDATA[]]></long-description>
6254
+ <tag line="1397" name="since" description="1.10"/>
6255
+ <tag line="1397" name="param" description="array format; 'default_columns' (default), 'default_hidden_columns', 'default_sortable_columns', 'quick_edit' or 'bulk_edit'" type="string" variable="$support_type">
6256
  <type by_reference="false">string</type>
6257
  </tag>
6258
+ <tag line="1397" name="return" description="default, hidden, sortable quick_edit or bulk_edit colums in appropriate format" type="array">
6259
  <type by_reference="false">array</type>
6260
  </tag>
6261
  </docblock>
6262
+ <argument line="1406">
6263
  <name>$support_type</name>
6264
  <default><![CDATA['default_columns']]></default>
6265
  <type/>
6266
  </argument>
6267
  </method>
6268
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1452" package="Media Library Assistant">
6269
  <name>_evaluate_file_information</name>
6270
  <full_name>_evaluate_file_information</full_name>
6271
+ <docblock line="1440">
6272
  <description><![CDATA[Evaluate file information for custom field mapping]]></description>
6273
  <long-description><![CDATA[]]></long-description>
6274
+ <tag line="1440" name="since" description="1.10"/>
6275
+ <tag line="1440" name="param" description="absolute path the the uploads base directory" type="string" variable="$upload_dir">
6276
  <type by_reference="false">string</type>
6277
  </tag>
6278
+ <tag line="1440" name="param" description="_wp_attached_file meta_value array, indexed by post_id" type="array" variable="$wp_attached_files">
6279
  <type by_reference="false">array</type>
6280
  </tag>
6281
+ <tag line="1440" name="param" description="_wp_attachment_metadata meta_value array, indexed by post_id" type="array" variable="$wp_attachment_metadata">
6282
  <type by_reference="false">array</type>
6283
  </tag>
6284
+ <tag line="1440" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
6285
  <type by_reference="false">integer</type>
6286
  </tag>
6287
+ <tag line="1440" name="return" description="absolute_path_raw, absolute_path, absolute_file_name_raw, absolute_file_name, absolute_file, base_file, path, file_name, extension, dimensions, width, height, hwstring_small, array of intermediate sizes" type="array">
6288
  <type by_reference="false">array</type>
6289
  </tag>
6290
  </docblock>
6291
+ <argument line="1452">
6292
  <name>$upload_dir</name>
6293
  <default><![CDATA[]]></default>
6294
  <type/>
6295
  </argument>
6296
+ <argument line="1452">
6297
  <name>$wp_attached_files</name>
6298
  <default><![CDATA[]]></default>
6299
  <type/>
6300
  </argument>
6301
+ <argument line="1452">
6302
  <name>$wp_attachment_metadata</name>
6303
  <default><![CDATA[]]></default>
6304
  <type/>
6305
  </argument>
6306
+ <argument line="1452">
6307
  <name>$post_id</name>
6308
  <default><![CDATA[]]></default>
6309
  <type/>
6310
  </argument>
6311
  </method>
6312
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1538" package="Media Library Assistant">
6313
  <name>_evaluate_post_information</name>
6314
  <full_name>_evaluate_post_information</full_name>
6315
+ <docblock line="1527">
6316
  <description><![CDATA[Evaluate post information for custom field mapping]]></description>
6317
  <long-description><![CDATA[]]></long-description>
6318
+ <tag line="1527" name="since" description="1.40"/>
6319
+ <tag line="1527" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
6320
  <type by_reference="false">integer</type>
6321
  </tag>
6322
+ <tag line="1527" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
6323
  <type by_reference="false">string</type>
6324
  </tag>
6325
+ <tag line="1527" name="param" description="data source name ( post_date or post_parent )" type="string" variable="$data_source">
6326
  <type by_reference="false">string</type>
6327
  </tag>
6328
+ <tag line="1527" name="return" description="'post_date' =&gt; (string) upload date, 'post_parent' =&gt; (integer) ID of parent or zero )" type="mixed">
6329
  <type by_reference="false">mixed</type>
6330
  </tag>
6331
  </docblock>
6332
+ <argument line="1538">
6333
  <name>$post_id</name>
6334
  <default><![CDATA[]]></default>
6335
  <type/>
6336
  </argument>
6337
+ <argument line="1538">
6338
  <name>$category</name>
6339
  <default><![CDATA[]]></default>
6340
  <type/>
6341
  </argument>
6342
+ <argument line="1538">
6343
  <name>$data_source</name>
6344
  <default><![CDATA[]]></default>
6345
  <type/>
6346
  </argument>
6347
  </method>
6348
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1574" package="Media Library Assistant">
6349
  <name>_evaluate_array_result</name>
6350
  <full_name>_evaluate_array_result</full_name>
6351
+ <docblock line="1563">
6352
  <description><![CDATA[Evaluate post information for custom field mapping]]></description>
6353
  <long-description><![CDATA[]]></long-description>
6354
+ <tag line="1563" name="since" description="1.40"/>
6355
+ <tag line="1563" name="param" description="field value(s)" type="array" variable="$value">
6356
  <type by_reference="false">array</type>
6357
  </tag>
6358
+ <tag line="1563" name="param" description="format option text|single|export|array|multi" type="string" variable="$option">
6359
  <type by_reference="false">string</type>
6360
  </tag>
6361
+ <tag line="1563" name="param" description="keep existing value(s) - for 'multi' option" type="boolean" variable="$keep_existing">
6362
  <type by_reference="false">boolean</type>
6363
  </tag>
6364
+ <tag line="1563" name="return" description="array for option = array|multi else string" type="mixed">
6365
  <type by_reference="false">mixed</type>
6366
  </tag>
6367
  </docblock>
6368
+ <argument line="1574">
6369
  <name>$value</name>
6370
  <default><![CDATA[]]></default>
6371
  <type/>
6372
  </argument>
6373
+ <argument line="1574">
6374
  <name>$option</name>
6375
  <default><![CDATA[]]></default>
6376
  <type/>
6377
  </argument>
6378
+ <argument line="1574">
6379
  <name>$keep_existing</name>
6380
  <default><![CDATA[]]></default>
6381
  <type/>
6382
  </argument>
6383
  </method>
6384
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1610" package="Media Library Assistant">
6385
  <name>_evaluate_data_source</name>
6386
  <full_name>_evaluate_data_source</full_name>
6387
+ <docblock line="1598">
6388
  <description><![CDATA[Evaluate custom field mapping data source]]></description>
6389
  <long-description><![CDATA[]]></long-description>
6390
+ <tag line="1598" name="since" description="1.10"/>
6391
+ <tag line="1598" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
6392
  <type by_reference="false">integer</type>
6393
  </tag>
6394
+ <tag line="1598" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
6395
  <type by_reference="false">string</type>
6396
  </tag>
6397
+ <tag line="1598" name="param" description="data source specification ( name, data_source, keep_existing, format, mla_column, quick_edit, bulk_edit, meta_name, no_null, option )" type="array" variable="$data_value">
6398
  <type by_reference="false">array</type>
6399
  </tag>
6400
+ <tag line="1598" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
6401
  <type by_reference="false">array</type>
6402
  </tag>
6403
+ <tag line="1598" name="return" description="data source value" type="string">
6404
  <type by_reference="false">string</type>
6405
  </tag>
6406
  </docblock>
6407
+ <argument line="1610">
6408
  <name>$post_id</name>
6409
  <default><![CDATA[]]></default>
6410
  <type/>
6411
  </argument>
6412
+ <argument line="1610">
6413
  <name>$category</name>
6414
  <default><![CDATA[]]></default>
6415
  <type/>
6416
  </argument>
6417
+ <argument line="1610">
6418
  <name>$data_value</name>
6419
  <default><![CDATA[]]></default>
6420
  <type/>
6421
  </argument>
6422
+ <argument line="1610">
6423
  <name>$attachment_metadata</name>
6424
  <default><![CDATA[NULL]]></default>
6425
  <type/>
6426
  </argument>
6427
  </method>
6428
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1978" package="Media Library Assistant">
6429
  <name>mla_evaluate_custom_field_mapping</name>
6430
  <full_name>mla_evaluate_custom_field_mapping</full_name>
6431
+ <docblock line="1966">
6432
  <description><![CDATA[Evaluate custom field mapping updates for a post]]></description>
6433
  <long-description><![CDATA[]]></long-description>
6434
+ <tag line="1966" name="since" description="1.10"/>
6435
+ <tag line="1966" name="param" description="post ID to be evaluated" type="integer" variable="$post_id">
6436
  <type by_reference="false">integer</type>
6437
  </tag>
6438
+ <tag line="1966" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
6439
  <type by_reference="false">string</type>
6440
  </tag>
6441
+ <tag line="1966" name="param" description="(optional) custom_field_mapping values, default NULL (use current option value)" type="array" variable="$settings">
6442
  <type by_reference="false">array</type>
6443
  </tag>
6444
+ <tag line="1966" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
6445
  <type by_reference="false">array</type>
6446
  </tag>
6447
+ <tag line="1966" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
6448
  <type by_reference="false">array</type>
6449
  </tag>
6450
  </docblock>
6451
+ <argument line="1978">
6452
  <name>$post_id</name>
6453
  <default><![CDATA[]]></default>
6454
  <type/>
6455
  </argument>
6456
+ <argument line="1978">
6457
  <name>$category</name>
6458
  <default><![CDATA[]]></default>
6459
  <type/>
6460
  </argument>
6461
+ <argument line="1978">
6462
  <name>$settings</name>
6463
  <default><![CDATA[NULL]]></default>
6464
  <type/>
6465
  </argument>
6466
+ <argument line="1978">
6467
  <name>$attachment_metadata</name>
6468
  <default><![CDATA[NULL]]></default>
6469
  <type/>
6470
  </argument>
6471
  </method>
6472
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2057" package="Media Library Assistant">
6473
  <name>_compose_custom_field_option_list</name>
6474
  <full_name>_compose_custom_field_option_list</full_name>
6475
+ <docblock line="2046">
6476
  <description><![CDATA[Compose a Custom Field Options list with current selection]]></description>
6477
  <long-description><![CDATA[]]></long-description>
6478
+ <tag line="2046" name="since" description="1.10"/>
6479
+ <tag line="2046" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6480
+ <tag line="2046" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
6481
  <type by_reference="false">string</type>
6482
  </tag>
6483
+ <tag line="2046" name="param" description="optional list of terms to exclude from the list" type="array" variable="$blacklist">
6484
  <type by_reference="false">array</type>
6485
  </tag>
6486
+ <tag line="2046" name="return" description="HTML markup with select field options" type="string">
6487
  <type by_reference="false">string</type>
6488
  </tag>
6489
  </docblock>
6490
+ <argument line="2057">
6491
  <name>$selection</name>
6492
  <default><![CDATA['none']]></default>
6493
  <type/>
6494
  </argument>
6495
+ <argument line="2057">
6496
  <name>$blacklist</name>
6497
  <default><![CDATA[array()]]></default>
6498
  <type/>
6499
  </argument>
6500
  </method>
6501
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2152" package="Media Library Assistant">
6502
  <name>_compose_data_source_option_list</name>
6503
  <full_name>_compose_data_source_option_list</full_name>
6504
+ <docblock line="2142">
6505
  <description><![CDATA[Compose a (Custom Field) Data Source Options list with current selection]]></description>
6506
  <long-description><![CDATA[]]></long-description>
6507
+ <tag line="2142" name="since" description="1.10"/>
6508
+ <tag line="2142" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6509
+ <tag line="2142" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
6510
  <type by_reference="false">string</type>
6511
  </tag>
6512
+ <tag line="2142" name="return" description="HTML markup with select field options" type="string">
6513
  <type by_reference="false">string</type>
6514
  </tag>
6515
  </docblock>
6516
+ <argument line="2152">
6517
  <name>$selection</name>
6518
  <default><![CDATA['none']]></default>
6519
  <type/>
6520
  </argument>
6521
  </method>
6522
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2217" package="Media Library Assistant">
6523
  <name>_update_custom_field_mapping</name>
6524
  <full_name>_update_custom_field_mapping</full_name>
6525
+ <docblock line="2207">
6526
  <description><![CDATA[Update custom field mappings]]></description>
6527
  <long-description><![CDATA[]]></long-description>
6528
+ <tag line="2207" name="since" description="1.10"/>
6529
+ <tag line="2207" name="param" description="current custom_field_mapping values" type="array" variable="$current_values">
6530
  <type by_reference="false">array</type>
6531
  </tag>
6532
+ <tag line="2207" name="param" description="new values" type="array" variable="$new_values">
6533
  <type by_reference="false">array</type>
6534
  </tag>
6535
+ <tag line="2207" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated custom_field_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
6536
  <type by_reference="false">array</type>
6537
  </tag>
6538
  </docblock>
6539
+ <argument line="2217">
6540
  <name>$current_values</name>
6541
  <default><![CDATA[]]></default>
6542
  <type/>
6543
  </argument>
6544
+ <argument line="2217">
6545
  <name>$new_values</name>
6546
  <default><![CDATA[]]></default>
6547
  <type/>
6548
  </argument>
6549
  </method>
6550
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2423" package="Media Library Assistant">
6551
  <name>mla_custom_field_option_handler</name>
6552
  <full_name>mla_custom_field_option_handler</full_name>
6553
+ <docblock line="2410">
6554
  <description><![CDATA[Render and manage custom field mapping options]]></description>
6555
  <long-description><![CDATA[]]></long-description>
6556
+ <tag line="2410" name="since" description="1.10"/>
6557
+ <tag line="2410" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6558
+ <tag line="2410" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
6559
  <type by_reference="false">string</type>
6560
  </tag>
6561
+ <tag line="2410" name="param" description="option name, e.g., 'custom_field_mapping'" type="string" variable="$key">
6562
  <type by_reference="false">string</type>
6563
  </tag>
6564
+ <tag line="2410" name="param" description="option parameters" type="array" variable="$value">
6565
  <type by_reference="false">array</type>
6566
  </tag>
6567
+ <tag line="2410" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
6568
  <type by_reference="false">array</type>
6569
  </tag>
6570
+ <tag line="2410" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
6571
  <type by_reference="false">string</type>
6572
  </tag>
6573
  </docblock>
6574
+ <argument line="2423">
6575
  <name>$action</name>
6576
  <default><![CDATA[]]></default>
6577
  <type/>
6578
  </argument>
6579
+ <argument line="2423">
6580
  <name>$key</name>
6581
  <default><![CDATA[]]></default>
6582
  <type/>
6583
  </argument>
6584
+ <argument line="2423">
6585
  <name>$value</name>
6586
  <default><![CDATA[]]></default>
6587
  <type/>
6588
  </argument>
6589
+ <argument line="2423">
6590
  <name>$args</name>
6591
  <default><![CDATA[null]]></default>
6592
  <type/>
6593
  </argument>
6594
  </method>
6595
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2616" package="Media Library Assistant">
6596
  <name>mla_evaluate_iptc_exif_mapping</name>
6597
  <full_name>mla_evaluate_iptc_exif_mapping</full_name>
6598
+ <docblock line="2605">
6599
  <description><![CDATA[Evaluate IPTC/EXIF mapping updates for a post]]></description>
6600
  <long-description><![CDATA[]]></long-description>
6601
+ <tag line="2605" name="since" description="1.00"/>
6602
+ <tag line="2605" name="param" description="post object with current values" type="object" variable="$post">
6603
  <type by_reference="false">object</type>
6604
  </tag>
6605
+ <tag line="2605" name="param" description="category to evaluate against, e.g., iptc_exif_standard_mapping or iptc_exif_mapping" type="string" variable="$category">
6606
  <type by_reference="false">string</type>
6607
  </tag>
6608
+ <tag line="2605" name="param" description="(optional) iptc_exif_mapping values, default - current option value" type="array" variable="$settings">
6609
  <type by_reference="false">array</type>
6610
  </tag>
6611
+ <tag line="2605" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
6612
  <type by_reference="false">array</type>
6613
  </tag>
6614
  </docblock>
6615
+ <argument line="2616">
6616
  <name>$post</name>
6617
  <default><![CDATA[]]></default>
6618
  <type/>
6619
  </argument>
6620
+ <argument line="2616">
6621
  <name>$category</name>
6622
  <default><![CDATA[]]></default>
6623
  <type/>
6624
  </argument>
6625
+ <argument line="2616">
6626
  <name>$settings</name>
6627
  <default><![CDATA[NULL]]></default>
6628
  <type/>
6629
  </argument>
6630
  </method>
6631
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2866" package="Media Library Assistant">
6632
  <name>_compose_iptc_option_list</name>
6633
  <full_name>_compose_iptc_option_list</full_name>
6634
+ <docblock line="2856">
6635
  <description><![CDATA[Compose an IPTC Options list with current selection]]></description>
6636
  <long-description><![CDATA[]]></long-description>
6637
+ <tag line="2856" name="since" description="1.00"/>
6638
+ <tag line="2856" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6639
+ <tag line="2856" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
6640
  <type by_reference="false">string</type>
6641
  </tag>
6642
+ <tag line="2856" name="return" description="HTML markup with select field options" type="string">
6643
  <type by_reference="false">string</type>
6644
  </tag>
6645
  </docblock>
6646
+ <argument line="2866">
6647
  <name>$selection</name>
6648
  <default><![CDATA['none']]></default>
6649
  <type/>
6650
  </argument>
6651
  </method>
6652
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2899" package="Media Library Assistant">
6653
  <name>_compose_parent_option_list</name>
6654
  <full_name>_compose_parent_option_list</full_name>
6655
+ <docblock line="2888">
6656
  <description><![CDATA[Compose an hierarchical taxonomy Parent options list with current selection]]></description>
6657
  <long-description><![CDATA[]]></long-description>
6658
+ <tag line="2888" name="since" description="1.00"/>
6659
+ <tag line="2888" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6660
+ <tag line="2888" name="param" description="taxonomy slug" type="string" variable="$taxonomy">
6661
  <type by_reference="false">string</type>
6662
  </tag>
6663
+ <tag line="2888" name="param" description="current selection or 0 (zero, default)" type="integer" variable="$selection">
6664
  <type by_reference="false">integer</type>
6665
  </tag>
6666
+ <tag line="2888" name="return" description="HTML markup with select field options" type="string">
6667
  <type by_reference="false">string</type>
6668
  </tag>
6669
  </docblock>
6670
+ <argument line="2899">
6671
  <name>$taxonomy</name>
6672
  <default><![CDATA[]]></default>
6673
  <type/>
6674
  </argument>
6675
+ <argument line="2899">
6676
  <name>$selection</name>
6677
  <default><![CDATA[0]]></default>
6678
  <type/>
6679
  </argument>
6680
  </method>
6681
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2933" package="Media Library Assistant">
6682
  <name>_update_iptc_exif_standard_mapping</name>
6683
  <full_name>_update_iptc_exif_standard_mapping</full_name>
6684
+ <docblock line="2923">
6685
  <description><![CDATA[Update Standard field portion of IPTC/EXIF mappings]]></description>
6686
  <long-description><![CDATA[]]></long-description>
6687
+ <tag line="2923" name="since" description="1.00"/>
6688
+ <tag line="2923" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
6689
  <type by_reference="false">array</type>
6690
  </tag>
6691
+ <tag line="2923" name="param" description="new values" type="array" variable="$new_values">
6692
  <type by_reference="false">array</type>
6693
  </tag>
6694
+ <tag line="2923" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
6695
  <type by_reference="false">array</type>
6696
  </tag>
6697
  </docblock>
6698
+ <argument line="2933">
6699
  <name>$current_values</name>
6700
  <default><![CDATA[]]></default>
6701
  <type/>
6702
  </argument>
6703
+ <argument line="2933">
6704
  <name>$new_values</name>
6705
  <default><![CDATA[]]></default>
6706
  <type/>
6707
  </argument>
6708
  </method>
6709
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3012" package="Media Library Assistant">
6710
  <name>_update_iptc_exif_taxonomy_mapping</name>
6711
  <full_name>_update_iptc_exif_taxonomy_mapping</full_name>
6712
+ <docblock line="3002">
6713
  <description><![CDATA[Update Taxonomy term portion of IPTC/EXIF mappings]]></description>
6714
  <long-description><![CDATA[]]></long-description>
6715
+ <tag line="3002" name="since" description="1.00"/>
6716
+ <tag line="3002" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
6717
  <type by_reference="false">array</type>
6718
  </tag>
6719
+ <tag line="3002" name="param" description="new values" type="array" variable="$new_values">
6720
  <type by_reference="false">array</type>
6721
  </tag>
6722
+ <tag line="3002" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
6723
  <type by_reference="false">array</type>
6724
  </tag>
6725
  </docblock>
6726
+ <argument line="3012">
6727
  <name>$current_values</name>
6728
  <default><![CDATA[]]></default>
6729
  <type/>
6730
  </argument>
6731
+ <argument line="3012">
6732
  <name>$new_values</name>
6733
  <default><![CDATA[]]></default>
6734
  <type/>
6735
  </argument>
6736
  </method>
6737
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3111" package="Media Library Assistant">
6738
  <name>_update_iptc_exif_custom_mapping</name>
6739
  <full_name>_update_iptc_exif_custom_mapping</full_name>
6740
+ <docblock line="3101">
6741
  <description><![CDATA[Update Custom field portion of IPTC/EXIF mappings]]></description>
6742
  <long-description><![CDATA[]]></long-description>
6743
+ <tag line="3101" name="since" description="1.00"/>
6744
+ <tag line="3101" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
6745
  <type by_reference="false">array</type>
6746
  </tag>
6747
+ <tag line="3101" name="param" description="new values" type="array" variable="$new_values">
6748
  <type by_reference="false">array</type>
6749
  </tag>
6750
+ <tag line="3101" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
6751
  <type by_reference="false">array</type>
6752
  </tag>
6753
  </docblock>
6754
+ <argument line="3111">
6755
  <name>$current_values</name>
6756
  <default><![CDATA[]]></default>
6757
  <type/>
6758
  </argument>
6759
+ <argument line="3111">
6760
  <name>$new_values</name>
6761
  <default><![CDATA[]]></default>
6762
  <type/>
6763
  </argument>
6764
  </method>
6765
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3235" package="Media Library Assistant">
6766
  <name>_get_custom_field_names</name>
6767
  <full_name>_get_custom_field_names</full_name>
6768
+ <docblock line="3225">
6769
  <description><![CDATA[Generate a list of all (post) Custom Field names]]></description>
6770
  <long-description><![CDATA[<p>The list will include any Custom Field and IPTC/EXIF rules that
6771
  haven't been mapped to any attachments, yet.</p>]]></long-description>
6772
+ <tag line="3225" name="since" description="1.00"/>
6773
+ <tag line="3225" name="return" description="Custom field names from the postmeta table and MLA rules" type="array">
6774
  <type by_reference="false">array</type>
6775
  </tag>
6776
  </docblock>
6777
  </method>
6778
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="3279" package="Media Library Assistant">
6779
  <name>mla_iptc_exif_option_handler</name>
6780
  <full_name>mla_iptc_exif_option_handler</full_name>
6781
+ <docblock line="3266">
6782
  <description><![CDATA[Render and manage iptc/exif support options]]></description>
6783
  <long-description><![CDATA[]]></long-description>
6784
+ <tag line="3266" name="since" description="1.00"/>
6785
+ <tag line="3266" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6786
+ <tag line="3266" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
6787
  <type by_reference="false">string</type>
6788
  </tag>
6789
+ <tag line="3266" name="param" description="option name, e.g., 'iptc_exif_mapping'" type="string" variable="$key">
6790
  <type by_reference="false">string</type>
6791
  </tag>
6792
+ <tag line="3266" name="param" description="option parameters" type="array" variable="$value">
6793
  <type by_reference="false">array</type>
6794
  </tag>
6795
+ <tag line="3266" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
6796
  <type by_reference="false">array</type>
6797
  </tag>
6798
+ <tag line="3266" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
6799
  <type by_reference="false">string</type>
6800
  </tag>
6801
  </docblock>
6802
+ <argument line="3279">
6803
  <name>$action</name>
6804
  <default><![CDATA[]]></default>
6805
  <type/>
6806
  </argument>
6807
+ <argument line="3279">
6808
  <name>$key</name>
6809
  <default><![CDATA[]]></default>
6810
  <type/>
6811
  </argument>
6812
+ <argument line="3279">
6813
  <name>$value</name>
6814
  <default><![CDATA[]]></default>
6815
  <type/>
6816
  </argument>
6817
+ <argument line="3279">
6818
  <name>$args</name>
6819
  <default><![CDATA[null]]></default>
6820
  <type/>
6822
  </method>
6823
  </class>
6824
  </file>
6825
+ <file path="includes\class-mla-settings.php" hash="a25a771db61d3812935b69baf0584e3f" package="Media Library Assistant">
6826
  <docblock line="2">
6827
  <description><![CDATA[Manages the settings page to edit the plugin option settings]]></description>
6828
  <long-description><![CDATA[]]></long-description>
6912
  </tag>
6913
  </docblock>
6914
  </property>
6915
+ <property final="false" static="true" visibility="private" line="819" namespace="global" package="Media Library Assistant">
6916
  <name>$page_template_array</name>
6917
  <default><![CDATA[null]]></default>
6918
+ <docblock line="809">
6919
  <description><![CDATA[Template file for the Settings page(s) and parts]]></description>
6920
  <long-description><![CDATA[<p>This array contains all of the template parts for the Settings page(s). The array is built once
6921
  each page load and cached for subsequent use.</p>]]></long-description>
6922
+ <tag line="809" name="since" description="0.80"/>
6923
+ <tag line="809" name="var" description="" type="array">
6924
  <type by_reference="false">array</type>
6925
  </tag>
6926
  </docblock>
6927
  </property>
6928
+ <property final="false" static="true" visibility="private" line="835" namespace="global" package="Media Library Assistant">
6929
  <name>$mla_tablist</name>
6930
  <default><![CDATA[array('general' => array('title' => 'General', 'render' => '_compose_general_tab'), 'view' => array('title' => 'Views', 'render' => '_compose_view_tab'), 'upload' => array('title' => 'Uploads', 'render' => '_compose_upload_tab'), 'mla_gallery' => array('title' => 'MLA Gallery', 'render' => '_compose_mla_gallery_tab'), 'custom_field' => array('title' => 'Custom Fields', 'render' => '_compose_custom_field_tab'), 'iptc_exif' => array('title' => 'IPTC/EXIF', 'render' => '_compose_iptc_exif_tab'), 'documentation' => array('title' => 'Documentation', 'render' => '_compose_documentation_tab'))]]></default>
6931
+ <docblock line="821">
6932
  <description><![CDATA[Definitions for Settings page tab ids, titles and handlers
6933
  Each tab is defined by an array with the following elements:]]></description>
6934
  <long-description><![CDATA[<p>array key => HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)</p>
6936
  <p>title => tab label / heading text
6937
  render => rendering function for tab messages and content. Usage:
6938
  $tab_content = <a href="">'render'</a>;</p>]]></long-description>
6939
+ <tag line="821" name="since" description="0.80"/>
6940
+ <tag line="821" name="var" description="" type="array">
6941
  <type by_reference="false">array</type>
6942
  </tag>
6943
  </docblock>
6966
  </tag>
6967
  </docblock>
6968
  </method>
6969
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="203" package="Media Library Assistant">
6970
  <name>mla_activation_hook</name>
6971
  <full_name>mla_activation_hook</full_name>
6972
+ <docblock line="194">
6973
  <description><![CDATA[Perform one-time actions on plugin activation]]></description>
6974
  <long-description><![CDATA[<p>Adds a view to the database to support sorting the listing on 'ALT Text'.</p>]]></long-description>
6975
+ <tag line="194" name="since" description="0.40"/>
6976
+ <tag line="194" name="return" description="" type="void">
6977
  <type by_reference="false">void</type>
6978
  </tag>
6979
  </docblock>
6980
  </method>
6981
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="216" package="Media Library Assistant">
6982
  <name>mla_deactivation_hook</name>
6983
  <full_name>mla_deactivation_hook</full_name>
6984
+ <docblock line="207">
6985
  <description><![CDATA[Perform one-time actions on plugin deactivation]]></description>
6986
  <long-description><![CDATA[<p>Removes (if present) a view from the database that supports sorting the listing on 'ALT Text'.</p>]]></long-description>
6987
+ <tag line="207" name="since" description="0.40"/>
6988
+ <tag line="207" name="return" description="" type="void">
6989
  <type by_reference="false">void</type>
6990
  </tag>
6991
  </docblock>
6992
  </method>
6993
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="263" package="Media Library Assistant">
6994
  <name>mla_admin_init_action</name>
6995
  <full_name>mla_admin_init_action</full_name>
6996
+ <docblock line="256">
6997
  <description><![CDATA[Load the plugin's Ajax handler]]></description>
6998
  <long-description><![CDATA[]]></long-description>
6999
+ <tag line="256" name="since" description="1.40"/>
7000
+ <tag line="256" name="return" description="" type="void">
7001
  <type by_reference="false">void</type>
7002
  </tag>
7003
  </docblock>
7004
  </method>
7005
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="277" package="Media Library Assistant">
7006
  <name>mla_admin_enqueue_scripts_action</name>
7007
  <full_name>mla_admin_enqueue_scripts_action</full_name>
7008
+ <docblock line="268">
7009
  <description><![CDATA[Load the plugin's Style Sheet and Javascript files]]></description>
7010
  <long-description><![CDATA[]]></long-description>
7011
+ <tag line="268" name="since" description="1.40"/>
7012
+ <tag line="268" name="param" description="Name of the page being loaded" type="string" variable="$page_hook">
7013
  <type by_reference="false">string</type>
7014
  </tag>
7015
+ <tag line="268" name="return" description="" type="void">
7016
  <type by_reference="false">void</type>
7017
  </tag>
7018
  </docblock>
7019
+ <argument line="277">
7020
  <name>$page_hook</name>
7021
  <default><![CDATA[]]></default>
7022
  <type/>
7023
  </argument>
7024
  </method>
7025
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="332" package="Media Library Assistant">
7026
  <name>mla_admin_menu_action</name>
7027
  <full_name>mla_admin_menu_action</full_name>
7028
+ <docblock line="323">
7029
  <description><![CDATA[Add settings page in the "Settings" section,
7030
  add screen options and help tabs,
7031
  add settings link in the Plugins section entry for MLA.]]></description>
7032
  <long-description><![CDATA[]]></long-description>
7033
+ <tag line="323" name="since" description="0.1"/>
7034
+ <tag line="323" name="return" description="" type="void">
7035
  <type by_reference="false">void</type>
7036
  </tag>
7037
  </docblock>
7038
  </method>
7039
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="357" package="Media Library Assistant">
7040
  <name>mla_add_menu_options_action</name>
7041
  <full_name>mla_add_menu_options_action</full_name>
7042
+ <docblock line="350">
7043
  <description><![CDATA[Add the "XX Entries per page" filter to the Screen Options tab]]></description>
7044
  <long-description><![CDATA[]]></long-description>
7045
+ <tag line="350" name="since" description="1.40"/>
7046
+ <tag line="350" name="return" description="" type="void">
7047
  <type by_reference="false">void</type>
7048
  </tag>
7049
  </docblock>
7050
  </method>
7051
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="402" package="Media Library Assistant">
7052
  <name>mla_add_help_tab_action</name>
7053
  <full_name>mla_add_help_tab_action</full_name>
7054
+ <docblock line="395">
7055
  <description><![CDATA[Add contextual help tabs to all the MLA pages]]></description>
7056
  <long-description><![CDATA[]]></long-description>
7057
+ <tag line="395" name="since" description="1.40"/>
7058
+ <tag line="395" name="return" description="" type="void">
7059
  <type by_reference="false">void</type>
7060
  </tag>
7061
  </docblock>
7062
  </method>
7063
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="477" package="Media Library Assistant">
7064
  <name>mla_screen_options_show_screen_filter</name>
7065
  <full_name>mla_screen_options_show_screen_filter</full_name>
7066
+ <docblock line="467">
7067
  <description><![CDATA[Only show screen options on the View and Upload tabs]]></description>
7068
  <long-description><![CDATA[]]></long-description>
7069
+ <tag line="467" name="since" description="1.40"/>
7070
+ <tag line="467" name="param" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean" variable="$show_screen">
7071
  <type by_reference="false">boolean</type>
7072
  </tag>
7073
+ <tag line="467" name="param" description="Name of the page being loaded" type="string" variable="$this_screen">
7074
  <type by_reference="false">string</type>
7075
  </tag>
7076
+ <tag line="467" name="return" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean">
7077
  <type by_reference="false">boolean</type>
7078
  </tag>
7079
  </docblock>
7080
+ <argument line="477">
7081
  <name>$show_screen</name>
7082
  <default><![CDATA[]]></default>
7083
  <type/>
7084
  </argument>
7085
+ <argument line="477">
7086
  <name>$this_screen</name>
7087
  <default><![CDATA[]]></default>
7088
  <type/>
7089
  </argument>
7090
  </method>
7091
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="497" package="Media Library Assistant">
7092
  <name>mla_set_screen_option_filter</name>
7093
  <full_name>mla_set_screen_option_filter</full_name>
7094
+ <docblock line="486">
7095
  <description><![CDATA[Save the "Views/Uploads per page" option set by this user]]></description>
7096
  <long-description><![CDATA[]]></long-description>
7097
+ <tag line="486" name="since" description="1.40"/>
7098
+ <tag line="486" name="param" description="false or value returned by previous filter" type="mixed" variable="$status">
7099
  <type by_reference="false">mixed</type>
7100
  </tag>
7101
+ <tag line="486" name="param" description="Name of the option being changed" type="string" variable="$option">
7102
  <type by_reference="false">string</type>
7103
  </tag>
7104
+ <tag line="486" name="param" description="New value of the option" type="string" variable="$value">
7105
  <type by_reference="false">string</type>
7106
  </tag>
7107
+ <tag line="486" name="return" description="New value if this is our option, otherwise nothing" type="string|void">
7108
  <type by_reference="false">string</type>
7109
  <type by_reference="false">void</type>
7110
  </tag>
7111
  </docblock>
7112
+ <argument line="497">
7113
  <name>$status</name>
7114
  <default><![CDATA[]]></default>
7115
  <type/>
7116
  </argument>
7117
+ <argument line="497">
7118
  <name>$option</name>
7119
  <default><![CDATA[]]></default>
7120
  <type/>
7121
  </argument>
7122
+ <argument line="497">
7123
  <name>$value</name>
7124
  <default><![CDATA[]]></default>
7125
  <type/>
7126
  </argument>
7127
  </method>
7128
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="513" package="Media Library Assistant">
7129
  <name>mla_inline_edit_view_action</name>
7130
  <full_name>mla_inline_edit_view_action</full_name>
7131
+ <docblock line="504">
7132
  <description><![CDATA[Ajax handler for Post MIME Types inline editing (quick and bulk edit)]]></description>
7133
  <long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
7134
+ <tag line="504" name="since" description="1.40"/>
7135
+ <tag line="504" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
7136
  <type by_reference="false">void</type>
7137
  </tag>
7138
  </docblock>
7139
  </method>
7140
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="555" package="Media Library Assistant">
7141
  <name>mla_inline_edit_upload_action</name>
7142
  <full_name>mla_inline_edit_upload_action</full_name>
7143
+ <docblock line="546">
7144
  <description><![CDATA[Ajax handler for Upload MIME Types inline editing (quick and bulk edit)]]></description>
7145
  <long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
7146
+ <tag line="546" name="since" description="1.40"/>
7147
+ <tag line="546" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
7148
  <type by_reference="false">void</type>
7149
  </tag>
7150
  </docblock>
7151
  </method>
7152
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="594" package="Media Library Assistant">
7153
  <name>mla_add_plugin_settings_link_filter</name>
7154
  <full_name>mla_add_plugin_settings_link_filter</full_name>
7155
+ <docblock line="584">
7156
  <description><![CDATA[Add the "Settings" link to the MLA entry in the Plugins section]]></description>
7157
  <long-description><![CDATA[]]></long-description>
7158
+ <tag line="584" name="since" description="0.1"/>
7159
+ <tag line="584" name="param" description="array of links for the Plugin, e.g., &quot;Activate&quot;" type="array" variable="$links">
7160
  <type by_reference="false">array</type>
7161
  </tag>
7162
+ <tag line="584" name="param" description="Directory and name of the plugin Index file" type="string" variable="$file">
7163
  <type by_reference="false">string</type>
7164
  </tag>
7165
+ <tag line="584" name="return" description="Updated array of links for the Plugin" type="array">
7166
  <type by_reference="false">array</type>
7167
  </tag>
7168
  </docblock>
7169
+ <argument line="594">
7170
  <name>$links</name>
7171
  <default><![CDATA[]]></default>
7172
  <type/>
7173
  </argument>
7174
+ <argument line="594">
7175
  <name>$file</name>
7176
  <default><![CDATA[]]></default>
7177
  <type/>
7178
  </argument>
7179
  </method>
7180
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="614" package="Media Library Assistant">
7181
  <name>_update_option_row</name>
7182
  <full_name>_update_option_row</full_name>
7183
+ <docblock line="603">
7184
  <description><![CDATA[Update or delete a single MLA option value]]></description>
7185
  <long-description><![CDATA[]]></long-description>
7186
+ <tag line="603" name="since" description="0.80"/>
7187
+ <tag line="603" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7188
+ <tag line="603" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
7189
  <type by_reference="false">string</type>
7190
  </tag>
7191
+ <tag line="603" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
7192
  <type by_reference="false">array</type>
7193
  </tag>
7194
+ <tag line="603" name="return" description="HTML markup for the option's table row" type="string">
7195
  <type by_reference="false">string</type>
7196
  </tag>
7197
  </docblock>
7198
+ <argument line="614">
7199
  <name>$key</name>
7200
  <default><![CDATA[]]></default>
7201
  <type/>
7202
  </argument>
7203
+ <argument line="614">
7204
  <name>$value</name>
7205
  <default><![CDATA[]]></default>
7206
  <type/>
7207
  </argument>
7208
  </method>
7209
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="692" package="Media Library Assistant">
7210
  <name>_compose_option_row</name>
7211
  <full_name>_compose_option_row</full_name>
7212
+ <docblock line="681">
7213
  <description><![CDATA[Compose the table row for a single MLA option]]></description>
7214
  <long-description><![CDATA[]]></long-description>
7215
+ <tag line="681" name="since" description="0.80"/>
7216
+ <tag line="681" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7217
+ <tag line="681" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
7218
  <type by_reference="false">string</type>
7219
  </tag>
7220
+ <tag line="681" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
7221
  <type by_reference="false">array</type>
7222
  </tag>
7223
+ <tag line="681" name="return" description="HTML markup for the option's table row" type="string">
7224
  <type by_reference="false">string</type>
7225
  </tag>
7226
  </docblock>
7227
+ <argument line="692">
7228
  <name>$key</name>
7229
  <default><![CDATA[]]></default>
7230
  <type/>
7231
  </argument>
7232
+ <argument line="692">
7233
  <name>$value</name>
7234
  <default><![CDATA[]]></default>
7235
  <type/>
7236
  </argument>
7237
  </method>
7238
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="855" package="Media Library Assistant">
7239
  <name>_compose_settings_tabs</name>
7240
  <full_name>_compose_settings_tabs</full_name>
7241
+ <docblock line="845">
7242
  <description><![CDATA[Compose the navigation tabs for the Settings subpage]]></description>
7243
  <long-description><![CDATA[]]></long-description>
7244
+ <tag line="845" name="since" description="0.80"/>
7245
+ <tag line="845" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7246
+ <tag line="845" name="param" description="Optional data-tab-id value for the active tab, default 'general'" type="string" variable="$active_tab">
7247
  <type by_reference="false">string</type>
7248
  </tag>
7249
+ <tag line="845" name="return" description="HTML markup for the Settings subpage navigation tabs" type="string">
7250
  <type by_reference="false">string</type>
7251
  </tag>
7252
  </docblock>
7253
+ <argument line="855">
7254
  <name>$active_tab</name>
7255
  <default><![CDATA['general']]></default>
7256
  <type/>
7257
  </argument>
7258
  </method>
7259
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="881" package="Media Library Assistant">
7260
  <name>_compose_general_tab</name>
7261
  <full_name>_compose_general_tab</full_name>
7262
+ <docblock line="873">
7263
  <description><![CDATA[Compose the General tab content for the Settings subpage]]></description>
7264
  <long-description><![CDATA[]]></long-description>
7265
+ <tag line="873" name="since" description="0.80"/>
7266
+ <tag line="873" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7267
+ <tag line="873" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7268
  <type by_reference="false">array</type>
7269
  </tag>
7270
  </docblock>
7271
  </method>
7272
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1011" package="Media Library Assistant">
7273
  <name>_current_bulk_action</name>
7274
  <full_name>_current_bulk_action</full_name>
7275
+ <docblock line="1004">
7276
  <description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
7277
  <long-description><![CDATA[]]></long-description>
7278
+ <tag line="1004" name="since" description="1.40"/>
7279
+ <tag line="1004" name="return" description="The action name or False if no action was selected" type="string|false">
7280
  <type by_reference="false">string</type>
7281
  <type by_reference="false">false</type>
7282
  </tag>
7283
  </docblock>
7284
  </method>
7285
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1041" package="Media Library Assistant">
7286
  <name>_compose_edit_view_tab</name>
7287
  <full_name>_compose_edit_view_tab</full_name>
7288
+ <docblock line="1031">
7289
  <description><![CDATA[Compose the Edit View tab content for the Settings subpage]]></description>
7290
  <long-description><![CDATA[]]></long-description>
7291
+ <tag line="1031" name="since" description="1.40"/>
7292
+ <tag line="1031" name="param" description="data values for the item" type="array" variable="$view">
7293
  <type by_reference="false">array</type>
7294
  </tag>
7295
+ <tag line="1031" name="param" description="Display template" type="string" variable="$template">
7296
  <type by_reference="false">string</type>
7297
  </tag>
7298
+ <tag line="1031" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7299
  <type by_reference="false">array</type>
7300
  </tag>
7301
  </docblock>
7302
+ <argument line="1041">
7303
  <name>$view</name>
7304
  <default><![CDATA[]]></default>
7305
  <type/>
7306
  </argument>
7307
+ <argument line="1041">
7308
  <name>$template</name>
7309
  <default><![CDATA[]]></default>
7310
  <type/>
7311
  </argument>
7312
  </method>
7313
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1074" package="Media Library Assistant">
7314
  <name>_compose_view_tab</name>
7315
  <full_name>_compose_view_tab</full_name>
7316
+ <docblock line="1067">
7317
  <description><![CDATA[Compose the Post MIME Type Views tab content for the Settings subpage]]></description>
7318
  <long-description><![CDATA[]]></long-description>
7319
+ <tag line="1067" name="since" description="1.40"/>
7320
+ <tag line="1067" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7321
  <type by_reference="false">array</type>
7322
  </tag>
7323
  </docblock>
7324
  </method>
7325
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1300" package="Media Library Assistant">
7326
  <name>mla_get_icon_type_dropdown</name>
7327
  <full_name>mla_get_icon_type_dropdown</full_name>
7328
+ <docblock line="1289">
7329
  <description><![CDATA[Get an HTML select element representing a list of icon types]]></description>
7330
  <long-description><![CDATA[]]></long-description>
7331
+ <tag line="1289" name="since" description="1.40"/>
7332
+ <tag line="1289" name="param" description="Display template array" type="array" variable="$templates">
7333
  <type by_reference="false">array</type>
7334
  </tag>
7335
+ <tag line="1289" name="param" description="HTML name attribute value" type="string" variable="$name">
7336
  <type by_reference="false">string</type>
7337
  </tag>
7338
+ <tag line="1289" name="param" description="currently selected Icon Type" type="string" variable="$selection">
7339
  <type by_reference="false">string</type>
7340
  </tag>
7341
+ <tag line="1289" name="return" description="HTML select element or empty string on failure." type="string">
7342
  <type by_reference="false">string</type>
7343
  </tag>
7344
  </docblock>
7345
+ <argument line="1300">
7346
  <name>$templates</name>
7347
  <default><![CDATA[]]></default>
7348
  <type/>
7349
  </argument>
7350
+ <argument line="1300">
7351
  <name>$name</name>
7352
  <default><![CDATA[]]></default>
7353
  <type/>
7354
  </argument>
7355
+ <argument line="1300">
7356
  <name>$selection</name>
7357
  <default><![CDATA['.none.']]></default>
7358
  <type/>
7359
  </argument>
7360
  </method>
7361
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1341" package="Media Library Assistant">
7362
  <name>_compose_edit_upload_tab</name>
7363
  <full_name>_compose_edit_upload_tab</full_name>
7364
+ <docblock line="1331">
7365
  <description><![CDATA[Compose the Edit Upload type tab content for the Settings subpage]]></description>
7366
  <long-description><![CDATA[]]></long-description>
7367
+ <tag line="1331" name="since" description="1.40"/>
7368
+ <tag line="1331" name="param" description="data values for the item" type="array" variable="$item">
7369
  <type by_reference="false">array</type>
7370
  </tag>
7371
+ <tag line="1331" name="param" description="Display template array" type="string" variable="$templates">
7372
  <type by_reference="false">string</type>
7373
  </tag>
7374
+ <tag line="1331" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7375
  <type by_reference="false">array</type>
7376
  </tag>
7377
  </docblock>
7378
+ <argument line="1341">
7379
  <name>$item</name>
7380
  <default><![CDATA[]]></default>
7381
  <type/>
7382
  </argument>
7383
+ <argument line="1341">
7384
  <name>$templates</name>
7385
  <default><![CDATA[]]></default>
7386
  <type/>
7387
  </argument>
7388
  </method>
7389
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1376" package="Media Library Assistant">
7390
  <name>_compose_optional_upload_tab</name>
7391
  <full_name>_compose_optional_upload_tab</full_name>
7392
+ <docblock line="1367">
7393
  <description><![CDATA[Compose the Optional File Upload MIME Types tab content for the Settings subpage]]></description>
7394
  <long-description><![CDATA[]]></long-description>
7395
+ <tag line="1367" name="since" description="1.40"/>
7396
+ <tag line="1367" name="param" description="Display templates" type="string" variable="$page_template_array">
7397
  <type by_reference="false">string</type>
7398
  </tag>
7399
+ <tag line="1367" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7400
  <type by_reference="false">array</type>
7401
  </tag>
7402
  </docblock>
7403
+ <argument line="1376">
7404
  <name>$page_template_array</name>
7405
  <default><![CDATA[]]></default>
7406
  <type/>
7407
  </argument>
7408
  </method>
7409
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1442" package="Media Library Assistant">
7410
  <name>_process_optional_upload_mime</name>
7411
  <full_name>_process_optional_upload_mime</full_name>
7412
+ <docblock line="1433">
7413
  <description><![CDATA[Process an Optional Upload MIME Type selection]]></description>
7414
  <long-description><![CDATA[]]></long-description>
7415
+ <tag line="1433" name="since" description="1.40"/>
7416
+ <tag line="1433" name="param" description="MLA Optional Upload MIME Type ID" type="\intger" variable="$ID">
7417
  <type by_reference="false">\intger</type>
7418
  </tag>
7419
+ <tag line="1433" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7420
  <type by_reference="false">array</type>
7421
  </tag>
7422
  </docblock>
7423
+ <argument line="1442">
7424
  <name>$ID</name>
7425
  <default><![CDATA[]]></default>
7426
  <type/>
7427
  </argument>
7428
  </method>
7429
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1462" package="Media Library Assistant">
7430
  <name>_compose_upload_tab</name>
7431
  <full_name>_compose_upload_tab</full_name>
7432
+ <docblock line="1455">
7433
  <description><![CDATA[Compose the File Upload MIME Types tab content for the Settings subpage]]></description>
7434
  <long-description><![CDATA[]]></long-description>
7435
+ <tag line="1455" name="since" description="1.40"/>
7436
+ <tag line="1455" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7437
  <type by_reference="false">array</type>
7438
  </tag>
7439
  </docblock>
7440
  </method>
7441
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1717" package="Media Library Assistant">
7442
  <name>_compose_mla_gallery_tab</name>
7443
  <full_name>_compose_mla_gallery_tab</full_name>
7444
+ <docblock line="1709">
7445
  <description><![CDATA[Compose the MLA Gallery tab content for the Settings subpage]]></description>
7446
  <long-description><![CDATA[]]></long-description>
7447
+ <tag line="1709" name="since" description="0.80"/>
7448
+ <tag line="1709" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7449
+ <tag line="1709" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7450
  <type by_reference="false">array</type>
7451
  </tag>
7452
  </docblock>
7453
  </method>
7454
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2027" package="Media Library Assistant">
7455
  <name>_compose_custom_field_tab</name>
7456
  <full_name>_compose_custom_field_tab</full_name>
7457
+ <docblock line="2019">
7458
  <description><![CDATA[Compose the Custom Field tab content for the Settings subpage]]></description>
7459
  <long-description><![CDATA[]]></long-description>
7460
+ <tag line="2019" name="since" description="1.10"/>
7461
+ <tag line="2019" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7462
+ <tag line="2019" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7463
  <type by_reference="false">array</type>
7464
  </tag>
7465
  </docblock>
7466
  </method>
7467
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2138" package="Media Library Assistant">
7468
  <name>_compose_iptc_exif_tab</name>
7469
  <full_name>_compose_iptc_exif_tab</full_name>
7470
+ <docblock line="2130">
7471
  <description><![CDATA[Compose the IPTC/EXIF tab content for the Settings subpage]]></description>
7472
  <long-description><![CDATA[]]></long-description>
7473
+ <tag line="2130" name="since" description="1.00"/>
7474
+ <tag line="2130" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7475
+ <tag line="2130" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7476
  <type by_reference="false">array</type>
7477
  </tag>
7478
  </docblock>
7479
  </method>
7480
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2251" package="Media Library Assistant">
7481
  <name>_compose_documentation_tab</name>
7482
  <full_name>_compose_documentation_tab</full_name>
7483
+ <docblock line="2243">
7484
  <description><![CDATA[Compose the Documentation tab content for the Settings subpage]]></description>
7485
  <long-description><![CDATA[]]></long-description>
7486
+ <tag line="2243" name="since" description="0.80"/>
7487
+ <tag line="2243" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7488
+ <tag line="2243" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7489
  <type by_reference="false">array</type>
7490
  </tag>
7491
  </docblock>
7492
  </method>
7493
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2271" package="Media Library Assistant">
7494
  <name>mla_render_settings_page</name>
7495
  <full_name>mla_render_settings_page</full_name>
7496
+ <docblock line="2264">
7497
  <description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
7498
  <long-description><![CDATA[]]></long-description>
7499
+ <tag line="2264" name="since" description="0.1"/>
7500
+ <tag line="2264" name="return" description="Echoes HTML markup for the Settings subpage" type="void">
7501
  <type by_reference="false">void</type>
7502
  </tag>
7503
  </docblock>
7504
  </method>
7505
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2330" package="Media Library Assistant">
7506
  <name>_save_gallery_settings</name>
7507
  <full_name>_save_gallery_settings</full_name>
7508
+ <docblock line="2321">
7509
  <description><![CDATA[Save MLA Gallery settings to the options table]]></description>
7510
  <long-description><![CDATA[]]></long-description>
7511
+ <tag line="2321" name="since" description="0.80"/>
7512
+ <tag line="2321" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7513
+ <tag line="2321" name="return" description="Message(s) reflecting the results of the operation" type="array">
7514
  <type by_reference="false">array</type>
7515
  </tag>
7516
  </docblock>
7517
  </method>
7518
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2570" package="Media Library Assistant">
7519
  <name>_save_view_settings</name>
7520
  <full_name>_save_view_settings</full_name>
7521
+ <docblock line="2561">
7522
  <description><![CDATA[Save View settings to the options table]]></description>
7523
  <long-description><![CDATA[]]></long-description>
7524
+ <tag line="2561" name="since" description="1.40"/>
7525
+ <tag line="2561" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7526
+ <tag line="2561" name="return" description="Message(s) reflecting the results of the operation" type="array">
7527
  <type by_reference="false">array</type>
7528
  </tag>
7529
  </docblock>
7530
  </method>
7531
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2601" package="Media Library Assistant">
7532
  <name>_save_upload_settings</name>
7533
  <full_name>_save_upload_settings</full_name>
7534
+ <docblock line="2592">
7535
  <description><![CDATA[Save Upload settings to the options table]]></description>
7536
  <long-description><![CDATA[]]></long-description>
7537
+ <tag line="2592" name="since" description="1.40"/>
7538
+ <tag line="2592" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7539
+ <tag line="2592" name="return" description="Message(s) reflecting the results of the operation" type="array">
7540
  <type by_reference="false">array</type>
7541
  </tag>
7542
  </docblock>
7543
  </method>
7544
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2637" package="Media Library Assistant">
7545
  <name>_process_custom_field_mapping</name>
7546
  <full_name>_process_custom_field_mapping</full_name>
7547
+ <docblock line="2626">
7548
  <description><![CDATA[Process custom field settings against all image attachments
7549
  without saving the settings to the mla_option]]></description>
7550
  <long-description><![CDATA[]]></long-description>
7551
+ <tag line="2626" name="since" description="1.10"/>
7552
+ <tag line="2626" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7553
+ <tag line="2626" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$settings">
7554
  <type by_reference="false">array</type>
7555
  </tag>
7556
+ <tag line="2626" name="return" description="Message(s) reflecting the results of the operation" type="array">
7557
  <type by_reference="false">array</type>
7558
  </tag>
7559
  </docblock>
7560
+ <argument line="2637">
7561
  <name>$settings</name>
7562
  <default><![CDATA[NULL]]></default>
7563
  <type/>
7564
  </argument>
7565
  </method>
7566
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2689" package="Media Library Assistant">
7567
  <name>_delete_custom_field</name>
7568
  <full_name>_delete_custom_field</full_name>
7569
+ <docblock line="2680">
7570
  <description><![CDATA[Delete a custom field from the wp_postmeta table]]></description>
7571
  <long-description><![CDATA[]]></long-description>
7572
+ <tag line="2680" name="since" description="1.10"/>
7573
+ <tag line="2680" name="param" description="specific custom_field_mapping rule" type="array" variable="$value">
7574
  <type by_reference="false">array</type>
7575
  </tag>
7576
+ <tag line="2680" name="return" description="Message(s) reflecting the results of the operation" type="array">
7577
  <type by_reference="false">array</type>
7578
  </tag>
7579
  </docblock>
7580
+ <argument line="2689">
7581
  <name>$value</name>
7582
  <default><![CDATA[]]></default>
7583
  <type/>
7584
  </argument>
7585
  </method>
7586
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2713" package="Media Library Assistant">
7587
  <name>_save_custom_field_settings</name>
7588
  <full_name>_save_custom_field_settings</full_name>
7589
+ <docblock line="2703">
7590
  <description><![CDATA[Save custom field settings to the options table]]></description>
7591
  <long-description><![CDATA[]]></long-description>
7592
+ <tag line="2703" name="since" description="1.10"/>
7593
+ <tag line="2703" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7594
+ <tag line="2703" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$new_values">
7595
  <type by_reference="false">array</type>
7596
  </tag>
7597
+ <tag line="2703" name="return" description="Message(s) reflecting the results of the operation" type="array">
7598
  <type by_reference="false">array</type>
7599
  </tag>
7600
  </docblock>
7601
+ <argument line="2713">
7602
  <name>$new_values</name>
7603
  <default><![CDATA[NULL]]></default>
7604
  <type/>
7605
  </argument>
7606
  </method>
7607
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2753" package="Media Library Assistant">
7608
  <name>_process_iptc_exif_standard</name>
7609
  <full_name>_process_iptc_exif_standard</full_name>
7610
+ <docblock line="2743">
7611
  <description><![CDATA[Process IPTC/EXIF standard field settings against all image attachments
7612
  without saving the settings to the mla_option]]></description>
7613
  <long-description><![CDATA[]]></long-description>
7614
+ <tag line="2743" name="since" description="1.00"/>
7615
+ <tag line="2743" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7616
+ <tag line="2743" name="return" description="Message(s) reflecting the results of the operation" type="array">
7617
  <type by_reference="false">array</type>
7618
  </tag>
7619
  </docblock>
7620
  </method>
7621
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2805" package="Media Library Assistant">
7622
  <name>_process_iptc_exif_taxonomy</name>
7623
  <full_name>_process_iptc_exif_taxonomy</full_name>
7624
+ <docblock line="2795">
7625
  <description><![CDATA[Process IPTC/EXIF taxonomy term settings against all image attachments
7626
  without saving the settings to the mla_option]]></description>
7627
  <long-description><![CDATA[]]></long-description>
7628
+ <tag line="2795" name="since" description="1.00"/>
7629
+ <tag line="2795" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7630
+ <tag line="2795" name="return" description="Message(s) reflecting the results of the operation" type="array">
7631
  <type by_reference="false">array</type>
7632
  </tag>
7633
  </docblock>
7634
  </method>
7635
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2860" package="Media Library Assistant">
7636
  <name>_process_iptc_exif_custom</name>
7637
  <full_name>_process_iptc_exif_custom</full_name>
7638
+ <docblock line="2848">
7639
  <description><![CDATA[Process IPTC/EXIF custom field settings against all image attachments
7640
  without saving the settings to the mla_option]]></description>
7641
  <long-description><![CDATA[]]></long-description>
7642
+ <tag line="2848" name="since" description="1.00"/>
7643
+ <tag line="2848" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7644
+ <tag line="2848" name="param" description="| NULL specific iptc_exif_custom_mapping values" type="array" variable="$settings">
7645
  <type by_reference="false">array</type>
7646
  </tag>
7647
+ <tag line="2848" name="return" description="Message(s) reflecting the results of the operation" type="array">
7648
  <type by_reference="false">array</type>
7649
  </tag>
7650
  </docblock>
7651
+ <argument line="2860">
7652
  <name>$settings</name>
7653
  <default><![CDATA[NULL]]></default>
7654
  <type/>
7655
  </argument>
7656
  </method>
7657
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2920" package="Media Library Assistant">
7658
  <name>_save_iptc_exif_custom_settings</name>
7659
  <full_name>_save_iptc_exif_custom_settings</full_name>
7660
+ <docblock line="2911">
7661
  <description><![CDATA[Save IPTC/EXIF custom field settings to the options table]]></description>
7662
  <long-description><![CDATA[]]></long-description>
7663
+ <tag line="2911" name="since" description="1.30"/>
7664
+ <tag line="2911" name="param" description="specific iptc_exif_custom_mapping values" type="array" variable="$new_values">
7665
  <type by_reference="false">array</type>
7666
  </tag>
7667
+ <tag line="2911" name="return" description="Message(s) reflecting the results of the operation" type="array">
7668
  <type by_reference="false">array</type>
7669
  </tag>
7670
  </docblock>
7671
+ <argument line="2920">
7672
  <name>$new_values</name>
7673
  <default><![CDATA[]]></default>
7674
  <type/>
7675
  </argument>
7676
  </method>
7677
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2936" package="Media Library Assistant">
7678
  <name>_save_iptc_exif_settings</name>
7679
  <full_name>_save_iptc_exif_settings</full_name>
7680
+ <docblock line="2927">
7681
  <description><![CDATA[Save IPTC/EXIF settings to the options table]]></description>
7682
  <long-description><![CDATA[]]></long-description>
7683
+ <tag line="2927" name="since" description="1.00"/>
7684
+ <tag line="2927" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7685
+ <tag line="2927" name="return" description="Message(s) reflecting the results of the operation" type="array">
7686
  <type by_reference="false">array</type>
7687
  </tag>
7688
  </docblock>
7689
  </method>
7690
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2973" package="Media Library Assistant">
7691
  <name>_save_general_settings</name>
7692
  <full_name>_save_general_settings</full_name>
7693
+ <docblock line="2964">
7694
  <description><![CDATA[Save General settings to the options table]]></description>
7695
  <long-description><![CDATA[]]></long-description>
7696
+ <tag line="2964" name="since" description="0.1"/>
7697
+ <tag line="2964" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7698
+ <tag line="2964" name="return" description="Message(s) reflecting the results of the operation" type="array">
7699
  <type by_reference="false">array</type>
7700
  </tag>
7701
  </docblock>
7702
  </method>
7703
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3031" package="Media Library Assistant">
7704
  <name>_reset_general_settings</name>
7705
  <full_name>_reset_general_settings</full_name>
7706
+ <docblock line="3024">
7707
  <description><![CDATA[Delete saved settings, restoring default values]]></description>
7708
  <long-description><![CDATA[]]></long-description>
7709
+ <tag line="3024" name="since" description="0.1"/>
7710
+ <tag line="3024" name="return" description="Message(s) reflecting the results of the operation" type="array">
7711
  <type by_reference="false">array</type>
7712
  </tag>
7713
  </docblock>
7714
  </method>
7715
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3071" package="Media Library Assistant">
7716
  <name>_compose_import_settings</name>
7717
  <full_name>_compose_import_settings</full_name>
7718
+ <docblock line="3064">
7719
  <description><![CDATA[Compose HTML markup for the import settings if any settings files exist]]></description>
7720
  <long-description><![CDATA[]]></long-description>
7721
+ <tag line="3064" name="since" description="1.50"/>
7722
+ <tag line="3064" name="return" description="HTML markup for the Import All Settings button and dropdown list, if any" type="string">
7723
  <type by_reference="false">string</type>
7724
  </tag>
7725
  </docblock>
7726
  </method>
7727
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3124" package="Media Library Assistant">
7728
  <name>_export_settings</name>
7729
  <full_name>_export_settings</full_name>
7730
+ <docblock line="3115">
7731
  <description><![CDATA[Serialize option settings and write them to a file]]></description>
7732
  <long-description><![CDATA[<p>Options with a default value, i.e., not stored in the database are NOT written to the file.</p>]]></long-description>
7733
+ <tag line="3115" name="since" description="1.50"/>
7734
+ <tag line="3115" name="return" description="Message(s) reflecting the results of the operation" type="array">
7735
  <type by_reference="false">array</type>
7736
  </tag>
7737
  </docblock>
7738
  </method>
7739
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3204" package="Media Library Assistant">
7740
  <name>_import_settings</name>
7741
  <full_name>_import_settings</full_name>
7742
+ <docblock line="3197">
7743
  <description><![CDATA[Read a serialized file of option settings and write them to the database]]></description>
7744
  <long-description><![CDATA[]]></long-description>
7745
+ <tag line="3197" name="since" description="1.50"/>
7746
+ <tag line="3197" name="return" description="Message(s) reflecting the results of the operation" type="array">
7747
  <type by_reference="false">array</type>
7748
  </tag>
7749
  </docblock>
7750
  </method>
7751
  </class>
7752
  </file>
7753
+ <file path="includes\class-mla-shortcodes.php" hash="4c97f2d79394addb7c97fd0f3aa1ae72" package="Media Library Assistant">
7754
  <docblock line="2">
7755
  <description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
7756
  <long-description><![CDATA[]]></long-description>
7767
  <tag line="9" name="package" description="Media Library Assistant"/>
7768
  <tag line="9" name="since" description="0.20"/>
7769
  </docblock>
7770
+ <property final="false" static="true" visibility="public" line="135" namespace="global" package="Media Library Assistant">
7771
  <name>$mla_debug_messages</name>
7772
  <default><![CDATA['']]></default>
7773
+ <docblock line="128">
7774
  <description><![CDATA[Accumulates debug messages]]></description>
7775
  <long-description><![CDATA[]]></long-description>
7776
+ <tag line="128" name="since" description="0.60"/>
7777
+ <tag line="128" name="var" description="" type="string">
7778
  <type by_reference="false">string</type>
7779
  </tag>
7780
  </docblock>
7781
  </property>
7782
+ <property final="false" static="true" visibility="private" line="144" namespace="global" package="Media Library Assistant">
7783
  <name>$mla_debug</name>
7784
  <default><![CDATA[false]]></default>
7785
+ <docblock line="137">
7786
  <description><![CDATA[Turn debug collection and display on or off]]></description>
7787
  <long-description><![CDATA[]]></long-description>
7788
+ <tag line="137" name="since" description="0.70"/>
7789
+ <tag line="137" name="var" description="" type="boolean">
7790
  <type by_reference="false">boolean</type>
7791
  </tag>
7792
  </docblock>
7793
  </property>
7794
+ <property final="false" static="true" visibility="private" line="2119" namespace="global" package="Media Library Assistant">
7795
  <name>$query_parameters</name>
7796
  <default><![CDATA[array()]]></default>
7797
+ <docblock line="2105">
7798
  <description><![CDATA[WP_Query filter "parameters"]]></description>
7799
  <long-description><![CDATA[<p>This array defines parameters for the query's where and orderby filters,
7800
  mla_shortcode_query_posts_where_filter and mla_shortcode_query_posts_orderby_filter.
7802
  any further logic required to translate those values is contained in the filter.</p>
7803
 
7804
  <p>Array index values are: orderby, post_parent</p>]]></long-description>
7805
+ <tag line="2105" name="since" description="1.13"/>
7806
+ <tag line="2105" name="var" description="" type="array">
7807
  <type by_reference="false">array</type>
7808
  </tag>
7809
  </docblock>
7810
  </property>
7811
+ <property final="false" static="true" visibility="private" line="2228" namespace="global" package="Media Library Assistant">
7812
+ <name>$mla_get_shortcode_attachments_parameters</name>
7813
  <default><![CDATA[array('order' => 'ASC', 'orderby' => 'menu_order,ID', 'id' => NULL, 'ids' => array(), 'include' => array(), 'exclude' => array(), 'post_parent' => NULL, 'author' => NULL, 'author_name' => '', 'cat' => 0, 'category_name' => '', 'category__and' => array(), 'category__in' => array(), 'category__not_in' => array(), 'tag' => '', 'tag_id' => 0, 'tag__and' => array(), 'tag__in' => array(), 'tag__not_in' => array(), 'tag_slug__and' => array(), 'tag_slug__in' => array(), 'tax_operator' => '', 'tax_include_children' => true, 'post_type' => 'attachment', 'post_status' => 'inherit', 'post_mime_type' => 'image', 'nopaging' => true, 'numberposts' => 0, 'posts_per_page' => 0, 'posts_per_archive_page' => 0, 'paged' => NULL, 'offset' => NULL, 'mla_page_parameter' => 'mla_paginate_current', 'mla_paginate_current' => NULL, 'mla_paginate_total' => NULL, 'meta_key' => '', 'meta_value' => '', 'meta_value_num' => NULL, 'meta_compare' => '', 'meta_query' => '', 's' => '')]]></default>
7814
+ <docblock line="2221">
7815
  <description><![CDATA[Data selection parameters for the WP_Query in [mla_gallery]]]></description>
7816
  <long-description><![CDATA[]]></long-description>
7817
+ <tag line="2221" name="since" description="1.30"/>
7818
+ <tag line="2221" name="var" description="" type="array">
7819
  <type by_reference="false">array</type>
7820
  </tag>
7821
  </docblock>
7822
  </property>
7823
+ <property final="false" static="true" visibility="public" line="2295" namespace="global" package="Media Library Assistant">
7824
  <name>$mla_gallery_wp_query_object</name>
7825
  <default><![CDATA[NULL]]></default>
7826
+ <docblock line="2285">
7827
  <description><![CDATA[The WP_Query object used to select items for the gallery.]]></description>
7828
  <long-description><![CDATA[<p>Defined as a public, static variable so it can be inspected from the
7829
  "mla_gallery_wp_query_object" action. Set to NULL at all other times.</p>]]></long-description>
7830
+ <tag line="2285" name="since" description="1.51"/>
7831
+ <tag line="2285" name="var" description="" type="object">
7832
  <type by_reference="false">object</type>
7833
  </tag>
7834
  </docblock>
7835
  </property>
7836
+ <property final="false" static="true" visibility="private" line="2857" namespace="global" package="Media Library Assistant">
7837
+ <name>$mla_get_terms_parameters</name>
7838
+ <default><![CDATA[array('taxonomy' => 'post_tag', 'include' => '', 'exclude' => '', 'parent' => '', 'minimum' => 0, 'number' => 45, 'orderby' => 'name', 'order' => 'ASC', 'preserve_case' => false, 'limit' => 0, 'offset' => 0)]]></default>
7839
+ <docblock line="2850">
7840
+ <description><![CDATA[Data selection parameters for [mla_tag_cloud]]]></description>
7841
+ <long-description><![CDATA[]]></long-description>
7842
+ <tag line="2850" name="since" description="1.60"/>
7843
+ <tag line="2850" name="var" description="" type="array">
7844
+ <type by_reference="false">array</type>
7845
+ </tag>
7846
+ </docblock>
7847
+ </property>
7848
  <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="23" package="Media Library Assistant">
7849
  <name>initialize</name>
7850
  <full_name>initialize</full_name>
7857
  </tag>
7858
  </docblock>
7859
  </method>
7860
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="36" package="Media Library Assistant">
7861
  <name>mla_attachment_list_shortcode</name>
7862
  <full_name>mla_attachment_list_shortcode</full_name>
7863
+ <docblock line="29">
7864
  <description><![CDATA[WordPress Shortcode; renders a complete list of all attachments and references to them]]></description>
7865
  <long-description><![CDATA[]]></long-description>
7866
+ <tag line="29" name="since" description="0.1"/>
7867
+ <tag line="29" name="return" description="echoes HTML markup for the attachment list" type="void">
7868
  <type by_reference="false">void</type>
7869
  </tag>
7870
  </docblock>
7871
  </method>
7872
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="160" package="Media Library Assistant">
7873
  <name>mla_gallery_shortcode</name>
7874
  <full_name>mla_gallery_shortcode</full_name>
7875
+ <docblock line="146">
7876
  <description><![CDATA[The MLA Gallery shortcode.]]></description>
7877
  <long-description><![CDATA[<p>This is a superset of the WordPress Gallery shortcode for displaying images on a post,
7878
  page or custom post type. It is adapted from /wp-includes/media.php gallery_shortcode.
7879
  Enhancements include many additional selection parameters and full taxonomy support.</p>]]></long-description>
7880
+ <tag line="146" name="since" description=".50"/>
7881
+ <tag line="146" name="param" description="Attributes of the shortcode" type="array" variable="$attr">
7882
+ <type by_reference="false">array</type>
7883
+ </tag>
7884
+ <tag line="146" name="param" description="Optional content for enclosing shortcodes; used with mla_alt_shortcode" type="string" variable="$content">
7885
+ <type by_reference="false">string</type>
7886
+ </tag>
7887
+ <tag line="146" name="return" description="HTML content to display gallery." type="string">
7888
+ <type by_reference="false">string</type>
7889
+ </tag>
7890
+ </docblock>
7891
+ <argument line="160">
7892
+ <name>$attr</name>
7893
+ <default><![CDATA[]]></default>
7894
+ <type/>
7895
+ </argument>
7896
+ <argument line="160">
7897
+ <name>$content</name>
7898
+ <default><![CDATA[NULL]]></default>
7899
+ <type/>
7900
+ </argument>
7901
+ </method>
7902
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1044" package="Media Library Assistant">
7903
+ <name>mla_tag_cloud</name>
7904
+ <full_name>mla_tag_cloud</full_name>
7905
+ <docblock line="1032">
7906
+ <description><![CDATA[The MLA Tag Cloud support function.]]></description>
7907
+ <long-description><![CDATA[<p>This is an alternative to the WordPress wp_tag_cloud function, with additional
7908
+ options to customize the hyperlink behind each term.</p>]]></long-description>
7909
+ <tag line="1032" name="since" description="1.60"/>
7910
+ <tag line="1032" name="param" description="Attributes of the shortcode." type="array" variable="$attr">
7911
+ <type by_reference="false">array</type>
7912
+ </tag>
7913
+ <tag line="1032" name="return" description="HTML content to display the tag cloud." type="string">
7914
+ <type by_reference="false">string</type>
7915
+ </tag>
7916
+ </docblock>
7917
+ <argument line="1044">
7918
+ <name>$attr</name>
7919
+ <default><![CDATA[]]></default>
7920
+ <type/>
7921
+ </argument>
7922
+ </method>
7923
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1750" package="Media Library Assistant">
7924
+ <name>mla_tag_cloud_shortcode</name>
7925
+ <full_name>mla_tag_cloud_shortcode</full_name>
7926
+ <docblock line="1739">
7927
+ <description><![CDATA[The MLA Tag Cloud shortcode.]]></description>
7928
+ <long-description><![CDATA[<p>This is an interface to the mla_tag_cloud function.</p>]]></long-description>
7929
+ <tag line="1739" name="since" description="1.60"/>
7930
+ <tag line="1739" name="param" description="Attributes of the shortcode." type="array" variable="$attr">
7931
  <type by_reference="false">array</type>
7932
  </tag>
7933
+ <tag line="1739" name="return" description="HTML content to display the tag cloud." type="string">
7934
  <type by_reference="false">string</type>
7935
  </tag>
7936
  </docblock>
7937
+ <argument line="1750">
7938
  <name>$attr</name>
7939
  <default><![CDATA[]]></default>
7940
  <type/>
7941
  </argument>
7942
  </method>
7943
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1783" package="Media Library Assistant">
7944
  <name>_process_shortcode_parameter</name>
7945
  <full_name>_process_shortcode_parameter</full_name>
7946
+ <docblock line="1773">
7947
  <description><![CDATA[Handles brace/bracket escaping and parses template for a shortcode parameter]]></description>
7948
  <long-description><![CDATA[]]></long-description>
7949
+ <tag line="1773" name="since" description="1.14"/>
7950
+ <tag line="1773" name="param" description="raw shortcode parameter, e.g., &quot;text {+field+} {brackets} \\{braces\\}&quot;" type="string" variable="$text">
7951
  <type by_reference="false">string</type>
7952
  </tag>
7953
+ <tag line="1773" name="param" description="template substitution values, e.g., ('instance' =&gt; '1', ... )" type="string" variable="$markup_values">
7954
  <type by_reference="false">string</type>
7955
  </tag>
7956
+ <tag line="1773" name="return" description="query specification with HTML escape sequences and line breaks removed" type="string">
7957
  <type by_reference="false">string</type>
7958
  </tag>
7959
  </docblock>
7960
+ <argument line="1783">
7961
  <name>$text</name>
7962
  <default><![CDATA[]]></default>
7963
  <type/>
7964
  </argument>
7965
+ <argument line="1783">
7966
  <name>$markup_values</name>
7967
  <default><![CDATA[]]></default>
7968
  <type/>
7969
  </argument>
7970
  </method>
7971
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1802" package="Media Library Assistant">
7972
  <name>_paginate_links</name>
7973
  <full_name>_paginate_links</full_name>
7974
+ <docblock line="1789">
7975
  <description><![CDATA[Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links']]></description>
7976
  <long-description><![CDATA[]]></long-description>
7977
+ <tag line="1789" name="since" description="1.42"/>
7978
+ <tag line="1789" name="param" description="value(s) for mla_output_type parameter" type="array" variable="$output_parameters">
7979
  <type by_reference="false">array</type>
7980
  </tag>
7981
+ <tag line="1789" name="param" description="template substitution values, e.g., ('instance' =&gt; '1', ... )" type="string" variable="$markup_values">
7982
  <type by_reference="false">string</type>
7983
  </tag>
7984
+ <tag line="1789" name="param" description="merged default and passed shortcode parameter values" type="string" variable="$arguments">
7985
  <type by_reference="false">string</type>
7986
  </tag>
7987
+ <tag line="1789" name="param" description="number of attachments in the gallery, without pagination" type="integer" variable="$found_rows">
7988
  <type by_reference="false">integer</type>
7989
  </tag>
7990
+ <tag line="1789" name="param" description="output text so far, may include debug values" type="string" variable="$output">
7991
  <type by_reference="false">string</type>
7992
  </tag>
7993
+ <tag line="1789" name="return" description="false or string with HTML for pagination output types" type="mixed">
7994
  <type by_reference="false">mixed</type>
7995
  </tag>
7996
  </docblock>
7997
+ <argument line="1802">
7998
  <name>$output_parameters</name>
7999
  <default><![CDATA[]]></default>
8000
  <type/>
8001
  </argument>
8002
+ <argument line="1802">
8003
  <name>$markup_values</name>
8004
  <default><![CDATA[]]></default>
8005
  <type/>
8006
  </argument>
8007
+ <argument line="1802">
8008
  <name>$arguments</name>
8009
  <default><![CDATA[]]></default>
8010
  <type/>
8011
  </argument>
8012
+ <argument line="1802">
8013
  <name>$found_rows</name>
8014
  <default><![CDATA[]]></default>
8015
  <type/>
8016
  </argument>
8017
+ <argument line="1802">
8018
  <name>$output</name>
8019
  <default><![CDATA['']]></default>
8020
  <type/>
8021
  </argument>
8022
  </method>
8023
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1932" package="Media Library Assistant">
8024
  <name>_process_pagination_output_types</name>
8025
  <full_name>_process_pagination_output_types</full_name>
8026
+ <docblock line="1918">
8027
  <description><![CDATA[Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links']]></description>
8028
  <long-description><![CDATA[]]></long-description>
8029
+ <tag line="1918" name="since" description="1.42"/>
8030
+ <tag line="1918" name="param" description="value(s) for mla_output_type parameter" type="array" variable="$output_parameters">
8031
  <type by_reference="false">array</type>
8032
  </tag>
8033
+ <tag line="1918" name="param" description="template substitution values, e.g., ('instance' =&gt; '1', ... )" type="string" variable="$markup_values">
8034
  <type by_reference="false">string</type>
8035
  </tag>
8036
+ <tag line="1918" name="param" description="merged default and passed shortcode parameter values" type="string" variable="$arguments">
8037
  <type by_reference="false">string</type>
8038
  </tag>
8039
+ <tag line="1918" name="param" description="raw passed shortcode parameter values" type="string" variable="$attr">
8040
  <type by_reference="false">string</type>
8041
  </tag>
8042
+ <tag line="1918" name="param" description="number of attachments in the gallery, without pagination" type="integer" variable="$found_rows">
8043
  <type by_reference="false">integer</type>
8044
  </tag>
8045
+ <tag line="1918" name="param" description="output text so far, may include debug values" type="string" variable="$output">
8046
  <type by_reference="false">string</type>
8047
  </tag>
8048
+ <tag line="1918" name="return" description="false or string with HTML for pagination output types" type="mixed">
8049
  <type by_reference="false">mixed</type>
8050
  </tag>
8051
  </docblock>
8052
+ <argument line="1932">
8053
  <name>$output_parameters</name>
8054
  <default><![CDATA[]]></default>
8055
  <type/>
8056
  </argument>
8057
+ <argument line="1932">
8058
  <name>$markup_values</name>
8059
  <default><![CDATA[]]></default>
8060
  <type/>
8061
  </argument>
8062
+ <argument line="1932">
8063
  <name>$arguments</name>
8064
  <default><![CDATA[]]></default>
8065
  <type/>
8066
  </argument>
8067
+ <argument line="1932">
8068
  <name>$attr</name>
8069
  <default><![CDATA[]]></default>
8070
  <type/>
8071
  </argument>
8072
+ <argument line="1932">
8073
  <name>$found_rows</name>
8074
  <default><![CDATA[]]></default>
8075
  <type/>
8076
  </argument>
8077
+ <argument line="1932">
8078
  <name>$output</name>
8079
  <default><![CDATA['']]></default>
8080
  <type/>
8081
  </argument>
8082
  </method>
8083
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2130" package="Media Library Assistant">
8084
  <name>_sanitize_query_specification</name>
8085
  <full_name>_sanitize_query_specification</full_name>
8086
+ <docblock line="2121">
8087
  <description><![CDATA[Cleans up damage caused by the Visual Editor to the tax_query and meta_query specifications]]></description>
8088
  <long-description><![CDATA[]]></long-description>
8089
+ <tag line="2121" name="since" description="1.14"/>
8090
+ <tag line="2121" name="param" description="query specification; PHP nested arrays" type="string" variable="$specification">
8091
  <type by_reference="false">string</type>
8092
  </tag>
8093
+ <tag line="2121" name="return" description="query specification with HTML escape sequences and line breaks removed" type="string">
8094
  <type by_reference="false">string</type>
8095
  </tag>
8096
  </docblock>
8097
+ <argument line="2130">
8098
  <name>$specification</name>
8099
  <default><![CDATA[]]></default>
8100
  <type/>
8101
  </argument>
8102
  </method>
8103
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2147" package="Media Library Assistant">
8104
  <name>_validate_sql_orderby</name>
8105
  <full_name>_validate_sql_orderby</full_name>
8106
+ <docblock line="2136">
8107
  <description><![CDATA[Translates query parameters to a valid SQL order by clause.]]></description>
8108
  <long-description><![CDATA[<p>Accepts one or more valid columns, with or without ASC/DESC.
8109
  Enhanced version of /wp-includes/formatting.php function sanitize_sql_orderby().</p>]]></long-description>
8110
+ <tag line="2136" name="since" description="1.20"/>
8111
+ <tag line="2136" name="param" description="Validated query parameters" type="array" variable="$query_parameters">
8112
  <type by_reference="false">array</type>
8113
  </tag>
8114
+ <tag line="2136" name="return" description="Returns the orderby clause if present, false otherwise." type="string|bool">
8115
  <type by_reference="false">string</type>
8116
  <type by_reference="false">bool</type>
8117
  </tag>
8118
  </docblock>
8119
+ <argument line="2147">
8120
  <name>$query_parameters</name>
8121
  <default><![CDATA[]]></default>
8122
  <type/>
8123
  </argument>
8124
  </method>
8125
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2308" package="Media Library Assistant">
8126
  <name>mla_get_shortcode_attachments</name>
8127
  <full_name>mla_get_shortcode_attachments</full_name>
8128
+ <docblock line="2297">
8129
  <description><![CDATA[Parses shortcode parameters and returns the gallery objects]]></description>
8130
  <long-description><![CDATA[]]></long-description>
8131
+ <tag line="2297" name="since" description=".50"/>
8132
+ <tag line="2297" name="param" description="Post ID of the parent" type="int" variable="$post_parent">
8133
  <type by_reference="false">int</type>
8134
  </tag>
8135
+ <tag line="2297" name="param" description="Attributes of the shortcode" type="array" variable="$attr">
8136
  <type by_reference="false">array</type>
8137
  </tag>
8138
+ <tag line="2297" name="param" description="true to calculate and return ['found_posts'] as an array element" type="boolean" variable="$return_found_rows">
8139
  <type by_reference="false">boolean</type>
8140
  </tag>
8141
+ <tag line="2297" name="return" description="List of attachments returned from WP_Query" type="array">
8142
  <type by_reference="false">array</type>
8143
  </tag>
8144
  </docblock>
8145
+ <argument line="2308">
8146
  <name>$post_parent</name>
8147
  <default><![CDATA[]]></default>
8148
  <type/>
8149
  </argument>
8150
+ <argument line="2308">
8151
  <name>$attr</name>
8152
  <default><![CDATA[]]></default>
8153
  <type/>
8154
  </argument>
8155
+ <argument line="2308">
8156
  <name>$return_found_rows</name>
8157
  <default><![CDATA[NULL]]></default>
8158
  <type/>
8159
  </argument>
8160
  </method>
8161
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2760" package="Media Library Assistant">
8162
  <name>mla_shortcode_query_posts_where_filter</name>
8163
  <full_name>mla_shortcode_query_posts_where_filter</full_name>
8164
+ <docblock line="2746">
8165
  <description><![CDATA[Filters the WHERE clause for shortcode queries]]></description>
8166
  <long-description><![CDATA[<p>Captures debug information. Adds whitespace to the post_type = 'attachment'
8167
  phrase to circumvent subsequent Role Scoper modification of the clause.
8168
  Handles post_parent "any" and "none" cases.
8169
  Defined as public because it's a filter.</p>]]></long-description>
8170
+ <tag line="2746" name="since" description="0.70"/>
8171
+ <tag line="2746" name="param" description="query clause before modification" type="string" variable="$where_clause">
8172
  <type by_reference="false">string</type>
8173
  </tag>
8174
+ <tag line="2746" name="return" description="query clause after modification" type="string">
8175
  <type by_reference="false">string</type>
8176
  </tag>
8177
  </docblock>
8178
+ <argument line="2760">
8179
  <name>$where_clause</name>
8180
  <default><![CDATA[]]></default>
8181
  <type/>
8182
  </argument>
8183
  </method>
8184
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2801" package="Media Library Assistant">
8185
  <name>mla_shortcode_query_posts_orderby_filter</name>
8186
  <full_name>mla_shortcode_query_posts_orderby_filter</full_name>
8187
+ <docblock line="2789">
8188
  <description><![CDATA[Filters the ORDERBY clause for shortcode queries]]></description>
8189
  <long-description><![CDATA[<p>This is an enhanced version of the code found in wp-includes/query.php, function get_posts.
8190
  Defined as public because it's a filter.</p>]]></long-description>
8191
+ <tag line="2789" name="since" description="1.20"/>
8192
+ <tag line="2789" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
8193
  <type by_reference="false">string</type>
8194
  </tag>
8195
+ <tag line="2789" name="return" description="query clause after modification" type="string">
8196
  <type by_reference="false">string</type>
8197
  </tag>
8198
  </docblock>
8199
+ <argument line="2801">
8200
  <name>$orderby_clause</name>
8201
  <default><![CDATA[]]></default>
8202
  <type/>
8203
  </argument>
8204
  </method>
8205
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2826" package="Media Library Assistant">
8206
  <name>mla_shortcode_query_posts_clauses_filter</name>
8207
  <full_name>mla_shortcode_query_posts_clauses_filter</full_name>
8208
+ <docblock line="2814">
8209
  <description><![CDATA[Filters all clauses for shortcode queries, pre caching plugins]]></description>
8210
  <long-description><![CDATA[<p>This is for debug purposes only.
8211
  Defined as public because it's a filter.</p>]]></long-description>
8212
+ <tag line="2814" name="since" description="1.30"/>
8213
+ <tag line="2814" name="param" description="query clauses before modification" type="array" variable="$pieces">
8214
  <type by_reference="false">array</type>
8215
  </tag>
8216
+ <tag line="2814" name="return" description="query clauses after modification (none)" type="array">
8217
  <type by_reference="false">array</type>
8218
  </tag>
8219
  </docblock>
8220
+ <argument line="2826">
8221
  <name>$pieces</name>
8222
  <default><![CDATA[]]></default>
8223
  <type/>
8224
  </argument>
8225
  </method>
8226
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2844" package="Media Library Assistant">
8227
  <name>mla_shortcode_query_posts_clauses_request_filter</name>
8228
  <full_name>mla_shortcode_query_posts_clauses_request_filter</full_name>
8229
+ <docblock line="2832">
8230
  <description><![CDATA[Filters all clauses for shortcode queries, post caching plugins]]></description>
8231
  <long-description><![CDATA[<p>This is for debug purposes only.
8232
  Defined as public because it's a filter.</p>]]></long-description>
8233
+ <tag line="2832" name="since" description="1.30"/>
8234
+ <tag line="2832" name="param" description="query clauses before modification" type="array" variable="$pieces">
8235
  <type by_reference="false">array</type>
8236
  </tag>
8237
+ <tag line="2832" name="return" description="query clauses after modification (none)" type="array">
8238
  <type by_reference="false">array</type>
8239
  </tag>
8240
  </docblock>
8241
+ <argument line="2844">
8242
  <name>$pieces</name>
8243
  <default><![CDATA[]]></default>
8244
  <type/>
8245
  </argument>
8246
  </method>
8247
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2910" package="Media Library Assistant">
8248
+ <name>mla_get_terms</name>
8249
+ <full_name>mla_get_terms</full_name>
8250
+ <docblock line="2872">
8251
+ <description><![CDATA[Retrieve the terms in one or more taxonomies.]]></description>
8252
+ <long-description><![CDATA[<p>Alternative to WordPress get_terms() function that provides
8253
+ an accurate count of attachments associated with each term.</p>
8254
+
8255
+ <p>taxonomy - string containing one or more (comma-delimited) taxonomy names
8256
+ or an array of taxonomy names.</p>
8257
+
8258
+ <p>include - An array, comma- or space-delimited string of term ids to include
8259
+ in the return array.</p>
8260
+
8261
+ <p>exclude - An array, comma- or space-delimited string of term ids to exclude
8262
+ from the return array. If 'include' is non-empty, 'exclude' is ignored.</p>
8263
+
8264
+ <p>parent - term_id of the terms' immediate parent; 0 for top-level terms.</p>
8265
+
8266
+ <p>minimum - minimum number of attachments a term must have to be included.</p>
8267
+
8268
+ <p>number - maximum number of term objects to return. Terms are ordered by count,
8269
+ descending and then by term_id before this value is applied.</p>
8270
+
8271
+ <p>orderby - 'count', 'id', 'name', 'none', 'random', 'slug'</p>
8272
+
8273
+ <p>order - 'ASC', 'DESC'</p>
8274
+
8275
+ <p>preserve_case - 'true', 'false' to make orderby case-sensitive.</p>
8276
+
8277
+ <p>limit - final number of term objects to return, for pagination.</p>
8278
+
8279
+ <p>offset - number of term objects to skip, for pagination.</p>]]></long-description>
8280
+ <tag line="2872" name="since" description="1.60"/>
8281
+ <tag line="2872" name="param" description="taxonomies to search and query parameters" type="array" variable="$attr">
8282
+ <type by_reference="false">array</type>
8283
+ </tag>
8284
+ <tag line="2872" name="return" description="array of term objects, empty if none found" type="array">
8285
+ <type by_reference="false">array</type>
8286
+ </tag>
8287
+ </docblock>
8288
+ <argument line="2910">
8289
+ <name>$attr</name>
8290
+ <default><![CDATA[]]></default>
8291
+ <type/>
8292
+ </argument>
8293
+ </method>
8294
  </class>
8295
  </file>
8296
  <file path="includes\class-mla-upload-list-table.php" hash="f7ba215328a778423cb7b855c72e5716" package="Media Library Assistant">
9942
  </docblock>
9943
  </function>
9944
  </file>
9945
+ <file path="index.php" hash="d1ce099270d3f496be286705b9972f51" package="Media Library Assistant">
9946
  <docblock line="2">
9947
  <description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
9948
  <long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
9949
  will the rest of the plugin be loaded and run.</p>]]></long-description>
9950
  <tag line="2" name="package" description="Media Library Assistant"/>
9951
+ <tag line="2" name="version" description="1.60"/>
9952
  </docblock>
9953
+ <include line="135" type="Require Once" package="Media Library Assistant">
9954
  <name>includes/mla-plugin-loader.php</name>
9955
  </include>
9956
  <constant namespace="global" line="50" package="Media Library Assistant">
9976
  <full_name>\MLA_BACKUP_DIR</full_name>
9977
  <value><![CDATA[$content_dir . '/mla-backup/']]></value>
9978
  </constant>
9979
+ <function namespace="global" line="123" package="Media Library Assistant">
9980
  <name>mla_name_conflict_reporting_action</name>
9981
  <full_name>\mla_name_conflict_reporting_action</full_name>
9982
+ <docblock line="118">
9983
  <description><![CDATA[Displays name conflict error messages at the top of the Dashboard]]></description>
9984
  <long-description><![CDATA[]]></long-description>
9985
+ <tag line="118" name="since" description="0.20"/>
9986
  </docblock>
9987
  </function>
9988
  </file>
readme.txt CHANGED
@@ -3,8 +3,8 @@ Contributors: dglingren
3
  Donate link: http://fairtradejudaica.org/make-a-difference/donate/
4
  Tags: attachment, attachments, documents, gallery, image, images, media, library, media library, media-tags, media tags, tags, media categories, categories, IPTC, EXIF, GPS, PDF, meta, metadata, photo, photos, photograph, photographs, photoblog, photo albums, lightroom, photoshop, MIME, mime-type, icon, upload, file extensions
5
  Requires at least: 3.3
6
- Tested up to: 3.7
7
- Stable tag: 1.52
8
  License: GPLv2 or later
9
  License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
 
@@ -121,6 +121,19 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
121
 
122
  == Changelog ==
123
 
 
 
 
 
 
 
 
 
 
 
 
 
 
124
  = 1.52 =
125
  * Fix: **Corrected serious defect in `[mla_gallery]`** that incorrectly limited the number of items returned for non-paginated galleries.
126
  * Fix: Eliminated "Strict Standards" messages issued from MLAModal functions.
@@ -191,8 +204,8 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
191
 
192
  == Upgrade Notice ==
193
 
194
- = 1.52 =
195
- Corrects serious defect in [mla_gallery] that incorrectly limits the number of items returned for non-paginated galleries. One other fix.
196
 
197
  == Other Notes ==
198
 
@@ -214,154 +227,234 @@ I have used and learned much from the following books (among many):
214
 
215
  Media Library Assistant includes many images drawn (with permission) from the [Crystal Project Icons](http://www.softicons.com/free-icons/system-icons/crystal-project-icons-by-everaldo-coelho), created by [Everaldo Coelho](http://www.everaldo.com), founder of [Yellowicon](http://www.yellowicon.com).
216
 
217
- == MLA Gallery Shortcode ==
218
 
219
- The `[mla_gallery]` shortcode is used in a post, page or custom post type to add a gallery of images and/or other Media Library items (such as PDF documents). MLA Gallery is a superset of the `[gallery]` shortcode in the WordPress core; it is compatible with `[gallery]` and provides many enhancements. These include:
220
 
221
- * Full support for WordPress categories, tags and custom taxonomies. You can select items with any of the taxonomy parameters documented in the WP_Query class.
222
- * Support for all post_mime_type values, not just images.
223
- * Media Library items need not be "attached" to the post. You can build a gallery with any combination of items in the Library using taxonomy terms, custom fields and more.
224
- * Control over the styles, markup and content of each gallery using the Style and Markup Templates documented below.
225
- * Access to a wide range of content using the Attachment-specific and Field-level Substitution parameters documented below. A powerful Content Template facility lets you assemble content from multiple sources and vary the results depending on which data elements contain non-empty values for a given gallery item.
226
- * Combine [mla_gallery] data selection with other popular gallery-generating plugins to get the best of both.
 
227
 
228
- All of the options/parameters documented for the `[gallery]` shortcode are supported by the `[mla_gallery]` shortcode; you can find them in the WordPress Codex. Most of the parameters documented for the WP_Query class are also supported; see the WordPress Codex. Because the `[mla_gallery]` shortcode is designed to work with Media Library items, there are some parameter differences and extensions; full documentation comes on the Settings/Media Library Assistant screen of the plugin.
229
 
230
- <h4>Gallery Display Style</h4>
231
 
232
- Two parameters provide a way to apply custom style and markup templates to your `[mla_gallery]` display: These parameters replace the default style and/or markup templates with templates you define on the "MLA Gallery" tab of the Settings page.
233
 
234
- Three parameters provide control over the placement, size and spacing of gallery items without requiring the use of custom Style templates.
235
 
236
- <h4>Gallery Display Content</h4>
237
 
238
- Twelve parameters provide pagination support and an easy way to control the contents of gallery items without requiring the use of custom Markup templates.
239
 
240
- <h4>NEW! MLA Gallery Filters and Actions (Hooks)</h4>
241
 
242
- The `[mla_gallery]` shortcode supports a comprehensive set of filters and actions (twenty-five in all) that give you complete control over gallery composition from PHP code in your theme or in another plugin. An example of using the hooks from a simple, stand-alone plugin can be found in mla-hooks-example.php.txt.
243
 
244
- The example code documents each hook with comments in the filter/action function that intercepts it. Generally, each part of the gallery supports three hooks: 1) a "values" hook, which lets you record or update the substitution values for that gallery part, 2) a "template" hook, which lets you record/update the template used to generate the HTML markup, and 3) a "parse" hook which lets you modify or replace the markup generated for a gallery part. There are also hooks for manipulating shortcode and data selection attributes and for inspecting query results.
245
 
246
- == Support for Alternative Gallery Output, e.g., pagination ==
247
- The `[mla_gallery]` shortcode can be used to provide "Previous" and "Next" links that support moving among the individual items in a gallery or among gallery "pages". For example, if you have many items with a specific Att. Category or Att. Tag value you can build a single-image page with links to the previous/next item having that value. You can also build a page that shows a large gallery in groups, or "gallery pages", of ten items with links to the previous/next ten items or links to all of the gallery pages of items having that value.
248
 
249
- The **"mla_output"** parameter determines the type of output the shortcode will return. You can choose from six values:
 
 
 
 
 
 
250
 
251
- * `gallery`: The default value; returns the traditional gallery of image thumbnails, captions, etc.
252
- * `next_link`: returns a link to the next gallery item.
253
- * `previous_link`: returns a link to the previous gallery item.
254
- * `next_page`: returns a link to the next "page" of gallery items.
255
- * `previous_page`: returns a link to the previous "page" of gallery items.
256
- * `paginate_links`: returns a link to gallery items at the start and end of the list and to pages around the current "gallery page" ( e.g.: &larr; Prev 1 … 3 4 5 6 7 … 9 Next &rarr; ).
257
 
258
- == Support for Other Gallery-generating Shortcodes ==
259
 
260
- The [mla_gallery] shortcode can be used in combination with other gallery-generating shortcodes to give you the data selection power of [mla_gallery] and the formatting/display power of popular alternatives such as the WordPress.com Jetpack Carousel and Tiled Galleries modules. Any shortcode that accepts "ids=" or a similar parameter listing the attachment ID values for the gallery can be used. For example, if you want to select images using the MLA Att. Category taxonomy but want to display a Jetpack "Tiled Mosaic" gallery, you can code:
261
 
262
- `[mla_gallery attachment_category=vegetable tax_operator="NOT IN" mla_alt_shortcode=gallery type="rectangular" mla_alt_ids_name=include]`
 
 
 
 
263
 
264
- == MLA Gallery Style and Markup Templates ==
265
 
266
- The Style and Markup templates give you great flexibility for the content and format of each `[mla_gallery]`. You can define as many templates as you need.
267
 
268
- Style templates provide gallery-specific CSS inline styles. Markup templates provide the HTML markup for 1) the beginning of the gallery, 2) the beginning of each row, 3) each gallery item, 4) the end of each row and 5) the end of the gallery. The attachment-specific markup parameters let you choose among most of the attachment fields, not just the caption.
269
 
270
- The MLA Gallery tab on the Settings page lets you add, change and delete custom templates. The default templates are also displayed on this tab for easy reference.
 
 
 
 
271
 
272
- <h3>Field-level Markup Substitution Parameters</h3>
273
 
274
- Field-level substitution parameters let you access query arguments, custom fields, taxonomy terms, and attachment metadata for display in an MLA gallery. Formatting options let you control what happens when a field has multiple values.
275
 
276
- There are nine prefix values for field-level data.
 
 
 
 
 
 
 
277
 
278
- * `request`: The parameters defined in the `$_REQUEST` array; the "query strings" sent from the browser.
279
- * `query`: The parameters defined in the `[mla_gallery]` shortcode.
280
- * `custom`: WordPress custom fields, which you can define and populate on the Edit Media screen.
281
- * `terms`: WordPress Category, tag or custom taxonomy terms.
282
- * `meta`: The WordPress "attachment metadata", if any, embedded in the image/audio/video file. For this category, you can code any of the field names embedded in the `_wp_attachment_metadata` array.
283
- * `pdf`: The Document Information Dictionary (D.I.D.)and XMP metadata, if any, embedded in a PDF file. For this category, you can code any of the nine D.I.D. entries (Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate, Trapped). For many documents there is also a rich collection of additional metadata stored in XMP Metadata Streams.
284
- * `iptc`: The IPTC (International Press Telecommunications Council) metadata, if any, embedded in the image file.
285
- * `exif`: The EXIF (EXchangeable Image File) metadata, if any, embedded in a JPEG DCT or TIFF Rev 6.0 image file.
286
- * `template`: A Content Template, which lets you compose a value from multiple substitution parameters and test for empty values, choosing among two or more alternatives or suppressing output entirely. See the plugin documentation for details.
287
 
288
- <h4>NEW! Metadata in PDF documents</h4>
289
 
290
- Metadata in PDF documents comes from two sources. Early versions of the PDF specification defined a Document Information Dictionary (D.I.D.) containing up to nine (optional) fields: Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate and Trapped.</td>
 
 
 
 
 
 
 
 
 
 
291
 
292
- More recent versions of the specification add a second source of metadata, Metadata Streams, holding data defined by the Extensible Metadata Platform (XMP) framework. XMP metadata varies from document to document but is often extensive. MLA provides access to this data in three ways:
293
 
294
- 1. If a D.I.D. field is not stored in the document, MLA will copy appropriate values from the XMP data into the empty field to populate it as often as possible. For example, the "creator" value(s) in the "dc" namespace ("dc.creator") might be copied to an empty "Author" field, or the "dc.subject" value(s) might be copied to an empty Keywords field.
295
 
296
- 2. Additional values in the "xmp", "xmpMM", "xmpRights", "xap", "xapMM", "dc", "pdf" and "pdfx" namespaces are copied up to the root level for easier access. For example, the "pdfx.SourceModified" value can be accessed as "SourceModified", without the "pdfx." portion of the compound name.
 
 
297
 
298
- 3. Other namespaces in the document are copied to arrays at the root level. For example, some documents contain information in the "photoshop" namespace, such as "photoshop.CaptionWriter" and "photoshop.AuthorsPosition". The native values of some fields, e.g., "dc.creator", can be an array.
299
 
300
- A special "pseudo value", "ALL_PDF", returns a string representation of all the metadata. You can use this pseudo-value to examine the metadata in a document, find field names and see what values are present.
301
 
302
- == NEW! Content Templates ==
303
 
304
- Content Templates (templates) are one of the Field-level Markup Substitution Parameters, indicated by a prefix value ( `[+template: ... +]` ). Within a template you can have any combination of four elements:
 
 
 
 
305
 
306
- * `String`: text and/or field-level substitution parameters, e.g., `[+template: Base File - [+base_file+] +]`
307
- * `Conditional`: text and/or field-level substitution parameters that will be tested for missing values. Any field-level substitution parameter that is not valid, is empty or contains only whitespace will cause the entire conditional to be eliminated. Conditional elements are enclosed in parentheses. For example, `[+template: (ITPC Title: [+iptc:object-name+] ) +]`. If the IPTC field is missing or blank both it and the preceding "ITPC Title: " literal are eliminated.
308
- * `Choice`: two or more alternatives from which the first valid, non-empty value will be taken. Choice elements are separated by vertical bars ("|"), e.g., `[+template: Summary: ([+caption+]|[+description+]|[+title+]) +]`
309
- * `Template`: another template. There is no particular advantage to nesting templates, but it works.
310
 
311
- The conditional and choice elements are the key to templates' power, particularly with custom fields and metadata such as ITPC and EXIF. With the conditional element you can combine literal text with a substitution value and eliminate the text if the value is missing. With the choice element you can specify multiple sources for a value and decide the order in which they are tested. In the choice example above the text "Description: " will always be used, followed by the attachment's caption (if present) or the description value or the literal "none" if both of the other values are missing.
312
 
313
- Conditional, choice and template elements can be nested as needed. For example, a conditional element can have a choice element within it or a choice alternative could include a conditional. Here's an example:
 
 
 
 
 
314
 
315
- `[+template: Terms: (([+terms:category+], [+terms:post_tag+])|[+ terms: category +]|[+terms:post_tag +]|none)+]`
316
 
317
- This template has a String, "Terms: " and a Conditional, "(([+terms: … none)". This Conditional separates the "Terms: " literal from the first alternative in the Choice. Within the Conditional is a Choice having four alternatives. The first alternative is a Conditional, which will be empty unless both categories and tags are present. The second and third alternatives handle the cases where one of the two taxonomies has terms, and the final alternative is used when neither categories nor tags are present.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
318
 
319
- ==Custom Field and Attachment Metadata Processing Options==
 
 
 
320
 
321
- On the Custom Fields tab of the Settings screen you can define the rules for mapping several types of file and image metadata to WordPress custom fields. Custom field mapping can be applied automatically when an attachment is added to the Media Library. You can refresh the mapping for <strong><em>ALL</em></strong> attachments using the command buttons on the screen. You can selectively apply the mapping in the bulk edit area of the Media/Assistant submenu table and/or on the Edit Media screen for a single attachment. The advantages of mapping metadata to custom fields are:
322
 
323
- * You can add the data to an [mla_gallery] with a field-level markup substitution parameter. For example, add the image dimensions or a list of all the intermediate sizes available for the image.
 
 
324
 
325
- * You can add the data as a sortable column to the Media/Assistant submenu table. For example, you can find all the "orphans" in your library by adding "reference_issues" and then sorting by that column.
 
326
 
327
- **NEW! Adding or changing Attachment Metadata**
328
 
329
- WordPress stores an array of information for image, audio and video items in the "_wp_attachment_metadata" custom field. Plugins such as "Fullscreen Galleria" also use this field to store information like GPS coordinates. Many of the array elements, such as the "sizes" array for images, are in turn arrays of more detailed values. <strong>Compound names</strong> are used to access elements within arrays, e.g., &quot;<strong>sizes.thumbnail.file</strong>&quot; is used to specify the file name for the thumbnail version of an image.
330
 
331
- By coding the "meta:" prefix in the Field Title column of a field mapping rule you can add to or update this data, from any of the data sources listed below. You can use a **Content Template** to compose a value from multiple substitution parameters and test for empty values, choosing among two or more alternatives or suppressing the mapping altogether for a given item.
 
 
332
 
333
- Let's say, for example, that you want to add GPS coordinates to the "image_meta" element of the Attachment Metadata.
334
 
335
- 1. Open the Settings/Media Library Assistant submenu and select the Custom Fields tab. Scroll down to the "Add a new Field and Mapping Rule" section.
 
336
 
337
- 2. In the Field Title text box, enter "meta:image_meta.latitude". The rule will store its results in the "latitude" element of the "image_meta" array within the Attachment Metadata field.
338
 
339
- 3. In the Data Source dropdown, select "-- Template (see below) --". In the text box below the dropdown, enter "([+exif:GPS.LatitudeSDD+])". This is a Content Template that extracts the "GPS.LatitudeSDD" value from the EXIF data embedded in an image file. The parentheses test the result to eliminate empty values; only non-empty values will be mapped into the image_meta array.
340
 
341
- 4. Set the other parts of the rule as needed. You can select "Keep" if some of your items already have this information or "Replace" to update all items. "Native" and "Text" are appropriate for this example. You can check "Delete NULL values" to remove any existing, empty values for this element. The "MLA Column", "Quick Edit" and "Bulk Edit" checkboxes have no meaning for Attachment Metadata elements and can be left blank; they will be ignored if checked.
 
 
342
 
343
- If you are creating an IPTC/EXIF mapping rule the details are a bit different, but the capability is equivalent.
344
 
345
- <h4>Data sources for custom field mapping</h4>
 
 
346
 
347
- A complete list of the <strong>42 data source elements</strong> is on the plugin's Settings page. In addition, you can map any of the fields found in the attachment's WordPress metadata array to a custom field.
348
 
349
- **NEW!** You can use a template to compose a custom field from alternative data sources, depending on which fields are populated for a given attachment. For example, "`[+pdf:Keywords+]|[+iptc:2#025+]|none`" will use the PDF Keywords field, if populated, then the IPTC keywords field, if populated, or the literal "none" if neither field contains a value. With this template you can get keywords from both PDF documents and images in a single field.
350
 
351
- ==IPTC &amp; EXIF Processing Options==
352
 
353
- Some image file formats such as JPEG DCT or TIFF Rev 6.0 support the addition of data about the image, or <em>metadata</em>, in the image file. Many popular image processing programs such as Adobe PhotoShop allow you to populate metadata fields with information such as a copyright notice, caption, the image author and keywords that categorize the image in a larger collection. WordPress uses some of this information to populate the Title, Slug and Description fields when you add an image to the Media Library.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
354
 
355
- The Media Library Assistant has powerful tools for copying image metadata to:
356
 
357
- * the WordPress standard fields, e.g., the Caption
358
- * taxonomy terms, e.g., in categories, tags or custom taxonomies
359
- * WordPress custom fields
360
 
361
- You can define the rules for mapping metadata on the "IPTC/EXIF" tab of the Settings page. You can choose to automatically apply the rules when new media are added to the Library (or not). You can click the "Map IPTC/EXIF metadata" button on the Edit Media/Edit Single Item screen or in the bulk edit area to selectively apply the rules to one or more images. You can click the "Map All Attachments Now" to apply the rules to <strong>all of the images in your library</strong> at one time.
 
 
 
362
 
363
- You can use a template to compose a value from multiple data sources, e.g., `Taken with [+meta:camera+] at [+dimensions+] using ISO [+exif:ISOSpeedRatings,single+] and [+exif:ExposureTime+] exposure time`.
364
 
365
- You can use a template to compose a value from alternative data sources, depending on which fields are populated for a given attachment. For example, `[+iptc:2#020+]|[+iptc:2#025+]|none` will use the IPTC supplemental-category field, if populated, then the IPTC keywords field, if populated, or the literal "none" if neither IPTC field contains a value.
 
 
 
 
 
 
366
 
367
- Using a template in the "Standard field mapping" or "Custom field mapping" tables will yield a text result. For example, multiple IPTC keywords would be converted into a comma-delimited list as a string. In the "Taxonomy term mapping" table the template will deliver an array result if the fields inside the template have multiple values. For example, you can code `[+iptc:2#020+][+iptc:2#025+]` to store each of the IPTC supplemental-category <em><strong>and</strong></em> keywords values (there is no "|" in the template) as a separate taxonomy term.
3
  Donate link: http://fairtradejudaica.org/make-a-difference/donate/
4
  Tags: attachment, attachments, documents, gallery, image, images, media, library, media library, media-tags, media tags, tags, media categories, categories, IPTC, EXIF, GPS, PDF, meta, metadata, photo, photos, photograph, photographs, photoblog, photo albums, lightroom, photoshop, MIME, mime-type, icon, upload, file extensions
5
  Requires at least: 3.3
6
+ Tested up to: 3.7.1
7
+ Stable tag: 1.60
8
  License: GPLv2 or later
9
  License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
 
121
 
122
  == Changelog ==
123
 
124
+ = 1.60 =
125
+ * New: **`[mla_tag_cloud]` shortcode**. Enhanced tag cloud for any taxonomy, with "grid" format, full Display Content and custom template support along the lines of `[mla_gallery]`. Paginated clouds are also supported. Full details in the [Other Notes section](http://wordpress.org/extend/plugins/media-library-assistant/other_notes/ "Click here, then scroll down") and on the Settings/Media Library Assistant Documentation tab.
126
+ * New: **`MLA Text Widget`**. You can add widgets containing `[mla_gallery]`, `[mla_tag_cloud]` or **any shortcode** to the sidebars on your site. More information in the [Other Notes section](http://wordpress.org/extend/plugins/media-library-assistant/other_notes/ "Click here, then scroll down").
127
+ * New: For `[mla_gallery]`, **new 'page_ID' and 'page_url'** substitution parameters for easier 'mla_link_href' composition.
128
+ * New: For `[mla_gallery]`, **link=span and link=none** let you replace the hyperlink enclosing each gallery thumbnail with non-link content.
129
+ * New: For `[mla_gallery]`, **default Style and Markup templates conform to WordPress 3.7 conventions**. The "orientation" attribute has been added to Attachment-specific substitution parameters and as a Data Source for custom field mapping.
130
+ * New: **Enhanced IPTC/EXIF Taxonomy term mapping.** You can now separate multiple terms contained in a single IPTC/EXIF value by specifying one or more delimiters. For example, specify ";" to separate values like "tag1; tag2" into separate terms.
131
+ * New: For `[mla_gallery]`, **Support for Other Gallery-generating Shortcodes now includes the "enclosing shortcode" form**. You can pass content to the alternate shortcode by coding something like `[mla_gallery ids="1230,1227" mla_alt_shortcode=fsg_link mla_alt_ids_name=include class=button]View the gallery[/mla_gallery]`. New filters are provided for inspecting/modifying the content.
132
+ * Fix: On the Media/Assistant submenu, **where-used errors are no longer returned for** XHTML-style self-closing shortcodes, i.e., ending with "/]", and for tax_query and meta_query parameters containing substitution parameters.
133
+ * Fix: **Hiding the Media/Library submenu is now more reliable**. The Media/Library submenu is hidden with a CSS style, but is still available for use by plugins such as Enable Media Replace. The Media/Assistant submenu is automatically moved up to the top of the submenu list. Attempts to display the Media/Library submenu, e.g., after deleting an item from the Edit Media screen, are redirected to the Media/Assistant submenu.
134
+ * Fix: For the Settings/Media Library Assistant "Custom Fields" and "IPTC/EXIF" tabs, the **"Add Rule/Add Field and Map All Attachments" buttons now map values correctly**. In previous MLA versions, the rule was added but the attachment values were not mapped.
135
+ * Fix: For `[mla_gallery]`, **array values are now accepted in [+request:+] substitution parameters**, and the `,export` option is supported as well. Array values can be passed from the URL or HTML forms to parameters that accept a list of values, such as taxonomy queries.
136
+
137
  = 1.52 =
138
  * Fix: **Corrected serious defect in `[mla_gallery]`** that incorrectly limited the number of items returned for non-paginated galleries.
139
  * Fix: Eliminated "Strict Standards" messages issued from MLAModal functions.
204
 
205
  == Upgrade Notice ==
206
 
207
+ = 1.60 =
208
+ New [mla_tag_cloud] shortcode and shortcode-enabled MLA Text Widget. Five other enhancements, four fixes.
209
 
210
  == Other Notes ==
211
 
227
 
228
  Media Library Assistant includes many images drawn (with permission) from the [Crystal Project Icons](http://www.softicons.com/free-icons/system-icons/crystal-project-icons-by-everaldo-coelho), created by [Everaldo Coelho](http://www.everaldo.com), founder of [Yellowicon](http://www.yellowicon.com).
229
 
230
+ == NEW! MLA Tag Cloud Shortcode ==
231
 
232
+ The `[mla_tag_cloud]` shortcode displays a list of taxonomy terms in what is called a 'tag cloud', where the size of each term is determined by how many times that particular term has been assigned to Media Library items (attachments). The cloud works with both flat (e.g., Att. Tags) and hierarchical taxonomies (e.g., Att. Categories) MLA Tag Cloud provides many enhancements to the basic "cloud" display. These include:
233
 
234
+ * Full support for WordPress categories, tags and custom taxonomies. You can select from any taxonomy or list of taxonomies defined in your site.
235
+ * Several display formats, including "flat","list" and "grid" (modeled after the `[mla_gallery]` display).
236
+ * Complete support for paginated clouds; display hundreds or thousands of terms in managable groups.
237
+ * Control over the styles, markup and content of each cloud using Style and Markup Templates. You can customize the "list" and "grid" formats to suit any need.
238
+ * Access to a wide range of content using the term-specific and Field-level Substitution parameters. A powerful Content Template facility lets you assemble content from multiple sources and vary the results depending on which data elements contain non-empty values for a given term.
239
+ * Display Style and Display Content parameters for easy customization of the cloud display and the destination of the links behind each term.
240
+ * A comprehensive set of filters gives you access to each step of the cloud generation process from PHP code in your theme or other plugins.
241
 
242
+ Many of the `[mla_tag_cloud]` concepts and shortcode parameters are modeled after the `[mla_gallery]` shortcode, so the learning curve is short. Differences and parameters unique to the cloud are given in the sections below.
243
 
244
+ <h4>Tag Cloud Output Formats</h4>
245
 
246
+ The traditional tag cloud output is a "heat map" of term names where larger names are associated with more attachments than smaller names. The terms' display format is determined by the "mla_output" parameter:
247
 
248
+ * `flat` - Returns a sequence of hypelink tags without further HTML markup. The "separator" parameter content (default, one newline character) is inserted between each hyperlink.
249
 
250
+ * `list` - Returns hyperlinks enclosed by one of the HTML list tags; unordered (&lt;ul&gt;&lt;/ul&gt;), ordered (&lt;ol&gt;&lt;/ol&gt;) or definitions (&lt;dl&gt;&lt;/dl&gt;), which allow for each term to have a "caption". The "itemtag", "termtag" and "captiontag" parameters customize the list markup.
251
 
252
+ * `grid` - Modeled on the galleries produced by `[mla_gallery]`; a rectangular display with rows and columns. The tag parameters listed above, the "columns" parameter and the Display Style parameters customize the display.
253
 
254
+ * `array` - Returns a PHP array of cloud hyperlinks. This output format is not available through the shortcode; it is allowed when the `MLAShortcodes::mla_tag_cloud()` function is called directly from your theme or plugin PHP code.
255
 
256
+ The "list" and "grid" formats can be extensively customized by using custom Style and Markup Templates. The `[mla_tag_cloud]` shortcode also supports pagination with "previous_link", "current_link", "next_link", "previous_page", "next_page" and "paginate_links" formats. These are essentially the same as those for the `[mla_gallery]` shortcode.
257
 
258
+ <h4>Tag Cloud Item Parameters</h4>
259
 
260
+ Each item in the tag cloud comprises a term name of varying size, a hyperlink surrounding the term name and a "title" attribute (Rollover Text) displayed when the cursor hovers over the term name hyperlink. The following parameters customize item content and markup:
 
261
 
262
+ * `smallest`
263
+ * `largest`
264
+ * `unit`
265
+ * `separator`
266
+ * `single_text`
267
+ * `multiple_text`
268
+ * `link`
269
 
270
+ The Item parameters are an easy way to customize the content and markup for each cloud item. For the list and grid formats you can also use the Tag Cloud Display Content parameters and/or Style and Markup Templates for even greater flexibility.
 
 
 
 
 
271
 
272
+ <h4>Tag Cloud Item Link</h4>
273
 
274
+ The Link parameter specifies the target and type of link from the tag cloud term/item to the item's archive page, edit page or other destination. You can also specify a non-hyperlink treatment for each item.
275
 
276
+ * `view` - Link to the term's "archive page"
277
+ * `edit` - Link to the term's "edit tag/category" admin screen
278
+ * `(mla_link_href)` - Link to a custom destination, typically another post/page
279
+ * `span` - Substitutes a `&lt;span&gt;&lt;/span&gt;` tag for the hyperlink tag
280
+ * `none` - Eliminates the hyperlink tag
281
 
282
+ Using the "mla_link_href" parameter to completely replace the link destination URL is a common and useful choice. With this parameter us can use the tag cloud to select a term and then go to another post/page that uses that selection as part of an `[mla_gallery]` shortcode.
283
 
284
+ <h4>Tag Cloud Display Style (list and grid)</h4>
285
 
286
+ These parameters provide a way to apply custom style and markup templates to your `[mla_tag_cloud]` display.
287
 
288
+ * `mla_style` - replaces the default style template
289
+ * `mla_markup` - replaces the default markup template
290
+ * `mla_float` - specifies the CSS float attribute of the ".tag-cloud-item" style
291
+ * `mla_margin` - specifies the CSS margin property of the ".tag-cloud-item" style
292
+ * `mla_itemwidth` - specifies the CSS width attribute of the ".tag-cloud-item" style
293
 
294
+ <h4>Tag Cloud Display Content</h4>
295
 
296
+ Eight parameters provide an easy way to control the contents of tag cloud items without requiring the use of custom Markup templates.
297
 
298
+ * `mla_link_attributes`
299
+ * `mla_link_class`
300
+ * `mla_link_href`
301
+ * `mla_link_text`
302
+ * `mla_nolink_text`
303
+ * `mla_rollover_text`
304
+ * `mla_caption`
305
+ * `mla_target`
306
 
307
+ <h4>Tag Cloud Data Selection Parameters</h4>
 
 
 
 
 
 
 
 
308
 
309
+ The data selection parameters specify which taxonomy (or taxonomies) the terms are taken from, which terms are returned for the cloud and the order in which the terms are returned:
310
 
311
+ * `taxonomy` - The taxonomy or taxonomies to retrieve terms from
312
+ * `include` - A comma-separated list of term ids to include
313
+ * `exclude` - A comma-separated list of term ids to exclude from the returned values
314
+ * `parent` - Get direct children of this term
315
+ * `minimum` - The minimum number of attachments required
316
+ * `number` - The maximum number of "most popular" terms to return
317
+ * `orderby` - The sort order of the retrieved terms
318
+ * `order` - "ASC" or "DESC"
319
+ * `preserve_case` - Preserve upper- and lower-case distinctions when sorting by name
320
+ * `limit` - The number of terms to return
321
+ * `offset` - The number of terms to skip before returning the results
322
 
323
+ <h4>Tag Cloud Substitution Parameters</h4>
324
 
325
+ Style and Markup templates give you great flexibility for the content and format of each [mla_tag_cloud] when you use the "list" and "grid" output formats. The following <strong>field-level substitution parameters</strong> are available in the Style template and any of the Markup template sections:
326
 
327
+ * `request` - The parameters defined in the `$_REQUEST` array; the "query strings" sent from the browser.
328
+ * `query` - The parameters defined in the `[mla_tag_cloud]` shortcode.
329
+ * `template` - A Content Template, which lets you compose a value from multiple substitution parameters and test for empty values, choosing among two or more alternatives or suppressing output entirely.
330
 
331
+ Twenty-eight tag cloud substitution parameters are available for the <strong>Style template</strong>. Tag cloud substitution parameters for the <strong>Markup template</strong> are available in all of the template sections. They include all of the parameters defined above (for the Style template) and three additional markup-specific parameters. Tag cloud <strong>item-specific substitution parameters</strong> for the Markup template are available in the "Item" section of the template. They include all of the parameters defined above (for the Style and Markup templates) and twenty-five additional item-specific parameters.
332
 
333
+ <h4>Tag Cloud Pagination Parameters</h4>
334
 
335
+ If you have a large number of terms in your cloud taxonomy you may want to paginate the cloud display, i.e., divide the cloud into two or more pages of a reasonable size. Pagination support for `[mla_tag_cloud]` is modeled on similar functions for`[mla_gallery]`, and you can find more explaination of the ideas behind pagination in the <strong>Support for Alternative Gallery Output, e.g., Pagination</strong> documentation section. Five parameters are supplied for this purpose:
336
 
337
+ * `limit` - the maximum number of terms to display in one cloud "page"
338
+ * `offset` - the number of terms to skip over before starting the current cloud page
339
+ * `mla_page_parameter` - the name of the parameter containing the current page number
340
+ * `mla_cloud_current` - the default current cloud page number
341
+ * `term_id` - the id of the current term within the cloud
342
 
343
+ The `[mla_tag_cloud]` shortcode can be used to provide "Previous" and "Next" links that support moving among the individual items in a cloud or among cloud "pages". For example, if you have many terms in your Att. Category or Att. Tag taxonomies you can build a term-specific `[mla_gallery]` page with links to the previous/next term in the taxonomy (a complete pagination example is included below). You can also build a page that shows a large taxonomy in groups, or "cloud pages", of ten terms with links to the previous/next ten terms or links to all of the cloud pages of terms in the taxonomy.
 
 
 
344
 
345
+ The <strong>"mla_output"</strong> parameter determines the type of output the shortcode will return. For pagination output, you can choose from six values:
346
 
347
+ * `next_link` - returns a link to the next cloud item, based on the "term_id" parameter value
348
+ * `current_link` - returns a link to the current cloud item, based on the "term_id" parameter value
349
+ * `previous_link` - returns a link to the previous cloud item, based on the "term_id" parameter value
350
+ * `next_page` - returns a link to the next "page" of cloud items, based on the "mla_cloud_current" parameter value
351
+ * `previous_page` - returns a link to the previous "page" of cloud items, based on the "mla_cloud_current" parameter value
352
+ * `paginate_links` - returns a link to cloud items at the start and end of the list and to pages around the current "cloud page" ( e.g.: &laquo; Previous 1 … 3 4 5 6 7 … 9 Next &raquo; ), based on the "mla_cloud_current" parameter value
353
 
354
+ The best way to understand cloud pagination is by example, as in the next section below.
355
 
356
+ <h4>Tag Cloud Pagination Example</h4>
357
+
358
+ This section takes you through several of the `[mla_tag_cloud]` features, step by step. Let's start with a very simple cloud showing all of the terms in the "Att. Category" taxonomy:
359
+
360
+ `
361
+ [mla_tag_cloud taxonomy=attachment_category number=0]
362
+ `
363
+
364
+ The "number=0" parameter overrides the default maximum of 45 terms, showing all of the terms in the taxonomy. Let's paginate the cloud and limit the terms display to ten terms per "page":
365
+
366
+ `
367
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10]
368
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_output="paginate_links,prev_next"]
369
+ `
370
+
371
+ The "limit=10" parameter (on <strong>both</strong> shortcodes) limits the term display to ten terms. The second `[mla_tag_cloud]` shortcode, adding the 'mla_output="paginate_links,prev_next"' parameter, displays a line of pagination links below the cloud page. Coordination between the two shortcodes is automatic, using the "mla_cloud_current" parameter added to the URLs by the shortcode.
372
+
373
+ Now we'll make the cloud a convenient way to control a term-specific `[mla_gallery]`. The next step uses the "mla_link_href" parameter to change the link destination of each cloud term, returning to the current page with the term id of the selected term. We also add the "mla_cloud_current" parameter to each of these new links, so the tag cloud page is retained when a term is selected:
374
 
375
+ `
376
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_link_href="{+page_url+}?current_id={+term_id+}&amp;amp;mla_cloud_current={+request:mla_cloud_current+}]
377
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_output="paginate_links,prev_next"]
378
+ `
379
 
380
+ The "&amp;amp;" before the "mla_cloud_current" parameter is required to get by the WordPress Visual Editor. The "{+request:mla_cloud_current+}" value copies the current page number from the URL ($_REQUEST array) and adds it to each term's link. Now, let's use the "current_id={+term_id+}" information in the link to compose a term-specific `[mla_gallery]`:
381
 
382
+ `
383
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_link_href="{+page_url+}?current_id={+term_id+}&amp;amp;mla_cloud_current={+request:mla_cloud_current+}]<br />
384
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_output="paginate_links,prev_next"]
385
 
386
+ [mla_gallery post_mime_type=all tax_query="array ( 0 => array ( 'taxonomy' => 'attachment_category', 'field' => 'id', 'terms' => array( {+request:current_id+} ), 'include_children' => false ) )" mla_caption="{+title+}" columns=5 size=icon link=file]
387
+ `
388
 
389
+ The most complicated part of the new shortcode is the "tax_query" parameter, which we're using to ensure that the gallery items displayed match the count displayed for each term in the tag cloud. The tag cloud count does not contain items associated with any "child terms", or sub-categories, of the cloud item. To match this count we must use the "include_children=false" and "field=id" parameters of the "tax_query".
390
 
391
+ We can easily paginate the term-specific gallery by adding a second `[mla_gallery]` shortcode and a "posts_per_page" parameter to both shortcodes:
392
 
393
+ `
394
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_link_href="{+page_url+}?current_id={+term_id+}&amp;amp;mla_cloud_current={+request:mla_cloud_current+}]<br />
395
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_output="paginate_links,prev_next"]
396
 
397
+ [mla_gallery post_mime_type=all tax_query="array ( 0 => array ( 'taxonomy' => 'attachment_category', 'field' => 'id', 'terms' => array( {+request:current_id+} ), 'include_children' => false ) )" mla_caption="{+title+}" columns=5 posts_per_page=5 size=icon link=file]
398
 
399
+ [mla_gallery post_mime_type=all tax_query="array ( 0 => array ( 'taxonomy' => 'attachment_category', 'field' => 'id', 'terms' => array( {+request:current_id+} ), 'include_children' => false ) )" columns=5 posts_per_page=5 mla_output="paginate_links,prev_next"]
400
+ `
401
 
402
+ The pagination controls for the tag cloud and the gallery operate independently because by default they use different names for their respective "_current" page parameters. Our page now has a lot of functionality without requiring any WordPress templates or PHP code.
403
 
404
+ For extra credit, let's add some more navigation options to the page. We'll build previous, current and next term links at the bottom of the page. These are enclosed in an HTML table so they all appear on one line of the page. Here is just the additional content; the table of three link navigation controls:
405
 
406
+ `
407
+ &lt;table width=99%&gt;&lt;tr&gt;
408
+ &lt;td width=33% style="text-align: left"&gt;[mla_tag_cloud taxonomy=attachment_category number=0 term_id="{+request:current_id+}" mla_output="previous_link" smallest=12 largest=12 mla_link_href="{+page_url+}?current_id={+term_id+}" mla_link_text="Previous: {+name+}"]&lt;/td&gt;
409
 
410
+ &lt;td width=33% style="text-align: center; font-weight: bold:"&gt;[mla_tag_cloud taxonomy=attachment_category number=0 term_id="{+request:current_id+}" mla_output=current_link smallest=12 largest=12 mla_link_text="Current: {+name+}" link=span]&lt;/td&gt;
411
 
412
+ &lt;td width=33% style="text-align: right"&gt;[mla_tag_cloud taxonomy=attachment_category number=0 term_id="{+request:current_id+}" mla_output="next_link" smallest=12 largest=12 mla_link_href="{+page_url+}?current_id={+term_id+}" mla_link_text="Next: {+name+}"]&lt;/td&gt;
413
+ &lt;/tr&gt;&lt;/table&gt;
414
+ `
415
 
416
+ The "smallest=12" and "largest=12" parameters make "font-size" the same for all of the term names regardless of how many items are associated with the term. The "mla_link_text" parameters add labels to each of the three navigation links. Finally, the "link=span" parameter in the middle ("mla_output=current_link") shortcode removes the hyperlink behind the term name, since it would just take you back to the page you're already on.
417
 
418
+ <h4>MLA Tag Cloud Filters (Hooks)</h4>
419
 
420
+ The `[mla_tag_cloud]` shortcode supports a comprehensive set of filters that give you complete control over cloud composition from PHP code in your theme or in another plugin. An example of using the hooks from a simple, stand-alone plugin can be found in the MLA `/examples` directory.
421
 
422
+ The example code documents each hook with comments in the filter/action function that intercepts each hook. Generally, each part of the gallery supports three hooks: 1) a "<strong>values</strong>" hook, which lets you record or update the substitution values for that gallery part, 2) a "<strong>template</strong>" hook, which lets you record/update the template used to generate the HTML markup, and 3) a "<strong>parse</strong>" hook which lets you modify or replace the markup generated for a gallery part. Hooks are also provided to inspect/modify the shortcode attributes and the array of tag objects returned by the data selection function.
423
+
424
+ == Content Templates ==
425
+
426
+ Content Templates (templates) are one of the Field-level Markup Substitution Parameters, indicated by a prefix value ( `[+template: ... +]` ). Within a template you can have any combination of four elements:
427
+
428
+ * `String`: text and/or field-level substitution parameters, e.g., `[+template: Base File - [+base_file+] +]`
429
+ * `Conditional`: text and/or field-level substitution parameters that will be tested for missing values. Any field-level substitution parameter that is not valid, is empty or contains only whitespace will cause the entire conditional to be eliminated. Conditional elements are enclosed in parentheses. For example, `[+template: (ITPC Title: [+iptc:object-name+] ) +]`. If the IPTC field is missing or blank both it and the preceding "ITPC Title: " literal are eliminated.
430
+ * `Choice`: two or more alternatives from which the first valid, non-empty value will be taken. Choice elements are separated by vertical bars ("|"), e.g., `[+template: Summary: ([+caption+]|[+description+]|[+title+]) +]`
431
+ * `Template`: another template. There is no particular advantage to nesting templates, but it works.
432
+
433
+ The conditional and choice elements are the key to templates' power, particularly with custom fields and metadata such as ITPC and EXIF. With the conditional element you can combine literal text with a substitution value and eliminate the text if the value is missing. With the choice element you can specify multiple sources for a value and decide the order in which they are tested. In the choice example above the text "Description: " will always be used, followed by the attachment's caption (if present) or the description value or the literal "none" if both of the other values are missing.
434
+
435
+ Conditional, choice and template elements can be nested as needed. For example, a conditional element can have a choice element within it or a choice alternative could include a conditional. Here's an example:
436
+
437
+ `[+template: Terms: (([+terms:category+], [+terms:post_tag+])|[+ terms: category +]|[+terms:post_tag +]|none)+]`
438
+
439
+ This template has a String, "Terms: " and a Conditional, "(([+terms: … none)". This Conditional separates the "Terms: " literal from the first alternative in the Choice. Within the Conditional is a Choice having four alternatives. The first alternative is a Conditional, which will be empty unless both categories and tags are present. The second and third alternatives handle the cases where one of the two taxonomies has terms, and the final alternative is used when neither categories nor tags are present.
440
 
441
+ == The MLA Text Widget ==
442
 
443
+ The MLA Text Widget lets you add content such as <code>[mla_gallery]</code> and <code>[mla_tag_cloud]</code> displays to your site's sidebars. It is an easy way to add slide shows and navigation features to all your pages. The MLA Text Widget is based on the WordPress Text widget, but adds the ability to include <strong>any</strong> shortcode to widget content. To use the MLA Text Widget:
 
 
444
 
445
+ 1. Go to the Appearance/Widgets Administration screen
446
+ 1. Open the sidebar, footer, or Theme section to which you wish to add the Text Widget
447
+ 1. Find the Text Widget in the list of Widgets
448
+ 1. Click and drag the Widget to the spot you wish it to appear
449
 
450
+ To open and edit the MLA Text Widget:
451
 
452
+ 1. Click the down arrow to the right of the MLA Text Widget title
453
+ 1. Set the MLA Text Widget Title (optional)
454
+ 1. Add the text or HTML code to the box or edit what is currently there
455
+ 1. If desired, choose the option to Automatically add paragraphs to wrap each block of text in an HTML paragraph tag
456
+ 1. Click Save to save the Widget
457
+ 1. Click Close to close the Widget
458
+ 1. Switch tabs in your browser and review the results; make changes if necessary
459
 
460
+ To add an <code>[mla_gallery]</code> or <code>[mla_tag_cloud]</code> shortcode to your widget, simply enter the shortcode name and parameters just as you would in the body of a post or page. Aside from the usually more limited area devoted to displaying the widget content, there are no differences in the way shortcodes are processed in the MLA Widget. Also, there is nothing special about the two MLA shortcodes; <strong>any</strong> shortcode can be added to the MLA Widget.
tpls/documentation-settings-tab.tpl CHANGED
@@ -1,9 +1,7 @@
1
  <!-- template="documentation-tab" -->
2
  <div class="mla-display-settings-page" id="mla-display-settings-documentation-tab" style="width:700px">
3
  <h3>Plugin and Shortcode Documentation. In this tab, jump to:</h3>
4
- <ul style="list-style-position:inside; list-style:disc; line-height: 18px">
5
- <li>
6
- <a href="#mla_gallery"><strong>MLA Gallery Shortcode</strong></a>
7
  <ul style="list-style-position:inside; list-style:disc; line-height: 15px; padding-left: 20px">
8
  <li><a href="#gallery_display_style">Gallery Display Style</a></li>
9
  <li><a href="#gallery_display_content">Gallery Display Content</a></li>
@@ -25,8 +23,22 @@
25
  <li><a href="#search_keywords">Search Keywords</a></li>
26
  <li><a href="#debugging_output">Debugging Output</a></li>
27
  <li><a href="#mla_gallery_hooks">MLA Gallery Filters (Hooks)</a></li>
28
- </ul>
29
- </li>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
30
  <li>
31
  <a href="#mla_output"><strong>Support for Alternative Gallery Output, e.g., Pagination</strong></a>
32
  </li>
@@ -56,6 +68,9 @@
56
  <a href="#mla_table_example"><strong>A table-based Style and Markup template example</strong></a>
57
  </li>
58
  <li>
 
 
 
59
  <a href="#mla_views"><strong>Library Views/Post MIME Type Processing</strong></a>
60
  </li>
61
  <li>
@@ -330,10 +345,36 @@ The <code>[mla_gallery]</code> shortcode supports an additional Size value, "ico
330
  </p>
331
  <h4>Link</h4>
332
  <p>
333
- The Link parameter specifies the target for the link from the gallery to the attachment. The default value, "permalink" (or its synonym "post"), links to the attachment's media page. The "file" and "full" values link directly to the attachment file.
334
  </p>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
335
  <p>
336
- For image attachments you can also specify the size of the image file you want to link to. Valid values include "thumbnail", "medium", "large" and any additional image size that was registered with add_image_size(). If the specified size is not available or if the attachment is not an image, the link will go directly to the attachment file.
337
  <a name="include_exclude"></a>
338
  </p>
339
  <h4>Include, Exclude</h4>
@@ -483,7 +524,7 @@ The "mla_debug" parameter controls the display of information about the query pa
483
  </p>
484
  <h4>MLA Gallery Filters and Actions (Hooks)</h4>
485
  <p>
486
- The <code>[mla_gallery]</code> shortcode supports a comprehensive set of filters and actions the give you complete control over gallery composition from PHP code in your theme or in another plugin. An example of using the hooks from a simple, stand-alone plugin can be found here: <a title="View the Hooks Example source code" href="[+examples_url+]mla-hooks-example.php.txt" target="_blank" style="font-size:14px; font-weight:bold">mla-hooks-example.php.txt</a>. To run the example:
487
  <ol>
488
  <li>Edit the code to, for example, uncomment the <code>error_log()</code> calls so you can see what is passed to the hooks you are interested in.</li>
489
  <li>Remove the ".txt" extension and saving the "mla-hooks-example.php" file in your plugins directory.</li>
@@ -501,16 +542,24 @@ The example code documents each hook with comments in the filter/action function
501
  <td>called at the beginning of the gallery. You can record/modify shortcode parameter values before (attributes) or after (arguments) they are combined with all the defaults.</td>
502
  </tr>
503
  <tr>
 
 
 
 
504
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_query_attributes,<br />mla_gallery_query_arguments</td>
505
- <td>called just before the <code>WP_Query->query()</code> call that selects gallery items, with query parameters beforee and after they are combined with defaults.</td>
506
  </tr>
507
  <tr>
508
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_wp_query_object</td>
509
  <td>called just after the <code>WP_Query->query()</code> call, so you can inspect/record the results.</td>
510
  </tr>
511
  <tr>
 
 
 
 
512
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">use_mla_gallery_style</td>
513
- <td>allow or suppress the inclusin of CSS styles in the gallery output.</td>
514
  </tr>
515
  <tr>
516
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_style</td>
@@ -541,6 +590,725 @@ The example code documents each hook with comments in the filter/action function
541
  <td>for manipulating the "Close" part of the Markup template.</td>
542
  </tr>
543
  </table>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
544
  <a name="mla_output"></a>
545
  &nbsp;
546
  <p>
@@ -548,11 +1316,11 @@ The example code documents each hook with comments in the filter/action function
548
  </p>
549
  <h3>Support for Alternative Gallery Output, e.g., Pagination</h3>
550
  <p>
551
- The <code>[mla_gallery]</code> shortcode can be used to provide "Previous" and "Next" links that support moving among the individual items in a gallery or among gallery "pages". For example, if you have many items with a specific Att. Category or Att. Tag value you can build a single-image page with links to the previous/next item having that value. You can also build a page that shows a large gallery in groups, or "gallery pages", of ten items with links to the previous/next ten items or links to all of the gallery pages of items having that value. Finally, you can get a set of links to all pages in the gallery or links around the current page ( e.g.: &larr; Prev 1 3 4 5 6 7 9 Next &rarr; ).
552
  </p>
553
  <h4>The <code>mla_output</code> parameter</h4>
554
  <p>
555
- The <strong>"mla_output"</strong> parameter determines the type of output the shortcode will return. Explanation and examples of each output type are given later in this section. You can choose from six values:
556
  </p>
557
  <table>
558
  <tr>
@@ -563,6 +1331,9 @@ The <strong>"mla_output"</strong> parameter determines the type of output the sh
563
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">next_link</td>
564
  <td>returns a link to the next gallery item. The optional "<strong>,wrap</strong>" qualifier determines what happens at the end of the gallery. If you omit the qualifier, an empty string is returned for the "next_link" from the last item in the gallery. If you code the ",wrap" qualifier, the "next_link" from the last item will be to the first gallery item.</td>
565
  </tr>
 
 
 
566
  <tr>
567
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">previous_link</td>
568
  <td>returns a link to the previous gallery item. The optional "<strong>,wrap</strong>" qualifier determines what happens at the beginning of the gallery. If you omit the qualifier, an empty string is returned for the "previous_link" from the first gallery item. If you code the ",wrap" qualifier, "previous_link" from the first gallery item will be to the last gallery item.</td>
@@ -577,7 +1348,7 @@ The <strong>"mla_output"</strong> parameter determines the type of output the sh
577
  </tr>
578
  <tr>
579
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">paginate_links</td>
580
- <td>returns a link to gallery items at the start and end of the list and to pages around the current "gallery page" ( e.g.: &larr; Prev 1 3 4 5 6 7 9 Next &rarr; ). The optional "<strong>,show_all</strong>" qualifier will show all of the gallery pages instead of a short list around the current page. The optional "<strong>,prev_next</strong>" qualifier will include the "&larr; Prev" and "Next &rarr;" portions of the link list.</td>
581
  </tr>
582
  </table>
583
  <h4>Next and previous gallery items; the <code>next_link</code> and <code>previous_link</code> output types</h4>
@@ -683,11 +1454,11 @@ The next or previous link returned can use the following Gallery Display Content
683
  </tr>
684
  <tr>
685
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_prev_text</td>
686
- <td>the "previous page" text (default "&larr; Previous"); an alternative to "mla_link_text" for <code>mla_output=previous_page</code></td>
687
  </tr>
688
  <tr>
689
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_next_text</td>
690
- <td>the "next page" text (default "Next &rarr;") an alternative to "mla_link_text" for <code>mla_output=next_page</code></td>
691
  </tr>
692
  <tr>
693
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_nolink_text</td>
@@ -803,11 +1574,11 @@ The <strong>Page Selection Parameters</strong>, <strong>Gallery Display Content
803
  </tr>
804
  <tr>
805
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_prev_text</td>
806
- <td>the "previous page" text (default "&larr; Previous") , which appears when the ",prev_next" qualifier is added to the output_type</td>
807
  </tr>
808
  <tr>
809
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_next_text</td>
810
- <td>the "next page" text (default "Next &rarr;") , which appears when the ",prev_next" qualifier is added to the output_type</td>
811
  </tr>
812
  <tr>
813
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_paginate_type</td>
@@ -878,6 +1649,14 @@ Here, <code>[mla_gallery]</code> selects the images with an Att. Tag of "fauna"
878
  Photonic recognizes the <code>type=default</code> parameter and takes over, using the other three parameters to format its results. This example is a less convenient but more flexible alternative to the native Photonic support built-in to <code>[mla_gallery]</code> (see next section).
879
  </p>
880
  <p>
 
 
 
 
 
 
 
 
881
  <strong>NOTE:</strong> When you use "mla_alt_shortcode" to pass format/display responsibility off to another shortcode you will lose the <code>[mla_gallery]</code> Gallery Display Style (e.g. "mla_float") and Gallery Display Content (e.g. "mla_caption") parameters. There is no reliable way for <code>[mla_gallery]</code> to pass this information on to the other shortcode you've specified.
882
  </p>
883
  <p>
@@ -1035,6 +1814,14 @@ In a template, substitution parameters are surrounded by opening ('[+') and clos
1035
  <td>absolute URL to the site directory, without trailing slash</td>
1036
  </tr>
1037
  <tr>
 
 
 
 
 
 
 
 
1038
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">base_url</td>
1039
  <td>absolute URL to the upload directory, without trailing slash</td>
1040
  </tr>
@@ -1121,6 +1908,10 @@ These substitution parameters are only available in the "Item" part of the marku
1121
  <td>height in pixels, for image types</td>
1122
  </tr>
1123
  <tr>
 
 
 
 
1124
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">image_meta</td>
1125
  <td>image metadata, for image types</td>
1126
  </tr>
@@ -1231,7 +2022,7 @@ There are nine prefix values for field-level data. Prefix values must be coded a
1231
  </tr>
1232
  <tr>
1233
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">query</td>
1234
- <td>The parameters defined in the <code>[mla_gallery]</code> shortcode. For example, if your shortcode is <code>[mla gallery attachment_tag=my-tag div-class=some_class]</code> you can access the parameters as <code>[+query:attachment_tag+]</code> and <code>[+query:div-class+]</code> respectively. Only the parameters actually coded in the shortcode are accessible; default values for parameters not actually coded are not available. You can define your own parameters, e.g., "div-class"; they will be accessible as field-level data but will otherwise be ignored.</td>
1235
  </tr>
1236
  <tr>
1237
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">custom</td>
@@ -1279,7 +2070,7 @@ There are nine prefix values for field-level data. Prefix values must be coded a
1279
  </tr>
1280
  <tr>
1281
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">template</td>
1282
- <td>A Content Template, which lets you compose a value from multiple substitution parameters and test for empty values, choosing among two or more alternatives or suppressing output entirely. See the <a href="#mla_template_parameters">Content Templates</a> section for details.</td> Note that the formatting option is not supported for templates.
1283
  </tr>
1284
  </table>
1285
  <a name="pdf_metadata"></a>
@@ -1401,7 +2192,7 @@ Conditional, choice and template elements can be nested as needed. For example,
1401
  <code>[+template: Terms: (([+terms:category+], [+terms:post_tag+])|[+ terms: category +]|[+terms:post_tag +]|none)+]</code>
1402
  </p>
1403
  <p>
1404
- This template has a String, "Terms: " and a Conditional, "(([+terms: none)". This Conditional separates the "Terms: " literal from the first alternative in the Choice. Within the Conditional is a Choice having four alternatives. The first alternative is a Conditional, which will be empty unless both categories and tags are present. The second and third alternatives handle the cases where one of the two taxonomies has terms, and the final alternative is used when neither categories nor tags are present.
1405
  </p>
1406
  <h4>Special characters inside templates</h4>
1407
  <p>
@@ -1480,11 +2271,40 @@ The Item markup section shows how to use the "terms", "custom", "iptc" and "exif
1480
  <td><code>&lt;/table&gt;</code></td>
1481
  </tr>
1482
  </table>
1483
- <a name="mla_views"></a>
1484
  &nbsp;
1485
  <p>
1486
  <a href="#backtotop">Go to Top</a>
1487
  </p>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1488
  <h3>Library Views/Post MIME Type Processing</h3>
1489
  <p>
1490
  WordPress uses <em><strong>Post MIME Types</strong></em> (a terrible name; they have nothing to do with Posts or Pages), to define the views for the Media/Library screen and the Media Manager/Add Media "media items" drop down list. MLA's Media/Assistant screen uses an enhanced version of the list, <em><strong>Table Views</strong></em>, to support views with multiple MIME Types (e.g., "audio,video") and wildcard specifications (e.g. "*/*ms*").
@@ -1758,6 +2578,10 @@ Set the other parts of the rule as needed. You can select "EXIF" unless you also
1758
  <td>for image types, height in pixels</td>
1759
  </tr>
1760
  <tr>
 
 
 
 
1761
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">hwstring_small</td>
1762
  <td>HTML dimensions of a "small" image, i.e., 128 or less width, 96 or less height. Not computed for images uploaded in WordPress 3.5 and later.</td>
1763
  </tr>
@@ -2045,6 +2869,15 @@ You can also enter a Content Template here by coding the "template:" prefix at t
2045
  <dt>Existing Text</dt>
2046
  <dd>Images already in the Media Library will have non-blank values in many fields and may have existing terms in a taxonomy. You can select "Keep" to retain these values or "Replace" to always map a metadata value into the field. For a taxonomy, "Keep" will retain any terms already assigned to the item and "Replace" will delete any existing terms before assigning metadata values as terms.
2047
  </dd>
 
 
 
 
 
 
 
 
 
2048
  <dt>Parent</dt>
2049
  <dd>For hierarchical taxonomies such as Categories you can select one of the existing terms in the taxonomy as the parent term for any terms you are mapping from metadata values. For example, you could define "IPTC Keywords" as a parent and then assign all of the 2#025 values under that parent term.
2050
  </dd>
1
  <!-- template="documentation-tab" -->
2
  <div class="mla-display-settings-page" id="mla-display-settings-documentation-tab" style="width:700px">
3
  <h3>Plugin and Shortcode Documentation. In this tab, jump to:</h3>
4
+ <div style="float:left; margin-right: 15px;"><a href="#mla_gallery"><strong>MLA Gallery Shortcode</strong></a>
 
 
5
  <ul style="list-style-position:inside; list-style:disc; line-height: 15px; padding-left: 20px">
6
  <li><a href="#gallery_display_style">Gallery Display Style</a></li>
7
  <li><a href="#gallery_display_content">Gallery Display Content</a></li>
23
  <li><a href="#search_keywords">Search Keywords</a></li>
24
  <li><a href="#debugging_output">Debugging Output</a></li>
25
  <li><a href="#mla_gallery_hooks">MLA Gallery Filters (Hooks)</a></li>
26
+ </ul></div>
27
+ <div style="float:left; margin-left: 15px;"><a href="#mla_tag_cloud"><strong>MLA Tag Cloud Shortcode</strong></a>
28
+ <ul style="list-style-position:inside; list-style:disc; line-height: 15px; padding-left: 20px">
29
+ <li><a href="#tag_cloud_output">Tag Cloud Output Formats</a></li>
30
+ <li><a href="#tag_cloud_items">Tag Cloud Item Parameters</a></li>
31
+ <li><a href="#tag_cloud_link">Tag Cloud Item Link</a></li>
32
+ <li><a href="#tag_cloud_display_style">Tag Cloud Display Style (list and grid)</a></li>
33
+ <li><a href="#tag_cloud_display_content">Tag Cloud Display Content</a></li>
34
+ <li><a href="#tag_cloud_data_selection">Tag Cloud Data Selection Parameters</a></li>
35
+ <li><a href="#tag_cloud_debugging_output">Tag Cloud Debugging Output</a></li>
36
+ <li><a href="#tag_cloud_substitution">Tag Cloud Substitution Parameters</a></li>
37
+ <li><a href="#tag_cloud_pagination_parameters">Tag Cloud Pagination Parameters</a></li>
38
+ <li><a href="#tag_cloud_pagination_example">A Tag Cloud Pagination Example</a></li>
39
+ <li><a href="#mla_tag_cloud_hooks">MLA Tag Cloud Filters (Hooks)</a></li>
40
+ </ul></div>
41
+ <ul style="list-style-position:inside; list-style:disc; line-height: 18px; clear:both">
42
  <li>
43
  <a href="#mla_output"><strong>Support for Alternative Gallery Output, e.g., Pagination</strong></a>
44
  </li>
68
  <a href="#mla_table_example"><strong>A table-based Style and Markup template example</strong></a>
69
  </li>
70
  <li>
71
+ <a href="#mla_text_widget"><strong>The MLA Text Widget</strong></a>
72
+ </li>
73
+ <li>
74
  <a href="#mla_views"><strong>Library Views/Post MIME Type Processing</strong></a>
75
  </li>
76
  <li>
345
  </p>
346
  <h4>Link</h4>
347
  <p>
348
+ The Link parameter specifies the target and type of link from the gallery item to the attachment or other destination. You can also specify a non-hyperlink treatment for the item.
349
  </p>
350
+ <table>
351
+ <tr>
352
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">permalink, post</td>
353
+ <td>Link to the attachment's "media page". This is the default value.</td>
354
+ </tr>
355
+ <tr>
356
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">file, full</td>
357
+ <td>Link directly to the attachment file.</td>
358
+ </tr>
359
+ <tr>
360
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">thumbnail,&nbsp;medium,<br />large</td>
361
+ <td>For image attachments, the size of the image file you want to link to.</td>
362
+ </tr>
363
+ <tr>
364
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold; font-style:italic">(other registered size)</td>
365
+ <td>For image attachments, any additional image size that was registered with add_image_size(). If the specified size is not available or if the attachment is not an image, the link will go directly to the attachment file.</td>
366
+ </tr>
367
+ <tr>
368
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">span</td>
369
+ <td>Substitutes a <code>&lt;span&gt;&lt;/span&gt;</code> tag for the hyperlink tag. You can use the "mla_link_attributes" and "mla_link_class" parameters to add attributes to the <code>&lt;span&gt;</code> tag. You can use the "mla_link_text" parameter to customize the text within the span.</td>
370
+ </tr>
371
+ <tr>
372
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">none</td>
373
+ <td>Eliminates the hyperlink tag surrounding the thumbnail image or text. You can use the "mla_link_text" parameter to customize the contents.</td>
374
+ </tr>
375
+ </table>
376
  <p>
377
+ &nbsp;
378
  <a name="include_exclude"></a>
379
  </p>
380
  <h4>Include, Exclude</h4>
524
  </p>
525
  <h4>MLA Gallery Filters and Actions (Hooks)</h4>
526
  <p>
527
+ The <code>[mla_gallery]</code> shortcode supports a comprehensive set of filters and actions that give you complete control over gallery composition from PHP code in your theme or in another plugin. An example of using the hooks from a simple, stand-alone plugin can be found here: <a title="View the Hooks Example source code" href="[+examples_url+]mla-hooks-example.php.txt" target="_blank" style="font-size:14px; font-weight:bold">mla-hooks-example.php.txt</a>. To run the example:
528
  <ol>
529
  <li>Edit the code to, for example, uncomment the <code>error_log()</code> calls so you can see what is passed to the hooks you are interested in.</li>
530
  <li>Remove the ".txt" extension and saving the "mla-hooks-example.php" file in your plugins directory.</li>
542
  <td>called at the beginning of the gallery. You can record/modify shortcode parameter values before (attributes) or after (arguments) they are combined with all the defaults.</td>
543
  </tr>
544
  <tr>
545
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_initial_content</td>
546
+ <td>called just after the <code>mla_gallery_attributes</code> filter, so you can inspect/modify any content enclosed by the <code>[mla_gallery]content[\mla_gallery]</code> "enclosing" shortcode format.</td>
547
+ </tr>
548
+ <tr>
549
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_query_attributes,<br />mla_gallery_query_arguments</td>
550
+ <td>called just before the <code>WP_Query->query()</code> call that selects gallery items, with query parameters before or after they are combined with defaults.</td>
551
  </tr>
552
  <tr>
553
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_wp_query_object</td>
554
  <td>called just after the <code>WP_Query->query()</code> call, so you can inspect/record the results.</td>
555
  </tr>
556
  <tr>
557
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_final_content</td>
558
+ <td>called just after the <code>mla_gallery_wp_query_object</code> filter, so you can inspect/modify any content enclosed by the <code>[mla_gallery]content[\mla_gallery]</code> "enclosing" shortcode format before it is passed to the alternative gallery shortcode.</td>
559
+ </tr>
560
+ <tr>
561
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">use_mla_gallery_style</td>
562
+ <td>allow or suppress the inclusion of CSS styles in the gallery output.</td>
563
  </tr>
564
  <tr>
565
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_style</td>
590
  <td>for manipulating the "Close" part of the Markup template.</td>
591
  </tr>
592
  </table>
593
+ <a name="mla_tag_cloud"></a>
594
+ &nbsp;
595
+ <p>
596
+ <a href="#backtotop">Go to Top</a>
597
+ </p>
598
+ <h3>MLA Tag Cloud Shortcode</h3>
599
+ <p>
600
+ The <code>[mla_tag_cloud]</code> shortcode function displays a list of taxonomy terms in what is called a 'tag cloud', where the size of each term is determined by how many times that particular term has been assigned to Media Library items (attachments). The cloud works with both flat (e.g., Att. Tags) and hierarchical taxonomies (e.g., Att. Categories) MLA Tag Cloud provides many enhancements to the basic "cloud" display. These include:
601
+ </p>
602
+ <ul class="mla_settings">
603
+ <li>Full support for WordPress categories, tags and custom taxonomies. You can select from any taxonomy or list of taxonomies defined in your site.</li>
604
+ <li>Several display formats, including "flat","list" and "grid" (modeled after the <code>[mla_gallery]</code> display).</li>
605
+ <li>Complete support for paginated clouds; display hundreds or thousands of terms in managable groups.</li>
606
+ <li>Control over the styles, markup and content of each cloud using Style and Markup Templates. You can customize the "list" and "grid" formats to suit any need.</li>
607
+ <li>Access to a wide range of content using the term-specific and Field-level Substitution parameters. A powerful Content Template facility lets you assemble content from multiple sources and vary the results depending on which data elements contain non-empty values for a given term.</li>
608
+ <li>Display Style and Display Content parameters for easy customization of the cloud display and the destination of the links behind each term.
609
+ </li>
610
+ <li>A comprehensive set of filters gives you access to each step of the cloud generation process from PHP code in your theme or other plugins.
611
+ </li>
612
+ </ul>
613
+ <p>
614
+ Many of the <code>[mla_tag_cloud]</code> concepts and shortcode parameters are modeled after the <code>[mla_gallery]</code> shortcode, so the learning curve is short. Differences and parameters unique to the cloud are given in the sections below.
615
+ <a name="tag_cloud_output"></a>
616
+ </p>
617
+ <h4>Tag Cloud Output Formats</h4>
618
+ <p>
619
+ The traditional tag cloud output is a "heat map" of term names where larger names are associated with more attachments than smaller names. The terms' display format is determined by the "mla_output" parameter:
620
+ </p>
621
+ <table>
622
+ <tr>
623
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">flat</td>
624
+ <td>Returns a sequence of hypelink tags without further HTML markup. The "separator" parameter content (default, one newline character) is inserted between each hyperlink.</td>
625
+ </tr>
626
+ <tr>
627
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">list</td>
628
+ <td>Returns hyperlinks enclosed by one of the HTML list tags; unordered (&lt;ul&gt;&lt;/ul&gt;), ordered (&lt;ol&gt;&lt;/ol&gt;) or definitions (&lt;dl&gt;&lt;/dl&gt;), which allow for each term to have a "caption". The "itemtag", "termtag" and "captiontag" parameters customize the list markup.</td>
629
+ </tr>
630
+ <tr>
631
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">grid</td>
632
+ <td>Modeled on the galleries produced by <code>[mla_gallery]</code>; a rectangular display with rows and columns. The tag parameters listed above, the "columns" parameter and the Display Style parameters customize the display.</td>
633
+ </tr>
634
+ <tr>
635
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">array</td>
636
+ <td>Returns a PHP array of cloud hyperlinks. This output format is not available through the shortcode; it is allowed when the <code>MLAShortcodes::mla_tag_cloud()</code> function is called directly from your theme or plugin PHP code.</td>
637
+ </tr>
638
+ </table>
639
+ <p>
640
+ The "list" and "grid" formats can be extensively customized by using custom Style and Markup Templates. The <code>[mla_tag_cloud]</code> shortcode also supports pagination with "previous_link", "current_link", "next_link", "previous_page", "next_page" and "paginate_links" formats. These are essentially the same as those for the <code>[mla_gallery]</code> shortcode.
641
+ <a name="tag_cloud_items"></a>
642
+ </p>
643
+ <h4>Tag Cloud Item Parameters</h4>
644
+ <p>
645
+ Each item in the tag cloud comprises a term name of varying size, a hyperlink surrounding the term name and a "title" attribute (Rollover Text) displayed when the cursor hovers over the term name hyperlink. The following parameters customize item content and markup:
646
+ </p>
647
+ <table>
648
+ <tr>
649
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">smallest</td>
650
+ <td>The text size (default 8) of the tag with the smallest count value (units given by unit parameter).</td>
651
+ </tr>
652
+ <tr>
653
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">largest</td>
654
+ <td>The text size (default 22) of the tag with the highest count value (units given by the unit parameter).</td>
655
+ </tr>
656
+ <tr>
657
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">unit</td>
658
+ <td>Unit of measure as pertains to the smallest and largest values. This can be any CSS length value, e.g. pt (the default), px, em, %.</td>
659
+ </tr>
660
+ <tr>
661
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">separator</td>
662
+ <td>The text/space between tags. Default '\n' (whitespace)</td>
663
+ </tr>
664
+ <tr>
665
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">single_text</td>
666
+ <td>The text for the "title" attribute (Rollover Text) when the count value is one. The default is '%d item". If you change the default, don't forget to include the '%d" placeholder.</td>
667
+ </tr>
668
+ <tr>
669
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">multiple_text</td>
670
+ <td>The text for the "title" attribute (Rollover Text) when the count value is zero or more than one. The default is '%d items". If you change the default, don't forget to include the '%d" placeholder.</td>
671
+ </tr>
672
+ <tr>
673
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">link</td>
674
+ <td>Chooses the destination of the item hyperlink; details in the next section below.</td>
675
+ </tr>
676
+ </table>
677
+ <p>
678
+ The Item parameters are an easy way to customize the content and markup for each cloud item. For the list and grid formats you can also use the <a href="#tag_cloud_display_content">Tag Cloud Display Content parameters</a> and/or Style and Markup Templates for even greater flexibility.
679
+ <a name="tag_cloud_link"></a>
680
+ </p>
681
+ <h4>Tag Cloud Item Link</h4>
682
+ <p>
683
+ The Link parameter specifies the target and type of link from the tag cloud term/item to the item's archive page, edit page or other destination. You can also specify a non-hyperlink treatment for each item.
684
+ </p>
685
+ <table>
686
+ <tr>
687
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">view</td>
688
+ <td>Link to the term's "archive page"; this is the default value. Support for archive pages, or "tag archives", is theme-dependent. There is an introduction to tag archives in the WordPress Codex at the bottom of the <a href="http://codex.wordpress.org/Function_Reference/wp_tag_cloud#Creating_a_Tag_Archive" title="Codex Tag Archive Discussion" target="_blank"><code>wp_tag_cloud</code> Function Reference</a>.</td>
689
+ </tr>
690
+ <tr>
691
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">edit</td>
692
+ <td>Link to the term's "edit tag/category" admin screen. This is only useful if the user is logged in and has the appropriate role or capabilities for accessing the edit screen.</td>
693
+ </tr>
694
+ <tr>
695
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold; font-style:italic">(mla_link_href)</td>
696
+ <td>Link to a custom destination, typically another post/page. If the "mla_link_href" parameter is present the value of the "link" parameter is ignored. See the pagination example later in this section for more details.</td>
697
+ </tr>
698
+ <tr>
699
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">span</td>
700
+ <td>Substitutes a <code>&lt;span&gt;&lt;/span&gt;</code> tag for the hyperlink tag. You can use the "mla_link_attributes" and "mla_link_class" parameters to add attributes to the <code>&lt;span&gt;</code> tag. You can use the "mla_link_text" parameter to customize the text within the span.</td>
701
+ </tr>
702
+ <tr>
703
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">none</td>
704
+ <td>Eliminates the hyperlink tag surrounding the item text. You can use the "mla_link_text" parameter to customize the contents.</td>
705
+ </tr>
706
+ </table>
707
+ <p>
708
+ Using the "mla_link_href" parameter to completely replace the link destination URL is a common and useful choice. With this parameter us can use the tag cloud to select a term and then go to another post/page that uses that selection as part of an <code>[mla_gallery]</code> shortcode. The pagination example later in this section uses this technique.
709
+ <a name="tag_cloud_display_style"></a>
710
+ </p>
711
+ <h4>Tag Cloud Display Style (list and grid)</h4>
712
+ <p>
713
+ Two parameters provide a way to apply custom style and markup templates to your <code>[mla_tag_cloud]</code> display. These parameters replace the default style and/or markup templates with templates you define on the "MLA Gallery" tab of the Settings page. Templates are supported for the "list" and "grid" cloud formats.
714
+ </p>
715
+ <table>
716
+ <tr>
717
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_style</td>
718
+ <td>replaces the default style template for an <code>[mla_tag_cloud]</code> shortcode. You can code "none" to suppress the addition of CSS inline styles entirely.</td>
719
+ </tr>
720
+ <tr>
721
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_markup</td>
722
+ <td>replaces the default markup template for an <code>[mla_tag_cloud]</code> shortcode</td>
723
+ </tr>
724
+ </table>
725
+ <p>
726
+ Three parameters provide control over the placement, size and spacing of terms in the "grid" format without requiring the use of custom Style templates.
727
+ </p>
728
+ <table>
729
+ <tr>
730
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_float</td>
731
+ <td>specifies the CSS float attribute of the ".tag-cloud-item" style. Acceptable values are "left", "none", "right"; the default value is "right" if current locale is RTL, "left" on LTR (left-to-right inline flow, e.g., English).</td>
732
+ </tr>
733
+ <tr>
734
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_margin</td>
735
+ <td>specifies the CSS margin property of the ".tag-cloud-item" style. The default value is "1.5%", a percent of the total grid width. You can also specify any dimension value, e.g., "10px" or "2em", as well as the "auto" or "inherit" values. Finally, you can specify "none", which will remove the margin property from the styles template altogether.</td>
736
+ </tr>
737
+ <tr>
738
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_itemwidth</td>
739
+ <td>specifies the CSS width attribute of the ".tag-cloud-item" style. You can specify a percent of the total grid width, e.g., "33.3%". You can also specify any dimension value, e.g., "10px" or "2em", as well as the "auto" or "inherit" values. You can specify "none", which will remove the margin property from the styles template altogether.
740
+ <br />&nbsp;<br />
741
+ Two additional values, "calculate" (the default) and "exact", calculate the width automatically, based on the "columns" and "mla_margin" values. For "calculate", the width is calculated by dividing 100% by the number of columns, then subtracting twice the margin. For example, the default value is (floor(1000/3)/10) - ( 2.0 * 1.5 ) = 30.3%. Adding in the left and right margins makes each column 33.3% and the total width will be 99.9%
742
+ <br />&nbsp;<br />
743
+ For the "exact" value, the calculation is the same but the margin is ignored, so the width value would be 33.3%.</td>
744
+ </tr>
745
+ </table>
746
+ <p>
747
+ The default margin and width calculations try to make the total width of each row as close to 100% as possible, but never exceed 100% due to rounding errors. If you have more advanced style and format needs, you can define custom style and/or markup templates. You can also code <code>mla_style=none</code> to suppress inline styles entirely and use a separate stylesheet to control the format of the grid.
748
+ <a name="tag_cloud_display_content"></a>
749
+ </p>
750
+ <h4>Tag Cloud Display Content</h4>
751
+ <p>
752
+ Eight parameters provide an easy way to control the contents of tag cloud items without requiring the use of custom Markup templates.
753
+ </p>
754
+ <table>
755
+ <tr>
756
+ <tr>
757
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_link_attributes</td>
758
+ <td>adds one or more HTML attributes to the hyperlink for each item; see below</td>
759
+ </tr>
760
+ <tr>
761
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_link_class</td>
762
+ <td><strong>adds</strong> one or more classes to any already defined for the hyperlink </td>
763
+ </tr>
764
+ <tr>
765
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_link_href</td>
766
+ <td>replaces the HTML "href" attribute in the hyperlink for each item; see below</td>
767
+ </tr>
768
+ <tr>
769
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_link_text</td>
770
+ <td>replaces the term name text displayed for each item</td>
771
+ </tr>
772
+ <tr>
773
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_nolink_text</td>
774
+ <td>replaces the empty string displayed when there are no cloud items or no pagination link</td>
775
+ </tr>
776
+ <tr>
777
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_rollover_text</td>
778
+ <td>replaces the HTML "title" attribute in the hyperlink for each item. This is the attachment title text displayed when the mouse rolls or hovers over the term name</td>
779
+ </tr>
780
+ <tr>
781
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_caption</td>
782
+ <td>replaces the caption text displayed beneath each item. The caption appears for "grid" items and for "list" items when the "captiontag" parameter is present.</td>
783
+ </tr>
784
+ <tr>
785
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_target</td>
786
+ <td>adds an HTML "target" attribute to the hyperlink for each gallery item; see below</td>
787
+ </tr>
788
+ <tr>
789
+ </table>
790
+ <p>
791
+ All but the "mla_target" parameter support the <a href="#tag_cloud_markup_parameters">Markup</a>, <a href="#tag_cloud_item_parameters">Item-specific</a>, <a href="#tag_cloud_variable_parameters">Field-level</a> and <a href="#mla_template_parameters">Content Template</a> substitution arguments defined for Markup Templates. For example, if you code "<code>mla_rollover_text='{+slug+} : {+rollover_text+}'</code>, the rollover text will contain the term slug, a colon, and the appropriate "single text" or "multiple text". Simply add "{+" before the substitution parameter name and add "+}" after the name. Note that the enclosing delimiters are different than those used in the templates, since the WordPress shortcode parser reserves square brackets ("[" and "]") for its own use.
792
+ </p>
793
+ <p>
794
+ The "mla_link_href" parameter is a great way to change the destination your cloud item links to and/or add arguments to the link for later processing. For example, to make a gallery item link back to the current page/post you can code: <code>mla_link_href='{+page_url+}'</code>. You can also add arguments to the link, e.g., <code>mla_link_href='{+page_url+}&amp;amp;myarg=myvalue'</code>. Note the use of the HTML entity name "&amp;amp;" to put an ampersand in the value; the WordPress "visual" post editor will replace "&", "<" and ">" with "&amp;amp;", "&amp;lt;" and "&amp;gt;" whether you like it not. The <strong>only</strong> markup parameters modified by this parameter are "link_url" and "thelink". The markup parameters "viewlink" and "editlink" are not modified.
795
+ </p>
796
+ <p>
797
+ The "mla_link_attributes" parameter accepts any value and adds it to the "&lt;a&gt;" or "&lt;span&gt;" tags for the item. For example, you can add a unique identifier to each item by adding <code>mla_link_attributes='id="{+selector}-{+index+}"'</code> to your shortcode (note the use of single quotes around the parameter value and the double quotes within the parameter). <strong>IMPORTANT:</strong> since the shortcode parser reserves square brackets ("[" and "]") for its own use, <strong>you must substitute curly braces for square brackets</strong> if your attributes require brackets. If you must code a curly brace in your attribute value, preface it with <strong>two backslash characters</strong>, e.g., "\\{" or "\\}". If you code an attribute already present in the tag, your value will override the existing value.
798
+ </p>
799
+ <p>
800
+ The "mla_target" parameter accepts any value and adds an HTML "target" attribute to the hyperlink with that value. For example, if you code <code>mla_target="_blank"</code> the item will open in a new window or tab. You can also use "_self", "_parent", "_top" or the "<em>framename</em>" of a named frame.
801
+ <a name="tag_cloud_data_selection"></a>
802
+ </p>
803
+ <h4>Tag Cloud Data Selection Parameters</h4>
804
+ <p>
805
+ The data selection parameters specify which taxonomy (or taxonomies) the terms are taken from, which terms are returned for the cloud and the order in which the terms are returned:
806
+ </p>
807
+ <table>
808
+ <tr>
809
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">taxonomy</td>
810
+ <td>The taxonomy or taxonomies to retrieve terms from. Use the name/slug of each taxonomy, not the display name, e.g., 'post_tag', category', 'attachment_tag', or 'attachment_category'. You can specify multiple taxonomies as a comma-separated string or (if you are calling <code>MLAShortcodes::mla_tag_cloud()</code> function directly from your theme or plugin PHP code) as an array.</td>
811
+ </tr>
812
+ <tr>
813
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">include</td>
814
+ <td>A comma-separated list of term ids (<strong>not</strong> names or slugs) to include. Only the terms in this list that are used in the taxonomies you specified will be retrieved.</td>
815
+ </tr>
816
+ <tr>
817
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">exclude</td>
818
+ <td>A comma-separated list of term ids (<strong>not</strong> names or slugs) to exclude from the returned values.</td>
819
+ </tr>
820
+ <tr>
821
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">parent</td>
822
+ <td>Get direct children of this term (only terms whose explicit parent is this value). If 0 is passed, only top-level terms are returned.</td>
823
+ </tr>
824
+ <tr>
825
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">minimum</td>
826
+ <td>The minimum number of attachments that must be associated with the term for the term to be included. For example, "minimum=1" will omit "empty" terms.</td>
827
+ </tr>
828
+ <tr>
829
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">number</td>
830
+ <td>The maximum number of "most popular" terms to return. The default, zero, returns them all. Terms are sorted by "count DESC, id ASC" to apply this constraint.</td>
831
+ </tr>
832
+ <tr>
833
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">orderby</td>
834
+ <td>The sort order of the retrieved terms. Can be one or more of "count", "id" (term_id), "name" (the default), "none", "random", or "slug".</td>
835
+ </tr>
836
+ <tr>
837
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">order</td>
838
+ <td>Can be "ASC" (ascending, the default) or "DESC" (descending).</td>
839
+ </tr>
840
+ <tr>
841
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">preserve_case</td>
842
+ <td>Preserve upper- and lower-case distinctions when sorting by name. The default, "false", specifies a case-insensitive sort order.</td>
843
+ </tr>
844
+ <tr>
845
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">limit</td>
846
+ <td>The number of terms to return. This parameter is used for pagination; it is applied <strong>after</strong> and separate from the "number" parameter above.</td>
847
+ </tr>
848
+ <tr>
849
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">offset</td>
850
+ <td>The number of terms to skip before returning the results. This parameter is used for pagination.</td>
851
+ </tr>
852
+ </table>
853
+ <p>
854
+ You can sort on more than one value, e.g., <code>orderby="author, date DESC"</code> and you can specify ASC/DESC on a value by value basis. <strong>NOTE: multiple orderby values are separated by commas, not spaces.</strong> This is a change from WP_Query.
855
+ <a name="tag_cloud_debugging_output"></a>
856
+ </p>
857
+ <h4>Debugging Output</h4>
858
+ <p>
859
+ The "mla_debug" parameter controls the display of information about the query parameters and SQL statements used to retrieve tag cloud items. If you code <code>mla_debug=true</code> you will see a lot of information added to the post or page containing the cloud. Of course, this parameter should <strong><em>ONLY</em></strong> be used in a development/debugging environment; it's quite ugly.
860
+ <a name="tag_cloud_substitution"></a>
861
+ </p>
862
+ <h4>Tag Cloud Substitution Parameters</h4>
863
+ <p>
864
+ Style and Markup templates give you great flexibility for the content and format of each [mla_tag_cloud] when you use the "list" and "grid" output formats. You can define as many templates as you need.
865
+ </p>
866
+ <p>
867
+ Style templates provide cloud-specific CSS inline styles (you can code mla_style=none to suppress the addition of CSS inline styles entirely). Markup templates provide the HTML markup for 1) the beginning of the cloud, 2) the beginning of each row ("grid" format), 3) each cloud item, 4) the end of each row ("grid" format) and 5) the end of the cloud. The MLA Gallery tab on the Settings page lets you add, change and delete custom templates. The default templates are also displayed on this tab for easy reference.
868
+ </p>
869
+ <p>
870
+ For the "grid" output format, all of the Markup template sections are used. For the "list" output format, only the "Open", "Item" and "Close" sections are used. There are two default templates for the "list" format; "tag-cloud-ul" and "tag-cloud-dl". As the names imply, the "tag-cloud-dl" default is used when the "captiontag" parameter is present in the shortcode. If you name a custom Markup template in your shortcode, it will be used whether the "captiontag" is present or not.
871
+ </p>
872
+ <p>
873
+ The following <strong>field-level substitution parameters</strong> are available in the Style template and any of the Markup template sections:</p>
874
+ <table>
875
+ <tr>
876
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">request</td>
877
+ <td>The parameters defined in the <code>$_REQUEST</code> array; the "query strings" sent from the browser. The PHP $_REQUEST variable is a superglobal Array that contains the contents of both $_GET, $_POST, and $_COOKIE arrays.</td>
878
+ </tr>
879
+ <tr>
880
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">query</td>
881
+ <td>The parameters defined in the <code>[mla_tag_cloud]</code> shortcode. For example, if your shortcode is <code>[mla gallery taxonomy=attachment_tag div-class=some_class]</code> you can access the parameters as <code>[+query:taxonomy+]</code> and <code>[+query:div-class+]</code> respectively. You can define your own parameters, e.g., "div-class"; they will be accessible as field-level data but will otherwise be ignored.</td>
882
+ <tr>
883
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">template</td>
884
+ <td>A Content Template, which lets you compose a value from multiple substitution parameters and test for empty values, choosing among two or more alternatives or suppressing output entirely. See the <a href="#mla_template_parameters">Content Templates</a> section for details. Note that the formatting option is not supported for content templates.</td>
885
+ </tr>
886
+ </table>
887
+ <p>
888
+ Tag cloud substitution parameters for the <strong>Style template</strong> are:
889
+ </p>
890
+ <table>
891
+ <tr>
892
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_style</td>
893
+ <td>shortcode parameter, default = 'tag-cloud'</td>
894
+ </tr>
895
+ <tr>
896
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_markup</td>
897
+ <td>shortcode parameter, default = 'tag-cloud-ul', or 'tag-cloud-dl' if the "captiontag" parameter is present.</td>
898
+ </tr>
899
+ <tr>
900
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">instance</td>
901
+ <td>starts at '1', incremented for each additional shortcode in the post/page</td>
902
+ </tr>
903
+ <tr>
904
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">taxonomy</td>
905
+ <td>the slug of the taxonomy on which the cloud is based. Multiple taxonomy slugs are joined with a dash to form a single value.</td>
906
+ </tr>
907
+ <tr>
908
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">itemtag</td>
909
+ <td>shortcode parameter, default = 'ul', or 'dl' if the "captiontag" parameter is present.</td>
910
+ </tr>
911
+ <tr>
912
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">termtag</td>
913
+ <td>shortcode parameter, default = 'li', or 'dd' if the "captiontag" parameter is present.</td>
914
+ </tr>
915
+ <tr>
916
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">captiontag</td>
917
+ <td>shortcode parameter, default = '', i.e., no caption tag value.</td>
918
+ </tr>
919
+ <tr>
920
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">columns</td>
921
+ <td>shortcode parameter, default = '3'; only meaningful for the "grid" output format.</td>
922
+ </tr>
923
+ <tr>
924
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">itemwidth</td>
925
+ <td>shortcode parameter, default is calculated by dividing 100% by the number of columns and subtracting twice the margin value, e.g., 30.3% for three columns and a margin value of 1.5%. Can also contain other dimensional values such as '10px' or CSS-specific values like 'auto' or 'inherit'.</td>
926
+ </tr>
927
+ <tr>
928
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">margin</td>
929
+ <td>shortcode parameter, default = '1.5%'. Can also contain other dimensional values such as '10px' or CSS-specific values like 'auto' or 'inherit'.</td>
930
+ </tr>
931
+ <tr>
932
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">float</td>
933
+ <td>'right' if current locale is RTL, 'left' if not</td>
934
+ </tr>
935
+ <tr>
936
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">selector</td>
937
+ <td>"mla_gallery-{$instance}", e.g., mla_gallery-1</td>
938
+ </tr>
939
+ <tr>
940
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">found_rows</td>
941
+ <td>the number of terms retrieved for the cloud</td>
942
+ </tr>
943
+ <tr>
944
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">min_count</td>
945
+ <td>the smallest number of attachments associated with any term</td>
946
+ </tr>
947
+ <tr>
948
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">max_count</td>
949
+ <td>the largest number of attachments associated with any term</td>
950
+ </tr>
951
+ <tr>
952
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">min_scaled_count</td>
953
+ <td>the smallest scaled count associated with any term</td>
954
+ </tr>
955
+ <tr>
956
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">max_scaled_count</td>
957
+ <td>the largest scaled count associated with any term</td>
958
+ </tr>
959
+ <tr>
960
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">spread</td>
961
+ <td>max_scaled_count - min_scaled_count</td>
962
+ </tr>
963
+ <tr>
964
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">smallest</td>
965
+ <td>the text size of the tag with the smallest count value</td>
966
+ </tr>
967
+ <tr>
968
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">largest</td>
969
+ <td>the text size of the tag with the largest count value</td>
970
+ </tr>
971
+ <tr>
972
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">unit</td>
973
+ <td>Unit of measure as pertains to the smallest and largest values</td>
974
+ </tr>
975
+ <tr>
976
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">font_spread</td>
977
+ <td>largest - smallest</td>
978
+ </tr>
979
+ <tr>
980
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">font_step</td>
981
+ <td>font_spread / spread</td>
982
+ </tr>
983
+ <tr>
984
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">separator</td>
985
+ <td>The text/space between tags</td>
986
+ </tr>
987
+ <tr>
988
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">single_text</td>
989
+ <td>Rollover Text when the count value is one</td>
990
+ </tr>
991
+ <tr>
992
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">multiple_text</td>
993
+ <td> Rollover Text when the count value is zero or more than one</td>
994
+ </tr>
995
+ <tr>
996
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">echo</td>
997
+ <td>whether the output is echoed directly to the browser (true) or returned to the caller (false). For a shortcode, always false.</td>
998
+ </tr>
999
+ <tr>
1000
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">link</td>
1001
+ <td>the destination of the item hyperlink</td>
1002
+ </tr>
1003
+ </table>
1004
+ <p>
1005
+ Tag cloud substitution parameters for the <strong>Markup template</strong> are available in all of the template sections. They include all of the parameters defined above (for the Style template). Additional markup-specific parameters are:
1006
+ </p>
1007
+ <table>
1008
+ <tr>
1009
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">site_url</td>
1010
+ <td>absolute URL to the site directory, without trailing slash</td>
1011
+ </tr>
1012
+ <tr>
1013
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">page_ID</td>
1014
+ <td>the ID value of the page or post on which the tag cloud appears, if any.</td>
1015
+ </tr>
1016
+ <tr>
1017
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">page_url</td>
1018
+ <td>absolute URL to the page or post on which the tag cloud appears, if any, with trailing slash</td>
1019
+ </tr>
1020
+ </table>
1021
+ <p>
1022
+ Tag cloud <strong>item-specific substitution parameters</strong> for the Markup template are available in the "Item" section of the template. They include all of the parameters defined above (for the Style and Markup templates) Additional item-specific parameters are:
1023
+ </p>
1024
+ <table>
1025
+ <tr>
1026
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">index</td>
1027
+ <td>starts at '1', incremented for each item in the cloud</td>
1028
+ </tr>
1029
+ <tr>
1030
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">last_in_row</td>
1031
+ <td>for the "grid" output format, set to "last_in_row" for the last item in each full cloud row, and to an empty string for all other items in the row. If the cloud ends with a partial row, the last_in_row parameter is not set.</td>
1032
+ </tr>
1033
+ <tr>
1034
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">key</td>
1035
+ <td>set to the "tags" array key/index value. Only useful if the <code>mla_get_terms_query_results()</code> filter has altered the array keys.</td>
1036
+ </tr>
1037
+ <tr>
1038
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">term_id</td>
1039
+ <td>the term id</td>
1040
+ </tr>
1041
+ <tr>
1042
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">name</td>
1043
+ <td>the term display name</td>
1044
+ </tr>
1045
+ <tr>
1046
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">slug</td>
1047
+ <td>the term slug</td>
1048
+ </tr>
1049
+ <tr>
1050
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">term_group</td>
1051
+ <td>the term group</td>
1052
+ </tr>
1053
+ <tr>
1054
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">term_taxonomy_id</td>
1055
+ <td>the term-taxonomy id</td>
1056
+ </tr>
1057
+ <tr>
1058
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">taxonomy</td>
1059
+ <td>the primary taxonomy for this term</td>
1060
+ </tr>
1061
+ <tr>
1062
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">description</td>
1063
+ <td>the term description, if any</td>
1064
+ </tr>
1065
+ <tr>
1066
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">parent</td>
1067
+ <td>the direct parent of the term</td>
1068
+ </tr>
1069
+ <tr>
1070
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">count</td>
1071
+ <td>the number of attachments associated with the term</td>
1072
+ </tr>
1073
+ <tr>
1074
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">scaled_count</td>
1075
+ <td>scaled count value, for determining font size. The default fomula for scaling the count is <code>round(log10($tag->count + 1) * 100)</code></td>
1076
+ </tr>
1077
+ <tr>
1078
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">font_size</td>
1079
+ <td>the numeric portion of the CSS "font-size" attribute</td>
1080
+ </tr>
1081
+ <tr>
1082
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">link_url</td>
1083
+ <td>the URL portion of "thelink" (below). Derived from editlink_url, termlink_url or mla_link_href.</td>
1084
+ </tr>
1085
+ <tr>
1086
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">editlink_url</td>
1087
+ <td>URL of the term's "edit category/tag" page</td></tr>
1088
+ <tr>
1089
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">termlink_url</td>
1090
+ <td>URL of the term's archive page</td>
1091
+ </tr>
1092
+ <tr>
1093
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">caption</td>
1094
+ <td>if captiontag is not empty, contains term description or the mla_caption value</td>
1095
+ </tr>
1096
+ <tr>
1097
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">link_attributes</td>
1098
+ <td>link attributes, if any, drawn from the mla_target, mla_link_attributes and mla_link_class parameters</td>
1099
+ </tr>
1100
+ <tr>
1101
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">rollover_text</td>
1102
+ <td>the "title" attribute value, drawn from single_text/multiple_text or the mla_rollover_text parameters</td>
1103
+ </tr>
1104
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">link_style</td>
1105
+ <td>the CSS "style" attribute, drawn from the font_size and unit parameters</td>
1106
+ </tr>
1107
+ <tr>
1108
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">link_text</td>
1109
+ <td>the text enclosed by the hyperlink, drawn from the term name or mla_link_text parameter</td>
1110
+ </tr>
1111
+ <tr>
1112
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">editlink</td>
1113
+ <td>full hyperlink to the term's "edit category/tag" page, including all the Display Content parameters</td>
1114
+ </tr>
1115
+ <tr>
1116
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">termlink</td>
1117
+ <td>full hyperlink to the term's archive page, including all the Display Content parameters</td>
1118
+ </tr>
1119
+ <tr>
1120
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">thelink</td>
1121
+ <td>full hyperlink to the chosen destination as determined by the "link" and "mla_link_href" parameters</td>
1122
+ </tr>
1123
+ </table>
1124
+ <p>
1125
+ &nbsp;
1126
+ <a name="tag_cloud_pagination_parameters"></a>
1127
+ </p>
1128
+ <h4>Tag Cloud Pagination Parameters</h4>
1129
+ <p>
1130
+ If you have a large number of terms in your cloud taxonomy you may want to paginate the cloud display, i.e., divide the cloud into two or more pages of a reasonable size. Pagination support for <code>[mla_tag_cloud]</code> is modeled on similar functions for<code>[mla_gallery]</code>, and you can find more explaination of the ideas behind pagination in the <a href="#mla_output"><strong>Support for Alternative Gallery Output, e.g., Pagination</strong></a> section. Five parameters are supplied for this purpose:
1131
+ <table>
1132
+ <tr>
1133
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">limit</td>
1134
+ <td>the maximum number of terms to display in one cloud "page". Think of this as a "terms per page" value.</td>
1135
+ </tr>
1136
+ <tr>
1137
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">offset</td>
1138
+ <td>the number of terms to skip over before starting the current cloud page. This parameter is usually derived automatically from the more useful "mla_cloud_current" parameter.</td>
1139
+ </tr>
1140
+ <tr>
1141
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_page_parameter</td>
1142
+ <td>the name of the parameter containing the current page number; default "mla_cloud_current". You can change the name if you need multiple paginated clouds on one post/page.</td>
1143
+ </tr>
1144
+ <tr>
1145
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_cloud_current</td>
1146
+ <td>the current cloud page number. The name of this parameter can be changed to support multiple paginated clouds on one post/page. This parameter will automatically be added to the URLs generated by pagination output types and managed for you.</td>
1147
+ </tr>
1148
+ <tr>
1149
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">term_id</td>
1150
+ <td>the id of the current term within the cloud. This parameter is used with the "previous_link", "current_link" and "next_link" output types. You <strong>must</strong> supply a term_id value when using these output types.</td>
1151
+ </tr>
1152
+ </table>
1153
+ <p>
1154
+ The <code>[mla_tag_cloud]</code> shortcode can be used to provide "Previous" and "Next" links that support moving among the individual items in a cloud or among cloud "pages". For example, if you have many terms in your Att. Category or Att. Tag taxonomies you can build a term-specific <code>[mla_gallery]</code> page with links to the previous/next term in the taxonomy (a complete pagination example is included below). You can also build a page that shows a large taxonomy in groups, or "cloud pages", of ten terms with links to the previous/next ten terms or links to all of the cloud pages of terms in the taxonomy.
1155
+ <p>
1156
+ The <strong>"mla_output"</strong> parameter determines the type of output the shortcode will return. For pagination output, you can choose from six values:
1157
+ </p>
1158
+ <table>
1159
+ <tr>
1160
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">next_link</td>
1161
+ <td>returns a link to the next cloud item, based on the "term_id" parameter value. The optional "<strong>,wrap</strong>" qualifier determines what happens at the end of the cloud. If you omit the qualifier, an empty string is returned for the "next_link" from the last item. If you code the ",wrap" qualifier, the "next_link" from the last item will be to the first item.</td>
1162
+ </tr>
1163
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">current_link</td>
1164
+ <td>returns a link to the current cloud item, based on the "term_id" parameter value. This gives you an easy way to provide a visual indication of where you are within the taxonomy. The "span" and "none" link formats are often used with this mla_output type.</td>
1165
+ </tr>
1166
+ <tr>
1167
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">previous_link</td>
1168
+ <td>returns a link to the previous cloud item, based on the "term_id" parameter value. The optional "<strong>,wrap</strong>" qualifier determines what happens at the beginning of the cloud. If you omit the qualifier, an empty string is returned for the "previous_link" from the first item. If you code the ",wrap" qualifier, "previous_link" from the gallery item will be to the last item.</td>
1169
+ </tr>
1170
+ <tr>
1171
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">next_page</td>
1172
+ <td>returns a link to the next "page" of cloud items, based on the "mla_cloud_current" parameter value. The optional "<strong>,wrap</strong>" or "<strong>,last</strong>" qualifiers determine what happens at the end of the taxonomy. If you omit the qualifier, an empty string is returned for the "next_page" if there are no more items in the taxonomy. If you code the ",wrap" qualifier, the "next_page" from the last page of items will be to the first page. If you code the ",last" qualifier, the "next_page" link will return to/remain on the last page.</td>
1173
+ </tr>
1174
+ <tr>
1175
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">previous_page</td>
1176
+ <td>returns a link to the previous "page" of cloud items, based on the "mla_cloud_current" parameter value. The optional "<strong>,wrap</strong>" or "<strong>,first</strong>" qualifiers determine what happens at the beginning of the taxonomy. If you omit the qualifier, an empty string is returned for the "previous_link" from the first page. If you code the ",wrap" qualifier, "previous_page" from the first page will be to the last page. If you code the ",first" qualifier, the "previous_link" link will return to/remain on the first page.</td>
1177
+ </tr>
1178
+ <tr>
1179
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">paginate_links</td>
1180
+ <td>returns a link to cloud items at the start and end of the list and to pages around the current "cloud page" ( e.g.: &laquo; Previous 1 ... 3 4 5 6 7 ... 9 Next &raquo; ), based on the "mla_cloud_current" parameter value. The optional "<strong>,show_all</strong>" qualifier will show all of the cloud pages instead of a short list around the current page. The optional "<strong>,prev_next</strong>" qualifier will include the "&laquo; Previous" and "Next &raquo;" portions of the link list.</td>
1181
+ </tr>
1182
+ </table>
1183
+ <p>
1184
+ The best way to understand cloud pagination is by example, as in the next section below.
1185
+ <a name="tag_cloud_pagination_example"></a>
1186
+ </p>
1187
+ <h4>Tag Cloud Pagination Example</h4>
1188
+ <p>
1189
+ This section takes you through several of the <code>[mla_tag_cloud]</code> features, step by step. Let's start with a very simple cloud showing all of the terms in the "Att. Category" taxonomy:
1190
+ </p>
1191
+ <p>
1192
+ <code>[mla_tag_cloud taxonomy=attachment_category number=0]</code>
1193
+ </p>
1194
+ <p>
1195
+ The "number=0" parameter overrides the default maximum of 45 terms, showing all of the terms in the taxonomy. Let's paginate the cloud and limit the terms display to ten terms per "page":
1196
+ </p>
1197
+ <p>
1198
+ <code>[mla_tag_cloud taxonomy=attachment_category number=0 limit=10]<br />
1199
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_output="paginate_links,prev_next"]</code>
1200
+ </p>
1201
+ <p>
1202
+ The "limit=10" parameter (on <strong>both</strong> shortcodes) limits the term display to ten terms. The second <code>[mla_tag_cloud]</code> shortcode, adding the 'mla_output="paginate_links,prev_next"' parameter, displays a line of pagination links below the cloud page. Coordination between the two shortcodes is automatic, using the "mla_cloud_current" parameter added to the URLs by the shortcode.
1203
+ </p>
1204
+ <p>Now we'll make the cloud a convenient way to control a term-specific <code>[mla_gallery]</code>. The next step uses the "mla_link_href" parameter to change the link destination of each cloud term, returning to the current page with the term id of the selected term. We also add the "mla_cloud_current" parameter to each of these new links, so the tag cloud page is retained when a term is selected:
1205
+ </p>
1206
+ <p>
1207
+ <code>[mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_link_href="{+page_url+}?current_id={+term_id+}&amp;amp;mla_cloud_current={+request:mla_cloud_current+}]<br />
1208
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_output="paginate_links,prev_next"]</code>
1209
+ </p>
1210
+ <p>
1211
+ The "&amp;amp;" before the "mla_cloud_current" parameter is required to get by the WordPress Visual Editor. The "{+request:mla_cloud_current+}" value copies the current page number from the URL ($_REQUEST array) and adds it to each term's link. Now, let's use the "current_id={+term_id+}" information in the link to compose a term-specific <code>[mla_gallery]</code>:
1212
+ </p>
1213
+ <p>
1214
+ <code>[mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_link_href="{+page_url+}?current_id={+term_id+}&amp;amp;mla_cloud_current={+request:mla_cloud_current+}]<br />
1215
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_output="paginate_links,prev_next"]
1216
+ <br />&nbsp;<br />
1217
+ [mla_gallery post_mime_type=all tax_query="array ( 0 => array ( 'taxonomy' => 'attachment_category', 'field' => 'id', 'terms' => array( {+request:current_id+} ), 'include_children' => false ) )" mla_caption="{+title+}" columns=5 size=icon link=file]</code>
1218
+ </p>
1219
+ <p>
1220
+ The most complicated part of the new shortcode is the "tax_query" parameter, which we're using to ensure that the gallery items displayed match the count displayed for each term in the tag cloud. The tag cloud count does not contain items associated with any "child terms", or sub-categories, of the cloud item. To match this count we must use the "include_children=false" and "field=id" parameters of the "tax_query".
1221
+ </p>
1222
+ <p>
1223
+ We can easily paginate the term-specific gallery by adding a second <code>[mla_gallery]</code> shortcode and a "posts_per_page" parameter to both shortcodes:
1224
+ </p>
1225
+ <p>
1226
+ <code>[mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_link_href="{+page_url+}?current_id={+term_id+}&amp;amp;mla_cloud_current={+request:mla_cloud_current+}]<br />
1227
+ [mla_tag_cloud taxonomy=attachment_category number=0 limit=10 mla_output="paginate_links,prev_next"]
1228
+ <br />&nbsp;<br />
1229
+ [mla_gallery post_mime_type=all tax_query="array ( 0 => array ( 'taxonomy' => 'attachment_category', 'field' => 'id', 'terms' => array( {+request:current_id+} ), 'include_children' => false ) )" mla_caption="{+title+}" columns=5 posts_per_page=5 size=icon link=file]
1230
+ <br />&nbsp;<br />
1231
+ [mla_gallery post_mime_type=all tax_query="array ( 0 => array ( 'taxonomy' => 'attachment_category', 'field' => 'id', 'terms' => array( {+request:current_id+} ), 'include_children' => false ) )" columns=5 posts_per_page=5 mla_output="paginate_links,prev_next"]</code>
1232
+ </p>
1233
+ <p>
1234
+ The pagination controls for the tag cloud and the gallery operate independently because by default they use different names for their respective "_current" page parameters. Our page now has a lot of functionality without requiring any WordPress templates or PHP code.
1235
+ </p>
1236
+ <p>
1237
+ For extra credit, let's add some more navigation options to the page. We'll build previous, current and next term links at the bottom of the page. These are enclosed in an HTML table so they all appear on one line of the page. Here is just the additional content; the table of three link navigation controls:
1238
+ </p>
1239
+ <p>
1240
+ <code>
1241
+ &lt;table width=99%&gt;&lt;tr&gt;<br />
1242
+ &lt;td width=33% style="text-align: left"&gt;[mla_tag_cloud taxonomy=attachment_category number=0 term_id="{+request:current_id+}" mla_output="previous_link" smallest=12 largest=12 mla_link_href="{+page_url+}?current_id={+term_id+}" mla_link_text="Previous: {+name+}"]&lt;/td&gt;<br />&nbsp;<br />
1243
+ &lt;td width=33% style="text-align: center; font-weight: bold:"&gt;[mla_tag_cloud taxonomy=attachment_category number=0 term_id="{+request:current_id+}" mla_output=current_link smallest=12 largest=12 mla_link_text="Current: {+name+}" link=span]&lt;/td&gt;<br />&nbsp;<br />
1244
+ &lt;td width=33% style="text-align: right"&gt;[mla_tag_cloud taxonomy=attachment_category number=0 term_id="{+request:current_id+}" mla_output="next_link" smallest=12 largest=12 mla_link_href="{+page_url+}?current_id={+term_id+}" mla_link_text="Next: {+name+}"]&lt;/td&gt;<br />
1245
+ &lt;/tr&gt;&lt;/table&gt;
1246
+ </code>
1247
+ </p>
1248
+ <p>
1249
+ The "smallest=12" and "largest=12" parameters make "font-size" the same for all of the term names regardless of how many items are associated with the term. The "mla_link_text" parameters add labels to each of the three navigation links. Finally, the "link=span" parameter in the middle ("mla_output=current_link") shortcode removes the hyperlink behind the term name, since it would just take you back to the page you're already on.
1250
+ <a name="mla_tag_cloud_hooks"></a>
1251
+ </p>
1252
+ <h4>MLA Tag Cloud Filters (Hooks)</h4>
1253
+ <p>
1254
+ The <code>[mla_tag_cloud]</code> shortcode supports a comprehensive set of filters that give you complete control over cloud composition from PHP code in your theme or in another plugin. An example of using the hooks from a simple, stand-alone plugin can be found here: <a title="View the Tag Cloud Hooks Example source code" href="[+examples_url+]mla-cloud-hooks-example.php.txt" target="_blank" style="font-size:14px; font-weight:bold">mla-cloud-hooks-example.php.txt</a>. To run the example:
1255
+ <ol>
1256
+ <li>Edit the code to, for example, uncomment the <code>error_log()</code> calls so you can see what is passed to the hooks you are interested in.</li>
1257
+ <li>Remove the ".txt" extension and save the "mla-cloud-hooks-example.php" file in your plugins directory. You can give the plugin and it file any (unique) name you like.</li>
1258
+ <li>Go to the Plugins/Installed Plugins screen and activate the "MLA Tag Cloud Hooks Example" plugin.</li>
1259
+ <li>Create a new <code>[mla_tag_cloud]</code> shortcode or modify an existing shortcode, adding the <code>my_filter="color cloud"</code> parameter to activate the example output.</li>
1260
+ <li>View the post or page on which the modified shortcode appears to see a tag cloud with a range of colors applied to the terms.</li>
1261
+ </ol>
1262
+ </p>
1263
+ <p>
1264
+ The example code documents each hook with comments in the filter/action function that intercepts each hook. Generally, each part of the gallery supports three hooks: 1) a "<strong>values</strong>" hook, which lets you record or update the substitution values for that gallery part, 2) a "<strong>template</strong>" hook, which lets you record/update the template used to generate the HTML markup, and 3) a "<strong>parse</strong>" hook which lets you modify or replace the markup generated for a gallery part. The current hooks are:
1265
+ </p>
1266
+ <table>
1267
+ <tr>
1268
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_tag_cloud_attributes,<br />mla_tag_cloud_arguments</td>
1269
+ <td>called at the beginning of the cloud generation. You can record/modify shortcode parameter values before (attributes) or after (arguments) they are combined with all the defaults.</td>
1270
+ </tr>
1271
+ <tr>
1272
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_get_terms_query_attributes,<br />mla_get_terms_query_arguments</td>
1273
+ <td>called just before the <code>WP_Query->query()</code> call that selects gallery items, with query parameters before or after they are combined with defaults.</td>
1274
+ </tr>
1275
+ <tr>
1276
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_get_terms_query_results</td>
1277
+ <td>called just after the <code>$wpdb->get_results</code> call, so you can inspect/record or modify the results.</td>
1278
+ </tr>
1279
+ <tr>
1280
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_tag_cloud_scale</td>
1281
+ <td>called as the scaled_count (size) of each term is calculated, so you can modify the results.</td>
1282
+ </tr>
1283
+ <tr>
1284
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">use_mla_tag_cloud_style</td>
1285
+ <td>allow or suppress the inclusion of CSS styles in the tag cloud output.</td>
1286
+ </tr>
1287
+ <tr>
1288
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_tag_cloud_style_values,<br /> mla_tag_cloud_style_template,<br />mla_tag_cloud_style_parse</td>
1289
+ <td>for manipulating the Style template.</td>
1290
+ </tr>
1291
+ <tr>
1292
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_tag_cloud_open_values,<br />mla_tag_cloud_open_template,<br />mla_tag_cloud_open_parse</td>
1293
+ <td>for manipulating the "Open" part of the Markup template used in a "list" or "grid" cloud.</td>
1294
+ </tr>
1295
+ <tr>
1296
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_tag_cloud_row_open_values,<br />mla_tag_cloud_row_open_template,<br />mla_tag_cloud_row_open_parse</td>
1297
+ <td>for manipulating the "Row Open" part of the Markup template used in a "grid" cloud.</td>
1298
+ </tr>
1299
+ <tr>
1300
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_tag_cloud_item_values,<br />mla_tag_cloud_item_template,<br />mla_tag_cloud_item_parse</td>
1301
+ <td>for manipulating the "Item" part of the Markup template used in a "list" or "grid" cloud.</td>
1302
+ </tr>
1303
+ <tr>
1304
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_tag_cloud_row_close_values,<br />mla_tag_cloud_row_close_template,<br />mla_tag_cloud_row_close_parse</td>
1305
+ <td>for manipulating the "Row Close" part of the Markup template used in a "grid" cloud.</td>
1306
+ </tr>
1307
+ <tr>
1308
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_tag_cloud_close_values,<br />mla_tag_cloud_close_template,<br />mla_tag_cloud_close_parse</td>
1309
+ <td>for manipulating the "Close" part of the Markup template used in a "list" or "grid" cloud.</td>
1310
+ </tr>
1311
+ </table>
1312
  <a name="mla_output"></a>
1313
  &nbsp;
1314
  <p>
1316
  </p>
1317
  <h3>Support for Alternative Gallery Output, e.g., Pagination</h3>
1318
  <p>
1319
+ The <code>[mla_gallery]</code> shortcode can be used to provide "Previous" and "Next" links that support moving among the individual items in a gallery or among gallery "pages". For example, if you have many items with a specific Att. Category or Att. Tag value you can build a single-image page with links to the previous/next item having that value. You can also build a page that shows a large gallery in groups, or "gallery pages", of ten items with links to the previous/next ten items or links to all of the gallery pages of items having that value. Finally, you can get a set of links to all pages in the gallery or links around the current page ( e.g.: &laquo; Previous 1 ... 3 4 5 6 7 ... 9 Next &raquo; ).
1320
  </p>
1321
  <h4>The <code>mla_output</code> parameter</h4>
1322
  <p>
1323
+ The <strong>"mla_output"</strong> parameter determines the type of output the shortcode will return. Explanation and examples of each output type are given later in this section. You can choose from seven values:
1324
  </p>
1325
  <table>
1326
  <tr>
1331
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">next_link</td>
1332
  <td>returns a link to the next gallery item. The optional "<strong>,wrap</strong>" qualifier determines what happens at the end of the gallery. If you omit the qualifier, an empty string is returned for the "next_link" from the last item in the gallery. If you code the ",wrap" qualifier, the "next_link" from the last item will be to the first gallery item.</td>
1333
  </tr>
1334
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">current_link</td>
1335
+ <td>returns a link to the current gallery item. This gives you an easy way to provide a visual indication of where you are within the overall gallery. The "span" and "none" link formats are often used with this mla_output type.</td>
1336
+ </tr>
1337
  <tr>
1338
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">previous_link</td>
1339
  <td>returns a link to the previous gallery item. The optional "<strong>,wrap</strong>" qualifier determines what happens at the beginning of the gallery. If you omit the qualifier, an empty string is returned for the "previous_link" from the first gallery item. If you code the ",wrap" qualifier, "previous_link" from the first gallery item will be to the last gallery item.</td>
1348
  </tr>
1349
  <tr>
1350
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">paginate_links</td>
1351
+ <td>returns a link to gallery items at the start and end of the list and to pages around the current "gallery page" ( e.g.: &laquo; Previous 1 ... 3 4 5 6 7 ... 9 Next &raquo; ). The optional "<strong>,show_all</strong>" qualifier will show all of the gallery pages instead of a short list around the current page. The optional "<strong>,prev_next</strong>" qualifier will include the "&laquo; Previous" and "Next &raquo;" portions of the link list.</td>
1352
  </tr>
1353
  </table>
1354
  <h4>Next and previous gallery items; the <code>next_link</code> and <code>previous_link</code> output types</h4>
1454
  </tr>
1455
  <tr>
1456
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_prev_text</td>
1457
+ <td>the "previous page" text (default "&laquo; Previous"); an alternative to "mla_link_text" for <code>mla_output=previous_page</code></td>
1458
  </tr>
1459
  <tr>
1460
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_next_text</td>
1461
+ <td>the "next page" text (default "Next &raquo;") an alternative to "mla_link_text" for <code>mla_output=next_page</code></td>
1462
  </tr>
1463
  <tr>
1464
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_nolink_text</td>
1574
  </tr>
1575
  <tr>
1576
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_prev_text</td>
1577
+ <td>the "previous page" text (default "&laquo; Previous") , which appears when the ",prev_next" qualifier is added to the output_type</td>
1578
  </tr>
1579
  <tr>
1580
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_next_text</td>
1581
+ <td>the "next page" text (default "Next &raquo;") , which appears when the ",prev_next" qualifier is added to the output_type</td>
1582
  </tr>
1583
  <tr>
1584
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_paginate_type</td>
1649
  Photonic recognizes the <code>type=default</code> parameter and takes over, using the other three parameters to format its results. This example is a less convenient but more flexible alternative to the native Photonic support built-in to <code>[mla_gallery]</code> (see next section).
1650
  </p>
1651
  <p>
1652
+ You can also use the "enclosing shortcode" form if the alternate shortcode, such as Fullscreen Galleria's "fsg_link", requires it. You would code this form as:
1653
+ </p>
1654
+ <code>
1655
+ [mla_gallery ids="1,2,3" mla_alt_shortcode=fsg_link mla_alt_ids_name=include class=button]View the gallery[/mla_gallery]
1656
+ </code>
1657
+ <p>If you mix the self-closing and enclosing versions of [mla_gallery] on one post/page you must use the "xhtml-style closing shortcodes like [mla_gallery /]" for the self-closing shortcodes.
1658
+ </p>
1659
+ <p>
1660
  <strong>NOTE:</strong> When you use "mla_alt_shortcode" to pass format/display responsibility off to another shortcode you will lose the <code>[mla_gallery]</code> Gallery Display Style (e.g. "mla_float") and Gallery Display Content (e.g. "mla_caption") parameters. There is no reliable way for <code>[mla_gallery]</code> to pass this information on to the other shortcode you've specified.
1661
  </p>
1662
  <p>
1814
  <td>absolute URL to the site directory, without trailing slash</td>
1815
  </tr>
1816
  <tr>
1817
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">page_ID</td>
1818
+ <td>the ID value of the page or post on which the gallery appears, if any.</td>
1819
+ </tr>
1820
+ <tr>
1821
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">page_url</td>
1822
+ <td>absolute URL to the page or post on which the gallery appears, if any, with trailing slash</td>
1823
+ </tr>
1824
+ <tr>
1825
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">base_url</td>
1826
  <td>absolute URL to the upload directory, without trailing slash</td>
1827
  </tr>
1908
  <td>height in pixels, for image types</td>
1909
  </tr>
1910
  <tr>
1911
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">orientation</td>
1912
+ <td>"portrait" (height > width) or "landscape", for image types; empty for non-image types</td>
1913
+ </tr>
1914
+ <tr>
1915
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">image_meta</td>
1916
  <td>image metadata, for image types</td>
1917
  </tr>
2022
  </tr>
2023
  <tr>
2024
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">query</td>
2025
+ <td>The parameters defined in the <code>[mla_gallery]</code> shortcode. For example, if your shortcode is <code>[mla_gallery attachment_tag=my-tag div-class=some_class]</code> you can access the parameters as <code>[+query:attachment_tag+]</code> and <code>[+query:div-class+]</code> respectively. Only the parameters actually present in the shortcode are accessible; default values for parameters not actually present are not available. You can define your own parameters, e.g., "div-class"; they will be accessible as field-level data but will otherwise be ignored.</td>
2026
  </tr>
2027
  <tr>
2028
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">custom</td>
2070
  </tr>
2071
  <tr>
2072
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">template</td>
2073
+ <td>A Content Template, which lets you compose a value from multiple substitution parameters and test for empty values, choosing among two or more alternatives or suppressing output entirely. See the <a href="#mla_template_parameters">Content Templates</a> section for details. Note that the formatting option is not supported for templates.</td>
2074
  </tr>
2075
  </table>
2076
  <a name="pdf_metadata"></a>
2192
  <code>[+template: Terms: (([+terms:category+], [+terms:post_tag+])|[+ terms: category +]|[+terms:post_tag +]|none)+]</code>
2193
  </p>
2194
  <p>
2195
+ This template has a String, "Terms: " and a Conditional, "(([+terms: ... none)". This Conditional separates the "Terms: " literal from the first alternative in the Choice. Within the Conditional is a Choice having four alternatives. The first alternative is a Conditional, which will be empty unless both categories and tags are present. The second and third alternatives handle the cases where one of the two taxonomies has terms, and the final alternative is used when neither categories nor tags are present.
2196
  </p>
2197
  <h4>Special characters inside templates</h4>
2198
  <p>
2271
  <td><code>&lt;/table&gt;</code></td>
2272
  </tr>
2273
  </table>
2274
+ <a name="mla_text_widget"></a>
2275
  &nbsp;
2276
  <p>
2277
  <a href="#backtotop">Go to Top</a>
2278
  </p>
2279
+ <h3>The MLA Text Widget</h3>
2280
+ <p>
2281
+ The MLA Text Widget lets you add content such as <code>[mla_gallery]</code> and <code>[mla_tag_cloud]</code> displays to your site's sidebars. It is an easy way to add slide shows and navigation features to all your pages. The MLA Text Widget is based on the WordPress Text widget, but adds the ability to include <strong>any</strong> shortcode to widget content. To use the MLA Text Widget:
2282
+ <ol>
2283
+ <li>Go to the Appearance/Widgets Administration screen</li>
2284
+ <li>Open the sidebar, footer, or Theme section to which you wish to add the Text Widget</li>
2285
+ <li>Find the Text Widget in the list of Widgets</li>
2286
+ <li>Click and drag the Widget to the spot you wish it to appear</li>
2287
+ </ol>
2288
+ </p>
2289
+ <p>
2290
+ To open and edit the MLA Text Widget:
2291
+ <ol>
2292
+ <li>Click the down arrow to the right of the MLA Text Widget title</li>
2293
+ <li>Set the MLA Text Widget Title (optional)</li>
2294
+ <li>Add the text or HTML code to the box or edit what is currently there</li>
2295
+ <li>If desired, choose the option to Automatically add paragraphs to wrap each block of text in an HTML paragraph tag</li>
2296
+ <li>Click Save to save the Widget</li>
2297
+ <li>Click Close to close the Widget</li>
2298
+ <li>Switch tabs in your browser and review the results; make changes if necessary</li>
2299
+ </ol>
2300
+ </p>
2301
+ <p>
2302
+ To add an <code>[mla_gallery]</code> or <code>[mla_tag_cloud]</code> shortcode to your widget, simply enter the shortcode name and parameters just as you would in the body of a post or page. Aside from the usually more limited area devoted to displaying the widget content, there are no differences in the way shortcodes are processed in the MLA Widget. Also, there is nothing special about the two MLA shortcodes; <strong>any</strong> shortcode can be added to the MLA Widget.
2303
+ <a name="mla_views"></a>
2304
+ </p>
2305
+ <p>
2306
+ <a href="#backtotop">Go to Top</a>
2307
+ </p>
2308
  <h3>Library Views/Post MIME Type Processing</h3>
2309
  <p>
2310
  WordPress uses <em><strong>Post MIME Types</strong></em> (a terrible name; they have nothing to do with Posts or Pages), to define the views for the Media/Library screen and the Media Manager/Add Media "media items" drop down list. MLA's Media/Assistant screen uses an enhanced version of the list, <em><strong>Table Views</strong></em>, to support views with multiple MIME Types (e.g., "audio,video") and wildcard specifications (e.g. "*/*ms*").
2578
  <td>for image types, height in pixels</td>
2579
  </tr>
2580
  <tr>
2581
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">orientation</td>
2582
+ <td>"portrait" (height > width) or "landscape", for image types; empty for non-image types</td>
2583
+ </tr>
2584
+ <tr>
2585
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">hwstring_small</td>
2586
  <td>HTML dimensions of a "small" image, i.e., 128 or less width, 96 or less height. Not computed for images uploaded in WordPress 3.5 and later.</td>
2587
  </tr>
2869
  <dt>Existing Text</dt>
2870
  <dd>Images already in the Media Library will have non-blank values in many fields and may have existing terms in a taxonomy. You can select "Keep" to retain these values or "Replace" to always map a metadata value into the field. For a taxonomy, "Keep" will retain any terms already assigned to the item and "Replace" will delete any existing terms before assigning metadata values as terms.
2871
  </dd>
2872
+ </dl>
2873
+ <p>
2874
+ The Taxonomy term mapping table has two additional columns:
2875
+ </p>
2876
+ <dl>
2877
+ <dt>Delimiter(s)</dt>
2878
+ <dd>
2879
+ In some cases multiple terms will be contained in a single IPTC or EXIF value. For example, Microsoft Windows stores its "Tags" in a single EXIF value (called Keywords) as a semicolon-delimited list, e.g., "tag1; tag2". You can separate terms encoded in this way by entering one or more delimiter characters in this column.
2880
+ </dd>
2881
  <dt>Parent</dt>
2882
  <dd>For hierarchical taxonomies such as Categories you can select one of the existing terms in the taxonomy as the parent term for any terms you are mapping from metadata values. For example, you could define "IPTC Keywords" as a parent and then assign all of the 2#025 values under that parent term.
2883
  </dd>
tpls/mla-option-templates.tpl CHANGED
@@ -329,6 +329,9 @@
329
  <th scope="col" style="text-align:center">
330
  Existing Text
331
  </th>
 
 
 
332
  <th scope="col" style="text-align:center">
333
  Parent
334
  </th>
@@ -432,6 +435,9 @@
432
  <option [+keep_selected+] value="1">Keep</option>
433
  <option [+replace_selected+] value="">Replace</option>
434
  </select>
 
 
 
435
  </td>
436
  <td style="text-align:left;">
437
  [+parent_select+]
@@ -578,8 +584,8 @@
578
  margin-left: 0;
579
  vertical-align: top;
580
  }
 
581
  </style>
582
- <!-- see mla_gallery_shortcode() in media-library-assistant/includes/class-mla-shortcodes.php -->
583
 
584
  <!-- template="default-open-markup" -->
585
  <div id='[+selector+]' class='gallery galleryid-[+id+] gallery-columns-[+columns+] gallery-size-[+size_class+]'>
@@ -589,7 +595,7 @@
589
 
590
  <!-- template="default-item-markup" -->
591
  <[+itemtag+] class='gallery-item [+last_in_row+]'>
592
- <[+icontag+] class='gallery-icon'>
593
  [+link+]
594
  </[+icontag+]>
595
  <[+captiontag+] class='wp-caption-text gallery-caption'>
@@ -602,3 +608,63 @@
602
 
603
  <!-- template="default-close-markup" -->
604
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
329
  <th scope="col" style="text-align:center">
330
  Existing Text
331
  </th>
332
+ <th scope="col" style="text-align:center">
333
+ Delimiter(s)
334
+ </th>
335
  <th scope="col" style="text-align:center">
336
  Parent
337
  </th>
435
  <option [+keep_selected+] value="1">Keep</option>
436
  <option [+replace_selected+] value="">Replace</option>
437
  </select>
438
+ </td>
439
+ <td style="text-align:center;">
440
+ <input name="iptc_exif_mapping[taxonomy][[+key+]][delimiters]" id="iptc_exif_taxonomy_delimiters_[+key+]" type="text" size="[+delimiters_size+]" value="[+delimiters_text+]" />
441
  </td>
442
  <td style="text-align:left;">
443
  [+parent_select+]
584
  margin-left: 0;
585
  vertical-align: top;
586
  }
587
+ /* see mla_gallery_shortcode() in media-library-assistant/includes/class-mla-shortcodes.php */
588
  </style>
 
589
 
590
  <!-- template="default-open-markup" -->
591
  <div id='[+selector+]' class='gallery galleryid-[+id+] gallery-columns-[+columns+] gallery-size-[+size_class+]'>
595
 
596
  <!-- template="default-item-markup" -->
597
  <[+itemtag+] class='gallery-item [+last_in_row+]'>
598
+ <[+icontag+] class='gallery-icon [+orientation+]'>
599
  [+link+]
600
  </[+icontag+]>
601
  <[+captiontag+] class='wp-caption-text gallery-caption'>
608
 
609
  <!-- template="default-close-markup" -->
610
  </div>
611
+
612
+ <!-- template="tag-cloud-style" -->
613
+ <style type='text/css'>
614
+ #[+selector+] {
615
+ margin: auto;
616
+ width: 100%;
617
+ }
618
+ #[+selector+] .tag-cloud-item {
619
+ float: [+float+];
620
+ margin: [+margin+];
621
+ text-align: center;
622
+ width: [+itemwidth+];
623
+ }
624
+ #[+selector+] .tag-cloud-caption {
625
+ margin-left: 0;
626
+ vertical-align: top;
627
+ }
628
+ /* see mla_tag_cloud() in media-library-assistant/includes/class-mla-shortcodes.php */
629
+ </style>
630
+
631
+ <!-- template="tag-cloud-open-markup" -->
632
+ <div id='[+selector+]' class='tag-cloud tag-cloud-taxonomy-[+taxonomy+] tag-cloud-columns-[+columns+]'>
633
+
634
+ <!-- template="tag-cloud-row-open-markup" -->
635
+ <!-- row-open -->
636
+
637
+ <!-- template="tag-cloud-item-markup" -->
638
+ <[+itemtag+] class='tag-cloud-item [+last_in_row+]'>
639
+ <[+termtag+] class='tag-cloud-term'>
640
+ [+thelink+]
641
+ </[+termtag+]>
642
+ <[+captiontag+] class='wp-caption-text tag-cloud-caption'>
643
+ [+caption+]
644
+ </[+captiontag+]>
645
+ </[+itemtag+]>
646
+
647
+ <!-- template="tag-cloud-row-close-markup" -->
648
+ <br style="clear: both" />
649
+
650
+ <!-- template="tag-cloud-close-markup" -->
651
+ </div>
652
+
653
+ <!-- template="tag-cloud-ul-open-markup" -->
654
+ <[+itemtag+] id='[+selector+]' class='tag-cloud tag-cloud-taxonomy-[+taxonomy+]'>
655
+
656
+ <!-- template="tag-cloud-ul-item-markup" -->
657
+ <[+termtag+] class='tag-cloud-term'>[+thelink+]</[+termtag+]>
658
+
659
+ <!-- template="tag-cloud-ul-close-markup" -->
660
+ </[+itemtag+]>
661
+
662
+ <!-- template="tag-cloud-dl-open-markup" -->
663
+ <[+itemtag+] id='[+selector+]' class='tag-cloud tag-cloud-taxonomy-[+taxonomy+]'>
664
+
665
+ <!-- template="tag-cloud-dl-item-markup" -->
666
+ <[+termtag+] class='tag-cloud-term'>[+thelink+]</[+termtag+]>
667
+ <[+captiontag+] class='wp-caption-text tag-cloud-caption'>[+caption+]</[+captiontag+]>
668
+
669
+ <!-- template="tag-cloud-dl-close-markup" -->
670
+ </[+itemtag+]>