Media Library Assistant - Version 0.50

Version Description

  • New: [mla_gallery] shortcode, a superset of the [gallery] shortcode that provides many enhancements. These include taxonomy support and all post_mime_type values (not just images). Media Library items need not be "attached" to the post.
  • New: [mla_gallery] shortcode documentation added to Settings page
  • New: Donate button and link added to Settings page
Download this release

Release Info

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

Code changes from version 0.41 to 0.50

css/mla-style.css CHANGED
@@ -116,3 +116,12 @@ textarea[readonly] {
116
  .bulk-edit-row-attachment fieldset.inline-edit-col-right label.inline-edit-tags span.title {
117
  width: 99%
118
  }
 
 
 
 
 
 
 
 
 
116
  .bulk-edit-row-attachment fieldset.inline-edit-col-right label.inline-edit-tags span.title {
117
  width: 99%
118
  }
119
+
120
+ /*
121
+ * MLA Settings page
122
+ */
123
+
124
+ ul.mla_settings {
125
+ list-style-type: disc;
126
+ list-style-position: inside
127
+ }
includes/class-mla-data.php CHANGED
@@ -34,22 +34,42 @@ class MLAData {
34
  *
35
  * @since 0.1
36
  *
37
- * @param string Complete path and name of the template file
 
38
  *
39
  * @return string|array|false|NULL
40
  * string for files that do not contain template divider comments,
41
  * array for files containing template divider comments,
42
- * false if file does not exist,
43
  * NULL if file could not be loaded.
44
  */
45
- public static function mla_load_template( $filepath ) {
46
- if ( !file_exists( $filepath ) )
47
- return false;
48
-
49
- $template = file_get_contents( $filepath, true );
50
- if ( $template == false ) {
51
- error_log( 'ERROR: mla_load_template file not found ' . var_export( $filepath, true ), 0 );
52
- return NULL;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
53
  }
54
 
55
  $match_count = preg_match_all( '#\<!-- template=".+" --\>#', $template, $matches, PREG_OFFSET_CAPTURE );
34
  *
35
  * @since 0.1
36
  *
37
+ * @param string Complete path and name of the template file, option name or the raw template
38
+ * @param string Type of template source; 'file', 'option', 'string'
39
  *
40
  * @return string|array|false|NULL
41
  * string for files that do not contain template divider comments,
42
  * array for files containing template divider comments,
43
+ * false if file or option does not exist,
44
  * NULL if file could not be loaded.
45
  */
46
+ public static function mla_load_template( $source, $type = 'file' ) {
47
+ switch ( $type ) {
48
+ case 'file':
49
+ if ( !file_exists( $source ) )
50
+ return false;
51
+
52
+ $template = file_get_contents( $source, true );
53
+ if ( $template == false ) {
54
+ error_log( 'ERROR: mla_load_template file not found ' . var_export( $source, true ), 0 );
55
+ return NULL;
56
+ }
57
+ break;
58
+ case 'option':
59
+ $template = MLASettings::mla_get_option( $source );
60
+ if ( $template == false ) {
61
+ return false;
62
+ }
63
+ break;
64
+ case 'string':
65
+ $template = $source;
66
+ if ( empty( $template ) ) {
67
+ return false;
68
+ }
69
+ break;
70
+ default:
71
+ error_log( 'ERROR: mla_load_template bad source type ' . var_export( $type, true ), 0 );
72
+ return NULL;
73
  }
74
 
75
  $match_count = preg_match_all( '#\<!-- template=".+" --\>#', $template, $matches, PREG_OFFSET_CAPTURE );
includes/class-mla-main.php CHANGED
@@ -38,7 +38,7 @@ class MLA {
38
  *
39
  * @var string
40
  */
41
- const CURRENT_MLA_VERSION = '0.41';
42
 
43
  /**
44
  * Minimum version of PHP required for this plugin
38
  *
39
  * @var string
40
  */
41
+ const CURRENT_MLA_VERSION = '0.50';
42
 
43
  /**
44
  * Minimum version of PHP required for this plugin
includes/class-mla-objects.php CHANGED
@@ -96,7 +96,9 @@ class MLAObjects {
96
  add_filter( "manage_edit-{$tax_name}_columns", 'MLAObjects::mla_taxonomy_get_columns_filter', 10, 1 ); // $columns
97
  add_filter( "manage_{$tax_name}_custom_column", 'MLAObjects::mla_taxonomy_column_filter', 10, 3 ); // $place_holder, $column_name, $tag->term_id
98
  }
99
- }
 
 
100
  } // _build_taxonomies
101
 
102
  /**
96
  add_filter( "manage_edit-{$tax_name}_columns", 'MLAObjects::mla_taxonomy_get_columns_filter', 10, 1 ); // $columns
97
  add_filter( "manage_{$tax_name}_custom_column", 'MLAObjects::mla_taxonomy_column_filter', 10, 3 ); // $place_holder, $column_name, $tag->term_id
98
  }
99
+ } // foreach
100
+
101
+ // add_post_type_support( 'attachment', 'custom-fields' ); WP 3.5 experiment - MOVE THIS!
102
  } // _build_taxonomies
103
 
104
  /**
includes/class-mla-settings.php CHANGED
@@ -174,6 +174,7 @@ class MLASettings {
174
  self::$mla_alt_text_view = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
175
  add_action( 'admin_menu', 'MLASettings::mla_admin_menu_action' );
176
  self::_version_upgrade();
 
177
  }
178
 
179
  /**
@@ -213,19 +214,19 @@ class MLASettings {
213
  } // version is less than .30
214
 
215
  self::mla_update_option( self::MLA_VERSION_OPTION, MLA::CURRENT_MLA_VERSION );
216
- self::mla_activation_hook();
217
  }
218
 
219
  /**
220
- * Perform one-time actions on plugin activation
221
  *
222
- * Adds a view to the database to support sorting the listing on 'ALT Text'.
 
223
  *
224
- * @since 0.40
225
  *
226
  * @return void
227
  */
228
- public static function mla_activation_hook( ) {
229
  global $wpdb, $table_prefix;
230
 
231
  $view_name = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
@@ -252,6 +253,19 @@ class MLASettings {
252
  }
253
  }
254
 
 
 
 
 
 
 
 
 
 
 
 
 
 
255
  /**
256
  * Perform one-time actions on plugin deactivation
257
  *
@@ -435,7 +449,8 @@ class MLASettings {
435
  */
436
  $shortcodes = array(
437
  // array("name" => "shortcode", "description" => "This shortcode...")
438
- array( 'name' => 'mla_attachment_list', 'description' => 'renders a complete list of all attachments and references to them.' )
 
439
  );
440
 
441
  $shortcode_list = '';
174
  self::$mla_alt_text_view = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
175
  add_action( 'admin_menu', 'MLASettings::mla_admin_menu_action' );
176
  self::_version_upgrade();
177
+ self::_create_alt_text_view();
178
  }
179
 
180
  /**
214
  } // version is less than .30
215
 
216
  self::mla_update_option( self::MLA_VERSION_OPTION, MLA::CURRENT_MLA_VERSION );
 
217
  }
218
 
219
  /**
220
+ * Add a view to the database to support sorting the listing on 'ALT Text'
221
  *
222
+ * This function is called on each plugin invocation because the plugin upgrade process
223
+ * does not call the activation hook.
224
  *
225
+ * @since 0.50
226
  *
227
  * @return void
228
  */
229
+ private static function _create_alt_text_view( ) {
230
  global $wpdb, $table_prefix;
231
 
232
  $view_name = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
253
  }
254
  }
255
 
256
+ /**
257
+ * Perform one-time actions on plugin activation
258
+ *
259
+ * Adds a view to the database to support sorting the listing on 'ALT Text'.
260
+ *
261
+ * @since 0.40
262
+ *
263
+ * @return void
264
+ */
265
+ public static function mla_activation_hook( ) {
266
+ self::_create_alt_text_view();
267
+ }
268
+
269
  /**
270
  * Perform one-time actions on plugin deactivation
271
  *
449
  */
450
  $shortcodes = array(
451
  // array("name" => "shortcode", "description" => "This shortcode...")
452
+ array( 'name' => 'mla_attachment_list', 'description' => 'renders a complete list of all attachments and references to them.' ),
453
+ array( 'name' => 'mla_gallery', 'description' => 'enhanced version of the WordPress [gallery] shortcode. For complete documentation <a href="#mla_gallery">click here</a>.' )
454
  );
455
 
456
  $shortcode_list = '';
includes/class-mla-shortcodes.php CHANGED
@@ -22,6 +22,7 @@ class MLAShortcodes {
22
  */
23
  public static function initialize() {
24
  add_shortcode( 'mla_attachment_list', 'MLAShortcodes::mla_attachment_list_shortcode' );
 
25
  }
26
 
27
  /**
@@ -120,5 +121,410 @@ class MLAShortcodes {
120
 
121
  echo "<br>----- End of Report -----\r\n";
122
  }
123
- } // Clas MLAShortcodes
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
124
  ?>
22
  */
23
  public static function initialize() {
24
  add_shortcode( 'mla_attachment_list', 'MLAShortcodes::mla_attachment_list_shortcode' );
25
+ add_shortcode( 'mla_gallery', 'MLAShortcodes::mla_gallery_shortcode' );
26
  }
27
 
28
  /**
121
 
122
  echo "<br>----- End of Report -----\r\n";
123
  }
124
+
125
+ /**
126
+ * The MLA Gallery shortcode.
127
+ *
128
+ * This is a superset of the WordPress Gallery shortcode for displaying images on a post,
129
+ * page or custom post type. It is adapted from /wp-includes/media.php gallery_shortcode.
130
+ * Enhancements include many additional selection parameters and full taxonomy support.
131
+ *
132
+ * @since .50
133
+ *
134
+ * @param array $attr Attributes of the shortcode.
135
+ *
136
+ * @return string HTML content to display gallery.
137
+ */
138
+ public static function mla_gallery_shortcode($attr) {
139
+ global $post;
140
+
141
+ static $instance = 0;
142
+ $instance++;
143
+
144
+ $default_arguments = array(
145
+ 'order' => 'ASC', // or 'DESC' or 'RAND'
146
+ 'orderby' => 'menu_order ID',
147
+ 'id' => NULL,
148
+ 'itemtag' => 'dl',
149
+ 'icontag' => 'dt',
150
+ 'captiontag' => 'dd',
151
+ 'link' => 'permalink', // or 'file'
152
+ 'columns' => 3,
153
+ 'size' => 'thumbnail',
154
+ 'ids' => array ( ),
155
+ 'include' => array ( ),
156
+ 'exclude' => array ( ),
157
+ // MLA extensions, from WP_Query
158
+ // Force 'get_children' style query
159
+ 'post_parent' => NULL, // post/page ID or 'current' or 'all'
160
+ // Author
161
+ 'author' => NULL,
162
+ 'author_name' => '',
163
+ // Category
164
+ 'cat' => 0,
165
+ 'category_name' => '',
166
+ 'category__and' => array ( ),
167
+ 'category__in' => array ( ),
168
+ 'category__not_in' => array ( ),
169
+ // Tag
170
+ 'tag' => '',
171
+ 'tag_id' => 0,
172
+ 'tag__and' => array ( ),
173
+ 'tag__in' => array ( ),
174
+ 'tag__not_in' => array ( ),
175
+ 'tag_slug__and' => array ( ),
176
+ 'tag_slug__in' => array ( ),
177
+ // Taxonomy parameters are handled separately
178
+ // {tax_slug} => 'term' | array ( 'term, 'term, ... )
179
+ // 'tax_query' => ''
180
+ // Post
181
+ 'post_type' => 'attachment',
182
+ 'post_status' => 'inherit',
183
+ 'post_mime_type' => 'image',
184
+ // Pagination - no default for most of these
185
+ 'nopaging' => true,
186
+ 'posts_per_page' => 0,
187
+ 'posts_per_archive_page' => 0,
188
+ 'paged' => NULL, // page number or 'current'
189
+ 'offset' => NULL,
190
+ // TBD Time
191
+ // Custom Field
192
+ 'meta_key' => '',
193
+ 'meta_value' => '',
194
+ 'meta_value_num' => NULL,
195
+ 'meta_compare' => '',
196
+ 'meta_query' => '',
197
+ // Search
198
+ 's' => ''
199
+ );
200
+
201
+ /*
202
+ * Merge input arguments with defaults, then extract the query arguments.
203
+ * $query_arguments has been initialized in the taxonomy code above.
204
+ */
205
+
206
+ $arguments = shortcode_atts( $default_arguments, $attr );
207
+
208
+ if ( 'RAND' == $arguments['order'] )
209
+ $arguments['orderby'] = 'none';
210
+
211
+ if ( !empty( $arguments['ids'] ) ) {
212
+ // 'ids' is explicitly ordered
213
+ $arguments['orderby'] = 'post__in';
214
+ $arguments['include'] = $arguments['ids'];
215
+ }
216
+ unset( $arguments['ids'] );
217
+
218
+ /*
219
+ * Extract taxonomy arguments
220
+ */
221
+ $taxonomies = get_taxonomies( array ( 'show_ui' => 'true' ), 'names' ); // 'objects'
222
+ $query_arguments = array ( );
223
+ if ( ! empty( $attr ) ) {
224
+ foreach ( $attr as $key => $value ) {
225
+ if ( 'tax_query' == $key ) {
226
+ if ( is_array( $value ) )
227
+ $query_arguments[ $key ] = $value;
228
+ else {
229
+ $function = @create_function('', 'return ' . $value . ';' );
230
+
231
+ if ( is_callable( $function ) )
232
+ $query_arguments[ $key ] = $function();
233
+ else
234
+ return '<p>ERROR: invalid mla_gallery tax_query = ' . var_export( $value, true ) . '</p>';
235
+ } // not array
236
+ } // tax_query
237
+ elseif ( array_key_exists( $key, $taxonomies ) ) {
238
+ $query_arguments[ $key ] = implode(',', array_filter( array_map( 'trim', explode( ",", $value ) ) ) );
239
+ } // array_key_exists
240
+ } //foreach $attr
241
+ } // ! empty
242
+
243
+ // We're trusting author input, but let's at least make sure it looks like a valid orderby statement
244
+ if ( isset( $arguments['orderby'] ) ) {
245
+ $attr['orderby'] = sanitize_sql_orderby( $arguments['orderby'] );
246
+ if ( ! $arguments['orderby'] )
247
+ unset( $arguments['orderby'] );
248
+ }
249
+
250
+ $use_children = empty( $query_arguments );
251
+ foreach ($arguments as $key => $value ) {
252
+ /*
253
+ * There are several "fallthru" cases in this switch statement that decide
254
+ * whether or not to limit the query to children of a specific post.
255
+ */
256
+ $children_ok = true;
257
+ switch ( $key ) {
258
+ case 'post_parent':
259
+ if ( 'current' == strtolower( $value ) )
260
+ $value = $post->ID;
261
+ elseif ( 'all' == strtolower( $value ) ) {
262
+ $value = NULL;
263
+ $use_children = false;
264
+ }
265
+ // fallthru
266
+ case 'id':
267
+ case 'posts_per_page':
268
+ case 'posts_per_archive_page':
269
+ if ( is_numeric( $value ) ) {
270
+ $value = intval( $value );
271
+ if ( ! empty( $value ) ) {
272
+ $query_arguments[ $key ] = $value;
273
+ if ( ! $children_ok )
274
+ $use_children = false;
275
+ }
276
+ }
277
+ unset( $arguments[ $key ] );
278
+ break;
279
+ case 'meta_value_num':
280
+ $children_ok = false;
281
+ // fallthru
282
+ case 'offset':
283
+ if ( is_numeric( $value ) ) {
284
+ $query_arguments[ $key ] = intval( $value );
285
+ if ( ! $children_ok )
286
+ $use_children = false;
287
+ }
288
+ unset( $arguments[ $key ] );
289
+ break;
290
+ case 'paged':
291
+ if ( 'current' == strtolower( $value ) )
292
+ $query_arguments[ $key ] = (get_query_var('paged')) ? get_query_var('paged') : 1;
293
+ elseif ( is_numeric( $value ) )
294
+ $query_arguments[ $key ] = intval( $value );
295
+ unset( $arguments[ $key ] );
296
+ break;
297
+ case 'author':
298
+ case 'cat':
299
+ case 'tag_id':
300
+ if ( ! empty( $value ) ) {
301
+ if ( is_array( $value ) )
302
+ $query_arguments[ $key ] = array_filter( $value );
303
+ else
304
+ $query_arguments[ $key ] = array_filter( array_map( 'intval', explode( ",", $value ) ) );
305
+
306
+ if ( 1 == count( $query_arguments[ $key ] ) )
307
+ $query_arguments[ $key ] = $query_arguments[ $key ][0];
308
+ else
309
+ $query_arguments[ $key ] = implode(',', $query_arguments[ $key ] );
310
+
311
+ $use_children = false;
312
+ }
313
+ unset( $arguments[ $key ] );
314
+ break;
315
+ case 'category__and':
316
+ case 'category__in':
317
+ case 'category__not_in':
318
+ case 'tag__and':
319
+ case 'tag__in':
320
+ case 'tag__not_in':
321
+ $children_ok = false;
322
+ // fallthru
323
+ case 'include':
324
+ case 'exclude':
325
+ if ( ! empty( $value ) ) {
326
+ if ( is_array( $value ) )
327
+ $query_arguments[ $key ] = array_filter( $value );
328
+ else
329
+ $query_arguments[ $key ] = array_filter( array_map( 'intval', explode( ",", $value ) ) );
330
+
331
+ if ( ! $children_ok )
332
+ $use_children = false;
333
+ }
334
+ unset( $arguments[ $key ] );
335
+ break;
336
+ case 'tag_slug__and':
337
+ case 'tag_slug__in':
338
+ if ( ! empty( $value ) ) {
339
+ if ( is_array( $value ) )
340
+ $query_arguments[ $key ] = $value;
341
+ else
342
+ $query_arguments[ $key ] = array_filter( array_map( 'trim', explode( ",", $value ) ) );
343
+
344
+ $use_children = false;
345
+ }
346
+ unset( $arguments[ $key ] );
347
+ break;
348
+ case 'nopaging': // boolean
349
+ if ( ! empty( $value ) && ( 'false' != strtolower( $value ) ) )
350
+ $query_arguments[ $key ] = true;
351
+ unset( $arguments[ $key ] );
352
+ break;
353
+ case 'author_name':
354
+ case 'category_name':
355
+ case 'tag':
356
+ case 'meta_key':
357
+ case 'meta_value':
358
+ case 'meta_compare':
359
+ case 's':
360
+ $children_ok = false;
361
+ // fallthru
362
+ case 'post_type':
363
+ case 'post_status':
364
+ case 'post_mime_type':
365
+ case 'order':
366
+ case 'orderby':
367
+ if ( ! empty( $value ) ) {
368
+ $query_arguments[ $key ] = $value;
369
+
370
+ if ( ! $children_ok )
371
+ $use_children = false;
372
+ }
373
+ unset( $arguments[ $key ] );
374
+ break;
375
+ case 'meta_query':
376
+ if ( ! empty( $value ) ) {
377
+ if ( is_array( $value ) )
378
+ $query_arguments[ $key ] = $value;
379
+ else {
380
+ $function = @create_function('', 'return ' . $value . ';' );
381
+
382
+ if ( is_callable( $function ) )
383
+ $query_arguments[ $key ] = $function();
384
+ else
385
+ return '<p>ERROR: invalid mla_gallery meta_query = ' . var_export( $value, true ) . '</p>';
386
+ } // not array
387
+
388
+ $use_children = false;
389
+ }
390
+ unset( $arguments[ $key ] );
391
+ break;
392
+ default:
393
+ // ignore anything else
394
+ } // switch $key
395
+ } // foreach $arguments
396
+
397
+ /*
398
+ * Decide whether to use a "get_children" style query
399
+ */
400
+ if ( $use_children && empty( $query_arguments['post_parent'] ) ) {
401
+ if ( empty( $query_arguments['id'] ) )
402
+ $query_arguments['post_parent'] = $post->ID;
403
+ else
404
+ $query_arguments['post_parent'] = $query_arguments['id'];
405
+
406
+ unset( $query_arguments['id'] );
407
+ }
408
+
409
+ if ( isset( $query_arguments['posts_per_page'] ) || isset( $query_arguments['posts_per_archive_page'] ) ||
410
+ isset( $query_arguments['paged'] ) || isset( $query_arguments['offset'] ) ) {
411
+ unset ($query_arguments['nopaging'] );
412
+ }
413
+
414
+ if ( isset( $query_arguments['orderby'] ) && ('rand' == $query_arguments['orderby'] ) )
415
+ unset ($query_arguments['order'] );
416
+
417
+ if ( isset( $query_arguments['order'] ) && ('rand' == $query_arguments['order'] ) )
418
+ unset ($query_arguments['orderby'] );
419
+
420
+ if ( isset( $query_arguments['post_mime_type'] ) && ('all' == strtolower( $query_arguments['post_mime_type'] ) ) )
421
+ unset ($query_arguments['post_mime_type'] );
422
+
423
+ $attachments = self::_get_attachments( $query_arguments );
424
+ if ( empty($attachments) )
425
+ return '';
426
+
427
+ if ( is_feed() ) {
428
+ $output = "\n";
429
+ foreach ( $attachments as $att_id => $attachment )
430
+ $output .= wp_get_attachment_link($att_id, $arguments['size'], true) . "\n";
431
+ return $output;
432
+ }
433
+
434
+ $id = $post->ID;
435
+ $itemtag = tag_escape( $arguments['itemtag'] );
436
+ $icontag = tag_escape( $arguments['icontag'] );
437
+ $captiontag = tag_escape( $arguments['captiontag'] );
438
+ $columns = intval( $arguments['columns']);
439
+ $itemwidth = $columns > 0 ? floor(100/$columns) : 100;
440
+ $float = is_rtl() ? 'right' : 'left';
441
+
442
+ $size = $arguments['size'];
443
+ if ( 'icon' == strtolower( $size) ) {
444
+ $size = array( 60, 60 );
445
+ $show_icon = true;
446
+ }
447
+ else
448
+ $show_icon = false;
449
+
450
+ $selector = "gallery-{$instance}";
451
+
452
+ $gallery_style = $gallery_div = '';
453
+ if ( apply_filters( 'use_default_gallery_style', true ) )
454
+ $gallery_style = "
455
+ <style type='text/css'>
456
+ #{$selector} {
457
+ margin: auto;
458
+ }
459
+ #{$selector} .gallery-item {
460
+ float: {$float};
461
+ margin-top: 10px;
462
+ text-align: center;
463
+ width: {$itemwidth}%;
464
+ }
465
+ #{$selector} img {
466
+ border: 2px solid #cfcfcf;
467
+ }
468
+ #{$selector} .gallery-caption {
469
+ margin-left: 0;
470
+ }
471
+ </style>
472
+ <!-- see gallery_shortcode() in wp-includes/media.php -->";
473
+ $size_class = sanitize_html_class( $size );
474
+ $gallery_div = "<div id='$selector' class='gallery galleryid-{$id} gallery-columns-{$columns} gallery-size-{$size_class}'>";
475
+ $output = apply_filters( 'gallery_style', $gallery_style . "\n\t\t" . $gallery_div );
476
+
477
+ $i = 0;
478
+ foreach ( $attachments as $id => $attachment ) {
479
+ $link = isset($arguments['link']) && 'file' == $arguments['link'] ? wp_get_attachment_link($attachment->ID, $size, false, $show_icon) : wp_get_attachment_link($attachment->ID, $size, true, $show_icon);
480
+
481
+ $output .= "<{$itemtag} class='gallery-item'>";
482
+ $output .= "
483
+ <{$icontag} class='gallery-icon'>
484
+ $link
485
+ </{$icontag}>";
486
+ $post_excerpt = esc_attr( trim( $attachment->post_excerpt ) );
487
+ if ( $captiontag && ! empty( $post_excerpt ) ) {
488
+ $output .= "
489
+ <{$captiontag} class='wp-caption-text gallery-caption'>
490
+ " . wptexturize($post_excerpt) . "
491
+ </{$captiontag}>";
492
+ }
493
+ $output .= "</{$itemtag}>";
494
+ if ( $columns > 0 && ++$i % $columns == 0 )
495
+ $output .= '<br style="clear: both" />';
496
+ }
497
+
498
+ $output .= "
499
+ <br style='clear: both;' />
500
+ </div>\n";
501
+
502
+ return $output;
503
+ }
504
+
505
+ /**
506
+ * Replaces /wp-includes/post.php function get_posts()
507
+ *
508
+ * @since .50
509
+ *
510
+ * @param array Attributes of the shortcode
511
+ *
512
+ * @return array List of attachments returned from WP_Query
513
+ */
514
+ private static function _get_attachments( $args ) {
515
+ if ( ! empty($args['include']) ) {
516
+ $incposts = wp_parse_id_list( $args['include'] );
517
+ $args['posts_per_page'] = count($incposts); // only the number of posts included
518
+ $args['post__in'] = $incposts;
519
+ } elseif ( ! empty($args['exclude']) )
520
+ $args['post__not_in'] = wp_parse_id_list( $args['exclude'] );
521
+
522
+ $args['ignore_sticky_posts'] = true;
523
+ $args['no_found_rows'] = true;
524
+
525
+ $get_posts = new WP_Query;
526
+ return $get_posts->query($args);
527
+
528
+ }
529
+ } // Class MLAShortcodes
530
  ?>
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 0.41
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: Provides several enhancements to the handling of images and files held in the WordPress Media Library.
16
  Author: David Lingren
