Media Library Assistant - Version 1.51

Version Description

  • New: For [mla_gallery], twenty-five new apply_filters hooks let you modify gallery output with PHP code in your theme or another plugin. More information in the "Other Notes" section here. A complete, working example is provided in the Settings/Media Library Assistant Documentation tab.
  • New: Attachment Metadata mapping. Add or change values in the WordPress _wp_attachment_metadata array. For example, add GPS data to the image_meta array. Full details in the "Other Notes" section and in the Settings/Media Library Assistant Documentation tab.
  • New: GPS Metadata fields added: LatitudeSDM, LatitudeSDD, LongitudeSDM, LongitudeSDD with leading "-" sign for southern and western values.
  • New: A new [mla_gallery] parameter, mla_page_parameter supports multiple paginated galleries on the same post/page.
  • New: On the Media/Assistant submenu, the Description field has been added to the Quick Edit area.
  • New: Support for "searchable category/tag metaboxes" added to the ATTACHMENT DETAILS pane of the Media Manager Modal Window. This feature requires download and activation of the "Media Categories" plugin (by Eddie Moya).
  • New: The [+custom:ALL_CUSTOM+] pseudo value lets you easily display the names and values of all custom fields associated with an item. You can use it in an [mla_gallery] or in a custom field mapping rule.
  • Fix: Media Manager Modal Window support has been re-worked to avoid adding additional parameters to the Attachments object. This improves the handling of "drag & drop" uploading of new Media Library items.
  • Fix: Sorting the Media/Assistant submenu table by a column which no longer exists does not cause database errors. The table sort reverts to the built-in default value. In addition, the dropdown list of sortable columns is now alphabetized.
  • Fix: The "Inserted in" reporting with the "Base" option setting more reliably handles the case where one item filename is a subset of another filename. For example, file "abc.jpg" no longer matches "abcd.jpg".
  • Fix: Handling of empty query: and request: substitution parameters has been restored to the pre-v1.50 logic.
  • Fix: Custom field mapping for fields with array values is more reliably handled.
  • Fix: Test elements in Content Templates returning array results more accurately test for substitution parameters having no value. For example, ([+iptc:2#020,array+][+iptc:2#025,array+]) will be empty unless both of the substitution parameters have values.
Download this release

Release Info

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

Code changes from version 1.50 to 1.51

examples/mla-hooks-example.php.txt ADDED
@@ -0,0 +1,731 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+ /**
3
+ * Provides an example of hooking the filters provided by the [mla_gallery] shortcode
4
+ *
5
+ * In this example, the gallery "caption" is modified to list all of the custom fields
6
+ * populated for each of the items in the gallery. The example documents ALL the filters
7
+ * available in the [mla_gallery] shortcode and illustrates some of the other techniques
8
+ * you can use to customize the gallery display.
9
+ *
10
+ * @package MLA Gallery Hooks Example
11
+ * @version 1.00
12
+ */
13
+
14
+ /*
15
+ 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
23
+
24
+ This program is free software; you can redistribute it and/or modify
25
+ it under the terms of the GNU General Public License as published by
26
+ the Free Software Foundation; either version 2 of the License, or
27
+ (at your option) any later version.
28
+
29
+ This program is distributed in the hope that it will be useful,
30
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
31
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
32
+ GNU General Public License for more details.
33
+
34
+ You can get a copy of the GNU General Public License by writing to the
35
+ Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
36
+ */
37
+
38
+ /**
39
+ * Class MLA Gallery Hooks Example hooks all of the filters provided by the [mla_gallery] shortcode
40
+ *
41
+ * Call it anything you want, but give it an unlikely and hopefully unique name. Hiding enerything
42
+ * else inside a class means this is the only name you have to worry about.
43
+ *
44
+ * @package MLA Gallery Hooks Example
45
+ * @since 1.00
46
+ */
47
+ class MLAGalleryHooksExample {
48
+ /**
49
+ * Initialization function, similar to __construct()
50
+ *
51
+ * @since 1.00
52
+ *
53
+ * @return void
54
+ */
55
+ public static function initialize() {
56
+ /*
57
+ * The filters are only useful for front-end posts/pages; exit if in the admin section
58
+ */
59
+ if ( is_admin() )
60
+ return;
61
+
62
+ /*
63
+ * add_filter parameters:
64
+ * $tag - name of the hook you're filtering; defined by [mla_gallery]
65
+ * $function_to_add - function to be called when [mla_gallery] applies the filter
66
+ * $priority - default 10; lower runs earlier, higher runs later
67
+ * $accepted_args - number of arguments your function accepts
68
+ *
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
+
79
+ add_filter( 'mla_gallery_style_values', 'MLAGalleryHooksExample::mla_gallery_style_values_filter', 10, 1 );
80
+ add_filter( 'mla_gallery_style_template', 'MLAGalleryHooksExample::mla_gallery_style_template_filter', 10, 1 );
81
+ add_filter( 'mla_gallery_style_parse', 'MLAGalleryHooksExample::mla_gallery_style_parse_filter', 10, 3 );
82
+
83
+ add_filter( 'mla_gallery_open_values', 'MLAGalleryHooksExample::mla_gallery_open_values_filter', 10, 1 );
84
+ add_filter( 'mla_gallery_open_template', 'MLAGalleryHooksExample::mla_gallery_open_template_filter', 10, 1 );
85
+ add_filter( 'mla_gallery_open_parse', 'MLAGalleryHooksExample::mla_gallery_open_parse_filter', 10, 3 );
86
+
87
+ add_filter( 'mla_gallery_style', 'MLAGalleryHooksExample::mla_gallery_style_filter', 10, 5 );
88
+
89
+ add_filter( 'mla_gallery_row_open_values', 'MLAGalleryHooksExample::mla_gallery_row_open_values_filter', 10, 1 );
90
+ add_filter( 'mla_gallery_row_open_template', 'MLAGalleryHooksExample::mla_gallery_row_open_template_filter', 10, 1 );
91
+ add_filter( 'mla_gallery_row_open_parse', 'MLAGalleryHooksExample::mla_gallery_row_open_parse_filter', 10, 3 );
92
+
93
+ add_filter( 'mla_gallery_item_values', 'MLAGalleryHooksExample::mla_gallery_item_values_filter', 10, 1 );
94
+ add_filter( 'mla_gallery_item_template', 'MLAGalleryHooksExample::mla_gallery_item_template_filter', 10, 1 );
95
+ add_filter( 'mla_gallery_item_parse', 'MLAGalleryHooksExample::mla_gallery_item_parse_filter', 10, 3 );
96
+
97
+ add_filter( 'mla_gallery_row_close_values', 'MLAGalleryHooksExample::mla_gallery_row_close_values_filter', 10, 1 );
98
+ add_filter( 'mla_gallery_row_close_template', 'MLAGalleryHooksExample::mla_gallery_row_close_template_filter', 10, 1 );
99
+ add_filter( 'mla_gallery_row_close_parse', 'MLAGalleryHooksExample::mla_gallery_row_close_parse_filter', 10, 3 );
100
+
101
+ add_filter( 'mla_gallery_close_values', 'MLAGalleryHooksExample::mla_gallery_close_values_filter', 10, 1 );
102
+ add_filter( 'mla_gallery_close_template', 'MLAGalleryHooksExample::mla_gallery_close_template_filter', 10, 1 );
103
+ add_filter( 'mla_gallery_close_parse', 'MLAGalleryHooksExample::mla_gallery_close_parse_filter', 10, 3 );
104
+ }
105
+
106
+ /**
107
+ * Save the shortcode attributes
108
+ *
109
+ * @since 1.00
110
+ *
111
+ * @var array
112
+ */
113
+ private static $shortcode_attributes = array();
114
+
115
+ /**
116
+ * MLA Gallery (Display) Attributes
117
+ *
118
+ * This filter gives you an opportunity to record or modify the arguments passed in to the shortcode
119
+ * before they are merged with the default arguments used for the gallery display.
120
+ *
121
+ * The $shortcode_attributes array is where you will find any of your own parameters that are coded in the
122
+ * shortcode, e.g., [mla_gallery my_parameter="my value"].
123
+ *
124
+ * @since 1.00
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_gallery_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( 'MLAGalleryHooksExample::mla_gallery_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
+ return $shortcode_attributes;
142
+ } // mla_gallery_attributes_filter
143
+
144
+ /**
145
+ * Save the shortcode arguments
146
+ *
147
+ * @since 1.00
148
+ *
149
+ * @var array
150
+ */
151
+ private static $all_display_parameters = array();
152
+
153
+ /**
154
+ * MLA Gallery (Display) Arguments
155
+ *
156
+ * This filter gives you an opportunity to record or modify the gallery display arguments
157
+ * after the shortcode attributes are merged with the default arguments.
158
+ *
159
+ * Note that the values in this array are input or default values, not the final computed values
160
+ * used for the gallery display. The computed values are in the $style_values, $markup_values and
161
+ * $item_values arrays passed to later filters below.
162
+ *
163
+ * @since 1.00
164
+ *
165
+ * @param array shortcode arguments merged with gallery display defaults, so every possible parameter is present
166
+ *
167
+ * @return array updated gallery display arguments
168
+ */
169
+ public static function mla_gallery_arguments_filter( $all_display_parameters ) {
170
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_arguments_filter $all_display_parameters = ' . var_export( $all_display_parameters, true ), 0 );
171
+
172
+ self::$all_display_parameters = $all_display_parameters;
173
+ return $all_display_parameters;
174
+ } // mla_gallery_arguments_filter
175
+
176
+ /**
177
+ * Save the query attributes
178
+ *
179
+ * @since 1.00
180
+ *
181
+ * @var array
182
+ */
183
+ private static $query_attributes = array();
184
+
185
+ /**
186
+ * MLA Gallery Query Attributes
187
+ *
188
+ * This filter gives you an opportunity to record or modify the arguments passed in to the shortcode
189
+ * before they are merged with the default arguments used to select the attachments for the gallery.
190
+ *
191
+ * The query attributes passed in to this filter are the same as those passed through the
192
+ * "MLA Gallery (Display) Attributes" filter above. This filter is provided so you can modify
193
+ * the data selection attributes without disturbing the attributes used for gallery display.
194
+ *
195
+ * @since 1.00
196
+ *
197
+ * @param array the shortcode parameters passed in to the shortcode
198
+ *
199
+ * @return array updated shortcode attributes
200
+ */
201
+ public static function mla_gallery_query_attributes_filter( $query_attributes ) {
202
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_query_attributes_filter $query_attributes = ' . var_export( $query_attributes, true ), 0 );
203
+
204
+ self::$query_attributes = $query_attributes;
205
+ return $query_attributes;
206
+ } // mla_gallery_query_attributes_filter
207
+
208
+ /**
209
+ * Save the query arguments
210
+ *
211
+ * @since 1.00
212
+ *
213
+ * @var array
214
+ */
215
+ private static $all_query_parameters = array();
216
+
217
+ /**
218
+ * MLA Gallery Query Arguments
219
+ *
220
+ * This filter gives you an opportunity to record or modify the attachment query arguments
221
+ * after the shortcode attributes are merged with the default arguments.
222
+ *
223
+ * @since 1.00
224
+ *
225
+ * @param array shortcode arguments merged with attachment selection defaults, so every possible parameter is present
226
+ *
227
+ * @return array updated attachment query arguments
228
+ */
229
+ public static function mla_gallery_query_arguments_filter( $all_query_parameters ) {
230
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_query_arguments_filter $all_query_parameters = ' . var_export( $all_query_parameters, true ), 0 );
231
+
232
+ self::$all_query_parameters = $all_query_parameters;
233
+ return $all_query_parameters;
234
+ } // mla_gallery_query_arguments_filter
235
+
236
+ /**
237
+ * Save some of the WP_Query object properties
238
+ *
239
+ * @since 1.00
240
+ *
241
+ * @var array
242
+ */
243
+ private static $wp_query_properties = array();
244
+
245
+ /**
246
+ * MLA Gallery WP Query Object
247
+ *
248
+ * This action gives you an opportunity (read-only) to record anything you need from the WP_Query object used
249
+ * to select the attachments for gallery display. This is the ONLY point at which the WP_Query object is defined.
250
+ *
251
+ * @since 1.00
252
+ * @uses MLAShortcodes::$mla_gallery_wp_query_object
253
+ *
254
+ * @param array query arguments passed to WP_Query->query
255
+ *
256
+ * @return void actions never return anything
257
+ */
258
+ public static function mla_gallery_wp_query_object_action( $query_arguments ) {
259
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_wp_query_object_action $query_arguments = ' . var_export( $query_arguments, true ), 0 );
260
+
261
+ self::$wp_query_properties = array();
262
+ self::$wp_query_properties ['request'] = MLAShortcodes::$mla_gallery_wp_query_object->request;
263
+ self::$wp_query_properties ['query_vars'] = MLAShortcodes::$mla_gallery_wp_query_object->query_vars;
264
+ self::$wp_query_properties ['post_count'] = MLAShortcodes::$mla_gallery_wp_query_object->post_count;
265
+
266
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_wp_query_object_action self::$wp_query_properties = ' . var_export( self::$wp_query_properties, true ), 0 );
267
+
268
+ /*
269
+ * Unlike Filters, Actions never return anything
270
+ */
271
+ return;
272
+ } // mla_gallery_wp_query_object_action
273
+
274
+ /**
275
+ * Use MLA Gallery Style
276
+ *
277
+ * You can use this filter to allow or suppress the inclusion of CSS styles in the
278
+ * gallery output. Return 'true' to allow the styles, false to suppress them. You can also
279
+ * suppress styles by returning an empty string from the mla_gallery_style_parse_filter below.
280
+ *
281
+ * @since 1.00
282
+ *
283
+ * @param boolean true unless the mla_style parameter is "none"
284
+ * @param string value of the mla_style parameter
285
+ *
286
+ * @return boolean true to fetch and parse the style template, false to leave it empty
287
+ */
288
+ public static function use_mla_gallery_style_filter( $use_style_template, $style_template_name ) {
289
+ //error_log( 'MLAGalleryHooksExample::use_mla_gallery_style_filter $use_style_template = ' . var_export( $use_style_template, true ), 0 );
290
+ //error_log( 'MLAGalleryHooksExample::use_mla_gallery_style_filter $style_template_name = ' . var_export( $style_template_name, true ), 0 );
291
+
292
+ /*
293
+ * Filters must return the first argument passed in, unchanged or updated
294
+ */
295
+ return $use_style_template;
296
+ } // use_mla_gallery_style_filter
297
+
298
+ /**
299
+ * MLA Gallery Style Values
300
+ *
301
+ * The "Values" series of filters gives you a chance to modify the substitution parameter values
302
+ * before they are used to complete the associated template (in the corresponding "Parse" filter).
303
+ * It is called just before the values are used to parse the associated template.
304
+ * You can add, change or delete parameters as needed.
305
+ *
306
+ * @since 1.00
307
+ *
308
+ * @param array parameter_name => parameter_value pairs
309
+ *
310
+ * @return array updated substitution parameter name => value pairs
311
+ */
312
+ public static function mla_gallery_style_values_filter( $style_values ) {
313
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_values_filter $style_values = ' . var_export( $style_values, true ), 0 );
314
+
315
+ /*
316
+ * You also have access to the PHP Super Globals, e.g., $_REQUEST, $_SERVER
317
+ */
318
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_values_filter $_REQUEST = ' . var_export( $_REQUEST, true ), 0 );
319
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_values_filter $_SERVER[ REQUEST_URI ] = ' . var_export( $_SERVER['REQUEST_URI'], true ), 0 );
320
+
321
+ /*
322
+ * You can use the WordPress globals like $wp_query, $wpdb and $table_prefix as well.
323
+ * Note that $wp_query contains values for the post/page query, NOT the [mla_gallery] query.
324
+ */
325
+ global $wp_query;
326
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_values_filter $wp_query->query = ' . var_export( $wp_query->query, true ), 0 );
327
+
328
+ return $style_values;
329
+ } // mla_gallery_style_values_filter
330
+
331
+ /**
332
+ * MLA Gallery Style Template
333
+ *
334
+ * The "Template" series of filters gives you a chance to modify the template value before
335
+ * it is used to generate the HTML markup (in the corresponding "Parse" filter).
336
+ * It is called just before the template is used to generate the markup.
337
+ * You can modify the template as needed.
338
+ *
339
+ * @since 1.00
340
+ *
341
+ * @param string template used to generate the HTML markup
342
+ *
343
+ * @return string updated template
344
+ */
345
+ public static function mla_gallery_style_template_filter( $style_template ) {
346
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_template_filter $style_template = ' . var_export( $style_template, true ), 0 );
347
+
348
+ return $style_template;
349
+ } // mla_gallery_style_template_filter
350
+
351
+ /**
352
+ * MLA Gallery Style Parse
353
+ *
354
+ * The "Parse" series of filters gives you a chance to modify or replace the HTML markup
355
+ * that will be added to the [mla_gallery] output. It is called just after the values array
356
+ * (updated in the corresponding "Values" filter) is combined (parsed) with the template.
357
+ * You can modify the HTML markup already prepared or start over with the template and the
358
+ * substitution values.
359
+ *
360
+ * @since 1.00
361
+ *
362
+ * @param string HTML markup returned by the template parser
363
+ * @param string template used to generate the HTML markup
364
+ * @param array parameter_name => parameter_value pairs
365
+ *
366
+ * @return array updated HTML markup for gallery output
367
+ */
368
+ public static function mla_gallery_style_parse_filter( $html_markup, $style_template, $style_values ) {
369
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
370
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_parse_filter $style_template = ' . var_export( $style_template, true ), 0 );
371
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_parse_filter $style_values = ' . var_export( $style_values, true ), 0 );
372
+
373
+ return $html_markup;
374
+ } // mla_gallery_style_parse_filter
375
+
376
+ /**
377
+ * MLA Gallery Open Values
378
+ *
379
+ * Note: The $markup_values array is shared among the open, row open, row close and close functions.
380
+ * It is also used to initialize the $item_values array.
381
+ *
382
+ * @since 1.00
383
+ *
384
+ * @param array parameter_name => parameter_value pairs
385
+ *
386
+ * @return array updated substitution parameter name => value pairs
387
+ */
388
+ public static function mla_gallery_open_values_filter( $markup_values ) {
389
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_open_values_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
390
+
391
+ return $markup_values;
392
+ } // mla_gallery_open_values_filter
393
+
394
+ /**
395
+ * MLA Gallery Open Template
396
+ *
397
+ * @since 1.00
398
+ *
399
+ * @param string template used to generate the HTML markup
400
+ *
401
+ * @return string updated template
402
+ */
403
+ public static function mla_gallery_open_template_filter( $open_template ) {
404
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_open_template_filter $open_template = ' . var_export( $open_template, true ), 0 );
405
+
406
+ return $open_template;
407
+ } // mla_gallery_open_template_filter
408
+
409
+ /**
410
+ * MLA Gallery Open Parse
411
+ *
412
+ * @since 1.00
413
+ *
414
+ * @param string HTML markup returned by the template parser
415
+ * @param string template used to generate the HTML markup
416
+ * @param array parameter_name => parameter_value pairs
417
+ *
418
+ * @return array updated HTML markup for gallery output
419
+ */
420
+ public static function mla_gallery_open_parse_filter( $html_markup, $open_template, $markup_values ) {
421
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_open_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
422
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_open_parse_filter $open_template = ' . var_export( $open_template, true ), 0 );
423
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_open_parse_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
424
+
425
+ return $html_markup;
426
+ } // mla_gallery_open_parse_filter
427
+
428
+ /**
429
+ * MLA Gallery Style
430
+ *
431
+ * This is an old filter retained for compatibility with earlier MLA versions.
432
+ * You will probably find the "Values" and "Parse" filters more useful.
433
+ *
434
+ * @since 1.00
435
+ *
436
+ * @param string HTML markup for "gallery style" and "gallery open", combined
437
+ * @param array parameter_name => parameter_value pairs for gallery style
438
+ * @param array parameter_name => parameter_value pairs for gallery open
439
+ * @param string template used to generate the HTML markup for gallery style
440
+ * @param string template used to generate the HTML markup for gallery open
441
+ *
442
+ * @return array updated HTML markup for "gallery style" and "gallery open" output
443
+ */
444
+ public static function mla_gallery_style_filter( $html_markup, $style_values, $open_values, $style_template, $open_template ) {
445
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
446
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_filter $style_values = ' . var_export( $style_values, true ), 0 );
447
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_filter $open_values = ' . var_export( $open_values, true ), 0 );
448
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_filter $style_template = ' . var_export( $style_template, true ), 0 );
449
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_style_filter $open_template = ' . var_export( $open_template, true ), 0 );
450
+
451
+ return $html_markup;
452
+ } // mla_gallery_style_filter
453
+
454
+ /**
455
+ * MLA Gallery Row Open Values
456
+ *
457
+ * @since 1.00
458
+ *
459
+ * @param array parameter_name => parameter_value pairs
460
+ *
461
+ * @return array updated substitution parameter name => value pairs
462
+ */
463
+ public static function mla_gallery_row_open_values_filter( $markup_values ) {
464
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_row_open_values_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
465
+
466
+ return $markup_values;
467
+ } // mla_gallery_row_open_values_filter
468
+
469
+ /**
470
+ * MLA Gallery Row Open Template
471
+ *
472
+ * @since 1.00
473
+ *
474
+ * @param string template used to generate the HTML markup
475
+ *
476
+ * @return string updated template
477
+ */
478
+ public static function mla_gallery_row_open_template_filter( $row_open_template ) {
479
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_row_open_template_filter $row_open_template = ' . var_export( $row_open_template, true ), 0 );
480
+
481
+ return $row_open_template;
482
+ } // mla_gallery_row_open_template_filter
483
+
484
+ /**
485
+ * MLA Gallery Row Open Parse
486
+ *
487
+ * @since 1.00
488
+ *
489
+ * @param string HTML markup returned by the template parser
490
+ * @param string template used to generate the HTML markup
491
+ * @param array parameter_name => parameter_value pairs
492
+ *
493
+ * @return array updated HTML markup for gallery output
494
+ */
495
+ public static function mla_gallery_row_open_parse_filter( $html_markup, $row_open_template, $markup_values ) {
496
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_row_open_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
497
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_row_open_parse_filter $row_open_template = ' . var_export( $row_open_template, true ), 0 );
498
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_row_open_parse_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
499
+
500
+ return $html_markup;
501
+ } // mla_gallery_row_open_parse_filter
502
+
503
+ /**
504
+ * MLA Gallery Item Values
505
+ *
506
+ * @since 1.00
507
+ *
508
+ * @param array parameter_name => parameter_value pairs
509
+ *
510
+ * @return array updated substitution parameter name => value pairs
511
+ */
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
518
+ * own to do this on a gallery-by-gallery basis, leaving other [mla_gallery] instances untouched.
519
+ */
520
+ if ( ! isset( self::$shortcode_attributes['my_filter'] ) || 'all custom' != self::$shortcode_attributes['my_filter'] )
521
+ return $item_values; // leave them unchanged
522
+
523
+ /*
524
+ * Preserve the existing caption, if present
525
+ */
526
+ $my_caption = '';
527
+ if ( ! empty( $item_values['caption'] ) )
528
+ $my_caption .= $item_values['caption'] . "<br />\r\n";
529
+
530
+ /*
531
+ * Retrieve the custom fields for this item, if any,
532
+ * and extract the values we are interested in.
533
+ */
534
+ $custom_fields = array();
535
+ $post_meta = get_metadata( 'post', $item_values['attachment_ID'] );
536
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_item_values_filter $post_meta = ' . var_export( $post_meta, true ), 0 );
537
+
538
+ if ( is_array( $post_meta ) ) {
539
+ foreach ( $post_meta as $post_meta_key => $post_meta_value ) {
540
+ if ( empty( $post_meta_key ) )
541
+ continue;
542
+
543
+ /*
544
+ * WordPress stores several of its own values as custom fields, which we will skip.
545
+ * Some of the values you might find useful are:
546
+ * _wp_attached_file, _wp_attachment_metadata, and _wp_attachment_image_alt
547
+ */
548
+ if ( '_' == $post_meta_key{0} )
549
+ continue;
550
+
551
+ /*
552
+ * At this point, every value is an array; one element per instance of the key.
553
+ * We'll test anyway, just to be sure, then convert single-instance values to a scalar.
554
+ * Metadata array values are serialized for storage in the database, so we might have to
555
+ * unserialize them before processing them as an array.
556
+ */
557
+ if ( is_array( $post_meta_value ) ) {
558
+ if ( count( $post_meta_value ) == 1 )
559
+ $post_meta_value = maybe_unserialize( $post_meta_value[0] );
560
+ else
561
+ foreach ( $post_meta_value as $single_key => $single_value )
562
+ $post_meta_value[ $single_key ] = maybe_unserialize( $single_value );
563
+ }
564
+
565
+ $custom_fields[ $post_meta_key ] = $post_meta_value;
566
+ } // foreach $post_meta
567
+ }
568
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_item_values_filter $custom_fields = ' . var_export( $custom_fields, true ), 0 );
569
+
570
+ /*
571
+ * Don't alter the caption if there are no custom fields to display
572
+ */
573
+ if ( empty( $custom_fields ) )
574
+ return $item_values;
575
+
576
+ /*
577
+ * Add the definition list to the caption
578
+ */
579
+ $my_caption .= "<dl class=\"custom_field\">\r\n";
580
+ foreach ( $custom_fields as $key => $value ) {
581
+ $my_caption .= "<dt class=\"name\">{$key}</dt>\r\n";
582
+ $my_caption .= "<dd class=\"value\">{$value}</dd>\r\n";
583
+ } // foreach custom field
584
+ $my_caption .= "</dl>";
585
+
586
+ /*
587
+ * Update the $item_values and pass them back from the filter.
588
+ */
589
+ $item_values['caption'] = $my_caption;
590
+ return $item_values;
591
+ } // mla_gallery_item_values_filter
592
+
593
+ /**
594
+ * MLA Gallery Item Template
595
+ *
596
+ * @since 1.00
597
+ *
598
+ * @param string template used to generate the HTML markup
599
+ *
600
+ * @return string updated template
601
+ */
602
+ public static function mla_gallery_item_template_filter( $item_template ) {
603
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_item_template_filter $item_template = ' . var_export( $item_template, true ), 0 );
604
+
605
+ return $item_template;
606
+ } // mla_gallery_item_template_filter
607
+
608
+ /**
609
+ * MLA Gallery Item Parse
610
+ *
611
+ * @since 1.00
612
+ *
613
+ * @param string HTML markup returned by the template parser
614
+ * @param string template used to generate the HTML markup
615
+ * @param array parameter_name => parameter_value pairs
616
+ *
617
+ * @return array updated HTML markup for gallery output
618
+ */
619
+ public static function mla_gallery_item_parse_filter( $html_markup, $item_template, $item_values ) {
620
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_item_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
621
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_item_parse_filter $item_template = ' . var_export( $item_template, true ), 0 );
622
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_item_parse_filter $item_values = ' . var_export( $item_values, true ), 0 );
623
+
624
+ return $html_markup;
625
+ } // mla_gallery_item_parse_filter
626
+
627
+ /**
628
+ * MLA Gallery Row Close Values
629
+ *
630
+ * @since 1.00
631
+ *
632
+ * @param array parameter_name => parameter_value pairs
633
+ *
634
+ * @return array updated substitution parameter name => value pairs
635
+ */
636
+ public static function mla_gallery_row_close_values_filter( $markup_values ) {
637
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_row_close_values_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
638
+
639
+ return $markup_values;
640
+ } // mla_gallery_row_close_values_filter
641
+
642
+ /**
643
+ * MLA Gallery Row Close Template
644
+ *
645
+ * @since 1.00
646
+ *
647
+ * @param string template used to generate the HTML markup
648
+ *
649
+ * @return string updated template
650
+ */
651
+ public static function mla_gallery_row_close_template_filter( $row_close_template ) {
652
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_row_close_template_filter $row_close_template = ' . var_export( $row_close_template, true ), 0 );
653
+
654
+ return $row_close_template;
655
+ } // mla_gallery_row_close_template_filter
656
+
657
+ /**
658
+ * MLA Gallery Row Close Parse
659
+ *
660
+ * @since 1.00
661
+ *
662
+ * @param string HTML markup returned by the template parser
663
+ * @param string template used to generate the HTML markup
664
+ * @param array parameter_name => parameter_value pairs
665
+ *
666
+ * @return array updated HTML markup for gallery output
667
+ */
668
+ public static function mla_gallery_row_close_parse_filter( $html_markup, $row_close_template, $markup_values ) {
669
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_row_close_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
670
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_row_close_parse_filter $row_close_template = ' . var_export( $row_close_template, true ), 0 );
671
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_row_close_parse_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
672
+
673
+ return $html_markup;
674
+ } // mla_gallery_row_close_parse_filter
675
+
676
+ /**
677
+ * MLA Gallery Close Values
678
+ *
679
+ * @since 1.00
680
+ *
681
+ * @param array parameter_name => parameter_value pairs
682
+ *
683
+ * @return array updated substitution parameter name => value pairs
684
+ */
685
+ public static function mla_gallery_close_values_filter( $markup_values ) {
686
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_close_values_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
687
+
688
+ return $markup_values;
689
+ } // mla_gallery_close_values_filter
690
+
691
+ /**
692
+ * MLA Gallery Close Template
693
+ *
694
+ * @since 1.00
695
+ *
696
+ * @param string template used to generate the HTML markup
697
+ *
698
+ * @return string updated template
699
+ */
700
+ public static function mla_gallery_close_template_filter( $close_template ) {
701
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_close_template_filter $close_template = ' . var_export( $close_template, true ), 0 );
702
+
703
+ return $close_template;
704
+ } // mla_gallery_close_template_filter
705
+
706
+ /**
707
+ * MLA Gallery Close Parse
708
+ *
709
+ * @since 1.00
710
+ *
711
+ * @param string HTML markup returned by the template parser
712
+ * @param string template used to generate the HTML markup
713
+ * @param array parameter_name => parameter_value pairs
714
+ *
715
+ * @return array updated HTML markup for gallery output
716
+ */
717
+ public static function mla_gallery_close_parse_filter( $html_markup, $close_template, $markup_values ) {
718
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_close_parse_filter $html_markup = ' . var_export( $html_markup, true ), 0 );
719
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_close_parse_filter $close_template = ' . var_export( $close_template, true ), 0 );
720
+ //error_log( 'MLAGalleryHooksExample::mla_gallery_close_parse_filter $markup_values = ' . var_export( $markup_values, true ), 0 );
721
+
722
+ return $html_markup;
723
+ } // mla_gallery_close_parse_filter
724
+
725
+ } // Class MLAGalleryHooksExample
726
+
727
+ /*
728
+ * Install the filters at an early opportunity
729
+ */
730
+ add_action('init', 'MLAGalleryHooksExample::initialize');
731
+ ?>
includes/class-mla-data.php CHANGED
@@ -152,7 +152,7 @@ class MLAData {
152
  *
153
  * @since 1.50
154
  *
155
- * @param string A string possibily starting with '[+template:'
156
  *
157
  * @return string '' or template string starting with '[+template:' and ending with the matching '+]'
158
  */
@@ -253,13 +253,19 @@ class MLAData {
253
  }
254
  elseif ( is_array( $element ) ) {
255
  foreach ($element as $key => $value ) {
256
- if ( is_scalar( $value ) ) {
257
  $value = trim( $value );
258
- if ( ! empty( $value ) )
259
- $final[] = $value;
260
- }
261
  elseif ( ! empty( $value ) )
262
- $final[] = var_export( $value, true );
 
 
 
 
 
 
 
 
 
263
  }
264
  }
265
  elseif ( ! empty( $element ) )
@@ -331,7 +337,7 @@ class MLAData {
331
  *
332
  * @since 1.50
333
  *
334
- * @param string A string possibily starting with '('
335
  *
336
  * @return string '' or template string starting with '(' and ending with the matching ')'
337
  */
@@ -555,11 +561,18 @@ class MLAData {
555
  }
556
  } // array of nodes
557
 
558
- foreach ($result as $value )
559
- if ( is_scalar( $value ) && false !== strpos( $value, '[+' ) ) {
560
  $result = array();
561
  break;
562
  }
 
 
 
 
 
 
 
563
 
564
  break;
565
  case 'choice':
@@ -778,11 +791,15 @@ class MLAData {
778
  case 'query':
779
  if ( isset( $query ) && isset( $query[ $value['value'] ] ) )
780
  $markup_values[ $key ] = $query[ $value['value'] ];
 
 
781
 
782
  break;
783
  case 'request':
784
  if ( isset( $_REQUEST[ $value['value'] ] ) )
785
  $markup_values[ $key ] = $_REQUEST[ $value['value'] ];
 
 
786
 
787
  break;
788
  case 'terms':
@@ -810,8 +827,34 @@ class MLAData {
810
  $markup_values[ $key ] = $text;
811
  break;
812
  case 'custom':
813
- if ( 0 < $post_id )
814
  $record = get_metadata( 'post', $post_id, $value['value'], 'single' == $value['option'] );
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
815
  else
816
  break;
817
 
@@ -1112,9 +1155,27 @@ class MLAData {
1112
  return null;
1113
  }
1114
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1115
  $clean_request = array (
1116
  'm' => 0,
1117
- 'orderby' => MLAOptions::mla_get_option( MLAOptions::MLA_DEFAULT_ORDERBY ),
1118
  'order' => MLAOptions::mla_get_option( MLAOptions::MLA_DEFAULT_ORDER ),
1119
  'post_type' => 'attachment',
1120
  'post_status' => 'inherit',
@@ -1284,7 +1345,7 @@ class MLAData {
1284
  self::$query_parameters['postmeta_key'] = '_wp_attachment_image_alt';
1285
  } // !empty
1286
 
1287
- unset( $clean_request['s'] );
1288
  unset( $clean_request['mla_search_connector'] );
1289
  unset( $clean_request['mla_search_fields'] );
1290
  unset( $clean_request['sentence'] );
@@ -1476,6 +1537,21 @@ class MLAData {
1476
  return $results;
1477
  }
1478
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1479
  /**
1480
  * Adds a keyword search to the WHERE clause, if required
1481
  *
@@ -1522,11 +1598,15 @@ class MLAData {
1522
  return $search_clause;
1523
  }
1524
 
 
 
 
1525
  if ( self::$query_parameters['sentence'] ) {
1526
  $search_terms = array( self::$query_parameters['s'] );
1527
  } else {
1528
- preg_match_all('/".*?("|$)|((?<=[\r\n\t ",+])|^)[^\r\n\t ",+]+/', self::$query_parameters['s'], $matches);
1529
- $search_terms = array_map('_search_terms_tidy', $matches[0]);
 
1530
  }
1531
 
1532
  $fields = self::$query_parameters['mla_search_fields'];
@@ -1809,7 +1889,70 @@ class MLAData {
1809
  }
1810
 
1811
  /**
1812
- * Finds the value of a key in a possibily nested array structure
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1813
  *
1814
  * Used primarily to extract fields from the _wp_attachment_metadata custom field.
1815
  * Could also be used with the ID3 metadata exposed in WordPress 3.6 and later.
@@ -1821,7 +1964,7 @@ class MLAData {
1821
  * @param string data option 'text'|'single'|'export'|'array'|'multi'
1822
  * @param boolean keep existing values - for 'multi' option
1823
  *
1824
- * @return string value matching key(.key ...) or ''
1825
  */
1826
  public static function mla_find_array_element( $needle, $haystack, $option, $keep_existing = false ) {
1827
  $key_array = explode( '.', $needle );
@@ -1839,9 +1982,6 @@ class MLAData {
1839
  }
1840
  else $haystack = '';
1841
 
1842
- // if ( 'single' == $option && is_array( $haystack ))
1843
- // $haystack = current( $haystack );
1844
-
1845
  if ( is_array( $haystack ) ) {
1846
  switch ( $option ) {
1847
  case 'single':
@@ -1869,8 +2009,7 @@ class MLAData {
1869
  * Fetch and filter meta data for an attachment
1870
  *
1871
  * Returns a filtered array of a post's meta data. Internal values beginning with '_'
1872
- * are stripped out or converted to an 'mla_' equivalent. Array data is replaced with
1873
- * a string containing the first array element.
1874
  *
1875
  * @since 0.1
1876
  *
@@ -1898,7 +2037,6 @@ class MLAData {
1898
  $attached_file = $post_meta_value[0];
1899
  } elseif ( stripos( $post_meta_key, '_wp_attachment_metadata' ) === 0 ) {
1900
  $key = 'mla_wp_attachment_metadata';
1901
- $post_meta_value = unserialize( $post_meta_value[0] );
1902
  } elseif ( stripos( $post_meta_key, '_wp_attachment_image_alt' ) === 0 ) {
1903
  $key = 'mla_wp_attachment_image_alt';
1904
  } else {
@@ -1911,13 +2049,20 @@ class MLAData {
1911
  $key = 'mla_item_' . $post_meta_key;
1912
  }
1913
 
1914
- // if ( is_array( $post_meta_value ) && count( $post_meta_value ) == 1 && isset( $post_meta_value[0] ) )
1915
- if ( is_array( $post_meta_value ) && count( $post_meta_value ) == 1 )
1916
- $value = array_shift( $post_meta_value );
1917
- else
1918
- $value = $post_meta_value;
1919
-
1920
- $results[ $key ] = $value;
 
 
 
 
 
 
 
1921
  } // foreach $post_meta
1922
 
1923
  if ( !empty( $attached_file ) ) {
@@ -2085,19 +2230,16 @@ class MLAData {
2085
  $inserted_in_option = MLAOptions::mla_get_option( MLAOptions::MLA_INSERTED_IN_TUNING );
2086
 
2087
  if ( 'base' == $inserted_in_option ) {
2088
- $like = like_escape( $references['path'] . $pathinfo['filename'] ) . '%.' . like_escape( $pathinfo['extension'] );
 
2089
  $inserts = $wpdb->get_results(
2090
  $wpdb->prepare(
2091
- "
2092
- SELECT ID, post_type, post_title
2093
- FROM {$wpdb->posts}
2094
- WHERE {$exclude_revisions}(
2095
- CONVERT(`post_content` USING utf8 )
2096
- LIKE %s)
2097
- ", "%{$like}%"
2098
  )
2099
  );
2100
-
2101
  if ( !empty( $inserts ) ) {
2102
  $references['found_reference'] = true;
2103
  $references['inserts'][ $pathinfo['filename'] ] = $inserts;
@@ -2114,13 +2256,8 @@ class MLAData {
2114
  $like = like_escape( $file );
2115
  $inserts = $wpdb->get_results(
2116
  $wpdb->prepare(
2117
- "
2118
- SELECT ID, post_type, post_title
2119
- FROM {$wpdb->posts}
2120
- WHERE {$exclude_revisions}(
2121
- CONVERT(`post_content` USING utf8 )
2122
- LIKE %s)
2123
- ", "%{$like}%"
2124
  )
2125
  );
2126
 
@@ -4043,22 +4180,29 @@ class MLAData {
4043
  return $text;
4044
  }
4045
 
 
 
 
 
 
 
 
 
 
4046
  private static function _rational_to_decimal( $rational ) {
4047
  $parts = explode('/', $rational);
4048
  return $parts[0] / ( $parts[1] ? $parts[1] : 1);
4049
  }
4050
 
4051
  /**
4052
- * Fetch and filter IPTC and EXIF meta data for an image attachment
4053
  *
4054
- * Returns
4055
- *
4056
  * @since 0.90
4057
  *
4058
  * @param int post ID of attachment
4059
  * @param string optional; if $post_id is zero, path to the image file.
4060
  *
4061
- * @return array Meta data variables
4062
  */
4063
  public static function mla_fetch_attachment_image_metadata( $post_id, $path = '' ) {
4064
  $results = array(
@@ -4136,6 +4280,8 @@ class MLAData {
4136
  $gps_data['LatitudeDD'] = sprintf( '%1$01f', $degrees + $decimal_degrees );
4137
  $gps_data['LatitudeMinDec'] = substr( $gps_data['LatitudeDM'], strpos( $gps_data['LatitudeDM'], ' ' ) + 1 );
4138
  $gps_data['LatitudeDegDec'] = substr( $gps_data['LatitudeDD'], strpos( $gps_data['LatitudeDD'], '.' ) );
 
 
4139
  $gps_data['LatitudeDM'] = $gps_data['LatitudeDM'] . $ref;
4140
  $gps_data['LatitudeDD'] = $gps_data['LatitudeDD'] . $ref;
4141
  }
@@ -4164,6 +4310,8 @@ class MLAData {
4164
  $gps_data['LongitudeDD'] = sprintf( '%1$01f', $degrees + $decimal_degrees );
4165
  $gps_data['LongitudeMinDec'] = substr( $gps_data['LongitudeDM'], strpos( $gps_data['LongitudeDM'], ' ' ) + 1 );
4166
  $gps_data['LongitudeDegDec'] = substr( $gps_data['LongitudeDD'], strpos( $gps_data['LongitudeDD'], '.' ) );
 
 
4167
  $gps_data['LongitudeDM'] = $gps_data['LongitudeDM'] . $ref;
4168
  $gps_data['LongitudeDD'] = $gps_data['LongitudeDD'] . $ref;
4169
  }
@@ -4220,7 +4368,79 @@ class MLAData {
4220
  }
4221
 
4222
  /**
4223
- * Update custom field data for a single attachment.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4224
  *
4225
  * @since 1.40
4226
  *
@@ -4232,8 +4452,15 @@ class MLAData {
4232
  public static function mla_update_item_postmeta( $post_id, $new_meta ) {
4233
  $post_data = self::mla_fetch_attachment_metadata( $post_id );
4234
  $message = '';
4235
-
 
4236
  foreach ( $new_meta as $meta_key => $meta_value ) {
 
 
 
 
 
 
4237
  if ( $multi_key = isset( $meta_value[0x80000000] ) )
4238
  unset( $meta_value[0x80000000] );
4239
 
@@ -4281,11 +4508,7 @@ class MLAData {
4281
  continue; // no change or message if old and new are both NULL
4282
  } // no old value
4283
 
4284
- if ( is_array( $old_meta_value ) ) {
4285
- $old_text = var_export( $old_meta_value, true );
4286
- }
4287
- else
4288
- $old_text = $old_meta_value;
4289
 
4290
  /*
4291
  * Multi-key change from existing values to new values
@@ -4336,17 +4559,33 @@ class MLAData {
4336
  else
4337
  $new_text = $meta_value;
4338
 
4339
- $message .= sprintf( 'Changing %1$s from "%2$s" to "%3$s"<br>', $meta_key, $old_text, $new_text );
4340
- $results = update_post_meta( $post_id, $meta_key, $meta_value );
4341
  }
4342
  } // foreach $new_meta
4343
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4344
  return $message;
4345
  }
4346
 
4347
  /**
4348
- * Update a single item; change the meta data
4349
- * for a single attachment.
4350
  *
4351
  * @since 0.1
4352
  *
152
  *
153
  * @since 1.50
154
  *
155
+ * @param string A string possibly starting with '[+template:'
156
  *
157
  * @return string '' or template string starting with '[+template:' and ending with the matching '+]'
158
  */
253
  }
254
  elseif ( is_array( $element ) ) {
255
  foreach ($element as $key => $value ) {
256
+ if ( is_scalar( $value ) )
257
  $value = trim( $value );
 
 
 
258
  elseif ( ! empty( $value ) )
259
+ $value = var_export( $value, true );
260
+
261
+ /*
262
+ * Preserve any keys with string values
263
+ */
264
+ if ( ! empty( $value ) )
265
+ if ( is_integer( $key ) )
266
+ $final[] = $value;
267
+ else
268
+ $final[ $key ] = $value;
269
  }
270
  }
271
  elseif ( ! empty( $element ) )
337
  *
338
  * @since 1.50
339
  *
340
+ * @param string A string possibly starting with '('
341
  *
342
  * @return string '' or template string starting with '(' and ending with the matching ')'
343
  */
561
  }
562
  } // array of nodes
563
 
564
+ foreach ($result as $element )
565
+ if ( is_scalar( $element ) && false !== strpos( $element, '[+' ) ) {
566
  $result = array();
567
  break;
568
  }
569
+ elseif ( is_array( $element ) ) {
570
+ foreach ( $element as $value )
571
+ if ( is_scalar( $value ) && false !== strpos( $value, '[+' ) ) {
572
+ $result = array();
573
+ break;
574
+ }
575
+ } // is_array
576
 
577
  break;
578
  case 'choice':
791
  case 'query':
792
  if ( isset( $query ) && isset( $query[ $value['value'] ] ) )
793
  $markup_values[ $key ] = $query[ $value['value'] ];
794
+ else
795
+ $markup_values[ $key ] = '';
796
 
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':
827
  $markup_values[ $key ] = $text;
828
  break;
829
  case 'custom':
830
+ if ( 0 < $post_id ) {
831
  $record = get_metadata( 'post', $post_id, $value['value'], 'single' == $value['option'] );
832
+ if ( empty( $record ) && 'ALL_CUSTOM' == $value['value'] ) {
833
+ $meta_values = self::mla_fetch_attachment_metadata( $post_id );
834
+ $clean_data = array();
835
+ foreach( $meta_values as $meta_key => $meta_value ) {
836
+ if ( 0 !== strpos( $meta_key, 'mla_item_' ) )
837
+ continue;
838
+
839
+ $meta_key = substr( $meta_key, 9 );
840
+ if ( is_array( $meta_value ) )
841
+ $clean_data[ $meta_key ] = '(ARRAY)';
842
+ elseif ( is_string( $meta_value ) )
843
+ $clean_data[ $meta_key ] = self::_bin_to_utf8( substr( $meta_value, 0, 256 ) );
844
+ else
845
+ $clean_data[ $meta_key ] = $meta_value;
846
+ } // foreach value
847
+
848
+ /*
849
+ * Convert the array to text, strip the outer "array( ... ,)" literal,
850
+ * the interior linefeed/space/space separators and backslashes.
851
+ */
852
+ $record = var_export( $clean_data, true);
853
+ $record = substr( $record, 7, strlen( $record ) - 10 );
854
+ $record = str_replace( chr(0x0A).' ', ' ', $record );
855
+ $record = str_replace( '\\', '', $record );
856
+ } // ALL_CUSTOM
857
+ }
858
  else
859
  break;
860
 
1155
  return null;
1156
  }
1157
 
1158
+ /*
1159
+ * Make sure the current orderby choice still exists or revert to default.
1160
+ */
1161
+ $default_orderby = array_merge( array( 'none' => array('none',false) ), MLA_List_Table::mla_get_sortable_columns( ) );
1162
+ $current_orderby = MLAOptions::mla_get_option( MLAOptions::MLA_DEFAULT_ORDERBY );
1163
+ $found_current = false;
1164
+ foreach ($default_orderby as $key => $value ) {
1165
+ if ( $current_orderby == $value[0] ) {
1166
+ $found_current = true;
1167
+ break;
1168
+ }
1169
+ }
1170
+
1171
+ if ( ! $found_current ) {
1172
+ MLAOptions::mla_delete_option( MLAOptions::MLA_DEFAULT_ORDERBY );
1173
+ $current_orderby = MLAOptions::mla_get_option( MLAOptions::MLA_DEFAULT_ORDERBY );
1174
+ }
1175
+
1176
  $clean_request = array (
1177
  'm' => 0,
1178
+ 'orderby' => $current_orderby,
1179
  'order' => MLAOptions::mla_get_option( MLAOptions::MLA_DEFAULT_ORDER ),
1180
  'post_type' => 'attachment',
1181
  'post_status' => 'inherit',
1345
  self::$query_parameters['postmeta_key'] = '_wp_attachment_image_alt';
1346
  } // !empty
1347
 
1348
+ // unset( $clean_request['s'] ); // WP v3.7 requires this to be present for posts_search filter
1349
  unset( $clean_request['mla_search_connector'] );
1350
  unset( $clean_request['mla_search_fields'] );
1351
  unset( $clean_request['sentence'] );
1537
  return $results;
1538
  }
1539
 
1540
+ /**
1541
+ * Replaces a WordPress function deprecated in v3.7
1542
+ *
1543
+ * Defined as public because it's a callback from array_map().
1544
+ *
1545
+ * @since 1.51
1546
+ *
1547
+ * @param string search term before modification
1548
+ *
1549
+ * @return string cleaned up search term
1550
+ */
1551
+ public static function mla_search_terms_tidy( $term ) {
1552
+ return trim( $term, "\"'\n\r " );
1553
+ }
1554
+
1555
  /**
1556
  * Adds a keyword search to the WHERE clause, if required
1557
  *
1598
  return $search_clause;
1599
  }
1600
 
1601
+ // WordPress v3.7 says: there are no line breaks in <input /> fields
1602
+ self::$query_parameters['s'] = str_replace( array( "\r", "\n" ), '', self::$query_parameters['s'] );
1603
+
1604
  if ( self::$query_parameters['sentence'] ) {
1605
  $search_terms = array( self::$query_parameters['s'] );
1606
  } else {
1607
+ // v3.6.1 was '/".*?("|$)|((?<=[\r\n\t ",+])|^)[^\r\n\t ",+]+/'
1608
+ preg_match_all('/".*?("|$)|((?<=[\t ",+])|^)[^\t ",+]+/', self::$query_parameters['s'], $matches);
1609
+ $search_terms = array_map('MLAData::mla_search_terms_tidy', $matches[0]);
1610
  }
1611
 
1612
  $fields = self::$query_parameters['mla_search_fields'];
1889
  }
1890
 
1891
  /**
1892
+ * Adds or replaces the value of a key in a possibly nested array structure
1893
+ *
1894
+ * @since 1.51
1895
+ *
1896
+ * @param string key value, e.g. array1.array2.element
1897
+ * @param mixed replacement value, string or array, by reference
1898
+ * @param array PHP nested arrays, by reference
1899
+ *
1900
+ * @return boolean true if $needle element set, false if not
1901
+ */
1902
+ private static function _set_array_element( $needle, &$value, &$haystack ) {
1903
+ $key_array = explode( '.', $needle );
1904
+ $key = array_shift( $key_array );
1905
+
1906
+ if ( empty( $key_array ) ) {
1907
+ $haystack[ $key ] = $value;
1908
+ return true;
1909
+ } // lowest level
1910
+
1911
+ /*
1912
+ * If an intermediate key is not an array, leave it alone and fail.
1913
+ * If an intermediate key does not exist, create an empty array for it.
1914
+ */
1915
+ if ( isset( $haystack[ $key ] ) ) {
1916
+ if ( ! is_array( $haystack[ $key ] ) )
1917
+ return false;
1918
+ }
1919
+ else
1920
+ $haystack[ $key ] = array();
1921
+
1922
+ return self::_set_array_element( implode( $key_array, '.' ), $value, $haystack[ $key ] );
1923
+ }
1924
+
1925
+ /**
1926
+ * Deletes the value of a key in a possibly nested array structure
1927
+ *
1928
+ * @since 1.51
1929
+ *
1930
+ * @param string key value, e.g. array1.array2.element
1931
+ * @param array PHP nested arrays, by reference
1932
+ *
1933
+ * @return boolean true if $needle element found, false if not
1934
+ */
1935
+ private static function _unset_array_element( $needle, &$haystack ) {
1936
+ $key_array = explode( '.', $needle );
1937
+ $key = array_shift( $key_array );
1938
+
1939
+ if ( empty( $key_array ) ) {
1940
+ if ( isset( $haystack[ $key ] ) ) {
1941
+ unset( $haystack[ $key ] );
1942
+ return true;
1943
+ }
1944
+
1945
+ return false;
1946
+ } // lowest level
1947
+
1948
+ if ( isset( $haystack[ $key ] ) )
1949
+ return self::_unset_array_element( implode( $key_array, '.' ), $haystack[ $key ] );
1950
+
1951
+ return false;
1952
+ }
1953
+
1954
+ /**
1955
+ * Finds the value of a key in a possibly nested array structure
1956
  *
1957
  * Used primarily to extract fields from the _wp_attachment_metadata custom field.
1958
  * Could also be used with the ID3 metadata exposed in WordPress 3.6 and later.
1964
  * @param string data option 'text'|'single'|'export'|'array'|'multi'
1965
  * @param boolean keep existing values - for 'multi' option
1966
  *
1967
+ * @return mixed string or array value matching key(.key ...) or ''
1968
  */
1969
  public static function mla_find_array_element( $needle, $haystack, $option, $keep_existing = false ) {
1970
  $key_array = explode( '.', $needle );
1982
  }
1983
  else $haystack = '';
1984
 
 
 
 
1985
  if ( is_array( $haystack ) ) {
1986
  switch ( $option ) {
1987
  case 'single':
2009
  * Fetch and filter meta data for an attachment
2010
  *
2011
  * Returns a filtered array of a post's meta data. Internal values beginning with '_'
2012
+ * are stripped out or converted to an 'mla_' equivalent.
 
2013
  *
2014
  * @since 0.1
2015
  *
2037
  $attached_file = $post_meta_value[0];
2038
  } elseif ( stripos( $post_meta_key, '_wp_attachment_metadata' ) === 0 ) {
2039
  $key = 'mla_wp_attachment_metadata';
 
2040
  } elseif ( stripos( $post_meta_key, '_wp_attachment_image_alt' ) === 0 ) {
2041
  $key = 'mla_wp_attachment_image_alt';
2042
  } else {
2049
  $key = 'mla_item_' . $post_meta_key;
2050
  }
2051
 
2052
+ /*
2053
+ * At this point, every value is an array; one element per instance of the key.
2054
+ * We'll test anyway, just to be sure, then convert single-instance values to a scalar.
2055
+ * Metadata array values are serialized for storage in the database.
2056
+ */
2057
+ if ( is_array( $post_meta_value ) ) {
2058
+ if ( count( $post_meta_value ) == 1 )
2059
+ $post_meta_value = maybe_unserialize( $post_meta_value[0] );
2060
+ else
2061
+ foreach ( $post_meta_value as $single_key => $single_value )
2062
+ $post_meta_value[ $single_key ] = maybe_unserialize( $single_value );
2063
+ }
2064
+
2065
+ $results[ $key ] = $post_meta_value;
2066
  } // foreach $post_meta
2067
 
2068
  if ( !empty( $attached_file ) ) {
2230
  $inserted_in_option = MLAOptions::mla_get_option( MLAOptions::MLA_INSERTED_IN_TUNING );
2231
 
2232
  if ( 'base' == $inserted_in_option ) {
2233
+ $like1 = like_escape( $references['path'] . $pathinfo['filename'] ) . '.' . like_escape( $pathinfo['extension'] );
2234
+ $like2 = like_escape( $references['path'] . $pathinfo['filename'] ) . '-%.' . like_escape( $pathinfo['extension'] );
2235
  $inserts = $wpdb->get_results(
2236
  $wpdb->prepare(
2237
+ "SELECT ID, post_type, post_title FROM {$wpdb->posts}
2238
+ WHERE {$exclude_revisions} ((CONVERT(`post_content` USING utf8 ) LIKE %s) OR
2239
+ (CONVERT(`post_content` USING utf8 ) LIKE %s))", "%{$like1}%", "%{$like2}%"
 
 
 
 
2240
  )
2241
  );
2242
+
2243
  if ( !empty( $inserts ) ) {
2244
  $references['found_reference'] = true;
2245
  $references['inserts'][ $pathinfo['filename'] ] = $inserts;
2256
  $like = like_escape( $file );
2257
  $inserts = $wpdb->get_results(
2258
  $wpdb->prepare(
2259
+ "SELECT ID, post_type, post_title FROM {$wpdb->posts}
2260
+ WHERE {$exclude_revisions}(CONVERT(`post_content` USING utf8 ) LIKE %s)", "%{$like}%"
 
 
 
 
 
2261
  )
2262
  );
2263
 
4180
  return $text;
4181
  }
4182
 
4183
+ /**
4184
+ * Convert an EXIF GPS rational value to a PHP float value
4185
+ *
4186
+ * @since 1.50
4187
+ *
4188
+ * @param array array( 0 => numerator, 1 => denominator )
4189
+ *
4190
+ * @return float numerator/denominator
4191
+ */
4192
  private static function _rational_to_decimal( $rational ) {
4193
  $parts = explode('/', $rational);
4194
  return $parts[0] / ( $parts[1] ? $parts[1] : 1);
4195
  }
4196
 
4197
  /**
4198
+ * Fetch and filter IPTC and EXIF or PDF metadata for an image attachment
4199
  *
 
 
4200
  * @since 0.90
4201
  *
4202
  * @param int post ID of attachment
4203
  * @param string optional; if $post_id is zero, path to the image file.
4204
  *
4205
+ * @return array Meta data variables, IPTC and EXIF or PDF
4206
  */
4207
  public static function mla_fetch_attachment_image_metadata( $post_id, $path = '' ) {
4208
  $results = array(
4280
  $gps_data['LatitudeDD'] = sprintf( '%1$01f', $degrees + $decimal_degrees );
4281
  $gps_data['LatitudeMinDec'] = substr( $gps_data['LatitudeDM'], strpos( $gps_data['LatitudeDM'], ' ' ) + 1 );
4282
  $gps_data['LatitudeDegDec'] = substr( $gps_data['LatitudeDD'], strpos( $gps_data['LatitudeDD'], '.' ) );
4283
+ $gps_data['LatitudeSDM'] = $refs . $gps_data['LatitudeDM'];
4284
+ $gps_data['LatitudeSDD'] = $refs . $gps_data['LatitudeDD'];
4285
  $gps_data['LatitudeDM'] = $gps_data['LatitudeDM'] . $ref;
4286
  $gps_data['LatitudeDD'] = $gps_data['LatitudeDD'] . $ref;
4287
  }
4310
  $gps_data['LongitudeDD'] = sprintf( '%1$01f', $degrees + $decimal_degrees );
4311
  $gps_data['LongitudeMinDec'] = substr( $gps_data['LongitudeDM'], strpos( $gps_data['LongitudeDM'], ' ' ) + 1 );
4312
  $gps_data['LongitudeDegDec'] = substr( $gps_data['LongitudeDD'], strpos( $gps_data['LongitudeDD'], '.' ) );
4313
+ $gps_data['LongitudeSDM'] = $refs . $gps_data['LongitudeDM'];
4314
+ $gps_data['LongitudeSDD'] = $refs . $gps_data['LongitudeDD'];
4315
  $gps_data['LongitudeDM'] = $gps_data['LongitudeDM'] . $ref;
4316
  $gps_data['LongitudeDD'] = $gps_data['LongitudeDD'] . $ref;
4317
  }
4368
  }
4369
 
4370
  /**
4371
+ * Update one "meta:" data for a single attachment
4372
+ *
4373
+ * @since 1.51
4374
+ *
4375
+ * @param array The current wp_attachment_metadata value
4376
+ * @param array Field name => value pairs
4377
+ *
4378
+ * @return string success/failure message(s); empty string if no changes.
4379
+ */
4380
+ private static function _update_wp_attachment_metadata( &$current_values, $new_meta ) {
4381
+ $message = '';
4382
+
4383
+ foreach( $new_meta as $key => $value ) {
4384
+ /*
4385
+ * The "Multi" option has no meaning for attachment_metadata;
4386
+ * convert to a simple array or string
4387
+ */
4388
+ if ( isset( $value[0x80000000] ) ) {
4389
+ unset( $value[0x80000000] );
4390
+ unset( $value[0x80000001] );
4391
+ unset( $value[0x80000002] );
4392
+
4393
+ if ( 1 == count( $value ) ) {
4394
+ foreach ( $value as $single_key => $single_value )
4395
+ if ( is_integer( $single_key ) )
4396
+ $value = $single_value;
4397
+ } // one-element array
4398
+ } // Multi-key value
4399
+
4400
+ $old_value = self::mla_find_array_element( $key, $current_values, 'array' );
4401
+ if ( ! empty( $old_value ) ) {
4402
+ if ( empty( $value ) ) {
4403
+ if ( self::_unset_array_element( $key, $current_values ) )
4404
+ $message .= sprintf( 'Deleting meta:%1$s<br>', $key );
4405
+ else
4406
+ $message .= sprintf( 'ERROR: meta:%1$s not found<br>', $key );
4407
+
4408
+ continue;
4409
+ }
4410
+ } // old_value present
4411
+ else {
4412
+ if ( ! empty( $value ) ) {
4413
+ if ( self::_set_array_element( $key, $value, $current_values ) )
4414
+ $message .= sprintf( 'Adding meta:%1$s = %2$s<br>', $key,
4415
+ ( is_array( $value ) ) ? var_export( $value, true ) : $value );
4416
+ else
4417
+ $message .= sprintf( 'ERROR: Adding meta:%1$s; not found<br>', $key );
4418
+
4419
+ continue;
4420
+ }
4421
+ elseif ( NULL == $value ) {
4422
+ if ( self::_unset_array_element( $key, $current_values ) )
4423
+ $message .= sprintf( 'Deleting Null meta:%1$s<br>', $key );
4424
+
4425
+ continue;
4426
+ }
4427
+ } // old_value empty
4428
+
4429
+ if ( $old_value != $value ) {
4430
+ if ( self::_set_array_element( $key, $value, $current_values ) )
4431
+ $message .= sprintf( 'Changing meta:%1$s from "%2$s" to "%3$s"<br>', $key,
4432
+ ( is_array( $old_value ) ) ? var_export( $old_value, true ) : $old_value,
4433
+ ( is_array( $value ) ) ? var_export( $value, true ) : $value );
4434
+ else
4435
+ $message .= sprintf( 'ERROR: Changing meta:%1$s; not found<br>', $key );
4436
+ }
4437
+ } // foreach new_meta
4438
+
4439
+ return $message;
4440
+ }
4441
+
4442
+ /**
4443
+ * Update custom field and "meta:" data for a single attachment
4444
  *
4445
  * @since 1.40
4446
  *
4452
  public static function mla_update_item_postmeta( $post_id, $new_meta ) {
4453
  $post_data = self::mla_fetch_attachment_metadata( $post_id );
4454
  $message = '';
4455
+
4456
+ $attachment_meta_values = array();
4457
  foreach ( $new_meta as $meta_key => $meta_value ) {
4458
+ if ( 'meta:' == substr( $meta_key, 0, 5 ) ) {
4459
+ $meta_key = substr( $meta_key, 5 );
4460
+ $attachment_meta_values[ $meta_key ] = $meta_value;
4461
+ continue;
4462
+ }
4463
+
4464
  if ( $multi_key = isset( $meta_value[0x80000000] ) )
4465
  unset( $meta_value[0x80000000] );
4466
 
4508
  continue; // no change or message if old and new are both NULL
4509
  } // no old value
4510
 
4511
+ $old_text = ( is_array( $old_meta_value ) ) ? var_export( $old_meta_value, true ) : $old_meta_value;
 
 
 
 
4512
 
4513
  /*
4514
  * Multi-key change from existing values to new values
4559
  else
4560
  $new_text = $meta_value;
4561
 
4562
+ if ( update_post_meta( $post_id, $meta_key, $meta_value ) )
4563
+ $message .= sprintf( 'Changing %1$s from "%2$s" to "%3$s"<br>', $meta_key, $old_text, $new_text );
4564
  }
4565
  } // foreach $new_meta
4566
 
4567
+ /*
4568
+ * Process the "meta:" updates, if any
4569
+ */
4570
+ if ( ! empty( $attachment_meta_values ) ) {
4571
+ if ( isset( $post_data['mla_wp_attachment_metadata'] ) )
4572
+ $current_values = $post_data['mla_wp_attachment_metadata'];
4573
+ else
4574
+ $current_values = array();
4575
+
4576
+ $results = self::_update_wp_attachment_metadata( $current_values, $attachment_meta_values );
4577
+ if ( ! empty( $results ) ) {
4578
+ if ( update_post_meta( $post_id, '_wp_attachment_metadata', $current_values ) )
4579
+ $message .= $results;
4580
+ }
4581
+ }
4582
+
4583
  return $message;
4584
  }
4585
 
4586
  /**
4587
+ * Update a single item; change the "post" data, taxonomy terms
4588
+ * and meta data for a single attachment
4589
  *
4590
  * @since 0.1
4591
  *
includes/class-mla-edit-media.php CHANGED
@@ -26,7 +26,7 @@ class MLAEdit {
26
  * page. This supports all the standard meta-boxes for post types.
27
  */
28
  if ( MLATest::$wordpress_3point5_plus ) {
29
- add_action( 'admin_init', 'MLAEdit::mla_custom_field_support_action' );
30
 
31
  add_action( 'add_meta_boxes', 'MLAEdit::mla_add_meta_boxes_action', 10, 2 );
32
 
@@ -52,8 +52,32 @@ class MLAEdit {
52
  *
53
  * @return void echoes the HTML markup for the label and value
54
  */
55
- public static function mla_custom_field_support_action( ) {
56
- add_post_type_support( 'attachment', 'custom-fields' );
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
57
  }
58
 
59
  /**
26
  * page. This supports all the standard meta-boxes for post types.
27
  */
28
  if ( MLATest::$wordpress_3point5_plus ) {
29
+ add_action( 'admin_init', 'MLAEdit::mla_admin_init_action' );
30
 
31
  add_action( 'add_meta_boxes', 'MLAEdit::mla_add_meta_boxes_action', 10, 2 );
32
 
52
  *
53
  * @return void echoes the HTML markup for the label and value
54
  */
55
+ public static function mla_admin_init_action( ) {
56
+ static $mc_att_category_metabox = array();
57
+
58
+ /*
59
+ * Enable the enhanced "Media Categories" searchable metaboxes for hiearchical taxonomies
60
+ */
61
+ if ( class_exists( 'Media_Categories' ) &&
62
+ ( ( 'checked' == MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX ) ) ||
63
+ ( 'checked' == MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_DETAILS_TAG_METABOX ) ) ) ) {
64
+ $taxonomies = get_taxonomies( array ( 'show_ui' => true ), 'objects' );
65
+
66
+ foreach ( $taxonomies as $key => $value ) {
67
+ if ( MLAOptions::mla_taxonomy_support( $key ) ) {
68
+ if ( $value->hierarchical ) {
69
+ if ( 'checked' == MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX ) )
70
+ $mc_att_category_metabox[] = new Media_Categories( $key );
71
+ } // hierarchical
72
+ else {
73
+ if ( 'checked' == MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_DETAILS_TAG_METABOX ) )
74
+ $mc_att_category_metabox[] = new Media_Categories( $key );
75
+ } // flat
76
+ } // is supported
77
+ } // foreach
78
+ } // class_exists
79
+
80
+ add_post_type_support( 'attachment', 'custom-fields' );
81
  }
82
 
83
  /**
includes/class-mla-list-table.php CHANGED
@@ -560,6 +560,7 @@ class MLA_List_Table extends WP_List_Table {
560
  $inline_data .= ' <div class="post_title">' . esc_attr( $item->post_title ) . "</div>\r\n";
561
  $inline_data .= ' <div class="post_name">' . esc_attr( $item->post_name ) . "</div>\r\n";
562
  $inline_data .= ' <div class="post_excerpt">' . esc_attr( $item->post_excerpt ) . "</div>\r\n";
 
563
 
564
  if ( !empty( $item->mla_wp_attachment_metadata ) ) {
565
  if ( isset( $item->mla_wp_attachment_image_alt ) )
@@ -576,7 +577,7 @@ class MLA_List_Table extends WP_List_Table {
576
  $custom_fields = array_merge( $custom_fields, MLAOptions::mla_custom_field_support( 'bulk_edit' ) );
577
  foreach ($custom_fields as $slug => $label ) {
578
  $value = get_metadata( 'post', $item->ID, $label, true );
579
- $inline_data .= ' <div class="' . $slug . '">' . $value . "</div>\r\n";
580
  }
581
 
582
  $taxonomies = get_object_taxonomies( 'attachment', 'objects' );
@@ -908,7 +909,7 @@ class MLA_List_Table extends WP_List_Table {
908
  * @return string HTML markup to be placed inside the column
909
  */
910
  function column_post_mime_type( $item ) {
911
- return sprintf( '<a href="%1$s" title="Filter by &#8220;%2$s&#8221;"">%2$s</a>', esc_url( add_query_arg( array_merge( self::mla_submenu_arguments( false ), array(
912
  'page' => MLA::ADMIN_PAGE_SLUG,
913
  'post_mime_type' => urlencode( $item->post_mime_type ),
914
  'heading_suffix' => urlencode( 'MIME Type: ' . $item->post_mime_type )
560
  $inline_data .= ' <div class="post_title">' . esc_attr( $item->post_title ) . "</div>\r\n";
561
  $inline_data .= ' <div class="post_name">' . esc_attr( $item->post_name ) . "</div>\r\n";
562
  $inline_data .= ' <div class="post_excerpt">' . esc_attr( $item->post_excerpt ) . "</div>\r\n";
563
+ $inline_data .= ' <div class="post_content">' . esc_attr( $item->post_content ) . "</div>\r\n";
564
 
565
  if ( !empty( $item->mla_wp_attachment_metadata ) ) {
566
  if ( isset( $item->mla_wp_attachment_image_alt ) )
577
  $custom_fields = array_merge( $custom_fields, MLAOptions::mla_custom_field_support( 'bulk_edit' ) );
578
  foreach ($custom_fields as $slug => $label ) {
579
  $value = get_metadata( 'post', $item->ID, $label, true );
580
+ $inline_data .= ' <div class="' . $slug . '">' . esc_html( $value ) . "</div>\r\n";
581
  }
582
 
583
  $taxonomies = get_object_taxonomies( 'attachment', 'objects' );
909
  * @return string HTML markup to be placed inside the column
910
  */
911
  function column_post_mime_type( $item ) {
912
+ return sprintf( '<a href="%1$s" title="Filter by &#8220;%2$s&#8221;">%2$s</a>', esc_url( add_query_arg( array_merge( self::mla_submenu_arguments( false ), array(
913
  'page' => MLA::ADMIN_PAGE_SLUG,
914
  'post_mime_type' => urlencode( $item->post_mime_type ),
915
  'heading_suffix' => urlencode( 'MIME Type: ' . $item->post_mime_type )
includes/class-mla-main.php CHANGED
@@ -38,7 +38,7 @@ class MLA {
38
  *
39
  * @var string
40
  */
41
- const CURRENT_MLA_VERSION = '1.50';
42
 
43
  /**
44
  * Slug for registering and enqueueing plugin style sheet
@@ -272,7 +272,7 @@ class MLA {
272
  wp_enqueue_script( self::JAVASCRIPT_INLINE_EDIT_SLUG, MLA_PLUGIN_URL . "js/mla-inline-edit-scripts{$suffix}.js",
273
  array( 'wp-lists', 'suggest', 'jquery' ), self::CURRENT_MLA_VERSION, false );
274
 
275
- $fields = array( 'post_title', 'post_name', 'post_excerpt', 'image_alt', 'post_parent', 'menu_order', 'post_author' );
276
  $custom_fields = MLAOptions::mla_custom_field_support( 'quick_edit' );
277
  $custom_fields = array_merge( $custom_fields, MLAOptions::mla_custom_field_support( 'bulk_edit' ) );
278
  foreach ($custom_fields as $slug => $label ) {
38
  *
39
  * @var string
40
  */
41
+ const CURRENT_MLA_VERSION = '1.51';
42
 
43
  /**
44
  * Slug for registering and enqueueing plugin style sheet
272
  wp_enqueue_script( self::JAVASCRIPT_INLINE_EDIT_SLUG, MLA_PLUGIN_URL . "js/mla-inline-edit-scripts{$suffix}.js",
273
  array( 'wp-lists', 'suggest', 'jquery' ), self::CURRENT_MLA_VERSION, false );
274
 
275
+ $fields = array( 'post_title', 'post_name', 'post_excerpt', 'post_content', 'image_alt', 'post_parent', 'menu_order', 'post_author' );
276
  $custom_fields = MLAOptions::mla_custom_field_support( 'quick_edit' );
277
  $custom_fields = array_merge( $custom_fields, MLAOptions::mla_custom_field_support( 'bulk_edit' ) );
278
  foreach ($custom_fields as $slug => $label ) {
includes/class-mla-media-modal.php CHANGED
@@ -197,6 +197,15 @@ class MLAModal {
197
  self::$mla_media_modal_settings['enableMonthsDropdown'] = ( 'checked' == MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_MONTHS ) );
198
  self::$mla_media_modal_settings['enableTermsDropdown'] = ( 'checked' == MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_TERMS ) );
199
  self::$mla_media_modal_settings['enableSearchBox'] = ( 'checked' == MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_SEARCHBOX ) );
 
 
 
 
 
 
 
 
 
200
 
201
  $settings = array_merge( $settings, array( 'mla_settings' => self::$mla_media_modal_settings ) );
202
  return $settings;
@@ -302,40 +311,40 @@ class MLAModal {
302
  echo "\t" . '<script type="text/html" id="tmpl-mla-search-box">' . "\r\n";
303
  echo "\t\t" . '<p class="search-box">' . "\r\n";
304
  echo "\t\t" . '<label class="screen-reader-text" for="media-search-input">Search Media:</label>' . "\r\n";
305
- echo "\t\t" . '<input type="text" name="mla_search_value" id="media-search-input" size="43" value="' . $search_value . '" />' . "\r\n";
306
  echo "\t\t" . '<input type="submit" name="mla_search_submit" id="search-submit" class="button" value="Search Media" /><br>' . "\r\n";
307
  if ( 'OR' == $search_connector ) {
308
- echo "\t\t" . '<input type="radio" name="mla_search_connector" value="AND" />&nbsp;and&nbsp;' . "\r\n";
309
- echo "\t\t" . '<input type="radio" name="mla_search_connector" checked="checked" value="OR" />&nbsp;or&nbsp;' . "\r\n";
310
  } else {
311
- echo "\t\t" . '<input type="radio" name="mla_search_connector" checked="checked" value="AND" />&nbsp;and&nbsp;' . "\r\n";
312
- echo "\t\t" . '<input type="radio" name="mla_search_connector" value="OR" />&nbsp;or&nbsp;' . "\r\n";
313
  }
314
 
315
  if ( in_array( 'title', $search_fields ) )
316
- echo "\t\t" . '<input type="checkbox" name="mla_search_title" id="search-title" checked="checked" value="title" />&nbsp;title&nbsp;' . "\r\n";
317
  else
318
- echo "\t\t" . '<input type="checkbox" name="mla_search_title" id="search-title" value="title" />&nbsp;title&nbsp;' . "\r\n";
319
 
320
  if ( in_array( 'name', $search_fields ) )
321
- echo "\t\t" . '<input type="checkbox" name="mla_search_name" id="search-name" checked="checked" value="name" />&nbsp;name&nbsp;' . "\r\n";
322
  else
323
- echo "\t\t" . '<input type="checkbox" name="mla_search_name" id="search-name" value="name" />&nbsp;name&nbsp;' . "\r\n";
324
 
325
  if ( in_array( 'alt-text', $search_fields ) )
326
- echo "\t\t" . '<input type="checkbox" name="mla_search_alt_text" id="search-alt-text" checked="checked" value="alt-text" />&nbsp;ALT text&nbsp;' . "\r\n";
327
  else
328
- echo "\t\t" . '<input type="checkbox" name="mla_search_alt_text" id="search-alt-text" value="alt-text" />&nbsp;ALT text&nbsp;' . "\r\n";
329
 
330
  if ( in_array( 'excerpt', $search_fields ) )
331
- echo "\t\t" . '<input type="checkbox" name="mla_search_excerpt" id="search-excerpt" checked="checked" value="excerpt" />&nbsp;caption&nbsp;' . "\r\n";
332
  else
333
- echo "\t\t" . '<input type="checkbox" name="mla_search_excerpt" id="search-excerpt" value="excerpt" />&nbsp;caption&nbsp;' . "\r\n";
334
 
335
  if ( in_array( 'content', $search_fields ) )
336
- echo "\t\t" . '<input type="checkbox" name="mla_search_content" id="search-content" checked="checked" value="content" />&nbsp;description&nbsp;' . "\r\n";
337
  else
338
- echo "\t\t" . '<input type="checkbox" name="mla_search_content" id="search-content" value="content" />&nbsp;description&nbsp;' . "\r\n";
339
 
340
  echo "\t\t" . '</p>' . "\r\n";
341
  echo "\t" . '</script>' . "\r\n";
@@ -352,7 +361,14 @@ class MLAModal {
352
  */
353
  public static function mla_admin_init_ajax_action() {
354
  if ( ( defined('WP_ADMIN') && WP_ADMIN ) && ( defined('DOING_AJAX') && DOING_AJAX ) ) {
355
- if ( isset( $_POST['action'] ) && ( $_POST['action'] == 'query-attachments' ) && isset( $_POST['query']['mla_source'] ) ){
 
 
 
 
 
 
 
356
  $_POST['action'] = self::JAVASCRIPT_MEDIA_MODAL_SLUG;
357
  $_REQUEST['action'] = self::JAVASCRIPT_MEDIA_MODAL_SLUG;
358
  }
@@ -378,7 +394,7 @@ class MLAModal {
378
  $query = isset( $_REQUEST['query'] ) ? (array) $_REQUEST['query'] : array();
379
  $query = array_intersect_key( $query, array_flip( array(
380
  'order', 'orderby', 'posts_per_page', 'paged', 'post_mime_type',
381
- 'post_parent', 'post__in', 'post__not_in', 'm', 'mla_filter_term',
382
  'mla_search_value', 's', 'mla_search_fields', 'mla_search_connector'
383
  ) ) );
384
 
@@ -394,21 +410,31 @@ class MLAModal {
394
  }
395
  }
396
 
 
 
 
 
 
 
 
 
 
 
397
  /*
398
  * Process the enhanced search box OR fix up the default search box
399
  */
400
  if ( isset( $query['mla_search_value'] ) ) {
401
  if ( ! empty( $query['mla_search_value'] ) )
402
  $query['s'] = $query['mla_search_value'];
403
- else
404
- unset( $query['s'] );
405
 
406
  unset( $query['mla_search_value'] );
407
  }
408
- elseif ( ! empty( $query['s'] ) ) {
409
  $query['mla_search_fields'] = array( 'title', 'content' );
410
  $query['mla_search_connector'] = 'AND';
411
- }
412
 
413
  if ( isset( $query['posts_per_page'] ) ) {
414
  $count = $query['posts_per_page'];
@@ -418,7 +444,36 @@ class MLAModal {
418
  $count = 0;
419
  $offset = 0;
420
  }
421
-
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
422
  $query['post_type'] = 'attachment';
423
  $query['post_status'] = 'inherit';
424
  if ( current_user_can( get_post_type_object( 'attachment' )->cap->read_private_posts ) )
197
  self::$mla_media_modal_settings['enableMonthsDropdown'] = ( 'checked' == MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_MONTHS ) );
198
  self::$mla_media_modal_settings['enableTermsDropdown'] = ( 'checked' == MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_TERMS ) );
199
  self::$mla_media_modal_settings['enableSearchBox'] = ( 'checked' == MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_SEARCHBOX ) );
200
+
201
+ /*
202
+ * These will be passed back to the server in the query['s'] field.
203
+ */
204
+ self::$mla_media_modal_settings['filterMonth'] = 0;
205
+ self::$mla_media_modal_settings['filterTerm'] = 0;
206
+ self::$mla_media_modal_settings['searchConnector'] = 'AND';
207
+ self::$mla_media_modal_settings['searchFields'] = array( 'title', 'content' );
208
+ self::$mla_media_modal_settings['searchValue'] = '';
209
 
210
  $settings = array_merge( $settings, array( 'mla_settings' => self::$mla_media_modal_settings ) );
211
  return $settings;
311
  echo "\t" . '<script type="text/html" id="tmpl-mla-search-box">' . "\r\n";
312
  echo "\t\t" . '<p class="search-box">' . "\r\n";
313
  echo "\t\t" . '<label class="screen-reader-text" for="media-search-input">Search Media:</label>' . "\r\n";
314
+ echo "\t\t" . '<input type="text" name="s[mla_search_value]" id="media-search-input" size="43" value="' . $search_value . '" />' . "\r\n";
315
  echo "\t\t" . '<input type="submit" name="mla_search_submit" id="search-submit" class="button" value="Search Media" /><br>' . "\r\n";
316
  if ( 'OR' == $search_connector ) {
317
+ echo "\t\t" . '<input type="radio" name="s[mla_search_connector]" value="AND" />&nbsp;and&nbsp;' . "\r\n";
318
+ echo "\t\t" . '<input type="radio" name="s[mla_search_connector]" checked="checked" value="OR" />&nbsp;or&nbsp;' . "\r\n";
319
  } else {
320
+ echo "\t\t" . '<input type="radio" name="s[mla_search_connector]" checked="checked" value="AND" />&nbsp;and&nbsp;' . "\r\n";
321
+ echo "\t\t" . '<input type="radio" name="s[mla_search_connector]" value="OR" />&nbsp;or&nbsp;' . "\r\n";
322
  }
323
 
324
  if ( in_array( 'title', $search_fields ) )
325
+ echo "\t\t" . '<input type="checkbox" name="s[mla_search_title]" id="search-title" checked="checked" value="title" />&nbsp;title&nbsp;' . "\r\n";
326
  else
327
+ echo "\t\t" . '<input type="checkbox" name="s[mla_search_title]" id="search-title" value="title" />&nbsp;title&nbsp;' . "\r\n";
328
 
329
  if ( in_array( 'name', $search_fields ) )
330
+ echo "\t\t" . '<input type="checkbox" name="s[mla_search_name]" id="search-name" checked="checked" value="name" />&nbsp;name&nbsp;' . "\r\n";
331
  else
332
+ echo "\t\t" . '<input type="checkbox" name="s[mla_search_name]" id="search-name" value="name" />&nbsp;name&nbsp;' . "\r\n";
333
 
334
  if ( in_array( 'alt-text', $search_fields ) )
335
+ echo "\t\t" . '<input type="checkbox" name="s[mla_search_alt_text]" id="search-alt-text" checked="checked" value="alt-text" />&nbsp;ALT text&nbsp;' . "\r\n";
336
  else
337
+ echo "\t\t" . '<input type="checkbox" name="s[mla_search_alt_text]" id="search-alt-text" value="alt-text" />&nbsp;ALT text&nbsp;' . "\r\n";
338
 
339
  if ( in_array( 'excerpt', $search_fields ) )
340
+ echo "\t\t" . '<input type="checkbox" name="s[mla_search_excerpt]" id="search-excerpt" checked="checked" value="excerpt" />&nbsp;caption&nbsp;' . "\r\n";
341
  else
342
+ echo "\t\t" . '<input type="checkbox" name="s[mla_search_excerpt]" id="search-excerpt" value="excerpt" />&nbsp;caption&nbsp;' . "\r\n";
343
 
344
  if ( in_array( 'content', $search_fields ) )
345
+ echo "\t\t" . '<input type="checkbox" name="s[mla_search_content]" id="search-content" checked="checked" value="content" />&nbsp;description&nbsp;' . "\r\n";
346
  else
347
+ echo "\t\t" . '<input type="checkbox" name="s[mla_search_content]" id="search-content" value="content" />&nbsp;description&nbsp;' . "\r\n";
348
 
349
  echo "\t\t" . '</p>' . "\r\n";
350
  echo "\t" . '</script>' . "\r\n";
361
  */
362
  public static function mla_admin_init_ajax_action() {
363
  if ( ( defined('WP_ADMIN') && WP_ADMIN ) && ( defined('DOING_AJAX') && DOING_AJAX ) ) {
364
+ if ( isset( $_POST['action'] ) && ( $_POST['action'] == 'query-attachments' ) && isset( $_POST['query']['s'] ) && is_array( $_POST['query']['s'] ) ){
365
+ foreach ( $_POST['query']['s'] as $key => $value ) {
366
+ $_POST['query'][ $key ] = $value;
367
+ $_REQUEST['query'][ $key ] = $value;
368
+ }
369
+
370
+ unset( $_POST['query']['s'] );
371
+ unset( $_REQUEST['query']['s'] );
372
  $_POST['action'] = self::JAVASCRIPT_MEDIA_MODAL_SLUG;
373
  $_REQUEST['action'] = self::JAVASCRIPT_MEDIA_MODAL_SLUG;
374
  }
394
  $query = isset( $_REQUEST['query'] ) ? (array) $_REQUEST['query'] : array();
395
  $query = array_intersect_key( $query, array_flip( array(
396
  'order', 'orderby', 'posts_per_page', 'paged', 'post_mime_type',
397
+ 'post_parent', 'post__in', 'post__not_in', 'mla_filter_month', 'mla_filter_term',
398
  'mla_search_value', 's', 'mla_search_fields', 'mla_search_connector'
399
  ) ) );
400
 
410
  }
411
  }
412
 
413
+ /*
414
+ * Convert mla_filter_month back to the WordPress "m" parameter
415
+ */
416
+ if ( isset( $query['mla_filter_month'] ) ) {
417
+ if ( '0' != $query['mla_filter_month'] )
418
+ $query['m'] = $query['mla_filter_month'];
419
+
420
+ unset( $query['mla_filter_month'] );
421
+ }
422
+
423
  /*
424
  * Process the enhanced search box OR fix up the default search box
425
  */
426
  if ( isset( $query['mla_search_value'] ) ) {
427
  if ( ! empty( $query['mla_search_value'] ) )
428
  $query['s'] = $query['mla_search_value'];
429
+ // else
430
+ // unset( $query['s'] );
431
 
432
  unset( $query['mla_search_value'] );
433
  }
434
+ /* elseif ( ! empty( $query['s'] ) ) {
435
  $query['mla_search_fields'] = array( 'title', 'content' );
436
  $query['mla_search_connector'] = 'AND';
437
+ } // */
438
 
439
  if ( isset( $query['posts_per_page'] ) ) {
440
  $count = $query['posts_per_page'];
444
  $count = 0;
445
  $offset = 0;
446
  }
447
+
448
+ /*
449
+ * Check for sorting override
450
+ */
451
+ $option = MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_ORDERBY );
452
+ if ( 'default' != $option ) {
453
+ /*
454
+ * Make sure the current orderby choice still exists or revert to default.
455
+ */
456
+ $default_orderby = array_merge( array( 'none' => array('none',false) ), MLA_List_Table::mla_get_sortable_columns( ) );
457
+ $found_current = false;
458
+ foreach ($default_orderby as $key => $value ) {
459
+ if ( $option == $value[0] ) {
460
+ $found_current = true;
461
+ break;
462
+ }
463
+ }
464
+
465
+ if ( ! $found_current ) {
466
+ MLAOptions::mla_delete_option( MLAOptions::MLA_DEFAULT_ORDERBY );
467
+ $option = MLAOptions::mla_get_option( MLAOptions::MLA_DEFAULT_ORDERBY );
468
+ }
469
+
470
+ $query['orderby'] = $option;
471
+ }
472
+
473
+ $option = MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_ORDER );
474
+ if ( 'default' != $option )
475
+ $query['order'] = $option;
476
+
477
  $query['post_type'] = 'attachment';
478
  $query['post_status'] = 'inherit';
479
  if ( current_user_can( get_post_type_object( 'attachment' )->cap->read_private_posts ) )
includes/class-mla-options.php CHANGED
@@ -136,6 +136,28 @@ class MLAOptions {
136
  */
137
  const MLA_MEDIA_MODAL_SEARCHBOX = 'media_modal_searchbox';
138
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
139
  /**
140
  * Provides a unique name for the Post MIME Types option
141
  */
@@ -474,6 +496,38 @@ class MLAOptions {
474
  'std' => 'checked',
475
  'help' => 'Check this option to enable search box enhancements.'),
476
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
477
  'template_header' =>
478
  array('tab' => 'mla_gallery',
479
  'name' => 'Default [mla_gallery] Templates and Settings',
@@ -1498,7 +1552,6 @@ class MLAOptions {
1498
  global $wpdb;
1499
  static $upload_dir, $intermediate_sizes = NULL, $wp_attached_files = NULL, $wp_attachment_metadata = NULL;
1500
  static $current_id = 0, $file_info = NULL, $parent_info = NULL, $references = NULL;
1501
-
1502
  if ( 'none' == $data_value['data_source'] )
1503
  return '';
1504
 
@@ -1872,11 +1925,11 @@ class MLAOptions {
1872
  if ( 'none' == $new_value['data_source'] )
1873
  continue;
1874
 
1875
- /*
1876
- * Convert checkbox value(s)
1877
- */
1878
- $new_value['no_null'] = isset( $new_value['no_null'] ) ? (boolean) isset( $new_value['no_null'] ) : false;
1879
-
1880
  $new_text = self::_evaluate_data_source( $post_id, $category, $new_value, $attachment_metadata );
1881
  if ( 'multi' == $new_value['option'] ) {
1882
  if ( ' ' == $new_text ) {
@@ -1900,8 +1953,18 @@ class MLAOptions {
1900
  }
1901
  else {
1902
  if ( $new_value['keep_existing'] ) {
1903
- if ( is_string( $old_text = get_metadata( 'post', $post_id, $new_value['name'], true ) ) )
1904
- $old_text = trim( $old_text );
 
 
 
 
 
 
 
 
 
 
1905
 
1906
  if ( ( ' ' != $new_text ) && empty( $old_text ) )
1907
  $custom_updates[ $new_value['name'] ] = $new_text;
@@ -2088,7 +2151,7 @@ class MLAOptions {
2088
  * @param array current custom_field_mapping values
2089
  * @param array new values
2090
  *
2091
- * @return array ( 'message' => HTML message(s) reflecting results, 'values' => updated iptc_exif_mapping values, 'changed' => true if any changes detected else false )
2092
  */
2093
  private static function _update_custom_field_mapping( $current_values, $new_values ) {
2094
  $error_list = '';
@@ -2159,11 +2222,19 @@ class MLAOptions {
2159
  continue;
2160
  } // delete rule
2161
  } // isset action
2162
-
 
 
 
 
 
 
 
 
 
2163
  if ( $old_values['data_source'] != $new_value['data_source'] ) {
2164
  $any_setting_changed = true;
2165
 
2166
- // if ( 'meta' == $old_values['data_source'] ) {
2167
  if ( in_array( $old_values['data_source'], array( 'meta', 'template' ) ) ) {
2168
  $new_value['meta_name'] = '';
2169
  }
@@ -2663,7 +2734,19 @@ class MLAOptions {
2663
  }
2664
 
2665
  if ( $new_value['keep_existing'] ) {
2666
- $old_value = get_metadata( 'post', $post->ID, $new_key, true );
 
 
 
 
 
 
 
 
 
 
 
 
2667
  if ( ( ! empty( $new_text ) ) && empty( $old_value ) ) {
2668
  $custom_updates[ $new_key ] = $new_text;
2669
  }
136
  */
137
  const MLA_MEDIA_MODAL_SEARCHBOX = 'media_modal_searchbox';
138
 
139
+ /**
140
+ * Provides a unique name for the Media Manager Attachment Details searchable taxonomy option
141
+ * This option is for hierarchical taxonomies, e.g., "Att. Categories".
142
+ */
143
+ const MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX = 'media_modal_details_category_metabox';
144
+
145
+ /**
146
+ * Provides a unique name for the Media Manager Attachment Details searchable taxonomy option
147
+ * This option is for flat taxonomies, e.g., "Att. Tags".
148
+ */
149
+ const MLA_MEDIA_MODAL_DETAILS_TAG_METABOX = 'media_modal_details_tag_metabox';
150
+
151
+ /**
152
+ * Provides a unique name for the Media Manager orderby option
153
+ */
154
+ const MLA_MEDIA_MODAL_ORDERBY = 'media_modal_orderby';
155
+
156
+ /**
157
+ * Provides a unique name for the Media Manager order option
158
+ */
159
+ const MLA_MEDIA_MODAL_ORDER = 'media_modal_order';
160
+
161
  /**
162
  * Provides a unique name for the Post MIME Types option
163
  */
496
  'std' => 'checked',
497
  'help' => 'Check this option to enable search box enhancements.'),
498
 
499
+ self::MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX =>
500
+ array('tab' => 'general',
501
+ 'name' => 'Media Manager Searchable Categories metaboxes',
502
+ 'type' => 'checkbox',
503
+ 'std' => '',
504
+ '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.'),
505
+
506
+ self::MLA_MEDIA_MODAL_DETAILS_TAG_METABOX =>
507
+ array('tab' => 'general',
508
+ 'name' => 'Media Manager Searchable Tags metaboxes',
509
+ 'type' => 'checkbox',
510
+ 'std' => '',
511
+ '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.'),
512
+
513
+ self::MLA_MEDIA_MODAL_ORDERBY =>
514
+ array('tab' => '',
515
+ 'name' => 'Media Manager Order By',
516
+ 'type' => 'select',
517
+ 'std' => 'default',
518
+ 'options' => array('default', 'none', 'title_name'),
519
+ 'texts' => array(' -- Media Manager Default -- ', 'None', 'Title/Name'),
520
+ '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.'),
521
+
522
+ self::MLA_MEDIA_MODAL_ORDER =>
523
+ array('tab' => '',
524
+ 'name' => 'Media Manager Order',
525
+ 'type' => 'radio',
526
+ 'std' => 'default',
527
+ 'options' => array('default', 'ASC', 'DESC'),
528
+ 'texts' => array(' -- Media Manager Default -- ', 'Ascending', 'Descending'),
529
+ 'help' => 'Choose the sort order.'),
530
+
531
  'template_header' =>
532
  array('tab' => 'mla_gallery',
533
  'name' => 'Default [mla_gallery] Templates and Settings',
1552
  global $wpdb;
1553
  static $upload_dir, $intermediate_sizes = NULL, $wp_attached_files = NULL, $wp_attachment_metadata = NULL;
1554
  static $current_id = 0, $file_info = NULL, $parent_info = NULL, $references = NULL;
 
1555
  if ( 'none' == $data_value['data_source'] )
1556
  return '';
1557
 
1925
  if ( 'none' == $new_value['data_source'] )
1926
  continue;
1927
 
1928
+ /*
1929
+ * Convert checkbox value(s)
1930
+ */
1931
+ $new_value['no_null'] = isset( $new_value['no_null'] );
1932
+
1933
  $new_text = self::_evaluate_data_source( $post_id, $category, $new_value, $attachment_metadata );
1934
  if ( 'multi' == $new_value['option'] ) {
1935
  if ( ' ' == $new_text ) {
1953
  }
1954
  else {
1955
  if ( $new_value['keep_existing'] ) {
1956
+ if ( 'meta:' == substr( $new_value['name'], 0, 5 ) ) {
1957
+ $meta_key = substr( $new_value['name'], 5 );
1958
+ $attachment_metadata = maybe_unserialize( get_metadata( 'post', $post_id, '_wp_attachment_metadata', true ) );
1959
+ if ( array( $attachment_metadata ) )
1960
+ $old_text = MLAData::mla_find_array_element( $meta_key, $attachment_metadata, 'array' );
1961
+ else
1962
+ $old_text = '';
1963
+ }
1964
+ else {
1965
+ if ( is_string( $old_text = get_metadata( 'post', $post_id, $new_value['name'], true ) ) )
1966
+ $old_text = trim( $old_text );
1967
+ }
1968
 
1969
  if ( ( ' ' != $new_text ) && empty( $old_text ) )
1970
  $custom_updates[ $new_value['name'] ] = $new_text;
2151
  * @param array current custom_field_mapping values
2152
  * @param array new values
2153
  *
2154
+ * @return array ( 'message' => HTML message(s) reflecting results, 'values' => updated custom_field_mapping values, 'changed' => true if any changes detected else false )
2155
  */
2156
  private static function _update_custom_field_mapping( $current_values, $new_values ) {
2157
  $error_list = '';
2222
  continue;
2223
  } // delete rule
2224
  } // isset action
2225
+
2226
+ /*
2227
+ * For "meta:" fields, the UI options are not appropriate
2228
+ */
2229
+ if ( 'meta:' == substr( $new_key, 0, 5 ) ) {
2230
+ unset( $new_value['mla_column'] );
2231
+ unset( $new_value['quick_edit'] );
2232
+ unset( $new_value['bulk_edit'] );
2233
+ }
2234
+
2235
  if ( $old_values['data_source'] != $new_value['data_source'] ) {
2236
  $any_setting_changed = true;
2237
 
 
2238
  if ( in_array( $old_values['data_source'], array( 'meta', 'template' ) ) ) {
2239
  $new_value['meta_name'] = '';
2240
  }
2734
  }
2735
 
2736
  if ( $new_value['keep_existing'] ) {
2737
+ if ( 'meta:' == substr( $new_key, 0, 5 ) ) {
2738
+ $meta_key = substr( $new_key, 5 );
2739
+ $attachment_metadata = maybe_unserialize( get_metadata( 'post', $post->ID, '_wp_attachment_metadata', true ) );
2740
+ if ( array( $attachment_metadata ) )
2741
+ $old_value = MLAData::mla_find_array_element( $meta_key, $attachment_metadata, 'array' );
2742
+ else
2743
+ $old_value = '';
2744
+ }
2745
+ else {
2746
+ if ( is_string( $old_value = get_metadata( 'post', $post->ID, $new_key, true ) ) )
2747
+ $old_value = trim( $old_value );
2748
+ }
2749
+
2750
  if ( ( ! empty( $new_text ) ) && empty( $old_value ) ) {
2751
  $custom_updates[ $new_key ] = $new_text;
2752
  }
includes/class-mla-settings.php CHANGED
@@ -927,14 +927,52 @@ class MLASettings {
927
  }
928
 
929
  /*
930
- * Fill in the current list of sortable columns
 
931
  */
932
- $default_orderby = MLA_List_Table::mla_get_sortable_columns( );
933
- foreach ($default_orderby as $key => $value ) {
934
- MLAOptions::$mla_option_definitions[MLAOptions::MLA_DEFAULT_ORDERBY]['options'][] = $value[0];
935
- MLAOptions::$mla_option_definitions[MLAOptions::MLA_DEFAULT_ORDERBY]['texts'][] = $value[1];
 
936
  }
937
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
938
  $options_list = '';
939
  foreach ( MLAOptions::$mla_option_definitions as $key => $value ) {
940
  if ( 'general' == $value['tab'] )
@@ -2183,7 +2221,8 @@ class MLASettings {
2183
  private static function _compose_documentation_tab( ) {
2184
  $page_template = MLAData::mla_load_template( MLA_PLUGIN_PATH . 'tpls/documentation-settings-tab.tpl' );
2185
  $page_values = array(
2186
- 'phpDocs_url' => MLA_PLUGIN_URL . 'phpDocs/index.html'
 
2187
  );
2188
 
2189
  return array(
927
  }
928
 
929
  /*
930
+ * Fill in the current list of Media/Assistant table sortable columns, sorted by their labels.
931
+ * Make sure the current choice still exists or revert to default.
932
  */
933
+ $columns = array();
934
+ foreach ( MLA_List_Table::mla_get_sortable_columns( ) as $key => $value ) {
935
+ if ( ! array_key_exists( $value[1], $columns ) ) {
936
+ $columns[ $value[1] ] = $value[0];
937
+ }
938
  }
939
 
940
+ uksort( $columns, 'strnatcasecmp' );
941
+ $options = array_merge( array('None' => 'none'), $columns );
942
+ $current = MLAOptions::mla_get_option( MLAOptions::MLA_DEFAULT_ORDERBY );
943
+ MLAOptions::$mla_option_definitions[MLAOptions::MLA_DEFAULT_ORDERBY]['options'] = array();
944
+ MLAOptions::$mla_option_definitions[MLAOptions::MLA_DEFAULT_ORDERBY]['texts'] = array();
945
+ $found_current = false;
946
+ foreach ($options as $key => $value ) {
947
+ MLAOptions::$mla_option_definitions[MLAOptions::MLA_DEFAULT_ORDERBY]['options'][] = $value;
948
+ MLAOptions::$mla_option_definitions[MLAOptions::MLA_DEFAULT_ORDERBY]['texts'][] = $key;
949
+ if ( $current == $value )
950
+ $found_current = true;
951
+ }
952
+
953
+ if ( ! $found_current ) {
954
+ MLAOptions::mla_delete_option( MLAOptions::MLA_DEFAULT_ORDERBY );
955
+ }
956
+
957
+ /*
958
+ * Validate the Media Manager sort order or revert to default
959
+ */
960
+ $options = array_merge( array(' -- Media Manager Default -- ' => 'default', 'None' => 'none'), $columns );
961
+ $current = MLAOptions::mla_get_option( MLAOptions::MLA_MEDIA_MODAL_ORDERBY );
962
+ MLAOptions::$mla_option_definitions[MLAOptions::MLA_MEDIA_MODAL_ORDERBY]['options'] = array();
963
+ MLAOptions::$mla_option_definitions[MLAOptions::MLA_MEDIA_MODAL_ORDERBY]['texts'] = array();
964
+ $found_current = false;
965
+ foreach ($options as $key => $value ) {
966
+ MLAOptions::$mla_option_definitions[MLAOptions::MLA_MEDIA_MODAL_ORDERBY]['options'][] = $value;
967
+ MLAOptions::$mla_option_definitions[MLAOptions::MLA_MEDIA_MODAL_ORDERBY]['texts'][] = $key;
968
+ if ( $current == $value )
969
+ $found_current = true;
970
+ }
971
+
972
+ if ( ! $found_current ) {
973
+ MLAOptions::mla_delete_option( MLAOptions::MLA_MEDIA_MODAL_ORDERBY );
974
+ }
975
+
976
  $options_list = '';
977
  foreach ( MLAOptions::$mla_option_definitions as $key => $value ) {
978
  if ( 'general' == $value['tab'] )
2221
  private static function _compose_documentation_tab( ) {
2222
  $page_template = MLAData::mla_load_template( MLA_PLUGIN_PATH . 'tpls/documentation-settings-tab.tpl' );
2223
  $page_values = array(
2224
+ 'phpDocs_url' => MLA_PLUGIN_URL . 'phpDocs/index.html',
2225
+ 'examples_url' => MLA_PLUGIN_URL . 'examples/'
2226
  );
2227
 
2228
  return array(
includes/class-mla-shortcodes.php CHANGED
@@ -172,13 +172,24 @@ class MLAShortcodes {
172
  elseif ( is_string( $attr ) )
173
  $attr = shortcode_parse_atts( $attr );
174
 
 
 
 
 
 
 
 
 
175
  /*
176
  * Special handling of the mla_paginate_current parameter to make
177
  * "MLA pagination" easier. Look for this parameter in $_REQUEST
178
  * if it's not present in the shortcode itself.
179
  */
180
- if ( isset( $_REQUEST['mla_paginate_current'] ) && ! isset( $attr['mla_paginate_current'] ) )
181
- $attr['mla_paginate_current'] = $_REQUEST['mla_paginate_current'];
 
 
 
182
 
183
  /*
184
  * These are the parameters for gallery display
@@ -262,7 +273,10 @@ class MLAShortcodes {
262
  * Merge gallery arguments with defaults, pass the query arguments on to mla_get_shortcode_attachments.
263
  */
264
 
 
265
  $arguments = shortcode_atts( $default_arguments, $attr );
 
 
266
  self::$mla_debug = !empty( $arguments['mla_debug'] ) && ( 'true' == strtolower( $arguments['mla_debug'] ) );
267
 
268
  /*
@@ -469,7 +483,11 @@ class MLAShortcodes {
469
  $style_values['itemwidth'] = 'auto';
470
  $style_template = preg_replace( '/width:[\s]*\[\+itemwidth\+\][\%]*[\;]*/', '', $style_template );
471
  }
 
 
 
472
  $gallery_style = MLAData::mla_parse_template( $style_template, $style_values );
 
473
 
474
  /*
475
  * Clean up the styles to resolve extra "%" suffixes on width or margin (pre v1.42 values)
@@ -525,11 +543,15 @@ class MLAShortcodes {
525
  $output = '';
526
 
527
  if ($is_gallery ) {
 
 
 
528
  if ( empty( $open_template ) )
529
  $gallery_div = '';
530
  else
531
  $gallery_div = MLAData::mla_parse_template( $open_template, $markup_values );
532
-
 
533
  $output .= apply_filters( 'mla_gallery_style', $gallery_style . $gallery_div, $style_values, $markup_values, $style_template, $open_template );
534
  }
535
  else {
@@ -886,8 +908,12 @@ class MLAShortcodes {
886
  /*
887
  * Start of row markup
888
  */
889
- if ( $markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 )
890
- $output .= MLAData::mla_parse_template( $row_open_template, $markup_values );
 
 
 
 
891
 
892
  /*
893
  * item markup
@@ -897,14 +923,21 @@ class MLAShortcodes {
897
  $item_values['last_in_row'] = 'last_in_row';
898
  else
899
  $item_values['last_in_row'] = '';
900
-
901
- $output .= MLAData::mla_parse_template( $item_template, $item_values );
 
 
 
902
 
903
  /*
904
  * End of row markup
905
  */
906
- if ( $markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 )
907
- $output .= MLAData::mla_parse_template( $row_close_template, $markup_values );
 
 
 
 
908
  } // is_gallery
909
  elseif ( ( $is_previous || $is_next ) )
910
  return $item_values['link'];
@@ -914,10 +947,17 @@ class MLAShortcodes {
914
  /*
915
  * Close out partial row
916
  */
917
- if ( ! ($markup_values['columns'] > 0 && $column_index % $markup_values['columns'] == 0 ) )
918
- $output .= MLAData::mla_parse_template( $row_close_template, $markup_values );
 
 
 
 
919
 
920
- $output .= MLAData::mla_parse_template( $close_template, $markup_values );
 
 
 
921
  } // is_gallery
922
 
923
  return $output;
@@ -967,6 +1007,7 @@ class MLAShortcodes {
967
  $prev_next = true;
968
  }
969
 
 
970
  $current_page = $markup_values['current_page'];
971
  $last_page = $markup_values['last_page'];
972
  $end_size = absint( $arguments['mla_end_size'] );
@@ -993,7 +1034,7 @@ class MLAShortcodes {
993
  if ( $prev_next && $current_page && 1 < $current_page ) {
994
  $markup_values['new_page'] = $current_page - 1;
995
  $new_title = ( ! empty( $arguments['mla_rollover_text'] ) ) ? 'title="' . esc_attr( self::_process_shortcode_parameter( $arguments['mla_rollover_text'], $markup_values ) ) . '" ' : '';
996
- $new_url = add_query_arg( array( 'mla_paginate_current' => $current_page - 1 ), $new_base );
997
  $prev_text = ( ! empty( $arguments['mla_prev_text'] ) ) ? esc_attr( self::_process_shortcode_parameter( $arguments['mla_prev_text'], $markup_values ) ) : '&laquo; Previous';
998
  $page_links[] = sprintf( '<a %1$sclass="prev page-numbers%2$s" %3$s%4$shref="%5$s">%6$s</a>',
999
  /* %1$s */ $new_target,
@@ -1019,7 +1060,7 @@ class MLAShortcodes {
1019
  else {
1020
  if ( $show_all || ( $new_page <= $end_size || ( $current_page && $new_page >= $current_page - $mid_size && $new_page <= $current_page + $mid_size ) || $new_page > $last_page - $end_size ) ) {
1021
  // build link
1022
- $new_url = add_query_arg( array( 'mla_paginate_current' => $new_page ), $new_base );
1023
  $page_links[] = sprintf( '<a %1$sclass="page-numbers%2$s" %3$s%4$shref="%5$s">%6$s</a>',
1024
  /* %1$s */ $new_target,
1025
  /* %2$s */ $new_class,
@@ -1042,7 +1083,7 @@ class MLAShortcodes {
1042
  // build next link
1043
  $markup_values['new_page'] = $current_page + 1;
1044
  $new_title = ( ! empty( $arguments['mla_rollover_text'] ) ) ? 'title="' . esc_attr( self::_process_shortcode_parameter( $arguments['mla_rollover_text'], $markup_values ) ) . '" ' : '';
1045
- $new_url = add_query_arg( array( 'mla_paginate_current' => $current_page + 1 ), $new_base );
1046
  $next_text = ( ! empty( $arguments['mla_next_text'] ) ) ? esc_attr( self::_process_shortcode_parameter( $arguments['mla_next_text'], $markup_values ) ) : 'Next &raquo;';
1047
  $page_links[] = sprintf( '<a %1$sclass="next page-numbers%2$s" %3$s%4$shref="%5$s">%6$s</a>',
1048
  /* %1$s */ $new_target,
@@ -1089,6 +1130,17 @@ class MLAShortcodes {
1089
  */
1090
  $arguments = array_merge( $arguments, shortcode_atts( self::$data_selection_parameters, $attr ) );
1091
  $posts_per_page = absint( $arguments['posts_per_page'] );
 
 
 
 
 
 
 
 
 
 
 
1092
 
1093
  if ( 0 == $posts_per_page )
1094
  $posts_per_page = absint( $arguments['numberposts'] );
@@ -1107,8 +1159,8 @@ class MLAShortcodes {
1107
  if ( isset( $arguments['mla_paginate_total'] ) && $max_page > absint( $arguments['mla_paginate_total'] ) )
1108
  $max_page = absint( $arguments['mla_paginate_total'] );
1109
 
1110
- if ( isset( $arguments['mla_paginate_current'] ) )
1111
- $paged = absint( $arguments['mla_paginate_current'] );
1112
  else
1113
  $paged = absint( $arguments['paged'] );
1114
 
@@ -1185,7 +1237,7 @@ class MLAShortcodes {
1185
  $markup_values['scheme'] = 'http://';
1186
 
1187
  $markup_values['http_host'] = $_SERVER['HTTP_HOST'];
1188
- $markup_values['request_uri'] = add_query_arg( array( 'mla_paginate_current' => $new_page ), $_SERVER['REQUEST_URI'] );
1189
  $markup_values['new_url'] = set_url_scheme( $markup_values['scheme'] . $markup_values['http_host'] . $markup_values['request_uri'] );
1190
 
1191
  /*
@@ -1408,6 +1460,7 @@ class MLAShortcodes {
1408
  'posts_per_archive_page' => 0,
1409
  'paged' => NULL, // page number or 'current'
1410
  'offset' => NULL,
 
1411
  'mla_paginate_current' => NULL,
1412
  'mla_paginate_total' => NULL,
1413
  // TBD Time
@@ -1421,6 +1474,18 @@ class MLAShortcodes {
1421
  's' => ''
1422
  );
1423
 
 
 
 
 
 
 
 
 
 
 
 
 
1424
  /**
1425
  * Parses shortcode parameters and returns the gallery objects
1426
  *
@@ -1432,7 +1497,7 @@ class MLAShortcodes {
1432
  *
1433
  * @return array List of attachments returned from WP_Query
1434
  */
1435
- public static function mla_get_shortcode_attachments( $post_parent, $attr, $return_found_rows = false ) {
1436
  global $wp_query;
1437
 
1438
  /*
@@ -1441,13 +1506,35 @@ class MLAShortcodes {
1441
  self::$query_parameters = array();
1442
 
1443
  /*
1444
- * Merge input arguments with defaults, then extract the query arguments.
1445
  */
1446
-
1447
- if ( is_string( $attr ) )
 
1448
  $attr = shortcode_parse_atts( $attr );
1449
-
 
 
 
 
 
 
 
 
 
1450
  $arguments = shortcode_atts( self::$data_selection_parameters, $attr );
 
 
 
 
 
 
 
 
 
 
 
 
1451
 
1452
  /*
1453
  * 'RAND' is not documented in the codex, but is present in the code.
@@ -1465,6 +1552,9 @@ class MLAShortcodes {
1465
  $arguments['include'] = $arguments['ids'];
1466
  }
1467
  unset( $arguments['ids'] );
 
 
 
1468
 
1469
  /*
1470
  * Extract taxonomy arguments
@@ -1509,6 +1599,7 @@ class MLAShortcodes {
1509
  } //foreach $attr
1510
  } // ! empty
1511
  unset( $arguments['tax_operator'] );
 
1512
 
1513
  /*
1514
  * $query_arguments has been initialized in the taxonomy code above.
@@ -1589,7 +1680,7 @@ class MLAShortcodes {
1589
  $query_arguments[ $key ] = 1;
1590
  unset( $arguments[ $key ] );
1591
  break;
1592
- case 'mla_paginate_current':
1593
  case 'mla_paginate_total':
1594
  if ( is_numeric( $value ) )
1595
  $query_arguments[ $key ] = intval( $value );
@@ -1728,15 +1819,15 @@ class MLAShortcodes {
1728
  /*
1729
  * MLA pagination will override WordPress pagination
1730
  */
1731
- if ( isset( $query_arguments['mla_paginate_current'] ) ) {
1732
  unset( $query_arguments['nopaging'] );
1733
  unset( $query_arguments['offset'] );
1734
  unset( $query_arguments['paged'] );
1735
 
1736
- if ( isset( $query_arguments['mla_paginate_total'] ) && ( $query_arguments['mla_paginate_current'] > $query_arguments['mla_paginate_total'] ) )
1737
  $query_arguments['offset'] = 0x7FFFFFFF; // suppress further output
1738
  else
1739
- $query_arguments['paged'] = $query_arguments['mla_paginate_current'];
1740
  }
1741
  else {
1742
  if ( isset( $query_arguments['posts_per_page'] ) || isset( $query_arguments['posts_per_archive_page'] ) ||
@@ -1744,7 +1835,7 @@ class MLAShortcodes {
1744
  unset( $query_arguments['nopaging'] );
1745
  }
1746
  }
1747
- unset( $query_arguments['mla_paginate_current'] );
1748
  unset( $query_arguments['mla_paginate_total'] );
1749
 
1750
  if ( isset( $query_arguments['post_mime_type'] ) && ('all' == strtolower( $query_arguments['post_mime_type'] ) ) )
@@ -1758,7 +1849,7 @@ class MLAShortcodes {
1758
  $query_arguments['post__not_in'] = wp_parse_id_list( $query_arguments['exclude'] );
1759
 
1760
  $query_arguments['ignore_sticky_posts'] = true;
1761
- $query_arguments['no_found_rows'] = ! $return_found_rows;
1762
 
1763
  /*
1764
  * We will always handle "orderby" in our filter
@@ -1784,11 +1875,20 @@ class MLAShortcodes {
1784
  self::$mla_debug_messages .= '<p><strong>mla_debug $wp_filter[posts_orderby]</strong> = ' . var_export( $wp_filter['posts_orderby'], true ) . '</p>';
1785
  }
1786
 
1787
- $get_posts = new WP_Query;
1788
- $attachments = $get_posts->query($query_arguments);
 
 
 
 
 
 
 
 
 
1789
 
1790
  if ( $return_found_rows ) {
1791
- $attachments['found_rows'] = $get_posts->found_posts;
1792
  }
1793
 
1794
  remove_filter( 'posts_where', 'MLAShortcodes::mla_shortcode_query_posts_where_filter', 0x7FFFFFFF, 1 );
@@ -1799,11 +1899,12 @@ class MLAShortcodes {
1799
  remove_filter( 'posts_clauses_request', 'MLAShortcodes::mla_shortcode_query_posts_clauses_request_filter', 0x7FFFFFFF, 1 );
1800
 
1801
  self::$mla_debug_messages .= '<p><strong>mla_debug query</strong> = ' . var_export( $query_arguments, true ) . '</p>';
1802
- self::$mla_debug_messages .= '<p><strong>mla_debug request</strong> = ' . var_export( $get_posts->request, true ) . '</p>';
1803
- self::$mla_debug_messages .= '<p><strong>mla_debug query_vars</strong> = ' . var_export( $get_posts->query_vars, true ) . '</p>';
1804
- self::$mla_debug_messages .= '<p><strong>mla_debug post_count</strong> = ' . var_export( $get_posts->post_count, true ) . '</p>';
1805
  }
1806
 
 
1807
  return $attachments;
1808
  }
1809
 
172
  elseif ( is_string( $attr ) )
173
  $attr = shortcode_parse_atts( $attr );
174
 
175
+ /*
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
+
183
  /*
184
  * Special handling of the mla_paginate_current parameter to make
185
  * "MLA pagination" easier. Look for this parameter in $_REQUEST
186
  * if it's not present in the shortcode itself.
187
  */
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
273
  * Merge gallery arguments with defaults, pass the query arguments on to mla_get_shortcode_attachments.
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
+
280
  self::$mla_debug = !empty( $arguments['mla_debug'] ) && ( 'true' == strtolower( $arguments['mla_debug'] ) );
281
 
282
  /*
483
  $style_values['itemwidth'] = 'auto';
484
  $style_template = preg_replace( '/width:[\s]*\[\+itemwidth\+\][\%]*[\;]*/', '', $style_template );
485
  }
486
+
487
+ $style_values = apply_filters( 'mla_gallery_style_values', $style_values );
488
+ $style_template = apply_filters( 'mla_gallery_style_template', $style_template );
489
  $gallery_style = MLAData::mla_parse_template( $style_template, $style_values );
490
+ $gallery_style = apply_filters( 'mla_gallery_style_parse', $gallery_style, $style_template, $style_values );
491
 
492
  /*
493
  * Clean up the styles to resolve extra "%" suffixes on width or margin (pre v1.42 values)
543
  $output = '';
544
 
545
  if ($is_gallery ) {
546
+ $markup_values = apply_filters( 'mla_gallery_open_values', $markup_values );
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 {
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
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'];
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;
1007
  $prev_next = true;
1008
  }
1009
 
1010
+ $mla_page_parameter = $arguments['mla_page_parameter'];
1011
  $current_page = $markup_values['current_page'];
1012
  $last_page = $markup_values['last_page'];
1013
  $end_size = absint( $arguments['mla_end_size'] );
1034
  if ( $prev_next && $current_page && 1 < $current_page ) {
1035
  $markup_values['new_page'] = $current_page - 1;
1036
  $new_title = ( ! empty( $arguments['mla_rollover_text'] ) ) ? 'title="' . esc_attr( self::_process_shortcode_parameter( $arguments['mla_rollover_text'], $markup_values ) ) . '" ' : '';
1037
+ $new_url = add_query_arg( array( $mla_page_parameter => $current_page - 1 ), $new_base );
1038
  $prev_text = ( ! empty( $arguments['mla_prev_text'] ) ) ? esc_attr( self::_process_shortcode_parameter( $arguments['mla_prev_text'], $markup_values ) ) : '&laquo; Previous';
1039
  $page_links[] = sprintf( '<a %1$sclass="prev page-numbers%2$s" %3$s%4$shref="%5$s">%6$s</a>',
1040
  /* %1$s */ $new_target,
1060
  else {
1061
  if ( $show_all || ( $new_page <= $end_size || ( $current_page && $new_page >= $current_page - $mid_size && $new_page <= $current_page + $mid_size ) || $new_page > $last_page - $end_size ) ) {
1062
  // build link
1063
+ $new_url = add_query_arg( array( $mla_page_parameter => $new_page ), $new_base );
1064
  $page_links[] = sprintf( '<a %1$sclass="page-numbers%2$s" %3$s%4$shref="%5$s">%6$s</a>',
1065
  /* %1$s */ $new_target,
1066
  /* %2$s */ $new_class,
1083
  // build next link
1084
  $markup_values['new_page'] = $current_page + 1;
1085
  $new_title = ( ! empty( $arguments['mla_rollover_text'] ) ) ? 'title="' . esc_attr( self::_process_shortcode_parameter( $arguments['mla_rollover_text'], $markup_values ) ) . '" ' : '';
1086
+ $new_url = add_query_arg( array( $mla_page_parameter => $current_page + 1 ), $new_base );
1087
  $next_text = ( ! empty( $arguments['mla_next_text'] ) ) ? esc_attr( self::_process_shortcode_parameter( $arguments['mla_next_text'], $markup_values ) ) : 'Next &raquo;';
1088
  $page_links[] = sprintf( '<a %1$sclass="next page-numbers%2$s" %3$s%4$shref="%5$s">%6$s</a>',
1089
  /* %1$s */ $new_target,
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
+
1135
+ /*
1136
+ * $mla_page_parameter, if set, doesn't make it through the shortcode_atts filter,
1137
+ * so we handle it separately
1138
+ */
1139
+ if ( ! isset( $arguments[ $mla_page_parameter ] ) )
1140
+ if ( isset( $attr[ $mla_page_parameter ] ) )
1141
+ $arguments[ $mla_page_parameter ] = $attr[ $mla_page_parameter ];
1142
+ else
1143
+ $arguments[ $mla_page_parameter ] = '';
1144
 
1145
  if ( 0 == $posts_per_page )
1146
  $posts_per_page = absint( $arguments['numberposts'] );
1159
  if ( isset( $arguments['mla_paginate_total'] ) && $max_page > absint( $arguments['mla_paginate_total'] ) )
1160
  $max_page = absint( $arguments['mla_paginate_total'] );
1161
 
1162
+ if ( isset( $arguments[ $mla_page_parameter ] ) )
1163
+ $paged = absint( $arguments[ $mla_page_parameter ] );
1164
  else
1165
  $paged = absint( $arguments['paged'] );
1166
 
1237
  $markup_values['scheme'] = 'http://';
1238
 
1239
  $markup_values['http_host'] = $_SERVER['HTTP_HOST'];
1240
+ $markup_values['request_uri'] = add_query_arg( array( $mla_page_parameter => $new_page ), $_SERVER['REQUEST_URI'] );
1241
  $markup_values['new_url'] = set_url_scheme( $markup_values['scheme'] . $markup_values['http_host'] . $markup_values['request_uri'] );
1242
 
1243
  /*
1460
  'posts_per_archive_page' => 0,
1461
  'paged' => NULL, // page number or 'current'
1462
  'offset' => NULL,
1463
+ 'mla_page_parameter' => 'mla_paginate_current',
1464
  'mla_paginate_current' => NULL,
1465
  'mla_paginate_total' => NULL,
1466
  // TBD Time
1474
  's' => ''
1475
  );
1476
 
1477
+ /**
1478
+ * The WP_Query object used to select items for the gallery.
1479
+ *
1480
+ * Defined as a public, static variable so it can be inspected from the
1481
+ * "mla_gallery_wp_query_object" action. Set to NULL at all other times.
1482
+ *
1483
+ * @since 1.51
1484
+ *
1485
+ * @var object
1486
+ */
1487
+ public static $mla_gallery_wp_query_object = NULL;
1488
+
1489
  /**
1490
  * Parses shortcode parameters and returns the gallery objects
1491
  *
1497
  *
1498
  * @return array List of attachments returned from WP_Query
1499
  */
1500
+ public static function mla_get_shortcode_attachments( $post_parent, $attr, $return_found_rows = NULL ) {
1501
  global $wp_query;
1502
 
1503
  /*
1506
  self::$query_parameters = array();
1507
 
1508
  /*
1509
+ * Make sure $attr is an array, even if it's empty
1510
  */
1511
+ if ( empty( $attr ) )
1512
+ $attr = array();
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
+ *
1519
+ * $return_found_rows is used to indicate that the call comes from gallery_shortcode(),
1520
+ * which is the only call that supplies it.
1521
+ */
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
+
1529
+ /*
1530
+ * $mla_page_parameter, if set, doesn't make it through the shortcode_atts filter,
1531
+ * so we handle it separately
1532
+ */
1533
+ if ( ! isset( $arguments[ $mla_page_parameter ] ) )
1534
+ if ( isset( $attr[ $mla_page_parameter ] ) )
1535
+ $arguments[ $mla_page_parameter ] = $attr[ $mla_page_parameter ];
1536
+ else
1537
+ $arguments[ $mla_page_parameter ] = '';
1538
 
1539
  /*
1540
  * 'RAND' is not documented in the codex, but is present in the code.
1552
  $arguments['include'] = $arguments['ids'];
1553
  }
1554
  unset( $arguments['ids'] );
1555
+
1556
+ if ( ! is_null( $return_found_rows ) )
1557
+ $arguments = apply_filters( 'mla_gallery_query_arguments', $arguments );
1558
 
1559
  /*
1560
  * Extract taxonomy arguments
1599
  } //foreach $attr
1600
  } // ! empty
1601
  unset( $arguments['tax_operator'] );
1602
+ unset( $arguments['tax_include_children'] );
1603
 
1604
  /*
1605
  * $query_arguments has been initialized in the taxonomy code above.
1680
  $query_arguments[ $key ] = 1;
1681
  unset( $arguments[ $key ] );
1682
  break;
1683
+ case $mla_page_parameter :
1684
  case 'mla_paginate_total':
1685
  if ( is_numeric( $value ) )
1686
  $query_arguments[ $key ] = intval( $value );
1819
  /*
1820
  * MLA pagination will override WordPress pagination
1821
  */
1822
+ if ( isset( $query_arguments[ $mla_page_parameter ] ) ) {
1823
  unset( $query_arguments['nopaging'] );
1824
  unset( $query_arguments['offset'] );
1825
  unset( $query_arguments['paged'] );
1826
 
1827
+ if ( isset( $query_arguments['mla_paginate_total'] ) && ( $query_arguments[ $mla_page_parameter ] > $query_arguments['mla_paginate_total'] ) )
1828
  $query_arguments['offset'] = 0x7FFFFFFF; // suppress further output
1829
  else
1830
+ $query_arguments['paged'] = $query_arguments[ $mla_page_parameter ];
1831
  }
1832
  else {
1833
  if ( isset( $query_arguments['posts_per_page'] ) || isset( $query_arguments['posts_per_archive_page'] ) ||
1835
  unset( $query_arguments['nopaging'] );
1836
  }
1837
  }
1838
+ unset( $query_arguments[ $mla_page_parameter ] );
1839
  unset( $query_arguments['mla_paginate_total'] );
1840
 
1841
  if ( isset( $query_arguments['post_mime_type'] ) && ('all' == strtolower( $query_arguments['post_mime_type'] ) ) )
1849
  $query_arguments['post__not_in'] = wp_parse_id_list( $query_arguments['exclude'] );
1850
 
1851
  $query_arguments['ignore_sticky_posts'] = true;
1852
+ $query_arguments['no_found_rows'] = is_null( $return_found_rows ) ? true : ! $return_found_rows;
1853
 
1854
  /*
1855
  * We will always handle "orderby" in our filter
1875
  self::$mla_debug_messages .= '<p><strong>mla_debug $wp_filter[posts_orderby]</strong> = ' . var_export( $wp_filter['posts_orderby'], true ) . '</p>';
1876
  }
1877
 
1878
+ self::$mla_gallery_wp_query_object = new WP_Query;
1879
+ $attachments = self::$mla_gallery_wp_query_object->query($query_arguments);
1880
+
1881
+ /*
1882
+ * $return_found_rows is used to indicate that the call comes from gallery_shortcode(),
1883
+ * which is the only call that supplies it.
1884
+ */
1885
+ if ( is_null( $return_found_rows ) )
1886
+ $return_found_rows = false;
1887
+ else
1888
+ do_action( 'mla_gallery_wp_query_object', $query_arguments );
1889
 
1890
  if ( $return_found_rows ) {
1891
+ $attachments['found_rows'] = self::$mla_gallery_wp_query_object->found_posts;
1892
  }
1893
 
1894
  remove_filter( 'posts_where', 'MLAShortcodes::mla_shortcode_query_posts_where_filter', 0x7FFFFFFF, 1 );
1899
  remove_filter( 'posts_clauses_request', 'MLAShortcodes::mla_shortcode_query_posts_clauses_request_filter', 0x7FFFFFFF, 1 );
1900
 
1901
  self::$mla_debug_messages .= '<p><strong>mla_debug query</strong> = ' . var_export( $query_arguments, true ) . '</p>';
1902
+ self::$mla_debug_messages .= '<p><strong>mla_debug request</strong> = ' . var_export( self::$mla_gallery_wp_query_object->request, true ) . '</p>';
1903
+ self::$mla_debug_messages .= '<p><strong>mla_debug query_vars</strong> = ' . var_export( self::$mla_gallery_wp_query_object->query_vars, true ) . '</p>';
1904
+ self::$mla_debug_messages .= '<p><strong>mla_debug post_count</strong> = ' . var_export( self::$mla_gallery_wp_query_object->post_count, true ) . '</p>';
1905
  }
1906
 
1907
+ self::$mla_gallery_wp_query_object = NULL;
1908
  return $attachments;
1909
  }
1910
 
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.50
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.50
18
  Author URI: http://fairtradejudaica.org/our-story/staff/
19
 
20
  Copyright 2011-2013 David Lingren
6
  * will the rest of the plugin be loaded and run.
7
  *
8
  * @package Media Library Assistant
9
+ * @version 1.51
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.51
18
  Author URI: http://fairtradejudaica.org/our-story/staff/
19
 
20
  Copyright 2011-2013 David Lingren
js/mla-media-modal-scripts.js CHANGED
@@ -8,10 +8,40 @@
8
  originalTrigger.apply(this, Array.prototype.slice.call(arguments));
9
  } // */
10
 
11
- /* // for Network debug
 
 
12
  var originalAjax = media.ajax;
13
- media.ajax = function( action ) {
14
- console.log( 'media.ajax: action = ' + JSON.stringify( action ) );
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
15
  return originalAjax.apply(this, Array.prototype.slice.call(arguments));
16
  }; // */
17
 
@@ -24,6 +54,18 @@
24
  mlaSettings = typeof wp.media.view.settings.mla_settings === 'undefined' ? {} : wp.media.view.settings.mla_settings;
25
  delete wp.media.view.settings.mla_settings;
26
 
 
 
 
 
 
 
 
 
 
 
 
 
27
  /**
28
  * Extended Filters dropdown with more mimeTypes
29
  */
@@ -81,9 +123,7 @@
81
  _.each( mlaSettings.months || {}, function( text, key ) {
82
  filters[ key ] = {
83
  text: text,
84
- props: {
85
- m: key,
86
- }
87
  };
88
  });
89
 
@@ -92,14 +132,25 @@
92
 
93
  select: function() {
94
  var model = this.model,
95
- value = '0', // Show all dates
96
  props = model.toJSON();
97
-
 
 
 
 
 
 
 
 
 
 
 
98
  _.find( this.filters, function( filter, id ) {
99
- var equal = _.all( filter.props, function( prop, key ) {
100
- return prop === ( _.isUndefined( props[ key ] ) ? null : props[ key ] );
101
- });
102
-
103
  if ( equal )
104
  return value = id;
105
  });
@@ -119,9 +170,7 @@
119
  _.each( mlaSettings.termsText || {}, function( text, key ) {
120
  filters[ key ] = {
121
  text: text,
122
- props: {
123
- mla_filter_term: parseInt( mlaSettings.termsValue[ key ] ),
124
- }
125
  };
126
  });
127
 
@@ -130,12 +179,23 @@
130
 
131
  select: function() {
132
  var model = this.model,
133
- value = '0', // All terms
134
  props = model.toJSON();
 
 
 
135
 
 
 
 
 
 
 
 
 
136
  _.find( this.filters, function( filter, id ) {
137
  var equal = _.all( filter.props, function( prop, key ) {
138
- return prop === ( _.isUndefined( props[ key ] ) ? null : props[ key ] );
139
  });
140
 
141
  if ( equal )
@@ -159,8 +219,6 @@
159
  },
160
 
161
  events: {
162
- // 'input': 'search',
163
- // 'keyup': 'search',
164
  'change': 'search',
165
  'click': 'search',
166
  'search': 'search',
@@ -173,53 +231,54 @@
173
  },
174
 
175
  search: function( event ) {
176
- // console.log( 'media.view.MlaSearch search: ' + event.type + ', ' + event.target.name + ', ' + event.target.value );
177
  if ( ( 'click' == event.type ) && ( 'mla_search_submit' != event.target.name ) ) {
178
  return;
179
  }
180
 
181
  switch ( event.target.name ) {
182
- case 'mla_search_value':
183
  mlaSettings.searchValue = event.target.value;
184
  case 'mla_search_submit':
185
- this.model.set({
186
- 's': mlaSettings.searchValue + mlaSettings.searchFields + mlaSettings.searchConnector,
 
187
  'mla_search_value': mlaSettings.searchValue,
188
  'mla_search_fields': mlaSettings.searchFields,
189
- 'mla_search_connector': mlaSettings.searchConnector });
 
190
  break;
191
- case 'mla_search_connector':
192
  mlaSettings.searchConnector = event.target.value;
193
  break;
194
- case 'mla_search_title':
195
  index = mlaSettings.searchFields.indexOf( 'title' );
196
  if ( -1 == index )
197
  mlaSettings.searchFields.push( 'title' )
198
  else
199
  mlaSettings.searchFields.splice( index, 1 );
200
  break;
201
- case 'mla_search_name':
202
  index = mlaSettings.searchFields.indexOf( 'name' );
203
  if ( -1 == index )
204
  mlaSettings.searchFields.push( 'name' )
205
  else
206
  mlaSettings.searchFields.splice( index, 1 );
207
  break;
208
- case 'mla_search_alt_text':
209
  index = mlaSettings.searchFields.indexOf( 'alt-text' );
210
  if ( -1 == index )
211
  mlaSettings.searchFields.push( 'alt-text' )
212
  else
213
  mlaSettings.searchFields.splice( index, 1 );
214
  break;
215
- case 'mla_search_excerpt':
216
  index = mlaSettings.searchFields.indexOf( 'excerpt' );
217
  if ( -1 == index )
218
  mlaSettings.searchFields.push( 'excerpt' )
219
  else
220
  mlaSettings.searchFields.splice( index, 1 );
221
  break;
222
- case 'mla_search_content':
223
  index = mlaSettings.searchFields.indexOf( 'content' );
224
  if ( -1 == index )
225
  mlaSettings.searchFields.push( 'content' )
@@ -233,81 +292,75 @@
233
  /**
234
  * Replace the media-toolbar with our own
235
  */
236
- media.view.AttachmentsBrowser = media.view.AttachmentsBrowser.extend({
237
- createToolbar: function() {
238
- var filters, FiltersConstructor;
239
-
240
- // Add a query arg identifying this as an MLA extended query, so the backend can reroute the request
241
- media.model.Query.defaultArgs.mla_source = 'MLA';
242
-
243
- if ( mlaSettings.enableSearchBox ) {
244
- media.model.Query.defaultArgs.mla_search_value = mlaSettings.searchValue;
245
- media.model.Query.defaultArgs.mla_search_fields = mlaSettings.searchFields;
246
- media.model.Query.defaultArgs.mla_search_connector = mlaSettings.searchConnector;
247
- }
248
-
249
- this.toolbar = new media.view.Toolbar({
250
- controller: this.controller
251
- });
252
-
253
- this.views.add( this.toolbar );
254
-
255
- filters = this.options.filters;
256
- if ( 'uploaded' === filters )
257
- FiltersConstructor = media.view.AttachmentFilters.Uploaded;
258
- else if ( 'all' === filters ) {
259
- if ( mlaSettings.enableMimeTypes )
260
- FiltersConstructor = media.view.AttachmentFilters.Mla;
261
- else
262
- FiltersConstructor = media.view.AttachmentFilters.All;
263
- }
264
-
265
- if ( FiltersConstructor ) {
266
- this.toolbar.set( 'filters', new FiltersConstructor({
267
- controller: this.controller,
268
- model: this.collection.props,
269
- priority: -80
270
- }).render() );
271
- }
272
-
273
- if ( filters && mlaSettings.enableMonthsDropdown ) {
274
- this.toolbar.set( 'months', new media.view.AttachmentFilters.MlaMonths({
275
- controller: this.controller,
276
- model: this.collection.props,
277
- priority: -80
278
- }).render() );
279
- }
280
-
281
- if ( filters && mlaSettings.enableTermsDropdown ) {
282
- this.toolbar.set( 'terms', new media.view.AttachmentFilters.MlaTerms({
283
- controller: this.controller,
284
- model: this.collection.props,
285
- priority: -80
286
- }).render() );
287
- }
288
-
289
- if ( this.options.search ) {
290
- if ( mlaSettings.enableSearchBox ) {
291
- this.toolbar.set( 'MlaSearch', new media.view.MlaSearch({
292
  controller: this.controller,
293
  model: this.collection.props,
294
- priority: 60
295
  }).render() );
296
- } else {
297
- this.toolbar.set( 'search', new media.view.Search({
 
 
298
  controller: this.controller,
299
  model: this.collection.props,
300
- priority: 60
301
  }).render() );
302
  }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
303
  }
304
-
305
- if ( this.options.dragInfo ) {
306
- this.toolbar.set( 'dragInfo', new media.View({
307
- el: $( '<div class="instructions">' + media.view.l10n.dragInfo + '</div>' )[0],
308
- priority: -40
309
- }) );
310
- }
311
- }
312
- });
313
  }(jQuery));
8
  originalTrigger.apply(this, Array.prototype.slice.call(arguments));
9
  } // */
10
 
11
+ /*
12
+ * Parse outgoing Ajax requests and stuff our arguments into the "s" field
13
+ */
14
  var originalAjax = media.ajax;
15
+ media.ajax = function( argumentZero ) {
16
+ if ( 'query-attachments' == argumentZero.data.action ) {
17
+
18
+ stype = typeof arguments[0]['data']['query']['s'];
19
+ if ( 'object' == stype )
20
+ s = arguments[0]['data']['query']['s'];
21
+ else if ( 'string' == stype )
22
+ s = { 'mla_search_value': arguments[0]['data']['query']['s'] };
23
+ else
24
+ s = {};
25
+
26
+ if ( 'undefined' != typeof s.mla_filter_month )
27
+ mlaSettings.filterMonth = s.mla_filter_month;
28
+
29
+ if ( 'undefined' != typeof s.mla_filter_term )
30
+ mlaSettings.filterTerm = s.mla_filter_term;
31
+
32
+ if ( 'undefined' != typeof s.mla_search_value )
33
+ mlaSettings.searchValue = s.mla_search_value;
34
+
35
+ searchValues = {
36
+ 'mla_filter_month': mlaSettings.filterMonth,
37
+ 'mla_filter_term': mlaSettings.filterTerm,
38
+ 'mla_search_value': mlaSettings.searchValue,
39
+ 'mla_search_fields': mlaSettings.searchFields,
40
+ 'mla_search_connector': mlaSettings.searchConnector };
41
+
42
+ arguments[0]['data']['query']['s'] = searchValues;
43
+ }
44
+
45
  return originalAjax.apply(this, Array.prototype.slice.call(arguments));
46
  }; // */
47
 
54
  mlaSettings = typeof wp.media.view.settings.mla_settings === 'undefined' ? {} : wp.media.view.settings.mla_settings;
55
  delete wp.media.view.settings.mla_settings;
56
 
57
+ /*
58
+ * Simulated click to force Attachments update after drag & drop uploading
59
+ * /
60
+ if (typeof wp.Uploader !== 'undefined' && typeof wp.Uploader.queue !== 'undefined') {
61
+ wp.Uploader.queue.on('reset', function() {
62
+
63
+ jQuery(function($){
64
+ $("#search-submit").click();
65
+ });
66
+ });
67
+ } // */
68
+
69
  /**
70
  * Extended Filters dropdown with more mimeTypes
71
  */
123
  _.each( mlaSettings.months || {}, function( text, key ) {
124
  filters[ key ] = {
125
  text: text,
126
+ props: { s: { 'mla_filter_month': key } }
 
 
127
  };
128
  });
129
 
132
 
133
  select: function() {
134
  var model = this.model,
135
+ value = mlaSettings.filterMonth,
136
  props = model.toJSON();
137
+
138
+ if ( _.isUndefined( props.s ) )
139
+ props.s = {};
140
+
141
+ if ( 'string' == typeof props.search )
142
+ mlaSettings.searchValue = props.search;
143
+
144
+ if (_.isUndefined( props.s.mla_filter_month ) )
145
+ props.s.mla_filter_month = mlaSettings.filterMonth;
146
+ else
147
+ mlaSettings.filterMonth = props.s.mla_filter_month;
148
+
149
  _.find( this.filters, function( filter, id ) {
150
+ var equal = _.all( filter.props, function( prop, key ) {
151
+ return prop.mla_filter_month == mlaSettings.filterMonth;
152
+ });
153
+
154
  if ( equal )
155
  return value = id;
156
  });
170
  _.each( mlaSettings.termsText || {}, function( text, key ) {
171
  filters[ key ] = {
172
  text: text,
173
+ props: { s: { 'mla_filter_term': parseInt( mlaSettings.termsValue[ key ] ) } }
 
 
174
  };
175
  });
176
 
179
 
180
  select: function() {
181
  var model = this.model,
182
+ value = mlaSettings.filterTerm,
183
  props = model.toJSON();
184
+
185
+ if ( _.isUndefined( props.s ) )
186
+ props.s = {};
187
 
188
+ if ( 'string' == typeof props.search )
189
+ mlaSettings.searchValue = props.search;
190
+
191
+ if (_.isUndefined( props.s.mla_filter_term ) )
192
+ props.s.mla_filter_term = mlaSettings.filterTerm;
193
+ else
194
+ mlaSettings.filterTerm = props.s.mla_filter_term;
195
+
196
  _.find( this.filters, function( filter, id ) {
197
  var equal = _.all( filter.props, function( prop, key ) {
198
+ return prop.mla_filter_term == mlaSettings.filterTerm;
199
  });
200
 
201
  if ( equal )
219
  },
220
 
221
  events: {
 
 
222
  'change': 'search',
223
  'click': 'search',
224
  'search': 'search',
231
  },
232
 
233
  search: function( event ) {
 
234
  if ( ( 'click' == event.type ) && ( 'mla_search_submit' != event.target.name ) ) {
235
  return;
236
  }
237
 
238
  switch ( event.target.name ) {
239
+ case 's[mla_search_value]':
240
  mlaSettings.searchValue = event.target.value;
241
  case 'mla_search_submit':
242
+ searchValues = {
243
+ 'mla_filter_month': mlaSettings.filterMonth,
244
+ 'mla_filter_term': mlaSettings.filterTerm,
245
  'mla_search_value': mlaSettings.searchValue,
246
  'mla_search_fields': mlaSettings.searchFields,
247
+ 'mla_search_connector': mlaSettings.searchConnector };
248
+ this.model.set({ 's': searchValues });
249
  break;
250
+ case 's[mla_search_connector]':
251
  mlaSettings.searchConnector = event.target.value;
252
  break;
253
+ case 's[mla_search_title]':
254
  index = mlaSettings.searchFields.indexOf( 'title' );
255
  if ( -1 == index )
256
  mlaSettings.searchFields.push( 'title' )
257
  else
258
  mlaSettings.searchFields.splice( index, 1 );
259
  break;
260
+ case 's[mla_search_name]':
261
  index = mlaSettings.searchFields.indexOf( 'name' );
262
  if ( -1 == index )
263
  mlaSettings.searchFields.push( 'name' )
264
  else
265
  mlaSettings.searchFields.splice( index, 1 );
266
  break;
267
+ case 's[mla_search_alt_text]':
268
  index = mlaSettings.searchFields.indexOf( 'alt-text' );
269
  if ( -1 == index )
270
  mlaSettings.searchFields.push( 'alt-text' )
271
  else
272
  mlaSettings.searchFields.splice( index, 1 );
273
  break;
274
+ case 's[mla_search_excerpt]':
275
  index = mlaSettings.searchFields.indexOf( 'excerpt' );
276
  if ( -1 == index )
277
  mlaSettings.searchFields.push( 'excerpt' )
278
  else
279
  mlaSettings.searchFields.splice( index, 1 );
280
  break;
281
+ case 's[mla_search_content]':
282
  index = mlaSettings.searchFields.indexOf( 'content' );
283
  if ( -1 == index )
284
  mlaSettings.searchFields.push( 'content' )
292
  /**
293
  * Replace the media-toolbar with our own
294
  */
295
+ if ( mlaSettings.enableMimeTypes || mlaSettings.enableMonthsDropdown
296
+ || mlaSettings.enableTermsDropdown || mlaSettings.enableSearchBox ) {
297
+ media.view.AttachmentsBrowser = media.view.AttachmentsBrowser.extend({
298
+ createToolbar: function() {
299
+ var filters, FiltersConstructor;
300
+
301
+ this.toolbar = new media.view.Toolbar({
302
+ controller: this.controller
303
+ });
304
+
305
+ this.views.add( this.toolbar );
306
+
307
+ filters = this.options.filters;
308
+ if ( 'uploaded' === filters )
309
+ FiltersConstructor = media.view.AttachmentFilters.Uploaded;
310
+ else if ( 'all' === filters ) {
311
+ if ( mlaSettings.enableMimeTypes )
312
+ FiltersConstructor = media.view.AttachmentFilters.Mla;
313
+ else
314
+ FiltersConstructor = media.view.AttachmentFilters.All;
315
+ }
316
+
317
+ if ( FiltersConstructor ) {
318
+ this.toolbar.set( 'filters', new FiltersConstructor({
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
319
  controller: this.controller,
320
  model: this.collection.props,
321
+ priority: -80
322
  }).render() );
323
+ }
324
+
325
+ if ( filters && mlaSettings.enableMonthsDropdown ) {
326
+ this.toolbar.set( 'months', new media.view.AttachmentFilters.MlaMonths({
327
  controller: this.controller,
328
  model: this.collection.props,
329
+ priority: -80
330
  }).render() );
331
  }
332
+
333
+ if ( filters && mlaSettings.enableTermsDropdown ) {
334
+ this.toolbar.set( 'terms', new media.view.AttachmentFilters.MlaTerms({
335
+ controller: this.controller,
336
+ model: this.collection.props,
337
+ priority: -80
338
+ }).render() );
339
+ }
340
+
341
+ if ( this.options.search ) {
342
+ if ( mlaSettings.enableSearchBox ) {
343
+ this.toolbar.set( 'MlaSearch', new media.view.MlaSearch({
344
+ controller: this.controller,
345
+ model: this.collection.props,
346
+ priority: 60
347
+ }).render() );
348
+ } else {
349
+ this.toolbar.set( 'search', new media.view.Search({
350
+ controller: this.controller,
351
+ model: this.collection.props,
352
+ priority: 60
353
+ }).render() );
354
+ }
355
+ }
356
+
357
+ if ( this.options.dragInfo ) {
358
+ this.toolbar.set( 'dragInfo', new media.View({
359
+ el: $( '<div class="instructions">' + media.view.l10n.dragInfo + '</div>' )[0],
360
+ priority: -40
361
+ }) );
362
+ }
363
  }
364
+ });
365
+ } // one or more MLA options enabled
 
 
 
 
 
 
 
366
  }(jQuery));
js/mla-media-modal-scripts.min.js CHANGED
@@ -1 +1 @@
1
- (function(b){var d=wp.media,c={},a={};c=typeof d.view.l10n.mla_strings==="undefined"?{}:d.view.l10n.mla_strings;delete d.view.l10n.mla_strings;a=typeof wp.media.view.settings.mla_settings==="undefined"?{}:wp.media.view.settings.mla_settings;delete wp.media.view.settings.mla_settings;d.view.AttachmentFilters.Mla=d.view.AttachmentFilters.extend({createFilters:function(){var e={};_.each(a.mimeTypes||{},function(g,f){e[f]={text:g,props:{type:f,uploadedTo:null,orderby:"date",order:"DESC"}}});e.all={text:d.view.l10n.allMediaItems,props:{type:null,uploadedTo:null,orderby:"date",order:"DESC"},priority:10};e.uploaded={text:d.view.l10n.uploadedToThisPost,props:{type:null,uploadedTo:d.view.settings.post.id,orderby:"menuOrder",order:"ASC"},priority:20};this.filters=e}});d.view.AttachmentFilters.MlaMonths=d.view.AttachmentFilters.extend({className:"attachment-months",createFilters:function(){var e={};_.each(a.months||{},function(g,f){e[f]={text:g,props:{m:f,}}});this.filters=e},select:function(){var e=this.model,g="0",f=e.toJSON();_.find(this.filters,function(i,j){var h=_.all(i.props,function(l,k){return l===(_.isUndefined(f[k])?null:f[k])});if(h){return g=j}});this.$el.val(g)}});d.view.AttachmentFilters.MlaTerms=d.view.AttachmentFilters.extend({className:"attachment-terms",createFilters:function(){var e={};_.each(a.termsText||{},function(g,f){e[f]={text:g,props:{mla_filter_term:parseInt(a.termsValue[f]),}}});this.filters=e},select:function(){var e=this.model,g="0",f=e.toJSON();_.find(this.filters,function(i,j){var h=_.all(i.props,function(l,k){return l===(_.isUndefined(f[k])?null:f[k])});if(h){return g=j}});this.$el.val(g)}});d.view.MlaSearch=d.View.extend({tagName:"div",className:"mla-search-box",template:d.template("mla-search-box"),attributes:{type:"mla-search-box",placeholder:c.searchBoxPlaceholder},events:{change:"search",click:"search",search:"search",MlaSearch:"search"},render:function(){this.$el.html(this.template());return this},search:function(e){if(("click"==e.type)&&("mla_search_submit"!=e.target.name)){return}switch(e.target.name){case"mla_search_value":a.searchValue=e.target.value;case"mla_search_submit":this.model.set({s:a.searchValue+a.searchFields+a.searchConnector,mla_search_value:a.searchValue,mla_search_fields:a.searchFields,mla_search_connector:a.searchConnector});break;case"mla_search_connector":a.searchConnector=e.target.value;break;case"mla_search_title":index=a.searchFields.indexOf("title");if(-1==index){a.searchFields.push("title")}else{a.searchFields.splice(index,1)}break;case"mla_search_name":index=a.searchFields.indexOf("name");if(-1==index){a.searchFields.push("name")}else{a.searchFields.splice(index,1)}break;case"mla_search_alt_text":index=a.searchFields.indexOf("alt-text");if(-1==index){a.searchFields.push("alt-text")}else{a.searchFields.splice(index,1)}break;case"mla_search_excerpt":index=a.searchFields.indexOf("excerpt");if(-1==index){a.searchFields.push("excerpt")}else{a.searchFields.splice(index,1)}break;case"mla_search_content":index=a.searchFields.indexOf("content");if(-1==index){a.searchFields.push("content")}else{a.searchFields.splice(index,1)}break}}});d.view.AttachmentsBrowser=d.view.AttachmentsBrowser.extend({createToolbar:function(){var f,e;d.model.Query.defaultArgs.mla_source="MLA";if(a.enableSearchBox){d.model.Query.defaultArgs.mla_search_value=a.searchValue;d.model.Query.defaultArgs.mla_search_fields=a.searchFields;d.model.Query.defaultArgs.mla_search_connector=a.searchConnector}this.toolbar=new d.view.Toolbar({controller:this.controller});this.views.add(this.toolbar);f=this.options.filters;if("uploaded"===f){e=d.view.AttachmentFilters.Uploaded}else{if("all"===f){if(a.enableMimeTypes){e=d.view.AttachmentFilters.Mla}else{e=d.view.AttachmentFilters.All}}}if(e){this.toolbar.set("filters",new e({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(f&&a.enableMonthsDropdown){this.toolbar.set("months",new d.view.AttachmentFilters.MlaMonths({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(f&&a.enableTermsDropdown){this.toolbar.set("terms",new d.view.AttachmentFilters.MlaTerms({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(this.options.search){if(a.enableSearchBox){this.toolbar.set("MlaSearch",new d.view.MlaSearch({controller:this.controller,model:this.collection.props,priority:60}).render())}else{this.toolbar.set("search",new d.view.Search({controller:this.controller,model:this.collection.props,priority:60}).render())}}if(this.options.dragInfo){this.toolbar.set("dragInfo",new d.View({el:b('<div class="instructions">'+d.view.l10n.dragInfo+"</div>")[0],priority:-40}))}}})}(jQuery));
1
+ (function(c){var e=wp.media,d={},a={};var b=e.ajax;e.ajax=function(f){if("query-attachments"==f.data.action){stype=typeof arguments[0]["data"]["query"]["s"];if("object"==stype){s=arguments[0]["data"]["query"]["s"]}else{if("string"==stype){s={mla_search_value:arguments[0]["data"]["query"]["s"]}}else{s={}}}if("undefined"!=typeof s.mla_filter_month){a.filterMonth=s.mla_filter_month}if("undefined"!=typeof s.mla_filter_term){a.filterTerm=s.mla_filter_term}if("undefined"!=typeof s.mla_search_value){a.searchValue=s.mla_search_value}searchValues={mla_filter_month:a.filterMonth,mla_filter_term:a.filterTerm,mla_search_value:a.searchValue,mla_search_fields:a.searchFields,mla_search_connector:a.searchConnector};arguments[0]["data"]["query"]["s"]=searchValues}return b.apply(this,Array.prototype.slice.call(arguments))};d=typeof e.view.l10n.mla_strings==="undefined"?{}:e.view.l10n.mla_strings;delete e.view.l10n.mla_strings;a=typeof wp.media.view.settings.mla_settings==="undefined"?{}:wp.media.view.settings.mla_settings;delete wp.media.view.settings.mla_settings;e.view.AttachmentFilters.Mla=e.view.AttachmentFilters.extend({createFilters:function(){var f={};_.each(a.mimeTypes||{},function(h,g){f[g]={text:h,props:{type:g,uploadedTo:null,orderby:"date",order:"DESC"}}});f.all={text:e.view.l10n.allMediaItems,props:{type:null,uploadedTo:null,orderby:"date",order:"DESC"},priority:10};f.uploaded={text:e.view.l10n.uploadedToThisPost,props:{type:null,uploadedTo:e.view.settings.post.id,orderby:"menuOrder",order:"ASC"},priority:20};this.filters=f}});e.view.AttachmentFilters.MlaMonths=e.view.AttachmentFilters.extend({className:"attachment-months",createFilters:function(){var f={};_.each(a.months||{},function(h,g){f[g]={text:h,props:{s:{mla_filter_month:g}}}});this.filters=f},select:function(){var f=this.model,h=a.filterMonth,g=f.toJSON();if(_.isUndefined(g.s)){g.s={}}if("string"==typeof g.search){a.searchValue=g.search}if(_.isUndefined(g.s.mla_filter_month)){g.s.mla_filter_month=a.filterMonth}else{a.filterMonth=g.s.mla_filter_month}_.find(this.filters,function(j,k){var i=_.all(j.props,function(m,l){return m.mla_filter_month==a.filterMonth});if(i){return h=k}});this.$el.val(h)}});e.view.AttachmentFilters.MlaTerms=e.view.AttachmentFilters.extend({className:"attachment-terms",createFilters:function(){var f={};_.each(a.termsText||{},function(h,g){f[g]={text:h,props:{s:{mla_filter_term:parseInt(a.termsValue[g])}}}});this.filters=f},select:function(){var f=this.model,h=a.filterTerm,g=f.toJSON();if(_.isUndefined(g.s)){g.s={}}if("string"==typeof g.search){a.searchValue=g.search}if(_.isUndefined(g.s.mla_filter_term)){g.s.mla_filter_term=a.filterTerm}else{a.filterTerm=g.s.mla_filter_term}_.find(this.filters,function(j,k){var i=_.all(j.props,function(m,l){return m.mla_filter_term==a.filterTerm});if(i){return h=k}});this.$el.val(h)}});e.view.MlaSearch=e.View.extend({tagName:"div",className:"mla-search-box",template:e.template("mla-search-box"),attributes:{type:"mla-search-box",placeholder:d.searchBoxPlaceholder},events:{change:"search",click:"search",search:"search",MlaSearch:"search"},render:function(){this.$el.html(this.template());return this},search:function(f){if(("click"==f.type)&&("mla_search_submit"!=f.target.name)){return}switch(f.target.name){case"s[mla_search_value]":a.searchValue=f.target.value;case"mla_search_submit":searchValues={mla_filter_month:a.filterMonth,mla_filter_term:a.filterTerm,mla_search_value:a.searchValue,mla_search_fields:a.searchFields,mla_search_connector:a.searchConnector};this.model.set({s:searchValues});break;case"s[mla_search_connector]":a.searchConnector=f.target.value;break;case"s[mla_search_title]":index=a.searchFields.indexOf("title");if(-1==index){a.searchFields.push("title")}else{a.searchFields.splice(index,1)}break;case"s[mla_search_name]":index=a.searchFields.indexOf("name");if(-1==index){a.searchFields.push("name")}else{a.searchFields.splice(index,1)}break;case"s[mla_search_alt_text]":index=a.searchFields.indexOf("alt-text");if(-1==index){a.searchFields.push("alt-text")}else{a.searchFields.splice(index,1)}break;case"s[mla_search_excerpt]":index=a.searchFields.indexOf("excerpt");if(-1==index){a.searchFields.push("excerpt")}else{a.searchFields.splice(index,1)}break;case"s[mla_search_content]":index=a.searchFields.indexOf("content");if(-1==index){a.searchFields.push("content")}else{a.searchFields.splice(index,1)}break}}});if(a.enableMimeTypes||a.enableMonthsDropdown||a.enableTermsDropdown||a.enableSearchBox){e.view.AttachmentsBrowser=e.view.AttachmentsBrowser.extend({createToolbar:function(){var g,f;this.toolbar=new e.view.Toolbar({controller:this.controller});this.views.add(this.toolbar);g=this.options.filters;if("uploaded"===g){f=e.view.AttachmentFilters.Uploaded}else{if("all"===g){if(a.enableMimeTypes){f=e.view.AttachmentFilters.Mla}else{f=e.view.AttachmentFilters.All}}}if(f){this.toolbar.set("filters",new f({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(g&&a.enableMonthsDropdown){this.toolbar.set("months",new e.view.AttachmentFilters.MlaMonths({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(g&&a.enableTermsDropdown){this.toolbar.set("terms",new e.view.AttachmentFilters.MlaTerms({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(this.options.search){if(a.enableSearchBox){this.toolbar.set("MlaSearch",new e.view.MlaSearch({controller:this.controller,model:this.collection.props,priority:60}).render())}else{this.toolbar.set("search",new e.view.Search({controller:this.controller,model:this.collection.props,priority:60}).render())}}if(this.options.dragInfo){this.toolbar.set("dragInfo",new e.View({el:c('<div class="instructions">'+e.view.l10n.dragInfo+"</div>")[0],priority:-40}))}}})}}(jQuery));
phpDocs/classes/MLA.html CHANGED
@@ -675,7 +675,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-09-27T14:55:49-07:00.<br></footer></div>
679
  </div>
680
  </body>
681
  </html>
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>
phpDocs/classes/MLAData.html CHANGED
@@ -58,11 +58,11 @@
58
  <li class="method public "><a href="#mla_count_list_table_items" title="mla_count_list_table_items :: Get the total number of attachment posts"><span class="description">Get the total number of attachment posts</span><pre>mla_count_list_table_items()</pre></a></li>
59
  <li class="method public "><a href="#mla_exif_metadata_value" title="mla_exif_metadata_value :: Parse one EXIF metadata field"><span class="description">Parse one EXIF metadata field</span><pre>mla_exif_metadata_value()</pre></a></li>
60
  <li class="method public "><a href="#mla_expand_field_level_parameters" title="mla_expand_field_level_parameters :: Analyze a template, expanding Field-level Markup Substitution Parameters"><span class="description">Analyze a template, expanding Field-level Markup Substitution Parameters</span><pre>mla_expand_field_level_parameters()</pre></a></li>
61
- <li class="method public "><a href="#mla_fetch_attachment_image_metadata" title="mla_fetch_attachment_image_metadata :: Fetch and filter IPTC and EXIF meta data for an image attachment"><span class="description">Fetch and filter IPTC and EXIF meta data for an image attachment</span><pre>mla_fetch_attachment_image_metadata()</pre></a></li>
62
  <li class="method public "><a href="#mla_fetch_attachment_metadata" title="mla_fetch_attachment_metadata :: Fetch and filter meta data for an attachment"><span class="description">Fetch and filter meta data for an attachment</span><pre>mla_fetch_attachment_metadata()</pre></a></li>
63
  <li class="method public "><a href="#mla_fetch_attachment_parent_data" title="mla_fetch_attachment_parent_data :: Returns information about an attachment's parent, if found"><span class="description">Returns information about an attachment's parent, if found</span><pre>mla_fetch_attachment_parent_data()</pre></a></li>
64
  <li class="method public "><a href="#mla_fetch_attachment_references" title="mla_fetch_attachment_references :: Find Featured Image and inserted image/link references to an attachment"><span class="description">Find Featured Image and inserted image/link references to an attachment</span><pre>mla_fetch_attachment_references()</pre></a></li>
65
- <li class="method public "><a href="#mla_find_array_element" title="mla_find_array_element :: Finds the value of a key in a possibily nested array structure"><span class="description">Finds the value of a key in a possibily nested array structure</span><pre>mla_find_array_element()</pre></a></li>
66
  <li class="method public "><a href="#mla_flush_mla_galleries" title="mla_flush_mla_galleries :: Invalidates the $mla_galleries or $galleries array and cached values"><span class="description">Invalidates the $mla_galleries or $galleries array and cached values</span><pre>mla_flush_mla_galleries()</pre></a></li>
67
  <li class="method public "><a href="#mla_get_attachment_by_id" title="mla_get_attachment_by_id :: Retrieve an Attachment array given a $post_id"><span class="description">Retrieve an Attachment array given a $post_id</span><pre>mla_get_attachment_by_id()</pre></a></li>
68
  <li class="method public "><a href="#mla_get_template_placeholders" title="mla_get_template_placeholders :: Analyze a template, returning an array of the placeholders it contains"><span class="description">Analyze a template, returning an array of the placeholders it contains</span><pre>mla_get_template_placeholders()</pre></a></li>
@@ -78,10 +78,10 @@
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 data for a single attachment."><span class="description">Update custom field 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 meta data
83
- for a single attachment."><span class="description">Update a single item; change the meta data
84
- for a single attachment.</span><pre>mla_update_single_item()</pre></a></li>
85
  <li class="nav-header private">» Private</li>
86
  <li class="method private "><a href="#_bin_to_utf8" title="_bin_to_utf8 :: Replace SQL incorrect characters (0x80 - 0xFF) with their UTF-8 equivalents"><span class="description">Replace SQL incorrect characters (0x80 - 0xFF) with their UTF-8 equivalents</span><pre>_bin_to_utf8()</pre></a></li>
87
  <li class="method private "><a href="#_build_mla_galleries" title="_build_mla_galleries :: Builds the $mla_galleries or $galleries array"><span class="description">Builds the $mla_galleries or $galleries array</span><pre>_build_mla_galleries()</pre></a></li>
@@ -109,8 +109,12 @@ for a single attachment.</span><pre>mla_update_single_item()</pre></a></li>
109
  <li class="method private "><a href="#_parse_xmp_metadata" title="_parse_xmp_metadata :: Parse an XMP object"><span class="description">Parse an XMP object</span><pre>_parse_xmp_metadata()</pre></a></li>
110
  <li class="method private "><a href="#_prepare_list_table_query" title="_prepare_list_table_query :: Sanitize and expand query arguments from request variables"><span class="description">Sanitize and expand query arguments from request variables</span><pre>_prepare_list_table_query()</pre></a></li>
111
  <li class="method private "><a href="#_process_field_level_array" title="_process_field_level_array :: Process an markup field array value according to the supplied data-format option"><span class="description">Process an markup field array value according to the supplied data-format option</span><pre>_process_field_level_array()</pre></a></li>
 
112
  <li class="method private "><a href="#_remove_tags" title="_remove_tags :: Remove tags from a term ids list"><span class="description">Remove tags from a term ids list</span><pre>_remove_tags()</pre></a></li>
113
  <li class="method private "><a href="#_search_mla_galleries" title="_search_mla_galleries :: Search the $mla_galleries or $galleries array"><span class="description">Search the $mla_galleries or $galleries array</span><pre>_search_mla_galleries()</pre></a></li>
 
 
 
114
  <li class="nav-header">
115
  <i class="icon-custom icon-property"></i> Properties</li>
116
  <li class="property public "><a href="#%24mla_iptc_keys" title="$mla_iptc_keys :: IPTC Dataset friendly name/slug and identifiers"><span class="description">IPTC Dataset friendly name/slug and identifiers</span><pre>$mla_iptc_keys</pre></a></li>
@@ -260,11 +264,11 @@ All but request and query require an attachment ID.</p></p>
260
  </div></div>
261
  </div>
262
  <a name="mla_fetch_attachment_image_metadata" id="mla_fetch_attachment_image_metadata"></a><div class="element clickable method public mla_fetch_attachment_image_metadata" data-toggle="collapse" data-target=".mla_fetch_attachment_image_metadata .collapse">
263
- <h2>Fetch and filter IPTC and EXIF meta data for an image attachment</h2>
264
  <pre>mla_fetch_attachment_image_metadata(int $post_id, string $path) : array</pre>
265
  <div class="labels"></div>
266
  <div class="row collapse"><div class="detail-description">
267
- <p class="long_description"><p>Returns</p></p>
268
  <table class="table table-bordered"><tr>
269
  <th>since</th>
270
  <td>0.90</td>
@@ -279,7 +283,7 @@ All but request and query require an attachment ID.</p></p>
279
  </div>
280
  <h3>Returns</h3>
281
  <div class="subelement response">
282
- <code>array</code>Meta data variables</div>
283
  </div></div>
284
  </div>
285
  <a name="mla_fetch_attachment_metadata" id="mla_fetch_attachment_metadata"></a><div class="element clickable method public mla_fetch_attachment_metadata" data-toggle="collapse" data-target=".mla_fetch_attachment_metadata .collapse">
@@ -288,8 +292,7 @@ All but request and query require an attachment ID.</p></p>
288
  <div class="labels"></div>
289
  <div class="row collapse"><div class="detail-description">
290
  <p class="long_description"><p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
291
- are stripped out or converted to an 'mla</em>' equivalent. Array data is replaced with
292
- a string containing the first array element.</p></p>
293
  <table class="table table-bordered"><tr>
294
  <th>since</th>
295
  <td>0.1</td>
@@ -348,8 +351,8 @@ as a Featured Image or inserted in the post as an image or link.</p></p>
348
  </div></div>
349
  </div>
350
  <a name="mla_find_array_element" id="mla_find_array_element"></a><div class="element clickable method public mla_find_array_element" data-toggle="collapse" data-target=".mla_find_array_element .collapse">
351
- <h2>Finds the value of a key in a possibily nested array structure</h2>
352
- <pre>mla_find_array_element(string $needle, array $haystack, string $option, boolean $keep_existing) : string</pre>
353
  <div class="labels"></div>
354
  <div class="row collapse"><div class="detail-description">
355
  <p class="long_description"><p>Used primarily to extract fields from the _wp_attachment_metadata custom field.
@@ -375,7 +378,7 @@ Could also be used with the ID3 metadata exposed in WordPress 3.6 and later.</p>
375
  </div>
376
  <h3>Returns</h3>
377
  <div class="subelement response">
378
- <code>string</code>value matching key(.key ...) or ''</div>
379
  </div></div>
380
  </div>
381
  <a name="mla_flush_mla_galleries" id="mla_flush_mla_galleries"></a><div class="element clickable method public mla_flush_mla_galleries" data-toggle="collapse" data-target=".mla_flush_mla_galleries .collapse">
@@ -713,7 +716,7 @@ Defined as public because it's a filter.</p></p>
713
  </div></div>
714
  </div>
715
  <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">
716
- <h2>Update custom field data for a single attachment.</h2>
717
  <pre>mla_update_item_postmeta(int $post_id, array $new_meta) : string</pre>
718
  <div class="labels"></div>
719
  <div class="row collapse"><div class="detail-description">
@@ -736,8 +739,8 @@ Defined as public because it's a filter.</p></p>
736
  </div></div>
737
  </div>
738
  <a name="mla_update_single_item" id="mla_update_single_item"></a><div class="element clickable method public mla_update_single_item" data-toggle="collapse" data-target=".mla_update_single_item .collapse">
739
- <h2>Update a single item; change the meta data
740
- for a single attachment.</h2>
741
  <pre>mla_update_single_item(int $post_id, array $new_data, array $tax_input, array $tax_actions) : array</pre>
742
  <div class="labels"></div>
743
  <div class="row collapse"><div class="detail-description">
@@ -1005,7 +1008,7 @@ This is required because Adobe Acrobat does NOT increment the generation number
1005
  <h3>Parameters</h3>
1006
  <div class="subelement argument">
1007
  <h4>$tpl</h4>
1008
- <code>string</code><p>A string possibily starting with '[+template:'</p>
1009
  </div>
1010
  <h3>Returns</h3>
1011
  <div class="subelement response">
@@ -1025,7 +1028,7 @@ This is required because Adobe Acrobat does NOT increment the generation number
1025
  <h3>Parameters</h3>
1026
  <div class="subelement argument">
1027
  <h4>$tpl</h4>
1028
- <code>string</code><p>A string possibily starting with '('</p>
1029
  </div>
1030
  <h3>Returns</h3>
1031
  <div class="subelement response">
@@ -1371,6 +1374,26 @@ Modeled after wp_edit_attachments_query in wp-admin/post.php</p></p>
1371
  <code>array</code>( parameter => value ) for all field-level parameters and anything in $markup_values</div>
1372
  </div></div>
1373
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1374
  <a name="_remove_tags" id="_remove_tags"></a><div class="element clickable method private _remove_tags" data-toggle="collapse" data-target="._remove_tags .collapse">
1375
  <h2>Remove tags from a term ids list</h2>
1376
  <pre>_remove_tags(array $terms_before, array $tags, object $taxonomy_obj) : array</pre>
@@ -1419,6 +1442,76 @@ Modeled after wp_edit_attachments_query in wp-admin/post.php</p></p>
1419
  <code>array</code>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.</div>
1420
  </div></div>
1421
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1422
  <h3>
1423
  <i class="icon-custom icon-property"></i> Properties</h3>
1424
  <a name="%24mla_iptc_keys" id="$mla_iptc_keys"> </a><div class="element clickable property public $mla_iptc_keys" data-toggle="collapse" data-target=".$mla_iptc_keys .collapse">
@@ -1609,7 +1702,7 @@ any further logic required to translate those values is contained in the filters
1609
  <div class="row"><footer class="span12">
1610
  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>
1611
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1612
- generated on 2013-09-27T14:55:49-07:00.<br></footer></div>
1613
  </div>
1614
  </body>
1615
  </html>
58
  <li class="method public "><a href="#mla_count_list_table_items" title="mla_count_list_table_items :: Get the total number of attachment posts"><span class="description">Get the total number of attachment posts</span><pre>mla_count_list_table_items()</pre></a></li>
59
  <li class="method public "><a href="#mla_exif_metadata_value" title="mla_exif_metadata_value :: Parse one EXIF metadata field"><span class="description">Parse one EXIF metadata field</span><pre>mla_exif_metadata_value()</pre></a></li>
60
  <li class="method public "><a href="#mla_expand_field_level_parameters" title="mla_expand_field_level_parameters :: Analyze a template, expanding Field-level Markup Substitution Parameters"><span class="description">Analyze a template, expanding Field-level Markup Substitution Parameters</span><pre>mla_expand_field_level_parameters()</pre></a></li>
61
+ <li class="method public "><a href="#mla_fetch_attachment_image_metadata" title="mla_fetch_attachment_image_metadata :: Fetch and filter IPTC and EXIF or PDF metadata for an image attachment"><span class="description">Fetch and filter IPTC and EXIF or PDF metadata for an image attachment</span><pre>mla_fetch_attachment_image_metadata()</pre></a></li>
62
  <li class="method public "><a href="#mla_fetch_attachment_metadata" title="mla_fetch_attachment_metadata :: Fetch and filter meta data for an attachment"><span class="description">Fetch and filter meta data for an attachment</span><pre>mla_fetch_attachment_metadata()</pre></a></li>
63
  <li class="method public "><a href="#mla_fetch_attachment_parent_data" title="mla_fetch_attachment_parent_data :: Returns information about an attachment's parent, if found"><span class="description">Returns information about an attachment's parent, if found</span><pre>mla_fetch_attachment_parent_data()</pre></a></li>
64
  <li class="method public "><a href="#mla_fetch_attachment_references" title="mla_fetch_attachment_references :: Find Featured Image and inserted image/link references to an attachment"><span class="description">Find Featured Image and inserted image/link references to an attachment</span><pre>mla_fetch_attachment_references()</pre></a></li>
65
+ <li class="method public "><a href="#mla_find_array_element" title="mla_find_array_element :: Finds the value of a key in a possibly nested array structure"><span class="description">Finds the value of a key in a possibly nested array structure</span><pre>mla_find_array_element()</pre></a></li>
66
  <li class="method public "><a href="#mla_flush_mla_galleries" title="mla_flush_mla_galleries :: Invalidates the $mla_galleries or $galleries array and cached values"><span class="description">Invalidates the $mla_galleries or $galleries array and cached values</span><pre>mla_flush_mla_galleries()</pre></a></li>
67
  <li class="method public "><a href="#mla_get_attachment_by_id" title="mla_get_attachment_by_id :: Retrieve an Attachment array given a $post_id"><span class="description">Retrieve an Attachment array given a $post_id</span><pre>mla_get_attachment_by_id()</pre></a></li>
68
  <li class="method public "><a href="#mla_get_template_placeholders" title="mla_get_template_placeholders :: Analyze a template, returning an array of the placeholders it contains"><span class="description">Analyze a template, returning an array of the placeholders it contains</span><pre>mla_get_template_placeholders()</pre></a></li>
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
84
+ and meta data for a single attachment</span><pre>mla_update_single_item()</pre></a></li>
85
  <li class="nav-header private">» Private</li>
86
  <li class="method private "><a href="#_bin_to_utf8" title="_bin_to_utf8 :: Replace SQL incorrect characters (0x80 - 0xFF) with their UTF-8 equivalents"><span class="description">Replace SQL incorrect characters (0x80 - 0xFF) with their UTF-8 equivalents</span><pre>_bin_to_utf8()</pre></a></li>
87
  <li class="method private "><a href="#_build_mla_galleries" title="_build_mla_galleries :: Builds the $mla_galleries or $galleries array"><span class="description">Builds the $mla_galleries or $galleries array</span><pre>_build_mla_galleries()</pre></a></li>
109
  <li class="method private "><a href="#_parse_xmp_metadata" title="_parse_xmp_metadata :: Parse an XMP object"><span class="description">Parse an XMP object</span><pre>_parse_xmp_metadata()</pre></a></li>
110
  <li class="method private "><a href="#_prepare_list_table_query" title="_prepare_list_table_query :: Sanitize and expand query arguments from request variables"><span class="description">Sanitize and expand query arguments from request variables</span><pre>_prepare_list_table_query()</pre></a></li>
111
  <li class="method private "><a href="#_process_field_level_array" title="_process_field_level_array :: Process an markup field array value according to the supplied data-format option"><span class="description">Process an markup field array value according to the supplied data-format option</span><pre>_process_field_level_array()</pre></a></li>
112
+ <li class="method private "><a href="#_rational_to_decimal" title="_rational_to_decimal :: Convert an EXIF GPS rational value to a PHP float value"><span class="description">Convert an EXIF GPS rational value to a PHP float value</span><pre>_rational_to_decimal()</pre></a></li>
113
  <li class="method private "><a href="#_remove_tags" title="_remove_tags :: Remove tags from a term ids list"><span class="description">Remove tags from a term ids list</span><pre>_remove_tags()</pre></a></li>
114
  <li class="method private "><a href="#_search_mla_galleries" title="_search_mla_galleries :: Search the $mla_galleries or $galleries array"><span class="description">Search the $mla_galleries or $galleries array</span><pre>_search_mla_galleries()</pre></a></li>
115
+ <li class="method private "><a href="#_set_array_element" title="_set_array_element :: Adds or replaces the value of a key in a possibly nested array structure"><span class="description">Adds or replaces the value of a key in a possibly nested array structure</span><pre>_set_array_element()</pre></a></li>
116
+ <li class="method private "><a href="#_unset_array_element" title="_unset_array_element :: Deletes the value of a key in a possibly nested array structure"><span class="description">Deletes the value of a key in a possibly nested array structure</span><pre>_unset_array_element()</pre></a></li>
117
+ <li class="method private "><a href="#_update_wp_attachment_metadata" title='_update_wp_attachment_metadata :: Update one "meta:" data for a single attachment'><span class="description">Update one "meta:" data for a single attachment</span><pre>_update_wp_attachment_metadata()</pre></a></li>
118
  <li class="nav-header">
119
  <i class="icon-custom icon-property"></i> Properties</li>
120
  <li class="property public "><a href="#%24mla_iptc_keys" title="$mla_iptc_keys :: IPTC Dataset friendly name/slug and identifiers"><span class="description">IPTC Dataset friendly name/slug and identifiers</span><pre>$mla_iptc_keys</pre></a></li>
264
  </div></div>
265
  </div>
266
  <a name="mla_fetch_attachment_image_metadata" id="mla_fetch_attachment_image_metadata"></a><div class="element clickable method public mla_fetch_attachment_image_metadata" data-toggle="collapse" data-target=".mla_fetch_attachment_image_metadata .collapse">
267
+ <h2>Fetch and filter IPTC and EXIF or PDF metadata for an image attachment</h2>
268
  <pre>mla_fetch_attachment_image_metadata(int $post_id, string $path) : array</pre>
269
  <div class="labels"></div>
270
  <div class="row collapse"><div class="detail-description">
271
+ <p class="long_description"></p>
272
  <table class="table table-bordered"><tr>
273
  <th>since</th>
274
  <td>0.90</td>
283
  </div>
284
  <h3>Returns</h3>
285
  <div class="subelement response">
286
+ <code>array</code>Meta data variables, IPTC and EXIF or PDF</div>
287
  </div></div>
288
  </div>
289
  <a name="mla_fetch_attachment_metadata" id="mla_fetch_attachment_metadata"></a><div class="element clickable method public mla_fetch_attachment_metadata" data-toggle="collapse" data-target=".mla_fetch_attachment_metadata .collapse">
292
  <div class="labels"></div>
293
  <div class="row collapse"><div class="detail-description">
294
  <p class="long_description"><p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
295
+ are stripped out or converted to an 'mla</em>' equivalent.</p></p>
 
296
  <table class="table table-bordered"><tr>
297
  <th>since</th>
298
  <td>0.1</td>
351
  </div></div>
352
  </div>
353
  <a name="mla_find_array_element" id="mla_find_array_element"></a><div class="element clickable method public mla_find_array_element" data-toggle="collapse" data-target=".mla_find_array_element .collapse">
354
+ <h2>Finds the value of a key in a possibly nested array structure</h2>
355
+ <pre>mla_find_array_element(string $needle, array $haystack, string $option, boolean $keep_existing) : mixed</pre>
356
  <div class="labels"></div>
357
  <div class="row collapse"><div class="detail-description">
358
  <p class="long_description"><p>Used primarily to extract fields from the _wp_attachment_metadata custom field.
378
  </div>
379
  <h3>Returns</h3>
380
  <div class="subelement response">
381
+ <code>mixed</code>string or array value matching key(.key ...) or ''</div>
382
  </div></div>
383
  </div>
384
  <a name="mla_flush_mla_galleries" id="mla_flush_mla_galleries"></a><div class="element clickable method public mla_flush_mla_galleries" data-toggle="collapse" data-target=".mla_flush_mla_galleries .collapse">
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>
721
  <div class="labels"></div>
722
  <div class="row collapse"><div class="detail-description">
739
  </div></div>
740
  </div>
741
  <a name="mla_update_single_item" id="mla_update_single_item"></a><div class="element clickable method public mla_update_single_item" data-toggle="collapse" data-target=".mla_update_single_item .collapse">
742
+ <h2>Update a single item; change the "post" data, taxonomy terms
743
+ and meta data for a single attachment</h2>
744
  <pre>mla_update_single_item(int $post_id, array $new_data, array $tax_input, array $tax_actions) : array</pre>
745
  <div class="labels"></div>
746
  <div class="row collapse"><div class="detail-description">
1008
  <h3>Parameters</h3>
1009
  <div class="subelement argument">
1010
  <h4>$tpl</h4>
1011
+ <code>string</code><p>A string possibly starting with '[+template:'</p>
1012
  </div>
1013
  <h3>Returns</h3>
1014
  <div class="subelement response">
1028
  <h3>Parameters</h3>
1029
  <div class="subelement argument">
1030
  <h4>$tpl</h4>
1031
+ <code>string</code><p>A string possibly starting with '('</p>
1032
  </div>
1033
  <h3>Returns</h3>
1034
  <div class="subelement response">
1374
  <code>array</code>( parameter => value ) for all field-level parameters and anything in $markup_values</div>
1375
  </div></div>
1376
  </div>
1377
+ <a name="_rational_to_decimal" id="_rational_to_decimal"></a><div class="element clickable method private _rational_to_decimal" data-toggle="collapse" data-target="._rational_to_decimal .collapse">
1378
+ <h2>Convert an EXIF GPS rational value to a PHP float value</h2>
1379
+ <pre>_rational_to_decimal(array $rational) : float</pre>
1380
+ <div class="labels"></div>
1381
+ <div class="row collapse"><div class="detail-description">
1382
+ <p class="long_description"></p>
1383
+ <table class="table table-bordered"><tr>
1384
+ <th>since</th>
1385
+ <td>1.50</td>
1386
+ </tr></table>
1387
+ <h3>Parameters</h3>
1388
+ <div class="subelement argument">
1389
+ <h4>$rational</h4>
1390
+ <code>array</code><p>array( 0 => numerator, 1 => denominator )</p>
1391
+ </div>
1392
+ <h3>Returns</h3>
1393
+ <div class="subelement response">
1394
+ <code>float</code>numerator/denominator</div>
1395
+ </div></div>
1396
+ </div>
1397
  <a name="_remove_tags" id="_remove_tags"></a><div class="element clickable method private _remove_tags" data-toggle="collapse" data-target="._remove_tags .collapse">
1398
  <h2>Remove tags from a term ids list</h2>
1399
  <pre>_remove_tags(array $terms_before, array $tags, object $taxonomy_obj) : array</pre>
1442
  <code>array</code>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.</div>
1443
  </div></div>
1444
  </div>
1445
+ <a name="_set_array_element" id="_set_array_element"></a><div class="element clickable method private _set_array_element" data-toggle="collapse" data-target="._set_array_element .collapse">
1446
+ <h2>Adds or replaces the value of a key in a possibly nested array structure</h2>
1447
+ <pre>_set_array_element(string $needle, mixed $value, array $haystack) : boolean</pre>
1448
+ <div class="labels"></div>
1449
+ <div class="row collapse"><div class="detail-description">
1450
+ <p class="long_description"></p>
1451
+ <table class="table table-bordered"><tr>
1452
+ <th>since</th>
1453
+ <td>1.51</td>
1454
+ </tr></table>
1455
+ <h3>Parameters</h3>
1456
+ <div class="subelement argument">
1457
+ <h4>$needle</h4>
1458
+ <code>string</code><p>key value, e.g. array1.array2.element</p></div>
1459
+ <div class="subelement argument">
1460
+ <h4>$value</h4>
1461
+ <code>mixed</code><p>replacement value, string or array, by reference</p></div>
1462
+ <div class="subelement argument">
1463
+ <h4>$haystack</h4>
1464
+ <code>array</code><p>PHP nested arrays, by reference</p></div>
1465
+ <h3>Returns</h3>
1466
+ <div class="subelement response">
1467
+ <code>boolean</code>true if $needle element set, false if not</div>
1468
+ </div></div>
1469
+ </div>
1470
+ <a name="_unset_array_element" id="_unset_array_element"></a><div class="element clickable method private _unset_array_element" data-toggle="collapse" data-target="._unset_array_element .collapse">
1471
+ <h2>Deletes the value of a key in a possibly nested array structure</h2>
1472
+ <pre>_unset_array_element(string $needle, array $haystack) : boolean</pre>
1473
+ <div class="labels"></div>
1474
+ <div class="row collapse"><div class="detail-description">
1475
+ <p class="long_description"></p>
1476
+ <table class="table table-bordered"><tr>
1477
+ <th>since</th>
1478
+ <td>1.51</td>
1479
+ </tr></table>
1480
+ <h3>Parameters</h3>
1481
+ <div class="subelement argument">
1482
+ <h4>$needle</h4>
1483
+ <code>string</code><p>key value, e.g. array1.array2.element</p></div>
1484
+ <div class="subelement argument">
1485
+ <h4>$haystack</h4>
1486
+ <code>array</code><p>PHP nested arrays, by reference</p></div>
1487
+ <h3>Returns</h3>
1488
+ <div class="subelement response">
1489
+ <code>boolean</code>true if $needle element found, false if not</div>
1490
+ </div></div>
1491
+ </div>
1492
+ <a name="_update_wp_attachment_metadata" id="_update_wp_attachment_metadata"></a><div class="element clickable method private _update_wp_attachment_metadata" data-toggle="collapse" data-target="._update_wp_attachment_metadata .collapse">
1493
+ <h2>Update one "meta:" data for a single attachment</h2>
1494
+ <pre>_update_wp_attachment_metadata(array $current_values, array $new_meta) : string</pre>
1495
+ <div class="labels"></div>
1496
+ <div class="row collapse"><div class="detail-description">
1497
+ <p class="long_description"></p>
1498
+ <table class="table table-bordered"><tr>
1499
+ <th>since</th>
1500
+ <td>1.51</td>
1501
+ </tr></table>
1502
+ <h3>Parameters</h3>
1503
+ <div class="subelement argument">
1504
+ <h4>$current_values</h4>
1505
+ <code>array</code><p>The current wp_attachment_metadata value</p></div>
1506
+ <div class="subelement argument">
1507
+ <h4>$new_meta</h4>
1508
+ <code>array</code><p>Field name => value pairs</p>
1509
+ </div>
1510
+ <h3>Returns</h3>
1511
+ <div class="subelement response">
1512
+ <code>string</code>success/failure message(s); empty string if no changes.</div>
1513
+ </div></div>
1514
+ </div>
1515
  <h3>
1516
  <i class="icon-custom icon-property"></i> Properties</h3>
1517
  <a name="%24mla_iptc_keys" id="$mla_iptc_keys"> </a><div class="element clickable property public $mla_iptc_keys" data-toggle="collapse" data-target=".$mla_iptc_keys .collapse">
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>
phpDocs/classes/MLAEdit.html CHANGED
@@ -56,8 +56,8 @@
56
  <i class="icon-custom icon-method"></i> Methods</li>
57
  <li class="method public "><a href="#initialize" title="initialize :: Initialization function, similar to __construct()"><span class="description">Initialization function, similar to __construct()</span><pre>initialize()</pre></a></li>
58
  <li class="method public "><a href="#mla_add_meta_boxes_action" title="mla_add_meta_boxes_action :: Registers meta boxes for the Edit Media screen."><span class="description">Registers meta boxes for the Edit Media screen.</span><pre>mla_add_meta_boxes_action()</pre></a></li>
 
59
  <li class="method public "><a href="#mla_attachment_submitbox_action" title="mla_attachment_submitbox_action :: Adds Last Modified date to the Submit box on the Edit Media screen."><span class="description">Adds Last Modified date to the Submit box on the Edit Media screen.</span><pre>mla_attachment_submitbox_action()</pre></a></li>
60
- <li class="method public "><a href="#mla_custom_field_support_action" title="mla_custom_field_support_action :: Adds Custom Field support to the Edit Media screen."><span class="description">Adds Custom Field support to the Edit Media screen.</span><pre>mla_custom_field_support_action()</pre></a></li>
61
  <li class="method public "><a href="#mla_edit_add_help_tab" title="mla_edit_add_help_tab :: Add contextual help tabs to the WordPress Edit Media page"><span class="description">Add contextual help tabs to the WordPress Edit Media page</span><pre>mla_edit_add_help_tab()</pre></a></li>
62
  <li class="method public "><a href="#mla_edit_attachment_action" title="mla_edit_attachment_action :: Saves updates from the Edit Media screen."><span class="description">Saves updates from the Edit Media screen.</span><pre>mla_edit_attachment_action()</pre></a></li>
63
  <li class="method public "><a href="#mla_featured_in_handler" title="mla_featured_in_handler :: Renders the Featured in meta box on the Edit Media page."><span class="description">Renders the Featured in meta box on the Edit Media page.</span><pre>mla_featured_in_handler()</pre></a></li>
@@ -133,9 +133,9 @@
133
  </div>
134
  </div></div>
135
  </div>
136
- <a name="mla_attachment_submitbox_action" id="mla_attachment_submitbox_action"></a><div class="element clickable method public mla_attachment_submitbox_action" data-toggle="collapse" data-target=".mla_attachment_submitbox_action .collapse">
137
- <h2>Adds Last Modified date to the Submit box on the Edit Media screen.</h2>
138
- <pre>mla_attachment_submitbox_action() : void</pre>
139
  <div class="labels"></div>
140
  <div class="row collapse"><div class="detail-description">
141
  <p class="long_description"><p>Declared public because it is an action.</p></p>
@@ -145,9 +145,9 @@
145
  </tr></table>
146
  </div></div>
147
  </div>
148
- <a name="mla_custom_field_support_action" id="mla_custom_field_support_action"></a><div class="element clickable method public mla_custom_field_support_action" data-toggle="collapse" data-target=".mla_custom_field_support_action .collapse">
149
- <h2>Adds Custom Field support to the Edit Media screen.</h2>
150
- <pre>mla_custom_field_support_action() : void</pre>
151
  <div class="labels"></div>
152
  <div class="row collapse"><div class="detail-description">
153
  <p class="long_description"><p>Declared public because it is an action.</p></p>
@@ -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-09-27T14:55:49-07:00.<br></footer></div>
349
  </div>
350
  </body>
351
  </html>
56
  <i class="icon-custom icon-method"></i> Methods</li>
57
  <li class="method public "><a href="#initialize" title="initialize :: Initialization function, similar to __construct()"><span class="description">Initialization function, similar to __construct()</span><pre>initialize()</pre></a></li>
58
  <li class="method public "><a href="#mla_add_meta_boxes_action" title="mla_add_meta_boxes_action :: Registers meta boxes for the Edit Media screen."><span class="description">Registers meta boxes for the Edit Media screen.</span><pre>mla_add_meta_boxes_action()</pre></a></li>
59
+ <li class="method public "><a href="#mla_admin_init_action" title="mla_admin_init_action :: Adds Custom Field support to the Edit Media screen."><span class="description">Adds Custom Field support to the Edit Media screen.</span><pre>mla_admin_init_action()</pre></a></li>
60
  <li class="method public "><a href="#mla_attachment_submitbox_action" title="mla_attachment_submitbox_action :: Adds Last Modified date to the Submit box on the Edit Media screen."><span class="description">Adds Last Modified date to the Submit box on the Edit Media screen.</span><pre>mla_attachment_submitbox_action()</pre></a></li>
 
61
  <li class="method public "><a href="#mla_edit_add_help_tab" title="mla_edit_add_help_tab :: Add contextual help tabs to the WordPress Edit Media page"><span class="description">Add contextual help tabs to the WordPress Edit Media page</span><pre>mla_edit_add_help_tab()</pre></a></li>
62
  <li class="method public "><a href="#mla_edit_attachment_action" title="mla_edit_attachment_action :: Saves updates from the Edit Media screen."><span class="description">Saves updates from the Edit Media screen.</span><pre>mla_edit_attachment_action()</pre></a></li>
63
  <li class="method public "><a href="#mla_featured_in_handler" title="mla_featured_in_handler :: Renders the Featured in meta box on the Edit Media page."><span class="description">Renders the Featured in meta box on the Edit Media page.</span><pre>mla_featured_in_handler()</pre></a></li>
133
  </div>
134
  </div></div>
135
  </div>
136
+ <a name="mla_admin_init_action" id="mla_admin_init_action"></a><div class="element clickable method public mla_admin_init_action" data-toggle="collapse" data-target=".mla_admin_init_action .collapse">
137
+ <h2>Adds Custom Field support to the Edit Media screen.</h2>
138
+ <pre>mla_admin_init_action() : void</pre>
139
  <div class="labels"></div>
140
  <div class="row collapse"><div class="detail-description">
141
  <p class="long_description"><p>Declared public because it is an action.</p></p>
145
  </tr></table>
146
  </div></div>
147
  </div>
148
+ <a name="mla_attachment_submitbox_action" id="mla_attachment_submitbox_action"></a><div class="element clickable method public mla_attachment_submitbox_action" data-toggle="collapse" data-target=".mla_attachment_submitbox_action .collapse">
149
+ <h2>Adds Last Modified date to the Submit box on the Edit Media screen.</h2>
150
+ <pre>mla_attachment_submitbox_action() : void</pre>
151
  <div class="labels"></div>
152
  <div class="row collapse"><div class="detail-description">
153
  <p class="long_description"><p>Declared public because it is an action.</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>
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-09-27T14:55:49-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-10-21T16:31:45-07: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-09-27T14:55:49-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-10-21T16:31:45-07: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-09-27T14:55:49-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-10-21T16:31:45-07:00.<br></footer></div>
173
  </div>
174
  </body>
175
  </html>
phpDocs/classes/MLAOptions.html CHANGED
@@ -112,8 +112,16 @@ settings are being updated or reset.</span><pre>mla_taxonomy_support()</pre></a>
112
  <li class="constant "><a href="#MLA_FEATURED_IN_TUNING" title="MLA_FEATURED_IN_TUNING :: Provides a unique name for a database tuning option"><span class="description">Provides a unique name for a database tuning option</span><pre>MLA_FEATURED_IN_TUNING</pre></a></li>
113
  <li class="constant "><a href="#MLA_GALLERY_IN_TUNING" title="MLA_GALLERY_IN_TUNING :: Provides a unique name for a database tuning option"><span class="description">Provides a unique name for a database tuning option</span><pre>MLA_GALLERY_IN_TUNING</pre></a></li>
114
  <li class="constant "><a href="#MLA_INSERTED_IN_TUNING" title="MLA_INSERTED_IN_TUNING :: Provides a unique name for a database tuning option"><span class="description">Provides a unique name for a database tuning option</span><pre>MLA_INSERTED_IN_TUNING</pre></a></li>
 
 
 
 
 
 
115
  <li class="constant "><a href="#MLA_MEDIA_MODAL_MIMETYPES" title="MLA_MEDIA_MODAL_MIMETYPES :: Provides a unique name for the Media Manager toolbar MIME Types option"><span class="description">Provides a unique name for the Media Manager toolbar MIME Types option</span><pre>MLA_MEDIA_MODAL_MIMETYPES</pre></a></li>
116
  <li class="constant "><a href="#MLA_MEDIA_MODAL_MONTHS" title="MLA_MEDIA_MODAL_MONTHS :: Provides a unique name for the Media Manager toolbar Month and Year option"><span class="description">Provides a unique name for the Media Manager toolbar Month and Year option</span><pre>MLA_MEDIA_MODAL_MONTHS</pre></a></li>
 
 
117
  <li class="constant "><a href="#MLA_MEDIA_MODAL_SEARCHBOX" title="MLA_MEDIA_MODAL_SEARCHBOX :: Provides a unique name for the Media Manager toolbar Search Box option"><span class="description">Provides a unique name for the Media Manager toolbar Search Box option</span><pre>MLA_MEDIA_MODAL_SEARCHBOX</pre></a></li>
118
  <li class="constant "><a href="#MLA_MEDIA_MODAL_TERMS" title="MLA_MEDIA_MODAL_TERMS :: Provides a unique name for the Media Manager toolbar Taxonomy Terms option"><span class="description">Provides a unique name for the Media Manager toolbar Taxonomy Terms option</span><pre>MLA_MEDIA_MODAL_TERMS</pre></a></li>
119
  <li class="constant "><a href="#MLA_MEDIA_MODAL_TOOLBAR" title="MLA_MEDIA_MODAL_TOOLBAR :: Provides a unique name for the Media Manager toolbar option"><span class="description">Provides a unique name for the Media Manager toolbar option</span><pre>MLA_MEDIA_MODAL_TOOLBAR</pre></a></li>
@@ -874,7 +882,7 @@ haven't been mapped to any attachments, yet.</p></p>
874
  <code>array</code><p>new values</p></div>
875
  <h3>Returns</h3>
876
  <div class="subelement response">
877
- <code>array</code>( 'message' => HTML message(s) reflecting results, 'values' => updated iptc_exif_mapping values, 'changed' => true if any changes detected else false )</div>
878
  </div></div>
879
  </div>
880
  <a name="_update_iptc_exif_custom_mapping" id="_update_iptc_exif_custom_mapping"></a><div class="element clickable method private _update_iptc_exif_custom_mapping" data-toggle="collapse" data-target="._update_iptc_exif_custom_mapping .collapse">
@@ -1106,6 +1114,20 @@ reset => reset function for 'custom' options; returns nothing. Usage:
1106
  <div class="labels"></div>
1107
  <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
1108
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1109
  <a name="MLA_MEDIA_MODAL_MIMETYPES" id="MLA_MEDIA_MODAL_MIMETYPES"> </a><div class="element clickable constant MLA_MEDIA_MODAL_MIMETYPES" data-toggle="collapse" data-target=".MLA_MEDIA_MODAL_MIMETYPES .collapse">
1110
  <h2>Provides a unique name for the Media Manager toolbar MIME Types option</h2>
1111
  <pre>MLA_MEDIA_MODAL_MIMETYPES </pre>
@@ -1118,6 +1140,18 @@ reset => reset function for 'custom' options; returns nothing. Usage:
1118
  <div class="labels"></div>
1119
  <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
1120
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
1121
  <a name="MLA_MEDIA_MODAL_SEARCHBOX" id="MLA_MEDIA_MODAL_SEARCHBOX"> </a><div class="element clickable constant MLA_MEDIA_MODAL_SEARCHBOX" data-toggle="collapse" data-target=".MLA_MEDIA_MODAL_SEARCHBOX .collapse">
1122
  <h2>Provides a unique name for the Media Manager toolbar Search Box option</h2>
1123
  <pre>MLA_MEDIA_MODAL_SEARCHBOX </pre>
@@ -1227,7 +1261,7 @@ reset => reset function for 'custom' options; returns nothing. Usage:
1227
  <div class="row"><footer class="span12">
1228
  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>
1229
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1230
- generated on 2013-09-27T14:55:49-07:00.<br></footer></div>
1231
  </div>
1232
  </body>
1233
  </html>
112
  <li class="constant "><a href="#MLA_FEATURED_IN_TUNING" title="MLA_FEATURED_IN_TUNING :: Provides a unique name for a database tuning option"><span class="description">Provides a unique name for a database tuning option</span><pre>MLA_FEATURED_IN_TUNING</pre></a></li>
113
  <li class="constant "><a href="#MLA_GALLERY_IN_TUNING" title="MLA_GALLERY_IN_TUNING :: Provides a unique name for a database tuning option"><span class="description">Provides a unique name for a database tuning option</span><pre>MLA_GALLERY_IN_TUNING</pre></a></li>
114
  <li class="constant "><a href="#MLA_INSERTED_IN_TUNING" title="MLA_INSERTED_IN_TUNING :: Provides a unique name for a database tuning option"><span class="description">Provides a unique name for a database tuning option</span><pre>MLA_INSERTED_IN_TUNING</pre></a></li>
115
+ <li class="constant "><a href="#MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX" title='MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX :: Provides a unique name for the Media Manager Attachment Details searchable taxonomy option
116
+ This option is for hierarchical taxonomies, e.g., "Att.'><span class="description">Provides a unique name for the Media Manager Attachment Details searchable taxonomy option
117
+ This option is for hierarchical taxonomies, e.g., "Att.</span><pre>MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX</pre></a></li>
118
+ <li class="constant "><a href="#MLA_MEDIA_MODAL_DETAILS_TAG_METABOX" title='MLA_MEDIA_MODAL_DETAILS_TAG_METABOX :: Provides a unique name for the Media Manager Attachment Details searchable taxonomy option
119
+ This option is for flat taxonomies, e.g., "Att.'><span class="description">Provides a unique name for the Media Manager Attachment Details searchable taxonomy option
120
+ This option is for flat taxonomies, e.g., "Att.</span><pre>MLA_MEDIA_MODAL_DETAILS_TAG_METABOX</pre></a></li>
121
  <li class="constant "><a href="#MLA_MEDIA_MODAL_MIMETYPES" title="MLA_MEDIA_MODAL_MIMETYPES :: Provides a unique name for the Media Manager toolbar MIME Types option"><span class="description">Provides a unique name for the Media Manager toolbar MIME Types option</span><pre>MLA_MEDIA_MODAL_MIMETYPES</pre></a></li>
122
  <li class="constant "><a href="#MLA_MEDIA_MODAL_MONTHS" title="MLA_MEDIA_MODAL_MONTHS :: Provides a unique name for the Media Manager toolbar Month and Year option"><span class="description">Provides a unique name for the Media Manager toolbar Month and Year option</span><pre>MLA_MEDIA_MODAL_MONTHS</pre></a></li>
123
+ <li class="constant "><a href="#MLA_MEDIA_MODAL_ORDER" title="MLA_MEDIA_MODAL_ORDER :: Provides a unique name for the Media Manager order option"><span class="description">Provides a unique name for the Media Manager order option</span><pre>MLA_MEDIA_MODAL_ORDER</pre></a></li>
124
+ <li class="constant "><a href="#MLA_MEDIA_MODAL_ORDERBY" title="MLA_MEDIA_MODAL_ORDERBY :: Provides a unique name for the Media Manager orderby option"><span class="description">Provides a unique name for the Media Manager orderby option</span><pre>MLA_MEDIA_MODAL_ORDERBY</pre></a></li>
125
  <li class="constant "><a href="#MLA_MEDIA_MODAL_SEARCHBOX" title="MLA_MEDIA_MODAL_SEARCHBOX :: Provides a unique name for the Media Manager toolbar Search Box option"><span class="description">Provides a unique name for the Media Manager toolbar Search Box option</span><pre>MLA_MEDIA_MODAL_SEARCHBOX</pre></a></li>
126
  <li class="constant "><a href="#MLA_MEDIA_MODAL_TERMS" title="MLA_MEDIA_MODAL_TERMS :: Provides a unique name for the Media Manager toolbar Taxonomy Terms option"><span class="description">Provides a unique name for the Media Manager toolbar Taxonomy Terms option</span><pre>MLA_MEDIA_MODAL_TERMS</pre></a></li>
127
  <li class="constant "><a href="#MLA_MEDIA_MODAL_TOOLBAR" title="MLA_MEDIA_MODAL_TOOLBAR :: Provides a unique name for the Media Manager toolbar option"><span class="description">Provides a unique name for the Media Manager toolbar option</span><pre>MLA_MEDIA_MODAL_TOOLBAR</pre></a></li>
882
  <code>array</code><p>new values</p></div>
883
  <h3>Returns</h3>
884
  <div class="subelement response">
885
+ <code>array</code>( 'message' => HTML message(s) reflecting results, 'values' => updated custom_field_mapping values, 'changed' => true if any changes detected else false )</div>
886
  </div></div>
887
  </div>
888
  <a name="_update_iptc_exif_custom_mapping" id="_update_iptc_exif_custom_mapping"></a><div class="element clickable method private _update_iptc_exif_custom_mapping" data-toggle="collapse" data-target="._update_iptc_exif_custom_mapping .collapse">
1114
  <div class="labels"></div>
1115
  <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
1116
  </div>
1117
+ <a name="MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX" id="MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX"> </a><div class="element clickable constant MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX" data-toggle="collapse" data-target=".MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX .collapse">
1118
+ <h2>Provides a unique name for the Media Manager Attachment Details searchable taxonomy option
1119
+ This option is for hierarchical taxonomies, e.g., "Att.</h2>
1120
+ <pre>MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX </pre>
1121
+ <div class="labels"></div>
1122
+ <div class="row collapse"><div class="detail-description"><p class="long_description"><p>Categories".</p></p></div></div>
1123
+ </div>
1124
+ <a name="MLA_MEDIA_MODAL_DETAILS_TAG_METABOX" id="MLA_MEDIA_MODAL_DETAILS_TAG_METABOX"> </a><div class="element clickable constant MLA_MEDIA_MODAL_DETAILS_TAG_METABOX" data-toggle="collapse" data-target=".MLA_MEDIA_MODAL_DETAILS_TAG_METABOX .collapse">
1125
+ <h2>Provides a unique name for the Media Manager Attachment Details searchable taxonomy option
1126
+ This option is for flat taxonomies, e.g., "Att.</h2>
1127
+ <pre>MLA_MEDIA_MODAL_DETAILS_TAG_METABOX </pre>
1128
+ <div class="labels"></div>
1129
+ <div class="row collapse"><div class="detail-description"><p class="long_description"><p>Tags".</p></p></div></div>
1130
+ </div>
1131
  <a name="MLA_MEDIA_MODAL_MIMETYPES" id="MLA_MEDIA_MODAL_MIMETYPES"> </a><div class="element clickable constant MLA_MEDIA_MODAL_MIMETYPES" data-toggle="collapse" data-target=".MLA_MEDIA_MODAL_MIMETYPES .collapse">
1132
  <h2>Provides a unique name for the Media Manager toolbar MIME Types option</h2>
1133
  <pre>MLA_MEDIA_MODAL_MIMETYPES </pre>
1140
  <div class="labels"></div>
1141
  <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
1142
  </div>
1143
+ <a name="MLA_MEDIA_MODAL_ORDER" id="MLA_MEDIA_MODAL_ORDER"> </a><div class="element clickable constant MLA_MEDIA_MODAL_ORDER" data-toggle="collapse" data-target=".MLA_MEDIA_MODAL_ORDER .collapse">
1144
+ <h2>Provides a unique name for the Media Manager order option</h2>
1145
+ <pre>MLA_MEDIA_MODAL_ORDER </pre>
1146
+ <div class="labels"></div>
1147
+ <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
1148
+ </div>
1149
+ <a name="MLA_MEDIA_MODAL_ORDERBY" id="MLA_MEDIA_MODAL_ORDERBY"> </a><div class="element clickable constant MLA_MEDIA_MODAL_ORDERBY" data-toggle="collapse" data-target=".MLA_MEDIA_MODAL_ORDERBY .collapse">
1150
+ <h2>Provides a unique name for the Media Manager orderby option</h2>
1151
+ <pre>MLA_MEDIA_MODAL_ORDERBY </pre>
1152
+ <div class="labels"></div>
1153
+ <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
1154
+ </div>
1155
  <a name="MLA_MEDIA_MODAL_SEARCHBOX" id="MLA_MEDIA_MODAL_SEARCHBOX"> </a><div class="element clickable constant MLA_MEDIA_MODAL_SEARCHBOX" data-toggle="collapse" data-target=".MLA_MEDIA_MODAL_SEARCHBOX .collapse">
1156
  <h2>Provides a unique name for the Media Manager toolbar Search Box option</h2>
1157
  <pre>MLA_MEDIA_MODAL_SEARCHBOX </pre>
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>
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-09-27T14:55:49-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-10-21T16:31:45-07:00.<br></footer></div>
1156
  </div>
1157
  </body>
1158
  </html>
phpDocs/classes/MLAShortcodes.html CHANGED
@@ -71,6 +71,7 @@
71
  <li class="nav-header">
72
  <i class="icon-custom icon-property"></i> Properties</li>
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="nav-header private">» Private</li>
75
  <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>
76
  <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>
@@ -402,6 +403,19 @@ Enhanced version of /wp-includes/formatting.php function sanitize_sql_orderby().
402
  </tr></table>
403
  </div></div>
404
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
405
  <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">
406
  <h2>Data selection parameters for the WP_Query in [mla_gallery]</h2>
407
  <pre>$data_selection_parameters : array</pre>
@@ -450,7 +464,7 @@ any further logic required to translate those values is contained in the filter.
450
  <div class="row"><footer class="span12">
451
  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>
452
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
453
- generated on 2013-09-27T14:55:49-07:00.<br></footer></div>
454
  </div>
455
  </body>
456
  </html>
71
  <li class="nav-header">
72
  <i class="icon-custom icon-property"></i> Properties</li>
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>
403
  </tr></table>
404
  </div></div>
405
  </div>
406
+ <a name="%24mla_gallery_wp_query_object" id="$mla_gallery_wp_query_object"> </a><div class="element clickable property public $mla_gallery_wp_query_object" data-toggle="collapse" data-target=".$mla_gallery_wp_query_object .collapse">
407
+ <h2>The WP_Query object used to select items for the gallery.</h2>
408
+ <pre>$mla_gallery_wp_query_object : object</pre>
409
+ <div class="labels"></div>
410
+ <div class="row collapse"><div class="detail-description">
411
+ <p class="long_description"><p>Defined as a public, static variable so it can be inspected from the
412
+ "mla_gallery_wp_query_object" action. Set to NULL at all other times.</p></p>
413
+ <table class="table table-bordered"><tr>
414
+ <th>since</th>
415
+ <td>1.51</td>
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>
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>
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-09-27T14:55:49-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-10-21T16:31:45-07:00.<br></footer></div>
166
  </div>
167
  </body>
168
  </html>
phpDocs/classes/MLA_List_Table.html CHANGED
@@ -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-09-27T14:55:49-07:00.<br></footer></div>
1101
  </div>
1102
  </body>
1103
  </html>
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>
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-09-27T14:55:49-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-10-21T16:31:45-07: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-09-27T14:55:49-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-10-21T16:31:45-07: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-09-27T14:55:49-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-10-21T16:31:45-07: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-09-27T14:55:49-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-10-21T16:31:45-07: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-09-27T14:55:49-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-10-21T16:31:45-07: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-09-27T14:55:49-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-10-21T16:31:45-07: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-09-27T14:55:49-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-10-21T16:31:45-07: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>2783</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-09-27T14:55:49-07:00.<br></footer></div>
90
  </div>
91
  </body>
92
  </html>
76
  </tr>
77
  <tr>
78
  <td>todo</td>
79
+ <td>2901</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-10-21T16:31:45-07:00.<br></footer></div>
90
  </div>
91
  </body>
92
  </html>
phpDocs/namespaces/global.html CHANGED
@@ -230,7 +230,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-09-27T14:55:49-07:00.<br></footer></div>
234
  </div>
235
  </body>
236
  </html>
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>
phpDocs/packages/Media Library Assistant.html CHANGED
@@ -261,7 +261,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-09-27T14:55:49-07:00.<br></footer></div>
265
  </div>
266
  </body>
267
  </html>
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>
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="2575837da4a45d84565d619b3cf2c869" 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="983" namespace="global" package="Media Library Assistant">
44
  <name>$mla_list_table_items</name>
45
  <default><![CDATA[NULL]]></default>
46
- <docblock line="976">
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="976" name="since" description="1.40"/>
50
- <tag line="976" 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="1089" namespace="global" package="Media Library Assistant">
56
  <name>$query_parameters</name>
57
  <default><![CDATA[array()]]></default>
58
- <docblock line="1076">
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="1076" name="since" description="0.30"/>
66
- <tag line="1076" 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="2234" namespace="global" package="Media Library Assistant">
72
  <name>$galleries</name>
73
  <default><![CDATA[null]]></default>
74
- <docblock line="2215">
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="2215" name="since" description="0.70"/>
88
- <tag line="2215" 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="2247" namespace="global" package="Media Library Assistant">
94
  <name>$mla_galleries</name>
95
  <default><![CDATA[null]]></default>
96
- <docblock line="2236">
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="2236" name="since" description="0.70"/>
102
- <tag line="2236" 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="2432" namespace="global" package="Media Library Assistant">
108
  <name>$pdf_indirect_objects</name>
109
  <default><![CDATA[NULL]]></default>
110
- <docblock line="2421">
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="2421" name="since" description="1.50"/>
116
- <tag line="2421" 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="3500" 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="3493">
125
  <description><![CDATA[UTF-8 replacements for invalid SQL characters]]></description>
126
  <long-description><![CDATA[]]></long-description>
127
- <tag line="3493" name="since" description="1.41"/>
128
- <tag line="3493" 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="3558" 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="3548">
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="3548" name="since" description="0.90"/>
141
- <tag line="3548" 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="3657" 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="3647">
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="3647" name="since" description="0.90"/>
154
- <tag line="3647" 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="3756" 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="3746">
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="3746" name="since" description="0.90"/>
167
- <tag line="3746" 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="3855" 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="3845">
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="3845" name="since" description="0.90"/>
180
- <tag line="3845" 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="3898" 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="3888">
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="3888" name="since" description="0.90"/>
193
- <tag line="3888" name="var" description="" type="array">
194
  <type by_reference="false">array</type>
195
  </tag>
196
  </docblock>
@@ -244,7 +244,7 @@ where "key" becomes the key part of the array.</p>]]></long-description>
244
  <description><![CDATA[Find a complete template, balancing opening and closing delimiters]]></description>
245
  <long-description><![CDATA[]]></long-description>
246
  <tag line="150" name="since" description="1.50"/>
247
- <tag line="150" name="param" description="A string possibily starting with '[+template:'" type="string" variable="$tpl">
248
  <type by_reference="false">string</type>
249
  </tag>
250
  <tag line="150" name="return" description="'' or template string starting with '[+template:' and ending with the matching '+]'" type="string">
@@ -285,1474 +285,1585 @@ where "key" becomes the key part of the array.</p>]]></long-description>
285
  <type/>
286
  </argument>
287
  </method>
288
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="287" package="Media Library Assistant">
289
  <name>mla_parse_template</name>
290
  <full_name>mla_parse_template</full_name>
291
- <docblock line="275">
292
  <description><![CDATA[Expand a template, replacing placeholders with their values]]></description>
293
  <long-description><![CDATA[<p>A simple parsing function for basic templating.</p>]]></long-description>
294
- <tag line="275" name="since" description="0.1"/>
295
- <tag line="275" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
296
  <type by_reference="false">string</type>
297
  </tag>
298
- <tag line="275" name="param" description="An associative array containing keys and values e.g. array('key' =&gt; 'value')" type="array" variable="$markup_values">
299
  <type by_reference="false">array</type>
300
  </tag>
301
- <tag line="275" name="return" description="Placeholders corresponding to the keys of the markup_values will be replaced with their values." type="\strng">
302
  <type by_reference="false">\strng</type>
303
  </tag>
304
  </docblock>
305
- <argument line="287">
306
  <name>$tpl</name>
307
  <default><![CDATA[]]></default>
308
  <type/>
309
  </argument>
310
- <argument line="287">
311
  <name>$markup_values</name>
312
  <default><![CDATA[]]></default>
313
  <type/>
314
  </argument>
315
  </method>
316
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="338" package="Media Library Assistant">
317
  <name>_find_test_substring</name>
318
  <full_name>_find_test_substring</full_name>
319
- <docblock line="329">
320
  <description><![CDATA[Find a complete (test) element, balancing opening and closing delimiters]]></description>
321
  <long-description><![CDATA[]]></long-description>
322
- <tag line="329" name="since" description="1.50"/>
323
- <tag line="329" name="param" description="A string possibily starting with '('" type="string" variable="$tpl">
324
  <type by_reference="false">string</type>
325
  </tag>
326
- <tag line="329" name="return" description="'' or template string starting with '(' and ending with the matching ')'" type="string">
327
  <type by_reference="false">string</type>
328
  </tag>
329
  </docblock>
330
- <argument line="338">
331
  <name>$tpl</name>
332
  <default><![CDATA[]]></default>
333
  <type/>
334
  </argument>
335
  </method>
336
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="381" package="Media Library Assistant">
337
  <name>_parse_field_level_template</name>
338
  <full_name>_parse_field_level_template</full_name>
339
- <docblock line="372">
340
  <description><![CDATA[Convert field-level "template:" string into its component parts]]></description>
341
  <long-description><![CDATA[]]></long-description>
342
- <tag line="372" name="since" description="1.50"/>
343
- <tag line="372" name="param" description="Template content with string, test and choice elements" type="string" variable="$tpl">
344
  <type by_reference="false">string</type>
345
  </tag>
346
- <tag line="372" name="return" description="( node =&gt; array( type =&gt; &quot;string | test | choice | template&quot;, length =&gt; bytes, value =&gt; string | node(s) ) )" type="array">
347
  <type by_reference="false">array</type>
348
  </tag>
349
  </docblock>
350
- <argument line="381">
351
  <name>$tpl</name>
352
  <default><![CDATA[]]></default>
353
  <type/>
354
  </argument>
355
  </method>
356
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="525" package="Media Library Assistant">
357
  <name>_evaluate_template_array_node</name>
358
  <full_name>_evaluate_template_array_node</full_name>
359
- <docblock line="513">
360
  <description><![CDATA[Analyze a field-level "template:" element, expanding Field-level Markup Substitution Parameters]]></description>
361
  <long-description><![CDATA[<p>Will return an array of values if one or more of the placeholders returns an array.</p>]]></long-description>
362
- <tag line="513" name="since" description="1.50"/>
363
- <tag line="513" name="param" description="A field-level template element node" type="array" variable="$node">
364
  <type by_reference="false">array</type>
365
  </tag>
366
- <tag line="513" name="param" description="An array of markup substitution values" type="array" variable="$markup_values">
367
  <type by_reference="false">array</type>
368
  </tag>
369
- <tag line="513" name="return" description="string or array, depending on placeholder values. Placeholders corresponding to the keys of the markup_values will be replaced with their values." type="mixed">
370
  <type by_reference="false">mixed</type>
371
  </tag>
372
  </docblock>
373
- <argument line="525">
374
  <name>$node</name>
375
  <default><![CDATA[]]></default>
376
  <type/>
377
  </argument>
378
- <argument line="525">
379
  <name>$markup_values</name>
380
  <default><![CDATA[array()]]></default>
381
  <type/>
382
  </argument>
383
  </method>
384
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="602" package="Media Library Assistant">
385
  <name>_evaluate_template_node</name>
386
  <full_name>_evaluate_template_node</full_name>
387
- <docblock line="592">
388
  <description><![CDATA[Analyze a field-level "template:" element, expanding Field-level Markup Substitution Parameters]]></description>
389
  <long-description><![CDATA[]]></long-description>
390
- <tag line="592" name="since" description="1.50"/>
391
- <tag line="592" name="param" description="A field-level template element node" type="array" variable="$node">
392
  <type by_reference="false">array</type>
393
  </tag>
394
- <tag line="592" name="param" description="An array of markup substitution values" type="array" variable="$markup_values">
395
  <type by_reference="false">array</type>
396
  </tag>
397
- <tag line="592" name="return" description="String with expanded values, if any" type="string">
398
  <type by_reference="false">string</type>
399
  </tag>
400
  </docblock>
401
- <argument line="602">
402
  <name>$node</name>
403
  <default><![CDATA[]]></default>
404
  <type/>
405
  </argument>
406
- <argument line="602">
407
  <name>$markup_values</name>
408
  <default><![CDATA[array()]]></default>
409
  <type/>
410
  </argument>
411
  </method>
412
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="664" package="Media Library Assistant">
413
  <name>_expand_field_level_template</name>
414
  <full_name>_expand_field_level_template</full_name>
415
- <docblock line="653">
416
  <description><![CDATA[Analyze a field-level "template:" element, expanding Field-level Markup Substitution Parameters]]></description>
417
  <long-description><![CDATA[]]></long-description>
418
- <tag line="653" name="since" description="1.50"/>
419
- <tag line="653" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
420
  <type by_reference="false">string</type>
421
  </tag>
422
- <tag line="653" name="param" description="An array of markup substitution values" type="array" variable="$markup_values">
423
  <type by_reference="false">array</type>
424
  </tag>
425
- <tag line="653" name="param" description="True to return array value(s), false to return a string" type="boolean" variable="$return_arrays">
426
  <type by_reference="false">boolean</type>
427
  </tag>
428
- <tag line="653" name="return" description="Element with expanded string/array values, if any" type="mixed">
429
  <type by_reference="false">mixed</type>
430
  </tag>
431
  </docblock>
432
- <argument line="664">
433
  <name>$tpl</name>
434
  <default><![CDATA[]]></default>
435
  <type/>
436
  </argument>
437
- <argument line="664">
438
  <name>$markup_values</name>
439
  <default><![CDATA[array()]]></default>
440
  <type/>
441
  </argument>
442
- <argument line="664">
443
  <name>$return_arrays</name>
444
  <default><![CDATA[false]]></default>
445
  <type/>
446
  </argument>
447
  </method>
448
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="706" package="Media Library Assistant">
449
  <name>_process_field_level_array</name>
450
  <full_name>_process_field_level_array</full_name>
451
- <docblock line="695">
452
  <description><![CDATA[Process an markup field array value according to the supplied data-format option]]></description>
453
  <long-description><![CDATA[]]></long-description>
454
- <tag line="695" name="since" description="1.50"/>
455
- <tag line="695" name="param" description="an array of scalar values" type="array" variable="$record">
456
  <type by_reference="false">array</type>
457
  </tag>
458
- <tag line="695" name="param" description="data option 'text'|'single'|'export'|'array'|'multi'" type="string" variable="$option">
459
  <type by_reference="false">string</type>
460
  </tag>
461
- <tag line="695" name="param" description="Optional: for option 'multi', retain existing values" type="boolean" variable="$keep_existing">
462
  <type by_reference="false">boolean</type>
463
  </tag>
464
- <tag line="695" name="return" description="( parameter =&gt; value ) for all field-level parameters and anything in $markup_values" type="array">
465
  <type by_reference="false">array</type>
466
  </tag>
467
  </docblock>
468
- <argument line="706">
469
  <name>$record</name>
470
  <default><![CDATA[]]></default>
471
  <type/>
472
  </argument>
473
- <argument line="706">
474
  <name>$option</name>
475
  <default><![CDATA['text']]></default>
476
  <type/>
477
  </argument>
478
- <argument line="706">
479
  <name>$keep_existing</name>
480
  <default><![CDATA[false]]></default>
481
  <type/>
482
  </argument>
483
  </method>
484
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="750" package="Media Library Assistant">
485
  <name>mla_expand_field_level_parameters</name>
486
  <full_name>mla_expand_field_level_parameters</full_name>
487
- <docblock line="732">
488
  <description><![CDATA[Analyze a template, expanding Field-level Markup Substitution Parameters]]></description>
489
  <long-description><![CDATA[<p>Field-level parameters must have one of the following prefix values:
490
  template, request, query, custom, terms, meta, iptc, exif, pdf.
491
  All but request and query require an attachment ID.</p>]]></long-description>
492
- <tag line="732" name="since" description="1.50"/>
493
- <tag line="732" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
494
  <type by_reference="false">string</type>
495
  </tag>
496
- <tag line="732" name="param" description="Optional: an array of values from the query, if any, e.g. shortcode parameters" type="array" variable="$query">
497
  <type by_reference="false">array</type>
498
  </tag>
499
- <tag line="732" name="param" description="Optional: an array of values to add to the returned array" type="array" variable="$markup_values">
500
  <type by_reference="false">array</type>
501
  </tag>
502
- <tag line="732" name="param" description="Optional: attachment ID for attachment-specific placeholders" type="integer" variable="$post_id">
503
  <type by_reference="false">integer</type>
504
  </tag>
505
- <tag line="732" name="param" description="Optional: for option 'multi', retain existing values" type="boolean" variable="$keep_existing">
506
  <type by_reference="false">boolean</type>
507
  </tag>
508
- <tag line="732" name="param" description="Optional: default option value" type="string" variable="$default_option">
509
  <type by_reference="false">string</type>
510
  </tag>
511
- <tag line="732" name="return" description="( parameter =&gt; value ) for all field-level parameters and anything in $markup_values" type="array">
512
  <type by_reference="false">array</type>
513
  </tag>
514
  </docblock>
515
- <argument line="750">
516
  <name>$tpl</name>
517
  <default><![CDATA[]]></default>
518
  <type/>
519
  </argument>
520
- <argument line="750">
521
  <name>$query</name>
522
  <default><![CDATA[NULL]]></default>
523
  <type/>
524
  </argument>
525
- <argument line="750">
526
  <name>$markup_values</name>
527
  <default><![CDATA[array()]]></default>
528
  <type/>
529
  </argument>
530
- <argument line="750">
531
  <name>$post_id</name>
532
  <default><![CDATA[0]]></default>
533
  <type/>
534
  </argument>
535
- <argument line="750">
536
  <name>$keep_existing</name>
537
  <default><![CDATA[false]]></default>
538
  <type/>
539
  </argument>
540
- <argument line="750">
541
  <name>$default_option</name>
542
  <default><![CDATA['text']]></default>
543
  <type/>
544
  </argument>
545
  </method>
546
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="904" package="Media Library Assistant">
547
  <name>mla_get_template_placeholders</name>
548
  <full_name>mla_get_template_placeholders</full_name>
549
- <docblock line="893">
550
  <description><![CDATA[Analyze a template, returning an array of the placeholders it contains]]></description>
551
  <long-description><![CDATA[]]></long-description>
552
- <tag line="893" name="since" description="0.90"/>
553
- <tag line="893" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
554
  <type by_reference="false">string</type>
555
  </tag>
556
- <tag line="893" name="param" description="Optional: default option value" type="string" variable="$default_option">
557
  <type by_reference="false">string</type>
558
  </tag>
559
- <tag line="893" 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="904">
564
  <name>$tpl</name>
565
  <default><![CDATA[]]></default>
566
  <type/>
567
  </argument>
568
- <argument line="904">
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="996" 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="985">
578
  <description><![CDATA[Get the total number of attachment posts]]></description>
579
  <long-description><![CDATA[]]></long-description>
580
- <tag line="985" name="since" description="0.30"/>
581
- <tag line="985" 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="985" 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="985" 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="985" name="return" description="Number of attachment posts" type="integer">
591
  <type by_reference="false">integer</type>
592
  </tag>
593
  </docblock>
594
- <argument line="996">
595
  <name>$request</name>
596
  <default><![CDATA[]]></default>
597
  <type/>
598
  </argument>
599
- <argument line="996">
600
  <name>$offset</name>
601
  <default><![CDATA[NULL]]></default>
602
  <type/>
603
  </argument>
604
- <argument line="996">
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="1025" 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="1011">
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="1011" name="since" description="0.1"/>
618
- <tag line="1011" 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="1011" 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="1011" 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="1011" 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="1025">
632
  <name>$request</name>
633
  <default><![CDATA[]]></default>
634
  <type/>
635
  </argument>
636
- <argument line="1025">
637
  <name>$offset</name>
638
  <default><![CDATA[]]></default>
639
  <type/>
640
  </argument>
641
- <argument line="1025">
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="1071" 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="1058">
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="1058" name="since" description="1.20"/>
654
- <tag line="1058" name="param" description="query parameters from Media Manager" type="array" variable="$request">
655
  <type by_reference="false">array</type>
656
  </tag>
657
- <tag line="1058" 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="1058" 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="1058" name="return" description="attachment objects (posts)" type="array">
664
  <type by_reference="false">array</type>
665
  </tag>
666
  </docblock>
667
- <argument line="1071">
668
  <name>$request</name>
669
  <default><![CDATA[]]></default>
670
  <type/>
671
  </argument>
672
- <argument line="1071">
673
  <name>$offset</name>
674
  <default><![CDATA[]]></default>
675
  <type/>
676
  </argument>
677
- <argument line="1071">
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="1105" package="Media Library Assistant">
684
  <name>_prepare_list_table_query</name>
685
  <full_name>_prepare_list_table_query</full_name>
686
- <docblock line="1091">
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="1091" name="since" description="0.1"/>
691
- <tag line="1091" 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="1091" 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="1091" 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="1091" 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="1105">
705
  <name>$raw_request</name>
706
  <default><![CDATA[]]></default>
707
  <type/>
708
  </argument>
709
- <argument line="1105">
710
  <name>$offset</name>
711
  <default><![CDATA[0]]></default>
712
  <type/>
713
  </argument>
714
- <argument line="1105">
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="1414" package="Media Library Assistant">
721
  <name>_execute_list_table_query</name>
722
  <full_name>_execute_list_table_query</full_name>
723
- <docblock line="1405">
724
  <description><![CDATA[Add filters, run query, remove filters]]></description>
725
  <long-description><![CDATA[]]></long-description>
726
- <tag line="1405" name="since" description="0.30"/>
727
- <tag line="1405" 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="1405" 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="1414">
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="1491" 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="1479">
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="1479" name="since" description="0.60"/>
747
- <tag line="1479" name="param" description="query clause before modification" type="string" variable="$search_string">
748
  <type by_reference="false">string</type>
749
  </tag>
750
- <tag line="1479" name="param" description="WP_Query object" type="object" variable="$query_object">
751
  <type by_reference="false">object</type>
752
  </tag>
753
- <tag line="1479" 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="1491">
758
  <name>$search_string</name>
759
  <default><![CDATA[]]></default>
760
  <type/>
761
  </argument>
762
- <argument line="1491">
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="1602" 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="1591">
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="1591" name="since" description="0.30"/>
775
- <tag line="1591" name="param" description="query clause before modification" type="string" variable="$join_clause">
776
  <type by_reference="false">string</type>
777
  </tag>
778
- <tag line="1591" 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="1602">
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="1629" 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="1617">
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="1617" name="since" description="0.1"/>
796
- <tag line="1617" name="param" description="query clause before modification" type="string" variable="$where_clause">
797
  <type by_reference="false">string</type>
798
  </tag>
799
- <tag line="1617" 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="1629">
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="1677" 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="1665">
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="1665" name="since" description="0.30"/>
817
- <tag line="1665" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
818
  <type by_reference="false">string</type>
819
  </tag>
820
- <tag line="1665" name="return" description="updated query clause" type="string">
821
  <type by_reference="false">string</type>
822
  </tag>
823
  </docblock>
824
- <argument line="1677">
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="1736" 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="1724">
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="1724" name="since" description="0.1"/>
838
- <tag line="1724" name="uses" description="\global\$post" refers="\global\$post"/>
839
- <tag line="1724" 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="1724" 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="1736">
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="1790" 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="1781">
857
  <description><![CDATA[Returns information about an attachment's parent, if found]]></description>
858
  <long-description><![CDATA[]]></long-description>
859
- <tag line="1781" name="since" description="0.1"/>
860
- <tag line="1781" 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="1781" 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="1790">
868
  <name>$parent_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="1826" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
874
  <name>mla_find_array_element</name>
875
  <full_name>mla_find_array_element</full_name>
876
- <docblock line="1811">
877
- <description><![CDATA[Finds the value of a key in a possibily nested array structure]]></description>
878
  <long-description><![CDATA[<p>Used primarily to extract fields from the _wp_attachment_metadata custom field.
879
  Could also be used with the ID3 metadata exposed in WordPress 3.6 and later.</p>]]></long-description>
880
- <tag line="1811" name="since" description="1.30"/>
881
- <tag line="1811" name="param" description="key value, e.g. array1.array2.element" type="string" variable="$needle">
882
  <type by_reference="false">string</type>
883
  </tag>
884
- <tag line="1811" name="param" description="PHP nested arrays" type="array" variable="$haystack">
885
  <type by_reference="false">array</type>
886
  </tag>
887
- <tag line="1811" name="param" description="data option 'text'|'single'|'export'|'array'|'multi'" type="string" variable="$option">
888
  <type by_reference="false">string</type>
889
  </tag>
890
- <tag line="1811" name="param" description="keep existing values - for 'multi' option" type="boolean" variable="$keep_existing">
891
  <type by_reference="false">boolean</type>
892
  </tag>
893
- <tag line="1811" name="return" description="value matching key(.key ...) or ''" type="string">
894
- <type by_reference="false">string</type>
895
  </tag>
896
  </docblock>
897
- <argument line="1826">
898
  <name>$needle</name>
899
  <default><![CDATA[]]></default>
900
  <type/>
901
  </argument>
902
- <argument line="1826">
903
  <name>$haystack</name>
904
  <default><![CDATA[]]></default>
905
  <type/>
906
  </argument>
907
- <argument line="1826">
908
  <name>$option</name>
909
  <default><![CDATA[]]></default>
910
  <type/>
911
  </argument>
912
- <argument line="1826">
913
  <name>$keep_existing</name>
914
  <default><![CDATA[false]]></default>
915
  <type/>
916
  </argument>
917
  </method>
918
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1881" package="Media Library Assistant">
919
  <name>mla_fetch_attachment_metadata</name>
920
  <full_name>mla_fetch_attachment_metadata</full_name>
921
- <docblock line="1868">
922
  <description><![CDATA[Fetch and filter meta data for an attachment]]></description>
923
  <long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
924
- are stripped out or converted to an 'mla</em>' equivalent. Array data is replaced with
925
- a string containing the first array element.</p>]]></long-description>
926
- <tag line="1868" name="since" description="0.1"/>
927
- <tag line="1868" name="param" description="post ID of attachment" type="int" variable="$post_id">
928
  <type by_reference="false">int</type>
929
  </tag>
930
- <tag line="1868" name="return" description="Meta data variables" type="array">
931
  <type by_reference="false">array</type>
932
  </tag>
933
  </docblock>
934
- <argument line="1881">
935
  <name>$post_id</name>
936
  <default><![CDATA[]]></default>
937
  <type/>
938
  </argument>
939
  </method>
940
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1953" package="Media Library Assistant">
941
  <name>mla_fetch_attachment_references</name>
942
  <full_name>mla_fetch_attachment_references</full_name>
943
- <docblock line="1940">
944
  <description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
945
  <long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
946
  as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
947
- <tag line="1940" name="since" description="0.1"/>
948
- <tag line="1940" name="param" description="post ID of attachment" type="int" variable="$ID">
949
  <type by_reference="false">int</type>
950
  </tag>
951
- <tag line="1940" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent">
952
  <type by_reference="false">int</type>
953
  </tag>
954
- <tag line="1940" name="return" description="Reference information; see $references array comments" type="array">
955
  <type by_reference="false">array</type>
956
  </tag>
957
  </docblock>
958
- <argument line="1953">
959
  <name>$ID</name>
960
  <default><![CDATA[]]></default>
961
  <type/>
962
  </argument>
963
- <argument line="1953">
964
  <name>$parent</name>
965
  <default><![CDATA[]]></default>
966
  <type/>
967
  </argument>
968
  </method>
969
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2258" package="Media Library Assistant">
970
  <name>mla_flush_mla_galleries</name>
971
  <full_name>mla_flush_mla_galleries</full_name>
972
- <docblock line="2249">
973
  <description><![CDATA[Invalidates the $mla_galleries or $galleries array and cached values]]></description>
974
  <long-description><![CDATA[]]></long-description>
975
- <tag line="2249" name="since" description="1.00"/>
976
- <tag line="2249" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
977
  <type by_reference="false">string</type>
978
  </tag>
979
- <tag line="2249" name="return" description="" type="void">
980
  <type by_reference="false">void</type>
981
  </tag>
982
  </docblock>
983
- <argument line="2258">
984
  <name>$option_name</name>
985
  <default><![CDATA[]]></default>
986
  <type/>
987
  </argument>
988
  </method>
989
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2282" package="Media Library Assistant">
990
  <name>mla_save_post_action</name>
991
  <full_name>mla_save_post_action</full_name>
992
- <docblock line="2273">
993
  <description><![CDATA[Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates]]></description>
994
  <long-description><![CDATA[]]></long-description>
995
- <tag line="2273" name="since" description="1.00"/>
996
- <tag line="2273" name="param" description="ID of post/page/attachment; not used at this time" type="integer" variable="$post_id">
997
  <type by_reference="false">integer</type>
998
  </tag>
999
- <tag line="2273" name="return" description="" type="void">
1000
  <type by_reference="false">void</type>
1001
  </tag>
1002
  </docblock>
1003
- <argument line="2282">
1004
  <name>$post_id</name>
1005
  <default><![CDATA[]]></default>
1006
  <type/>
1007
  </argument>
1008
  </method>
1009
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2299" package="Media Library Assistant">
1010
  <name>_build_mla_galleries</name>
1011
  <full_name>_build_mla_galleries</full_name>
1012
- <docblock line="2287">
1013
  <description><![CDATA[Builds the $mla_galleries or $galleries array]]></description>
1014
  <long-description><![CDATA[]]></long-description>
1015
- <tag line="2287" name="since" description="0.70"/>
1016
- <tag line="2287" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
1017
  <type by_reference="false">string</type>
1018
  </tag>
1019
- <tag line="2287" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
1020
  <type by_reference="false">array</type>
1021
  </tag>
1022
- <tag line="2287" name="param" description="the shortcode to be searched for and processed" type="string" variable="$shortcode">
1023
  <type by_reference="false">string</type>
1024
  </tag>
1025
- <tag line="2287" name="param" description="true to exclude revisions from the search" type="boolean" variable="$exclude_revisions">
1026
  <type by_reference="false">boolean</type>
1027
  </tag>
1028
- <tag line="2287" name="return" description="true if the galleries array is not empty" type="boolean">
1029
  <type by_reference="false">boolean</type>
1030
  </tag>
1031
  </docblock>
1032
- <argument line="2299">
1033
  <name>$option_name</name>
1034
  <default><![CDATA[]]></default>
1035
  <type/>
1036
  </argument>
1037
- <argument line="2299">
1038
  <name>$galleries_array</name>
1039
  <default><![CDATA[]]></default>
1040
  <type/>
1041
  </argument>
1042
- <argument line="2299">
1043
  <name>$shortcode</name>
1044
  <default><![CDATA[]]></default>
1045
  <type/>
1046
  </argument>
1047
- <argument line="2299">
1048
  <name>$exclude_revisions</name>
1049
  <default><![CDATA[]]></default>
1050
  <type/>
1051
  </argument>
1052
  </method>
1053
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2408" package="Media Library Assistant">
1054
  <name>_search_mla_galleries</name>
1055
  <full_name>_search_mla_galleries</full_name>
1056
- <docblock line="2397">
1057
  <description><![CDATA[Search the $mla_galleries or $galleries array]]></description>
1058
  <long-description><![CDATA[]]></long-description>
1059
- <tag line="2397" name="since" description="0.70"/>
1060
- <tag line="2397" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
1061
  <type by_reference="false">array</type>
1062
  </tag>
1063
- <tag line="2397" name="param" description="the attachment ID to be searched for and processed" type="int" variable="$attachment_id">
1064
  <type by_reference="false">int</type>
1065
  </tag>
1066
- <tag line="2397" 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">
1067
  <type by_reference="false">array</type>
1068
  </tag>
1069
  </docblock>
1070
- <argument line="2408">
1071
  <name>$galleries_array</name>
1072
  <default><![CDATA[]]></default>
1073
  <type/>
1074
  </argument>
1075
- <argument line="2408">
1076
  <name>$attachment_id</name>
1077
  <default><![CDATA[]]></default>
1078
  <type/>
1079
  </argument>
1080
  </method>
1081
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2447" package="Media Library Assistant">
1082
  <name>_parse_pdf_xref_subsection</name>
1083
  <full_name>_parse_pdf_xref_subsection</full_name>
1084
- <docblock line="2434">
1085
  <description><![CDATA[Parse a cross-reference table subsection into the array of indirect object definitions]]></description>
1086
  <long-description><![CDATA[<p>A cross-reference subsection is a sequence of 20-byte entries, each with offset and generation values.</p>]]></long-description>
1087
- <tag line="2434" name="since" description="1.50"/>
1088
- <tag line="2434" name="param" description="buffer containing the subsection" type="string" variable="$xref_section">
1089
  <type by_reference="false">string</type>
1090
  </tag>
1091
- <tag line="2434" name="param" description="offset within the buffer of the first entry" type="integer" variable="$offset">
1092
  <type by_reference="false">integer</type>
1093
  </tag>
1094
- <tag line="2434" name="param" description="number of the first object in the subsection" type="integer" variable="$object_id">
1095
  <type by_reference="false">integer</type>
1096
  </tag>
1097
- <tag line="2434" name="param" description="number of entries in the subsection" type="integer" variable="$count">
1098
  <type by_reference="false">integer</type>
1099
  </tag>
1100
- <tag line="2434" name="return" description="" type="void">
1101
  <type by_reference="false">void</type>
1102
  </tag>
1103
  </docblock>
1104
- <argument line="2447">
1105
  <name>$xref_section</name>
1106
  <default><![CDATA[]]></default>
1107
  <type/>
1108
  </argument>
1109
- <argument line="2447">
1110
  <name>$offset</name>
1111
  <default><![CDATA[]]></default>
1112
  <type/>
1113
  </argument>
1114
- <argument line="2447">
1115
  <name>$object_id</name>
1116
  <default><![CDATA[]]></default>
1117
  <type/>
1118
  </argument>
1119
- <argument line="2447">
1120
  <name>$count</name>
1121
  <default><![CDATA[]]></default>
1122
  <type/>
1123
  </argument>
1124
  </method>
1125
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2477" package="Media Library Assistant">
1126
  <name>_parse_pdf_xref_section</name>
1127
  <full_name>_parse_pdf_xref_section</full_name>
1128
- <docblock line="2466">
1129
  <description><![CDATA[Parse a cross-reference table section into the array of indirect object definitions]]></description>
1130
  <long-description><![CDATA[<p>Creates the array of indirect object offsets and lengths</p>]]></long-description>
1131
- <tag line="2466" name="since" description="1.50"/>
1132
- <tag line="2466" name="param" description="full path and file name" type="string" variable="$file_name">
1133
  <type by_reference="false">string</type>
1134
  </tag>
1135
- <tag line="2466" name="param" description="offset within the file of the xref id and count entry" type="integer" variable="$file_offset">
1136
  <type by_reference="false">integer</type>
1137
  </tag>
1138
- <tag line="2466" name="return" description="length of the section" type="integer">
1139
  <type by_reference="false">integer</type>
1140
  </tag>
1141
  </docblock>
1142
- <argument line="2477">
1143
  <name>$file_name</name>
1144
  <default><![CDATA[]]></default>
1145
  <type/>
1146
  </argument>
1147
- <argument line="2477">
1148
  <name>$file_offset</name>
1149
  <default><![CDATA[]]></default>
1150
  <type/>
1151
  </argument>
1152
  </method>
1153
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2511" package="Media Library Assistant">
1154
  <name>_parse_pdf_xref_stream</name>
1155
  <full_name>_parse_pdf_xref_stream</full_name>
1156
- <docblock line="2499">
1157
  <description><![CDATA[Parse a cross-reference steam into the array of indirect object definitions]]></description>
1158
  <long-description><![CDATA[<p>Creates the array of indirect object offsets and lengths</p>]]></long-description>
1159
- <tag line="2499" name="since" description="1.50"/>
1160
- <tag line="2499" name="param" description="full path and file name" type="string" variable="$file_name">
1161
  <type by_reference="false">string</type>
1162
  </tag>
1163
- <tag line="2499" name="param" description="offset within the file of the xref id and count entry" type="integer" variable="$file_offset">
1164
  <type by_reference="false">integer</type>
1165
  </tag>
1166
- <tag line="2499" name="param" description="&quot;/W&quot; entry, representing the size of the fields in a single entry" type="string" variable="$entry_parms_string">
1167
  <type by_reference="false">string</type>
1168
  </tag>
1169
- <tag line="2499" name="return" description="length of the stream" type="integer">
1170
  <type by_reference="false">integer</type>
1171
  </tag>
1172
  </docblock>
1173
- <argument line="2511">
1174
  <name>$file_name</name>
1175
  <default><![CDATA[]]></default>
1176
  <type/>
1177
  </argument>
1178
- <argument line="2511">
1179
  <name>$file_offset</name>
1180
  <default><![CDATA[]]></default>
1181
  <type/>
1182
  </argument>
1183
- <argument line="2511">
1184
  <name>$entry_parms_string</name>
1185
  <default><![CDATA[]]></default>
1186
  <type/>
1187
  </argument>
1188
  </method>
1189
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2585" package="Media Library Assistant">
1190
  <name>_build_pdf_indirect_objects</name>
1191
  <full_name>_build_pdf_indirect_objects</full_name>
1192
- <docblock line="2575">
1193
  <description><![CDATA[Build an array of indirect object definitions]]></description>
1194
  <long-description><![CDATA[<p>Creates the array of indirect object offsets and lengths</p>]]></long-description>
1195
- <tag line="2575" name="since" description="1.50"/>
1196
- <tag line="2575" name="param" description="The entire PDF document, passsed by reference" type="string" variable="$string">
1197
  <type by_reference="false">string</type>
1198
  </tag>
1199
- <tag line="2575" name="return" description="" type="void">
1200
  <type by_reference="false">void</type>
1201
  </tag>
1202
  </docblock>
1203
- <argument line="2585">
1204
  <name>$string</name>
1205
  <default><![CDATA[]]></default>
1206
  <type/>
1207
  </argument>
1208
  </method>
1209
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2634" package="Media Library Assistant">
1210
  <name>_find_pdf_indirect_dictionary</name>
1211
  <full_name>_find_pdf_indirect_dictionary</full_name>
1212
- <docblock line="2620">
1213
  <description><![CDATA[Find the offset, length and contents of an indirect object containing a dictionary]]></description>
1214
  <long-description><![CDATA[<p>The function searches the entire file, if necessary, to find the last/most recent copy of the object.
1215
  This is required because Adobe Acrobat does NOT increment the generation number when it reuses an object.</p>]]></long-description>
1216
- <tag line="2620" name="since" description="1.50"/>
1217
- <tag line="2620" name="param" description="full path and file name" type="string" variable="$file_name">
1218
  <type by_reference="false">string</type>
1219
  </tag>
1220
- <tag line="2620" name="param" description="The object number" type="integer" variable="$object">
1221
  <type by_reference="false">integer</type>
1222
  </tag>
1223
- <tag line="2620" name="param" description="The object generation number; default zero (0)" type="integer" variable="$generation">
1224
  <type by_reference="false">integer</type>
1225
  </tag>
1226
- <tag line="2620" name="return" description="NULL on failure else array( 'start' =&gt; offset in the file, 'length' =&gt; object length, 'content' =&gt; dictionary contents )" type="mixed">
1227
  <type by_reference="false">mixed</type>
1228
  </tag>
1229
  </docblock>
1230
- <argument line="2634">
1231
  <name>$file_name</name>
1232
  <default><![CDATA[]]></default>
1233
  <type/>
1234
  </argument>
1235
- <argument line="2634">
1236
  <name>$object</name>
1237
  <default><![CDATA[]]></default>
1238
  <type/>
1239
  </argument>
1240
- <argument line="2634">
1241
  <name>$generation</name>
1242
  <default><![CDATA[0]]></default>
1243
  <type/>
1244
  </argument>
1245
  </method>
1246
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2730" package="Media Library Assistant">
1247
  <name>_parse_iso8601_date</name>
1248
  <full_name>_parse_iso8601_date</full_name>
1249
- <docblock line="2721">
1250
  <description><![CDATA[Parse a ISO 8601 Timestamp]]></description>
1251
  <long-description><![CDATA[]]></long-description>
1252
- <tag line="2721" name="since" description="1.50"/>
1253
- <tag line="2721" name="param" description="ISO string of the form YYYY-MM-DDTHH:MM:SS-HH:MM (inc time zone)" type="string" variable="$source_string">
1254
  <type by_reference="false">string</type>
1255
  </tag>
1256
- <tag line="2721" name="return" description="formatted date string YYYY-MM-DD HH:mm:SS" type="string">
1257
  <type by_reference="false">string</type>
1258
  </tag>
1259
  </docblock>
1260
- <argument line="2730">
1261
  <name>$source_string</name>
1262
  <default><![CDATA[]]></default>
1263
  <type/>
1264
  </argument>
1265
  </method>
1266
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2752" package="Media Library Assistant">
1267
  <name>_parse_pdf_date</name>
1268
  <full_name>_parse_pdf_date</full_name>
1269
- <docblock line="2743">
1270
  <description><![CDATA[Parse a PDF date string]]></description>
1271
  <long-description><![CDATA[]]></long-description>
1272
- <tag line="2743" name="since" description="1.50"/>
1273
- <tag line="2743" name="param" description="PDF date string of the form D:YYYYMMDDHHmmSSOHH'mm" type="string" variable="$source_string">
1274
  <type by_reference="false">string</type>
1275
  </tag>
1276
- <tag line="2743" name="return" description="formatted date string YYYY-MM-DD HH:mm:SS" type="string">
1277
  <type by_reference="false">string</type>
1278
  </tag>
1279
  </docblock>
1280
- <argument line="2752">
1281
  <name>$source_string</name>
1282
  <default><![CDATA[]]></default>
1283
  <type/>
1284
  </argument>
1285
  </method>
1286
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2774" package="Media Library Assistant">
1287
  <name>_parse_pdf_UTF16BE</name>
1288
  <full_name>_parse_pdf_UTF16BE</full_name>
1289
- <docblock line="2765">
1290
  <description><![CDATA[Parse a PDF Unicode (16-bit Big Endian) object]]></description>
1291
  <long-description><![CDATA[]]></long-description>
1292
- <tag line="2765" name="since" description="1.50"/>
1293
- <tag line="2765" name="param" description="PDF string of 16-bit characters" type="string" variable="$source_string">
1294
  <type by_reference="false">string</type>
1295
  </tag>
1296
- <tag line="2765" name="return" description="UTF-8 encoded string" type="string">
1297
  <type by_reference="false">string</type>
1298
  </tag>
1299
  </docblock>
1300
- <argument line="2774">
1301
  <name>$source_string</name>
1302
  <default><![CDATA[]]></default>
1303
  <type/>
1304
  </argument>
1305
  </method>
1306
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2803" package="Media Library Assistant">
1307
  <name>_parse_pdf_string</name>
1308
  <full_name>_parse_pdf_string</full_name>
1309
- <docblock line="2790">
1310
  <description><![CDATA[Parse a PDF string object]]></description>
1311
  <long-description><![CDATA[<p>Returns an array with one dictionary entry. The array also has a '/length' element containing
1312
  the number of bytes occupied by the string in the source string, including the enclosing parentheses.</p>]]></long-description>
1313
- <tag line="2790" name="since" description="1.50"/>
1314
- <tag line="2790" name="param" description="data within which the string occurs" type="string" variable="$source_string">
1315
  <type by_reference="false">string</type>
1316
  </tag>
1317
- <tag line="2790" name="param" description="offset within the source string of the opening '(' character." type="integer" variable="$offset">
1318
  <type by_reference="false">integer</type>
1319
  </tag>
1320
- <tag line="2790" name="return" description="( key =&gt; array( 'type' =&gt; type, 'value' =&gt; value, '/length' =&gt; length ) ) for the string" type="array">
1321
  <type by_reference="false">array</type>
1322
  </tag>
1323
  </docblock>
1324
- <argument line="2803">
1325
  <name>$source_string</name>
1326
  <default><![CDATA[]]></default>
1327
  <type/>
1328
  </argument>
1329
- <argument line="2803">
1330
  <name>$offset</name>
1331
  <default><![CDATA[]]></default>
1332
  <type/>
1333
  </argument>
1334
  </method>
1335
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2891" package="Media Library Assistant">
1336
  <name>_parse_pdf_LPD_dictionary</name>
1337
  <full_name>_parse_pdf_LPD_dictionary</full_name>
1338
- <docblock line="2877">
1339
  <description><![CDATA[Parse a PDF Linearization Parameter Dictionary object]]></description>
1340
  <long-description><![CDATA[<p>Returns an array of dictionary contents, classified by object type: boolean, numeric, string, hex (string),
1341
  indirect (object), name, array, dictionary, stream, and null.
1342
  The array also has a '/length' element containing the number of bytes occupied by the
1343
  dictionary in the source string, excluding the enclosing delimiters, if passed in.</p>]]></long-description>
1344
- <tag line="2877" name="since" description="1.50"/>
1345
- <tag line="2877" name="param" description="data within which the object occurs, typically the start of a PDF document" type="string" variable="$source_string">
1346
  <type by_reference="false">string</type>
1347
  </tag>
1348
- <tag line="2877" name="param" description="filesize of the PDF document, for validation purposes, or zero (0) to ignore filesize" type="integer" variable="$filesize">
1349
  <type by_reference="false">integer</type>
1350
  </tag>
1351
- <tag line="2877" name="return" description="array of dictionary objects on success, false on failure" type="mixed">
1352
  <type by_reference="false">mixed</type>
1353
  </tag>
1354
  </docblock>
1355
- <argument line="2891">
1356
  <name>$source_string</name>
1357
  <default><![CDATA[]]></default>
1358
  <type/>
1359
  </argument>
1360
- <argument line="2891">
1361
  <name>$filesize</name>
1362
  <default><![CDATA[]]></default>
1363
  <type/>
1364
  </argument>
1365
  </method>
1366
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2915" package="Media Library Assistant">
1367
  <name>_parse_pdf_dictionary</name>
1368
  <full_name>_parse_pdf_dictionary</full_name>
1369
- <docblock line="2901">
1370
  <description><![CDATA[Parse a PDF dictionary object]]></description>
1371
  <long-description><![CDATA[<p>Returns an array of dictionary contents, classified by object type: boolean, numeric, string, hex (string),
1372
  indirect (object), name, array, dictionary, stream, and null.
1373
  The array also has a '/length' element containing the number of bytes occupied by the
1374
  dictionary in the source string, excluding the enclosing delimiters.</p>]]></long-description>
1375
- <tag line="2901" name="since" description="1.50"/>
1376
- <tag line="2901" name="param" description="data within which the string occurs" type="string" variable="$source_string">
1377
  <type by_reference="false">string</type>
1378
  </tag>
1379
- <tag line="2901" name="param" description="offset within the source string of the opening '&lt;&lt;' characters or the first content character." type="integer" variable="$offset">
1380
  <type by_reference="false">integer</type>
1381
  </tag>
1382
- <tag line="2901" name="return" description="( '/length' =&gt; length, key =&gt; array( 'type' =&gt; type, 'value' =&gt; value ) ) for each dictionary field" type="array">
1383
  <type by_reference="false">array</type>
1384
  </tag>
1385
  </docblock>
1386
- <argument line="2915">
1387
  <name>$source_string</name>
1388
  <default><![CDATA[]]></default>
1389
  <type/>
1390
  </argument>
1391
- <argument line="2915">
1392
  <name>$offset</name>
1393
  <default><![CDATA[]]></default>
1394
  <type/>
1395
  </argument>
1396
  </method>
1397
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3049" package="Media Library Assistant">
1398
  <name>_parse_xmp_metadata</name>
1399
  <full_name>_parse_xmp_metadata</full_name>
1400
- <docblock line="3035">
1401
  <description><![CDATA[Parse an XMP object]]></description>
1402
  <long-description><![CDATA[<p>Returns an array of dictionary contents, classified by object type: boolean, numeric, string, hex (string),
1403
  indirect (object), name, array, dictionary, stream, and null.
1404
  The array also has a '/length' element containing the number of bytes occupied by the
1405
  dictionary in the source string, excluding the enclosing delimiters, if passed in.</p>]]></long-description>
1406
- <tag line="3035" name="since" description="1.50"/>
1407
- <tag line="3035" name="param" description="full path and file name" type="string" variable="$file_name">
1408
  <type by_reference="false">string</type>
1409
  </tag>
1410
- <tag line="3035" name="param" description="offset within the file of the search start point" type="integer" variable="$file_offset">
1411
  <type by_reference="false">integer</type>
1412
  </tag>
1413
- <tag line="3035" name="return" description="array of metadata values or NULL on failure" type="mixed">
1414
  <type by_reference="false">mixed</type>
1415
  </tag>
1416
  </docblock>
1417
- <argument line="3049">
1418
  <name>$file_name</name>
1419
  <default><![CDATA[]]></default>
1420
  <type/>
1421
  </argument>
1422
- <argument line="3049">
1423
  <name>$file_offset</name>
1424
  <default><![CDATA[]]></default>
1425
  <type/>
1426
  </argument>
1427
  </method>
1428
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3317" package="Media Library Assistant">
1429
  <name>_extract_pdf_trailer</name>
1430
  <full_name>_extract_pdf_trailer</full_name>
1431
- <docblock line="3307">
1432
  <description><![CDATA[Extract dictionary from traditional cross-reference + trailer documents]]></description>
1433
  <long-description><![CDATA[]]></long-description>
1434
- <tag line="3307" name="since" description="1.50"/>
1435
- <tag line="3307" name="param" description="full path to the desired file" type="string" variable="$file_name">
1436
  <type by_reference="false">string</type>
1437
  </tag>
1438
- <tag line="3307" name="param" description="offset within file of the cross-reference table" type="integer" variable="$file_offset">
1439
  <type by_reference="false">integer</type>
1440
  </tag>
1441
- <tag line="3307" name="return" description="array of &quot;PDF dictionary arrays&quot;, newest first, or NULL on failure" type="mixed">
1442
  <type by_reference="false">mixed</type>
1443
  </tag>
1444
  </docblock>
1445
- <argument line="3317">
1446
  <name>$file_name</name>
1447
  <default><![CDATA[]]></default>
1448
  <type/>
1449
  </argument>
1450
- <argument line="3317">
1451
  <name>$file_offset</name>
1452
  <default><![CDATA[]]></default>
1453
  <type/>
1454
  </argument>
1455
  </method>
1456
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3401" package="Media Library Assistant">
1457
  <name>_extract_pdf_metadata</name>
1458
  <full_name>_extract_pdf_metadata</full_name>
1459
- <docblock line="3392">
1460
  <description><![CDATA[Extract Metadata from a PDF file]]></description>
1461
  <long-description><![CDATA[]]></long-description>
1462
- <tag line="3392" name="since" description="1.50"/>
1463
- <tag line="3392" name="param" description="full path to the desired file" type="string" variable="$file_name">
1464
  <type by_reference="false">string</type>
1465
  </tag>
1466
- <tag line="3392" name="return" description="( key =&gt; value ) for each metadata field, in string format" type="array">
1467
  <type by_reference="false">array</type>
1468
  </tag>
1469
  </docblock>
1470
- <argument line="3401">
1471
  <name>$file_name</name>
1472
  <default><![CDATA[]]></default>
1473
  <type/>
1474
  </argument>
1475
  </method>
1476
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3528" package="Media Library Assistant">
1477
  <name>_bin_to_utf8</name>
1478
  <full_name>_bin_to_utf8</full_name>
1479
- <docblock line="3519">
1480
  <description><![CDATA[Replace SQL incorrect characters (0x80 - 0xFF) with their UTF-8 equivalents]]></description>
1481
  <long-description><![CDATA[]]></long-description>
1482
- <tag line="3519" name="since" description="1.41"/>
1483
- <tag line="3519" name="param" description="unencoded string" type="string" variable="$string">
1484
  <type by_reference="false">string</type>
1485
  </tag>
1486
- <tag line="3519" name="return" description="UTF-8 encoded string" type="string">
1487
  <type by_reference="false">string</type>
1488
  </tag>
1489
  </docblock>
1490
- <argument line="3528">
1491
  <name>$string</name>
1492
  <default><![CDATA[]]></default>
1493
  <type/>
1494
  </argument>
1495
  </method>
1496
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="3924" package="Media Library Assistant">
1497
  <name>mla_iptc_metadata_value</name>
1498
  <full_name>mla_iptc_metadata_value</full_name>
1499
- <docblock line="3914">
1500
  <description><![CDATA[Parse one IPTC metadata field]]></description>
1501
  <long-description><![CDATA[]]></long-description>
1502
- <tag line="3914" name="since" description="1.41"/>
1503
- <tag line="3914" name="param" description="field name - IPTC Identifier or friendly name/slug" type="string" variable="$iptc_key">
1504
  <type by_reference="false">string</type>
1505
  </tag>
1506
- <tag line="3914" name="param" description="metadata array containing iptc, exif, and pdf metadata arrays" type="string" variable="$item_metadata">
1507
  <type by_reference="false">string</type>
1508
  </tag>
1509
- <tag line="3914" name="return" description="string/array representation of metadata value or an empty string" type="mixed">
1510
  <type by_reference="false">mixed</type>
1511
  </tag>
1512
  </docblock>
1513
- <argument line="3924">
1514
  <name>$iptc_key</name>
1515
  <default><![CDATA[]]></default>
1516
  <type/>
1517
  </argument>
1518
- <argument line="3924">
1519
  <name>$item_metadata</name>
1520
  <default><![CDATA[]]></default>
1521
  <type/>
1522
  </argument>
1523
  </method>
1524
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="3956" package="Media Library Assistant">
1525
  <name>mla_exif_metadata_value</name>
1526
  <full_name>mla_exif_metadata_value</full_name>
1527
- <docblock line="3944">
1528
  <description><![CDATA[Parse one EXIF metadata field]]></description>
1529
  <long-description><![CDATA[<p>Also handles the special pseudo-values 'ALL_EXIF' and 'ALL_IPTC'.</p>]]></long-description>
1530
- <tag line="3944" name="since" description="1.13"/>
1531
- <tag line="3944" name="param" description="field name" type="string" variable="$exif_key">
1532
  <type by_reference="false">string</type>
1533
  </tag>
1534
- <tag line="3944" name="param" description="metadata array containing iptc, exif, and pdf metadata arrays" type="string" variable="$item_metadata">
1535
  <type by_reference="false">string</type>
1536
  </tag>
1537
- <tag line="3944" name="return" description="string/array representation of metadata value or an empty string" type="mixed">
1538
  <type by_reference="false">mixed</type>
1539
  </tag>
1540
  </docblock>
1541
- <argument line="3956">
1542
  <name>$exif_key</name>
1543
  <default><![CDATA[]]></default>
1544
  <type/>
1545
  </argument>
1546
- <argument line="3956">
1547
  <name>$item_metadata</name>
1548
  <default><![CDATA[]]></default>
1549
  <type/>
1550
  </argument>
1551
  </method>
1552
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4015" package="Media Library Assistant">
1553
  <name>mla_pdf_metadata_value</name>
1554
  <full_name>mla_pdf_metadata_value</full_name>
1555
- <docblock line="4003">
1556
  <description><![CDATA[Parse one PDF metadata field]]></description>
1557
  <long-description><![CDATA[<p>Also handles the special pseudo-value 'ALL_PDF'.</p>]]></long-description>
1558
- <tag line="4003" name="since" description="1.50"/>
1559
- <tag line="4003" name="param" description="field name" type="string" variable="$pdf_key">
1560
  <type by_reference="false">string</type>
1561
  </tag>
1562
- <tag line="4003" name="param" description="metadata array containing iptc, exif, and pdf metadata arrays" type="string" variable="$item_metadata">
1563
  <type by_reference="false">string</type>
1564
  </tag>
1565
- <tag line="4003" name="return" description="string/array representation of metadata value or an empty string" type="mixed">
1566
  <type by_reference="false">mixed</type>
1567
  </tag>
1568
  </docblock>
1569
- <argument line="4015">
1570
  <name>$pdf_key</name>
1571
  <default><![CDATA[]]></default>
1572
  <type/>
1573
  </argument>
1574
- <argument line="4015">
1575
  <name>$item_metadata</name>
1576
  <default><![CDATA[]]></default>
1577
  <type/>
1578
  </argument>
1579
  </method>
1580
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4058" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1581
  <name>mla_fetch_attachment_image_metadata</name>
1582
  <full_name>mla_fetch_attachment_image_metadata</full_name>
1583
- <docblock line="4046">
1584
- <description><![CDATA[Fetch and filter IPTC and EXIF meta data for an image attachment]]></description>
1585
- <long-description><![CDATA[<p>Returns</p>]]></long-description>
1586
- <tag line="4046" name="since" description="0.90"/>
1587
- <tag line="4046" name="param" description="post ID of attachment" type="int" variable="$post_id">
1588
  <type by_reference="false">int</type>
1589
  </tag>
1590
- <tag line="4046" name="param" description="optional; if $post_id is zero, path to the image file." type="string" variable="$path">
1591
  <type by_reference="false">string</type>
1592
  </tag>
1593
- <tag line="4046" name="return" description="Meta data variables" type="array">
1594
  <type by_reference="false">array</type>
1595
  </tag>
1596
  </docblock>
1597
- <argument line="4058">
1598
  <name>$post_id</name>
1599
  <default><![CDATA[]]></default>
1600
  <type/>
1601
  </argument>
1602
- <argument line="4058">
1603
  <name>$path</name>
1604
  <default><![CDATA['']]></default>
1605
  <type/>
1606
  </argument>
1607
  </method>
1608
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4126" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1609
  <name>mla_update_item_postmeta</name>
1610
  <full_name>mla_update_item_postmeta</full_name>
1611
- <docblock line="4116">
1612
- <description><![CDATA[Update custom field data for a single attachment.]]></description>
1613
  <long-description><![CDATA[]]></long-description>
1614
- <tag line="4116" name="since" description="1.40"/>
1615
- <tag line="4116" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
1616
  <type by_reference="false">int</type>
1617
  </tag>
1618
- <tag line="4116" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_meta">
1619
  <type by_reference="false">array</type>
1620
  </tag>
1621
- <tag line="4116" name="return" description="success/failure message(s)" type="string">
1622
  <type by_reference="false">string</type>
1623
  </tag>
1624
  </docblock>
1625
- <argument line="4126">
1626
  <name>$post_id</name>
1627
  <default><![CDATA[]]></default>
1628
  <type/>
1629
  </argument>
1630
- <argument line="4126">
1631
  <name>$new_meta</name>
1632
  <default><![CDATA[]]></default>
1633
  <type/>
1634
  </argument>
1635
  </method>
1636
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="4254" package="Media Library Assistant">
1637
  <name>mla_update_single_item</name>
1638
  <full_name>mla_update_single_item</full_name>
1639
- <docblock line="4241">
1640
- <description><![CDATA[Update a single item; change the meta data
1641
- for a single attachment.]]></description>
1642
  <long-description><![CDATA[]]></long-description>
1643
- <tag line="4241" name="since" description="0.1"/>
1644
- <tag line="4241" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
1645
  <type by_reference="false">int</type>
1646
  </tag>
1647
- <tag line="4241" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_data">
1648
  <type by_reference="false">array</type>
1649
  </tag>
1650
- <tag line="4241" name="param" description="Optional taxonomy term values, default null" type="array" variable="$tax_input">
1651
  <type by_reference="false">array</type>
1652
  </tag>
1653
- <tag line="4241" name="param" description="Optional taxonomy actions (add, remove, replace), default null" type="array" variable="$tax_actions">
1654
  <type by_reference="false">array</type>
1655
  </tag>
1656
- <tag line="4241" name="return" description="success/failure message and NULL content" type="array">
1657
  <type by_reference="false">array</type>
1658
  </tag>
1659
  </docblock>
1660
- <argument line="4254">
1661
  <name>$post_id</name>
1662
  <default><![CDATA[]]></default>
1663
  <type/>
1664
  </argument>
1665
- <argument line="4254">
1666
  <name>$new_data</name>
1667
  <default><![CDATA[]]></default>
1668
  <type/>
1669
  </argument>
1670
- <argument line="4254">
1671
  <name>$tax_input</name>
1672
  <default><![CDATA[NULL]]></default>
1673
  <type/>
1674
  </argument>
1675
- <argument line="4254">
1676
  <name>$tax_actions</name>
1677
  <default><![CDATA[NULL]]></default>
1678
  <type/>
1679
  </argument>
1680
  </method>
1681
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="4467" package="Media Library Assistant">
1682
  <name>_remove_tags</name>
1683
  <full_name>_remove_tags</full_name>
1684
- <docblock line="4456">
1685
  <description><![CDATA[Remove tags from a term ids list]]></description>
1686
  <long-description><![CDATA[]]></long-description>
1687
- <tag line="4456" name="since" description="0.40"/>
1688
- <tag line="4456" name="param" description="The term ids currently assigned" type="array" variable="$terms_before">
1689
  <type by_reference="false">array</type>
1690
  </tag>
1691
- <tag line="4456" name="param" description="| string The term ids (array) or names (string) to remove" type="array" variable="$tags">
1692
  <type by_reference="false">array</type>
1693
  </tag>
1694
- <tag line="4456" name="param" description="The taxonomy object" type="object" variable="$taxonomy_obj">
1695
  <type by_reference="false">object</type>
1696
  </tag>
1697
- <tag line="4456" name="return" description="Term ids of the surviving tags" type="array">
1698
  <type by_reference="false">array</type>
1699
  </tag>
1700
  </docblock>
1701
- <argument line="4467">
1702
  <name>$terms_before</name>
1703
  <default><![CDATA[]]></default>
1704
  <type/>
1705
  </argument>
1706
- <argument line="4467">
1707
  <name>$tags</name>
1708
  <default><![CDATA[]]></default>
1709
  <type/>
1710
  </argument>
1711
- <argument line="4467">
1712
  <name>$taxonomy_obj</name>
1713
  <default><![CDATA[]]></default>
1714
  <type/>
1715
  </argument>
1716
  </method>
1717
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="4511" package="Media Library Assistant">
1718
  <name>_hex_dump</name>
1719
  <full_name>_hex_dump</full_name>
1720
- <docblock line="4499">
1721
  <description><![CDATA[Format printable version of binary data]]></description>
1722
  <long-description><![CDATA[]]></long-description>
1723
- <tag line="4499" name="since" description="0.90"/>
1724
- <tag line="4499" name="param" description="Binary data" type="string" variable="$data">
1725
  <type by_reference="false">string</type>
1726
  </tag>
1727
- <tag line="4499" name="param" description="Bytes to format, default = 0 (all bytes)" type="integer" variable="$limit">
1728
  <type by_reference="false">integer</type>
1729
  </tag>
1730
- <tag line="4499" name="param" description="Bytes to format on each line" type="\intger" variable="$bytes_per_row">
1731
  <type by_reference="false">\intger</type>
1732
  </tag>
1733
- <tag line="4499" name="param" description="offset of initial byte, or -1 to suppress printing offset information" type="integer" variable="$offset">
1734
  <type by_reference="false">integer</type>
1735
  </tag>
1736
- <tag line="4499" name="return" description="Printable representation of $data" type="string">
1737
  <type by_reference="false">string</type>
1738
  </tag>
1739
  </docblock>
1740
- <argument line="4511">
1741
  <name>$data</name>
1742
  <default><![CDATA[]]></default>
1743
  <type/>
1744
  </argument>
1745
- <argument line="4511">
1746
  <name>$limit</name>
1747
  <default><![CDATA[0]]></default>
1748
  <type/>
1749
  </argument>
1750
- <argument line="4511">
1751
  <name>$bytes_per_row</name>
1752
  <default><![CDATA[16]]></default>
1753
  <type/>
1754
  </argument>
1755
- <argument line="4511">
1756
  <name>$offset</name>
1757
  <default><![CDATA[-1]]></default>
1758
  <type/>
@@ -1760,10 +1871,10 @@ for a single attachment.]]></description>
1760
  </method>
1761
  </class>
1762
  <markers>
1763
- <todo line="2783">encode the rest</todo>
1764
  </markers>
1765
  </file>
1766
- <file path="includes\class-mla-edit-media.php" hash="ffa4ba62a4969d2e50e12b044ce0cace" package="Media Library Assistant">
1767
  <docblock line="2">
1768
  <description><![CDATA[Media Library Assistant Edit Media screen enhancements]]></description>
1769
  <long-description><![CDATA[]]></long-description>
@@ -1780,15 +1891,15 @@ for a single attachment.]]></description>
1780
  <tag line="9" name="package" description="Media Library Assistant"/>
1781
  <tag line="9" name="since" description="0.80"/>
1782
  </docblock>
1783
- <property final="false" static="true" visibility="private" line="203" namespace="global" package="Media Library Assistant">
1784
  <name>$mla_references</name>
1785
  <default><![CDATA[null]]></default>
1786
- <docblock line="193">
1787
  <description><![CDATA[Where-used values for the current item]]></description>
1788
  <long-description><![CDATA[<p>This array contains the Featured/Inserted/Gallery/MLA Gallery references for the item.
1789
  The array is built once each page load and cached for subsequent calls.</p>]]></long-description>
1790
- <tag line="193" name="since" description="0.80"/>
1791
- <tag line="193" name="var" description="" type="array">
1792
  <type by_reference="false">array</type>
1793
  </tag>
1794
  </docblock>
@@ -1806,8 +1917,8 @@ The array is built once each page load and cached for subsequent calls.</p>]]></
1806
  </docblock>
1807
  </method>
1808
  <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="55" package="Media Library Assistant">
1809
- <name>mla_custom_field_support_action</name>
1810
- <full_name>mla_custom_field_support_action</full_name>
1811
  <docblock line="47">
1812
  <description><![CDATA[Adds Custom Field support to the Edit Media screen.]]></description>
1813
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
@@ -1817,249 +1928,249 @@ The array is built once each page load and cached for subsequent calls.</p>]]></
1817
  </tag>
1818
  </docblock>
1819
  </method>
1820
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="69" package="Media Library Assistant">
1821
  <name>mla_post_updated_messages_filter</name>
1822
  <full_name>mla_post_updated_messages_filter</full_name>
1823
- <docblock line="59">
1824
  <description><![CDATA[Adds mapping update messages for display at the top of the Edit Media screen.]]></description>
1825
  <long-description><![CDATA[<p>Declared public because it is a filter.</p>]]></long-description>
1826
- <tag line="59" name="since" description="1.10"/>
1827
- <tag line="59" name="param" description="messages for the Edit screen" type="array" variable="$messages">
1828
  <type by_reference="false">array</type>
1829
  </tag>
1830
- <tag line="59" name="return" description="updated messages" type="array">
1831
  <type by_reference="false">array</type>
1832
  </tag>
1833
  </docblock>
1834
- <argument line="69">
1835
  <name>$messages</name>
1836
  <default><![CDATA[]]></default>
1837
  <type/>
1838
  </argument>
1839
  </method>
1840
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="86" package="Media Library Assistant">
1841
  <name>mla_attachment_submitbox_action</name>
1842
  <full_name>mla_attachment_submitbox_action</full_name>
1843
- <docblock line="78">
1844
  <description><![CDATA[Adds Last Modified date to the Submit box on the Edit Media screen.]]></description>
1845
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
1846
- <tag line="78" name="since" description="0.80"/>
1847
- <tag line="78" name="return" description="echoes the HTML markup for the label and value" type="void">
1848
  <type by_reference="false">void</type>
1849
  </tag>
1850
  </docblock>
1851
  </method>
1852
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="119" package="Media Library Assistant">
1853
  <name>mla_add_meta_boxes_action</name>
1854
  <full_name>mla_add_meta_boxes_action</full_name>
1855
- <docblock line="108">
1856
  <description><![CDATA[Registers meta boxes for the Edit Media screen.]]></description>
1857
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
1858
- <tag line="108" name="since" description="0.80"/>
1859
- <tag line="108" name="param" description="type of the current post, e.g., 'attachment' (optional, default 'unknown')" type="string" variable="$post_type">
1860
  <type by_reference="false">string</type>
1861
  </tag>
1862
- <tag line="108" name="param" description="current post (optional, default (object) array ( 'ID' =&gt; 0 ))" type="object" variable="$post">
1863
  <type by_reference="false">object</type>
1864
  </tag>
1865
- <tag line="108" name="return" description="" type="void">
1866
  <type by_reference="false">void</type>
1867
  </tag>
1868
  </docblock>
1869
- <argument line="119">
1870
  <name>$post_type</name>
1871
  <default><![CDATA['unknown']]></default>
1872
  <type/>
1873
  </argument>
1874
- <argument line="119">
1875
  <name>$post</name>
1876
  <default><![CDATA[NULL]]></default>
1877
  <type/>
1878
  </argument>
1879
  </method>
1880
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="155" package="Media Library Assistant">
1881
  <name>mla_edit_add_help_tab</name>
1882
  <full_name>mla_edit_add_help_tab</full_name>
1883
- <docblock line="145">
1884
  <description><![CDATA[Add contextual help tabs to the WordPress Edit Media page]]></description>
1885
  <long-description><![CDATA[]]></long-description>
1886
- <tag line="145" name="since" description="0.90"/>
1887
- <tag line="145" name="param" description="title as shown on the screen" type="string" variable="$admin_title">
1888
  <type by_reference="false">string</type>
1889
  </tag>
1890
- <tag line="145" name="param" description="title as shown in the HTML header" type="string" variable="$title">
1891
  <type by_reference="false">string</type>
1892
  </tag>
1893
- <tag line="145" name="return" description="" type="void">
1894
  <type by_reference="false">void</type>
1895
  </tag>
1896
  </docblock>
1897
- <argument line="155">
1898
  <name>$admin_title</name>
1899
  <default><![CDATA[]]></default>
1900
  <type/>
1901
  </argument>
1902
- <argument line="155">
1903
  <name>$title</name>
1904
  <default><![CDATA[]]></default>
1905
  <type/>
1906
  </argument>
1907
  </method>
1908
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="215" package="Media Library Assistant">
1909
  <name>mla_parent_info_handler</name>
1910
  <full_name>mla_parent_info_handler</full_name>
1911
- <docblock line="205">
1912
  <description><![CDATA[Renders the Parent Info meta box on the Edit Media page.]]></description>
1913
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
1914
- <tag line="205" name="since" description="0.80"/>
1915
- <tag line="205" name="param" description="current post" type="object" variable="$post">
1916
  <type by_reference="false">object</type>
1917
  </tag>
1918
- <tag line="205" name="return" description="echoes the HTML markup for the meta box content" type="void">
1919
  <type by_reference="false">void</type>
1920
  </tag>
1921
  </docblock>
1922
- <argument line="215">
1923
  <name>$post</name>
1924
  <default><![CDATA[]]></default>
1925
  <type/>
1926
  </argument>
1927
  </method>
1928
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="240" package="Media Library Assistant">
1929
  <name>mla_menu_order_handler</name>
1930
  <full_name>mla_menu_order_handler</full_name>
1931
- <docblock line="230">
1932
  <description><![CDATA[Renders the Menu Order meta box on the Edit Media page.]]></description>
1933
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
1934
- <tag line="230" name="since" description="0.80"/>
1935
- <tag line="230" name="param" description="current post" type="object" variable="$post">
1936
  <type by_reference="false">object</type>
1937
  </tag>
1938
- <tag line="230" name="return" description="echoes the HTML markup for the meta box content" type="void">
1939
  <type by_reference="false">void</type>
1940
  </tag>
1941
  </docblock>
1942
- <argument line="240">
1943
  <name>$post</name>
1944
  <default><![CDATA[]]></default>
1945
  <type/>
1946
  </argument>
1947
  </method>
1948
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="255" package="Media Library Assistant">
1949
  <name>mla_image_metadata_handler</name>
1950
  <full_name>mla_image_metadata_handler</full_name>
1951
- <docblock line="245">
1952
  <description><![CDATA[Renders the Image Metadata meta box on the Edit Media page.]]></description>
1953
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
1954
- <tag line="245" name="since" description="0.80"/>
1955
- <tag line="245" name="param" description="current post" type="object" variable="$post">
1956
  <type by_reference="false">object</type>
1957
  </tag>
1958
- <tag line="245" name="return" description="echoes the HTML markup for the meta box content" type="void">
1959
  <type by_reference="false">void</type>
1960
  </tag>
1961
  </docblock>
1962
- <argument line="255">
1963
  <name>$post</name>
1964
  <default><![CDATA[]]></default>
1965
  <type/>
1966
  </argument>
1967
  </method>
1968
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="276" package="Media Library Assistant">
1969
  <name>mla_featured_in_handler</name>
1970
  <full_name>mla_featured_in_handler</full_name>
1971
- <docblock line="266">
1972
  <description><![CDATA[Renders the Featured in meta box on the Edit Media page.]]></description>
1973
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
1974
- <tag line="266" name="since" description="0.80"/>
1975
- <tag line="266" name="param" description="current post" type="object" variable="$post">
1976
  <type by_reference="false">object</type>
1977
  </tag>
1978
- <tag line="266" name="return" description="echoes the HTML markup for the meta box content" type="void">
1979
  <type by_reference="false">void</type>
1980
  </tag>
1981
  </docblock>
1982
- <argument line="276">
1983
  <name>$post</name>
1984
  <default><![CDATA[]]></default>
1985
  <type/>
1986
  </argument>
1987
  </method>
1988
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="306" package="Media Library Assistant">
1989
  <name>mla_inserted_in_handler</name>
1990
  <full_name>mla_inserted_in_handler</full_name>
1991
- <docblock line="296">
1992
  <description><![CDATA[Renders the Inserted in meta box on the Edit Media page.]]></description>
1993
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
1994
- <tag line="296" name="since" description="0.80"/>
1995
- <tag line="296" name="param" description="current post" type="object" variable="$post">
1996
  <type by_reference="false">object</type>
1997
  </tag>
1998
- <tag line="296" name="return" description="echoes the HTML markup for the meta box content" type="void">
1999
  <type by_reference="false">void</type>
2000
  </tag>
2001
  </docblock>
2002
- <argument line="306">
2003
  <name>$post</name>
2004
  <default><![CDATA[]]></default>
2005
  <type/>
2006
  </argument>
2007
  </method>
2008
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="340" package="Media Library Assistant">
2009
  <name>mla_gallery_in_handler</name>
2010
  <full_name>mla_gallery_in_handler</full_name>
2011
- <docblock line="330">
2012
  <description><![CDATA[Renders the Gallery in meta box on the Edit Media page.]]></description>
2013
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
2014
- <tag line="330" name="since" description="0.80"/>
2015
- <tag line="330" name="param" description="current post" type="object" variable="$post">
2016
  <type by_reference="false">object</type>
2017
  </tag>
2018
- <tag line="330" name="return" description="echoes the HTML markup for the meta box content" type="void">
2019
  <type by_reference="false">void</type>
2020
  </tag>
2021
  </docblock>
2022
- <argument line="340">
2023
  <name>$post</name>
2024
  <default><![CDATA[]]></default>
2025
  <type/>
2026
  </argument>
2027
  </method>
2028
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="370" package="Media Library Assistant">
2029
  <name>mla_mla_gallery_in_handler</name>
2030
  <full_name>mla_mla_gallery_in_handler</full_name>
2031
- <docblock line="360">
2032
  <description><![CDATA[Renders the Gallery in meta box on the Edit Media page.]]></description>
2033
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
2034
- <tag line="360" name="since" description="0.80"/>
2035
- <tag line="360" name="param" description="current post" type="object" variable="$post">
2036
  <type by_reference="false">object</type>
2037
  </tag>
2038
- <tag line="360" name="return" description="echoes the HTML markup for the meta box content" type="void">
2039
  <type by_reference="false">void</type>
2040
  </tag>
2041
  </docblock>
2042
- <argument line="370">
2043
  <name>$post</name>
2044
  <default><![CDATA[]]></default>
2045
  <type/>
2046
  </argument>
2047
  </method>
2048
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="400" package="Media Library Assistant">
2049
  <name>mla_edit_attachment_action</name>
2050
  <full_name>mla_edit_attachment_action</full_name>
2051
- <docblock line="390">
2052
  <description><![CDATA[Saves updates from the Edit Media screen.]]></description>
2053
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
2054
- <tag line="390" name="since" description="0.80"/>
2055
- <tag line="390" name="param" description="ID of the current post" type="integer" variable="$post_ID">
2056
  <type by_reference="false">integer</type>
2057
  </tag>
2058
- <tag line="390" name="return" description="" type="void">
2059
  <type by_reference="false">void</type>
2060
  </tag>
2061
  </docblock>
2062
- <argument line="400">
2063
  <name>$post_ID</name>
2064
  <default><![CDATA[]]></default>
2065
  <type/>
@@ -2067,7 +2178,7 @@ The array is built once each page load and cached for subsequent calls.</p>]]></
2067
  </method>
2068
  </class>
2069
  </file>
2070
- <file path="includes\class-mla-list-table.php" hash="5a90b71280002569d10abfd4e2018d73" package="Media Library Assistant">
2071
  <docblock line="2">
2072
  <description><![CDATA[Media Library Assistant extended List Table class]]></description>
2073
  <long-description><![CDATA[]]></long-description>
@@ -2435,605 +2546,605 @@ is given special treatment when columns are processed.</p>]]></long-description>
2435
  <type/>
2436
  </argument>
2437
  </method>
2438
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="606" package="Media Library Assistant">
2439
  <name>column_ID_parent</name>
2440
  <full_name>column_ID_parent</full_name>
2441
- <docblock line="598">
2442
  <description><![CDATA[Supply the content for a custom column]]></description>
2443
  <long-description><![CDATA[]]></long-description>
2444
- <tag line="598" name="since" description="0.1"/>
2445
- <tag line="598" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2446
  <type by_reference="false">array</type>
2447
  </tag>
2448
- <tag line="598" name="return" description="HTML markup to be placed inside the column" type="string">
2449
  <type by_reference="false">string</type>
2450
  </tag>
2451
  </docblock>
2452
- <argument line="606">
2453
  <name>$item</name>
2454
  <default><![CDATA[]]></default>
2455
  <type/>
2456
  </argument>
2457
  </method>
2458
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="638" package="Media Library Assistant">
2459
  <name>column_title_name</name>
2460
  <full_name>column_title_name</full_name>
2461
- <docblock line="630">
2462
  <description><![CDATA[Supply the content for a custom column]]></description>
2463
  <long-description><![CDATA[]]></long-description>
2464
- <tag line="630" name="since" description="0.1"/>
2465
- <tag line="630" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2466
  <type by_reference="false">array</type>
2467
  </tag>
2468
- <tag line="630" name="return" description="HTML markup to be placed inside the column" type="string">
2469
  <type by_reference="false">string</type>
2470
  </tag>
2471
  </docblock>
2472
- <argument line="638">
2473
  <name>$item</name>
2474
  <default><![CDATA[]]></default>
2475
  <type/>
2476
  </argument>
2477
  </method>
2478
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="661" package="Media Library Assistant">
2479
  <name>column_post_title</name>
2480
  <full_name>column_post_title</full_name>
2481
- <docblock line="653">
2482
  <description><![CDATA[Supply the content for a custom column]]></description>
2483
  <long-description><![CDATA[]]></long-description>
2484
- <tag line="653" name="since" description="0.1"/>
2485
- <tag line="653" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2486
  <type by_reference="false">array</type>
2487
  </tag>
2488
- <tag line="653" name="return" description="HTML markup to be placed inside the column" type="string">
2489
  <type by_reference="false">string</type>
2490
  </tag>
2491
  </docblock>
2492
- <argument line="661">
2493
  <name>$item</name>
2494
  <default><![CDATA[]]></default>
2495
  <type/>
2496
  </argument>
2497
  </method>
2498
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="679" package="Media Library Assistant">
2499
  <name>column_post_name</name>
2500
  <full_name>column_post_name</full_name>
2501
- <docblock line="671">
2502
  <description><![CDATA[Supply the content for a custom column]]></description>
2503
  <long-description><![CDATA[]]></long-description>
2504
- <tag line="671" name="since" description="0.1"/>
2505
- <tag line="671" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2506
  <type by_reference="false">array</type>
2507
  </tag>
2508
- <tag line="671" name="return" description="HTML markup to be placed inside the column" type="string">
2509
  <type by_reference="false">string</type>
2510
  </tag>
2511
  </docblock>
2512
- <argument line="679">
2513
  <name>$item</name>
2514
  <default><![CDATA[]]></default>
2515
  <type/>
2516
  </argument>
2517
  </method>
2518
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="697" package="Media Library Assistant">
2519
  <name>column_parent</name>
2520
  <full_name>column_parent</full_name>
2521
- <docblock line="689">
2522
  <description><![CDATA[Supply the content for a custom column]]></description>
2523
  <long-description><![CDATA[]]></long-description>
2524
- <tag line="689" name="since" description="0.1"/>
2525
- <tag line="689" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2526
  <type by_reference="false">array</type>
2527
  </tag>
2528
- <tag line="689" name="return" description="HTML markup to be placed inside the column" type="string">
2529
  <type by_reference="false">string</type>
2530
  </tag>
2531
  </docblock>
2532
- <argument line="697">
2533
  <name>$item</name>
2534
  <default><![CDATA[]]></default>
2535
  <type/>
2536
  </argument>
2537
  </method>
2538
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="722" package="Media Library Assistant">
2539
  <name>column_menu_order</name>
2540
  <full_name>column_menu_order</full_name>
2541
- <docblock line="714">
2542
  <description><![CDATA[Supply the content for a custom column]]></description>
2543
  <long-description><![CDATA[]]></long-description>
2544
- <tag line="714" name="since" description="0.60"/>
2545
- <tag line="714" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2546
  <type by_reference="false">array</type>
2547
  </tag>
2548
- <tag line="714" name="return" description="HTML markup to be placed inside the column" type="string">
2549
  <type by_reference="false">string</type>
2550
  </tag>
2551
  </docblock>
2552
- <argument line="722">
2553
  <name>$item</name>
2554
  <default><![CDATA[]]></default>
2555
  <type/>
2556
  </argument>
2557
  </method>
2558
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="734" package="Media Library Assistant">
2559
  <name>column_featured</name>
2560
  <full_name>column_featured</full_name>
2561
- <docblock line="726">
2562
  <description><![CDATA[Supply the content for a custom column]]></description>
2563
  <long-description><![CDATA[]]></long-description>
2564
- <tag line="726" name="since" description="0.1"/>
2565
- <tag line="726" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2566
  <type by_reference="false">array</type>
2567
  </tag>
2568
- <tag line="726" name="return" description="HTML markup to be placed inside the column" type="string">
2569
  <type by_reference="false">string</type>
2570
  </tag>
2571
  </docblock>
2572
- <argument line="734">
2573
  <name>$item</name>
2574
  <default><![CDATA[]]></default>
2575
  <type/>
2576
  </argument>
2577
  </method>
2578
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="766" package="Media Library Assistant">
2579
  <name>column_inserted</name>
2580
  <full_name>column_inserted</full_name>
2581
- <docblock line="758">
2582
  <description><![CDATA[Supply the content for a custom column]]></description>
2583
  <long-description><![CDATA[]]></long-description>
2584
- <tag line="758" name="since" description="0.1"/>
2585
- <tag line="758" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2586
  <type by_reference="false">array</type>
2587
  </tag>
2588
- <tag line="758" name="return" description="HTML markup to be placed inside the column" type="string">
2589
  <type by_reference="false">string</type>
2590
  </tag>
2591
  </docblock>
2592
- <argument line="766">
2593
  <name>$item</name>
2594
  <default><![CDATA[]]></default>
2595
  <type/>
2596
  </argument>
2597
  </method>
2598
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="802" package="Media Library Assistant">
2599
  <name>column_galleries</name>
2600
  <full_name>column_galleries</full_name>
2601
- <docblock line="794">
2602
  <description><![CDATA[Supply the content for a custom column]]></description>
2603
  <long-description><![CDATA[]]></long-description>
2604
- <tag line="794" name="since" description="0.70"/>
2605
- <tag line="794" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2606
  <type by_reference="false">array</type>
2607
  </tag>
2608
- <tag line="794" name="return" description="HTML markup to be placed inside the column" type="string">
2609
  <type by_reference="false">string</type>
2610
  </tag>
2611
  </docblock>
2612
- <argument line="802">
2613
  <name>$item</name>
2614
  <default><![CDATA[]]></default>
2615
  <type/>
2616
  </argument>
2617
  </method>
2618
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="834" package="Media Library Assistant">
2619
  <name>column_mla_galleries</name>
2620
  <full_name>column_mla_galleries</full_name>
2621
- <docblock line="826">
2622
  <description><![CDATA[Supply the content for a custom column]]></description>
2623
  <long-description><![CDATA[]]></long-description>
2624
- <tag line="826" name="since" description="0.70"/>
2625
- <tag line="826" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2626
  <type by_reference="false">array</type>
2627
  </tag>
2628
- <tag line="826" name="return" description="HTML markup to be placed inside the column" type="string">
2629
  <type by_reference="false">string</type>
2630
  </tag>
2631
  </docblock>
2632
- <argument line="834">
2633
  <name>$item</name>
2634
  <default><![CDATA[]]></default>
2635
  <type/>
2636
  </argument>
2637
  </method>
2638
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="866" package="Media Library Assistant">
2639
  <name>column_alt_text</name>
2640
  <full_name>column_alt_text</full_name>
2641
- <docblock line="858">
2642
  <description><![CDATA[Supply the content for a custom column]]></description>
2643
  <long-description><![CDATA[]]></long-description>
2644
- <tag line="858" name="since" description="0.1"/>
2645
- <tag line="858" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2646
  <type by_reference="false">array</type>
2647
  </tag>
2648
- <tag line="858" name="return" description="HTML markup to be placed inside the column" type="string">
2649
  <type by_reference="false">string</type>
2650
  </tag>
2651
  </docblock>
2652
- <argument line="866">
2653
  <name>$item</name>
2654
  <default><![CDATA[]]></default>
2655
  <type/>
2656
  </argument>
2657
  </method>
2658
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="886" package="Media Library Assistant">
2659
  <name>column_caption</name>
2660
  <full_name>column_caption</full_name>
2661
- <docblock line="878">
2662
  <description><![CDATA[Supply the content for a custom column]]></description>
2663
  <long-description><![CDATA[]]></long-description>
2664
- <tag line="878" name="since" description="0.1"/>
2665
- <tag line="878" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2666
  <type by_reference="false">array</type>
2667
  </tag>
2668
- <tag line="878" name="return" description="HTML markup to be placed inside the column" type="string">
2669
  <type by_reference="false">string</type>
2670
  </tag>
2671
  </docblock>
2672
- <argument line="886">
2673
  <name>$item</name>
2674
  <default><![CDATA[]]></default>
2675
  <type/>
2676
  </argument>
2677
  </method>
2678
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="898" package="Media Library Assistant">
2679
  <name>column_description</name>
2680
  <full_name>column_description</full_name>
2681
- <docblock line="890">
2682
  <description><![CDATA[Supply the content for a custom column]]></description>
2683
  <long-description><![CDATA[]]></long-description>
2684
- <tag line="890" name="since" description="0.1"/>
2685
- <tag line="890" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2686
  <type by_reference="false">array</type>
2687
  </tag>
2688
- <tag line="890" name="return" description="HTML markup to be placed inside the column" type="string">
2689
  <type by_reference="false">string</type>
2690
  </tag>
2691
  </docblock>
2692
- <argument line="898">
2693
  <name>$item</name>
2694
  <default><![CDATA[]]></default>
2695
  <type/>
2696
  </argument>
2697
  </method>
2698
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="910" package="Media Library Assistant">
2699
  <name>column_post_mime_type</name>
2700
  <full_name>column_post_mime_type</full_name>
2701
- <docblock line="902">
2702
  <description><![CDATA[Supply the content for a custom column]]></description>
2703
  <long-description><![CDATA[]]></long-description>
2704
- <tag line="902" name="since" description="0.30"/>
2705
- <tag line="902" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2706
  <type by_reference="false">array</type>
2707
  </tag>
2708
- <tag line="902" name="return" description="HTML markup to be placed inside the column" type="string">
2709
  <type by_reference="false">string</type>
2710
  </tag>
2711
  </docblock>
2712
- <argument line="910">
2713
  <name>$item</name>
2714
  <default><![CDATA[]]></default>
2715
  <type/>
2716
  </argument>
2717
  </method>
2718
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="926" package="Media Library Assistant">
2719
  <name>column_file_url</name>
2720
  <full_name>column_file_url</full_name>
2721
- <docblock line="918">
2722
  <description><![CDATA[Supply the content for a custom column]]></description>
2723
  <long-description><![CDATA[]]></long-description>
2724
- <tag line="918" name="since" description="0.1"/>
2725
- <tag line="918" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2726
  <type by_reference="false">array</type>
2727
  </tag>
2728
- <tag line="918" name="return" description="HTML markup to be placed inside the column" type="string">
2729
  <type by_reference="false">string</type>
2730
  </tag>
2731
  </docblock>
2732
- <argument line="926">
2733
  <name>$item</name>
2734
  <default><![CDATA[]]></default>
2735
  <type/>
2736
  </argument>
2737
  </method>
2738
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="940" package="Media Library Assistant">
2739
  <name>column_base_file</name>
2740
  <full_name>column_base_file</full_name>
2741
- <docblock line="932">
2742
  <description><![CDATA[Supply the content for a custom column]]></description>
2743
  <long-description><![CDATA[]]></long-description>
2744
- <tag line="932" name="since" description="0.1"/>
2745
- <tag line="932" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2746
  <type by_reference="false">array</type>
2747
  </tag>
2748
- <tag line="932" name="return" description="HTML markup to be placed inside the column" type="string">
2749
  <type by_reference="false">string</type>
2750
  </tag>
2751
  </docblock>
2752
- <argument line="940">
2753
  <name>$item</name>
2754
  <default><![CDATA[]]></default>
2755
  <type/>
2756
  </argument>
2757
  </method>
2758
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="952" package="Media Library Assistant">
2759
  <name>column_date</name>
2760
  <full_name>column_date</full_name>
2761
- <docblock line="944">
2762
  <description><![CDATA[Supply the content for a custom column]]></description>
2763
  <long-description><![CDATA[]]></long-description>
2764
- <tag line="944" name="since" description="0.1"/>
2765
- <tag line="944" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2766
  <type by_reference="false">array</type>
2767
  </tag>
2768
- <tag line="944" name="return" description="HTML markup to be placed inside the column" type="string">
2769
  <type by_reference="false">string</type>
2770
  </tag>
2771
  </docblock>
2772
- <argument line="952">
2773
  <name>$item</name>
2774
  <default><![CDATA[]]></default>
2775
  <type/>
2776
  </argument>
2777
  </method>
2778
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="981" package="Media Library Assistant">
2779
  <name>column_modified</name>
2780
  <full_name>column_modified</full_name>
2781
- <docblock line="973">
2782
  <description><![CDATA[Supply the content for a custom column]]></description>
2783
  <long-description><![CDATA[]]></long-description>
2784
- <tag line="973" name="since" description="0.30"/>
2785
- <tag line="973" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2786
  <type by_reference="false">array</type>
2787
  </tag>
2788
- <tag line="973" name="return" description="HTML markup to be placed inside the column" type="string">
2789
  <type by_reference="false">string</type>
2790
  </tag>
2791
  </docblock>
2792
- <argument line="981">
2793
  <name>$item</name>
2794
  <default><![CDATA[]]></default>
2795
  <type/>
2796
  </argument>
2797
  </method>
2798
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1010" package="Media Library Assistant">
2799
  <name>column_author</name>
2800
  <full_name>column_author</full_name>
2801
- <docblock line="1002">
2802
  <description><![CDATA[Supply the content for a custom column]]></description>
2803
  <long-description><![CDATA[]]></long-description>
2804
- <tag line="1002" name="since" description="0.30"/>
2805
- <tag line="1002" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2806
  <type by_reference="false">array</type>
2807
  </tag>
2808
- <tag line="1002" name="return" description="HTML markup to be placed inside the column" type="string">
2809
  <type by_reference="false">string</type>
2810
  </tag>
2811
  </docblock>
2812
- <argument line="1010">
2813
  <name>$item</name>
2814
  <default><![CDATA[]]></default>
2815
  <type/>
2816
  </argument>
2817
  </method>
2818
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1031" package="Media Library Assistant">
2819
  <name>column_attached_to</name>
2820
  <full_name>column_attached_to</full_name>
2821
- <docblock line="1023">
2822
  <description><![CDATA[Supply the content for a custom column]]></description>
2823
  <long-description><![CDATA[]]></long-description>
2824
- <tag line="1023" name="since" description="0.1"/>
2825
- <tag line="1023" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2826
  <type by_reference="false">array</type>
2827
  </tag>
2828
- <tag line="1023" name="return" description="HTML markup to be placed inside the column" type="string">
2829
  <type by_reference="false">string</type>
2830
  </tag>
2831
  </docblock>
2832
- <argument line="1031">
2833
  <name>$item</name>
2834
  <default><![CDATA[]]></default>
2835
  <type/>
2836
  </argument>
2837
  </method>
2838
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1062" package="Media Library Assistant">
2839
  <name>mla_submenu_arguments</name>
2840
  <full_name>mla_submenu_arguments</full_name>
2841
- <docblock line="1053">
2842
  <description><![CDATA[Process $_REQUEST, building $submenu_arguments]]></description>
2843
  <long-description><![CDATA[]]></long-description>
2844
- <tag line="1053" name="since" description="1.42"/>
2845
- <tag line="1053" name="param" description="Optional: Include the &quot;click filter&quot; values in the results" type="boolean" variable="$include_filters">
2846
  <type by_reference="false">boolean</type>
2847
  </tag>
2848
- <tag line="1053" name="return" description="non-empty view, search, filter and sort arguments" type="array">
2849
  <type by_reference="false">array</type>
2850
  </tag>
2851
  </docblock>
2852
- <argument line="1062">
2853
  <name>$include_filters</name>
2854
  <default><![CDATA[true]]></default>
2855
  <type/>
2856
  </argument>
2857
  </method>
2858
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1151" package="Media Library Assistant">
2859
  <name>pagination</name>
2860
  <full_name>pagination</full_name>
2861
- <docblock line="1143">
2862
  <description><![CDATA[Display the pagination, adding view, search and filter arguments]]></description>
2863
  <long-description><![CDATA[]]></long-description>
2864
- <tag line="1143" name="since" description="1.42"/>
2865
- <tag line="1143" name="param" description="'top' | 'bottom'" type="string" variable="$which">
2866
  <type by_reference="false">string</type>
2867
  </tag>
2868
- <tag line="1143" name="return" description="" type="void">
2869
  <type by_reference="false">void</type>
2870
  </tag>
2871
  </docblock>
2872
- <argument line="1151">
2873
  <name>$which</name>
2874
  <default><![CDATA[]]></default>
2875
  <type/>
2876
  </argument>
2877
  </method>
2878
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1165" package="Media Library Assistant">
2879
  <name>get_columns</name>
2880
  <full_name>get_columns</full_name>
2881
- <docblock line="1158">
2882
  <description><![CDATA[This method dictates the table's columns and titles]]></description>
2883
  <long-description><![CDATA[]]></long-description>
2884
- <tag line="1158" name="since" description="0.1"/>
2885
- <tag line="1158" name="return" description="Column information: 'slugs'=&gt;'Visible Titles'" type="array">
2886
  <type by_reference="false">array</type>
2887
  </tag>
2888
  </docblock>
2889
  </method>
2890
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1177" package="Media Library Assistant">
2891
  <name>get_hidden_columns</name>
2892
  <full_name>get_hidden_columns</full_name>
2893
- <docblock line="1169">
2894
  <description><![CDATA[Returns the list of currently hidden columns from a user option or
2895
  from default values if the option is not set]]></description>
2896
  <long-description><![CDATA[]]></long-description>
2897
- <tag line="1169" name="since" description="0.1"/>
2898
- <tag line="1169" name="return" description="Column information,e.g., array(0 =&gt; 'ID_parent, 1 =&gt; 'title_name')" type="array">
2899
  <type by_reference="false">array</type>
2900
  </tag>
2901
  </docblock>
2902
  </method>
2903
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1197" package="Media Library Assistant">
2904
  <name>get_sortable_columns</name>
2905
  <full_name>get_sortable_columns</full_name>
2906
- <docblock line="1187">
2907
  <description><![CDATA[Returns an array where the key is the column that needs to be sortable
2908
  and the value is db column to sort by.]]></description>
2909
  <long-description><![CDATA[<p>Also notes the current sort column,
2910
  if set.</p>]]></long-description>
2911
- <tag line="1187" name="since" description="0.1"/>
2912
- <tag line="1187" name="return" description="Sortable column information,e.g., 'slugs'=&gt;array('data_values',boolean)" type="array">
2913
  <type by_reference="false">array</type>
2914
  </tag>
2915
  </docblock>
2916
  </method>
2917
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1223" package="Media Library Assistant">
2918
  <name>print_column_headers</name>
2919
  <full_name>print_column_headers</full_name>
2920
- <docblock line="1216">
2921
  <description><![CDATA[Print column headers, adding view, search and filter arguments]]></description>
2922
  <long-description><![CDATA[]]></long-description>
2923
- <tag line="1216" name="since" description="1.42"/>
2924
- <tag line="1216" name="param" description="Whether to set the id attribute or not" type="bool" variable="$with_id">
2925
  <type by_reference="false">bool</type>
2926
  </tag>
2927
  </docblock>
2928
- <argument line="1223">
2929
  <name>$with_id</name>
2930
  <default><![CDATA[true]]></default>
2931
  <type/>
2932
  </argument>
2933
  </method>
2934
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1240" package="Media Library Assistant">
2935
  <name>_get_view</name>
2936
  <full_name>_get_view</full_name>
2937
- <docblock line="1230">
2938
  <description><![CDATA[Returns HTML markup for one view that can be used with this table]]></description>
2939
  <long-description><![CDATA[]]></long-description>
2940
- <tag line="1230" name="since" description="1.40"/>
2941
- <tag line="1230" name="param" description="View slug, key to MLA_POST_MIME_TYPES array" type="string" variable="$view_slug">
2942
  <type by_reference="false">string</type>
2943
  </tag>
2944
- <tag line="1230" name="param" description="Slug for current view" type="string" variable="$current_view">
2945
  <type by_reference="false">string</type>
2946
  </tag>
2947
- <tag line="1230" name="return" description="| false HTML for link to display the view, false if count = zero" type="string">
2948
  <type by_reference="false">string</type>
2949
  </tag>
2950
  </docblock>
2951
- <argument line="1240">
2952
  <name>$view_slug</name>
2953
  <default><![CDATA[]]></default>
2954
  <type/>
2955
  </argument>
2956
- <argument line="1240">
2957
  <name>$current_view</name>
2958
  <default><![CDATA[]]></default>
2959
  <type/>
2960
  </argument>
2961
  </method>
2962
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1350" package="Media Library Assistant">
2963
  <name>get_views</name>
2964
  <full_name>get_views</full_name>
2965
- <docblock line="1342">
2966
  <description><![CDATA[Returns an associative array listing all the views that can be used with this table.]]></description>
2967
  <long-description><![CDATA[<p>These are listed across the top of the page and managed by WordPress.</p>]]></long-description>
2968
- <tag line="1342" name="since" description="0.1"/>
2969
- <tag line="1342" name="return" description="View information,e.g., array ( id =&gt; link )" type="array">
2970
  <type by_reference="false">array</type>
2971
  </tag>
2972
  </docblock>
2973
  </method>
2974
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1398" package="Media Library Assistant">
2975
  <name>get_bulk_actions</name>
2976
  <full_name>get_bulk_actions</full_name>
2977
- <docblock line="1390">
2978
  <description><![CDATA[Get an associative array ( option_name => option_title ) with the list
2979
  of bulk actions available on this table.]]></description>
2980
  <long-description><![CDATA[]]></long-description>
2981
- <tag line="1390" name="since" description="0.1"/>
2982
- <tag line="1390" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
2983
  <type by_reference="false">array</type>
2984
  </tag>
2985
  </docblock>
2986
  </method>
2987
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1429" package="Media Library Assistant">
2988
  <name>extra_tablenav</name>
2989
  <full_name>extra_tablenav</full_name>
2990
- <docblock line="1418">
2991
  <description><![CDATA[Extra controls to be displayed between bulk actions and pagination]]></description>
2992
  <long-description><![CDATA[<p>Modeled after class-wp-posts-list-table.php in wp-admin/includes.</p>]]></long-description>
2993
- <tag line="1418" name="since" description="0.1"/>
2994
- <tag line="1418" name="param" description="'top' or 'bottom', i.e., above or below the table rows" type="string" variable="$which">
2995
  <type by_reference="false">string</type>
2996
  </tag>
2997
- <tag line="1418" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
2998
  <type by_reference="false">array</type>
2999
  </tag>
3000
  </docblock>
3001
- <argument line="1429">
3002
  <name>$which</name>
3003
  <default><![CDATA[]]></default>
3004
  <type/>
3005
  </argument>
3006
  </method>
3007
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1466" package="Media Library Assistant">
3008
  <name>prepare_items</name>
3009
  <full_name>prepare_items</full_name>
3010
- <docblock line="1454">
3011
  <description><![CDATA[Prepares the list of items for displaying]]></description>
3012
  <long-description><![CDATA[<p>This is where you prepare your data for display. This method will usually
3013
  be used to query the database, sort and filter the data, and generally
3014
  get it ready to be displayed. At a minimum, we should set $this->items and
3015
  $this->set_pagination_args().</p>]]></long-description>
3016
- <tag line="1454" name="since" description="0.1"/>
3017
- <tag line="1454" name="return" description="" type="void">
3018
  <type by_reference="false">void</type>
3019
  </tag>
3020
  </docblock>
3021
  </method>
3022
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1513" package="Media Library Assistant">
3023
  <name>single_row</name>
3024
  <full_name>single_row</full_name>
3025
- <docblock line="1504">
3026
  <description><![CDATA[Generates (echoes) content for a single row of the table]]></description>
3027
  <long-description><![CDATA[]]></long-description>
3028
- <tag line="1504" name="since" description=".20"/>
3029
- <tag line="1504" name="param" description="the current item" type="object" variable="$item">
3030
  <type by_reference="false">object</type>
3031
  </tag>
3032
- <tag line="1504" name="return" description="Echoes the row HTML" type="void">
3033
  <type by_reference="false">void</type>
3034
  </tag>
3035
  </docblock>
3036
- <argument line="1513">
3037
  <name>$item</name>
3038
  <default><![CDATA[]]></default>
3039
  <type/>
@@ -3041,7 +3152,7 @@ $this->set_pagination_args().</p>]]></long-description>
3041
  </method>
3042
  </class>
3043
  </file>
3044
- <file path="includes\class-mla-main.php" hash="e5727fc114c04807546516c3e5927f74" package="Media Library Assistant">
3045
  <docblock line="2">
3046
  <description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
3047
  <long-description><![CDATA[]]></long-description>
@@ -3078,7 +3189,7 @@ of images and files held in the WordPress Media Library.]]></description>
3078
  <constant namespace="global" line="41" package="Media Library Assistant">
3079
  <name>CURRENT_MLA_VERSION</name>
3080
  <full_name>CURRENT_MLA_VERSION</full_name>
3081
- <value><![CDATA['1.50']]></value>
3082
  <docblock line="34">
3083
  <description><![CDATA[Current version number]]></description>
3084
  <long-description><![CDATA[]]></long-description>
@@ -3651,7 +3762,7 @@ change the meta data for a single attachment.]]></description>
3651
  </method>
3652
  </class>
3653
  </file>
3654
- <file path="includes\class-mla-media-modal.php" hash="989ae04fc16eb02102df255989fefa46" package="Media Library Assistant">
3655
  <docblock line="2">
3656
  <description><![CDATA[Media Library Assistant Media Manager enhancements]]></description>
3657
  <long-description><![CDATA[]]></long-description>
@@ -3800,78 +3911,78 @@ and mla_print_media_templates_action]]></description>
3800
  <type/>
3801
  </argument>
3802
  </method>
3803
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="216" package="Media Library Assistant">
3804
  <name>mla_media_view_strings_filter</name>
3805
  <full_name>mla_media_view_strings_filter</full_name>
3806
- <docblock line="205">
3807
  <description><![CDATA[Adds strings values to be passed to the Media Manager in /wp-includes/js/media-views.js.]]></description>
3808
  <long-description><![CDATA[<p>Declared public because it is a filter.</p>]]></long-description>
3809
- <tag line="205" name="since" description="1.20"/>
3810
- <tag line="205" name="param" description="associative array with string =&gt; value pairs" type="array" variable="$strings">
3811
  <type by_reference="false">array</type>
3812
  </tag>
3813
- <tag line="205" name="param" description="|| NULL current post object, if available" type="object" variable="$post">
3814
  <type by_reference="false">object</type>
3815
  </tag>
3816
- <tag line="205" name="return" description="updated $strings array" type="array">
3817
  <type by_reference="false">array</type>
3818
  </tag>
3819
  </docblock>
3820
- <argument line="216">
3821
  <name>$strings</name>
3822
  <default><![CDATA[]]></default>
3823
  <type/>
3824
  </argument>
3825
- <argument line="216">
3826
  <name>$post</name>
3827
  <default><![CDATA[]]></default>
3828
  <type/>
3829
  </argument>
3830
  </method>
3831
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="233" package="Media Library Assistant">
3832
  <name>mla_wp_enqueue_media_action</name>
3833
  <full_name>mla_wp_enqueue_media_action</full_name>
3834
- <docblock line="225">
3835
  <description><![CDATA[Enqueues the mla-media-modal-scripts.js file, adding it to the Media Manager scripts.]]></description>
3836
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
3837
- <tag line="225" name="since" description="1.20"/>
3838
- <tag line="225" name="return" description="" type="void">
3839
  <type by_reference="false">void</type>
3840
  </tag>
3841
  </docblock>
3842
  </method>
3843
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="251" package="Media Library Assistant">
3844
  <name>mla_print_media_templates_action</name>
3845
  <full_name>mla_print_media_templates_action</full_name>
3846
- <docblock line="243">
3847
  <description><![CDATA[Prints the templates used in the MLA Media Manager enhancements.]]></description>
3848
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
3849
- <tag line="243" name="since" description="1.20"/>
3850
- <tag line="243" name="return" description="echoes HTML script tags for the templates" type="void">
3851
  <type by_reference="false">void</type>
3852
  </tag>
3853
  </docblock>
3854
  </method>
3855
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="353" package="Media Library Assistant">
3856
  <name>mla_admin_init_ajax_action</name>
3857
  <full_name>mla_admin_init_ajax_action</full_name>
3858
- <docblock line="344">
3859
  <description><![CDATA[Adjust ajax handler for Media Manager queries]]></description>
3860
  <long-description><![CDATA[<p>Replace 'query-attachments' with our own handler if the request is coming from the "Assistant" tab</p>]]></long-description>
3861
- <tag line="344" name="since" description="1.20"/>
3862
- <tag line="344" name="return" description="" type="void">
3863
  <type by_reference="false">void</type>
3864
  </tag>
3865
  </docblock>
3866
  </method>
3867
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="371" package="Media Library Assistant">
3868
  <name>mla_query_attachments_action</name>
3869
  <full_name>mla_query_attachments_action</full_name>
3870
- <docblock line="362">
3871
  <description><![CDATA[Ajax handler for Media Manager queries]]></description>
3872
  <long-description><![CDATA[<p>Adapted from wp_ajax_query_attachments in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
3873
- <tag line="362" name="since" description="1.20"/>
3874
- <tag line="362" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
3875
  <type by_reference="false">void</type>
3876
  </tag>
3877
  </docblock>
@@ -5205,7 +5316,7 @@ which returns a count of the attachments assigned a given term]]></description>
5205
  </method>
5206
  </class>
5207
  </file>
5208
- <file path="includes\class-mla-options.php" hash="00e9a7aa62ec4d5613c98416d09ce8db" package="Media Library Assistant">
5209
  <docblock line="2">
5210
  <description><![CDATA[Manages the plugin option settings]]></description>
5211
  <long-description><![CDATA[]]></long-description>
@@ -5439,103 +5550,141 @@ and provides functions to get and put them from/to WordPress option variables]]>
5439
  <long-description><![CDATA[]]></long-description>
5440
  </docblock>
5441
  </constant>
5442
- <constant namespace="global" line="142" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
5443
  <name>MLA_POST_MIME_TYPES</name>
5444
  <full_name>MLA_POST_MIME_TYPES</full_name>
5445
  <value><![CDATA['post_mime_types']]></value>
5446
- <docblock line="139">
5447
  <description><![CDATA[Provides a unique name for the Post MIME Types option]]></description>
5448
  <long-description><![CDATA[]]></long-description>
5449
  </docblock>
5450
  </constant>
5451
- <constant namespace="global" line="147" package="Media Library Assistant">
5452
  <name>MLA_ENABLE_POST_MIME_TYPES</name>
5453
  <full_name>MLA_ENABLE_POST_MIME_TYPES</full_name>
5454
  <value><![CDATA['enable_post_mime_types']]></value>
5455
- <docblock line="144">
5456
  <description><![CDATA[Provides a unique name for the Enable Post MIME Types option]]></description>
5457
  <long-description><![CDATA[]]></long-description>
5458
  </docblock>
5459
  </constant>
5460
- <constant namespace="global" line="152" package="Media Library Assistant">
5461
  <name>MLA_UPLOAD_MIMES</name>
5462
  <full_name>MLA_UPLOAD_MIMES</full_name>
5463
  <value><![CDATA['upload_mimes']]></value>
5464
- <docblock line="149">
5465
  <description><![CDATA[Provides a unique name for the Upload MIME Types option]]></description>
5466
  <long-description><![CDATA[]]></long-description>
5467
  </docblock>
5468
  </constant>
5469
- <constant namespace="global" line="157" package="Media Library Assistant">
5470
  <name>MLA_ENABLE_UPLOAD_MIMES</name>
5471
  <full_name>MLA_ENABLE_UPLOAD_MIMES</full_name>
5472
  <value><![CDATA['enable_upload_mimes']]></value>
5473
- <docblock line="154">
5474
  <description><![CDATA[Provides a unique name for the Enable Upload MIME Types option]]></description>
5475
  <long-description><![CDATA[]]></long-description>
5476
  </docblock>
5477
  </constant>
5478
- <constant namespace="global" line="162" package="Media Library Assistant">
5479
  <name>MLA_ENABLE_MLA_ICONS</name>
5480
  <full_name>MLA_ENABLE_MLA_ICONS</full_name>
5481
  <value><![CDATA['enable_mla_icons']]></value>
5482
- <docblock line="159">
5483
  <description><![CDATA[Provides a unique name for the Enable MLA Icons option]]></description>
5484
  <long-description><![CDATA[]]></long-description>
5485
  </docblock>
5486
  </constant>
5487
- <property final="false" static="true" visibility="public" line="173" namespace="global" package="Media Library Assistant">
5488
  <name>$process_featured_in</name>
5489
  <default><![CDATA[true]]></default>
5490
- <docblock line="164">
5491
  <description><![CDATA[Option setting for "Featured in" reporting]]></description>
5492
  <long-description><![CDATA[<p>This setting is false if the "Featured in" database access setting is "disabled", else true.</p>]]></long-description>
5493
- <tag line="164" name="since" description="1.00"/>
5494
- <tag line="164" name="var" description="" type="boolean">
5495
  <type by_reference="false">boolean</type>
5496
  </tag>
5497
  </docblock>
5498
  </property>
5499
- <property final="false" static="true" visibility="public" line="184" namespace="global" package="Media Library Assistant">
5500
  <name>$process_inserted_in</name>
5501
  <default><![CDATA[true]]></default>
5502
- <docblock line="175">
5503
  <description><![CDATA[Option setting for "Inserted in" reporting]]></description>
5504
  <long-description><![CDATA[<p>This setting is false if the "Inserted in" database access setting is "disabled", else true.</p>]]></long-description>
5505
- <tag line="175" name="since" description="1.00"/>
5506
- <tag line="175" name="var" description="" type="boolean">
5507
  <type by_reference="false">boolean</type>
5508
  </tag>
5509
  </docblock>
5510
  </property>
5511
- <property final="false" static="true" visibility="public" line="195" namespace="global" package="Media Library Assistant">
5512
  <name>$process_gallery_in</name>
5513
  <default><![CDATA[true]]></default>
5514
- <docblock line="186">
5515
  <description><![CDATA[Option setting for "Gallery in" reporting]]></description>
5516
  <long-description><![CDATA[<p>This setting is false if the "Gallery in" database access setting is "disabled", else true.</p>]]></long-description>
5517
- <tag line="186" name="since" description="1.00"/>
5518
- <tag line="186" name="var" description="" type="boolean">
5519
  <type by_reference="false">boolean</type>
5520
  </tag>
5521
  </docblock>
5522
  </property>
5523
- <property final="false" static="true" visibility="public" line="206" namespace="global" package="Media Library Assistant">
5524
  <name>$process_mla_gallery_in</name>
5525
  <default><![CDATA[true]]></default>
5526
- <docblock line="197">
5527
  <description><![CDATA[Option setting for "MLA Gallery in" reporting]]></description>
5528
  <long-description><![CDATA[<p>This setting is false if the "MLA Gallery in" database access setting is "disabled", else true.</p>]]></long-description>
5529
- <tag line="197" name="since" description="1.00"/>
5530
- <tag line="197" name="var" description="" type="boolean">
5531
  <type by_reference="false">boolean</type>
5532
  </tag>
5533
  </docblock>
5534
  </property>
5535
- <property final="false" static="true" visibility="public" line="233" namespace="global" package="Media Library Assistant">
5536
  <name>$mla_option_definitions</name>
5537
- <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.'), '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>
5538
- <docblock line="208">
5539
  <description><![CDATA[$mla_option_definitions defines the database options and admin page areas for setting/updating them.]]></description>
5540
  <long-description><![CDATA[<p>Each option is defined by an array with the following elements:</p>
5541
 
@@ -5561,947 +5710,947 @@ reset => reset function for 'custom' options; returns nothing. Usage:
5561
  $message = ['reset']( 'reset', $key, $value, $_REQUEST );</p>]]></long-description>
5562
  </docblock>
5563
  </property>
5564
- <property final="false" static="true" visibility="private" line="805" namespace="global" package="Media Library Assistant">
5565
  <name>$mla_option_templates</name>
5566
  <default><![CDATA[null]]></default>
5567
- <docblock line="798">
5568
  <description><![CDATA[Style and Markup templates]]></description>
5569
  <long-description><![CDATA[]]></long-description>
5570
- <tag line="798" name="since" description="0.80"/>
5571
- <tag line="798" name="var" description="" type="array">
5572
  <type by_reference="false">array</type>
5573
  </tag>
5574
  </docblock>
5575
  </property>
5576
- <property final="false" static="true" visibility="private" line="1967" namespace="global" package="Media Library Assistant">
5577
  <name>$custom_field_data_sources</name>
5578
  <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>
5579
- <docblock line="1960">
5580
  <description><![CDATA[Array of Data Source names for custom field mapping]]></description>
5581
  <long-description><![CDATA[]]></long-description>
5582
- <tag line="1960" name="since" description="1.10"/>
5583
- <tag line="1960" name="var" description="" type="array">
5584
  <type by_reference="false">array</type>
5585
  </tag>
5586
  </docblock>
5587
  </property>
5588
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="779" package="Media Library Assistant">
5589
  <name>initialize</name>
5590
  <full_name>initialize</full_name>
5591
- <docblock line="772">
5592
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
5593
  <long-description><![CDATA[]]></long-description>
5594
- <tag line="772" name="since" description="1.00"/>
5595
- <tag line="772" name="return" description="" type="void">
5596
  <type by_reference="false">void</type>
5597
  </tag>
5598
  </docblock>
5599
  </method>
5600
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="814" package="Media Library Assistant">
5601
  <name>_load_option_templates</name>
5602
  <full_name>_load_option_templates</full_name>
5603
- <docblock line="807">
5604
  <description><![CDATA[Load style and markup templates to $mla_templates]]></description>
5605
  <long-description><![CDATA[]]></long-description>
5606
- <tag line="807" name="since" description="0.80"/>
5607
- <tag line="807" name="return" description="" type="void">
5608
  <type by_reference="false">void</type>
5609
  </tag>
5610
  </docblock>
5611
  </method>
5612
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="862" package="Media Library Assistant">
5613
  <name>mla_fetch_gallery_template</name>
5614
  <full_name>mla_fetch_gallery_template</full_name>
5615
- <docblock line="852">
5616
  <description><![CDATA[Fetch style or markup template from $mla_templates]]></description>
5617
  <long-description><![CDATA[]]></long-description>
5618
- <tag line="852" name="since" description="0.80"/>
5619
- <tag line="852" name="param" description="Template name" type="string" variable="$key">
5620
  <type by_reference="false">string</type>
5621
  </tag>
5622
- <tag line="852" name="param" description="Template type; 'style' (default) or 'markup'" type="string" variable="$type">
5623
  <type by_reference="false">string</type>
5624
  </tag>
5625
- <tag line="852" name="return" description="requested template, false if not found or null if no templates" type="string|boolean|null">
5626
  <type by_reference="false">string</type>
5627
  <type by_reference="false">boolean</type>
5628
  <type by_reference="false">null</type>
5629
  </tag>
5630
  </docblock>
5631
- <argument line="862">
5632
  <name>$key</name>
5633
  <default><![CDATA[]]></default>
5634
  <type/>
5635
  </argument>
5636
- <argument line="862">
5637
  <name>$type</name>
5638
  <default><![CDATA['style']]></default>
5639
  <type/>
5640
  </argument>
5641
  </method>
5642
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="885" package="Media Library Assistant">
5643
  <name>mla_get_style_templates</name>
5644
  <full_name>mla_get_style_templates</full_name>
5645
- <docblock line="878">
5646
  <description><![CDATA[Get ALL style templates from $mla_templates, including 'default']]></description>
5647
  <long-description><![CDATA[]]></long-description>
5648
- <tag line="878" name="since" description="0.80"/>
5649
- <tag line="878" name="return" description="name =&gt; value for all style templates or null if no templates" type="array|null">
5650
  <type by_reference="false">array</type>
5651
  <type by_reference="false">null</type>
5652
  </tag>
5653
  </docblock>
5654
  </method>
5655
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="911" package="Media Library Assistant">
5656
  <name>mla_put_style_templates</name>
5657
  <full_name>mla_put_style_templates</full_name>
5658
- <docblock line="903">
5659
  <description><![CDATA[Put user-defined style templates to $mla_templates and database]]></description>
5660
  <long-description><![CDATA[]]></long-description>
5661
- <tag line="903" name="since" description="0.80"/>
5662
- <tag line="903" name="param" description="name =&gt; value for all user-defined style templates" type="array" variable="$templates">
5663
  <type by_reference="false">array</type>
5664
  </tag>
5665
- <tag line="903" name="return" description="true if success, false if failure" type="boolean">
5666
  <type by_reference="false">boolean</type>
5667
  </tag>
5668
  </docblock>
5669
- <argument line="911">
5670
  <name>$templates</name>
5671
  <default><![CDATA[]]></default>
5672
  <type/>
5673
  </argument>
5674
  </method>
5675
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="927" package="Media Library Assistant">
5676
  <name>mla_get_markup_templates</name>
5677
  <full_name>mla_get_markup_templates</full_name>
5678
- <docblock line="920">
5679
  <description><![CDATA[Get ALL markup templates from $mla_templates, including 'default']]></description>
5680
  <long-description><![CDATA[]]></long-description>
5681
- <tag line="920" name="since" description="0.80"/>
5682
- <tag line="920" name="return" description="name =&gt; value for all markup templates or null if no templates" type="array|null">
5683
  <type by_reference="false">array</type>
5684
  <type by_reference="false">null</type>
5685
  </tag>
5686
  </docblock>
5687
  </method>
5688
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="982" package="Media Library Assistant">
5689
  <name>mla_put_markup_templates</name>
5690
  <full_name>mla_put_markup_templates</full_name>
5691
- <docblock line="974">
5692
  <description><![CDATA[Put user-defined markup templates to $mla_templates and database]]></description>
5693
  <long-description><![CDATA[]]></long-description>
5694
- <tag line="974" name="since" description="0.80"/>
5695
- <tag line="974" name="param" description="name =&gt; value for all user-defined markup templates" type="array" variable="$templates">
5696
  <type by_reference="false">array</type>
5697
  </tag>
5698
- <tag line="974" name="return" description="true if success, false if failure" type="boolean">
5699
  <type by_reference="false">boolean</type>
5700
  </tag>
5701
  </docblock>
5702
- <argument line="982">
5703
  <name>$templates</name>
5704
  <default><![CDATA[]]></default>
5705
  <type/>
5706
  </argument>
5707
  </method>
5708
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1002" package="Media Library Assistant">
5709
  <name>mla_get_option</name>
5710
  <full_name>mla_get_option</full_name>
5711
- <docblock line="991">
5712
  <description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
5713
  <long-description><![CDATA[]]></long-description>
5714
- <tag line="991" name="since" description="0.1"/>
5715
- <tag line="991" name="param" description="Name of the desired option" type="string" variable="$option">
5716
  <type by_reference="false">string</type>
5717
  </tag>
5718
- <tag line="991" name="param" description="True to ignore current setting and return default values" type="boolean" variable="$get_default">
5719
  <type by_reference="false">boolean</type>
5720
  </tag>
5721
- <tag line="991" name="param" description="True to ignore default values and return only stored values" type="boolean" variable="$get_stored">
5722
  <type by_reference="false">boolean</type>
5723
  </tag>
5724
- <tag line="991" name="return" description="Value(s) for the option or false if the option is not a defined MLA option" type="mixed">
5725
  <type by_reference="false">mixed</type>
5726
  </tag>
5727
  </docblock>
5728
- <argument line="1002">
5729
  <name>$option</name>
5730
  <default><![CDATA[]]></default>
5731
  <type/>
5732
  </argument>
5733
- <argument line="1002">
5734
  <name>$get_default</name>
5735
  <default><![CDATA[false]]></default>
5736
  <type/>
5737
  </argument>
5738
- <argument line="1002">
5739
  <name>$get_stored</name>
5740
  <default><![CDATA[false]]></default>
5741
  <type/>
5742
  </argument>
5743
  </method>
5744
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1029" package="Media Library Assistant">
5745
  <name>mla_update_option</name>
5746
  <full_name>mla_update_option</full_name>
5747
- <docblock line="1019">
5748
  <description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
5749
  <long-description><![CDATA[]]></long-description>
5750
- <tag line="1019" name="since" description="0.1"/>
5751
- <tag line="1019" name="param" description="Name of the desired option" type="string" variable="$option">
5752
  <type by_reference="false">string</type>
5753
  </tag>
5754
- <tag line="1019" name="param" description="New value for the desired option" type="mixed" variable="$newvalue">
5755
  <type by_reference="false">mixed</type>
5756
  </tag>
5757
- <tag line="1019" name="return" description="True if the value was changed or false if the update failed" type="boolean">
5758
  <type by_reference="false">boolean</type>
5759
  </tag>
5760
  </docblock>
5761
- <argument line="1029">
5762
  <name>$option</name>
5763
  <default><![CDATA[]]></default>
5764
  <type/>
5765
  </argument>
5766
- <argument line="1029">
5767
  <name>$newvalue</name>
5768
  <default><![CDATA[]]></default>
5769
  <type/>
5770
  </argument>
5771
  </method>
5772
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1045" package="Media Library Assistant">
5773
  <name>mla_delete_option</name>
5774
  <full_name>mla_delete_option</full_name>
5775
- <docblock line="1036">
5776
  <description><![CDATA[Delete the stored value of a defined MLA option]]></description>
5777
  <long-description><![CDATA[]]></long-description>
5778
- <tag line="1036" name="since" description="0.1"/>
5779
- <tag line="1036" name="param" description="Name of the desired option" type="string" variable="$option">
5780
  <type by_reference="false">string</type>
5781
  </tag>
5782
- <tag line="1036" name="return" description="True if the option was deleted, otherwise false" type="boolean">
5783
  <type by_reference="false">boolean</type>
5784
  </tag>
5785
  </docblock>
5786
- <argument line="1045">
5787
  <name>$option</name>
5788
  <default><![CDATA[]]></default>
5789
  <type/>
5790
  </argument>
5791
  </method>
5792
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1066" package="Media Library Assistant">
5793
  <name>mla_taxonomy_support</name>
5794
  <full_name>mla_taxonomy_support</full_name>
5795
- <docblock line="1053">
5796
  <description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
5797
  settings are being updated or reset.]]></description>
5798
  <long-description><![CDATA[]]></long-description>
5799
- <tag line="1053" name="since" description="0.30"/>
5800
- <tag line="1053" name="param" description="Taxonomy name, e.g., attachment_category" type="string" variable="$tax_name">
5801
  <type by_reference="false">string</type>
5802
  </tag>
5803
- <tag line="1053" name="param" description="Optional. 'support' (default), 'quick-edit' or 'filter'" type="string" variable="$support_type">
5804
  <type by_reference="false">string</type>
5805
  </tag>
5806
- <tag line="1053" 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">
5807
  <type by_reference="false">boolean</type>
5808
  <type by_reference="false">string</type>
5809
  </tag>
5810
  </docblock>
5811
- <argument line="1066">
5812
  <name>$tax_name</name>
5813
  <default><![CDATA[]]></default>
5814
  <type/>
5815
  </argument>
5816
- <argument line="1066">
5817
  <name>$support_type</name>
5818
  <default><![CDATA['support']]></default>
5819
  <type/>
5820
  </argument>
5821
  </method>
5822
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1142" package="Media Library Assistant">
5823
  <name>mla_taxonomy_option_handler</name>
5824
  <full_name>mla_taxonomy_option_handler</full_name>
5825
- <docblock line="1129">
5826
  <description><![CDATA[Render and manage taxonomy support options, e.g., Categories and Post Tags]]></description>
5827
  <long-description><![CDATA[]]></long-description>
5828
- <tag line="1129" name="since" description="0.30"/>
5829
- <tag line="1129" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
5830
- <tag line="1129" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
5831
  <type by_reference="false">string</type>
5832
  </tag>
5833
- <tag line="1129" name="param" description="option name, e.g., 'taxonomy_support'" type="string" variable="$key">
5834
  <type by_reference="false">string</type>
5835
  </tag>
5836
- <tag line="1129" name="param" description="option parameters" type="array" variable="$value">
5837
  <type by_reference="false">array</type>
5838
  </tag>
5839
- <tag line="1129" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
5840
  <type by_reference="false">array</type>
5841
  </tag>
5842
- <tag line="1129" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
5843
  <type by_reference="false">string</type>
5844
  </tag>
5845
  </docblock>
5846
- <argument line="1142">
5847
  <name>$action</name>
5848
  <default><![CDATA[]]></default>
5849
  <type/>
5850
  </argument>
5851
- <argument line="1142">
5852
  <name>$key</name>
5853
  <default><![CDATA[]]></default>
5854
  <type/>
5855
  </argument>
5856
- <argument line="1142">
5857
  <name>$value</name>
5858
  <default><![CDATA[]]></default>
5859
  <type/>
5860
  </argument>
5861
- <argument line="1142">
5862
  <name>$args</name>
5863
  <default><![CDATA[null]]></default>
5864
  <type/>
5865
  </argument>
5866
  </method>
5867
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1250" package="Media Library Assistant">
5868
  <name>mla_add_attachment_action</name>
5869
  <full_name>mla_add_attachment_action</full_name>
5870
- <docblock line="1241">
5871
  <description><![CDATA[Perform ITC/EXIF mapping on just-inserted attachment]]></description>
5872
  <long-description><![CDATA[]]></long-description>
5873
- <tag line="1241" name="since" description="1.00"/>
5874
- <tag line="1241" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
5875
  <type by_reference="false">integer</type>
5876
  </tag>
5877
- <tag line="1241" name="return" description="" type="void">
5878
  <type by_reference="false">void</type>
5879
  </tag>
5880
  </docblock>
5881
- <argument line="1250">
5882
  <name>$post_id</name>
5883
  <default><![CDATA[]]></default>
5884
  <type/>
5885
  </argument>
5886
  </method>
5887
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1270" package="Media Library Assistant">
5888
  <name>mla_update_attachment_metadata_filter</name>
5889
  <full_name>mla_update_attachment_metadata_filter</full_name>
5890
- <docblock line="1260">
5891
  <description><![CDATA[Perform Custom Field mapping on just-inserted or updated attachment]]></description>
5892
  <long-description><![CDATA[]]></long-description>
5893
- <tag line="1260" name="since" description="1.10"/>
5894
- <tag line="1260" name="param" description="Attachment metadata for just-inserted attachment" type="array" variable="$data">
5895
  <type by_reference="false">array</type>
5896
  </tag>
5897
- <tag line="1260" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
5898
  <type by_reference="false">integer</type>
5899
  </tag>
5900
- <tag line="1260" name="return" description="" type="void">
5901
  <type by_reference="false">void</type>
5902
  </tag>
5903
  </docblock>
5904
- <argument line="1270">
5905
  <name>$data</name>
5906
  <default><![CDATA[]]></default>
5907
  <type/>
5908
  </argument>
5909
- <argument line="1270">
5910
  <name>$post_id</name>
5911
  <default><![CDATA[]]></default>
5912
  <type/>
5913
  </argument>
5914
  </method>
5915
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1290" package="Media Library Assistant">
5916
  <name>mla_custom_field_option_value</name>
5917
  <full_name>mla_custom_field_option_value</full_name>
5918
- <docblock line="1281">
5919
  <description><![CDATA[Fetch custom field option value given a slug]]></description>
5920
  <long-description><![CDATA[]]></long-description>
5921
- <tag line="1281" name="since" description="1.10"/>
5922
- <tag line="1281" name="param" description="slug, e.g., 'c_file-size' for the 'File Size' field" type="string" variable="$slug">
5923
  <type by_reference="false">string</type>
5924
  </tag>
5925
- <tag line="1281" name="return" description="option value, e.g., array( 'name' =&gt; 'File Size', ... )" type="array">
5926
  <type by_reference="false">array</type>
5927
  </tag>
5928
  </docblock>
5929
- <argument line="1290">
5930
  <name>$slug</name>
5931
  <default><![CDATA[]]></default>
5932
  <type/>
5933
  </argument>
5934
  </method>
5935
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1310" package="Media Library Assistant">
5936
  <name>mla_custom_field_support</name>
5937
  <full_name>mla_custom_field_support</full_name>
5938
- <docblock line="1301">
5939
  <description><![CDATA[Evaluate file information for custom field mapping]]></description>
5940
  <long-description><![CDATA[]]></long-description>
5941
- <tag line="1301" name="since" description="1.10"/>
5942
- <tag line="1301" name="param" description="array format; 'default_columns' (default), 'default_hidden_columns', 'default_sortable_columns', 'quick_edit' or 'bulk_edit'" type="string" variable="$support_type">
5943
  <type by_reference="false">string</type>
5944
  </tag>
5945
- <tag line="1301" name="return" description="default, hidden, sortable quick_edit or bulk_edit colums in appropriate format" type="array">
5946
  <type by_reference="false">array</type>
5947
  </tag>
5948
  </docblock>
5949
- <argument line="1310">
5950
  <name>$support_type</name>
5951
  <default><![CDATA['default_columns']]></default>
5952
  <type/>
5953
  </argument>
5954
  </method>
5955
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1356" package="Media Library Assistant">
5956
  <name>_evaluate_file_information</name>
5957
  <full_name>_evaluate_file_information</full_name>
5958
- <docblock line="1344">
5959
  <description><![CDATA[Evaluate file information for custom field mapping]]></description>
5960
  <long-description><![CDATA[]]></long-description>
5961
- <tag line="1344" name="since" description="1.10"/>
5962
- <tag line="1344" name="param" description="absolute path the the uploads base directory" type="string" variable="$upload_dir">
5963
  <type by_reference="false">string</type>
5964
  </tag>
5965
- <tag line="1344" name="param" description="_wp_attached_file meta_value array, indexed by post_id" type="array" variable="$wp_attached_files">
5966
  <type by_reference="false">array</type>
5967
  </tag>
5968
- <tag line="1344" name="param" description="_wp_attachment_metadata meta_value array, indexed by post_id" type="array" variable="$wp_attachment_metadata">
5969
  <type by_reference="false">array</type>
5970
  </tag>
5971
- <tag line="1344" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
5972
  <type by_reference="false">integer</type>
5973
  </tag>
5974
- <tag line="1344" 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">
5975
  <type by_reference="false">array</type>
5976
  </tag>
5977
  </docblock>
5978
- <argument line="1356">
5979
  <name>$upload_dir</name>
5980
  <default><![CDATA[]]></default>
5981
  <type/>
5982
  </argument>
5983
- <argument line="1356">
5984
  <name>$wp_attached_files</name>
5985
  <default><![CDATA[]]></default>
5986
  <type/>
5987
  </argument>
5988
- <argument line="1356">
5989
  <name>$wp_attachment_metadata</name>
5990
  <default><![CDATA[]]></default>
5991
  <type/>
5992
  </argument>
5993
- <argument line="1356">
5994
  <name>$post_id</name>
5995
  <default><![CDATA[]]></default>
5996
  <type/>
5997
  </argument>
5998
  </method>
5999
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1425" package="Media Library Assistant">
6000
  <name>_evaluate_post_information</name>
6001
  <full_name>_evaluate_post_information</full_name>
6002
- <docblock line="1414">
6003
  <description><![CDATA[Evaluate post information for custom field mapping]]></description>
6004
  <long-description><![CDATA[]]></long-description>
6005
- <tag line="1414" name="since" description="1.40"/>
6006
- <tag line="1414" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
6007
  <type by_reference="false">integer</type>
6008
  </tag>
6009
- <tag line="1414" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
6010
  <type by_reference="false">string</type>
6011
  </tag>
6012
- <tag line="1414" name="param" description="data source name ( post_date or post_parent )" type="string" variable="$data_source">
6013
  <type by_reference="false">string</type>
6014
  </tag>
6015
- <tag line="1414" name="return" description="'post_date' =&gt; (string) upload date, 'post_parent' =&gt; (integer) ID of parent or zero )" type="mixed">
6016
  <type by_reference="false">mixed</type>
6017
  </tag>
6018
  </docblock>
6019
- <argument line="1425">
6020
  <name>$post_id</name>
6021
  <default><![CDATA[]]></default>
6022
  <type/>
6023
  </argument>
6024
- <argument line="1425">
6025
  <name>$category</name>
6026
  <default><![CDATA[]]></default>
6027
  <type/>
6028
  </argument>
6029
- <argument line="1425">
6030
  <name>$data_source</name>
6031
  <default><![CDATA[]]></default>
6032
  <type/>
6033
  </argument>
6034
  </method>
6035
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1461" package="Media Library Assistant">
6036
  <name>_evaluate_array_result</name>
6037
  <full_name>_evaluate_array_result</full_name>
6038
- <docblock line="1450">
6039
  <description><![CDATA[Evaluate post information for custom field mapping]]></description>
6040
  <long-description><![CDATA[]]></long-description>
6041
- <tag line="1450" name="since" description="1.40"/>
6042
- <tag line="1450" name="param" description="field value(s)" type="array" variable="$value">
6043
  <type by_reference="false">array</type>
6044
  </tag>
6045
- <tag line="1450" name="param" description="format option text|single|export|array|multi" type="string" variable="$option">
6046
  <type by_reference="false">string</type>
6047
  </tag>
6048
- <tag line="1450" name="param" description="keep existing value(s) - for 'multi' option" type="boolean" variable="$keep_existing">
6049
  <type by_reference="false">boolean</type>
6050
  </tag>
6051
- <tag line="1450" name="return" description="array for option = array|multi else string" type="mixed">
6052
  <type by_reference="false">mixed</type>
6053
  </tag>
6054
  </docblock>
6055
- <argument line="1461">
6056
  <name>$value</name>
6057
  <default><![CDATA[]]></default>
6058
  <type/>
6059
  </argument>
6060
- <argument line="1461">
6061
  <name>$option</name>
6062
  <default><![CDATA[]]></default>
6063
  <type/>
6064
  </argument>
6065
- <argument line="1461">
6066
  <name>$keep_existing</name>
6067
  <default><![CDATA[]]></default>
6068
  <type/>
6069
  </argument>
6070
  </method>
6071
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1497" package="Media Library Assistant">
6072
  <name>_evaluate_data_source</name>
6073
  <full_name>_evaluate_data_source</full_name>
6074
- <docblock line="1485">
6075
  <description><![CDATA[Evaluate custom field mapping data source]]></description>
6076
  <long-description><![CDATA[]]></long-description>
6077
- <tag line="1485" name="since" description="1.10"/>
6078
- <tag line="1485" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
6079
  <type by_reference="false">integer</type>
6080
  </tag>
6081
- <tag line="1485" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
6082
  <type by_reference="false">string</type>
6083
  </tag>
6084
- <tag line="1485" 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">
6085
  <type by_reference="false">array</type>
6086
  </tag>
6087
- <tag line="1485" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
6088
  <type by_reference="false">array</type>
6089
  </tag>
6090
- <tag line="1485" name="return" description="data source value" type="string">
6091
  <type by_reference="false">string</type>
6092
  </tag>
6093
  </docblock>
6094
- <argument line="1497">
6095
  <name>$post_id</name>
6096
  <default><![CDATA[]]></default>
6097
  <type/>
6098
  </argument>
6099
- <argument line="1497">
6100
  <name>$category</name>
6101
  <default><![CDATA[]]></default>
6102
  <type/>
6103
  </argument>
6104
- <argument line="1497">
6105
  <name>$data_value</name>
6106
  <default><![CDATA[]]></default>
6107
  <type/>
6108
  </argument>
6109
- <argument line="1497">
6110
  <name>$attachment_metadata</name>
6111
  <default><![CDATA[NULL]]></default>
6112
  <type/>
6113
  </argument>
6114
  </method>
6115
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1865" package="Media Library Assistant">
6116
  <name>mla_evaluate_custom_field_mapping</name>
6117
  <full_name>mla_evaluate_custom_field_mapping</full_name>
6118
- <docblock line="1853">
6119
  <description><![CDATA[Evaluate custom field mapping updates for a post]]></description>
6120
  <long-description><![CDATA[]]></long-description>
6121
- <tag line="1853" name="since" description="1.10"/>
6122
- <tag line="1853" name="param" description="post ID to be evaluated" type="integer" variable="$post_id">
6123
  <type by_reference="false">integer</type>
6124
  </tag>
6125
- <tag line="1853" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
6126
  <type by_reference="false">string</type>
6127
  </tag>
6128
- <tag line="1853" name="param" description="(optional) custom_field_mapping values, default NULL (use current option value)" type="array" variable="$settings">
6129
  <type by_reference="false">array</type>
6130
  </tag>
6131
- <tag line="1853" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
6132
  <type by_reference="false">array</type>
6133
  </tag>
6134
- <tag line="1853" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
6135
  <type by_reference="false">array</type>
6136
  </tag>
6137
  </docblock>
6138
- <argument line="1865">
6139
  <name>$post_id</name>
6140
  <default><![CDATA[]]></default>
6141
  <type/>
6142
  </argument>
6143
- <argument line="1865">
6144
  <name>$category</name>
6145
  <default><![CDATA[]]></default>
6146
  <type/>
6147
  </argument>
6148
- <argument line="1865">
6149
  <name>$settings</name>
6150
  <default><![CDATA[NULL]]></default>
6151
  <type/>
6152
  </argument>
6153
- <argument line="1865">
6154
  <name>$attachment_metadata</name>
6155
  <default><![CDATA[NULL]]></default>
6156
  <type/>
6157
  </argument>
6158
  </method>
6159
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1934" package="Media Library Assistant">
6160
  <name>_compose_custom_field_option_list</name>
6161
  <full_name>_compose_custom_field_option_list</full_name>
6162
- <docblock line="1923">
6163
  <description><![CDATA[Compose a Custom Field Options list with current selection]]></description>
6164
  <long-description><![CDATA[]]></long-description>
6165
- <tag line="1923" name="since" description="1.10"/>
6166
- <tag line="1923" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6167
- <tag line="1923" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
6168
  <type by_reference="false">string</type>
6169
  </tag>
6170
- <tag line="1923" name="param" description="optional list of terms to exclude from the list" type="array" variable="$blacklist">
6171
  <type by_reference="false">array</type>
6172
  </tag>
6173
- <tag line="1923" name="return" description="HTML markup with select field options" type="string">
6174
  <type by_reference="false">string</type>
6175
  </tag>
6176
  </docblock>
6177
- <argument line="1934">
6178
  <name>$selection</name>
6179
  <default><![CDATA['none']]></default>
6180
  <type/>
6181
  </argument>
6182
- <argument line="1934">
6183
  <name>$blacklist</name>
6184
  <default><![CDATA[array()]]></default>
6185
  <type/>
6186
  </argument>
6187
  </method>
6188
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2028" package="Media Library Assistant">
6189
  <name>_compose_data_source_option_list</name>
6190
  <full_name>_compose_data_source_option_list</full_name>
6191
- <docblock line="2018">
6192
  <description><![CDATA[Compose a (Custom Field) Data Source Options list with current selection]]></description>
6193
  <long-description><![CDATA[]]></long-description>
6194
- <tag line="2018" name="since" description="1.10"/>
6195
- <tag line="2018" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6196
- <tag line="2018" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
6197
  <type by_reference="false">string</type>
6198
  </tag>
6199
- <tag line="2018" name="return" description="HTML markup with select field options" type="string">
6200
  <type by_reference="false">string</type>
6201
  </tag>
6202
  </docblock>
6203
- <argument line="2028">
6204
  <name>$selection</name>
6205
  <default><![CDATA['none']]></default>
6206
  <type/>
6207
  </argument>
6208
  </method>
6209
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2093" package="Media Library Assistant">
6210
  <name>_update_custom_field_mapping</name>
6211
  <full_name>_update_custom_field_mapping</full_name>
6212
- <docblock line="2083">
6213
  <description><![CDATA[Update custom field mappings]]></description>
6214
  <long-description><![CDATA[]]></long-description>
6215
- <tag line="2083" name="since" description="1.10"/>
6216
- <tag line="2083" name="param" description="current custom_field_mapping values" type="array" variable="$current_values">
6217
  <type by_reference="false">array</type>
6218
  </tag>
6219
- <tag line="2083" name="param" description="new values" type="array" variable="$new_values">
6220
  <type by_reference="false">array</type>
6221
  </tag>
6222
- <tag line="2083" 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">
6223
  <type by_reference="false">array</type>
6224
  </tag>
6225
  </docblock>
6226
- <argument line="2093">
6227
  <name>$current_values</name>
6228
  <default><![CDATA[]]></default>
6229
  <type/>
6230
  </argument>
6231
- <argument line="2093">
6232
  <name>$new_values</name>
6233
  <default><![CDATA[]]></default>
6234
  <type/>
6235
  </argument>
6236
  </method>
6237
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2291" package="Media Library Assistant">
6238
  <name>mla_custom_field_option_handler</name>
6239
  <full_name>mla_custom_field_option_handler</full_name>
6240
- <docblock line="2278">
6241
  <description><![CDATA[Render and manage custom field mapping options]]></description>
6242
  <long-description><![CDATA[]]></long-description>
6243
- <tag line="2278" name="since" description="1.10"/>
6244
- <tag line="2278" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6245
- <tag line="2278" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
6246
  <type by_reference="false">string</type>
6247
  </tag>
6248
- <tag line="2278" name="param" description="option name, e.g., 'custom_field_mapping'" type="string" variable="$key">
6249
  <type by_reference="false">string</type>
6250
  </tag>
6251
- <tag line="2278" name="param" description="option parameters" type="array" variable="$value">
6252
  <type by_reference="false">array</type>
6253
  </tag>
6254
- <tag line="2278" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
6255
  <type by_reference="false">array</type>
6256
  </tag>
6257
- <tag line="2278" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
6258
  <type by_reference="false">string</type>
6259
  </tag>
6260
  </docblock>
6261
- <argument line="2291">
6262
  <name>$action</name>
6263
  <default><![CDATA[]]></default>
6264
  <type/>
6265
  </argument>
6266
- <argument line="2291">
6267
  <name>$key</name>
6268
  <default><![CDATA[]]></default>
6269
  <type/>
6270
  </argument>
6271
- <argument line="2291">
6272
  <name>$value</name>
6273
  <default><![CDATA[]]></default>
6274
  <type/>
6275
  </argument>
6276
- <argument line="2291">
6277
  <name>$args</name>
6278
  <default><![CDATA[null]]></default>
6279
  <type/>
6280
  </argument>
6281
  </method>
6282
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2483" package="Media Library Assistant">
6283
  <name>mla_evaluate_iptc_exif_mapping</name>
6284
  <full_name>mla_evaluate_iptc_exif_mapping</full_name>
6285
- <docblock line="2472">
6286
  <description><![CDATA[Evaluate IPTC/EXIF mapping updates for a post]]></description>
6287
  <long-description><![CDATA[]]></long-description>
6288
- <tag line="2472" name="since" description="1.00"/>
6289
- <tag line="2472" name="param" description="post object with current values" type="object" variable="$post">
6290
  <type by_reference="false">object</type>
6291
  </tag>
6292
- <tag line="2472" name="param" description="category to evaluate against, e.g., iptc_exif_standard_mapping or iptc_exif_mapping" type="string" variable="$category">
6293
  <type by_reference="false">string</type>
6294
  </tag>
6295
- <tag line="2472" name="param" description="(optional) iptc_exif_mapping values, default - current option value" type="array" variable="$settings">
6296
  <type by_reference="false">array</type>
6297
  </tag>
6298
- <tag line="2472" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
6299
  <type by_reference="false">array</type>
6300
  </tag>
6301
  </docblock>
6302
- <argument line="2483">
6303
  <name>$post</name>
6304
  <default><![CDATA[]]></default>
6305
  <type/>
6306
  </argument>
6307
- <argument line="2483">
6308
  <name>$category</name>
6309
  <default><![CDATA[]]></default>
6310
  <type/>
6311
  </argument>
6312
- <argument line="2483">
6313
  <name>$settings</name>
6314
  <default><![CDATA[NULL]]></default>
6315
  <type/>
6316
  </argument>
6317
  </method>
6318
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2693" package="Media Library Assistant">
6319
  <name>_compose_iptc_option_list</name>
6320
  <full_name>_compose_iptc_option_list</full_name>
6321
- <docblock line="2683">
6322
  <description><![CDATA[Compose an IPTC Options list with current selection]]></description>
6323
  <long-description><![CDATA[]]></long-description>
6324
- <tag line="2683" name="since" description="1.00"/>
6325
- <tag line="2683" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6326
- <tag line="2683" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
6327
  <type by_reference="false">string</type>
6328
  </tag>
6329
- <tag line="2683" name="return" description="HTML markup with select field options" type="string">
6330
  <type by_reference="false">string</type>
6331
  </tag>
6332
  </docblock>
6333
- <argument line="2693">
6334
  <name>$selection</name>
6335
  <default><![CDATA['none']]></default>
6336
  <type/>
6337
  </argument>
6338
  </method>
6339
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2726" package="Media Library Assistant">
6340
  <name>_compose_parent_option_list</name>
6341
  <full_name>_compose_parent_option_list</full_name>
6342
- <docblock line="2715">
6343
  <description><![CDATA[Compose an hierarchical taxonomy Parent options list with current selection]]></description>
6344
  <long-description><![CDATA[]]></long-description>
6345
- <tag line="2715" name="since" description="1.00"/>
6346
- <tag line="2715" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6347
- <tag line="2715" name="param" description="taxonomy slug" type="string" variable="$taxonomy">
6348
  <type by_reference="false">string</type>
6349
  </tag>
6350
- <tag line="2715" name="param" description="current selection or 0 (zero, default)" type="integer" variable="$selection">
6351
  <type by_reference="false">integer</type>
6352
  </tag>
6353
- <tag line="2715" name="return" description="HTML markup with select field options" type="string">
6354
  <type by_reference="false">string</type>
6355
  </tag>
6356
  </docblock>
6357
- <argument line="2726">
6358
  <name>$taxonomy</name>
6359
  <default><![CDATA[]]></default>
6360
  <type/>
6361
  </argument>
6362
- <argument line="2726">
6363
  <name>$selection</name>
6364
  <default><![CDATA[0]]></default>
6365
  <type/>
6366
  </argument>
6367
  </method>
6368
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2760" package="Media Library Assistant">
6369
  <name>_update_iptc_exif_standard_mapping</name>
6370
  <full_name>_update_iptc_exif_standard_mapping</full_name>
6371
- <docblock line="2750">
6372
  <description><![CDATA[Update Standard field portion of IPTC/EXIF mappings]]></description>
6373
  <long-description><![CDATA[]]></long-description>
6374
- <tag line="2750" name="since" description="1.00"/>
6375
- <tag line="2750" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
6376
  <type by_reference="false">array</type>
6377
  </tag>
6378
- <tag line="2750" name="param" description="new values" type="array" variable="$new_values">
6379
  <type by_reference="false">array</type>
6380
  </tag>
6381
- <tag line="2750" 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">
6382
  <type by_reference="false">array</type>
6383
  </tag>
6384
  </docblock>
6385
- <argument line="2760">
6386
  <name>$current_values</name>
6387
  <default><![CDATA[]]></default>
6388
  <type/>
6389
  </argument>
6390
- <argument line="2760">
6391
  <name>$new_values</name>
6392
  <default><![CDATA[]]></default>
6393
  <type/>
6394
  </argument>
6395
  </method>
6396
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2839" package="Media Library Assistant">
6397
  <name>_update_iptc_exif_taxonomy_mapping</name>
6398
  <full_name>_update_iptc_exif_taxonomy_mapping</full_name>
6399
- <docblock line="2829">
6400
  <description><![CDATA[Update Taxonomy term portion of IPTC/EXIF mappings]]></description>
6401
  <long-description><![CDATA[]]></long-description>
6402
- <tag line="2829" name="since" description="1.00"/>
6403
- <tag line="2829" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
6404
  <type by_reference="false">array</type>
6405
  </tag>
6406
- <tag line="2829" name="param" description="new values" type="array" variable="$new_values">
6407
  <type by_reference="false">array</type>
6408
  </tag>
6409
- <tag line="2829" 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">
6410
  <type by_reference="false">array</type>
6411
  </tag>
6412
  </docblock>
6413
- <argument line="2839">
6414
  <name>$current_values</name>
6415
  <default><![CDATA[]]></default>
6416
  <type/>
6417
  </argument>
6418
- <argument line="2839">
6419
  <name>$new_values</name>
6420
  <default><![CDATA[]]></default>
6421
  <type/>
6422
  </argument>
6423
  </method>
6424
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2931" package="Media Library Assistant">
6425
  <name>_update_iptc_exif_custom_mapping</name>
6426
  <full_name>_update_iptc_exif_custom_mapping</full_name>
6427
- <docblock line="2921">
6428
  <description><![CDATA[Update Custom field portion of IPTC/EXIF mappings]]></description>
6429
  <long-description><![CDATA[]]></long-description>
6430
- <tag line="2921" name="since" description="1.00"/>
6431
- <tag line="2921" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
6432
  <type by_reference="false">array</type>
6433
  </tag>
6434
- <tag line="2921" name="param" description="new values" type="array" variable="$new_values">
6435
  <type by_reference="false">array</type>
6436
  </tag>
6437
- <tag line="2921" 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">
6438
  <type by_reference="false">array</type>
6439
  </tag>
6440
  </docblock>
6441
- <argument line="2931">
6442
  <name>$current_values</name>
6443
  <default><![CDATA[]]></default>
6444
  <type/>
6445
  </argument>
6446
- <argument line="2931">
6447
  <name>$new_values</name>
6448
  <default><![CDATA[]]></default>
6449
  <type/>
6450
  </argument>
6451
  </method>
6452
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3055" package="Media Library Assistant">
6453
  <name>_get_custom_field_names</name>
6454
  <full_name>_get_custom_field_names</full_name>
6455
- <docblock line="3045">
6456
  <description><![CDATA[Generate a list of all (post) Custom Field names]]></description>
6457
  <long-description><![CDATA[<p>The list will include any Custom Field and IPTC/EXIF rules that
6458
  haven't been mapped to any attachments, yet.</p>]]></long-description>
6459
- <tag line="3045" name="since" description="1.00"/>
6460
- <tag line="3045" name="return" description="Custom field names from the postmeta table and MLA rules" type="array">
6461
  <type by_reference="false">array</type>
6462
  </tag>
6463
  </docblock>
6464
  </method>
6465
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="3099" package="Media Library Assistant">
6466
  <name>mla_iptc_exif_option_handler</name>
6467
  <full_name>mla_iptc_exif_option_handler</full_name>
6468
- <docblock line="3086">
6469
  <description><![CDATA[Render and manage iptc/exif support options]]></description>
6470
  <long-description><![CDATA[]]></long-description>
6471
- <tag line="3086" name="since" description="1.00"/>
6472
- <tag line="3086" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
6473
- <tag line="3086" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
6474
  <type by_reference="false">string</type>
6475
  </tag>
6476
- <tag line="3086" name="param" description="option name, e.g., 'iptc_exif_mapping'" type="string" variable="$key">
6477
  <type by_reference="false">string</type>
6478
  </tag>
6479
- <tag line="3086" name="param" description="option parameters" type="array" variable="$value">
6480
  <type by_reference="false">array</type>
6481
  </tag>
6482
- <tag line="3086" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
6483
  <type by_reference="false">array</type>
6484
  </tag>
6485
- <tag line="3086" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
6486
  <type by_reference="false">string</type>
6487
  </tag>
6488
  </docblock>
6489
- <argument line="3099">
6490
  <name>$action</name>
6491
  <default><![CDATA[]]></default>
6492
  <type/>
6493
  </argument>
6494
- <argument line="3099">
6495
  <name>$key</name>
6496
  <default><![CDATA[]]></default>
6497
  <type/>
6498
  </argument>
6499
- <argument line="3099">
6500
  <name>$value</name>
6501
  <default><![CDATA[]]></default>
6502
  <type/>
6503
  </argument>
6504
- <argument line="3099">
6505
  <name>$args</name>
6506
  <default><![CDATA[null]]></default>
6507
  <type/>
@@ -6509,7 +6658,7 @@ haven't been mapped to any attachments, yet.</p>]]></long-description>
6509
  </method>
6510
  </class>
6511
  </file>
6512
- <file path="includes\class-mla-settings.php" hash="e805ac5cd13b8dd69b925b3d5a475a2c" package="Media Library Assistant">
6513
  <docblock line="2">
6514
  <description><![CDATA[Manages the settings page to edit the plugin option settings]]></description>
6515
  <long-description><![CDATA[]]></long-description>
@@ -6956,488 +7105,488 @@ add settings link in the Plugins section entry for MLA.]]></description>
6956
  </tag>
6957
  </docblock>
6958
  </method>
6959
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="957" package="Media Library Assistant">
6960
  <name>_current_bulk_action</name>
6961
  <full_name>_current_bulk_action</full_name>
6962
- <docblock line="950">
6963
  <description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
6964
  <long-description><![CDATA[]]></long-description>
6965
- <tag line="950" name="since" description="1.40"/>
6966
- <tag line="950" name="return" description="The action name or False if no action was selected" type="string|false">
6967
  <type by_reference="false">string</type>
6968
  <type by_reference="false">false</type>
6969
  </tag>
6970
  </docblock>
6971
  </method>
6972
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="987" package="Media Library Assistant">
6973
  <name>_compose_edit_view_tab</name>
6974
  <full_name>_compose_edit_view_tab</full_name>
6975
- <docblock line="977">
6976
  <description><![CDATA[Compose the Edit View tab content for the Settings subpage]]></description>
6977
  <long-description><![CDATA[]]></long-description>
6978
- <tag line="977" name="since" description="1.40"/>
6979
- <tag line="977" name="param" description="data values for the item" type="array" variable="$view">
6980
  <type by_reference="false">array</type>
6981
  </tag>
6982
- <tag line="977" name="param" description="Display template" type="string" variable="$template">
6983
  <type by_reference="false">string</type>
6984
  </tag>
6985
- <tag line="977" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
6986
  <type by_reference="false">array</type>
6987
  </tag>
6988
  </docblock>
6989
- <argument line="987">
6990
  <name>$view</name>
6991
  <default><![CDATA[]]></default>
6992
  <type/>
6993
  </argument>
6994
- <argument line="987">
6995
  <name>$template</name>
6996
  <default><![CDATA[]]></default>
6997
  <type/>
6998
  </argument>
6999
  </method>
7000
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1020" package="Media Library Assistant">
7001
  <name>_compose_view_tab</name>
7002
  <full_name>_compose_view_tab</full_name>
7003
- <docblock line="1013">
7004
  <description><![CDATA[Compose the Post MIME Type Views tab content for the Settings subpage]]></description>
7005
  <long-description><![CDATA[]]></long-description>
7006
- <tag line="1013" name="since" description="1.40"/>
7007
- <tag line="1013" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7008
  <type by_reference="false">array</type>
7009
  </tag>
7010
  </docblock>
7011
  </method>
7012
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1246" package="Media Library Assistant">
7013
  <name>mla_get_icon_type_dropdown</name>
7014
  <full_name>mla_get_icon_type_dropdown</full_name>
7015
- <docblock line="1235">
7016
  <description><![CDATA[Get an HTML select element representing a list of icon types]]></description>
7017
  <long-description><![CDATA[]]></long-description>
7018
- <tag line="1235" name="since" description="1.40"/>
7019
- <tag line="1235" name="param" description="Display template array" type="array" variable="$templates">
7020
  <type by_reference="false">array</type>
7021
  </tag>
7022
- <tag line="1235" name="param" description="HTML name attribute value" type="string" variable="$name">
7023
  <type by_reference="false">string</type>
7024
  </tag>
7025
- <tag line="1235" name="param" description="currently selected Icon Type" type="string" variable="$selection">
7026
  <type by_reference="false">string</type>
7027
  </tag>
7028
- <tag line="1235" name="return" description="HTML select element or empty string on failure." type="string">
7029
  <type by_reference="false">string</type>
7030
  </tag>
7031
  </docblock>
7032
- <argument line="1246">
7033
  <name>$templates</name>
7034
  <default><![CDATA[]]></default>
7035
  <type/>
7036
  </argument>
7037
- <argument line="1246">
7038
  <name>$name</name>
7039
  <default><![CDATA[]]></default>
7040
  <type/>
7041
  </argument>
7042
- <argument line="1246">
7043
  <name>$selection</name>
7044
  <default><![CDATA['.none.']]></default>
7045
  <type/>
7046
  </argument>
7047
  </method>
7048
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1287" package="Media Library Assistant">
7049
  <name>_compose_edit_upload_tab</name>
7050
  <full_name>_compose_edit_upload_tab</full_name>
7051
- <docblock line="1277">
7052
  <description><![CDATA[Compose the Edit Upload type tab content for the Settings subpage]]></description>
7053
  <long-description><![CDATA[]]></long-description>
7054
- <tag line="1277" name="since" description="1.40"/>
7055
- <tag line="1277" name="param" description="data values for the item" type="array" variable="$item">
7056
  <type by_reference="false">array</type>
7057
  </tag>
7058
- <tag line="1277" name="param" description="Display template array" type="string" variable="$templates">
7059
  <type by_reference="false">string</type>
7060
  </tag>
7061
- <tag line="1277" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7062
  <type by_reference="false">array</type>
7063
  </tag>
7064
  </docblock>
7065
- <argument line="1287">
7066
  <name>$item</name>
7067
  <default><![CDATA[]]></default>
7068
  <type/>
7069
  </argument>
7070
- <argument line="1287">
7071
  <name>$templates</name>
7072
  <default><![CDATA[]]></default>
7073
  <type/>
7074
  </argument>
7075
  </method>
7076
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1322" package="Media Library Assistant">
7077
  <name>_compose_optional_upload_tab</name>
7078
  <full_name>_compose_optional_upload_tab</full_name>
7079
- <docblock line="1313">
7080
  <description><![CDATA[Compose the Optional File Upload MIME Types tab content for the Settings subpage]]></description>
7081
  <long-description><![CDATA[]]></long-description>
7082
- <tag line="1313" name="since" description="1.40"/>
7083
- <tag line="1313" name="param" description="Display templates" type="string" variable="$page_template_array">
7084
  <type by_reference="false">string</type>
7085
  </tag>
7086
- <tag line="1313" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7087
  <type by_reference="false">array</type>
7088
  </tag>
7089
  </docblock>
7090
- <argument line="1322">
7091
  <name>$page_template_array</name>
7092
  <default><![CDATA[]]></default>
7093
  <type/>
7094
  </argument>
7095
  </method>
7096
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1388" package="Media Library Assistant">
7097
  <name>_process_optional_upload_mime</name>
7098
  <full_name>_process_optional_upload_mime</full_name>
7099
- <docblock line="1379">
7100
  <description><![CDATA[Process an Optional Upload MIME Type selection]]></description>
7101
  <long-description><![CDATA[]]></long-description>
7102
- <tag line="1379" name="since" description="1.40"/>
7103
- <tag line="1379" name="param" description="MLA Optional Upload MIME Type ID" type="\intger" variable="$ID">
7104
  <type by_reference="false">\intger</type>
7105
  </tag>
7106
- <tag line="1379" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7107
  <type by_reference="false">array</type>
7108
  </tag>
7109
  </docblock>
7110
- <argument line="1388">
7111
  <name>$ID</name>
7112
  <default><![CDATA[]]></default>
7113
  <type/>
7114
  </argument>
7115
  </method>
7116
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1408" package="Media Library Assistant">
7117
  <name>_compose_upload_tab</name>
7118
  <full_name>_compose_upload_tab</full_name>
7119
- <docblock line="1401">
7120
  <description><![CDATA[Compose the File Upload MIME Types tab content for the Settings subpage]]></description>
7121
  <long-description><![CDATA[]]></long-description>
7122
- <tag line="1401" name="since" description="1.40"/>
7123
- <tag line="1401" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7124
  <type by_reference="false">array</type>
7125
  </tag>
7126
  </docblock>
7127
  </method>
7128
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1663" package="Media Library Assistant">
7129
  <name>_compose_mla_gallery_tab</name>
7130
  <full_name>_compose_mla_gallery_tab</full_name>
7131
- <docblock line="1655">
7132
  <description><![CDATA[Compose the MLA Gallery tab content for the Settings subpage]]></description>
7133
  <long-description><![CDATA[]]></long-description>
7134
- <tag line="1655" name="since" description="0.80"/>
7135
- <tag line="1655" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7136
- <tag line="1655" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7137
  <type by_reference="false">array</type>
7138
  </tag>
7139
  </docblock>
7140
  </method>
7141
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1967" package="Media Library Assistant">
7142
  <name>_compose_custom_field_tab</name>
7143
  <full_name>_compose_custom_field_tab</full_name>
7144
- <docblock line="1959">
7145
  <description><![CDATA[Compose the Custom Field tab content for the Settings subpage]]></description>
7146
  <long-description><![CDATA[]]></long-description>
7147
- <tag line="1959" name="since" description="1.10"/>
7148
- <tag line="1959" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7149
- <tag line="1959" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7150
  <type by_reference="false">array</type>
7151
  </tag>
7152
  </docblock>
7153
  </method>
7154
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2074" package="Media Library Assistant">
7155
  <name>_compose_iptc_exif_tab</name>
7156
  <full_name>_compose_iptc_exif_tab</full_name>
7157
- <docblock line="2066">
7158
  <description><![CDATA[Compose the IPTC/EXIF tab content for the Settings subpage]]></description>
7159
  <long-description><![CDATA[]]></long-description>
7160
- <tag line="2066" name="since" description="1.00"/>
7161
- <tag line="2066" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7162
- <tag line="2066" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7163
  <type by_reference="false">array</type>
7164
  </tag>
7165
  </docblock>
7166
  </method>
7167
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2183" package="Media Library Assistant">
7168
  <name>_compose_documentation_tab</name>
7169
  <full_name>_compose_documentation_tab</full_name>
7170
- <docblock line="2175">
7171
  <description><![CDATA[Compose the Documentation tab content for the Settings subpage]]></description>
7172
  <long-description><![CDATA[]]></long-description>
7173
- <tag line="2175" name="since" description="0.80"/>
7174
- <tag line="2175" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
7175
- <tag line="2175" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
7176
  <type by_reference="false">array</type>
7177
  </tag>
7178
  </docblock>
7179
  </method>
7180
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2202" package="Media Library Assistant">
7181
  <name>mla_render_settings_page</name>
7182
  <full_name>mla_render_settings_page</full_name>
7183
- <docblock line="2195">
7184
  <description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
7185
  <long-description><![CDATA[]]></long-description>
7186
- <tag line="2195" name="since" description="0.1"/>
7187
- <tag line="2195" name="return" description="Echoes HTML markup for the Settings subpage" type="void">
7188
  <type by_reference="false">void</type>
7189
  </tag>
7190
  </docblock>
7191
  </method>
7192
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2261" package="Media Library Assistant">
7193
  <name>_save_gallery_settings</name>
7194
  <full_name>_save_gallery_settings</full_name>
7195
- <docblock line="2252">
7196
  <description><![CDATA[Save MLA Gallery settings to the options table]]></description>
7197
  <long-description><![CDATA[]]></long-description>
7198
- <tag line="2252" name="since" description="0.80"/>
7199
- <tag line="2252" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7200
- <tag line="2252" name="return" description="Message(s) reflecting the results of the operation" type="array">
7201
  <type by_reference="false">array</type>
7202
  </tag>
7203
  </docblock>
7204
  </method>
7205
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2504" package="Media Library Assistant">
7206
  <name>_save_view_settings</name>
7207
  <full_name>_save_view_settings</full_name>
7208
- <docblock line="2495">
7209
  <description><![CDATA[Save View settings to the options table]]></description>
7210
  <long-description><![CDATA[]]></long-description>
7211
- <tag line="2495" name="since" description="1.40"/>
7212
- <tag line="2495" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7213
- <tag line="2495" name="return" description="Message(s) reflecting the results of the operation" type="array">
7214
  <type by_reference="false">array</type>
7215
  </tag>
7216
  </docblock>
7217
  </method>
7218
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2535" package="Media Library Assistant">
7219
  <name>_save_upload_settings</name>
7220
  <full_name>_save_upload_settings</full_name>
7221
- <docblock line="2526">
7222
  <description><![CDATA[Save Upload settings to the options table]]></description>
7223
  <long-description><![CDATA[]]></long-description>
7224
- <tag line="2526" name="since" description="1.40"/>
7225
- <tag line="2526" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7226
- <tag line="2526" name="return" description="Message(s) reflecting the results of the operation" type="array">
7227
  <type by_reference="false">array</type>
7228
  </tag>
7229
  </docblock>
7230
  </method>
7231
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2571" package="Media Library Assistant">
7232
  <name>_process_custom_field_mapping</name>
7233
  <full_name>_process_custom_field_mapping</full_name>
7234
- <docblock line="2560">
7235
  <description><![CDATA[Process custom field settings against all image attachments
7236
  without saving the settings to the mla_option]]></description>
7237
  <long-description><![CDATA[]]></long-description>
7238
- <tag line="2560" name="since" description="1.10"/>
7239
- <tag line="2560" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7240
- <tag line="2560" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$settings">
7241
  <type by_reference="false">array</type>
7242
  </tag>
7243
- <tag line="2560" name="return" description="Message(s) reflecting the results of the operation" type="array">
7244
  <type by_reference="false">array</type>
7245
  </tag>
7246
  </docblock>
7247
- <argument line="2571">
7248
  <name>$settings</name>
7249
  <default><![CDATA[NULL]]></default>
7250
  <type/>
7251
  </argument>
7252
  </method>
7253
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2623" package="Media Library Assistant">
7254
  <name>_delete_custom_field</name>
7255
  <full_name>_delete_custom_field</full_name>
7256
- <docblock line="2614">
7257
  <description><![CDATA[Delete a custom field from the wp_postmeta table]]></description>
7258
  <long-description><![CDATA[]]></long-description>
7259
- <tag line="2614" name="since" description="1.10"/>
7260
- <tag line="2614" name="param" description="specific custom_field_mapping rule" type="array" variable="$value">
7261
  <type by_reference="false">array</type>
7262
  </tag>
7263
- <tag line="2614" name="return" description="Message(s) reflecting the results of the operation" type="array">
7264
  <type by_reference="false">array</type>
7265
  </tag>
7266
  </docblock>
7267
- <argument line="2623">
7268
  <name>$value</name>
7269
  <default><![CDATA[]]></default>
7270
  <type/>
7271
  </argument>
7272
  </method>
7273
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2647" package="Media Library Assistant">
7274
  <name>_save_custom_field_settings</name>
7275
  <full_name>_save_custom_field_settings</full_name>
7276
- <docblock line="2637">
7277
  <description><![CDATA[Save custom field settings to the options table]]></description>
7278
  <long-description><![CDATA[]]></long-description>
7279
- <tag line="2637" name="since" description="1.10"/>
7280
- <tag line="2637" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7281
- <tag line="2637" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$new_values">
7282
  <type by_reference="false">array</type>
7283
  </tag>
7284
- <tag line="2637" name="return" description="Message(s) reflecting the results of the operation" type="array">
7285
  <type by_reference="false">array</type>
7286
  </tag>
7287
  </docblock>
7288
- <argument line="2647">
7289
  <name>$new_values</name>
7290
  <default><![CDATA[NULL]]></default>
7291
  <type/>
7292
  </argument>
7293
  </method>
7294
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2687" package="Media Library Assistant">
7295
  <name>_process_iptc_exif_standard</name>
7296
  <full_name>_process_iptc_exif_standard</full_name>
7297
- <docblock line="2677">
7298
  <description><![CDATA[Process IPTC/EXIF standard field settings against all image attachments
7299
  without saving the settings to the mla_option]]></description>
7300
  <long-description><![CDATA[]]></long-description>
7301
- <tag line="2677" name="since" description="1.00"/>
7302
- <tag line="2677" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7303
- <tag line="2677" name="return" description="Message(s) reflecting the results of the operation" type="array">
7304
  <type by_reference="false">array</type>
7305
  </tag>
7306
  </docblock>
7307
  </method>
7308
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2739" package="Media Library Assistant">
7309
  <name>_process_iptc_exif_taxonomy</name>
7310
  <full_name>_process_iptc_exif_taxonomy</full_name>
7311
- <docblock line="2729">
7312
  <description><![CDATA[Process IPTC/EXIF taxonomy term settings against all image attachments
7313
  without saving the settings to the mla_option]]></description>
7314
  <long-description><![CDATA[]]></long-description>
7315
- <tag line="2729" name="since" description="1.00"/>
7316
- <tag line="2729" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7317
- <tag line="2729" name="return" description="Message(s) reflecting the results of the operation" type="array">
7318
  <type by_reference="false">array</type>
7319
  </tag>
7320
  </docblock>
7321
  </method>
7322
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2794" package="Media Library Assistant">
7323
  <name>_process_iptc_exif_custom</name>
7324
  <full_name>_process_iptc_exif_custom</full_name>
7325
- <docblock line="2782">
7326
  <description><![CDATA[Process IPTC/EXIF custom field settings against all image attachments
7327
  without saving the settings to the mla_option]]></description>
7328
  <long-description><![CDATA[]]></long-description>
7329
- <tag line="2782" name="since" description="1.00"/>
7330
- <tag line="2782" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7331
- <tag line="2782" name="param" description="| NULL specific iptc_exif_custom_mapping values" type="array" variable="$settings">
7332
  <type by_reference="false">array</type>
7333
  </tag>
7334
- <tag line="2782" name="return" description="Message(s) reflecting the results of the operation" type="array">
7335
  <type by_reference="false">array</type>
7336
  </tag>
7337
  </docblock>
7338
- <argument line="2794">
7339
  <name>$settings</name>
7340
  <default><![CDATA[NULL]]></default>
7341
  <type/>
7342
  </argument>
7343
  </method>
7344
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2854" package="Media Library Assistant">
7345
  <name>_save_iptc_exif_custom_settings</name>
7346
  <full_name>_save_iptc_exif_custom_settings</full_name>
7347
- <docblock line="2845">
7348
  <description><![CDATA[Save IPTC/EXIF custom field settings to the options table]]></description>
7349
  <long-description><![CDATA[]]></long-description>
7350
- <tag line="2845" name="since" description="1.30"/>
7351
- <tag line="2845" name="param" description="specific iptc_exif_custom_mapping values" type="array" variable="$new_values">
7352
  <type by_reference="false">array</type>
7353
  </tag>
7354
- <tag line="2845" name="return" description="Message(s) reflecting the results of the operation" type="array">
7355
  <type by_reference="false">array</type>
7356
  </tag>
7357
  </docblock>
7358
- <argument line="2854">
7359
  <name>$new_values</name>
7360
  <default><![CDATA[]]></default>
7361
  <type/>
7362
  </argument>
7363
  </method>
7364
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2870" package="Media Library Assistant">
7365
  <name>_save_iptc_exif_settings</name>
7366
  <full_name>_save_iptc_exif_settings</full_name>
7367
- <docblock line="2861">
7368
  <description><![CDATA[Save IPTC/EXIF settings to the options table]]></description>
7369
  <long-description><![CDATA[]]></long-description>
7370
- <tag line="2861" name="since" description="1.00"/>
7371
- <tag line="2861" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7372
- <tag line="2861" name="return" description="Message(s) reflecting the results of the operation" type="array">
7373
  <type by_reference="false">array</type>
7374
  </tag>
7375
  </docblock>
7376
  </method>
7377
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2907" package="Media Library Assistant">
7378
  <name>_save_general_settings</name>
7379
  <full_name>_save_general_settings</full_name>
7380
- <docblock line="2898">
7381
  <description><![CDATA[Save General settings to the options table]]></description>
7382
  <long-description><![CDATA[]]></long-description>
7383
- <tag line="2898" name="since" description="0.1"/>
7384
- <tag line="2898" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
7385
- <tag line="2898" name="return" description="Message(s) reflecting the results of the operation" type="array">
7386
  <type by_reference="false">array</type>
7387
  </tag>
7388
  </docblock>
7389
  </method>
7390
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2965" package="Media Library Assistant">
7391
  <name>_reset_general_settings</name>
7392
  <full_name>_reset_general_settings</full_name>
7393
- <docblock line="2958">
7394
  <description><![CDATA[Delete saved settings, restoring default values]]></description>
7395
  <long-description><![CDATA[]]></long-description>
7396
- <tag line="2958" name="since" description="0.1"/>
7397
- <tag line="2958" name="return" description="Message(s) reflecting the results of the operation" type="array">
7398
  <type by_reference="false">array</type>
7399
  </tag>
7400
  </docblock>
7401
  </method>
7402
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3005" package="Media Library Assistant">
7403
  <name>_compose_import_settings</name>
7404
  <full_name>_compose_import_settings</full_name>
7405
- <docblock line="2998">
7406
  <description><![CDATA[Compose HTML markup for the import settings if any settings files exist]]></description>
7407
  <long-description><![CDATA[]]></long-description>
7408
- <tag line="2998" name="since" description="1.50"/>
7409
- <tag line="2998" name="return" description="HTML markup for the Import All Settings button and dropdown list, if any" type="string">
7410
  <type by_reference="false">string</type>
7411
  </tag>
7412
  </docblock>
7413
  </method>
7414
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3058" package="Media Library Assistant">
7415
  <name>_export_settings</name>
7416
  <full_name>_export_settings</full_name>
7417
- <docblock line="3049">
7418
  <description><![CDATA[Serialize option settings and write them to a file]]></description>
7419
  <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>
7420
- <tag line="3049" name="since" description="1.50"/>
7421
- <tag line="3049" name="return" description="Message(s) reflecting the results of the operation" type="array">
7422
  <type by_reference="false">array</type>
7423
  </tag>
7424
  </docblock>
7425
  </method>
7426
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="3138" package="Media Library Assistant">
7427
  <name>_import_settings</name>
7428
  <full_name>_import_settings</full_name>
7429
- <docblock line="3131">
7430
  <description><![CDATA[Read a serialized file of option settings and write them to the database]]></description>
7431
  <long-description><![CDATA[]]></long-description>
7432
- <tag line="3131" name="since" description="1.50"/>
7433
- <tag line="3131" 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
  </method>
7438
  </class>
7439
  </file>
7440
- <file path="includes\class-mla-shortcodes.php" hash="a87a2da7638583367c84bb39b5fafbf0" package="Media Library Assistant">
7441
  <docblock line="2">
7442
  <description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
7443
  <long-description><![CDATA[]]></long-description>
@@ -7478,10 +7627,10 @@ without saving the settings to the mla_option]]></description>
7478
  </tag>
7479
  </docblock>
7480
  </property>
7481
- <property final="false" static="true" visibility="private" line="1259" namespace="global" package="Media Library Assistant">
7482
  <name>$query_parameters</name>
7483
  <default><![CDATA[array()]]></default>
7484
- <docblock line="1245">
7485
  <description><![CDATA[WP_Query filter "parameters"]]></description>
7486
  <long-description><![CDATA[<p>This array defines parameters for the query's where and orderby filters,
7487
  mla_shortcode_query_posts_where_filter and mla_shortcode_query_posts_orderby_filter.
@@ -7489,24 +7638,37 @@ The parameters are set up in the mla_get_shortcode_attachments function, and
7489
  any further logic required to translate those values is contained in the filter.</p>
7490
 
7491
  <p>Array index values are: orderby, post_parent</p>]]></long-description>
7492
- <tag line="1245" name="since" description="1.13"/>
7493
- <tag line="1245" name="var" description="" type="array">
7494
  <type by_reference="false">array</type>
7495
  </tag>
7496
  </docblock>
7497
  </property>
7498
- <property final="false" static="true" visibility="private" line="1368" namespace="global" package="Media Library Assistant">
7499
  <name>$data_selection_parameters</name>
7500
- <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_paginate_current' => NULL, 'mla_paginate_total' => NULL, 'meta_key' => '', 'meta_value' => '', 'meta_value_num' => NULL, 'meta_compare' => '', 'meta_query' => '', 's' => '')]]></default>
7501
- <docblock line="1361">
7502
  <description><![CDATA[Data selection parameters for the WP_Query in [mla_gallery]]]></description>
7503
  <long-description><![CDATA[]]></long-description>
7504
- <tag line="1361" name="since" description="1.30"/>
7505
- <tag line="1361" name="var" description="" type="array">
7506
  <type by_reference="false">array</type>
7507
  </tag>
7508
  </docblock>
7509
  </property>
 
 
 
 
 
 
 
 
 
 
 
 
 
7510
  <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="23" package="Media Library Assistant">
7511
  <name>initialize</name>
7512
  <full_name>initialize</full_name>
@@ -7553,305 +7715,305 @@ Enhancements include many additional selection parameters and full taxonomy supp
7553
  <type/>
7554
  </argument>
7555
  </method>
7556
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="936" package="Media Library Assistant">
7557
  <name>_process_shortcode_parameter</name>
7558
  <full_name>_process_shortcode_parameter</full_name>
7559
- <docblock line="926">
7560
  <description><![CDATA[Handles brace/bracket escaping and parses template for a shortcode parameter]]></description>
7561
  <long-description><![CDATA[]]></long-description>
7562
- <tag line="926" name="since" description="1.14"/>
7563
- <tag line="926" name="param" description="raw shortcode parameter, e.g., &quot;text {+field+} {brackets} \\{braces\\}&quot;" type="string" variable="$text">
7564
  <type by_reference="false">string</type>
7565
  </tag>
7566
- <tag line="926" name="param" description="template substitution values, e.g., ('instance' =&gt; '1', ... )" type="string" variable="$markup_values">
7567
  <type by_reference="false">string</type>
7568
  </tag>
7569
- <tag line="926" name="return" description="query specification with HTML escape sequences and line breaks removed" type="string">
7570
  <type by_reference="false">string</type>
7571
  </tag>
7572
  </docblock>
7573
- <argument line="936">
7574
  <name>$text</name>
7575
  <default><![CDATA[]]></default>
7576
  <type/>
7577
  </argument>
7578
- <argument line="936">
7579
  <name>$markup_values</name>
7580
  <default><![CDATA[]]></default>
7581
  <type/>
7582
  </argument>
7583
  </method>
7584
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="955" package="Media Library Assistant">
7585
  <name>_paginate_links</name>
7586
  <full_name>_paginate_links</full_name>
7587
- <docblock line="942">
7588
  <description><![CDATA[Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links']]></description>
7589
  <long-description><![CDATA[]]></long-description>
7590
- <tag line="942" name="since" description="1.42"/>
7591
- <tag line="942" name="param" description="value(s) for mla_output_type parameter" type="array" variable="$output_parameters">
7592
  <type by_reference="false">array</type>
7593
  </tag>
7594
- <tag line="942" name="param" description="template substitution values, e.g., ('instance' =&gt; '1', ... )" type="string" variable="$markup_values">
7595
  <type by_reference="false">string</type>
7596
  </tag>
7597
- <tag line="942" name="param" description="merged default and passed shortcode parameter values" type="string" variable="$arguments">
7598
  <type by_reference="false">string</type>
7599
  </tag>
7600
- <tag line="942" name="param" description="number of attachments in the gallery, without pagination" type="integer" variable="$found_rows">
7601
  <type by_reference="false">integer</type>
7602
  </tag>
7603
- <tag line="942" name="param" description="output text so far, may include debug values" type="string" variable="$output">
7604
  <type by_reference="false">string</type>
7605
  </tag>
7606
- <tag line="942" name="return" description="false or string with HTML for pagination output types" type="mixed">
7607
  <type by_reference="false">mixed</type>
7608
  </tag>
7609
  </docblock>
7610
- <argument line="955">
7611
  <name>$output_parameters</name>
7612
  <default><![CDATA[]]></default>
7613
  <type/>
7614
  </argument>
7615
- <argument line="955">
7616
  <name>$markup_values</name>
7617
  <default><![CDATA[]]></default>
7618
  <type/>
7619
  </argument>
7620
- <argument line="955">
7621
  <name>$arguments</name>
7622
  <default><![CDATA[]]></default>
7623
  <type/>
7624
  </argument>
7625
- <argument line="955">
7626
  <name>$found_rows</name>
7627
  <default><![CDATA[]]></default>
7628
  <type/>
7629
  </argument>
7630
- <argument line="955">
7631
  <name>$output</name>
7632
  <default><![CDATA['']]></default>
7633
  <type/>
7634
  </argument>
7635
  </method>
7636
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1083" package="Media Library Assistant">
7637
  <name>_process_pagination_output_types</name>
7638
  <full_name>_process_pagination_output_types</full_name>
7639
- <docblock line="1069">
7640
  <description><![CDATA[Handles pagnation output types 'previous_page', 'next_page', and 'paginate_links']]></description>
7641
  <long-description><![CDATA[]]></long-description>
7642
- <tag line="1069" name="since" description="1.42"/>
7643
- <tag line="1069" name="param" description="value(s) for mla_output_type parameter" type="array" variable="$output_parameters">
7644
  <type by_reference="false">array</type>
7645
  </tag>
7646
- <tag line="1069" name="param" description="template substitution values, e.g., ('instance' =&gt; '1', ... )" type="string" variable="$markup_values">
7647
  <type by_reference="false">string</type>
7648
  </tag>
7649
- <tag line="1069" name="param" description="merged default and passed shortcode parameter values" type="string" variable="$arguments">
7650
  <type by_reference="false">string</type>
7651
  </tag>
7652
- <tag line="1069" name="param" description="raw passed shortcode parameter values" type="string" variable="$attr">
7653
  <type by_reference="false">string</type>
7654
  </tag>
7655
- <tag line="1069" name="param" description="number of attachments in the gallery, without pagination" type="integer" variable="$found_rows">
7656
  <type by_reference="false">integer</type>
7657
  </tag>
7658
- <tag line="1069" name="param" description="output text so far, may include debug values" type="string" variable="$output">
7659
  <type by_reference="false">string</type>
7660
  </tag>
7661
- <tag line="1069" name="return" description="false or string with HTML for pagination output types" type="mixed">
7662
  <type by_reference="false">mixed</type>
7663
  </tag>
7664
  </docblock>
7665
- <argument line="1083">
7666
  <name>$output_parameters</name>
7667
  <default><![CDATA[]]></default>
7668
  <type/>
7669
  </argument>
7670
- <argument line="1083">
7671
  <name>$markup_values</name>
7672
  <default><![CDATA[]]></default>
7673
  <type/>
7674
  </argument>
7675
- <argument line="1083">
7676
  <name>$arguments</name>
7677
  <default><![CDATA[]]></default>
7678
  <type/>
7679
  </argument>
7680
- <argument line="1083">
7681
  <name>$attr</name>
7682
  <default><![CDATA[]]></default>
7683
  <type/>
7684
  </argument>
7685
- <argument line="1083">
7686
  <name>$found_rows</name>
7687
  <default><![CDATA[]]></default>
7688
  <type/>
7689
  </argument>
7690
- <argument line="1083">
7691
  <name>$output</name>
7692
  <default><![CDATA['']]></default>
7693
  <type/>
7694
  </argument>
7695
  </method>
7696
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1270" package="Media Library Assistant">
7697
  <name>_sanitize_query_specification</name>
7698
  <full_name>_sanitize_query_specification</full_name>
7699
- <docblock line="1261">
7700
  <description><![CDATA[Cleans up damage caused by the Visual Editor to the tax_query and meta_query specifications]]></description>
7701
  <long-description><![CDATA[]]></long-description>
7702
- <tag line="1261" name="since" description="1.14"/>
7703
- <tag line="1261" name="param" description="query specification; PHP nested arrays" type="string" variable="$specification">
7704
  <type by_reference="false">string</type>
7705
  </tag>
7706
- <tag line="1261" name="return" description="query specification with HTML escape sequences and line breaks removed" type="string">
7707
  <type by_reference="false">string</type>
7708
  </tag>
7709
  </docblock>
7710
- <argument line="1270">
7711
  <name>$specification</name>
7712
  <default><![CDATA[]]></default>
7713
  <type/>
7714
  </argument>
7715
  </method>
7716
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1287" package="Media Library Assistant">
7717
  <name>_validate_sql_orderby</name>
7718
  <full_name>_validate_sql_orderby</full_name>
7719
- <docblock line="1276">
7720
  <description><![CDATA[Translates query parameters to a valid SQL order by clause.]]></description>
7721
  <long-description><![CDATA[<p>Accepts one or more valid columns, with or without ASC/DESC.
7722
  Enhanced version of /wp-includes/formatting.php function sanitize_sql_orderby().</p>]]></long-description>
7723
- <tag line="1276" name="since" description="1.20"/>
7724
- <tag line="1276" name="param" description="Validated query parameters" type="array" variable="$query_parameters">
7725
  <type by_reference="false">array</type>
7726
  </tag>
7727
- <tag line="1276" name="return" description="Returns the orderby clause if present, false otherwise." type="string|bool">
7728
  <type by_reference="false">string</type>
7729
  <type by_reference="false">bool</type>
7730
  </tag>
7731
  </docblock>
7732
- <argument line="1287">
7733
  <name>$query_parameters</name>
7734
  <default><![CDATA[]]></default>
7735
  <type/>
7736
  </argument>
7737
  </method>
7738
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1435" package="Media Library Assistant">
7739
  <name>mla_get_shortcode_attachments</name>
7740
  <full_name>mla_get_shortcode_attachments</full_name>
7741
- <docblock line="1424">
7742
  <description><![CDATA[Parses shortcode parameters and returns the gallery objects]]></description>
7743
  <long-description><![CDATA[]]></long-description>
7744
- <tag line="1424" name="since" description=".50"/>
7745
- <tag line="1424" name="param" description="Post ID of the parent" type="int" variable="$post_parent">
7746
  <type by_reference="false">int</type>
7747
  </tag>
7748
- <tag line="1424" name="param" description="Attributes of the shortcode" type="array" variable="$attr">
7749
  <type by_reference="false">array</type>
7750
  </tag>
7751
- <tag line="1424" name="param" description="true to calculate and return ['found_posts'] as an array element" type="boolean" variable="$return_found_rows">
7752
  <type by_reference="false">boolean</type>
7753
  </tag>
7754
- <tag line="1424" name="return" description="List of attachments returned from WP_Query" type="array">
7755
  <type by_reference="false">array</type>
7756
  </tag>
7757
  </docblock>
7758
- <argument line="1435">
7759
  <name>$post_parent</name>
7760
  <default><![CDATA[]]></default>
7761
  <type/>
7762
  </argument>
7763
- <argument line="1435">
7764
  <name>$attr</name>
7765
  <default><![CDATA[]]></default>
7766
  <type/>
7767
  </argument>
7768
- <argument line="1435">
7769
  <name>$return_found_rows</name>
7770
- <default><![CDATA[false]]></default>
7771
  <type/>
7772
  </argument>
7773
  </method>
7774
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1824" package="Media Library Assistant">
7775
  <name>mla_shortcode_query_posts_where_filter</name>
7776
  <full_name>mla_shortcode_query_posts_where_filter</full_name>
7777
- <docblock line="1810">
7778
  <description><![CDATA[Filters the WHERE clause for shortcode queries]]></description>
7779
  <long-description><![CDATA[<p>Captures debug information. Adds whitespace to the post_type = 'attachment'
7780
  phrase to circumvent subsequent Role Scoper modification of the clause.
7781
  Handles post_parent "any" and "none" cases.
7782
  Defined as public because it's a filter.</p>]]></long-description>
7783
- <tag line="1810" name="since" description="0.70"/>
7784
- <tag line="1810" name="param" description="query clause before modification" type="string" variable="$where_clause">
7785
  <type by_reference="false">string</type>
7786
  </tag>
7787
- <tag line="1810" name="return" description="query clause after modification" type="string">
7788
  <type by_reference="false">string</type>
7789
  </tag>
7790
  </docblock>
7791
- <argument line="1824">
7792
  <name>$where_clause</name>
7793
  <default><![CDATA[]]></default>
7794
  <type/>
7795
  </argument>
7796
  </method>
7797
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1865" package="Media Library Assistant">
7798
  <name>mla_shortcode_query_posts_orderby_filter</name>
7799
  <full_name>mla_shortcode_query_posts_orderby_filter</full_name>
7800
- <docblock line="1853">
7801
  <description><![CDATA[Filters the ORDERBY clause for shortcode queries]]></description>
7802
  <long-description><![CDATA[<p>This is an enhanced version of the code found in wp-includes/query.php, function get_posts.
7803
  Defined as public because it's a filter.</p>]]></long-description>
7804
- <tag line="1853" name="since" description="1.20"/>
7805
- <tag line="1853" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
7806
  <type by_reference="false">string</type>
7807
  </tag>
7808
- <tag line="1853" name="return" description="query clause after modification" type="string">
7809
  <type by_reference="false">string</type>
7810
  </tag>
7811
  </docblock>
7812
- <argument line="1865">
7813
  <name>$orderby_clause</name>
7814
  <default><![CDATA[]]></default>
7815
  <type/>
7816
  </argument>
7817
  </method>
7818
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1890" package="Media Library Assistant">
7819
  <name>mla_shortcode_query_posts_clauses_filter</name>
7820
  <full_name>mla_shortcode_query_posts_clauses_filter</full_name>
7821
- <docblock line="1878">
7822
  <description><![CDATA[Filters all clauses for shortcode queries, pre caching plugins]]></description>
7823
  <long-description><![CDATA[<p>This is for debug purposes only.
7824
  Defined as public because it's a filter.</p>]]></long-description>
7825
- <tag line="1878" name="since" description="1.30"/>
7826
- <tag line="1878" name="param" description="query clauses before modification" type="array" variable="$pieces">
7827
  <type by_reference="false">array</type>
7828
  </tag>
7829
- <tag line="1878" name="return" description="query clauses after modification (none)" type="array">
7830
  <type by_reference="false">array</type>
7831
  </tag>
7832
  </docblock>
7833
- <argument line="1890">
7834
  <name>$pieces</name>
7835
  <default><![CDATA[]]></default>
7836
  <type/>
7837
  </argument>
7838
  </method>
7839
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1908" package="Media Library Assistant">
7840
  <name>mla_shortcode_query_posts_clauses_request_filter</name>
7841
  <full_name>mla_shortcode_query_posts_clauses_request_filter</full_name>
7842
- <docblock line="1896">
7843
  <description><![CDATA[Filters all clauses for shortcode queries, post caching plugins]]></description>
7844
  <long-description><![CDATA[<p>This is for debug purposes only.
7845
  Defined as public because it's a filter.</p>]]></long-description>
7846
- <tag line="1896" name="since" description="1.30"/>
7847
- <tag line="1896" name="param" description="query clauses before modification" type="array" variable="$pieces">
7848
  <type by_reference="false">array</type>
7849
  </tag>
7850
- <tag line="1896" name="return" description="query clauses after modification (none)" type="array">
7851
  <type by_reference="false">array</type>
7852
  </tag>
7853
  </docblock>
7854
- <argument line="1908">
7855
  <name>$pieces</name>
7856
  <default><![CDATA[]]></default>
7857
  <type/>
@@ -9508,13 +9670,13 @@ This file is only loaded if the naming conflict tests in index.php are passed.</
9508
  </docblock>
9509
  </function>
9510
  </file>
9511
- <file path="index.php" hash="6149065d6dfab8fc7dbc9215bcb3d9d5" package="Media Library Assistant">
9512
  <docblock line="2">
9513
  <description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
9514
  <long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
9515
  will the rest of the plugin be loaded and run.</p>]]></long-description>
9516
  <tag line="2" name="package" description="Media Library Assistant"/>
9517
- <tag line="2" name="version" description="1.50"/>
9518
  </docblock>
9519
  <include line="134" type="Require Once" package="Media Library Assistant">
9520
  <name>includes/mla-plugin-loader.php</name>
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
  </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
  ['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>
244
  <description><![CDATA[Find a complete template, balancing opening and closing delimiters]]></description>
245
  <long-description><![CDATA[]]></long-description>
246
  <tag line="150" name="since" description="1.50"/>
247
+ <tag line="150" name="param" description="A string possibly starting with '[+template:'" type="string" variable="$tpl">
248
  <type by_reference="false">string</type>
249
  </tag>
250
  <tag line="150" name="return" description="'' or template string starting with '[+template:' and ending with the matching '+]'" type="string">
285
  <type/>
286
  </argument>
287
  </method>
288
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="293" package="Media Library Assistant">
289
  <name>mla_parse_template</name>
290
  <full_name>mla_parse_template</full_name>
291
+ <docblock line="281">
292
  <description><![CDATA[Expand a template, replacing placeholders with their values]]></description>
293
  <long-description><![CDATA[<p>A simple parsing function for basic templating.</p>]]></long-description>
294
+ <tag line="281" name="since" description="0.1"/>
295
+ <tag line="281" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
296
  <type by_reference="false">string</type>
297
  </tag>
298
+ <tag line="281" name="param" description="An associative array containing keys and values e.g. array('key' =&gt; 'value')" type="array" variable="$markup_values">
299
  <type by_reference="false">array</type>
300
  </tag>
301
+ <tag line="281" name="return" description="Placeholders corresponding to the keys of the markup_values will be replaced with their values." type="\strng">
302
  <type by_reference="false">\strng</type>
303
  </tag>
304
  </docblock>
305
+ <argument line="293">
306
  <name>$tpl</name>
307
  <default><![CDATA[]]></default>
308
  <type/>
309
  </argument>
310
+ <argument line="293">
311
  <name>$markup_values</name>
312
  <default><![CDATA[]]></default>
313
  <type/>
314
  </argument>
315
  </method>
316
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="344" package="Media Library Assistant">
317
  <name>_find_test_substring</name>
318
  <full_name>_find_test_substring</full_name>
319
+ <docblock line="335">
320
  <description><![CDATA[Find a complete (test) element, balancing opening and closing delimiters]]></description>
321
  <long-description><![CDATA[]]></long-description>
322
+ <tag line="335" name="since" description="1.50"/>
323
+ <tag line="335" name="param" description="A string possibly starting with '('" type="string" variable="$tpl">
324
  <type by_reference="false">string</type>
325
  </tag>
326
+ <tag line="335" name="return" description="'' or template string starting with '(' and ending with the matching ')'" type="string">
327
  <type by_reference="false">string</type>
328
  </tag>
329
  </docblock>
330
+ <argument line="344">
331
  <name>$tpl</name>
332
  <default><![CDATA[]]></default>
333
  <type/>
334
  </argument>
335
  </method>
336
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="387" package="Media Library Assistant">
337
  <name>_parse_field_level_template</name>
338
  <full_name>_parse_field_level_template</full_name>
339
+ <docblock line="378">
340
  <description><![CDATA[Convert field-level "template:" string into its component parts]]></description>
341
  <long-description><![CDATA[]]></long-description>
342
+ <tag line="378" name="since" description="1.50"/>
343
+ <tag line="378" name="param" description="Template content with string, test and choice elements" type="string" variable="$tpl">
344
  <type by_reference="false">string</type>
345
  </tag>
346
+ <tag line="378" name="return" description="( node =&gt; array( type =&gt; &quot;string | test | choice | template&quot;, length =&gt; bytes, value =&gt; string | node(s) ) )" type="array">
347
  <type by_reference="false">array</type>
348
  </tag>
349
  </docblock>
350
+ <argument line="387">
351
  <name>$tpl</name>
352
  <default><![CDATA[]]></default>
353
  <type/>
354
  </argument>
355
  </method>
356
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="531" package="Media Library Assistant">
357
  <name>_evaluate_template_array_node</name>
358
  <full_name>_evaluate_template_array_node</full_name>
359
+ <docblock line="519">
360
  <description><![CDATA[Analyze a field-level "template:" element, expanding Field-level Markup Substitution Parameters]]></description>
361
  <long-description><![CDATA[<p>Will return an array of values if one or more of the placeholders returns an array.</p>]]></long-description>
362
+ <tag line="519" name="since" description="1.50"/>
363
+ <tag line="519" name="param" description="A field-level template element node" type="array" variable="$node">
364
  <type by_reference="false">array</type>
365
  </tag>
366
+ <tag line="519" name="param" description="An array of markup substitution values" type="array" variable="$markup_values">
367
  <type by_reference="false">array</type>
368
  </tag>
369
+ <tag line="519" name="return" description="string or array, depending on placeholder values. Placeholders corresponding to the keys of the markup_values will be replaced with their values." type="mixed">
370
  <type by_reference="false">mixed</type>
371
  </tag>
372
  </docblock>
373
+ <argument line="531">
374
  <name>$node</name>
375
  <default><![CDATA[]]></default>
376
  <type/>
377
  </argument>
378
+ <argument line="531">
379
  <name>$markup_values</name>
380
  <default><![CDATA[array()]]></default>
381
  <type/>
382
  </argument>
383
  </method>
384
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="615" package="Media Library Assistant">
385
  <name>_evaluate_template_node</name>
386
  <full_name>_evaluate_template_node</full_name>
387
+ <docblock line="605">
388
  <description><![CDATA[Analyze a field-level "template:" element, expanding Field-level Markup Substitution Parameters]]></description>
389
  <long-description><![CDATA[]]></long-description>
390
+ <tag line="605" name="since" description="1.50"/>
391
+ <tag line="605" name="param" description="A field-level template element node" type="array" variable="$node">
392
  <type by_reference="false">array</type>
393
  </tag>
394
+ <tag line="605" name="param" description="An array of markup substitution values" type="array" variable="$markup_values">
395
  <type by_reference="false">array</type>
396
  </tag>
397
+ <tag line="605" name="return" description="String with expanded values, if any" type="string">
398
  <type by_reference="false">string</type>
399
  </tag>
400
  </docblock>
401
+ <argument line="615">
402
  <name>$node</name>
403
  <default><![CDATA[]]></default>
404
  <type/>
405
  </argument>
406
+ <argument line="615">
407
  <name>$markup_values</name>
408
  <default><![CDATA[array()]]></default>
409
  <type/>
410
  </argument>
411
  </method>
412
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="677" package="Media Library Assistant">
413
  <name>_expand_field_level_template</name>
414
  <full_name>_expand_field_level_template</full_name>
415
+ <docblock line="666">
416
  <description><![CDATA[Analyze a field-level "template:" element, expanding Field-level Markup Substitution Parameters]]></description>
417
  <long-description><![CDATA[]]></long-description>
418
+ <tag line="666" name="since" description="1.50"/>
419
+ <tag line="666" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
420
  <type by_reference="false">string</type>
421
  </tag>
422
+ <tag line="666" name="param" description="An array of markup substitution values" type="array" variable="$markup_values">
423
  <type by_reference="false">array</type>
424
  </tag>
425
+ <tag line="666" name="param" description="True to return array value(s), false to return a string" type="boolean" variable="$return_arrays">
426
  <type by_reference="false">boolean</type>
427
  </tag>
428
+ <tag line="666" name="return" description="Element with expanded string/array values, if any" type="mixed">
429
  <type by_reference="false">mixed</type>
430
  </tag>
431
  </docblock>
432
+ <argument line="677">
433
  <name>$tpl</name>
434
  <default><![CDATA[]]></default>
435
  <type/>
436
  </argument>
437
+ <argument line="677">
438
  <name>$markup_values</name>
439
  <default><![CDATA[array()]]></default>
440
  <type/>
441
  </argument>
442
+ <argument line="677">
443
  <name>$return_arrays</name>
444
  <default><![CDATA[false]]></default>
445
  <type/>
446
  </argument>
447
  </method>
448
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="719" package="Media Library Assistant">
449
  <name>_process_field_level_array</name>
450
  <full_name>_process_field_level_array</full_name>
451
+ <docblock line="708">
452
  <description><![CDATA[Process an markup field array value according to the supplied data-format option]]></description>
453
  <long-description><![CDATA[]]></long-description>
454
+ <tag line="708" name="since" description="1.50"/>
455
+ <tag line="708" name="param" description="an array of scalar values" type="array" variable="$record">
456
  <type by_reference="false">array</type>
457
  </tag>
458
+ <tag line="708" name="param" description="data option 'text'|'single'|'export'|'array'|'multi'" type="string" variable="$option">
459
  <type by_reference="false">string</type>
460
  </tag>
461
+ <tag line="708" name="param" description="Optional: for option 'multi', retain existing values" type="boolean" variable="$keep_existing">
462
  <type by_reference="false">boolean</type>
463
  </tag>
464
+ <tag line="708" name="return" description="( parameter =&gt; value ) for all field-level parameters and anything in $markup_values" type="array">
465
  <type by_reference="false">array</type>
466
  </tag>
467
  </docblock>
468
+ <argument line="719">
469
  <name>$record</name>
470
  <default><![CDATA[]]></default>
471
  <type/>
472
  </argument>
473
+ <argument line="719">
474
  <name>$option</name>
475
  <default><![CDATA['text']]></default>
476
  <type/>
477
  </argument>
478
+ <argument line="719">
479
  <name>$keep_existing</name>
480
  <default><![CDATA[false]]></default>
481
  <type/>
482
  </argument>
483
  </method>
484
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="763" package="Media Library Assistant">
485
  <name>mla_expand_field_level_parameters</name>
486
  <full_name>mla_expand_field_level_parameters</full_name>
487
+ <docblock line="745">
488
  <description><![CDATA[Analyze a template, expanding Field-level Markup Substitution Parameters]]></description>
489
  <long-description><![CDATA[<p>Field-level parameters must have one of the following prefix values:
490
  template, request, query, custom, terms, meta, iptc, exif, pdf.
491
  All but request and query require an attachment ID.</p>]]></long-description>
492
+ <tag line="745" name="since" description="1.50"/>
493
+ <tag line="745" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
494
  <type by_reference="false">string</type>
495
  </tag>
496
+ <tag line="745" name="param" description="Optional: an array of values from the query, if any, e.g. shortcode parameters" type="array" variable="$query">
497
  <type by_reference="false">array</type>
498
  </tag>
499
+ <tag line="745" name="param" description="Optional: an array of values to add to the returned array" type="array" variable="$markup_values">
500
  <type by_reference="false">array</type>
501
  </tag>
502
+ <tag line="745" name="param" description="Optional: attachment ID for attachment-specific placeholders" type="integer" variable="$post_id">
503
  <type by_reference="false">integer</type>
504
  </tag>
505
+ <tag line="745" name="param" description="Optional: for option 'multi', retain existing values" type="boolean" variable="$keep_existing">
506
  <type by_reference="false">boolean</type>
507
  </tag>
508
+ <tag line="745" name="param" description="Optional: default option value" type="string" variable="$default_option">
509
  <type by_reference="false">string</type>
510
  </tag>
511
+ <tag line="745" name="return" description="( parameter =&gt; value ) for all field-level parameters and anything in $markup_values" type="array">
512
  <type by_reference="false">array</type>
513
  </tag>
514
  </docblock>
515
+ <argument line="763">
516
  <name>$tpl</name>
517
  <default><![CDATA[]]></default>
518
  <type/>
519
  </argument>
520
+ <argument line="763">
521
  <name>$query</name>
522
  <default><![CDATA[NULL]]></default>
523
  <type/>
524
  </argument>
525
+ <argument line="763">
526
  <name>$markup_values</name>
527
  <default><![CDATA[array()]]></default>
528
  <type/>
529
  </argument>
530
+ <argument line="763">
531
  <name>$post_id</name>
532
  <default><![CDATA[0]]></default>
533
  <type/>
534
  </argument>
535
+ <argument line="763">
536
  <name>$keep_existing</name>
537
  <default><![CDATA[false]]></default>
538
  <type/>
539
  </argument>
540
+ <argument line="763">
541
  <name>$default_option</name>
542
  <default><![CDATA['text']]></default>
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
  </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">
1878
  <docblock line="2">
1879
  <description><![CDATA[Media Library Assistant Edit Media screen enhancements]]></description>
1880
  <long-description><![CDATA[]]></long-description>
1891
  <tag line="9" name="package" description="Media Library Assistant"/>
1892
  <tag line="9" name="since" description="0.80"/>
1893
  </docblock>
1894
+ <property final="false" static="true" visibility="private" line="227" namespace="global" package="Media Library Assistant">
1895
  <name>$mla_references</name>
1896
  <default><![CDATA[null]]></default>
1897
+ <docblock line="217">
1898
  <description><![CDATA[Where-used values for the current item]]></description>
1899
  <long-description><![CDATA[<p>This array contains the Featured/Inserted/Gallery/MLA Gallery references for the item.
1900
  The array is built once each page load and cached for subsequent calls.</p>]]></long-description>
1901
+ <tag line="217" name="since" description="0.80"/>
1902
+ <tag line="217" name="var" description="" type="array">
1903
  <type by_reference="false">array</type>
1904
  </tag>
1905
  </docblock>
1917
  </docblock>
1918
  </method>
1919
  <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="55" package="Media Library Assistant">
1920
+ <name>mla_admin_init_action</name>
1921
+ <full_name>mla_admin_init_action</full_name>
1922
  <docblock line="47">
1923
  <description><![CDATA[Adds Custom Field support to the Edit Media screen.]]></description>
1924
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
1928
  </tag>
1929
  </docblock>
1930
  </method>
1931
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="93" package="Media Library Assistant">
1932
  <name>mla_post_updated_messages_filter</name>
1933
  <full_name>mla_post_updated_messages_filter</full_name>
1934
+ <docblock line="83">
1935
  <description><![CDATA[Adds mapping update messages for display at the top of the Edit Media screen.]]></description>
1936
  <long-description><![CDATA[<p>Declared public because it is a filter.</p>]]></long-description>
1937
+ <tag line="83" name="since" description="1.10"/>
1938
+ <tag line="83" name="param" description="messages for the Edit screen" type="array" variable="$messages">
1939
  <type by_reference="false">array</type>
1940
  </tag>
1941
+ <tag line="83" name="return" description="updated messages" type="array">
1942
  <type by_reference="false">array</type>
1943
  </tag>
1944
  </docblock>
1945
+ <argument line="93">
1946
  <name>$messages</name>
1947
  <default><![CDATA[]]></default>
1948
  <type/>
1949
  </argument>
1950
  </method>
1951
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="110" package="Media Library Assistant">
1952
  <name>mla_attachment_submitbox_action</name>
1953
  <full_name>mla_attachment_submitbox_action</full_name>
1954
+ <docblock line="102">
1955
  <description><![CDATA[Adds Last Modified date to the Submit box on the Edit Media screen.]]></description>
1956
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
1957
+ <tag line="102" name="since" description="0.80"/>
1958
+ <tag line="102" name="return" description="echoes the HTML markup for the label and value" type="void">
1959
  <type by_reference="false">void</type>
1960
  </tag>
1961
  </docblock>
1962
  </method>
1963
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="143" package="Media Library Assistant">
1964
  <name>mla_add_meta_boxes_action</name>
1965
  <full_name>mla_add_meta_boxes_action</full_name>
1966
+ <docblock line="132">
1967
  <description><![CDATA[Registers meta boxes for the Edit Media screen.]]></description>
1968
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
1969
+ <tag line="132" name="since" description="0.80"/>
1970
+ <tag line="132" name="param" description="type of the current post, e.g., 'attachment' (optional, default 'unknown')" type="string" variable="$post_type">
1971
  <type by_reference="false">string</type>
1972
  </tag>
1973
+ <tag line="132" name="param" description="current post (optional, default (object) array ( 'ID' =&gt; 0 ))" type="object" variable="$post">
1974
  <type by_reference="false">object</type>
1975
  </tag>
1976
+ <tag line="132" name="return" description="" type="void">
1977
  <type by_reference="false">void</type>
1978
  </tag>
1979
  </docblock>
1980
+ <argument line="143">
1981
  <name>$post_type</name>
1982
  <default><![CDATA['unknown']]></default>
1983
  <type/>
1984
  </argument>
1985
+ <argument line="143">
1986
  <name>$post</name>
1987
  <default><![CDATA[NULL]]></default>
1988
  <type/>
1989
  </argument>
1990
  </method>
1991
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="179" package="Media Library Assistant">
1992
  <name>mla_edit_add_help_tab</name>
1993
  <full_name>mla_edit_add_help_tab</full_name>
1994
+ <docblock line="169">
1995
  <description><![CDATA[Add contextual help tabs to the WordPress Edit Media page]]></description>
1996
  <long-description><![CDATA[]]></long-description>
1997
+ <tag line="169" name="since" description="0.90"/>
1998
+ <tag line="169" name="param" description="title as shown on the screen" type="string" variable="$admin_title">
1999
  <type by_reference="false">string</type>
2000
  </tag>
2001
+ <tag line="169" name="param" description="title as shown in the HTML header" type="string" variable="$title">
2002
  <type by_reference="false">string</type>
2003
  </tag>
2004
+ <tag line="169" name="return" description="" type="void">
2005
  <type by_reference="false">void</type>
2006
  </tag>
2007
  </docblock>
2008
+ <argument line="179">
2009
  <name>$admin_title</name>
2010
  <default><![CDATA[]]></default>
2011
  <type/>
2012
  </argument>
2013
+ <argument line="179">
2014
  <name>$title</name>
2015
  <default><![CDATA[]]></default>
2016
  <type/>
2017
  </argument>
2018
  </method>
2019
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="239" package="Media Library Assistant">
2020
  <name>mla_parent_info_handler</name>
2021
  <full_name>mla_parent_info_handler</full_name>
2022
+ <docblock line="229">
2023
  <description><![CDATA[Renders the Parent Info meta box on the Edit Media page.]]></description>
2024
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
2025
+ <tag line="229" name="since" description="0.80"/>
2026
+ <tag line="229" name="param" description="current post" type="object" variable="$post">
2027
  <type by_reference="false">object</type>
2028
  </tag>
2029
+ <tag line="229" name="return" description="echoes the HTML markup for the meta box content" type="void">
2030
  <type by_reference="false">void</type>
2031
  </tag>
2032
  </docblock>
2033
+ <argument line="239">
2034
  <name>$post</name>
2035
  <default><![CDATA[]]></default>
2036
  <type/>
2037
  </argument>
2038
  </method>
2039
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="264" package="Media Library Assistant">
2040
  <name>mla_menu_order_handler</name>
2041
  <full_name>mla_menu_order_handler</full_name>
2042
+ <docblock line="254">
2043
  <description><![CDATA[Renders the Menu Order meta box on the Edit Media page.]]></description>
2044
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
2045
+ <tag line="254" name="since" description="0.80"/>
2046
+ <tag line="254" name="param" description="current post" type="object" variable="$post">
2047
  <type by_reference="false">object</type>
2048
  </tag>
2049
+ <tag line="254" name="return" description="echoes the HTML markup for the meta box content" type="void">
2050
  <type by_reference="false">void</type>
2051
  </tag>
2052
  </docblock>
2053
+ <argument line="264">
2054
  <name>$post</name>
2055
  <default><![CDATA[]]></default>
2056
  <type/>
2057
  </argument>
2058
  </method>
2059
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="279" package="Media Library Assistant">
2060
  <name>mla_image_metadata_handler</name>
2061
  <full_name>mla_image_metadata_handler</full_name>
2062
+ <docblock line="269">
2063
  <description><![CDATA[Renders the Image Metadata meta box on the Edit Media page.]]></description>
2064
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
2065
+ <tag line="269" name="since" description="0.80"/>
2066
+ <tag line="269" name="param" description="current post" type="object" variable="$post">
2067
  <type by_reference="false">object</type>
2068
  </tag>
2069
+ <tag line="269" name="return" description="echoes the HTML markup for the meta box content" type="void">
2070
  <type by_reference="false">void</type>
2071
  </tag>
2072
  </docblock>
2073
+ <argument line="279">
2074
  <name>$post</name>
2075
  <default><![CDATA[]]></default>
2076
  <type/>
2077
  </argument>
2078
  </method>
2079
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="300" package="Media Library Assistant">
2080
  <name>mla_featured_in_handler</name>
2081
  <full_name>mla_featured_in_handler</full_name>
2082
+ <docblock line="290">
2083
  <description><![CDATA[Renders the Featured in meta box on the Edit Media page.]]></description>
2084
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
2085
+ <tag line="290" name="since" description="0.80"/>
2086
+ <tag line="290" name="param" description="current post" type="object" variable="$post">
2087
  <type by_reference="false">object</type>
2088
  </tag>
2089
+ <tag line="290" name="return" description="echoes the HTML markup for the meta box content" type="void">
2090
  <type by_reference="false">void</type>
2091
  </tag>
2092
  </docblock>
2093
+ <argument line="300">
2094
  <name>$post</name>
2095
  <default><![CDATA[]]></default>
2096
  <type/>
2097
  </argument>
2098
  </method>
2099
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="330" package="Media Library Assistant">
2100
  <name>mla_inserted_in_handler</name>
2101
  <full_name>mla_inserted_in_handler</full_name>
2102
+ <docblock line="320">
2103
  <description><![CDATA[Renders the Inserted in meta box on the Edit Media page.]]></description>
2104
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
2105
+ <tag line="320" name="since" description="0.80"/>
2106
+ <tag line="320" name="param" description="current post" type="object" variable="$post">
2107
  <type by_reference="false">object</type>
2108
  </tag>
2109
+ <tag line="320" name="return" description="echoes the HTML markup for the meta box content" type="void">
2110
  <type by_reference="false">void</type>
2111
  </tag>
2112
  </docblock>
2113
+ <argument line="330">
2114
  <name>$post</name>
2115
  <default><![CDATA[]]></default>
2116
  <type/>
2117
  </argument>
2118
  </method>
2119
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="364" package="Media Library Assistant">
2120
  <name>mla_gallery_in_handler</name>
2121
  <full_name>mla_gallery_in_handler</full_name>
2122
+ <docblock line="354">
2123
  <description><![CDATA[Renders the Gallery in meta box on the Edit Media page.]]></description>
2124
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
2125
+ <tag line="354" name="since" description="0.80"/>
2126
+ <tag line="354" name="param" description="current post" type="object" variable="$post">
2127
  <type by_reference="false">object</type>
2128
  </tag>
2129
+ <tag line="354" name="return" description="echoes the HTML markup for the meta box content" type="void">
2130
  <type by_reference="false">void</type>
2131
  </tag>
2132
  </docblock>
2133
+ <argument line="364">
2134
  <name>$post</name>
2135
  <default><![CDATA[]]></default>
2136
  <type/>
2137
  </argument>
2138
  </method>
2139
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="394" package="Media Library Assistant">
2140
  <name>mla_mla_gallery_in_handler</name>
2141
  <full_name>mla_mla_gallery_in_handler</full_name>
2142
+ <docblock line="384">
2143
  <description><![CDATA[Renders the Gallery in meta box on the Edit Media page.]]></description>
2144
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
2145
+ <tag line="384" name="since" description="0.80"/>
2146
+ <tag line="384" name="param" description="current post" type="object" variable="$post">
2147
  <type by_reference="false">object</type>
2148
  </tag>
2149
+ <tag line="384" name="return" description="echoes the HTML markup for the meta box content" type="void">
2150
  <type by_reference="false">void</type>
2151
  </tag>
2152
  </docblock>
2153
+ <argument line="394">
2154
  <name>$post</name>
2155
  <default><![CDATA[]]></default>
2156
  <type/>
2157
  </argument>
2158
  </method>
2159
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="424" package="Media Library Assistant">
2160
  <name>mla_edit_attachment_action</name>
2161
  <full_name>mla_edit_attachment_action</full_name>
2162
+ <docblock line="414">
2163
  <description><![CDATA[Saves updates from the Edit Media screen.]]></description>
2164
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
2165
+ <tag line="414" name="since" description="0.80"/>
2166
+ <tag line="414" name="param" description="ID of the current post" type="integer" variable="$post_ID">
2167
  <type by_reference="false">integer</type>
2168
  </tag>
2169
+ <tag line="414" name="return" description="" type="void">
2170
  <type by_reference="false">void</type>
2171
  </tag>
2172
  </docblock>
2173
+ <argument line="424">
2174
  <name>$post_ID</name>
2175
  <default><![CDATA[]]></default>
2176
  <type/>
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>
2546
  <type/>
2547
  </argument>
2548
  </method>
2549
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="607" package="Media Library Assistant">
2550
  <name>column_ID_parent</name>
2551
  <full_name>column_ID_parent</full_name>
2552
+ <docblock line="599">
2553
  <description><![CDATA[Supply the content for a custom column]]></description>
2554
  <long-description><![CDATA[]]></long-description>
2555
+ <tag line="599" name="since" description="0.1"/>
2556
+ <tag line="599" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2557
  <type by_reference="false">array</type>
2558
  </tag>
2559
+ <tag line="599" name="return" description="HTML markup to be placed inside the column" type="string">
2560
  <type by_reference="false">string</type>
2561
  </tag>
2562
  </docblock>
2563
+ <argument line="607">
2564
  <name>$item</name>
2565
  <default><![CDATA[]]></default>
2566
  <type/>
2567
  </argument>
2568
  </method>
2569
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="639" package="Media Library Assistant">
2570
  <name>column_title_name</name>
2571
  <full_name>column_title_name</full_name>
2572
+ <docblock line="631">
2573
  <description><![CDATA[Supply the content for a custom column]]></description>
2574
  <long-description><![CDATA[]]></long-description>
2575
+ <tag line="631" name="since" description="0.1"/>
2576
+ <tag line="631" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2577
  <type by_reference="false">array</type>
2578
  </tag>
2579
+ <tag line="631" name="return" description="HTML markup to be placed inside the column" type="string">
2580
  <type by_reference="false">string</type>
2581
  </tag>
2582
  </docblock>
2583
+ <argument line="639">
2584
  <name>$item</name>
2585
  <default><![CDATA[]]></default>
2586
  <type/>
2587
  </argument>
2588
  </method>
2589
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="662" package="Media Library Assistant">
2590
  <name>column_post_title</name>
2591
  <full_name>column_post_title</full_name>
2592
+ <docblock line="654">
2593
  <description><![CDATA[Supply the content for a custom column]]></description>
2594
  <long-description><![CDATA[]]></long-description>
2595
+ <tag line="654" name="since" description="0.1"/>
2596
+ <tag line="654" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2597
  <type by_reference="false">array</type>
2598
  </tag>
2599
+ <tag line="654" name="return" description="HTML markup to be placed inside the column" type="string">
2600
  <type by_reference="false">string</type>
2601
  </tag>
2602
  </docblock>
2603
+ <argument line="662">
2604
  <name>$item</name>
2605
  <default><![CDATA[]]></default>
2606
  <type/>
2607
  </argument>
2608
  </method>
2609
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="680" package="Media Library Assistant">
2610
  <name>column_post_name</name>
2611
  <full_name>column_post_name</full_name>
2612
+ <docblock line="672">
2613
  <description><![CDATA[Supply the content for a custom column]]></description>
2614
  <long-description><![CDATA[]]></long-description>
2615
+ <tag line="672" name="since" description="0.1"/>
2616
+ <tag line="672" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2617
  <type by_reference="false">array</type>
2618
  </tag>
2619
+ <tag line="672" name="return" description="HTML markup to be placed inside the column" type="string">
2620
  <type by_reference="false">string</type>
2621
  </tag>
2622
  </docblock>
2623
+ <argument line="680">
2624
  <name>$item</name>
2625
  <default><![CDATA[]]></default>
2626
  <type/>
2627
  </argument>
2628
  </method>
2629
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="698" package="Media Library Assistant">
2630
  <name>column_parent</name>
2631
  <full_name>column_parent</full_name>
2632
+ <docblock line="690">
2633
  <description><![CDATA[Supply the content for a custom column]]></description>
2634
  <long-description><![CDATA[]]></long-description>
2635
+ <tag line="690" name="since" description="0.1"/>
2636
+ <tag line="690" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2637
  <type by_reference="false">array</type>
2638
  </tag>
2639
+ <tag line="690" name="return" description="HTML markup to be placed inside the column" type="string">
2640
  <type by_reference="false">string</type>
2641
  </tag>
2642
  </docblock>
2643
+ <argument line="698">
2644
  <name>$item</name>
2645
  <default><![CDATA[]]></default>
2646
  <type/>
2647
  </argument>
2648
  </method>
2649
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="723" package="Media Library Assistant">
2650
  <name>column_menu_order</name>
2651
  <full_name>column_menu_order</full_name>
2652
+ <docblock line="715">
2653
  <description><![CDATA[Supply the content for a custom column]]></description>
2654
  <long-description><![CDATA[]]></long-description>
2655
+ <tag line="715" name="since" description="0.60"/>
2656
+ <tag line="715" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2657
  <type by_reference="false">array</type>
2658
  </tag>
2659
+ <tag line="715" name="return" description="HTML markup to be placed inside the column" type="string">
2660
  <type by_reference="false">string</type>
2661
  </tag>
2662
  </docblock>
2663
+ <argument line="723">
2664
  <name>$item</name>
2665
  <default><![CDATA[]]></default>
2666
  <type/>
2667
  </argument>
2668
  </method>
2669
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="735" package="Media Library Assistant">
2670
  <name>column_featured</name>
2671
  <full_name>column_featured</full_name>
2672
+ <docblock line="727">
2673
  <description><![CDATA[Supply the content for a custom column]]></description>
2674
  <long-description><![CDATA[]]></long-description>
2675
+ <tag line="727" name="since" description="0.1"/>
2676
+ <tag line="727" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2677
  <type by_reference="false">array</type>
2678
  </tag>
2679
+ <tag line="727" name="return" description="HTML markup to be placed inside the column" type="string">
2680
  <type by_reference="false">string</type>
2681
  </tag>
2682
  </docblock>
2683
+ <argument line="735">
2684
  <name>$item</name>
2685
  <default><![CDATA[]]></default>
2686
  <type/>
2687
  </argument>
2688
  </method>
2689
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="767" package="Media Library Assistant">
2690
  <name>column_inserted</name>
2691
  <full_name>column_inserted</full_name>
2692
+ <docblock line="759">
2693
  <description><![CDATA[Supply the content for a custom column]]></description>
2694
  <long-description><![CDATA[]]></long-description>
2695
+ <tag line="759" name="since" description="0.1"/>
2696
+ <tag line="759" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2697
  <type by_reference="false">array</type>
2698
  </tag>
2699
+ <tag line="759" name="return" description="HTML markup to be placed inside the column" type="string">
2700
  <type by_reference="false">string</type>
2701
  </tag>
2702
  </docblock>
2703
+ <argument line="767">
2704
  <name>$item</name>
2705
  <default><![CDATA[]]></default>
2706
  <type/>
2707
  </argument>
2708
  </method>
2709
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="803" package="Media Library Assistant">
2710
  <name>column_galleries</name>
2711
  <full_name>column_galleries</full_name>
2712
+ <docblock line="795">
2713
  <description><![CDATA[Supply the content for a custom column]]></description>
2714
  <long-description><![CDATA[]]></long-description>
2715
+ <tag line="795" name="since" description="0.70"/>
2716
+ <tag line="795" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2717
  <type by_reference="false">array</type>
2718
  </tag>
2719
+ <tag line="795" name="return" description="HTML markup to be placed inside the column" type="string">
2720
  <type by_reference="false">string</type>
2721
  </tag>
2722
  </docblock>
2723
+ <argument line="803">
2724
  <name>$item</name>
2725
  <default><![CDATA[]]></default>
2726
  <type/>
2727
  </argument>
2728
  </method>
2729
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="835" package="Media Library Assistant">
2730
  <name>column_mla_galleries</name>
2731
  <full_name>column_mla_galleries</full_name>
2732
+ <docblock line="827">
2733
  <description><![CDATA[Supply the content for a custom column]]></description>
2734
  <long-description><![CDATA[]]></long-description>
2735
+ <tag line="827" name="since" description="0.70"/>
2736
+ <tag line="827" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2737
  <type by_reference="false">array</type>
2738
  </tag>
2739
+ <tag line="827" name="return" description="HTML markup to be placed inside the column" type="string">
2740
  <type by_reference="false">string</type>
2741
  </tag>
2742
  </docblock>
2743
+ <argument line="835">
2744
  <name>$item</name>
2745
  <default><![CDATA[]]></default>
2746
  <type/>
2747
  </argument>
2748
  </method>
2749
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="867" package="Media Library Assistant">
2750
  <name>column_alt_text</name>
2751
  <full_name>column_alt_text</full_name>
2752
+ <docblock line="859">
2753
  <description><![CDATA[Supply the content for a custom column]]></description>
2754
  <long-description><![CDATA[]]></long-description>
2755
+ <tag line="859" name="since" description="0.1"/>
2756
+ <tag line="859" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2757
  <type by_reference="false">array</type>
2758
  </tag>
2759
+ <tag line="859" name="return" description="HTML markup to be placed inside the column" type="string">
2760
  <type by_reference="false">string</type>
2761
  </tag>
2762
  </docblock>
2763
+ <argument line="867">
2764
  <name>$item</name>
2765
  <default><![CDATA[]]></default>
2766
  <type/>
2767
  </argument>
2768
  </method>
2769
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="887" package="Media Library Assistant">
2770
  <name>column_caption</name>
2771
  <full_name>column_caption</full_name>
2772
+ <docblock line="879">
2773
  <description><![CDATA[Supply the content for a custom column]]></description>
2774
  <long-description><![CDATA[]]></long-description>
2775
+ <tag line="879" name="since" description="0.1"/>
2776
+ <tag line="879" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2777
  <type by_reference="false">array</type>
2778
  </tag>
2779
+ <tag line="879" name="return" description="HTML markup to be placed inside the column" type="string">
2780
  <type by_reference="false">string</type>
2781
  </tag>
2782
  </docblock>
2783
+ <argument line="887">
2784
  <name>$item</name>
2785
  <default><![CDATA[]]></default>
2786
  <type/>
2787
  </argument>
2788
  </method>
2789
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="899" package="Media Library Assistant">
2790
  <name>column_description</name>
2791
  <full_name>column_description</full_name>
2792
+ <docblock line="891">
2793
  <description><![CDATA[Supply the content for a custom column]]></description>
2794
  <long-description><![CDATA[]]></long-description>
2795
+ <tag line="891" name="since" description="0.1"/>
2796
+ <tag line="891" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2797
  <type by_reference="false">array</type>
2798
  </tag>
2799
+ <tag line="891" name="return" description="HTML markup to be placed inside the column" type="string">
2800
  <type by_reference="false">string</type>
2801
  </tag>
2802
  </docblock>
2803
+ <argument line="899">
2804
  <name>$item</name>
2805
  <default><![CDATA[]]></default>
2806
  <type/>
2807
  </argument>
2808
  </method>
2809
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="911" package="Media Library Assistant">
2810
  <name>column_post_mime_type</name>
2811
  <full_name>column_post_mime_type</full_name>
2812
+ <docblock line="903">
2813
  <description><![CDATA[Supply the content for a custom column]]></description>
2814
  <long-description><![CDATA[]]></long-description>
2815
+ <tag line="903" name="since" description="0.30"/>
2816
+ <tag line="903" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2817
  <type by_reference="false">array</type>
2818
  </tag>
2819
+ <tag line="903" name="return" description="HTML markup to be placed inside the column" type="string">
2820
  <type by_reference="false">string</type>
2821
  </tag>
2822
  </docblock>
2823
+ <argument line="911">
2824
  <name>$item</name>
2825
  <default><![CDATA[]]></default>
2826
  <type/>
2827
  </argument>
2828
  </method>
2829
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="927" package="Media Library Assistant">
2830
  <name>column_file_url</name>
2831
  <full_name>column_file_url</full_name>
2832
+ <docblock line="919">
2833
  <description><![CDATA[Supply the content for a custom column]]></description>
2834
  <long-description><![CDATA[]]></long-description>
2835
+ <tag line="919" name="since" description="0.1"/>
2836
+ <tag line="919" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2837
  <type by_reference="false">array</type>
2838
  </tag>
2839
+ <tag line="919" name="return" description="HTML markup to be placed inside the column" type="string">
2840
  <type by_reference="false">string</type>
2841
  </tag>
2842
  </docblock>
2843
+ <argument line="927">
2844
  <name>$item</name>
2845
  <default><![CDATA[]]></default>
2846
  <type/>
2847
  </argument>
2848
  </method>
2849
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="941" package="Media Library Assistant">
2850
  <name>column_base_file</name>
2851
  <full_name>column_base_file</full_name>
2852
+ <docblock line="933">
2853
  <description><![CDATA[Supply the content for a custom column]]></description>
2854
  <long-description><![CDATA[]]></long-description>
2855
+ <tag line="933" name="since" description="0.1"/>
2856
+ <tag line="933" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2857
  <type by_reference="false">array</type>
2858
  </tag>
2859
+ <tag line="933" name="return" description="HTML markup to be placed inside the column" type="string">
2860
  <type by_reference="false">string</type>
2861
  </tag>
2862
  </docblock>
2863
+ <argument line="941">
2864
  <name>$item</name>
2865
  <default><![CDATA[]]></default>
2866
  <type/>
2867
  </argument>
2868
  </method>
2869
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="953" package="Media Library Assistant">
2870
  <name>column_date</name>
2871
  <full_name>column_date</full_name>
2872
+ <docblock line="945">
2873
  <description><![CDATA[Supply the content for a custom column]]></description>
2874
  <long-description><![CDATA[]]></long-description>
2875
+ <tag line="945" name="since" description="0.1"/>
2876
+ <tag line="945" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2877
  <type by_reference="false">array</type>
2878
  </tag>
2879
+ <tag line="945" name="return" description="HTML markup to be placed inside the column" type="string">
2880
  <type by_reference="false">string</type>
2881
  </tag>
2882
  </docblock>
2883
+ <argument line="953">
2884
  <name>$item</name>
2885
  <default><![CDATA[]]></default>
2886
  <type/>
2887
  </argument>
2888
  </method>
2889
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="982" package="Media Library Assistant">
2890
  <name>column_modified</name>
2891
  <full_name>column_modified</full_name>
2892
+ <docblock line="974">
2893
  <description><![CDATA[Supply the content for a custom column]]></description>
2894
  <long-description><![CDATA[]]></long-description>
2895
+ <tag line="974" name="since" description="0.30"/>
2896
+ <tag line="974" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2897
  <type by_reference="false">array</type>
2898
  </tag>
2899
+ <tag line="974" name="return" description="HTML markup to be placed inside the column" type="string">
2900
  <type by_reference="false">string</type>
2901
  </tag>
2902
  </docblock>
2903
+ <argument line="982">
2904
  <name>$item</name>
2905
  <default><![CDATA[]]></default>
2906
  <type/>
2907
  </argument>
2908
  </method>
2909
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1011" package="Media Library Assistant">
2910
  <name>column_author</name>
2911
  <full_name>column_author</full_name>
2912
+ <docblock line="1003">
2913
  <description><![CDATA[Supply the content for a custom column]]></description>
2914
  <long-description><![CDATA[]]></long-description>
2915
+ <tag line="1003" name="since" description="0.30"/>
2916
+ <tag line="1003" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2917
  <type by_reference="false">array</type>
2918
  </tag>
2919
+ <tag line="1003" name="return" description="HTML markup to be placed inside the column" type="string">
2920
  <type by_reference="false">string</type>
2921
  </tag>
2922
  </docblock>
2923
+ <argument line="1011">
2924
  <name>$item</name>
2925
  <default><![CDATA[]]></default>
2926
  <type/>
2927
  </argument>
2928
  </method>
2929
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1032" package="Media Library Assistant">
2930
  <name>column_attached_to</name>
2931
  <full_name>column_attached_to</full_name>
2932
+ <docblock line="1024">
2933
  <description><![CDATA[Supply the content for a custom column]]></description>
2934
  <long-description><![CDATA[]]></long-description>
2935
+ <tag line="1024" name="since" description="0.1"/>
2936
+ <tag line="1024" name="param" description="A singular attachment (post) object" type="array" variable="$item">
2937
  <type by_reference="false">array</type>
2938
  </tag>
2939
+ <tag line="1024" name="return" description="HTML markup to be placed inside the column" type="string">
2940
  <type by_reference="false">string</type>
2941
  </tag>
2942
  </docblock>
2943
+ <argument line="1032">
2944
  <name>$item</name>
2945
  <default><![CDATA[]]></default>
2946
  <type/>
2947
  </argument>
2948
  </method>
2949
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1063" package="Media Library Assistant">
2950
  <name>mla_submenu_arguments</name>
2951
  <full_name>mla_submenu_arguments</full_name>
2952
+ <docblock line="1054">
2953
  <description><![CDATA[Process $_REQUEST, building $submenu_arguments]]></description>
2954
  <long-description><![CDATA[]]></long-description>
2955
+ <tag line="1054" name="since" description="1.42"/>
2956
+ <tag line="1054" name="param" description="Optional: Include the &quot;click filter&quot; values in the results" type="boolean" variable="$include_filters">
2957
  <type by_reference="false">boolean</type>
2958
  </tag>
2959
+ <tag line="1054" name="return" description="non-empty view, search, filter and sort arguments" type="array">
2960
  <type by_reference="false">array</type>
2961
  </tag>
2962
  </docblock>
2963
+ <argument line="1063">
2964
  <name>$include_filters</name>
2965
  <default><![CDATA[true]]></default>
2966
  <type/>
2967
  </argument>
2968
  </method>
2969
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1152" package="Media Library Assistant">
2970
  <name>pagination</name>
2971
  <full_name>pagination</full_name>
2972
+ <docblock line="1144">
2973
  <description><![CDATA[Display the pagination, adding view, search and filter arguments]]></description>
2974
  <long-description><![CDATA[]]></long-description>
2975
+ <tag line="1144" name="since" description="1.42"/>
2976
+ <tag line="1144" name="param" description="'top' | 'bottom'" type="string" variable="$which">
2977
  <type by_reference="false">string</type>
2978
  </tag>
2979
+ <tag line="1144" name="return" description="" type="void">
2980
  <type by_reference="false">void</type>
2981
  </tag>
2982
  </docblock>
2983
+ <argument line="1152">
2984
  <name>$which</name>
2985
  <default><![CDATA[]]></default>
2986
  <type/>
2987
  </argument>
2988
  </method>
2989
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1166" package="Media Library Assistant">
2990
  <name>get_columns</name>
2991
  <full_name>get_columns</full_name>
2992
+ <docblock line="1159">
2993
  <description><![CDATA[This method dictates the table's columns and titles]]></description>
2994
  <long-description><![CDATA[]]></long-description>
2995
+ <tag line="1159" name="since" description="0.1"/>
2996
+ <tag line="1159" name="return" description="Column information: 'slugs'=&gt;'Visible Titles'" type="array">
2997
  <type by_reference="false">array</type>
2998
  </tag>
2999
  </docblock>
3000
  </method>
3001
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1178" package="Media Library Assistant">
3002
  <name>get_hidden_columns</name>
3003
  <full_name>get_hidden_columns</full_name>
3004
+ <docblock line="1170">
3005
  <description><![CDATA[Returns the list of currently hidden columns from a user option or
3006
  from default values if the option is not set]]></description>
3007
  <long-description><![CDATA[]]></long-description>
3008
+ <tag line="1170" name="since" description="0.1"/>
3009
+ <tag line="1170" name="return" description="Column information,e.g., array(0 =&gt; 'ID_parent, 1 =&gt; 'title_name')" type="array">
3010
  <type by_reference="false">array</type>
3011
  </tag>
3012
  </docblock>
3013
  </method>
3014
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1198" package="Media Library Assistant">
3015
  <name>get_sortable_columns</name>
3016
  <full_name>get_sortable_columns</full_name>
3017
+ <docblock line="1188">
3018
  <description><![CDATA[Returns an array where the key is the column that needs to be sortable
3019
  and the value is db column to sort by.]]></description>
3020
  <long-description><![CDATA[<p>Also notes the current sort column,
3021
  if set.</p>]]></long-description>
3022
+ <tag line="1188" name="since" description="0.1"/>
3023
+ <tag line="1188" name="return" description="Sortable column information,e.g., 'slugs'=&gt;array('data_values',boolean)" type="array">
3024
  <type by_reference="false">array</type>
3025
  </tag>
3026
  </docblock>
3027
  </method>
3028
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1224" package="Media Library Assistant">
3029
  <name>print_column_headers</name>
3030
  <full_name>print_column_headers</full_name>
3031
+ <docblock line="1217">
3032
  <description><![CDATA[Print column headers, adding view, search and filter arguments]]></description>
3033
  <long-description><![CDATA[]]></long-description>
3034
+ <tag line="1217" name="since" description="1.42"/>
3035
+ <tag line="1217" name="param" description="Whether to set the id attribute or not" type="bool" variable="$with_id">
3036
  <type by_reference="false">bool</type>
3037
  </tag>
3038
  </docblock>
3039
+ <argument line="1224">
3040
  <name>$with_id</name>
3041
  <default><![CDATA[true]]></default>
3042
  <type/>
3043
  </argument>
3044
  </method>
3045
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1241" package="Media Library Assistant">
3046
  <name>_get_view</name>
3047
  <full_name>_get_view</full_name>
3048
+ <docblock line="1231">
3049
  <description><![CDATA[Returns HTML markup for one view that can be used with this table]]></description>
3050
  <long-description><![CDATA[]]></long-description>
3051
+ <tag line="1231" name="since" description="1.40"/>
3052
+ <tag line="1231" name="param" description="View slug, key to MLA_POST_MIME_TYPES array" type="string" variable="$view_slug">
3053
  <type by_reference="false">string</type>
3054
  </tag>
3055
+ <tag line="1231" name="param" description="Slug for current view" type="string" variable="$current_view">
3056
  <type by_reference="false">string</type>
3057
  </tag>
3058
+ <tag line="1231" name="return" description="| false HTML for link to display the view, false if count = zero" type="string">
3059
  <type by_reference="false">string</type>
3060
  </tag>
3061
  </docblock>
3062
+ <argument line="1241">
3063
  <name>$view_slug</name>
3064
  <default><![CDATA[]]></default>
3065
  <type/>
3066
  </argument>
3067
+ <argument line="1241">
3068
  <name>$current_view</name>
3069
  <default><![CDATA[]]></default>
3070
  <type/>
3071
  </argument>
3072
  </method>
3073
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1351" package="Media Library Assistant">
3074
  <name>get_views</name>
3075
  <full_name>get_views</full_name>
3076
+ <docblock line="1343">
3077
  <description><![CDATA[Returns an associative array listing all the views that can be used with this table.]]></description>
3078
  <long-description><![CDATA[<p>These are listed across the top of the page and managed by WordPress.</p>]]></long-description>
3079
+ <tag line="1343" name="since" description="0.1"/>
3080
+ <tag line="1343" name="return" description="View information,e.g., array ( id =&gt; link )" type="array">
3081
  <type by_reference="false">array</type>
3082
  </tag>
3083
  </docblock>
3084
  </method>
3085
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1399" package="Media Library Assistant">
3086
  <name>get_bulk_actions</name>
3087
  <full_name>get_bulk_actions</full_name>
3088
+ <docblock line="1391">
3089
  <description><![CDATA[Get an associative array ( option_name => option_title ) with the list
3090
  of bulk actions available on this table.]]></description>
3091
  <long-description><![CDATA[]]></long-description>
3092
+ <tag line="1391" name="since" description="0.1"/>
3093
+ <tag line="1391" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
3094
  <type by_reference="false">array</type>
3095
  </tag>
3096
  </docblock>
3097
  </method>
3098
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1430" package="Media Library Assistant">
3099
  <name>extra_tablenav</name>
3100
  <full_name>extra_tablenav</full_name>
3101
+ <docblock line="1419">
3102
  <description><![CDATA[Extra controls to be displayed between bulk actions and pagination]]></description>
3103
  <long-description><![CDATA[<p>Modeled after class-wp-posts-list-table.php in wp-admin/includes.</p>]]></long-description>
3104
+ <tag line="1419" name="since" description="0.1"/>
3105
+ <tag line="1419" name="param" description="'top' or 'bottom', i.e., above or below the table rows" type="string" variable="$which">
3106
  <type by_reference="false">string</type>
3107
  </tag>
3108
+ <tag line="1419" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
3109
  <type by_reference="false">array</type>
3110
  </tag>
3111
  </docblock>
3112
+ <argument line="1430">
3113
  <name>$which</name>
3114
  <default><![CDATA[]]></default>
3115
  <type/>
3116
  </argument>
3117
  </method>
3118
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1467" package="Media Library Assistant">
3119
  <name>prepare_items</name>
3120
  <full_name>prepare_items</full_name>
3121
+ <docblock line="1455">
3122
  <description><![CDATA[Prepares the list of items for displaying]]></description>
3123
  <long-description><![CDATA[<p>This is where you prepare your data for display. This method will usually
3124
  be used to query the database, sort and filter the data, and generally
3125
  get it ready to be displayed. At a minimum, we should set $this->items and
3126
  $this->set_pagination_args().</p>]]></long-description>
3127
+ <tag line="1455" name="since" description="0.1"/>
3128
+ <tag line="1455" name="return" description="" type="void">
3129
  <type by_reference="false">void</type>
3130
  </tag>
3131
  </docblock>
3132
  </method>
3133
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1514" package="Media Library Assistant">
3134
  <name>single_row</name>
3135
  <full_name>single_row</full_name>
3136
+ <docblock line="1505">
3137
  <description><![CDATA[Generates (echoes) content for a single row of the table]]></description>
3138
  <long-description><![CDATA[]]></long-description>
3139
+ <tag line="1505" name="since" description=".20"/>
3140
+ <tag line="1505" name="param" description="the current item" type="object" variable="$item">
3141
  <type by_reference="false">object</type>
3142
  </tag>
3143
+ <tag line="1505" name="return" description="Echoes the row HTML" type="void">
3144
  <type by_reference="false">void</type>
3145
  </tag>
3146
  </docblock>
3147
+ <argument line="1514">
3148
  <name>$item</name>
3149
  <default><![CDATA[]]></default>
3150
  <type/>
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
  <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>
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>
3911
  <type/>
3912
  </argument>
3913
  </method>
3914
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="225" package="Media Library Assistant">
3915
  <name>mla_media_view_strings_filter</name>
3916
  <full_name>mla_media_view_strings_filter</full_name>
3917
+ <docblock line="214">
3918
  <description><![CDATA[Adds strings values to be passed to the Media Manager in /wp-includes/js/media-views.js.]]></description>
3919
  <long-description><![CDATA[<p>Declared public because it is a filter.</p>]]></long-description>
3920
+ <tag line="214" name="since" description="1.20"/>
3921
+ <tag line="214" name="param" description="associative array with string =&gt; value pairs" type="array" variable="$strings">
3922
  <type by_reference="false">array</type>
3923
  </tag>
3924
+ <tag line="214" name="param" description="|| NULL current post object, if available" type="object" variable="$post">
3925
  <type by_reference="false">object</type>
3926
  </tag>
3927
+ <tag line="214" name="return" description="updated $strings array" type="array">
3928
  <type by_reference="false">array</type>
3929
  </tag>
3930
  </docblock>
3931
+ <argument line="225">
3932
  <name>$strings</name>
3933
  <default><![CDATA[]]></default>
3934
  <type/>
3935
  </argument>
3936
+ <argument line="225">
3937
  <name>$post</name>
3938
  <default><![CDATA[]]></default>
3939
  <type/>
3940
  </argument>
3941
  </method>
3942
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="242" package="Media Library Assistant">
3943
  <name>mla_wp_enqueue_media_action</name>
3944
  <full_name>mla_wp_enqueue_media_action</full_name>
3945
+ <docblock line="234">
3946
  <description><![CDATA[Enqueues the mla-media-modal-scripts.js file, adding it to the Media Manager scripts.]]></description>
3947
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
3948
+ <tag line="234" name="since" description="1.20"/>
3949
+ <tag line="234" name="return" description="" type="void">
3950
  <type by_reference="false">void</type>
3951
  </tag>
3952
  </docblock>
3953
  </method>
3954
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="260" package="Media Library Assistant">
3955
  <name>mla_print_media_templates_action</name>
3956
  <full_name>mla_print_media_templates_action</full_name>
3957
+ <docblock line="252">
3958
  <description><![CDATA[Prints the templates used in the MLA Media Manager enhancements.]]></description>
3959
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
3960
+ <tag line="252" name="since" description="1.20"/>
3961
+ <tag line="252" name="return" description="echoes HTML script tags for the templates" type="void">
3962
  <type by_reference="false">void</type>
3963
  </tag>
3964
  </docblock>
3965
  </method>
3966
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="362" package="Media Library Assistant">
3967
  <name>mla_admin_init_ajax_action</name>
3968
  <full_name>mla_admin_init_ajax_action</full_name>
3969
+ <docblock line="353">
3970
  <description><![CDATA[Adjust ajax handler for Media Manager queries]]></description>
3971
  <long-description><![CDATA[<p>Replace 'query-attachments' with our own handler if the request is coming from the "Assistant" tab</p>]]></long-description>
3972
+ <tag line="353" name="since" description="1.20"/>
3973
+ <tag line="353" name="return" description="" type="void">
3974
  <type by_reference="false">void</type>
3975
  </tag>
3976
  </docblock>
3977
  </method>
3978
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="387" package="Media Library Assistant">
3979
  <name>mla_query_attachments_action</name>
3980
  <full_name>mla_query_attachments_action</full_name>
3981
+ <docblock line="378">
3982
  <description><![CDATA[Ajax handler for Media Manager queries]]></description>
3983
  <long-description><![CDATA[<p>Adapted from wp_ajax_query_attachments in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
3984
+ <tag line="378" name="since" description="1.20"/>
3985
+ <tag line="378" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
3986
  <type by_reference="false">void</type>
3987
  </tag>
3988
  </docblock>
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>
5550
  <long-description><![CDATA[]]></long-description>
5551
  </docblock>
5552
  </constant>
5553
+ <constant namespace="global" line="143" package="Media Library Assistant">
5554
+ <name>MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX</name>
5555
+ <full_name>MLA_MEDIA_MODAL_DETAILS_CATEGORY_METABOX</full_name>
5556
+ <value><![CDATA['media_modal_details_category_metabox']]></value>
5557
+ <docblock line="139">
5558
+ <description><![CDATA[Provides a unique name for the Media Manager Attachment Details searchable taxonomy option
5559
+ This option is for hierarchical taxonomies, e.g., "Att.]]></description>
5560
+ <long-description><![CDATA[<p>Categories".</p>]]></long-description>
5561
+ </docblock>
5562
+ </constant>
5563
+ <constant namespace="global" line="149" package="Media Library Assistant">
5564
+ <name>MLA_MEDIA_MODAL_DETAILS_TAG_METABOX</name>
5565
+ <full_name>MLA_MEDIA_MODAL_DETAILS_TAG_METABOX</full_name>
5566
+ <value><![CDATA['media_modal_details_tag_metabox']]></value>
5567
+ <docblock line="145">
5568
+ <description><![CDATA[Provides a unique name for the Media Manager Attachment Details searchable taxonomy option
5569
+ This option is for flat taxonomies, e.g., "Att.]]></description>
5570
+ <long-description><![CDATA[<p>Tags".</p>]]></long-description>
5571
+ </docblock>
5572
+ </constant>
5573
+ <constant namespace="global" line="154" package="Media Library Assistant">
5574
+ <name>MLA_MEDIA_MODAL_ORDERBY</name>
5575
+ <full_name>MLA_MEDIA_MODAL_ORDERBY</full_name>
5576
+ <value><![CDATA['media_modal_orderby']]></value>
5577
+ <docblock line="151">
5578
+ <description><![CDATA[Provides a unique name for the Media Manager orderby option]]></description>
5579
+ <long-description><![CDATA[]]></long-description>
5580
+ </docblock>
5581
+ </constant>
5582
+ <constant namespace="global" line="159" package="Media Library Assistant">
5583
+ <name>MLA_MEDIA_MODAL_ORDER</name>
5584
+ <full_name>MLA_MEDIA_MODAL_ORDER</full_name>
5585
+ <value><![CDATA['media_modal_order']]></value>
5586
+ <docblock line="156">
5587
+ <description><![CDATA[Provides a unique name for the Media Manager order option]]></description>
5588
+ <long-description><![CDATA[]]></long-description>
5589
+ </docblock>
5590
+ </constant>
5591
+ <constant namespace="global" line="164" package="Media Library Assistant">
5592
  <name>MLA_POST_MIME_TYPES</name>
5593
  <full_name>MLA_POST_MIME_TYPES</full_name>
5594
  <value><![CDATA['post_mime_types']]></value>
5595
+ <docblock line="161">
5596
  <description><![CDATA[Provides a unique name for the Post MIME Types option]]></description>
5597
  <long-description><![CDATA[]]></long-description>
5598
  </docblock>
5599
  </constant>
5600
+ <constant namespace="global" line="169" package="Media Library Assistant">
5601
  <name>MLA_ENABLE_POST_MIME_TYPES</name>
5602
  <full_name>MLA_ENABLE_POST_MIME_TYPES</full_name>
5603
  <value><![CDATA['enable_post_mime_types']]></value>
5604
+ <docblock line="166">
5605
  <description><![CDATA[Provides a unique name for the Enable Post MIME Types option]]></description>
5606
  <long-description><![CDATA[]]></long-description>
5607
  </docblock>
5608
  </constant>
5609
+ <constant namespace="global" line="174" package="Media Library Assistant">
5610
  <name>MLA_UPLOAD_MIMES</name>
5611
  <full_name>MLA_UPLOAD_MIMES</full_name>
5612
  <value><![CDATA['upload_mimes']]></value>
5613
+ <docblock line="171">
5614
  <description><![CDATA[Provides a unique name for the Upload MIME Types option]]></description>
5615
  <long-description><![CDATA[]]></long-description>
5616
  </docblock>
5617
  </constant>
5618
+ <constant namespace="global" line="179" package="Media Library Assistant">
5619
  <name>MLA_ENABLE_UPLOAD_MIMES</name>
5620
  <full_name>MLA_ENABLE_UPLOAD_MIMES</full_name>
5621
  <value><![CDATA['enable_upload_mimes']]></value>
5622
+ <docblock line="176">
5623
  <description><![CDATA[Provides a unique name for the Enable Upload MIME Types option]]></description>
5624
  <long-description><![CDATA[]]></long-description>
5625
  </docblock>
5626
  </constant>
5627
+ <constant namespace="global" line="184" package="Media Library Assistant">
5628
  <name>MLA_ENABLE_MLA_ICONS</name>
5629
  <full_name>MLA_ENABLE_MLA_ICONS</full_name>
5630
  <value><![CDATA['enable_mla_icons']]></value>
5631
+ <docblock line="181">
5632
  <description><![CDATA[Provides a unique name for the Enable MLA Icons option]]></description>
5633
  <long-description><![CDATA[]]></long-description>
5634
  </docblock>
5635
  </constant>
5636
+ <property final="false" static="true" visibility="public" line="195" namespace="global" package="Media Library Assistant">
5637
  <name>$process_featured_in</name>
5638
  <default><![CDATA[true]]></default>
5639
+ <docblock line="186">
5640
  <description><![CDATA[Option setting for "Featured in" reporting]]></description>
5641
  <long-description><![CDATA[<p>This setting is false if the "Featured in" database access setting is "disabled", else true.</p>]]></long-description>
5642
+ <tag line="186" name="since" description="1.00"/>
5643
+ <tag line="186" name="var" description="" type="boolean">
5644
  <type by_reference="false">boolean</type>
5645
  </tag>
5646
  </docblock>
5647
  </property>
5648
+ <property final="false" static="true" visibility="public" line="206" namespace="global" package="Media Library Assistant">
5649
  <name>$process_inserted_in</name>
5650
  <default><![CDATA[true]]></default>
5651
+ <docblock line="197">
5652
  <description><![CDATA[Option setting for "Inserted in" reporting]]></description>
5653
  <long-description><![CDATA[<p>This setting is false if the "Inserted in" database access setting is "disabled", else true.</p>]]></long-description>
5654
+ <tag line="197" name="since" description="1.00"/>
5655
+ <tag line="197" name="var" description="" type="boolean">
5656
  <type by_reference="false">boolean</type>
5657
  </tag>
5658
  </docblock>
5659
  </property>
5660
+ <property final="false" static="true" visibility="public" line="217" namespace="global" package="Media Library Assistant">
5661
  <name>$process_gallery_in</name>
5662
  <default><![CDATA[true]]></default>
5663
+ <docblock line="208">
5664
  <description><![CDATA[Option setting for "Gallery in" reporting]]></description>
5665
  <long-description><![CDATA[<p>This setting is false if the "Gallery in" database access setting is "disabled", else true.</p>]]></long-description>
5666
+ <tag line="208" name="since" description="1.00"/>
5667
+ <tag line="208" name="var" description="" type="boolean">
5668
  <type by_reference="false">boolean</type>
5669
  </tag>
5670
  </docblock>
5671
  </property>
5672
+ <property final="false" static="true" visibility="public" line="228" namespace="global" package="Media Library Assistant">
5673
  <name>$process_mla_gallery_in</name>
5674
  <default><![CDATA[true]]></default>
5675
+ <docblock line="219">
5676
  <description><![CDATA[Option setting for "MLA Gallery in" reporting]]></description>
5677
  <long-description><![CDATA[<p>This setting is false if the "MLA Gallery in" database access setting is "disabled", else true.</p>]]></long-description>
5678
+ <tag line="219" name="since" description="1.00"/>
5679
+ <tag line="219" name="var" description="" type="boolean">
5680
  <type by_reference="false">boolean</type>
5681
  </tag>
5682
  </docblock>
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>
5690
 
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
  </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>
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>
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
  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>
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/>
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>
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.6
7
- Stable tag: 1.50
8
  License: GPLv2 or later
9
  License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
 
@@ -14,11 +14,11 @@ Enhances the Media Library; powerful [mla_gallery], taxonomy support, IPTC/EXIF/
14
 
15
  The Media Library Assistant provides several enhancements for managing the Media Library, including:
16
 
17
- * The **`[mla_gallery]` shortcode**, 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 WordPress `[gallery]` shortcode; it is compatible with `[gallery]` and provides many enhancements. These include: 1) full query and display support for WordPress categories, tags, custom taxonomies and custom fields, 2) support for all post_mime_type values, not just images 3) media Library items need not be "attached" to the post, and 4) control over the styles, markup and content of each gallery using Style and Markup Templates.
18
 
19
  * Powerful **Content Templates**, which let you compose a value from multiple data sources, mix literal text with data values, test for empty values and choose among two or more alternatives or suppress output entirely.
20
 
21
- * **Attachment metadata** such as file size, image dimensions and where-used information can be assigned to WordPress custom fields. You can then use the custom fields in your `[mla_gallery]` display and you can add custom fields as sortable, searchable columns in the Media/Assistant submenu table.
22
 
23
  * **IPTC**, **EXIF (including GPS)** and **PDF** metadata can be assigned to standard WordPress fields, taxonomy terms and custom fields. You can update all existing attachments from the Settings page IPTC/EXIF tab, groups of existing attachments with a Bulk Action or one existing attachment from the Edit Media/Edit Single Item screen. Display **IPTC**, **EXIF** and **PDF** metadata with `[mla_gallery]` custom templates.
24
 
@@ -121,6 +121,21 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
121
 
122
  == Changelog ==
123
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
124
  = 1.50 =
125
  * New: **PDF metadata support**, including the traditional Document Information Dictionary and the newer, more extensive XMP metadata. Include this information in your `[mla_gallery]` display and map it to standard fields, taxonomy terms and custom fields.
126
  * New: **Content Templates**, which let you compose a value from multiple substitution parameters, combine text and data values, test for empty values and choose among two or more alternatives or suppress output entirely.
@@ -138,79 +153,21 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
138
  * Fix: Initialization functions now have a higher priority value, so they run later. This improves features such as discovery of custom taxonomies created in theme `functions.php` files that use the `init` hook.
139
  * Fix: Hyperlinks to Document tab from other Settings/MediaLibrary Assistant tabs have been changed to more reliable absolute href values.
140
 
141
- = 1.43 =
142
- * New: For `[mla_gallery]`, a new `mla_output=paginate_links` parameter creates a paginated link list for galleries with multiple "gallery pages" ( e.g.: < Prev 1 3 4 5 6 7 … 9 Next > ). See the Settings/Media Library Assistant Documentation tab for complete information and examples.
143
- * New: For `[mla_gallery]`, `mla_prev_text` and `mla_next_text` can be used in place of `mla_link_text` with the `previous_link` and `next_link` output types.
144
- * Fix: When resetting Settings/Media Library Assistant General tab options, a Fatal PHP error no longer occurs.
145
- * Fix: PHP Warning message removed for `[mla_gallery]` shortcodes with no parameters at all.
146
- * Fix: For WordPress version 3.6, the Media Manager taxonomy dropdown box is indented with dashes; it no longer shows plaintext version of HTML non-breaking spaces.
147
- * Fix: For `[mla_gallery]`, "Next" and "Previous" text default values now use acute quotes, not arrows, conforming to the WordPress values.
148
- * Fix: Example for the `previous_page`/`next_page` output types has been corrected, showing `posts_per_page` in all three shortcodes.
149
-
150
- = 1.42 =
151
- * New: **Pagination support for `[mla_gallery]`**, using the "previous_page" and "next_page" values of the "mla_output" parameter. See the Settings/Media Library Assistant Documentation tab for complete information and examples.
152
- * New: For `[mla_gallery]`, a new parameter ("mla_link_class") lets you add class attribute values to the hyperlinks.
153
- * New: For `[mla_gallery]`, a new parameter ("mla_nolink_text") replaces the empty string returned for an empty `[mla_gallery]` or null pagination links.
154
- * New: For `[mla_gallery]`, the **"mla_margin" and "mla_itemwidth" parameters can be set to any value**, not just percent values. You can use "auto", dimension values like "10px" or remove the properties altogether. See the Settings/Media Library Assistant Documentation tab for complete information.
155
- * New: Default values for the `[mla_gallery]` "columns", "mla_margin" and "mla_itemwidth" parameters can now be specified on the Settings/Media Library Assistant submenu, MLA Gallery tab.
156
- * New: For `[mla_gallery]`, a new substitution parameter ("last_in_row") contains a class name for the last item in each full gallery row. You can use this class name to apply specific CSS styles to the last item in each full row.
157
- * New: For `[mla_gallery]`, a new parameter ("tax_include_children") gives more control for queries on hierarchial taxonomies, such as `attachment_category`.
158
- * New: On the Media/Assistant submenu a new rollover action, "View", has been added.
159
- * New: On the Media/Assistant submenu a new column, "File URL", has been added.
160
- * New: `absolute_path`, `absolute_file_name`, `base_file`, `name_only` and `mime_type` values added to the custom field data sources list.
161
- * Fix: For `[mla_gallery]`, the `paged=current` value will now take its value from the "page" query variable for Single Paginated Posts that contain the `<!--nextpage-->` quicktag in the post content.
162
- * Fix: On the Media/Assistant submenu, the view, search, filter and sort values are retained when moving among multiple pages.
163
- * Fix: On the Media/Assistant submenu, the view, search and filter values are retained when re-sorting by column values.
164
- * Fix: On the Media/Assistant submenu, the current view is correctly highlighted for MLA enhanced table views.
165
- * Fix: If you disable the Media Manager Enhanced Search Media box, the WordPress-native search box functions correctly.
166
- * Fix: On the Settings/Media Library Assistant submenu, Custom Fields and IPTC/EXIF tabs, the field drop-downlist in the "Add a new Mapping Rule" area now includes fields that have been defined but not yet mapped to any attachments.
167
-
168
- = 1.41 =
169
- * New: For `[mla_gallery]`, the new `mla_output` parameter lets you get "previous_link" and "next_link" values to support moving through an `[mla_gallery]` one item at a time. Look for **Support for Alternative Gallery Output** in the Other Notes section or the Settings/Media Library Assistant Documentation tab for complete information.
170
- * New: For `[mla_gallery]`, field-level substitution parameters now include $_REQUEST arguments. You can pass any values you need from HTML form or hyperlink variables to the Gallery Display Content parameters and to your custom style and markup templates.
171
- * New: Hover text/tool tips, e.g., "Filter by...", "Edit..." added to most links on the Media/Assistant submenu table.
172
- * New: The ALL_EXIF and ALL_IPTC pseudo variables now limit each field value to 256 bytes or less. Array values are included once, at their most expanded level.
173
- * New: For `[mla_gallery]`, EXIF values containing arrays now use the ",single" and ",export" qualifiers.
174
- * Fix: Intermittent "full height" display of attachment thumbnails has been eliminated. Attachment thumbnail is now a link to the Edit Media screen.
175
- * Fix: EXIF and IPTC values containing invalid UTF8 characters are converted to valid UTF8 equivalents.
176
- * Fix: When editing `[gallery]` shortcodes in the Media Manager the proper gallery contents (image thumbnails) are now returned.
177
- * Fix: Better handling of Media/Assistant submenu table listing when returning from a Bulk Action, especially Bulk Edit. Display filters for date, category/tag and the search box are retained.
178
- * Fix: For `[mla_gallery]`, Gallery Content Display parameters are now processed when `mla_viewer=true`.
179
- * Fix: For `[mla_gallery]`, the default "alt" attribute (item caption) is processed when `mla_viewer=true`.
180
- * Fix: For `[mla_gallery]`, error messages are displayed for invalid "terms:" and "custom:" substitution parameters.
181
-
182
- = 1.40 =
183
- * New: **"base" selection** for the where-used database access tuning "Inserted in" option **can significantly improve performance** while retaining the most useful part of the where-used information. It's on the Settings/Media Library Assistant screen, General tab.
184
- * New: **Add Post MIME Types and define new views** for the Media/Library screen and the Media Manager/Add Media "media items" drop down list.
185
- * New: MLA's Media/Assistant screen and the Media Manager/Add Media "media items" drop down list use an enhanced version of the list, **Table Views**, to support views with multiple MIME Types (e.g., "audio,video") and wildcard specifications (e.g. "*/*ms*"). You can also create views based on custom field values.
186
- * New: Add file extensions and MIME types for uploads to the Media Library. Search the list of over 1,500 extension/MIME type associations to get the best matches possible.
187
- * New: **Choose from 112 enhanced file type images** to associate more specific and colorful icons with non-image file extensions for admin screens and `[gallery]` or `[mla_gallery]` displays.
188
- * New: For `[mla_gallery]`, four new "Gallery Display Content" parameters, `mla_link_attributes`, `mla_image_attributes`, `mla_image_class` and `mla_image_alt`, give you complete control over the link and image portions of gallery items without requiring custom style or markup templates.
189
- * New: `upload_date`, `parent_date` and eight "where used" values added to the custom field data sources list.
190
- * New: Five options for mapping multi-value custom fields, "text", "single", "export", "array" and "multi", give more control over the process.
191
- * New: "Delete NULL values" option offers better control over storing custom field values mapped from MLA data sources.
192
- * New: The Media/Assistant "MIME Type" column now links to a table listing filtered by MIME Type.
193
- * Fix: Better performance for database-intensive oprations such as custom field mapping rules processing.
194
- * Fix: MLA help tabs are not added to edit taxonomy screens when post_type is not "attachment".
195
- * Fix: Duplicate MLA help tabs not added to the WordPress Edit Tags and Categories screens.
196
- * Fix: Quick edit data now populates in Title/Name, Title or Name columns when ID/Parent column is hidden.
197
- * Fix: Terms dropdown list is now sorted by name (was by term-id) on the Media/Assistant table listing and on the Media Manager "Add Media" dialog box.
198
- * Fix: Where-used reporting "Gallery in" and "MLA Gallery in" results now properly handle `[gallery]` and `[mla_gallery]` shortcodes embedded within other (enclosing) shortcodes.
199
- * Fix: Taxonomy support now properly handles custom taxonomies registered with `show_ui = '1'` and other variations of boolean "true", e.g., those created by the "Magic Fields 2" plugin.
200
- * Fix: Better error handling and reporting when processing invalid `[mla_gallery]` and `[gallery]` shortcodes.
201
- * Fix: Unusual calls to the 'add_meta_boxes' action, e.g., missing arguments, no longer generate Warning messages.
202
- * Fix: For `[mla_gallery]`, `mla_target` now works when `mla_viewer=true`.
203
- * Fix: For `[mla_gallery]`, `mla_debug` now works with `mla_alt_shortcode`.
204
- * Fix: For `[mla_gallery]`, the default `caption` value is now available to the `mla_caption` parameter.
205
 
206
  = 1.00 - 1.30 =
207
- * New "mla_alt_shortcode" parameter combines [mla_gallery] with other gallery display shortcodes, e.g., Jetpack Carousel and Tiled Mosaic. Support for new 3.6 audio/video metadata. One other enhancement, eight fixes.
208
- * Media Manager (Add Media, etc.) enhancements: filter by more MIME types, date, taxonomy terms; enhanced search box for name/slug, ALT text, caption and attachment ID. New [mla_gallery] sort options. Four other enhancements, four fixes.
209
- * New [mla_gallery] mla_target and tax_operator parameters, tax_query cleanup and ids/include fix. Attachments column fix. IPTC/EXIF and Custom Field mapping fixes. Three other fixes.
210
- * Search by attachment ID, avoid fatal errors and other odd results when adding taxonomy terms. One other fix.
211
- * Map attachment metadata to custom fields; add them to [mla_gallery] display and as sortable columns on the Media/Assistant submenu table. Get Photonic Gallery (plugin) integration and six other fixes.
212
- where-used reporting. Specify default `[mla_gallery]` style and markup templates. Five other fixes.
213
-
 
214
  = 0.11 - 0.90 =
215
  * `[mla_gallery]` support for custom fields, taxonomy terms and IPTC/EXIF metadata. Updated for WordPress 3.5!
216
  * Improved default Style template, `[mla_gallery]` parameters "mla_itemwidth" and "mla_margin" for control of gallery item spacing. Quick edit support of WordPress standard Categories taxonomy has been fixed.
@@ -230,8 +187,8 @@ where-used reporting. Specify default `[mla_gallery]` style and markup templates
230
 
231
  == Upgrade Notice ==
232
 
233
- = 1.50 =
234
- PDF and GPS Metadata support. Content Templates; mix literal text with data values, test for empty values and choose among two or more alternatives for [mla_gallery] and data mapping. Five other enhancements, seven fixes.
235
 
236
  == Other Notes ==
237
 
@@ -276,9 +233,11 @@ Three parameters provide control over the placement, size and spacing of gallery
276
 
277
  Twelve parameters provide pagination support and an easy way to control the contents of gallery items without requiring the use of custom Markup templates.
278
 
279
- <h4>Google File Viewer Support</h4>
 
 
280
 
281
- Four parameters provide an easy way to generate thumbnail images for the non-image file types.
282
 
283
  == Support for Alternative Gallery Output, e.g., pagination ==
284
  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.
@@ -320,7 +279,7 @@ There are nine prefix values for field-level data.
320
  * `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.
321
  * `iptc`: The IPTC (International Press Telecommunications Council) metadata, if any, embedded in the image file.
322
  * `exif`: The EXIF (EXchangeable Image File) metadata, if any, embedded in a JPEG DCT or TIFF Rev 6.0 image file.
323
- * `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.
324
 
325
  <h4>NEW! Metadata in PDF documents</h4>
326
 
@@ -353,7 +312,7 @@ Conditional, choice and template elements can be nested as needed. For example,
353
 
354
  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.
355
 
356
- ==Custom Field Processing Options==
357
 
358
  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:
359
 
@@ -361,6 +320,24 @@ On the Custom Fields tab of the Settings screen you can define the rules for map
361
 
362
  * 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.
363
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
364
  <h4>Data sources for custom field mapping</h4>
365
 
366
  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.
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.51
8
  License: GPLv2 or later
9
  License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
 
14
 
15
  The Media Library Assistant provides several enhancements for managing the Media Library, including:
16
 
17
+ * The **`[mla_gallery]` shortcode**, 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 WordPress `[gallery]` shortcode; it is compatible with `[gallery]` and provides many enhancements. These include: 1) full query and display support for WordPress categories, tags, custom taxonomies and custom fields, 2) support for all post_mime_type values, not just images 3) media Library items need not be "attached" to the post, and 4) control over the styles, markup and content of each gallery using Style and Markup Templates. **Twenty-five hooks** provided for complete gallery customization from your theme or plugin code.
18
 
19
  * Powerful **Content Templates**, which let you compose a value from multiple data sources, mix literal text with data values, test for empty values and choose among two or more alternatives or suppress output entirely.
20
 
21
+ * **Attachment metadata** such as file size, image dimensions and where-used information can be assigned to WordPress custom fields. You can then use the custom fields in your `[mla_gallery]` display and you can add custom fields as sortable, searchable columns in the Media/Assistant submenu table. You can also **modify the WordPress `_wp_attachment_metadata` contents** to suit your needs.
22
 
23
  * **IPTC**, **EXIF (including GPS)** and **PDF** metadata can be assigned to standard WordPress fields, taxonomy terms and custom fields. You can update all existing attachments from the Settings page IPTC/EXIF tab, groups of existing attachments with a Bulk Action or one existing attachment from the Edit Media/Edit Single Item screen. Display **IPTC**, **EXIF** and **PDF** metadata with `[mla_gallery]` custom templates.
24
 
121
 
122
  == Changelog ==
123
 
124
+ = 1.51 =
125
+ * New: For `[mla_gallery]`, **twenty-five new `apply_filters` hooks** let you modify gallery output with PHP code in your theme or another plugin. More information in the "Other Notes" section here. A complete, working example is provided in the Settings/Media Library Assistant Documentation tab.
126
+ * New: **Attachment Metadata mapping**. Add or change values in the WordPress `_wp_attachment_metadata` array. For example, add GPS data to the `image_meta` array. Full details in the "Other Notes" section and in the Settings/Media Library Assistant Documentation tab.
127
+ * New: **GPS Metadata fields added**: LatitudeSDM, LatitudeSDD, LongitudeSDM, LongitudeSDD with leading "-" sign for southern and western values.
128
+ * New: A new `[mla_gallery]` parameter, `mla_page_parameter` supports **multiple paginated galleries on the same post/page**.
129
+ * New: On the Media/Assistant submenu, the Description field has been added to the Quick Edit area.
130
+ * New: Support for **"searchable category/tag metaboxes"** added to the ATTACHMENT DETAILS pane of the Media Manager Modal Window. This feature requires download and activation of the "Media Categories" plugin (by Eddie Moya).
131
+ * New: The **`[+custom:ALL_CUSTOM+]` pseudo value** lets you easily display the names and values of all custom fields associated with an item. You can use it in an `[mla_gallery]` or in a custom field mapping rule.
132
+ * Fix: Media Manager Modal Window support has been re-worked to avoid adding additional parameters to the Attachments object. This improves the handling of "drag & drop" uploading of new Media Library items.
133
+ * Fix: Sorting the Media/Assistant submenu table by a column which no longer exists does not cause database errors. The table sort reverts to the built-in default value. In addition, the dropdown list of sortable columns is now alphabetized.
134
+ * Fix: The "Inserted in" reporting with the "Base" option setting more reliably handles the case where one item filename is a subset of another filename. For example, file "abc.jpg" no longer matches "abcd.jpg".
135
+ * Fix: Handling of empty `query:` and `request:` substitution parameters has been restored to the pre-v1.50 logic.
136
+ * Fix: Custom field mapping for fields with array values is more reliably handled.
137
+ * Fix: Test elements in Content Templates returning array results more accurately test for substitution parameters having no value. For example, `([+iptc:2#020,array+][+iptc:2#025,array+])` will be empty unless **both** of the substitution parameters have values.
138
+
139
  = 1.50 =
140
  * New: **PDF metadata support**, including the traditional Document Information Dictionary and the newer, more extensive XMP metadata. Include this information in your `[mla_gallery]` display and map it to standard fields, taxonomy terms and custom fields.
141
  * New: **Content Templates**, which let you compose a value from multiple substitution parameters, combine text and data values, test for empty values and choose among two or more alternatives or suppress output entirely.
153
  * Fix: Initialization functions now have a higher priority value, so they run later. This improves features such as discovery of custom taxonomies created in theme `functions.php` files that use the `init` hook.
154
  * Fix: Hyperlinks to Document tab from other Settings/MediaLibrary Assistant tabs have been changed to more reliable absolute href values.
155
 
156
+ = 1.40 - 1.43 =
157
+ * 1.43: Generalized pagination support with "mla_output=paginate_links". One other enhancement, four fixes.
158
+ * 1.42: Pagination support for [mla_gallery]! Improved CSS width (itemwidth) and margin handling. Eight other enhancements, six fixes.
159
+ * 1.41: New [mla_gallery] "previous link" and "next link" output for gallery navigation. New "request" substitution parameter to access $_REQUEST variables. Three other enhancements, seven fixes.
160
+ * 1.40: Better performance! New custom table views, Post MIME Type and Upload file/MIMEs control; 112 file type icons to choose from. Four new Gallery Display Content parameters. four other enhancements, twelve fixes.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
161
 
162
  = 1.00 - 1.30 =
163
+ * 1.30: New "mla_alt_shortcode" parameter combines [mla_gallery] with other gallery display shortcodes, e.g., Jetpack Carousel and Tiled Mosaic. Support for new 3.6 audio/video metadata. One other enhancement, eight fixes.
164
+ * 1.20: Media Manager (Add Media, etc.) enhancements: filter by more MIME types, date, taxonomy terms; enhanced search box for name/slug, ALT text, caption and attachment ID. New [mla_gallery] sort options. Four other enhancements, four fixes.
165
+ * 1.14: New [mla_gallery] mla_target and tax_operator parameters, tax_query cleanup and ids/include fix. Attachments column fix. IPTC/EXIF and Custom Field mapping fixes. Three other fixes.
166
+ * 1.13: Add custom fields to the quick and bulk edit areas; sort and search on them in the Media/Assistant submenu. Expanded EXIF data access, including COMPUTED values. Google File Viewer support, two other enhancements and two fixes.
167
+ * 1.11: Search by attachment ID, avoid fatal errors and other odd results when adding taxonomy terms. One other fix.
168
+ * 1.10: Map attachment metadata to custom fields; add them to [mla_gallery] display and as sortable columns on the Media/Assistant submenu table. Get Photonic Gallery (plugin) integration and six other fixes.
169
+ * 1.00: Map IPTC and EXIF metadata to standard fields, taxonomy terms and custom fields. Improved performance for where-used reporting. Specify default `[mla_gallery]` style and markup templates. Five other fixes.
170
+
171
  = 0.11 - 0.90 =
172
  * `[mla_gallery]` support for custom fields, taxonomy terms and IPTC/EXIF metadata. Updated for WordPress 3.5!
173
  * Improved default Style template, `[mla_gallery]` parameters "mla_itemwidth" and "mla_margin" for control of gallery item spacing. Quick edit support of WordPress standard Categories taxonomy has been fixed.
187
 
188
  == Upgrade Notice ==
189
 
190
+ = 1.51 =
191
+ Attachment Metadata mapping/updating, [mla_gallery] "apply_filters" hooks, multiple paginated galleries per page, "ALL_CUSTOM" pseudo value. Three other enhancements, six fixes.
192
 
193
  == Other Notes ==
194
 
233
 
234
  Twelve parameters provide pagination support and an easy way to control the contents of gallery items without requiring the use of custom Markup templates.
235
 
236
+ <h4>NEW! MLA Gallery Filters and Actions (Hooks)</h4>
237
+
238
+ 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.
239
 
240
+ 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.
241
 
242
  == Support for Alternative Gallery Output, e.g., pagination ==
243
  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.
279
  * `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.
280
  * `iptc`: The IPTC (International Press Telecommunications Council) metadata, if any, embedded in the image file.
281
  * `exif`: The EXIF (EXchangeable Image File) metadata, if any, embedded in a JPEG DCT or TIFF Rev 6.0 image file.
282
+ * `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.
283
 
284
  <h4>NEW! Metadata in PDF documents</h4>
285
 
312
 
313
  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.
314
 
315
+ ==Custom Field and Attachment Metadata Processing Options==
316
 
317
  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:
318
 
320
 
321
  * 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.
322
 
323
+ **NEW! Adding or changing Attachment Metadata**
324
+
325
+ 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.
326
+
327
+ 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.
328
+
329
+ Let's say, for example, that you want to add GPS coordinates to the "image_meta" element of the Attachment Metadata.
330
+
331
+ 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.
332
+
333
+ 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.
334
+
335
+ 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.
336
+
337
+ 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.
338
+
339
+ If you are creating an IPTC/EXIF mapping rule the details are a bit different, but the capability is equivalent.
340
+
341
  <h4>Data sources for custom field mapping</h4>
342
 
343
  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.
tpls/admin-display-settings-page.tpl CHANGED
@@ -212,11 +212,14 @@
212
  </form>
213
 
214
  <!-- template="custom-field-tab" -->
215
- <h3>Custom Field Processing Options</h3>
216
  <p>
217
  In this tab you can define the rules for mapping several types of image metadata to WordPress custom fields. <strong>NOTE:</strong> changes to a single rule will be made permanent if you click the "Update Rule" button for that rule. The rule will be applied to existing attachments if you click the "Map All Attachments" button for that rule.
218
  </p>
219
  <p>
 
 
 
220
  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 this screen. You can selectively apply the mapping in the bulk edit area of the Media/Assistant screen and/or on the Media/Edit Media screen for a single attachment.
221
  </p>
222
  <p>
@@ -229,7 +232,7 @@ If you just want to add a custom field to the Media/Assistant submenu, the quick
229
  You can find more information about all of these topics on the <a href="[+settingsURL+]?page=mla-settings-menu-documentation&amp;mla_tab=documentation#mla_custom_field_mapping" title="Custom Field Processing Options documentation">Documentation tab</a>.
230
  </p>
231
  <p>
232
- <strong>NOTE:</strong> Check the box in the "MLA Column" column to make the field a sortable, searchable column in the Media/Assistant submenu table. The "file_size", "pixels", "width" and "height" data sources will sort more sensibly if you use the "Commas" format. Check the "Quick Edit" or "Bulk Edit" box to add the field to the quick edit or bulk edit areas of the Media/Assistant submenu.
233
  </p>
234
  <form action="[+form_url+]" method="post" class="mla-display-settings-page" id="mla-display-settings-custom-field-tab">
235
  &nbsp;<br />
212
  </form>
213
 
214
  <!-- template="custom-field-tab" -->
215
+ <h3>Custom Field and Attachment Metadata Processing Options</h3>
216
  <p>
217
  In this tab you can define the rules for mapping several types of image metadata to WordPress custom fields. <strong>NOTE:</strong> changes to a single rule will be made permanent if you click the "Update Rule" button for that rule. The rule will be applied to existing attachments if you click the "Map All Attachments" button for that rule.
218
  </p>
219
  <p>
220
+ You can also use this screen to define rules for adding or updating fields within the WordPress-supplied "Attachment Metadata", stored in the "_wp_attachment_metadata" custom field. See the <a href="[+settingsURL+]?page=mla-settings-menu-documentation&amp;mla_tab=documentation#attachment_metadata_mapping">Adding or changing Attachment Metadata</a> section of the Documentation for details.
221
+ </p>
222
+ <p>
223
  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 this screen. You can selectively apply the mapping in the bulk edit area of the Media/Assistant screen and/or on the Media/Edit Media screen for a single attachment.
224
  </p>
225
  <p>
232
  You can find more information about all of these topics on the <a href="[+settingsURL+]?page=mla-settings-menu-documentation&amp;mla_tab=documentation#mla_custom_field_mapping" title="Custom Field Processing Options documentation">Documentation tab</a>.
233
  </p>
234
  <p>
235
+ <strong>NOTE:</strong> For custom fields (but <strong>not</strong> for Attachment Metadata values), check the box in the "MLA Column" column to make the field a sortable, searchable column in the Media/Assistant submenu table. The "file_size", "pixels", "width" and "height" data sources will sort more sensibly if you use the "Commas" format. Check the "Quick Edit" or "Bulk Edit" box to add the field to the quick edit or bulk edit areas of the Media/Assistant submenu.
236
  </p>
237
  <form action="[+form_url+]" method="post" class="mla-display-settings-page" id="mla-display-settings-custom-field-tab">
238
  &nbsp;<br />
tpls/admin-inline-edit-form.tpl CHANGED
@@ -27,7 +27,7 @@
27
  <input type="radio" name="tax_action[[+tax_attr+]]" id="tax_reset_[+tax_attr+]" value="replace" /> Replace&nbsp;
28
  </div>
29
  <!-- template="custom_field" -->
30
- <label class="inline-edit-[+slug+]"> <span class="title">[+label+]</span> <span class="input-text-wrap">
31
  <input type="text" name="[+slug+]" value="" />
32
  </span> </label>
33
  <!-- template="page" -->
@@ -48,6 +48,9 @@
48
  <label> <span class="title">Caption</span> <span class="input-text-wrap">
49
  <input type="text" name="post_excerpt" value="" />
50
  </span> </label>
 
 
 
51
  <label class="inline-edit-image-alt"> <span class="title">Alt Text</span> <span class="input-text-wrap">
52
  <input type="text" name="image_alt" value="" />
53
  </span> </label>
27
  <input type="radio" name="tax_action[[+tax_attr+]]" id="tax_reset_[+tax_attr+]" value="replace" /> Replace&nbsp;
28
  </div>
29
  <!-- template="custom_field" -->
30
+ <label class="inline-edit-[+slug+]" style="clear:both"> <span class="title">[+label+]</span> <span class="input-text-wrap">
31
  <input type="text" name="[+slug+]" value="" />
32
  </span> </label>
33
  <!-- template="page" -->
48
  <label> <span class="title">Caption</span> <span class="input-text-wrap">
49
  <input type="text" name="post_excerpt" value="" />
50
  </span> </label>
51
+ <label> <span class="title">Description</span> <span class="input-text-wrap">
52
+ <textarea class="widefat" name="post_content"></textarea>
53
+ </span> </label>
54
  <label class="inline-edit-image-alt"> <span class="title">Alt Text</span> <span class="input-text-wrap">
55
  <input type="text" name="image_alt" value="" />
56
  </span> </label>
tpls/documentation-settings-tab.tpl CHANGED
@@ -24,6 +24,7 @@
24
  <li><a href="#custom_field_parameters">Custom Field Parameters</a></li>
25
  <li><a href="#search_keywords">Search Keywords</a></li>
26
  <li><a href="#debugging_output">Debugging Output</a></li>
 
27
  </ul>
28
  </li>
29
  <li>
@@ -38,21 +39,17 @@
38
  <li>
39
  <a href="#mla_gallery_templates"><strong>Style and Markup Templates</strong></a>
40
  </li>
41
- <li>
42
- <a href="#mla_style_parameters"><strong>Substitution parameters for style templates</strong></a>
43
- </li>
44
- <li>
45
- <a href="#mla_markup_parameters"><strong>Substitution parameters for markup templates</strong></a>
46
- </li>
47
- <li>
48
- <a href="#mla_attachment_parameters"><strong>Attachment-specific substitution parameters for the markup template Item part</strong></a>
49
- </li>
50
  <li>
51
  <a href="#mla_variable_parameters"><strong>Field-level markup substitution parameters</strong></a>
52
  </li>
53
- <li>
54
- <a href="#pdf_metadata"><strong>Metadata in PDF documents</strong></a>
55
- </li>
56
  <li>
57
  <a href="#mla_template_parameters"><strong>Content Templates</strong></a>
58
  <li>
@@ -68,21 +65,22 @@
68
  <a href="#mla_optional_uploads"><strong>Searching for Upload MIME Types</strong></a>
69
  </li>
70
  <li>
71
- <a href="#mla_custom_field_mapping"><strong>Custom Field Processing Options</strong></a>
72
- </li>
73
- <li>
74
- <a href="#mla_custom_field_parameters"><strong>Data sources for custom field mapping</strong></a>
75
  </li>
 
 
 
 
 
76
  <li>
77
  <a href="#mla_iptc_exif_mapping"><strong>IPTC &amp; EXIF Processing Options</strong></a>
78
  </li>
79
- <li>
80
- <a href="#mla_gps_values"><strong>Enhanced GPS values</strong></a>
81
- </li>
82
- <li>
83
- <a href="#mla_iptc_identifiers"><strong>IPTC identifiers and friendly names</strong></a>
84
  </li>
85
  </ul>
 
86
  <h3>Plugin Code Documentation</h3>
87
  <p>
88
  If you are a developer interested in how this plugin is put together, you should
@@ -481,7 +479,68 @@ The search parameter ("s=keyword") will perform a keyword search. A cursory insp
481
  <h4>Debugging Output</h4>
482
  <p>
483
  The "mla_debug" parameter controls the display of information about the query parameters and SQL statements used to retrieve gallery items. If you code <code>mla_debug=true</code> you will see a lot of information added to the post or page containing the gallery. Of course, this parameter should <strong><em>ONLY</em></strong> be used in a development/debugging environment; it's quite ugly.
 
 
 
 
 
 
 
 
 
 
 
 
484
  </p>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
485
  <a name="mla_output"></a>
486
  &nbsp;
487
  <p>
@@ -1176,7 +1235,10 @@ There are nine prefix values for field-level data. Prefix values must be coded a
1176
  </tr>
1177
  <tr>
1178
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">custom</td>
1179
- <td>WordPress Custom Fields, which you can define and populate on the Edit Media screen or map from various sources on the Settings/Media Library Assistant Custom and IPTC/EXIF tabs. The field name, or key, can contain spaces and some punctuation characters. You <strong><em>cannot use the plus sign ('+')</em></strong> in a field name you want to use with <code>[mla_gallery]</code>. Custom field names are case-sensitive; "client" and "Client" are not the same.</td>
 
 
 
1180
  </tr>
1181
  <tr>
1182
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">terms</td>
@@ -1555,11 +1617,14 @@ Put on your boots and have a paddle handy - it's a swamp! Good luck.
1555
  <p>
1556
  <a href="#backtotop">Go to Top</a>
1557
  </p>
1558
- <h3>Custom Field Processing Options</h3>
1559
  <p>
1560
  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.
1561
  </p>
1562
  <p>
 
 
 
1563
  This is a powerful tool, but it comes at the price of additional database storage space and processing time to maintain and retrieve the data. <strong><em>Think carefully about your needs before you use this tool.</em></strong> You can disable or delete any rules you create, so you might want to set up some rules for a special project or analysis of your library and then discard them when you're done. That said, the advantages of mapping metadata to custom fields are:
1564
  </p>
1565
  <ul class="mla_settings">
@@ -1577,7 +1642,49 @@ Several of the data elements are sourced from the WordPress "image_meta" array.
1577
  You can also use a <a href="#mla_template_parameters">Content Template</a> to compose custom field values from multiple sources, test for non-empty content and choose from alternative sources.
1578
  </p>
1579
  <p>
1580
- If you just want to add a custom field to the Media/Assistant submenu, the quick edit area and/or the bulk edit area you can bypass the mapping logic by leaving the Data Source value as "-- None (select a value) --".
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1581
  </p>
1582
  <a name="mla_custom_field_parameters"></a>
1583
  &nbsp;
@@ -1865,7 +1972,12 @@ If you use the "Multi" option you will almost certainly want to use the "Delete
1865
  </p>
1866
  <h4>Custom field mapping for metadata fields</h4>
1867
  <p>
1868
- If you select "<strong>-- Metadata (see below) --</strong>" as the data source you must specify the name of the field you want in the text box below the data source dropdown box. Any of the fields in the <em>_wp_attachment_metadata</em> array may be named, including the new audio/video fields available with WordPress 3.6 and later. For example, "length_formatted" will return the length of a video attachment. You can specify fields within an array with a compound name, e.g., "audio.sample_rate" to get the sampling rate field from the "audio" array of a video attachment. If you simply specify "audio", you will get the values of every array element, e.g., "mp4,ISO/IEC 14496 AAC,48000,2,16,false,stereo".
 
 
 
 
 
1869
  </p>
1870
  <h4>Custom field mapping with Content Templates</h4>
1871
  <p>
@@ -1880,7 +1992,10 @@ You can use a template to compose a custom field from multiple data sources, e.g
1880
  </p>
1881
  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, "<code>[+pdf:Keywords+]|[+iptc:2#025+]|none</code>" 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.
1882
  <p>
1883
- Using a template with the Option Dropdown "Text" or "Single" values will yield a text result. For example, multiple IPTC keywords would be converted into a comma-delimited list as a string. If you combine a template with the "Export", "Array" or "Multi" values the template will deliver an array result if the fields inside the template have multiple values. For example, with "Multi" you can code "<code>[+iptc:2#020<strong>,array</strong>+][+iptc:2#025<strong>,array</strong>+]</code>" to store each of the IPTC supplemental-category <em><strong>and</strong></em> keywords values (there is no "|" in the template) in a separate custom field value. Note the use of the <strong>,array</strong> formatting option in each field; this is required to get an array result for the field.
 
 
 
1884
  </p>
1885
  <a name="mla_iptc_exif_mapping"></a>
1886
  &nbsp;
@@ -1906,6 +2021,8 @@ The three mapping tables on the IPTC/EXIF tab have the following columns:
1906
  <dl>
1907
  <dt>Field Title</dt>
1908
  <dd>The standard field title, taxonomy name or Custom Field name. In the Custom Field table you can define a new field by entering its name in the blank box at the bottom of the list; the value will be saved when you click "Save Changes" at the bottom of the screen.
 
 
1909
  </dd>
1910
  <dt>IPTC Value</dt>
1911
  <dd>The IPTC (International Press Telecommunications Council) metadata, if any, embedded in the image file. For this category, you can select any of the IPTC DataSet tag and field identifiers, e.g., "2#025" for the Keywords field. The dropdown list has the identifier and the "friendly name" MLA defines for most of the IPTC fields; see the table of identifiers and friendly names in the table below. You can find more information in the <a href="http://www.iptc.org/std/IIM/4.1/specification/IIMV4.1.pdf" title="IPTC-NAA Information Interchange Model Version No. 4.1 specification" target="_blank">IPTC-NAA Information Interchange Model Version No. 4.1 specification</a>.
@@ -1946,7 +2063,7 @@ You can use a template to compose a value from multiple data sources, e.g., "<co
1946
  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, "<code>[+iptc:2#020+]|[+iptc:2#025+]|none</code>" 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.
1947
  </p>
1948
  <p>
1949
- 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 "<code>[+iptc:2#020+][+iptc:2#025+]</code>" 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.
1950
  </p>
1951
  <p>
1952
  Note that the <strong>,array</strong> formatting option is <strong>not</strong> required to get an array result for the field in a Taxonomy term mapping template; it is assumed. If you want a <strong>text</strong>, <strong>single</strong> or <strong>export</strong> result you can add one of those formatting options to your field specification.
@@ -2035,6 +2152,16 @@ The native format of this data is somewhat complicated, so MLA converts the most
2035
  <td style="padding-right: 10px; vertical-align: top">Second portion of Latitude</td>
2036
  </tr>
2037
  <tr>
 
 
 
 
 
 
 
 
 
 
2038
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">LatitudeDM</td>
2039
  <td style="padding-right: 10px; vertical-align: top">44 7.5669N</td>
2040
  <td style="padding-right: 10px; vertical-align: top">Latitude expressed as degrees and decimal minutes (MinDec)</td>
@@ -2085,6 +2212,16 @@ The native format of this data is somewhat complicated, so MLA converts the most
2085
  <td style="padding-right: 10px; vertical-align: top">Second portion of Longitude</td>
2086
  </tr>
2087
  <tr>
 
 
 
 
 
 
 
 
 
 
2088
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">LongitudeDM</td>
2089
  <td style="padding-right: 10px; vertical-align: top">145 5.1534E</td>
2090
  <td style="padding-right: 10px; vertical-align: top">Longitude expressed as degrees and decimal minutes (MinDec)</td>
@@ -2175,7 +2312,7 @@ The native format of this data is somewhat complicated, so MLA converts the most
2175
  <p>
2176
  <a href="#backtotop">Go to Top</a>
2177
  </p>
2178
- <h3>IPTC Identifiers and Friendly Names</h3>
2179
  <table>
2180
  <tr><td colspan="3" style="font-weight:bold">Envelope Record</td></tr>
2181
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">model-version</td><td style="padding-right: 10px; vertical-align: top">1#000</td><td style="padding-right: 10px; vertical-align: top">2 octet binary IIM version number</td></tr>
24
  <li><a href="#custom_field_parameters">Custom Field Parameters</a></li>
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>
39
  <li>
40
  <a href="#mla_gallery_templates"><strong>Style and Markup Templates</strong></a>
41
  </li>
42
+ <ul style="list-style-position:inside; list-style:disc; line-height: 15px; padding-left: 20px">
43
+ <li><a href="#mla_style_parameters">Substitution parameters for style templates</a></li>
44
+ <li><a href="#mla_markup_parameters">Substitution parameters for markup templates</a></li>
45
+ <li><a href="#mla_attachment_parameters">Attachment-specific substitution parameters for the markup template Item part</a></li>
46
+ </ul>
 
 
 
 
47
  <li>
48
  <a href="#mla_variable_parameters"><strong>Field-level markup substitution parameters</strong></a>
49
  </li>
50
+ <ul style="list-style-position:inside; list-style:disc; line-height: 15px; padding-left: 20px">
51
+ <li><a href="#pdf_metadata">Metadata in PDF documents</a></li>
52
+ </ul>
53
  <li>
54
  <a href="#mla_template_parameters"><strong>Content Templates</strong></a>
55
  <li>
65
  <a href="#mla_optional_uploads"><strong>Searching for Upload MIME Types</strong></a>
66
  </li>
67
  <li>
68
+ <a href="#mla_custom_field_mapping"><strong>Custom Field and Attachment Metadata Processing Options</strong></a>
 
 
 
69
  </li>
70
+ <ul style="list-style-position:inside; list-style:disc; line-height: 15px; padding-left: 20px">
71
+ <li><a href="#attachment_metadata_mapping">Adding or Changing Attachment Metadata</a></li>
72
+ <li><a href="#mla_custom_field_parameters">Data sources for custom field mapping</a></li>
73
+ <li><a href="#custom_field_mapping_with_templates">Custom field mapping with Content Templates</a></li>
74
+ </ul>
75
  <li>
76
  <a href="#mla_iptc_exif_mapping"><strong>IPTC &amp; EXIF Processing Options</strong></a>
77
  </li>
78
+ <ul style="list-style-position:inside; list-style:disc; line-height: 15px; padding-left: 20px">
79
+ <li><a href="#mla_gps_values">Enhanced GPS values</a></li>
80
+ <li><a href="#mla_iptc_identifiers">IPTC identifiers and friendly names</a>
 
 
81
  </li>
82
  </ul>
83
+ </ul>
84
  <h3>Plugin Code Documentation</h3>
85
  <p>
86
  If you are a developer interested in how this plugin is put together, you should
479
  <h4>Debugging Output</h4>
480
  <p>
481
  The "mla_debug" parameter controls the display of information about the query parameters and SQL statements used to retrieve gallery items. If you code <code>mla_debug=true</code> you will see a lot of information added to the post or page containing the gallery. Of course, this parameter should <strong><em>ONLY</em></strong> be used in a development/debugging environment; it's quite ugly.
482
+ <a name="mla_gallery_hooks"></a>
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>
490
+ <li>Go to the Plugins/Installed Plugins screen and activate the "MLA Gallery Hooks Example" plugin.</li>
491
+ <li>Create a new <code>[mla_gallery]</code> shortcode or modify an existing shortcode, adding the <code>my_filter="all custom"</code> parameter to activate the example output.</li>
492
+ <li>View the post or page on which the modified shortcode appears to see a list of each item's custom fields appended to the gallery captions.</li>
493
+ </ol>
494
  </p>
495
+ <p>
496
+ 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:
497
+ </p>
498
+ <table>
499
+ <tr>
500
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_attributes,<br />mla_gallery_arguments</td>
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>
517
+ <td>an old filter retained for compatibility with earlier MLA versions.</td>
518
+ </tr>
519
+ <tr>
520
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_style_values,<br /> mla_gallery_style_template,<br />mla_gallery_style_parse</td>
521
+ <td>for manipulating the Style template.</td>
522
+ </tr>
523
+ <tr>
524
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_open_values,<br />mla_gallery_open_template,<br />mla_gallery_open_parse</td>
525
+ <td>for manipulating the "Open" part of the Markup template.</td>
526
+ </tr>
527
+ <tr>
528
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_row_open_values,<br />mla_gallery_row_open_template,<br />mla_gallery_row_open_parse</td>
529
+ <td>for manipulating the "Row Open" part of the Markup template.</td>
530
+ </tr>
531
+ <tr>
532
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_item_values,<br />mla_gallery_item_template,<br />mla_gallery_item_parse</td>
533
+ <td>for manipulating the "Item" part of the Markup template.</td>
534
+ </tr>
535
+ <tr>
536
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_row_close_values,<br />mla_gallery_row_close_template,<br />mla_gallery_row_close_parse</td>
537
+ <td>for manipulating the "Row Close" part of the Markup template.</td>
538
+ </tr>
539
+ <tr>
540
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_gallery_close_values,<br />mla_gallery_close_template,<br />mla_gallery_close_parse</td>
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>
1235
  </tr>
1236
  <tr>
1237
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">custom</td>
1238
+ <td>WordPress Custom Fields, which you can define and populate on the Edit Media screen or map from various sources on the Settings/Media Library Assistant Custom and IPTC/EXIF tabs. The field name, or key, can contain spaces and some punctuation characters. You <strong><em>cannot use the plus sign ('+')</em></strong> in a field name you want to use with <code>[mla_gallery]</code>. Custom field names are case-sensitive; "client" and "Client" are not the same. <br />&nbsp;<br />
1239
+ One special custom "pseudo-value" is available; <strong>ALL_CUSTOM</strong> (<code>[+custom:ALL_CUSTOM+]</code>). This returns a string representation of all custom field values. You can use this pseudo-values to quickly examine which fields are populated for a given Media Library item and what its values are.
1240
+ <br />&nbsp;<br />
1241
+ The ALL_CUSTOM value is altered in two ways. First, values of more than 256 characters are truncated to 256 characters. This prevents large fields from dominating the display. Second, array values are shown '(ARRAY)'.</td>
1242
  </tr>
1243
  <tr>
1244
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">terms</td>
1617
  <p>
1618
  <a href="#backtotop">Go to Top</a>
1619
  </p>
1620
+ <h3>Custom Field and Attachment Metadata Processing Options</h3>
1621
  <p>
1622
  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.
1623
  </p>
1624
  <p>
1625
+ You can also use this screen to define rules for adding or updating elements within the WordPress-supplied "Attachment Metadata", stored in the "_wp_attachment_metadata" custom field. See the <a href="#attachment_metadata_mapping">Adding or changing Attachment Metadata</a> section below for details.
1626
+ </p>
1627
+ <p>
1628
  This is a powerful tool, but it comes at the price of additional database storage space and processing time to maintain and retrieve the data. <strong><em>Think carefully about your needs before you use this tool.</em></strong> You can disable or delete any rules you create, so you might want to set up some rules for a special project or analysis of your library and then discard them when you're done. That said, the advantages of mapping metadata to custom fields are:
1629
  </p>
1630
  <ul class="mla_settings">
1642
  You can also use a <a href="#mla_template_parameters">Content Template</a> to compose custom field values from multiple sources, test for non-empty content and choose from alternative sources.
1643
  </p>
1644
  <p>
1645
+ If you just want to add a custom field to the Media/Assistant submenu, the Quick Edit area and/or the Bulk Edit area you can bypass the mapping logic by leaving the Data Source value as "-- None (select a value) --".
1646
+ </p>
1647
+ <a name="attachment_metadata_mapping"></a>
1648
+ &nbsp;<br />
1649
+ <h4>Adding or changing Attachment Metadata</h4>
1650
+ <p>
1651
+ 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.
1652
+ </p>
1653
+ <p>
1654
+ As explained elsewhere, you can access all of this data with the "meta:" <a href="#mla_variable_parameters">Field-level markup substitution parameter</a>. By coding the "meta:" prefix in the Field Title column of a field mapping rule you can add to or update this data as well, from any of the data sources listed below. You can use a <a href="#mla_template_parameters">Content Template</a> 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.
1655
+ <p>
1656
+ Let's say, for example, that you want to add GPS coordinates to the "image_meta" element of the Attachment Metadata.
1657
+ <ol>
1658
+ <li>
1659
+ 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.
1660
+ </li>
1661
+ <li>
1662
+ 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.
1663
+ </li>
1664
+ <li>
1665
+ 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.
1666
+ </li>
1667
+ <li>
1668
+ 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.
1669
+ </li>
1670
+ </ol>
1671
+ </p>
1672
+ <p>
1673
+ If you are creating an IPTC/EXIF mapping rule the details are a bit different.
1674
+ <ol>
1675
+ <li>
1676
+ Open the Settings/Media Library Assistant submenu and select the IPTC/EXIF tab. Scroll down to the "Add a new Field and Mapping Rule" section.
1677
+ </li>
1678
+ <li>
1679
+ 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.
1680
+ </li>
1681
+ <li>
1682
+ In the "EXIF/Template" text box, enter "template:([+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.
1683
+ </li>
1684
+ <li>
1685
+ Set the other parts of the rule as needed. You can select "EXIF" unless you also select an IPTC value and want it to have priority. You can select "Keep" if some of your items already have this information or "Replace" to update all items.
1686
+ </li>
1687
+ </ol>
1688
  </p>
1689
  <a name="mla_custom_field_parameters"></a>
1690
  &nbsp;
1972
  </p>
1973
  <h4>Custom field mapping for metadata fields</h4>
1974
  <p>
1975
+ If you select "<strong>-- Metadata (see below) --</strong>" as the data source you must specify the name of the field you want in the text box below the data source dropdown box. Any of the fields in the <em>_wp_attachment_metadata</em> array may be named, including the new audio/video fields available with WordPress 3.6 and later. For example, "length_formatted" will return the length of a video attachment. You can specify elements within an array with a compound name, e.g., "audio.sample_rate" to get the sampling rate field from the "audio" array of a video attachment. If you simply specify "audio", you will get the values of every array element, e.g., "mp4,ISO/IEC 14496 AAC,48000,2,16,false,stereo".
1976
+ </p>
1977
+ <a name="custom_field_mapping_with_templates"></a>
1978
+ &nbsp;
1979
+ <p>
1980
+ <a href="#backtotop">Go to Top</a>
1981
  </p>
1982
  <h4>Custom field mapping with Content Templates</h4>
1983
  <p>
1992
  </p>
1993
  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, "<code>[+pdf:Keywords+]|[+iptc:2#025+]|none</code>" 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.
1994
  <p>
1995
+ Using a template with the Option Dropdown "Text" or "Single" values will yield a text result. For example, multiple IPTC keywords would be converted into a comma-delimited list as a string. If you combine a template with the "Export", "Array" or "Multi" values the template will deliver an array result if the fields inside the template have multiple values. For example, with "Multi" you can code "<code>([+iptc:2#020<strong>,array</strong>+])([+iptc:2#025<strong>,array</strong>+])</code>" to store each of the IPTC supplemental-category <em><strong>and</strong></em> keywords values (there is no "|" in the template) in a separate custom field value. Note the use of the <strong>,array</strong> formatting option in each field; this is required to get an array result for the field. Also, note that each of the fields is enclosed in parentheses, so the field is suppressed if it contains no values.
1996
+ </p>
1997
+ <p>
1998
+ <strong>CAUTION:</strong> If you use the <code>[+custom:ALL_CUSTOM+]</code> pseudo value in a mapping rule, and you apply the rule more than once, you will see copies of the field you are mapping to in the result. To "clear out" a field you are mapping ALL_CUSTOM into, clear out the text box containing the template, select "Replace" and check the "Delete NULL values" box. Then, click "Map All Attachments"; that will delete the old values and give you a clean start. You'll also see that the template you deleted will be restored after the mapping is complete.
1999
  </p>
2000
  <a name="mla_iptc_exif_mapping"></a>
2001
  &nbsp;
2021
  <dl>
2022
  <dt>Field Title</dt>
2023
  <dd>The standard field title, taxonomy name or Custom Field name. In the Custom Field table you can define a new field by entering its name in the blank box at the bottom of the list; the value will be saved when you click "Save Changes" at the bottom of the screen.
2024
+ <br />&nbsp;<br />
2025
+ You can also use the Custom field mapping section of this screen to define rules for adding or updating elements within the WordPress-supplied "Attachment Metadata", stored in the "_wp_attachment_metadata" custom field. Code the "meta:" prefix in the Field Title textbox to make the destination of the rule an element of the Attachment Metadata; see the <a href="#attachment_metadata_mapping">Adding or changing Attachment Metadata</a> section for more details.
2026
  </dd>
2027
  <dt>IPTC Value</dt>
2028
  <dd>The IPTC (International Press Telecommunications Council) metadata, if any, embedded in the image file. For this category, you can select any of the IPTC DataSet tag and field identifiers, e.g., "2#025" for the Keywords field. The dropdown list has the identifier and the "friendly name" MLA defines for most of the IPTC fields; see the table of identifiers and friendly names in the table below. You can find more information in the <a href="http://www.iptc.org/std/IIM/4.1/specification/IIMV4.1.pdf" title="IPTC-NAA Information Interchange Model Version No. 4.1 specification" target="_blank">IPTC-NAA Information Interchange Model Version No. 4.1 specification</a>.
2063
  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, "<code>[+iptc:2#020+]|[+iptc:2#025+]|none</code>" 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.
2064
  </p>
2065
  <p>
2066
+ 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 "<code>([+iptc:2#020+])([+iptc:2#025+])</code>" 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. Note that each of the fields is enclosed in parentheses, so the field is suppressed if it contains no values.
2067
  </p>
2068
  <p>
2069
  Note that the <strong>,array</strong> formatting option is <strong>not</strong> required to get an array result for the field in a Taxonomy term mapping template; it is assumed. If you want a <strong>text</strong>, <strong>single</strong> or <strong>export</strong> result you can add one of those formatting options to your field specification.
2152
  <td style="padding-right: 10px; vertical-align: top">Second portion of Latitude</td>
2153
  </tr>
2154
  <tr>
2155
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">LatitudeSDM</td>
2156
+ <td style="padding-right: 10px; vertical-align: top">44 7.5669</td>
2157
+ <td style="padding-right: 10px; vertical-align: top">Latitude expressed as degrees and decimal minutes (MinDec),<br />with a leading "-" for Southern values</td>
2158
+ </tr>
2159
+ <tr>
2160
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">LatitudeSDD</td>
2161
+ <td style="padding-right: 10px; vertical-align: top">44.126116</td>
2162
+ <td style="padding-right: 10px; vertical-align: top">Latitude expressed as decimal degrees,<br />with a leading "-" for Southern values</td>
2163
+ </tr>
2164
+ <tr>
2165
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">LatitudeDM</td>
2166
  <td style="padding-right: 10px; vertical-align: top">44 7.5669N</td>
2167
  <td style="padding-right: 10px; vertical-align: top">Latitude expressed as degrees and decimal minutes (MinDec)</td>
2212
  <td style="padding-right: 10px; vertical-align: top">Second portion of Longitude</td>
2213
  </tr>
2214
  <tr>
2215
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">LongitudeSDM</td>
2216
+ <td style="padding-right: 10px; vertical-align: top">145 5.1534</td>
2217
+ <td style="padding-right: 10px; vertical-align: top">Longitude expressed as degrees and decimal minutes (MinDec),<br />with a leading "-" for Western values</td>
2218
+ </tr>
2219
+ <tr>
2220
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">LongitudeSDD</td>
2221
+ <td style="padding-right: 10px; vertical-align: top">145.085890</td>
2222
+ <td style="padding-right: 10px; vertical-align: top">Longitude expressed as decimal degrees,<br />with a leading "-" for Western values</td>
2223
+ </tr>
2224
+ <tr>
2225
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">LongitudeDM</td>
2226
  <td style="padding-right: 10px; vertical-align: top">145 5.1534E</td>
2227
  <td style="padding-right: 10px; vertical-align: top">Longitude expressed as degrees and decimal minutes (MinDec)</td>
2312
  <p>
2313
  <a href="#backtotop">Go to Top</a>
2314
  </p>
2315
+ <h4>IPTC Identifiers and Friendly Names</h4>
2316
  <table>
2317
  <tr><td colspan="3" style="font-weight:bold">Envelope Record</td></tr>
2318
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">model-version</td><td style="padding-right: 10px; vertical-align: top">1#000</td><td style="padding-right: 10px; vertical-align: top">2 octet binary IIM version number</td></tr>
tpls/mla-option-templates.tpl CHANGED
@@ -217,7 +217,7 @@
217
  <!-- template="custom-field-new-field-row" -->
218
  <tr>
219
  <td colspan="[+column_count+]" style="font-weight:bold; height: 3em; vertical-align:bottom">
220
- Add a new Custom Field and Mapping Rule
221
  </td>
222
  </tr>
223
  <tr valign="top">
@@ -524,7 +524,7 @@
524
  <!-- template="iptc-exif-custom-new-field-row" -->
525
  <tr>
526
  <td colspan="[+column_count+]" style="font-weight:bold; height: 3em; vertical-align:bottom">
527
- Add a new Custom Field and Mapping Rule
528
  </td>
529
  </tr>
530
  <tr valign="top">
217
  <!-- template="custom-field-new-field-row" -->
218
  <tr>
219
  <td colspan="[+column_count+]" style="font-weight:bold; height: 3em; vertical-align:bottom">
220
+ Add a new Field and Mapping Rule
221
  </td>
222
  </tr>
223
  <tr valign="top">
524
  <!-- template="iptc-exif-custom-new-field-row" -->
525
  <tr>
526
  <td colspan="[+column_count+]" style="font-weight:bold; height: 3em; vertical-align:bottom">
527
+ Add a new Field and Mapping Rule
528
  </td>
529
  </tr>
530
  <tr valign="top">