17
- Version: 0.41
18
  Author URI: http://fairtradejudaica.org/our-story/staff/
19
  */
20
 
6
  * will the rest of the plugin be loaded and run.
7
  *
8
  * @package Media Library Assistant
9
+ * @version 0.50
10
  */
11
 
12
  /*
14
  Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
15
  Description: Provides several enhancements to the handling of images and files held in the WordPress Media Library.
16
  Author: David Lingren
17
+ Version: 0.50
18
  Author URI: http://fairtradejudaica.org/our-story/staff/
19
  */
20
 
phpDocs/classes/MLA.html CHANGED
@@ -725,7 +725,7 @@ for a single attachment.</h2>
725
  <div class="row"><footer class="span12">
726
  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>
727
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
728
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
729
  </div>
730
  </body>
731
  </html>
725
  <div class="row"><footer class="span12">
726
  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>
727
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
728
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
729
  </div>
730
  </body>
731
  </html>
phpDocs/classes/MLAData.html CHANGED
@@ -178,7 +178,7 @@ the posts and postmeta tables, and all references to the attachment.</p></p>
178
  </div>
179
  <a name="mla_load_template" id="mla_load_template"></a><div class="element clickable method public mla_load_template" data-toggle="collapse" data-target=".mla_load_template .collapse">
180
  <h2>Load an HTML template from a file</h2>
181
- <pre>mla_load_template(string $filepath) : string | array | false | NULL</pre>
182
  <div class="labels"></div>
183
  <div class="row collapse"><div class="detail-description">
184
  <p class="long_description"><p>Loads a template to a string or a multi-part template to an array.
@@ -190,11 +190,15 @@ where "key" becomes the key part of the array.</p></p>
190
  </tr></table>
191
  <h3>Parameters</h3>
192
  <div class="subelement argument">
193
- <h4>$filepath</h4>
194
- <code>string</code><p>Complete path and name of the template file</p></div>
 
 
 
 
195
  <h3>Returns</h3>
196
  <div class="subelement response">
197
- <code>string</code><code>array</code><code>false</code><code>NULL</code>string for files that do not contain template divider comments, array for files containing template divider comments, false if file does not exist, NULL if file could not be loaded.</div>
198
  </div></div>
199
  </div>
200
  <a name="mla_parse_template" id="mla_parse_template"></a><div class="element clickable method public mla_parse_template" data-toggle="collapse" data-target=".mla_parse_template .collapse">
@@ -419,7 +423,7 @@ any further logic required to translate those values is contained in the filters
419
  <div class="row"><footer class="span12">
420
  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>
421
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
422
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
423
  </div>
424
  </body>
425
  </html>
178
  </div>
179
  <a name="mla_load_template" id="mla_load_template"></a><div class="element clickable method public mla_load_template" data-toggle="collapse" data-target=".mla_load_template .collapse">
180
  <h2>Load an HTML template from a file</h2>
181
+ <pre>mla_load_template(string $source, string $type) : string | array | false | NULL</pre>
182
  <div class="labels"></div>
183
  <div class="row collapse"><div class="detail-description">
184
  <p class="long_description"><p>Loads a template to a string or a multi-part template to an array.
190
  </tr></table>
191
  <h3>Parameters</h3>
192
  <div class="subelement argument">
193
+ <h4>$source</h4>
194
+ <code>string</code><p>Complete path and name of the template file, option name or the raw template</p></div>
195
+ <div class="subelement argument">
196
+ <h4>$type</h4>
197
+ <code>string</code><p>Type of template source; 'file', 'option', 'string'</p>
198
+ </div>
199
  <h3>Returns</h3>
200
  <div class="subelement response">
201
+ <code>string</code><code>array</code><code>false</code><code>NULL</code>string for files that do not contain template divider comments, array for files containing template divider comments, false if file or option does not exist, NULL if file could not be loaded.</div>
202
  </div></div>
203
  </div>
204
  <a name="mla_parse_template" id="mla_parse_template"></a><div class="element clickable method public mla_parse_template" data-toggle="collapse" data-target=".mla_parse_template .collapse">
423
  <div class="row"><footer class="span12">
424
  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>
425
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
426
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
427
  </div>
428
  </body>
429
  </html>
phpDocs/classes/MLAObjects.html CHANGED
@@ -167,7 +167,7 @@ which replaces the "Posts" column with an equivalent "Attachments" column.</h2>
167
  <div class="row"><footer class="span12">
168
  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>
169
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
170
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
171
  </div>
172
  </body>
173
  </html>
167
  <div class="row"><footer class="span12">
168
  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>
169
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
170
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
171
  </div>
172
  </body>
173
  </html>
phpDocs/classes/MLASettings.html CHANGED
@@ -67,6 +67,7 @@ settings are being updated or reset."><span class="description">Determine MLA su
67
  settings are being updated or reset.</span><pre>mla_taxonomy_support()</pre></a></li>
68
  <li class="method public "><a href="#mla_update_option" title="mla_update_option :: Add or update the stored value of a defined MLA option"><span class="description">Add or update the stored value of a defined MLA option</span><pre>mla_update_option()</pre></a></li>
69
  <li class="nav-header private">» Private</li>
 
70
  <li class="method private "><a href="#_reset_settings" title="_reset_settings :: Delete saved settings, restoring default values"><span class="description">Delete saved settings, restoring default values</span><pre>_reset_settings()</pre></a></li>
71
  <li class="method private "><a href="#_save_settings" title="_save_settings :: Save settings to the options table"><span class="description">Save settings to the options table</span><pre>_save_settings()</pre></a></li>
72
  <li class="method private "><a href="#_taxonomy_handler" title="_taxonomy_handler :: Render and manage other taxonomy support options, e.g., Categories and Post Tags"><span class="description">Render and manage other taxonomy support options, e.g., Categories and Post Tags</span><pre>_taxonomy_handler()</pre></a></li>
@@ -278,6 +279,19 @@ settings are being updated or reset.</h2>
278
  <code>boolean</code>True if the value was changed or false if the update failed</div>
279
  </div></div>
280
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
281
  <a name="_reset_settings" id="_reset_settings"></a><div class="element clickable method private _reset_settings" data-toggle="collapse" data-target="._reset_settings .collapse">
282
  <h2>Delete saved settings, restoring default values</h2>
283
  <pre>_reset_settings(array $template_array) : array</pre>
@@ -428,7 +442,7 @@ reset => reset function for 'custom' options; returns nothing. Usage:
428
  <div class="row"><footer class="span12">
429
  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>
430
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
431
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
432
  </div>
433
  </body>
434
  </html>
67
  settings are being updated or reset.</span><pre>mla_taxonomy_support()</pre></a></li>
68
  <li class="method public "><a href="#mla_update_option" title="mla_update_option :: Add or update the stored value of a defined MLA option"><span class="description">Add or update the stored value of a defined MLA option</span><pre>mla_update_option()</pre></a></li>
69
  <li class="nav-header private">» Private</li>
70
+ <li class="method private "><a href="#_create_alt_text_view" title="_create_alt_text_view :: Add a view to the database to support sorting the listing on 'ALT Text'"><span class="description">Add a view to the database to support sorting the listing on 'ALT Text'</span><pre>_create_alt_text_view()</pre></a></li>
71
  <li class="method private "><a href="#_reset_settings" title="_reset_settings :: Delete saved settings, restoring default values"><span class="description">Delete saved settings, restoring default values</span><pre>_reset_settings()</pre></a></li>
72
  <li class="method private "><a href="#_save_settings" title="_save_settings :: Save settings to the options table"><span class="description">Save settings to the options table</span><pre>_save_settings()</pre></a></li>
73
  <li class="method private "><a href="#_taxonomy_handler" title="_taxonomy_handler :: Render and manage other taxonomy support options, e.g., Categories and Post Tags"><span class="description">Render and manage other taxonomy support options, e.g., Categories and Post Tags</span><pre>_taxonomy_handler()</pre></a></li>
279
  <code>boolean</code>True if the value was changed or false if the update failed</div>
280
  </div></div>
281
  </div>
282
+ <a name="_create_alt_text_view" id="_create_alt_text_view"></a><div class="element clickable method private _create_alt_text_view" data-toggle="collapse" data-target="._create_alt_text_view .collapse">
283
+ <h2>Add a view to the database to support sorting the listing on 'ALT Text'</h2>
284
+ <pre>_create_alt_text_view() : void</pre>
285
+ <div class="labels"></div>
286
+ <div class="row collapse"><div class="detail-description">
287
+ <p class="long_description"><p>This function is called on each plugin invocation because the plugin upgrade process
288
+ does not call the activation hook.</p></p>
289
+ <table class="table table-bordered"><tr>
290
+ <th>since</th>
291
+ <td>0.50</td>
292
+ </tr></table>
293
+ </div></div>
294
+ </div>
295
  <a name="_reset_settings" id="_reset_settings"></a><div class="element clickable method private _reset_settings" data-toggle="collapse" data-target="._reset_settings .collapse">
296
  <h2>Delete saved settings, restoring default values</h2>
297
  <pre>_reset_settings(array $template_array) : array</pre>
442
  <div class="row"><footer class="span12">
443
  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>
444
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
445
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
446
  </div>
447
  </body>
448
  </html>
phpDocs/classes/MLAShortcodes.html CHANGED
@@ -54,6 +54,9 @@
54
  <i class="icon-custom icon-method"></i> Methods</li>
55
  <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>
56
  <li class="method public "><a href="#mla_attachment_list_shortcode" title="mla_attachment_list_shortcode :: WordPress Shortcode; renders a complete list of all attachments and references to them"><span class="description">WordPress Shortcode; renders a complete list of all attachments and references to them</span><pre>mla_attachment_list_shortcode()</pre></a></li>
 
 
 
57
  </ul>
58
  </div>
59
  <div class="span8">
@@ -106,6 +109,46 @@
106
  </tr></table>
107
  </div></div>
108
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
109
  </div>
110
  </div>
111
  </div>
@@ -113,7 +156,7 @@
113
  <div class="row"><footer class="span12">
114
  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>
115
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
116
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
117
  </div>
118
  </body>
119
  </html>
54
  <i class="icon-custom icon-method"></i> Methods</li>
55
  <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>
56
  <li class="method public "><a href="#mla_attachment_list_shortcode" title="mla_attachment_list_shortcode :: WordPress Shortcode; renders a complete list of all attachments and references to them"><span class="description">WordPress Shortcode; renders a complete list of all attachments and references to them</span><pre>mla_attachment_list_shortcode()</pre></a></li>
57
+ <li class="method public "><a href="#mla_gallery_shortcode" title="mla_gallery_shortcode :: The MLA Gallery shortcode."><span class="description">The MLA Gallery shortcode.</span><pre>mla_gallery_shortcode()</pre></a></li>
58
+ <li class="nav-header private">» Private</li>
59
+ <li class="method private "><a href="#_get_attachments" title="_get_attachments :: Replaces /wp-includes/post.php function get_posts()"><span class="description">Replaces /wp-includes/post.php function get_posts()</span><pre>_get_attachments()</pre></a></li>
60
  </ul>
61
  </div>
62
  <div class="span8">
109
  </tr></table>
110
  </div></div>
111
  </div>
112
+ <a name="mla_gallery_shortcode" id="mla_gallery_shortcode"></a><div class="element clickable method public mla_gallery_shortcode" data-toggle="collapse" data-target=".mla_gallery_shortcode .collapse">
113
+ <h2>The MLA Gallery shortcode.</h2>
114
+ <pre>mla_gallery_shortcode(array $attr) : string</pre>
115
+ <div class="labels"></div>
116
+ <div class="row collapse"><div class="detail-description">
117
+ <p class="long_description"><p>This is a superset of the WordPress Gallery shortcode for displaying images on a post,
118
+ page or custom post type. It is adapted from /wp-includes/media.php gallery_shortcode.
119
+ Enhancements include many additional selection parameters and full taxonomy support.</p></p>
120
+ <table class="table table-bordered"><tr>
121
+ <th>since</th>
122
+ <td>.50</td>
123
+ </tr></table>
124
+ <h3>Parameters</h3>
125
+ <div class="subelement argument">
126
+ <h4>$attr</h4>
127
+ <code>array</code><p>Attributes of the shortcode.</p></div>
128
+ <h3>Returns</h3>
129
+ <div class="subelement response">
130
+ <code>string</code>HTML content to display gallery.</div>
131
+ </div></div>
132
+ </div>
133
+ <a name="_get_attachments" id="_get_attachments"></a><div class="element clickable method private _get_attachments" data-toggle="collapse" data-target="._get_attachments .collapse">
134
+ <h2>Replaces /wp-includes/post.php function get_posts()</h2>
135
+ <pre>_get_attachments(array $args) : array</pre>
136
+ <div class="labels"></div>
137
+ <div class="row collapse"><div class="detail-description">
138
+ <p class="long_description"></p>
139
+ <table class="table table-bordered"><tr>
140
+ <th>since</th>
141
+ <td>.50</td>
142
+ </tr></table>
143
+ <h3>Parameters</h3>
144
+ <div class="subelement argument">
145
+ <h4>$args</h4>
146
+ <code>array</code><p>Attributes of the shortcode</p></div>
147
+ <h3>Returns</h3>
148
+ <div class="subelement response">
149
+ <code>array</code>List of attachments returned from WP_Query</div>
150
+ </div></div>
151
+ </div>
152
  </div>
153
  </div>
154
  </div>
156
  <div class="row"><footer class="span12">
157
  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>
158
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
159
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
160
  </div>
161
  </body>
162
  </html>
phpDocs/classes/MLATest.html CHANGED
@@ -130,7 +130,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
130
  <div class="row"><footer class="span12">
131
  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>
132
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
133
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
134
  </div>
135
  </body>
136
  </html>
130
  <div class="row"><footer class="span12">
131
  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>
132
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
133
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
134
  </div>
135
  </body>
136
  </html>
phpDocs/classes/MLA_List_Table.html CHANGED
@@ -923,7 +923,7 @@ sorted by that column. This is computed each time the table is displayed.</p></p
923
  <div class="row"><footer class="span12">
924
  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>
925
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
926
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
927
  </div>
928
  </body>
929
  </html>
923
  <div class="row"><footer class="span12">
924
  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>
925
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
926
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
927
  </div>
928
  </body>
929
  </html>
phpDocs/deprecated.html CHANGED
@@ -62,7 +62,7 @@
62
  <div class="row"><footer class="span12">
63
  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>
64
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
65
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
66
  </div>
67
  </body>
68
  </html>
62
  <div class="row"><footer class="span12">
63
  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>
64
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
65
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
66
  </div>
67
  </body>
68
  </html>
phpDocs/errors.html CHANGED
@@ -74,7 +74,7 @@
74
  <div class="row"><footer class="span12">
75
  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>
76
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
77
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
78
  </div>
79
  </body>
80
  </html>
74
  <div class="row"><footer class="span12">
75
  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>
76
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
77
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
78
  </div>
79
  </body>
80
  </html>
phpDocs/graph_class.html CHANGED
@@ -59,7 +59,7 @@
59
  </script><div class="row"><footer class="span12">
60
  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>
61
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
62
- generated on 2012-10-02T19:39:46-07:00.<br></footer></div>
63
  </div>
64
  </body>
65
  </html>
59
  </script><div class="row"><footer class="span12">
60
  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>
61
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
62
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
63
  </div>
64
  </body>
65
  </html>
phpDocs/index.html CHANGED
@@ -79,7 +79,7 @@
79
  <div class="row"><footer class="span12">
80
  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>
81
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
82
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
83
  </div>
84
  </body>
85
  </html>
79
  <div class="row"><footer class="span12">
80
  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>
81
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
82
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
83
  </div>
84
  </body>
85
  </html>
phpDocs/markers.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 2012-10-02T19:39:45-07:00.<br></footer></div>
68
  </div>
69
  </body>
70
  </html>
64
  <div class="row"><footer class="span12">
65
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
66
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
67
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
68
  </div>
69
  </body>
70
  </html>
phpDocs/namespaces/global.html CHANGED
@@ -159,7 +159,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
159
  <div class="row"><footer class="span12">
160
  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>
161
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
162
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
163
  </div>
164
  </body>
165
  </html>
159
  <div class="row"><footer class="span12">
160
  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>
161
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
162
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
163
  </div>
164
  </body>
165
  </html>
phpDocs/packages/Media Library Assistant.html CHANGED
@@ -179,7 +179,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
179
  <div class="row"><footer class="span12">
180
  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>
181
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
182
- generated on 2012-10-02T19:39:45-07:00.<br></footer></div>
183
  </div>
184
  </body>
185
  </html>
179
  <div class="row"><footer class="span12">
180
  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>
181
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
182
+ generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
183
  </div>
184
  </body>
185
  </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="819357cd3db399fcf174acb513026794" 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>
@@ -18,16 +18,16 @@ Templates separate HTML markup from PHP code for easier maintenance and localiza
18
  <tag line="9" name="package" description="Media Library Assistant"/>
19
  <tag line="9" name="since" description="0.1"/>
20
  </docblock>
21
- <property final="false" static="true" visibility="private" line="202" namespace="global" package="Media Library Assistant">
22
  <name>$query_parameters</name>
23
  <default><![CDATA[array()]]></default>
24
- <docblock line="191">
25
  <description><![CDATA[WP_Query filter "parameters"]]></description>
26
  <long-description><![CDATA[<p>This array defines parameters for the query's join, where and orderby filters.
27
  The parameters are set up in the _prepare_list_table_query function, and
28
  any further logic required to translate those values is contained in the filters.</p>]]></long-description>
29
- <tag line="191" name="since" description="0.30"/>
30
- <tag line="191" name="var" description="" type="array">
31
  <type by_reference="false">array</type>
32
  </tag>
33
  </docblock>
@@ -41,7 +41,7 @@ any further logic required to translate those values is contained in the filters
41
  <tag line="19" name="since" description="0.1"/>
42
  </docblock>
43
  </method>
44
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="45" package="Media Library Assistant">
45
  <name>mla_load_template</name>
46
  <full_name>mla_load_template</full_name>
47
  <docblock line="28">
@@ -50,314 +50,322 @@ any further logic required to translate those values is contained in the filters
50
  Multi-part templates are divided by comments of the form <!-- template="key" -->,
51
  where "key" becomes the key part of the array.</p>]]></long-description>
52
  <tag line="28" name="since" description="0.1"/>
53
- <tag line="28" name="param" description="Complete path and name of the template file" type="string" variable="$filepath">
54
  <type by_reference="false">string</type>
55
  </tag>
56
- <tag line="28" name="return" description="string for files that do not contain template divider comments, array for files containing template divider comments, false if file does not exist, NULL if file could not be loaded." type="string|array|false|NULL">
 
 
 
57
  <type by_reference="false">string</type>
58
  <type by_reference="false">array</type>
59
  <type by_reference="false">false</type>
60
  <type by_reference="false">NULL</type>
61
  </tag>
62
  </docblock>
63
- <argument line="45">
64
- <name>$filepath</name>
65
  <default><![CDATA[]]></default>
66
  <type/>
67
  </argument>
 
 
 
 
 
68
  </method>
69
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="121" package="Media Library Assistant">
70
  <name>mla_parse_template</name>
71
  <full_name>mla_parse_template</full_name>
72
- <docblock line="109">
73
  <description><![CDATA[Expand a template, replacing place holders with their values]]></description>
74
  <long-description><![CDATA[<p>A simple parsing function for basic templating.</p>]]></long-description>
75
- <tag line="109" name="since" description="0.1"/>
76
- <tag line="109" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
77
  <type by_reference="false">string</type>
78
  </tag>
79
- <tag line="109" name="param" description="An associative array containing keys and values e.g. array('key' =&gt; 'value')" type="array" variable="$hash">
80
  <type by_reference="false">array</type>
81
  </tag>
82
- <tag line="109" name="return" description="Placeholders corresponding to the keys of the hash will be replaced with their values" type="string">
83
  <type by_reference="false">string</type>
84
  </tag>
85
  </docblock>
86
- <argument line="121">
87
  <name>$tpl</name>
88
  <default><![CDATA[]]></default>
89
  <type/>
90
  </argument>
91
- <argument line="121">
92
  <name>$hash</name>
93
  <default><![CDATA[]]></default>
94
  <type/>
95
  </argument>
96
  </method>
97
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="139" package="Media Library Assistant">
98
  <name>mla_count_list_table_items</name>
99
  <full_name>mla_count_list_table_items</full_name>
100
- <docblock line="130">
101
  <description><![CDATA[Get the total number of attachment posts]]></description>
102
  <long-description><![CDATA[]]></long-description>
103
- <tag line="130" name="since" description="0.30"/>
104
- <tag line="130" name="param" description="Query variables, e.g., from $_REQUEST" type="array" variable="$request">
105
  <type by_reference="false">array</type>
106
  </tag>
107
- <tag line="130" name="return" description="Number of attachment posts" type="integer">
108
  <type by_reference="false">integer</type>
109
  </tag>
110
  </docblock>
111
- <argument line="139">
112
  <name>$request</name>
113
  <default><![CDATA[]]></default>
114
  <type/>
115
  </argument>
116
  </method>
117
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="160" package="Media Library Assistant">
118
  <name>mla_query_list_table_items</name>
119
  <full_name>mla_query_list_table_items</full_name>
120
- <docblock line="146">
121
  <description><![CDATA[Retrieve attachment objects for list table display]]></description>
122
  <long-description><![CDATA[<p>Supports prepare_items in class-mla-list-table.php.
123
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
124
- <tag line="146" name="since" description="0.1"/>
125
- <tag line="146" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
126
  <type by_reference="false">array</type>
127
  </tag>
128
- <tag line="146" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
129
  <type by_reference="false">int</type>
130
  </tag>
131
- <tag line="146" name="param" description="number of rows on each page" type="int" variable="$count">
132
  <type by_reference="false">int</type>
133
  </tag>
134
- <tag line="146" name="return" description="attachment objects (posts) including parent data, meta data and references" type="array">
135
  <type by_reference="false">array</type>
136
  </tag>
137
  </docblock>
138
- <argument line="160">
139
  <name>$request</name>
140
  <default><![CDATA[]]></default>
141
  <type/>
142
  </argument>
143
- <argument line="160">
144
  <name>$offset</name>
145
  <default><![CDATA[]]></default>
146
  <type/>
147
  </argument>
148
- <argument line="160">
149
  <name>$count</name>
150
  <default><![CDATA[]]></default>
151
  <type/>
152
  </argument>
153
  </method>
154
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="218" package="Media Library Assistant">
155
  <name>_prepare_list_table_query</name>
156
  <full_name>_prepare_list_table_query</full_name>
157
- <docblock line="204">
158
  <description><![CDATA[Sanitize and expand query arguments from request variables]]></description>
159
  <long-description><![CDATA[<p>Prepare the arguments for WP_Query.
160
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
161
- <tag line="204" name="since" description="0.1"/>
162
- <tag line="204" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$raw_request">
163
  <type by_reference="false">array</type>
164
  </tag>
165
- <tag line="204" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
166
  <type by_reference="false">int</type>
167
  </tag>
168
- <tag line="204" name="param" description="number of rows on each page (0 = all rows)" type="int" variable="$count">
169
  <type by_reference="false">int</type>
170
  </tag>
171
- <tag line="204" name="return" description="revised arguments suitable for WP_Query" type="array">
172
  <type by_reference="false">array</type>
173
  </tag>
174
  </docblock>
175
- <argument line="218">
176
  <name>$raw_request</name>
177
  <default><![CDATA[]]></default>
178
  <type/>
179
  </argument>
180
- <argument line="218">
181
  <name>$offset</name>
182
  <default><![CDATA[0]]></default>
183
  <type/>
184
  </argument>
185
- <argument line="218">
186
  <name>$count</name>
187
  <default><![CDATA[0]]></default>
188
  <type/>
189
  </argument>
190
  </method>
191
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="395" package="Media Library Assistant">
192
  <name>_execute_list_table_query</name>
193
  <full_name>_execute_list_table_query</full_name>
194
- <docblock line="386">
195
  <description><![CDATA[Add filters, run query, remove filters]]></description>
196
  <long-description><![CDATA[]]></long-description>
197
- <tag line="386" name="since" description="0.30"/>
198
- <tag line="386" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
199
  <type by_reference="false">array</type>
200
  </tag>
201
- <tag line="386" name="return" description="WP_Query object with query results" type="object">
202
  <type by_reference="false">object</type>
203
  </tag>
204
  </docblock>
205
- <argument line="395">
206
  <name>$request</name>
207
  <default><![CDATA[]]></default>
208
  <type/>
209
  </argument>
210
  </method>
211
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="420" package="Media Library Assistant">
212
  <name>mla_query_posts_join_filter</name>
213
  <full_name>mla_query_posts_join_filter</full_name>
214
- <docblock line="409">
215
  <description><![CDATA[Adds a JOIN clause, if required]]></description>
216
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
217
- <tag line="409" name="since" description="0.30"/>
218
- <tag line="409" name="param" description="query clause before modification" type="string" variable="$join_clause">
219
  <type by_reference="false">string</type>
220
  </tag>
221
- <tag line="409" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
222
  <type by_reference="false">string</type>
223
  </tag>
224
  </docblock>
225
- <argument line="420">
226
  <name>$join_clause</name>
227
  <default><![CDATA[]]></default>
228
  <type/>
229
  </argument>
230
  </method>
231
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="450" package="Media Library Assistant">
232
  <name>mla_query_posts_where_filter</name>
233
  <full_name>mla_query_posts_where_filter</full_name>
234
- <docblock line="438">
235
  <description><![CDATA[Adds a WHERE clause for detached items]]></description>
236
  <long-description><![CDATA[<p>Modeled after _edit_attachments_query_helper in wp-admin/post.php.
237
  Defined as public because it's a filter.</p>]]></long-description>
238
- <tag line="438" name="since" description="0.1"/>
239
- <tag line="438" name="param" description="query clause before modification" type="string" variable="$where_clause">
240
  <type by_reference="false">string</type>
241
  </tag>
242
- <tag line="438" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
243
  <type by_reference="false">string</type>
244
  </tag>
245
  </docblock>
246
- <argument line="450">
247
  <name>$where_clause</name>
248
  <default><![CDATA[]]></default>
249
  <type/>
250
  </argument>
251
  </method>
252
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="473" package="Media Library Assistant">
253
  <name>mla_query_posts_orderby_filter</name>
254
  <full_name>mla_query_posts_orderby_filter</full_name>
255
- <docblock line="461">
256
  <description><![CDATA[Adds a ORDERBY clause, if required]]></description>
257
  <long-description><![CDATA[<p>Expands the range of sort options because the logic in WP_Query is limited.
258
  Defined as public because it's a filter.</p>]]></long-description>
259
- <tag line="461" name="since" description="0.30"/>
260
- <tag line="461" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
261
  <type by_reference="false">string</type>
262
  </tag>
263
- <tag line="461" name="return" description="updated query clause" type="string">
264
  <type by_reference="false">string</type>
265
  </tag>
266
  </docblock>
267
- <argument line="473">
268
  <name>$orderby_clause</name>
269
  <default><![CDATA[]]></default>
270
  <type/>
271
  </argument>
272
  </method>
273
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="524" package="Media Library Assistant">
274
  <name>mla_get_attachment_by_id</name>
275
  <full_name>mla_get_attachment_by_id</full_name>
276
- <docblock line="513">
277
  <description><![CDATA[Retrieve an Attachment array given a $post_id]]></description>
278
  <long-description><![CDATA[<p>The (associative) array will contain every field that can be found in
279
  the posts and postmeta tables, and all references to the attachment.</p>]]></long-description>
280
- <tag line="513" name="since" description="0.1"/>
281
- <tag line="513" name="param" description="The ID of the attachment post" type="int" variable="$post_id">
282
  <type by_reference="false">int</type>
283
  </tag>
284
- <tag line="513" name="return" description="NULL on failure else associative array" type="NULL|array">
285
  <type by_reference="false">NULL</type>
286
  <type by_reference="false">array</type>
287
  </tag>
288
  </docblock>
289
- <argument line="524">
290
  <name>$post_id</name>
291
  <default><![CDATA[]]></default>
292
  <type/>
293
  </argument>
294
  </method>
295
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="575" package="Media Library Assistant">
296
  <name>mla_fetch_attachment_references</name>
297
  <full_name>mla_fetch_attachment_references</full_name>
298
- <docblock line="562">
299
  <description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
300
  <long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
301
  as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
302
- <tag line="562" name="since" description="0.1"/>
303
- <tag line="562" name="param" description="post ID of attachment" type="int" variable="$ID">
304
  <type by_reference="false">int</type>
305
  </tag>
306
- <tag line="562" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent">
307
  <type by_reference="false">int</type>
308
  </tag>
309
- <tag line="562" name="return" description="Reference information; see $references array comments" type="array">
310
  <type by_reference="false">array</type>
311
  </tag>
312
  </docblock>
313
- <argument line="575">
314
  <name>$ID</name>
315
  <default><![CDATA[]]></default>
316
  <type/>
317
  </argument>
318
- <argument line="575">
319
  <name>$parent</name>
320
  <default><![CDATA[]]></default>
321
  <type/>
322
  </argument>
323
  </method>
324
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="722" package="Media Library Assistant">
325
  <name>_fetch_attachment_parent_data</name>
326
  <full_name>_fetch_attachment_parent_data</full_name>
327
- <docblock line="713">
328
  <description><![CDATA[Returns information about an attachment's parent, if found]]></description>
329
  <long-description><![CDATA[]]></long-description>
330
- <tag line="713" name="since" description="0.1"/>
331
- <tag line="713" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent_id">
332
  <type by_reference="false">int</type>
333
  </tag>
334
- <tag line="713" name="return" description="Parent information; post_date, post_title and post_type" type="array">
335
  <type by_reference="false">array</type>
336
  </tag>
337
  </docblock>
338
- <argument line="722">
339
  <name>$parent_id</name>
340
  <default><![CDATA[]]></default>
341
  <type/>
342
  </argument>
343
  </method>
344
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="750" package="Media Library Assistant">
345
  <name>_fetch_attachment_metadata</name>
346
  <full_name>_fetch_attachment_metadata</full_name>
347
- <docblock line="737">
348
  <description><![CDATA[Fetch and filter meta data for an attachment]]></description>
349
  <long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
350
  are stripped out or converted to an 'mla</em>' equivalent. Array data is replaced with
351
  a string containing the first array element.</p>]]></long-description>
352
- <tag line="737" name="since" description="0.1"/>
353
- <tag line="737" name="param" description="post ID of attachment" type="int" variable="$post_id">
354
  <type by_reference="false">int</type>
355
  </tag>
356
- <tag line="737" name="return" description="Meta data variables" type="array">
357
  <type by_reference="false">array</type>
358
  </tag>
359
  </docblock>
360
- <argument line="750">
361
  <name>$post_id</name>
362
  <default><![CDATA[]]></default>
363
  <type/>
@@ -1162,7 +1170,7 @@ $this->set_pagination_args().</p>]]></long-description>
1162
  </method>
1163
  </class>
1164
  </file>
1165
- <file path="includes\class-mla-main.php" hash="a031122e5b5090fdd805147105e62de4" package="Media Library Assistant">
1166
  <docblock line="2">
1167
  <description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
1168
  <long-description><![CDATA[]]></long-description>
@@ -1199,7 +1207,7 @@ of images and files held in the WordPress Media Library.]]></description>
1199
  <constant namespace="global" line="41" package="Media Library Assistant">
1200
  <name>CURRENT_MLA_VERSION</name>
1201
  <full_name>CURRENT_MLA_VERSION</full_name>
1202
- <value><![CDATA['0.30']]></value>
1203
  <docblock line="34">
1204
  <description><![CDATA[Current version number]]></description>
1205
  <long-description><![CDATA[]]></long-description>
@@ -1447,397 +1455,397 @@ of images and files held in the WordPress Media Library.]]></description>
1447
  <type/>
1448
  </argument>
1449
  </method>
1450
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="264" package="Media Library Assistant">
1451
  <name>mla_admin_menu_action</name>
1452
  <full_name>mla_admin_menu_action</full_name>
1453
- <docblock line="251">
1454
  <description><![CDATA[Add the submenu pages]]></description>
1455
  <long-description><![CDATA[<p>Add a submenu page in the "Media" section,
1456
  add submenu page(s) for attachment taxonomies,
1457
  add filter to clean up taxonomy submenu labels
1458
  add settings page in the "Settings" section,
1459
  add settings link in the Plugins section entry for MLA.</p>]]></long-description>
1460
- <tag line="251" name="since" description="0.1"/>
1461
- <tag line="251" name="return" description="" type="void">
1462
  <type by_reference="false">void</type>
1463
  </tag>
1464
  </docblock>
1465
  </method>
1466
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="295" package="Media Library Assistant">
1467
  <name>mla_add_menu_options</name>
1468
  <full_name>mla_add_menu_options</full_name>
1469
- <docblock line="288">
1470
  <description><![CDATA[Add the "XX Entries per page" filter to the Screen Options tab]]></description>
1471
  <long-description><![CDATA[]]></long-description>
1472
- <tag line="288" name="since" description="0.1"/>
1473
- <tag line="288" name="return" description="" type="void">
1474
  <type by_reference="false">void</type>
1475
  </tag>
1476
  </docblock>
1477
  </method>
1478
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="317" package="Media Library Assistant">
1479
  <name>mla_screen_options_show_screen_filter</name>
1480
  <full_name>mla_screen_options_show_screen_filter</full_name>
1481
- <docblock line="307">
1482
  <description><![CDATA[Only show screen options on the table-list screen]]></description>
1483
  <long-description><![CDATA[]]></long-description>
1484
- <tag line="307" name="since" description="0.1"/>
1485
- <tag line="307" name="param" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean" variable="$show_screen">
1486
  <type by_reference="false">boolean</type>
1487
  </tag>
1488
- <tag line="307" name="param" description="Name of the page being loaded" type="string" variable="$this_screen">
1489
  <type by_reference="false">string</type>
1490
  </tag>
1491
- <tag line="307" name="return" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean">
1492
  <type by_reference="false">boolean</type>
1493
  </tag>
1494
  </docblock>
1495
- <argument line="317">
1496
  <name>$show_screen</name>
1497
  <default><![CDATA[]]></default>
1498
  <type/>
1499
  </argument>
1500
- <argument line="317">
1501
  <name>$this_screen</name>
1502
  <default><![CDATA[]]></default>
1503
  <type/>
1504
  </argument>
1505
  </method>
1506
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="335" package="Media Library Assistant">
1507
  <name>mla_set_screen_option_filter</name>
1508
  <full_name>mla_set_screen_option_filter</full_name>
1509
- <docblock line="324">
1510
  <description><![CDATA[Save the "Entries per page" option set by this user]]></description>
1511
  <long-description><![CDATA[]]></long-description>
1512
- <tag line="324" name="since" description="0.1"/>
1513
- <tag line="324" name="param" description="Unknown - always false?" type="boolean" variable="$status">
1514
  <type by_reference="false">boolean</type>
1515
  </tag>
1516
- <tag line="324" name="param" description="Name of the option being changed" type="string" variable="$option">
1517
  <type by_reference="false">string</type>
1518
  </tag>
1519
- <tag line="324" name="param" description="New value of the option" type="string" variable="$value">
1520
  <type by_reference="false">string</type>
1521
  </tag>
1522
- <tag line="324" name="return" description="New value if this is our option, otherwise nothing" type="string|void">
1523
  <type by_reference="false">string</type>
1524
  <type by_reference="false">void</type>
1525
  </tag>
1526
  </docblock>
1527
- <argument line="335">
1528
  <name>$status</name>
1529
  <default><![CDATA[]]></default>
1530
  <type/>
1531
  </argument>
1532
- <argument line="335">
1533
  <name>$option</name>
1534
  <default><![CDATA[]]></default>
1535
  <type/>
1536
  </argument>
1537
- <argument line="335">
1538
  <name>$value</name>
1539
  <default><![CDATA[]]></default>
1540
  <type/>
1541
  </argument>
1542
  </method>
1543
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="351" package="Media Library Assistant">
1544
  <name>mla_edit_tax_redirect</name>
1545
  <full_name>mla_edit_tax_redirect</full_name>
1546
- <docblock line="341">
1547
  <description><![CDATA[Redirect to the Edit Tags/Categories page]]></description>
1548
  <long-description><![CDATA[<p>The custom taxonomy add/edit submenu entries go to "upload.php" by default.
1549
  This filter is the only way to redirect them to the correct WordPress page.</p>]]></long-description>
1550
- <tag line="341" name="since" description="0.1"/>
1551
- <tag line="341" name="return" description="" type="void">
1552
  <type by_reference="false">void</type>
1553
  </tag>
1554
  </docblock>
1555
  </method>
1556
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="369" package="Media Library Assistant">
1557
  <name>mla_add_help_tab</name>
1558
  <full_name>mla_add_help_tab</full_name>
1559
- <docblock line="362">
1560
  <description><![CDATA[Add contextual help tabs to all the MLA pages]]></description>
1561
  <long-description><![CDATA[]]></long-description>
1562
- <tag line="362" name="since" description="0.1"/>
1563
- <tag line="362" name="return" description="" type="void">
1564
  <type by_reference="false">void</type>
1565
  </tag>
1566
  </docblock>
1567
  </method>
1568
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="461" package="Media Library Assistant">
1569
  <name>mla_modify_parent_menu</name>
1570
  <full_name>mla_modify_parent_menu</full_name>
1571
- <docblock line="448">
1572
  <description><![CDATA[Cleanup menus for Edit Tags/Categories page]]></description>
1573
  <long-description><![CDATA[<p>The submenu entries for custom taxonomies under the "Media" menu are not set up
1574
  correctly by WordPress, so this function cleans them up, redirecting the request
1575
  to the right WordPress page for editing/adding taxonomy terms.</p>]]></long-description>
1576
- <tag line="448" name="since" description="0.1"/>
1577
- <tag line="448" name="param" description="The top-level menu page" type="array" variable="$parent_file">
1578
  <type by_reference="false">array</type>
1579
  </tag>
1580
- <tag line="448" name="return" description="The updated top-level menu page" type="string">
1581
  <type by_reference="false">string</type>
1582
  </tag>
1583
  </docblock>
1584
- <argument line="461">
1585
  <name>$parent_file</name>
1586
  <default><![CDATA[]]></default>
1587
  <type/>
1588
  </argument>
1589
  </method>
1590
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="492" package="Media Library Assistant">
1591
  <name>mla_render_admin_page</name>
1592
  <full_name>mla_render_admin_page</full_name>
1593
- <docblock line="485">
1594
  <description><![CDATA[Render the "Assistant" subpage in the Media section, using the list_table package]]></description>
1595
  <long-description><![CDATA[]]></long-description>
1596
- <tag line="485" name="since" description="0.1"/>
1597
- <tag line="485" name="return" description="" type="void">
1598
  <type by_reference="false">void</type>
1599
  </tag>
1600
  </docblock>
1601
  </method>
1602
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="695" package="Media Library Assistant">
1603
  <name>mla_inline_edit_action</name>
1604
  <full_name>mla_inline_edit_action</full_name>
1605
- <docblock line="686">
1606
  <description><![CDATA[Ajax handler for inline editing (quick and bulk edit)]]></description>
1607
  <long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
1608
- <tag line="686" name="since" description="0.20"/>
1609
- <tag line="686" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
1610
  <type by_reference="false">void</type>
1611
  </tag>
1612
  </docblock>
1613
  </method>
1614
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="764" package="Media Library Assistant">
1615
  <name>_build_inline_edit_form</name>
1616
  <full_name>_build_inline_edit_form</full_name>
1617
- <docblock line="753">
1618
  <description><![CDATA[Build the hidden row templates for inline editing (quick and bulk edit)]]></description>
1619
  <long-description><![CDATA[<p>inspired by inline_edit() in wp-admin\includes\class-wp-posts-list-table.php.</p>]]></long-description>
1620
- <tag line="753" name="since" description="0.20"/>
1621
- <tag line="753" name="param" description="MLA List Table object" type="object" variable="$MLAListTable">
1622
  <type by_reference="false">object</type>
1623
  </tag>
1624
- <tag line="753" name="return" description="HTML &lt;form&gt; markup for hidden rows" type="string">
1625
  <type by_reference="false">string</type>
1626
  </tag>
1627
  </docblock>
1628
- <argument line="764">
1629
  <name>$MLAListTable</name>
1630
  <default><![CDATA[]]></default>
1631
  <type/>
1632
  </argument>
1633
  </method>
1634
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="891" package="Media Library Assistant">
1635
  <name>_authors_dropdown</name>
1636
  <full_name>_authors_dropdown</full_name>
1637
- <docblock line="880">
1638
  <description><![CDATA[Get the edit Authors dropdown box, if user has suitable permissions]]></description>
1639
  <long-description><![CDATA[]]></long-description>
1640
- <tag line="880" name="since" description="0.20"/>
1641
- <tag line="880" name="param" description="User ID of the current author" type="integer" variable="$author">
1642
  <type by_reference="false">integer</type>
1643
  </tag>
1644
- <tag line="880" name="param" description="HTML name attribute" type="string" variable="$name">
1645
  <type by_reference="false">string</type>
1646
  </tag>
1647
- <tag line="880" name="param" description="HTML class attribute" type="string" variable="$class">
1648
  <type by_reference="false">string</type>
1649
  </tag>
1650
- <tag line="880" name="return" description="HTML markup for the dropdown field or False" type="string|false">
1651
  <type by_reference="false">string</type>
1652
  <type by_reference="false">false</type>
1653
  </tag>
1654
  </docblock>
1655
- <argument line="891">
1656
  <name>$author</name>
1657
  <default><![CDATA[0]]></default>
1658
  <type/>
1659
  </argument>
1660
- <argument line="891">
1661
  <name>$name</name>
1662
  <default><![CDATA['post_author']]></default>
1663
  <type/>
1664
  </argument>
1665
- <argument line="891">
1666
  <name>$class</name>
1667
  <default><![CDATA['authors']]></default>
1668
  <type/>
1669
  </argument>
1670
  </method>
1671
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="923" package="Media Library Assistant">
1672
  <name>_current_bulk_action</name>
1673
  <full_name>_current_bulk_action</full_name>
1674
- <docblock line="916">
1675
  <description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
1676
  <long-description><![CDATA[]]></long-description>
1677
- <tag line="916" name="since" description="0.1"/>
1678
- <tag line="916" name="return" description="The action name or False if no action was selected" type="string|false">
1679
  <type by_reference="false">string</type>
1680
  <type by_reference="false">false</type>
1681
  </tag>
1682
  </docblock>
1683
  </method>
1684
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="953" package="Media Library Assistant">
1685
  <name>_delete_single_item</name>
1686
  <full_name>_delete_single_item</full_name>
1687
- <docblock line="944">
1688
  <description><![CDATA[Delete a single item permanently]]></description>
1689
  <long-description><![CDATA[]]></long-description>
1690
- <tag line="944" name="since" description="0.1"/>
1691
- <tag line="944" name="param" description="The form POST data" type="array" variable="$post_id">
1692
  <type by_reference="false">array</type>
1693
  </tag>
1694
- <tag line="944" name="return" description="success/failure message and NULL content" type="array">
1695
  <type by_reference="false">array</type>
1696
  </tag>
1697
  </docblock>
1698
- <argument line="953">
1699
  <name>$post_id</name>
1700
  <default><![CDATA[]]></default>
1701
  <type/>
1702
  </argument>
1703
  </method>
1704
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="982" package="Media Library Assistant">
1705
  <name>_display_single_item</name>
1706
  <full_name>_display_single_item</full_name>
1707
- <docblock line="972">
1708
  <description><![CDATA[Display a single item sub page; prepare the form to
1709
  change the meta data for a single attachment.]]></description>
1710
  <long-description><![CDATA[]]></long-description>
1711
- <tag line="972" name="since" description="0.1"/>
1712
- <tag line="972" name="param" description="The WordPress Post ID of the attachment item" type="int" variable="$post_id">
1713
  <type by_reference="false">int</type>
1714
  </tag>
1715
- <tag line="972" name="return" description="message and/or HTML content" type="array">
1716
  <type by_reference="false">array</type>
1717
  </tag>
1718
  </docblock>
1719
- <argument line="982">
1720
  <name>$post_id</name>
1721
  <default><![CDATA[]]></default>
1722
  <type/>
1723
  </argument>
1724
  </method>
1725
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1196" package="Media Library Assistant">
1726
  <name>_update_single_item</name>
1727
  <full_name>_update_single_item</full_name>
1728
- <docblock line="1183">
1729
  <description><![CDATA[Update a single item; change the meta data
1730
  for a single attachment.]]></description>
1731
  <long-description><![CDATA[]]></long-description>
1732
- <tag line="1183" name="since" description="0.1"/>
1733
- <tag line="1183" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
1734
  <type by_reference="false">int</type>
1735
  </tag>
1736
- <tag line="1183" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_data">
1737
  <type by_reference="false">array</type>
1738
  </tag>
1739
- <tag line="1183" name="param" description="Taxonomy term values" type="array" variable="$tax_input">
1740
  <type by_reference="false">array</type>
1741
  </tag>
1742
- <tag line="1183" name="param" description="Taxonomy actions (add, remove, replace)" type="array" variable="$tax_actions">
1743
  <type by_reference="false">array</type>
1744
  </tag>
1745
- <tag line="1183" name="return" description="success/failure message and NULL content" type="array">
1746
  <type by_reference="false">array</type>
1747
  </tag>
1748
  </docblock>
1749
- <argument line="1196">
1750
  <name>$post_id</name>
1751
  <default><![CDATA[]]></default>
1752
  <type/>
1753
  </argument>
1754
- <argument line="1196">
1755
  <name>$new_data</name>
1756
  <default><![CDATA[]]></default>
1757
  <type/>
1758
  </argument>
1759
- <argument line="1196">
1760
  <name>$tax_input</name>
1761
  <default><![CDATA[NULL]]></default>
1762
  <type/>
1763
  </argument>
1764
- <argument line="1196">
1765
  <name>$tax_actions</name>
1766
  <default><![CDATA[NULL]]></default>
1767
  <type/>
1768
  </argument>
1769
  </method>
1770
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1385" package="Media Library Assistant">
1771
  <name>_remove_tags</name>
1772
  <full_name>_remove_tags</full_name>
1773
- <docblock line="1374">
1774
  <description><![CDATA[Remove tags from a term ids list]]></description>
1775
  <long-description><![CDATA[]]></long-description>
1776
- <tag line="1374" name="since" description="0.40"/>
1777
- <tag line="1374" name="param" description="The term ids currently assigned" type="array" variable="$terms_before">
1778
  <type by_reference="false">array</type>
1779
  </tag>
1780
- <tag line="1374" name="param" description="| string The term ids (array) or names (string) to remove" type="array" variable="$tags">
1781
  <type by_reference="false">array</type>
1782
  </tag>
1783
- <tag line="1374" name="param" description="The taxonomy object" type="object" variable="$taxonomy_obj">
1784
  <type by_reference="false">object</type>
1785
  </tag>
1786
- <tag line="1374" name="return" description="Term ids of the surviving tags" type="array">
1787
  <type by_reference="false">array</type>
1788
  </tag>
1789
  </docblock>
1790
- <argument line="1385">
1791
  <name>$terms_before</name>
1792
  <default><![CDATA[]]></default>
1793
  <type/>
1794
  </argument>
1795
- <argument line="1385">
1796
  <name>$tags</name>
1797
  <default><![CDATA[]]></default>
1798
  <type/>
1799
  </argument>
1800
- <argument line="1385">
1801
  <name>$taxonomy_obj</name>
1802
  <default><![CDATA[]]></default>
1803
  <type/>
1804
  </argument>
1805
  </method>
1806
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1436" package="Media Library Assistant">
1807
  <name>_restore_single_item</name>
1808
  <full_name>_restore_single_item</full_name>
1809
- <docblock line="1427">
1810
  <description><![CDATA[Restore a single item from the Trash]]></description>
1811
  <long-description><![CDATA[]]></long-description>
1812
- <tag line="1427" name="since" description="0.1"/>
1813
- <tag line="1427" name="param" description="The form POST data" type="array" variable="$post_id">
1814
  <type by_reference="false">array</type>
1815
  </tag>
1816
- <tag line="1427" name="return" description="success/failure message and NULL content" type="array">
1817
  <type by_reference="false">array</type>
1818
  </tag>
1819
  </docblock>
1820
- <argument line="1436">
1821
  <name>$post_id</name>
1822
  <default><![CDATA[]]></default>
1823
  <type/>
1824
  </argument>
1825
  </method>
1826
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1472" package="Media Library Assistant">
1827
  <name>_trash_single_item</name>
1828
  <full_name>_trash_single_item</full_name>
1829
- <docblock line="1463">
1830
  <description><![CDATA[Move a single item to Trash]]></description>
1831
  <long-description><![CDATA[]]></long-description>
1832
- <tag line="1463" name="since" description="0.1"/>
1833
- <tag line="1463" name="param" description="The form POST data" type="array" variable="$post_id">
1834
  <type by_reference="false">array</type>
1835
  </tag>
1836
- <tag line="1463" name="return" description="success/failure message and NULL content" type="array">
1837
  <type by_reference="false">array</type>
1838
  </tag>
1839
  </docblock>
1840
- <argument line="1472">
1841
  <name>$post_id</name>
1842
  <default><![CDATA[]]></default>
1843
  <type/>
@@ -1845,7 +1853,7 @@ for a single attachment.]]></description>
1845
  </method>
1846
  </class>
1847
  </file>
1848
- <file path="includes\class-mla-objects.php" hash="7d0870e15bac97ba058ac5e548e37182" package="Media Library Assistant">
1849
  <docblock line="2">
1850
  <description><![CDATA[Media Library Assistant Custom Taxonomy and Post Type objects]]></description>
1851
  <long-description><![CDATA[]]></long-description>
@@ -1886,59 +1894,59 @@ for a single attachment.]]></description>
1886
  </tag>
1887
  </docblock>
1888
  </method>
1889
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="112" package="Media Library Assistant">
1890
  <name>mla_taxonomy_get_columns_filter</name>
1891
  <full_name>mla_taxonomy_get_columns_filter</full_name>
1892
- <docblock line="102">
1893
  <description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
1894
  which replaces the "Posts" column with an equivalent "Attachments" column.]]></description>
1895
  <long-description><![CDATA[]]></long-description>
1896
- <tag line="102" name="since" description="0.30"/>
1897
- <tag line="102" name="param" description="column definitions for the edit taxonomy list table" type="array" variable="$columns">
1898
  <type by_reference="false">array</type>
1899
  </tag>
1900
- <tag line="102" name="return" description="updated column definitions for the edit taxonomy list table" type="array">
1901
  <type by_reference="false">array</type>
1902
  </tag>
1903
  </docblock>
1904
- <argument line="112">
1905
  <name>$columns</name>
1906
  <default><![CDATA[]]></default>
1907
  <type/>
1908
  </argument>
1909
  </method>
1910
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="138" package="Media Library Assistant">
1911
  <name>mla_taxonomy_column_filter</name>
1912
  <full_name>mla_taxonomy_column_filter</full_name>
1913
- <docblock line="125">
1914
  <description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
1915
  which returns a count of the attachments assigned a given term]]></description>
1916
  <long-description><![CDATA[]]></long-description>
1917
- <tag line="125" name="since" description="0.30"/>
1918
- <tag line="125" name="param" description="current column value; always ''" type="string" variable="$place_holder">
1919
  <type by_reference="false">string</type>
1920
  </tag>
1921
- <tag line="125" name="param" description="name of the column" type="array" variable="$column_name">
1922
  <type by_reference="false">array</type>
1923
  </tag>
1924
- <tag line="125" name="param" description="ID of the term for which the count is desired" type="array" variable="$term_id">
1925
  <type by_reference="false">array</type>
1926
  </tag>
1927
- <tag line="125" name="return" description="HTML markup for the column content; number of attachments in the category and alink to retrieve a list of them" type="array">
1928
  <type by_reference="false">array</type>
1929
  </tag>
1930
  </docblock>
1931
- <argument line="138">
1932
  <name>$place_holder</name>
1933
  <default><![CDATA[]]></default>
1934
  <type/>
1935
  </argument>
1936
- <argument line="138">
1937
  <name>$column_name</name>
1938
  <default><![CDATA[]]></default>
1939
  <type/>
1940
  </argument>
1941
- <argument line="138">
1942
  <name>$term_id</name>
1943
  <default><![CDATA[]]></default>
1944
  <type/>
@@ -1946,7 +1954,7 @@ which returns a count of the attachments assigned a given term]]></description>
1946
  </method>
1947
  </class>
1948
  </file>
1949
- <file path="includes\class-mla-settings.php" hash="c7ff750a5f9679abfd7929d37ad74197" package="Media Library Assistant">
1950
  <docblock line="2">
1951
  <description><![CDATA[Manages the plugin option settings and provides the settings page to edit them]]></description>
1952
  <long-description><![CDATA[]]></long-description>
@@ -2043,272 +2051,285 @@ reset => reset function for 'custom' options; returns nothing. Usage:
2043
  </tag>
2044
  </docblock>
2045
  </method>
2046
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="186" package="Media Library Assistant">
2047
  <name>_version_upgrade</name>
2048
  <full_name>_version_upgrade</full_name>
2049
- <docblock line="179">
2050
  <description><![CDATA[Database and option update check, for installing new versions]]></description>
2051
  <long-description><![CDATA[]]></long-description>
2052
- <tag line="179" name="since" description="0.30"/>
2053
- <tag line="179" name="return" description="" type="void">
 
 
 
 
 
 
 
 
 
 
 
 
 
2054
  <type by_reference="false">void</type>
2055
  </tag>
2056
  </docblock>
2057
  </method>
2058
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="227" package="Media Library Assistant">
2059
  <name>mla_activation_hook</name>
2060
  <full_name>mla_activation_hook</full_name>
2061
- <docblock line="218">
2062
  <description><![CDATA[Perform one-time actions on plugin activation]]></description>
2063
  <long-description><![CDATA[<p>Adds a view to the database to support sorting the listing on 'ALT Text'.</p>]]></long-description>
2064
- <tag line="218" name="since" description="0.40"/>
2065
- <tag line="218" name="return" description="" type="void">
2066
  <type by_reference="false">void</type>
2067
  </tag>
2068
  </docblock>
2069
  </method>
2070
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="257" package="Media Library Assistant">
2071
  <name>mla_deactivation_hook</name>
2072
  <full_name>mla_deactivation_hook</full_name>
2073
- <docblock line="248">
2074
  <description><![CDATA[Perform one-time actions on plugin deactivation]]></description>
2075
  <long-description><![CDATA[<p>Removes a view from the database that supports sorting the listing on 'ALT Text'.</p>]]></long-description>
2076
- <tag line="248" name="since" description="0.40"/>
2077
- <tag line="248" name="return" description="" type="void">
2078
  <type by_reference="false">void</type>
2079
  </tag>
2080
  </docblock>
2081
  </method>
2082
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="294" package="Media Library Assistant">
2083
  <name>mla_admin_menu_action</name>
2084
  <full_name>mla_admin_menu_action</full_name>
2085
- <docblock line="286">
2086
  <description><![CDATA[Add settings page in the "Settings" section,
2087
  add settings link in the Plugins section entry for MLA.]]></description>
2088
  <long-description><![CDATA[]]></long-description>
2089
- <tag line="286" name="since" description="0.1"/>
2090
- <tag line="286" name="return" description="" type="void">
2091
  <type by_reference="false">void</type>
2092
  </tag>
2093
  </docblock>
2094
  </method>
2095
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="310" package="Media Library Assistant">
2096
  <name>mla_add_plugin_settings_link</name>
2097
  <full_name>mla_add_plugin_settings_link</full_name>
2098
- <docblock line="300">
2099
  <description><![CDATA[Add the "Settings" link to the MLA entry in the Plugins section]]></description>
2100
  <long-description><![CDATA[]]></long-description>
2101
- <tag line="300" name="since" description="0.1"/>
2102
- <tag line="300" name="param" description="array of links for the Plugin, e.g., &quot;Activate&quot;" type="array" variable="$links">
2103
  <type by_reference="false">array</type>
2104
  </tag>
2105
- <tag line="300" name="param" description="Directory and name of the plugin Index file" type="string" variable="$file">
2106
  <type by_reference="false">string</type>
2107
  </tag>
2108
- <tag line="300" name="return" description="Updated array of links for the Plugin" type="array">
2109
  <type by_reference="false">array</type>
2110
  </tag>
2111
  </docblock>
2112
- <argument line="310">
2113
  <name>$links</name>
2114
  <default><![CDATA[]]></default>
2115
  <type/>
2116
  </argument>
2117
- <argument line="310">
2118
  <name>$file</name>
2119
  <default><![CDATA[]]></default>
2120
  <type/>
2121
  </argument>
2122
  </method>
2123
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="328" package="Media Library Assistant">
2124
  <name>mla_get_option</name>
2125
  <full_name>mla_get_option</full_name>
2126
- <docblock line="319">
2127
  <description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
2128
  <long-description><![CDATA[]]></long-description>
2129
- <tag line="319" name="since" description="0.1"/>
2130
- <tag line="319" name="param" description="Name of the desired option" type="string" variable="$option">
2131
  <type by_reference="false">string</type>
2132
  </tag>
2133
- <tag line="319" name="return" description="Value(s) for the option or false if the option is not a defined MLA option" type="mixed">
2134
  <type by_reference="false">mixed</type>
2135
  </tag>
2136
  </docblock>
2137
- <argument line="328">
2138
  <name>$option</name>
2139
  <default><![CDATA[]]></default>
2140
  <type/>
2141
  </argument>
2142
  </method>
2143
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="349" package="Media Library Assistant">
2144
  <name>mla_update_option</name>
2145
  <full_name>mla_update_option</full_name>
2146
- <docblock line="339">
2147
  <description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
2148
  <long-description><![CDATA[]]></long-description>
2149
- <tag line="339" name="since" description="0.1"/>
2150
- <tag line="339" name="param" description="Name of the desired option" type="string" variable="$option">
2151
  <type by_reference="false">string</type>
2152
  </tag>
2153
- <tag line="339" name="param" description="New value for the desired option" type="mixed" variable="$newvalue">
2154
  <type by_reference="false">mixed</type>
2155
  </tag>
2156
- <tag line="339" name="return" description="True if the value was changed or false if the update failed" type="boolean">
2157
  <type by_reference="false">boolean</type>
2158
  </tag>
2159
  </docblock>
2160
- <argument line="349">
2161
  <name>$option</name>
2162
  <default><![CDATA[]]></default>
2163
  <type/>
2164
  </argument>
2165
- <argument line="349">
2166
  <name>$newvalue</name>
2167
  <default><![CDATA[]]></default>
2168
  <type/>
2169
  </argument>
2170
  </method>
2171
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="365" package="Media Library Assistant">
2172
  <name>mla_delete_option</name>
2173
  <full_name>mla_delete_option</full_name>
2174
- <docblock line="356">
2175
  <description><![CDATA[Delete the stored value of a defined MLA option]]></description>
2176
  <long-description><![CDATA[]]></long-description>
2177
- <tag line="356" name="since" description="0.1"/>
2178
- <tag line="356" name="param" description="Name of the desired option" type="string" variable="$option">
2179
  <type by_reference="false">string</type>
2180
  </tag>
2181
- <tag line="356" name="return" description="True if the option was deleted, otherwise false" type="boolean">
2182
  <type by_reference="false">boolean</type>
2183
  </tag>
2184
  </docblock>
2185
- <argument line="365">
2186
  <name>$option</name>
2187
  <default><![CDATA[]]></default>
2188
  <type/>
2189
  </argument>
2190
  </method>
2191
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="380" package="Media Library Assistant">
2192
  <name>mla_render_settings_page</name>
2193
  <full_name>mla_render_settings_page</full_name>
2194
- <docblock line="373">
2195
  <description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
2196
  <long-description><![CDATA[]]></long-description>
2197
- <tag line="373" name="since" description="0.1"/>
2198
- <tag line="373" name="return" description="Echoes HTML markup for the settings subpage" type="void">
2199
  <type by_reference="false">void</type>
2200
  </tag>
2201
  </docblock>
2202
  </method>
2203
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="602" package="Media Library Assistant">
2204
  <name>mla_taxonomy_support</name>
2205
  <full_name>mla_taxonomy_support</full_name>
2206
- <docblock line="589">
2207
  <description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
2208
  settings are being updated or reset.]]></description>
2209
  <long-description><![CDATA[]]></long-description>
2210
- <tag line="589" name="since" description="0.30"/>
2211
- <tag line="589" name="param" description="Taxonomy name, e.g., attachment_category" type="string" variable="$tax_name">
2212
  <type by_reference="false">string</type>
2213
  </tag>
2214
- <tag line="589" name="param" description="'support' (the default), 'quick-edit' or 'filter'" type="string" variable="$support_type">
2215
  <type by_reference="false">string</type>
2216
  </tag>
2217
- <tag line="589" 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">
2218
  <type by_reference="false">boolean</type>
2219
  <type by_reference="false">string</type>
2220
  </tag>
2221
  </docblock>
2222
- <argument line="602">
2223
  <name>$tax_name</name>
2224
  <default><![CDATA[]]></default>
2225
  <type/>
2226
  </argument>
2227
- <argument line="602">
2228
  <name>$support_type</name>
2229
  <default><![CDATA['support']]></default>
2230
  <type/>
2231
  </argument>
2232
  </method>
2233
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="674" package="Media Library Assistant">
2234
  <name>_save_settings</name>
2235
  <full_name>_save_settings</full_name>
2236
- <docblock line="665">
2237
  <description><![CDATA[Save settings to the options table]]></description>
2238
  <long-description><![CDATA[]]></long-description>
2239
- <tag line="665" name="since" description="0.1"/>
2240
- <tag line="665" name="param" description="HTML template(s) for the settings page" type="array" variable="$template_array">
2241
  <type by_reference="false">array</type>
2242
  </tag>
2243
- <tag line="665" name="return" description="Message(s) reflecting the results of the operation" type="array">
2244
  <type by_reference="false">array</type>
2245
  </tag>
2246
  </docblock>
2247
- <argument line="674">
2248
  <name>$template_array</name>
2249
  <default><![CDATA[]]></default>
2250
  <type/>
2251
  </argument>
2252
  </method>
2253
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="765" package="Media Library Assistant">
2254
  <name>_reset_settings</name>
2255
  <full_name>_reset_settings</full_name>
2256
- <docblock line="756">
2257
  <description><![CDATA[Delete saved settings, restoring default values]]></description>
2258
  <long-description><![CDATA[]]></long-description>
2259
- <tag line="756" name="since" description="0.1"/>
2260
- <tag line="756" name="param" description="HTML template(s) for the settings page" type="array" variable="$template_array">
2261
  <type by_reference="false">array</type>
2262
  </tag>
2263
- <tag line="756" name="return" description="Message(s) reflecting the results of the operation" type="array">
2264
  <type by_reference="false">array</type>
2265
  </tag>
2266
  </docblock>
2267
- <argument line="765">
2268
  <name>$template_array</name>
2269
  <default><![CDATA[]]></default>
2270
  <type/>
2271
  </argument>
2272
  </method>
2273
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="808" package="Media Library Assistant">
2274
  <name>_taxonomy_handler</name>
2275
  <full_name>_taxonomy_handler</full_name>
2276
- <docblock line="796">
2277
  <description><![CDATA[Render and manage other taxonomy support options, e.g., Categories and Post Tags]]></description>
2278
  <long-description><![CDATA[]]></long-description>
2279
- <tag line="796" name="since" description="0.30"/>
2280
- <tag line="796" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
2281
  <type by_reference="false">string</type>
2282
  </tag>
2283
- <tag line="796" name="param" description="option name, e.g., 'taxonomy_support'" type="string" variable="$key">
2284
  <type by_reference="false">string</type>
2285
  </tag>
2286
- <tag line="796" name="param" description="option parameters" type="array" variable="$value">
2287
  <type by_reference="false">array</type>
2288
  </tag>
2289
- <tag line="796" name="param" description="The $page_template_array for 'render' else $_REQUEST" type="array" variable="$args">
2290
  <type by_reference="false">array</type>
2291
  </tag>
2292
- <tag line="796" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
2293
  <type by_reference="false">string</type>
2294
  </tag>
2295
  </docblock>
2296
- <argument line="808">
2297
  <name>$action</name>
2298
  <default><![CDATA[]]></default>
2299
  <type/>
2300
  </argument>
2301
- <argument line="808">
2302
  <name>$key</name>
2303
  <default><![CDATA[]]></default>
2304
  <type/>
2305
  </argument>
2306
- <argument line="808">
2307
  <name>$value</name>
2308
  <default><![CDATA[]]></default>
2309
  <type/>
2310
  </argument>
2311
- <argument line="808">
2312
  <name>$args</name>
2313
  <default><![CDATA[]]></default>
2314
  <type/>
@@ -2316,7 +2337,7 @@ settings are being updated or reset.]]></description>
2316
  </method>
2317
  </class>
2318
  </file>
2319
- <file path="includes\class-mla-shortcodes.php" hash="eca48c0e1084966640a0083cf3c70a7b" package="Media Library Assistant">
2320
  <docblock line="2">
2321
  <description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
2322
  <long-description><![CDATA[]]></long-description>
@@ -2345,18 +2366,60 @@ settings are being updated or reset.]]></description>
2345
  </tag>
2346
  </docblock>
2347
  </method>
2348
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="34" package="Media Library Assistant">
2349
  <name>mla_attachment_list_shortcode</name>
2350
  <full_name>mla_attachment_list_shortcode</full_name>
2351
- <docblock line="27">
2352
  <description><![CDATA[WordPress Shortcode; renders a complete list of all attachments and references to them]]></description>
2353
  <long-description><![CDATA[]]></long-description>
2354
- <tag line="27" name="since" description="0.1"/>
2355
- <tag line="27" name="return" description="echoes HTML markup for the attachment list" type="void">
2356
  <type by_reference="false">void</type>
2357
  </tag>
2358
  </docblock>
2359
  </method>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2360
  </class>
2361
  </file>
2362
  <file path="includes\mla-plugin-loader.php" hash="9abec375c6f7ae5efd70d593750132ef" package="Media Library Assistant">
@@ -2398,13 +2461,13 @@ This file is only loaded if the naming conflict tests in index.php are passed.</
2398
  </docblock>
2399
  </constant>
2400
  </file>
2401
- <file path="index.php" hash="5084371b7f9b3500b13f2b83a1e2a44b" package="Media Library Assistant">
2402
  <docblock line="2">
2403
  <description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
2404
  <long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
2405
  will the rest of the plugin be loaded and run.</p>]]></long-description>
2406
  <tag line="2" name="package" description="Media Library Assistant"/>
2407
- <tag line="2" name="version" description="0.40"/>
2408
  </docblock>
2409
  <include line="103" type="Require Once" package="Media Library Assistant">
2410
  <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="a7a7cf84277084dd2745f90fa38c39c7" 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>
18
  <tag line="9" name="package" description="Media Library Assistant"/>
19
  <tag line="9" name="since" description="0.1"/>
20
  </docblock>
21
+ <property final="false" static="true" visibility="private" line="222" namespace="global" package="Media Library Assistant">
22
  <name>$query_parameters</name>
23
  <default><![CDATA[array()]]></default>
24
+ <docblock line="211">
25
  <description><![CDATA[WP_Query filter "parameters"]]></description>
26
  <long-description><![CDATA[<p>This array defines parameters for the query's join, where and orderby filters.
27
  The parameters are set up in the _prepare_list_table_query function, and
28
  any further logic required to translate those values is contained in the filters.</p>]]></long-description>
29
+ <tag line="211" name="since" description="0.30"/>
30
+ <tag line="211" name="var" description="" type="array">
31
  <type by_reference="false">array</type>
32
  </tag>
33
  </docblock>
41
  <tag line="19" name="since" description="0.1"/>
42
  </docblock>
43
  </method>
44
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="46" package="Media Library Assistant">
45
  <name>mla_load_template</name>
46
  <full_name>mla_load_template</full_name>
47
  <docblock line="28">
50
  Multi-part templates are divided by comments of the form <!-- template="key" -->,
51
  where "key" becomes the key part of the array.</p>]]></long-description>
52
  <tag line="28" name="since" description="0.1"/>
53
+ <tag line="28" name="param" description="Complete path and name of the template file, option name or the raw template" type="string" variable="$source">
54
  <type by_reference="false">string</type>
55
  </tag>
56
+ <tag line="28" name="param" description="Type of template source; 'file', 'option', 'string'" type="string" variable="$type">
57
+ <type by_reference="false">string</type>
58
+ </tag>
59
+ <tag line="28" name="return" description="string for files that do not contain template divider comments, array for files containing template divider comments, false if file or option does not exist, NULL if file could not be loaded." type="string|array|false|NULL">
60
  <type by_reference="false">string</type>
61
  <type by_reference="false">array</type>
62
  <type by_reference="false">false</type>
63
  <type by_reference="false">NULL</type>
64
  </tag>
65
  </docblock>
66
+ <argument line="46">
67
+ <name>$source</name>
68
  <default><![CDATA[]]></default>
69
  <type/>
70
  </argument>
71
+ <argument line="46">
72
+ <name>$type</name>
73
+ <default><![CDATA['file']]></default>
74
+ <type/>
75
+ </argument>
76
  </method>
77
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="141" package="Media Library Assistant">
78
  <name>mla_parse_template</name>
79
  <full_name>mla_parse_template</full_name>
80
+ <docblock line="129">
81
  <description><![CDATA[Expand a template, replacing place holders with their values]]></description>
82
  <long-description><![CDATA[<p>A simple parsing function for basic templating.</p>]]></long-description>
83
+ <tag line="129" name="since" description="0.1"/>
84
+ <tag line="129" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
85
  <type by_reference="false">string</type>
86
  </tag>
87
+ <tag line="129" name="param" description="An associative array containing keys and values e.g. array('key' =&gt; 'value')" type="array" variable="$hash">
88
  <type by_reference="false">array</type>
89
  </tag>
90
+ <tag line="129" name="return" description="Placeholders corresponding to the keys of the hash will be replaced with their values" type="string">
91
  <type by_reference="false">string</type>
92
  </tag>
93
  </docblock>
94
+ <argument line="141">
95
  <name>$tpl</name>
96
  <default><![CDATA[]]></default>
97
  <type/>
98
  </argument>
99
+ <argument line="141">
100
  <name>$hash</name>
101
  <default><![CDATA[]]></default>
102
  <type/>
103
  </argument>
104
  </method>
105
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="159" package="Media Library Assistant">
106
  <name>mla_count_list_table_items</name>
107
  <full_name>mla_count_list_table_items</full_name>
108
+ <docblock line="150">
109
  <description><![CDATA[Get the total number of attachment posts]]></description>
110
  <long-description><![CDATA[]]></long-description>
111
+ <tag line="150" name="since" description="0.30"/>
112
+ <tag line="150" name="param" description="Query variables, e.g., from $_REQUEST" type="array" variable="$request">
113
  <type by_reference="false">array</type>
114
  </tag>
115
+ <tag line="150" name="return" description="Number of attachment posts" type="integer">
116
  <type by_reference="false">integer</type>
117
  </tag>
118
  </docblock>
119
+ <argument line="159">
120
  <name>$request</name>
121
  <default><![CDATA[]]></default>
122
  <type/>
123
  </argument>
124
  </method>
125
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="180" package="Media Library Assistant">
126
  <name>mla_query_list_table_items</name>
127
  <full_name>mla_query_list_table_items</full_name>
128
+ <docblock line="166">
129
  <description><![CDATA[Retrieve attachment objects for list table display]]></description>
130
  <long-description><![CDATA[<p>Supports prepare_items in class-mla-list-table.php.
131
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
132
+ <tag line="166" name="since" description="0.1"/>
133
+ <tag line="166" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
134
  <type by_reference="false">array</type>
135
  </tag>
136
+ <tag line="166" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
137
  <type by_reference="false">int</type>
138
  </tag>
139
+ <tag line="166" name="param" description="number of rows on each page" type="int" variable="$count">
140
  <type by_reference="false">int</type>
141
  </tag>
142
+ <tag line="166" name="return" description="attachment objects (posts) including parent data, meta data and references" type="array">
143
  <type by_reference="false">array</type>
144
  </tag>
145
  </docblock>
146
+ <argument line="180">
147
  <name>$request</name>
148
  <default><![CDATA[]]></default>
149
  <type/>
150
  </argument>
151
+ <argument line="180">
152
  <name>$offset</name>
153
  <default><![CDATA[]]></default>
154
  <type/>
155
  </argument>
156
+ <argument line="180">
157
  <name>$count</name>
158
  <default><![CDATA[]]></default>
159
  <type/>
160
  </argument>
161
  </method>
162
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="238" package="Media Library Assistant">
163
  <name>_prepare_list_table_query</name>
164
  <full_name>_prepare_list_table_query</full_name>
165
+ <docblock line="224">
166
  <description><![CDATA[Sanitize and expand query arguments from request variables]]></description>
167
  <long-description><![CDATA[<p>Prepare the arguments for WP_Query.
168
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
169
+ <tag line="224" name="since" description="0.1"/>
170
+ <tag line="224" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$raw_request">
171
  <type by_reference="false">array</type>
172
  </tag>
173
+ <tag line="224" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
174
  <type by_reference="false">int</type>
175
  </tag>
176
+ <tag line="224" name="param" description="number of rows on each page (0 = all rows)" type="int" variable="$count">
177
  <type by_reference="false">int</type>
178
  </tag>
179
+ <tag line="224" name="return" description="revised arguments suitable for WP_Query" type="array">
180
  <type by_reference="false">array</type>
181
  </tag>
182
  </docblock>
183
+ <argument line="238">
184
  <name>$raw_request</name>
185
  <default><![CDATA[]]></default>
186
  <type/>
187
  </argument>
188
+ <argument line="238">
189
  <name>$offset</name>
190
  <default><![CDATA[0]]></default>
191
  <type/>
192
  </argument>
193
+ <argument line="238">
194
  <name>$count</name>
195
  <default><![CDATA[0]]></default>
196
  <type/>
197
  </argument>
198
  </method>
199
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="409" package="Media Library Assistant">
200
  <name>_execute_list_table_query</name>
201
  <full_name>_execute_list_table_query</full_name>
202
+ <docblock line="400">
203
  <description><![CDATA[Add filters, run query, remove filters]]></description>
204
  <long-description><![CDATA[]]></long-description>
205
+ <tag line="400" name="since" description="0.30"/>
206
+ <tag line="400" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
207
  <type by_reference="false">array</type>
208
  </tag>
209
+ <tag line="400" name="return" description="WP_Query object with query results" type="object">
210
  <type by_reference="false">object</type>
211
  </tag>
212
  </docblock>
213
+ <argument line="409">
214
  <name>$request</name>
215
  <default><![CDATA[]]></default>
216
  <type/>
217
  </argument>
218
  </method>
219
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="434" package="Media Library Assistant">
220
  <name>mla_query_posts_join_filter</name>
221
  <full_name>mla_query_posts_join_filter</full_name>
222
+ <docblock line="423">
223
  <description><![CDATA[Adds a JOIN clause, if required]]></description>
224
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
225
+ <tag line="423" name="since" description="0.30"/>
226
+ <tag line="423" name="param" description="query clause before modification" type="string" variable="$join_clause">
227
  <type by_reference="false">string</type>
228
  </tag>
229
+ <tag line="423" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
230
  <type by_reference="false">string</type>
231
  </tag>
232
  </docblock>
233
+ <argument line="434">
234
  <name>$join_clause</name>
235
  <default><![CDATA[]]></default>
236
  <type/>
237
  </argument>
238
  </method>
239
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="461" package="Media Library Assistant">
240
  <name>mla_query_posts_where_filter</name>
241
  <full_name>mla_query_posts_where_filter</full_name>
242
+ <docblock line="449">
243
  <description><![CDATA[Adds a WHERE clause for detached items]]></description>
244
  <long-description><![CDATA[<p>Modeled after _edit_attachments_query_helper in wp-admin/post.php.
245
  Defined as public because it's a filter.</p>]]></long-description>
246
+ <tag line="449" name="since" description="0.1"/>
247
+ <tag line="449" name="param" description="query clause before modification" type="string" variable="$where_clause">
248
  <type by_reference="false">string</type>
249
  </tag>
250
+ <tag line="449" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
251
  <type by_reference="false">string</type>
252
  </tag>
253
  </docblock>
254
+ <argument line="461">
255
  <name>$where_clause</name>
256
  <default><![CDATA[]]></default>
257
  <type/>
258
  </argument>
259
  </method>
260
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="482" package="Media Library Assistant">
261
  <name>mla_query_posts_orderby_filter</name>
262
  <full_name>mla_query_posts_orderby_filter</full_name>
263
+ <docblock line="470">
264
  <description><![CDATA[Adds a ORDERBY clause, if required]]></description>
265
  <long-description><![CDATA[<p>Expands the range of sort options because the logic in WP_Query is limited.
266
  Defined as public because it's a filter.</p>]]></long-description>
267
+ <tag line="470" name="since" description="0.30"/>
268
+ <tag line="470" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
269
  <type by_reference="false">string</type>
270
  </tag>
271
+ <tag line="470" name="return" description="updated query clause" type="string">
272
  <type by_reference="false">string</type>
273
  </tag>
274
  </docblock>
275
+ <argument line="482">
276
  <name>$orderby_clause</name>
277
  <default><![CDATA[]]></default>
278
  <type/>
279
  </argument>
280
  </method>
281
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="531" package="Media Library Assistant">
282
  <name>mla_get_attachment_by_id</name>
283
  <full_name>mla_get_attachment_by_id</full_name>
284
+ <docblock line="520">
285
  <description><![CDATA[Retrieve an Attachment array given a $post_id]]></description>
286
  <long-description><![CDATA[<p>The (associative) array will contain every field that can be found in
287
  the posts and postmeta tables, and all references to the attachment.</p>]]></long-description>
288
+ <tag line="520" name="since" description="0.1"/>
289
+ <tag line="520" name="param" description="The ID of the attachment post" type="int" variable="$post_id">
290
  <type by_reference="false">int</type>
291
  </tag>
292
+ <tag line="520" name="return" description="NULL on failure else associative array" type="NULL|array">
293
  <type by_reference="false">NULL</type>
294
  <type by_reference="false">array</type>
295
  </tag>
296
  </docblock>
297
+ <argument line="531">
298
  <name>$post_id</name>
299
  <default><![CDATA[]]></default>
300
  <type/>
301
  </argument>
302
  </method>
303
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="580" package="Media Library Assistant">
304
  <name>mla_fetch_attachment_references</name>
305
  <full_name>mla_fetch_attachment_references</full_name>
306
+ <docblock line="567">
307
  <description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
308
  <long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
309
  as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
310
+ <tag line="567" name="since" description="0.1"/>
311
+ <tag line="567" name="param" description="post ID of attachment" type="int" variable="$ID">
312
  <type by_reference="false">int</type>
313
  </tag>
314
+ <tag line="567" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent">
315
  <type by_reference="false">int</type>
316
  </tag>
317
+ <tag line="567" name="return" description="Reference information; see $references array comments" type="array">
318
  <type by_reference="false">array</type>
319
  </tag>
320
  </docblock>
321
+ <argument line="580">
322
  <name>$ID</name>
323
  <default><![CDATA[]]></default>
324
  <type/>
325
  </argument>
326
+ <argument line="580">
327
  <name>$parent</name>
328
  <default><![CDATA[]]></default>
329
  <type/>
330
  </argument>
331
  </method>
332
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="727" package="Media Library Assistant">
333
  <name>_fetch_attachment_parent_data</name>
334
  <full_name>_fetch_attachment_parent_data</full_name>
335
+ <docblock line="718">
336
  <description><![CDATA[Returns information about an attachment's parent, if found]]></description>
337
  <long-description><![CDATA[]]></long-description>
338
+ <tag line="718" name="since" description="0.1"/>
339
+ <tag line="718" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent_id">
340
  <type by_reference="false">int</type>
341
  </tag>
342
+ <tag line="718" name="return" description="Parent information; post_date, post_title and post_type" type="array">
343
  <type by_reference="false">array</type>
344
  </tag>
345
  </docblock>
346
+ <argument line="727">
347
  <name>$parent_id</name>
348
  <default><![CDATA[]]></default>
349
  <type/>
350
  </argument>
351
  </method>
352
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="755" package="Media Library Assistant">
353
  <name>_fetch_attachment_metadata</name>
354
  <full_name>_fetch_attachment_metadata</full_name>
355
+ <docblock line="742">
356
  <description><![CDATA[Fetch and filter meta data for an attachment]]></description>
357
  <long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
358
  are stripped out or converted to an 'mla</em>' equivalent. Array data is replaced with
359
  a string containing the first array element.</p>]]></long-description>
360
+ <tag line="742" name="since" description="0.1"/>
361
+ <tag line="742" name="param" description="post ID of attachment" type="int" variable="$post_id">
362
  <type by_reference="false">int</type>
363
  </tag>
364
+ <tag line="742" name="return" description="Meta data variables" type="array">
365
  <type by_reference="false">array</type>
366
  </tag>
367
  </docblock>
368
+ <argument line="755">
369
  <name>$post_id</name>
370
  <default><![CDATA[]]></default>
371
  <type/>
1170
  </method>
1171
  </class>
1172
  </file>
1173
+ <file path="includes\class-mla-main.php" hash="2c8f9915bf1378a0a98232a27894e3a0" package="Media Library Assistant">
1174
  <docblock line="2">
1175
  <description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
1176
  <long-description><![CDATA[]]></long-description>
1207
  <constant namespace="global" line="41" package="Media Library Assistant">
1208
  <name>CURRENT_MLA_VERSION</name>
1209
  <full_name>CURRENT_MLA_VERSION</full_name>
1210
+ <value><![CDATA['0.50']]></value>
1211
  <docblock line="34">
1212
  <description><![CDATA[Current version number]]></description>
1213
  <long-description><![CDATA[]]></long-description>
1455
  <type/>
1456
  </argument>
1457
  </method>
1458
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="263" package="Media Library Assistant">
1459
  <name>mla_admin_menu_action</name>
1460
  <full_name>mla_admin_menu_action</full_name>
1461
+ <docblock line="250">
1462
  <description><![CDATA[Add the submenu pages]]></description>
1463
  <long-description><![CDATA[<p>Add a submenu page in the "Media" section,
1464
  add submenu page(s) for attachment taxonomies,
1465
  add filter to clean up taxonomy submenu labels
1466
  add settings page in the "Settings" section,
1467
  add settings link in the Plugins section entry for MLA.</p>]]></long-description>
1468
+ <tag line="250" name="since" description="0.1"/>
1469
+ <tag line="250" name="return" description="" type="void">
1470
  <type by_reference="false">void</type>
1471
  </tag>
1472
  </docblock>
1473
  </method>
1474
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="294" package="Media Library Assistant">
1475
  <name>mla_add_menu_options</name>
1476
  <full_name>mla_add_menu_options</full_name>
1477
+ <docblock line="287">
1478
  <description><![CDATA[Add the "XX Entries per page" filter to the Screen Options tab]]></description>
1479
  <long-description><![CDATA[]]></long-description>
1480
+ <tag line="287" name="since" description="0.1"/>
1481
+ <tag line="287" name="return" description="" type="void">
1482
  <type by_reference="false">void</type>
1483
  </tag>
1484
  </docblock>
1485
  </method>
1486
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="316" package="Media Library Assistant">
1487
  <name>mla_screen_options_show_screen_filter</name>
1488
  <full_name>mla_screen_options_show_screen_filter</full_name>
1489
+ <docblock line="306">
1490
  <description><![CDATA[Only show screen options on the table-list screen]]></description>
1491
  <long-description><![CDATA[]]></long-description>
1492
+ <tag line="306" name="since" description="0.1"/>
1493
+ <tag line="306" name="param" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean" variable="$show_screen">
1494
  <type by_reference="false">boolean</type>
1495
  </tag>
1496
+ <tag line="306" name="param" description="Name of the page being loaded" type="string" variable="$this_screen">
1497
  <type by_reference="false">string</type>
1498
  </tag>
1499
+ <tag line="306" name="return" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean">
1500
  <type by_reference="false">boolean</type>
1501
  </tag>
1502
  </docblock>
1503
+ <argument line="316">
1504
  <name>$show_screen</name>
1505
  <default><![CDATA[]]></default>
1506
  <type/>
1507
  </argument>
1508
+ <argument line="316">
1509
  <name>$this_screen</name>
1510
  <default><![CDATA[]]></default>
1511
  <type/>
1512
  </argument>
1513
  </method>
1514
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="334" package="Media Library Assistant">
1515
  <name>mla_set_screen_option_filter</name>
1516
  <full_name>mla_set_screen_option_filter</full_name>
1517
+ <docblock line="323">
1518
  <description><![CDATA[Save the "Entries per page" option set by this user]]></description>
1519
  <long-description><![CDATA[]]></long-description>
1520
+ <tag line="323" name="since" description="0.1"/>
1521
+ <tag line="323" name="param" description="Unknown - always false?" type="boolean" variable="$status">
1522
  <type by_reference="false">boolean</type>
1523
  </tag>
1524
+ <tag line="323" name="param" description="Name of the option being changed" type="string" variable="$option">
1525
  <type by_reference="false">string</type>
1526
  </tag>
1527
+ <tag line="323" name="param" description="New value of the option" type="string" variable="$value">
1528
  <type by_reference="false">string</type>
1529
  </tag>
1530
+ <tag line="323" name="return" description="New value if this is our option, otherwise nothing" type="string|void">
1531
  <type by_reference="false">string</type>
1532
  <type by_reference="false">void</type>
1533
  </tag>
1534
  </docblock>
1535
+ <argument line="334">
1536
  <name>$status</name>
1537
  <default><![CDATA[]]></default>
1538
  <type/>
1539
  </argument>
1540
+ <argument line="334">
1541
  <name>$option</name>
1542
  <default><![CDATA[]]></default>
1543
  <type/>
1544
  </argument>
1545
+ <argument line="334">
1546
  <name>$value</name>
1547
  <default><![CDATA[]]></default>
1548
  <type/>
1549
  </argument>
1550
  </method>
1551
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="350" package="Media Library Assistant">
1552
  <name>mla_edit_tax_redirect</name>
1553
  <full_name>mla_edit_tax_redirect</full_name>
1554
+ <docblock line="340">
1555
  <description><![CDATA[Redirect to the Edit Tags/Categories page]]></description>
1556
  <long-description><![CDATA[<p>The custom taxonomy add/edit submenu entries go to "upload.php" by default.
1557
  This filter is the only way to redirect them to the correct WordPress page.</p>]]></long-description>
1558
+ <tag line="340" name="since" description="0.1"/>
1559
+ <tag line="340" name="return" description="" type="void">
1560
  <type by_reference="false">void</type>
1561
  </tag>
1562
  </docblock>
1563
  </method>
1564
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="368" package="Media Library Assistant">
1565
  <name>mla_add_help_tab</name>
1566
  <full_name>mla_add_help_tab</full_name>
1567
+ <docblock line="361">
1568
  <description><![CDATA[Add contextual help tabs to all the MLA pages]]></description>
1569
  <long-description><![CDATA[]]></long-description>
1570
+ <tag line="361" name="since" description="0.1"/>
1571
+ <tag line="361" name="return" description="" type="void">
1572
  <type by_reference="false">void</type>
1573
  </tag>
1574
  </docblock>
1575
  </method>
1576
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="460" package="Media Library Assistant">
1577
  <name>mla_modify_parent_menu</name>
1578
  <full_name>mla_modify_parent_menu</full_name>
1579
+ <docblock line="447">
1580
  <description><![CDATA[Cleanup menus for Edit Tags/Categories page]]></description>
1581
  <long-description><![CDATA[<p>The submenu entries for custom taxonomies under the "Media" menu are not set up
1582
  correctly by WordPress, so this function cleans them up, redirecting the request
1583
  to the right WordPress page for editing/adding taxonomy terms.</p>]]></long-description>
1584
+ <tag line="447" name="since" description="0.1"/>
1585
+ <tag line="447" name="param" description="The top-level menu page" type="array" variable="$parent_file">
1586
  <type by_reference="false">array</type>
1587
  </tag>
1588
+ <tag line="447" name="return" description="The updated top-level menu page" type="string">
1589
  <type by_reference="false">string</type>
1590
  </tag>
1591
  </docblock>
1592
+ <argument line="460">
1593
  <name>$parent_file</name>
1594
  <default><![CDATA[]]></default>
1595
  <type/>
1596
  </argument>
1597
  </method>
1598
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="491" package="Media Library Assistant">
1599
  <name>mla_render_admin_page</name>
1600
  <full_name>mla_render_admin_page</full_name>
1601
+ <docblock line="484">
1602
  <description><![CDATA[Render the "Assistant" subpage in the Media section, using the list_table package]]></description>
1603
  <long-description><![CDATA[]]></long-description>
1604
+ <tag line="484" name="since" description="0.1"/>
1605
+ <tag line="484" name="return" description="" type="void">
1606
  <type by_reference="false">void</type>
1607
  </tag>
1608
  </docblock>
1609
  </method>
1610
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="689" package="Media Library Assistant">
1611
  <name>mla_inline_edit_action</name>
1612
  <full_name>mla_inline_edit_action</full_name>
1613
+ <docblock line="680">
1614
  <description><![CDATA[Ajax handler for inline editing (quick and bulk edit)]]></description>
1615
  <long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
1616
+ <tag line="680" name="since" description="0.20"/>
1617
+ <tag line="680" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
1618
  <type by_reference="false">void</type>
1619
  </tag>
1620
  </docblock>
1621
  </method>
1622
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="758" package="Media Library Assistant">
1623
  <name>_build_inline_edit_form</name>
1624
  <full_name>_build_inline_edit_form</full_name>
1625
+ <docblock line="747">
1626
  <description><![CDATA[Build the hidden row templates for inline editing (quick and bulk edit)]]></description>
1627
  <long-description><![CDATA[<p>inspired by inline_edit() in wp-admin\includes\class-wp-posts-list-table.php.</p>]]></long-description>
1628
+ <tag line="747" name="since" description="0.20"/>
1629
+ <tag line="747" name="param" description="MLA List Table object" type="object" variable="$MLAListTable">
1630
  <type by_reference="false">object</type>
1631
  </tag>
1632
+ <tag line="747" name="return" description="HTML &lt;form&gt; markup for hidden rows" type="string">
1633
  <type by_reference="false">string</type>
1634
  </tag>
1635
  </docblock>
1636
+ <argument line="758">
1637
  <name>$MLAListTable</name>
1638
  <default><![CDATA[]]></default>
1639
  <type/>
1640
  </argument>
1641
  </method>
1642
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="885" package="Media Library Assistant">
1643
  <name>_authors_dropdown</name>
1644
  <full_name>_authors_dropdown</full_name>
1645
+ <docblock line="874">
1646
  <description><![CDATA[Get the edit Authors dropdown box, if user has suitable permissions]]></description>
1647
  <long-description><![CDATA[]]></long-description>
1648
+ <tag line="874" name="since" description="0.20"/>
1649
+ <tag line="874" name="param" description="User ID of the current author" type="integer" variable="$author">
1650
  <type by_reference="false">integer</type>
1651
  </tag>
1652
+ <tag line="874" name="param" description="HTML name attribute" type="string" variable="$name">
1653
  <type by_reference="false">string</type>
1654
  </tag>
1655
+ <tag line="874" name="param" description="HTML class attribute" type="string" variable="$class">
1656
  <type by_reference="false">string</type>
1657
  </tag>
1658
+ <tag line="874" name="return" description="HTML markup for the dropdown field or False" type="string|false">
1659
  <type by_reference="false">string</type>
1660
  <type by_reference="false">false</type>
1661
  </tag>
1662
  </docblock>
1663
+ <argument line="885">
1664
  <name>$author</name>
1665
  <default><![CDATA[0]]></default>
1666
  <type/>
1667
  </argument>
1668
+ <argument line="885">
1669
  <name>$name</name>
1670
  <default><![CDATA['post_author']]></default>
1671
  <type/>
1672
  </argument>
1673
+ <argument line="885">
1674
  <name>$class</name>
1675
  <default><![CDATA['authors']]></default>
1676
  <type/>
1677
  </argument>
1678
  </method>
1679
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="917" package="Media Library Assistant">
1680
  <name>_current_bulk_action</name>
1681
  <full_name>_current_bulk_action</full_name>
1682
+ <docblock line="910">
1683
  <description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
1684
  <long-description><![CDATA[]]></long-description>
1685
+ <tag line="910" name="since" description="0.1"/>
1686
+ <tag line="910" name="return" description="The action name or False if no action was selected" type="string|false">
1687
  <type by_reference="false">string</type>
1688
  <type by_reference="false">false</type>
1689
  </tag>
1690
  </docblock>
1691
  </method>
1692
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="947" package="Media Library Assistant">
1693
  <name>_delete_single_item</name>
1694
  <full_name>_delete_single_item</full_name>
1695
+ <docblock line="938">
1696
  <description><![CDATA[Delete a single item permanently]]></description>
1697
  <long-description><![CDATA[]]></long-description>
1698
+ <tag line="938" name="since" description="0.1"/>
1699
+ <tag line="938" name="param" description="The form POST data" type="array" variable="$post_id">
1700
  <type by_reference="false">array</type>
1701
  </tag>
1702
+ <tag line="938" name="return" description="success/failure message and NULL content" type="array">
1703
  <type by_reference="false">array</type>
1704
  </tag>
1705
  </docblock>
1706
+ <argument line="947">
1707
  <name>$post_id</name>
1708
  <default><![CDATA[]]></default>
1709
  <type/>
1710
  </argument>
1711
  </method>
1712
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="976" package="Media Library Assistant">
1713
  <name>_display_single_item</name>
1714
  <full_name>_display_single_item</full_name>
1715
+ <docblock line="966">
1716
  <description><![CDATA[Display a single item sub page; prepare the form to
1717
  change the meta data for a single attachment.]]></description>
1718
  <long-description><![CDATA[]]></long-description>
1719
+ <tag line="966" name="since" description="0.1"/>
1720
+ <tag line="966" name="param" description="The WordPress Post ID of the attachment item" type="int" variable="$post_id">
1721
  <type by_reference="false">int</type>
1722
  </tag>
1723
+ <tag line="966" name="return" description="message and/or HTML content" type="array">
1724
  <type by_reference="false">array</type>
1725
  </tag>
1726
  </docblock>
1727
+ <argument line="976">
1728
  <name>$post_id</name>
1729
  <default><![CDATA[]]></default>
1730
  <type/>
1731
  </argument>
1732
  </method>
1733
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1190" package="Media Library Assistant">
1734
  <name>_update_single_item</name>
1735
  <full_name>_update_single_item</full_name>
1736
+ <docblock line="1177">
1737
  <description><![CDATA[Update a single item; change the meta data
1738
  for a single attachment.]]></description>
1739
  <long-description><![CDATA[]]></long-description>
1740
+ <tag line="1177" name="since" description="0.1"/>
1741
+ <tag line="1177" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
1742
  <type by_reference="false">int</type>
1743
  </tag>
1744
+ <tag line="1177" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_data">
1745
  <type by_reference="false">array</type>
1746
  </tag>
1747
+ <tag line="1177" name="param" description="Taxonomy term values" type="array" variable="$tax_input">
1748
  <type by_reference="false">array</type>
1749
  </tag>
1750
+ <tag line="1177" name="param" description="Taxonomy actions (add, remove, replace)" type="array" variable="$tax_actions">
1751
  <type by_reference="false">array</type>
1752
  </tag>
1753
+ <tag line="1177" name="return" description="success/failure message and NULL content" type="array">
1754
  <type by_reference="false">array</type>
1755
  </tag>
1756
  </docblock>
1757
+ <argument line="1190">
1758
  <name>$post_id</name>
1759
  <default><![CDATA[]]></default>
1760
  <type/>
1761
  </argument>
1762
+ <argument line="1190">
1763
  <name>$new_data</name>
1764
  <default><![CDATA[]]></default>
1765
  <type/>
1766
  </argument>
1767
+ <argument line="1190">
1768
  <name>$tax_input</name>
1769
  <default><![CDATA[NULL]]></default>
1770
  <type/>
1771
  </argument>
1772
+ <argument line="1190">
1773
  <name>$tax_actions</name>
1774
  <default><![CDATA[NULL]]></default>
1775
  <type/>
1776
  </argument>
1777
  </method>
1778
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1373" package="Media Library Assistant">
1779
  <name>_remove_tags</name>
1780
  <full_name>_remove_tags</full_name>
1781
+ <docblock line="1362">
1782
  <description><![CDATA[Remove tags from a term ids list]]></description>
1783
  <long-description><![CDATA[]]></long-description>
1784
+ <tag line="1362" name="since" description="0.40"/>
1785
+ <tag line="1362" name="param" description="The term ids currently assigned" type="array" variable="$terms_before">
1786
  <type by_reference="false">array</type>
1787
  </tag>
1788
+ <tag line="1362" name="param" description="| string The term ids (array) or names (string) to remove" type="array" variable="$tags">
1789
  <type by_reference="false">array</type>
1790
  </tag>
1791
+ <tag line="1362" name="param" description="The taxonomy object" type="object" variable="$taxonomy_obj">
1792
  <type by_reference="false">object</type>
1793
  </tag>
1794
+ <tag line="1362" name="return" description="Term ids of the surviving tags" type="array">
1795
  <type by_reference="false">array</type>
1796
  </tag>
1797
  </docblock>
1798
+ <argument line="1373">
1799
  <name>$terms_before</name>
1800
  <default><![CDATA[]]></default>
1801
  <type/>
1802
  </argument>
1803
+ <argument line="1373">
1804
  <name>$tags</name>
1805
  <default><![CDATA[]]></default>
1806
  <type/>
1807
  </argument>
1808
+ <argument line="1373">
1809
  <name>$taxonomy_obj</name>
1810
  <default><![CDATA[]]></default>
1811
  <type/>
1812
  </argument>
1813
  </method>
1814
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1415" package="Media Library Assistant">
1815
  <name>_restore_single_item</name>
1816
  <full_name>_restore_single_item</full_name>
1817
+ <docblock line="1406">
1818
  <description><![CDATA[Restore a single item from the Trash]]></description>
1819
  <long-description><![CDATA[]]></long-description>
1820
+ <tag line="1406" name="since" description="0.1"/>
1821
+ <tag line="1406" name="param" description="The form POST data" type="array" variable="$post_id">
1822
  <type by_reference="false">array</type>
1823
  </tag>
1824
+ <tag line="1406" name="return" description="success/failure message and NULL content" type="array">
1825
  <type by_reference="false">array</type>
1826
  </tag>
1827
  </docblock>
1828
+ <argument line="1415">
1829
  <name>$post_id</name>
1830
  <default><![CDATA[]]></default>
1831
  <type/>
1832
  </argument>
1833
  </method>
1834
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1451" package="Media Library Assistant">
1835
  <name>_trash_single_item</name>
1836
  <full_name>_trash_single_item</full_name>
1837
+ <docblock line="1442">
1838
  <description><![CDATA[Move a single item to Trash]]></description>
1839
  <long-description><![CDATA[]]></long-description>
1840
+ <tag line="1442" name="since" description="0.1"/>
1841
+ <tag line="1442" name="param" description="The form POST data" type="array" variable="$post_id">
1842
  <type by_reference="false">array</type>
1843
  </tag>
1844
+ <tag line="1442" name="return" description="success/failure message and NULL content" type="array">
1845
  <type by_reference="false">array</type>
1846
  </tag>
1847
  </docblock>
1848
+ <argument line="1451">
1849
  <name>$post_id</name>
1850
  <default><![CDATA[]]></default>
1851
  <type/>
1853
  </method>
1854
  </class>
1855
  </file>
1856
+ <file path="includes\class-mla-objects.php" hash="365a8f71e063969bed4a81d103c220a6" package="Media Library Assistant">
1857
  <docblock line="2">
1858
  <description><![CDATA[Media Library Assistant Custom Taxonomy and Post Type objects]]></description>
1859
  <long-description><![CDATA[]]></long-description>
1894
  </tag>
1895
  </docblock>
1896
  </method>
1897
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="114" package="Media Library Assistant">
1898
  <name>mla_taxonomy_get_columns_filter</name>
1899
  <full_name>mla_taxonomy_get_columns_filter</full_name>
1900
+ <docblock line="104">
1901
  <description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
1902
  which replaces the "Posts" column with an equivalent "Attachments" column.]]></description>
1903
  <long-description><![CDATA[]]></long-description>
1904
+ <tag line="104" name="since" description="0.30"/>
1905
+ <tag line="104" name="param" description="column definitions for the edit taxonomy list table" type="array" variable="$columns">
1906
  <type by_reference="false">array</type>
1907
  </tag>
1908
+ <tag line="104" name="return" description="updated column definitions for the edit taxonomy list table" type="array">
1909
  <type by_reference="false">array</type>
1910
  </tag>
1911
  </docblock>
1912
+ <argument line="114">
1913
  <name>$columns</name>
1914
  <default><![CDATA[]]></default>
1915
  <type/>
1916
  </argument>
1917
  </method>
1918
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="140" package="Media Library Assistant">
1919
  <name>mla_taxonomy_column_filter</name>
1920
  <full_name>mla_taxonomy_column_filter</full_name>
1921
+ <docblock line="127">
1922
  <description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
1923
  which returns a count of the attachments assigned a given term]]></description>
1924
  <long-description><![CDATA[]]></long-description>
1925
+ <tag line="127" name="since" description="0.30"/>
1926
+ <tag line="127" name="param" description="current column value; always ''" type="string" variable="$place_holder">
1927
  <type by_reference="false">string</type>
1928
  </tag>
1929
+ <tag line="127" name="param" description="name of the column" type="array" variable="$column_name">
1930
  <type by_reference="false">array</type>
1931
  </tag>
1932
+ <tag line="127" name="param" description="ID of the term for which the count is desired" type="array" variable="$term_id">
1933
  <type by_reference="false">array</type>
1934
  </tag>
1935
+ <tag line="127" name="return" description="HTML markup for the column content; number of attachments in the category and alink to retrieve a list of them" type="array">
1936
  <type by_reference="false">array</type>
1937
  </tag>
1938
  </docblock>
1939
+ <argument line="140">
1940
  <name>$place_holder</name>
1941
  <default><![CDATA[]]></default>
1942
  <type/>
1943
  </argument>
1944
+ <argument line="140">
1945
  <name>$column_name</name>
1946
  <default><![CDATA[]]></default>
1947
  <type/>
1948
  </argument>
1949
+ <argument line="140">
1950
  <name>$term_id</name>
1951
  <default><![CDATA[]]></default>
1952
  <type/>
1954
  </method>
1955
  </class>
1956
  </file>
1957
+ <file path="includes\class-mla-settings.php" hash="0b5952919548fa0a7e29ad41d0f03940" package="Media Library Assistant">
1958
  <docblock line="2">
1959
  <description><![CDATA[Manages the plugin option settings and provides the settings page to edit them]]></description>
1960
  <long-description><![CDATA[]]></long-description>
2051
  </tag>
2052
  </docblock>
2053
  </method>
2054
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="187" package="Media Library Assistant">
2055
  <name>_version_upgrade</name>
2056
  <full_name>_version_upgrade</full_name>
2057
+ <docblock line="180">
2058
  <description><![CDATA[Database and option update check, for installing new versions]]></description>
2059
  <long-description><![CDATA[]]></long-description>
2060
+ <tag line="180" name="since" description="0.30"/>
2061
+ <tag line="180" name="return" description="" type="void">
2062
+ <type by_reference="false">void</type>
2063
+ </tag>
2064
+ </docblock>
2065
+ </method>
2066
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="229" package="Media Library Assistant">
2067
+ <name>_create_alt_text_view</name>
2068
+ <full_name>_create_alt_text_view</full_name>
2069
+ <docblock line="219">
2070
+ <description><![CDATA[Add a view to the database to support sorting the listing on 'ALT Text']]></description>
2071
+ <long-description><![CDATA[<p>This function is called on each plugin invocation because the plugin upgrade process
2072
+ does not call the activation hook.</p>]]></long-description>
2073
+ <tag line="219" name="since" description="0.50"/>
2074
+ <tag line="219" name="return" description="" type="void">
2075
  <type by_reference="false">void</type>
2076
  </tag>
2077
  </docblock>
2078
  </method>
2079
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="265" package="Media Library Assistant">
2080
  <name>mla_activation_hook</name>
2081
  <full_name>mla_activation_hook</full_name>
2082
+ <docblock line="256">
2083
  <description><![CDATA[Perform one-time actions on plugin activation]]></description>
2084
  <long-description><![CDATA[<p>Adds a view to the database to support sorting the listing on 'ALT Text'.</p>]]></long-description>
2085
+ <tag line="256" name="since" description="0.40"/>
2086
+ <tag line="256" name="return" description="" type="void">
2087
  <type by_reference="false">void</type>
2088
  </tag>
2089
  </docblock>
2090
  </method>
2091
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="278" package="Media Library Assistant">
2092
  <name>mla_deactivation_hook</name>
2093
  <full_name>mla_deactivation_hook</full_name>
2094
+ <docblock line="269">
2095
  <description><![CDATA[Perform one-time actions on plugin deactivation]]></description>
2096
  <long-description><![CDATA[<p>Removes a view from the database that supports sorting the listing on 'ALT Text'.</p>]]></long-description>
2097
+ <tag line="269" name="since" description="0.40"/>
2098
+ <tag line="269" name="return" description="" type="void">
2099
  <type by_reference="false">void</type>
2100
  </tag>
2101
  </docblock>
2102
  </method>
2103
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="309" package="Media Library Assistant">
2104
  <name>mla_admin_menu_action</name>
2105
  <full_name>mla_admin_menu_action</full_name>
2106
+ <docblock line="301">
2107
  <description><![CDATA[Add settings page in the "Settings" section,
2108
  add settings link in the Plugins section entry for MLA.]]></description>
2109
  <long-description><![CDATA[]]></long-description>
2110
+ <tag line="301" name="since" description="0.1"/>
2111
+ <tag line="301" name="return" description="" type="void">
2112
  <type by_reference="false">void</type>
2113
  </tag>
2114
  </docblock>
2115
  </method>
2116
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="327" package="Media Library Assistant">
2117
  <name>mla_add_plugin_settings_link</name>
2118
  <full_name>mla_add_plugin_settings_link</full_name>
2119
+ <docblock line="317">
2120
  <description><![CDATA[Add the "Settings" link to the MLA entry in the Plugins section]]></description>
2121
  <long-description><![CDATA[]]></long-description>
2122
+ <tag line="317" name="since" description="0.1"/>
2123
+ <tag line="317" name="param" description="array of links for the Plugin, e.g., &quot;Activate&quot;" type="array" variable="$links">
2124
  <type by_reference="false">array</type>
2125
  </tag>
2126
+ <tag line="317" name="param" description="Directory and name of the plugin Index file" type="string" variable="$file">
2127
  <type by_reference="false">string</type>
2128
  </tag>
2129
+ <tag line="317" name="return" description="Updated array of links for the Plugin" type="array">
2130
  <type by_reference="false">array</type>
2131
  </tag>
2132
  </docblock>
2133
+ <argument line="327">
2134
  <name>$links</name>
2135
  <default><![CDATA[]]></default>
2136
  <type/>
2137
  </argument>
2138
+ <argument line="327">
2139
  <name>$file</name>
2140
  <default><![CDATA[]]></default>
2141
  <type/>
2142
  </argument>
2143
  </method>
2144
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="345" package="Media Library Assistant">
2145
  <name>mla_get_option</name>
2146
  <full_name>mla_get_option</full_name>
2147
+ <docblock line="336">
2148
  <description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
2149
  <long-description><![CDATA[]]></long-description>
2150
+ <tag line="336" name="since" description="0.1"/>
2151
+ <tag line="336" name="param" description="Name of the desired option" type="string" variable="$option">
2152
  <type by_reference="false">string</type>
2153
  </tag>
2154
+ <tag line="336" name="return" description="Value(s) for the option or false if the option is not a defined MLA option" type="mixed">
2155
  <type by_reference="false">mixed</type>
2156
  </tag>
2157
  </docblock>
2158
+ <argument line="345">
2159
  <name>$option</name>
2160
  <default><![CDATA[]]></default>
2161
  <type/>
2162
  </argument>
2163
  </method>
2164
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="366" package="Media Library Assistant">
2165
  <name>mla_update_option</name>
2166
  <full_name>mla_update_option</full_name>
2167
+ <docblock line="356">
2168
  <description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
2169
  <long-description><![CDATA[]]></long-description>
2170
+ <tag line="356" name="since" description="0.1"/>
2171
+ <tag line="356" name="param" description="Name of the desired option" type="string" variable="$option">
2172
  <type by_reference="false">string</type>
2173
  </tag>
2174
+ <tag line="356" name="param" description="New value for the desired option" type="mixed" variable="$newvalue">
2175
  <type by_reference="false">mixed</type>
2176
  </tag>
2177
+ <tag line="356" name="return" description="True if the value was changed or false if the update failed" type="boolean">
2178
  <type by_reference="false">boolean</type>
2179
  </tag>
2180
  </docblock>
2181
+ <argument line="366">
2182
  <name>$option</name>
2183
  <default><![CDATA[]]></default>
2184
  <type/>
2185
  </argument>
2186
+ <argument line="366">
2187
  <name>$newvalue</name>
2188
  <default><![CDATA[]]></default>
2189
  <type/>
2190
  </argument>
2191
  </method>
2192
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="382" package="Media Library Assistant">
2193
  <name>mla_delete_option</name>
2194
  <full_name>mla_delete_option</full_name>
2195
+ <docblock line="373">
2196
  <description><![CDATA[Delete the stored value of a defined MLA option]]></description>
2197
  <long-description><![CDATA[]]></long-description>
2198
+ <tag line="373" name="since" description="0.1"/>
2199
+ <tag line="373" name="param" description="Name of the desired option" type="string" variable="$option">
2200
  <type by_reference="false">string</type>
2201
  </tag>
2202
+ <tag line="373" name="return" description="True if the option was deleted, otherwise false" type="boolean">
2203
  <type by_reference="false">boolean</type>
2204
  </tag>
2205
  </docblock>
2206
+ <argument line="382">
2207
  <name>$option</name>
2208
  <default><![CDATA[]]></default>
2209
  <type/>
2210
  </argument>
2211
  </method>
2212
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="397" package="Media Library Assistant">
2213
  <name>mla_render_settings_page</name>
2214
  <full_name>mla_render_settings_page</full_name>
2215
+ <docblock line="390">
2216
  <description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
2217
  <long-description><![CDATA[]]></long-description>
2218
+ <tag line="390" name="since" description="0.1"/>
2219
+ <tag line="390" name="return" description="Echoes HTML markup for the settings subpage" type="void">
2220
  <type by_reference="false">void</type>
2221
  </tag>
2222
  </docblock>
2223
  </method>
2224
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="619" package="Media Library Assistant">
2225
  <name>mla_taxonomy_support</name>
2226
  <full_name>mla_taxonomy_support</full_name>
2227
+ <docblock line="606">
2228
  <description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
2229
  settings are being updated or reset.]]></description>
2230
  <long-description><![CDATA[]]></long-description>
2231
+ <tag line="606" name="since" description="0.30"/>
2232
+ <tag line="606" name="param" description="Taxonomy name, e.g., attachment_category" type="string" variable="$tax_name">
2233
  <type by_reference="false">string</type>
2234
  </tag>
2235
+ <tag line="606" name="param" description="'support' (the default), 'quick-edit' or 'filter'" type="string" variable="$support_type">
2236
  <type by_reference="false">string</type>
2237
  </tag>
2238
+ <tag line="606" 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">
2239
  <type by_reference="false">boolean</type>
2240
  <type by_reference="false">string</type>
2241
  </tag>
2242
  </docblock>
2243
+ <argument line="619">
2244
  <name>$tax_name</name>
2245
  <default><![CDATA[]]></default>
2246
  <type/>
2247
  </argument>
2248
+ <argument line="619">
2249
  <name>$support_type</name>
2250
  <default><![CDATA['support']]></default>
2251
  <type/>
2252
  </argument>
2253
  </method>
2254
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="691" package="Media Library Assistant">
2255
  <name>_save_settings</name>
2256
  <full_name>_save_settings</full_name>
2257
+ <docblock line="682">
2258
  <description><![CDATA[Save settings to the options table]]></description>
2259
  <long-description><![CDATA[]]></long-description>
2260
+ <tag line="682" name="since" description="0.1"/>
2261
+ <tag line="682" name="param" description="HTML template(s) for the settings page" type="array" variable="$template_array">
2262
  <type by_reference="false">array</type>
2263
  </tag>
2264
+ <tag line="682" name="return" description="Message(s) reflecting the results of the operation" type="array">
2265
  <type by_reference="false">array</type>
2266
  </tag>
2267
  </docblock>
2268
+ <argument line="691">
2269
  <name>$template_array</name>
2270
  <default><![CDATA[]]></default>
2271
  <type/>
2272
  </argument>
2273
  </method>
2274
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="782" package="Media Library Assistant">
2275
  <name>_reset_settings</name>
2276
  <full_name>_reset_settings</full_name>
2277
+ <docblock line="773">
2278
  <description><![CDATA[Delete saved settings, restoring default values]]></description>
2279
  <long-description><![CDATA[]]></long-description>
2280
+ <tag line="773" name="since" description="0.1"/>
2281
+ <tag line="773" name="param" description="HTML template(s) for the settings page" type="array" variable="$template_array">
2282
  <type by_reference="false">array</type>
2283
  </tag>
2284
+ <tag line="773" name="return" description="Message(s) reflecting the results of the operation" type="array">
2285
  <type by_reference="false">array</type>
2286
  </tag>
2287
  </docblock>
2288
+ <argument line="782">
2289
  <name>$template_array</name>
2290
  <default><![CDATA[]]></default>
2291
  <type/>
2292
  </argument>
2293
  </method>
2294
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="825" package="Media Library Assistant">
2295
  <name>_taxonomy_handler</name>
2296
  <full_name>_taxonomy_handler</full_name>
2297
+ <docblock line="813">
2298
  <description><![CDATA[Render and manage other taxonomy support options, e.g., Categories and Post Tags]]></description>
2299
  <long-description><![CDATA[]]></long-description>
2300
+ <tag line="813" name="since" description="0.30"/>
2301
+ <tag line="813" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
2302
  <type by_reference="false">string</type>
2303
  </tag>
2304
+ <tag line="813" name="param" description="option name, e.g., 'taxonomy_support'" type="string" variable="$key">
2305
  <type by_reference="false">string</type>
2306
  </tag>
2307
+ <tag line="813" name="param" description="option parameters" type="array" variable="$value">
2308
  <type by_reference="false">array</type>
2309
  </tag>
2310
+ <tag line="813" name="param" description="The $page_template_array for 'render' else $_REQUEST" type="array" variable="$args">
2311
  <type by_reference="false">array</type>
2312
  </tag>
2313
+ <tag line="813" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
2314
  <type by_reference="false">string</type>
2315
  </tag>
2316
  </docblock>
2317
+ <argument line="825">
2318
  <name>$action</name>
2319
  <default><![CDATA[]]></default>
2320
  <type/>
2321
  </argument>
2322
+ <argument line="825">
2323
  <name>$key</name>
2324
  <default><![CDATA[]]></default>
2325
  <type/>
2326
  </argument>
2327
+ <argument line="825">
2328
  <name>$value</name>
2329
  <default><![CDATA[]]></default>
2330
  <type/>
2331
  </argument>
2332
+ <argument line="825">
2333
  <name>$args</name>
2334
  <default><![CDATA[]]></default>
2335
  <type/>
2337
  </method>
2338
  </class>
2339
  </file>
2340
+ <file path="includes\class-mla-shortcodes.php" hash="81880022f36a38665a25af8fc6e0734a" package="Media Library Assistant">
2341
  <docblock line="2">
2342
  <description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
2343
  <long-description><![CDATA[]]></long-description>
2366
  </tag>
2367
  </docblock>
2368
  </method>
2369
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="35" package="Media Library Assistant">
2370
  <name>mla_attachment_list_shortcode</name>
2371
  <full_name>mla_attachment_list_shortcode</full_name>
2372
+ <docblock line="28">
2373
  <description><![CDATA[WordPress Shortcode; renders a complete list of all attachments and references to them]]></description>
2374
  <long-description><![CDATA[]]></long-description>
2375
+ <tag line="28" name="since" description="0.1"/>
2376
+ <tag line="28" name="return" description="echoes HTML markup for the attachment list" type="void">
2377
  <type by_reference="false">void</type>
2378
  </tag>
2379
  </docblock>
2380
  </method>
2381
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="138" package="Media Library Assistant">
2382
+ <name>mla_gallery_shortcode</name>
2383
+ <full_name>mla_gallery_shortcode</full_name>
2384
+ <docblock line="125">
2385
+ <description><![CDATA[The MLA Gallery shortcode.]]></description>
2386
+ <long-description><![CDATA[<p>This is a superset of the WordPress Gallery shortcode for displaying images on a post,
2387
+ page or custom post type. It is adapted from /wp-includes/media.php gallery_shortcode.
2388
+ Enhancements include many additional selection parameters and full taxonomy support.</p>]]></long-description>
2389
+ <tag line="125" name="since" description=".50"/>
2390
+ <tag line="125" name="param" description="Attributes of the shortcode." type="array" variable="$attr">
2391
+ <type by_reference="false">array</type>
2392
+ </tag>
2393
+ <tag line="125" name="return" description="HTML content to display gallery." type="string">
2394
+ <type by_reference="false">string</type>
2395
+ </tag>
2396
+ </docblock>
2397
+ <argument line="138">
2398
+ <name>$attr</name>
2399
+ <default><![CDATA[]]></default>
2400
+ <type/>
2401
+ </argument>
2402
+ </method>
2403
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="514" package="Media Library Assistant">
2404
+ <name>_get_attachments</name>
2405
+ <full_name>_get_attachments</full_name>
2406
+ <docblock line="505">
2407
+ <description><![CDATA[Replaces /wp-includes/post.php function get_posts()]]></description>
2408
+ <long-description><![CDATA[]]></long-description>
2409
+ <tag line="505" name="since" description=".50"/>
2410
+ <tag line="505" name="param" description="Attributes of the shortcode" type="array" variable="$args">
2411
+ <type by_reference="false">array</type>
2412
+ </tag>
2413
+ <tag line="505" name="return" description="List of attachments returned from WP_Query" type="array">
2414
+ <type by_reference="false">array</type>
2415
+ </tag>
2416
+ </docblock>
2417
+ <argument line="514">
2418
+ <name>$args</name>
2419
+ <default><![CDATA[]]></default>
2420
+ <type/>
2421
+ </argument>
2422
+ </method>
2423
  </class>
2424
  </file>
2425
  <file path="includes\mla-plugin-loader.php" hash="9abec375c6f7ae5efd70d593750132ef" package="Media Library Assistant">
2461
  </docblock>
2462
  </constant>
2463
  </file>
2464
+ <file path="index.php" hash="30c4fdc78cd5d1ecc4d04cd0212f3b9f" package="Media Library Assistant">
2465
  <docblock line="2">
2466
  <description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
2467
  <long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
2468
  will the rest of the plugin be loaded and run.</p>]]></long-description>
2469
  <tag line="2" name="package" description="Media Library Assistant"/>
2470
+ <tag line="2" name="version" description="0.50"/>
2471
  </docblock>
2472
  <include line="103" type="Require Once" package="Media Library Assistant">
2473
  <name>includes/mla-plugin-loader.php</name>
readme.txt CHANGED
@@ -4,17 +4,18 @@ Donate link: http://fairtradejudaica.org/make-a-difference/donate/
4
  Tags: attachments, documents, gallery, image, images, media, library, media library, media-tags, media tags, tags, media categories, categories
5
  Requires at least: 3.3
6
  Tested up to: 3.4.2
7
- Stable tag: 0.41
8
  License: GPLv2 or later
9
  License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
 
11
- Provides several enhancements to the WordPress Media Library,
12
- such as full taxonomy support, bulk & quick edit actions and where-used reporting.
13
 
14
  == Description ==
15
 
16
  The Media Library Assistant provides several enhancements for managing the Media Library, including:
17
 
 
 
18
  * An inline "Bulk Edit" area; update author or parent, add, remove or replace taxonomy terms for several attachments at once.
19
  * An inline "Quick Edit" action for many common fields.
20
  * Complete support for ALL taxonomies, including the standard Categories and Tags, your custom taxonomies and the Assistant's pre-defined Att. Categories and Att. Tags. You can add taxonomy columns to the Assistant listing, filter on any taxonomy, assign terms and list the attachments for a term.
@@ -25,9 +26,9 @@ The Media Library Assistant provides several enhancements for managing the Media
25
  * Provides additional view filters for mime types and taxonomies
26
  * Provides many more listing columns (more than 15) to choose from
27
 
28
- The Assistant is designed to work like the standard Media Library pages, so the learning curve is short and gentle. Contextual help is provided on every new screen to highlight new features.
29
 
30
- This plugin was inspired by my work on the WordPress web site for our nonprofit, Fair Trade Judaica. If you find the Media Library Assistant plugin useful and would like to support a great cause, consider a <strong>tax-deductible</strong> donation to our work. Thank you!
31
 
32
  == Installation ==
33
 
@@ -37,9 +38,22 @@ This plugin was inspired by my work on the WordPress web site for our nonprofit,
37
  1. Visit the "Assistant" submenu in the Media admin section
38
  1. Click the Screen Options link to customize the display
39
  1. Use the enhanced Edit page to assign categories and tags
 
40
 
41
  == Frequently Asked Questions ==
42
 
 
 
 
 
 
 
 
 
 
 
 
 
43
  = Can the Assistant use the standard WordPress post Categories and Tags? =
44
 
45
  Yes! You can activate or deactivate support for Categories and Tags at any time by visiting the Media Library Assistant Settings page.
@@ -83,8 +97,13 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
83
 
84
  == Changelog ==
85
 
 
 
 
 
 
86
  = 0.41 =
87
- * Fix: SQL View now created for automatic plugin upgrades
88
 
89
  = 0.40 =
90
  * New: Bulk Edit area; update author or parent, add, remove or replace taxonomy terms for several attachments at once
@@ -127,6 +146,9 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
127
 
128
  == Upgrade Notice ==
129
 
 
 
 
130
  = 0.41 =
131
  Upgrade for the new Bulk Edit area; add, remove or replace taxonomy terms for several attachments at once. Sort your media listing on ALT Text, exclude revisions from where-used reporting.
132
 
@@ -145,6 +167,99 @@ You should upgrade to this version if you are getting "404 Not Found" errors whe
145
  = 0.1 =
146
  Initial release.
147
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
148
  == Help Summary ==
149
  <p><strong><em>Assistant Submenu - Attachment List Table</em></strong></p>
150
  <p><strong>Overview</strong></p>
@@ -211,7 +326,8 @@ Initial release.
211
  </ul>
212
  <p><strong>Attachments Column</strong></p>
213
  <p>The &#8220;Attachments&#8221; colunm at the right of the table gives you the number of attachments associated with each tag. You can click on the number to get a list of all the attachments with that tag. The heading on the list page(s) will display the tag value you&#8217;ve selected.</p>
214
- == Other Notes ==
 
215
 
216
  I have used and learned much from the following books (among many):
217
 
4
  Tags: attachments, documents, gallery, image, images, media, library, media library, media-tags, media tags, tags, media categories, categories
5
  Requires at least: 3.3
6
  Tested up to: 3.4.2
7
+ Stable tag: 0.50
8
  License: GPLv2 or later
9
  License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
 
11
+ Provides enhancements to the Media Library; powerful[mla_gallery], full taxonomy support, bulk & quick edit actions and where-used reporting.
 
12
 
13
  == Description ==
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](http://wordpress.org/extend/plugins/media-library-assistant/other_notes/ "Complete Documentation") is a superset of the [gallery] shortcode in the WordPress core; it is compatible with [gallery] and provides many enhancements. These include: 1) full support for WordPress categories, tags and custom taxonomies, 2) support for all post_mime_type values, not just images 3) media Library items need not be "attached" to the post.
18
+
19
  * An inline "Bulk Edit" area; update author or parent, add, remove or replace taxonomy terms for several attachments at once.
20
  * An inline "Quick Edit" action for many common fields.
21
  * Complete support for ALL taxonomies, including the standard Categories and Tags, your custom taxonomies and the Assistant's pre-defined Att. Categories and Att. Tags. You can add taxonomy columns to the Assistant listing, filter on any taxonomy, assign terms and list the attachments for a term.
26
  * Provides additional view filters for mime types and taxonomies
27
  * Provides many more listing columns (more than 15) to choose from
28
 
29
+ The Assistant is designed to work like the standard Media Library pages, so the learning curve is short and gentle. Contextual help is provided on every new screen to highlight new features. The [Other Notes section](http://wordpress.org/extend/plugins/media-library-assistant/other_notes/ "Click here, then scroll down for Help Summary") contains a summary of the help text following the [mla_gallery] documentation.
30
 
31
+ This plugin was inspired by my work on the WordPress web site for our nonprofit, Fair Trade Judaica. If you find the Media Library Assistant plugin useful and would like to support a great cause, consider a [<strong>tax-deductible</strong> donation](http://fairtradejudaica.org/make-a-difference/donate/ "Support Our Work") to our work. Thank you!
32
 
33
  == Installation ==
34
 
38
  1. Visit the "Assistant" submenu in the Media admin section
39
  1. Click the Screen Options link to customize the display
40
  1. Use the enhanced Edit page to assign categories and tags
41
+ 1. Use the [mla_gallery] shortcode to add galleries of images, documents and more to your posts and pages
42
 
43
  == Frequently Asked Questions ==
44
 
45
+ = How can I use Categories, Tags and custom taxonomies to select images for display in my posts and pages? =
46
+
47
+ The powerful [mla_gallery] shortcode supports almost all of the query flexibility provided by the WP_Query class. You can find [complete documentation](http://wordpress.org/extend/plugins/media-library-assistant/other_notes/ "Complete Documentation") in the Other Notes section.
48
+
49
+ = Can I use [mla_gallery] for attachments other than images? =
50
+
51
+ Yes! The [mla_gallery] shortcode supports all MIME types. You can build a gallery of your PDF documents, plain text files and other attachments. You can mix images and other MIME types in the same gallery, too; check out [the documentation](http://wordpress.org/extend/plugins/media-library-assistant/other_notes/ "Complete Documentation").
52
+
53
+ = Can I attach an image to more than one post or page? =
54
+
55
+ No; that's a structural limitation of the WordPress database. However, you can use Categories, Tags and custom taxonomies to organize your images and associate them with posts and pages in any way you like. The [mla_gallery] shortcode makes it easy.
56
+
57
  = Can the Assistant use the standard WordPress post Categories and Tags? =
58
 
59
  Yes! You can activate or deactivate support for Categories and Tags at any time by visiting the Media Library Assistant Settings page.
97
 
98
  == Changelog ==
99
 
100
+ = 0.50 =
101
+ * New: [mla_gallery] shortcode, a superset of the [gallery] shortcode that provides many enhancements. These include taxonomy support and all post_mime_type values (not just images). Media Library items need not be "attached" to the post.
102
+ * New: [mla_gallery] shortcode documentation added to Settings page
103
+ * New: Donate button and link added to Settings page
104
+
105
  = 0.41 =
106
+ * Fix: SQL View (supporting ALT Text sorting) now created for automatic plugin upgrades
107
 
108
  = 0.40 =
109
  * New: Bulk Edit area; update author or parent, add, remove or replace taxonomy terms for several attachments at once
146
 
147
  == Upgrade Notice ==
148
 
149
+ = 0.50 =
150
+ Upgrade for the new [mla_gallery] shortcode, a superset of the [gallery] shortcode that provides many enhancements. These include taxonomy support and all post_mime_type values (not just images).
151
+
152
  = 0.41 =
153
  Upgrade for the new Bulk Edit area; add, remove or replace taxonomy terms for several attachments at once. Sort your media listing on ALT Text, exclude revisions from where-used reporting.
154
 
167
  = 0.1 =
168
  Initial release.
169
 
170
+ ==MLA Gallery Shortcode==
171
+
172
+ The [mla_gallery] shortcode is used in a post, page or custom post type to add a gallery of images and/or other Media Library items (such as PDF documents). MLA Gallery is a superset of the [gallery] shortcode in the WordPress core; it is compatible with [gallery] and provides many enhancements. These include:
173
+
174
+ * Full support for WordPress categories, tags and custom taxonomies. You can select items with any of the taxonomy parameters documented in the WP_Query class.
175
+ * Support for all post_mime_type values, not just images.
176
+ * Media Library items need not be "attached" to the post. You can build a gallery with any combination of items in the Library using taxonomy terms, custom fields and more.
177
+
178
+ All of the options/parameters documented for the [gallery] shortcode are supported by the [mla_gallery] shortcode; you can find them in the WordPress Codex. Most of the parameters documented for the WP_Query class are also supported; see the WordPress Codex. Because the [mla_gallery] shortcode is designed to work with Media Library items, there are some parameter differences and extensions; these are documented below.
179
+
180
+ <h4>Include, Exclude</h4>
181
+
182
+ You can use "post_parent=all" to include or exclude attachments regardless of which post or page they are attached to. You can use "post_mime_type=all" to include or exclude attachments of all MIME types, not just images.
183
+
184
+ <h4>Size</h4>
185
+
186
+ The Size parameter specifies the image size to use for the thumbnail display. Valid values include "thumbnail", "medium", "large", "full" and any other additional image size that was registered with add_image_size(). The default value is "thumbnail". You can use "none" to suppress thumbnail display and substitute the item title string for the image.
187
+
188
+ The [mla_gallery] shortcode supports an additional Size value, "icon", which shows a 60x60 pixel thumbnail for image items and an appropriate icon for non-image items such as PDF or text files.
189
+
190
+ <h4>Order, Orderby</h4>
191
+
192
+ To order the gallery randomly, use "orderby=rand". To suppress gallery ordering you can use "orderby=none" or "order=rand".
193
+
194
+ The Orderby parameter specifies which database field is used to sort the gallery. You can order the gallery by any of the values documented for the WP_Query class reference in the Codex; you are NOT restricted to the values documented for the [gallery] shortcode.
195
+
196
+ <h4>Post ID, Post Parent</h4>
197
+
198
+ The "id" parameter lets you specify a post ID for your query. If the "id" parameter is not specified, the [mla_gallery] behavior differs from the [gallery] behavior. If your query uses taxonomy or custom field parameters, "author", "author_name" or "s" (search term), then the query will NOT be restricted to items attached to the current post. This lets you build a gallery with any combination of Media Library items that match the parameters.
199
+
200
+ You can use the "post_parent" to override the default behavior. If you set "post_parent" to a specific post ID, only the items attached to that post are displayed. If you set "post_parent" to "current", only the items attached to the current post are displayed. If you set "post_parent" to "all", the query will not have a post ID or post_parent parameter.
201
+
202
+ For example, `[mla_gallery tag="artisan"]` will display all images having the specified tag value, regardless of which post (if any) they are attached to. If you use `[mla_gallery tag="artisan" post_parent="current"]` it will display images having the specified tag value only if they are attached to the current post.
203
+
204
+ <h4>Author, Author Name</h4>
205
+
206
+ You can query by author's id or the "user_nicename" value (not the "display_name" value). Multiple author ID values are allowed, but only one author name value can be entered.
207
+
208
+ <h4>Category Parameters</h4>
209
+
210
+ Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
211
+
212
+ <h4>Tag Parameters</h4>
213
+
214
+ Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
215
+
216
+ Note that the "tag_id" parameter requires exactly one tag ID; multiple IDs are not allowed. You can use the "tag__in" parameter to query for multiple values.
217
+
218
+ <h4>Taxonomy Parameters</h4>
219
+
220
+ The [mla_gallery] shortcode supports the simple "{tax} (string)" values (deprecated as of WordPress version 3.1) as well as the more powerful "tax_query" value.
221
+
222
+ For simple queries, enter the taxonomy name and the term(s) that must be matched, e.g.:
223
+
224
+ * `[mla_gallery attachment_category='separate-category,another-category']`
225
+
226
+ Note that you must use the name/slug strings for taxonomy and terms, not the "title" strings.
227
+
228
+ More complex queries can be specified by using "tax_query", e.g.:
229
+
230
+ * `[mla_gallery tax_query="array(array('taxonomy' => 'attachment_tag','field' => 'slug','terms' => 'artisan'))"]`
231
+ * `[mla_gallery tax_query="array(array('taxonomy' => 'attachment_category','field' => 'id','terms' => array(11, 12)))" post_parent=current post_mime_type='']`
232
+
233
+ The first example is equivalent to the simple query "attachment_tag=artisan". The second example matches items of all MIME types, attached to the current post, having an attachment_category ID of 11 or 12.
234
+
235
+ When embedding the shortcode in the body of a post, be very careful when coding the tax_query; it must be a valid PHP array specification. In particular, code the query on one line; splitting it across lines can insert HTML &#8249;br&#8250; tags and corrupt your query.
236
+
237
+ Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
238
+
239
+ <h4>Post Type, Post Status and Post MIME Type</h4>
240
+
241
+ For compatibility with the WordPress [gallery] shortcode, these parameters default to "post_type=attachment", "post_status=inherit" and "post_mime_type=image". You can override the defaults to, for example, display items in the trash ("post_status=trash") or PDF documents ("post_mime_type=application/pdf") or all MIME types ("post_mime_type=all"). I'm not sure why you'd want to override "post_type", but you are welcome to experiment and let me know what you find.
242
+
243
+ <h4>Pagination Parameters</h4>
244
+
245
+ The [mla_gallery] shortcode supplies "nopaging=true" as a default parameter. If you are working with a template that supports pagination you can replace this with specific values for "posts_per_page", "posts_per_archive_page", "paged" and/or "offset" . You can also pass "paged=current" to suppress the "nopaging" default; "current" will be replaced by the appropriate value (get_query_var('paged')).
246
+
247
+ <h4>Time Parameters</h4>
248
+
249
+ Support for time parameters is not included in the current version. I may add it later - let me know if you need it.
250
+
251
+ <h4>Custom Field Parameters</h4>
252
+
253
+ The [mla_gallery] shortcode supports the simple custom field parameters as well as the more powerful "meta_query" parameters made available as of WordPress 3.1.
254
+
255
+ When embedding the shortcode in the body of a post, be very careful when coding the meta_query; it must be a valid PHP array specification. In particular, code the query on one line; splitting it across lines can insert HTML <br> tags and corrupt your query.
256
+
257
+ Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
258
+
259
+ <h4>Search Keywords</h4>
260
+
261
+ The search parameter ("s=keyword") will perform a keyword search. A cursory inspection of the code in /wp-includes/query.php reveals that the search includes the "post_title" and "post_content" (Description) fields but not the "post_excerpt" (Caption) field. An SQL "LIKE" clause is composed and added to the search criteria. I haven't done much testing of this parameter.
262
+
263
  == Help Summary ==
264
  <p><strong><em>Assistant Submenu - Attachment List Table</em></strong></p>
265
  <p><strong>Overview</strong></p>
326
  </ul>
327
  <p><strong>Attachments Column</strong></p>
328
  <p>The &#8220;Attachments&#8221; colunm at the right of the table gives you the number of attachments associated with each tag. You can click on the number to get a list of all the attachments with that tag. The heading on the list page(s) will display the tag value you&#8217;ve selected.</p>
329
+
330
+ == Acknowledgements ==
331
 
332
  I have used and learned much from the following books (among many):
333
 
tpls/admin-display-settings-page.tpl CHANGED
@@ -109,7 +109,7 @@
109
  </td>
110
  </tr>
111
  <!-- template="page" -->
112
- <div class="wrap">
113
  <div id="icon-options-general" class="icon32"><br/></div>
114
  <h2>Media Library Assistant [+version+] Settings</h2>
115
  [+messages+]
@@ -125,9 +125,134 @@
125
  [+_wpnonce+]
126
  [+_wp_http_referer+]
127
  </form>
 
 
 
 
 
 
 
 
 
 
128
  <h3>Plugin Documentation</h3>
129
  <p>
130
  If you are a developer interested in how this plugin is put together, you should
131
- have a look at the <a title="Consult the phpDocs documentation" href="[+phpDocs_url+]" target="_blank">phpDocs documentation</a>.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
132
  </p>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
133
  </div>
109
  </td>
110
  </tr>
111
  <!-- template="page" -->
112
+ <a name="backtotop"></a><div class="wrap">
113
  <div id="icon-options-general" class="icon32"><br/></div>
114
  <h2>Media Library Assistant [+version+] Settings</h2>
115
  [+messages+]
125
  [+_wpnonce+]
126
  [+_wp_http_referer+]
127
  </form>
128
+ <p>
129
+ <a href="#backtotop">Go to Top</a>
130
+ </p>
131
+ <h3>Support Our Work</h3>
132
+ <table width="700" border="0" cellpadding="10">
133
+ <tr>
134
+ <td><a href="http://fairtradejudaica.org/make-a-difference/donate/" title="Donate to FTJ" target="_blank" style="border: none;"><img border="0" src="http://fairtradejudaica.org/wp-content/uploads/newsletter/images/DonateButton.jpg" width="100" height="40" alt="Donate"></a></td>
135
+ <td>This plugin was inspired by my work on the WordPress web site for our nonprofit, Fair Trade Judaica. If you find the Media Library Assistant plugin useful and would like to support a great cause, consider a <a href="http://fairtradejudaica.org/make-a-difference/donate/" title="Donate to FTJ" target="_blank" style="font-weight:bold">tax-deductible donation</a> to our work. Thank you!</td>
136
+ </tr>
137
+ </table>
138
  <h3>Plugin Documentation</h3>
139
  <p>
140
  If you are a developer interested in how this plugin is put together, you should
141
+ have a look at the <a title="Consult the phpDocs documentation" href="[+phpDocs_url+]" target="_blank" style="font-size:14px; font-weight:bold">phpDocs documentation</a>.
142
+ </p>
143
+ <a name="mla_gallery"></a>
144
+ <p>
145
+ <a href="#backtotop">Go to Top</a>
146
+ </p>
147
+ <div class="mla_gallery_help" style="width:700px">
148
+ <h3>MLA Gallery Shortcode</h3>
149
+ <p>
150
+ The [mla_gallery] shortcode is used in a post, page or custom post type to add a gallery of images and/or other Media Library items (such as PDF documents). MLA Gallery is a superset of the [gallery] shortcode in the WordPress core; it is compatible with [gallery] and provides many enhancements. These include:
151
+ </p>
152
+ <ul class="mla_settings">
153
+ <li>Full support for WordPress categories, tags and custom taxonomies. You can select items with any of the taxonomy parameters documented in the WP_Query class.</li>
154
+ <li>Support for all post_mime_type values, not just images.</li>
155
+ <li>Media Library items need not be "attached" to the post. You can build a gallery with any combination of items in the Library using taxonomy terms, custom fields and more.</li>
156
+ </ul>
157
+ <p>
158
+ All of the options/parameters documented for the [gallery] shortcode are supported by the [mla_gallery] shortcode; you can find them in the WordPress Codex. Most of the parameters documented for the WP_Query class are also supported; see the WordPress Codex. Because the [mla_gallery] shortcode is designed to work with Media Library items, there are some parameter differences and extensions; these are documented below.
159
+ </p>
160
+ <h4>Include, Exclude</h4>
161
+ <p>
162
+ You can use "post_parent=all" to include or exclude attachments regardless of which post or page they are attached to. You can use "post_mime_type=all" to include or exclude attachments of all MIME types, not just images.
163
+ </p>
164
+ <h4>Size</h4>
165
+ <p>
166
+ The Size parameter specifies the image size to use for the thumbnail display. Valid values include "thumbnail", "medium", "large", "full" and any other additional image size that was registered with add_image_size(). The default value is "thumbnail". You can use "none" to suppress thumbnail display and substitute the item title string for the image.
167
+ </p>
168
+ <p>
169
+ The [mla_gallery] shortcode supports an additional Size value, "icon", which shows a 60x60 pixel thumbnail for image items and an appropriate icon for non-image items such as PDF or text files.
170
+ </p>
171
+ <h4>Order, Orderby</h4>
172
+ <p>
173
+ To order the gallery randomly, use "orderby=rand". To suppress gallery ordering you can use "orderby=none" or "order=rand".
174
+ </p>
175
+ <p>The Orderby parameter specifies which database field is used to sort the gallery. You can order the gallery by any of the values documented for the WP_Query class reference in the Codex; you are NOT restricted to the values documented for the [gallery] shortcode.
176
+ </p>
177
+ <h4>Post ID, Post Parent</h4>
178
+ <p>
179
+ The "id" parameter lets you specify a post ID for your query. If the "id" parameter is not specified, the [mla_gallery] behavior differs from the [gallery] behavior. If your query uses taxonomy or custom field parameters, "author", "author_name" or "s" (search term), then the query will NOT be restricted to items attached to the current post. This lets you build a gallery with any combination of Media Library items that match the parameters.
180
+ </p>
181
+ <p>
182
+ You can use the "post_parent" to override the default behavior. If you set "post_parent" to a specific post ID, only the items attached to that post are displayed. If you set "post_parent" to "current", only the items attached to the current post are displayed. If you set "post_parent" to "all", the query will not have a post ID or post_parent parameter.
183
+ </p>
184
+ <p>
185
+ For example, [mla_gallery tag="artisan"] will display all images having the specified tag value, regardless of which post (if any) they are attached to. If you use [mla_gallery tag="artisan" post_parent="current"] it will display images having the specified tag value only if they are attached to the current post.
186
+ </p>
187
+ <h4>Author, Author Name</h4>
188
+ <p>
189
+ You can query by author's id or the "user_nicename" value (not the "display_name" value). Multiple author ID values are allowed, but only one author name value can be entered.
190
+ </p>
191
+ <h4>Category Parameters</h4>
192
+ <p>
193
+ Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
194
+ </p>
195
+ <h4>Tag Parameters</h4>
196
+ <p>
197
+ Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
198
+ </p>
199
+ <p>
200
+ Note that the "tag_id" parameter requires exactly one tag ID; multiple IDs are not allowed. You can use the "tag__in" parameter to query for multiple values.
201
+ </p>
202
+ <h4>Taxonomy Parameters</h4>
203
+ <p>
204
+ The [mla_gallery] shortcode supports the simple "{tax} (string)" values (deprecated as of WordPress version 3.1) as well as the more powerful "tax_query" value.
205
+ </p>
206
+ <p>
207
+ For simple queries, enter the taxonomy name and the term(s) that must be matched, e.g.:
208
+ </p>
209
+ <ul class="mla_settings">
210
+ <li>[mla_gallery attachment_category='separate-category,another-category']</li>
211
+ </ul>
212
+ <p>
213
+ Note that you must use the name/slug strings for taxonomy and terms, not the "title" strings.
214
+ </p>
215
+ <p>
216
+ More complex queries can be specified by using "tax_query", e.g.:
217
+ </p>
218
+ <ul class="mla_settings">
219
+ <li>[mla_gallery tax_query="array(array('taxonomy' => 'attachment_tag','field' => 'slug','terms' => 'artisan'))"]</li>
220
+ <li>[mla_gallery tax_query="array(array('taxonomy' => 'attachment_category','field' => 'id','terms' => array(11, 12)))" post_parent=current post_mime_type='']</li>
221
+ </ul>
222
+ <p>
223
+ The first example is equivalent to the simple query "attachment_tag=artisan". The second example matches items of all MIME types, attached to the current post, having an attachment_category ID of 11 or 12.
224
+ </p>
225
+ <p>
226
+ When embedding the shortcode in the body of a post, be very careful when coding the tax_query; it must be a valid PHP array specification. In particular, code the query on one line; splitting it across lines can insert HTML &#8249;br&#8250; tags and corrupt your query.
227
+ </p>
228
+ <p>
229
+ Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
230
  </p>
231
+ <h4>Post Type, Post Status and Post MIME Type</h4>
232
+ <p>
233
+ For compatibility with the WordPress [gallery] shortcode, these parameters default to "post_type=attachment", "post_status=inherit" and "post_mime_type=image". You can override the defaults to, for example, display items in the trash ("post_status=trash") or PDF documents ("post_mime_type=application/pdf") or all MIME types ("post_mime_type=all"). I'm not sure why you'd want to override "post_type", but you are welcome to experiment and let me know what you find.
234
+ </p>
235
+ <h4>Pagination Parameters</h4>
236
+ <p>
237
+ The [mla_gallery] shortcode supplies "nopaging=true" as a default parameter. If you are working with a template that supports pagination you can replace this with specific values for "posts_per_page", "posts_per_archive_page", "paged" and/or "offset" . You can also pass "paged=current" to suppress the "nopaging" default; "current" will be replaced by the appropriate value (get_query_var('paged')).
238
+ </p>
239
+ <h4>Time Parameters</h4>
240
+ <p>
241
+ Support for time parameters is not included in the current version. I may add it later - let me know if you need it.
242
+ </p>
243
+ <h4>Custom Field Parameters</h4>
244
+ <p>
245
+ The [mla_gallery] shortcode supports the simple custom field parameters as well as the more powerful "meta_query" parameters made available as of WordPress 3.1.
246
+ </p>
247
+ <p>
248
+ When embedding the shortcode in the body of a post, be very careful when coding the meta_query; it must be a valid PHP array specification. In particular, code the query on one line; splitting it across lines can insert HTML <br> tags and corrupt your query.
249
+ </p>
250
+ <p>
251
+ Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
252
+ </p>
253
+ <h4>Search Keywords</h4>
254
+ <p>
255
+ The search parameter ("s=keyword") will perform a keyword search. A cursory inspection of the code in /wp-includes/query.php reveals that the search includes the "post_title" and "post_content" (Description) fields but not the "post_excerpt" (Caption) field. An SQL "LIKE" clause is composed and added to the search criteria. I haven't done much testing of this parameter.
256
+ </p>
257
+ </div>
258
  </div>
tpls/help-for-media_page_mla-menu.tpl CHANGED
@@ -3,7 +3,7 @@
3
  <p>All the files you&#8217;ve uploaded are listed in the Media Library Assistant table, ordered by the Title field. You can change the sort order by clicking on one of the blue column names. You can change the default sort order on the Settings screen.</p>
4
  <p>You can use the Screen Options tab to customize the display of this screen. You can choose any combination of the sixteen (16) columns available for display. You can also choose how many items appear on each page of the display.</p>
5
  <p>You can narrow the list by file type/status using the text link filters at the top of the screen. You also can refine the list by month using the dropdown menu above the media table.</p>
6
- <p>If you have selected &#8220;Attachment Categories&#8221; support, you can filter the list by selecting &#8220;All Categories&#8221;, &#8220;No Categories&#8221; or a specific category from the drop down list. If you select a category that has child categories beneath it, attachments in any of the child categories will also appear in the filtered list.</p>
7
  <p><strong>NOTE:</strong> Month and category filters are &#8220;sticky&#8221;, i.e., they will persist as you resort the display or change the file type/status view.</p>
8
  <!-- template="mla-featured-inserted" -->
9
  <!-- title="Featured/Inserted" order="2" -->
3
  <p>All the files you&#8217;ve uploaded are listed in the Media Library Assistant table, ordered by the Title field. You can change the sort order by clicking on one of the blue column names. You can change the default sort order on the Settings screen.</p>
4
  <p>You can use the Screen Options tab to customize the display of this screen. You can choose any combination of the sixteen (16) columns available for display. You can also choose how many items appear on each page of the display.</p>
5
  <p>You can narrow the list by file type/status using the text link filters at the top of the screen. You also can refine the list by month using the dropdown menu above the media table.</p>
6
+ <p>If you have selected taxonomy support, e.g., &#8220;Att. Categories&#8221;, you can filter the list by selecting &#8220;All Categories&#8221;, &#8220;No Categories&#8221; or a specific category from the drop down list. If you select a category that has child categories beneath it, attachments in any of the child categories will also appear in the filtered list. You can select the taxonomy you want to filter by on the Settings page.</p>
7
  <p><strong>NOTE:</strong> Month and category filters are &#8220;sticky&#8221;, i.e., they will persist as you resort the display or change the file type/status view.</p>
8
  <!-- template="mla-featured-inserted" -->
9
  <!-- title="Featured/Inserted" order="2" -->