Media Library Assistant - Version 1.10

Version Description

  • New: Attachment metadata such as file size, dimensions and where-used status can be assigned to WordPress custom fields. These custom fields can be added to the Media/Assistant submenu table as sortable columns and displayed in [mla_gallery] shortcode output.
  • New: Integrates with Photonic Gallery (plugin), so you can add slideshows, thumbnail strips and special effects to your [mla_gallery] galleries.
  • Fix: Edit Media screen with appropriate message displayed after "Map ... Metadata" actions.
  • Fix: SQL View (supporting ALT Text sorting/searching) now created only when required and dropped immediately after use. Avoids conflicts with database backup/restore utilities.
  • Fix: "Map IPTC/EXIF Metadata" link moved from Image Metadata box to Save Metadata box.
  • Fix: Field-level debug information removed from bulk edit messages.
  • Fix: PHP Notice for NULL post metadata keys resolved.
  • Fix: PHP Notice for images without "sizes" metadata array resolved.
Download this release

Release Info

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

Code changes from version 1.00 to 1.10

Files changed (32) hide show
  1. includes/class-mla-data.php +236 -152
  2. includes/class-mla-edit-media.php +38 -11
  3. includes/class-mla-list-table.php +24 -10
  4. includes/class-mla-main.php +57 -51
  5. includes/class-mla-options.php +854 -25
  6. includes/class-mla-settings.php +244 -81
  7. includes/class-mla-shortcodes.php +45 -15
  8. index.php +3 -3
  9. phpDocs/classes/MLA.html +16 -29
  10. phpDocs/classes/MLAData.html +42 -6
  11. phpDocs/classes/MLAEdit.html +34 -14
  12. phpDocs/classes/MLAObjects.html +1 -1
  13. phpDocs/classes/MLAOptions.html +298 -1
  14. phpDocs/classes/MLASettings.html +92 -29
  15. phpDocs/classes/MLAShortcodes.html +1 -1
  16. phpDocs/classes/MLATest.html +1 -1
  17. phpDocs/classes/MLA_List_Table.html +10 -5
  18. phpDocs/deprecated.html +1 -1
  19. phpDocs/errors.html +1 -1
  20. phpDocs/graph_class.html +1 -1
  21. phpDocs/index.html +1 -1
  22. phpDocs/markers.html +1 -1
  23. phpDocs/namespaces/global.html +1 -1
  24. phpDocs/packages/Media Library Assistant.html +1 -1
  25. phpDocs/structure.xml +1475 -1052
  26. readme.txt +117 -25
  27. tpls/admin-display-settings-page.tpl +35 -0
  28. tpls/admin-inline-edit-form.tpl +2 -1
  29. tpls/documentation-settings-tab.tpl +194 -11
  30. tpls/help-for-edit_attachment.tpl +7 -0
  31. tpls/help-for-media_page_mla-menu.tpl +8 -5
  32. tpls/mla-option-templates.tpl +153 -0
includes/class-mla-data.php CHANGED
@@ -16,12 +16,31 @@
16
  * @since 0.1
17
  */
18
  class MLAData {
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
19
  /**
20
  * Initialization function, similar to __construct()
21
  *
22
  * @since 0.1
23
  */
24
  public static function initialize() {
 
 
 
25
  add_action( 'save_post', 'MLAData::mla_save_post_action', 10, 1);
26
  add_action( 'edit_attachment', 'MLAData::mla_save_post_action', 10, 1);
27
  add_action( 'add_attachment', 'MLAData::mla_save_post_action', 10, 1);
@@ -264,7 +283,7 @@ class MLAData {
264
  *
265
  * @var array
266
  */
267
- private static $query_parameters = array( );
268
 
269
  /**
270
  * Sanitize and expand query arguments from request variables
@@ -297,7 +316,7 @@ class MLAData {
297
  'post_type' => 'attachment',
298
  'post_status' => 'inherit',
299
  'mla-search-connector' => 'AND',
300
- 'mla-search-fields' => array ( )
301
  );
302
 
303
  foreach ( $raw_request as $key => $value ) {
@@ -382,7 +401,7 @@ class MLAData {
382
  /*
383
  * Pass query parameters to the filters for _execute_list_table_query
384
  */
385
- self::$query_parameters = array( );
386
  self::$query_parameters['detached'] = isset( $clean_request['detached'] );
387
  self::$query_parameters['orderby'] = $clean_request['orderby'];
388
  self::$query_parameters['order'] = $clean_request['order'];
@@ -398,6 +417,9 @@ class MLAData {
398
  self::$query_parameters['mla-search-fields'] = $clean_request['mla-search-fields'];
399
  self::$query_parameters['sentence'] = isset( $clean_request['sentence'] );
400
  self::$query_parameters['exact'] = isset( $clean_request['exact'] );
 
 
 
401
  } // !empty
402
 
403
  unset( $clean_request['s'] );
@@ -411,22 +433,33 @@ class MLAData {
411
  * We have to handle custom field/post_meta values here
412
  * because they need a JOIN clause supplied by WP_Query
413
  */
414
- switch ( self::$query_parameters['orderby'] ) {
415
- /*
416
- * '_wp_attachment_image_alt' is special; we'll handle it in the JOIN and ORDERBY filters
417
- */
418
- case '_wp_attachment_image_alt':
419
- if ( isset($clean_request['orderby']) )
420
- unset($clean_request['orderby']);
421
- if ( isset($clean_request['order']) )
422
- unset($clean_request['order']);
423
- break;
424
- case '_wp_attached_file':
425
- $clean_request['meta_key'] = '_wp_attached_file';
426
  $clean_request['orderby'] = 'meta_value';
427
  $clean_request['order'] = self::$query_parameters['order'];
428
- break;
429
- } // $orderby
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
430
 
431
  /*
432
  * Ignore incoming paged value; use offset and count instead
@@ -502,6 +535,27 @@ class MLAData {
502
  * @return object WP_Query object with query results
503
  */
504
  private static function _execute_list_table_query( $request ) {
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
505
  add_filter( 'posts_search', 'MLAData::mla_query_posts_search_filter', 10, 2 ); // $search, &$this
506
  add_filter( 'posts_join', 'MLAData::mla_query_posts_join_filter' );
507
  add_filter( 'posts_where', 'MLAData::mla_query_posts_where_filter' );
@@ -514,6 +568,10 @@ class MLAData {
514
  remove_filter( 'posts_join', 'MLAData::mla_query_posts_join_filter' );
515
  remove_filter( 'posts_search', 'MLAData::mla_query_posts_search_filter' );
516
 
 
 
 
 
517
  return $results;
518
  }
519
 
@@ -568,7 +626,7 @@ class MLAData {
568
  }
569
 
570
  if ( in_array( 'alt-text', $fields ) ) {
571
- $view_name = MLASettings::$mla_alt_text_view;
572
  $search_clause .= "{$inner_connector}({$view_name}.meta_value LIKE '{$percent}{$term}{$percent}')";
573
  $inner_connector = ' OR ';
574
  }
@@ -592,7 +650,7 @@ class MLAData {
592
  }
593
 
594
  /**
595
- * Adds a JOIN clause, if required
596
  *
597
  * Defined as public because it's a filter.
598
  *
@@ -600,19 +658,17 @@ class MLAData {
600
  *
601
  * @param string query clause before modification
602
  *
603
- * @return string query clause after "detached" item modification
604
  */
605
  public static function mla_query_posts_join_filter( $join_clause ) {
606
  global $table_prefix;
607
  /*
608
  * '_wp_attachment_image_alt' is special; we have to use an SQL VIEW to
609
  * build an intermediate table and modify the JOIN to include posts with
610
- * no value for this meta data field.
611
  */
612
- if ( '_wp_attachment_image_alt' == self::$query_parameters['orderby']
613
- || isset( self::$query_parameters['s'] )
614
- ) {
615
- $view_name = MLASettings::$mla_alt_text_view;
616
  $join_clause .= " LEFT JOIN {$view_name} ON ({$table_prefix}posts.ID = {$view_name}.post_id)";
617
  }
618
 
@@ -656,35 +712,40 @@ class MLAData {
656
  global $table_prefix;
657
 
658
  if ( isset( self::$query_parameters['orderby'] ) ) {
659
- switch ( self::$query_parameters['orderby'] ) {
660
- case 'none':
661
- $orderby = '';
662
- break;
663
- /*
664
- * There are two columns defined that end up sorting on post_title,
665
- * so we can't use the database column to identify the column but
666
- * we actually sort on the database column.
667
- */
668
- case 'title_name':
669
- $orderby = "{$table_prefix}posts.post_title";
670
- break;
671
- /*
672
- * The _wp_attached_file meta data value is present for all attachments, and the
673
- * sorting on the meta data value is handled by WP_Query
674
- */
675
- case '_wp_attached_file':
676
- $orderby = '';
677
- break;
678
- /*
679
- * The _wp_attachment_image_alt value is only present for images, so we have to
680
- * use the view we prepared to get attachments with no meta data value
681
- */
682
- case '_wp_attachment_image_alt':
683
- $orderby = MLASettings::$mla_alt_text_view . '.meta_value';
684
- break;
685
- default:
686
- $orderby = "{$table_prefix}posts." . self::$query_parameters['orderby'];
687
- } // $query_parameters['orderby']
 
 
 
 
 
688
 
689
  if ( ! empty( $orderby ) )
690
  $orderby_clause = $orderby . ' ' . self::$query_parameters['order'];
@@ -700,6 +761,7 @@ class MLAData {
700
  * the posts and postmeta tables, and all references to the attachment.
701
  *
702
  * @since 0.1
 
703
  *
704
  * @param int The ID of the attachment post
705
  * @return NULL|array NULL on failure else associative array
@@ -740,6 +802,96 @@ class MLAData {
740
  return $post_data;
741
  }
742
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
743
  /**
744
  * Find Featured Image and inserted image/link references to an attachment
745
  *
@@ -762,7 +914,8 @@ class MLAData {
762
  * found_parent true if $parent matches a where-used post ID
763
  * is_unattached true if $parent is zero (0)
764
  * base_file relative path and name of the uploaded file, e.g., 2012/04/image.jpg
765
- * path path to the file, relative to the "uploads/" directory
 
766
  * files base file and any other image size files. Array key is path and file name.
767
  * Non-image file value is a string containing file name without path
768
  * Image file value is an array with file name, width and height
@@ -775,9 +928,9 @@ class MLAData {
775
  * that was returned by an [mla_gallery] shortcode
776
  * galleries Array of objects with the post_type and post_title of each post
777
  * that was returned by a [gallery] shortcode
778
- * file The name portion of the base file, e.g., image.jpg
779
  * parent_type 'post' or 'page' or the custom post type of the attachment's parent
780
  * parent_title post_title of the attachment's parent
 
781
  */
782
  $references = array(
783
  'tested_reference' => false,
@@ -786,12 +939,12 @@ class MLAData {
786
  'is_unattached' => ( ( (int) $parent ) === 0 ),
787
  'base_file' => '',
788
  'path' => '',
 
789
  'files' => array(),
790
  'features' => array(),
791
  'inserts' => array(),
792
  'mla_galleries' => array(),
793
  'galleries' => array(),
794
- 'file' => '',
795
  'parent_type' => '',
796
  'parent_title' => '',
797
  'parent_errors' => ''
@@ -812,7 +965,7 @@ class MLAData {
812
  } // empty( $attachment_metadata )
813
  else {
814
  $references['base_file'] = $attachment_metadata['file'];
815
- $sizes = $attachment_metadata['sizes'];
816
  if ( !empty( $sizes ) ) {
817
  /* Using the name as the array key ensures each name is added only once */
818
  foreach ( $sizes as $size ) {
@@ -931,7 +1084,7 @@ class MLAData {
931
  } // foreach $gallery
932
  } // !empty
933
  else
934
- $references['mla_galleries'] = array( );
935
  }
936
  } // $process_mla_gallery_in
937
 
@@ -953,20 +1106,14 @@ class MLAData {
953
  } // foreach $gallery
954
  } // !empty
955
  else
956
- $references['galleries'] = array( );
957
  }
958
  } // $process_gallery_in
959
 
960
  /*
961
  * Evaluate and summarize reference tests
962
  */
963
- if ( !empty( $references['parent_title'] ) )
964
- $errors = '';
965
- elseif ( $references['is_unattached'] )
966
- $errors = '(UNATTACHED) ';
967
- else
968
- $errors = '(INVALID PARENT) ';
969
-
970
  if ( 0 == $reference_tests ) {
971
  $references['tested_reference'] = false;
972
  $errors .= '(NO REFERENCE TESTS)';
@@ -982,6 +1129,11 @@ class MLAData {
982
  $errors .= "(BAD PARENT{$suffix})";
983
  }
984
 
 
 
 
 
 
985
  $references['parent_errors'] = trim( $errors );
986
  return $references;
987
  }
@@ -1099,7 +1251,7 @@ class MLAData {
1099
  /*
1100
  * $galleries_array is null, so build the array
1101
  */
1102
- $galleries_array = array( );
1103
 
1104
  if ( $exclude_revisions )
1105
  $exclude_revisions = "(post_type <> 'revision') AND ";
@@ -1128,8 +1280,8 @@ class MLAData {
1128
  $result_id = $result->ID;
1129
  $galleries_array[ $result_id ]['parent_title'] = $result->post_title;
1130
  $galleries_array[ $result_id ]['parent_type'] = $result->post_type;
1131
- $galleries_array[ $result_id ]['results'] = array( );
1132
- $galleries_array[ $result_id ]['galleries'] = array( );
1133
  $instance = 0;
1134
 
1135
  foreach ( $matches[1] as $index => $match ) {
@@ -1139,7 +1291,7 @@ class MLAData {
1139
  if ( empty( $match ) || ( ' ' == substr( $match, 0, 1 ) ) ) {
1140
  $instance++;
1141
  $galleries_array[ $result_id ]['galleries'][ $instance ]['query'] = trim( $matches[1][$index] );
1142
- $galleries_array[ $result_id ]['galleries'][ $instance ]['results'] = array( );
1143
 
1144
  $post = $result; // set global variable for mla_gallery_shortcode
1145
  $attachments = MLAShortcodes::mla_get_shortcode_attachments( $result_id, $galleries_array[ $result_id ]['galleries'][ $instance ]['query'] );
@@ -1175,7 +1327,7 @@ class MLAData {
1175
  * The array key is the parent_post ID; each entry contains post_title and post_type.
1176
  */
1177
  private static function _search_mla_galleries( &$galleries_array, $attachment_id ) {
1178
- $gallery_refs = array( );
1179
  if ( ! empty( $galleries_array ) ) {
1180
  foreach ( $galleries_array as $parent_id => $gallery ) {
1181
  if ( in_array( $attachment_id, $gallery['results'] ) ) {
@@ -1187,30 +1339,6 @@ class MLAData {
1187
  return $gallery_refs;
1188
  }
1189
 
1190
- /**
1191
- * Returns information about an attachment's parent, if found
1192
- *
1193
- * @since 0.1
1194
- *
1195
- * @param int post ID of attachment's parent, if any
1196
- *
1197
- * @return array Parent information; post_date, post_title and post_type
1198
- */
1199
- public static function mla_fetch_attachment_parent_data( $parent_id ) {
1200
- $parent_data = array();
1201
- if ( $parent_id ) {
1202
- $parent = get_post( $parent_id );
1203
- if ( isset( $parent->post_date ) )
1204
- $parent_data['parent_date'] = $parent->post_date;
1205
- if ( isset( $parent->post_title ) )
1206
- $parent_data['parent_title'] = $parent->post_title;
1207
- if ( isset( $parent->post_type ) )
1208
- $parent_data['parent_type'] = $parent->post_type;
1209
- }
1210
-
1211
- return $parent_data;
1212
- }
1213
-
1214
  /**
1215
  * Fetch and filter IPTC and EXIF meta data for an image attachment
1216
  *
@@ -1225,8 +1353,8 @@ class MLAData {
1225
  */
1226
  public static function mla_fetch_attachment_image_metadata( $post_id, $path = '' ) {
1227
  $results = array(
1228
- 'mla_iptc_metadata' => array (),
1229
- 'mla_exif_metadata' => array ()
1230
  );
1231
 
1232
  // $post_meta = get_metadata( 'post', $post_id, '_wp_attachment_metadata' );
@@ -1267,57 +1395,6 @@ class MLAData {
1267
  return $results;
1268
  }
1269
 
1270
- /**
1271
- * Fetch and filter meta data for an attachment
1272
- *
1273
- * Returns a filtered array of a post's meta data. Internal values beginning with '_'
1274
- * are stripped out or converted to an 'mla_' equivalent. Array data is replaced with
1275
- * a string containing the first array element.
1276
- *
1277
- * @since 0.1
1278
- *
1279
- * @param int post ID of attachment
1280
- *
1281
- * @return array Meta data variables
1282
- */
1283
- public static function mla_fetch_attachment_metadata( $post_id ) {
1284
- $results = array();
1285
- $post_meta = get_metadata( 'post', $post_id );
1286
-
1287
- if ( is_array( $post_meta ) ) {
1288
- foreach ( $post_meta as $post_meta_key => $post_meta_value ) {
1289
- if ( '_' == $post_meta_key{0} ) {
1290
- if ( stripos( $post_meta_key, '_wp_attached_file' ) === 0 ) {
1291
- $key = 'mla_wp_attached_file';
1292
- } elseif ( stripos( $post_meta_key, '_wp_attachment_metadata' ) === 0 ) {
1293
- $key = 'mla_wp_attachment_metadata';
1294
- $post_meta_value = unserialize( $post_meta_value[0] );
1295
- } elseif ( stripos( $post_meta_key, '_wp_attachment_image_alt' ) === 0 ) {
1296
- $key = 'mla_wp_attachment_image_alt';
1297
- } else {
1298
- continue;
1299
- }
1300
- } else {
1301
- if ( stripos( $post_meta_key, 'mla_' ) === 0 )
1302
- $key = $post_meta_key;
1303
- else
1304
- $key = 'mla_item_' . $post_meta_key;
1305
- }
1306
-
1307
- if ( is_array( $post_meta_value ) && count( $post_meta_value ) == 1 )
1308
- $value = $post_meta_value[0];
1309
- else
1310
- $value = $post_meta_value;
1311
-
1312
- $results[ $key ] = $value;
1313
- }
1314
- /* foreach $post_meta */
1315
- }
1316
- /* is_array($post_meta) */
1317
-
1318
- return $results;
1319
- }
1320
-
1321
  /**
1322
  * Update a single item; change the meta data
1323
  * for a single attachment.
@@ -1522,11 +1599,18 @@ class MLAData {
1522
  'body' => ''
1523
  );
1524
  else {
1525
- if ( wp_update_post( $updates ) )
 
 
 
 
 
 
1526
  return array(
1527
- 'message' => 'Item: ' . $post_id . ' updated.<br>' . $message,
1528
  'body' => ''
1529
  );
 
1530
  else
1531
  return array(
1532
  'message' => 'ERROR: Item ' . $post_id . ' update failed.',
@@ -1556,7 +1640,7 @@ class MLAData {
1556
  $tags = str_replace( $comma, ',', $tags );
1557
  $terms = explode( ',', trim( $tags, " \n\t\r\0\x0B," ) );
1558
 
1559
- $tags = array ( );
1560
  foreach ( (array) $terms as $term) {
1561
  if ( !strlen(trim($term)) )
1562
  continue;
16
  * @since 0.1
17
  */
18
  class MLAData {
19
+ /**
20
+ * Provides a unique suffix for the ALT Text SQL VIEW
21
+ *
22
+ * @since 0.40
23
+ */
24
+ const MLA_ALT_TEXT_VIEW_SUFFIX = 'alt_text_view';
25
+
26
+ /**
27
+ * Provides a unique name for the ALT Text SQL VIEW
28
+ *
29
+ * @since 0.40
30
+ *
31
+ * @var array
32
+ */
33
+ private static $mla_alt_text_view = NULL;
34
+
35
  /**
36
  * Initialization function, similar to __construct()
37
  *
38
  * @since 0.1
39
  */
40
  public static function initialize() {
41
+ global $table_prefix;
42
+ self::$mla_alt_text_view = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
43
+
44
  add_action( 'save_post', 'MLAData::mla_save_post_action', 10, 1);
45
  add_action( 'edit_attachment', 'MLAData::mla_save_post_action', 10, 1);
46
  add_action( 'add_attachment', 'MLAData::mla_save_post_action', 10, 1);
283
  *
284
  * @var array
285
  */
286
+ private static $query_parameters = array();
287
 
288
  /**
289
  * Sanitize and expand query arguments from request variables
316
  'post_type' => 'attachment',
317
  'post_status' => 'inherit',
318
  'mla-search-connector' => 'AND',
319
+ 'mla-search-fields' => array()
320
  );
321
 
322
  foreach ( $raw_request as $key => $value ) {
401
  /*
402
  * Pass query parameters to the filters for _execute_list_table_query
403
  */
404
+ self::$query_parameters = array( 'use_alt_text_view' => false );
405
  self::$query_parameters['detached'] = isset( $clean_request['detached'] );
406
  self::$query_parameters['orderby'] = $clean_request['orderby'];
407
  self::$query_parameters['order'] = $clean_request['order'];
417
  self::$query_parameters['mla-search-fields'] = $clean_request['mla-search-fields'];
418
  self::$query_parameters['sentence'] = isset( $clean_request['sentence'] );
419
  self::$query_parameters['exact'] = isset( $clean_request['exact'] );
420
+
421
+ if ( in_array( 'alt-text', self::$query_parameters['mla-search-fields'] ) )
422
+ self::$query_parameters['use_alt_text_view'] = true;
423
  } // !empty
424
 
425
  unset( $clean_request['s'] );
433
  * We have to handle custom field/post_meta values here
434
  * because they need a JOIN clause supplied by WP_Query
435
  */
436
+ if ( 'c_' == substr( self::$query_parameters['orderby'], 0, 2 ) ) {
437
+ $option_value = MLAOptions::mla_custom_field_option_value( self::$query_parameters['orderby'] );
438
+ if ( isset( $option_value['name'] ) ) {
439
+ $clean_request['meta_key'] = $option_value['name'];
 
 
 
 
 
 
 
 
440
  $clean_request['orderby'] = 'meta_value';
441
  $clean_request['order'] = self::$query_parameters['order'];
442
+ }
443
+ } // custom field
444
+ else {
445
+ switch ( self::$query_parameters['orderby'] ) {
446
+ /*
447
+ * '_wp_attachment_image_alt' is special; we'll handle it in the JOIN and ORDERBY filters
448
+ */
449
+ case '_wp_attachment_image_alt':
450
+ self::$query_parameters['use_alt_text_view'] = true;
451
+ if ( isset($clean_request['orderby']) )
452
+ unset($clean_request['orderby']);
453
+ if ( isset($clean_request['order']) )
454
+ unset($clean_request['order']);
455
+ break;
456
+ case '_wp_attached_file':
457
+ $clean_request['meta_key'] = '_wp_attached_file';
458
+ $clean_request['orderby'] = 'meta_value';
459
+ $clean_request['order'] = self::$query_parameters['order'];
460
+ break;
461
+ } // switch $orderby
462
+ }
463
 
464
  /*
465
  * Ignore incoming paged value; use offset and count instead
535
  * @return object WP_Query object with query results
536
  */
537
  private static function _execute_list_table_query( $request ) {
538
+ global $wpdb, $table_prefix;
539
+
540
+ /*
541
+ * ALT Text is special; we have to use an SQL VIEW to build
542
+ * an intermediate table and modify the JOIN to include posts
543
+ * with no value for this metadata field.
544
+ */
545
+ if ( self::$query_parameters['use_alt_text_view'] ) {
546
+ $view_name = self::$mla_alt_text_view;
547
+ $table_name = $table_prefix . 'postmeta';
548
+
549
+ $result = $wpdb->query(
550
+ "
551
+ CREATE OR REPLACE VIEW {$view_name} AS
552
+ SELECT post_id, meta_value
553
+ FROM {$table_name}
554
+ WHERE {$table_name}.meta_key = '_wp_attachment_image_alt'
555
+ "
556
+ );
557
+ }
558
+
559
  add_filter( 'posts_search', 'MLAData::mla_query_posts_search_filter', 10, 2 ); // $search, &$this
560
  add_filter( 'posts_join', 'MLAData::mla_query_posts_join_filter' );
561
  add_filter( 'posts_where', 'MLAData::mla_query_posts_where_filter' );
568
  remove_filter( 'posts_join', 'MLAData::mla_query_posts_join_filter' );
569
  remove_filter( 'posts_search', 'MLAData::mla_query_posts_search_filter' );
570
 
571
+ if ( self::$query_parameters['use_alt_text_view'] ) {
572
+ $result = $wpdb->query( "DROP VIEW {$view_name}" );
573
+ }
574
+
575
  return $results;
576
  }
577
 
626
  }
627
 
628
  if ( in_array( 'alt-text', $fields ) ) {
629
+ $view_name = self::$mla_alt_text_view;
630
  $search_clause .= "{$inner_connector}({$view_name}.meta_value LIKE '{$percent}{$term}{$percent}')";
631
  $inner_connector = ' OR ';
632
  }
650
  }
651
 
652
  /**
653
+ * Adds a JOIN clause, if required, to handle sorting/searching on ALT Text
654
  *
655
  * Defined as public because it's a filter.
656
  *
658
  *
659
  * @param string query clause before modification
660
  *
661
+ * @return string query clause after "LEFT JOIN view ON post_id" item modification
662
  */
663
  public static function mla_query_posts_join_filter( $join_clause ) {
664
  global $table_prefix;
665
  /*
666
  * '_wp_attachment_image_alt' is special; we have to use an SQL VIEW to
667
  * build an intermediate table and modify the JOIN to include posts with
668
+ * no value for this metadata field.
669
  */
670
+ if ( self::$query_parameters['use_alt_text_view'] ) {
671
+ $view_name = self::$mla_alt_text_view;
 
 
672
  $join_clause .= " LEFT JOIN {$view_name} ON ({$table_prefix}posts.ID = {$view_name}.post_id)";
673
  }
674
 
712
  global $table_prefix;
713
 
714
  if ( isset( self::$query_parameters['orderby'] ) ) {
715
+ if ( 'c_' == substr( self::$query_parameters['orderby'], 0, 2 ) ) {
716
+ $orderby = $table_prefix . 'postmeta.meta_value';
717
+ } // custom field sort
718
+ else {
719
+ switch ( self::$query_parameters['orderby'] ) {
720
+ case 'none':
721
+ $orderby = '';
722
+ break;
723
+ /*
724
+ * There are two columns defined that end up sorting on post_title,
725
+ * so we can't use the database column to identify the column but
726
+ * we actually sort on the database column.
727
+ */
728
+ case 'title_name':
729
+ $orderby = "{$table_prefix}posts.post_title";
730
+ break;
731
+ /*
732
+ * The _wp_attached_file meta data value is present for all attachments, and the
733
+ * sorting on the meta data value is handled by WP_Query
734
+ */
735
+ case '_wp_attached_file':
736
+ $orderby = '';
737
+ break;
738
+ /*
739
+ * The _wp_attachment_image_alt value is only present for images, so we have to
740
+ * use the view we prepared to get attachments with no meta data value
741
+ */
742
+ case '_wp_attachment_image_alt':
743
+ $orderby = self::$mla_alt_text_view . '.meta_value';
744
+ break;
745
+ default:
746
+ $orderby = "{$table_prefix}posts." . self::$query_parameters['orderby'];
747
+ } // $query_parameters['orderby']
748
+ }
749
 
750
  if ( ! empty( $orderby ) )
751
  $orderby_clause = $orderby . ' ' . self::$query_parameters['order'];
761
  * the posts and postmeta tables, and all references to the attachment.
762
  *
763
  * @since 0.1
764
+ * @uses $post WordPress global variable
765
  *
766
  * @param int The ID of the attachment post
767
  * @return NULL|array NULL on failure else associative array
802
  return $post_data;
803
  }
804
 
805
+ /**
806
+ * Returns information about an attachment's parent, if found
807
+ *
808
+ * @since 0.1
809
+ *
810
+ * @param int post ID of attachment's parent, if any
811
+ *
812
+ * @return array Parent information; post_date, post_title and post_type
813
+ */
814
+ public static function mla_fetch_attachment_parent_data( $parent_id ) {
815
+ $parent_data = array();
816
+ if ( $parent_id ) {
817
+ $parent = get_post( $parent_id );
818
+ if ( isset( $parent->post_date ) )
819
+ $parent_data['parent_date'] = $parent->post_date;
820
+ if ( isset( $parent->post_title ) )
821
+ $parent_data['parent_title'] = $parent->post_title;
822
+ if ( isset( $parent->post_type ) )
823
+ $parent_data['parent_type'] = $parent->post_type;
824
+ }
825
+
826
+ return $parent_data;
827
+ }
828
+
829
+ /**
830
+ * Fetch and filter meta data for an attachment
831
+ *
832
+ * Returns a filtered array of a post's meta data. Internal values beginning with '_'
833
+ * are stripped out or converted to an 'mla_' equivalent. Array data is replaced with
834
+ * a string containing the first array element.
835
+ *
836
+ * @since 0.1
837
+ *
838
+ * @param int post ID of attachment
839
+ *
840
+ * @return array Meta data variables
841
+ */
842
+ public static function mla_fetch_attachment_metadata( $post_id ) {
843
+ $attached_file = NULL;
844
+ $results = array();
845
+ $post_meta = get_metadata( 'post', $post_id );
846
+
847
+ if ( is_array( $post_meta ) ) {
848
+ foreach ( $post_meta as $post_meta_key => $post_meta_value ) {
849
+ if ( empty( $post_meta_key ) )
850
+ continue;
851
+
852
+ if ( '_' == $post_meta_key{0} ) {
853
+ if ( stripos( $post_meta_key, '_wp_attached_file' ) === 0 ) {
854
+ $key = 'mla_wp_attached_file';
855
+ $attached_file = $post_meta_value[0];
856
+ } elseif ( stripos( $post_meta_key, '_wp_attachment_metadata' ) === 0 ) {
857
+ $key = 'mla_wp_attachment_metadata';
858
+ $post_meta_value = unserialize( $post_meta_value[0] );
859
+ } elseif ( stripos( $post_meta_key, '_wp_attachment_image_alt' ) === 0 ) {
860
+ $key = 'mla_wp_attachment_image_alt';
861
+ } else {
862
+ continue;
863
+ }
864
+ } else {
865
+ if ( stripos( $post_meta_key, 'mla_' ) === 0 )
866
+ $key = $post_meta_key;
867
+ else
868
+ $key = 'mla_item_' . $post_meta_key;
869
+ }
870
+
871
+ if ( is_array( $post_meta_value ) && count( $post_meta_value ) == 1 )
872
+ $value = $post_meta_value[0];
873
+ else
874
+ $value = $post_meta_value;
875
+
876
+ $results[ $key ] = $value;
877
+ } // foreach $post_meta
878
+
879
+ if ( !empty( $attached_file ) ) {
880
+ $last_slash = strrpos( $attached_file, '/' );
881
+ if ( false === $last_slash ) {
882
+ $results['mla_wp_attached_path'] = '';
883
+ $results['mla_wp_attached_filename'] = $attached_file;
884
+ }
885
+ else {
886
+ $results['mla_wp_attached_path'] = substr( $attached_file, 0, $last_slash + 1 );
887
+ $results['mla_wp_attached_filename'] = substr( $attached_file, $last_slash + 1 );
888
+ }
889
+ } // $attached_file
890
+ } // is_array($post_meta)
891
+
892
+ return $results;
893
+ }
894
+
895
  /**
896
  * Find Featured Image and inserted image/link references to an attachment
897
  *
914
  * found_parent true if $parent matches a where-used post ID
915
  * is_unattached true if $parent is zero (0)
916
  * base_file relative path and name of the uploaded file, e.g., 2012/04/image.jpg
917
+ * path path to the file, relative to the "uploads/" directory, e.g., 2012/04/
918
+ * file The name portion of the base file, e.g., image.jpg
919
  * files base file and any other image size files. Array key is path and file name.
920
  * Non-image file value is a string containing file name without path
921
  * Image file value is an array with file name, width and height
928
  * that was returned by an [mla_gallery] shortcode
929
  * galleries Array of objects with the post_type and post_title of each post
930
  * that was returned by a [gallery] shortcode
 
931
  * parent_type 'post' or 'page' or the custom post type of the attachment's parent
932
  * parent_title post_title of the attachment's parent
933
+ * parent_errors UNATTACHED, ORPHAN, BAD/INVALID PARENT
934
  */
935
  $references = array(
936
  'tested_reference' => false,
939
  'is_unattached' => ( ( (int) $parent ) === 0 ),
940
  'base_file' => '',
941
  'path' => '',
942
+ 'file' => '',
943
  'files' => array(),
944
  'features' => array(),
945
  'inserts' => array(),
946
  'mla_galleries' => array(),
947
  'galleries' => array(),
 
948
  'parent_type' => '',
949
  'parent_title' => '',
950
  'parent_errors' => ''
965
  } // empty( $attachment_metadata )
966
  else {
967
  $references['base_file'] = $attachment_metadata['file'];
968
+ $sizes = isset( $attachment_metadata['sizes'] ) ? $attachment_metadata['sizes'] : NULL;
969
  if ( !empty( $sizes ) ) {
970
  /* Using the name as the array key ensures each name is added only once */
971
  foreach ( $sizes as $size ) {
1084
  } // foreach $gallery
1085
  } // !empty
1086
  else
1087
+ $references['mla_galleries'] = array();
1088
  }
1089
  } // $process_mla_gallery_in
1090
 
1106
  } // foreach $gallery
1107
  } // !empty
1108
  else
1109
+ $references['galleries'] = array();
1110
  }
1111
  } // $process_gallery_in
1112
 
1113
  /*
1114
  * Evaluate and summarize reference tests
1115
  */
1116
+ $errors = '';
 
 
 
 
 
 
1117
  if ( 0 == $reference_tests ) {
1118
  $references['tested_reference'] = false;
1119
  $errors .= '(NO REFERENCE TESTS)';
1129
  $errors .= "(BAD PARENT{$suffix})";
1130
  }
1131
 
1132
+ if ( $references['is_unattached'] )
1133
+ $errors .= '(UNATTACHED) ';
1134
+ elseif ( empty( $references['parent_title'] ) )
1135
+ $errors .= '(INVALID PARENT) ';
1136
+
1137
  $references['parent_errors'] = trim( $errors );
1138
  return $references;
1139
  }
1251
  /*
1252
  * $galleries_array is null, so build the array
1253
  */
1254
+ $galleries_array = array();
1255
 
1256
  if ( $exclude_revisions )
1257
  $exclude_revisions = "(post_type <> 'revision') AND ";
1280
  $result_id = $result->ID;
1281
  $galleries_array[ $result_id ]['parent_title'] = $result->post_title;
1282
  $galleries_array[ $result_id ]['parent_type'] = $result->post_type;
1283
+ $galleries_array[ $result_id ]['results'] = array();
1284
+ $galleries_array[ $result_id ]['galleries'] = array();
1285
  $instance = 0;
1286
 
1287
  foreach ( $matches[1] as $index => $match ) {
1291
  if ( empty( $match ) || ( ' ' == substr( $match, 0, 1 ) ) ) {
1292
  $instance++;
1293
  $galleries_array[ $result_id ]['galleries'][ $instance ]['query'] = trim( $matches[1][$index] );
1294
+ $galleries_array[ $result_id ]['galleries'][ $instance ]['results'] = array();
1295
 
1296
  $post = $result; // set global variable for mla_gallery_shortcode
1297
  $attachments = MLAShortcodes::mla_get_shortcode_attachments( $result_id, $galleries_array[ $result_id ]['galleries'][ $instance ]['query'] );
1327
  * The array key is the parent_post ID; each entry contains post_title and post_type.
1328
  */
1329
  private static function _search_mla_galleries( &$galleries_array, $attachment_id ) {
1330
+ $gallery_refs = array();
1331
  if ( ! empty( $galleries_array ) ) {
1332
  foreach ( $galleries_array as $parent_id => $gallery ) {
1333
  if ( in_array( $attachment_id, $gallery['results'] ) ) {
1339
  return $gallery_refs;
1340
  }
1341
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1342
  /**
1343
  * Fetch and filter IPTC and EXIF meta data for an image attachment
1344
  *
1353
  */
1354
  public static function mla_fetch_attachment_image_metadata( $post_id, $path = '' ) {
1355
  $results = array(
1356
+ 'mla_iptc_metadata' => array(),
1357
+ 'mla_exif_metadata' => array()
1358
  );
1359
 
1360
  // $post_meta = get_metadata( 'post', $post_id, '_wp_attachment_metadata' );
1395
  return $results;
1396
  }
1397
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1398
  /**
1399
  * Update a single item; change the meta data
1400
  * for a single attachment.
1599
  'body' => ''
1600
  );
1601
  else {
1602
+ if ( wp_update_post( $updates ) ) {
1603
+ $final_message = 'Item: ' . $post_id . ' updated.';
1604
+ /*
1605
+ * Uncomment this for debugging.
1606
+ */
1607
+ // $final_message .= '<br>' . $message;
1608
+
1609
  return array(
1610
+ 'message' => $final_message,
1611
  'body' => ''
1612
  );
1613
+ }
1614
  else
1615
  return array(
1616
  'message' => 'ERROR: Item ' . $post_id . ' update failed.',
1640
  $tags = str_replace( $comma, ',', $tags );
1641
  $terms = explode( ',', trim( $tags, " \n\t\r\0\x0B," ) );
1642
 
1643
+ $tags = array();
1644
  foreach ( (array) $terms as $term) {
1645
  if ( !strlen(trim($term)) )
1646
  continue;
includes/class-mla-edit-media.php CHANGED
@@ -30,13 +30,16 @@ class MLAEdit {
30
 
31
  add_action( 'add_meta_boxes', 'MLAEdit::mla_add_meta_boxes_action', 10, 2 );
32
 
 
 
 
33
  // do_action in wp-admin/includes/meta-boxes.php function attachment_submit_meta_box
34
- add_action( 'attachment_submitbox_misc_actions', 'MLAEdit::mla_last_modified_action' );
35
 
36
  // do_action in wp-includes/post.php function wp_insert_post
37
  add_action( 'edit_attachment', 'MLAEdit::mla_edit_attachment_action', 10, 1 );
38
 
39
- // add_action( 'load-edit_attachment.php', 'MLAEdit::mla_edit_add_help_tab' );
40
  add_filter( 'admin_title', 'MLAEdit::mla_edit_add_help_tab', 10, 2 );
41
  } // $wordpress_3point5_plus
42
  }
@@ -53,6 +56,25 @@ class MLAEdit {
53
  add_post_type_support( 'attachment', 'custom-fields' );
54
  }
55
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
56
  /**
57
  * Adds Last Modified date to the Submit box on the Edit Media screen.
58
  * Declared public because it is an action.
@@ -61,7 +83,7 @@ class MLAEdit {
61
  *
62
  * @return void echoes the HTML markup for the label and value
63
  */
64
- public static function mla_last_modified_action( ) {
65
  global $post;
66
 
67
  $datef = __( 'M j, Y @ G:i' );
@@ -70,7 +92,18 @@ class MLAEdit {
70
  echo '<div class="misc-pub-section curtime">' . "\r\n";
71
  echo '<span id="timestamp">' . sprintf($stamp, $date) . "</span>\r\n";
72
  echo "</div><!-- .misc-pub-section -->\r\n";
73
- } // mla_last_modified_action
 
 
 
 
 
 
 
 
 
 
 
74
 
75
  /**
76
  * Registers meta boxes for the Edit Media screen.
@@ -127,7 +160,7 @@ class MLAEdit {
127
  /*
128
  * Provide explicit control over tab order
129
  */
130
- $tab_array = array( );
131
 
132
  foreach ( $template_array as $id => $content ) {
133
  $match_count = preg_match( '#\<!-- title="(.+)" order="(.+)" --\>#', $content, $matches, PREG_OFFSET_CAPTURE );
@@ -222,12 +255,6 @@ class MLAEdit {
222
  $value = '';
223
 
224
  echo '<label class="screen-reader-text" for="mla_image_metadata">Image Metadata</label><textarea class="readonly" id="mla_image_metadata" rows="5" cols="80" readonly="readonly" name="mla_image_metadata" >' . esc_textarea( $value ) . "</textarea>\r\n";
225
-
226
- $view_args = array(
227
- 'page' => 'mla-menu',
228
- 'mla_item_ID' => $post->ID
229
- );
230
- echo '<a style="float: right; " href="' . add_query_arg( $view_args, wp_nonce_url( 'upload.php?mla_admin_action=' . MLA::MLA_ADMIN_SINGLE_MAP, MLA::MLA_ADMIN_NONCE ) ) . '" title="Map IPTC/EXIF metadata for this item">Map IPTC/EXIF Metadata</a>' . "\r\n";
231
  }
232
 
233
  /**
30
 
31
  add_action( 'add_meta_boxes', 'MLAEdit::mla_add_meta_boxes_action', 10, 2 );
32
 
33
+ // apply_filters( 'post_updated_messages', $messages ) in wp-admin/edit-form-advanced.php
34
+ add_filter( 'post_updated_messages', 'MLAEdit::mla_post_updated_messages_filter', 10, 1 );
35
+
36
  // do_action in wp-admin/includes/meta-boxes.php function attachment_submit_meta_box
37
+ add_action( 'attachment_submitbox_misc_actions', 'MLAEdit::mla_attachment_submitbox_action' );
38
 
39
  // do_action in wp-includes/post.php function wp_insert_post
40
  add_action( 'edit_attachment', 'MLAEdit::mla_edit_attachment_action', 10, 1 );
41
 
42
+ // apply_filters( 'admin_title', $admin_title, $title ) in /wp-admin/admin-header.php
43
  add_filter( 'admin_title', 'MLAEdit::mla_edit_add_help_tab', 10, 2 );
44
  } // $wordpress_3point5_plus
45
  }
56
  add_post_type_support( 'attachment', 'custom-fields' );
57
  }
58
 
59
+ /**
60
+ * Adds mapping update messages for display at the top of the Edit Media screen.
61
+ * Declared public because it is a filter.
62
+ *
63
+ * @since 1.10
64
+ *
65
+ * @param array messages for the Edit screen
66
+ *
67
+ * @return array updated messages
68
+ */
69
+ public static function mla_post_updated_messages_filter( $messages ) {
70
+ if ( isset( $messages['attachment'] ) ) {
71
+ $messages['attachment'][101] = 'Custom Field mapping updated.';
72
+ $messages['attachment'][102] = 'IPTC/EXIF mapping updated.';
73
+ }
74
+
75
+ return $messages;
76
+ } // mla_post_updated_messages_filter
77
+
78
  /**
79
  * Adds Last Modified date to the Submit box on the Edit Media screen.
80
  * Declared public because it is an action.
83
  *
84
  * @return void echoes the HTML markup for the label and value
85
  */
86
+ public static function mla_attachment_submitbox_action( ) {
87
  global $post;
88
 
89
  $datef = __( 'M j, Y @ G:i' );
92
  echo '<div class="misc-pub-section curtime">' . "\r\n";
93
  echo '<span id="timestamp">' . sprintf($stamp, $date) . "</span>\r\n";
94
  echo "</div><!-- .misc-pub-section -->\r\n";
95
+ echo '<div class="misc-pub-section mla-links">' . "\r\n";
96
+
97
+ $view_args = array( 'page' => 'mla-menu', 'mla_item_ID' => $post->ID );
98
+ if ( isset( $_REQUEST['mla_source'] ) )
99
+ $view_args['mla_source'] = $_REQUEST['mla_source'];
100
+
101
+ echo '<span id="mla_metadata_links" style="font-weight: bold; line-height: 2em">';
102
+ echo '<a href="' . add_query_arg( $view_args, wp_nonce_url( 'upload.php?mla_admin_action=' . MLA::MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP, MLA::MLA_ADMIN_NONCE ) ) . '" title="Map Custom Field metadata for this item">Map Custom Field Metadata</a><br>';
103
+ echo '<a href="' . add_query_arg( $view_args, wp_nonce_url( 'upload.php?mla_admin_action=' . MLA::MLA_ADMIN_SINGLE_MAP, MLA::MLA_ADMIN_NONCE ) ) . '" title="Map IPTC/EXIF metadata for this item">Map IPTC/EXIF Metadata</a>';
104
+ echo "</span>\r\n";
105
+ echo "</div><!-- .misc-pub-section -->\r\n";
106
+ } // mla_attachment_submitbox_action
107
 
108
  /**
109
  * Registers meta boxes for the Edit Media screen.
160
  /*
161
  * Provide explicit control over tab order
162
  */
163
+ $tab_array = array();
164
 
165
  foreach ( $template_array as $id => $content ) {
166
  $match_count = preg_match( '#\<!-- title="(.+)" order="(.+)" --\>#', $content, $matches, PREG_OFFSET_CAPTURE );
255
  $value = '';
256
 
257
  echo '<label class="screen-reader-text" for="mla_image_metadata">Image Metadata</label><textarea class="readonly" id="mla_image_metadata" rows="5" cols="80" readonly="readonly" name="mla_image_metadata" >' . esc_textarea( $value ) . "</textarea>\r\n";
 
 
 
 
 
 
258
  }
259
 
260
  /**
includes/class-mla-list-table.php CHANGED
@@ -46,7 +46,7 @@ class MLA_List_Table extends WP_List_Table {
46
  *
47
  * @var array
48
  */
49
- private $currently_hidden = array( );
50
 
51
  /*
52
  * These arrays define the table columns.
@@ -64,6 +64,7 @@ class MLA_List_Table extends WP_List_Table {
64
  * bulk actions or checkboxes, simply leave the 'cb' entry out of your array.
65
  *
66
  * Taxonomy columns are added to this array by mla_admin_init_action.
 
67
  *
68
  * @since 0.1
69
  *
@@ -92,6 +93,7 @@ class MLA_List_Table extends WP_List_Table {
92
  'author' => 'Author',
93
  'attached_to' => 'Attached to'
94
  // taxonomy columns added by mla_admin_init_action
 
95
  );
96
 
97
  /**
@@ -104,6 +106,7 @@ class MLA_List_Table extends WP_List_Table {
104
  * array(0 => 'ID_parent, 1 => 'title_name').
105
  *
106
  * Taxonomy columns are added to this array by mla_admin_init_action.
 
107
  *
108
  * @since 0.1
109
  *
@@ -143,6 +146,9 @@ class MLA_List_Table extends WP_List_Table {
143
  * The array value also contains a boolean which is 'true' if the data is currently
144
  * sorted by that column. This is computed each time the table is displayed.
145
  *
 
 
 
146
  * @since 0.1
147
  *
148
  * @var array
@@ -168,6 +174,7 @@ class MLA_List_Table extends WP_List_Table {
168
  'author' => array('post_author',false),
169
  'attached_to' => array('post_parent',false),
170
  // sortable taxonomy columns, if any, added by mla_admin_init_action
 
171
  );
172
 
173
  /**
@@ -195,7 +202,7 @@ class MLA_List_Table extends WP_List_Table {
195
  * @return array Mime type names
196
  */
197
  private function _avail_mime_types( $num_posts ) {
198
- $available = array( );
199
 
200
  foreach ( $num_posts as $mime_type => $number ) {
201
  if ( ( $number > 0 ) && ( $mime_type <> 'trash' ) )
@@ -208,7 +215,7 @@ class MLA_List_Table extends WP_List_Table {
208
  /**
209
  * Get possible mime types for view preparation
210
  *
211
- * Modeled after get_post_mime_types in wp-admin/includes/post.php,
212
  * with additional entries.
213
  *
214
  * @since 0.1
@@ -290,7 +297,7 @@ class MLA_List_Table extends WP_List_Table {
290
  */
291
  public static function mla_get_sortable_columns( )
292
  {
293
- $results = array ( ) ;
294
 
295
  foreach ( MLA_List_Table::$default_sortable_columns as $key => $value ) {
296
  $value[1] = MLA_List_Table::$default_columns[ $key ];
@@ -356,10 +363,14 @@ class MLA_List_Table extends WP_List_Table {
356
  if ( MLAOptions::mla_taxonomy_support( $tax_name ) ) {
357
  $tax_object = get_taxonomy( $tax_name );
358
  MLA_List_Table::$default_columns[ 't_' . $tax_name ] = $tax_object->labels->name;
359
- MLA_List_Table::$default_hidden_columns [] = $tax_name;
360
  // MLA_List_Table::$default_sortable_columns [] = none at this time
361
  } // supported taxonomy
362
  } // foreach $tax_name
 
 
 
 
363
  }
364
 
365
  /**
@@ -413,7 +424,7 @@ class MLA_List_Table extends WP_List_Table {
413
  if ( empty( $terms ) )
414
  return 'none';
415
  else {
416
- $list = array( );
417
  foreach ( $terms as $term ) {
418
  $list[ ] = sprintf( '<a href="%s">%s</a>', esc_url( add_query_arg( array(
419
  'page' => 'mla-menu',
@@ -429,7 +440,10 @@ class MLA_List_Table extends WP_List_Table {
429
  else {
430
  return 'not supported';
431
  }
432
- }
 
 
 
433
  else {
434
  //Show the whole array for troubleshooting purposes
435
  return 'column_default: ' . $column_name . ', ' . print_r( $item, true );
@@ -478,7 +492,7 @@ class MLA_List_Table extends WP_List_Table {
478
  * @return array Names and URLs of row-level actions
479
  */
480
  private function _build_rollover_actions( $item, $column ) {
481
- $actions = array( );
482
 
483
  if ( ( $this->rollover_id != $item->ID ) && !in_array( $column, $this->currently_hidden ) ) {
484
  /*
@@ -1085,7 +1099,7 @@ class MLA_List_Table extends WP_List_Table {
1085
  function get_views( ) {
1086
  global $wpdb;
1087
 
1088
- $type_links = array( );
1089
  $_num_posts = (array) wp_count_attachments();
1090
  $_total_posts = array_sum( $_num_posts ) - $_num_posts['trash'];
1091
  $total_orphans = $wpdb->get_var(
@@ -1159,7 +1173,7 @@ class MLA_List_Table extends WP_List_Table {
1159
  */
1160
  function get_bulk_actions( )
1161
  {
1162
- $actions = array( );
1163
 
1164
  if ( $this->is_trash ) {
1165
  $actions['restore'] = 'Restore';
46
  *
47
  * @var array
48
  */
49
+ private $currently_hidden = array();
50
 
51
  /*
52
  * These arrays define the table columns.
64
  * bulk actions or checkboxes, simply leave the 'cb' entry out of your array.
65
  *
66
  * Taxonomy columns are added to this array by mla_admin_init_action.
67
+ * Custom field columns are added to this array by mla_admin_init_action.
68
  *
69
  * @since 0.1
70
  *
93
  'author' => 'Author',
94
  'attached_to' => 'Attached to'
95
  // taxonomy columns added by mla_admin_init_action
96
+ // custom field columns added by mla_admin_init_action
97
  );
98
 
99
  /**
106
  * array(0 => 'ID_parent, 1 => 'title_name').
107
  *
108
  * Taxonomy columns are added to this array by mla_admin_init_action.
109
+ * Custom field columns are added to this array by mla_admin_init_action.
110
  *
111
  * @since 0.1
112
  *
146
  * The array value also contains a boolean which is 'true' if the data is currently
147
  * sorted by that column. This is computed each time the table is displayed.
148
  *
149
+ * Taxonomy columns, if any, are added to this array by mla_admin_init_action.
150
+ * Custom field columns are added to this array by mla_admin_init_action.
151
+ *
152
  * @since 0.1
153
  *
154
  * @var array
174
  'author' => array('post_author',false),
175
  'attached_to' => array('post_parent',false),
176
  // sortable taxonomy columns, if any, added by mla_admin_init_action
177
+ // sortable custom field columns, if any, added by mla_admin_init_action
178
  );
179
 
180
  /**
202
  * @return array Mime type names
203
  */
204
  private function _avail_mime_types( $num_posts ) {
205
+ $available = array();
206
 
207
  foreach ( $num_posts as $mime_type => $number ) {
208
  if ( ( $number > 0 ) && ( $mime_type <> 'trash' ) )
215
  /**
216
  * Get possible mime types for view preparation
217
  *
218
+ * Modeled after get_post_mime_types in wp-includes/post.php,
219
  * with additional entries.
220
  *
221
  * @since 0.1
297
  */
298
  public static function mla_get_sortable_columns( )
299
  {
300
+ $results = array() ;
301
 
302
  foreach ( MLA_List_Table::$default_sortable_columns as $key => $value ) {
303
  $value[1] = MLA_List_Table::$default_columns[ $key ];
363
  if ( MLAOptions::mla_taxonomy_support( $tax_name ) ) {
364
  $tax_object = get_taxonomy( $tax_name );
365
  MLA_List_Table::$default_columns[ 't_' . $tax_name ] = $tax_object->labels->name;
366
+ MLA_List_Table::$default_hidden_columns [] = 't_' . $tax_name;
367
  // MLA_List_Table::$default_sortable_columns [] = none at this time
368
  } // supported taxonomy
369
  } // foreach $tax_name
370
+
371
+ MLA_List_Table::$default_columns = array_merge( MLA_List_Table::$default_columns, MLAOptions::mla_custom_field_support( 'default_columns' ) );
372
+ MLA_List_Table::$default_hidden_columns = array_merge( MLA_List_Table::$default_hidden_columns, MLAOptions::mla_custom_field_support( 'default_hidden_columns' ) );
373
+ MLA_List_Table::$default_sortable_columns = array_merge( MLA_List_Table::$default_sortable_columns, MLAOptions::mla_custom_field_support( 'default_sortable_columns' ) );
374
  }
375
 
376
  /**
424
  if ( empty( $terms ) )
425
  return 'none';
426
  else {
427
+ $list = array();
428
  foreach ( $terms as $term ) {
429
  $list[ ] = sprintf( '<a href="%s">%s</a>', esc_url( add_query_arg( array(
430
  'page' => 'mla-menu',
440
  else {
441
  return 'not supported';
442
  }
443
+ } // 't_'
444
+ elseif ( 'c_' == substr( $column_name, 0, 2 ) ) {
445
+ return get_post_meta( $item->ID, MLA_List_Table::$default_columns[ $column_name ], true );
446
+ } // 'c_'
447
  else {
448
  //Show the whole array for troubleshooting purposes
449
  return 'column_default: ' . $column_name . ', ' . print_r( $item, true );
492
  * @return array Names and URLs of row-level actions
493
  */
494
  private function _build_rollover_actions( $item, $column ) {
495
+ $actions = array();
496
 
497
  if ( ( $this->rollover_id != $item->ID ) && !in_array( $column, $this->currently_hidden ) ) {
498
  /*
1099
  function get_views( ) {
1100
  global $wpdb;
1101
 
1102
+ $type_links = array();
1103
  $_num_posts = (array) wp_count_attachments();
1104
  $_total_posts = array_sum( $_num_posts ) - $_num_posts['trash'];
1105
  $total_orphans = $wpdb->get_var(
1173
  */
1174
  function get_bulk_actions( )
1175
  {
1176
+ $actions = array();
1177
 
1178
  if ( $this->is_trash ) {
1179
  $actions['restore'] = 'Restore';
includes/class-mla-main.php CHANGED
@@ -38,7 +38,7 @@ class MLA {
38
  *
39
  * @var string
40
  */
41
- const CURRENT_MLA_VERSION = '1.00';
42
 
43
  /**
44
  * Minimum version of PHP required for this plugin
@@ -166,6 +166,15 @@ class MLA {
166
  */
167
  const MLA_ADMIN_SINGLE_TRASH = 'single_item_trash';
168
 
 
 
 
 
 
 
 
 
 
169
  /**
170
  * mla_admin_action value for mapping IPTC/EXIF metadata
171
  *
@@ -182,7 +191,7 @@ class MLA {
182
  *
183
  * @var array
184
  */
185
- private static $page_hooks = array( );
186
 
187
  /**
188
  * Initialization function, similar to __construct()
@@ -208,13 +217,42 @@ class MLA {
208
  }
209
 
210
  /**
211
- * Load the plugin's Ajax handler
212
  *
213
  * @since 0.20
214
  *
215
  * @return void
216
  */
217
  public static function mla_admin_init_action() {
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
218
  add_action( 'wp_ajax_' . self::JAVASCRIPT_INLINE_EDIT_SLUG, 'MLA::mla_inline_edit_action' );
219
  }
220
 
@@ -303,41 +341,6 @@ class MLA {
303
  }
304
 
305
  add_filter( 'parent_file', 'MLA::mla_parent_file_filter', 10, 1 );
306
-
307
- /*
308
- * For WordPress 3.5 and later we are using the native Edit Media screen,
309
- * so we want to get control back when the edits are completed.
310
- */
311
- if( MLATest::$wordpress_3point5_plus ) {
312
- add_filter( 'load-upload.php', 'MLA::mla_load_upload_php_action' );
313
- add_filter( 'load-post.php', 'MLA::mla_load_post_php_action' );
314
- }
315
- }
316
-
317
- /**
318
- * Intercept return from Edit Media screen
319
- *
320
- * @since 0.60
321
- *
322
- * @return void
323
- */
324
- public static function mla_load_upload_php_action( ) {
325
- // error_log('mla_load_upload_php_action current_screen = ' . var_export( get_current_screen(), true), 0 ); /* DGL */
326
- // error_log('mla_load_upload_php_action $_REQUEST = ' . var_export($_REQUEST, true ), 0 ); /* DGL */
327
- // error_log('mla_load_upload_php_action wp_get_referer() = ' . var_export(wp_get_referer(), true ), 0 ); /* DGL */
328
- }
329
-
330
- /**
331
- * Intercept call to Edit Media screen
332
- *
333
- * @since 0.60
334
- *
335
- * @return void
336
- */
337
- public static function mla_load_post_php_action( ) {
338
- // error_log('mla_load_post_php_action current_screen = ' . var_export( get_current_screen(), true), 0 ); /* DGL */
339
- // error_log('mla_load_post_php_action $_REQUEST = ' . var_export($_REQUEST, true ), 0 ); /* DGL */
340
- // error_log('mla_load_post_php_action wp_get_referer() = ' . var_export(wp_get_referer(), true ), 0 ); /* DGL */
341
  }
342
 
343
  /**
@@ -423,7 +426,7 @@ class MLA {
423
  /*
424
  * Provide explicit control over tab order
425
  */
426
- $tab_array = array( );
427
 
428
  foreach ( $template_array as $id => $content ) {
429
  $match_count = preg_match( '#\<!-- title="(.+)" order="(.+)" --\>#', $content, $matches, PREG_OFFSET_CAPTURE );
@@ -571,7 +574,7 @@ class MLA {
571
 
572
  echo "<div class=\"wrap\">\r\n";
573
  echo "<div id=\"icon-upload\" class=\"icon32\"><br/></div>\r\n";
574
- echo "<h2>Media Library Assistant"; // omit trailing </h2> for now
575
 
576
  if ( !current_user_can( 'upload_files' ) ) {
577
  echo " - Error</h2>\r\n";
@@ -587,7 +590,7 @@ class MLA {
587
  * The category taxonomy is a special case because post_categories_meta_box() changes the input name
588
  */
589
  if ( !isset( $_REQUEST['tax_input'] ) )
590
- $_REQUEST['tax_input'] = array ();
591
 
592
  if ( isset( $_REQUEST['post_category'] ) ) {
593
  $_REQUEST['tax_input']['category'] = $_REQUEST['post_category'];
@@ -609,14 +612,22 @@ class MLA {
609
  $item_content = self::_delete_single_item( $post_id );
610
  break;
611
  case 'edit':
 
 
 
 
 
 
 
612
  if ( !empty( $_REQUEST['bulk_map'] ) ) {
613
  $item = get_post( $post_id );
614
  $updates = MLAOptions::mla_evaluate_iptc_exif_mapping( $item, 'iptc_exif_mapping' );
 
615
  $item_content = MLAData::mla_update_single_item( $post_id, $updates );
616
  break;
617
  }
618
 
619
- $new_data = array ( ) ;
620
  if ( isset( $_REQUEST['post_parent'] ) && is_numeric( $_REQUEST['post_parent'] ) )
621
  $new_data['post_parent'] = $_REQUEST['post_parent'];
622
 
@@ -681,11 +692,6 @@ class MLA {
681
  case self::MLA_ADMIN_SINGLE_TRASH:
682
  $page_content = self::_trash_single_item( $_REQUEST['mla_item_ID'] );
683
  break;
684
- case self::MLA_ADMIN_SINGLE_MAP:
685
- $item = get_post( $_REQUEST['mla_item_ID'] );
686
- $updates = MLAOptions::mla_evaluate_iptc_exif_mapping( $item, 'iptc_exif_mapping' );
687
- $page_content = MLAData::mla_update_single_item( $_REQUEST['mla_item_ID'], $updates );
688
- break;
689
  default:
690
  $page_content = array(
691
  'message' => sprintf( 'Unknown mla_admin_action - "%1$s"', $_REQUEST['mla_admin_action'] ),
@@ -852,7 +858,7 @@ class MLA {
852
  * The category taxonomy is a special case because post_categories_meta_box() changes the input name
853
  */
854
  if ( !isset( $_REQUEST['tax_input'] ) )
855
- $_REQUEST['tax_input'] = array ();
856
 
857
  if ( isset( $_REQUEST['post_category'] ) ) {
858
  $_REQUEST['tax_input']['category'] = $_REQUEST['post_category'];
@@ -863,7 +869,7 @@ class MLA {
863
  /*
864
  * Flat taxonomy strings must be cleaned up and duplicates removed
865
  */
866
- $tax_output = array ();
867
  $tax_input = $_REQUEST['tax_input'];
868
  foreach ( $tax_input as $tax_name => $tax_value ) {
869
  if ( ! is_array( $tax_value ) ) {
@@ -879,7 +885,7 @@ class MLA {
879
  if ( ',' != $comma )
880
  $tax_value = str_replace( ',', $comma, $tax_value );
881
 
882
- $tax_array = array ();
883
  $dedup_array = explode( $comma, $tax_value );
884
  foreach ( $dedup_array as $tax_value )
885
  $tax_array [$tax_value] = $tax_value;
@@ -1398,7 +1404,7 @@ class MLA {
1398
  /*
1399
  * Posts are restored to "draft" status, so this must be updated.
1400
  */
1401
- $update_post = array( );
1402
  $update_post['ID'] = $post_id;
1403
  $update_post['post_status'] = 'inherit';
1404
  wp_update_post( $update_post );
38
  *
39
  * @var string
40
  */
41
+ const CURRENT_MLA_VERSION = '1.10';
42
 
43
  /**
44
  * Minimum version of PHP required for this plugin
166
  */
167
  const MLA_ADMIN_SINGLE_TRASH = 'single_item_trash';
168
 
169
+ /**
170
+ * mla_admin_action value for mapping Custom Field metadata
171
+ *
172
+ * @since 1.10
173
+ *
174
+ * @var string
175
+ */
176
+ const MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP = 'single_item_custom_field_map';
177
+
178
  /**
179
  * mla_admin_action value for mapping IPTC/EXIF metadata
180
  *
191
  *
192
  * @var array
193
  */
194
+ private static $page_hooks = array();
195
 
196
  /**
197
  * Initialization function, similar to __construct()
217
  }
218
 
219
  /**
220
+ * Load the plugin's Ajax handler or process Edit Media update actions
221
  *
222
  * @since 0.20
223
  *
224
  * @return void
225
  */
226
  public static function mla_admin_init_action() {
227
+ /*
228
+ * Process row-level actions from the Edit Media screen
229
+ */
230
+ if ( !empty( $_REQUEST['mla_admin_action'] ) ) {
231
+ check_admin_referer( self::MLA_ADMIN_NONCE );
232
+
233
+ switch ( $_REQUEST['mla_admin_action'] ) {
234
+ case self::MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP:
235
+ $updates = MLAOptions::mla_evaluate_custom_field_mapping( $_REQUEST['mla_item_ID'], 'single_attachment_mapping' );
236
+
237
+ if ( !empty( $updates ) )
238
+ $item_content = MLAData::mla_update_single_item( $_REQUEST['mla_item_ID'], $updates );
239
+
240
+ $view_args = isset( $_REQUEST['mla_source'] ) ? array( 'mla_source' => $_REQUEST['mla_source']) : array();
241
+ wp_redirect( add_query_arg( $view_args, admin_url( 'post.php' ) . '?post=' . $_REQUEST['mla_item_ID'] . '&action=edit&message=101' ), 302 );
242
+ exit;
243
+ case self::MLA_ADMIN_SINGLE_MAP:
244
+ $item = get_post( $_REQUEST['mla_item_ID'] );
245
+ $updates = MLAOptions::mla_evaluate_iptc_exif_mapping( $item, 'iptc_exif_mapping' );
246
+ $page_content = MLAData::mla_update_single_item( $_REQUEST['mla_item_ID'], $updates );
247
+
248
+ $view_args = isset( $_REQUEST['mla_source'] ) ? array( 'mla_source' => $_REQUEST['mla_source']) : array();
249
+ wp_redirect( add_query_arg( $view_args, admin_url( 'post.php' ) . '?post=' . $_REQUEST['mla_item_ID'] . '&action=edit&message=102' ), 302 );
250
+ exit;
251
+ default:
252
+ // ignore the rest
253
+ } // switch ($_REQUEST['mla_admin_action'])
254
+ } // (!empty($_REQUEST['mla_admin_action'])
255
+
256
  add_action( 'wp_ajax_' . self::JAVASCRIPT_INLINE_EDIT_SLUG, 'MLA::mla_inline_edit_action' );
257
  }
258
 
341
  }
342
 
343
  add_filter( 'parent_file', 'MLA::mla_parent_file_filter', 10, 1 );
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
344
  }
345
 
346
  /**
426
  /*
427
  * Provide explicit control over tab order
428
  */
429
+ $tab_array = array();
430
 
431
  foreach ( $template_array as $id => $content ) {
432
  $match_count = preg_match( '#\<!-- title="(.+)" order="(.+)" --\>#', $content, $matches, PREG_OFFSET_CAPTURE );
574
 
575
  echo "<div class=\"wrap\">\r\n";
576
  echo "<div id=\"icon-upload\" class=\"icon32\"><br/></div>\r\n";
577
+ echo "<h2>Media Library Assistant"; // trailing </h2> is action-specific
578
 
579
  if ( !current_user_can( 'upload_files' ) ) {
580
  echo " - Error</h2>\r\n";
590
  * The category taxonomy is a special case because post_categories_meta_box() changes the input name
591
  */
592
  if ( !isset( $_REQUEST['tax_input'] ) )
593
+ $_REQUEST['tax_input'] = array();
594
 
595
  if ( isset( $_REQUEST['post_category'] ) ) {
596
  $_REQUEST['tax_input']['category'] = $_REQUEST['post_category'];
612
  $item_content = self::_delete_single_item( $post_id );
613
  break;
614
  case 'edit':
615
+ if ( !empty( $_REQUEST['bulk_custom_field_map'] ) ) {
616
+ $updates = MLAOptions::mla_evaluate_custom_field_mapping( $post_id, 'single_attachment_mapping' );
617
+
618
+ $item_content = MLAData::mla_update_single_item( $post_id, $updates );
619
+ break;
620
+ }
621
+
622
  if ( !empty( $_REQUEST['bulk_map'] ) ) {
623
  $item = get_post( $post_id );
624
  $updates = MLAOptions::mla_evaluate_iptc_exif_mapping( $item, 'iptc_exif_mapping' );
625
+
626
  $item_content = MLAData::mla_update_single_item( $post_id, $updates );
627
  break;
628
  }
629
 
630
+ $new_data = array() ;
631
  if ( isset( $_REQUEST['post_parent'] ) && is_numeric( $_REQUEST['post_parent'] ) )
632
  $new_data['post_parent'] = $_REQUEST['post_parent'];
633
 
692
  case self::MLA_ADMIN_SINGLE_TRASH:
693
  $page_content = self::_trash_single_item( $_REQUEST['mla_item_ID'] );
694
  break;
 
 
 
 
 
695
  default:
696
  $page_content = array(
697
  'message' => sprintf( 'Unknown mla_admin_action - "%1$s"', $_REQUEST['mla_admin_action'] ),
858
  * The category taxonomy is a special case because post_categories_meta_box() changes the input name
859
  */
860
  if ( !isset( $_REQUEST['tax_input'] ) )
861
+ $_REQUEST['tax_input'] = array();
862
 
863
  if ( isset( $_REQUEST['post_category'] ) ) {
864
  $_REQUEST['tax_input']['category'] = $_REQUEST['post_category'];
869
  /*
870
  * Flat taxonomy strings must be cleaned up and duplicates removed
871
  */
872
+ $tax_output = array();
873
  $tax_input = $_REQUEST['tax_input'];
874
  foreach ( $tax_input as $tax_name => $tax_value ) {
875
  if ( ! is_array( $tax_value ) ) {
885
  if ( ',' != $comma )
886
  $tax_value = str_replace( ',', $comma, $tax_value );
887
 
888
+ $tax_array = array();
889
  $dedup_array = explode( $comma, $tax_value );
890
  foreach ( $dedup_array as $tax_value )
891
  $tax_array [$tax_value] = $tax_value;
1404
  /*
1405
  * Posts are restored to "draft" status, so this must be updated.
1406
  */
1407
+ $update_post = array();
1408
  $update_post['ID'] = $post_id;
1409
  $update_post['post_status'] = 'inherit';
1410
  wp_update_post( $update_post );
includes/class-mla-options.php CHANGED
@@ -41,6 +41,11 @@ class MLAOptions {
41
  */
42
  const MLA_MLA_GALLERY_IN_TUNING = 'mla_gallery_in_tuning';
43
 
 
 
 
 
 
44
  /**
45
  * Provides a unique name for the Custom Field "new field" key
46
  */
@@ -272,7 +277,7 @@ class MLAOptions {
272
  'style_templates' =>
273
  array('tab' => '',
274
  'type' => 'hidden',
275
- 'std' => array( )),
276
 
277
  /*
278
  * Managed by mla_get_markup_templates and mla_put_markup_templates
@@ -280,7 +285,24 @@ class MLAOptions {
280
  'markup_templates' =>
281
  array('tab' => '',
282
  'type' => 'hidden',
283
- 'std' => array( )),
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
284
 
285
  'enable_iptc_exif_mapping' =>
286
  array('tab' => 'iptc-exif',
@@ -302,7 +324,7 @@ class MLAOptions {
302
  'iptc_exif_taxonomy_mapping' =>
303
  array('tab' => '',
304
  'help' => 'Update the taxonomy term mapping values above, then click Save Changes or Map All Attachments Now.',
305
- 'std' => NULL,
306
  'type' => 'custom',
307
  'render' => 'mla_iptc_exif_option_handler',
308
  'update' => 'mla_iptc_exif_option_handler',
@@ -410,6 +432,9 @@ class MLAOptions {
410
 
411
  if ( 'checked' == MLAOptions::mla_get_option( 'enable_iptc_exif_mapping' ) )
412
  add_action( 'add_attachment', 'MLAOptions::mla_add_attachment_action' );
 
 
 
413
  }
414
 
415
  /**
@@ -504,7 +529,7 @@ class MLAOptions {
504
  return null;
505
  }
506
 
507
- $templates = array( );
508
  foreach ( self::$mla_option_templates as $key => $value ) {
509
  $tail = strrpos( $key, '-style' );
510
  if ( ! ( false === $tail ) ) {
@@ -546,7 +571,7 @@ class MLAOptions {
546
  return null;
547
  }
548
 
549
- $templates = array( );
550
  foreach ( self::$mla_option_templates as $key => $value ) {
551
  $tail = strrpos( $key, '-row-open-markup' );
552
  if ( ! ( false === $tail ) ) {
@@ -675,7 +700,7 @@ class MLAOptions {
675
 
676
  switch ( $support_type ) {
677
  case 'support':
678
- $tax_support = isset( $tax_options['tax_support'] ) ? $tax_options['tax_support'] : array ();
679
  $is_supported = array_key_exists( $tax_name, $tax_support );
680
 
681
  if ( !empty( $_REQUEST['mla-general-options-save'] ) ) {
@@ -693,7 +718,7 @@ class MLAOptions {
693
 
694
  return $is_supported;
695
  case 'quick-edit':
696
- $tax_quick_edit = isset( $tax_options['tax_quick_edit'] ) ? $tax_options['tax_quick_edit'] : array ();
697
  $is_supported = array_key_exists( $tax_name, $tax_quick_edit );
698
 
699
  if ( !empty( $_REQUEST['mla-general-options-save'] ) ) {
@@ -751,8 +776,8 @@ class MLAOptions {
751
  case 'render':
752
  $taxonomies = get_taxonomies( array ( 'show_ui' => 'true' ), 'objects' );
753
  $current_values = self::mla_get_option( $key );
754
- $tax_support = isset( $current_values['tax_support'] ) ? $current_values['tax_support'] : array ();
755
- $tax_quick_edit = isset( $current_values['tax_quick_edit'] ) ? $current_values['tax_quick_edit'] : array ();
756
  $tax_filter = isset( $current_values['tax_filter'] ) ? $current_values['tax_filter'] : '';
757
 
758
  /*
@@ -807,8 +832,8 @@ class MLAOptions {
807
  return MLAData::mla_parse_template( self::$mla_option_templates['taxonomy-table'], $option_values );
808
  case 'update':
809
  case 'delete':
810
- $tax_support = isset( $args['tax_support'] ) ? $args['tax_support'] : array ();
811
- $tax_quick_edit = isset( $args['tax_quick_edit'] ) ? $args['tax_quick_edit'] : array ();
812
  $tax_filter = isset( $args['tax_filter'] ) ? $args['tax_filter'] : '';
813
 
814
  $msg = '';
@@ -855,11 +880,814 @@ class MLAOptions {
855
  * @return void
856
  */
857
  public static function mla_add_attachment_action( $post_id ) {
858
- $item = get_post( $post_id );
859
- $updates = MLAOptions::mla_evaluate_iptc_exif_mapping( $item, 'iptc_exif_mapping' );
860
- $item_content = MLAData::mla_update_single_item( $post_id, $updates );
861
- } // mla_taxonomy_option_handler
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
862
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
863
  /**
864
  * Evaluate IPTC/EXIF mapping updates for a post
865
  *
@@ -872,12 +1700,10 @@ class MLAOptions {
872
  * @return array Updates suitable for MLAData::mla_update_single_item, if any
873
  */
874
  public static function mla_evaluate_iptc_exif_mapping( $post, $category, $settings = NULL ) {
875
- // error_log( '$post = ' . var_export( $post->post_name, true ) , 0 );
876
  $metadata = MLAData::mla_fetch_attachment_image_metadata( $post->ID );
877
- // error_log( '$metadata = ' . var_export( $metadata, true ) , 0 );
878
  $iptc_metadata = $metadata['mla_iptc_metadata'];
879
  $exif_metadata = $metadata['mla_exif_metadata'];
880
- $updates = array( );
881
  $update_all = ( 'iptc_exif_mapping' == $category );
882
  if ( NULL == $settings )
883
  $settings = self::mla_get_option( 'iptc_exif_mapping' );
@@ -956,7 +1782,7 @@ class MLAOptions {
956
  if ( is_string( $new_text ) )
957
  $new_text = array( $new_text );
958
 
959
- $new_terms = array( );
960
  foreach( $new_text as $new_term ) {
961
  $term_object = term_exists( $new_term, $new_key );
962
  if ($term_object !== 0 && $term_object !== null)
@@ -988,7 +1814,6 @@ class MLAOptions {
988
  foreach( $settings['custom'] as $new_key => $new_value ) {
989
  $iptc_value = ( isset( $iptc_metadata[ $new_value['iptc_value'] ] ) ) ? $iptc_metadata[ $new_value['iptc_value'] ] : '';
990
  $exif_value = ( isset( $exif_metadata[ $new_value['exif_value'] ] ) ) ? $exif_metadata[ $new_value['exif_value'] ] : '';
991
- $keep_existing = (boolean) $new_value['keep_existing'];
992
 
993
  if ( $new_value['iptc_first'] )
994
  if ( ! empty( $iptc_value ) )
@@ -1001,8 +1826,12 @@ class MLAOptions {
1001
  else
1002
  $new_text = $iptc_value;
1003
 
1004
- $old_text = get_metadata( 'post', $post->ID, $new_key, true );
1005
- if ( empty( $old_text ) || !$keep_existing ) {
 
 
 
 
1006
  $custom_updates[ $new_key ] = $new_text;
1007
  }
1008
  } // foreach new setting
@@ -1346,7 +2175,7 @@ class MLAOptions {
1346
  /*
1347
  * Uncomment this for debugging.
1348
  */
1349
- $error_list .= $message_list;
1350
 
1351
  return array( 'message' => $error_list, 'values' => $current_values, 'changed' => $settings_changed );
1352
  } // _update_iptc_exif_custom_mapping
@@ -1657,7 +2486,7 @@ class MLAOptions {
1657
  if ( $settings_changed )
1658
  return "IPTC/EXIF Custom field settings saved.\r\n";
1659
  else
1660
- return "ERROR: IPTC/EXIF Custom field settings update failed.\r\n";
1661
  case 'iptc_exif_mapping':
1662
  self::mla_delete_option( $key );
1663
  return "<br>Reset custom {$key}\r\n";
@@ -1667,6 +2496,6 @@ class MLAOptions {
1667
  default:
1668
  return "<br>ERROR: Custom {$key} unknown action: {$action}\r\n";
1669
  } // switch $action
1670
- } // mla_taxonomy_option_handler
1671
  } // class MLAOptions
1672
  ?>
41
  */
42
  const MLA_MLA_GALLERY_IN_TUNING = 'mla_gallery_in_tuning';
43
 
44
+ /**
45
+ * Provides a unique name for the Custom Field "new rule" key
46
+ */
47
+ const MLA_NEW_CUSTOM_RULE = '__NEW RULE__';
48
+
49
  /**
50
  * Provides a unique name for the Custom Field "new field" key
51
  */
277
  'style_templates' =>
278
  array('tab' => '',
279
  'type' => 'hidden',
280
+ 'std' => array()),
281
 
282
  /*
283
  * Managed by mla_get_markup_templates and mla_put_markup_templates
285
  'markup_templates' =>
286
  array('tab' => '',
287
  'type' => 'hidden',
288
+ 'std' => array()),
289
+
290
+ 'enable_custom_field_mapping' =>
291
+ array('tab' => 'custom-field',
292
+ 'name' => 'Enable custom field mapping when adding new media',
293
+ 'type' => 'checkbox',
294
+ 'std' => '',
295
+ 'help' => 'Check this option to enable mapping when uploading new media (attachments).<br>&nbsp;&nbsp;Click Save Changes at the bottom of the screen if you change this option.<br>&nbsp;&nbsp;Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'),
296
+
297
+ 'custom_field_mapping' =>
298
+ array('tab' => '',
299
+ 'help' => '&nbsp;<br>Update the custom field mapping values above, then click Save Changes to make the updates permanent.<br>You can also make temporary updates and click a Map All Attachments button to apply the rule(s) to all attachments without saving any rule changes.',
300
+ 'std' => array(),
301
+ 'type' => 'custom',
302
+ 'render' => 'mla_custom_field_option_handler',
303
+ 'update' => 'mla_custom_field_option_handler',
304
+ 'delete' => 'mla_custom_field_option_handler',
305
+ 'reset' => 'mla_custom_field_option_handler'),
306
 
307
  'enable_iptc_exif_mapping' =>
308
  array('tab' => 'iptc-exif',
324
  'iptc_exif_taxonomy_mapping' =>
325
  array('tab' => '',
326
  'help' => 'Update the taxonomy term mapping values above, then click Save Changes or Map All Attachments Now.',
327
+ 'std' => NULL,
328
  'type' => 'custom',
329
  'render' => 'mla_iptc_exif_option_handler',
330
  'update' => 'mla_iptc_exif_option_handler',
432
 
433
  if ( 'checked' == MLAOptions::mla_get_option( 'enable_iptc_exif_mapping' ) )
434
  add_action( 'add_attachment', 'MLAOptions::mla_add_attachment_action' );
435
+
436
+ if ( 'checked' == MLAOptions::mla_get_option( 'enable_custom_field_mapping' ) )
437
+ add_filter( 'wp_update_attachment_metadata', 'MLAOptions::mla_update_attachment_metadata_filter', 10, 2 ); // $data, $post_id
438
  }
439
 
440
  /**
529
  return null;
530
  }
531
 
532
+ $templates = array();
533
  foreach ( self::$mla_option_templates as $key => $value ) {
534
  $tail = strrpos( $key, '-style' );
535
  if ( ! ( false === $tail ) ) {
571
  return null;
572
  }
573
 
574
+ $templates = array();
575
  foreach ( self::$mla_option_templates as $key => $value ) {
576
  $tail = strrpos( $key, '-row-open-markup' );
577
  if ( ! ( false === $tail ) ) {
700
 
701
  switch ( $support_type ) {
702
  case 'support':
703
+ $tax_support = isset( $tax_options['tax_support'] ) ? $tax_options['tax_support'] : array();
704
  $is_supported = array_key_exists( $tax_name, $tax_support );
705
 
706
  if ( !empty( $_REQUEST['mla-general-options-save'] ) ) {
718
 
719
  return $is_supported;
720
  case 'quick-edit':
721
+ $tax_quick_edit = isset( $tax_options['tax_quick_edit'] ) ? $tax_options['tax_quick_edit'] : array();
722
  $is_supported = array_key_exists( $tax_name, $tax_quick_edit );
723
 
724
  if ( !empty( $_REQUEST['mla-general-options-save'] ) ) {
776
  case 'render':
777
  $taxonomies = get_taxonomies( array ( 'show_ui' => 'true' ), 'objects' );
778
  $current_values = self::mla_get_option( $key );
779
+ $tax_support = isset( $current_values['tax_support'] ) ? $current_values['tax_support'] : array();
780
+ $tax_quick_edit = isset( $current_values['tax_quick_edit'] ) ? $current_values['tax_quick_edit'] : array();
781
  $tax_filter = isset( $current_values['tax_filter'] ) ? $current_values['tax_filter'] : '';
782
 
783
  /*
832
  return MLAData::mla_parse_template( self::$mla_option_templates['taxonomy-table'], $option_values );
833
  case 'update':
834
  case 'delete':
835
+ $tax_support = isset( $args['tax_support'] ) ? $args['tax_support'] : array();
836
+ $tax_quick_edit = isset( $args['tax_quick_edit'] ) ? $args['tax_quick_edit'] : array();
837
  $tax_filter = isset( $args['tax_filter'] ) ? $args['tax_filter'] : '';
838
 
839
  $msg = '';
880
  * @return void
881
  */
882
  public static function mla_add_attachment_action( $post_id ) {
883
+ if ( 'checked' == MLAOptions::mla_get_option( 'enable_iptc_exif_mapping' ) ) {
884
+ $item = get_post( $post_id );
885
+ $updates = MLAOptions::mla_evaluate_iptc_exif_mapping( $item, 'iptc_exif_mapping' );
886
+
887
+ if ( !empty( $updates ) )
888
+ $item_content = MLAData::mla_update_single_item( $post_id, $updates );
889
+ }
890
+ } // mla_add_attachment_action
891
+
892
+ /**
893
+ * Perform Custom Field mapping on just-inserted or updated attachment
894
+ *
895
+ * @since 1.10
896
+ *
897
+ * @param array Attachment metadata for just-inserted attachment
898
+ * @param integer ID of just-inserted attachment
899
+ *
900
+ * @return void
901
+ */
902
+ public static function mla_update_attachment_metadata_filter( $data, $post_id ) {
903
+ if ( 'checked' == MLAOptions::mla_get_option( 'enable_custom_field_mapping' ) ) {
904
+ $updates = MLAOptions::mla_evaluate_custom_field_mapping( $post_id, 'single_attachment_mapping', NULL, $data );
905
+
906
+ if ( !empty( $updates ) )
907
+ $item_content = MLAData::mla_update_single_item( $post_id, $updates );
908
+ }
909
+
910
+ return $data;
911
+ } // mla_update_attachment_metadata_filter
912
+
913
+ /**
914
+ * Fetch custom field option value given a slug
915
+ *
916
+ * @since 1.10
917
+ *
918
+ * @param string slug, e.g., 'c_file-size' for the 'File Size' field
919
+ *
920
+ * @return array option value, e.g., array( 'name' => 'File Size', ... )
921
+ */
922
+ public static function mla_custom_field_option_value( $slug ) {
923
+ $option_values = self::mla_get_option( 'custom_field_mapping' );
924
+
925
+ foreach( $option_values as $key => $value ) {
926
+ if ( $slug == 'c_' . sanitize_title( $key ) )
927
+ return $value;
928
+ }
929
+
930
+ return array();
931
+ } // mla_custom_field_option_value
932
+
933
+ /**
934
+ * Evaluate file information for custom field mapping
935
+ *
936
+ * @since 1.10
937
+ *
938
+ * @param string array format; 'default_columns' (default), 'default_hidden_columns' or 'default_sortable_columns'
939
+ *
940
+ * @return array default, hidden or sortable colums in appropriate format
941
+ */
942
+ public static function mla_custom_field_support( $support_type = 'default_columns' ) {
943
+ $option_values = self::mla_get_option( 'custom_field_mapping' );
944
+ $results = array();
945
+
946
+ foreach( $option_values as $key => $value ) {
947
+ if ( $value['mla_column'] ) {
948
+ $slug = 'c_' . sanitize_title( $key );
949
+ switch( $support_type ) {
950
+ case 'default_columns':
951
+ $results[ $slug ] = $value['name'];
952
+ break;
953
+ case 'default_hidden_columns':
954
+ $results[ ] = $slug;
955
+ break;
956
+ case 'default_sortable_columns':
957
+ $results[ $slug ] = array( $slug, false );
958
+ break;
959
+ } // switch support_type
960
+ } // is mla_column
961
+ } // foreach option_value
962
+
963
+ return $results;
964
+ } // mla_custom_field_support
965
+
966
+ /**
967
+ * Evaluate file information for custom field mapping
968
+ *
969
+ * @since 1.10
970
+ *
971
+ * @param string absolute path the the uploads base directory
972
+ * @param array _wp_attached_file meta_value array, indexed by post_id
973
+ * @param array _wp_attachment_metadata meta_value array, indexed by post_id
974
+ * @param integer post->ID of attachment
975
+ *
976
+ * @return array absolute_path, base_file, path, file_name, extension, dimensions, width, height, hwstring_small, array of intermediate sizes
977
+ */
978
+ private static function _evaluate_file_information( $upload_dir, &$wp_attached_files, &$wp_attachment_metadata, $post_id ) {
979
+ $results = array(
980
+ 'absolute_path' => '',
981
+ 'base_file' => '',
982
+ 'path' => '',
983
+ 'file_name' => '',
984
+ 'extension' => '',
985
+ 'width' => '',
986
+ 'height' => '',
987
+ 'hwstring_small' => '',
988
+ 'sizes' => array()
989
+ );
990
+
991
+ $attached_file = isset( $wp_attached_files[ $post_id ]->meta_value ) ? $wp_attached_files[ $post_id ]->meta_value : '';
992
+ $attachment_metadata = isset( $wp_attachment_metadata[ $post_id ]->meta_value ) ? unserialize( $wp_attachment_metadata[ $post_id ]->meta_value ) : array();
993
+
994
+ if ( !empty( $attachment_metadata ) ) {
995
+ $base_file = $attachment_metadata['file'];
996
+ $sizes = isset( $attachment_metadata['sizes'] ) ? $attachment_metadata['sizes'] : array();
997
+ $results['width'] = $attachment_metadata['width'];
998
+ $results['height'] = $attachment_metadata['height'];
999
+ $results['hwstring_small'] = isset( $attachment_metadata['hwstring_small'] ) ? $attachment_metadata['hwstring_small'] : '';
1000
+
1001
+ foreach( $attachment_metadata['image_meta'] as $key => $value )
1002
+ $results[ $key ] = $value;
1003
+ }
1004
+ else {
1005
+ $base_file = $attached_file;
1006
+ $sizes = array();
1007
+ }
1008
+
1009
+ if ( ! empty( $base_file ) ) {
1010
+ $results['base_file'] = $base_file;
1011
+ $last_slash = strrpos( $base_file, '/' );
1012
+ if ( false === $last_slash ) {
1013
+ $results['absolute_path'] = $upload_dir;
1014
+ $results['file_name'] = wptexturize( $base_file );
1015
+ }
1016
+ else {
1017
+ $file_name = substr( $base_file, $last_slash + 1 );
1018
+ $path = substr( $base_file, 0, $last_slash + 1 );
1019
+ $results['absolute_path'] = $upload_dir . $path;
1020
+ $results['path'] = wptexturize( $path );
1021
+ $results['file_name'] = wptexturize( $file_name );
1022
+ }
1023
+
1024
+ $last_dot = strrpos( $base_file, '.' );
1025
+ if ( false === $last_dot ) {
1026
+ $results['extension'] = '';
1027
+ }
1028
+ else {
1029
+ $results['extension'] = substr( $base_file, $last_dot + 1 );
1030
+ }
1031
+
1032
+ }
1033
+
1034
+ $results['sizes'] = $sizes;
1035
+ return $results;
1036
+ } // _evaluate_file_information
1037
+
1038
+ /**
1039
+ * Evaluate custom field mapping data source
1040
+ *
1041
+ * @since 1.10
1042
+ *
1043
+ * @param integer post->ID of attachment
1044
+ * @param string category/scope to evaluate against: custom_field_mapping or single_attachment_mapping
1045
+ * @param string data source name
1046
+ * @param string desired results format, default 'native'
1047
+ * @param array (optional) attachment_metadata, default NULL (use current postmeta database value)
1048
+ *
1049
+ * @return string data source value
1050
+ */
1051
+ private static function _evaluate_data_source( $post_id, $category, $data_source, $format = 'native', $attachment_metadata = NULL ) {
1052
+ global $wpdb;
1053
+ static $upload_dir, $intermediate_sizes = NULL, $wp_attached_files = NULL, $wp_attachment_metadata = NULL;
1054
+ static $current_id = 0, $file_info = NULL;
1055
+
1056
+ /*
1057
+ * Do this once per page load; cache attachment metadata if mapping all attachments
1058
+ */
1059
+ if ( NULL == $intermediate_sizes ) {
1060
+ $upload_dir = wp_upload_dir();
1061
+ $upload_dir = $upload_dir['basedir'] . '/';
1062
+ $intermediate_sizes = get_intermediate_image_sizes();
1063
+
1064
+ if ( 'custom_field_mapping' == $category ) {
1065
+ if ( ! $table = _get_meta_table('post') ) {
1066
+ $wp_attached_files = array();
1067
+ $wp_attachment_metadata = array();
1068
+ }
1069
+ else {
1070
+ $wp_attachment_metadata = $wpdb->get_results( "SELECT post_id, meta_value FROM {$table} WHERE meta_key = '_wp_attachment_metadata'", OBJECT_K );
1071
+ $wp_attached_files = $wpdb->get_results( "SELECT post_id, meta_value FROM {$table} WHERE meta_key = '_wp_attached_file'", OBJECT_K );
1072
+ }
1073
+ } // custom_field_mapping, i.e., mapping all attachments
1074
+ } // first call after page load
1075
+
1076
+ /*
1077
+ * Do this once per post. Simulate SQL results for $wp_attached_files and $wp_attachment_metadata.
1078
+ */
1079
+ if ( $current_id != $post_id ) {
1080
+ $current_id = $post_id;
1081
+ if ( 'single_attachment_mapping' == $category ) {
1082
+ $meta_value = get_metadata( 'post', $post_id, '_wp_attached_file' );
1083
+ $wp_attached_files = array( $post_id => (object) array( 'post_id' => $post_id, 'meta_value' => $meta_value[0] ) );
1084
+
1085
+ if ( NULL == $attachment_metadata )
1086
+ $attachment_metadata = get_metadata( 'post', $post_id, '_wp_attachment_metadata' );
1087
+
1088
+ if ( empty( $attachment_metadata ) )
1089
+ $attachment_metadata = array();
1090
+
1091
+ $wp_attachment_metadata = array( $post_id => (object) array( 'post_id' => $post_id, 'meta_value' => serialize( $attachment_metadata[0] ) ) );
1092
+ }
1093
+
1094
+ $file_info = self::_evaluate_file_information( $upload_dir, $wp_attached_files, $wp_attachment_metadata, $post_id );
1095
+ }
1096
+
1097
+ $size_info = array( 'file' => '', 'width' => '', 'height' => '' );
1098
+ $match_count = preg_match( '/(.+)\[(.+)\]/', $data_source, $matches );
1099
+ if ( 1 == $match_count ) {
1100
+ $data_source = $matches[1] . '[size]';
1101
+ if ( isset( $file_info['sizes'][ $matches[2] ] ) )
1102
+ $size_info = $file_info['sizes'][ $matches[2] ];
1103
+ }
1104
+
1105
+ $result = '';
1106
+
1107
+ switch( $data_source ) {
1108
+ case 'path':
1109
+ case 'file_name':
1110
+ case 'extension':
1111
+ case 'width':
1112
+ case 'height':
1113
+ case 'hwstring_small':
1114
+ case 'aperture':
1115
+ case 'credit':
1116
+ case 'camera':
1117
+ case 'caption':
1118
+ case 'created_timestamp':
1119
+ case 'copyright':
1120
+ case 'focal_length':
1121
+ case 'iso':
1122
+ case 'shutter_speed':
1123
+ case 'title':
1124
+ $result = $file_info[ $data_source ];
1125
+ break;
1126
+ case 'file_size':
1127
+ $filesize = @ filesize( $file_info['absolute_path'] . $file_info['file_name'] );
1128
+ if ( ! (false === $filesize ) )
1129
+ $result = $filesize;
1130
+ break;
1131
+ case 'dimensions':
1132
+ $result = $file_info['width'] . 'x' . $file_info['height'];
1133
+ if ( 'x' == $result )
1134
+ $result = '';
1135
+ break;
1136
+ case 'pixels':
1137
+ $result = absint( (int) $file_info['width'] * (int) $file_info['height'] );
1138
+ if ( 0 == $result )
1139
+ $result = '';
1140
+ else
1141
+ $result = (string) $result;
1142
+ break;
1143
+ case 'size_keys':
1144
+ foreach( $file_info['sizes'] as $key => $value ) {
1145
+ $result .= $key . ', ';
1146
+ }
1147
+ if ( $result )
1148
+ $result = rtrim( $result, ', ' );
1149
+ break;
1150
+ case 'size_names':
1151
+ foreach( $file_info['sizes'] as $key => $value ) {
1152
+ $result .= $value['file'] . ', ';
1153
+ }
1154
+ if ( $result )
1155
+ $result = rtrim( $result, ', ' );
1156
+ break;
1157
+ case 'size_bytes':
1158
+ foreach( $file_info['sizes'] as $key => $value ) {
1159
+ $filesize = @ filesize( $file_info['absolute_path'] . $value['file'] );
1160
+ if ( false === $filesize )
1161
+ $result .= '?, ';
1162
+ else {
1163
+ switch( $format ) {
1164
+ case 'commas':
1165
+ if ( is_numeric( $filesize ) )
1166
+ $filesize = number_format( (float)$filesize );
1167
+ break;
1168
+ default:
1169
+ // no change
1170
+ } // format
1171
+ $result .= $filesize . ', ';
1172
+ }
1173
+ }
1174
+ if ( $result )
1175
+ $result = rtrim( $result, ', ' );
1176
+ break;
1177
+ case 'size_pixels':
1178
+ foreach( $file_info['sizes'] as $key => $value ) {
1179
+ $pixels = absint( (int) $value['width'] * (int) $value['height'] );
1180
+
1181
+ switch( $format ) {
1182
+ case 'commas':
1183
+ if ( is_numeric( $pixels ) )
1184
+ $pixels = number_format( (float)$pixels );
1185
+ break;
1186
+ default:
1187
+ // no change
1188
+ } // format
1189
+ $result .= $pixels . ', ';
1190
+ }
1191
+ if ( $result )
1192
+ $result = rtrim( $result, ', ' );
1193
+ break;
1194
+ case 'size_dimensions':
1195
+ foreach( $file_info['sizes'] as $key => $value ) {
1196
+ $result .= $value['width'] . 'x' . $value['height'] . ', ';
1197
+ }
1198
+ if ( $result )
1199
+ $result = rtrim( $result, ', ' );
1200
+ break;
1201
+ case 'size_name[size]':
1202
+ $result = $size_info['file'];
1203
+ break;
1204
+ case 'size_bytes[size]':
1205
+ $result = @ filesize( $file_info['absolute_path'] . $size_info['file'] );
1206
+ if ( false === $result )
1207
+ $result .= '?';
1208
+ break;
1209
+ case 'size_pixels[size]':
1210
+ $result = absint( (int) $size_info['width'] * (int) $size_info['height'] );
1211
+ break;
1212
+ case 'size_dimensions[size]':
1213
+ $result = $size_info['width'] . 'x' . $size_info['height'];
1214
+ if ( 'x' == $result )
1215
+ $result = '';
1216
+ break;
1217
+ case 'parent_type':
1218
+ case 'parent_title':
1219
+ $parent_info = $wpdb->get_col( "SELECT post_parent FROM {$wpdb->posts} WHERE ID = '{$post_id}'" );
1220
+ if ( is_array( $parent_info) ) {
1221
+ $parent_info = MLAData::mla_fetch_attachment_parent_data( $parent_info[0] );
1222
+ if ( isset( $parent_info[ $data_source ] ) )
1223
+ $result = $parent_info[ $data_source ];
1224
+ }
1225
+ break;
1226
+ case 'parent_issues':
1227
+ $parent_info = $wpdb->get_col( "SELECT post_parent FROM {$wpdb->posts} WHERE ID = '{$post_id}'" );
1228
+ $parent_id = is_array( $parent_info) ? $parent_info[0] : 0;
1229
+ $references = MLAData::mla_fetch_attachment_references( $post_id, $parent_id );
1230
+
1231
+ if ( !empty( $references['parent_errors'] ) ) {
1232
+ $result = $references['parent_errors'];
1233
+ /*
1234
+ * Remove (ORPHAN...
1235
+ */
1236
+ if ( false !== strpos( $result, '(ORPHAN)' ) )
1237
+ $result = trim( substr( $result, 8) );
1238
+ elseif ( false !== strpos( $result, '(ORPHAN?)' ) )
1239
+ $result = trim( substr( $result, 9) );
1240
+ }
1241
+ break;
1242
+ case 'reference_issues':
1243
+ $parent_info = $wpdb->get_col( "SELECT post_parent FROM {$wpdb->posts} WHERE ID = '{$post_id}'" );
1244
+ $parent_id = is_array( $parent_info) ? $parent_info[0] : 0;
1245
+ $references = MLAData::mla_fetch_attachment_references( $post_id, $parent_id );
1246
+ if ( !empty( $references['parent_errors'] ) )
1247
+ $result = $references['parent_errors'];
1248
+ break;
1249
+ default:
1250
+ return '';
1251
+ } // switch $data_source
1252
+
1253
+ switch( $format ) {
1254
+ case 'commas':
1255
+ if ( is_numeric( $result ) )
1256
+ $result = number_format( (float)$result );
1257
+ break;
1258
+ default:
1259
+ // no change
1260
+ } // format
1261
+
1262
+ /*
1263
+ * Make numeric values sortable as strings, make all value non-empty
1264
+ */
1265
+ if ( in_array( $data_source, array( 'file_size', 'pixels', 'width', 'height' ) ) )
1266
+ $result = str_pad( $result, 15, ' ', STR_PAD_LEFT );
1267
+ elseif ( empty( $result ) )
1268
+ $result = ' ';
1269
+
1270
+ return $result;
1271
+ } // _evaluate_data_source
1272
 
1273
+ /**
1274
+ * Evaluate custom field mapping updates for a post
1275
+ *
1276
+ * @since 1.10
1277
+ *
1278
+ * @param integer post ID to be evaluated
1279
+ * @param string category/scope to evaluate against: custom_field_mapping or single_attachment_mapping
1280
+ * @param array (optional) custom_field_mapping values, default NULL (use current option value)
1281
+ * @param array (optional) attachment_metadata, default NULL (use current postmeta database value)
1282
+ *
1283
+ * @return array Updates suitable for MLAData::mla_update_single_item, if any
1284
+ */
1285
+ public static function mla_evaluate_custom_field_mapping( $post_id, $category, $settings = NULL, $attachment_metadata = NULL ) {
1286
+ if ( NULL == $settings )
1287
+ $settings = self::mla_get_option( 'custom_field_mapping' );
1288
+
1289
+ $updates = array();
1290
+ $custom_updates = array();
1291
+
1292
+ foreach( $settings as $new_key => $new_value ) {
1293
+ if ( $new_value['keep_existing'] )
1294
+ $old_text = get_metadata( 'post', $post_id, $new_key, true );
1295
+ else
1296
+ $old_text = '';
1297
+
1298
+ if ( empty( $old_text ) )
1299
+ $custom_updates[ $new_value['name'] ] = self::_evaluate_data_source( $post_id, $category, $new_value['data_source'], $new_value['format'], $attachment_metadata );
1300
+ } // foreach new setting
1301
+
1302
+ if ( ! empty( $custom_updates ) )
1303
+ $updates['custom_updates'] = $custom_updates;
1304
+
1305
+ return $updates;
1306
+ } // mla_evaluate_custom_field_mapping
1307
+
1308
+ /**
1309
+ * Compose a Custom Field Options list with current selection
1310
+ *
1311
+ * @since 1.10
1312
+ * @uses $mla_option_templates contains row and table templates
1313
+ *
1314
+ * @param string current selection or 'none' (default)
1315
+ *
1316
+ * @return string HTML markup with select field options
1317
+ */
1318
+ private static function _compose_custom_field_option_list( $selection = 'none' ) {
1319
+ $option_template = self::$mla_option_templates['custom-field-select-option'];
1320
+ $option_values = array (
1321
+ 'selected' => ( 'none' == $selection ) ? 'selected="selected"' : '',
1322
+ 'value' => 'none',
1323
+ 'text' => ' -- None (select a value) -- '
1324
+ );
1325
+
1326
+ $custom_field_options = MLAData::mla_parse_template( $option_template, $option_values );
1327
+ $custom_field_names = MLAOptions::_get_custom_field_names();
1328
+ foreach ( $custom_field_names as $value ) {
1329
+ $option_values = array (
1330
+ 'selected' => ( $value == $selection ) ? 'selected="selected"' : '',
1331
+ 'value' => $value,
1332
+ 'text' => $value
1333
+ );
1334
+
1335
+ $custom_field_options .= MLAData::mla_parse_template( $option_template, $option_values );
1336
+ } // foreach custom_field_name
1337
+
1338
+ return $custom_field_options;
1339
+ } // _compose_custom_field_option_list
1340
+
1341
+ /**
1342
+ * Array of Data Source names for custom field mapping
1343
+ *
1344
+ * @since 1.10
1345
+ *
1346
+ * @var array
1347
+ */
1348
+ private static $custom_field_data_sources = array (
1349
+ 'path',
1350
+ 'file_name',
1351
+ 'extension',
1352
+ 'file_size',
1353
+ 'dimensions',
1354
+ 'pixels',
1355
+ 'width',
1356
+ 'height',
1357
+ 'hwstring_small',
1358
+ 'size_keys',
1359
+ 'size_names',
1360
+ 'size_bytes',
1361
+ 'size_pixels',
1362
+ 'size_dimensions',
1363
+ 'size_name[size]',
1364
+ 'size_bytes[size]',
1365
+ 'size_pixels[size]',
1366
+ 'size_dimensions[size]',
1367
+ 'parent_type',
1368
+ 'parent_title',
1369
+ 'parent_issues',
1370
+ 'reference_issues',
1371
+ 'aperture',
1372
+ 'credit',
1373
+ 'camera',
1374
+ 'caption',
1375
+ 'created_timestamp',
1376
+ 'copyright',
1377
+ 'focal_length',
1378
+ 'iso',
1379
+ 'shutter_speed',
1380
+ 'title'
1381
+ );
1382
+
1383
+ /**
1384
+ * Compose a (Custom Field) Data Source Options list with current selection
1385
+ *
1386
+ * @since 1.10
1387
+ * @uses $mla_option_templates contains row and table templates
1388
+ *
1389
+ * @param string current selection or 'none' (default)
1390
+ *
1391
+ * @return string HTML markup with select field options
1392
+ */
1393
+ private static function _compose_data_source_option_list( $selection = 'none' ) {
1394
+ $option_template = self::$mla_option_templates['custom-field-select-option'];
1395
+ $option_values = array (
1396
+ 'selected' => ( 'none' == $selection ) ? 'selected="selected"' : '',
1397
+ 'value' => 'none',
1398
+ 'text' => ' -- None (select a value) -- '
1399
+ );
1400
+
1401
+ $custom_field_options = MLAData::mla_parse_template( $option_template, $option_values );
1402
+ $intermediate_sizes = get_intermediate_image_sizes();
1403
+
1404
+ foreach ( self::$custom_field_data_sources as $value ) {
1405
+ $size_pos = strpos( $value, '[size]' );
1406
+ if ( $size_pos ) {
1407
+ $root_value = substr( $value, 0, $size_pos );
1408
+ foreach( $intermediate_sizes as $size_name ) {
1409
+ $value = $root_value . '[' . $size_name . ']';
1410
+ $option_values = array (
1411
+ 'selected' => ( $value == $selection ) ? 'selected="selected"' : '',
1412
+ 'value' => $value,
1413
+ 'text' => $value
1414
+ );
1415
+
1416
+ $custom_field_options .= MLAData::mla_parse_template( $option_template, $option_values );
1417
+ } // foreach size_name
1418
+ continue;
1419
+ }
1420
+ else {
1421
+ $option_values = array (
1422
+ 'selected' => ( $value == $selection ) ? 'selected="selected"' : '',
1423
+ 'value' => $value,
1424
+ 'text' => $value
1425
+ );
1426
+ }
1427
+
1428
+ $custom_field_options .= MLAData::mla_parse_template( $option_template, $option_values );
1429
+ } // foreach custom_field_name
1430
+
1431
+ return $custom_field_options;
1432
+ } // _compose_data_source_option_list
1433
+
1434
+ /**
1435
+ * Update custom field mappings
1436
+ *
1437
+ * @since 1.10
1438
+ *
1439
+ * @param array current custom_field_mapping values
1440
+ * @param array new values
1441
+ *
1442
+ * @return array ( 'message' => HTML message(s) reflecting results, 'values' => updated iptc_exif_mapping values, 'changed' => true if any changes detected else false )
1443
+ */
1444
+ private static function _update_custom_field_mapping( $current_values, $new_values ) {
1445
+ $error_list = '';
1446
+ $message_list = '';
1447
+ $settings_changed = false;
1448
+
1449
+ foreach ( $new_values as $new_key => $new_value ) {
1450
+ $any_setting_changed = false;
1451
+
1452
+ /*
1453
+ * Check for the addition of a new rule or field
1454
+ */
1455
+ if ( self::MLA_NEW_CUSTOM_FIELD == $new_key ) {
1456
+ $new_key = trim( $new_value['name'] );
1457
+
1458
+ if ( empty( $new_key ) )
1459
+ continue;
1460
+
1461
+ $message_list .= "<br>Adding new field {$new_key}.\r\n";
1462
+ $any_setting_changed = true;
1463
+ }
1464
+ elseif ( self::MLA_NEW_CUSTOM_RULE == $new_key ) {
1465
+ $new_key = trim( $new_value['name'] );
1466
+
1467
+ if ( 'none' == $new_key )
1468
+ continue;
1469
+
1470
+ $message_list .= "<br>Adding new rule for {$new_key}.\r\n";
1471
+ $any_setting_changed = true;
1472
+ }
1473
+ else {
1474
+ /*
1475
+ * Replace slug with field name
1476
+ */
1477
+ $new_key = trim( $new_value['name'] );
1478
+ }
1479
+
1480
+ if ( isset( $current_values[ $new_key ] ) ) {
1481
+ $old_values = $current_values[ $new_key ];
1482
+ $any_setting_changed = false;
1483
+ }
1484
+ else {
1485
+ $old_values = array(
1486
+ 'name' => $new_key,
1487
+ 'data_source' => 'none',
1488
+ 'keep_existing' => true,
1489
+ 'format' => 'native',
1490
+ 'mla_column' => false
1491
+ );
1492
+ }
1493
+
1494
+ if ( isset( $new_value['action'] ) ) {
1495
+ if ( array_key_exists( 'delete_rule', $new_value['action'] ) || array_key_exists( 'delete_field', $new_value['action'] ) ) {
1496
+ $settings_changed = true;
1497
+ $message_list .= "<br>deleting rule for {$old_values['name']}.\r\n";
1498
+ unset( $current_values[ $new_key ] );
1499
+ continue;
1500
+ } // delete rule
1501
+ } // isset action
1502
+
1503
+ if ( $old_values['data_source'] != $new_value['data_source'] ) {
1504
+ $any_setting_changed = true;
1505
+ $message_list .= "<br>{$old_values['name']} changing Data Source from {$old_values['data_source']} to {$new_value['data_source']}.\r\n";
1506
+ $old_values['data_source'] = $new_value['data_source'];
1507
+ }
1508
+
1509
+ if ( $new_value['keep_existing'] ) {
1510
+ $boolean_value = true;
1511
+ $boolean_text = 'Replace to Keep';
1512
+ }
1513
+ else {
1514
+ $boolean_value = false;
1515
+ $boolean_text = 'Keep to Replace';
1516
+ }
1517
+ if ( $old_values['keep_existing'] != $boolean_value ) {
1518
+ $any_setting_changed = true;
1519
+ $message_list .= "<br>{$old_values['name']} changing Existing Text value from {$boolean_text}.\r\n";
1520
+ $old_values['keep_existing'] = $boolean_value;
1521
+ }
1522
+
1523
+ if ( $old_values['format'] != $new_value['format'] ) {
1524
+ $any_setting_changed = true;
1525
+ $message_list .= "<br>{$old_values['name']} changing Format from {$old_values['format']} to {$new_value['format']}.\r\n";
1526
+ $old_values['format'] = $new_value['format'];
1527
+ }
1528
+
1529
+ if ( isset( $new_value['mla_column'] ) ) {
1530
+ $boolean_value = true;
1531
+ $boolean_text = 'unchecked to checked';
1532
+ }
1533
+ else {
1534
+ $boolean_value = false;
1535
+ $boolean_text = 'checked to unchecked';
1536
+ }
1537
+ if ( $old_values['mla_column'] != $boolean_value ) {
1538
+ $any_setting_changed = true;
1539
+ $message_list .= "<br>{$old_values['name']} changing MLA Column value from {$boolean_text}.\r\n";
1540
+ $old_values['mla_column'] = $boolean_value;
1541
+ }
1542
+
1543
+ if ( $any_setting_changed ) {
1544
+ $settings_changed = true;
1545
+ $current_values[ $new_key ] = $old_values;
1546
+ }
1547
+ } // foreach new value
1548
+
1549
+ /*
1550
+ * Uncomment this for debugging.
1551
+ */
1552
+ // $error_list .= $message_list;
1553
+
1554
+ return array( 'message' => $error_list, 'values' => $current_values, 'changed' => $settings_changed );
1555
+ } // _update_custom_field_mapping
1556
+
1557
+ /**
1558
+ * Render and manage custom field mapping options
1559
+ *
1560
+ * @since 1.10
1561
+ * @uses $mla_option_templates contains row and table templates
1562
+ *
1563
+ * @param string 'render', 'update', 'delete', or 'reset'
1564
+ * @param string option name, e.g., 'custom_field_mapping'
1565
+ * @param array option parameters
1566
+ * @param array Optional. null (default) for 'render' else option data, e.g., $_REQUEST
1567
+ *
1568
+ * @return string HTML table row markup for 'render' else message(s) reflecting the results of the operation.
1569
+ */
1570
+ public static function mla_custom_field_option_handler( $action, $key, $value, $args = null ) {
1571
+ $current_values = self::mla_get_option( 'custom_field_mapping' );
1572
+
1573
+ switch ( $action ) {
1574
+ case 'render':
1575
+ if (empty( $current_values ) ) {
1576
+ $table_rows = MLAData::mla_parse_template( self::$mla_option_templates['custom-field-empty-row'], array( 'column_count' => 5 ) );
1577
+ }
1578
+ else {
1579
+ $row_template = self::$mla_option_templates['custom-field-rule-row'];
1580
+ $table_rows = '';
1581
+ }
1582
+
1583
+ foreach ( $current_values as $row_name => $current_value ) {
1584
+ $row_values = array (
1585
+ 'key' => sanitize_title( $row_name ),
1586
+ 'name' => $row_name,
1587
+ 'data_source_options' => self::_compose_data_source_option_list( $current_value['data_source'] ),
1588
+ 'keep_selected' => '',
1589
+ 'replace_selected' => '',
1590
+ 'native_format' => '',
1591
+ 'commas_format' => '',
1592
+ 'mla_column_checked' => '',
1593
+ 'column_count' => 5
1594
+ );
1595
+
1596
+ if ( $current_value['keep_existing'] )
1597
+ $row_values['keep_selected'] = 'selected="selected"';
1598
+ else
1599
+ $row_values['replace_selected'] = 'selected="selected"';
1600
+
1601
+ switch( $current_value['format'] ) {
1602
+ case 'native':
1603
+ $row_values['native_format'] = 'selected="selected"';
1604
+ break;
1605
+ case 'commas':
1606
+ $row_values['commas_format'] = 'selected="selected"';
1607
+ break;
1608
+ default:
1609
+ $row_values['native_format'] = 'selected="selected"';
1610
+ } // format
1611
+
1612
+ if ( $current_value['mla_column'] )
1613
+ $row_values['mla_column_checked'] = 'checked="checked"';
1614
+
1615
+ $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
1616
+ } // foreach current_value
1617
+
1618
+ /*
1619
+ * Add a row for defining a new Custom Rule
1620
+ */
1621
+ $row_template = self::$mla_option_templates['custom-field-new-rule-row'];
1622
+ $row_values = array (
1623
+ 'key' => self::MLA_NEW_CUSTOM_RULE,
1624
+ 'field_name_options' => self::_compose_custom_field_option_list( 'none' ),
1625
+ 'data_source_options' => self::_compose_data_source_option_list( 'none' ),
1626
+ 'keep_selected' => '',
1627
+ 'replace_selected' => 'selected="selected"',
1628
+ 'native_format' => 'selected="selected"',
1629
+ 'commas_format' => '',
1630
+ 'mla_column_checked' => '',
1631
+ 'column_count' => 5
1632
+ );
1633
+ $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
1634
+
1635
+ /*
1636
+ * Add a row for defining a new Custom Field
1637
+ */
1638
+ $row_template = self::$mla_option_templates['custom-field-new-field-row'];
1639
+ $row_values = array (
1640
+ 'key' => self::MLA_NEW_CUSTOM_FIELD,
1641
+ 'field_name_size' => '24',
1642
+ 'data_source_options' => self::_compose_data_source_option_list( 'none' ),
1643
+ 'keep_selected' => '',
1644
+ 'replace_selected' => 'selected="selected"',
1645
+ 'native_format' => 'selected="selected"',
1646
+ 'commas_format' => '',
1647
+ 'mla_column_checked' => '',
1648
+ 'column_count' => 5
1649
+ );
1650
+ $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
1651
+
1652
+ $option_values = array (
1653
+ 'table_rows' => $table_rows,
1654
+ 'help' => $value['help']
1655
+ );
1656
+
1657
+ return MLAData::mla_parse_template( self::$mla_option_templates['custom-field-table'], $option_values );
1658
+ case 'update':
1659
+ case 'delete':
1660
+ $settings_changed = false;
1661
+ $messages = '';
1662
+
1663
+ $results = self::_update_custom_field_mapping( $current_values, $args );
1664
+ $messages .= $results['message'];
1665
+ $current_values = $results['values'];
1666
+ $settings_changed = $results['changed'];
1667
+
1668
+ if ( $settings_changed ) {
1669
+ $settings_changed = MLAOptions::mla_update_option( 'custom_field_mapping', $current_values );
1670
+ if ( $settings_changed )
1671
+ $results = "Custom field mapping rules updated.\r\n";
1672
+ else
1673
+ $results = "ERROR: Custom field mapping rules update failed.\r\n";
1674
+ }
1675
+ else
1676
+ $results = "Custom field no mapping rule changes detected.\r\n";
1677
+
1678
+ return $results . $messages;
1679
+ case 'reset':
1680
+ $current_values = self::$mla_option_definitions['custom_field_mapping']['std'];
1681
+ $settings_changed = MLAOptions::mla_update_option( 'custom_field_mapping', $current_values );
1682
+ if ( $settings_changed )
1683
+ return "Custom field mapping settings saved.\r\n";
1684
+ else
1685
+ return "ERROR: Custom field mapping settings reset failed.\r\n";
1686
+ default:
1687
+ return "<br>ERROR: Custom {$key} unknown action: {$action}\r\n";
1688
+ } // switch $action
1689
+ } // mla_custom_field_option_handler
1690
+
1691
  /**
1692
  * Evaluate IPTC/EXIF mapping updates for a post
1693
  *
1700
  * @return array Updates suitable for MLAData::mla_update_single_item, if any
1701
  */
1702
  public static function mla_evaluate_iptc_exif_mapping( $post, $category, $settings = NULL ) {
 
1703
  $metadata = MLAData::mla_fetch_attachment_image_metadata( $post->ID );
 
1704
  $iptc_metadata = $metadata['mla_iptc_metadata'];
1705
  $exif_metadata = $metadata['mla_exif_metadata'];
1706
+ $updates = array();
1707
  $update_all = ( 'iptc_exif_mapping' == $category );
1708
  if ( NULL == $settings )
1709
  $settings = self::mla_get_option( 'iptc_exif_mapping' );
1782
  if ( is_string( $new_text ) )
1783
  $new_text = array( $new_text );
1784
 
1785
+ $new_terms = array();
1786
  foreach( $new_text as $new_term ) {
1787
  $term_object = term_exists( $new_term, $new_key );
1788
  if ($term_object !== 0 && $term_object !== null)
1814
  foreach( $settings['custom'] as $new_key => $new_value ) {
1815
  $iptc_value = ( isset( $iptc_metadata[ $new_value['iptc_value'] ] ) ) ? $iptc_metadata[ $new_value['iptc_value'] ] : '';
1816
  $exif_value = ( isset( $exif_metadata[ $new_value['exif_value'] ] ) ) ? $exif_metadata[ $new_value['exif_value'] ] : '';
 
1817
 
1818
  if ( $new_value['iptc_first'] )
1819
  if ( ! empty( $iptc_value ) )
1826
  else
1827
  $new_text = $iptc_value;
1828
 
1829
+ if ( $new_value['keep_existing'] )
1830
+ $old_text = get_metadata( 'post', $post->ID, $new_key, true );
1831
+ else
1832
+ $old_text = '';
1833
+
1834
+ if ( empty( $old_text ) ) {
1835
  $custom_updates[ $new_key ] = $new_text;
1836
  }
1837
  } // foreach new setting
2175
  /*
2176
  * Uncomment this for debugging.
2177
  */
2178
+ // $error_list .= $message_list;
2179
 
2180
  return array( 'message' => $error_list, 'values' => $current_values, 'changed' => $settings_changed );
2181
  } // _update_iptc_exif_custom_mapping
2486
  if ( $settings_changed )
2487
  return "IPTC/EXIF Custom field settings saved.\r\n";
2488
  else
2489
+ return "ERROR: IPTC/EXIF Custom field settings reset failed.\r\n";
2490
  case 'iptc_exif_mapping':
2491
  self::mla_delete_option( $key );
2492
  return "<br>Reset custom {$key}\r\n";
2496
  default:
2497
  return "<br>ERROR: Custom {$key} unknown action: {$action}\r\n";
2498
  } // switch $action
2499
+ } // mla_iptc_exif_option_handler
2500
  } // class MLAOptions
2501
  ?>
includes/class-mla-settings.php CHANGED
@@ -13,20 +13,6 @@
13
  * @since 0.1
14
  */
15
  class MLASettings {
16
- /**
17
- * Provides a unique name for the ALT Text SQL VIEW
18
- *
19
- * @since 0.40
20
- *
21
- * @var array
22
- */
23
- public static $mla_alt_text_view = null;
24
-
25
- /**
26
- * Provides a unique suffix for the ALT Text SQL VIEW
27
- */
28
- const MLA_ALT_TEXT_VIEW_SUFFIX = 'alt_text_view';
29
-
30
  /**
31
  * Provides a unique name for the settings page
32
  */
@@ -40,12 +26,8 @@ class MLASettings {
40
  * @return void
41
  */
42
  public static function initialize( ) {
43
- global $table_prefix;
44
-
45
- self::$mla_alt_text_view = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
46
  add_action( 'admin_menu', 'MLASettings::mla_admin_menu_action' );
47
  self::_version_upgrade();
48
- self::_create_alt_text_view();
49
  }
50
 
51
  /**
@@ -87,39 +69,6 @@ class MLASettings {
87
  MLAOptions::mla_update_option( MLAOptions::MLA_VERSION_OPTION, MLA::CURRENT_MLA_VERSION );
88
  }
89
 
90
- /**
91
- * Add a view to the database to support sorting the listing on 'ALT Text'
92
- *
93
- * This function is called on each plugin invocation because the plugin upgrade process
94
- * does not call the activation hook.
95
- *
96
- * @since 0.50
97
- *
98
- * @return void
99
- */
100
- private static function _create_alt_text_view( ) {
101
- global $wpdb, $table_prefix;
102
-
103
- $view_name = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
104
- $table_name = $table_prefix . 'postmeta';
105
- $result = $wpdb->query(
106
- "
107
- SHOW TABLES LIKE '{$view_name}'
108
- "
109
- );
110
-
111
- if ( 0 == $result ) {
112
- $result = $wpdb->query(
113
- "
114
- CREATE OR REPLACE VIEW {$view_name} AS
115
- SELECT post_id, meta_value
116
- FROM {$table_name}
117
- WHERE {$table_name}.meta_key = '_wp_attachment_image_alt'
118
- "
119
- );
120
- }
121
- }
122
-
123
  /**
124
  * Perform one-time actions on plugin activation
125
  *
@@ -130,13 +79,13 @@ class MLASettings {
130
  * @return void
131
  */
132
  public static function mla_activation_hook( ) {
133
- self::_create_alt_text_view();
134
  }
135
 
136
  /**
137
  * Perform one-time actions on plugin deactivation
138
  *
139
- * Removes a view from the database that supports sorting the listing on 'ALT Text'.
140
  *
141
  * @since 0.40
142
  *
@@ -145,19 +94,11 @@ class MLASettings {
145
  public static function mla_deactivation_hook( ) {
146
  global $wpdb, $table_prefix;
147
 
148
- $view_name = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
149
- $result = $wpdb->query(
150
- "
151
- SHOW TABLES LIKE '{$view_name}'
152
- "
153
- );
154
 
155
  if ( $result) {
156
- $result = $wpdb->query(
157
- "
158
- DROP VIEW {$view_name}
159
- "
160
- );
161
  }
162
  }
163
 
@@ -432,6 +373,7 @@ class MLASettings {
432
  private static $mla_tablist = array(
433
  'general' => array( 'title' => 'General', 'render' => '_compose_general_tab' ),
434
  'mla-gallery' => array( 'title' => 'MLA Gallery', 'render' => '_compose_mla_gallery_tab' ),
 
435
  'iptc-exif' => array( 'title' => 'IPTC/EXIF', 'render' => '_compose_iptc_exif_tab' ),
436
  'documentation' => array( 'title' => 'Documentation', 'render' => '_compose_documentation_tab' )
437
  );
@@ -847,6 +789,111 @@ class MLASettings {
847
  return $page_content;
848
  }
849
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
850
  /**
851
  * Compose the IPTC/EXIF tab content for the Settings subpage
852
  *
@@ -856,7 +903,6 @@ class MLASettings {
856
  * @return array 'message' => status/error messages, 'body' => tab content
857
  */
858
  private static function _compose_iptc_exif_tab( ) {
859
- // error_log( '_compose_iptc_exif_tab $_REQUEST = ' . var_export( $_REQUEST, true ), 0 );
860
  /*
861
  * Check for submit buttons to change or reset settings.
862
  * Initialize page messages and content.
@@ -1019,10 +1065,10 @@ class MLASettings {
1019
  * Get the current style contents for comparison
1020
  */
1021
  $old_templates = MLAOptions::mla_get_style_templates();
1022
- $new_templates = array( );
1023
  $new_names = $_REQUEST['mla_style_templates_name'];
1024
  $new_values = stripslashes_deep( $_REQUEST['mla_style_templates_value'] );
1025
- $new_deletes = isset( $_REQUEST['mla_style_templates_delete'] ) ? $_REQUEST['mla_style_templates_delete']: array( );
1026
 
1027
  /*
1028
  * Build new style template array, noting changes
@@ -1043,12 +1089,12 @@ class MLASettings {
1043
  if ( '' == $new_slug )
1044
  continue;
1045
  elseif ( 'blank' == $new_slug ) {
1046
- $error_list .= "<br>Error: reserved name '{$new_slug}', new style template discarded.";
1047
  continue;
1048
  }
1049
 
1050
  if( array_key_exists( $new_slug, $old_templates ) ) {
1051
- $error_list .= "<br>Error: duplicate name '{$new_slug}', new style template discarded.";
1052
  continue;
1053
  }
1054
  else {
@@ -1061,13 +1107,13 @@ class MLASettings {
1061
  * Handle name changes, check for duplicates
1062
  */
1063
  if ( '' == $new_slug ) {
1064
- $error_list .= "<br>Error: blank style template name value, reverting to '{$name}'.";
1065
  $new_slug = $name;
1066
  }
1067
 
1068
  if ( $new_slug != $name ) {
1069
  if( array_key_exists( $new_slug, $old_templates ) ) {
1070
- $error_list .= "<br>Error: duplicate new style template name '{$new_slug}', reverting to '{$name}'.";
1071
  $new_slug = $name;
1072
  }
1073
  elseif ( 'blank' != $name ) {
@@ -1087,21 +1133,21 @@ class MLASettings {
1087
  if ( $templates_changed ) {
1088
  $settings_changed = true;
1089
  if ( false == MLAOptions::mla_put_style_templates( $new_templates ) )
1090
- $error_list .= "<br>Error: update of style templates failed.";
1091
  }
1092
 
1093
  /*
1094
  * Get the current markup contents for comparison
1095
  */
1096
  $old_templates = MLAOptions::mla_get_markup_templates();
1097
- $new_templates = array( );
1098
  $new_names = $_REQUEST['mla_markup_templates_name'];
1099
  $new_values['open'] = stripslashes_deep( $_REQUEST['mla_markup_templates_open'] );
1100
  $new_values['row-open'] = stripslashes_deep( $_REQUEST['mla_markup_templates_row_open'] );
1101
  $new_values['item'] = stripslashes_deep( $_REQUEST['mla_markup_templates_item'] );
1102
  $new_values['row-close'] = stripslashes_deep( $_REQUEST['mla_markup_templates_row_close'] );
1103
  $new_values['close'] = stripslashes_deep( $_REQUEST['mla_markup_templates_close'] );
1104
- $new_deletes = isset( $_REQUEST['mla_markup_templates_delete'] ) ? $_REQUEST['mla_markup_templates_delete']: array( );
1105
 
1106
  /*
1107
  * Build new markup template array, noting changes
@@ -1123,12 +1169,12 @@ class MLASettings {
1123
  continue;
1124
 
1125
  if ( 'blank' == $new_slug ) {
1126
- $error_list .= "<br>Error: reserved name '{$new_slug}', new markup template discarded.";
1127
  continue;
1128
  }
1129
 
1130
  if( array_key_exists( $new_slug, $old_templates ) ) {
1131
- $error_list .= "<br>Error: duplicate name '{$new_slug}', new markup template discarded.";
1132
  continue;
1133
  }
1134
  else {
@@ -1141,18 +1187,18 @@ class MLASettings {
1141
  * Handle name changes, check for duplicates
1142
  */
1143
  if ( '' == $new_slug ) {
1144
- $error_list .= "<br>Error: blank markup template name value, reverting to '{$name}'.";
1145
  $new_slug = $name;
1146
  }
1147
 
1148
  if ( $new_slug != $name ) {
1149
  if( array_key_exists( $new_slug, $old_templates ) ) {
1150
- $error_list .= "<br>Error: duplicate new markup template name '{$new_slug}', reverting to '{$name}'.";
1151
  $new_slug = $name;
1152
  }
1153
 
1154
  if( array_key_exists( $new_slug, $old_templates ) ) {
1155
- $error_list .= "<br>Error: duplicate new markup template name '{$new_slug}', reverting to '{$name}'.";
1156
  $new_slug = $name;
1157
  }
1158
  elseif ( 'blank' != $name ) {
@@ -1198,7 +1244,7 @@ class MLASettings {
1198
  if ( $templates_changed ) {
1199
  $settings_changed = true;
1200
  if ( false == MLAOptions::mla_put_markup_templates( $new_templates ) )
1201
- $error_list .= "<br>Error: update of markup templates failed.";
1202
  }
1203
 
1204
  if ( $settings_changed )
@@ -1219,6 +1265,123 @@ class MLASettings {
1219
  return $page_content;
1220
  } // _save_gallery_settings
1221
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1222
  /**
1223
  * Process IPTC/EXIF standard field settings against all image attachments
1224
  * without saving the settings to the mla_option
@@ -1291,7 +1454,7 @@ class MLASettings {
1291
 
1292
  $examine_count += 1;
1293
  if ( ! empty( $updates ) ) {
1294
- $results = MLAData::mla_update_single_item( $post->ID, array( ), $updates['taxonomy_updates']['inputs'], $updates['taxonomy_updates']['actions'] );
1295
  if ( stripos( $results['message'], 'updated.' ) )
1296
  $update_count += 1;
1297
  }
13
  * @since 0.1
14
  */
15
  class MLASettings {
 
 
 
 
 
 
 
 
 
 
 
 
 
 
16
  /**
17
  * Provides a unique name for the settings page
18
  */
26
  * @return void
27
  */
28
  public static function initialize( ) {
 
 
 
29
  add_action( 'admin_menu', 'MLASettings::mla_admin_menu_action' );
30
  self::_version_upgrade();
 
31
  }
32
 
33
  /**
69
  MLAOptions::mla_update_option( MLAOptions::MLA_VERSION_OPTION, MLA::CURRENT_MLA_VERSION );
70
  }
71
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
72
  /**
73
  * Perform one-time actions on plugin activation
74
  *
79
  * @return void
80
  */
81
  public static function mla_activation_hook( ) {
82
+ // self::_create_alt_text_view(); DELETED v1.10, NO LONGER REQUIRED
83
  }
84
 
85
  /**
86
  * Perform one-time actions on plugin deactivation
87
  *
88
+ * Removes (if present) a view from the database that supports sorting the listing on 'ALT Text'.
89
  *
90
  * @since 0.40
91
  *
94
  public static function mla_deactivation_hook( ) {
95
  global $wpdb, $table_prefix;
96
 
97
+ $view_name = $table_prefix . MLA_OPTION_PREFIX . MLAData::MLA_ALT_TEXT_VIEW_SUFFIX;
98
+ $result = $wpdb->query( "SHOW TABLES LIKE '{$view_name}'" );
 
 
 
 
99
 
100
  if ( $result) {
101
+ $result = $wpdb->query( "DROP VIEW {$view_name}" );
 
 
 
 
102
  }
103
  }
104
 
373
  private static $mla_tablist = array(
374
  'general' => array( 'title' => 'General', 'render' => '_compose_general_tab' ),
375
  'mla-gallery' => array( 'title' => 'MLA Gallery', 'render' => '_compose_mla_gallery_tab' ),
376
+ 'custom-field' => array( 'title' => 'Custom Fields', 'render' => '_compose_custom_field_tab' ),
377
  'iptc-exif' => array( 'title' => 'IPTC/EXIF', 'render' => '_compose_iptc_exif_tab' ),
378
  'documentation' => array( 'title' => 'Documentation', 'render' => '_compose_documentation_tab' )
379
  );
789
  return $page_content;
790
  }
791
 
792
+ /**
793
+ * Compose the Custom Field tab content for the Settings subpage
794
+ *
795
+ * @since 1.10
796
+ * @uses $page_template_array contains tab content template(s)
797
+ *
798
+ * @return array 'message' => status/error messages, 'body' => tab content
799
+ */
800
+ private static function _compose_custom_field_tab( ) {
801
+ /*
802
+ * Check for action or submit buttons.
803
+ * Initialize page messages and content.
804
+ */
805
+ if ( isset( $_REQUEST['custom_field_mapping'] ) && is_array( $_REQUEST['custom_field_mapping'] ) ) {
806
+ check_admin_referer( MLA::MLA_ADMIN_NONCE, '_wpnonce' );
807
+
808
+ /*
809
+ * Check for page-level submit buttons to change settings or map attachments.
810
+ * Initialize page messages and content.
811
+ */
812
+ if ( !empty( $_REQUEST['custom-field-options-save'] ) ) {
813
+ $page_content = self::_save_custom_field_settings( );
814
+ }
815
+ elseif ( !empty( $_REQUEST['custom-field-options-map'] ) ) {
816
+ $page_content = self::_process_custom_field_mapping( );
817
+ }
818
+ else {
819
+ $page_content = array(
820
+ 'message' => '',
821
+ 'body' => ''
822
+ );
823
+
824
+ /*
825
+ * Check for single-rule action buttons
826
+ */
827
+ foreach( $_REQUEST['custom_field_mapping'] as $key => $value ) {
828
+ if ( isset( $value['action'] ) ) {
829
+ $settings = array( $key => $value );
830
+ foreach ( $value['action'] as $action => $label ) {
831
+ switch( $action ) {
832
+ case 'delete_field':
833
+ $delete_result = self::_delete_custom_field( $value );
834
+ case 'delete_rule':
835
+ case 'add_rule':
836
+ case 'add_field':
837
+ case 'update_rule':
838
+ $page_content = self::_save_custom_field_settings( $settings );
839
+ if ( isset( $delete_result ) )
840
+ $page_content['message'] = $delete_result . $page_content['message'];
841
+ break;
842
+ case 'map_now':
843
+ $page_content = self::_process_custom_field_mapping( $settings );
844
+ break;
845
+ case 'add_rule_map':
846
+ case 'add_field_map':
847
+ $page_content = self::_save_custom_field_settings( $settings );
848
+ $map_content = self::_process_custom_field_mapping( $settings );
849
+ $page_content['message'] .= '<br>&nbsp;<br>' . $map_content['message'];
850
+ break;
851
+ default:
852
+ // ignore everything else
853
+ } //switch action
854
+ } // foreach action
855
+ } /// isset action
856
+ } // foreach rule
857
+ } // specific rule check
858
+ } // isset custom_field_mapping
859
+ else {
860
+ $page_content = array(
861
+ 'message' => '',
862
+ 'body' => ''
863
+ );
864
+ }
865
+
866
+ if ( !empty( $page_content['body'] ) ) {
867
+ return $page_content;
868
+ }
869
+
870
+ $page_values = array(
871
+ 'options_list' => '',
872
+ 'custom_options_list' => '',
873
+ '_wpnonce' => wp_nonce_field( MLA::MLA_ADMIN_NONCE, '_wpnonce', true, false ),
874
+ '_wp_http_referer' => wp_referer_field( false )
875
+ );
876
+
877
+ /*
878
+ * Start with any page-level options
879
+ */
880
+ $options_list = '';
881
+ foreach ( MLAOptions::$mla_option_definitions as $key => $value ) {
882
+ if ( 'custom-field' == $value['tab'] )
883
+ $options_list .= self::_compose_option_row( $key, $value );
884
+ }
885
+
886
+ $page_values['options_list'] = $options_list;
887
+
888
+ /*
889
+ * Add mapping options
890
+ */
891
+ $page_values['custom_options_list'] = MLAOptions::mla_custom_field_option_handler( 'render', 'custom_field_mapping', MLAOptions::$mla_option_definitions['custom_field_mapping'] );
892
+
893
+ $page_content['body'] = MLAData::mla_parse_template( self::$page_template_array['custom-field-tab'], $page_values );
894
+ return $page_content;
895
+ }
896
+
897
  /**
898
  * Compose the IPTC/EXIF tab content for the Settings subpage
899
  *
903
  * @return array 'message' => status/error messages, 'body' => tab content
904
  */
905
  private static function _compose_iptc_exif_tab( ) {
 
906
  /*
907
  * Check for submit buttons to change or reset settings.
908
  * Initialize page messages and content.
1065
  * Get the current style contents for comparison
1066
  */
1067
  $old_templates = MLAOptions::mla_get_style_templates();
1068
+ $new_templates = array();
1069
  $new_names = $_REQUEST['mla_style_templates_name'];
1070
  $new_values = stripslashes_deep( $_REQUEST['mla_style_templates_value'] );
1071
+ $new_deletes = isset( $_REQUEST['mla_style_templates_delete'] ) ? $_REQUEST['mla_style_templates_delete']: array();
1072
 
1073
  /*
1074
  * Build new style template array, noting changes
1089
  if ( '' == $new_slug )
1090
  continue;
1091
  elseif ( 'blank' == $new_slug ) {
1092
+ $error_list .= "<br>ERROR: reserved name '{$new_slug}', new style template discarded.";
1093
  continue;
1094
  }
1095
 
1096
  if( array_key_exists( $new_slug, $old_templates ) ) {
1097
+ $error_list .= "<br>ERROR: duplicate name '{$new_slug}', new style template discarded.";
1098
  continue;
1099
  }
1100
  else {
1107
  * Handle name changes, check for duplicates
1108
  */
1109
  if ( '' == $new_slug ) {
1110
+ $error_list .= "<br>ERROR: blank style template name value, reverting to '{$name}'.";
1111
  $new_slug = $name;
1112
  }
1113
 
1114
  if ( $new_slug != $name ) {
1115
  if( array_key_exists( $new_slug, $old_templates ) ) {
1116
+ $error_list .= "<br>ERROR: duplicate new style template name '{$new_slug}', reverting to '{$name}'.";
1117
  $new_slug = $name;
1118
  }
1119
  elseif ( 'blank' != $name ) {
1133
  if ( $templates_changed ) {
1134
  $settings_changed = true;
1135
  if ( false == MLAOptions::mla_put_style_templates( $new_templates ) )
1136
+ $error_list .= "<br>ERROR: update of style templates failed.";
1137
  }
1138
 
1139
  /*
1140
  * Get the current markup contents for comparison
1141
  */
1142
  $old_templates = MLAOptions::mla_get_markup_templates();
1143
+ $new_templates = array();
1144
  $new_names = $_REQUEST['mla_markup_templates_name'];
1145
  $new_values['open'] = stripslashes_deep( $_REQUEST['mla_markup_templates_open'] );
1146
  $new_values['row-open'] = stripslashes_deep( $_REQUEST['mla_markup_templates_row_open'] );
1147
  $new_values['item'] = stripslashes_deep( $_REQUEST['mla_markup_templates_item'] );
1148
  $new_values['row-close'] = stripslashes_deep( $_REQUEST['mla_markup_templates_row_close'] );
1149
  $new_values['close'] = stripslashes_deep( $_REQUEST['mla_markup_templates_close'] );
1150
+ $new_deletes = isset( $_REQUEST['mla_markup_templates_delete'] ) ? $_REQUEST['mla_markup_templates_delete']: array();
1151
 
1152
  /*
1153
  * Build new markup template array, noting changes
1169
  continue;
1170
 
1171
  if ( 'blank' == $new_slug ) {
1172
+ $error_list .= "<br>ERROR: reserved name '{$new_slug}', new markup template discarded.";
1173
  continue;
1174
  }
1175
 
1176
  if( array_key_exists( $new_slug, $old_templates ) ) {
1177
+ $error_list .= "<br>ERROR: duplicate name '{$new_slug}', new markup template discarded.";
1178
  continue;
1179
  }
1180
  else {
1187
  * Handle name changes, check for duplicates
1188
  */
1189
  if ( '' == $new_slug ) {
1190
+ $error_list .= "<br>ERROR: blank markup template name value, reverting to '{$name}'.";
1191
  $new_slug = $name;
1192
  }
1193
 
1194
  if ( $new_slug != $name ) {
1195
  if( array_key_exists( $new_slug, $old_templates ) ) {
1196
+ $error_list .= "<br>ERROR: duplicate new markup template name '{$new_slug}', reverting to '{$name}'.";
1197
  $new_slug = $name;
1198
  }
1199
 
1200
  if( array_key_exists( $new_slug, $old_templates ) ) {
1201
+ $error_list .= "<br>ERROR: duplicate new markup template name '{$new_slug}', reverting to '{$name}'.";
1202
  $new_slug = $name;
1203
  }
1204
  elseif ( 'blank' != $name ) {
1244
  if ( $templates_changed ) {
1245
  $settings_changed = true;
1246
  if ( false == MLAOptions::mla_put_markup_templates( $new_templates ) )
1247
+ $error_list .= "<br>ERROR: update of markup templates failed.";
1248
  }
1249
 
1250
  if ( $settings_changed )
1265
  return $page_content;
1266
  } // _save_gallery_settings
1267
 
1268
+ /**
1269
+ * Process custom field settings against all image attachments
1270
+ * without saving the settings to the mla_option
1271
+ *
1272
+ * @since 1.10
1273
+ * @uses $_REQUEST if passed a NULL parameter
1274
+ *
1275
+ * @param array | NULL specific custom_field_mapping values
1276
+ *
1277
+ * @return array Message(s) reflecting the results of the operation
1278
+ */
1279
+ private static function _process_custom_field_mapping( $settings = NULL ) {
1280
+ global $wpdb;
1281
+
1282
+ if ( NULL == $settings ) {
1283
+ $settings = ( isset( $_REQUEST['custom_field_mapping'] ) ) ? $_REQUEST['custom_field_mapping'] : array();
1284
+ if ( isset( $settings[ MLAOptions::MLA_NEW_CUSTOM_FIELD ] ) )
1285
+ unset( $settings[ MLAOptions::MLA_NEW_CUSTOM_FIELD ] );
1286
+ if ( isset( $settings[ MLAOptions::MLA_NEW_CUSTOM_RULE ] ) )
1287
+ unset( $settings[ MLAOptions::MLA_NEW_CUSTOM_RULE ] );
1288
+ }
1289
+
1290
+ if ( empty( $settings ) )
1291
+ return array(
1292
+ 'message' => 'ERROR: No custom field mapping rules to process.',
1293
+ 'body' => ''
1294
+ );
1295
+
1296
+ $examine_count = 0;
1297
+ $update_count = 0;
1298
+ $post_ids = $wpdb->get_col( "SELECT ID FROM {$wpdb->posts} WHERE `post_type` = 'attachment'" );
1299
+
1300
+ foreach( $post_ids as $key => $post_id ) {
1301
+ $updates = MLAOptions::mla_evaluate_custom_field_mapping( (integer) $post_id, 'custom_field_mapping', $settings );
1302
+
1303
+ $examine_count += 1;
1304
+ if ( ! empty( $updates ) ) {
1305
+ $results = MLAData::mla_update_single_item( (integer) $post_id, $updates );
1306
+ if ( stripos( $results['message'], 'updated.' ) )
1307
+ $update_count += 1;
1308
+ }
1309
+ } // foreach post
1310
+
1311
+ if ( $update_count )
1312
+ $message = "Custom field mapping completed; {$examine_count} attachment(s) examined, {$update_count} updated.\r\n";
1313
+ else
1314
+ $message = "Custom field mapping completed; {$examine_count} attachment(s) examined, no changes detected.\r\n";
1315
+
1316
+ return array(
1317
+ 'message' => $message,
1318
+ 'body' => ''
1319
+ );
1320
+ } // _process_custom_field_mapping
1321
+
1322
+ /**
1323
+ * Delete a custom field from the wp_postmeta table
1324
+ *
1325
+ * @since 1.10
1326
+ *
1327
+ * @param array specific custom_field_mapping rule
1328
+ *
1329
+ * @return array Message(s) reflecting the results of the operation
1330
+ */
1331
+ private static function _delete_custom_field( $value ) {
1332
+ global $wpdb;
1333
+
1334
+ $post_meta_ids = $wpdb->get_col( $wpdb->prepare( "SELECT meta_id FROM {$wpdb->postmeta} LEFT JOIN {$wpdb->posts} ON ( {$wpdb->posts}.ID = {$wpdb->postmeta}.post_id ) WHERE {$wpdb->postmeta}.meta_key = '%s' AND {$wpdb->posts}.post_type = 'attachment'", $value['name'] ));
1335
+ foreach ( $post_meta_ids as $mid )
1336
+ delete_metadata_by_mid( 'post', $mid );
1337
+
1338
+ $count = count( $post_meta_ids );
1339
+ if ( $count )
1340
+ return sprintf( 'Deleted custom field value from ' . _n('%s attachment.', '%s attachments.', $count), $count);
1341
+ else
1342
+ return 'No attachments contained this custom field';
1343
+ } // _delete_custom_field
1344
+
1345
+ /**
1346
+ * Save custom field settings to the options table
1347
+ *
1348
+ * @since 1.10
1349
+ * @uses $_REQUEST if passed a NULL parameter
1350
+ *
1351
+ * @param array | NULL specific custom_field_mapping values
1352
+ *
1353
+ * @return array Message(s) reflecting the results of the operation
1354
+ */
1355
+ private static function _save_custom_field_settings( $new_values = NULL ) {
1356
+ $message_list = '';
1357
+ $option_messages = '';
1358
+
1359
+ if ( NULL == $new_values ) {
1360
+ /*
1361
+ * Start with any page-level options
1362
+ */
1363
+ foreach ( MLAOptions::$mla_option_definitions as $key => $value ) {
1364
+ if ( 'custom-field' == $value['tab'] )
1365
+ $option_messages .= self::_update_option_row( $key, $value );
1366
+ }
1367
+
1368
+ /*
1369
+ * Add mapping options
1370
+ */
1371
+ $new_values = ( isset( $_REQUEST['custom_field_mapping'] ) ) ? $_REQUEST['custom_field_mapping'] : array();
1372
+ } // NULL
1373
+
1374
+ /*
1375
+ * Uncomment this for debugging.
1376
+ */
1377
+ // $message_list = $option_messages . '<br>';
1378
+
1379
+ return array(
1380
+ 'message' => $message_list . MLAOptions::mla_custom_field_option_handler( 'update', 'custom_field_mapping', MLAOptions::$mla_option_definitions['custom_field_mapping'], $new_values ),
1381
+ 'body' => ''
1382
+ );
1383
+ } // _save_custom_field_settings
1384
+
1385
  /**
1386
  * Process IPTC/EXIF standard field settings against all image attachments
1387
  * without saving the settings to the mla_option
1454
 
1455
  $examine_count += 1;
1456
  if ( ! empty( $updates ) ) {
1457
+ $results = MLAData::mla_update_single_item( $post->ID, array(), $updates['taxonomy_updates']['inputs'], $updates['taxonomy_updates']['actions'] );
1458
  if ( stripos( $results['message'], 'updated.' ) )
1459
  $update_count += 1;
1460
  }
includes/class-mla-shortcodes.php CHANGED
@@ -177,7 +177,20 @@ class MLAShortcodes {
177
  'mla_link_text' => '',
178
  'mla_rollover_text' => '',
179
  'mla_caption' => '',
180
- 'mla_debug' => false
 
 
 
 
 
 
 
 
 
 
 
 
 
181
  );
182
 
183
  /*
@@ -200,6 +213,24 @@ class MLAShortcodes {
200
  }
201
  } // empty $attachments
202
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
203
  $size = $size_class = $arguments['size'];
204
  if ( 'icon' == strtolower( $size) ) {
205
  $size = array( 60, 60 );
@@ -302,7 +333,6 @@ class MLAShortcodes {
302
  */
303
  $new_text = str_replace( '{+', '[+', str_replace( '+}', '+]', $arguments['mla_link_text'] . $arguments['mla_rollover_text'] . $arguments['mla_caption'] ) );
304
  $placeholders = MLAData::mla_get_template_placeholders( $item_template . $new_text );
305
- // error_log( '$placeholders = ' . var_export( $placeholders, true ), 0);
306
  foreach ($placeholders as $key => $value ) {
307
  switch ( $value['prefix'] ) {
308
  case 'terms':
@@ -387,7 +417,7 @@ class MLAShortcodes {
387
  }
388
  else {
389
  $base_file = $post_meta['mla_wp_attached_file'];
390
- $sizes = array( );
391
  }
392
 
393
  if ( isset( $post_meta['mla_wp_attachment_image_alt'] ) )
@@ -664,9 +694,9 @@ class MLAShortcodes {
664
  'order' => 'ASC', // or 'DESC' or 'RAND'
665
  'orderby' => 'menu_order ID',
666
  'id' => NULL,
667
- 'ids' => array ( ),
668
- 'include' => array ( ),
669
- 'exclude' => array ( ),
670
  // MLA extensions, from WP_Query
671
  // Force 'get_children' style query
672
  'post_parent' => NULL, // post/page ID or 'current' or 'all'
@@ -676,17 +706,17 @@ class MLAShortcodes {
676
  // Category
677
  'cat' => 0,
678
  'category_name' => '',
679
- 'category__and' => array ( ),
680
- 'category__in' => array ( ),
681
- 'category__not_in' => array ( ),
682
  // Tag
683
  'tag' => '',
684
  'tag_id' => 0,
685
- 'tag__and' => array ( ),
686
- 'tag__in' => array ( ),
687
- 'tag__not_in' => array ( ),
688
- 'tag_slug__and' => array ( ),
689
- 'tag_slug__in' => array ( ),
690
  // Taxonomy parameters are handled separately
691
  // {tax_slug} => 'term' | array ( 'term, 'term, ... )
692
  // 'tax_query' => ''
@@ -734,7 +764,7 @@ class MLAShortcodes {
734
  * Extract taxonomy arguments
735
  */
736
  $taxonomies = get_taxonomies( array ( 'show_ui' => 'true' ), 'names' ); // 'objects'
737
- $query_arguments = array ( );
738
  if ( ! empty( $attr ) ) {
739
  foreach ( $attr as $key => $value ) {
740
  if ( 'tax_query' == $key ) {
177
  'mla_link_text' => '',
178
  'mla_rollover_text' => '',
179
  'mla_caption' => '',
180
+ 'mla_debug' => false,
181
+ // Photonic-specific
182
+ 'id' => NULL,
183
+ 'style' => NULL,
184
+ 'type' => 'default',
185
+ 'thumb_width' => 75,
186
+ 'thumb_height' => 75,
187
+ 'thumbnail_size' => 'thumbnail',
188
+ 'slide_size' => 'large',
189
+ 'slideshow_height' => 500,
190
+ 'fx' => 'fade',
191
+ 'timeout' => 4000,
192
+ 'speed' => 1000,
193
+ 'pause' => true
194
  );
195
 
196
  /*
213
  }
214
  } // empty $attachments
215
 
216
+ /*
217
+ * Look for Photonic-enhanced gallery
218
+ */
219
+ global $photonic;
220
+
221
+ if ( is_object( $photonic ) && ! empty( $arguments['style'] ) ) {
222
+ if ( 'default' != strtolower( $arguments['type'] ) )
223
+ return '<p><strong>Photonic-enhanced [mla_gallery]</strong> type must be <strong>default</strong>, query = ' . var_export( $attr, true ) . '</p>';
224
+
225
+ $images = array();
226
+ foreach ($attachments as $key => $val) {
227
+ $images[$val->ID] = $attachments[$key];
228
+ }
229
+
230
+ $output = $photonic->build_gallery( $images, $arguments['style'], $arguments );
231
+ return $output;
232
+ }
233
+
234
  $size = $size_class = $arguments['size'];
235
  if ( 'icon' == strtolower( $size) ) {
236
  $size = array( 60, 60 );
333
  */
334
  $new_text = str_replace( '{+', '[+', str_replace( '+}', '+]', $arguments['mla_link_text'] . $arguments['mla_rollover_text'] . $arguments['mla_caption'] ) );
335
  $placeholders = MLAData::mla_get_template_placeholders( $item_template . $new_text );
 
336
  foreach ($placeholders as $key => $value ) {
337
  switch ( $value['prefix'] ) {
338
  case 'terms':
417
  }
418
  else {
419
  $base_file = $post_meta['mla_wp_attached_file'];
420
+ $sizes = array();
421
  }
422
 
423
  if ( isset( $post_meta['mla_wp_attachment_image_alt'] ) )
694
  'order' => 'ASC', // or 'DESC' or 'RAND'
695
  'orderby' => 'menu_order ID',
696
  'id' => NULL,
697
+ 'ids' => array(),
698
+ 'include' => array(),
699
+ 'exclude' => array(),
700
  // MLA extensions, from WP_Query
701
  // Force 'get_children' style query
702
  'post_parent' => NULL, // post/page ID or 'current' or 'all'
706
  // Category
707
  'cat' => 0,
708
  'category_name' => '',
709
+ 'category__and' => array(),
710
+ 'category__in' => array(),
711
+ 'category__not_in' => array(),
712
  // Tag
713
  'tag' => '',
714
  'tag_id' => 0,
715
+ 'tag__and' => array(),
716
+ 'tag__in' => array(),
717
+ 'tag__not_in' => array(),
718
+ 'tag_slug__and' => array(),
719
+ 'tag_slug__in' => array(),
720
  // Taxonomy parameters are handled separately
721
  // {tax_slug} => 'term' | array ( 'term, 'term, ... )
722
  // 'tax_query' => ''
764
  * Extract taxonomy arguments
765
  */
766
  $taxonomies = get_taxonomies( array ( 'show_ui' => 'true' ), 'names' ); // 'objects'
767
+ $query_arguments = array();
768
  if ( ! empty( $attr ) ) {
769
  foreach ( $attr as $key => $value ) {
770
  if ( 'tax_query' == $key ) {
index.php CHANGED
@@ -6,15 +6,15 @@
6
  * will the rest of the plugin be loaded and run.
7
  *
8
  * @package Media Library Assistant
9
- * @version 1.00
10
  */
11
 
12
  /*
13
  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: 1.00
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 1.10
10
  */
11
 
12
  /*
13
  Plugin Name: Media Library Assistant
14
  Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
15
+ Description: Enhances the Media Library; powerful[mla_gallery], taxonomy support, IPTC/EXIF processing, bulk & quick edit actions and where-used reporting.
16
  Author: David Lingren
17
+ Version: 1.10
18
  Author URI: http://fairtradejudaica.org/our-story/staff/
19
  */
20
 
phpDocs/classes/MLA.html CHANGED
@@ -56,12 +56,10 @@
56
  <li class="method public "><a href="#mla_add_help_tab" title="mla_add_help_tab :: Add contextual help tabs to all the MLA pages"><span class="description">Add contextual help tabs to all the MLA pages</span><pre>mla_add_help_tab()</pre></a></li>
57
  <li class="method public "><a href="#mla_add_menu_options" title='mla_add_menu_options :: Add the "XX Entries per page" filter to the Screen Options tab'><span class="description">Add the "XX Entries per page" filter to the Screen Options tab</span><pre>mla_add_menu_options()</pre></a></li>
58
  <li class="method public "><a href="#mla_admin_enqueue_scripts_action" title="mla_admin_enqueue_scripts_action :: Load the plugin's Style Sheet and Javascript files"><span class="description">Load the plugin's Style Sheet and Javascript files</span><pre>mla_admin_enqueue_scripts_action()</pre></a></li>
59
- <li class="method public "><a href="#mla_admin_init_action" title="mla_admin_init_action :: Load the plugin's Ajax handler"><span class="description">Load the plugin's Ajax handler</span><pre>mla_admin_init_action()</pre></a></li>
60
  <li class="method public "><a href="#mla_admin_menu_action" title="mla_admin_menu_action :: Add the submenu pages"><span class="description">Add the submenu pages</span><pre>mla_admin_menu_action()</pre></a></li>
61
  <li class="method public "><a href="#mla_edit_tax_redirect" title="mla_edit_tax_redirect :: Redirect to the Edit Tags/Categories page"><span class="description">Redirect to the Edit Tags/Categories page</span><pre>mla_edit_tax_redirect()</pre></a></li>
62
  <li class="method public "><a href="#mla_inline_edit_action" title="mla_inline_edit_action :: Ajax handler for inline editing (quick and bulk edit)"><span class="description">Ajax handler for inline editing (quick and bulk edit)</span><pre>mla_inline_edit_action()</pre></a></li>
63
- <li class="method public "><a href="#mla_load_post_php_action" title="mla_load_post_php_action :: Intercept call to Edit Media screen"><span class="description">Intercept call to Edit Media screen</span><pre>mla_load_post_php_action()</pre></a></li>
64
- <li class="method public "><a href="#mla_load_upload_php_action" title="mla_load_upload_php_action :: Intercept return from Edit Media screen"><span class="description">Intercept return from Edit Media screen</span><pre>mla_load_upload_php_action()</pre></a></li>
65
  <li class="method public "><a href="#mla_parent_file_filter" title="mla_parent_file_filter :: Cleanup menus for Edit Tags/Categories page"><span class="description">Cleanup menus for Edit Tags/Categories page</span><pre>mla_parent_file_filter()</pre></a></li>
66
  <li class="method public "><a href="#mla_render_admin_page" title='mla_render_admin_page :: Render the "Assistant" subpage in the Media section, using the list_table package'><span class="description">Render the "Assistant" subpage in the Media section, using the list_table package</span><pre>mla_render_admin_page()</pre></a></li>
67
  <li class="method public "><a href="#mla_screen_options_show_screen_filter" title="mla_screen_options_show_screen_filter :: Only show screen options on the table-list screen"><span class="description">Only show screen options on the table-list screen</span><pre>mla_screen_options_show_screen_filter()</pre></a></li>
@@ -91,6 +89,7 @@ change the meta data for a single attachment.</span><pre>_display_single_item()<
91
  <li class="constant "><a href="#MIN_PHP_VERSION" title="MIN_PHP_VERSION :: Minimum version of PHP required for this plugin"><span class="description">Minimum version of PHP required for this plugin</span><pre>MIN_PHP_VERSION</pre></a></li>
92
  <li class="constant "><a href="#MIN_WORDPRESS_VERSION" title="MIN_WORDPRESS_VERSION :: Minimum version of WordPress required for this plugin"><span class="description">Minimum version of WordPress required for this plugin</span><pre>MIN_WORDPRESS_VERSION</pre></a></li>
93
  <li class="constant "><a href="#MLA_ADMIN_NONCE" title="MLA_ADMIN_NONCE :: Action name; uniquely identifies the nonce"><span class="description">Action name; uniquely identifies the nonce</span><pre>MLA_ADMIN_NONCE</pre></a></li>
 
94
  <li class="constant "><a href="#MLA_ADMIN_SINGLE_DELETE" title="MLA_ADMIN_SINGLE_DELETE :: mla_admin_action value for permanently deleting a single item"><span class="description">mla_admin_action value for permanently deleting a single item</span><pre>MLA_ADMIN_SINGLE_DELETE</pre></a></li>
95
  <li class="constant "><a href="#MLA_ADMIN_SINGLE_EDIT_DISPLAY" title="MLA_ADMIN_SINGLE_EDIT_DISPLAY :: mla_admin_action value for displaying a single item"><span class="description">mla_admin_action value for displaying a single item</span><pre>MLA_ADMIN_SINGLE_EDIT_DISPLAY</pre></a></li>
96
  <li class="constant "><a href="#MLA_ADMIN_SINGLE_EDIT_UPDATE" title="MLA_ADMIN_SINGLE_EDIT_UPDATE :: mla_admin_action value for updating a single item"><span class="description">mla_admin_action value for updating a single item</span><pre>MLA_ADMIN_SINGLE_EDIT_UPDATE</pre></a></li>
@@ -183,7 +182,7 @@ set up the Assistant submenu.</p></p>
183
  </div></div>
184
  </div>
185
  <a name="mla_admin_init_action" id="mla_admin_init_action"></a><div class="element clickable method public mla_admin_init_action" data-toggle="collapse" data-target=".mla_admin_init_action .collapse">
186
- <h2>Load the plugin's Ajax handler</h2>
187
  <pre>mla_admin_init_action() : void</pre>
188
  <div class="labels"></div>
189
  <div class="row collapse"><div class="detail-description">
@@ -238,30 +237,6 @@ The filter is not required for WordPress 3.5 and later.</p></p>
238
  </tr></table>
239
  </div></div>
240
  </div>
241
- <a name="mla_load_post_php_action" id="mla_load_post_php_action"></a><div class="element clickable method public mla_load_post_php_action" data-toggle="collapse" data-target=".mla_load_post_php_action .collapse">
242
- <h2>Intercept call to Edit Media screen</h2>
243
- <pre>mla_load_post_php_action() : void</pre>
244
- <div class="labels"></div>
245
- <div class="row collapse"><div class="detail-description">
246
- <p class="long_description"></p>
247
- <table class="table table-bordered"><tr>
248
- <th>since</th>
249
- <td>0.60</td>
250
- </tr></table>
251
- </div></div>
252
- </div>
253
- <a name="mla_load_upload_php_action" id="mla_load_upload_php_action"></a><div class="element clickable method public mla_load_upload_php_action" data-toggle="collapse" data-target=".mla_load_upload_php_action .collapse">
254
- <h2>Intercept return from Edit Media screen</h2>
255
- <pre>mla_load_upload_php_action() : void</pre>
256
- <div class="labels"></div>
257
- <div class="row collapse"><div class="detail-description">
258
- <p class="long_description"></p>
259
- <table class="table table-bordered"><tr>
260
- <th>since</th>
261
- <td>0.60</td>
262
- </tr></table>
263
- </div></div>
264
- </div>
265
  <a name="mla_parent_file_filter" id="mla_parent_file_filter"></a><div class="element clickable method public mla_parent_file_filter" data-toggle="collapse" data-target=".mla_parent_file_filter .collapse">
266
  <h2>Cleanup menus for Edit Tags/Categories page</h2>
267
  <pre>mla_parent_file_filter(array $parent_file) : string</pre>
@@ -610,6 +585,18 @@ change the meta data for a single attachment.</h2>
610
  </tr></table>
611
  </div></div>
612
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
613
  <a name="MLA_ADMIN_SINGLE_DELETE" id="MLA_ADMIN_SINGLE_DELETE"> </a><div class="element clickable constant MLA_ADMIN_SINGLE_DELETE" data-toggle="collapse" data-target=".MLA_ADMIN_SINGLE_DELETE .collapse">
614
  <h2>mla_admin_action value for permanently deleting a single item</h2>
615
  <pre>MLA_ADMIN_SINGLE_DELETE : string</pre>
@@ -713,7 +700,7 @@ change the meta data for a single attachment.</h2>
713
  <div class="row"><footer class="span12">
714
  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>
715
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
716
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
717
  </div>
718
  </body>
719
  </html>
56
  <li class="method public "><a href="#mla_add_help_tab" title="mla_add_help_tab :: Add contextual help tabs to all the MLA pages"><span class="description">Add contextual help tabs to all the MLA pages</span><pre>mla_add_help_tab()</pre></a></li>
57
  <li class="method public "><a href="#mla_add_menu_options" title='mla_add_menu_options :: Add the "XX Entries per page" filter to the Screen Options tab'><span class="description">Add the "XX Entries per page" filter to the Screen Options tab</span><pre>mla_add_menu_options()</pre></a></li>
58
  <li class="method public "><a href="#mla_admin_enqueue_scripts_action" title="mla_admin_enqueue_scripts_action :: Load the plugin's Style Sheet and Javascript files"><span class="description">Load the plugin's Style Sheet and Javascript files</span><pre>mla_admin_enqueue_scripts_action()</pre></a></li>
59
+ <li class="method public "><a href="#mla_admin_init_action" title="mla_admin_init_action :: Load the plugin's Ajax handler or process Edit Media update actions"><span class="description">Load the plugin's Ajax handler or process Edit Media update actions</span><pre>mla_admin_init_action()</pre></a></li>
60
  <li class="method public "><a href="#mla_admin_menu_action" title="mla_admin_menu_action :: Add the submenu pages"><span class="description">Add the submenu pages</span><pre>mla_admin_menu_action()</pre></a></li>
61
  <li class="method public "><a href="#mla_edit_tax_redirect" title="mla_edit_tax_redirect :: Redirect to the Edit Tags/Categories page"><span class="description">Redirect to the Edit Tags/Categories page</span><pre>mla_edit_tax_redirect()</pre></a></li>
62
  <li class="method public "><a href="#mla_inline_edit_action" title="mla_inline_edit_action :: Ajax handler for inline editing (quick and bulk edit)"><span class="description">Ajax handler for inline editing (quick and bulk edit)</span><pre>mla_inline_edit_action()</pre></a></li>
 
 
63
  <li class="method public "><a href="#mla_parent_file_filter" title="mla_parent_file_filter :: Cleanup menus for Edit Tags/Categories page"><span class="description">Cleanup menus for Edit Tags/Categories page</span><pre>mla_parent_file_filter()</pre></a></li>
64
  <li class="method public "><a href="#mla_render_admin_page" title='mla_render_admin_page :: Render the "Assistant" subpage in the Media section, using the list_table package'><span class="description">Render the "Assistant" subpage in the Media section, using the list_table package</span><pre>mla_render_admin_page()</pre></a></li>
65
  <li class="method public "><a href="#mla_screen_options_show_screen_filter" title="mla_screen_options_show_screen_filter :: Only show screen options on the table-list screen"><span class="description">Only show screen options on the table-list screen</span><pre>mla_screen_options_show_screen_filter()</pre></a></li>
89
  <li class="constant "><a href="#MIN_PHP_VERSION" title="MIN_PHP_VERSION :: Minimum version of PHP required for this plugin"><span class="description">Minimum version of PHP required for this plugin</span><pre>MIN_PHP_VERSION</pre></a></li>
90
  <li class="constant "><a href="#MIN_WORDPRESS_VERSION" title="MIN_WORDPRESS_VERSION :: Minimum version of WordPress required for this plugin"><span class="description">Minimum version of WordPress required for this plugin</span><pre>MIN_WORDPRESS_VERSION</pre></a></li>
91
  <li class="constant "><a href="#MLA_ADMIN_NONCE" title="MLA_ADMIN_NONCE :: Action name; uniquely identifies the nonce"><span class="description">Action name; uniquely identifies the nonce</span><pre>MLA_ADMIN_NONCE</pre></a></li>
92
+ <li class="constant "><a href="#MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP" title="MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP :: mla_admin_action value for mapping Custom Field metadata"><span class="description">mla_admin_action value for mapping Custom Field metadata</span><pre>MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP</pre></a></li>
93
  <li class="constant "><a href="#MLA_ADMIN_SINGLE_DELETE" title="MLA_ADMIN_SINGLE_DELETE :: mla_admin_action value for permanently deleting a single item"><span class="description">mla_admin_action value for permanently deleting a single item</span><pre>MLA_ADMIN_SINGLE_DELETE</pre></a></li>
94
  <li class="constant "><a href="#MLA_ADMIN_SINGLE_EDIT_DISPLAY" title="MLA_ADMIN_SINGLE_EDIT_DISPLAY :: mla_admin_action value for displaying a single item"><span class="description">mla_admin_action value for displaying a single item</span><pre>MLA_ADMIN_SINGLE_EDIT_DISPLAY</pre></a></li>
95
  <li class="constant "><a href="#MLA_ADMIN_SINGLE_EDIT_UPDATE" title="MLA_ADMIN_SINGLE_EDIT_UPDATE :: mla_admin_action value for updating a single item"><span class="description">mla_admin_action value for updating a single item</span><pre>MLA_ADMIN_SINGLE_EDIT_UPDATE</pre></a></li>
182
  </div></div>
183
  </div>
184
  <a name="mla_admin_init_action" id="mla_admin_init_action"></a><div class="element clickable method public mla_admin_init_action" data-toggle="collapse" data-target=".mla_admin_init_action .collapse">
185
+ <h2>Load the plugin's Ajax handler or process Edit Media update actions</h2>
186
  <pre>mla_admin_init_action() : void</pre>
187
  <div class="labels"></div>
188
  <div class="row collapse"><div class="detail-description">
237
  </tr></table>
238
  </div></div>
239
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
240
  <a name="mla_parent_file_filter" id="mla_parent_file_filter"></a><div class="element clickable method public mla_parent_file_filter" data-toggle="collapse" data-target=".mla_parent_file_filter .collapse">
241
  <h2>Cleanup menus for Edit Tags/Categories page</h2>
242
  <pre>mla_parent_file_filter(array $parent_file) : string</pre>
585
  </tr></table>
586
  </div></div>
587
  </div>
588
+ <a name="MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP" id="MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP"> </a><div class="element clickable constant MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP" data-toggle="collapse" data-target=".MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP .collapse">
589
+ <h2>mla_admin_action value for mapping Custom Field metadata</h2>
590
+ <pre>MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP : string</pre>
591
+ <div class="labels"></div>
592
+ <div class="row collapse"><div class="detail-description">
593
+ <p class="long_description"></p>
594
+ <table class="table table-bordered"><tr>
595
+ <th>since</th>
596
+ <td>1.10</td>
597
+ </tr></table>
598
+ </div></div>
599
+ </div>
600
  <a name="MLA_ADMIN_SINGLE_DELETE" id="MLA_ADMIN_SINGLE_DELETE"> </a><div class="element clickable constant MLA_ADMIN_SINGLE_DELETE" data-toggle="collapse" data-target=".MLA_ADMIN_SINGLE_DELETE .collapse">
601
  <h2>mla_admin_action value for permanently deleting a single item</h2>
602
  <pre>MLA_ADMIN_SINGLE_DELETE : string</pre>
700
  <div class="row"><footer class="span12">
701
  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>
702
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
703
+ generated on 2013-01-14T20:41:50-08:00.<br></footer></div>
704
  </div>
705
  </body>
706
  </html>
phpDocs/classes/MLAData.html CHANGED
@@ -64,7 +64,7 @@
64
  <li class="method public "><a href="#mla_load_template" title="mla_load_template :: Load an HTML template from a file"><span class="description">Load an HTML template from a file</span><pre>mla_load_template()</pre></a></li>
65
  <li class="method public "><a href="#mla_parse_template" title="mla_parse_template :: Expand a template, replacing place holders with their values"><span class="description">Expand a template, replacing place holders with their values</span><pre>mla_parse_template()</pre></a></li>
66
  <li class="method public "><a href="#mla_query_list_table_items" title="mla_query_list_table_items :: Retrieve attachment objects for list table display"><span class="description">Retrieve attachment objects for list table display</span><pre>mla_query_list_table_items()</pre></a></li>
67
- <li class="method public "><a href="#mla_query_posts_join_filter" title="mla_query_posts_join_filter :: Adds a JOIN clause, if required"><span class="description">Adds a JOIN clause, if required</span><pre>mla_query_posts_join_filter()</pre></a></li>
68
  <li class="method public "><a href="#mla_query_posts_orderby_filter" title="mla_query_posts_orderby_filter :: Adds a ORDERBY clause, if required"><span class="description">Adds a ORDERBY clause, if required</span><pre>mla_query_posts_orderby_filter()</pre></a></li>
69
  <li class="method public "><a href="#mla_query_posts_search_filter" title="mla_query_posts_search_filter :: Adds a keyword search to the WHERE clause, if required"><span class="description">Adds a keyword search to the WHERE clause, if required</span><pre>mla_query_posts_search_filter()</pre></a></li>
70
  <li class="method public "><a href="#mla_query_posts_where_filter" title="mla_query_posts_where_filter :: Adds a WHERE clause for detached items"><span class="description">Adds a WHERE clause for detached items</span><pre>mla_query_posts_where_filter()</pre></a></li>
@@ -83,8 +83,12 @@ for a single attachment.</span><pre>mla_update_single_item()</pre></a></li>
83
  <i class="icon-custom icon-property"></i> Properties</li>
84
  <li class="nav-header private">» Private</li>
85
  <li class="property private "><a href="#%24galleries" title="$galleries :: Objects containing [gallery] shortcodes"><span class="description">Objects containing [gallery] shortcodes</span><pre>$galleries</pre></a></li>
 
86
  <li class="property private "><a href="#%24mla_galleries" title="$mla_galleries :: Objects containing [mla_gallery] shortcodes"><span class="description">Objects containing [mla_gallery] shortcodes</span><pre>$mla_galleries</pre></a></li>
87
  <li class="property private "><a href="#%24query_parameters" title='$query_parameters :: WP_Query filter "parameters"'><span class="description">WP_Query filter "parameters"</span><pre>$query_parameters</pre></a></li>
 
 
 
88
  </ul>
89
  </div>
90
  <div class="span8">
@@ -258,10 +262,16 @@ as a Featured Image or inserted in the post as an image or link.</p></p>
258
  <div class="row collapse"><div class="detail-description">
259
  <p class="long_description"><p>The (associative) array will contain every field that can be found in
260
  the posts and postmeta tables, and all references to the attachment.</p></p>
261
- <table class="table table-bordered"><tr>
 
262
  <th>since</th>
263
  <td>0.1</td>
264
- </tr></table>
 
 
 
 
 
265
  <h3>Parameters</h3>
266
  <div class="subelement argument">
267
  <h4>$post_id</h4>
@@ -368,7 +378,7 @@ Modeled after wp_edit_attachments_query in wp-admin/post.php</p></p>
368
  </div></div>
369
  </div>
370
  <a name="mla_query_posts_join_filter" id="mla_query_posts_join_filter"></a><div class="element clickable method public mla_query_posts_join_filter" data-toggle="collapse" data-target=".mla_query_posts_join_filter .collapse">
371
- <h2>Adds a JOIN clause, if required</h2>
372
  <pre>mla_query_posts_join_filter(string $join_clause) : string</pre>
373
  <div class="labels"></div>
374
  <div class="row collapse"><div class="detail-description">
@@ -383,7 +393,7 @@ Modeled after wp_edit_attachments_query in wp-admin/post.php</p></p>
383
  <code>string</code><p>query clause before modification</p></div>
384
  <h3>Returns</h3>
385
  <div class="subelement response">
386
- <code>string</code>query clause after "detached" item modification</div>
387
  </div></div>
388
  </div>
389
  <a name="mla_query_posts_orderby_filter" id="mla_query_posts_orderby_filter"></a><div class="element clickable method public mla_query_posts_orderby_filter" data-toggle="collapse" data-target=".mla_query_posts_orderby_filter .collapse">
@@ -671,6 +681,18 @@ Each inner array has these elements:
671
  </tr></table>
672
  </div></div>
673
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
674
  <a name="%24mla_galleries" id="$mla_galleries"> </a><div class="element clickable property private $mla_galleries" data-toggle="collapse" data-target=".$mla_galleries .collapse">
675
  <h2>Objects containing [mla_gallery] shortcodes</h2>
676
  <pre>$mla_galleries : array</pre>
@@ -699,6 +721,20 @@ any further logic required to translate those values is contained in the filters
699
  </tr></table>
700
  </div></div>
701
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
702
  </div>
703
  </div>
704
  </div>
@@ -706,7 +742,7 @@ any further logic required to translate those values is contained in the filters
706
  <div class="row"><footer class="span12">
707
  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>
708
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
709
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
710
  </div>
711
  </body>
712
  </html>
64
  <li class="method public "><a href="#mla_load_template" title="mla_load_template :: Load an HTML template from a file"><span class="description">Load an HTML template from a file</span><pre>mla_load_template()</pre></a></li>
65
  <li class="method public "><a href="#mla_parse_template" title="mla_parse_template :: Expand a template, replacing place holders with their values"><span class="description">Expand a template, replacing place holders with their values</span><pre>mla_parse_template()</pre></a></li>
66
  <li class="method public "><a href="#mla_query_list_table_items" title="mla_query_list_table_items :: Retrieve attachment objects for list table display"><span class="description">Retrieve attachment objects for list table display</span><pre>mla_query_list_table_items()</pre></a></li>
67
+ <li class="method public "><a href="#mla_query_posts_join_filter" title="mla_query_posts_join_filter :: Adds a JOIN clause, if required, to handle sorting/searching on ALT Text"><span class="description">Adds a JOIN clause, if required, to handle sorting/searching on ALT Text</span><pre>mla_query_posts_join_filter()</pre></a></li>
68
  <li class="method public "><a href="#mla_query_posts_orderby_filter" title="mla_query_posts_orderby_filter :: Adds a ORDERBY clause, if required"><span class="description">Adds a ORDERBY clause, if required</span><pre>mla_query_posts_orderby_filter()</pre></a></li>
69
  <li class="method public "><a href="#mla_query_posts_search_filter" title="mla_query_posts_search_filter :: Adds a keyword search to the WHERE clause, if required"><span class="description">Adds a keyword search to the WHERE clause, if required</span><pre>mla_query_posts_search_filter()</pre></a></li>
70
  <li class="method public "><a href="#mla_query_posts_where_filter" title="mla_query_posts_where_filter :: Adds a WHERE clause for detached items"><span class="description">Adds a WHERE clause for detached items</span><pre>mla_query_posts_where_filter()</pre></a></li>
83
  <i class="icon-custom icon-property"></i> Properties</li>
84
  <li class="nav-header private">» Private</li>
85
  <li class="property private "><a href="#%24galleries" title="$galleries :: Objects containing [gallery] shortcodes"><span class="description">Objects containing [gallery] shortcodes</span><pre>$galleries</pre></a></li>
86
+ <li class="property private "><a href="#%24mla_alt_text_view" title="$mla_alt_text_view :: Provides a unique name for the ALT Text SQL VIEW"><span class="description">Provides a unique name for the ALT Text SQL VIEW</span><pre>$mla_alt_text_view</pre></a></li>
87
  <li class="property private "><a href="#%24mla_galleries" title="$mla_galleries :: Objects containing [mla_gallery] shortcodes"><span class="description">Objects containing [mla_gallery] shortcodes</span><pre>$mla_galleries</pre></a></li>
88
  <li class="property private "><a href="#%24query_parameters" title='$query_parameters :: WP_Query filter "parameters"'><span class="description">WP_Query filter "parameters"</span><pre>$query_parameters</pre></a></li>
89
+ <li class="nav-header">
90
+ <i class="icon-custom icon-constant"></i> Constants</li>
91
+ <li class="constant "><a href="#MLA_ALT_TEXT_VIEW_SUFFIX" title="MLA_ALT_TEXT_VIEW_SUFFIX :: Provides a unique suffix for the ALT Text SQL VIEW"><span class="description">Provides a unique suffix for the ALT Text SQL VIEW</span><pre>MLA_ALT_TEXT_VIEW_SUFFIX</pre></a></li>
92
  </ul>
93
  </div>
94
  <div class="span8">
262
  <div class="row collapse"><div class="detail-description">
263
  <p class="long_description"><p>The (associative) array will contain every field that can be found in
264
  the posts and postmeta tables, and all references to the attachment.</p></p>
265
+ <table class="table table-bordered">
266
+ <tr>
267
  <th>since</th>
268
  <td>0.1</td>
269
+ </tr>
270
+ <tr>
271
+ <th>uses</th>
272
+ <td>\global\$post</td>
273
+ </tr>
274
+ </table>
275
  <h3>Parameters</h3>
276
  <div class="subelement argument">
277
  <h4>$post_id</h4>
378
  </div></div>
379
  </div>
380
  <a name="mla_query_posts_join_filter" id="mla_query_posts_join_filter"></a><div class="element clickable method public mla_query_posts_join_filter" data-toggle="collapse" data-target=".mla_query_posts_join_filter .collapse">
381
+ <h2>Adds a JOIN clause, if required, to handle sorting/searching on ALT Text</h2>
382
  <pre>mla_query_posts_join_filter(string $join_clause) : string</pre>
383
  <div class="labels"></div>
384
  <div class="row collapse"><div class="detail-description">
393
  <code>string</code><p>query clause before modification</p></div>
394
  <h3>Returns</h3>
395
  <div class="subelement response">
396
+ <code>string</code>query clause after "LEFT JOIN view ON post_id" item modification</div>
397
  </div></div>
398
  </div>
399
  <a name="mla_query_posts_orderby_filter" id="mla_query_posts_orderby_filter"></a><div class="element clickable method public mla_query_posts_orderby_filter" data-toggle="collapse" data-target=".mla_query_posts_orderby_filter .collapse">
681
  </tr></table>
682
  </div></div>
683
  </div>
684
+ <a name="%24mla_alt_text_view" id="$mla_alt_text_view"> </a><div class="element clickable property private $mla_alt_text_view" data-toggle="collapse" data-target=".$mla_alt_text_view .collapse">
685
+ <h2>Provides a unique name for the ALT Text SQL VIEW</h2>
686
+ <pre>$mla_alt_text_view : array</pre>
687
+ <div class="labels"></div>
688
+ <div class="row collapse"><div class="detail-description">
689
+ <p class="long_description"></p>
690
+ <table class="table table-bordered"><tr>
691
+ <th>since</th>
692
+ <td>0.40</td>
693
+ </tr></table>
694
+ </div></div>
695
+ </div>
696
  <a name="%24mla_galleries" id="$mla_galleries"> </a><div class="element clickable property private $mla_galleries" data-toggle="collapse" data-target=".$mla_galleries .collapse">
697
  <h2>Objects containing [mla_gallery] shortcodes</h2>
698
  <pre>$mla_galleries : array</pre>
721
  </tr></table>
722
  </div></div>
723
  </div>
724
+ <h3>
725
+ <i class="icon-custom icon-constant"></i> Constants</h3>
726
+ <a name="MLA_ALT_TEXT_VIEW_SUFFIX" id="MLA_ALT_TEXT_VIEW_SUFFIX"> </a><div class="element clickable constant MLA_ALT_TEXT_VIEW_SUFFIX" data-toggle="collapse" data-target=".MLA_ALT_TEXT_VIEW_SUFFIX .collapse">
727
+ <h2>Provides a unique suffix for the ALT Text SQL VIEW</h2>
728
+ <pre>MLA_ALT_TEXT_VIEW_SUFFIX </pre>
729
+ <div class="labels"></div>
730
+ <div class="row collapse"><div class="detail-description">
731
+ <p class="long_description"></p>
732
+ <table class="table table-bordered"><tr>
733
+ <th>since</th>
734
+ <td>0.40</td>
735
+ </tr></table>
736
+ </div></div>
737
+ </div>
738
  </div>
739
  </div>
740
  </div>
742
  <div class="row"><footer class="span12">
743
  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>
744
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
745
+ generated on 2013-01-14T20:41:50-08:00.<br></footer></div>
746
  </div>
747
  </body>
748
  </html>
phpDocs/classes/MLAEdit.html CHANGED
@@ -54,6 +54,7 @@
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_add_meta_boxes_action" title="mla_add_meta_boxes_action :: Registers meta boxes for the Edit Media screen."><span class="description">Registers meta boxes for the Edit Media screen.</span><pre>mla_add_meta_boxes_action()</pre></a></li>
 
57
  <li class="method public "><a href="#mla_custom_field_support_action" title="mla_custom_field_support_action :: Adds Custom Field support to the Edit Media screen."><span class="description">Adds Custom Field support to the Edit Media screen.</span><pre>mla_custom_field_support_action()</pre></a></li>
58
  <li class="method public "><a href="#mla_edit_add_help_tab" title="mla_edit_add_help_tab :: Add contextual help tabs to the WordPress Edit Media page"><span class="description">Add contextual help tabs to the WordPress Edit Media page</span><pre>mla_edit_add_help_tab()</pre></a></li>
59
  <li class="method public "><a href="#mla_edit_attachment_action" title="mla_edit_attachment_action :: Saves updates from the Edit Media screen."><span class="description">Saves updates from the Edit Media screen.</span><pre>mla_edit_attachment_action()</pre></a></li>
@@ -61,10 +62,10 @@
61
  <li class="method public "><a href="#mla_gallery_in_handler" title="mla_gallery_in_handler :: Renders the Gallery in meta box on the Edit Media page."><span class="description">Renders the Gallery in meta box on the Edit Media page.</span><pre>mla_gallery_in_handler()</pre></a></li>
62
  <li class="method public "><a href="#mla_image_metadata_handler" title="mla_image_metadata_handler :: Renders the Image Metadata meta box on the Edit Media page."><span class="description">Renders the Image Metadata meta box on the Edit Media page.</span><pre>mla_image_metadata_handler()</pre></a></li>
63
  <li class="method public "><a href="#mla_inserted_in_handler" title="mla_inserted_in_handler :: Renders the Inserted in meta box on the Edit Media page."><span class="description">Renders the Inserted in meta box on the Edit Media page.</span><pre>mla_inserted_in_handler()</pre></a></li>
64
- <li class="method public "><a href="#mla_last_modified_action" title="mla_last_modified_action :: Adds Last Modified date to the Submit box on the Edit Media screen."><span class="description">Adds Last Modified date to the Submit box on the Edit Media screen.</span><pre>mla_last_modified_action()</pre></a></li>
65
  <li class="method public "><a href="#mla_menu_order_handler" title="mla_menu_order_handler :: Renders the Menu Order meta box on the Edit Media page."><span class="description">Renders the Menu Order meta box on the Edit Media page.</span><pre>mla_menu_order_handler()</pre></a></li>
66
  <li class="method public "><a href="#mla_mla_gallery_in_handler" title="mla_mla_gallery_in_handler :: Renders the Gallery in meta box on the Edit Media page."><span class="description">Renders the Gallery in meta box on the Edit Media page.</span><pre>mla_mla_gallery_in_handler()</pre></a></li>
67
  <li class="method public "><a href="#mla_parent_info_handler" title="mla_parent_info_handler :: Renders the Parent Info meta box on the Edit Media page."><span class="description">Renders the Parent Info meta box on the Edit Media page.</span><pre>mla_parent_info_handler()</pre></a></li>
 
68
  <li class="nav-header">
69
  <i class="icon-custom icon-property"></i> Properties</li>
70
  <li class="nav-header private">» Private</li>
@@ -129,6 +130,18 @@
129
  <code>object</code><p>current post</p></div>
130
  </div></div>
131
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
132
  <a name="mla_custom_field_support_action" id="mla_custom_field_support_action"></a><div class="element clickable method public mla_custom_field_support_action" data-toggle="collapse" data-target=".mla_custom_field_support_action .collapse">
133
  <h2>Adds Custom Field support to the Edit Media screen.</h2>
134
  <pre>mla_custom_field_support_action() : void</pre>
@@ -240,18 +253,6 @@
240
  <code>object</code><p>current post</p></div>
241
  </div></div>
242
  </div>
243
- <a name="mla_last_modified_action" id="mla_last_modified_action"></a><div class="element clickable method public mla_last_modified_action" data-toggle="collapse" data-target=".mla_last_modified_action .collapse">
244
- <h2>Adds Last Modified date to the Submit box on the Edit Media screen.</h2>
245
- <pre>mla_last_modified_action() : void</pre>
246
- <div class="labels"></div>
247
- <div class="row collapse"><div class="detail-description">
248
- <p class="long_description"><p>Declared public because it is an action.</p></p>
249
- <table class="table table-bordered"><tr>
250
- <th>since</th>
251
- <td>0.80</td>
252
- </tr></table>
253
- </div></div>
254
- </div>
255
  <a name="mla_menu_order_handler" id="mla_menu_order_handler"></a><div class="element clickable method public mla_menu_order_handler" data-toggle="collapse" data-target=".mla_menu_order_handler .collapse">
256
  <h2>Renders the Menu Order meta box on the Edit Media page.</h2>
257
  <pre>mla_menu_order_handler(object $post) : void</pre>
@@ -300,6 +301,25 @@
300
  <code>object</code><p>current post</p></div>
301
  </div></div>
302
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
303
  <h3>
304
  <i class="icon-custom icon-property"></i> Properties</h3>
305
  <a name="%24mla_references" id="$mla_references"> </a><div class="element clickable property private $mla_references" data-toggle="collapse" data-target=".$mla_references .collapse">
@@ -322,7 +342,7 @@ The array is built once each page load and cached for subsequent calls.</p></p>
322
  <div class="row"><footer class="span12">
323
  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>
324
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
325
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
326
  </div>
327
  </body>
328
  </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_add_meta_boxes_action" title="mla_add_meta_boxes_action :: Registers meta boxes for the Edit Media screen."><span class="description">Registers meta boxes for the Edit Media screen.</span><pre>mla_add_meta_boxes_action()</pre></a></li>
57
+ <li class="method public "><a href="#mla_attachment_submitbox_action" title="mla_attachment_submitbox_action :: Adds Last Modified date to the Submit box on the Edit Media screen."><span class="description">Adds Last Modified date to the Submit box on the Edit Media screen.</span><pre>mla_attachment_submitbox_action()</pre></a></li>
58
  <li class="method public "><a href="#mla_custom_field_support_action" title="mla_custom_field_support_action :: Adds Custom Field support to the Edit Media screen."><span class="description">Adds Custom Field support to the Edit Media screen.</span><pre>mla_custom_field_support_action()</pre></a></li>
59
  <li class="method public "><a href="#mla_edit_add_help_tab" title="mla_edit_add_help_tab :: Add contextual help tabs to the WordPress Edit Media page"><span class="description">Add contextual help tabs to the WordPress Edit Media page</span><pre>mla_edit_add_help_tab()</pre></a></li>
60
  <li class="method public "><a href="#mla_edit_attachment_action" title="mla_edit_attachment_action :: Saves updates from the Edit Media screen."><span class="description">Saves updates from the Edit Media screen.</span><pre>mla_edit_attachment_action()</pre></a></li>
62
  <li class="method public "><a href="#mla_gallery_in_handler" title="mla_gallery_in_handler :: Renders the Gallery in meta box on the Edit Media page."><span class="description">Renders the Gallery in meta box on the Edit Media page.</span><pre>mla_gallery_in_handler()</pre></a></li>
63
  <li class="method public "><a href="#mla_image_metadata_handler" title="mla_image_metadata_handler :: Renders the Image Metadata meta box on the Edit Media page."><span class="description">Renders the Image Metadata meta box on the Edit Media page.</span><pre>mla_image_metadata_handler()</pre></a></li>
64
  <li class="method public "><a href="#mla_inserted_in_handler" title="mla_inserted_in_handler :: Renders the Inserted in meta box on the Edit Media page."><span class="description">Renders the Inserted in meta box on the Edit Media page.</span><pre>mla_inserted_in_handler()</pre></a></li>
 
65
  <li class="method public "><a href="#mla_menu_order_handler" title="mla_menu_order_handler :: Renders the Menu Order meta box on the Edit Media page."><span class="description">Renders the Menu Order meta box on the Edit Media page.</span><pre>mla_menu_order_handler()</pre></a></li>
66
  <li class="method public "><a href="#mla_mla_gallery_in_handler" title="mla_mla_gallery_in_handler :: Renders the Gallery in meta box on the Edit Media page."><span class="description">Renders the Gallery in meta box on the Edit Media page.</span><pre>mla_mla_gallery_in_handler()</pre></a></li>
67
  <li class="method public "><a href="#mla_parent_info_handler" title="mla_parent_info_handler :: Renders the Parent Info meta box on the Edit Media page."><span class="description">Renders the Parent Info meta box on the Edit Media page.</span><pre>mla_parent_info_handler()</pre></a></li>
68
+ <li class="method public "><a href="#mla_post_updated_messages_filter" title="mla_post_updated_messages_filter :: Adds mapping update messages for display at the top of the Edit Media screen."><span class="description">Adds mapping update messages for display at the top of the Edit Media screen.</span><pre>mla_post_updated_messages_filter()</pre></a></li>
69
  <li class="nav-header">
70
  <i class="icon-custom icon-property"></i> Properties</li>
71
  <li class="nav-header private">» Private</li>
130
  <code>object</code><p>current post</p></div>
131
  </div></div>
132
  </div>
133
+ <a name="mla_attachment_submitbox_action" id="mla_attachment_submitbox_action"></a><div class="element clickable method public mla_attachment_submitbox_action" data-toggle="collapse" data-target=".mla_attachment_submitbox_action .collapse">
134
+ <h2>Adds Last Modified date to the Submit box on the Edit Media screen.</h2>
135
+ <pre>mla_attachment_submitbox_action() : void</pre>
136
+ <div class="labels"></div>
137
+ <div class="row collapse"><div class="detail-description">
138
+ <p class="long_description"><p>Declared public because it is an action.</p></p>
139
+ <table class="table table-bordered"><tr>
140
+ <th>since</th>
141
+ <td>0.80</td>
142
+ </tr></table>
143
+ </div></div>
144
+ </div>
145
  <a name="mla_custom_field_support_action" id="mla_custom_field_support_action"></a><div class="element clickable method public mla_custom_field_support_action" data-toggle="collapse" data-target=".mla_custom_field_support_action .collapse">
146
  <h2>Adds Custom Field support to the Edit Media screen.</h2>
147
  <pre>mla_custom_field_support_action() : void</pre>
253
  <code>object</code><p>current post</p></div>
254
  </div></div>
255
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
256
  <a name="mla_menu_order_handler" id="mla_menu_order_handler"></a><div class="element clickable method public mla_menu_order_handler" data-toggle="collapse" data-target=".mla_menu_order_handler .collapse">
257
  <h2>Renders the Menu Order meta box on the Edit Media page.</h2>
258
  <pre>mla_menu_order_handler(object $post) : void</pre>
301
  <code>object</code><p>current post</p></div>
302
  </div></div>
303
  </div>
304
+ <a name="mla_post_updated_messages_filter" id="mla_post_updated_messages_filter"></a><div class="element clickable method public mla_post_updated_messages_filter" data-toggle="collapse" data-target=".mla_post_updated_messages_filter .collapse">
305
+ <h2>Adds mapping update messages for display at the top of the Edit Media screen.</h2>
306
+ <pre>mla_post_updated_messages_filter(array $messages) : array</pre>
307
+ <div class="labels"></div>
308
+ <div class="row collapse"><div class="detail-description">
309
+ <p class="long_description"><p>Declared public because it is a filter.</p></p>
310
+ <table class="table table-bordered"><tr>
311
+ <th>since</th>
312
+ <td>1.10</td>
313
+ </tr></table>
314
+ <h3>Parameters</h3>
315
+ <div class="subelement argument">
316
+ <h4>$messages</h4>
317
+ <code>array</code><p>messages for the Edit screen</p></div>
318
+ <h3>Returns</h3>
319
+ <div class="subelement response">
320
+ <code>array</code>updated messages</div>
321
+ </div></div>
322
+ </div>
323
  <h3>
324
  <i class="icon-custom icon-property"></i> Properties</h3>
325
  <a name="%24mla_references" id="$mla_references"> </a><div class="element clickable property private $mla_references" data-toggle="collapse" data-target=".$mla_references .collapse">
342
  <div class="row"><footer class="span12">
343
  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>
344
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
345
+ generated on 2013-01-14T20:41:50-08:00.<br></footer></div>
346
  </div>
347
  </body>
348
  </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-12-29T12:42:47-08: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 2013-01-14T20:41:50-08:00.<br></footer></div>
171
  </div>
172
  </body>
173
  </html>
phpDocs/classes/MLAOptions.html CHANGED
@@ -54,7 +54,11 @@
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_add_attachment_action" title="mla_add_attachment_action :: Perform ITC/EXIF mapping on just-inserted attachment"><span class="description">Perform ITC/EXIF mapping on just-inserted attachment</span><pre>mla_add_attachment_action()</pre></a></li>
 
 
 
57
  <li class="method public "><a href="#mla_delete_option" title="mla_delete_option :: Delete the stored value of a defined MLA option"><span class="description">Delete the stored value of a defined MLA option</span><pre>mla_delete_option()</pre></a></li>
 
58
  <li class="method public "><a href="#mla_evaluate_iptc_exif_mapping" title="mla_evaluate_iptc_exif_mapping :: Evaluate IPTC/EXIF mapping updates for a post"><span class="description">Evaluate IPTC/EXIF mapping updates for a post</span><pre>mla_evaluate_iptc_exif_mapping()</pre></a></li>
59
  <li class="method public "><a href="#mla_fetch_gallery_template" title="mla_fetch_gallery_template :: Fetch style or markup template from $mla_templates"><span class="description">Fetch style or markup template from $mla_templates</span><pre>mla_fetch_gallery_template()</pre></a></li>
60
  <li class="method public "><a href="#mla_get_markup_templates" title="mla_get_markup_templates :: Get ALL markup templates from $mla_templates, including 'default'"><span class="description">Get ALL markup templates from $mla_templates, including 'default'</span><pre>mla_get_markup_templates()</pre></a></li>
@@ -67,12 +71,18 @@
67
  <li class="method public "><a href="#mla_taxonomy_support" title="mla_taxonomy_support :: Determine MLA support for a taxonomy, handling the special case where the
68
  settings are being updated or reset."><span class="description">Determine MLA support for a taxonomy, handling the special case where the
69
  settings are being updated or reset.</span><pre>mla_taxonomy_support()</pre></a></li>
 
70
  <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>
71
  <li class="nav-header private">» Private</li>
 
 
72
  <li class="method private "><a href="#_compose_iptc_option_list" title="_compose_iptc_option_list :: Compose an IPTC Options list with current selection"><span class="description">Compose an IPTC Options list with current selection</span><pre>_compose_iptc_option_list()</pre></a></li>
73
  <li class="method private "><a href="#_compose_parent_option_list" title="_compose_parent_option_list :: Compose an hierarchical taxonomy Parent options list with current selection"><span class="description">Compose an hierarchical taxonomy Parent options list with current selection</span><pre>_compose_parent_option_list()</pre></a></li>
 
 
74
  <li class="method private "><a href="#_get_custom_field_names" title="_get_custom_field_names :: Generate a list of all (post) Custom Field names"><span class="description">Generate a list of all (post) Custom Field names</span><pre>_get_custom_field_names()</pre></a></li>
75
  <li class="method private "><a href="#_load_option_templates" title="_load_option_templates :: Load style and markup templates to $mla_templates"><span class="description">Load style and markup templates to $mla_templates</span><pre>_load_option_templates()</pre></a></li>
 
76
  <li class="method private "><a href="#_update_iptc_exif_custom_mapping" title="_update_iptc_exif_custom_mapping :: Update Custom field portion of IPTC/EXIF mappings"><span class="description">Update Custom field portion of IPTC/EXIF mappings</span><pre>_update_iptc_exif_custom_mapping()</pre></a></li>
77
  <li class="method private "><a href="#_update_iptc_exif_standard_mapping" title="_update_iptc_exif_standard_mapping :: Update Standard field portion of IPTC/EXIF mappings"><span class="description">Update Standard field portion of IPTC/EXIF mappings</span><pre>_update_iptc_exif_standard_mapping()</pre></a></li>
78
  <li class="method private "><a href="#_update_iptc_exif_taxonomy_mapping" title="_update_iptc_exif_taxonomy_mapping :: Update Taxonomy term portion of IPTC/EXIF mappings"><span class="description">Update Taxonomy term portion of IPTC/EXIF mappings</span><pre>_update_iptc_exif_taxonomy_mapping()</pre></a></li>
@@ -84,6 +94,7 @@ settings are being updated or reset.</span><pre>mla_taxonomy_support()</pre></a>
84
  <li class="property public "><a href="#%24process_inserted_in" title='$process_inserted_in :: Option setting for "Inserted in" reporting'><span class="description">Option setting for "Inserted in" reporting</span><pre>$process_inserted_in</pre></a></li>
85
  <li class="property public "><a href="#%24process_mla_gallery_in" title='$process_mla_gallery_in :: Option setting for "MLA Gallery in" reporting'><span class="description">Option setting for "MLA Gallery in" reporting</span><pre>$process_mla_gallery_in</pre></a></li>
86
  <li class="nav-header private">» Private</li>
 
87
  <li class="property private "><a href="#%24mla_option_templates" title="$mla_option_templates :: Style and Markup templates"><span class="description">Style and Markup templates</span><pre>$mla_option_templates</pre></a></li>
88
  <li class="nav-header">
89
  <i class="icon-custom icon-constant"></i> Constants</li>
@@ -92,6 +103,7 @@ settings are being updated or reset.</span><pre>mla_taxonomy_support()</pre></a>
92
  <li class="constant "><a href="#MLA_INSERTED_IN_TUNING" title="MLA_INSERTED_IN_TUNING :: Provides a unique name for a database tuning option"><span class="description">Provides a unique name for a database tuning option</span><pre>MLA_INSERTED_IN_TUNING</pre></a></li>
93
  <li class="constant "><a href="#MLA_MLA_GALLERY_IN_TUNING" title="MLA_MLA_GALLERY_IN_TUNING :: Provides a unique name for a database tuning option"><span class="description">Provides a unique name for a database tuning option</span><pre>MLA_MLA_GALLERY_IN_TUNING</pre></a></li>
94
  <li class="constant "><a href="#MLA_NEW_CUSTOM_FIELD" title='MLA_NEW_CUSTOM_FIELD :: Provides a unique name for the Custom Field "new field" key'><span class="description">Provides a unique name for the Custom Field "new field" key</span><pre>MLA_NEW_CUSTOM_FIELD</pre></a></li>
 
95
  <li class="constant "><a href="#MLA_VERSION_OPTION" title="MLA_VERSION_OPTION :: Provides a unique name for the current version option"><span class="description">Provides a unique name for the current version option</span><pre>MLA_VERSION_OPTION</pre></a></li>
96
  </ul>
97
  </div>
@@ -151,6 +163,83 @@ and provides functions to get and put them from/to WordPress option variables</p
151
  </div>
152
  </div></div>
153
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
154
  <a name="mla_delete_option" id="mla_delete_option"></a><div class="element clickable method public mla_delete_option" data-toggle="collapse" data-target=".mla_delete_option .collapse">
155
  <h2>Delete the stored value of a defined MLA option</h2>
156
  <pre>mla_delete_option(string $option) : boolean</pre>
@@ -170,6 +259,37 @@ and provides functions to get and put them from/to WordPress option variables</p
170
  <code>boolean</code>True if the option was deleted, otherwise false</div>
171
  </div></div>
172
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
173
  <a name="mla_evaluate_iptc_exif_mapping" id="mla_evaluate_iptc_exif_mapping"></a><div class="element clickable method public mla_evaluate_iptc_exif_mapping" data-toggle="collapse" data-target=".mla_evaluate_iptc_exif_mapping .collapse">
174
  <h2>Evaluate IPTC/EXIF mapping updates for a post</h2>
175
  <pre>mla_evaluate_iptc_exif_mapping(object $post, string $category, array $settings) : array</pre>
@@ -406,6 +526,27 @@ settings are being updated or reset.</h2>
406
  <code>boolean</code><code>string</code>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</div>
407
  </div></div>
408
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
409
  <a name="mla_update_option" id="mla_update_option"></a><div class="element clickable method public mla_update_option" data-toggle="collapse" data-target=".mla_update_option .collapse">
410
  <h2>Add or update the stored value of a defined MLA option</h2>
411
  <pre>mla_update_option(string $option, mixed $newvalue) : boolean</pre>
@@ -428,6 +569,58 @@ settings are being updated or reset.</h2>
428
  <code>boolean</code>True if the value was changed or false if the update failed</div>
429
  </div></div>
430
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
431
  <a name="_compose_iptc_option_list" id="_compose_iptc_option_list"></a><div class="element clickable method private _compose_iptc_option_list" data-toggle="collapse" data-target="._compose_iptc_option_list .collapse">
432
  <h2>Compose an IPTC Options list with current selection</h2>
433
  <pre>_compose_iptc_option_list(string $selection) : string</pre>
@@ -483,6 +676,70 @@ settings are being updated or reset.</h2>
483
  <code>string</code>HTML markup with select field options</div>
484
  </div></div>
485
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
486
  <a name="_get_custom_field_names" id="_get_custom_field_names"></a><div class="element clickable method private _get_custom_field_names" data-toggle="collapse" data-target="._get_custom_field_names .collapse">
487
  <h2>Generate a list of all (post) Custom Field names</h2>
488
  <pre>_get_custom_field_names() : array</pre>
@@ -510,6 +767,28 @@ settings are being updated or reset.</h2>
510
  </tr></table>
511
  </div></div>
512
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
513
  <a name="_update_iptc_exif_custom_mapping" id="_update_iptc_exif_custom_mapping"></a><div class="element clickable method private _update_iptc_exif_custom_mapping" data-toggle="collapse" data-target="._update_iptc_exif_custom_mapping .collapse">
514
  <h2>Update Custom field portion of IPTC/EXIF mappings</h2>
515
  <pre>_update_iptc_exif_custom_mapping(array $current_values, array $new_values) : array</pre>
@@ -653,6 +932,18 @@ reset => reset function for 'custom' options; returns nothing. Usage:
653
  </tr></table>
654
  </div></div>
655
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
656
  <a name="%24mla_option_templates" id="$mla_option_templates"> </a><div class="element clickable property private $mla_option_templates" data-toggle="collapse" data-target=".$mla_option_templates .collapse">
657
  <h2>Style and Markup templates</h2>
658
  <pre>$mla_option_templates : array</pre>
@@ -697,6 +988,12 @@ reset => reset function for 'custom' options; returns nothing. Usage:
697
  <div class="labels"></div>
698
  <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
699
  </div>
 
 
 
 
 
 
700
  <a name="MLA_VERSION_OPTION" id="MLA_VERSION_OPTION"> </a><div class="element clickable constant MLA_VERSION_OPTION" data-toggle="collapse" data-target=".MLA_VERSION_OPTION .collapse">
701
  <h2>Provides a unique name for the current version option</h2>
702
  <pre>MLA_VERSION_OPTION </pre>
@@ -710,7 +1007,7 @@ reset => reset function for 'custom' options; returns nothing. Usage:
710
  <div class="row"><footer class="span12">
711
  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>
712
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
713
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
714
  </div>
715
  </body>
716
  </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_add_attachment_action" title="mla_add_attachment_action :: Perform ITC/EXIF mapping on just-inserted attachment"><span class="description">Perform ITC/EXIF mapping on just-inserted attachment</span><pre>mla_add_attachment_action()</pre></a></li>
57
+ <li class="method public "><a href="#mla_custom_field_option_handler" title="mla_custom_field_option_handler :: Render and manage custom field mapping options"><span class="description">Render and manage custom field mapping options</span><pre>mla_custom_field_option_handler()</pre></a></li>
58
+ <li class="method public "><a href="#mla_custom_field_option_value" title="mla_custom_field_option_value :: Fetch custom field option value given a slug"><span class="description">Fetch custom field option value given a slug</span><pre>mla_custom_field_option_value()</pre></a></li>
59
+ <li class="method public "><a href="#mla_custom_field_support" title="mla_custom_field_support :: Evaluate file information for custom field mapping"><span class="description">Evaluate file information for custom field mapping</span><pre>mla_custom_field_support()</pre></a></li>
60
  <li class="method public "><a href="#mla_delete_option" title="mla_delete_option :: Delete the stored value of a defined MLA option"><span class="description">Delete the stored value of a defined MLA option</span><pre>mla_delete_option()</pre></a></li>
61
+ <li class="method public "><a href="#mla_evaluate_custom_field_mapping" title="mla_evaluate_custom_field_mapping :: Evaluate custom field mapping updates for a post"><span class="description">Evaluate custom field mapping updates for a post</span><pre>mla_evaluate_custom_field_mapping()</pre></a></li>
62
  <li class="method public "><a href="#mla_evaluate_iptc_exif_mapping" title="mla_evaluate_iptc_exif_mapping :: Evaluate IPTC/EXIF mapping updates for a post"><span class="description">Evaluate IPTC/EXIF mapping updates for a post</span><pre>mla_evaluate_iptc_exif_mapping()</pre></a></li>
63
  <li class="method public "><a href="#mla_fetch_gallery_template" title="mla_fetch_gallery_template :: Fetch style or markup template from $mla_templates"><span class="description">Fetch style or markup template from $mla_templates</span><pre>mla_fetch_gallery_template()</pre></a></li>
64
  <li class="method public "><a href="#mla_get_markup_templates" title="mla_get_markup_templates :: Get ALL markup templates from $mla_templates, including 'default'"><span class="description">Get ALL markup templates from $mla_templates, including 'default'</span><pre>mla_get_markup_templates()</pre></a></li>
71
  <li class="method public "><a href="#mla_taxonomy_support" title="mla_taxonomy_support :: Determine MLA support for a taxonomy, handling the special case where the
72
  settings are being updated or reset."><span class="description">Determine MLA support for a taxonomy, handling the special case where the
73
  settings are being updated or reset.</span><pre>mla_taxonomy_support()</pre></a></li>
74
+ <li class="method public "><a href="#mla_update_attachment_metadata_filter" title="mla_update_attachment_metadata_filter :: Perform Custom Field mapping on just-inserted or updated attachment"><span class="description">Perform Custom Field mapping on just-inserted or updated attachment</span><pre>mla_update_attachment_metadata_filter()</pre></a></li>
75
  <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>
76
  <li class="nav-header private">» Private</li>
77
+ <li class="method private "><a href="#_compose_custom_field_option_list" title="_compose_custom_field_option_list :: Compose a Custom Field Options list with current selection"><span class="description">Compose a Custom Field Options list with current selection</span><pre>_compose_custom_field_option_list()</pre></a></li>
78
+ <li class="method private "><a href="#_compose_data_source_option_list" title="_compose_data_source_option_list :: Compose a (Custom Field) Data Source Options list with current selection"><span class="description">Compose a (Custom Field) Data Source Options list with current selection</span><pre>_compose_data_source_option_list()</pre></a></li>
79
  <li class="method private "><a href="#_compose_iptc_option_list" title="_compose_iptc_option_list :: Compose an IPTC Options list with current selection"><span class="description">Compose an IPTC Options list with current selection</span><pre>_compose_iptc_option_list()</pre></a></li>
80
  <li class="method private "><a href="#_compose_parent_option_list" title="_compose_parent_option_list :: Compose an hierarchical taxonomy Parent options list with current selection"><span class="description">Compose an hierarchical taxonomy Parent options list with current selection</span><pre>_compose_parent_option_list()</pre></a></li>
81
+ <li class="method private "><a href="#_evaluate_data_source" title="_evaluate_data_source :: Evaluate custom field mapping data source"><span class="description">Evaluate custom field mapping data source</span><pre>_evaluate_data_source()</pre></a></li>
82
+ <li class="method private "><a href="#_evaluate_file_information" title="_evaluate_file_information :: Evaluate file information for custom field mapping"><span class="description">Evaluate file information for custom field mapping</span><pre>_evaluate_file_information()</pre></a></li>
83
  <li class="method private "><a href="#_get_custom_field_names" title="_get_custom_field_names :: Generate a list of all (post) Custom Field names"><span class="description">Generate a list of all (post) Custom Field names</span><pre>_get_custom_field_names()</pre></a></li>
84
  <li class="method private "><a href="#_load_option_templates" title="_load_option_templates :: Load style and markup templates to $mla_templates"><span class="description">Load style and markup templates to $mla_templates</span><pre>_load_option_templates()</pre></a></li>
85
+ <li class="method private "><a href="#_update_custom_field_mapping" title="_update_custom_field_mapping :: Update custom field mappings"><span class="description">Update custom field mappings</span><pre>_update_custom_field_mapping()</pre></a></li>
86
  <li class="method private "><a href="#_update_iptc_exif_custom_mapping" title="_update_iptc_exif_custom_mapping :: Update Custom field portion of IPTC/EXIF mappings"><span class="description">Update Custom field portion of IPTC/EXIF mappings</span><pre>_update_iptc_exif_custom_mapping()</pre></a></li>
87
  <li class="method private "><a href="#_update_iptc_exif_standard_mapping" title="_update_iptc_exif_standard_mapping :: Update Standard field portion of IPTC/EXIF mappings"><span class="description">Update Standard field portion of IPTC/EXIF mappings</span><pre>_update_iptc_exif_standard_mapping()</pre></a></li>
88
  <li class="method private "><a href="#_update_iptc_exif_taxonomy_mapping" title="_update_iptc_exif_taxonomy_mapping :: Update Taxonomy term portion of IPTC/EXIF mappings"><span class="description">Update Taxonomy term portion of IPTC/EXIF mappings</span><pre>_update_iptc_exif_taxonomy_mapping()</pre></a></li>
94
  <li class="property public "><a href="#%24process_inserted_in" title='$process_inserted_in :: Option setting for "Inserted in" reporting'><span class="description">Option setting for "Inserted in" reporting</span><pre>$process_inserted_in</pre></a></li>
95
  <li class="property public "><a href="#%24process_mla_gallery_in" title='$process_mla_gallery_in :: Option setting for "MLA Gallery in" reporting'><span class="description">Option setting for "MLA Gallery in" reporting</span><pre>$process_mla_gallery_in</pre></a></li>
96
  <li class="nav-header private">» Private</li>
97
+ <li class="property private "><a href="#%24custom_field_data_sources" title="$custom_field_data_sources :: Array of Data Source names for custom field mapping"><span class="description">Array of Data Source names for custom field mapping</span><pre>$custom_field_data_sources</pre></a></li>
98
  <li class="property private "><a href="#%24mla_option_templates" title="$mla_option_templates :: Style and Markup templates"><span class="description">Style and Markup templates</span><pre>$mla_option_templates</pre></a></li>
99
  <li class="nav-header">
100
  <i class="icon-custom icon-constant"></i> Constants</li>
103
  <li class="constant "><a href="#MLA_INSERTED_IN_TUNING" title="MLA_INSERTED_IN_TUNING :: Provides a unique name for a database tuning option"><span class="description">Provides a unique name for a database tuning option</span><pre>MLA_INSERTED_IN_TUNING</pre></a></li>
104
  <li class="constant "><a href="#MLA_MLA_GALLERY_IN_TUNING" title="MLA_MLA_GALLERY_IN_TUNING :: Provides a unique name for a database tuning option"><span class="description">Provides a unique name for a database tuning option</span><pre>MLA_MLA_GALLERY_IN_TUNING</pre></a></li>
105
  <li class="constant "><a href="#MLA_NEW_CUSTOM_FIELD" title='MLA_NEW_CUSTOM_FIELD :: Provides a unique name for the Custom Field "new field" key'><span class="description">Provides a unique name for the Custom Field "new field" key</span><pre>MLA_NEW_CUSTOM_FIELD</pre></a></li>
106
+ <li class="constant "><a href="#MLA_NEW_CUSTOM_RULE" title='MLA_NEW_CUSTOM_RULE :: Provides a unique name for the Custom Field "new rule" key'><span class="description">Provides a unique name for the Custom Field "new rule" key</span><pre>MLA_NEW_CUSTOM_RULE</pre></a></li>
107
  <li class="constant "><a href="#MLA_VERSION_OPTION" title="MLA_VERSION_OPTION :: Provides a unique name for the current version option"><span class="description">Provides a unique name for the current version option</span><pre>MLA_VERSION_OPTION</pre></a></li>
108
  </ul>
109
  </div>
163
  </div>
164
  </div></div>
165
  </div>
166
+ <a name="mla_custom_field_option_handler" id="mla_custom_field_option_handler"></a><div class="element clickable method public mla_custom_field_option_handler" data-toggle="collapse" data-target=".mla_custom_field_option_handler .collapse">
167
+ <h2>Render and manage custom field mapping options</h2>
168
+ <pre>mla_custom_field_option_handler(string $action, string $key, array $value, array $args) : string</pre>
169
+ <div class="labels"></div>
170
+ <div class="row collapse"><div class="detail-description">
171
+ <p class="long_description"></p>
172
+ <table class="table table-bordered">
173
+ <tr>
174
+ <th>since</th>
175
+ <td>1.10</td>
176
+ </tr>
177
+ <tr>
178
+ <th>uses</th>
179
+ <td>\global\$mla_option_templates</td>
180
+ </tr>
181
+ </table>
182
+ <h3>Parameters</h3>
183
+ <div class="subelement argument">
184
+ <h4>$action</h4>
185
+ <code>string</code><p>'render', 'update', 'delete', or 'reset'</p>
186
+ </div>
187
+ <div class="subelement argument">
188
+ <h4>$key</h4>
189
+ <code>string</code><p>option name, e.g., 'custom_field_mapping'</p>
190
+ </div>
191
+ <div class="subelement argument">
192
+ <h4>$value</h4>
193
+ <code>array</code><p>option parameters</p></div>
194
+ <div class="subelement argument">
195
+ <h4>$args</h4>
196
+ <code>array</code><p>Optional. null (default) for 'render' else option data, e.g., $_REQUEST</p>
197
+ </div>
198
+ <h3>Returns</h3>
199
+ <div class="subelement response">
200
+ <code>string</code>HTML table row markup for 'render' else message(s) reflecting the results of the operation.</div>
201
+ </div></div>
202
+ </div>
203
+ <a name="mla_custom_field_option_value" id="mla_custom_field_option_value"></a><div class="element clickable method public mla_custom_field_option_value" data-toggle="collapse" data-target=".mla_custom_field_option_value .collapse">
204
+ <h2>Fetch custom field option value given a slug</h2>
205
+ <pre>mla_custom_field_option_value(string $slug) : array</pre>
206
+ <div class="labels"></div>
207
+ <div class="row collapse"><div class="detail-description">
208
+ <p class="long_description"></p>
209
+ <table class="table table-bordered"><tr>
210
+ <th>since</th>
211
+ <td>1.10</td>
212
+ </tr></table>
213
+ <h3>Parameters</h3>
214
+ <div class="subelement argument">
215
+ <h4>$slug</h4>
216
+ <code>string</code><p>slug, e.g., 'c_file-size' for the 'File Size' field</p>
217
+ </div>
218
+ <h3>Returns</h3>
219
+ <div class="subelement response">
220
+ <code>array</code>option value, e.g., array( 'name' => 'File Size', ... )</div>
221
+ </div></div>
222
+ </div>
223
+ <a name="mla_custom_field_support" id="mla_custom_field_support"></a><div class="element clickable method public mla_custom_field_support" data-toggle="collapse" data-target=".mla_custom_field_support .collapse">
224
+ <h2>Evaluate file information for custom field mapping</h2>
225
+ <pre>mla_custom_field_support(string $support_type) : array</pre>
226
+ <div class="labels"></div>
227
+ <div class="row collapse"><div class="detail-description">
228
+ <p class="long_description"></p>
229
+ <table class="table table-bordered"><tr>
230
+ <th>since</th>
231
+ <td>1.10</td>
232
+ </tr></table>
233
+ <h3>Parameters</h3>
234
+ <div class="subelement argument">
235
+ <h4>$support_type</h4>
236
+ <code>string</code><p>array format; 'default_columns' (default), 'default_hidden_columns' or 'default_sortable_columns'</p>
237
+ </div>
238
+ <h3>Returns</h3>
239
+ <div class="subelement response">
240
+ <code>array</code>default, hidden or sortable colums in appropriate format</div>
241
+ </div></div>
242
+ </div>
243
  <a name="mla_delete_option" id="mla_delete_option"></a><div class="element clickable method public mla_delete_option" data-toggle="collapse" data-target=".mla_delete_option .collapse">
244
  <h2>Delete the stored value of a defined MLA option</h2>
245
  <pre>mla_delete_option(string $option) : boolean</pre>
259
  <code>boolean</code>True if the option was deleted, otherwise false</div>
260
  </div></div>
261
  </div>
262
+ <a name="mla_evaluate_custom_field_mapping" id="mla_evaluate_custom_field_mapping"></a><div class="element clickable method public mla_evaluate_custom_field_mapping" data-toggle="collapse" data-target=".mla_evaluate_custom_field_mapping .collapse">
263
+ <h2>Evaluate custom field mapping updates for a post</h2>
264
+ <pre>mla_evaluate_custom_field_mapping(integer $post_id, string $category, array $settings, array $attachment_metadata) : array</pre>
265
+ <div class="labels"></div>
266
+ <div class="row collapse"><div class="detail-description">
267
+ <p class="long_description"></p>
268
+ <table class="table table-bordered"><tr>
269
+ <th>since</th>
270
+ <td>1.10</td>
271
+ </tr></table>
272
+ <h3>Parameters</h3>
273
+ <div class="subelement argument">
274
+ <h4>$post_id</h4>
275
+ <code>integer</code><p>post ID to be evaluated</p></div>
276
+ <div class="subelement argument">
277
+ <h4>$category</h4>
278
+ <code>string</code><p>category/scope to evaluate against: custom_field_mapping or single_attachment_mapping</p>
279
+ </div>
280
+ <div class="subelement argument">
281
+ <h4>$settings</h4>
282
+ <code>array</code><p>(optional) custom_field_mapping values, default NULL (use current option value)</p>
283
+ </div>
284
+ <div class="subelement argument">
285
+ <h4>$attachment_metadata</h4>
286
+ <code>array</code><p>(optional) attachment_metadata, default NULL (use current postmeta database value)</p>
287
+ </div>
288
+ <h3>Returns</h3>
289
+ <div class="subelement response">
290
+ <code>array</code>Updates suitable for MLAData::mla_update_single_item, if any</div>
291
+ </div></div>
292
+ </div>
293
  <a name="mla_evaluate_iptc_exif_mapping" id="mla_evaluate_iptc_exif_mapping"></a><div class="element clickable method public mla_evaluate_iptc_exif_mapping" data-toggle="collapse" data-target=".mla_evaluate_iptc_exif_mapping .collapse">
294
  <h2>Evaluate IPTC/EXIF mapping updates for a post</h2>
295
  <pre>mla_evaluate_iptc_exif_mapping(object $post, string $category, array $settings) : array</pre>
526
  <code>boolean</code><code>string</code>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</div>
527
  </div></div>
528
  </div>
529
+ <a name="mla_update_attachment_metadata_filter" id="mla_update_attachment_metadata_filter"></a><div class="element clickable method public mla_update_attachment_metadata_filter" data-toggle="collapse" data-target=".mla_update_attachment_metadata_filter .collapse">
530
+ <h2>Perform Custom Field mapping on just-inserted or updated attachment</h2>
531
+ <pre>mla_update_attachment_metadata_filter(array $data, integer $post_id) : void</pre>
532
+ <div class="labels"></div>
533
+ <div class="row collapse"><div class="detail-description">
534
+ <p class="long_description"></p>
535
+ <table class="table table-bordered"><tr>
536
+ <th>since</th>
537
+ <td>1.10</td>
538
+ </tr></table>
539
+ <h3>Parameters</h3>
540
+ <div class="subelement argument">
541
+ <h4>$data</h4>
542
+ <code>array</code><p>Attachment metadata for just-inserted attachment</p>
543
+ </div>
544
+ <div class="subelement argument">
545
+ <h4>$post_id</h4>
546
+ <code>integer</code><p>ID of just-inserted attachment</p>
547
+ </div>
548
+ </div></div>
549
+ </div>
550
  <a name="mla_update_option" id="mla_update_option"></a><div class="element clickable method public mla_update_option" data-toggle="collapse" data-target=".mla_update_option .collapse">
551
  <h2>Add or update the stored value of a defined MLA option</h2>
552
  <pre>mla_update_option(string $option, mixed $newvalue) : boolean</pre>
569
  <code>boolean</code>True if the value was changed or false if the update failed</div>
570
  </div></div>
571
  </div>
572
+ <a name="_compose_custom_field_option_list" id="_compose_custom_field_option_list"></a><div class="element clickable method private _compose_custom_field_option_list" data-toggle="collapse" data-target="._compose_custom_field_option_list .collapse">
573
+ <h2>Compose a Custom Field Options list with current selection</h2>
574
+ <pre>_compose_custom_field_option_list(string $selection) : string</pre>
575
+ <div class="labels"></div>
576
+ <div class="row collapse"><div class="detail-description">
577
+ <p class="long_description"></p>
578
+ <table class="table table-bordered">
579
+ <tr>
580
+ <th>since</th>
581
+ <td>1.10</td>
582
+ </tr>
583
+ <tr>
584
+ <th>uses</th>
585
+ <td>\global\$mla_option_templates</td>
586
+ </tr>
587
+ </table>
588
+ <h3>Parameters</h3>
589
+ <div class="subelement argument">
590
+ <h4>$selection</h4>
591
+ <code>string</code><p>current selection or 'none' (default)</p>
592
+ </div>
593
+ <h3>Returns</h3>
594
+ <div class="subelement response">
595
+ <code>string</code>HTML markup with select field options</div>
596
+ </div></div>
597
+ </div>
598
+ <a name="_compose_data_source_option_list" id="_compose_data_source_option_list"></a><div class="element clickable method private _compose_data_source_option_list" data-toggle="collapse" data-target="._compose_data_source_option_list .collapse">
599
+ <h2>Compose a (Custom Field) Data Source Options list with current selection</h2>
600
+ <pre>_compose_data_source_option_list(string $selection) : string</pre>
601
+ <div class="labels"></div>
602
+ <div class="row collapse"><div class="detail-description">
603
+ <p class="long_description"></p>
604
+ <table class="table table-bordered">
605
+ <tr>
606
+ <th>since</th>
607
+ <td>1.10</td>
608
+ </tr>
609
+ <tr>
610
+ <th>uses</th>
611
+ <td>\global\$mla_option_templates</td>
612
+ </tr>
613
+ </table>
614
+ <h3>Parameters</h3>
615
+ <div class="subelement argument">
616
+ <h4>$selection</h4>
617
+ <code>string</code><p>current selection or 'none' (default)</p>
618
+ </div>
619
+ <h3>Returns</h3>
620
+ <div class="subelement response">
621
+ <code>string</code>HTML markup with select field options</div>
622
+ </div></div>
623
+ </div>
624
  <a name="_compose_iptc_option_list" id="_compose_iptc_option_list"></a><div class="element clickable method private _compose_iptc_option_list" data-toggle="collapse" data-target="._compose_iptc_option_list .collapse">
625
  <h2>Compose an IPTC Options list with current selection</h2>
626
  <pre>_compose_iptc_option_list(string $selection) : string</pre>
676
  <code>string</code>HTML markup with select field options</div>
677
  </div></div>
678
  </div>
679
+ <a name="_evaluate_data_source" id="_evaluate_data_source"></a><div class="element clickable method private _evaluate_data_source" data-toggle="collapse" data-target="._evaluate_data_source .collapse">
680
+ <h2>Evaluate custom field mapping data source</h2>
681
+ <pre>_evaluate_data_source(integer $post_id, string $category, string $data_source, string $format, array $attachment_metadata) : string</pre>
682
+ <div class="labels"></div>
683
+ <div class="row collapse"><div class="detail-description">
684
+ <p class="long_description"></p>
685
+ <table class="table table-bordered"><tr>
686
+ <th>since</th>
687
+ <td>1.10</td>
688
+ </tr></table>
689
+ <h3>Parameters</h3>
690
+ <div class="subelement argument">
691
+ <h4>$post_id</h4>
692
+ <code>integer</code><p>post->ID of attachment</p>
693
+ </div>
694
+ <div class="subelement argument">
695
+ <h4>$category</h4>
696
+ <code>string</code><p>category/scope to evaluate against: custom_field_mapping or single_attachment_mapping</p>
697
+ </div>
698
+ <div class="subelement argument">
699
+ <h4>$data_source</h4>
700
+ <code>string</code><p>data source name</p></div>
701
+ <div class="subelement argument">
702
+ <h4>$format</h4>
703
+ <code>string</code><p>desired results format, default 'native'</p>
704
+ </div>
705
+ <div class="subelement argument">
706
+ <h4>$attachment_metadata</h4>
707
+ <code>array</code><p>(optional) attachment_metadata, default NULL (use current postmeta database value)</p>
708
+ </div>
709
+ <h3>Returns</h3>
710
+ <div class="subelement response">
711
+ <code>string</code>data source value</div>
712
+ </div></div>
713
+ </div>
714
+ <a name="_evaluate_file_information" id="_evaluate_file_information"></a><div class="element clickable method private _evaluate_file_information" data-toggle="collapse" data-target="._evaluate_file_information .collapse">
715
+ <h2>Evaluate file information for custom field mapping</h2>
716
+ <pre>_evaluate_file_information(string $upload_dir, array $wp_attached_files, array $wp_attachment_metadata, integer $post_id) : array</pre>
717
+ <div class="labels"></div>
718
+ <div class="row collapse"><div class="detail-description">
719
+ <p class="long_description"></p>
720
+ <table class="table table-bordered"><tr>
721
+ <th>since</th>
722
+ <td>1.10</td>
723
+ </tr></table>
724
+ <h3>Parameters</h3>
725
+ <div class="subelement argument">
726
+ <h4>$upload_dir</h4>
727
+ <code>string</code><p>absolute path the the uploads base directory</p></div>
728
+ <div class="subelement argument">
729
+ <h4>$wp_attached_files</h4>
730
+ <code>array</code><p>_wp_attached_file meta_value array, indexed by post_id</p></div>
731
+ <div class="subelement argument">
732
+ <h4>$wp_attachment_metadata</h4>
733
+ <code>array</code><p>_wp_attachment_metadata meta_value array, indexed by post_id</p></div>
734
+ <div class="subelement argument">
735
+ <h4>$post_id</h4>
736
+ <code>integer</code><p>post->ID of attachment</p>
737
+ </div>
738
+ <h3>Returns</h3>
739
+ <div class="subelement response">
740
+ <code>array</code>absolute_path, base_file, path, file_name, extension, dimensions, width, height, hwstring_small, array of intermediate sizes</div>
741
+ </div></div>
742
+ </div>
743
  <a name="_get_custom_field_names" id="_get_custom_field_names"></a><div class="element clickable method private _get_custom_field_names" data-toggle="collapse" data-target="._get_custom_field_names .collapse">
744
  <h2>Generate a list of all (post) Custom Field names</h2>
745
  <pre>_get_custom_field_names() : array</pre>
767
  </tr></table>
768
  </div></div>
769
  </div>
770
+ <a name="_update_custom_field_mapping" id="_update_custom_field_mapping"></a><div class="element clickable method private _update_custom_field_mapping" data-toggle="collapse" data-target="._update_custom_field_mapping .collapse">
771
+ <h2>Update custom field mappings</h2>
772
+ <pre>_update_custom_field_mapping(array $current_values, array $new_values) : array</pre>
773
+ <div class="labels"></div>
774
+ <div class="row collapse"><div class="detail-description">
775
+ <p class="long_description"></p>
776
+ <table class="table table-bordered"><tr>
777
+ <th>since</th>
778
+ <td>1.10</td>
779
+ </tr></table>
780
+ <h3>Parameters</h3>
781
+ <div class="subelement argument">
782
+ <h4>$current_values</h4>
783
+ <code>array</code><p>current custom_field_mapping values</p></div>
784
+ <div class="subelement argument">
785
+ <h4>$new_values</h4>
786
+ <code>array</code><p>new values</p></div>
787
+ <h3>Returns</h3>
788
+ <div class="subelement response">
789
+ <code>array</code>( 'message' => HTML message(s) reflecting results, 'values' => updated iptc_exif_mapping values, 'changed' => true if any changes detected else false )</div>
790
+ </div></div>
791
+ </div>
792
  <a name="_update_iptc_exif_custom_mapping" id="_update_iptc_exif_custom_mapping"></a><div class="element clickable method private _update_iptc_exif_custom_mapping" data-toggle="collapse" data-target="._update_iptc_exif_custom_mapping .collapse">
793
  <h2>Update Custom field portion of IPTC/EXIF mappings</h2>
794
  <pre>_update_iptc_exif_custom_mapping(array $current_values, array $new_values) : array</pre>
932
  </tr></table>
933
  </div></div>
934
  </div>
935
+ <a name="%24custom_field_data_sources" id="$custom_field_data_sources"> </a><div class="element clickable property private $custom_field_data_sources" data-toggle="collapse" data-target=".$custom_field_data_sources .collapse">
936
+ <h2>Array of Data Source names for custom field mapping</h2>
937
+ <pre>$custom_field_data_sources : array</pre>
938
+ <div class="labels"></div>
939
+ <div class="row collapse"><div class="detail-description">
940
+ <p class="long_description"></p>
941
+ <table class="table table-bordered"><tr>
942
+ <th>since</th>
943
+ <td>1.10</td>
944
+ </tr></table>
945
+ </div></div>
946
+ </div>
947
  <a name="%24mla_option_templates" id="$mla_option_templates"> </a><div class="element clickable property private $mla_option_templates" data-toggle="collapse" data-target=".$mla_option_templates .collapse">
948
  <h2>Style and Markup templates</h2>
949
  <pre>$mla_option_templates : array</pre>
988
  <div class="labels"></div>
989
  <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
990
  </div>
991
+ <a name="MLA_NEW_CUSTOM_RULE" id="MLA_NEW_CUSTOM_RULE"> </a><div class="element clickable constant MLA_NEW_CUSTOM_RULE" data-toggle="collapse" data-target=".MLA_NEW_CUSTOM_RULE .collapse">
992
+ <h2>Provides a unique name for the Custom Field "new rule" key</h2>
993
+ <pre>MLA_NEW_CUSTOM_RULE </pre>
994
+ <div class="labels"></div>
995
+ <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
996
+ </div>
997
  <a name="MLA_VERSION_OPTION" id="MLA_VERSION_OPTION"> </a><div class="element clickable constant MLA_VERSION_OPTION" data-toggle="collapse" data-target=".MLA_VERSION_OPTION .collapse">
998
  <h2>Provides a unique name for the current version option</h2>
999
  <pre>MLA_VERSION_OPTION </pre>
1007
  <div class="row"><footer class="span12">
1008
  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>
1009
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1010
+ generated on 2013-01-14T20:41:50-08:00.<br></footer></div>
1011
  </div>
1012
  </body>
1013
  </html>
phpDocs/classes/MLASettings.html CHANGED
@@ -61,13 +61,17 @@ add settings link in the Plugins section entry for MLA.</span><pre>mla_admin_men
61
  <li class="method public "><a href="#mla_deactivation_hook" title="mla_deactivation_hook :: Perform one-time actions on plugin deactivation"><span class="description">Perform one-time actions on plugin deactivation</span><pre>mla_deactivation_hook()</pre></a></li>
62
  <li class="method public "><a href="#mla_render_settings_page" title='mla_render_settings_page :: Render (echo) the "Media Library Assistant" subpage in the Settings section'><span class="description">Render (echo) the "Media Library Assistant" subpage in the Settings section</span><pre>mla_render_settings_page()</pre></a></li>
63
  <li class="nav-header private">» Private</li>
 
64
  <li class="method private "><a href="#_compose_documentation_tab" title="_compose_documentation_tab :: Compose the Documentation tab content for the Settings subpage"><span class="description">Compose the Documentation tab content for the Settings subpage</span><pre>_compose_documentation_tab()</pre></a></li>
65
  <li class="method private "><a href="#_compose_general_tab" title="_compose_general_tab :: Compose the General tab content for the Settings subpage"><span class="description">Compose the General tab content for the Settings subpage</span><pre>_compose_general_tab()</pre></a></li>
66
  <li class="method private "><a href="#_compose_iptc_exif_tab" title="_compose_iptc_exif_tab :: Compose the IPTC/EXIF tab content for the Settings subpage"><span class="description">Compose the IPTC/EXIF tab content for the Settings subpage</span><pre>_compose_iptc_exif_tab()</pre></a></li>
67
  <li class="method private "><a href="#_compose_mla_gallery_tab" title="_compose_mla_gallery_tab :: Compose the MLA Gallery tab content for the Settings subpage"><span class="description">Compose the MLA Gallery tab content for the Settings subpage</span><pre>_compose_mla_gallery_tab()</pre></a></li>
68
  <li class="method private "><a href="#_compose_option_row" title="_compose_option_row :: Compose the table row for a single MLA option"><span class="description">Compose the table row for a single MLA option</span><pre>_compose_option_row()</pre></a></li>
69
  <li class="method private "><a href="#_compose_settings_tabs" title="_compose_settings_tabs :: Compose the navigation tabs for the Settings subpage"><span class="description">Compose the navigation tabs for the Settings subpage</span><pre>_compose_settings_tabs()</pre></a></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="#_process_iptc_exif_custom" title="_process_iptc_exif_custom :: Process IPTC/EXIF custom field settings against all image attachments
72
  without saving the settings to the mla_option"><span class="description">Process IPTC/EXIF custom field settings against all image attachments
73
  without saving the settings to the mla_option</span><pre>_process_iptc_exif_custom()</pre></a></li>
@@ -78,6 +82,7 @@ without saving the settings to the mla_option</span><pre>_process_iptc_exif_stan
78
  without saving the settings to the mla_option"><span class="description">Process IPTC/EXIF taxonomy term settings against all image attachments
79
  without saving the settings to the mla_option</span><pre>_process_iptc_exif_taxonomy()</pre></a></li>
80
  <li class="method private "><a href="#_reset_general_settings" title="_reset_general_settings :: Delete saved settings, restoring default values"><span class="description">Delete saved settings, restoring default values</span><pre>_reset_general_settings()</pre></a></li>
 
81
  <li class="method private "><a href="#_save_gallery_settings" title="_save_gallery_settings :: Save MLA Gallery settings to the options table"><span class="description">Save MLA Gallery settings to the options table</span><pre>_save_gallery_settings()</pre></a></li>
82
  <li class="method private "><a href="#_save_general_settings" title="_save_general_settings :: Save General settings to the options table"><span class="description">Save General settings to the options table</span><pre>_save_general_settings()</pre></a></li>
83
  <li class="method private "><a href="#_save_iptc_exif_settings" title="_save_iptc_exif_settings :: Save IPTC/EXIF settings to the options table"><span class="description">Save IPTC/EXIF settings to the options table</span><pre>_save_iptc_exif_settings()</pre></a></li>
@@ -85,7 +90,6 @@ without saving the settings to the mla_option</span><pre>_process_iptc_exif_taxo
85
  <li class="method private "><a href="#_version_upgrade" title="_version_upgrade :: Database and option update check, for installing new versions"><span class="description">Database and option update check, for installing new versions</span><pre>_version_upgrade()</pre></a></li>
86
  <li class="nav-header">
87
  <i class="icon-custom icon-property"></i> Properties</li>
88
- <li class="property public "><a href="#%24mla_alt_text_view" title="$mla_alt_text_view :: Provides a unique name for the ALT Text SQL VIEW"><span class="description">Provides a unique name for the ALT Text SQL VIEW</span><pre>$mla_alt_text_view</pre></a></li>
89
  <li class="nav-header private">» Private</li>
90
  <li class="property private "><a href="#%24mla_tablist" title="$mla_tablist :: Definitions for Settings page tab ids, titles and handlers
91
  Each tab is defined by an array with the following elements:"><span class="description">Definitions for Settings page tab ids, titles and handlers
@@ -93,7 +97,6 @@ Each tab is defined by an array with the following elements:</span><pre>$mla_tab
93
  <li class="property private "><a href="#%24page_template_array" title="$page_template_array :: Template file for the Settings page(s) and parts"><span class="description">Template file for the Settings page(s) and parts</span><pre>$page_template_array</pre></a></li>
94
  <li class="nav-header">
95
  <i class="icon-custom icon-constant"></i> Constants</li>
96
- <li class="constant "><a href="#MLA_ALT_TEXT_VIEW_SUFFIX" title="MLA_ALT_TEXT_VIEW_SUFFIX :: Provides a unique suffix for the ALT Text SQL VIEW"><span class="description">Provides a unique suffix for the ALT Text SQL VIEW</span><pre>MLA_ALT_TEXT_VIEW_SUFFIX</pre></a></li>
97
  <li class="constant "><a href="#MLA_SETTINGS_SLUG" title="MLA_SETTINGS_SLUG :: Provides a unique name for the settings page"><span class="description">Provides a unique name for the settings page</span><pre>MLA_SETTINGS_SLUG</pre></a></li>
98
  </ul>
99
  </div>
@@ -188,7 +191,7 @@ add settings link in the Plugins section entry for MLA.</h2>
188
  <pre>mla_deactivation_hook() : void</pre>
189
  <div class="labels"></div>
190
  <div class="row collapse"><div class="detail-description">
191
- <p class="long_description"><p>Removes a view from the database that supports sorting the listing on 'ALT Text'.</p></p>
192
  <table class="table table-bordered"><tr>
193
  <th>since</th>
194
  <td>0.40</td>
@@ -207,6 +210,27 @@ add settings link in the Plugins section entry for MLA.</h2>
207
  </tr></table>
208
  </div></div>
209
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
210
  <a name="_compose_documentation_tab" id="_compose_documentation_tab"></a><div class="element clickable method private _compose_documentation_tab" data-toggle="collapse" data-target="._compose_documentation_tab .collapse">
211
  <h2>Compose the Documentation tab content for the Settings subpage</h2>
212
  <pre>_compose_documentation_tab() : array</pre>
@@ -347,17 +371,49 @@ add settings link in the Plugins section entry for MLA.</h2>
347
  <code>string</code>HTML markup for the Settings subpage navigation tabs</div>
348
  </div></div>
349
  </div>
350
- <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">
351
- <h2>Add a view to the database to support sorting the listing on 'ALT Text'</h2>
352
- <pre>_create_alt_text_view() : void</pre>
353
  <div class="labels"></div>
354
  <div class="row collapse"><div class="detail-description">
355
- <p class="long_description"><p>This function is called on each plugin invocation because the plugin upgrade process
356
- does not call the activation hook.</p></p>
357
  <table class="table table-bordered"><tr>
358
  <th>since</th>
359
- <td>0.50</td>
360
  </tr></table>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
361
  </div></div>
362
  </div>
363
  <a name="_process_iptc_exif_custom" id="_process_iptc_exif_custom"></a><div class="element clickable method private _process_iptc_exif_custom" data-toggle="collapse" data-target="._process_iptc_exif_custom .collapse">
@@ -441,6 +497,31 @@ without saving the settings to the mla_option</h2>
441
  <code>array</code>Message(s) reflecting the results of the operation</div>
442
  </div></div>
443
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
444
  <a name="_save_gallery_settings" id="_save_gallery_settings"></a><div class="element clickable method private _save_gallery_settings" data-toggle="collapse" data-target="._save_gallery_settings .collapse">
445
  <h2>Save MLA Gallery settings to the options table</h2>
446
  <pre>_save_gallery_settings() : array</pre>
@@ -548,18 +629,6 @@ without saving the settings to the mla_option</h2>
548
  </div>
549
  <h3>
550
  <i class="icon-custom icon-property"></i> Properties</h3>
551
- <a name="%24mla_alt_text_view" id="$mla_alt_text_view"> </a><div class="element clickable property public $mla_alt_text_view" data-toggle="collapse" data-target=".$mla_alt_text_view .collapse">
552
- <h2>Provides a unique name for the ALT Text SQL VIEW</h2>
553
- <pre>$mla_alt_text_view : array</pre>
554
- <div class="labels"></div>
555
- <div class="row collapse"><div class="detail-description">
556
- <p class="long_description"></p>
557
- <table class="table table-bordered"><tr>
558
- <th>since</th>
559
- <td>0.40</td>
560
- </tr></table>
561
- </div></div>
562
- </div>
563
  <a name="%24mla_tablist" id="$mla_tablist"> </a><div class="element clickable property private $mla_tablist" data-toggle="collapse" data-target=".$mla_tablist .collapse">
564
  <h2>Definitions for Settings page tab ids, titles and handlers
565
  Each tab is defined by an array with the following elements:</h2>
@@ -592,12 +661,6 @@ each page load and cached for subsequent use.</p></p>
592
  </div>
593
  <h3>
594
  <i class="icon-custom icon-constant"></i> Constants</h3>
595
- <a name="MLA_ALT_TEXT_VIEW_SUFFIX" id="MLA_ALT_TEXT_VIEW_SUFFIX"> </a><div class="element clickable constant MLA_ALT_TEXT_VIEW_SUFFIX" data-toggle="collapse" data-target=".MLA_ALT_TEXT_VIEW_SUFFIX .collapse">
596
- <h2>Provides a unique suffix for the ALT Text SQL VIEW</h2>
597
- <pre>MLA_ALT_TEXT_VIEW_SUFFIX </pre>
598
- <div class="labels"></div>
599
- <div class="row collapse"><div class="detail-description"><p class="long_description"></p></div></div>
600
- </div>
601
  <a name="MLA_SETTINGS_SLUG" id="MLA_SETTINGS_SLUG"> </a><div class="element clickable constant MLA_SETTINGS_SLUG" data-toggle="collapse" data-target=".MLA_SETTINGS_SLUG .collapse">
602
  <h2>Provides a unique name for the settings page</h2>
603
  <pre>MLA_SETTINGS_SLUG </pre>
@@ -611,7 +674,7 @@ each page load and cached for subsequent use.</p></p>
611
  <div class="row"><footer class="span12">
612
  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>
613
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
614
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
615
  </div>
616
  </body>
617
  </html>
61
  <li class="method public "><a href="#mla_deactivation_hook" title="mla_deactivation_hook :: Perform one-time actions on plugin deactivation"><span class="description">Perform one-time actions on plugin deactivation</span><pre>mla_deactivation_hook()</pre></a></li>
62
  <li class="method public "><a href="#mla_render_settings_page" title='mla_render_settings_page :: Render (echo) the "Media Library Assistant" subpage in the Settings section'><span class="description">Render (echo) the "Media Library Assistant" subpage in the Settings section</span><pre>mla_render_settings_page()</pre></a></li>
63
  <li class="nav-header private">» Private</li>
64
+ <li class="method private "><a href="#_compose_custom_field_tab" title="_compose_custom_field_tab :: Compose the Custom Field tab content for the Settings subpage"><span class="description">Compose the Custom Field tab content for the Settings subpage</span><pre>_compose_custom_field_tab()</pre></a></li>
65
  <li class="method private "><a href="#_compose_documentation_tab" title="_compose_documentation_tab :: Compose the Documentation tab content for the Settings subpage"><span class="description">Compose the Documentation tab content for the Settings subpage</span><pre>_compose_documentation_tab()</pre></a></li>
66
  <li class="method private "><a href="#_compose_general_tab" title="_compose_general_tab :: Compose the General tab content for the Settings subpage"><span class="description">Compose the General tab content for the Settings subpage</span><pre>_compose_general_tab()</pre></a></li>
67
  <li class="method private "><a href="#_compose_iptc_exif_tab" title="_compose_iptc_exif_tab :: Compose the IPTC/EXIF tab content for the Settings subpage"><span class="description">Compose the IPTC/EXIF tab content for the Settings subpage</span><pre>_compose_iptc_exif_tab()</pre></a></li>
68
  <li class="method private "><a href="#_compose_mla_gallery_tab" title="_compose_mla_gallery_tab :: Compose the MLA Gallery tab content for the Settings subpage"><span class="description">Compose the MLA Gallery tab content for the Settings subpage</span><pre>_compose_mla_gallery_tab()</pre></a></li>
69
  <li class="method private "><a href="#_compose_option_row" title="_compose_option_row :: Compose the table row for a single MLA option"><span class="description">Compose the table row for a single MLA option</span><pre>_compose_option_row()</pre></a></li>
70
  <li class="method private "><a href="#_compose_settings_tabs" title="_compose_settings_tabs :: Compose the navigation tabs for the Settings subpage"><span class="description">Compose the navigation tabs for the Settings subpage</span><pre>_compose_settings_tabs()</pre></a></li>
71
+ <li class="method private "><a href="#_delete_custom_field" title="_delete_custom_field :: Delete a custom field from the wp_postmeta table"><span class="description">Delete a custom field from the wp_postmeta table</span><pre>_delete_custom_field()</pre></a></li>
72
+ <li class="method private "><a href="#_process_custom_field_mapping" title="_process_custom_field_mapping :: Process custom field settings against all image attachments
73
+ without saving the settings to the mla_option"><span class="description">Process custom field settings against all image attachments
74
+ without saving the settings to the mla_option</span><pre>_process_custom_field_mapping()</pre></a></li>
75
  <li class="method private "><a href="#_process_iptc_exif_custom" title="_process_iptc_exif_custom :: Process IPTC/EXIF custom field settings against all image attachments
76
  without saving the settings to the mla_option"><span class="description">Process IPTC/EXIF custom field settings against all image attachments
77
  without saving the settings to the mla_option</span><pre>_process_iptc_exif_custom()</pre></a></li>
82
  without saving the settings to the mla_option"><span class="description">Process IPTC/EXIF taxonomy term settings against all image attachments
83
  without saving the settings to the mla_option</span><pre>_process_iptc_exif_taxonomy()</pre></a></li>
84
  <li class="method private "><a href="#_reset_general_settings" title="_reset_general_settings :: Delete saved settings, restoring default values"><span class="description">Delete saved settings, restoring default values</span><pre>_reset_general_settings()</pre></a></li>
85
+ <li class="method private "><a href="#_save_custom_field_settings" title="_save_custom_field_settings :: Save custom field settings to the options table"><span class="description">Save custom field settings to the options table</span><pre>_save_custom_field_settings()</pre></a></li>
86
  <li class="method private "><a href="#_save_gallery_settings" title="_save_gallery_settings :: Save MLA Gallery settings to the options table"><span class="description">Save MLA Gallery settings to the options table</span><pre>_save_gallery_settings()</pre></a></li>
87
  <li class="method private "><a href="#_save_general_settings" title="_save_general_settings :: Save General settings to the options table"><span class="description">Save General settings to the options table</span><pre>_save_general_settings()</pre></a></li>
88
  <li class="method private "><a href="#_save_iptc_exif_settings" title="_save_iptc_exif_settings :: Save IPTC/EXIF settings to the options table"><span class="description">Save IPTC/EXIF settings to the options table</span><pre>_save_iptc_exif_settings()</pre></a></li>
90
  <li class="method private "><a href="#_version_upgrade" title="_version_upgrade :: Database and option update check, for installing new versions"><span class="description">Database and option update check, for installing new versions</span><pre>_version_upgrade()</pre></a></li>
91
  <li class="nav-header">
92
  <i class="icon-custom icon-property"></i> Properties</li>
 
93
  <li class="nav-header private">» Private</li>
94
  <li class="property private "><a href="#%24mla_tablist" title="$mla_tablist :: Definitions for Settings page tab ids, titles and handlers
95
  Each tab is defined by an array with the following elements:"><span class="description">Definitions for Settings page tab ids, titles and handlers
97
  <li class="property private "><a href="#%24page_template_array" title="$page_template_array :: Template file for the Settings page(s) and parts"><span class="description">Template file for the Settings page(s) and parts</span><pre>$page_template_array</pre></a></li>
98
  <li class="nav-header">
99
  <i class="icon-custom icon-constant"></i> Constants</li>
 
100
  <li class="constant "><a href="#MLA_SETTINGS_SLUG" title="MLA_SETTINGS_SLUG :: Provides a unique name for the settings page"><span class="description">Provides a unique name for the settings page</span><pre>MLA_SETTINGS_SLUG</pre></a></li>
101
  </ul>
102
  </div>
191
  <pre>mla_deactivation_hook() : void</pre>
192
  <div class="labels"></div>
193
  <div class="row collapse"><div class="detail-description">
194
+ <p class="long_description"><p>Removes (if present) a view from the database that supports sorting the listing on 'ALT Text'.</p></p>
195
  <table class="table table-bordered"><tr>
196
  <th>since</th>
197
  <td>0.40</td>
210
  </tr></table>
211
  </div></div>
212
  </div>
213
+ <a name="_compose_custom_field_tab" id="_compose_custom_field_tab"></a><div class="element clickable method private _compose_custom_field_tab" data-toggle="collapse" data-target="._compose_custom_field_tab .collapse">
214
+ <h2>Compose the Custom Field tab content for the Settings subpage</h2>
215
+ <pre>_compose_custom_field_tab() : array</pre>
216
+ <div class="labels"></div>
217
+ <div class="row collapse"><div class="detail-description">
218
+ <p class="long_description"></p>
219
+ <table class="table table-bordered">
220
+ <tr>
221
+ <th>since</th>
222
+ <td>1.10</td>
223
+ </tr>
224
+ <tr>
225
+ <th>uses</th>
226
+ <td>\global\$page_template_array</td>
227
+ </tr>
228
+ </table>
229
+ <h3>Returns</h3>
230
+ <div class="subelement response">
231
+ <code>array</code>'message' => status/error messages, 'body' => tab content</div>
232
+ </div></div>
233
+ </div>
234
  <a name="_compose_documentation_tab" id="_compose_documentation_tab"></a><div class="element clickable method private _compose_documentation_tab" data-toggle="collapse" data-target="._compose_documentation_tab .collapse">
235
  <h2>Compose the Documentation tab content for the Settings subpage</h2>
236
  <pre>_compose_documentation_tab() : array</pre>
371
  <code>string</code>HTML markup for the Settings subpage navigation tabs</div>
372
  </div></div>
373
  </div>
374
+ <a name="_delete_custom_field" id="_delete_custom_field"></a><div class="element clickable method private _delete_custom_field" data-toggle="collapse" data-target="._delete_custom_field .collapse">
375
+ <h2>Delete a custom field from the wp_postmeta table</h2>
376
+ <pre>_delete_custom_field(array $value) : array</pre>
377
  <div class="labels"></div>
378
  <div class="row collapse"><div class="detail-description">
379
+ <p class="long_description"></p>
 
380
  <table class="table table-bordered"><tr>
381
  <th>since</th>
382
+ <td>1.10</td>
383
  </tr></table>
384
+ <h3>Parameters</h3>
385
+ <div class="subelement argument">
386
+ <h4>$value</h4>
387
+ <code>array</code><p>specific custom_field_mapping rule</p></div>
388
+ <h3>Returns</h3>
389
+ <div class="subelement response">
390
+ <code>array</code>Message(s) reflecting the results of the operation</div>
391
+ </div></div>
392
+ </div>
393
+ <a name="_process_custom_field_mapping" id="_process_custom_field_mapping"></a><div class="element clickable method private _process_custom_field_mapping" data-toggle="collapse" data-target="._process_custom_field_mapping .collapse">
394
+ <h2>Process custom field settings against all image attachments
395
+ without saving the settings to the mla_option</h2>
396
+ <pre>_process_custom_field_mapping(array $settings) : array</pre>
397
+ <div class="labels"></div>
398
+ <div class="row collapse"><div class="detail-description">
399
+ <p class="long_description"></p>
400
+ <table class="table table-bordered">
401
+ <tr>
402
+ <th>since</th>
403
+ <td>1.10</td>
404
+ </tr>
405
+ <tr>
406
+ <th>uses</th>
407
+ <td>\global\$_REQUEST</td>
408
+ </tr>
409
+ </table>
410
+ <h3>Parameters</h3>
411
+ <div class="subelement argument">
412
+ <h4>$settings</h4>
413
+ <code>array</code><p>| NULL specific custom_field_mapping values</p></div>
414
+ <h3>Returns</h3>
415
+ <div class="subelement response">
416
+ <code>array</code>Message(s) reflecting the results of the operation</div>
417
  </div></div>
418
  </div>
419
  <a name="_process_iptc_exif_custom" id="_process_iptc_exif_custom"></a><div class="element clickable method private _process_iptc_exif_custom" data-toggle="collapse" data-target="._process_iptc_exif_custom .collapse">
497
  <code>array</code>Message(s) reflecting the results of the operation</div>
498
  </div></div>
499
  </div>
500
+ <a name="_save_custom_field_settings" id="_save_custom_field_settings"></a><div class="element clickable method private _save_custom_field_settings" data-toggle="collapse" data-target="._save_custom_field_settings .collapse">
501
+ <h2>Save custom field settings to the options table</h2>
502
+ <pre>_save_custom_field_settings(array $new_values) : array</pre>
503
+ <div class="labels"></div>
504
+ <div class="row collapse"><div class="detail-description">
505
+ <p class="long_description"></p>
506
+ <table class="table table-bordered">
507
+ <tr>
508
+ <th>since</th>
509
+ <td>1.10</td>
510
+ </tr>
511
+ <tr>
512
+ <th>uses</th>
513
+ <td>\global\$_REQUEST</td>
514
+ </tr>
515
+ </table>
516
+ <h3>Parameters</h3>
517
+ <div class="subelement argument">
518
+ <h4>$new_values</h4>
519
+ <code>array</code><p>| NULL specific custom_field_mapping values</p></div>
520
+ <h3>Returns</h3>
521
+ <div class="subelement response">
522
+ <code>array</code>Message(s) reflecting the results of the operation</div>
523
+ </div></div>
524
+ </div>
525
  <a name="_save_gallery_settings" id="_save_gallery_settings"></a><div class="element clickable method private _save_gallery_settings" data-toggle="collapse" data-target="._save_gallery_settings .collapse">
526
  <h2>Save MLA Gallery settings to the options table</h2>
527
  <pre>_save_gallery_settings() : array</pre>
629
  </div>
630
  <h3>
631
  <i class="icon-custom icon-property"></i> Properties</h3>
 
 
 
 
 
 
 
 
 
 
 
 
632
  <a name="%24mla_tablist" id="$mla_tablist"> </a><div class="element clickable property private $mla_tablist" data-toggle="collapse" data-target=".$mla_tablist .collapse">
633
  <h2>Definitions for Settings page tab ids, titles and handlers
634
  Each tab is defined by an array with the following elements:</h2>
661
  </div>
662
  <h3>
663
  <i class="icon-custom icon-constant"></i> Constants</h3>
 
 
 
 
 
 
664
  <a name="MLA_SETTINGS_SLUG" id="MLA_SETTINGS_SLUG"> </a><div class="element clickable constant MLA_SETTINGS_SLUG" data-toggle="collapse" data-target=".MLA_SETTINGS_SLUG .collapse">
665
  <h2>Provides a unique name for the settings page</h2>
666
  <pre>MLA_SETTINGS_SLUG </pre>
674
  <div class="row"><footer class="span12">
675
  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>
676
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
677
+ generated on 2013-01-14T20:41:50-08:00.<br></footer></div>
678
  </div>
679
  </body>
680
  </html>
phpDocs/classes/MLAShortcodes.html CHANGED
@@ -281,7 +281,7 @@ the "IPTC-NAA Information Interchange Model Version No. 4.1".</p></p>
281
  <div class="row"><footer class="span12">
282
  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>
283
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
284
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
285
  </div>
286
  </body>
287
  </html>
281
  <div class="row"><footer class="span12">
282
  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>
283
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
284
+ generated on 2013-01-14T20:41:51-08:00.<br></footer></div>
285
  </div>
286
  </body>
287
  </html>
phpDocs/classes/MLATest.html CHANGED
@@ -160,7 +160,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
160
  <div class="row"><footer class="span12">
161
  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>
162
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
163
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
164
  </div>
165
  </body>
166
  </html>
160
  <div class="row"><footer class="span12">
161
  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>
162
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
163
+ generated on 2013-01-14T20:41:51-08:00.<br></footer></div>
164
  </div>
165
  </body>
166
  </html>
phpDocs/classes/MLA_List_Table.html CHANGED
@@ -716,7 +716,7 @@ created in time to affect the "screen options" setup.</p></p>
716
  <pre>mla_get_attachment_mime_types() : array</pre>
717
  <div class="labels"></div>
718
  <div class="row collapse"><div class="detail-description">
719
- <p class="long_description"><p>Modeled after get_post_mime_types in wp-admin/includes/post.php,
720
  with additional entries.</p></p>
721
  <table class="table table-bordered"><tr>
722
  <th>since</th>
@@ -924,7 +924,8 @@ use the special slug "cb".</p>
924
  column in your table you must create a column_cb() method. If you don't need
925
  bulk actions or checkboxes, simply leave the 'cb' entry out of your array.</p>
926
 
927
- <p>Taxonomy columns are added to this array by mla_admin_init_action.</p></p>
 
928
  <table class="table table-bordered"><tr>
929
  <th>since</th>
930
  <td>0.1</td>
@@ -942,7 +943,8 @@ the user has not altered the selection of hidden columns.</p>
942
  <p>The value on the right-hand side must match the column slug, e.g.,
943
  array(0 => 'ID_parent, 1 => 'title_name').</p>
944
 
945
- <p>Taxonomy columns are added to this array by mla_admin_init_action.</p></p>
 
946
  <table class="table table-bordered"><tr>
947
  <th>since</th>
948
  <td>0.1</td>
@@ -960,7 +962,10 @@ to sort by. Often, the key and value will be the same, but this is not always
960
  the case (as the value is a column name from the database, not the list table).</p>
961
 
962
  <p>The array value also contains a boolean which is 'true' if the data is currently
963
- sorted by that column. This is computed each time the table is displayed.</p></p>
 
 
 
964
  <table class="table table-bordered"><tr>
965
  <th>since</th>
966
  <td>0.1</td>
@@ -986,7 +991,7 @@ sorted by that column. This is computed each time the table is displayed.</p></p
986
  <div class="row"><footer class="span12">
987
  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>
988
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
989
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
990
  </div>
991
  </body>
992
  </html>
716
  <pre>mla_get_attachment_mime_types() : array</pre>
717
  <div class="labels"></div>
718
  <div class="row collapse"><div class="detail-description">
719
+ <p class="long_description"><p>Modeled after get_post_mime_types in wp-includes/post.php,
720
  with additional entries.</p></p>
721
  <table class="table table-bordered"><tr>
722
  <th>since</th>
924
  column in your table you must create a column_cb() method. If you don't need
925
  bulk actions or checkboxes, simply leave the 'cb' entry out of your array.</p>
926
 
927
+ <p>Taxonomy columns are added to this array by mla_admin_init_action.
928
+ Custom field columns are added to this array by mla_admin_init_action.</p></p>
929
  <table class="table table-bordered"><tr>
930
  <th>since</th>
931
  <td>0.1</td>
943
  <p>The value on the right-hand side must match the column slug, e.g.,
944
  array(0 => 'ID_parent, 1 => 'title_name').</p>
945
 
946
+ <p>Taxonomy columns are added to this array by mla_admin_init_action.
947
+ Custom field columns are added to this array by mla_admin_init_action.</p></p>
948
  <table class="table table-bordered"><tr>
949
  <th>since</th>
950
  <td>0.1</td>
962
  the case (as the value is a column name from the database, not the list table).</p>
963
 
964
  <p>The array value also contains a boolean which is 'true' if the data is currently
965
+ sorted by that column. This is computed each time the table is displayed.</p>
966
+
967
+ <p>Taxonomy columns, if any, are added to this array by mla_admin_init_action.
968
+ Custom field columns are added to this array by mla_admin_init_action.</p></p>
969
  <table class="table table-bordered"><tr>
970
  <th>since</th>
971
  <td>0.1</td>
991
  <div class="row"><footer class="span12">
992
  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>
993
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
994
+ generated on 2013-01-14T20:41:50-08:00.<br></footer></div>
995
  </div>
996
  </body>
997
  </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-12-29T12:42:47-08: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 2013-01-14T20:41:51-08:00.<br></footer></div>
66
  </div>
67
  </body>
68
  </html>
phpDocs/errors.html CHANGED
@@ -76,7 +76,7 @@
76
  <div class="row"><footer class="span12">
77
  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>
78
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
79
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
80
  </div>
81
  </body>
82
  </html>
76
  <div class="row"><footer class="span12">
77
  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>
78
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
79
+ generated on 2013-01-14T20:41:51-08:00.<br></footer></div>
80
  </div>
81
  </body>
82
  </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-12-29T12:42:47-08: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 2013-01-14T20:41:51-08: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-12-29T12:42:47-08: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 2013-01-14T20:41:50-08: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-12-29T12:42:47-08:00.<br></footer></div>
68
  </div>
69
  </body>
70
  </html>
64
  <div class="row"><footer class="span12">
65
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
66
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
67
+ generated on 2013-01-14T20:41:51-08:00.<br></footer></div>
68
  </div>
69
  </body>
70
  </html>
phpDocs/namespaces/global.html CHANGED
@@ -173,7 +173,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
173
  <div class="row"><footer class="span12">
174
  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>
175
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
176
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
177
  </div>
178
  </body>
179
  </html>
173
  <div class="row"><footer class="span12">
174
  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>
175
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
176
+ generated on 2013-01-14T20:41:50-08:00.<br></footer></div>
177
  </div>
178
  </body>
179
  </html>
phpDocs/packages/Media Library Assistant.html CHANGED
@@ -195,7 +195,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
195
  <div class="row"><footer class="span12">
196
  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>
197
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
198
- generated on 2012-12-29T12:42:47-08:00.<br></footer></div>
199
  </div>
200
  </body>
201
  </html>
195
  <div class="row"><footer class="span12">
196
  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>
197
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
198
+ generated on 2013-01-14T20:41:50-08:00.<br></footer></div>
199
  </div>
200
  </body>
201
  </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="2f1b4ec9475e8fa42ec89bc39e7458f1" 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,24 +18,46 @@ 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="267" namespace="global" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
22
  <name>$query_parameters</name>
23
  <default><![CDATA[array()]]></default>
24
- <docblock line="256">
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="256" name="since" description="0.30"/>
30
- <tag line="256" name="var" description="" type="array">
31
  <type by_reference="false">array</type>
32
  </tag>
33
  </docblock>
34
  </property>
35
- <property final="false" static="true" visibility="private" line="1007" namespace="global" package="Media Library Assistant">
36
  <name>$galleries</name>
37
  <default><![CDATA[null]]></default>
38
- <docblock line="989">
39
  <description><![CDATA[Objects containing [gallery] shortcodes]]></description>
40
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [gallery] shortcodes
41
  and array(s) of which attachments each [gallery] contains. The arrays are built once
@@ -47,665 +69,666 @@ Each inner array has these elements:
47
  ['parent_type'] 'post' or 'page' or the custom post_type of the gallery parent,
48
  ['query'] contains a string with the arguments of the [gallery],
49
  ['results'] contains an array of post_ids for the objects in the gallery.</p>]]></long-description>
50
- <tag line="989" name="since" description="0.70"/>
51
- <tag line="989" name="var" description="" type="array">
52
  <type by_reference="false">array</type>
53
  </tag>
54
  </docblock>
55
  </property>
56
- <property final="false" static="true" visibility="private" line="1020" namespace="global" package="Media Library Assistant">
57
  <name>$mla_galleries</name>
58
  <default><![CDATA[null]]></default>
59
- <docblock line="1009">
60
  <description><![CDATA[Objects containing [mla_gallery] shortcodes]]></description>
61
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [mla_gallery] shortcodes
62
  and array(s) of which attachments each [mla_gallery] contains. The arrays are built once
63
  each page load and cached for subsequent calls.</p>]]></long-description>
64
- <tag line="1009" name="since" description="0.70"/>
65
- <tag line="1009" name="var" description="" type="array">
66
  <type by_reference="false">array</type>
67
  </tag>
68
  </docblock>
69
  </property>
70
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="24" package="Media Library Assistant">
71
  <name>initialize</name>
72
  <full_name>initialize</full_name>
73
- <docblock line="19">
74
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
75
  <long-description><![CDATA[]]></long-description>
76
- <tag line="19" name="since" description="0.1"/>
77
  </docblock>
78
  </method>
79
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="48" package="Media Library Assistant">
80
  <name>mla_load_template</name>
81
  <full_name>mla_load_template</full_name>
82
- <docblock line="30">
83
  <description><![CDATA[Load an HTML template from a file]]></description>
84
  <long-description><![CDATA[<p>Loads a template to a string or a multi-part template to an array.
85
  Multi-part templates are divided by comments of the form <!-- template="key" -->,
86
  where "key" becomes the key part of the array.</p>]]></long-description>
87
- <tag line="30" name="since" description="0.1"/>
88
- <tag line="30" name="param" description="Complete path and name of the template file, option name or the raw template" type="string" variable="$source">
89
  <type by_reference="false">string</type>
90
  </tag>
91
- <tag line="30" name="param" description="Optional type of template source; 'file' (default), 'option', 'string'" type="string" variable="$type">
92
  <type by_reference="false">string</type>
93
  </tag>
94
- <tag line="30" 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">
95
  <type by_reference="false">string</type>
96
  <type by_reference="false">array</type>
97
  <type by_reference="false">false</type>
98
  <type by_reference="false">NULL</type>
99
  </tag>
100
  </docblock>
101
- <argument line="48">
102
  <name>$source</name>
103
  <default><![CDATA[]]></default>
104
  <type/>
105
  </argument>
106
- <argument line="48">
107
  <name>$type</name>
108
  <default><![CDATA['file']]></default>
109
  <type/>
110
  </argument>
111
  </method>
112
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="143" package="Media Library Assistant">
113
  <name>mla_parse_template</name>
114
  <full_name>mla_parse_template</full_name>
115
- <docblock line="131">
116
  <description><![CDATA[Expand a template, replacing place holders with their values]]></description>
117
  <long-description><![CDATA[<p>A simple parsing function for basic templating.</p>]]></long-description>
118
- <tag line="131" name="since" description="0.1"/>
119
- <tag line="131" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
120
  <type by_reference="false">string</type>
121
  </tag>
122
- <tag line="131" name="param" description="An associative array containing keys and values e.g. array('key' =&gt; 'value')" type="array" variable="$hash">
123
  <type by_reference="false">array</type>
124
  </tag>
125
- <tag line="131" name="return" description="Placeholders corresponding to the keys of the hash will be replaced with their values" type="string">
126
  <type by_reference="false">string</type>
127
  </tag>
128
  </docblock>
129
- <argument line="143">
130
  <name>$tpl</name>
131
  <default><![CDATA[]]></default>
132
  <type/>
133
  </argument>
134
- <argument line="143">
135
  <name>$hash</name>
136
  <default><![CDATA[]]></default>
137
  <type/>
138
  </argument>
139
  </method>
140
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="162" package="Media Library Assistant">
141
  <name>mla_get_template_placeholders</name>
142
  <full_name>mla_get_template_placeholders</full_name>
143
- <docblock line="152">
144
  <description><![CDATA[Analyze a template, returning an array of the place holders it contains]]></description>
145
  <long-description><![CDATA[]]></long-description>
146
- <tag line="152" name="since" description="0.90"/>
147
- <tag line="152" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
148
  <type by_reference="false">string</type>
149
  </tag>
150
- <tag line="152" name="return" description="Placeholder information: each entry is an array with ['prefix'] =&gt; string, ['value'] =&gt; string, ['single'] =&gt; boolean" type="array">
151
  <type by_reference="false">array</type>
152
  </tag>
153
  </docblock>
154
- <argument line="162">
155
  <name>$tpl</name>
156
  <default><![CDATA[]]></default>
157
  <type/>
158
  </argument>
159
  </method>
160
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="204" package="Media Library Assistant">
161
  <name>mla_count_list_table_items</name>
162
  <full_name>mla_count_list_table_items</full_name>
163
- <docblock line="195">
164
  <description><![CDATA[Get the total number of attachment posts]]></description>
165
  <long-description><![CDATA[]]></long-description>
166
- <tag line="195" name="since" description="0.30"/>
167
- <tag line="195" name="param" description="Query variables, e.g., from $_REQUEST" type="array" variable="$request">
168
  <type by_reference="false">array</type>
169
  </tag>
170
- <tag line="195" name="return" description="Number of attachment posts" type="integer">
171
  <type by_reference="false">integer</type>
172
  </tag>
173
  </docblock>
174
- <argument line="204">
175
  <name>$request</name>
176
  <default><![CDATA[]]></default>
177
  <type/>
178
  </argument>
179
  </method>
180
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="225" package="Media Library Assistant">
181
  <name>mla_query_list_table_items</name>
182
  <full_name>mla_query_list_table_items</full_name>
183
- <docblock line="211">
184
  <description><![CDATA[Retrieve attachment objects for list table display]]></description>
185
  <long-description><![CDATA[<p>Supports prepare_items in class-mla-list-table.php.
186
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
187
- <tag line="211" name="since" description="0.1"/>
188
- <tag line="211" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
189
  <type by_reference="false">array</type>
190
  </tag>
191
- <tag line="211" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
192
  <type by_reference="false">int</type>
193
  </tag>
194
- <tag line="211" name="param" description="number of rows on each page" type="int" variable="$count">
195
  <type by_reference="false">int</type>
196
  </tag>
197
- <tag line="211" name="return" description="attachment objects (posts) including parent data, meta data and references" type="array">
198
  <type by_reference="false">array</type>
199
  </tag>
200
  </docblock>
201
- <argument line="225">
202
  <name>$request</name>
203
  <default><![CDATA[]]></default>
204
  <type/>
205
  </argument>
206
- <argument line="225">
207
  <name>$offset</name>
208
  <default><![CDATA[]]></default>
209
  <type/>
210
  </argument>
211
- <argument line="225">
212
  <name>$count</name>
213
  <default><![CDATA[]]></default>
214
  <type/>
215
  </argument>
216
  </method>
217
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="283" package="Media Library Assistant">
218
  <name>_prepare_list_table_query</name>
219
  <full_name>_prepare_list_table_query</full_name>
220
- <docblock line="269">
221
  <description><![CDATA[Sanitize and expand query arguments from request variables]]></description>
222
  <long-description><![CDATA[<p>Prepare the arguments for WP_Query.
223
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
224
- <tag line="269" name="since" description="0.1"/>
225
- <tag line="269" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$raw_request">
226
  <type by_reference="false">array</type>
227
  </tag>
228
- <tag line="269" name="param" description="Optional number of rows (default 0) to skip over to reach desired page" type="int" variable="$offset">
229
  <type by_reference="false">int</type>
230
  </tag>
231
- <tag line="269" name="param" description="Optional number of rows on each page (0 = all rows, default)" type="int" variable="$count">
232
  <type by_reference="false">int</type>
233
  </tag>
234
- <tag line="269" name="return" description="revised arguments suitable for WP_Query" type="array">
235
  <type by_reference="false">array</type>
236
  </tag>
237
  </docblock>
238
- <argument line="283">
239
  <name>$raw_request</name>
240
  <default><![CDATA[]]></default>
241
  <type/>
242
  </argument>
243
- <argument line="283">
244
  <name>$offset</name>
245
  <default><![CDATA[0]]></default>
246
  <type/>
247
  </argument>
248
- <argument line="283">
249
  <name>$count</name>
250
  <default><![CDATA[0]]></default>
251
  <type/>
252
  </argument>
253
  </method>
254
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="504" package="Media Library Assistant">
255
  <name>_execute_list_table_query</name>
256
  <full_name>_execute_list_table_query</full_name>
257
- <docblock line="495">
258
  <description><![CDATA[Add filters, run query, remove filters]]></description>
259
  <long-description><![CDATA[]]></long-description>
260
- <tag line="495" name="since" description="0.30"/>
261
- <tag line="495" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
262
  <type by_reference="false">array</type>
263
  </tag>
264
- <tag line="495" name="return" description="WP_Query object with query results" type="object">
265
  <type by_reference="false">object</type>
266
  </tag>
267
  </docblock>
268
- <argument line="504">
269
  <name>$request</name>
270
  <default><![CDATA[]]></default>
271
  <type/>
272
  </argument>
273
  </method>
274
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="532" package="Media Library Assistant">
275
  <name>mla_query_posts_search_filter</name>
276
  <full_name>mla_query_posts_search_filter</full_name>
277
- <docblock line="520">
278
  <description><![CDATA[Adds a keyword search to the WHERE clause, if required]]></description>
279
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
280
- <tag line="520" name="since" description="0.60"/>
281
- <tag line="520" name="param" description="query clause before modification" type="string" variable="$search_string">
282
  <type by_reference="false">string</type>
283
  </tag>
284
- <tag line="520" name="param" description="WP_Query object" type="object" variable="$query_object">
285
  <type by_reference="false">object</type>
286
  </tag>
287
- <tag line="520" name="return" description="query clause after keyword search addition" type="string">
288
  <type by_reference="false">string</type>
289
  </tag>
290
  </docblock>
291
- <argument line="532">
292
  <name>$search_string</name>
293
  <default><![CDATA[]]></default>
294
  <type/>
295
  </argument>
296
- <argument line="532">
297
  <name>$query_object</name>
298
  <default><![CDATA[]]></default>
299
  <type/>
300
  </argument>
301
  </method>
302
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="605" package="Media Library Assistant">
303
  <name>mla_query_posts_join_filter</name>
304
  <full_name>mla_query_posts_join_filter</full_name>
305
- <docblock line="594">
306
- <description><![CDATA[Adds a JOIN clause, if required]]></description>
307
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
308
- <tag line="594" name="since" description="0.30"/>
309
- <tag line="594" name="param" description="query clause before modification" type="string" variable="$join_clause">
310
  <type by_reference="false">string</type>
311
  </tag>
312
- <tag line="594" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
313
  <type by_reference="false">string</type>
314
  </tag>
315
  </docblock>
316
- <argument line="605">
317
  <name>$join_clause</name>
318
  <default><![CDATA[]]></default>
319
  <type/>
320
  </argument>
321
  </method>
322
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="634" package="Media Library Assistant">
323
  <name>mla_query_posts_where_filter</name>
324
  <full_name>mla_query_posts_where_filter</full_name>
325
- <docblock line="622">
326
  <description><![CDATA[Adds a WHERE clause for detached items]]></description>
327
  <long-description><![CDATA[<p>Modeled after _edit_attachments_query_helper in wp-admin/post.php.
328
  Defined as public because it's a filter.</p>]]></long-description>
329
- <tag line="622" name="since" description="0.1"/>
330
- <tag line="622" name="param" description="query clause before modification" type="string" variable="$where_clause">
331
  <type by_reference="false">string</type>
332
  </tag>
333
- <tag line="622" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
334
  <type by_reference="false">string</type>
335
  </tag>
336
  </docblock>
337
- <argument line="634">
338
  <name>$where_clause</name>
339
  <default><![CDATA[]]></default>
340
  <type/>
341
  </argument>
342
  </method>
343
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="655" package="Media Library Assistant">
344
  <name>mla_query_posts_orderby_filter</name>
345
  <full_name>mla_query_posts_orderby_filter</full_name>
346
- <docblock line="643">
347
  <description><![CDATA[Adds a ORDERBY clause, if required]]></description>
348
  <long-description><![CDATA[<p>Expands the range of sort options because the logic in WP_Query is limited.
349
  Defined as public because it's a filter.</p>]]></long-description>
350
- <tag line="643" name="since" description="0.30"/>
351
- <tag line="643" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
352
  <type by_reference="false">string</type>
353
  </tag>
354
- <tag line="643" name="return" description="updated query clause" type="string">
355
  <type by_reference="false">string</type>
356
  </tag>
357
  </docblock>
358
- <argument line="655">
359
  <name>$orderby_clause</name>
360
  <default><![CDATA[]]></default>
361
  <type/>
362
  </argument>
363
  </method>
364
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="707" package="Media Library Assistant">
365
  <name>mla_get_attachment_by_id</name>
366
  <full_name>mla_get_attachment_by_id</full_name>
367
- <docblock line="696">
368
  <description><![CDATA[Retrieve an Attachment array given a $post_id]]></description>
369
  <long-description><![CDATA[<p>The (associative) array will contain every field that can be found in
370
  the posts and postmeta tables, and all references to the attachment.</p>]]></long-description>
371
- <tag line="696" name="since" description="0.1"/>
372
- <tag line="696" name="param" description="The ID of the attachment post" type="int" variable="$post_id">
 
373
  <type by_reference="false">int</type>
374
  </tag>
375
- <tag line="696" name="return" description="NULL on failure else associative array" type="NULL|array">
376
  <type by_reference="false">NULL</type>
377
  <type by_reference="false">array</type>
378
  </tag>
379
  </docblock>
380
- <argument line="707">
381
  <name>$post_id</name>
382
  <default><![CDATA[]]></default>
383
  <type/>
384
  </argument>
385
  </method>
386
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="756" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
387
  <name>mla_fetch_attachment_references</name>
388
  <full_name>mla_fetch_attachment_references</full_name>
389
- <docblock line="743">
390
  <description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
391
  <long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
392
  as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
393
- <tag line="743" name="since" description="0.1"/>
394
- <tag line="743" name="param" description="post ID of attachment" type="int" variable="$ID">
395
  <type by_reference="false">int</type>
396
  </tag>
397
- <tag line="743" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent">
398
  <type by_reference="false">int</type>
399
  </tag>
400
- <tag line="743" name="return" description="Reference information; see $references array comments" type="array">
401
  <type by_reference="false">array</type>
402
  </tag>
403
  </docblock>
404
- <argument line="756">
405
  <name>$ID</name>
406
  <default><![CDATA[]]></default>
407
  <type/>
408
  </argument>
409
- <argument line="756">
410
  <name>$parent</name>
411
  <default><![CDATA[]]></default>
412
  <type/>
413
  </argument>
414
  </method>
415
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1031" package="Media Library Assistant">
416
  <name>mla_flush_mla_galleries</name>
417
  <full_name>mla_flush_mla_galleries</full_name>
418
- <docblock line="1022">
419
  <description><![CDATA[Invalidates the $mla_galleries or $galleries array and cached values]]></description>
420
  <long-description><![CDATA[]]></long-description>
421
- <tag line="1022" name="since" description="1.00"/>
422
- <tag line="1022" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
423
  <type by_reference="false">string</type>
424
  </tag>
425
- <tag line="1022" name="return" description="" type="void">
426
  <type by_reference="false">void</type>
427
  </tag>
428
  </docblock>
429
- <argument line="1031">
430
  <name>$option_name</name>
431
  <default><![CDATA[]]></default>
432
  <type/>
433
  </argument>
434
  </method>
435
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1055" package="Media Library Assistant">
436
  <name>mla_save_post_action</name>
437
  <full_name>mla_save_post_action</full_name>
438
- <docblock line="1046">
439
  <description><![CDATA[Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates]]></description>
440
  <long-description><![CDATA[]]></long-description>
441
- <tag line="1046" name="since" description="1.00"/>
442
- <tag line="1046" name="param" description="ID of post/page/attachment; not used at this time" type="integer" variable="$post_id">
443
  <type by_reference="false">integer</type>
444
  </tag>
445
- <tag line="1046" name="return" description="" type="void">
446
  <type by_reference="false">void</type>
447
  </tag>
448
  </docblock>
449
- <argument line="1055">
450
  <name>$post_id</name>
451
  <default><![CDATA[]]></default>
452
  <type/>
453
  </argument>
454
  </method>
455
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1072" package="Media Library Assistant">
456
  <name>_build_mla_galleries</name>
457
  <full_name>_build_mla_galleries</full_name>
458
- <docblock line="1060">
459
  <description><![CDATA[Builds the $mla_galleries or $galleries array]]></description>
460
  <long-description><![CDATA[]]></long-description>
461
- <tag line="1060" name="since" description="0.70"/>
462
- <tag line="1060" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
463
  <type by_reference="false">string</type>
464
  </tag>
465
- <tag line="1060" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
466
  <type by_reference="false">array</type>
467
  </tag>
468
- <tag line="1060" name="param" description="the shortcode to be searched for and processed" type="string" variable="$shortcode">
469
  <type by_reference="false">string</type>
470
  </tag>
471
- <tag line="1060" name="param" description="true to exclude revisions from the search" type="boolean" variable="$exclude_revisions">
472
  <type by_reference="false">boolean</type>
473
  </tag>
474
- <tag line="1060" name="return" description="true if the galleries array is not empty" type="boolean">
475
  <type by_reference="false">boolean</type>
476
  </tag>
477
  </docblock>
478
- <argument line="1072">
479
  <name>$option_name</name>
480
  <default><![CDATA[]]></default>
481
  <type/>
482
  </argument>
483
- <argument line="1072">
484
  <name>$galleries_array</name>
485
  <default><![CDATA[]]></default>
486
  <type/>
487
  </argument>
488
- <argument line="1072">
489
  <name>$shortcode</name>
490
  <default><![CDATA[]]></default>
491
  <type/>
492
  </argument>
493
- <argument line="1072">
494
  <name>$exclude_revisions</name>
495
  <default><![CDATA[]]></default>
496
  <type/>
497
  </argument>
498
  </method>
499
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1177" package="Media Library Assistant">
500
  <name>_search_mla_galleries</name>
501
  <full_name>_search_mla_galleries</full_name>
502
- <docblock line="1166">
503
  <description><![CDATA[Search the $mla_galleries or $galleries array]]></description>
504
  <long-description><![CDATA[]]></long-description>
505
- <tag line="1166" name="since" description="0.70"/>
506
- <tag line="1166" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
507
  <type by_reference="false">array</type>
508
  </tag>
509
- <tag line="1166" name="param" description="the attachment ID to be searched for and processed" type="int" variable="$attachment_id">
510
  <type by_reference="false">int</type>
511
  </tag>
512
- <tag line="1166" name="return" description="All posts/pages with one or more galleries that include the attachment. The array key is the parent_post ID; each entry contains post_title and post_type." type="array">
513
  <type by_reference="false">array</type>
514
  </tag>
515
  </docblock>
516
- <argument line="1177">
517
  <name>$galleries_array</name>
518
  <default><![CDATA[]]></default>
519
  <type/>
520
  </argument>
521
- <argument line="1177">
522
  <name>$attachment_id</name>
523
  <default><![CDATA[]]></default>
524
  <type/>
525
  </argument>
526
  </method>
527
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1199" package="Media Library Assistant">
528
- <name>mla_fetch_attachment_parent_data</name>
529
- <full_name>mla_fetch_attachment_parent_data</full_name>
530
- <docblock line="1190">
531
- <description><![CDATA[Returns information about an attachment's parent, if found]]></description>
532
- <long-description><![CDATA[]]></long-description>
533
- <tag line="1190" name="since" description="0.1"/>
534
- <tag line="1190" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent_id">
535
- <type by_reference="false">int</type>
536
- </tag>
537
- <tag line="1190" name="return" description="Parent information; post_date, post_title and post_type" type="array">
538
- <type by_reference="false">array</type>
539
- </tag>
540
- </docblock>
541
- <argument line="1199">
542
- <name>$parent_id</name>
543
- <default><![CDATA[]]></default>
544
- <type/>
545
- </argument>
546
- </method>
547
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1226" package="Media Library Assistant">
548
  <name>mla_fetch_attachment_image_metadata</name>
549
  <full_name>mla_fetch_attachment_image_metadata</full_name>
550
- <docblock line="1214">
551
  <description><![CDATA[Fetch and filter IPTC and EXIF meta data for an image attachment]]></description>
552
  <long-description><![CDATA[<p>Returns</p>]]></long-description>
553
- <tag line="1214" name="since" description="0.90"/>
554
- <tag line="1214" name="param" description="post ID of attachment" type="int" variable="$post_id">
555
  <type by_reference="false">int</type>
556
  </tag>
557
- <tag line="1214" name="param" description="optional; if $post_id is zero, path to the image file." type="string" variable="$path">
558
  <type by_reference="false">string</type>
559
  </tag>
560
- <tag line="1214" name="return" description="Meta data variables" type="array">
561
  <type by_reference="false">array</type>
562
  </tag>
563
  </docblock>
564
- <argument line="1226">
565
  <name>$post_id</name>
566
  <default><![CDATA[]]></default>
567
  <type/>
568
  </argument>
569
- <argument line="1226">
570
  <name>$path</name>
571
  <default><![CDATA['']]></default>
572
  <type/>
573
  </argument>
574
  </method>
575
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1283" package="Media Library Assistant">
576
- <name>mla_fetch_attachment_metadata</name>
577
- <full_name>mla_fetch_attachment_metadata</full_name>
578
- <docblock line="1270">
579
- <description><![CDATA[Fetch and filter meta data for an attachment]]></description>
580
- <long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
581
- are stripped out or converted to an 'mla</em>' equivalent. Array data is replaced with
582
- a string containing the first array element.</p>]]></long-description>
583
- <tag line="1270" name="since" description="0.1"/>
584
- <tag line="1270" name="param" description="post ID of attachment" type="int" variable="$post_id">
585
- <type by_reference="false">int</type>
586
- </tag>
587
- <tag line="1270" name="return" description="Meta data variables" type="array">
588
- <type by_reference="false">array</type>
589
- </tag>
590
- </docblock>
591
- <argument line="1283">
592
- <name>$post_id</name>
593
- <default><![CDATA[]]></default>
594
- <type/>
595
- </argument>
596
- </method>
597
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1334" package="Media Library Assistant">
598
  <name>mla_update_single_item</name>
599
  <full_name>mla_update_single_item</full_name>
600
- <docblock line="1321">
601
  <description><![CDATA[Update a single item; change the meta data
602
  for a single attachment.]]></description>
603
  <long-description><![CDATA[]]></long-description>
604
- <tag line="1321" name="since" description="0.1"/>
605
- <tag line="1321" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
606
  <type by_reference="false">int</type>
607
  </tag>
608
- <tag line="1321" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_data">
609
  <type by_reference="false">array</type>
610
  </tag>
611
- <tag line="1321" name="param" description="Optional taxonomy term values, default null" type="array" variable="$tax_input">
612
  <type by_reference="false">array</type>
613
  </tag>
614
- <tag line="1321" name="param" description="Optional taxonomy actions (add, remove, replace), default null" type="array" variable="$tax_actions">
615
  <type by_reference="false">array</type>
616
  </tag>
617
- <tag line="1321" name="return" description="success/failure message and NULL content" type="array">
618
  <type by_reference="false">array</type>
619
  </tag>
620
  </docblock>
621
- <argument line="1334">
622
  <name>$post_id</name>
623
  <default><![CDATA[]]></default>
624
  <type/>
625
  </argument>
626
- <argument line="1334">
627
  <name>$new_data</name>
628
  <default><![CDATA[]]></default>
629
  <type/>
630
  </argument>
631
- <argument line="1334">
632
  <name>$tax_input</name>
633
  <default><![CDATA[NULL]]></default>
634
  <type/>
635
  </argument>
636
- <argument line="1334">
637
  <name>$tax_actions</name>
638
  <default><![CDATA[NULL]]></default>
639
  <type/>
640
  </argument>
641
  </method>
642
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1549" package="Media Library Assistant">
643
  <name>_remove_tags</name>
644
  <full_name>_remove_tags</full_name>
645
- <docblock line="1538">
646
  <description><![CDATA[Remove tags from a term ids list]]></description>
647
  <long-description><![CDATA[]]></long-description>
648
- <tag line="1538" name="since" description="0.40"/>
649
- <tag line="1538" name="param" description="The term ids currently assigned" type="array" variable="$terms_before">
650
  <type by_reference="false">array</type>
651
  </tag>
652
- <tag line="1538" name="param" description="| string The term ids (array) or names (string) to remove" type="array" variable="$tags">
653
  <type by_reference="false">array</type>
654
  </tag>
655
- <tag line="1538" name="param" description="The taxonomy object" type="object" variable="$taxonomy_obj">
656
  <type by_reference="false">object</type>
657
  </tag>
658
- <tag line="1538" name="return" description="Term ids of the surviving tags" type="array">
659
  <type by_reference="false">array</type>
660
  </tag>
661
  </docblock>
662
- <argument line="1549">
663
  <name>$terms_before</name>
664
  <default><![CDATA[]]></default>
665
  <type/>
666
  </argument>
667
- <argument line="1549">
668
  <name>$tags</name>
669
  <default><![CDATA[]]></default>
670
  <type/>
671
  </argument>
672
- <argument line="1549">
673
  <name>$taxonomy_obj</name>
674
  <default><![CDATA[]]></default>
675
  <type/>
676
  </argument>
677
  </method>
678
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1593" package="Media Library Assistant">
679
  <name>_hex_dump</name>
680
  <full_name>_hex_dump</full_name>
681
- <docblock line="1582">
682
  <description><![CDATA[Format printable version of binary data]]></description>
683
  <long-description><![CDATA[]]></long-description>
684
- <tag line="1582" name="since" description="0.90"/>
685
- <tag line="1582" name="param" description="Binary data" type="string" variable="$data">
686
  <type by_reference="false">string</type>
687
  </tag>
688
- <tag line="1582" name="param" description="Bytes to format, default = 0 (all bytes)" type="integer" variable="$limit">
689
  <type by_reference="false">integer</type>
690
  </tag>
691
- <tag line="1582" name="param" description="Bytes to format on each line" type="\intger" variable="$bytes_per_row">
692
  <type by_reference="false">\intger</type>
693
  </tag>
694
- <tag line="1582" name="return" description="Printable representation of $data" type="string">
695
  <type by_reference="false">string</type>
696
  </tag>
697
  </docblock>
698
- <argument line="1593">
699
  <name>$data</name>
700
  <default><![CDATA[]]></default>
701
  <type/>
702
  </argument>
703
- <argument line="1593">
704
  <name>$limit</name>
705
  <default><![CDATA[0]]></default>
706
  <type/>
707
  </argument>
708
- <argument line="1593">
709
  <name>$bytes_per_row</name>
710
  <default><![CDATA[16]]></default>
711
  <type/>
@@ -713,7 +736,7 @@ for a single attachment.]]></description>
713
  </method>
714
  </class>
715
  </file>
716
- <file path="includes\class-mla-edit-media.php" hash="7857a4c937bb5b6230ec7c8fd4915785" package="Media Library Assistant">
717
  <docblock line="2">
718
  <description><![CDATA[Media Library Assistant Edit Media screen enhancements]]></description>
719
  <long-description><![CDATA[]]></long-description>
@@ -730,15 +753,15 @@ for a single attachment.]]></description>
730
  <tag line="9" name="package" description="Media Library Assistant"/>
731
  <tag line="9" name="since" description="0.80"/>
732
  </docblock>
733
- <property final="false" static="true" visibility="private" line="164" namespace="global" package="Media Library Assistant">
734
  <name>$mla_references</name>
735
  <default><![CDATA[null]]></default>
736
- <docblock line="154">
737
  <description><![CDATA[Where-used values for the current item]]></description>
738
  <long-description><![CDATA[<p>This array contains the Featured/Inserted/Gallery/MLA Gallery references for the item.
739
  The array is built once each page load and cached for subsequent calls.</p>]]></long-description>
740
- <tag line="154" name="since" description="0.80"/>
741
- <tag line="154" name="var" description="" type="array">
742
  <type by_reference="false">array</type>
743
  </tag>
744
  </docblock>
@@ -755,241 +778,261 @@ The array is built once each page load and cached for subsequent calls.</p>]]></
755
  </tag>
756
  </docblock>
757
  </method>
758
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="52" package="Media Library Assistant">
759
  <name>mla_custom_field_support_action</name>
760
  <full_name>mla_custom_field_support_action</full_name>
761
- <docblock line="44">
762
  <description><![CDATA[Adds Custom Field support to the Edit Media screen.]]></description>
763
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
764
- <tag line="44" name="since" description="0.80"/>
765
- <tag line="44" name="return" description="echoes the HTML markup for the label and value" type="void">
766
  <type by_reference="false">void</type>
767
  </tag>
768
  </docblock>
769
  </method>
770
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="64" package="Media Library Assistant">
771
- <name>mla_last_modified_action</name>
772
- <full_name>mla_last_modified_action</full_name>
773
- <docblock line="56">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
774
  <description><![CDATA[Adds Last Modified date to the Submit box on the Edit Media screen.]]></description>
775
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
776
- <tag line="56" name="since" description="0.80"/>
777
- <tag line="56" name="return" description="echoes the HTML markup for the label and value" type="void">
778
  <type by_reference="false">void</type>
779
  </tag>
780
  </docblock>
781
  </method>
782
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="86" package="Media Library Assistant">
783
  <name>mla_add_meta_boxes_action</name>
784
  <full_name>mla_add_meta_boxes_action</full_name>
785
- <docblock line="75">
786
  <description><![CDATA[Registers meta boxes for the Edit Media screen.]]></description>
787
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
788
- <tag line="75" name="since" description="0.80"/>
789
- <tag line="75" name="param" description="type of the current post, e.g., 'attachment'" type="string" variable="$post_type">
790
  <type by_reference="false">string</type>
791
  </tag>
792
- <tag line="75" name="param" description="current post" type="object" variable="$post">
793
  <type by_reference="false">object</type>
794
  </tag>
795
- <tag line="75" name="return" description="" type="void">
796
  <type by_reference="false">void</type>
797
  </tag>
798
  </docblock>
799
- <argument line="86">
800
  <name>$post_type</name>
801
  <default><![CDATA[]]></default>
802
  <type/>
803
  </argument>
804
- <argument line="86">
805
  <name>$post</name>
806
  <default><![CDATA[]]></default>
807
  <type/>
808
  </argument>
809
  </method>
810
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="116" package="Media Library Assistant">
811
  <name>mla_edit_add_help_tab</name>
812
  <full_name>mla_edit_add_help_tab</full_name>
813
- <docblock line="106">
814
  <description><![CDATA[Add contextual help tabs to the WordPress Edit Media page]]></description>
815
  <long-description><![CDATA[]]></long-description>
816
- <tag line="106" name="since" description="0.90"/>
817
- <tag line="106" name="param" description="title as shown on the screen" type="string" variable="$admin_title">
818
  <type by_reference="false">string</type>
819
  </tag>
820
- <tag line="106" name="param" description="title as shown in the HTML header" type="string" variable="$title">
821
  <type by_reference="false">string</type>
822
  </tag>
823
- <tag line="106" name="return" description="" type="void">
824
  <type by_reference="false">void</type>
825
  </tag>
826
  </docblock>
827
- <argument line="116">
828
  <name>$admin_title</name>
829
  <default><![CDATA[]]></default>
830
  <type/>
831
  </argument>
832
- <argument line="116">
833
  <name>$title</name>
834
  <default><![CDATA[]]></default>
835
  <type/>
836
  </argument>
837
  </method>
838
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="176" package="Media Library Assistant">
839
  <name>mla_parent_info_handler</name>
840
  <full_name>mla_parent_info_handler</full_name>
841
- <docblock line="166">
842
  <description><![CDATA[Renders the Parent Info meta box on the Edit Media page.]]></description>
843
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
844
- <tag line="166" name="since" description="0.80"/>
845
- <tag line="166" name="param" description="current post" type="object" variable="$post">
846
  <type by_reference="false">object</type>
847
  </tag>
848
- <tag line="166" name="return" description="echoes the HTML markup for the meta box content" type="void">
849
  <type by_reference="false">void</type>
850
  </tag>
851
  </docblock>
852
- <argument line="176">
853
  <name>$post</name>
854
  <default><![CDATA[]]></default>
855
  <type/>
856
  </argument>
857
  </method>
858
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="201" package="Media Library Assistant">
859
  <name>mla_menu_order_handler</name>
860
  <full_name>mla_menu_order_handler</full_name>
861
- <docblock line="191">
862
  <description><![CDATA[Renders the Menu Order meta box on the Edit Media page.]]></description>
863
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
864
- <tag line="191" name="since" description="0.80"/>
865
- <tag line="191" name="param" description="current post" type="object" variable="$post">
866
  <type by_reference="false">object</type>
867
  </tag>
868
- <tag line="191" name="return" description="echoes the HTML markup for the meta box content" type="void">
869
  <type by_reference="false">void</type>
870
  </tag>
871
  </docblock>
872
- <argument line="201">
873
  <name>$post</name>
874
  <default><![CDATA[]]></default>
875
  <type/>
876
  </argument>
877
  </method>
878
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="216" package="Media Library Assistant">
879
  <name>mla_image_metadata_handler</name>
880
  <full_name>mla_image_metadata_handler</full_name>
881
- <docblock line="206">
882
  <description><![CDATA[Renders the Image Metadata meta box on the Edit Media page.]]></description>
883
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
884
- <tag line="206" name="since" description="0.80"/>
885
- <tag line="206" name="param" description="current post" type="object" variable="$post">
886
  <type by_reference="false">object</type>
887
  </tag>
888
- <tag line="206" name="return" description="echoes the HTML markup for the meta box content" type="void">
889
  <type by_reference="false">void</type>
890
  </tag>
891
  </docblock>
892
- <argument line="216">
893
  <name>$post</name>
894
  <default><![CDATA[]]></default>
895
  <type/>
896
  </argument>
897
  </method>
898
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="243" package="Media Library Assistant">
899
  <name>mla_featured_in_handler</name>
900
  <full_name>mla_featured_in_handler</full_name>
901
- <docblock line="233">
902
  <description><![CDATA[Renders the Featured in meta box on the Edit Media page.]]></description>
903
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
904
- <tag line="233" name="since" description="0.80"/>
905
- <tag line="233" name="param" description="current post" type="object" variable="$post">
906
  <type by_reference="false">object</type>
907
  </tag>
908
- <tag line="233" name="return" description="echoes the HTML markup for the meta box content" type="void">
909
  <type by_reference="false">void</type>
910
  </tag>
911
  </docblock>
912
- <argument line="243">
913
  <name>$post</name>
914
  <default><![CDATA[]]></default>
915
  <type/>
916
  </argument>
917
  </method>
918
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="273" package="Media Library Assistant">
919
  <name>mla_inserted_in_handler</name>
920
  <full_name>mla_inserted_in_handler</full_name>
921
- <docblock line="263">
922
  <description><![CDATA[Renders the Inserted in meta box on the Edit Media page.]]></description>
923
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
924
- <tag line="263" name="since" description="0.80"/>
925
- <tag line="263" name="param" description="current post" type="object" variable="$post">
926
  <type by_reference="false">object</type>
927
  </tag>
928
- <tag line="263" name="return" description="echoes the HTML markup for the meta box content" type="void">
929
  <type by_reference="false">void</type>
930
  </tag>
931
  </docblock>
932
- <argument line="273">
933
  <name>$post</name>
934
  <default><![CDATA[]]></default>
935
  <type/>
936
  </argument>
937
  </method>
938
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="307" package="Media Library Assistant">
939
  <name>mla_gallery_in_handler</name>
940
  <full_name>mla_gallery_in_handler</full_name>
941
- <docblock line="297">
942
  <description><![CDATA[Renders the Gallery in meta box on the Edit Media page.]]></description>
943
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
944
- <tag line="297" name="since" description="0.80"/>
945
- <tag line="297" name="param" description="current post" type="object" variable="$post">
946
  <type by_reference="false">object</type>
947
  </tag>
948
- <tag line="297" name="return" description="echoes the HTML markup for the meta box content" type="void">
949
  <type by_reference="false">void</type>
950
  </tag>
951
  </docblock>
952
- <argument line="307">
953
  <name>$post</name>
954
  <default><![CDATA[]]></default>
955
  <type/>
956
  </argument>
957
  </method>
958
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="337" package="Media Library Assistant">
959
  <name>mla_mla_gallery_in_handler</name>
960
  <full_name>mla_mla_gallery_in_handler</full_name>
961
- <docblock line="327">
962
  <description><![CDATA[Renders the Gallery in meta box on the Edit Media page.]]></description>
963
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
964
- <tag line="327" name="since" description="0.80"/>
965
- <tag line="327" name="param" description="current post" type="object" variable="$post">
966
  <type by_reference="false">object</type>
967
  </tag>
968
- <tag line="327" name="return" description="echoes the HTML markup for the meta box content" type="void">
969
  <type by_reference="false">void</type>
970
  </tag>
971
  </docblock>
972
- <argument line="337">
973
  <name>$post</name>
974
  <default><![CDATA[]]></default>
975
  <type/>
976
  </argument>
977
  </method>
978
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="367" package="Media Library Assistant">
979
  <name>mla_edit_attachment_action</name>
980
  <full_name>mla_edit_attachment_action</full_name>
981
- <docblock line="357">
982
  <description><![CDATA[Saves updates from the Edit Media screen.]]></description>
983
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
984
- <tag line="357" name="since" description="0.80"/>
985
- <tag line="357" name="param" description="ID of the current post" type="integer" variable="$post_ID">
986
  <type by_reference="false">integer</type>
987
  </tag>
988
- <tag line="357" name="return" description="" type="void">
989
  <type by_reference="false">void</type>
990
  </tag>
991
  </docblock>
992
- <argument line="367">
993
  <name>$post_ID</name>
994
  <default><![CDATA[]]></default>
995
  <type/>
@@ -997,7 +1040,7 @@ The array is built once each page load and cached for subsequent calls.</p>]]></
997
  </method>
998
  </class>
999
  </file>
1000
- <file path="includes\class-mla-list-table.php" hash="eb1bd1eed3466725fb73b49bc03d39a3" package="Media Library Assistant">
1001
  <docblock line="2">
1002
  <description><![CDATA[Media Library Assistant extended List Table class]]></description>
1003
  <long-description><![CDATA[]]></long-description>
@@ -1041,7 +1084,7 @@ The array is built once each page load and cached for subsequent calls.</p>]]></
1041
  </tag>
1042
  </docblock>
1043
  </property>
1044
- <property final="false" static="true" visibility="private" line="72" namespace="global" package="Media Library Assistant">
1045
  <name>$default_columns</name>
1046
  <default><![CDATA[array('cb' => '<input type="checkbox" />', 'icon' => '', 'ID_parent' => 'ID/Parent', 'title_name' => 'Title/Name', 'post_title' => 'Title', 'post_name' => 'Name', 'parent' => 'Parent ID', 'menu_order' => 'Menu Order', 'featured' => 'Featured in', 'inserted' => 'Inserted in', 'galleries' => 'Gallery in', 'mla_galleries' => 'MLA Gallery in', 'alt_text' => 'ALT Text', 'caption' => 'Caption', 'description' => 'Description', 'post_mime_type' => 'MIME Type', 'base_file' => 'Base File', 'date' => 'Date', 'modified' => 'Last Modified', 'author' => 'Author', 'attached_to' => 'Attached to')]]></default>
1047
  <docblock line="55">
@@ -1054,17 +1097,18 @@ use the special slug "cb".</p>
1054
  column in your table you must create a column_cb() method. If you don't need
1055
  bulk actions or checkboxes, simply leave the 'cb' entry out of your array.</p>
1056
 
1057
- <p>Taxonomy columns are added to this array by mla_admin_init_action.</p>]]></long-description>
 
1058
  <tag line="55" name="since" description="0.1"/>
1059
  <tag line="55" name="var" description="" type="array">
1060
  <type by_reference="false">array</type>
1061
  </tag>
1062
  </docblock>
1063
  </property>
1064
- <property final="false" static="true" visibility="private" line="112" namespace="global" package="Media Library Assistant">
1065
  <name>$default_hidden_columns</name>
1066
  <default><![CDATA[array('post_title', 'post_name', 'parent', 'menu_order', 'galleries', 'mla_galleries', 'alt_text', 'caption', 'description', 'post_mime_type', 'base_file', 'date', 'modified', 'author', 'attached_to')]]></default>
1067
- <docblock line="97">
1068
  <description><![CDATA[Default values for hidden columns]]></description>
1069
  <long-description><![CDATA[<p>This array is used when the user-level option is not set, i.e.,
1070
  the user has not altered the selection of hidden columns.</p>
@@ -1072,17 +1116,18 @@ the user has not altered the selection of hidden columns.</p>
1072
  <p>The value on the right-hand side must match the column slug, e.g.,
1073
  array(0 => 'ID_parent, 1 => 'title_name').</p>
1074
 
1075
- <p>Taxonomy columns are added to this array by mla_admin_init_action.</p>]]></long-description>
1076
- <tag line="97" name="since" description="0.1"/>
1077
- <tag line="97" name="var" description="" type="array">
 
1078
  <type by_reference="false">array</type>
1079
  </tag>
1080
  </docblock>
1081
  </property>
1082
- <property final="false" static="true" visibility="private" line="150" namespace="global" package="Media Library Assistant">
1083
  <name>$default_sortable_columns</name>
1084
  <default><![CDATA[array('ID_parent' => array('ID', false), 'title_name' => array('title_name', false), 'post_title' => array('post_title', false), 'post_name' => array('post_name', false), 'parent' => array('post_parent', false), 'menu_order' => array('menu_order', false), 'alt_text' => array('_wp_attachment_image_alt', false), 'caption' => array('post_excerpt', false), 'description' => array('post_content', false), 'post_mime_type' => array('post_mime_type', false), 'base_file' => array('_wp_attached_file', false), 'date' => array('post_date', false), 'modified' => array('post_modified', false), 'author' => array('post_author', false), 'attached_to' => array('post_parent', false))]]></default>
1085
- <docblock line="135">
1086
  <description><![CDATA[Sortable column definitions]]></description>
1087
  <long-description><![CDATA[<p>This array defines the table columns that can be sorted. The array key
1088
  is the column slug that needs to be sortable, and the value is database column
@@ -1090,763 +1135,766 @@ to sort by. Often, the key and value will be the same, but this is not always
1090
  the case (as the value is a column name from the database, not the list table).</p>
1091
 
1092
  <p>The array value also contains a boolean which is 'true' if the data is currently
1093
- sorted by that column. This is computed each time the table is displayed.</p>]]></long-description>
1094
- <tag line="135" name="since" description="0.1"/>
1095
- <tag line="135" name="var" description="" type="array">
 
 
 
1096
  <type by_reference="false">array</type>
1097
  </tag>
1098
  </docblock>
1099
  </property>
1100
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="180" package="Media Library Assistant">
1101
  <name>_default_hidden_columns</name>
1102
  <full_name>_default_hidden_columns</full_name>
1103
- <docblock line="173">
1104
  <description><![CDATA[Access the default list of hidden columns]]></description>
1105
  <long-description><![CDATA[]]></long-description>
1106
- <tag line="173" name="since" description="0.1"/>
1107
- <tag line="173" name="return" description="default list of hidden columns" type="array">
1108
  <type by_reference="false">array</type>
1109
  </tag>
1110
  </docblock>
1111
  </method>
1112
- <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="197" package="Media Library Assistant">
1113
  <name>_avail_mime_types</name>
1114
  <full_name>_avail_mime_types</full_name>
1115
- <docblock line="185">
1116
  <description><![CDATA[Get mime types with one or more attachments for view preparation]]></description>
1117
  <long-description><![CDATA[<p>Modeled after get_available_post_mime_types in wp-admin/includes/post.php,
1118
  with additional entries.</p>]]></long-description>
1119
- <tag line="185" name="since" description="0.1"/>
1120
- <tag line="185" name="param" description="Number of posts for each mime type" type="array" variable="$num_posts">
1121
  <type by_reference="false">array</type>
1122
  </tag>
1123
- <tag line="185" name="return" description="Mime type names" type="array">
1124
  <type by_reference="false">array</type>
1125
  </tag>
1126
  </docblock>
1127
- <argument line="197">
1128
  <name>$num_posts</name>
1129
  <default><![CDATA[]]></default>
1130
  <type/>
1131
  </argument>
1132
  </method>
1133
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="218" package="Media Library Assistant">
1134
  <name>mla_get_attachment_mime_types</name>
1135
  <full_name>mla_get_attachment_mime_types</full_name>
1136
- <docblock line="208">
1137
  <description><![CDATA[Get possible mime types for view preparation]]></description>
1138
- <long-description><![CDATA[<p>Modeled after get_post_mime_types in wp-admin/includes/post.php,
1139
  with additional entries.</p>]]></long-description>
1140
- <tag line="208" name="since" description="0.1"/>
1141
- <tag line="208" name="return" description="Mime type names and HTML markup for views" type="array">
1142
  <type by_reference="false">array</type>
1143
  </tag>
1144
  </docblock>
1145
  </method>
1146
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="291" package="Media Library Assistant">
1147
  <name>mla_get_sortable_columns</name>
1148
  <full_name>mla_get_sortable_columns</full_name>
1149
- <docblock line="284">
1150
  <description><![CDATA[Return the names and display values of the sortable columns]]></description>
1151
  <long-description><![CDATA[]]></long-description>
1152
- <tag line="284" name="since" description="0.30"/>
1153
- <tag line="284" name="return" description="name =&gt; array( orderby value, heading ) for sortable columns" type="array">
1154
  <type by_reference="false">array</type>
1155
  </tag>
1156
  </docblock>
1157
  </method>
1158
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="318" package="Media Library Assistant">
1159
  <name>mla_manage_hidden_columns_filter</name>
1160
  <full_name>mla_manage_hidden_columns_filter</full_name>
1161
- <docblock line="303">
1162
  <description><![CDATA[Handler for filter 'get_user_option_managemedia_page_mla-menucolumnshidden']]></description>
1163
  <long-description><![CDATA[<p>Required because the screen.php get_hidden_columns function only uses
1164
  the get_user_option result. Set when the file is loaded because the object
1165
  is not created in time for the call from screen.php.</p>]]></long-description>
1166
- <tag line="303" name="since" description="0.1"/>
1167
- <tag line="303" name="param" description="current list of hidden columns, if any" type="string" variable="$result">
1168
  <type by_reference="false">string</type>
1169
  </tag>
1170
- <tag line="303" name="param" description="'managemedia_page_mla-menucolumnshidden'" type="string" variable="$option">
1171
  <type by_reference="false">string</type>
1172
  </tag>
1173
- <tag line="303" name="param" description="WP_User object, if logged in" type="object" variable="$user_data">
1174
  <type by_reference="false">object</type>
1175
  </tag>
1176
- <tag line="303" name="return" description="updated list of hidden columns" type="array">
1177
  <type by_reference="false">array</type>
1178
  </tag>
1179
  </docblock>
1180
- <argument line="318">
1181
  <name>$result</name>
1182
  <default><![CDATA[]]></default>
1183
  <type/>
1184
  </argument>
1185
- <argument line="318">
1186
  <name>$option</name>
1187
  <default><![CDATA[]]></default>
1188
  <type/>
1189
  </argument>
1190
- <argument line="318">
1191
  <name>$user_data</name>
1192
  <default><![CDATA[]]></default>
1193
  <type/>
1194
  </argument>
1195
  </method>
1196
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="336" package="Media Library Assistant">
1197
  <name>mla_manage_columns_filter</name>
1198
  <full_name>mla_manage_columns_filter</full_name>
1199
- <docblock line="325">
1200
  <description><![CDATA[Handler for filter 'manage_media_page_mla-menu_columns']]></description>
1201
  <long-description><![CDATA[<p>This required filter dictates the table's columns and titles. Set when the
1202
  file is loaded because the list_table object isn't created in time
1203
  to affect the "screen options" setup.</p>]]></long-description>
1204
- <tag line="325" name="since" description="0.1"/>
1205
- <tag line="325" name="return" description="list of table columns" type="array">
1206
  <type by_reference="false">array</type>
1207
  </tag>
1208
  </docblock>
1209
  </method>
1210
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="351" package="Media Library Assistant">
1211
  <name>mla_admin_init_action</name>
1212
  <full_name>mla_admin_init_action</full_name>
1213
- <docblock line="341">
1214
  <description><![CDATA[Adds support for taxonomy columns]]></description>
1215
  <long-description><![CDATA[<p>Called in the admin_init action because the list_table object isn't
1216
  created in time to affect the "screen options" setup.</p>]]></long-description>
1217
- <tag line="341" name="since" description="0.30"/>
1218
- <tag line="341" name="return" description="" type="void">
1219
  <type by_reference="false">void</type>
1220
  </tag>
1221
  </docblock>
1222
  </method>
1223
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="373" package="Media Library Assistant">
1224
  <name>__construct</name>
1225
  <full_name>__construct</full_name>
1226
- <docblock line="365">
1227
  <description><![CDATA[Initializes some properties from $_REQUEST vairables, then
1228
  calls the parent constructor to set some default configs.]]></description>
1229
  <long-description><![CDATA[]]></long-description>
1230
- <tag line="365" name="since" description="0.1"/>
1231
- <tag line="365" name="return" description="" type="void">
1232
  <type by_reference="false">void</type>
1233
  </tag>
1234
  </docblock>
1235
  </method>
1236
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="406" package="Media Library Assistant">
1237
  <name>column_default</name>
1238
  <full_name>column_default</full_name>
1239
- <docblock line="393">
1240
  <description><![CDATA[Supply a column value if no column-specific function has been defined]]></description>
1241
  <long-description><![CDATA[<p>Called when the parent class can't find a method specifically built for a
1242
  given column. The taxonomy columns are handled here. All other columns should
1243
  have a specific method, so this function returns a troubleshooting message.</p>]]></long-description>
1244
- <tag line="393" name="since" description="0.1"/>
1245
- <tag line="393" name="param" description="A singular item (one full row's worth of data)" type="array" variable="$item">
1246
  <type by_reference="false">array</type>
1247
  </tag>
1248
- <tag line="393" name="param" description="The name/slug of the column to be processed" type="array" variable="$column_name">
1249
  <type by_reference="false">array</type>
1250
  </tag>
1251
- <tag line="393" name="return" description="Text or HTML to be placed inside the column" type="string">
1252
  <type by_reference="false">string</type>
1253
  </tag>
1254
  </docblock>
1255
- <argument line="406">
1256
  <name>$item</name>
1257
  <default><![CDATA[]]></default>
1258
  <type/>
1259
  </argument>
1260
- <argument line="406">
1261
  <name>$column_name</name>
1262
  <default><![CDATA[]]></default>
1263
  <type/>
1264
  </argument>
1265
  </method>
1266
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="448" package="Media Library Assistant">
1267
  <name>column_cb</name>
1268
  <full_name>column_cb</full_name>
1269
- <docblock line="439">
1270
  <description><![CDATA[Displays checkboxes for using bulk actions.]]></description>
1271
  <long-description><![CDATA[<p>The 'cb' column
1272
  is given special treatment when columns are processed.</p>]]></long-description>
1273
- <tag line="439" name="since" description="0.1"/>
1274
- <tag line="439" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1275
  <type by_reference="false">array</type>
1276
  </tag>
1277
- <tag line="439" name="return" description="HTML markup to be placed inside the column" type="string">
1278
  <type by_reference="false">string</type>
1279
  </tag>
1280
  </docblock>
1281
- <argument line="448">
1282
  <name>$item</name>
1283
  <default><![CDATA[]]></default>
1284
  <type/>
1285
  </argument>
1286
  </method>
1287
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="464" package="Media Library Assistant">
1288
  <name>column_icon</name>
1289
  <full_name>column_icon</full_name>
1290
- <docblock line="456">
1291
  <description><![CDATA[Supply the content for a custom column]]></description>
1292
  <long-description><![CDATA[]]></long-description>
1293
- <tag line="456" name="since" description="0.1"/>
1294
- <tag line="456" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1295
  <type by_reference="false">array</type>
1296
  </tag>
1297
- <tag line="456" name="return" description="HTML markup to be placed inside the column" type="string">
1298
  <type by_reference="false">string</type>
1299
  </tag>
1300
  </docblock>
1301
- <argument line="464">
1302
  <name>$item</name>
1303
  <default><![CDATA[]]></default>
1304
  <type/>
1305
  </argument>
1306
  </method>
1307
- <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="480" package="Media Library Assistant">
1308
  <name>_build_rollover_actions</name>
1309
  <full_name>_build_rollover_actions</full_name>
1310
- <docblock line="469">
1311
  <description><![CDATA[Add rollover actions to exactly one of the following displayed columns:
1312
  'ID_parent', 'title_name', 'post_title', 'post_name']]></description>
1313
  <long-description><![CDATA[]]></long-description>
1314
- <tag line="469" name="since" description="0.1"/>
1315
- <tag line="469" name="param" description="A singular attachment (post) object" type="object" variable="$item">
1316
  <type by_reference="false">object</type>
1317
  </tag>
1318
- <tag line="469" name="param" description="Current column name" type="string" variable="$column">
1319
  <type by_reference="false">string</type>
1320
  </tag>
1321
- <tag line="469" name="return" description="Names and URLs of row-level actions" type="array">
1322
  <type by_reference="false">array</type>
1323
  </tag>
1324
  </docblock>
1325
- <argument line="480">
1326
  <name>$item</name>
1327
  <default><![CDATA[]]></default>
1328
  <type/>
1329
  </argument>
1330
- <argument line="480">
1331
  <name>$column</name>
1332
  <default><![CDATA[]]></default>
1333
  <type/>
1334
  </argument>
1335
  </method>
1336
- <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="558" package="Media Library Assistant">
1337
  <name>_build_inline_data</name>
1338
  <full_name>_build_inline_data</full_name>
1339
- <docblock line="549">
1340
  <description><![CDATA[Add hidden fields with the data for use in the inline editor]]></description>
1341
  <long-description><![CDATA[]]></long-description>
1342
- <tag line="549" name="since" description="0.20"/>
1343
- <tag line="549" name="param" description="A singular attachment (post) object" type="object" variable="$item">
1344
  <type by_reference="false">object</type>
1345
  </tag>
1346
- <tag line="549" name="return" description="HTML &lt;div&gt; with row data" type="string">
1347
  <type by_reference="false">string</type>
1348
  </tag>
1349
  </docblock>
1350
- <argument line="558">
1351
  <name>$item</name>
1352
  <default><![CDATA[]]></default>
1353
  <type/>
1354
  </argument>
1355
  </method>
1356
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="599" package="Media Library Assistant">
1357
  <name>column_ID_parent</name>
1358
  <full_name>column_ID_parent</full_name>
1359
- <docblock line="591">
1360
  <description><![CDATA[Supply the content for a custom column]]></description>
1361
  <long-description><![CDATA[]]></long-description>
1362
- <tag line="591" name="since" description="0.1"/>
1363
- <tag line="591" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1364
  <type by_reference="false">array</type>
1365
  </tag>
1366
- <tag line="591" name="return" description="HTML markup to be placed inside the column" type="string">
1367
  <type by_reference="false">string</type>
1368
  </tag>
1369
  </docblock>
1370
- <argument line="599">
1371
  <name>$item</name>
1372
  <default><![CDATA[]]></default>
1373
  <type/>
1374
  </argument>
1375
  </method>
1376
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="631" package="Media Library Assistant">
1377
  <name>column_title_name</name>
1378
  <full_name>column_title_name</full_name>
1379
- <docblock line="623">
1380
  <description><![CDATA[Supply the content for a custom column]]></description>
1381
  <long-description><![CDATA[]]></long-description>
1382
- <tag line="623" name="since" description="0.1"/>
1383
- <tag line="623" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1384
  <type by_reference="false">array</type>
1385
  </tag>
1386
- <tag line="623" name="return" description="HTML markup to be placed inside the column" type="string">
1387
  <type by_reference="false">string</type>
1388
  </tag>
1389
  </docblock>
1390
- <argument line="631">
1391
  <name>$item</name>
1392
  <default><![CDATA[]]></default>
1393
  <type/>
1394
  </argument>
1395
  </method>
1396
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="654" package="Media Library Assistant">
1397
  <name>column_post_title</name>
1398
  <full_name>column_post_title</full_name>
1399
- <docblock line="646">
1400
  <description><![CDATA[Supply the content for a custom column]]></description>
1401
  <long-description><![CDATA[]]></long-description>
1402
- <tag line="646" name="since" description="0.1"/>
1403
- <tag line="646" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1404
  <type by_reference="false">array</type>
1405
  </tag>
1406
- <tag line="646" name="return" description="HTML markup to be placed inside the column" type="string">
1407
  <type by_reference="false">string</type>
1408
  </tag>
1409
  </docblock>
1410
- <argument line="654">
1411
  <name>$item</name>
1412
  <default><![CDATA[]]></default>
1413
  <type/>
1414
  </argument>
1415
  </method>
1416
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="672" package="Media Library Assistant">
1417
  <name>column_post_name</name>
1418
  <full_name>column_post_name</full_name>
1419
- <docblock line="664">
1420
  <description><![CDATA[Supply the content for a custom column]]></description>
1421
  <long-description><![CDATA[]]></long-description>
1422
- <tag line="664" name="since" description="0.1"/>
1423
- <tag line="664" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1424
  <type by_reference="false">array</type>
1425
  </tag>
1426
- <tag line="664" name="return" description="HTML markup to be placed inside the column" type="string">
1427
  <type by_reference="false">string</type>
1428
  </tag>
1429
  </docblock>
1430
- <argument line="672">
1431
  <name>$item</name>
1432
  <default><![CDATA[]]></default>
1433
  <type/>
1434
  </argument>
1435
  </method>
1436
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="690" package="Media Library Assistant">
1437
  <name>column_parent</name>
1438
  <full_name>column_parent</full_name>
1439
- <docblock line="682">
1440
  <description><![CDATA[Supply the content for a custom column]]></description>
1441
  <long-description><![CDATA[]]></long-description>
1442
- <tag line="682" name="since" description="0.1"/>
1443
- <tag line="682" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1444
  <type by_reference="false">array</type>
1445
  </tag>
1446
- <tag line="682" name="return" description="HTML markup to be placed inside the column" type="string">
1447
  <type by_reference="false">string</type>
1448
  </tag>
1449
  </docblock>
1450
- <argument line="690">
1451
  <name>$item</name>
1452
  <default><![CDATA[]]></default>
1453
  <type/>
1454
  </argument>
1455
  </method>
1456
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="715" package="Media Library Assistant">
1457
  <name>column_menu_order</name>
1458
  <full_name>column_menu_order</full_name>
1459
- <docblock line="707">
1460
  <description><![CDATA[Supply the content for a custom column]]></description>
1461
  <long-description><![CDATA[]]></long-description>
1462
- <tag line="707" name="since" description="0.60"/>
1463
- <tag line="707" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1464
  <type by_reference="false">array</type>
1465
  </tag>
1466
- <tag line="707" name="return" description="HTML markup to be placed inside the column" type="string">
1467
  <type by_reference="false">string</type>
1468
  </tag>
1469
  </docblock>
1470
- <argument line="715">
1471
  <name>$item</name>
1472
  <default><![CDATA[]]></default>
1473
  <type/>
1474
  </argument>
1475
  </method>
1476
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="727" package="Media Library Assistant">
1477
  <name>column_featured</name>
1478
  <full_name>column_featured</full_name>
1479
- <docblock line="719">
1480
  <description><![CDATA[Supply the content for a custom column]]></description>
1481
  <long-description><![CDATA[]]></long-description>
1482
- <tag line="719" name="since" description="0.1"/>
1483
- <tag line="719" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1484
  <type by_reference="false">array</type>
1485
  </tag>
1486
- <tag line="719" name="return" description="HTML markup to be placed inside the column" type="string">
1487
  <type by_reference="false">string</type>
1488
  </tag>
1489
  </docblock>
1490
- <argument line="727">
1491
  <name>$item</name>
1492
  <default><![CDATA[]]></default>
1493
  <type/>
1494
  </argument>
1495
  </method>
1496
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="758" package="Media Library Assistant">
1497
  <name>column_inserted</name>
1498
  <full_name>column_inserted</full_name>
1499
- <docblock line="750">
1500
  <description><![CDATA[Supply the content for a custom column]]></description>
1501
  <long-description><![CDATA[]]></long-description>
1502
- <tag line="750" name="since" description="0.1"/>
1503
- <tag line="750" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1504
  <type by_reference="false">array</type>
1505
  </tag>
1506
- <tag line="750" name="return" description="HTML markup to be placed inside the column" type="string">
1507
  <type by_reference="false">string</type>
1508
  </tag>
1509
  </docblock>
1510
- <argument line="758">
1511
  <name>$item</name>
1512
  <default><![CDATA[]]></default>
1513
  <type/>
1514
  </argument>
1515
  </method>
1516
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="793" package="Media Library Assistant">
1517
  <name>column_galleries</name>
1518
  <full_name>column_galleries</full_name>
1519
- <docblock line="785">
1520
  <description><![CDATA[Supply the content for a custom column]]></description>
1521
  <long-description><![CDATA[]]></long-description>
1522
- <tag line="785" name="since" description="0.70"/>
1523
- <tag line="785" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1524
  <type by_reference="false">array</type>
1525
  </tag>
1526
- <tag line="785" name="return" description="HTML markup to be placed inside the column" type="string">
1527
  <type by_reference="false">string</type>
1528
  </tag>
1529
  </docblock>
1530
- <argument line="793">
1531
  <name>$item</name>
1532
  <default><![CDATA[]]></default>
1533
  <type/>
1534
  </argument>
1535
  </method>
1536
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="824" package="Media Library Assistant">
1537
  <name>column_mla_galleries</name>
1538
  <full_name>column_mla_galleries</full_name>
1539
- <docblock line="816">
1540
  <description><![CDATA[Supply the content for a custom column]]></description>
1541
  <long-description><![CDATA[]]></long-description>
1542
- <tag line="816" name="since" description="0.70"/>
1543
- <tag line="816" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1544
  <type by_reference="false">array</type>
1545
  </tag>
1546
- <tag line="816" name="return" description="HTML markup to be placed inside the column" type="string">
1547
  <type by_reference="false">string</type>
1548
  </tag>
1549
  </docblock>
1550
- <argument line="824">
1551
  <name>$item</name>
1552
  <default><![CDATA[]]></default>
1553
  <type/>
1554
  </argument>
1555
  </method>
1556
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="855" package="Media Library Assistant">
1557
  <name>column_alt_text</name>
1558
  <full_name>column_alt_text</full_name>
1559
- <docblock line="847">
1560
  <description><![CDATA[Supply the content for a custom column]]></description>
1561
  <long-description><![CDATA[]]></long-description>
1562
- <tag line="847" name="since" description="0.1"/>
1563
- <tag line="847" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1564
  <type by_reference="false">array</type>
1565
  </tag>
1566
- <tag line="847" name="return" description="HTML markup to be placed inside the column" type="string">
1567
  <type by_reference="false">string</type>
1568
  </tag>
1569
  </docblock>
1570
- <argument line="855">
1571
  <name>$item</name>
1572
  <default><![CDATA[]]></default>
1573
  <type/>
1574
  </argument>
1575
  </method>
1576
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="870" package="Media Library Assistant">
1577
  <name>column_caption</name>
1578
  <full_name>column_caption</full_name>
1579
- <docblock line="862">
1580
  <description><![CDATA[Supply the content for a custom column]]></description>
1581
  <long-description><![CDATA[]]></long-description>
1582
- <tag line="862" name="since" description="0.1"/>
1583
- <tag line="862" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1584
  <type by_reference="false">array</type>
1585
  </tag>
1586
- <tag line="862" name="return" description="HTML markup to be placed inside the column" type="string">
1587
  <type by_reference="false">string</type>
1588
  </tag>
1589
  </docblock>
1590
- <argument line="870">
1591
  <name>$item</name>
1592
  <default><![CDATA[]]></default>
1593
  <type/>
1594
  </argument>
1595
  </method>
1596
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="882" package="Media Library Assistant">
1597
  <name>column_description</name>
1598
  <full_name>column_description</full_name>
1599
- <docblock line="874">
1600
  <description><![CDATA[Supply the content for a custom column]]></description>
1601
  <long-description><![CDATA[]]></long-description>
1602
- <tag line="874" name="since" description="0.1"/>
1603
- <tag line="874" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1604
  <type by_reference="false">array</type>
1605
  </tag>
1606
- <tag line="874" name="return" description="HTML markup to be placed inside the column" type="string">
1607
  <type by_reference="false">string</type>
1608
  </tag>
1609
  </docblock>
1610
- <argument line="882">
1611
  <name>$item</name>
1612
  <default><![CDATA[]]></default>
1613
  <type/>
1614
  </argument>
1615
  </method>
1616
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="894" package="Media Library Assistant">
1617
  <name>column_post_mime_type</name>
1618
  <full_name>column_post_mime_type</full_name>
1619
- <docblock line="886">
1620
  <description><![CDATA[Supply the content for a custom column]]></description>
1621
  <long-description><![CDATA[]]></long-description>
1622
- <tag line="886" name="since" description="0.30"/>
1623
- <tag line="886" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1624
  <type by_reference="false">array</type>
1625
  </tag>
1626
- <tag line="886" name="return" description="HTML markup to be placed inside the column" type="string">
1627
  <type by_reference="false">string</type>
1628
  </tag>
1629
  </docblock>
1630
- <argument line="894">
1631
  <name>$item</name>
1632
  <default><![CDATA[]]></default>
1633
  <type/>
1634
  </argument>
1635
  </method>
1636
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="906" package="Media Library Assistant">
1637
  <name>column_base_file</name>
1638
  <full_name>column_base_file</full_name>
1639
- <docblock line="898">
1640
  <description><![CDATA[Supply the content for a custom column]]></description>
1641
  <long-description><![CDATA[]]></long-description>
1642
- <tag line="898" name="since" description="0.1"/>
1643
- <tag line="898" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1644
  <type by_reference="false">array</type>
1645
  </tag>
1646
- <tag line="898" name="return" description="HTML markup to be placed inside the column" type="string">
1647
  <type by_reference="false">string</type>
1648
  </tag>
1649
  </docblock>
1650
- <argument line="906">
1651
  <name>$item</name>
1652
  <default><![CDATA[]]></default>
1653
  <type/>
1654
  </argument>
1655
  </method>
1656
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="918" package="Media Library Assistant">
1657
  <name>column_date</name>
1658
  <full_name>column_date</full_name>
1659
- <docblock line="910">
1660
  <description><![CDATA[Supply the content for a custom column]]></description>
1661
  <long-description><![CDATA[]]></long-description>
1662
- <tag line="910" name="since" description="0.1"/>
1663
- <tag line="910" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1664
  <type by_reference="false">array</type>
1665
  </tag>
1666
- <tag line="910" name="return" description="HTML markup to be placed inside the column" type="string">
1667
  <type by_reference="false">string</type>
1668
  </tag>
1669
  </docblock>
1670
- <argument line="918">
1671
  <name>$item</name>
1672
  <default><![CDATA[]]></default>
1673
  <type/>
1674
  </argument>
1675
  </method>
1676
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="947" package="Media Library Assistant">
1677
  <name>column_modified</name>
1678
  <full_name>column_modified</full_name>
1679
- <docblock line="939">
1680
  <description><![CDATA[Supply the content for a custom column]]></description>
1681
  <long-description><![CDATA[]]></long-description>
1682
- <tag line="939" name="since" description="0.30"/>
1683
- <tag line="939" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1684
  <type by_reference="false">array</type>
1685
  </tag>
1686
- <tag line="939" name="return" description="HTML markup to be placed inside the column" type="string">
1687
  <type by_reference="false">string</type>
1688
  </tag>
1689
  </docblock>
1690
- <argument line="947">
1691
  <name>$item</name>
1692
  <default><![CDATA[]]></default>
1693
  <type/>
1694
  </argument>
1695
  </method>
1696
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="976" package="Media Library Assistant">
1697
  <name>column_author</name>
1698
  <full_name>column_author</full_name>
1699
- <docblock line="968">
1700
  <description><![CDATA[Supply the content for a custom column]]></description>
1701
  <long-description><![CDATA[]]></long-description>
1702
- <tag line="968" name="since" description="0.30"/>
1703
- <tag line="968" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1704
  <type by_reference="false">array</type>
1705
  </tag>
1706
- <tag line="968" name="return" description="HTML markup to be placed inside the column" type="string">
1707
  <type by_reference="false">string</type>
1708
  </tag>
1709
  </docblock>
1710
- <argument line="976">
1711
  <name>$item</name>
1712
  <default><![CDATA[]]></default>
1713
  <type/>
1714
  </argument>
1715
  </method>
1716
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="997" package="Media Library Assistant">
1717
  <name>column_attached_to</name>
1718
  <full_name>column_attached_to</full_name>
1719
- <docblock line="989">
1720
  <description><![CDATA[Supply the content for a custom column]]></description>
1721
  <long-description><![CDATA[]]></long-description>
1722
- <tag line="989" name="since" description="0.1"/>
1723
- <tag line="989" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1724
  <type by_reference="false">array</type>
1725
  </tag>
1726
- <tag line="989" name="return" description="HTML markup to be placed inside the column" type="string">
1727
  <type by_reference="false">string</type>
1728
  </tag>
1729
  </docblock>
1730
- <argument line="997">
1731
  <name>$item</name>
1732
  <default><![CDATA[]]></default>
1733
  <type/>
1734
  </argument>
1735
  </method>
1736
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1026" package="Media Library Assistant">
1737
  <name>get_columns</name>
1738
  <full_name>get_columns</full_name>
1739
- <docblock line="1019">
1740
  <description><![CDATA[This method dictates the table's columns and titles]]></description>
1741
  <long-description><![CDATA[]]></long-description>
1742
- <tag line="1019" name="since" description="0.1"/>
1743
- <tag line="1019" name="return" description="Column information: 'slugs'=&gt;'Visible Titles'" type="array">
1744
  <type by_reference="false">array</type>
1745
  </tag>
1746
  </docblock>
1747
  </method>
1748
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1038" package="Media Library Assistant">
1749
  <name>get_hidden_columns</name>
1750
  <full_name>get_hidden_columns</full_name>
1751
- <docblock line="1030">
1752
  <description><![CDATA[Returns the list of currently hidden columns from a user option or
1753
  from default values if the option is not set]]></description>
1754
  <long-description><![CDATA[]]></long-description>
1755
- <tag line="1030" name="since" description="0.1"/>
1756
- <tag line="1030" name="return" description="Column information,e.g., array(0 =&gt; 'ID_parent, 1 =&gt; 'title_name')" type="array">
1757
  <type by_reference="false">array</type>
1758
  </tag>
1759
  </docblock>
1760
  </method>
1761
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1058" package="Media Library Assistant">
1762
  <name>get_sortable_columns</name>
1763
  <full_name>get_sortable_columns</full_name>
1764
- <docblock line="1048">
1765
  <description><![CDATA[Returns an array where the key is the column that needs to be sortable
1766
  and the value is db column to sort by.]]></description>
1767
  <long-description><![CDATA[<p>Also notes the current sort column,
1768
  if set.</p>]]></long-description>
1769
- <tag line="1048" name="since" description="0.1"/>
1770
- <tag line="1048" name="return" description="Sortable column information,e.g., 'slugs'=&gt;array('data_values',boolean)" type="array">
1771
  <type by_reference="false">array</type>
1772
  </tag>
1773
  </docblock>
1774
  </method>
1775
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1085" package="Media Library Assistant">
1776
  <name>get_views</name>
1777
  <full_name>get_views</full_name>
1778
- <docblock line="1077">
1779
  <description><![CDATA[Returns an associative array listing all the views that can be used with this table.]]></description>
1780
  <long-description><![CDATA[<p>These are listed across the top of the page and managed by WordPress.</p>]]></long-description>
1781
- <tag line="1077" name="since" description="0.1"/>
1782
- <tag line="1077" name="return" description="View information,e.g., array ( id =&gt; link )" type="array">
1783
  <type by_reference="false">array</type>
1784
  </tag>
1785
  </docblock>
1786
  </method>
1787
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1160" package="Media Library Assistant">
1788
  <name>get_bulk_actions</name>
1789
  <full_name>get_bulk_actions</full_name>
1790
- <docblock line="1152">
1791
  <description><![CDATA[Get an associative array ( option_name => option_title ) with the list
1792
  of bulk actions available on this table.]]></description>
1793
  <long-description><![CDATA[]]></long-description>
1794
- <tag line="1152" name="since" description="0.1"/>
1795
- <tag line="1152" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
1796
  <type by_reference="false">array</type>
1797
  </tag>
1798
  </docblock>
1799
  </method>
1800
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1191" package="Media Library Assistant">
1801
  <name>extra_tablenav</name>
1802
  <full_name>extra_tablenav</full_name>
1803
- <docblock line="1180">
1804
  <description><![CDATA[Extra controls to be displayed between bulk actions and pagination]]></description>
1805
  <long-description><![CDATA[<p>Modeled after class-wp-posts-list-table.php in wp-admin/includes.</p>]]></long-description>
1806
- <tag line="1180" name="since" description="0.1"/>
1807
- <tag line="1180" name="param" description="'top' or 'bottom', i.e., above or below the table rows" type="string" variable="$which">
1808
  <type by_reference="false">string</type>
1809
  </tag>
1810
- <tag line="1180" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
1811
  <type by_reference="false">array</type>
1812
  </tag>
1813
  </docblock>
1814
- <argument line="1191">
1815
  <name>$which</name>
1816
  <default><![CDATA[]]></default>
1817
  <type/>
1818
  </argument>
1819
  </method>
1820
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1251" package="Media Library Assistant">
1821
  <name>prepare_items</name>
1822
  <full_name>prepare_items</full_name>
1823
- <docblock line="1239">
1824
  <description><![CDATA[Prepares the list of items for displaying]]></description>
1825
  <long-description><![CDATA[<p>This is where you prepare your data for display. This method will usually
1826
  be used to query the database, sort and filter the data, and generally
1827
  get it ready to be displayed. At a minimum, we should set $this->items and
1828
  $this->set_pagination_args().</p>]]></long-description>
1829
- <tag line="1239" name="since" description="0.1"/>
1830
- <tag line="1239" name="return" description="" type="void">
1831
  <type by_reference="false">void</type>
1832
  </tag>
1833
  </docblock>
1834
  </method>
1835
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1297" package="Media Library Assistant">
1836
  <name>single_row</name>
1837
  <full_name>single_row</full_name>
1838
- <docblock line="1288">
1839
  <description><![CDATA[Generates (echoes) content for a single row of the table]]></description>
1840
  <long-description><![CDATA[]]></long-description>
1841
- <tag line="1288" name="since" description=".20"/>
1842
- <tag line="1288" name="param" description="the current item" type="object" variable="$item">
1843
  <type by_reference="false">object</type>
1844
  </tag>
1845
- <tag line="1288" name="return" description="Echoes the row HTML" type="void">
1846
  <type by_reference="false">void</type>
1847
  </tag>
1848
  </docblock>
1849
- <argument line="1297">
1850
  <name>$item</name>
1851
  <default><![CDATA[]]></default>
1852
  <type/>
@@ -1854,7 +1902,7 @@ $this->set_pagination_args().</p>]]></long-description>
1854
  </method>
1855
  </class>
1856
  </file>
1857
- <file path="includes\class-mla-main.php" hash="2b1a10bf4ebeaba1a8d36c28efd1f089" package="Media Library Assistant">
1858
  <docblock line="2">
1859
  <description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
1860
  <long-description><![CDATA[]]></long-description>
@@ -1891,7 +1939,7 @@ of images and files held in the WordPress Media Library.]]></description>
1891
  <constant namespace="global" line="41" package="Media Library Assistant">
1892
  <name>CURRENT_MLA_VERSION</name>
1893
  <full_name>CURRENT_MLA_VERSION</full_name>
1894
- <value><![CDATA['1.00']]></value>
1895
  <docblock line="34">
1896
  <description><![CDATA[Current version number]]></description>
1897
  <long-description><![CDATA[]]></long-description>
@@ -2084,80 +2132,93 @@ of images and files held in the WordPress Media Library.]]></description>
2084
  </docblock>
2085
  </constant>
2086
  <constant namespace="global" line="176" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
2087
  <name>MLA_ADMIN_SINGLE_MAP</name>
2088
  <full_name>MLA_ADMIN_SINGLE_MAP</full_name>
2089
  <value><![CDATA['single_item_map']]></value>
2090
- <docblock line="169">
2091
  <description><![CDATA[mla_admin_action value for mapping IPTC/EXIF metadata]]></description>
2092
  <long-description><![CDATA[]]></long-description>
2093
- <tag line="169" name="since" description="1.00"/>
2094
- <tag line="169" name="var" description="" type="string">
2095
  <type by_reference="false">string</type>
2096
  </tag>
2097
  </docblock>
2098
  </constant>
2099
- <property final="false" static="true" visibility="private" line="185" namespace="global" package="Media Library Assistant">
2100
  <name>$page_hooks</name>
2101
  <default><![CDATA[array()]]></default>
2102
- <docblock line="178">
2103
  <description><![CDATA[Holds screen ids to match help text to corresponding screen]]></description>
2104
  <long-description><![CDATA[]]></long-description>
2105
- <tag line="178" name="since" description="0.1"/>
2106
- <tag line="178" name="var" description="" type="array">
2107
  <type by_reference="false">array</type>
2108
  </tag>
2109
  </docblock>
2110
  </property>
2111
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="198" package="Media Library Assistant">
2112
  <name>initialize</name>
2113
  <full_name>initialize</full_name>
2114
- <docblock line="187">
2115
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
2116
  <long-description><![CDATA[<p>This function contains add_action and add_filter calls
2117
  to set up the Ajax handlers, enqueue JavaScript and CSS files, and
2118
  set up the Assistant submenu.</p>]]></long-description>
2119
- <tag line="187" name="since" description="0.1"/>
2120
- <tag line="187" name="return" description="" type="void">
2121
  <type by_reference="false">void</type>
2122
  </tag>
2123
  </docblock>
2124
  </method>
2125
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="217" package="Media Library Assistant">
2126
  <name>mla_admin_init_action</name>
2127
  <full_name>mla_admin_init_action</full_name>
2128
- <docblock line="210">
2129
- <description><![CDATA[Load the plugin's Ajax handler]]></description>
2130
  <long-description><![CDATA[]]></long-description>
2131
- <tag line="210" name="since" description="0.20"/>
2132
- <tag line="210" name="return" description="" type="void">
2133
  <type by_reference="false">void</type>
2134
  </tag>
2135
  </docblock>
2136
  </method>
2137
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="230" package="Media Library Assistant">
2138
  <name>mla_admin_enqueue_scripts_action</name>
2139
  <full_name>mla_admin_enqueue_scripts_action</full_name>
2140
- <docblock line="221">
2141
  <description><![CDATA[Load the plugin's Style Sheet and Javascript files]]></description>
2142
  <long-description><![CDATA[]]></long-description>
2143
- <tag line="221" name="since" description="0.1"/>
2144
- <tag line="221" name="param" description="Name of the page being loaded" type="string" variable="$page_hook">
2145
  <type by_reference="false">string</type>
2146
  </tag>
2147
- <tag line="221" name="return" description="" type="void">
2148
  <type by_reference="false">void</type>
2149
  </tag>
2150
  </docblock>
2151
- <argument line="230">
2152
  <name>$page_hook</name>
2153
  <default><![CDATA[]]></default>
2154
  <type/>
2155
  </argument>
2156
  </method>
2157
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="278" package="Media Library Assistant">
2158
  <name>mla_admin_menu_action</name>
2159
  <full_name>mla_admin_menu_action</full_name>
2160
- <docblock line="263">
2161
  <description><![CDATA[Add the submenu pages]]></description>
2162
  <long-description><![CDATA[<p>Add a submenu page in the "Media" section,
2163
  add settings page in the "Settings" section.
@@ -2166,143 +2227,119 @@ add settings link in the Plugins section entry for MLA.</p>
2166
  <p>For WordPress versions before 3.5,
2167
  add submenu page(s) for attachment taxonomies,
2168
  add filter to clean up taxonomy submenu labels.</p>]]></long-description>
2169
- <tag line="263" name="since" description="0.1"/>
2170
- <tag line="263" name="return" description="" type="void">
2171
- <type by_reference="false">void</type>
2172
- </tag>
2173
- </docblock>
2174
- </method>
2175
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="324" package="Media Library Assistant">
2176
- <name>mla_load_upload_php_action</name>
2177
- <full_name>mla_load_upload_php_action</full_name>
2178
- <docblock line="317">
2179
- <description><![CDATA[Intercept return from Edit Media screen]]></description>
2180
- <long-description><![CDATA[]]></long-description>
2181
- <tag line="317" name="since" description="0.60"/>
2182
- <tag line="317" name="return" description="" type="void">
2183
  <type by_reference="false">void</type>
2184
  </tag>
2185
  </docblock>
2186
  </method>
2187
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="337" package="Media Library Assistant">
2188
- <name>mla_load_post_php_action</name>
2189
- <full_name>mla_load_post_php_action</full_name>
2190
- <docblock line="330">
2191
- <description><![CDATA[Intercept call to Edit Media screen]]></description>
2192
- <long-description><![CDATA[]]></long-description>
2193
- <tag line="330" name="since" description="0.60"/>
2194
- <tag line="330" name="return" description="" type="void">
2195
- <type by_reference="false">void</type>
2196
- </tag>
2197
- </docblock>
2198
- </method>
2199
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="350" package="Media Library Assistant">
2200
  <name>mla_add_menu_options</name>
2201
  <full_name>mla_add_menu_options</full_name>
2202
- <docblock line="343">
2203
  <description><![CDATA[Add the "XX Entries per page" filter to the Screen Options tab]]></description>
2204
  <long-description><![CDATA[]]></long-description>
2205
- <tag line="343" name="since" description="0.1"/>
2206
- <tag line="343" name="return" description="" type="void">
2207
  <type by_reference="false">void</type>
2208
  </tag>
2209
  </docblock>
2210
  </method>
2211
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="369" package="Media Library Assistant">
2212
  <name>mla_add_help_tab</name>
2213
  <full_name>mla_add_help_tab</full_name>
2214
- <docblock line="362">
2215
  <description><![CDATA[Add contextual help tabs to all the MLA pages]]></description>
2216
  <long-description><![CDATA[]]></long-description>
2217
- <tag line="362" name="since" description="0.1"/>
2218
- <tag line="362" name="return" description="" type="void">
2219
  <type by_reference="false">void</type>
2220
  </tag>
2221
  </docblock>
2222
  </method>
2223
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="458" package="Media Library Assistant">
2224
  <name>mla_screen_options_show_screen_filter</name>
2225
  <full_name>mla_screen_options_show_screen_filter</full_name>
2226
- <docblock line="448">
2227
  <description><![CDATA[Only show screen options on the table-list screen]]></description>
2228
  <long-description><![CDATA[]]></long-description>
2229
- <tag line="448" name="since" description="0.1"/>
2230
- <tag line="448" name="param" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean" variable="$show_screen">
2231
  <type by_reference="false">boolean</type>
2232
  </tag>
2233
- <tag line="448" name="param" description="Name of the page being loaded" type="string" variable="$this_screen">
2234
  <type by_reference="false">string</type>
2235
  </tag>
2236
- <tag line="448" name="return" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean">
2237
  <type by_reference="false">boolean</type>
2238
  </tag>
2239
  </docblock>
2240
- <argument line="458">
2241
  <name>$show_screen</name>
2242
  <default><![CDATA[]]></default>
2243
  <type/>
2244
  </argument>
2245
- <argument line="458">
2246
  <name>$this_screen</name>
2247
  <default><![CDATA[]]></default>
2248
  <type/>
2249
  </argument>
2250
  </method>
2251
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="476" package="Media Library Assistant">
2252
  <name>mla_set_screen_option_filter</name>
2253
  <full_name>mla_set_screen_option_filter</full_name>
2254
- <docblock line="465">
2255
  <description><![CDATA[Save the "Entries per page" option set by this user]]></description>
2256
  <long-description><![CDATA[]]></long-description>
2257
- <tag line="465" name="since" description="0.1"/>
2258
- <tag line="465" name="param" description="Unknown - always false?" type="boolean" variable="$status">
2259
  <type by_reference="false">boolean</type>
2260
  </tag>
2261
- <tag line="465" name="param" description="Name of the option being changed" type="string" variable="$option">
2262
  <type by_reference="false">string</type>
2263
  </tag>
2264
- <tag line="465" name="param" description="New value of the option" type="string" variable="$value">
2265
  <type by_reference="false">string</type>
2266
  </tag>
2267
- <tag line="465" name="return" description="New value if this is our option, otherwise nothing" type="string|void">
2268
  <type by_reference="false">string</type>
2269
  <type by_reference="false">void</type>
2270
  </tag>
2271
  </docblock>
2272
- <argument line="476">
2273
  <name>$status</name>
2274
  <default><![CDATA[]]></default>
2275
  <type/>
2276
  </argument>
2277
- <argument line="476">
2278
  <name>$option</name>
2279
  <default><![CDATA[]]></default>
2280
  <type/>
2281
  </argument>
2282
- <argument line="476">
2283
  <name>$value</name>
2284
  <default><![CDATA[]]></default>
2285
  <type/>
2286
  </argument>
2287
  </method>
2288
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="493" package="Media Library Assistant">
2289
  <name>mla_edit_tax_redirect</name>
2290
  <full_name>mla_edit_tax_redirect</full_name>
2291
- <docblock line="482">
2292
  <description><![CDATA[Redirect to the Edit Tags/Categories page]]></description>
2293
  <long-description><![CDATA[<p>The custom taxonomy add/edit submenu entries go to "upload.php" by default.
2294
  This filter is the only way to redirect them to the correct WordPress page.
2295
  The filter is not required for WordPress 3.5 and later.</p>]]></long-description>
2296
- <tag line="482" name="since" description="0.1"/>
2297
- <tag line="482" name="return" description="" type="void">
2298
  <type by_reference="false">void</type>
2299
  </tag>
2300
  </docblock>
2301
  </method>
2302
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="526" package="Media Library Assistant">
2303
  <name>mla_parent_file_filter</name>
2304
  <full_name>mla_parent_file_filter</full_name>
2305
- <docblock line="510">
2306
  <description><![CDATA[Cleanup menus for Edit Tags/Categories page]]></description>
2307
  <long-description><![CDATA[<p>For WordPress before 3.5, the submenu entries for custom taxonomies
2308
  under the "Media" menu are not set up correctly by WordPress, so this
@@ -2310,190 +2347,190 @@ function cleans them up, redirecting the request to the right WordPress
2310
  page for editing/adding taxonomy terms.
2311
  For WordPress 3.5 and later, the function fixes the submenu bolding when
2312
  going to the Edit Media screen.</p>]]></long-description>
2313
- <tag line="510" name="since" description="0.1"/>
2314
- <tag line="510" name="param" description="The top-level menu page" type="array" variable="$parent_file">
2315
  <type by_reference="false">array</type>
2316
  </tag>
2317
- <tag line="510" name="return" description="The updated top-level menu page" type="string">
2318
  <type by_reference="false">string</type>
2319
  </tag>
2320
  </docblock>
2321
- <argument line="526">
2322
  <name>$parent_file</name>
2323
  <default><![CDATA[]]></default>
2324
  <type/>
2325
  </argument>
2326
  </method>
2327
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="569" package="Media Library Assistant">
2328
  <name>mla_render_admin_page</name>
2329
  <full_name>mla_render_admin_page</full_name>
2330
- <docblock line="562">
2331
  <description><![CDATA[Render the "Assistant" subpage in the Media section, using the list_table package]]></description>
2332
  <long-description><![CDATA[]]></long-description>
2333
- <tag line="562" name="since" description="0.1"/>
2334
- <tag line="562" name="return" description="" type="void">
2335
  <type by_reference="false">void</type>
2336
  </tag>
2337
  </docblock>
2338
  </method>
2339
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="836" package="Media Library Assistant">
2340
  <name>mla_inline_edit_action</name>
2341
  <full_name>mla_inline_edit_action</full_name>
2342
- <docblock line="827">
2343
  <description><![CDATA[Ajax handler for inline editing (quick and bulk edit)]]></description>
2344
  <long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
2345
- <tag line="827" name="since" description="0.20"/>
2346
- <tag line="827" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
2347
  <type by_reference="false">void</type>
2348
  </tag>
2349
  </docblock>
2350
  </method>
2351
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="916" package="Media Library Assistant">
2352
  <name>_build_inline_edit_form</name>
2353
  <full_name>_build_inline_edit_form</full_name>
2354
- <docblock line="905">
2355
  <description><![CDATA[Build the hidden row templates for inline editing (quick and bulk edit)]]></description>
2356
  <long-description><![CDATA[<p>inspired by inline_edit() in wp-admin\includes\class-wp-posts-list-table.php.</p>]]></long-description>
2357
- <tag line="905" name="since" description="0.20"/>
2358
- <tag line="905" name="param" description="MLA List Table object" type="object" variable="$MLAListTable">
2359
  <type by_reference="false">object</type>
2360
  </tag>
2361
- <tag line="905" name="return" description="HTML &lt;form&gt; markup for hidden rows" type="string">
2362
  <type by_reference="false">string</type>
2363
  </tag>
2364
  </docblock>
2365
- <argument line="916">
2366
  <name>$MLAListTable</name>
2367
  <default><![CDATA[]]></default>
2368
  <type/>
2369
  </argument>
2370
  </method>
2371
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1053" package="Media Library Assistant">
2372
  <name>_authors_dropdown</name>
2373
  <full_name>_authors_dropdown</full_name>
2374
- <docblock line="1042">
2375
  <description><![CDATA[Get the edit Authors dropdown box, if user has suitable permissions]]></description>
2376
  <long-description><![CDATA[]]></long-description>
2377
- <tag line="1042" name="since" description="0.20"/>
2378
- <tag line="1042" name="param" description="Optional User ID of the current author, default 0" type="integer" variable="$author">
2379
  <type by_reference="false">integer</type>
2380
  </tag>
2381
- <tag line="1042" name="param" description="Optional HTML name attribute, default 'post_author'" type="string" variable="$name">
2382
  <type by_reference="false">string</type>
2383
  </tag>
2384
- <tag line="1042" name="param" description="Optional HTML class attribute, default 'authors'" type="string" variable="$class">
2385
  <type by_reference="false">string</type>
2386
  </tag>
2387
- <tag line="1042" name="return" description="HTML markup for the dropdown field or False" type="string|false">
2388
  <type by_reference="false">string</type>
2389
  <type by_reference="false">false</type>
2390
  </tag>
2391
  </docblock>
2392
- <argument line="1053">
2393
  <name>$author</name>
2394
  <default><![CDATA[0]]></default>
2395
  <type/>
2396
  </argument>
2397
- <argument line="1053">
2398
  <name>$name</name>
2399
  <default><![CDATA['post_author']]></default>
2400
  <type/>
2401
  </argument>
2402
- <argument line="1053">
2403
  <name>$class</name>
2404
  <default><![CDATA['authors']]></default>
2405
  <type/>
2406
  </argument>
2407
  </method>
2408
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1087" package="Media Library Assistant">
2409
  <name>_current_bulk_action</name>
2410
  <full_name>_current_bulk_action</full_name>
2411
- <docblock line="1080">
2412
  <description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
2413
  <long-description><![CDATA[]]></long-description>
2414
- <tag line="1080" name="since" description="0.1"/>
2415
- <tag line="1080" name="return" description="The action name or False if no action was selected" type="string|false">
2416
  <type by_reference="false">string</type>
2417
  <type by_reference="false">false</type>
2418
  </tag>
2419
  </docblock>
2420
  </method>
2421
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1116" package="Media Library Assistant">
2422
  <name>_delete_single_item</name>
2423
  <full_name>_delete_single_item</full_name>
2424
- <docblock line="1107">
2425
  <description><![CDATA[Delete a single item permanently]]></description>
2426
  <long-description><![CDATA[]]></long-description>
2427
- <tag line="1107" name="since" description="0.1"/>
2428
- <tag line="1107" name="param" description="The form POST data" type="array" variable="$post_id">
2429
  <type by_reference="false">array</type>
2430
  </tag>
2431
- <tag line="1107" name="return" description="success/failure message and NULL content" type="array">
2432
  <type by_reference="false">array</type>
2433
  </tag>
2434
  </docblock>
2435
- <argument line="1116">
2436
  <name>$post_id</name>
2437
  <default><![CDATA[]]></default>
2438
  <type/>
2439
  </argument>
2440
  </method>
2441
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1145" package="Media Library Assistant">
2442
  <name>_display_single_item</name>
2443
  <full_name>_display_single_item</full_name>
2444
- <docblock line="1135">
2445
  <description><![CDATA[Display a single item sub page; prepare the form to
2446
  change the meta data for a single attachment.]]></description>
2447
  <long-description><![CDATA[]]></long-description>
2448
- <tag line="1135" name="since" description="0.1"/>
2449
- <tag line="1135" name="param" description="The WordPress Post ID of the attachment item" type="int" variable="$post_id">
2450
  <type by_reference="false">int</type>
2451
  </tag>
2452
- <tag line="1135" name="return" description="message and/or HTML content" type="array">
2453
  <type by_reference="false">array</type>
2454
  </tag>
2455
  </docblock>
2456
- <argument line="1145">
2457
  <name>$post_id</name>
2458
  <default><![CDATA[]]></default>
2459
  <type/>
2460
  </argument>
2461
  </method>
2462
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1385" package="Media Library Assistant">
2463
  <name>_restore_single_item</name>
2464
  <full_name>_restore_single_item</full_name>
2465
- <docblock line="1376">
2466
  <description><![CDATA[Restore a single item from the Trash]]></description>
2467
  <long-description><![CDATA[]]></long-description>
2468
- <tag line="1376" name="since" description="0.1"/>
2469
- <tag line="1376" name="param" description="The form POST data" type="array" variable="$post_id">
2470
  <type by_reference="false">array</type>
2471
  </tag>
2472
- <tag line="1376" name="return" description="success/failure message and NULL content" type="array">
2473
  <type by_reference="false">array</type>
2474
  </tag>
2475
  </docblock>
2476
- <argument line="1385">
2477
  <name>$post_id</name>
2478
  <default><![CDATA[]]></default>
2479
  <type/>
2480
  </argument>
2481
  </method>
2482
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1421" package="Media Library Assistant">
2483
  <name>_trash_single_item</name>
2484
  <full_name>_trash_single_item</full_name>
2485
- <docblock line="1412">
2486
  <description><![CDATA[Move a single item to Trash]]></description>
2487
  <long-description><![CDATA[]]></long-description>
2488
- <tag line="1412" name="since" description="0.1"/>
2489
- <tag line="1412" name="param" description="The form POST data" type="array" variable="$post_id">
2490
  <type by_reference="false">array</type>
2491
  </tag>
2492
- <tag line="1412" name="return" description="success/failure message and NULL content" type="array">
2493
  <type by_reference="false">array</type>
2494
  </tag>
2495
  </docblock>
2496
- <argument line="1421">
2497
  <name>$post_id</name>
2498
  <default><![CDATA[]]></default>
2499
  <type/>
@@ -2602,7 +2639,7 @@ which returns a count of the attachments assigned a given term]]></description>
2602
  </method>
2603
  </class>
2604
  </file>
2605
- <file path="includes\class-mla-options.php" hash="6c93e0f09cbe473453eff5c67a46273f" package="Media Library Assistant">
2606
  <docblock line="2">
2607
  <description><![CDATA[Manages the plugin option settings]]></description>
2608
  <long-description><![CDATA[]]></long-description>
@@ -2666,66 +2703,75 @@ and provides functions to get and put them from/to WordPress option variables]]>
2666
  </docblock>
2667
  </constant>
2668
  <constant namespace="global" line="47" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
2669
  <name>MLA_NEW_CUSTOM_FIELD</name>
2670
  <full_name>MLA_NEW_CUSTOM_FIELD</full_name>
2671
  <value><![CDATA['__NEW FIELD__']]></value>
2672
- <docblock line="44">
2673
  <description><![CDATA[Provides a unique name for the Custom Field "new field" key]]></description>
2674
  <long-description><![CDATA[]]></long-description>
2675
  </docblock>
2676
  </constant>
2677
- <property final="false" static="true" visibility="public" line="58" namespace="global" package="Media Library Assistant">
2678
  <name>$process_featured_in</name>
2679
  <default><![CDATA[true]]></default>
2680
- <docblock line="49">
2681
  <description><![CDATA[Option setting for "Featured in" reporting]]></description>
2682
  <long-description><![CDATA[<p>This setting is false if the "Featured in" database access setting is "disabled", else true.</p>]]></long-description>
2683
- <tag line="49" name="since" description="1.00"/>
2684
- <tag line="49" name="var" description="" type="boolean">
2685
  <type by_reference="false">boolean</type>
2686
  </tag>
2687
  </docblock>
2688
  </property>
2689
- <property final="false" static="true" visibility="public" line="69" namespace="global" package="Media Library Assistant">
2690
  <name>$process_inserted_in</name>
2691
  <default><![CDATA[true]]></default>
2692
- <docblock line="60">
2693
  <description><![CDATA[Option setting for "Inserted in" reporting]]></description>
2694
  <long-description><![CDATA[<p>This setting is false if the "Inserted in" database access setting is "disabled", else true.</p>]]></long-description>
2695
- <tag line="60" name="since" description="1.00"/>
2696
- <tag line="60" name="var" description="" type="boolean">
2697
  <type by_reference="false">boolean</type>
2698
  </tag>
2699
  </docblock>
2700
  </property>
2701
- <property final="false" static="true" visibility="public" line="80" namespace="global" package="Media Library Assistant">
2702
  <name>$process_gallery_in</name>
2703
  <default><![CDATA[true]]></default>
2704
- <docblock line="71">
2705
  <description><![CDATA[Option setting for "Gallery in" reporting]]></description>
2706
  <long-description><![CDATA[<p>This setting is false if the "Gallery in" database access setting is "disabled", else true.</p>]]></long-description>
2707
- <tag line="71" name="since" description="1.00"/>
2708
- <tag line="71" name="var" description="" type="boolean">
2709
  <type by_reference="false">boolean</type>
2710
  </tag>
2711
  </docblock>
2712
  </property>
2713
- <property final="false" static="true" visibility="public" line="91" namespace="global" package="Media Library Assistant">
2714
  <name>$process_mla_gallery_in</name>
2715
  <default><![CDATA[true]]></default>
2716
- <docblock line="82">
2717
  <description><![CDATA[Option setting for "MLA Gallery in" reporting]]></description>
2718
  <long-description><![CDATA[<p>This setting is false if the "MLA Gallery in" database access setting is "disabled", else true.</p>]]></long-description>
2719
- <tag line="82" name="since" description="1.00"/>
2720
- <tag line="82" name="var" description="" type="boolean">
2721
  <type by_reference="false">boolean</type>
2722
  </tag>
2723
  </docblock>
2724
  </property>
2725
- <property final="false" static="true" visibility="public" line="118" namespace="global" package="Media Library Assistant">
2726
  <name>$mla_option_definitions</name>
2727
- <default><![CDATA[array(self::MLA_VERSION_OPTION => array('tab' => '', 'type' => 'hidden', 'std' => '0'), 'attachment_category' => array('tab' => '', 'name' => 'Attachment Categories', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to add support for Attachment Categories.'), 'attachment_tag' => array('tab' => '', 'name' => 'Attachment Tags', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to add support for Attachment Tags.'), 'where_used_heading' => array('tab' => 'general', 'name' => 'Where-used Reporting', 'type' => 'header'), 'exclude_revisions' => array('tab' => 'general', 'name' => 'Exclude Revisions', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to exclude revisions from where-used reporting.'), 'where_used_subheading' => array('tab' => 'general', 'name' => 'Where-used database access tuning', 'type' => 'subheader'), self::MLA_FEATURED_IN_TUNING => array('tab' => 'general', 'name' => 'Featured in', 'type' => 'select', 'std' => 'enabled', 'options' => array('enabled', 'disabled'), 'texts' => array('Enabled', 'Disabled'), 'help' => 'Search database posts and pages for Featured Image attachments.'), self::MLA_INSERTED_IN_TUNING => array('tab' => 'general', 'name' => 'Inserted in', 'type' => 'select', 'std' => 'enabled', 'options' => array('enabled', 'disabled'), 'texts' => array('Enabled', 'Disabled'), 'help' => 'Search database posts and pages for attachments embedded in content.'), self::MLA_GALLERY_IN_TUNING => array('tab' => 'general', 'name' => 'Gallery in', 'type' => 'select', 'std' => 'cached', 'options' => array('dynamic', 'refresh', 'cached', 'disabled'), 'texts' => array('Dynamic', 'Refresh', 'Cached', 'Disabled'), 'help' => 'Search database posts and pages for [gallery] shortcode results.<br>&nbsp;&nbsp;Dynamic = once every page load, Cached = once every login, Disabled = never.<br>&nbsp;&nbsp;Refresh = update references, then set to Cached.'), self::MLA_MLA_GALLERY_IN_TUNING => array('tab' => 'general', 'name' => 'MLA Gallery in', 'type' => 'select', 'std' => 'cached', 'options' => array('dynamic', 'refresh', 'cached', 'disabled'), 'texts' => array('Dynamic', 'Refresh', 'Cached', 'Disabled'), 'help' => 'Search database posts and pages for [mla_gallery] shortcode results.<br>&nbsp;&nbsp;Dynamic = once every page load, Cached = once every login, Disabled = never.<br>&nbsp;&nbsp;Refresh = update references, then set to Cached.'), 'taxonomy_heading' => array('tab' => 'general', 'name' => 'Taxonomy Support', 'type' => 'header'), 'taxonomy_support' => array('tab' => 'general', 'help' => 'Check the "Support" box to add the taxonomy to the Assistant.<br>Check the "Inline Edit" box to display the taxonomy in the Quick Edit and Bulk Edit areas.<br>Use the "List Filter" option to select the taxonomy on which to filter the Assistant table listing.', 'std' => array('tax_support' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_quick_edit' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_filter' => 'attachment_category'), 'type' => 'custom', 'render' => 'mla_taxonomy_option_handler', 'update' => 'mla_taxonomy_option_handler', 'delete' => 'mla_taxonomy_option_handler', 'reset' => 'mla_taxonomy_option_handler'), 'orderby_heading' => array('tab' => 'general', 'name' => 'Default Table Listing Sort Order', 'type' => 'header'), 'default_orderby' => array('tab' => 'general', 'name' => 'Order By', 'type' => 'select', 'std' => 'title_name', 'options' => array('none', 'title_name'), 'texts' => array('None', 'Title/Name'), 'help' => 'Select the column for the sort order of the Assistant table listing.'), 'default_order' => array('tab' => 'general', 'name' => 'Order', 'type' => 'radio', 'std' => 'ASC', 'options' => array('ASC', 'DESC'), 'texts' => array('Ascending', 'Descending'), 'help' => 'Choose the sort order.'), 'template_heading' => array('tab' => 'mla-gallery', 'name' => 'Default [mla_gallery] Templates', 'type' => 'header'), 'default_style' => array('tab' => 'mla-gallery', 'name' => 'Style Template', 'type' => 'select', 'std' => 'default', 'options' => array(), 'texts' => array(), 'help' => 'Select the default style template for your [mla_gallery] shortcodes.'), 'default_markup' => array('tab' => 'mla-gallery', 'name' => 'Markup Template', 'type' => 'select', 'std' => 'default', 'options' => array(), 'texts' => array(), 'help' => 'Select the default markup template for your [mla_gallery] shortcodes.'), 'style_templates' => array('tab' => '', 'type' => 'hidden', 'std' => array()), 'markup_templates' => array('tab' => '', 'type' => 'hidden', 'std' => array()), 'enable_iptc_exif_mapping' => array('tab' => 'iptc-exif', 'name' => 'Enable IPTC/EXIF Mapping when adding new media', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable mapping when uploading new media (attachments).<br>&nbsp;&nbsp;Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'), 'iptc_exif_standard_mapping' => array('tab' => '', 'help' => 'Update the standard field mapping values above, then click Save Changes to make the updates permanent.<br>You can also make temporary updates and click Map All Attachments Now to apply the updates to all attachments without saving the rule changes.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_taxonomy_mapping' => array('tab' => '', 'help' => 'Update the taxonomy term mapping values above, then click Save Changes or Map All Attachments Now.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_custom_mapping' => array('tab' => '', 'help' => 'Update the custom field mapping values above.<br>To define a new custom field, enter a field name in the "Field Title" text box at the end of the list and Save Changes.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_mapping' => array('tab' => '', 'help' => 'IPTC/EXIF Mapping help', 'std' => array('standard' => array('post_title' => array('name' => 'Title', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_name' => array('name' => 'Name/Slug', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'image_alt' => array('name' => 'Alternate Text', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_excerpt' => array('name' => 'Caption', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_content' => array('name' => 'Description', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true)), 'taxonomy' => array(), 'custom' => array()), 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'))]]></default>
2728
- <docblock line="93">
2729
  <description><![CDATA[$mla_option_definitions defines the database options and admin page areas for setting/updating them.]]></description>
2730
  <long-description><![CDATA[<p>Each option is defined by an array with the following elements:</p>
2731
 
@@ -2751,523 +2797,858 @@ reset => reset function for 'custom' options; returns nothing. Usage:
2751
  $message = ['reset']( 'reset', $key, $value, $_REQUEST );</p>]]></long-description>
2752
  </docblock>
2753
  </property>
2754
- <property final="false" static="true" visibility="private" line="422" namespace="global" package="Media Library Assistant">
2755
  <name>$mla_option_templates</name>
2756
  <default><![CDATA[null]]></default>
2757
- <docblock line="415">
2758
  <description><![CDATA[Style and Markup templates]]></description>
2759
  <long-description><![CDATA[]]></long-description>
2760
- <tag line="415" name="since" description="0.80"/>
2761
- <tag line="415" name="var" description="" type="array">
2762
  <type by_reference="false">array</type>
2763
  </tag>
2764
  </docblock>
2765
  </property>
2766
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="399" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
2767
  <name>initialize</name>
2768
  <full_name>initialize</full_name>
2769
- <docblock line="392">
2770
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
2771
  <long-description><![CDATA[]]></long-description>
2772
- <tag line="392" name="since" description="1.00"/>
2773
- <tag line="392" name="return" description="" type="void">
2774
  <type by_reference="false">void</type>
2775
  </tag>
2776
  </docblock>
2777
  </method>
2778
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="431" package="Media Library Assistant">
2779
  <name>_load_option_templates</name>
2780
  <full_name>_load_option_templates</full_name>
2781
- <docblock line="424">
2782
  <description><![CDATA[Load style and markup templates to $mla_templates]]></description>
2783
  <long-description><![CDATA[]]></long-description>
2784
- <tag line="424" name="since" description="0.80"/>
2785
- <tag line="424" name="return" description="" type="void">
2786
  <type by_reference="false">void</type>
2787
  </tag>
2788
  </docblock>
2789
  </method>
2790
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="479" package="Media Library Assistant">
2791
  <name>mla_fetch_gallery_template</name>
2792
  <full_name>mla_fetch_gallery_template</full_name>
2793
- <docblock line="469">
2794
  <description><![CDATA[Fetch style or markup template from $mla_templates]]></description>
2795
  <long-description><![CDATA[]]></long-description>
2796
- <tag line="469" name="since" description="0.80"/>
2797
- <tag line="469" name="param" description="Template name" type="string" variable="$key">
2798
  <type by_reference="false">string</type>
2799
  </tag>
2800
- <tag line="469" name="param" description="Template type; 'style' (default) or 'markup'" type="string" variable="$type">
2801
  <type by_reference="false">string</type>
2802
  </tag>
2803
- <tag line="469" name="return" description="requested template, false if not found or null if no templates" type="string|boolean|null">
2804
  <type by_reference="false">string</type>
2805
  <type by_reference="false">boolean</type>
2806
  <type by_reference="false">null</type>
2807
  </tag>
2808
  </docblock>
2809
- <argument line="479">
2810
  <name>$key</name>
2811
  <default><![CDATA[]]></default>
2812
  <type/>
2813
  </argument>
2814
- <argument line="479">
2815
  <name>$type</name>
2816
  <default><![CDATA['style']]></default>
2817
  <type/>
2818
  </argument>
2819
  </method>
2820
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="501" package="Media Library Assistant">
2821
  <name>mla_get_style_templates</name>
2822
  <full_name>mla_get_style_templates</full_name>
2823
- <docblock line="494">
2824
  <description><![CDATA[Get ALL style templates from $mla_templates, including 'default']]></description>
2825
  <long-description><![CDATA[]]></long-description>
2826
- <tag line="494" name="since" description="0.80"/>
2827
- <tag line="494" name="return" description="name =&gt; value for all style templates or null if no templates" type="array|null">
2828
  <type by_reference="false">array</type>
2829
  <type by_reference="false">null</type>
2830
  </tag>
2831
  </docblock>
2832
  </method>
2833
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="527" package="Media Library Assistant">
2834
  <name>mla_put_style_templates</name>
2835
  <full_name>mla_put_style_templates</full_name>
2836
- <docblock line="519">
2837
  <description><![CDATA[Put user-defined style templates to $mla_templates and database]]></description>
2838
  <long-description><![CDATA[]]></long-description>
2839
- <tag line="519" name="since" description="0.80"/>
2840
- <tag line="519" name="param" description="name =&gt; value for all user-defined style templates" type="array" variable="$templates">
2841
  <type by_reference="false">array</type>
2842
  </tag>
2843
- <tag line="519" name="return" description="true if success, false if failure" type="boolean">
2844
  <type by_reference="false">boolean</type>
2845
  </tag>
2846
  </docblock>
2847
- <argument line="527">
2848
  <name>$templates</name>
2849
  <default><![CDATA[]]></default>
2850
  <type/>
2851
  </argument>
2852
  </method>
2853
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="543" package="Media Library Assistant">
2854
  <name>mla_get_markup_templates</name>
2855
  <full_name>mla_get_markup_templates</full_name>
2856
- <docblock line="536">
2857
  <description><![CDATA[Get ALL markup templates from $mla_templates, including 'default']]></description>
2858
  <long-description><![CDATA[]]></long-description>
2859
- <tag line="536" name="since" description="0.80"/>
2860
- <tag line="536" name="return" description="name =&gt; value for all markup templates or null if no templates" type="array|null">
2861
  <type by_reference="false">array</type>
2862
  <type by_reference="false">null</type>
2863
  </tag>
2864
  </docblock>
2865
  </method>
2866
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="597" package="Media Library Assistant">
2867
  <name>mla_put_markup_templates</name>
2868
  <full_name>mla_put_markup_templates</full_name>
2869
- <docblock line="589">
2870
  <description><![CDATA[Put user-defined markup templates to $mla_templates and database]]></description>
2871
  <long-description><![CDATA[]]></long-description>
2872
- <tag line="589" name="since" description="0.80"/>
2873
- <tag line="589" name="param" description="name =&gt; value for all user-defined markup templates" type="array" variable="$templates">
2874
  <type by_reference="false">array</type>
2875
  </tag>
2876
- <tag line="589" name="return" description="true if success, false if failure" type="boolean">
2877
  <type by_reference="false">boolean</type>
2878
  </tag>
2879
  </docblock>
2880
- <argument line="597">
2881
  <name>$templates</name>
2882
  <default><![CDATA[]]></default>
2883
  <type/>
2884
  </argument>
2885
  </method>
2886
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="615" package="Media Library Assistant">
2887
  <name>mla_get_option</name>
2888
  <full_name>mla_get_option</full_name>
2889
- <docblock line="606">
2890
  <description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
2891
  <long-description><![CDATA[]]></long-description>
2892
- <tag line="606" name="since" description="0.1"/>
2893
- <tag line="606" name="param" description="Name of the desired option" type="string" variable="$option">
2894
  <type by_reference="false">string</type>
2895
  </tag>
2896
- <tag line="606" name="return" description="Value(s) for the option or false if the option is not a defined MLA option" type="mixed">
2897
  <type by_reference="false">mixed</type>
2898
  </tag>
2899
  </docblock>
2900
- <argument line="615">
2901
  <name>$option</name>
2902
  <default><![CDATA[]]></default>
2903
  <type/>
2904
  </argument>
2905
  </method>
2906
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="636" package="Media Library Assistant">
2907
  <name>mla_update_option</name>
2908
  <full_name>mla_update_option</full_name>
2909
- <docblock line="626">
2910
  <description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
2911
  <long-description><![CDATA[]]></long-description>
2912
- <tag line="626" name="since" description="0.1"/>
2913
- <tag line="626" name="param" description="Name of the desired option" type="string" variable="$option">
2914
  <type by_reference="false">string</type>
2915
  </tag>
2916
- <tag line="626" name="param" description="New value for the desired option" type="mixed" variable="$newvalue">
2917
  <type by_reference="false">mixed</type>
2918
  </tag>
2919
- <tag line="626" name="return" description="True if the value was changed or false if the update failed" type="boolean">
2920
  <type by_reference="false">boolean</type>
2921
  </tag>
2922
  </docblock>
2923
- <argument line="636">
2924
  <name>$option</name>
2925
  <default><![CDATA[]]></default>
2926
  <type/>
2927
  </argument>
2928
- <argument line="636">
2929
  <name>$newvalue</name>
2930
  <default><![CDATA[]]></default>
2931
  <type/>
2932
  </argument>
2933
  </method>
2934
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="652" package="Media Library Assistant">
2935
  <name>mla_delete_option</name>
2936
  <full_name>mla_delete_option</full_name>
2937
- <docblock line="643">
2938
  <description><![CDATA[Delete the stored value of a defined MLA option]]></description>
2939
  <long-description><![CDATA[]]></long-description>
2940
- <tag line="643" name="since" description="0.1"/>
2941
- <tag line="643" name="param" description="Name of the desired option" type="string" variable="$option">
2942
  <type by_reference="false">string</type>
2943
  </tag>
2944
- <tag line="643" name="return" description="True if the option was deleted, otherwise false" type="boolean">
2945
  <type by_reference="false">boolean</type>
2946
  </tag>
2947
  </docblock>
2948
- <argument line="652">
2949
  <name>$option</name>
2950
  <default><![CDATA[]]></default>
2951
  <type/>
2952
  </argument>
2953
  </method>
2954
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="673" package="Media Library Assistant">
2955
  <name>mla_taxonomy_support</name>
2956
  <full_name>mla_taxonomy_support</full_name>
2957
- <docblock line="660">
2958
  <description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
2959
  settings are being updated or reset.]]></description>
2960
  <long-description><![CDATA[]]></long-description>
2961
- <tag line="660" name="since" description="0.30"/>
2962
- <tag line="660" name="param" description="Taxonomy name, e.g., attachment_category" type="string" variable="$tax_name">
2963
  <type by_reference="false">string</type>
2964
  </tag>
2965
- <tag line="660" name="param" description="Optional. 'support' (default), 'quick-edit' or 'filter'" type="string" variable="$support_type">
2966
  <type by_reference="false">string</type>
2967
  </tag>
2968
- <tag line="660" 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">
2969
  <type by_reference="false">boolean</type>
2970
  <type by_reference="false">string</type>
2971
  </tag>
2972
  </docblock>
2973
- <argument line="673">
2974
  <name>$tax_name</name>
2975
  <default><![CDATA[]]></default>
2976
  <type/>
2977
  </argument>
2978
- <argument line="673">
2979
  <name>$support_type</name>
2980
  <default><![CDATA['support']]></default>
2981
  <type/>
2982
  </argument>
2983
  </method>
2984
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="749" package="Media Library Assistant">
2985
  <name>mla_taxonomy_option_handler</name>
2986
  <full_name>mla_taxonomy_option_handler</full_name>
2987
- <docblock line="736">
2988
  <description><![CDATA[Render and manage taxonomy support options, e.g., Categories and Post Tags]]></description>
2989
  <long-description><![CDATA[]]></long-description>
2990
- <tag line="736" name="since" description="0.30"/>
2991
- <tag line="736" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
2992
- <tag line="736" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
2993
  <type by_reference="false">string</type>
2994
  </tag>
2995
- <tag line="736" name="param" description="option name, e.g., 'taxonomy_support'" type="string" variable="$key">
2996
  <type by_reference="false">string</type>
2997
  </tag>
2998
- <tag line="736" name="param" description="option parameters" type="array" variable="$value">
2999
  <type by_reference="false">array</type>
3000
  </tag>
3001
- <tag line="736" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
3002
  <type by_reference="false">array</type>
3003
  </tag>
3004
- <tag line="736" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
3005
  <type by_reference="false">string</type>
3006
  </tag>
3007
  </docblock>
3008
- <argument line="749">
3009
  <name>$action</name>
3010
  <default><![CDATA[]]></default>
3011
  <type/>
3012
  </argument>
3013
- <argument line="749">
3014
  <name>$key</name>
3015
  <default><![CDATA[]]></default>
3016
  <type/>
3017
  </argument>
3018
- <argument line="749">
3019
  <name>$value</name>
3020
  <default><![CDATA[]]></default>
3021
  <type/>
3022
  </argument>
3023
- <argument line="749">
3024
  <name>$args</name>
3025
  <default><![CDATA[null]]></default>
3026
  <type/>
3027
  </argument>
3028
  </method>
3029
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="857" package="Media Library Assistant">
3030
  <name>mla_add_attachment_action</name>
3031
  <full_name>mla_add_attachment_action</full_name>
3032
- <docblock line="848">
3033
  <description><![CDATA[Perform ITC/EXIF mapping on just-inserted attachment]]></description>
3034
  <long-description><![CDATA[]]></long-description>
3035
- <tag line="848" name="since" description="1.00"/>
3036
- <tag line="848" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
3037
  <type by_reference="false">integer</type>
3038
  </tag>
3039
- <tag line="848" name="return" description="" type="void">
3040
  <type by_reference="false">void</type>
3041
  </tag>
3042
  </docblock>
3043
- <argument line="857">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3044
  <name>$post_id</name>
3045
  <default><![CDATA[]]></default>
3046
  <type/>
3047
  </argument>
3048
  </method>
3049
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="874" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3050
  <name>mla_evaluate_iptc_exif_mapping</name>
3051
  <full_name>mla_evaluate_iptc_exif_mapping</full_name>
3052
- <docblock line="863">
3053
  <description><![CDATA[Evaluate IPTC/EXIF mapping updates for a post]]></description>
3054
  <long-description><![CDATA[]]></long-description>
3055
- <tag line="863" name="since" description="1.00"/>
3056
- <tag line="863" name="param" description="post object with current values" type="object" variable="$post">
3057
  <type by_reference="false">object</type>
3058
  </tag>
3059
- <tag line="863" name="param" description="category to evaluate against, e.g., iptc_exif_standard_mapping or iptc_exif_mapping" type="string" variable="$category">
3060
  <type by_reference="false">string</type>
3061
  </tag>
3062
- <tag line="863" name="param" description="(optional) iptc_exif_mapping values, default - current option value" type="array" variable="$settings">
3063
  <type by_reference="false">array</type>
3064
  </tag>
3065
- <tag line="863" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
3066
  <type by_reference="false">array</type>
3067
  </tag>
3068
  </docblock>
3069
- <argument line="874">
3070
  <name>$post</name>
3071
  <default><![CDATA[]]></default>
3072
  <type/>
3073
  </argument>
3074
- <argument line="874">
3075
  <name>$category</name>
3076
  <default><![CDATA[]]></default>
3077
  <type/>
3078
  </argument>
3079
- <argument line="874">
3080
  <name>$settings</name>
3081
  <default><![CDATA[NULL]]></default>
3082
  <type/>
3083
  </argument>
3084
  </method>
3085
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1027" package="Media Library Assistant">
3086
  <name>_compose_iptc_option_list</name>
3087
  <full_name>_compose_iptc_option_list</full_name>
3088
- <docblock line="1017">
3089
  <description><![CDATA[Compose an IPTC Options list with current selection]]></description>
3090
  <long-description><![CDATA[]]></long-description>
3091
- <tag line="1017" name="since" description="1.00"/>
3092
- <tag line="1017" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3093
- <tag line="1017" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
3094
  <type by_reference="false">string</type>
3095
  </tag>
3096
- <tag line="1017" name="return" description="HTML markup with select field options" type="string">
3097
  <type by_reference="false">string</type>
3098
  </tag>
3099
  </docblock>
3100
- <argument line="1027">
3101
  <name>$selection</name>
3102
  <default><![CDATA['none']]></default>
3103
  <type/>
3104
  </argument>
3105
  </method>
3106
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1060" package="Media Library Assistant">
3107
  <name>_compose_parent_option_list</name>
3108
  <full_name>_compose_parent_option_list</full_name>
3109
- <docblock line="1049">
3110
  <description><![CDATA[Compose an hierarchical taxonomy Parent options list with current selection]]></description>
3111
  <long-description><![CDATA[]]></long-description>
3112
- <tag line="1049" name="since" description="1.00"/>
3113
- <tag line="1049" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3114
- <tag line="1049" name="param" description="taxonomy slug" type="string" variable="$taxonomy">
3115
  <type by_reference="false">string</type>
3116
  </tag>
3117
- <tag line="1049" name="param" description="current selection or 0 (zero, default)" type="integer" variable="$selection">
3118
  <type by_reference="false">integer</type>
3119
  </tag>
3120
- <tag line="1049" name="return" description="HTML markup with select field options" type="string">
3121
  <type by_reference="false">string</type>
3122
  </tag>
3123
  </docblock>
3124
- <argument line="1060">
3125
  <name>$taxonomy</name>
3126
  <default><![CDATA[]]></default>
3127
  <type/>
3128
  </argument>
3129
- <argument line="1060">
3130
  <name>$selection</name>
3131
  <default><![CDATA[0]]></default>
3132
  <type/>
3133
  </argument>
3134
  </method>
3135
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1094" package="Media Library Assistant">
3136
  <name>_update_iptc_exif_standard_mapping</name>
3137
  <full_name>_update_iptc_exif_standard_mapping</full_name>
3138
- <docblock line="1084">
3139
  <description><![CDATA[Update Standard field portion of IPTC/EXIF mappings]]></description>
3140
  <long-description><![CDATA[]]></long-description>
3141
- <tag line="1084" name="since" description="1.00"/>
3142
- <tag line="1084" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3143
  <type by_reference="false">array</type>
3144
  </tag>
3145
- <tag line="1084" name="param" description="new values" type="array" variable="$new_values">
3146
  <type by_reference="false">array</type>
3147
  </tag>
3148
- <tag line="1084" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
3149
  <type by_reference="false">array</type>
3150
  </tag>
3151
  </docblock>
3152
- <argument line="1094">
3153
  <name>$current_values</name>
3154
  <default><![CDATA[]]></default>
3155
  <type/>
3156
  </argument>
3157
- <argument line="1094">
3158
  <name>$new_values</name>
3159
  <default><![CDATA[]]></default>
3160
  <type/>
3161
  </argument>
3162
  </method>
3163
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1173" package="Media Library Assistant">
3164
  <name>_update_iptc_exif_taxonomy_mapping</name>
3165
  <full_name>_update_iptc_exif_taxonomy_mapping</full_name>
3166
- <docblock line="1163">
3167
  <description><![CDATA[Update Taxonomy term portion of IPTC/EXIF mappings]]></description>
3168
  <long-description><![CDATA[]]></long-description>
3169
- <tag line="1163" name="since" description="1.00"/>
3170
- <tag line="1163" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3171
  <type by_reference="false">array</type>
3172
  </tag>
3173
- <tag line="1163" name="param" description="new values" type="array" variable="$new_values">
3174
  <type by_reference="false">array</type>
3175
  </tag>
3176
- <tag line="1163" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
3177
  <type by_reference="false">array</type>
3178
  </tag>
3179
  </docblock>
3180
- <argument line="1173">
3181
  <name>$current_values</name>
3182
  <default><![CDATA[]]></default>
3183
  <type/>
3184
  </argument>
3185
- <argument line="1173">
3186
  <name>$new_values</name>
3187
  <default><![CDATA[]]></default>
3188
  <type/>
3189
  </argument>
3190
  </method>
3191
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1265" package="Media Library Assistant">
3192
  <name>_update_iptc_exif_custom_mapping</name>
3193
  <full_name>_update_iptc_exif_custom_mapping</full_name>
3194
- <docblock line="1255">
3195
  <description><![CDATA[Update Custom field portion of IPTC/EXIF mappings]]></description>
3196
  <long-description><![CDATA[]]></long-description>
3197
- <tag line="1255" name="since" description="1.00"/>
3198
- <tag line="1255" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3199
  <type by_reference="false">array</type>
3200
  </tag>
3201
- <tag line="1255" name="param" description="new values" type="array" variable="$new_values">
3202
  <type by_reference="false">array</type>
3203
  </tag>
3204
- <tag line="1255" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
3205
  <type by_reference="false">array</type>
3206
  </tag>
3207
  </docblock>
3208
- <argument line="1265">
3209
  <name>$current_values</name>
3210
  <default><![CDATA[]]></default>
3211
  <type/>
3212
  </argument>
3213
- <argument line="1265">
3214
  <name>$new_values</name>
3215
  <default><![CDATA[]]></default>
3216
  <type/>
3217
  </argument>
3218
  </method>
3219
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1361" package="Media Library Assistant">
3220
  <name>_get_custom_field_names</name>
3221
  <full_name>_get_custom_field_names</full_name>
3222
- <docblock line="1354">
3223
  <description><![CDATA[Generate a list of all (post) Custom Field names]]></description>
3224
  <long-description><![CDATA[]]></long-description>
3225
- <tag line="1354" name="since" description="1.00"/>
3226
- <tag line="1354" name="return" description="Custom field names from the postmeta table" type="array">
3227
  <type by_reference="false">array</type>
3228
  </tag>
3229
  </docblock>
3230
  </method>
3231
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1390" package="Media Library Assistant">
3232
  <name>mla_iptc_exif_option_handler</name>
3233
  <full_name>mla_iptc_exif_option_handler</full_name>
3234
- <docblock line="1377">
3235
  <description><![CDATA[Render and manage iptc/exif support options]]></description>
3236
  <long-description><![CDATA[]]></long-description>
3237
- <tag line="1377" name="since" description="1.00"/>
3238
- <tag line="1377" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3239
- <tag line="1377" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
3240
  <type by_reference="false">string</type>
3241
  </tag>
3242
- <tag line="1377" name="param" description="option name, e.g., 'iptc_exif_mapping'" type="string" variable="$key">
3243
  <type by_reference="false">string</type>
3244
  </tag>
3245
- <tag line="1377" name="param" description="option parameters" type="array" variable="$value">
3246
  <type by_reference="false">array</type>
3247
  </tag>
3248
- <tag line="1377" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
3249
  <type by_reference="false">array</type>
3250
  </tag>
3251
- <tag line="1377" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
3252
  <type by_reference="false">string</type>
3253
  </tag>
3254
  </docblock>
3255
- <argument line="1390">
3256
  <name>$action</name>
3257
  <default><![CDATA[]]></default>
3258
  <type/>
3259
  </argument>
3260
- <argument line="1390">
3261
  <name>$key</name>
3262
  <default><![CDATA[]]></default>
3263
  <type/>
3264
  </argument>
3265
- <argument line="1390">
3266
  <name>$value</name>
3267
  <default><![CDATA[]]></default>
3268
  <type/>
3269
  </argument>
3270
- <argument line="1390">
3271
  <name>$args</name>
3272
  <default><![CDATA[null]]></default>
3273
  <type/>
@@ -3275,7 +3656,7 @@ settings are being updated or reset.]]></description>
3275
  </method>
3276
  </class>
3277
  </file>
3278
- <file path="includes\class-mla-settings.php" hash="58c9d18c4a22fab744f3f87104c55582" package="Media Library Assistant">
3279
  <docblock line="2">
3280
  <description><![CDATA[Manages the settings page to edit the plugin option settings]]></description>
3281
  <long-description><![CDATA[]]></long-description>
@@ -3292,53 +3673,32 @@ settings are being updated or reset.]]></description>
3292
  <tag line="9" name="package" description="Media Library Assistant"/>
3293
  <tag line="9" name="since" description="0.1"/>
3294
  </docblock>
3295
- <constant namespace="global" line="28" package="Media Library Assistant">
3296
- <name>MLA_ALT_TEXT_VIEW_SUFFIX</name>
3297
- <full_name>MLA_ALT_TEXT_VIEW_SUFFIX</full_name>
3298
- <value><![CDATA['alt_text_view']]></value>
3299
- <docblock line="25">
3300
- <description><![CDATA[Provides a unique suffix for the ALT Text SQL VIEW]]></description>
3301
- <long-description><![CDATA[]]></long-description>
3302
- </docblock>
3303
- </constant>
3304
- <constant namespace="global" line="33" package="Media Library Assistant">
3305
  <name>MLA_SETTINGS_SLUG</name>
3306
  <full_name>MLA_SETTINGS_SLUG</full_name>
3307
  <value><![CDATA['mla-settings-menu']]></value>
3308
- <docblock line="30">
3309
  <description><![CDATA[Provides a unique name for the settings page]]></description>
3310
  <long-description><![CDATA[]]></long-description>
3311
  </docblock>
3312
  </constant>
3313
- <property final="false" static="true" visibility="public" line="23" namespace="global" package="Media Library Assistant">
3314
- <name>$mla_alt_text_view</name>
3315
- <default><![CDATA[null]]></default>
3316
- <docblock line="16">
3317
- <description><![CDATA[Provides a unique name for the ALT Text SQL VIEW]]></description>
3318
- <long-description><![CDATA[]]></long-description>
3319
- <tag line="16" name="since" description="0.40"/>
3320
- <tag line="16" name="var" description="" type="array">
3321
- <type by_reference="false">array</type>
3322
- </tag>
3323
- </docblock>
3324
- </property>
3325
- <property final="false" static="true" visibility="private" line="416" namespace="global" package="Media Library Assistant">
3326
  <name>$page_template_array</name>
3327
  <default><![CDATA[null]]></default>
3328
- <docblock line="406">
3329
  <description><![CDATA[Template file for the Settings page(s) and parts]]></description>
3330
  <long-description><![CDATA[<p>This array contains all of the template parts for the Settings page(s). The array is built once
3331
  each page load and cached for subsequent use.</p>]]></long-description>
3332
- <tag line="406" name="since" description="0.80"/>
3333
- <tag line="406" name="var" description="" type="array">
3334
  <type by_reference="false">array</type>
3335
  </tag>
3336
  </docblock>
3337
  </property>
3338
- <property final="false" static="true" visibility="private" line="432" namespace="global" package="Media Library Assistant">
3339
  <name>$mla_tablist</name>
3340
- <default><![CDATA[array('general' => array('title' => 'General', 'render' => '_compose_general_tab'), 'mla-gallery' => array('title' => 'MLA Gallery', 'render' => '_compose_mla_gallery_tab'), 'iptc-exif' => array('title' => 'IPTC/EXIF', 'render' => '_compose_iptc_exif_tab'), 'documentation' => array('title' => 'Documentation', 'render' => '_compose_documentation_tab'))]]></default>
3341
- <docblock line="418">
3342
  <description><![CDATA[Definitions for Settings page tab ids, titles and handlers
3343
  Each tab is defined by an array with the following elements:]]></description>
3344
  <long-description><![CDATA[<p>array key => HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)</p>
@@ -3346,353 +3706,416 @@ Each tab is defined by an array with the following elements:]]></description>
3346
  <p>title => tab label / heading text
3347
  render => rendering function for tab messages and content. Usage:
3348
  $tab_content = <a href="">'render'</a>;</p>]]></long-description>
3349
- <tag line="418" name="since" description="0.80"/>
3350
- <tag line="418" name="var" description="" type="array">
3351
  <type by_reference="false">array</type>
3352
  </tag>
3353
  </docblock>
3354
  </property>
3355
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="42" package="Media Library Assistant">
3356
  <name>initialize</name>
3357
  <full_name>initialize</full_name>
3358
- <docblock line="35">
3359
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
3360
  <long-description><![CDATA[]]></long-description>
3361
- <tag line="35" name="since" description="0.1"/>
3362
- <tag line="35" name="return" description="" type="void">
3363
  <type by_reference="false">void</type>
3364
  </tag>
3365
  </docblock>
3366
  </method>
3367
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="58" package="Media Library Assistant">
3368
  <name>_version_upgrade</name>
3369
  <full_name>_version_upgrade</full_name>
3370
- <docblock line="51">
3371
  <description><![CDATA[Database and option update check, for installing new versions]]></description>
3372
  <long-description><![CDATA[]]></long-description>
3373
- <tag line="51" name="since" description="0.30"/>
3374
- <tag line="51" name="return" description="" type="void">
3375
- <type by_reference="false">void</type>
3376
- </tag>
3377
- </docblock>
3378
- </method>
3379
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="100" package="Media Library Assistant">
3380
- <name>_create_alt_text_view</name>
3381
- <full_name>_create_alt_text_view</full_name>
3382
- <docblock line="90">
3383
- <description><![CDATA[Add a view to the database to support sorting the listing on 'ALT Text']]></description>
3384
- <long-description><![CDATA[<p>This function is called on each plugin invocation because the plugin upgrade process
3385
- does not call the activation hook.</p>]]></long-description>
3386
- <tag line="90" name="since" description="0.50"/>
3387
- <tag line="90" name="return" description="" type="void">
3388
  <type by_reference="false">void</type>
3389
  </tag>
3390
  </docblock>
3391
  </method>
3392
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="132" package="Media Library Assistant">
3393
  <name>mla_activation_hook</name>
3394
  <full_name>mla_activation_hook</full_name>
3395
- <docblock line="123">
3396
  <description><![CDATA[Perform one-time actions on plugin activation]]></description>
3397
  <long-description><![CDATA[<p>Adds a view to the database to support sorting the listing on 'ALT Text'.</p>]]></long-description>
3398
- <tag line="123" name="since" description="0.40"/>
3399
- <tag line="123" name="return" description="" type="void">
3400
  <type by_reference="false">void</type>
3401
  </tag>
3402
  </docblock>
3403
  </method>
3404
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="145" package="Media Library Assistant">
3405
  <name>mla_deactivation_hook</name>
3406
  <full_name>mla_deactivation_hook</full_name>
3407
- <docblock line="136">
3408
  <description><![CDATA[Perform one-time actions on plugin deactivation]]></description>
3409
- <long-description><![CDATA[<p>Removes a view from the database that supports sorting the listing on 'ALT Text'.</p>]]></long-description>
3410
- <tag line="136" name="since" description="0.40"/>
3411
- <tag line="136" name="return" description="" type="void">
3412
  <type by_reference="false">void</type>
3413
  </tag>
3414
  </docblock>
3415
  </method>
3416
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="172" package="Media Library Assistant">
3417
  <name>mla_admin_menu_action</name>
3418
  <full_name>mla_admin_menu_action</full_name>
3419
- <docblock line="164">
3420
  <description><![CDATA[Add settings page in the "Settings" section,
3421
  add settings link in the Plugins section entry for MLA.]]></description>
3422
  <long-description><![CDATA[]]></long-description>
3423
- <tag line="164" name="since" description="0.1"/>
3424
- <tag line="164" name="return" description="" type="void">
3425
  <type by_reference="false">void</type>
3426
  </tag>
3427
  </docblock>
3428
  </method>
3429
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="190" package="Media Library Assistant">
3430
  <name>mla_add_plugin_settings_link</name>
3431
  <full_name>mla_add_plugin_settings_link</full_name>
3432
- <docblock line="180">
3433
  <description><![CDATA[Add the "Settings" link to the MLA entry in the Plugins section]]></description>
3434
  <long-description><![CDATA[]]></long-description>
3435
- <tag line="180" name="since" description="0.1"/>
3436
- <tag line="180" name="param" description="array of links for the Plugin, e.g., &quot;Activate&quot;" type="array" variable="$links">
3437
  <type by_reference="false">array</type>
3438
  </tag>
3439
- <tag line="180" name="param" description="Directory and name of the plugin Index file" type="string" variable="$file">
3440
  <type by_reference="false">string</type>
3441
  </tag>
3442
- <tag line="180" name="return" description="Updated array of links for the Plugin" type="array">
3443
  <type by_reference="false">array</type>
3444
  </tag>
3445
  </docblock>
3446
- <argument line="190">
3447
  <name>$links</name>
3448
  <default><![CDATA[]]></default>
3449
  <type/>
3450
  </argument>
3451
- <argument line="190">
3452
  <name>$file</name>
3453
  <default><![CDATA[]]></default>
3454
  <type/>
3455
  </argument>
3456
  </method>
3457
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="210" package="Media Library Assistant">
3458
  <name>_update_option_row</name>
3459
  <full_name>_update_option_row</full_name>
3460
- <docblock line="199">
3461
  <description><![CDATA[Update or delete a single MLA option value]]></description>
3462
  <long-description><![CDATA[]]></long-description>
3463
- <tag line="199" name="since" description="0.80"/>
3464
- <tag line="199" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
3465
- <tag line="199" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
3466
  <type by_reference="false">string</type>
3467
  </tag>
3468
- <tag line="199" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
3469
  <type by_reference="false">array</type>
3470
  </tag>
3471
- <tag line="199" name="return" description="HTML markup for the option's table row" type="string">
3472
  <type by_reference="false">string</type>
3473
  </tag>
3474
  </docblock>
3475
- <argument line="210">
3476
  <name>$key</name>
3477
  <default><![CDATA[]]></default>
3478
  <type/>
3479
  </argument>
3480
- <argument line="210">
3481
  <name>$value</name>
3482
  <default><![CDATA[]]></default>
3483
  <type/>
3484
  </argument>
3485
  </method>
3486
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="288" package="Media Library Assistant">
3487
  <name>_compose_option_row</name>
3488
  <full_name>_compose_option_row</full_name>
3489
- <docblock line="277">
3490
  <description><![CDATA[Compose the table row for a single MLA option]]></description>
3491
  <long-description><![CDATA[]]></long-description>
3492
- <tag line="277" name="since" description="0.80"/>
3493
- <tag line="277" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3494
- <tag line="277" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
3495
  <type by_reference="false">string</type>
3496
  </tag>
3497
- <tag line="277" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
3498
  <type by_reference="false">array</type>
3499
  </tag>
3500
- <tag line="277" name="return" description="HTML markup for the option's table row" type="string">
3501
  <type by_reference="false">string</type>
3502
  </tag>
3503
  </docblock>
3504
- <argument line="288">
3505
  <name>$key</name>
3506
  <default><![CDATA[]]></default>
3507
  <type/>
3508
  </argument>
3509
- <argument line="288">
3510
  <name>$value</name>
3511
  <default><![CDATA[]]></default>
3512
  <type/>
3513
  </argument>
3514
  </method>
3515
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="449" package="Media Library Assistant">
3516
  <name>_compose_settings_tabs</name>
3517
  <full_name>_compose_settings_tabs</full_name>
3518
- <docblock line="439">
3519
  <description><![CDATA[Compose the navigation tabs for the Settings subpage]]></description>
3520
  <long-description><![CDATA[]]></long-description>
3521
- <tag line="439" name="since" description="0.80"/>
3522
- <tag line="439" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3523
- <tag line="439" name="param" description="Optional data-tab-id value for the active tab, default 'general'" type="string" variable="$active_tab">
3524
  <type by_reference="false">string</type>
3525
  </tag>
3526
- <tag line="439" name="return" description="HTML markup for the Settings subpage navigation tabs" type="string">
3527
  <type by_reference="false">string</type>
3528
  </tag>
3529
  </docblock>
3530
- <argument line="449">
3531
  <name>$active_tab</name>
3532
  <default><![CDATA['general']]></default>
3533
  <type/>
3534
  </argument>
3535
  </method>
3536
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="475" package="Media Library Assistant">
3537
  <name>_compose_general_tab</name>
3538
  <full_name>_compose_general_tab</full_name>
3539
- <docblock line="467">
3540
  <description><![CDATA[Compose the General tab content for the Settings subpage]]></description>
3541
  <long-description><![CDATA[]]></long-description>
3542
- <tag line="467" name="since" description="0.80"/>
3543
- <tag line="467" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3544
- <tag line="467" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
3545
  <type by_reference="false">array</type>
3546
  </tag>
3547
  </docblock>
3548
  </method>
3549
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="559" package="Media Library Assistant">
3550
  <name>_compose_mla_gallery_tab</name>
3551
  <full_name>_compose_mla_gallery_tab</full_name>
3552
- <docblock line="551">
3553
  <description><![CDATA[Compose the MLA Gallery tab content for the Settings subpage]]></description>
3554
  <long-description><![CDATA[]]></long-description>
3555
- <tag line="551" name="since" description="0.80"/>
3556
- <tag line="551" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3557
- <tag line="551" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
3558
  <type by_reference="false">array</type>
3559
  </tag>
3560
  </docblock>
3561
  </method>
3562
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="858" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
3563
  <name>_compose_iptc_exif_tab</name>
3564
  <full_name>_compose_iptc_exif_tab</full_name>
3565
- <docblock line="850">
3566
  <description><![CDATA[Compose the IPTC/EXIF tab content for the Settings subpage]]></description>
3567
  <long-description><![CDATA[]]></long-description>
3568
- <tag line="850" name="since" description="1.00"/>
3569
- <tag line="850" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3570
- <tag line="850" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
3571
  <type by_reference="false">array</type>
3572
  </tag>
3573
  </docblock>
3574
  </method>
3575
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="931" package="Media Library Assistant">
3576
  <name>_compose_documentation_tab</name>
3577
  <full_name>_compose_documentation_tab</full_name>
3578
- <docblock line="923">
3579
  <description><![CDATA[Compose the Documentation tab content for the Settings subpage]]></description>
3580
  <long-description><![CDATA[]]></long-description>
3581
- <tag line="923" name="since" description="0.80"/>
3582
- <tag line="923" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3583
- <tag line="923" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
3584
  <type by_reference="false">array</type>
3585
  </tag>
3586
  </docblock>
3587
  </method>
3588
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="950" package="Media Library Assistant">
3589
  <name>mla_render_settings_page</name>
3590
  <full_name>mla_render_settings_page</full_name>
3591
- <docblock line="943">
3592
  <description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
3593
  <long-description><![CDATA[]]></long-description>
3594
- <tag line="943" name="since" description="0.1"/>
3595
- <tag line="943" name="return" description="Echoes HTML markup for the Settings subpage" type="void">
3596
  <type by_reference="false">void</type>
3597
  </tag>
3598
  </docblock>
3599
  </method>
3600
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1000" package="Media Library Assistant">
3601
  <name>_save_gallery_settings</name>
3602
  <full_name>_save_gallery_settings</full_name>
3603
- <docblock line="991">
3604
  <description><![CDATA[Save MLA Gallery settings to the options table]]></description>
3605
  <long-description><![CDATA[]]></long-description>
3606
- <tag line="991" name="since" description="0.80"/>
3607
- <tag line="991" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
3608
- <tag line="991" name="return" description="Message(s) reflecting the results of the operation" type="array">
3609
  <type by_reference="false">array</type>
3610
  </tag>
3611
  </docblock>
3612
  </method>
3613
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1232" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3614
  <name>_process_iptc_exif_standard</name>
3615
  <full_name>_process_iptc_exif_standard</full_name>
3616
- <docblock line="1222">
3617
  <description><![CDATA[Process IPTC/EXIF standard field settings against all image attachments
3618
  without saving the settings to the mla_option]]></description>
3619
  <long-description><![CDATA[]]></long-description>
3620
- <tag line="1222" name="since" description="1.00"/>
3621
- <tag line="1222" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
3622
- <tag line="1222" name="return" description="Message(s) reflecting the results of the operation" type="array">
3623
  <type by_reference="false">array</type>
3624
  </tag>
3625
  </docblock>
3626
  </method>
3627
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1276" package="Media Library Assistant">
3628
  <name>_process_iptc_exif_taxonomy</name>
3629
  <full_name>_process_iptc_exif_taxonomy</full_name>
3630
- <docblock line="1266">
3631
  <description><![CDATA[Process IPTC/EXIF taxonomy term settings against all image attachments
3632
  without saving the settings to the mla_option]]></description>
3633
  <long-description><![CDATA[]]></long-description>
3634
- <tag line="1266" name="since" description="1.00"/>
3635
- <tag line="1266" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
3636
- <tag line="1266" name="return" description="Message(s) reflecting the results of the operation" type="array">
3637
  <type by_reference="false">array</type>
3638
  </tag>
3639
  </docblock>
3640
  </method>
3641
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1321" package="Media Library Assistant">
3642
  <name>_process_iptc_exif_custom</name>
3643
  <full_name>_process_iptc_exif_custom</full_name>
3644
- <docblock line="1311">
3645
  <description><![CDATA[Process IPTC/EXIF custom field settings against all image attachments
3646
  without saving the settings to the mla_option]]></description>
3647
  <long-description><![CDATA[]]></long-description>
3648
- <tag line="1311" name="since" description="1.00"/>
3649
- <tag line="1311" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
3650
- <tag line="1311" name="return" description="Message(s) reflecting the results of the operation" type="array">
3651
  <type by_reference="false">array</type>
3652
  </tag>
3653
  </docblock>
3654
  </method>
3655
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1365" package="Media Library Assistant">
3656
  <name>_save_iptc_exif_settings</name>
3657
  <full_name>_save_iptc_exif_settings</full_name>
3658
- <docblock line="1356">
3659
  <description><![CDATA[Save IPTC/EXIF settings to the options table]]></description>
3660
  <long-description><![CDATA[]]></long-description>
3661
- <tag line="1356" name="since" description="1.00"/>
3662
- <tag line="1356" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
3663
- <tag line="1356" name="return" description="Message(s) reflecting the results of the operation" type="array">
3664
  <type by_reference="false">array</type>
3665
  </tag>
3666
  </docblock>
3667
  </method>
3668
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1402" package="Media Library Assistant">
3669
  <name>_save_general_settings</name>
3670
  <full_name>_save_general_settings</full_name>
3671
- <docblock line="1393">
3672
  <description><![CDATA[Save General settings to the options table]]></description>
3673
  <long-description><![CDATA[]]></long-description>
3674
- <tag line="1393" name="since" description="0.1"/>
3675
- <tag line="1393" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
3676
- <tag line="1393" name="return" description="Message(s) reflecting the results of the operation" type="array">
3677
  <type by_reference="false">array</type>
3678
  </tag>
3679
  </docblock>
3680
  </method>
3681
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1460" package="Media Library Assistant">
3682
  <name>_reset_general_settings</name>
3683
  <full_name>_reset_general_settings</full_name>
3684
- <docblock line="1453">
3685
  <description><![CDATA[Delete saved settings, restoring default values]]></description>
3686
  <long-description><![CDATA[]]></long-description>
3687
- <tag line="1453" name="since" description="0.1"/>
3688
- <tag line="1453" name="return" description="Message(s) reflecting the results of the operation" type="array">
3689
  <type by_reference="false">array</type>
3690
  </tag>
3691
  </docblock>
3692
  </method>
3693
  </class>
3694
  </file>
3695
- <file path="includes\class-mla-shortcodes.php" hash="81847954de4a0349181a8fca0aac37a9" package="Media Library Assistant">
3696
  <docblock line="2">
3697
  <description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
3698
  <long-description><![CDATA[]]></long-description>
@@ -3733,67 +4156,67 @@ without saving the settings to the mla_option]]></description>
3733
  </tag>
3734
  </docblock>
3735
  </property>
3736
- <property final="false" static="true" visibility="private" line="1006" namespace="global" package="Media Library Assistant">
3737
  <name>$mla_iptc_records</name>
3738
  <default><![CDATA[array("1#000" => "Model Version", "1#005" => "Destination", "1#020" => "File Format", "1#022" => "File Format Version", "1#030" => "Service Identifier", "1#040" => "Envelope Number", "1#050" => "Product ID", "1#060" => "Envelope Priority", "1#070" => "Date Sent", "1#080" => "Time Sent", "1#090" => "Coded Character Set", "1#100" => "UNO", "1#120" => "ARM Identifier", "1#122" => "ARM Version", "2#000" => "Record Version", "2#003" => "Object Type Reference", "2#004" => "Object Attribute Reference", "2#005" => "Object Name", "2#007" => "Edit Status", "2#008" => "Editorial Update", "2#010" => "Urgency", "2#012" => "Subject Reference", "2#015" => "Category", "2#020" => "Supplemental Category", "2#022" => "Fixture Identifier", "2#025" => "Keywords", "2#026" => "Content Location Code", "2#027" => "Content Location Name", "2#030" => "Release Date", "2#035" => "Release Time", "2#037" => "Expiration Date", "2#038" => "Expiration Time", "2#040" => "Special Instructions", "2#042" => "Action Advised", "2#045" => "Reference Service", "2#047" => "Reference Date", "2#050" => "Reference Number", "2#055" => "Date Created", "2#060" => "Time Created", "2#062" => "Digital Creation Date", "2#063" => "Digital Creation Time", "2#065" => "Originating Program", "2#070" => "Program Version", "2#075" => "Object Cycle", "2#080" => "By-line", "2#085" => "By-line Title", "2#090" => "City", "2#092" => "Sub-location", "2#095" => "Province or State", "2#100" => "Country or Primary Location Code", "2#101" => "Country or Primary Location Name", "2#103" => "Original Transmission Reference", "2#105" => "Headline", "2#110" => "Credit", "2#115" => "Source", "2#116" => "Copyright Notice", "2#118" => "Contact", "2#120" => "Caption or Abstract", "2#122" => "Caption Writer or Editor", "2#125" => "Rasterized Caption", "2#130" => "Image Type", "2#131" => "Image Orientation", "2#135" => "Language Identifier", "2#150" => "Audio Type", "2#151" => "Audio Sampling Rate", "2#152" => "Audio Sampling Resolution", "2#153" => "Audio Duration", "2#154" => "Audio Outcue", "2#200" => "ObjectData Preview File Format", "2#201" => "ObjectData Preview File Format Version", "2#202" => "ObjectData Preview Data", "7#010" => "Size Mode", "7#020" => "Max Subfile Size", "7#090" => "ObjectData Size Announced", "7#095" => "Maximum ObjectData Size", "8#010" => "Subfile", "9#010" => "Confirmed ObjectData Size")]]></default>
3739
- <docblock line="996">
3740
  <description><![CDATA[IPTC Dataset identifiers and names]]></description>
3741
  <long-description><![CDATA[<p>This array contains the identifiers and names of Datasets defined in
3742
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
3743
- <tag line="996" name="since" description="0.90"/>
3744
- <tag line="996" name="var" description="" type="array">
3745
  <type by_reference="false">array</type>
3746
  </tag>
3747
  </docblock>
3748
  </property>
3749
- <property final="false" static="true" visibility="public" line="1105" namespace="global" package="Media Library Assistant">
3750
  <name>$mla_iptc_keys</name>
3751
  <default><![CDATA[array('model-version' => '1#000', 'destination' => '1#005', 'file-format' => '1#020', 'file-format-version' => '1#022', 'service-identifier' => '1#030', 'envelope-number' => '1#040', 'product-id' => '1#050', 'envelope-priority' => '1#060', 'date-sent' => '1#070', 'time-sent' => '1#080', 'coded-character-set' => '1#090', 'uno' => '1#100', 'arm-identifier' => '1#120', 'arm-version' => '1#122', 'record-version' => '2#000', 'object-type-reference' => '2#003', 'object-attribute-reference' => '2#004', 'object-name' => '2#005', 'edit-status' => '2#007', 'editorial-update' => '2#008', 'urgency' => '2#010', 'subject-reference' => '2#012', 'category' => '2#015', 'supplemental-category' => '2#020', 'fixture-identifier' => '2#022', 'keywords' => '2#025', 'content-location-code' => '2#026', 'content-location-name' => '2#027', 'release-date' => '2#030', 'release-time' => '2#035', 'expiration-date' => '2#037', 'expiration-time' => '2#038', 'special-instructions' => '2#040', 'action-advised' => '2#042', 'reference-service' => '2#045', 'reference-date' => '2#047', 'reference-number' => '2#050', 'date-created' => '2#055', 'time-created' => '2#060', 'digital-creation-date' => '2#062', 'digital-creation-time' => '2#063', 'originating-program' => '2#065', 'program-version' => '2#070', 'object-cycle' => '2#075', 'by-line' => '2#080', 'by-line-title' => '2#085', 'city' => '2#090', 'sub-location' => '2#092', 'province-or-state' => '2#095', 'country-or-primary-location-code' => '2#100', 'country-or-primary-location-name' => '2#101', 'original-transmission-reference' => '2#103', 'headline' => '2#105', 'credit' => '2#110', 'source' => '2#115', 'copyright-notice' => '2#116', 'contact' => '2#118', 'caption-or-abstract' => '2#120', 'caption-writer-or-editor' => '2#122', 'rasterized-caption' => '2#125', 'image-type' => '2#130', 'image-orientation' => '2#131', 'language-identifier' => '2#135', 'audio-type' => '2#150', 'audio-sampling-rate' => '2#151', 'audio-sampling-resolution' => '2#152', 'audio-duration' => '2#153', 'audio-outcue' => '2#154', 'objectdata-preview-file-format' => '2#200', 'objectdata-preview-file-format-version' => '2#201', 'objectdata-preview-data' => '2#202', 'size-mode' => '7#010', 'max-subfile-size' => '7#020', 'objectdata-size-announced' => '7#090', 'maximum-objectdata-size' => '7#095', 'subfile' => '8#010', 'confirmed-objectdata-size' => '9#010')]]></default>
3752
- <docblock line="1095">
3753
  <description><![CDATA[IPTC Dataset friendly name/slug and identifiers]]></description>
3754
  <long-description><![CDATA[<p>This array contains the sanitized names and identifiers of Datasets defined in
3755
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
3756
- <tag line="1095" name="since" description="0.90"/>
3757
- <tag line="1095" name="var" description="" type="array">
3758
  <type by_reference="false">array</type>
3759
  </tag>
3760
  </docblock>
3761
  </property>
3762
- <property final="false" static="true" visibility="private" line="1204" namespace="global" package="Media Library Assistant">
3763
  <name>$mla_iptc_descriptions</name>
3764
  <default><![CDATA[array("1#000" => "2 octet binary IIM version number", "1#005" => "Max 1024 characters of Destination (ISO routing information); repeatable", "1#020" => "2 octet binary file format number, see IPTC-NAA V4 Appendix A", "1#022" => "2 octet binary file format version number", "1#030" => "Max 10 characters of Service Identifier and product", "1#040" => "8 Character Envelope Number", "1#050" => "Max 32 characters subset of provider's overall service; repeatable", "1#060" => "1 numeric character of envelope handling priority (not urgency)", "1#070" => "8 numeric characters of Date Sent by service - CCYYMMDD", "1#080" => "11 characters of Time Sent by service - HHMMSS±HHMM", "1#090" => "Max 32 characters of control functions, etc.", "1#100" => "14 to 80 characters of eternal, globally unique identification for objects", "1#120" => "2 octet binary Abstract Relationship Model Identifier", "1#122" => "2 octet binary Abstract Relationship Model Version", "2#000" => "2 octet binary Information Interchange Model, Part II version number", "2#003" => "3 to 67 Characters of Object Type Reference number and optional text", "2#004" => "3 to 67 Characters of Object Attribute Reference number and optional text; repeatable", "2#005" => "Max 64 characters of the object name or shorthand reference", "2#007" => "Max 64 characters of the status of the objectdata", "2#008" => "2 numeric characters of the type of update this object provides", "2#010" => "1 numeric character of the editorial urgency of content", "2#012" => "13 to 236 characters of a structured definition of the subject matter; repeatable", "2#015" => "Max 3 characters of the subject of the objectdata, DEPRECATED", "2#020" => "Max 32 characters (each) of further refinement of subject, DEPRECATED; repeatable", "2#022" => "Max 32 characters identifying recurring, predictable content", "2#025" => "Max 64 characters (each) of tags; repeatable", "2#026" => "3 characters of ISO3166 country code or IPTC-assigned code; repeatable", "2#027" => "Max 64 characters of publishable country/geographical location name; repeatable", "2#030" => "8 numeric characters of Release Date - CCYYMMDD", "2#035" => "11 characters of Release Time (earliest use) - HHMMSS±HHMM", "2#037" => "8 numeric characters of Expiration Date (latest use) - CCYYMDD", "2#038" => "11 characters of Expiration Time (latest use) - HHMMSS±HHMM", "2#040" => "Max 256 Characters of editorial instructions, e.g., embargoes and warnings", "2#042" => "2 numeric characters of type of action this object provides to a previous object", "2#045" => "Max 10 characters of the Service ID (1#030) of a prior envelope; repeatable", "2#047" => "8 numeric characters of prior envelope Reference Date (1#070) - CCYYMMDD; repeatable", "2#050" => "8 characters of prior envelope Reference Number (1#040); repeatable", "2#055" => "8 numeric characters of intellectual content Date Created - CCYYMMDD", "2#060" => "11 characters of intellectual content Time Created - HHMMSS±HHMM", "2#062" => "8 numeric characters of digital representation creation date - CCYYMMDD", "2#063" => "11 characters of digital representation creation time - HHMMSS±HHMM", "2#065" => "Max 32 characters of the program used to create the objectdata", "2#070" => "Program Version - Max 10 characters of the version of the program used to create the objectdata", "2#075" => "1 character where a=morning, p=evening, b=both", "2#080" => "Max 32 Characters of the name of the objectdata creator, e.g., the writer, photographer; repeatable", "2#085" => "Max 32 characters of the title of the objectdata creator; repeatable", "2#090" => "Max 32 Characters of the city of objectdata origin", "2#092" => "Max 32 Characters of the location within the city of objectdata origin", "2#095" => "Max 32 Characters of the objectdata origin Province or State", "2#100" => "3 characters of ISO3166 or IPTC-assigned code for Country of objectdata origin", "2#101" => "Max 64 characters of publishable country/geographical location name of objectdata origin", "2#103" => "Max 32 characters of a code representing the location of original transmission", "2#105" => "Max 256 Characters of a publishable entry providing a synopsis of the contents of the objectdata", "2#110" => "Max 32 Characters that identifies the provider of the objectdata (Vs the owner/creator)", "2#115" => "Max 32 Characters that identifies the original owner of the intellectual content", "2#116" => "Max 128 Characters that contains any necessary copyright notice", "2#118" => "Max 128 characters that identifies the person or organisation which can provide further background information; repeatable", "2#120" => "Max 2000 Characters of a textual description of the objectdata", "2#122" => "Max 32 Characters that the identifies the person involved in the writing, editing or correcting the objectdata or caption/abstract; repeatable", "2#125" => "7360 binary octets of the rasterized caption - 1 bit per pixel, 460x128-pixel image", "2#130" => "2 characters of color composition type and information", "2#131" => "1 alphabetic character indicating the image area layout - P=portrait, L=landscape, S=square", "2#135" => "2 or 3 aphabetic characters containing the major national language of the object, according to the ISO 639:1988 codes", "2#150" => "2 characters identifying monaural/stereo and exact type of audio content", "2#151" => "6 numeric characters representing the audio sampling rate in hertz (Hz)", "2#152" => "2 numeric characters representing the number of bits in each audio sample", "2#153" => "6 numeric characters of the Audio Duration - HHMMSS", "2#154" => "Max 64 characters of the content of the end of an audio objectdata", "2#200" => "2 octet binary file format of the ObjectData Preview", "2#201" => "2 octet binary particular version of the ObjectData Preview File Format", "2#202" => "Max 256000 binary octets containing the ObjectData Preview data", "7#010" => "1 numeric character - 0=objectdata size not known, 1=objectdata size known at beginning of transfer", "7#020" => "4 octet binary maximum subfile dataset(s) size", "7#090" => "4 octet binary objectdata size if known at beginning of transfer", "7#095" => "4 octet binary largest possible objectdata size", "8#010" => "Subfile DataSet containing the objectdata itself; repeatable", "9#010" => "4 octet binary total objectdata size")]]></default>
3765
- <docblock line="1194">
3766
  <description><![CDATA[IPTC Dataset descriptions]]></description>
3767
  <long-description><![CDATA[<p>This array contains the descriptions of Datasets defined in
3768
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
3769
- <tag line="1194" name="since" description="0.90"/>
3770
- <tag line="1194" name="var" description="" type="array">
3771
  <type by_reference="false">array</type>
3772
  </tag>
3773
  </docblock>
3774
  </property>
3775
- <property final="false" static="true" visibility="private" line="1303" namespace="global" package="Media Library Assistant">
3776
  <name>$mla_iptc_formats</name>
3777
  <default><![CDATA[array(0 => "No ObjectData", 1 => "IPTC-NAA Digital Newsphoto Parameter Record", 2 => "IPTC7901 Recommended Message Format", 3 => "Tagged Image File Format (Adobe/Aldus Image data)", 4 => "Illustrator (Adobe Graphics data)", 5 => "AppleSingle (Apple Computer Inc)", 6 => "NAA 89-3 (ANPA 1312)", 7 => "MacBinary II", 0 => "IPTC Unstructured Character Oriented File Format (UCOFF)", 0 => "United Press International ANPA 1312 variant", 10 => "United Press International Down-Load Message", 11 => "JPEG File Interchange (JFIF)", 12 => "Photo-CD Image-Pac (Eastman Kodak)", 13 => "Microsoft Bit Mapped Graphics File [*.BMP]", 14 => "Digital Audio File [*.WAV] (Microsoft & Creative Labs)", 15 => "Audio plus Moving Video [*.AVI] (Microsoft)", 16 => "PC DOS/Windows Executable Files [*.COM][*.EXE]", 17 => "Compressed Binary File [*.ZIP] (PKWare Inc)", 18 => "Audio Interchange File Format AIFF (Apple Computer Inc)", 19 => "RIFF Wave (Microsoft Corporation)", 20 => "Freehand (Macromedia/Aldus)", 21 => "Hypertext Markup Language - HTML (The Internet Society)", 22 => "MPEG 2 Audio Layer 2 (Musicom), ISO/IEC", 23 => "MPEG 2 Audio Layer 3, ISO/IEC", 24 => "Portable Document File (*.PDF) Adobe", 25 => "News Industry Text Format (NITF)", 26 => "Tape Archive (*.TAR)", 27 => "Tidningarnas Telegrambyrå NITF version (TTNITF DTD)", 28 => "Ritzaus Bureau NITF version (RBNITF DTD)", 29 => "Corel Draw [*.CDR]")]]></default>
3778
- <docblock line="1293">
3779
  <description><![CDATA[IPTC file format identifiers and descriptions]]></description>
3780
  <long-description><![CDATA[<p>This array contains the file format identifiers and descriptions defined in
3781
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 1#020.</p>]]></long-description>
3782
- <tag line="1293" name="since" description="0.90"/>
3783
- <tag line="1293" name="var" description="" type="array">
3784
  <type by_reference="false">array</type>
3785
  </tag>
3786
  </docblock>
3787
  </property>
3788
- <property final="false" static="true" visibility="private" line="1346" namespace="global" package="Media Library Assistant">
3789
  <name>$mla_iptc_image_types</name>
3790
  <default><![CDATA[array("M" => "Monochrome", "Y" => "Yellow Component", "M" => "Magenta Component", "C" => "Cyan Component", "K" => "Black Component", "R" => "Red Component", "G" => "Green Component", "B" => "Blue Component", "T" => "Text Only", "F" => "Full colour composite, frame sequential", "L" => "Full colour composite, line sequential", "P" => "Full colour composite, pixel sequential", "S" => "Full colour composite, special interleaving")]]></default>
3791
- <docblock line="1336">
3792
  <description><![CDATA[IPTC image type identifiers and descriptions]]></description>
3793
  <long-description><![CDATA[<p>This array contains the image type identifiers and descriptions defined in
3794
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 2#130, octet 2.</p>]]></long-description>
3795
- <tag line="1336" name="since" description="0.90"/>
3796
- <tag line="1336" name="var" description="" type="array">
3797
  <type by_reference="false">array</type>
3798
  </tag>
3799
  </docblock>
@@ -3844,51 +4267,51 @@ Enhancements include many additional selection parameters and full taxonomy supp
3844
  <type/>
3845
  </argument>
3846
  </method>
3847
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="659" package="Media Library Assistant">
3848
  <name>mla_get_shortcode_attachments</name>
3849
  <full_name>mla_get_shortcode_attachments</full_name>
3850
- <docblock line="649">
3851
  <description><![CDATA[Parses shortcode parameters and returns the gallery objects]]></description>
3852
  <long-description><![CDATA[]]></long-description>
3853
- <tag line="649" name="since" description=".50"/>
3854
- <tag line="649" name="param" description="Post ID of the parent" type="int" variable="$post_parent">
3855
  <type by_reference="false">int</type>
3856
  </tag>
3857
- <tag line="649" name="param" description="Attributes of the shortcode" type="array" variable="$attr">
3858
  <type by_reference="false">array</type>
3859
  </tag>
3860
- <tag line="649" name="return" description="List of attachments returned from WP_Query" type="array">
3861
  <type by_reference="false">array</type>
3862
  </tag>
3863
  </docblock>
3864
- <argument line="659">
3865
  <name>$post_parent</name>
3866
  <default><![CDATA[]]></default>
3867
  <type/>
3868
  </argument>
3869
- <argument line="659">
3870
  <name>$attr</name>
3871
  <default><![CDATA[]]></default>
3872
  <type/>
3873
  </argument>
3874
  </method>
3875
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="979" package="Media Library Assistant">
3876
  <name>mla_shortcode_query_posts_where_filter</name>
3877
  <full_name>mla_shortcode_query_posts_where_filter</full_name>
3878
- <docblock line="966">
3879
  <description><![CDATA[Filters the WHERE clause for shortcode queries]]></description>
3880
  <long-description><![CDATA[<p>Captures debug information. Adds whitespace to the post_type = 'attachment'
3881
  phrase to circumvent subsequent Role Scoper modification of the clause.
3882
  Defined as public because it's a filter.</p>]]></long-description>
3883
- <tag line="966" name="since" description="0.70"/>
3884
- <tag line="966" name="param" description="query clause before modification" type="string" variable="$where_clause">
3885
  <type by_reference="false">string</type>
3886
  </tag>
3887
- <tag line="966" name="return" description="query clause after modification" type="string">
3888
  <type by_reference="false">string</type>
3889
  </tag>
3890
  </docblock>
3891
- <argument line="979">
3892
  <name>$where_clause</name>
3893
  <default><![CDATA[]]></default>
3894
  <type/>
@@ -3941,13 +4364,13 @@ This file is only loaded if the naming conflict tests in index.php are passed.</
3941
  </docblock>
3942
  </constant>
3943
  </file>
3944
- <file path="index.php" hash="841b32bdaac4ba91f25f6d7565bb7bf7" package="Media Library Assistant">
3945
  <docblock line="2">
3946
  <description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
3947
  <long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
3948
  will the rest of the plugin be loaded and run.</p>]]></long-description>
3949
  <tag line="2" name="package" description="Media Library Assistant"/>
3950
- <tag line="2" name="version" description="1.00"/>
3951
  </docblock>
3952
  <include line="103" type="Require Once" package="Media Library Assistant">
3953
  <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="650c4819a7b60b57674aae8b2c342023" 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
+ <constant namespace="global" line="24" package="Media Library Assistant">
22
+ <name>MLA_ALT_TEXT_VIEW_SUFFIX</name>
23
+ <full_name>MLA_ALT_TEXT_VIEW_SUFFIX</full_name>
24
+ <value><![CDATA['alt_text_view']]></value>
25
+ <docblock line="19">
26
+ <description><![CDATA[Provides a unique suffix for the ALT Text SQL VIEW]]></description>
27
+ <long-description><![CDATA[]]></long-description>
28
+ <tag line="19" name="since" description="0.40"/>
29
+ </docblock>
30
+ </constant>
31
+ <property final="false" static="true" visibility="private" line="33" namespace="global" package="Media Library Assistant">
32
+ <name>$mla_alt_text_view</name>
33
+ <default><![CDATA[NULL]]></default>
34
+ <docblock line="26">
35
+ <description><![CDATA[Provides a unique name for the ALT Text SQL VIEW]]></description>
36
+ <long-description><![CDATA[]]></long-description>
37
+ <tag line="26" name="since" description="0.40"/>
38
+ <tag line="26" name="var" description="" type="array">
39
+ <type by_reference="false">array</type>
40
+ </tag>
41
+ </docblock>
42
+ </property>
43
+ <property final="false" static="true" visibility="private" line="286" namespace="global" package="Media Library Assistant">
44
  <name>$query_parameters</name>
45
  <default><![CDATA[array()]]></default>
46
+ <docblock line="275">
47
  <description><![CDATA[WP_Query filter "parameters"]]></description>
48
  <long-description><![CDATA[<p>This array defines parameters for the query's join, where and orderby filters.
49
  The parameters are set up in the _prepare_list_table_query function, and
50
  any further logic required to translate those values is contained in the filters.</p>]]></long-description>
51
+ <tag line="275" name="since" description="0.30"/>
52
+ <tag line="275" name="var" description="" type="array">
53
  <type by_reference="false">array</type>
54
  </tag>
55
  </docblock>
56
  </property>
57
+ <property final="false" static="true" visibility="private" line="1159" namespace="global" package="Media Library Assistant">
58
  <name>$galleries</name>
59
  <default><![CDATA[null]]></default>
60
+ <docblock line="1141">
61
  <description><![CDATA[Objects containing [gallery] shortcodes]]></description>
62
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [gallery] shortcodes
63
  and array(s) of which attachments each [gallery] contains. The arrays are built once
69
  ['parent_type'] 'post' or 'page' or the custom post_type of the gallery parent,
70
  ['query'] contains a string with the arguments of the [gallery],
71
  ['results'] contains an array of post_ids for the objects in the gallery.</p>]]></long-description>
72
+ <tag line="1141" name="since" description="0.70"/>
73
+ <tag line="1141" name="var" description="" type="array">
74
  <type by_reference="false">array</type>
75
  </tag>
76
  </docblock>
77
  </property>
78
+ <property final="false" static="true" visibility="private" line="1172" namespace="global" package="Media Library Assistant">
79
  <name>$mla_galleries</name>
80
  <default><![CDATA[null]]></default>
81
+ <docblock line="1161">
82
  <description><![CDATA[Objects containing [mla_gallery] shortcodes]]></description>
83
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [mla_gallery] shortcodes
84
  and array(s) of which attachments each [mla_gallery] contains. The arrays are built once
85
  each page load and cached for subsequent calls.</p>]]></long-description>
86
+ <tag line="1161" name="since" description="0.70"/>
87
+ <tag line="1161" name="var" description="" type="array">
88
  <type by_reference="false">array</type>
89
  </tag>
90
  </docblock>
91
  </property>
92
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="40" package="Media Library Assistant">
93
  <name>initialize</name>
94
  <full_name>initialize</full_name>
95
+ <docblock line="35">
96
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
97
  <long-description><![CDATA[]]></long-description>
98
+ <tag line="35" name="since" description="0.1"/>
99
  </docblock>
100
  </method>
101
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="67" package="Media Library Assistant">
102
  <name>mla_load_template</name>
103
  <full_name>mla_load_template</full_name>
104
+ <docblock line="49">
105
  <description><![CDATA[Load an HTML template from a file]]></description>
106
  <long-description><![CDATA[<p>Loads a template to a string or a multi-part template to an array.
107
  Multi-part templates are divided by comments of the form <!-- template="key" -->,
108
  where "key" becomes the key part of the array.</p>]]></long-description>
109
+ <tag line="49" name="since" description="0.1"/>
110
+ <tag line="49" name="param" description="Complete path and name of the template file, option name or the raw template" type="string" variable="$source">
111
  <type by_reference="false">string</type>
112
  </tag>
113
+ <tag line="49" name="param" description="Optional type of template source; 'file' (default), 'option', 'string'" type="string" variable="$type">
114
  <type by_reference="false">string</type>
115
  </tag>
116
+ <tag line="49" 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">
117
  <type by_reference="false">string</type>
118
  <type by_reference="false">array</type>
119
  <type by_reference="false">false</type>
120
  <type by_reference="false">NULL</type>
121
  </tag>
122
  </docblock>
123
+ <argument line="67">
124
  <name>$source</name>
125
  <default><![CDATA[]]></default>
126
  <type/>
127
  </argument>
128
+ <argument line="67">
129
  <name>$type</name>
130
  <default><![CDATA['file']]></default>
131
  <type/>
132
  </argument>
133
  </method>
134
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="162" package="Media Library Assistant">
135
  <name>mla_parse_template</name>
136
  <full_name>mla_parse_template</full_name>
137
+ <docblock line="150">
138
  <description><![CDATA[Expand a template, replacing place holders with their values]]></description>
139
  <long-description><![CDATA[<p>A simple parsing function for basic templating.</p>]]></long-description>
140
+ <tag line="150" name="since" description="0.1"/>
141
+ <tag line="150" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
142
  <type by_reference="false">string</type>
143
  </tag>
144
+ <tag line="150" name="param" description="An associative array containing keys and values e.g. array('key' =&gt; 'value')" type="array" variable="$hash">
145
  <type by_reference="false">array</type>
146
  </tag>
147
+ <tag line="150" name="return" description="Placeholders corresponding to the keys of the hash will be replaced with their values" type="string">
148
  <type by_reference="false">string</type>
149
  </tag>
150
  </docblock>
151
+ <argument line="162">
152
  <name>$tpl</name>
153
  <default><![CDATA[]]></default>
154
  <type/>
155
  </argument>
156
+ <argument line="162">
157
  <name>$hash</name>
158
  <default><![CDATA[]]></default>
159
  <type/>
160
  </argument>
161
  </method>
162
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="181" package="Media Library Assistant">
163
  <name>mla_get_template_placeholders</name>
164
  <full_name>mla_get_template_placeholders</full_name>
165
+ <docblock line="171">
166
  <description><![CDATA[Analyze a template, returning an array of the place holders it contains]]></description>
167
  <long-description><![CDATA[]]></long-description>
168
+ <tag line="171" name="since" description="0.90"/>
169
+ <tag line="171" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
170
  <type by_reference="false">string</type>
171
  </tag>
172
+ <tag line="171" name="return" description="Placeholder information: each entry is an array with ['prefix'] =&gt; string, ['value'] =&gt; string, ['single'] =&gt; boolean" type="array">
173
  <type by_reference="false">array</type>
174
  </tag>
175
  </docblock>
176
+ <argument line="181">
177
  <name>$tpl</name>
178
  <default><![CDATA[]]></default>
179
  <type/>
180
  </argument>
181
  </method>
182
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="223" package="Media Library Assistant">
183
  <name>mla_count_list_table_items</name>
184
  <full_name>mla_count_list_table_items</full_name>
185
+ <docblock line="214">
186
  <description><![CDATA[Get the total number of attachment posts]]></description>
187
  <long-description><![CDATA[]]></long-description>
188
+ <tag line="214" name="since" description="0.30"/>
189
+ <tag line="214" name="param" description="Query variables, e.g., from $_REQUEST" type="array" variable="$request">
190
  <type by_reference="false">array</type>
191
  </tag>
192
+ <tag line="214" name="return" description="Number of attachment posts" type="integer">
193
  <type by_reference="false">integer</type>
194
  </tag>
195
  </docblock>
196
+ <argument line="223">
197
  <name>$request</name>
198
  <default><![CDATA[]]></default>
199
  <type/>
200
  </argument>
201
  </method>
202
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="244" package="Media Library Assistant">
203
  <name>mla_query_list_table_items</name>
204
  <full_name>mla_query_list_table_items</full_name>
205
+ <docblock line="230">
206
  <description><![CDATA[Retrieve attachment objects for list table display]]></description>
207
  <long-description><![CDATA[<p>Supports prepare_items in class-mla-list-table.php.
208
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
209
+ <tag line="230" name="since" description="0.1"/>
210
+ <tag line="230" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
211
  <type by_reference="false">array</type>
212
  </tag>
213
+ <tag line="230" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
214
  <type by_reference="false">int</type>
215
  </tag>
216
+ <tag line="230" name="param" description="number of rows on each page" type="int" variable="$count">
217
  <type by_reference="false">int</type>
218
  </tag>
219
+ <tag line="230" name="return" description="attachment objects (posts) including parent data, meta data and references" type="array">
220
  <type by_reference="false">array</type>
221
  </tag>
222
  </docblock>
223
+ <argument line="244">
224
  <name>$request</name>
225
  <default><![CDATA[]]></default>
226
  <type/>
227
  </argument>
228
+ <argument line="244">
229
  <name>$offset</name>
230
  <default><![CDATA[]]></default>
231
  <type/>
232
  </argument>
233
+ <argument line="244">
234
  <name>$count</name>
235
  <default><![CDATA[]]></default>
236
  <type/>
237
  </argument>
238
  </method>
239
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="302" package="Media Library Assistant">
240
  <name>_prepare_list_table_query</name>
241
  <full_name>_prepare_list_table_query</full_name>
242
+ <docblock line="288">
243
  <description><![CDATA[Sanitize and expand query arguments from request variables]]></description>
244
  <long-description><![CDATA[<p>Prepare the arguments for WP_Query.
245
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
246
+ <tag line="288" name="since" description="0.1"/>
247
+ <tag line="288" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$raw_request">
248
  <type by_reference="false">array</type>
249
  </tag>
250
+ <tag line="288" name="param" description="Optional number of rows (default 0) to skip over to reach desired page" type="int" variable="$offset">
251
  <type by_reference="false">int</type>
252
  </tag>
253
+ <tag line="288" name="param" description="Optional number of rows on each page (0 = all rows, default)" type="int" variable="$count">
254
  <type by_reference="false">int</type>
255
  </tag>
256
+ <tag line="288" name="return" description="revised arguments suitable for WP_Query" type="array">
257
  <type by_reference="false">array</type>
258
  </tag>
259
  </docblock>
260
+ <argument line="302">
261
  <name>$raw_request</name>
262
  <default><![CDATA[]]></default>
263
  <type/>
264
  </argument>
265
+ <argument line="302">
266
  <name>$offset</name>
267
  <default><![CDATA[0]]></default>
268
  <type/>
269
  </argument>
270
+ <argument line="302">
271
  <name>$count</name>
272
  <default><![CDATA[0]]></default>
273
  <type/>
274
  </argument>
275
  </method>
276
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="537" package="Media Library Assistant">
277
  <name>_execute_list_table_query</name>
278
  <full_name>_execute_list_table_query</full_name>
279
+ <docblock line="528">
280
  <description><![CDATA[Add filters, run query, remove filters]]></description>
281
  <long-description><![CDATA[]]></long-description>
282
+ <tag line="528" name="since" description="0.30"/>
283
+ <tag line="528" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
284
  <type by_reference="false">array</type>
285
  </tag>
286
+ <tag line="528" name="return" description="WP_Query object with query results" type="object">
287
  <type by_reference="false">object</type>
288
  </tag>
289
  </docblock>
290
+ <argument line="537">
291
  <name>$request</name>
292
  <default><![CDATA[]]></default>
293
  <type/>
294
  </argument>
295
  </method>
296
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="590" package="Media Library Assistant">
297
  <name>mla_query_posts_search_filter</name>
298
  <full_name>mla_query_posts_search_filter</full_name>
299
+ <docblock line="578">
300
  <description><![CDATA[Adds a keyword search to the WHERE clause, if required]]></description>
301
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
302
+ <tag line="578" name="since" description="0.60"/>
303
+ <tag line="578" name="param" description="query clause before modification" type="string" variable="$search_string">
304
  <type by_reference="false">string</type>
305
  </tag>
306
+ <tag line="578" name="param" description="WP_Query object" type="object" variable="$query_object">
307
  <type by_reference="false">object</type>
308
  </tag>
309
+ <tag line="578" name="return" description="query clause after keyword search addition" type="string">
310
  <type by_reference="false">string</type>
311
  </tag>
312
  </docblock>
313
+ <argument line="590">
314
  <name>$search_string</name>
315
  <default><![CDATA[]]></default>
316
  <type/>
317
  </argument>
318
+ <argument line="590">
319
  <name>$query_object</name>
320
  <default><![CDATA[]]></default>
321
  <type/>
322
  </argument>
323
  </method>
324
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="663" package="Media Library Assistant">
325
  <name>mla_query_posts_join_filter</name>
326
  <full_name>mla_query_posts_join_filter</full_name>
327
+ <docblock line="652">
328
+ <description><![CDATA[Adds a JOIN clause, if required, to handle sorting/searching on ALT Text]]></description>
329
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
330
+ <tag line="652" name="since" description="0.30"/>
331
+ <tag line="652" name="param" description="query clause before modification" type="string" variable="$join_clause">
332
  <type by_reference="false">string</type>
333
  </tag>
334
+ <tag line="652" name="return" description="query clause after &quot;LEFT JOIN view ON post_id&quot; item modification" type="string">
335
  <type by_reference="false">string</type>
336
  </tag>
337
  </docblock>
338
+ <argument line="663">
339
  <name>$join_clause</name>
340
  <default><![CDATA[]]></default>
341
  <type/>
342
  </argument>
343
  </method>
344
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="690" package="Media Library Assistant">
345
  <name>mla_query_posts_where_filter</name>
346
  <full_name>mla_query_posts_where_filter</full_name>
347
+ <docblock line="678">
348
  <description><![CDATA[Adds a WHERE clause for detached items]]></description>
349
  <long-description><![CDATA[<p>Modeled after _edit_attachments_query_helper in wp-admin/post.php.
350
  Defined as public because it's a filter.</p>]]></long-description>
351
+ <tag line="678" name="since" description="0.1"/>
352
+ <tag line="678" name="param" description="query clause before modification" type="string" variable="$where_clause">
353
  <type by_reference="false">string</type>
354
  </tag>
355
+ <tag line="678" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
356
  <type by_reference="false">string</type>
357
  </tag>
358
  </docblock>
359
+ <argument line="690">
360
  <name>$where_clause</name>
361
  <default><![CDATA[]]></default>
362
  <type/>
363
  </argument>
364
  </method>
365
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="711" package="Media Library Assistant">
366
  <name>mla_query_posts_orderby_filter</name>
367
  <full_name>mla_query_posts_orderby_filter</full_name>
368
+ <docblock line="699">
369
  <description><![CDATA[Adds a ORDERBY clause, if required]]></description>
370
  <long-description><![CDATA[<p>Expands the range of sort options because the logic in WP_Query is limited.
371
  Defined as public because it's a filter.</p>]]></long-description>
372
+ <tag line="699" name="since" description="0.30"/>
373
+ <tag line="699" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
374
  <type by_reference="false">string</type>
375
  </tag>
376
+ <tag line="699" name="return" description="updated query clause" type="string">
377
  <type by_reference="false">string</type>
378
  </tag>
379
  </docblock>
380
+ <argument line="711">
381
  <name>$orderby_clause</name>
382
  <default><![CDATA[]]></default>
383
  <type/>
384
  </argument>
385
  </method>
386
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="769" package="Media Library Assistant">
387
  <name>mla_get_attachment_by_id</name>
388
  <full_name>mla_get_attachment_by_id</full_name>
389
+ <docblock line="757">
390
  <description><![CDATA[Retrieve an Attachment array given a $post_id]]></description>
391
  <long-description><![CDATA[<p>The (associative) array will contain every field that can be found in
392
  the posts and postmeta tables, and all references to the attachment.</p>]]></long-description>
393
+ <tag line="757" name="since" description="0.1"/>
394
+ <tag line="757" name="uses" description="\global\$post" refers="\global\$post"/>
395
+ <tag line="757" name="param" description="The ID of the attachment post" type="int" variable="$post_id">
396
  <type by_reference="false">int</type>
397
  </tag>
398
+ <tag line="757" name="return" description="NULL on failure else associative array" type="NULL|array">
399
  <type by_reference="false">NULL</type>
400
  <type by_reference="false">array</type>
401
  </tag>
402
  </docblock>
403
+ <argument line="769">
404
  <name>$post_id</name>
405
  <default><![CDATA[]]></default>
406
  <type/>
407
  </argument>
408
  </method>
409
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="814" package="Media Library Assistant">
410
+ <name>mla_fetch_attachment_parent_data</name>
411
+ <full_name>mla_fetch_attachment_parent_data</full_name>
412
+ <docblock line="805">
413
+ <description><![CDATA[Returns information about an attachment's parent, if found]]></description>
414
+ <long-description><![CDATA[]]></long-description>
415
+ <tag line="805" name="since" description="0.1"/>
416
+ <tag line="805" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent_id">
417
+ <type by_reference="false">int</type>
418
+ </tag>
419
+ <tag line="805" name="return" description="Parent information; post_date, post_title and post_type" type="array">
420
+ <type by_reference="false">array</type>
421
+ </tag>
422
+ </docblock>
423
+ <argument line="814">
424
+ <name>$parent_id</name>
425
+ <default><![CDATA[]]></default>
426
+ <type/>
427
+ </argument>
428
+ </method>
429
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="842" package="Media Library Assistant">
430
+ <name>mla_fetch_attachment_metadata</name>
431
+ <full_name>mla_fetch_attachment_metadata</full_name>
432
+ <docblock line="829">
433
+ <description><![CDATA[Fetch and filter meta data for an attachment]]></description>
434
+ <long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
435
+ are stripped out or converted to an 'mla</em>' equivalent. Array data is replaced with
436
+ a string containing the first array element.</p>]]></long-description>
437
+ <tag line="829" name="since" description="0.1"/>
438
+ <tag line="829" name="param" description="post ID of attachment" type="int" variable="$post_id">
439
+ <type by_reference="false">int</type>
440
+ </tag>
441
+ <tag line="829" name="return" description="Meta data variables" type="array">
442
+ <type by_reference="false">array</type>
443
+ </tag>
444
+ </docblock>
445
+ <argument line="842">
446
+ <name>$post_id</name>
447
+ <default><![CDATA[]]></default>
448
+ <type/>
449
+ </argument>
450
+ </method>
451
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="908" package="Media Library Assistant">
452
  <name>mla_fetch_attachment_references</name>
453
  <full_name>mla_fetch_attachment_references</full_name>
454
+ <docblock line="895">
455
  <description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
456
  <long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
457
  as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
458
+ <tag line="895" name="since" description="0.1"/>
459
+ <tag line="895" name="param" description="post ID of attachment" type="int" variable="$ID">
460
  <type by_reference="false">int</type>
461
  </tag>
462
+ <tag line="895" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent">
463
  <type by_reference="false">int</type>
464
  </tag>
465
+ <tag line="895" name="return" description="Reference information; see $references array comments" type="array">
466
  <type by_reference="false">array</type>
467
  </tag>
468
  </docblock>
469
+ <argument line="908">
470
  <name>$ID</name>
471
  <default><![CDATA[]]></default>
472
  <type/>
473
  </argument>
474
+ <argument line="908">
475
  <name>$parent</name>
476
  <default><![CDATA[]]></default>
477
  <type/>
478
  </argument>
479
  </method>
480
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1183" package="Media Library Assistant">
481
  <name>mla_flush_mla_galleries</name>
482
  <full_name>mla_flush_mla_galleries</full_name>
483
+ <docblock line="1174">
484
  <description><![CDATA[Invalidates the $mla_galleries or $galleries array and cached values]]></description>
485
  <long-description><![CDATA[]]></long-description>
486
+ <tag line="1174" name="since" description="1.00"/>
487
+ <tag line="1174" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
488
  <type by_reference="false">string</type>
489
  </tag>
490
+ <tag line="1174" name="return" description="" type="void">
491
  <type by_reference="false">void</type>
492
  </tag>
493
  </docblock>
494
+ <argument line="1183">
495
  <name>$option_name</name>
496
  <default><![CDATA[]]></default>
497
  <type/>
498
  </argument>
499
  </method>
500
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1207" package="Media Library Assistant">
501
  <name>mla_save_post_action</name>
502
  <full_name>mla_save_post_action</full_name>
503
+ <docblock line="1198">
504
  <description><![CDATA[Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates]]></description>
505
  <long-description><![CDATA[]]></long-description>
506
+ <tag line="1198" name="since" description="1.00"/>
507
+ <tag line="1198" name="param" description="ID of post/page/attachment; not used at this time" type="integer" variable="$post_id">
508
  <type by_reference="false">integer</type>
509
  </tag>
510
+ <tag line="1198" name="return" description="" type="void">
511
  <type by_reference="false">void</type>
512
  </tag>
513
  </docblock>
514
+ <argument line="1207">
515
  <name>$post_id</name>
516
  <default><![CDATA[]]></default>
517
  <type/>
518
  </argument>
519
  </method>
520
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1224" package="Media Library Assistant">
521
  <name>_build_mla_galleries</name>
522
  <full_name>_build_mla_galleries</full_name>
523
+ <docblock line="1212">
524
  <description><![CDATA[Builds the $mla_galleries or $galleries array]]></description>
525
  <long-description><![CDATA[]]></long-description>
526
+ <tag line="1212" name="since" description="0.70"/>
527
+ <tag line="1212" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
528
  <type by_reference="false">string</type>
529
  </tag>
530
+ <tag line="1212" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
531
  <type by_reference="false">array</type>
532
  </tag>
533
+ <tag line="1212" name="param" description="the shortcode to be searched for and processed" type="string" variable="$shortcode">
534
  <type by_reference="false">string</type>
535
  </tag>
536
+ <tag line="1212" name="param" description="true to exclude revisions from the search" type="boolean" variable="$exclude_revisions">
537
  <type by_reference="false">boolean</type>
538
  </tag>
539
+ <tag line="1212" name="return" description="true if the galleries array is not empty" type="boolean">
540
  <type by_reference="false">boolean</type>
541
  </tag>
542
  </docblock>
543
+ <argument line="1224">
544
  <name>$option_name</name>
545
  <default><![CDATA[]]></default>
546
  <type/>
547
  </argument>
548
+ <argument line="1224">
549
  <name>$galleries_array</name>
550
  <default><![CDATA[]]></default>
551
  <type/>
552
  </argument>
553
+ <argument line="1224">
554
  <name>$shortcode</name>
555
  <default><![CDATA[]]></default>
556
  <type/>
557
  </argument>
558
+ <argument line="1224">
559
  <name>$exclude_revisions</name>
560
  <default><![CDATA[]]></default>
561
  <type/>
562
  </argument>
563
  </method>
564
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1329" package="Media Library Assistant">
565
  <name>_search_mla_galleries</name>
566
  <full_name>_search_mla_galleries</full_name>
567
+ <docblock line="1318">
568
  <description><![CDATA[Search the $mla_galleries or $galleries array]]></description>
569
  <long-description><![CDATA[]]></long-description>
570
+ <tag line="1318" name="since" description="0.70"/>
571
+ <tag line="1318" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
572
  <type by_reference="false">array</type>
573
  </tag>
574
+ <tag line="1318" name="param" description="the attachment ID to be searched for and processed" type="int" variable="$attachment_id">
575
  <type by_reference="false">int</type>
576
  </tag>
577
+ <tag line="1318" name="return" description="All posts/pages with one or more galleries that include the attachment. The array key is the parent_post ID; each entry contains post_title and post_type." type="array">
578
  <type by_reference="false">array</type>
579
  </tag>
580
  </docblock>
581
+ <argument line="1329">
582
  <name>$galleries_array</name>
583
  <default><![CDATA[]]></default>
584
  <type/>
585
  </argument>
586
+ <argument line="1329">
587
  <name>$attachment_id</name>
588
  <default><![CDATA[]]></default>
589
  <type/>
590
  </argument>
591
  </method>
592
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1354" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
593
  <name>mla_fetch_attachment_image_metadata</name>
594
  <full_name>mla_fetch_attachment_image_metadata</full_name>
595
+ <docblock line="1342">
596
  <description><![CDATA[Fetch and filter IPTC and EXIF meta data for an image attachment]]></description>
597
  <long-description><![CDATA[<p>Returns</p>]]></long-description>
598
+ <tag line="1342" name="since" description="0.90"/>
599
+ <tag line="1342" name="param" description="post ID of attachment" type="int" variable="$post_id">
600
  <type by_reference="false">int</type>
601
  </tag>
602
+ <tag line="1342" name="param" description="optional; if $post_id is zero, path to the image file." type="string" variable="$path">
603
  <type by_reference="false">string</type>
604
  </tag>
605
+ <tag line="1342" name="return" description="Meta data variables" type="array">
606
  <type by_reference="false">array</type>
607
  </tag>
608
  </docblock>
609
+ <argument line="1354">
610
  <name>$post_id</name>
611
  <default><![CDATA[]]></default>
612
  <type/>
613
  </argument>
614
+ <argument line="1354">
615
  <name>$path</name>
616
  <default><![CDATA['']]></default>
617
  <type/>
618
  </argument>
619
  </method>
620
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1411" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
621
  <name>mla_update_single_item</name>
622
  <full_name>mla_update_single_item</full_name>
623
+ <docblock line="1398">
624
  <description><![CDATA[Update a single item; change the meta data
625
  for a single attachment.]]></description>
626
  <long-description><![CDATA[]]></long-description>
627
+ <tag line="1398" name="since" description="0.1"/>
628
+ <tag line="1398" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
629
  <type by_reference="false">int</type>
630
  </tag>
631
+ <tag line="1398" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_data">
632
  <type by_reference="false">array</type>
633
  </tag>
634
+ <tag line="1398" name="param" description="Optional taxonomy term values, default null" type="array" variable="$tax_input">
635
  <type by_reference="false">array</type>
636
  </tag>
637
+ <tag line="1398" name="param" description="Optional taxonomy actions (add, remove, replace), default null" type="array" variable="$tax_actions">
638
  <type by_reference="false">array</type>
639
  </tag>
640
+ <tag line="1398" name="return" description="success/failure message and NULL content" type="array">
641
  <type by_reference="false">array</type>
642
  </tag>
643
  </docblock>
644
+ <argument line="1411">
645
  <name>$post_id</name>
646
  <default><![CDATA[]]></default>
647
  <type/>
648
  </argument>
649
+ <argument line="1411">
650
  <name>$new_data</name>
651
  <default><![CDATA[]]></default>
652
  <type/>
653
  </argument>
654
+ <argument line="1411">
655
  <name>$tax_input</name>
656
  <default><![CDATA[NULL]]></default>
657
  <type/>
658
  </argument>
659
+ <argument line="1411">
660
  <name>$tax_actions</name>
661
  <default><![CDATA[NULL]]></default>
662
  <type/>
663
  </argument>
664
  </method>
665
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1633" package="Media Library Assistant">
666
  <name>_remove_tags</name>
667
  <full_name>_remove_tags</full_name>
668
+ <docblock line="1622">
669
  <description><![CDATA[Remove tags from a term ids list]]></description>
670
  <long-description><![CDATA[]]></long-description>
671
+ <tag line="1622" name="since" description="0.40"/>
672
+ <tag line="1622" name="param" description="The term ids currently assigned" type="array" variable="$terms_before">
673
  <type by_reference="false">array</type>
674
  </tag>
675
+ <tag line="1622" name="param" description="| string The term ids (array) or names (string) to remove" type="array" variable="$tags">
676
  <type by_reference="false">array</type>
677
  </tag>
678
+ <tag line="1622" name="param" description="The taxonomy object" type="object" variable="$taxonomy_obj">
679
  <type by_reference="false">object</type>
680
  </tag>
681
+ <tag line="1622" name="return" description="Term ids of the surviving tags" type="array">
682
  <type by_reference="false">array</type>
683
  </tag>
684
  </docblock>
685
+ <argument line="1633">
686
  <name>$terms_before</name>
687
  <default><![CDATA[]]></default>
688
  <type/>
689
  </argument>
690
+ <argument line="1633">
691
  <name>$tags</name>
692
  <default><![CDATA[]]></default>
693
  <type/>
694
  </argument>
695
+ <argument line="1633">
696
  <name>$taxonomy_obj</name>
697
  <default><![CDATA[]]></default>
698
  <type/>
699
  </argument>
700
  </method>
701
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1677" package="Media Library Assistant">
702
  <name>_hex_dump</name>
703
  <full_name>_hex_dump</full_name>
704
+ <docblock line="1666">
705
  <description><![CDATA[Format printable version of binary data]]></description>
706
  <long-description><![CDATA[]]></long-description>
707
+ <tag line="1666" name="since" description="0.90"/>
708
+ <tag line="1666" name="param" description="Binary data" type="string" variable="$data">
709
  <type by_reference="false">string</type>
710
  </tag>
711
+ <tag line="1666" name="param" description="Bytes to format, default = 0 (all bytes)" type="integer" variable="$limit">
712
  <type by_reference="false">integer</type>
713
  </tag>
714
+ <tag line="1666" name="param" description="Bytes to format on each line" type="\intger" variable="$bytes_per_row">
715
  <type by_reference="false">\intger</type>
716
  </tag>
717
+ <tag line="1666" name="return" description="Printable representation of $data" type="string">
718
  <type by_reference="false">string</type>
719
  </tag>
720
  </docblock>
721
+ <argument line="1677">
722
  <name>$data</name>
723
  <default><![CDATA[]]></default>
724
  <type/>
725
  </argument>
726
+ <argument line="1677">
727
  <name>$limit</name>
728
  <default><![CDATA[0]]></default>
729
  <type/>
730
  </argument>
731
+ <argument line="1677">
732
  <name>$bytes_per_row</name>
733
  <default><![CDATA[16]]></default>
734
  <type/>
736
  </method>
737
  </class>
738
  </file>
739
+ <file path="includes\class-mla-edit-media.php" hash="ecf5932a9aa8974651feeb7c4b5352ab" package="Media Library Assistant">
740
  <docblock line="2">
741
  <description><![CDATA[Media Library Assistant Edit Media screen enhancements]]></description>
742
  <long-description><![CDATA[]]></long-description>
753
  <tag line="9" name="package" description="Media Library Assistant"/>
754
  <tag line="9" name="since" description="0.80"/>
755
  </docblock>
756
+ <property final="false" static="true" visibility="private" line="197" namespace="global" package="Media Library Assistant">
757
  <name>$mla_references</name>
758
  <default><![CDATA[null]]></default>
759
+ <docblock line="187">
760
  <description><![CDATA[Where-used values for the current item]]></description>
761
  <long-description><![CDATA[<p>This array contains the Featured/Inserted/Gallery/MLA Gallery references for the item.
762
  The array is built once each page load and cached for subsequent calls.</p>]]></long-description>
763
+ <tag line="187" name="since" description="0.80"/>
764
+ <tag line="187" name="var" description="" type="array">
765
  <type by_reference="false">array</type>
766
  </tag>
767
  </docblock>
778
  </tag>
779
  </docblock>
780
  </method>
781
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="55" package="Media Library Assistant">
782
  <name>mla_custom_field_support_action</name>
783
  <full_name>mla_custom_field_support_action</full_name>
784
+ <docblock line="47">
785
  <description><![CDATA[Adds Custom Field support to the Edit Media screen.]]></description>
786
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
787
+ <tag line="47" name="since" description="0.80"/>
788
+ <tag line="47" name="return" description="echoes the HTML markup for the label and value" type="void">
789
  <type by_reference="false">void</type>
790
  </tag>
791
  </docblock>
792
  </method>
793
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="69" package="Media Library Assistant">
794
+ <name>mla_post_updated_messages_filter</name>
795
+ <full_name>mla_post_updated_messages_filter</full_name>
796
+ <docblock line="59">
797
+ <description><![CDATA[Adds mapping update messages for display at the top of the Edit Media screen.]]></description>
798
+ <long-description><![CDATA[<p>Declared public because it is a filter.</p>]]></long-description>
799
+ <tag line="59" name="since" description="1.10"/>
800
+ <tag line="59" name="param" description="messages for the Edit screen" type="array" variable="$messages">
801
+ <type by_reference="false">array</type>
802
+ </tag>
803
+ <tag line="59" name="return" description="updated messages" type="array">
804
+ <type by_reference="false">array</type>
805
+ </tag>
806
+ </docblock>
807
+ <argument line="69">
808
+ <name>$messages</name>
809
+ <default><![CDATA[]]></default>
810
+ <type/>
811
+ </argument>
812
+ </method>
813
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="86" package="Media Library Assistant">
814
+ <name>mla_attachment_submitbox_action</name>
815
+ <full_name>mla_attachment_submitbox_action</full_name>
816
+ <docblock line="78">
817
  <description><![CDATA[Adds Last Modified date to the Submit box on the Edit Media screen.]]></description>
818
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
819
+ <tag line="78" name="since" description="0.80"/>
820
+ <tag line="78" name="return" description="echoes the HTML markup for the label and value" type="void">
821
  <type by_reference="false">void</type>
822
  </tag>
823
  </docblock>
824
  </method>
825
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="119" package="Media Library Assistant">
826
  <name>mla_add_meta_boxes_action</name>
827
  <full_name>mla_add_meta_boxes_action</full_name>
828
+ <docblock line="108">
829
  <description><![CDATA[Registers meta boxes for the Edit Media screen.]]></description>
830
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
831
+ <tag line="108" name="since" description="0.80"/>
832
+ <tag line="108" name="param" description="type of the current post, e.g., 'attachment'" type="string" variable="$post_type">
833
  <type by_reference="false">string</type>
834
  </tag>
835
+ <tag line="108" name="param" description="current post" type="object" variable="$post">
836
  <type by_reference="false">object</type>
837
  </tag>
838
+ <tag line="108" name="return" description="" type="void">
839
  <type by_reference="false">void</type>
840
  </tag>
841
  </docblock>
842
+ <argument line="119">
843
  <name>$post_type</name>
844
  <default><![CDATA[]]></default>
845
  <type/>
846
  </argument>
847
+ <argument line="119">
848
  <name>$post</name>
849
  <default><![CDATA[]]></default>
850
  <type/>
851
  </argument>
852
  </method>
853
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="149" package="Media Library Assistant">
854
  <name>mla_edit_add_help_tab</name>
855
  <full_name>mla_edit_add_help_tab</full_name>
856
+ <docblock line="139">
857
  <description><![CDATA[Add contextual help tabs to the WordPress Edit Media page]]></description>
858
  <long-description><![CDATA[]]></long-description>
859
+ <tag line="139" name="since" description="0.90"/>
860
+ <tag line="139" name="param" description="title as shown on the screen" type="string" variable="$admin_title">
861
  <type by_reference="false">string</type>
862
  </tag>
863
+ <tag line="139" name="param" description="title as shown in the HTML header" type="string" variable="$title">
864
  <type by_reference="false">string</type>
865
  </tag>
866
+ <tag line="139" name="return" description="" type="void">
867
  <type by_reference="false">void</type>
868
  </tag>
869
  </docblock>
870
+ <argument line="149">
871
  <name>$admin_title</name>
872
  <default><![CDATA[]]></default>
873
  <type/>
874
  </argument>
875
+ <argument line="149">
876
  <name>$title</name>
877
  <default><![CDATA[]]></default>
878
  <type/>
879
  </argument>
880
  </method>
881
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="209" package="Media Library Assistant">
882
  <name>mla_parent_info_handler</name>
883
  <full_name>mla_parent_info_handler</full_name>
884
+ <docblock line="199">
885
  <description><![CDATA[Renders the Parent Info meta box on the Edit Media page.]]></description>
886
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
887
+ <tag line="199" name="since" description="0.80"/>
888
+ <tag line="199" name="param" description="current post" type="object" variable="$post">
889
  <type by_reference="false">object</type>
890
  </tag>
891
+ <tag line="199" name="return" description="echoes the HTML markup for the meta box content" type="void">
892
  <type by_reference="false">void</type>
893
  </tag>
894
  </docblock>
895
+ <argument line="209">
896
  <name>$post</name>
897
  <default><![CDATA[]]></default>
898
  <type/>
899
  </argument>
900
  </method>
901
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="234" package="Media Library Assistant">
902
  <name>mla_menu_order_handler</name>
903
  <full_name>mla_menu_order_handler</full_name>
904
+ <docblock line="224">
905
  <description><![CDATA[Renders the Menu Order meta box on the Edit Media page.]]></description>
906
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
907
+ <tag line="224" name="since" description="0.80"/>
908
+ <tag line="224" name="param" description="current post" type="object" variable="$post">
909
  <type by_reference="false">object</type>
910
  </tag>
911
+ <tag line="224" name="return" description="echoes the HTML markup for the meta box content" type="void">
912
  <type by_reference="false">void</type>
913
  </tag>
914
  </docblock>
915
+ <argument line="234">
916
  <name>$post</name>
917
  <default><![CDATA[]]></default>
918
  <type/>
919
  </argument>
920
  </method>
921
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="249" package="Media Library Assistant">
922
  <name>mla_image_metadata_handler</name>
923
  <full_name>mla_image_metadata_handler</full_name>
924
+ <docblock line="239">
925
  <description><![CDATA[Renders the Image Metadata meta box on the Edit Media page.]]></description>
926
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
927
+ <tag line="239" name="since" description="0.80"/>
928
+ <tag line="239" name="param" description="current post" type="object" variable="$post">
929
  <type by_reference="false">object</type>
930
  </tag>
931
+ <tag line="239" name="return" description="echoes the HTML markup for the meta box content" type="void">
932
  <type by_reference="false">void</type>
933
  </tag>
934
  </docblock>
935
+ <argument line="249">
936
  <name>$post</name>
937
  <default><![CDATA[]]></default>
938
  <type/>
939
  </argument>
940
  </method>
941
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="270" package="Media Library Assistant">
942
  <name>mla_featured_in_handler</name>
943
  <full_name>mla_featured_in_handler</full_name>
944
+ <docblock line="260">
945
  <description><![CDATA[Renders the Featured in meta box on the Edit Media page.]]></description>
946
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
947
+ <tag line="260" name="since" description="0.80"/>
948
+ <tag line="260" name="param" description="current post" type="object" variable="$post">
949
  <type by_reference="false">object</type>
950
  </tag>
951
+ <tag line="260" name="return" description="echoes the HTML markup for the meta box content" type="void">
952
  <type by_reference="false">void</type>
953
  </tag>
954
  </docblock>
955
+ <argument line="270">
956
  <name>$post</name>
957
  <default><![CDATA[]]></default>
958
  <type/>
959
  </argument>
960
  </method>
961
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="300" package="Media Library Assistant">
962
  <name>mla_inserted_in_handler</name>
963
  <full_name>mla_inserted_in_handler</full_name>
964
+ <docblock line="290">
965
  <description><![CDATA[Renders the Inserted in meta box on the Edit Media page.]]></description>
966
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
967
+ <tag line="290" name="since" description="0.80"/>
968
+ <tag line="290" name="param" description="current post" type="object" variable="$post">
969
  <type by_reference="false">object</type>
970
  </tag>
971
+ <tag line="290" name="return" description="echoes the HTML markup for the meta box content" type="void">
972
  <type by_reference="false">void</type>
973
  </tag>
974
  </docblock>
975
+ <argument line="300">
976
  <name>$post</name>
977
  <default><![CDATA[]]></default>
978
  <type/>
979
  </argument>
980
  </method>
981
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="334" package="Media Library Assistant">
982
  <name>mla_gallery_in_handler</name>
983
  <full_name>mla_gallery_in_handler</full_name>
984
+ <docblock line="324">
985
  <description><![CDATA[Renders the Gallery in meta box on the Edit Media page.]]></description>
986
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
987
+ <tag line="324" name="since" description="0.80"/>
988
+ <tag line="324" name="param" description="current post" type="object" variable="$post">
989
  <type by_reference="false">object</type>
990
  </tag>
991
+ <tag line="324" name="return" description="echoes the HTML markup for the meta box content" type="void">
992
  <type by_reference="false">void</type>
993
  </tag>
994
  </docblock>
995
+ <argument line="334">
996
  <name>$post</name>
997
  <default><![CDATA[]]></default>
998
  <type/>
999
  </argument>
1000
  </method>
1001
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="364" package="Media Library Assistant">
1002
  <name>mla_mla_gallery_in_handler</name>
1003
  <full_name>mla_mla_gallery_in_handler</full_name>
1004
+ <docblock line="354">
1005
  <description><![CDATA[Renders the Gallery in meta box on the Edit Media page.]]></description>
1006
  <long-description><![CDATA[<p>Declared public because it is a callback function.</p>]]></long-description>
1007
+ <tag line="354" name="since" description="0.80"/>
1008
+ <tag line="354" name="param" description="current post" type="object" variable="$post">
1009
  <type by_reference="false">object</type>
1010
  </tag>
1011
+ <tag line="354" name="return" description="echoes the HTML markup for the meta box content" type="void">
1012
  <type by_reference="false">void</type>
1013
  </tag>
1014
  </docblock>
1015
+ <argument line="364">
1016
  <name>$post</name>
1017
  <default><![CDATA[]]></default>
1018
  <type/>
1019
  </argument>
1020
  </method>
1021
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="394" package="Media Library Assistant">
1022
  <name>mla_edit_attachment_action</name>
1023
  <full_name>mla_edit_attachment_action</full_name>
1024
+ <docblock line="384">
1025
  <description><![CDATA[Saves updates from the Edit Media screen.]]></description>
1026
  <long-description><![CDATA[<p>Declared public because it is an action.</p>]]></long-description>
1027
+ <tag line="384" name="since" description="0.80"/>
1028
+ <tag line="384" name="param" description="ID of the current post" type="integer" variable="$post_ID">
1029
  <type by_reference="false">integer</type>
1030
  </tag>
1031
+ <tag line="384" name="return" description="" type="void">
1032
  <type by_reference="false">void</type>
1033
  </tag>
1034
  </docblock>
1035
+ <argument line="394">
1036
  <name>$post_ID</name>
1037
  <default><![CDATA[]]></default>
1038
  <type/>
1040
  </method>
1041
  </class>
1042
  </file>
1043
+ <file path="includes\class-mla-list-table.php" hash="c3483d35c2703078c3b811de7c2cd690" package="Media Library Assistant">
1044
  <docblock line="2">
1045
  <description><![CDATA[Media Library Assistant extended List Table class]]></description>
1046
  <long-description><![CDATA[]]></long-description>
1084
  </tag>
1085
  </docblock>
1086
  </property>
1087
+ <property final="false" static="true" visibility="private" line="73" namespace="global" package="Media Library Assistant">
1088
  <name>$default_columns</name>
1089
  <default><![CDATA[array('cb' => '<input type="checkbox" />', 'icon' => '', 'ID_parent' => 'ID/Parent', 'title_name' => 'Title/Name', 'post_title' => 'Title', 'post_name' => 'Name', 'parent' => 'Parent ID', 'menu_order' => 'Menu Order', 'featured' => 'Featured in', 'inserted' => 'Inserted in', 'galleries' => 'Gallery in', 'mla_galleries' => 'MLA Gallery in', 'alt_text' => 'ALT Text', 'caption' => 'Caption', 'description' => 'Description', 'post_mime_type' => 'MIME Type', 'base_file' => 'Base File', 'date' => 'Date', 'modified' => 'Last Modified', 'author' => 'Author', 'attached_to' => 'Attached to')]]></default>
1090
  <docblock line="55">
1097
  column in your table you must create a column_cb() method. If you don't need
1098
  bulk actions or checkboxes, simply leave the 'cb' entry out of your array.</p>
1099
 
1100
+ <p>Taxonomy columns are added to this array by mla_admin_init_action.
1101
+ Custom field columns are added to this array by mla_admin_init_action.</p>]]></long-description>
1102
  <tag line="55" name="since" description="0.1"/>
1103
  <tag line="55" name="var" description="" type="array">
1104
  <type by_reference="false">array</type>
1105
  </tag>
1106
  </docblock>
1107
  </property>
1108
+ <property final="false" static="true" visibility="private" line="115" namespace="global" package="Media Library Assistant">
1109
  <name>$default_hidden_columns</name>
1110
  <default><![CDATA[array('post_title', 'post_name', 'parent', 'menu_order', 'galleries', 'mla_galleries', 'alt_text', 'caption', 'description', 'post_mime_type', 'base_file', 'date', 'modified', 'author', 'attached_to')]]></default>
1111
+ <docblock line="99">
1112
  <description><![CDATA[Default values for hidden columns]]></description>
1113
  <long-description><![CDATA[<p>This array is used when the user-level option is not set, i.e.,
1114
  the user has not altered the selection of hidden columns.</p>
1116
  <p>The value on the right-hand side must match the column slug, e.g.,
1117
  array(0 => 'ID_parent, 1 => 'title_name').</p>
1118
 
1119
+ <p>Taxonomy columns are added to this array by mla_admin_init_action.
1120
+ Custom field columns are added to this array by mla_admin_init_action.</p>]]></long-description>
1121
+ <tag line="99" name="since" description="0.1"/>
1122
+ <tag line="99" name="var" description="" type="array">
1123
  <type by_reference="false">array</type>
1124
  </tag>
1125
  </docblock>
1126
  </property>
1127
+ <property final="false" static="true" visibility="private" line="156" namespace="global" package="Media Library Assistant">
1128
  <name>$default_sortable_columns</name>
1129
  <default><![CDATA[array('ID_parent' => array('ID', false), 'title_name' => array('title_name', false), 'post_title' => array('post_title', false), 'post_name' => array('post_name', false), 'parent' => array('post_parent', false), 'menu_order' => array('menu_order', false), 'alt_text' => array('_wp_attachment_image_alt', false), 'caption' => array('post_excerpt', false), 'description' => array('post_content', false), 'post_mime_type' => array('post_mime_type', false), 'base_file' => array('_wp_attached_file', false), 'date' => array('post_date', false), 'modified' => array('post_modified', false), 'author' => array('post_author', false), 'attached_to' => array('post_parent', false))]]></default>
1130
+ <docblock line="138">
1131
  <description><![CDATA[Sortable column definitions]]></description>
1132
  <long-description><![CDATA[<p>This array defines the table columns that can be sorted. The array key
1133
  is the column slug that needs to be sortable, and the value is database column
1135
  the case (as the value is a column name from the database, not the list table).</p>
1136
 
1137
  <p>The array value also contains a boolean which is 'true' if the data is currently
1138
+ sorted by that column. This is computed each time the table is displayed.</p>
1139
+
1140
+ <p>Taxonomy columns, if any, are added to this array by mla_admin_init_action.
1141
+ Custom field columns are added to this array by mla_admin_init_action.</p>]]></long-description>
1142
+ <tag line="138" name="since" description="0.1"/>
1143
+ <tag line="138" name="var" description="" type="array">
1144
  <type by_reference="false">array</type>
1145
  </tag>
1146
  </docblock>
1147
  </property>
1148
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="187" package="Media Library Assistant">
1149
  <name>_default_hidden_columns</name>
1150
  <full_name>_default_hidden_columns</full_name>
1151
+ <docblock line="180">
1152
  <description><![CDATA[Access the default list of hidden columns]]></description>
1153
  <long-description><![CDATA[]]></long-description>
1154
+ <tag line="180" name="since" description="0.1"/>
1155
+ <tag line="180" name="return" description="default list of hidden columns" type="array">
1156
  <type by_reference="false">array</type>
1157
  </tag>
1158
  </docblock>
1159
  </method>
1160
+ <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="204" package="Media Library Assistant">
1161
  <name>_avail_mime_types</name>
1162
  <full_name>_avail_mime_types</full_name>
1163
+ <docblock line="192">
1164
  <description><![CDATA[Get mime types with one or more attachments for view preparation]]></description>
1165
  <long-description><![CDATA[<p>Modeled after get_available_post_mime_types in wp-admin/includes/post.php,
1166
  with additional entries.</p>]]></long-description>
1167
+ <tag line="192" name="since" description="0.1"/>
1168
+ <tag line="192" name="param" description="Number of posts for each mime type" type="array" variable="$num_posts">
1169
  <type by_reference="false">array</type>
1170
  </tag>
1171
+ <tag line="192" name="return" description="Mime type names" type="array">
1172
  <type by_reference="false">array</type>
1173
  </tag>
1174
  </docblock>
1175
+ <argument line="204">
1176
  <name>$num_posts</name>
1177
  <default><![CDATA[]]></default>
1178
  <type/>
1179
  </argument>
1180
  </method>
1181
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="225" package="Media Library Assistant">
1182
  <name>mla_get_attachment_mime_types</name>
1183
  <full_name>mla_get_attachment_mime_types</full_name>
1184
+ <docblock line="215">
1185
  <description><![CDATA[Get possible mime types for view preparation]]></description>
1186
+ <long-description><![CDATA[<p>Modeled after get_post_mime_types in wp-includes/post.php,
1187
  with additional entries.</p>]]></long-description>
1188
+ <tag line="215" name="since" description="0.1"/>
1189
+ <tag line="215" name="return" description="Mime type names and HTML markup for views" type="array">
1190
  <type by_reference="false">array</type>
1191
  </tag>
1192
  </docblock>
1193
  </method>
1194
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="298" package="Media Library Assistant">
1195
  <name>mla_get_sortable_columns</name>
1196
  <full_name>mla_get_sortable_columns</full_name>
1197
+ <docblock line="291">
1198
  <description><![CDATA[Return the names and display values of the sortable columns]]></description>
1199
  <long-description><![CDATA[]]></long-description>
1200
+ <tag line="291" name="since" description="0.30"/>
1201
+ <tag line="291" name="return" description="name =&gt; array( orderby value, heading ) for sortable columns" type="array">
1202
  <type by_reference="false">array</type>
1203
  </tag>
1204
  </docblock>
1205
  </method>
1206
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="325" package="Media Library Assistant">
1207
  <name>mla_manage_hidden_columns_filter</name>
1208
  <full_name>mla_manage_hidden_columns_filter</full_name>
1209
+ <docblock line="310">
1210
  <description><![CDATA[Handler for filter 'get_user_option_managemedia_page_mla-menucolumnshidden']]></description>
1211
  <long-description><![CDATA[<p>Required because the screen.php get_hidden_columns function only uses
1212
  the get_user_option result. Set when the file is loaded because the object
1213
  is not created in time for the call from screen.php.</p>]]></long-description>
1214
+ <tag line="310" name="since" description="0.1"/>
1215
+ <tag line="310" name="param" description="current list of hidden columns, if any" type="string" variable="$result">
1216
  <type by_reference="false">string</type>
1217
  </tag>
1218
+ <tag line="310" name="param" description="'managemedia_page_mla-menucolumnshidden'" type="string" variable="$option">
1219
  <type by_reference="false">string</type>
1220
  </tag>
1221
+ <tag line="310" name="param" description="WP_User object, if logged in" type="object" variable="$user_data">
1222
  <type by_reference="false">object</type>
1223
  </tag>
1224
+ <tag line="310" name="return" description="updated list of hidden columns" type="array">
1225
  <type by_reference="false">array</type>
1226
  </tag>
1227
  </docblock>
1228
+ <argument line="325">
1229
  <name>$result</name>
1230
  <default><![CDATA[]]></default>
1231
  <type/>
1232
  </argument>
1233
+ <argument line="325">
1234
  <name>$option</name>
1235
  <default><![CDATA[]]></default>
1236
  <type/>
1237
  </argument>
1238
+ <argument line="325">
1239
  <name>$user_data</name>
1240
  <default><![CDATA[]]></default>
1241
  <type/>
1242
  </argument>
1243
  </method>
1244
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="343" package="Media Library Assistant">
1245
  <name>mla_manage_columns_filter</name>
1246
  <full_name>mla_manage_columns_filter</full_name>
1247
+ <docblock line="332">
1248
  <description><![CDATA[Handler for filter 'manage_media_page_mla-menu_columns']]></description>
1249
  <long-description><![CDATA[<p>This required filter dictates the table's columns and titles. Set when the
1250
  file is loaded because the list_table object isn't created in time
1251
  to affect the "screen options" setup.</p>]]></long-description>
1252
+ <tag line="332" name="since" description="0.1"/>
1253
+ <tag line="332" name="return" description="list of table columns" type="array">
1254
  <type by_reference="false">array</type>
1255
  </tag>
1256
  </docblock>
1257
  </method>
1258
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="358" package="Media Library Assistant">
1259
  <name>mla_admin_init_action</name>
1260
  <full_name>mla_admin_init_action</full_name>
1261
+ <docblock line="348">
1262
  <description><![CDATA[Adds support for taxonomy columns]]></description>
1263
  <long-description><![CDATA[<p>Called in the admin_init action because the list_table object isn't
1264
  created in time to affect the "screen options" setup.</p>]]></long-description>
1265
+ <tag line="348" name="since" description="0.30"/>
1266
+ <tag line="348" name="return" description="" type="void">
1267
  <type by_reference="false">void</type>
1268
  </tag>
1269
  </docblock>
1270
  </method>
1271
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="384" package="Media Library Assistant">
1272
  <name>__construct</name>
1273
  <full_name>__construct</full_name>
1274
+ <docblock line="376">
1275
  <description><![CDATA[Initializes some properties from $_REQUEST vairables, then
1276
  calls the parent constructor to set some default configs.]]></description>
1277
  <long-description><![CDATA[]]></long-description>
1278
+ <tag line="376" name="since" description="0.1"/>
1279
+ <tag line="376" name="return" description="" type="void">
1280
  <type by_reference="false">void</type>
1281
  </tag>
1282
  </docblock>
1283
  </method>
1284
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="417" package="Media Library Assistant">
1285
  <name>column_default</name>
1286
  <full_name>column_default</full_name>
1287
+ <docblock line="404">
1288
  <description><![CDATA[Supply a column value if no column-specific function has been defined]]></description>
1289
  <long-description><![CDATA[<p>Called when the parent class can't find a method specifically built for a
1290
  given column. The taxonomy columns are handled here. All other columns should
1291
  have a specific method, so this function returns a troubleshooting message.</p>]]></long-description>
1292
+ <tag line="404" name="since" description="0.1"/>
1293
+ <tag line="404" name="param" description="A singular item (one full row's worth of data)" type="array" variable="$item">
1294
  <type by_reference="false">array</type>
1295
  </tag>
1296
+ <tag line="404" name="param" description="The name/slug of the column to be processed" type="array" variable="$column_name">
1297
  <type by_reference="false">array</type>
1298
  </tag>
1299
+ <tag line="404" name="return" description="Text or HTML to be placed inside the column" type="string">
1300
  <type by_reference="false">string</type>
1301
  </tag>
1302
  </docblock>
1303
+ <argument line="417">
1304
  <name>$item</name>
1305
  <default><![CDATA[]]></default>
1306
  <type/>
1307
  </argument>
1308
+ <argument line="417">
1309
  <name>$column_name</name>
1310
  <default><![CDATA[]]></default>
1311
  <type/>
1312
  </argument>
1313
  </method>
1314
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="462" package="Media Library Assistant">
1315
  <name>column_cb</name>
1316
  <full_name>column_cb</full_name>
1317
+ <docblock line="453">
1318
  <description><![CDATA[Displays checkboxes for using bulk actions.]]></description>
1319
  <long-description><![CDATA[<p>The 'cb' column
1320
  is given special treatment when columns are processed.</p>]]></long-description>
1321
+ <tag line="453" name="since" description="0.1"/>
1322
+ <tag line="453" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1323
  <type by_reference="false">array</type>
1324
  </tag>
1325
+ <tag line="453" name="return" description="HTML markup to be placed inside the column" type="string">
1326
  <type by_reference="false">string</type>
1327
  </tag>
1328
  </docblock>
1329
+ <argument line="462">
1330
  <name>$item</name>
1331
  <default><![CDATA[]]></default>
1332
  <type/>
1333
  </argument>
1334
  </method>
1335
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="478" package="Media Library Assistant">
1336
  <name>column_icon</name>
1337
  <full_name>column_icon</full_name>
1338
+ <docblock line="470">
1339
  <description><![CDATA[Supply the content for a custom column]]></description>
1340
  <long-description><![CDATA[]]></long-description>
1341
+ <tag line="470" name="since" description="0.1"/>
1342
+ <tag line="470" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1343
  <type by_reference="false">array</type>
1344
  </tag>
1345
+ <tag line="470" name="return" description="HTML markup to be placed inside the column" type="string">
1346
  <type by_reference="false">string</type>
1347
  </tag>
1348
  </docblock>
1349
+ <argument line="478">
1350
  <name>$item</name>
1351
  <default><![CDATA[]]></default>
1352
  <type/>
1353
  </argument>
1354
  </method>
1355
+ <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="494" package="Media Library Assistant">
1356
  <name>_build_rollover_actions</name>
1357
  <full_name>_build_rollover_actions</full_name>
1358
+ <docblock line="483">
1359
  <description><![CDATA[Add rollover actions to exactly one of the following displayed columns:
1360
  'ID_parent', 'title_name', 'post_title', 'post_name']]></description>
1361
  <long-description><![CDATA[]]></long-description>
1362
+ <tag line="483" name="since" description="0.1"/>
1363
+ <tag line="483" name="param" description="A singular attachment (post) object" type="object" variable="$item">
1364
  <type by_reference="false">object</type>
1365
  </tag>
1366
+ <tag line="483" name="param" description="Current column name" type="string" variable="$column">
1367
  <type by_reference="false">string</type>
1368
  </tag>
1369
+ <tag line="483" name="return" description="Names and URLs of row-level actions" type="array">
1370
  <type by_reference="false">array</type>
1371
  </tag>
1372
  </docblock>
1373
+ <argument line="494">
1374
  <name>$item</name>
1375
  <default><![CDATA[]]></default>
1376
  <type/>
1377
  </argument>
1378
+ <argument line="494">
1379
  <name>$column</name>
1380
  <default><![CDATA[]]></default>
1381
  <type/>
1382
  </argument>
1383
  </method>
1384
+ <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="572" package="Media Library Assistant">
1385
  <name>_build_inline_data</name>
1386
  <full_name>_build_inline_data</full_name>
1387
+ <docblock line="563">
1388
  <description><![CDATA[Add hidden fields with the data for use in the inline editor]]></description>
1389
  <long-description><![CDATA[]]></long-description>
1390
+ <tag line="563" name="since" description="0.20"/>
1391
+ <tag line="563" name="param" description="A singular attachment (post) object" type="object" variable="$item">
1392
  <type by_reference="false">object</type>
1393
  </tag>
1394
+ <tag line="563" name="return" description="HTML &lt;div&gt; with row data" type="string">
1395
  <type by_reference="false">string</type>
1396
  </tag>
1397
  </docblock>
1398
+ <argument line="572">
1399
  <name>$item</name>
1400
  <default><![CDATA[]]></default>
1401
  <type/>
1402
  </argument>
1403
  </method>
1404
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="613" package="Media Library Assistant">
1405
  <name>column_ID_parent</name>
1406
  <full_name>column_ID_parent</full_name>
1407
+ <docblock line="605">
1408
  <description><![CDATA[Supply the content for a custom column]]></description>
1409
  <long-description><![CDATA[]]></long-description>
1410
+ <tag line="605" name="since" description="0.1"/>
1411
+ <tag line="605" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1412
  <type by_reference="false">array</type>
1413
  </tag>
1414
+ <tag line="605" name="return" description="HTML markup to be placed inside the column" type="string">
1415
  <type by_reference="false">string</type>
1416
  </tag>
1417
  </docblock>
1418
+ <argument line="613">
1419
  <name>$item</name>
1420
  <default><![CDATA[]]></default>
1421
  <type/>
1422
  </argument>
1423
  </method>
1424
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="645" package="Media Library Assistant">
1425
  <name>column_title_name</name>
1426
  <full_name>column_title_name</full_name>
1427
+ <docblock line="637">
1428
  <description><![CDATA[Supply the content for a custom column]]></description>
1429
  <long-description><![CDATA[]]></long-description>
1430
+ <tag line="637" name="since" description="0.1"/>
1431
+ <tag line="637" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1432
  <type by_reference="false">array</type>
1433
  </tag>
1434
+ <tag line="637" name="return" description="HTML markup to be placed inside the column" type="string">
1435
  <type by_reference="false">string</type>
1436
  </tag>
1437
  </docblock>
1438
+ <argument line="645">
1439
  <name>$item</name>
1440
  <default><![CDATA[]]></default>
1441
  <type/>
1442
  </argument>
1443
  </method>
1444
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="668" package="Media Library Assistant">
1445
  <name>column_post_title</name>
1446
  <full_name>column_post_title</full_name>
1447
+ <docblock line="660">
1448
  <description><![CDATA[Supply the content for a custom column]]></description>
1449
  <long-description><![CDATA[]]></long-description>
1450
+ <tag line="660" name="since" description="0.1"/>
1451
+ <tag line="660" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1452
  <type by_reference="false">array</type>
1453
  </tag>
1454
+ <tag line="660" name="return" description="HTML markup to be placed inside the column" type="string">
1455
  <type by_reference="false">string</type>
1456
  </tag>
1457
  </docblock>
1458
+ <argument line="668">
1459
  <name>$item</name>
1460
  <default><![CDATA[]]></default>
1461
  <type/>
1462
  </argument>
1463
  </method>
1464
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="686" package="Media Library Assistant">
1465
  <name>column_post_name</name>
1466
  <full_name>column_post_name</full_name>
1467
+ <docblock line="678">
1468
  <description><![CDATA[Supply the content for a custom column]]></description>
1469
  <long-description><![CDATA[]]></long-description>
1470
+ <tag line="678" name="since" description="0.1"/>
1471
+ <tag line="678" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1472
  <type by_reference="false">array</type>
1473
  </tag>
1474
+ <tag line="678" name="return" description="HTML markup to be placed inside the column" type="string">
1475
  <type by_reference="false">string</type>
1476
  </tag>
1477
  </docblock>
1478
+ <argument line="686">
1479
  <name>$item</name>
1480
  <default><![CDATA[]]></default>
1481
  <type/>
1482
  </argument>
1483
  </method>
1484
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="704" package="Media Library Assistant">
1485
  <name>column_parent</name>
1486
  <full_name>column_parent</full_name>
1487
+ <docblock line="696">
1488
  <description><![CDATA[Supply the content for a custom column]]></description>
1489
  <long-description><![CDATA[]]></long-description>
1490
+ <tag line="696" name="since" description="0.1"/>
1491
+ <tag line="696" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1492
  <type by_reference="false">array</type>
1493
  </tag>
1494
+ <tag line="696" name="return" description="HTML markup to be placed inside the column" type="string">
1495
  <type by_reference="false">string</type>
1496
  </tag>
1497
  </docblock>
1498
+ <argument line="704">
1499
  <name>$item</name>
1500
  <default><![CDATA[]]></default>
1501
  <type/>
1502
  </argument>
1503
  </method>
1504
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="729" package="Media Library Assistant">
1505
  <name>column_menu_order</name>
1506
  <full_name>column_menu_order</full_name>
1507
+ <docblock line="721">
1508
  <description><![CDATA[Supply the content for a custom column]]></description>
1509
  <long-description><![CDATA[]]></long-description>
1510
+ <tag line="721" name="since" description="0.60"/>
1511
+ <tag line="721" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1512
  <type by_reference="false">array</type>
1513
  </tag>
1514
+ <tag line="721" name="return" description="HTML markup to be placed inside the column" type="string">
1515
  <type by_reference="false">string</type>
1516
  </tag>
1517
  </docblock>
1518
+ <argument line="729">
1519
  <name>$item</name>
1520
  <default><![CDATA[]]></default>
1521
  <type/>
1522
  </argument>
1523
  </method>
1524
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="741" package="Media Library Assistant">
1525
  <name>column_featured</name>
1526
  <full_name>column_featured</full_name>
1527
+ <docblock line="733">
1528
  <description><![CDATA[Supply the content for a custom column]]></description>
1529
  <long-description><![CDATA[]]></long-description>
1530
+ <tag line="733" name="since" description="0.1"/>
1531
+ <tag line="733" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1532
  <type by_reference="false">array</type>
1533
  </tag>
1534
+ <tag line="733" name="return" description="HTML markup to be placed inside the column" type="string">
1535
  <type by_reference="false">string</type>
1536
  </tag>
1537
  </docblock>
1538
+ <argument line="741">
1539
  <name>$item</name>
1540
  <default><![CDATA[]]></default>
1541
  <type/>
1542
  </argument>
1543
  </method>
1544
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="772" package="Media Library Assistant">
1545
  <name>column_inserted</name>
1546
  <full_name>column_inserted</full_name>
1547
+ <docblock line="764">
1548
  <description><![CDATA[Supply the content for a custom column]]></description>
1549
  <long-description><![CDATA[]]></long-description>
1550
+ <tag line="764" name="since" description="0.1"/>
1551
+ <tag line="764" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1552
  <type by_reference="false">array</type>
1553
  </tag>
1554
+ <tag line="764" name="return" description="HTML markup to be placed inside the column" type="string">
1555
  <type by_reference="false">string</type>
1556
  </tag>
1557
  </docblock>
1558
+ <argument line="772">
1559
  <name>$item</name>
1560
  <default><![CDATA[]]></default>
1561
  <type/>
1562
  </argument>
1563
  </method>
1564
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="807" package="Media Library Assistant">
1565
  <name>column_galleries</name>
1566
  <full_name>column_galleries</full_name>
1567
+ <docblock line="799">
1568
  <description><![CDATA[Supply the content for a custom column]]></description>
1569
  <long-description><![CDATA[]]></long-description>
1570
+ <tag line="799" name="since" description="0.70"/>
1571
+ <tag line="799" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1572
  <type by_reference="false">array</type>
1573
  </tag>
1574
+ <tag line="799" name="return" description="HTML markup to be placed inside the column" type="string">
1575
  <type by_reference="false">string</type>
1576
  </tag>
1577
  </docblock>
1578
+ <argument line="807">
1579
  <name>$item</name>
1580
  <default><![CDATA[]]></default>
1581
  <type/>
1582
  </argument>
1583
  </method>
1584
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="838" package="Media Library Assistant">
1585
  <name>column_mla_galleries</name>
1586
  <full_name>column_mla_galleries</full_name>
1587
+ <docblock line="830">
1588
  <description><![CDATA[Supply the content for a custom column]]></description>
1589
  <long-description><![CDATA[]]></long-description>
1590
+ <tag line="830" name="since" description="0.70"/>
1591
+ <tag line="830" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1592
  <type by_reference="false">array</type>
1593
  </tag>
1594
+ <tag line="830" name="return" description="HTML markup to be placed inside the column" type="string">
1595
  <type by_reference="false">string</type>
1596
  </tag>
1597
  </docblock>
1598
+ <argument line="838">
1599
  <name>$item</name>
1600
  <default><![CDATA[]]></default>
1601
  <type/>
1602
  </argument>
1603
  </method>
1604
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="869" package="Media Library Assistant">
1605
  <name>column_alt_text</name>
1606
  <full_name>column_alt_text</full_name>
1607
+ <docblock line="861">
1608
  <description><![CDATA[Supply the content for a custom column]]></description>
1609
  <long-description><![CDATA[]]></long-description>
1610
+ <tag line="861" name="since" description="0.1"/>
1611
+ <tag line="861" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1612
  <type by_reference="false">array</type>
1613
  </tag>
1614
+ <tag line="861" name="return" description="HTML markup to be placed inside the column" type="string">
1615
  <type by_reference="false">string</type>
1616
  </tag>
1617
  </docblock>
1618
+ <argument line="869">
1619
  <name>$item</name>
1620
  <default><![CDATA[]]></default>
1621
  <type/>
1622
  </argument>
1623
  </method>
1624
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="884" package="Media Library Assistant">
1625
  <name>column_caption</name>
1626
  <full_name>column_caption</full_name>
1627
+ <docblock line="876">
1628
  <description><![CDATA[Supply the content for a custom column]]></description>
1629
  <long-description><![CDATA[]]></long-description>
1630
+ <tag line="876" name="since" description="0.1"/>
1631
+ <tag line="876" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1632
  <type by_reference="false">array</type>
1633
  </tag>
1634
+ <tag line="876" name="return" description="HTML markup to be placed inside the column" type="string">
1635
  <type by_reference="false">string</type>
1636
  </tag>
1637
  </docblock>
1638
+ <argument line="884">
1639
  <name>$item</name>
1640
  <default><![CDATA[]]></default>
1641
  <type/>
1642
  </argument>
1643
  </method>
1644
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="896" package="Media Library Assistant">
1645
  <name>column_description</name>
1646
  <full_name>column_description</full_name>
1647
+ <docblock line="888">
1648
  <description><![CDATA[Supply the content for a custom column]]></description>
1649
  <long-description><![CDATA[]]></long-description>
1650
+ <tag line="888" name="since" description="0.1"/>
1651
+ <tag line="888" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1652
  <type by_reference="false">array</type>
1653
  </tag>
1654
+ <tag line="888" name="return" description="HTML markup to be placed inside the column" type="string">
1655
  <type by_reference="false">string</type>
1656
  </tag>
1657
  </docblock>
1658
+ <argument line="896">
1659
  <name>$item</name>
1660
  <default><![CDATA[]]></default>
1661
  <type/>
1662
  </argument>
1663
  </method>
1664
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="908" package="Media Library Assistant">
1665
  <name>column_post_mime_type</name>
1666
  <full_name>column_post_mime_type</full_name>
1667
+ <docblock line="900">
1668
  <description><![CDATA[Supply the content for a custom column]]></description>
1669
  <long-description><![CDATA[]]></long-description>
1670
+ <tag line="900" name="since" description="0.30"/>
1671
+ <tag line="900" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1672
  <type by_reference="false">array</type>
1673
  </tag>
1674
+ <tag line="900" name="return" description="HTML markup to be placed inside the column" type="string">
1675
  <type by_reference="false">string</type>
1676
  </tag>
1677
  </docblock>
1678
+ <argument line="908">
1679
  <name>$item</name>
1680
  <default><![CDATA[]]></default>
1681
  <type/>
1682
  </argument>
1683
  </method>
1684
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="920" package="Media Library Assistant">
1685
  <name>column_base_file</name>
1686
  <full_name>column_base_file</full_name>
1687
+ <docblock line="912">
1688
  <description><![CDATA[Supply the content for a custom column]]></description>
1689
  <long-description><![CDATA[]]></long-description>
1690
+ <tag line="912" name="since" description="0.1"/>
1691
+ <tag line="912" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1692
  <type by_reference="false">array</type>
1693
  </tag>
1694
+ <tag line="912" name="return" description="HTML markup to be placed inside the column" type="string">
1695
  <type by_reference="false">string</type>
1696
  </tag>
1697
  </docblock>
1698
+ <argument line="920">
1699
  <name>$item</name>
1700
  <default><![CDATA[]]></default>
1701
  <type/>
1702
  </argument>
1703
  </method>
1704
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="932" package="Media Library Assistant">
1705
  <name>column_date</name>
1706
  <full_name>column_date</full_name>
1707
+ <docblock line="924">
1708
  <description><![CDATA[Supply the content for a custom column]]></description>
1709
  <long-description><![CDATA[]]></long-description>
1710
+ <tag line="924" name="since" description="0.1"/>
1711
+ <tag line="924" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1712
  <type by_reference="false">array</type>
1713
  </tag>
1714
+ <tag line="924" name="return" description="HTML markup to be placed inside the column" type="string">
1715
  <type by_reference="false">string</type>
1716
  </tag>
1717
  </docblock>
1718
+ <argument line="932">
1719
  <name>$item</name>
1720
  <default><![CDATA[]]></default>
1721
  <type/>
1722
  </argument>
1723
  </method>
1724
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="961" package="Media Library Assistant">
1725
  <name>column_modified</name>
1726
  <full_name>column_modified</full_name>
1727
+ <docblock line="953">
1728
  <description><![CDATA[Supply the content for a custom column]]></description>
1729
  <long-description><![CDATA[]]></long-description>
1730
+ <tag line="953" name="since" description="0.30"/>
1731
+ <tag line="953" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1732
  <type by_reference="false">array</type>
1733
  </tag>
1734
+ <tag line="953" name="return" description="HTML markup to be placed inside the column" type="string">
1735
  <type by_reference="false">string</type>
1736
  </tag>
1737
  </docblock>
1738
+ <argument line="961">
1739
  <name>$item</name>
1740
  <default><![CDATA[]]></default>
1741
  <type/>
1742
  </argument>
1743
  </method>
1744
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="990" package="Media Library Assistant">
1745
  <name>column_author</name>
1746
  <full_name>column_author</full_name>
1747
+ <docblock line="982">
1748
  <description><![CDATA[Supply the content for a custom column]]></description>
1749
  <long-description><![CDATA[]]></long-description>
1750
+ <tag line="982" name="since" description="0.30"/>
1751
+ <tag line="982" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1752
  <type by_reference="false">array</type>
1753
  </tag>
1754
+ <tag line="982" name="return" description="HTML markup to be placed inside the column" type="string">
1755
  <type by_reference="false">string</type>
1756
  </tag>
1757
  </docblock>
1758
+ <argument line="990">
1759
  <name>$item</name>
1760
  <default><![CDATA[]]></default>
1761
  <type/>
1762
  </argument>
1763
  </method>
1764
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1011" package="Media Library Assistant">
1765
  <name>column_attached_to</name>
1766
  <full_name>column_attached_to</full_name>
1767
+ <docblock line="1003">
1768
  <description><![CDATA[Supply the content for a custom column]]></description>
1769
  <long-description><![CDATA[]]></long-description>
1770
+ <tag line="1003" name="since" description="0.1"/>
1771
+ <tag line="1003" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1772
  <type by_reference="false">array</type>
1773
  </tag>
1774
+ <tag line="1003" name="return" description="HTML markup to be placed inside the column" type="string">
1775
  <type by_reference="false">string</type>
1776
  </tag>
1777
  </docblock>
1778
+ <argument line="1011">
1779
  <name>$item</name>
1780
  <default><![CDATA[]]></default>
1781
  <type/>
1782
  </argument>
1783
  </method>
1784
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1040" package="Media Library Assistant">
1785
  <name>get_columns</name>
1786
  <full_name>get_columns</full_name>
1787
+ <docblock line="1033">
1788
  <description><![CDATA[This method dictates the table's columns and titles]]></description>
1789
  <long-description><![CDATA[]]></long-description>
1790
+ <tag line="1033" name="since" description="0.1"/>
1791
+ <tag line="1033" name="return" description="Column information: 'slugs'=&gt;'Visible Titles'" type="array">
1792
  <type by_reference="false">array</type>
1793
  </tag>
1794
  </docblock>
1795
  </method>
1796
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1052" package="Media Library Assistant">
1797
  <name>get_hidden_columns</name>
1798
  <full_name>get_hidden_columns</full_name>
1799
+ <docblock line="1044">
1800
  <description><![CDATA[Returns the list of currently hidden columns from a user option or
1801
  from default values if the option is not set]]></description>
1802
  <long-description><![CDATA[]]></long-description>
1803
+ <tag line="1044" name="since" description="0.1"/>
1804
+ <tag line="1044" name="return" description="Column information,e.g., array(0 =&gt; 'ID_parent, 1 =&gt; 'title_name')" type="array">
1805
  <type by_reference="false">array</type>
1806
  </tag>
1807
  </docblock>
1808
  </method>
1809
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1072" package="Media Library Assistant">
1810
  <name>get_sortable_columns</name>
1811
  <full_name>get_sortable_columns</full_name>
1812
+ <docblock line="1062">
1813
  <description><![CDATA[Returns an array where the key is the column that needs to be sortable
1814
  and the value is db column to sort by.]]></description>
1815
  <long-description><![CDATA[<p>Also notes the current sort column,
1816
  if set.</p>]]></long-description>
1817
+ <tag line="1062" name="since" description="0.1"/>
1818
+ <tag line="1062" name="return" description="Sortable column information,e.g., 'slugs'=&gt;array('data_values',boolean)" type="array">
1819
  <type by_reference="false">array</type>
1820
  </tag>
1821
  </docblock>
1822
  </method>
1823
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1099" package="Media Library Assistant">
1824
  <name>get_views</name>
1825
  <full_name>get_views</full_name>
1826
+ <docblock line="1091">
1827
  <description><![CDATA[Returns an associative array listing all the views that can be used with this table.]]></description>
1828
  <long-description><![CDATA[<p>These are listed across the top of the page and managed by WordPress.</p>]]></long-description>
1829
+ <tag line="1091" name="since" description="0.1"/>
1830
+ <tag line="1091" name="return" description="View information,e.g., array ( id =&gt; link )" type="array">
1831
  <type by_reference="false">array</type>
1832
  </tag>
1833
  </docblock>
1834
  </method>
1835
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1174" package="Media Library Assistant">
1836
  <name>get_bulk_actions</name>
1837
  <full_name>get_bulk_actions</full_name>
1838
+ <docblock line="1166">
1839
  <description><![CDATA[Get an associative array ( option_name => option_title ) with the list
1840
  of bulk actions available on this table.]]></description>
1841
  <long-description><![CDATA[]]></long-description>
1842
+ <tag line="1166" name="since" description="0.1"/>
1843
+ <tag line="1166" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
1844
  <type by_reference="false">array</type>
1845
  </tag>
1846
  </docblock>
1847
  </method>
1848
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1205" package="Media Library Assistant">
1849
  <name>extra_tablenav</name>
1850
  <full_name>extra_tablenav</full_name>
1851
+ <docblock line="1194">
1852
  <description><![CDATA[Extra controls to be displayed between bulk actions and pagination]]></description>
1853
  <long-description><![CDATA[<p>Modeled after class-wp-posts-list-table.php in wp-admin/includes.</p>]]></long-description>
1854
+ <tag line="1194" name="since" description="0.1"/>
1855
+ <tag line="1194" name="param" description="'top' or 'bottom', i.e., above or below the table rows" type="string" variable="$which">
1856
  <type by_reference="false">string</type>
1857
  </tag>
1858
+ <tag line="1194" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
1859
  <type by_reference="false">array</type>
1860
  </tag>
1861
  </docblock>
1862
+ <argument line="1205">
1863
  <name>$which</name>
1864
  <default><![CDATA[]]></default>
1865
  <type/>
1866
  </argument>
1867
  </method>
1868
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1265" package="Media Library Assistant">
1869
  <name>prepare_items</name>
1870
  <full_name>prepare_items</full_name>
1871
+ <docblock line="1253">
1872
  <description><![CDATA[Prepares the list of items for displaying]]></description>
1873
  <long-description><![CDATA[<p>This is where you prepare your data for display. This method will usually
1874
  be used to query the database, sort and filter the data, and generally
1875
  get it ready to be displayed. At a minimum, we should set $this->items and
1876
  $this->set_pagination_args().</p>]]></long-description>
1877
+ <tag line="1253" name="since" description="0.1"/>
1878
+ <tag line="1253" name="return" description="" type="void">
1879
  <type by_reference="false">void</type>
1880
  </tag>
1881
  </docblock>
1882
  </method>
1883
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1311" package="Media Library Assistant">
1884
  <name>single_row</name>
1885
  <full_name>single_row</full_name>
1886
+ <docblock line="1302">
1887
  <description><![CDATA[Generates (echoes) content for a single row of the table]]></description>
1888
  <long-description><![CDATA[]]></long-description>
1889
+ <tag line="1302" name="since" description=".20"/>
1890
+ <tag line="1302" name="param" description="the current item" type="object" variable="$item">
1891
  <type by_reference="false">object</type>
1892
  </tag>
1893
+ <tag line="1302" name="return" description="Echoes the row HTML" type="void">
1894
  <type by_reference="false">void</type>
1895
  </tag>
1896
  </docblock>
1897
+ <argument line="1311">
1898
  <name>$item</name>
1899
  <default><![CDATA[]]></default>
1900
  <type/>
1902
  </method>
1903
  </class>
1904
  </file>
1905
+ <file path="includes\class-mla-main.php" hash="0a39e4b57804d47a9b32a27bc4bba097" package="Media Library Assistant">
1906
  <docblock line="2">
1907
  <description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
1908
  <long-description><![CDATA[]]></long-description>
1939
  <constant namespace="global" line="41" package="Media Library Assistant">
1940
  <name>CURRENT_MLA_VERSION</name>
1941
  <full_name>CURRENT_MLA_VERSION</full_name>
1942
+ <value><![CDATA['1.10']]></value>
1943
  <docblock line="34">
1944
  <description><![CDATA[Current version number]]></description>
1945
  <long-description><![CDATA[]]></long-description>
2132
  </docblock>
2133
  </constant>
2134
  <constant namespace="global" line="176" package="Media Library Assistant">
2135
+ <name>MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP</name>
2136
+ <full_name>MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP</full_name>
2137
+ <value><![CDATA['single_item_custom_field_map']]></value>
2138
+ <docblock line="169">
2139
+ <description><![CDATA[mla_admin_action value for mapping Custom Field metadata]]></description>
2140
+ <long-description><![CDATA[]]></long-description>
2141
+ <tag line="169" name="since" description="1.10"/>
2142
+ <tag line="169" name="var" description="" type="string">
2143
+ <type by_reference="false">string</type>
2144
+ </tag>
2145
+ </docblock>
2146
+ </constant>
2147
+ <constant namespace="global" line="185" package="Media Library Assistant">
2148
  <name>MLA_ADMIN_SINGLE_MAP</name>
2149
  <full_name>MLA_ADMIN_SINGLE_MAP</full_name>
2150
  <value><![CDATA['single_item_map']]></value>
2151
+ <docblock line="178">
2152
  <description><![CDATA[mla_admin_action value for mapping IPTC/EXIF metadata]]></description>
2153
  <long-description><![CDATA[]]></long-description>
2154
+ <tag line="178" name="since" description="1.00"/>
2155
+ <tag line="178" name="var" description="" type="string">
2156
  <type by_reference="false">string</type>
2157
  </tag>
2158
  </docblock>
2159
  </constant>
2160
+ <property final="false" static="true" visibility="private" line="194" namespace="global" package="Media Library Assistant">
2161
  <name>$page_hooks</name>
2162
  <default><![CDATA[array()]]></default>
2163
+ <docblock line="187">
2164
  <description><![CDATA[Holds screen ids to match help text to corresponding screen]]></description>
2165
  <long-description><![CDATA[]]></long-description>
2166
+ <tag line="187" name="since" description="0.1"/>
2167
+ <tag line="187" name="var" description="" type="array">
2168
  <type by_reference="false">array</type>
2169
  </tag>
2170
  </docblock>
2171
  </property>
2172
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="207" package="Media Library Assistant">
2173
  <name>initialize</name>
2174
  <full_name>initialize</full_name>
2175
+ <docblock line="196">
2176
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
2177
  <long-description><![CDATA[<p>This function contains add_action and add_filter calls
2178
  to set up the Ajax handlers, enqueue JavaScript and CSS files, and
2179
  set up the Assistant submenu.</p>]]></long-description>
2180
+ <tag line="196" name="since" description="0.1"/>
2181
+ <tag line="196" name="return" description="" type="void">
2182
  <type by_reference="false">void</type>
2183
  </tag>
2184
  </docblock>
2185
  </method>
2186
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="226" package="Media Library Assistant">
2187
  <name>mla_admin_init_action</name>
2188
  <full_name>mla_admin_init_action</full_name>
2189
+ <docblock line="219">
2190
+ <description><![CDATA[Load the plugin's Ajax handler or process Edit Media update actions]]></description>
2191
  <long-description><![CDATA[]]></long-description>
2192
+ <tag line="219" name="since" description="0.20"/>
2193
+ <tag line="219" name="return" description="" type="void">
2194
  <type by_reference="false">void</type>
2195
  </tag>
2196
  </docblock>
2197
  </method>
2198
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="268" package="Media Library Assistant">
2199
  <name>mla_admin_enqueue_scripts_action</name>
2200
  <full_name>mla_admin_enqueue_scripts_action</full_name>
2201
+ <docblock line="259">
2202
  <description><![CDATA[Load the plugin's Style Sheet and Javascript files]]></description>
2203
  <long-description><![CDATA[]]></long-description>
2204
+ <tag line="259" name="since" description="0.1"/>
2205
+ <tag line="259" name="param" description="Name of the page being loaded" type="string" variable="$page_hook">
2206
  <type by_reference="false">string</type>
2207
  </tag>
2208
+ <tag line="259" name="return" description="" type="void">
2209
  <type by_reference="false">void</type>
2210
  </tag>
2211
  </docblock>
2212
+ <argument line="268">
2213
  <name>$page_hook</name>
2214
  <default><![CDATA[]]></default>
2215
  <type/>
2216
  </argument>
2217
  </method>
2218
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="316" package="Media Library Assistant">
2219
  <name>mla_admin_menu_action</name>
2220
  <full_name>mla_admin_menu_action</full_name>
2221
+ <docblock line="301">
2222
  <description><![CDATA[Add the submenu pages]]></description>
2223
  <long-description><![CDATA[<p>Add a submenu page in the "Media" section,
2224
  add settings page in the "Settings" section.
2227
  <p>For WordPress versions before 3.5,
2228
  add submenu page(s) for attachment taxonomies,
2229
  add filter to clean up taxonomy submenu labels.</p>]]></long-description>
2230
+ <tag line="301" name="since" description="0.1"/>
2231
+ <tag line="301" name="return" description="" type="void">
 
 
 
 
 
 
 
 
 
 
 
 
2232
  <type by_reference="false">void</type>
2233
  </tag>
2234
  </docblock>
2235
  </method>
2236
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="353" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
2237
  <name>mla_add_menu_options</name>
2238
  <full_name>mla_add_menu_options</full_name>
2239
+ <docblock line="346">
2240
  <description><![CDATA[Add the "XX Entries per page" filter to the Screen Options tab]]></description>
2241
  <long-description><![CDATA[]]></long-description>
2242
+ <tag line="346" name="since" description="0.1"/>
2243
+ <tag line="346" name="return" description="" type="void">
2244
  <type by_reference="false">void</type>
2245
  </tag>
2246
  </docblock>
2247
  </method>
2248
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="372" package="Media Library Assistant">
2249
  <name>mla_add_help_tab</name>
2250
  <full_name>mla_add_help_tab</full_name>
2251
+ <docblock line="365">
2252
  <description><![CDATA[Add contextual help tabs to all the MLA pages]]></description>
2253
  <long-description><![CDATA[]]></long-description>
2254
+ <tag line="365" name="since" description="0.1"/>
2255
+ <tag line="365" name="return" description="" type="void">
2256
  <type by_reference="false">void</type>
2257
  </tag>
2258
  </docblock>
2259
  </method>
2260
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="461" package="Media Library Assistant">
2261
  <name>mla_screen_options_show_screen_filter</name>
2262
  <full_name>mla_screen_options_show_screen_filter</full_name>
2263
+ <docblock line="451">
2264
  <description><![CDATA[Only show screen options on the table-list screen]]></description>
2265
  <long-description><![CDATA[]]></long-description>
2266
+ <tag line="451" name="since" description="0.1"/>
2267
+ <tag line="451" name="param" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean" variable="$show_screen">
2268
  <type by_reference="false">boolean</type>
2269
  </tag>
2270
+ <tag line="451" name="param" description="Name of the page being loaded" type="string" variable="$this_screen">
2271
  <type by_reference="false">string</type>
2272
  </tag>
2273
+ <tag line="451" name="return" description="True to display &quot;Screen Options&quot;, false to suppress them" type="boolean">
2274
  <type by_reference="false">boolean</type>
2275
  </tag>
2276
  </docblock>
2277
+ <argument line="461">
2278
  <name>$show_screen</name>
2279
  <default><![CDATA[]]></default>
2280
  <type/>
2281
  </argument>
2282
+ <argument line="461">
2283
  <name>$this_screen</name>
2284
  <default><![CDATA[]]></default>
2285
  <type/>
2286
  </argument>
2287
  </method>
2288
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="479" package="Media Library Assistant">
2289
  <name>mla_set_screen_option_filter</name>
2290
  <full_name>mla_set_screen_option_filter</full_name>
2291
+ <docblock line="468">
2292
  <description><![CDATA[Save the "Entries per page" option set by this user]]></description>
2293
  <long-description><![CDATA[]]></long-description>
2294
+ <tag line="468" name="since" description="0.1"/>
2295
+ <tag line="468" name="param" description="Unknown - always false?" type="boolean" variable="$status">
2296
  <type by_reference="false">boolean</type>
2297
  </tag>
2298
+ <tag line="468" name="param" description="Name of the option being changed" type="string" variable="$option">
2299
  <type by_reference="false">string</type>
2300
  </tag>
2301
+ <tag line="468" name="param" description="New value of the option" type="string" variable="$value">
2302
  <type by_reference="false">string</type>
2303
  </tag>
2304
+ <tag line="468" name="return" description="New value if this is our option, otherwise nothing" type="string|void">
2305
  <type by_reference="false">string</type>
2306
  <type by_reference="false">void</type>
2307
  </tag>
2308
  </docblock>
2309
+ <argument line="479">
2310
  <name>$status</name>
2311
  <default><![CDATA[]]></default>
2312
  <type/>
2313
  </argument>
2314
+ <argument line="479">
2315
  <name>$option</name>
2316
  <default><![CDATA[]]></default>
2317
  <type/>
2318
  </argument>
2319
+ <argument line="479">
2320
  <name>$value</name>
2321
  <default><![CDATA[]]></default>
2322
  <type/>
2323
  </argument>
2324
  </method>
2325
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="496" package="Media Library Assistant">
2326
  <name>mla_edit_tax_redirect</name>
2327
  <full_name>mla_edit_tax_redirect</full_name>
2328
+ <docblock line="485">
2329
  <description><![CDATA[Redirect to the Edit Tags/Categories page]]></description>
2330
  <long-description><![CDATA[<p>The custom taxonomy add/edit submenu entries go to "upload.php" by default.
2331
  This filter is the only way to redirect them to the correct WordPress page.
2332
  The filter is not required for WordPress 3.5 and later.</p>]]></long-description>
2333
+ <tag line="485" name="since" description="0.1"/>
2334
+ <tag line="485" name="return" description="" type="void">
2335
  <type by_reference="false">void</type>
2336
  </tag>
2337
  </docblock>
2338
  </method>
2339
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="529" package="Media Library Assistant">
2340
  <name>mla_parent_file_filter</name>
2341
  <full_name>mla_parent_file_filter</full_name>
2342
+ <docblock line="513">
2343
  <description><![CDATA[Cleanup menus for Edit Tags/Categories page]]></description>
2344
  <long-description><![CDATA[<p>For WordPress before 3.5, the submenu entries for custom taxonomies
2345
  under the "Media" menu are not set up correctly by WordPress, so this
2347
  page for editing/adding taxonomy terms.
2348
  For WordPress 3.5 and later, the function fixes the submenu bolding when
2349
  going to the Edit Media screen.</p>]]></long-description>
2350
+ <tag line="513" name="since" description="0.1"/>
2351
+ <tag line="513" name="param" description="The top-level menu page" type="array" variable="$parent_file">
2352
  <type by_reference="false">array</type>
2353
  </tag>
2354
+ <tag line="513" name="return" description="The updated top-level menu page" type="string">
2355
  <type by_reference="false">string</type>
2356
  </tag>
2357
  </docblock>
2358
+ <argument line="529">
2359
  <name>$parent_file</name>
2360
  <default><![CDATA[]]></default>
2361
  <type/>
2362
  </argument>
2363
  </method>
2364
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="572" package="Media Library Assistant">
2365
  <name>mla_render_admin_page</name>
2366
  <full_name>mla_render_admin_page</full_name>
2367
+ <docblock line="565">
2368
  <description><![CDATA[Render the "Assistant" subpage in the Media section, using the list_table package]]></description>
2369
  <long-description><![CDATA[]]></long-description>
2370
+ <tag line="565" name="since" description="0.1"/>
2371
+ <tag line="565" name="return" description="" type="void">
2372
  <type by_reference="false">void</type>
2373
  </tag>
2374
  </docblock>
2375
  </method>
2376
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="842" package="Media Library Assistant">
2377
  <name>mla_inline_edit_action</name>
2378
  <full_name>mla_inline_edit_action</full_name>
2379
+ <docblock line="833">
2380
  <description><![CDATA[Ajax handler for inline editing (quick and bulk edit)]]></description>
2381
  <long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
2382
+ <tag line="833" name="since" description="0.20"/>
2383
+ <tag line="833" name="return" description="echo HTML &lt;tr&gt; markup for updated row or error message, then die()" type="void">
2384
  <type by_reference="false">void</type>
2385
  </tag>
2386
  </docblock>
2387
  </method>
2388
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="922" package="Media Library Assistant">
2389
  <name>_build_inline_edit_form</name>
2390
  <full_name>_build_inline_edit_form</full_name>
2391
+ <docblock line="911">
2392
  <description><![CDATA[Build the hidden row templates for inline editing (quick and bulk edit)]]></description>
2393
  <long-description><![CDATA[<p>inspired by inline_edit() in wp-admin\includes\class-wp-posts-list-table.php.</p>]]></long-description>
2394
+ <tag line="911" name="since" description="0.20"/>
2395
+ <tag line="911" name="param" description="MLA List Table object" type="object" variable="$MLAListTable">
2396
  <type by_reference="false">object</type>
2397
  </tag>
2398
+ <tag line="911" name="return" description="HTML &lt;form&gt; markup for hidden rows" type="string">
2399
  <type by_reference="false">string</type>
2400
  </tag>
2401
  </docblock>
2402
+ <argument line="922">
2403
  <name>$MLAListTable</name>
2404
  <default><![CDATA[]]></default>
2405
  <type/>
2406
  </argument>
2407
  </method>
2408
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1059" package="Media Library Assistant">
2409
  <name>_authors_dropdown</name>
2410
  <full_name>_authors_dropdown</full_name>
2411
+ <docblock line="1048">
2412
  <description><![CDATA[Get the edit Authors dropdown box, if user has suitable permissions]]></description>
2413
  <long-description><![CDATA[]]></long-description>
2414
+ <tag line="1048" name="since" description="0.20"/>
2415
+ <tag line="1048" name="param" description="Optional User ID of the current author, default 0" type="integer" variable="$author">
2416
  <type by_reference="false">integer</type>
2417
  </tag>
2418
+ <tag line="1048" name="param" description="Optional HTML name attribute, default 'post_author'" type="string" variable="$name">
2419
  <type by_reference="false">string</type>
2420
  </tag>
2421
+ <tag line="1048" name="param" description="Optional HTML class attribute, default 'authors'" type="string" variable="$class">
2422
  <type by_reference="false">string</type>
2423
  </tag>
2424
+ <tag line="1048" name="return" description="HTML markup for the dropdown field or False" type="string|false">
2425
  <type by_reference="false">string</type>
2426
  <type by_reference="false">false</type>
2427
  </tag>
2428
  </docblock>
2429
+ <argument line="1059">
2430
  <name>$author</name>
2431
  <default><![CDATA[0]]></default>
2432
  <type/>
2433
  </argument>
2434
+ <argument line="1059">
2435
  <name>$name</name>
2436
  <default><![CDATA['post_author']]></default>
2437
  <type/>
2438
  </argument>
2439
+ <argument line="1059">
2440
  <name>$class</name>
2441
  <default><![CDATA['authors']]></default>
2442
  <type/>
2443
  </argument>
2444
  </method>
2445
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1093" package="Media Library Assistant">
2446
  <name>_current_bulk_action</name>
2447
  <full_name>_current_bulk_action</full_name>
2448
+ <docblock line="1086">
2449
  <description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
2450
  <long-description><![CDATA[]]></long-description>
2451
+ <tag line="1086" name="since" description="0.1"/>
2452
+ <tag line="1086" name="return" description="The action name or False if no action was selected" type="string|false">
2453
  <type by_reference="false">string</type>
2454
  <type by_reference="false">false</type>
2455
  </tag>
2456
  </docblock>
2457
  </method>
2458
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1122" package="Media Library Assistant">
2459
  <name>_delete_single_item</name>
2460
  <full_name>_delete_single_item</full_name>
2461
+ <docblock line="1113">
2462
  <description><![CDATA[Delete a single item permanently]]></description>
2463
  <long-description><![CDATA[]]></long-description>
2464
+ <tag line="1113" name="since" description="0.1"/>
2465
+ <tag line="1113" name="param" description="The form POST data" type="array" variable="$post_id">
2466
  <type by_reference="false">array</type>
2467
  </tag>
2468
+ <tag line="1113" name="return" description="success/failure message and NULL content" type="array">
2469
  <type by_reference="false">array</type>
2470
  </tag>
2471
  </docblock>
2472
+ <argument line="1122">
2473
  <name>$post_id</name>
2474
  <default><![CDATA[]]></default>
2475
  <type/>
2476
  </argument>
2477
  </method>
2478
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1151" package="Media Library Assistant">
2479
  <name>_display_single_item</name>
2480
  <full_name>_display_single_item</full_name>
2481
+ <docblock line="1141">
2482
  <description><![CDATA[Display a single item sub page; prepare the form to
2483
  change the meta data for a single attachment.]]></description>
2484
  <long-description><![CDATA[]]></long-description>
2485
+ <tag line="1141" name="since" description="0.1"/>
2486
+ <tag line="1141" name="param" description="The WordPress Post ID of the attachment item" type="int" variable="$post_id">
2487
  <type by_reference="false">int</type>
2488
  </tag>
2489
+ <tag line="1141" name="return" description="message and/or HTML content" type="array">
2490
  <type by_reference="false">array</type>
2491
  </tag>
2492
  </docblock>
2493
+ <argument line="1151">
2494
  <name>$post_id</name>
2495
  <default><![CDATA[]]></default>
2496
  <type/>
2497
  </argument>
2498
  </method>
2499
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1391" package="Media Library Assistant">
2500
  <name>_restore_single_item</name>
2501
  <full_name>_restore_single_item</full_name>
2502
+ <docblock line="1382">
2503
  <description><![CDATA[Restore a single item from the Trash]]></description>
2504
  <long-description><![CDATA[]]></long-description>
2505
+ <tag line="1382" name="since" description="0.1"/>
2506
+ <tag line="1382" name="param" description="The form POST data" type="array" variable="$post_id">
2507
  <type by_reference="false">array</type>
2508
  </tag>
2509
+ <tag line="1382" name="return" description="success/failure message and NULL content" type="array">
2510
  <type by_reference="false">array</type>
2511
  </tag>
2512
  </docblock>
2513
+ <argument line="1391">
2514
  <name>$post_id</name>
2515
  <default><![CDATA[]]></default>
2516
  <type/>
2517
  </argument>
2518
  </method>
2519
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1427" package="Media Library Assistant">
2520
  <name>_trash_single_item</name>
2521
  <full_name>_trash_single_item</full_name>
2522
+ <docblock line="1418">
2523
  <description><![CDATA[Move a single item to Trash]]></description>
2524
  <long-description><![CDATA[]]></long-description>
2525
+ <tag line="1418" name="since" description="0.1"/>
2526
+ <tag line="1418" name="param" description="The form POST data" type="array" variable="$post_id">
2527
  <type by_reference="false">array</type>
2528
  </tag>
2529
+ <tag line="1418" name="return" description="success/failure message and NULL content" type="array">
2530
  <type by_reference="false">array</type>
2531
  </tag>
2532
  </docblock>
2533
+ <argument line="1427">
2534
  <name>$post_id</name>
2535
  <default><![CDATA[]]></default>
2536
  <type/>
2639
  </method>
2640
  </class>
2641
  </file>
2642
+ <file path="includes\class-mla-options.php" hash="f9e38aeb5c91bc79d23c75edd466200c" package="Media Library Assistant">
2643
  <docblock line="2">
2644
  <description><![CDATA[Manages the plugin option settings]]></description>
2645
  <long-description><![CDATA[]]></long-description>
2703
  </docblock>
2704
  </constant>
2705
  <constant namespace="global" line="47" package="Media Library Assistant">
2706
+ <name>MLA_NEW_CUSTOM_RULE</name>
2707
+ <full_name>MLA_NEW_CUSTOM_RULE</full_name>
2708
+ <value><![CDATA['__NEW RULE__']]></value>
2709
+ <docblock line="44">
2710
+ <description><![CDATA[Provides a unique name for the Custom Field "new rule" key]]></description>
2711
+ <long-description><![CDATA[]]></long-description>
2712
+ </docblock>
2713
+ </constant>
2714
+ <constant namespace="global" line="52" package="Media Library Assistant">
2715
  <name>MLA_NEW_CUSTOM_FIELD</name>
2716
  <full_name>MLA_NEW_CUSTOM_FIELD</full_name>
2717
  <value><![CDATA['__NEW FIELD__']]></value>
2718
+ <docblock line="49">
2719
  <description><![CDATA[Provides a unique name for the Custom Field "new field" key]]></description>
2720
  <long-description><![CDATA[]]></long-description>
2721
  </docblock>
2722
  </constant>
2723
+ <property final="false" static="true" visibility="public" line="63" namespace="global" package="Media Library Assistant">
2724
  <name>$process_featured_in</name>
2725
  <default><![CDATA[true]]></default>
2726
+ <docblock line="54">
2727
  <description><![CDATA[Option setting for "Featured in" reporting]]></description>
2728
  <long-description><![CDATA[<p>This setting is false if the "Featured in" database access setting is "disabled", else true.</p>]]></long-description>
2729
+ <tag line="54" name="since" description="1.00"/>
2730
+ <tag line="54" name="var" description="" type="boolean">
2731
  <type by_reference="false">boolean</type>
2732
  </tag>
2733
  </docblock>
2734
  </property>
2735
+ <property final="false" static="true" visibility="public" line="74" namespace="global" package="Media Library Assistant">
2736
  <name>$process_inserted_in</name>
2737
  <default><![CDATA[true]]></default>
2738
+ <docblock line="65">
2739
  <description><![CDATA[Option setting for "Inserted in" reporting]]></description>
2740
  <long-description><![CDATA[<p>This setting is false if the "Inserted in" database access setting is "disabled", else true.</p>]]></long-description>
2741
+ <tag line="65" name="since" description="1.00"/>
2742
+ <tag line="65" name="var" description="" type="boolean">
2743
  <type by_reference="false">boolean</type>
2744
  </tag>
2745
  </docblock>
2746
  </property>
2747
+ <property final="false" static="true" visibility="public" line="85" namespace="global" package="Media Library Assistant">
2748
  <name>$process_gallery_in</name>
2749
  <default><![CDATA[true]]></default>
2750
+ <docblock line="76">
2751
  <description><![CDATA[Option setting for "Gallery in" reporting]]></description>
2752
  <long-description><![CDATA[<p>This setting is false if the "Gallery in" database access setting is "disabled", else true.</p>]]></long-description>
2753
+ <tag line="76" name="since" description="1.00"/>
2754
+ <tag line="76" name="var" description="" type="boolean">
2755
  <type by_reference="false">boolean</type>
2756
  </tag>
2757
  </docblock>
2758
  </property>
2759
+ <property final="false" static="true" visibility="public" line="96" namespace="global" package="Media Library Assistant">
2760
  <name>$process_mla_gallery_in</name>
2761
  <default><![CDATA[true]]></default>
2762
+ <docblock line="87">
2763
  <description><![CDATA[Option setting for "MLA Gallery in" reporting]]></description>
2764
  <long-description><![CDATA[<p>This setting is false if the "MLA Gallery in" database access setting is "disabled", else true.</p>]]></long-description>
2765
+ <tag line="87" name="since" description="1.00"/>
2766
+ <tag line="87" name="var" description="" type="boolean">
2767
  <type by_reference="false">boolean</type>
2768
  </tag>
2769
  </docblock>
2770
  </property>
2771
+ <property final="false" static="true" visibility="public" line="123" namespace="global" package="Media Library Assistant">
2772
  <name>$mla_option_definitions</name>
2773
+ <default><![CDATA[array(self::MLA_VERSION_OPTION => array('tab' => '', 'type' => 'hidden', 'std' => '0'), 'attachment_category' => array('tab' => '', 'name' => 'Attachment Categories', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to add support for Attachment Categories.'), 'attachment_tag' => array('tab' => '', 'name' => 'Attachment Tags', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to add support for Attachment Tags.'), 'where_used_heading' => array('tab' => 'general', 'name' => 'Where-used Reporting', 'type' => 'header'), 'exclude_revisions' => array('tab' => 'general', 'name' => 'Exclude Revisions', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to exclude revisions from where-used reporting.'), 'where_used_subheading' => array('tab' => 'general', 'name' => 'Where-used database access tuning', 'type' => 'subheader'), self::MLA_FEATURED_IN_TUNING => array('tab' => 'general', 'name' => 'Featured in', 'type' => 'select', 'std' => 'enabled', 'options' => array('enabled', 'disabled'), 'texts' => array('Enabled', 'Disabled'), 'help' => 'Search database posts and pages for Featured Image attachments.'), self::MLA_INSERTED_IN_TUNING => array('tab' => 'general', 'name' => 'Inserted in', 'type' => 'select', 'std' => 'enabled', 'options' => array('enabled', 'disabled'), 'texts' => array('Enabled', 'Disabled'), 'help' => 'Search database posts and pages for attachments embedded in content.'), self::MLA_GALLERY_IN_TUNING => array('tab' => 'general', 'name' => 'Gallery in', 'type' => 'select', 'std' => 'cached', 'options' => array('dynamic', 'refresh', 'cached', 'disabled'), 'texts' => array('Dynamic', 'Refresh', 'Cached', 'Disabled'), 'help' => 'Search database posts and pages for [gallery] shortcode results.<br>&nbsp;&nbsp;Dynamic = once every page load, Cached = once every login, Disabled = never.<br>&nbsp;&nbsp;Refresh = update references, then set to Cached.'), self::MLA_MLA_GALLERY_IN_TUNING => array('tab' => 'general', 'name' => 'MLA Gallery in', 'type' => 'select', 'std' => 'cached', 'options' => array('dynamic', 'refresh', 'cached', 'disabled'), 'texts' => array('Dynamic', 'Refresh', 'Cached', 'Disabled'), 'help' => 'Search database posts and pages for [mla_gallery] shortcode results.<br>&nbsp;&nbsp;Dynamic = once every page load, Cached = once every login, Disabled = never.<br>&nbsp;&nbsp;Refresh = update references, then set to Cached.'), 'taxonomy_heading' => array('tab' => 'general', 'name' => 'Taxonomy Support', 'type' => 'header'), 'taxonomy_support' => array('tab' => 'general', 'help' => 'Check the "Support" box to add the taxonomy to the Assistant.<br>Check the "Inline Edit" box to display the taxonomy in the Quick Edit and Bulk Edit areas.<br>Use the "List Filter" option to select the taxonomy on which to filter the Assistant table listing.', 'std' => array('tax_support' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_quick_edit' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_filter' => 'attachment_category'), 'type' => 'custom', 'render' => 'mla_taxonomy_option_handler', 'update' => 'mla_taxonomy_option_handler', 'delete' => 'mla_taxonomy_option_handler', 'reset' => 'mla_taxonomy_option_handler'), 'orderby_heading' => array('tab' => 'general', 'name' => 'Default Table Listing Sort Order', 'type' => 'header'), 'default_orderby' => array('tab' => 'general', 'name' => 'Order By', 'type' => 'select', 'std' => 'title_name', 'options' => array('none', 'title_name'), 'texts' => array('None', 'Title/Name'), 'help' => 'Select the column for the sort order of the Assistant table listing.'), 'default_order' => array('tab' => 'general', 'name' => 'Order', 'type' => 'radio', 'std' => 'ASC', 'options' => array('ASC', 'DESC'), 'texts' => array('Ascending', 'Descending'), 'help' => 'Choose the sort order.'), 'template_heading' => array('tab' => 'mla-gallery', 'name' => 'Default [mla_gallery] Templates', 'type' => 'header'), 'default_style' => array('tab' => 'mla-gallery', 'name' => 'Style Template', 'type' => 'select', 'std' => 'default', 'options' => array(), 'texts' => array(), 'help' => 'Select the default style template for your [mla_gallery] shortcodes.'), 'default_markup' => array('tab' => 'mla-gallery', 'name' => 'Markup Template', 'type' => 'select', 'std' => 'default', 'options' => array(), 'texts' => array(), 'help' => 'Select the default markup template for your [mla_gallery] shortcodes.'), 'style_templates' => array('tab' => '', 'type' => 'hidden', 'std' => array()), 'markup_templates' => array('tab' => '', 'type' => 'hidden', 'std' => array()), 'enable_custom_field_mapping' => array('tab' => 'custom-field', 'name' => 'Enable custom field mapping when adding new media', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable mapping when uploading new media (attachments).<br>&nbsp;&nbsp;Click Save Changes at the bottom of the screen if you change this option.<br>&nbsp;&nbsp;Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'), 'custom_field_mapping' => array('tab' => '', 'help' => '&nbsp;<br>Update the custom field mapping values above, then click Save Changes to make the updates permanent.<br>You can also make temporary updates and click a Map All Attachments button to apply the rule(s) to all attachments without saving any rule changes.', 'std' => array(), 'type' => 'custom', 'render' => 'mla_custom_field_option_handler', 'update' => 'mla_custom_field_option_handler', 'delete' => 'mla_custom_field_option_handler', 'reset' => 'mla_custom_field_option_handler'), 'enable_iptc_exif_mapping' => array('tab' => 'iptc-exif', 'name' => 'Enable IPTC/EXIF Mapping when adding new media', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable mapping when uploading new media (attachments).<br>&nbsp;&nbsp;Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'), 'iptc_exif_standard_mapping' => array('tab' => '', 'help' => 'Update the standard field mapping values above, then click Save Changes to make the updates permanent.<br>You can also make temporary updates and click Map All Attachments Now to apply the updates to all attachments without saving the rule changes.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_taxonomy_mapping' => array('tab' => '', 'help' => 'Update the taxonomy term mapping values above, then click Save Changes or Map All Attachments Now.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_custom_mapping' => array('tab' => '', 'help' => 'Update the custom field mapping values above.<br>To define a new custom field, enter a field name in the "Field Title" text box at the end of the list and Save Changes.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_mapping' => array('tab' => '', 'help' => 'IPTC/EXIF Mapping help', 'std' => array('standard' => array('post_title' => array('name' => 'Title', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_name' => array('name' => 'Name/Slug', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'image_alt' => array('name' => 'Alternate Text', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_excerpt' => array('name' => 'Caption', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_content' => array('name' => 'Description', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true)), 'taxonomy' => array(), 'custom' => array()), 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'))]]></default>
2774
+ <docblock line="98">
2775
  <description><![CDATA[$mla_option_definitions defines the database options and admin page areas for setting/updating them.]]></description>
2776
  <long-description><![CDATA[<p>Each option is defined by an array with the following elements:</p>
2777
 
2797
  $message = ['reset']( 'reset', $key, $value, $_REQUEST );</p>]]></long-description>
2798
  </docblock>
2799
  </property>
2800
+ <property final="false" static="true" visibility="private" line="447" namespace="global" package="Media Library Assistant">
2801
  <name>$mla_option_templates</name>
2802
  <default><![CDATA[null]]></default>
2803
+ <docblock line="440">
2804
  <description><![CDATA[Style and Markup templates]]></description>
2805
  <long-description><![CDATA[]]></long-description>
2806
+ <tag line="440" name="since" description="0.80"/>
2807
+ <tag line="440" name="var" description="" type="array">
2808
  <type by_reference="false">array</type>
2809
  </tag>
2810
  </docblock>
2811
  </property>
2812
+ <property final="false" static="true" visibility="private" line="1348" namespace="global" package="Media Library Assistant">
2813
+ <name>$custom_field_data_sources</name>
2814
+ <default><![CDATA[array('path', 'file_name', 'extension', 'file_size', 'dimensions', 'pixels', 'width', 'height', 'hwstring_small', 'size_keys', 'size_names', 'size_bytes', 'size_pixels', 'size_dimensions', 'size_name[size]', 'size_bytes[size]', 'size_pixels[size]', 'size_dimensions[size]', 'parent_type', 'parent_title', 'parent_issues', 'reference_issues', 'aperture', 'credit', 'camera', 'caption', 'created_timestamp', 'copyright', 'focal_length', 'iso', 'shutter_speed', 'title')]]></default>
2815
+ <docblock line="1341">
2816
+ <description><![CDATA[Array of Data Source names for custom field mapping]]></description>
2817
+ <long-description><![CDATA[]]></long-description>
2818
+ <tag line="1341" name="since" description="1.10"/>
2819
+ <tag line="1341" name="var" description="" type="array">
2820
+ <type by_reference="false">array</type>
2821
+ </tag>
2822
+ </docblock>
2823
+ </property>
2824
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="421" package="Media Library Assistant">
2825
  <name>initialize</name>
2826
  <full_name>initialize</full_name>
2827
+ <docblock line="414">
2828
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
2829
  <long-description><![CDATA[]]></long-description>
2830
+ <tag line="414" name="since" description="1.00"/>
2831
+ <tag line="414" name="return" description="" type="void">
2832
  <type by_reference="false">void</type>
2833
  </tag>
2834
  </docblock>
2835
  </method>
2836
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="456" package="Media Library Assistant">
2837
  <name>_load_option_templates</name>
2838
  <full_name>_load_option_templates</full_name>
2839
+ <docblock line="449">
2840
  <description><![CDATA[Load style and markup templates to $mla_templates]]></description>
2841
  <long-description><![CDATA[]]></long-description>
2842
+ <tag line="449" name="since" description="0.80"/>
2843
+ <tag line="449" name="return" description="" type="void">
2844
  <type by_reference="false">void</type>
2845
  </tag>
2846
  </docblock>
2847
  </method>
2848
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="504" package="Media Library Assistant">
2849
  <name>mla_fetch_gallery_template</name>
2850
  <full_name>mla_fetch_gallery_template</full_name>
2851
+ <docblock line="494">
2852
  <description><![CDATA[Fetch style or markup template from $mla_templates]]></description>
2853
  <long-description><![CDATA[]]></long-description>
2854
+ <tag line="494" name="since" description="0.80"/>
2855
+ <tag line="494" name="param" description="Template name" type="string" variable="$key">
2856
  <type by_reference="false">string</type>
2857
  </tag>
2858
+ <tag line="494" name="param" description="Template type; 'style' (default) or 'markup'" type="string" variable="$type">
2859
  <type by_reference="false">string</type>
2860
  </tag>
2861
+ <tag line="494" name="return" description="requested template, false if not found or null if no templates" type="string|boolean|null">
2862
  <type by_reference="false">string</type>
2863
  <type by_reference="false">boolean</type>
2864
  <type by_reference="false">null</type>
2865
  </tag>
2866
  </docblock>
2867
+ <argument line="504">
2868
  <name>$key</name>
2869
  <default><![CDATA[]]></default>
2870
  <type/>
2871
  </argument>
2872
+ <argument line="504">
2873
  <name>$type</name>
2874
  <default><![CDATA['style']]></default>
2875
  <type/>
2876
  </argument>
2877
  </method>
2878
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="526" package="Media Library Assistant">
2879
  <name>mla_get_style_templates</name>
2880
  <full_name>mla_get_style_templates</full_name>
2881
+ <docblock line="519">
2882
  <description><![CDATA[Get ALL style templates from $mla_templates, including 'default']]></description>
2883
  <long-description><![CDATA[]]></long-description>
2884
+ <tag line="519" name="since" description="0.80"/>
2885
+ <tag line="519" name="return" description="name =&gt; value for all style templates or null if no templates" type="array|null">
2886
  <type by_reference="false">array</type>
2887
  <type by_reference="false">null</type>
2888
  </tag>
2889
  </docblock>
2890
  </method>
2891
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="552" package="Media Library Assistant">
2892
  <name>mla_put_style_templates</name>
2893
  <full_name>mla_put_style_templates</full_name>
2894
+ <docblock line="544">
2895
  <description><![CDATA[Put user-defined style templates to $mla_templates and database]]></description>
2896
  <long-description><![CDATA[]]></long-description>
2897
+ <tag line="544" name="since" description="0.80"/>
2898
+ <tag line="544" name="param" description="name =&gt; value for all user-defined style templates" type="array" variable="$templates">
2899
  <type by_reference="false">array</type>
2900
  </tag>
2901
+ <tag line="544" name="return" description="true if success, false if failure" type="boolean">
2902
  <type by_reference="false">boolean</type>
2903
  </tag>
2904
  </docblock>
2905
+ <argument line="552">
2906
  <name>$templates</name>
2907
  <default><![CDATA[]]></default>
2908
  <type/>
2909
  </argument>
2910
  </method>
2911
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="568" package="Media Library Assistant">
2912
  <name>mla_get_markup_templates</name>
2913
  <full_name>mla_get_markup_templates</full_name>
2914
+ <docblock line="561">
2915
  <description><![CDATA[Get ALL markup templates from $mla_templates, including 'default']]></description>
2916
  <long-description><![CDATA[]]></long-description>
2917
+ <tag line="561" name="since" description="0.80"/>
2918
+ <tag line="561" name="return" description="name =&gt; value for all markup templates or null if no templates" type="array|null">
2919
  <type by_reference="false">array</type>
2920
  <type by_reference="false">null</type>
2921
  </tag>
2922
  </docblock>
2923
  </method>
2924
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="622" package="Media Library Assistant">
2925
  <name>mla_put_markup_templates</name>
2926
  <full_name>mla_put_markup_templates</full_name>
2927
+ <docblock line="614">
2928
  <description><![CDATA[Put user-defined markup templates to $mla_templates and database]]></description>
2929
  <long-description><![CDATA[]]></long-description>
2930
+ <tag line="614" name="since" description="0.80"/>
2931
+ <tag line="614" name="param" description="name =&gt; value for all user-defined markup templates" type="array" variable="$templates">
2932
  <type by_reference="false">array</type>
2933
  </tag>
2934
+ <tag line="614" name="return" description="true if success, false if failure" type="boolean">
2935
  <type by_reference="false">boolean</type>
2936
  </tag>
2937
  </docblock>
2938
+ <argument line="622">
2939
  <name>$templates</name>
2940
  <default><![CDATA[]]></default>
2941
  <type/>
2942
  </argument>
2943
  </method>
2944
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="640" package="Media Library Assistant">
2945
  <name>mla_get_option</name>
2946
  <full_name>mla_get_option</full_name>
2947
+ <docblock line="631">
2948
  <description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
2949
  <long-description><![CDATA[]]></long-description>
2950
+ <tag line="631" name="since" description="0.1"/>
2951
+ <tag line="631" name="param" description="Name of the desired option" type="string" variable="$option">
2952
  <type by_reference="false">string</type>
2953
  </tag>
2954
+ <tag line="631" name="return" description="Value(s) for the option or false if the option is not a defined MLA option" type="mixed">
2955
  <type by_reference="false">mixed</type>
2956
  </tag>
2957
  </docblock>
2958
+ <argument line="640">
2959
  <name>$option</name>
2960
  <default><![CDATA[]]></default>
2961
  <type/>
2962
  </argument>
2963
  </method>
2964
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="661" package="Media Library Assistant">
2965
  <name>mla_update_option</name>
2966
  <full_name>mla_update_option</full_name>
2967
+ <docblock line="651">
2968
  <description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
2969
  <long-description><![CDATA[]]></long-description>
2970
+ <tag line="651" name="since" description="0.1"/>
2971
+ <tag line="651" name="param" description="Name of the desired option" type="string" variable="$option">
2972
  <type by_reference="false">string</type>
2973
  </tag>
2974
+ <tag line="651" name="param" description="New value for the desired option" type="mixed" variable="$newvalue">
2975
  <type by_reference="false">mixed</type>
2976
  </tag>
2977
+ <tag line="651" name="return" description="True if the value was changed or false if the update failed" type="boolean">
2978
  <type by_reference="false">boolean</type>
2979
  </tag>
2980
  </docblock>
2981
+ <argument line="661">
2982
  <name>$option</name>
2983
  <default><![CDATA[]]></default>
2984
  <type/>
2985
  </argument>
2986
+ <argument line="661">
2987
  <name>$newvalue</name>
2988
  <default><![CDATA[]]></default>
2989
  <type/>
2990
  </argument>
2991
  </method>
2992
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="677" package="Media Library Assistant">
2993
  <name>mla_delete_option</name>
2994
  <full_name>mla_delete_option</full_name>
2995
+ <docblock line="668">
2996
  <description><![CDATA[Delete the stored value of a defined MLA option]]></description>
2997
  <long-description><![CDATA[]]></long-description>
2998
+ <tag line="668" name="since" description="0.1"/>
2999
+ <tag line="668" name="param" description="Name of the desired option" type="string" variable="$option">
3000
  <type by_reference="false">string</type>
3001
  </tag>
3002
+ <tag line="668" name="return" description="True if the option was deleted, otherwise false" type="boolean">
3003
  <type by_reference="false">boolean</type>
3004
  </tag>
3005
  </docblock>
3006
+ <argument line="677">
3007
  <name>$option</name>
3008
  <default><![CDATA[]]></default>
3009
  <type/>
3010
  </argument>
3011
  </method>
3012
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="698" package="Media Library Assistant">
3013
  <name>mla_taxonomy_support</name>
3014
  <full_name>mla_taxonomy_support</full_name>
3015
+ <docblock line="685">
3016
  <description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
3017
  settings are being updated or reset.]]></description>
3018
  <long-description><![CDATA[]]></long-description>
3019
+ <tag line="685" name="since" description="0.30"/>
3020
+ <tag line="685" name="param" description="Taxonomy name, e.g., attachment_category" type="string" variable="$tax_name">
3021
  <type by_reference="false">string</type>
3022
  </tag>
3023
+ <tag line="685" name="param" description="Optional. 'support' (default), 'quick-edit' or 'filter'" type="string" variable="$support_type">
3024
  <type by_reference="false">string</type>
3025
  </tag>
3026
+ <tag line="685" 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">
3027
  <type by_reference="false">boolean</type>
3028
  <type by_reference="false">string</type>
3029
  </tag>
3030
  </docblock>
3031
+ <argument line="698">
3032
  <name>$tax_name</name>
3033
  <default><![CDATA[]]></default>
3034
  <type/>
3035
  </argument>
3036
+ <argument line="698">
3037
  <name>$support_type</name>
3038
  <default><![CDATA['support']]></default>
3039
  <type/>
3040
  </argument>
3041
  </method>
3042
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="774" package="Media Library Assistant">
3043
  <name>mla_taxonomy_option_handler</name>
3044
  <full_name>mla_taxonomy_option_handler</full_name>
3045
+ <docblock line="761">
3046
  <description><![CDATA[Render and manage taxonomy support options, e.g., Categories and Post Tags]]></description>
3047
  <long-description><![CDATA[]]></long-description>
3048
+ <tag line="761" name="since" description="0.30"/>
3049
+ <tag line="761" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3050
+ <tag line="761" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
3051
  <type by_reference="false">string</type>
3052
  </tag>
3053
+ <tag line="761" name="param" description="option name, e.g., 'taxonomy_support'" type="string" variable="$key">
3054
  <type by_reference="false">string</type>
3055
  </tag>
3056
+ <tag line="761" name="param" description="option parameters" type="array" variable="$value">
3057
  <type by_reference="false">array</type>
3058
  </tag>
3059
+ <tag line="761" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
3060
  <type by_reference="false">array</type>
3061
  </tag>
3062
+ <tag line="761" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
3063
  <type by_reference="false">string</type>
3064
  </tag>
3065
  </docblock>
3066
+ <argument line="774">
3067
  <name>$action</name>
3068
  <default><![CDATA[]]></default>
3069
  <type/>
3070
  </argument>
3071
+ <argument line="774">
3072
  <name>$key</name>
3073
  <default><![CDATA[]]></default>
3074
  <type/>
3075
  </argument>
3076
+ <argument line="774">
3077
  <name>$value</name>
3078
  <default><![CDATA[]]></default>
3079
  <type/>
3080
  </argument>
3081
+ <argument line="774">
3082
  <name>$args</name>
3083
  <default><![CDATA[null]]></default>
3084
  <type/>
3085
  </argument>
3086
  </method>
3087
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="882" package="Media Library Assistant">
3088
  <name>mla_add_attachment_action</name>
3089
  <full_name>mla_add_attachment_action</full_name>
3090
+ <docblock line="873">
3091
  <description><![CDATA[Perform ITC/EXIF mapping on just-inserted attachment]]></description>
3092
  <long-description><![CDATA[]]></long-description>
3093
+ <tag line="873" name="since" description="1.00"/>
3094
+ <tag line="873" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
3095
  <type by_reference="false">integer</type>
3096
  </tag>
3097
+ <tag line="873" name="return" description="" type="void">
3098
  <type by_reference="false">void</type>
3099
  </tag>
3100
  </docblock>
3101
+ <argument line="882">
3102
+ <name>$post_id</name>
3103
+ <default><![CDATA[]]></default>
3104
+ <type/>
3105
+ </argument>
3106
+ </method>
3107
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="902" package="Media Library Assistant">
3108
+ <name>mla_update_attachment_metadata_filter</name>
3109
+ <full_name>mla_update_attachment_metadata_filter</full_name>
3110
+ <docblock line="892">
3111
+ <description><![CDATA[Perform Custom Field mapping on just-inserted or updated attachment]]></description>
3112
+ <long-description><![CDATA[]]></long-description>
3113
+ <tag line="892" name="since" description="1.10"/>
3114
+ <tag line="892" name="param" description="Attachment metadata for just-inserted attachment" type="array" variable="$data">
3115
+ <type by_reference="false">array</type>
3116
+ </tag>
3117
+ <tag line="892" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
3118
+ <type by_reference="false">integer</type>
3119
+ </tag>
3120
+ <tag line="892" name="return" description="" type="void">
3121
+ <type by_reference="false">void</type>
3122
+ </tag>
3123
+ </docblock>
3124
+ <argument line="902">
3125
+ <name>$data</name>
3126
+ <default><![CDATA[]]></default>
3127
+ <type/>
3128
+ </argument>
3129
+ <argument line="902">
3130
+ <name>$post_id</name>
3131
+ <default><![CDATA[]]></default>
3132
+ <type/>
3133
+ </argument>
3134
+ </method>
3135
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="922" package="Media Library Assistant">
3136
+ <name>mla_custom_field_option_value</name>
3137
+ <full_name>mla_custom_field_option_value</full_name>
3138
+ <docblock line="913">
3139
+ <description><![CDATA[Fetch custom field option value given a slug]]></description>
3140
+ <long-description><![CDATA[]]></long-description>
3141
+ <tag line="913" name="since" description="1.10"/>
3142
+ <tag line="913" name="param" description="slug, e.g., 'c_file-size' for the 'File Size' field" type="string" variable="$slug">
3143
+ <type by_reference="false">string</type>
3144
+ </tag>
3145
+ <tag line="913" name="return" description="option value, e.g., array( 'name' =&gt; 'File Size', ... )" type="array">
3146
+ <type by_reference="false">array</type>
3147
+ </tag>
3148
+ </docblock>
3149
+ <argument line="922">
3150
+ <name>$slug</name>
3151
+ <default><![CDATA[]]></default>
3152
+ <type/>
3153
+ </argument>
3154
+ </method>
3155
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="942" package="Media Library Assistant">
3156
+ <name>mla_custom_field_support</name>
3157
+ <full_name>mla_custom_field_support</full_name>
3158
+ <docblock line="933">
3159
+ <description><![CDATA[Evaluate file information for custom field mapping]]></description>
3160
+ <long-description><![CDATA[]]></long-description>
3161
+ <tag line="933" name="since" description="1.10"/>
3162
+ <tag line="933" name="param" description="array format; 'default_columns' (default), 'default_hidden_columns' or 'default_sortable_columns'" type="string" variable="$support_type">
3163
+ <type by_reference="false">string</type>
3164
+ </tag>
3165
+ <tag line="933" name="return" description="default, hidden or sortable colums in appropriate format" type="array">
3166
+ <type by_reference="false">array</type>
3167
+ </tag>
3168
+ </docblock>
3169
+ <argument line="942">
3170
+ <name>$support_type</name>
3171
+ <default><![CDATA['default_columns']]></default>
3172
+ <type/>
3173
+ </argument>
3174
+ </method>
3175
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="978" package="Media Library Assistant">
3176
+ <name>_evaluate_file_information</name>
3177
+ <full_name>_evaluate_file_information</full_name>
3178
+ <docblock line="966">
3179
+ <description><![CDATA[Evaluate file information for custom field mapping]]></description>
3180
+ <long-description><![CDATA[]]></long-description>
3181
+ <tag line="966" name="since" description="1.10"/>
3182
+ <tag line="966" name="param" description="absolute path the the uploads base directory" type="string" variable="$upload_dir">
3183
+ <type by_reference="false">string</type>
3184
+ </tag>
3185
+ <tag line="966" name="param" description="_wp_attached_file meta_value array, indexed by post_id" type="array" variable="$wp_attached_files">
3186
+ <type by_reference="false">array</type>
3187
+ </tag>
3188
+ <tag line="966" name="param" description="_wp_attachment_metadata meta_value array, indexed by post_id" type="array" variable="$wp_attachment_metadata">
3189
+ <type by_reference="false">array</type>
3190
+ </tag>
3191
+ <tag line="966" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
3192
+ <type by_reference="false">integer</type>
3193
+ </tag>
3194
+ <tag line="966" name="return" description="absolute_path, base_file, path, file_name, extension, dimensions, width, height, hwstring_small, array of intermediate sizes" type="array">
3195
+ <type by_reference="false">array</type>
3196
+ </tag>
3197
+ </docblock>
3198
+ <argument line="978">
3199
+ <name>$upload_dir</name>
3200
+ <default><![CDATA[]]></default>
3201
+ <type/>
3202
+ </argument>
3203
+ <argument line="978">
3204
+ <name>$wp_attached_files</name>
3205
+ <default><![CDATA[]]></default>
3206
+ <type/>
3207
+ </argument>
3208
+ <argument line="978">
3209
+ <name>$wp_attachment_metadata</name>
3210
+ <default><![CDATA[]]></default>
3211
+ <type/>
3212
+ </argument>
3213
+ <argument line="978">
3214
  <name>$post_id</name>
3215
  <default><![CDATA[]]></default>
3216
  <type/>
3217
  </argument>
3218
  </method>
3219
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1051" package="Media Library Assistant">
3220
+ <name>_evaluate_data_source</name>
3221
+ <full_name>_evaluate_data_source</full_name>
3222
+ <docblock line="1038">
3223
+ <description><![CDATA[Evaluate custom field mapping data source]]></description>
3224
+ <long-description><![CDATA[]]></long-description>
3225
+ <tag line="1038" name="since" description="1.10"/>
3226
+ <tag line="1038" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
3227
+ <type by_reference="false">integer</type>
3228
+ </tag>
3229
+ <tag line="1038" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
3230
+ <type by_reference="false">string</type>
3231
+ </tag>
3232
+ <tag line="1038" name="param" description="data source name" type="string" variable="$data_source">
3233
+ <type by_reference="false">string</type>
3234
+ </tag>
3235
+ <tag line="1038" name="param" description="desired results format, default 'native'" type="string" variable="$format">
3236
+ <type by_reference="false">string</type>
3237
+ </tag>
3238
+ <tag line="1038" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
3239
+ <type by_reference="false">array</type>
3240
+ </tag>
3241
+ <tag line="1038" name="return" description="data source value" type="string">
3242
+ <type by_reference="false">string</type>
3243
+ </tag>
3244
+ </docblock>
3245
+ <argument line="1051">
3246
+ <name>$post_id</name>
3247
+ <default><![CDATA[]]></default>
3248
+ <type/>
3249
+ </argument>
3250
+ <argument line="1051">
3251
+ <name>$category</name>
3252
+ <default><![CDATA[]]></default>
3253
+ <type/>
3254
+ </argument>
3255
+ <argument line="1051">
3256
+ <name>$data_source</name>
3257
+ <default><![CDATA[]]></default>
3258
+ <type/>
3259
+ </argument>
3260
+ <argument line="1051">
3261
+ <name>$format</name>
3262
+ <default><![CDATA['native']]></default>
3263
+ <type/>
3264
+ </argument>
3265
+ <argument line="1051">
3266
+ <name>$attachment_metadata</name>
3267
+ <default><![CDATA[NULL]]></default>
3268
+ <type/>
3269
+ </argument>
3270
+ </method>
3271
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1285" package="Media Library Assistant">
3272
+ <name>mla_evaluate_custom_field_mapping</name>
3273
+ <full_name>mla_evaluate_custom_field_mapping</full_name>
3274
+ <docblock line="1273">
3275
+ <description><![CDATA[Evaluate custom field mapping updates for a post]]></description>
3276
+ <long-description><![CDATA[]]></long-description>
3277
+ <tag line="1273" name="since" description="1.10"/>
3278
+ <tag line="1273" name="param" description="post ID to be evaluated" type="integer" variable="$post_id">
3279
+ <type by_reference="false">integer</type>
3280
+ </tag>
3281
+ <tag line="1273" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
3282
+ <type by_reference="false">string</type>
3283
+ </tag>
3284
+ <tag line="1273" name="param" description="(optional) custom_field_mapping values, default NULL (use current option value)" type="array" variable="$settings">
3285
+ <type by_reference="false">array</type>
3286
+ </tag>
3287
+ <tag line="1273" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
3288
+ <type by_reference="false">array</type>
3289
+ </tag>
3290
+ <tag line="1273" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
3291
+ <type by_reference="false">array</type>
3292
+ </tag>
3293
+ </docblock>
3294
+ <argument line="1285">
3295
+ <name>$post_id</name>
3296
+ <default><![CDATA[]]></default>
3297
+ <type/>
3298
+ </argument>
3299
+ <argument line="1285">
3300
+ <name>$category</name>
3301
+ <default><![CDATA[]]></default>
3302
+ <type/>
3303
+ </argument>
3304
+ <argument line="1285">
3305
+ <name>$settings</name>
3306
+ <default><![CDATA[NULL]]></default>
3307
+ <type/>
3308
+ </argument>
3309
+ <argument line="1285">
3310
+ <name>$attachment_metadata</name>
3311
+ <default><![CDATA[NULL]]></default>
3312
+ <type/>
3313
+ </argument>
3314
+ </method>
3315
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1318" package="Media Library Assistant">
3316
+ <name>_compose_custom_field_option_list</name>
3317
+ <full_name>_compose_custom_field_option_list</full_name>
3318
+ <docblock line="1308">
3319
+ <description><![CDATA[Compose a Custom Field Options list with current selection]]></description>
3320
+ <long-description><![CDATA[]]></long-description>
3321
+ <tag line="1308" name="since" description="1.10"/>
3322
+ <tag line="1308" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3323
+ <tag line="1308" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
3324
+ <type by_reference="false">string</type>
3325
+ </tag>
3326
+ <tag line="1308" name="return" description="HTML markup with select field options" type="string">
3327
+ <type by_reference="false">string</type>
3328
+ </tag>
3329
+ </docblock>
3330
+ <argument line="1318">
3331
+ <name>$selection</name>
3332
+ <default><![CDATA['none']]></default>
3333
+ <type/>
3334
+ </argument>
3335
+ </method>
3336
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1393" package="Media Library Assistant">
3337
+ <name>_compose_data_source_option_list</name>
3338
+ <full_name>_compose_data_source_option_list</full_name>
3339
+ <docblock line="1383">
3340
+ <description><![CDATA[Compose a (Custom Field) Data Source Options list with current selection]]></description>
3341
+ <long-description><![CDATA[]]></long-description>
3342
+ <tag line="1383" name="since" description="1.10"/>
3343
+ <tag line="1383" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3344
+ <tag line="1383" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
3345
+ <type by_reference="false">string</type>
3346
+ </tag>
3347
+ <tag line="1383" name="return" description="HTML markup with select field options" type="string">
3348
+ <type by_reference="false">string</type>
3349
+ </tag>
3350
+ </docblock>
3351
+ <argument line="1393">
3352
+ <name>$selection</name>
3353
+ <default><![CDATA['none']]></default>
3354
+ <type/>
3355
+ </argument>
3356
+ </method>
3357
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1444" package="Media Library Assistant">
3358
+ <name>_update_custom_field_mapping</name>
3359
+ <full_name>_update_custom_field_mapping</full_name>
3360
+ <docblock line="1434">
3361
+ <description><![CDATA[Update custom field mappings]]></description>
3362
+ <long-description><![CDATA[]]></long-description>
3363
+ <tag line="1434" name="since" description="1.10"/>
3364
+ <tag line="1434" name="param" description="current custom_field_mapping values" type="array" variable="$current_values">
3365
+ <type by_reference="false">array</type>
3366
+ </tag>
3367
+ <tag line="1434" name="param" description="new values" type="array" variable="$new_values">
3368
+ <type by_reference="false">array</type>
3369
+ </tag>
3370
+ <tag line="1434" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
3371
+ <type by_reference="false">array</type>
3372
+ </tag>
3373
+ </docblock>
3374
+ <argument line="1444">
3375
+ <name>$current_values</name>
3376
+ <default><![CDATA[]]></default>
3377
+ <type/>
3378
+ </argument>
3379
+ <argument line="1444">
3380
+ <name>$new_values</name>
3381
+ <default><![CDATA[]]></default>
3382
+ <type/>
3383
+ </argument>
3384
+ </method>
3385
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1570" package="Media Library Assistant">
3386
+ <name>mla_custom_field_option_handler</name>
3387
+ <full_name>mla_custom_field_option_handler</full_name>
3388
+ <docblock line="1557">
3389
+ <description><![CDATA[Render and manage custom field mapping options]]></description>
3390
+ <long-description><![CDATA[]]></long-description>
3391
+ <tag line="1557" name="since" description="1.10"/>
3392
+ <tag line="1557" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3393
+ <tag line="1557" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
3394
+ <type by_reference="false">string</type>
3395
+ </tag>
3396
+ <tag line="1557" name="param" description="option name, e.g., 'custom_field_mapping'" type="string" variable="$key">
3397
+ <type by_reference="false">string</type>
3398
+ </tag>
3399
+ <tag line="1557" name="param" description="option parameters" type="array" variable="$value">
3400
+ <type by_reference="false">array</type>
3401
+ </tag>
3402
+ <tag line="1557" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
3403
+ <type by_reference="false">array</type>
3404
+ </tag>
3405
+ <tag line="1557" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
3406
+ <type by_reference="false">string</type>
3407
+ </tag>
3408
+ </docblock>
3409
+ <argument line="1570">
3410
+ <name>$action</name>
3411
+ <default><![CDATA[]]></default>
3412
+ <type/>
3413
+ </argument>
3414
+ <argument line="1570">
3415
+ <name>$key</name>
3416
+ <default><![CDATA[]]></default>
3417
+ <type/>
3418
+ </argument>
3419
+ <argument line="1570">
3420
+ <name>$value</name>
3421
+ <default><![CDATA[]]></default>
3422
+ <type/>
3423
+ </argument>
3424
+ <argument line="1570">
3425
+ <name>$args</name>
3426
+ <default><![CDATA[null]]></default>
3427
+ <type/>
3428
+ </argument>
3429
+ </method>
3430
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1702" package="Media Library Assistant">
3431
  <name>mla_evaluate_iptc_exif_mapping</name>
3432
  <full_name>mla_evaluate_iptc_exif_mapping</full_name>
3433
+ <docblock line="1691">
3434
  <description><![CDATA[Evaluate IPTC/EXIF mapping updates for a post]]></description>
3435
  <long-description><![CDATA[]]></long-description>
3436
+ <tag line="1691" name="since" description="1.00"/>
3437
+ <tag line="1691" name="param" description="post object with current values" type="object" variable="$post">
3438
  <type by_reference="false">object</type>
3439
  </tag>
3440
+ <tag line="1691" name="param" description="category to evaluate against, e.g., iptc_exif_standard_mapping or iptc_exif_mapping" type="string" variable="$category">
3441
  <type by_reference="false">string</type>
3442
  </tag>
3443
+ <tag line="1691" name="param" description="(optional) iptc_exif_mapping values, default - current option value" type="array" variable="$settings">
3444
  <type by_reference="false">array</type>
3445
  </tag>
3446
+ <tag line="1691" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
3447
  <type by_reference="false">array</type>
3448
  </tag>
3449
  </docblock>
3450
+ <argument line="1702">
3451
  <name>$post</name>
3452
  <default><![CDATA[]]></default>
3453
  <type/>
3454
  </argument>
3455
+ <argument line="1702">
3456
  <name>$category</name>
3457
  <default><![CDATA[]]></default>
3458
  <type/>
3459
  </argument>
3460
+ <argument line="1702">
3461
  <name>$settings</name>
3462
  <default><![CDATA[NULL]]></default>
3463
  <type/>
3464
  </argument>
3465
  </method>
3466
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1856" package="Media Library Assistant">
3467
  <name>_compose_iptc_option_list</name>
3468
  <full_name>_compose_iptc_option_list</full_name>
3469
+ <docblock line="1846">
3470
  <description><![CDATA[Compose an IPTC Options list with current selection]]></description>
3471
  <long-description><![CDATA[]]></long-description>
3472
+ <tag line="1846" name="since" description="1.00"/>
3473
+ <tag line="1846" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3474
+ <tag line="1846" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
3475
  <type by_reference="false">string</type>
3476
  </tag>
3477
+ <tag line="1846" name="return" description="HTML markup with select field options" type="string">
3478
  <type by_reference="false">string</type>
3479
  </tag>
3480
  </docblock>
3481
+ <argument line="1856">
3482
  <name>$selection</name>
3483
  <default><![CDATA['none']]></default>
3484
  <type/>
3485
  </argument>
3486
  </method>
3487
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1889" package="Media Library Assistant">
3488
  <name>_compose_parent_option_list</name>
3489
  <full_name>_compose_parent_option_list</full_name>
3490
+ <docblock line="1878">
3491
  <description><![CDATA[Compose an hierarchical taxonomy Parent options list with current selection]]></description>
3492
  <long-description><![CDATA[]]></long-description>
3493
+ <tag line="1878" name="since" description="1.00"/>
3494
+ <tag line="1878" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3495
+ <tag line="1878" name="param" description="taxonomy slug" type="string" variable="$taxonomy">
3496
  <type by_reference="false">string</type>
3497
  </tag>
3498
+ <tag line="1878" name="param" description="current selection or 0 (zero, default)" type="integer" variable="$selection">
3499
  <type by_reference="false">integer</type>
3500
  </tag>
3501
+ <tag line="1878" name="return" description="HTML markup with select field options" type="string">
3502
  <type by_reference="false">string</type>
3503
  </tag>
3504
  </docblock>
3505
+ <argument line="1889">
3506
  <name>$taxonomy</name>
3507
  <default><![CDATA[]]></default>
3508
  <type/>
3509
  </argument>
3510
+ <argument line="1889">
3511
  <name>$selection</name>
3512
  <default><![CDATA[0]]></default>
3513
  <type/>
3514
  </argument>
3515
  </method>
3516
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1923" package="Media Library Assistant">
3517
  <name>_update_iptc_exif_standard_mapping</name>
3518
  <full_name>_update_iptc_exif_standard_mapping</full_name>
3519
+ <docblock line="1913">
3520
  <description><![CDATA[Update Standard field portion of IPTC/EXIF mappings]]></description>
3521
  <long-description><![CDATA[]]></long-description>
3522
+ <tag line="1913" name="since" description="1.00"/>
3523
+ <tag line="1913" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3524
  <type by_reference="false">array</type>
3525
  </tag>
3526
+ <tag line="1913" name="param" description="new values" type="array" variable="$new_values">
3527
  <type by_reference="false">array</type>
3528
  </tag>
3529
+ <tag line="1913" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
3530
  <type by_reference="false">array</type>
3531
  </tag>
3532
  </docblock>
3533
+ <argument line="1923">
3534
  <name>$current_values</name>
3535
  <default><![CDATA[]]></default>
3536
  <type/>
3537
  </argument>
3538
+ <argument line="1923">
3539
  <name>$new_values</name>
3540
  <default><![CDATA[]]></default>
3541
  <type/>
3542
  </argument>
3543
  </method>
3544
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2002" package="Media Library Assistant">
3545
  <name>_update_iptc_exif_taxonomy_mapping</name>
3546
  <full_name>_update_iptc_exif_taxonomy_mapping</full_name>
3547
+ <docblock line="1992">
3548
  <description><![CDATA[Update Taxonomy term portion of IPTC/EXIF mappings]]></description>
3549
  <long-description><![CDATA[]]></long-description>
3550
+ <tag line="1992" name="since" description="1.00"/>
3551
+ <tag line="1992" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3552
  <type by_reference="false">array</type>
3553
  </tag>
3554
+ <tag line="1992" name="param" description="new values" type="array" variable="$new_values">
3555
  <type by_reference="false">array</type>
3556
  </tag>
3557
+ <tag line="1992" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
3558
  <type by_reference="false">array</type>
3559
  </tag>
3560
  </docblock>
3561
+ <argument line="2002">
3562
  <name>$current_values</name>
3563
  <default><![CDATA[]]></default>
3564
  <type/>
3565
  </argument>
3566
+ <argument line="2002">
3567
  <name>$new_values</name>
3568
  <default><![CDATA[]]></default>
3569
  <type/>
3570
  </argument>
3571
  </method>
3572
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2094" package="Media Library Assistant">
3573
  <name>_update_iptc_exif_custom_mapping</name>
3574
  <full_name>_update_iptc_exif_custom_mapping</full_name>
3575
+ <docblock line="2084">
3576
  <description><![CDATA[Update Custom field portion of IPTC/EXIF mappings]]></description>
3577
  <long-description><![CDATA[]]></long-description>
3578
+ <tag line="2084" name="since" description="1.00"/>
3579
+ <tag line="2084" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3580
  <type by_reference="false">array</type>
3581
  </tag>
3582
+ <tag line="2084" name="param" description="new values" type="array" variable="$new_values">
3583
  <type by_reference="false">array</type>
3584
  </tag>
3585
+ <tag line="2084" name="return" description="( 'message' =&gt; HTML message(s) reflecting results, 'values' =&gt; updated iptc_exif_mapping values, 'changed' =&gt; true if any changes detected else false )" type="array">
3586
  <type by_reference="false">array</type>
3587
  </tag>
3588
  </docblock>
3589
+ <argument line="2094">
3590
  <name>$current_values</name>
3591
  <default><![CDATA[]]></default>
3592
  <type/>
3593
  </argument>
3594
+ <argument line="2094">
3595
  <name>$new_values</name>
3596
  <default><![CDATA[]]></default>
3597
  <type/>
3598
  </argument>
3599
  </method>
3600
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2190" package="Media Library Assistant">
3601
  <name>_get_custom_field_names</name>
3602
  <full_name>_get_custom_field_names</full_name>
3603
+ <docblock line="2183">
3604
  <description><![CDATA[Generate a list of all (post) Custom Field names]]></description>
3605
  <long-description><![CDATA[]]></long-description>
3606
+ <tag line="2183" name="since" description="1.00"/>
3607
+ <tag line="2183" name="return" description="Custom field names from the postmeta table" type="array">
3608
  <type by_reference="false">array</type>
3609
  </tag>
3610
  </docblock>
3611
  </method>
3612
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2219" package="Media Library Assistant">
3613
  <name>mla_iptc_exif_option_handler</name>
3614
  <full_name>mla_iptc_exif_option_handler</full_name>
3615
+ <docblock line="2206">
3616
  <description><![CDATA[Render and manage iptc/exif support options]]></description>
3617
  <long-description><![CDATA[]]></long-description>
3618
+ <tag line="2206" name="since" description="1.00"/>
3619
+ <tag line="2206" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3620
+ <tag line="2206" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
3621
  <type by_reference="false">string</type>
3622
  </tag>
3623
+ <tag line="2206" name="param" description="option name, e.g., 'iptc_exif_mapping'" type="string" variable="$key">
3624
  <type by_reference="false">string</type>
3625
  </tag>
3626
+ <tag line="2206" name="param" description="option parameters" type="array" variable="$value">
3627
  <type by_reference="false">array</type>
3628
  </tag>
3629
+ <tag line="2206" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
3630
  <type by_reference="false">array</type>
3631
  </tag>
3632
+ <tag line="2206" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
3633
  <type by_reference="false">string</type>
3634
  </tag>
3635
  </docblock>
3636
+ <argument line="2219">
3637
  <name>$action</name>
3638
  <default><![CDATA[]]></default>
3639
  <type/>
3640
  </argument>
3641
+ <argument line="2219">
3642
  <name>$key</name>
3643
  <default><![CDATA[]]></default>
3644
  <type/>
3645
  </argument>
3646
+ <argument line="2219">
3647
  <name>$value</name>
3648
  <default><![CDATA[]]></default>
3649
  <type/>
3650
  </argument>
3651
+ <argument line="2219">
3652
  <name>$args</name>
3653
  <default><![CDATA[null]]></default>
3654
  <type/>
3656
  </method>
3657
  </class>
3658
  </file>
3659
+ <file path="includes\class-mla-settings.php" hash="f0c0b7acc87a6f1cfd922637cd65110b" package="Media Library Assistant">
3660
  <docblock line="2">
3661
  <description><![CDATA[Manages the settings page to edit the plugin option settings]]></description>
3662
  <long-description><![CDATA[]]></long-description>
3673
  <tag line="9" name="package" description="Media Library Assistant"/>
3674
  <tag line="9" name="since" description="0.1"/>
3675
  </docblock>
3676
+ <constant namespace="global" line="19" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
3677
  <name>MLA_SETTINGS_SLUG</name>
3678
  <full_name>MLA_SETTINGS_SLUG</full_name>
3679
  <value><![CDATA['mla-settings-menu']]></value>
3680
+ <docblock line="16">
3681
  <description><![CDATA[Provides a unique name for the settings page]]></description>
3682
  <long-description><![CDATA[]]></long-description>
3683
  </docblock>
3684
  </constant>
3685
+ <property final="false" static="true" visibility="private" line="357" namespace="global" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
3686
  <name>$page_template_array</name>
3687
  <default><![CDATA[null]]></default>
3688
+ <docblock line="347">
3689
  <description><![CDATA[Template file for the Settings page(s) and parts]]></description>
3690
  <long-description><![CDATA[<p>This array contains all of the template parts for the Settings page(s). The array is built once
3691
  each page load and cached for subsequent use.</p>]]></long-description>
3692
+ <tag line="347" name="since" description="0.80"/>
3693
+ <tag line="347" name="var" description="" type="array">
3694
  <type by_reference="false">array</type>
3695
  </tag>
3696
  </docblock>
3697
  </property>
3698
+ <property final="false" static="true" visibility="private" line="373" namespace="global" package="Media Library Assistant">
3699
  <name>$mla_tablist</name>
3700
+ <default><![CDATA[array('general' => array('title' => 'General', 'render' => '_compose_general_tab'), 'mla-gallery' => array('title' => 'MLA Gallery', 'render' => '_compose_mla_gallery_tab'), 'custom-field' => array('title' => 'Custom Fields', 'render' => '_compose_custom_field_tab'), 'iptc-exif' => array('title' => 'IPTC/EXIF', 'render' => '_compose_iptc_exif_tab'), 'documentation' => array('title' => 'Documentation', 'render' => '_compose_documentation_tab'))]]></default>
3701
+ <docblock line="359">
3702
  <description><![CDATA[Definitions for Settings page tab ids, titles and handlers
3703
  Each tab is defined by an array with the following elements:]]></description>
3704
  <long-description><![CDATA[<p>array key => HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)</p>
3706
  <p>title => tab label / heading text
3707
  render => rendering function for tab messages and content. Usage:
3708
  $tab_content = <a href="">'render'</a>;</p>]]></long-description>
3709
+ <tag line="359" name="since" description="0.80"/>
3710
+ <tag line="359" name="var" description="" type="array">
3711
  <type by_reference="false">array</type>
3712
  </tag>
3713
  </docblock>
3714
  </property>
3715
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="28" package="Media Library Assistant">
3716
  <name>initialize</name>
3717
  <full_name>initialize</full_name>
3718
+ <docblock line="21">
3719
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
3720
  <long-description><![CDATA[]]></long-description>
3721
+ <tag line="21" name="since" description="0.1"/>
3722
+ <tag line="21" name="return" description="" type="void">
3723
  <type by_reference="false">void</type>
3724
  </tag>
3725
  </docblock>
3726
  </method>
3727
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="40" package="Media Library Assistant">
3728
  <name>_version_upgrade</name>
3729
  <full_name>_version_upgrade</full_name>
3730
+ <docblock line="33">
3731
  <description><![CDATA[Database and option update check, for installing new versions]]></description>
3732
  <long-description><![CDATA[]]></long-description>
3733
+ <tag line="33" name="since" description="0.30"/>
3734
+ <tag line="33" name="return" description="" type="void">
 
 
 
 
 
 
 
 
 
 
 
 
 
3735
  <type by_reference="false">void</type>
3736
  </tag>
3737
  </docblock>
3738
  </method>
3739
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="81" package="Media Library Assistant">
3740
  <name>mla_activation_hook</name>
3741
  <full_name>mla_activation_hook</full_name>
3742
+ <docblock line="72">
3743
  <description><![CDATA[Perform one-time actions on plugin activation]]></description>
3744
  <long-description><![CDATA[<p>Adds a view to the database to support sorting the listing on 'ALT Text'.</p>]]></long-description>
3745
+ <tag line="72" name="since" description="0.40"/>
3746
+ <tag line="72" name="return" description="" type="void">
3747
  <type by_reference="false">void</type>
3748
  </tag>
3749
  </docblock>
3750
  </method>
3751
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="94" package="Media Library Assistant">
3752
  <name>mla_deactivation_hook</name>
3753
  <full_name>mla_deactivation_hook</full_name>
3754
+ <docblock line="85">
3755
  <description><![CDATA[Perform one-time actions on plugin deactivation]]></description>
3756
+ <long-description><![CDATA[<p>Removes (if present) a view from the database that supports sorting the listing on 'ALT Text'.</p>]]></long-description>
3757
+ <tag line="85" name="since" description="0.40"/>
3758
+ <tag line="85" name="return" description="" type="void">
3759
  <type by_reference="false">void</type>
3760
  </tag>
3761
  </docblock>
3762
  </method>
3763
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="113" package="Media Library Assistant">
3764
  <name>mla_admin_menu_action</name>
3765
  <full_name>mla_admin_menu_action</full_name>
3766
+ <docblock line="105">
3767
  <description><![CDATA[Add settings page in the "Settings" section,
3768
  add settings link in the Plugins section entry for MLA.]]></description>
3769
  <long-description><![CDATA[]]></long-description>
3770
+ <tag line="105" name="since" description="0.1"/>
3771
+ <tag line="105" name="return" description="" type="void">
3772
  <type by_reference="false">void</type>
3773
  </tag>
3774
  </docblock>
3775
  </method>
3776
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="131" package="Media Library Assistant">
3777
  <name>mla_add_plugin_settings_link</name>
3778
  <full_name>mla_add_plugin_settings_link</full_name>
3779
+ <docblock line="121">
3780
  <description><![CDATA[Add the "Settings" link to the MLA entry in the Plugins section]]></description>
3781
  <long-description><![CDATA[]]></long-description>
3782
+ <tag line="121" name="since" description="0.1"/>
3783
+ <tag line="121" name="param" description="array of links for the Plugin, e.g., &quot;Activate&quot;" type="array" variable="$links">
3784
  <type by_reference="false">array</type>
3785
  </tag>
3786
+ <tag line="121" name="param" description="Directory and name of the plugin Index file" type="string" variable="$file">
3787
  <type by_reference="false">string</type>
3788
  </tag>
3789
+ <tag line="121" name="return" description="Updated array of links for the Plugin" type="array">
3790
  <type by_reference="false">array</type>
3791
  </tag>
3792
  </docblock>
3793
+ <argument line="131">
3794
  <name>$links</name>
3795
  <default><![CDATA[]]></default>
3796
  <type/>
3797
  </argument>
3798
+ <argument line="131">
3799
  <name>$file</name>
3800
  <default><![CDATA[]]></default>
3801
  <type/>
3802
  </argument>
3803
  </method>
3804
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="151" package="Media Library Assistant">
3805
  <name>_update_option_row</name>
3806
  <full_name>_update_option_row</full_name>
3807
+ <docblock line="140">
3808
  <description><![CDATA[Update or delete a single MLA option value]]></description>
3809
  <long-description><![CDATA[]]></long-description>
3810
+ <tag line="140" name="since" description="0.80"/>
3811
+ <tag line="140" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
3812
+ <tag line="140" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
3813
  <type by_reference="false">string</type>
3814
  </tag>
3815
+ <tag line="140" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
3816
  <type by_reference="false">array</type>
3817
  </tag>
3818
+ <tag line="140" name="return" description="HTML markup for the option's table row" type="string">
3819
  <type by_reference="false">string</type>
3820
  </tag>
3821
  </docblock>
3822
+ <argument line="151">
3823
  <name>$key</name>
3824
  <default><![CDATA[]]></default>
3825
  <type/>
3826
  </argument>
3827
+ <argument line="151">
3828
  <name>$value</name>
3829
  <default><![CDATA[]]></default>
3830
  <type/>
3831
  </argument>
3832
  </method>
3833
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="229" package="Media Library Assistant">
3834
  <name>_compose_option_row</name>
3835
  <full_name>_compose_option_row</full_name>
3836
+ <docblock line="218">
3837
  <description><![CDATA[Compose the table row for a single MLA option]]></description>
3838
  <long-description><![CDATA[]]></long-description>
3839
+ <tag line="218" name="since" description="0.80"/>
3840
+ <tag line="218" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3841
+ <tag line="218" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
3842
  <type by_reference="false">string</type>
3843
  </tag>
3844
+ <tag line="218" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
3845
  <type by_reference="false">array</type>
3846
  </tag>
3847
+ <tag line="218" name="return" description="HTML markup for the option's table row" type="string">
3848
  <type by_reference="false">string</type>
3849
  </tag>
3850
  </docblock>
3851
+ <argument line="229">
3852
  <name>$key</name>
3853
  <default><![CDATA[]]></default>
3854
  <type/>
3855
  </argument>
3856
+ <argument line="229">
3857
  <name>$value</name>
3858
  <default><![CDATA[]]></default>
3859
  <type/>
3860
  </argument>
3861
  </method>
3862
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="391" package="Media Library Assistant">
3863
  <name>_compose_settings_tabs</name>
3864
  <full_name>_compose_settings_tabs</full_name>
3865
+ <docblock line="381">
3866
  <description><![CDATA[Compose the navigation tabs for the Settings subpage]]></description>
3867
  <long-description><![CDATA[]]></long-description>
3868
+ <tag line="381" name="since" description="0.80"/>
3869
+ <tag line="381" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3870
+ <tag line="381" name="param" description="Optional data-tab-id value for the active tab, default 'general'" type="string" variable="$active_tab">
3871
  <type by_reference="false">string</type>
3872
  </tag>
3873
+ <tag line="381" name="return" description="HTML markup for the Settings subpage navigation tabs" type="string">
3874
  <type by_reference="false">string</type>
3875
  </tag>
3876
  </docblock>
3877
+ <argument line="391">
3878
  <name>$active_tab</name>
3879
  <default><![CDATA['general']]></default>
3880
  <type/>
3881
  </argument>
3882
  </method>
3883
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="417" package="Media Library Assistant">
3884
  <name>_compose_general_tab</name>
3885
  <full_name>_compose_general_tab</full_name>
3886
+ <docblock line="409">
3887
  <description><![CDATA[Compose the General tab content for the Settings subpage]]></description>
3888
  <long-description><![CDATA[]]></long-description>
3889
+ <tag line="409" name="since" description="0.80"/>
3890
+ <tag line="409" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3891
+ <tag line="409" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
3892
  <type by_reference="false">array</type>
3893
  </tag>
3894
  </docblock>
3895
  </method>
3896
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="501" package="Media Library Assistant">
3897
  <name>_compose_mla_gallery_tab</name>
3898
  <full_name>_compose_mla_gallery_tab</full_name>
3899
+ <docblock line="493">
3900
  <description><![CDATA[Compose the MLA Gallery tab content for the Settings subpage]]></description>
3901
  <long-description><![CDATA[]]></long-description>
3902
+ <tag line="493" name="since" description="0.80"/>
3903
+ <tag line="493" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3904
+ <tag line="493" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
3905
  <type by_reference="false">array</type>
3906
  </tag>
3907
  </docblock>
3908
  </method>
3909
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="800" package="Media Library Assistant">
3910
+ <name>_compose_custom_field_tab</name>
3911
+ <full_name>_compose_custom_field_tab</full_name>
3912
+ <docblock line="792">
3913
+ <description><![CDATA[Compose the Custom Field tab content for the Settings subpage]]></description>
3914
+ <long-description><![CDATA[]]></long-description>
3915
+ <tag line="792" name="since" description="1.10"/>
3916
+ <tag line="792" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3917
+ <tag line="792" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
3918
+ <type by_reference="false">array</type>
3919
+ </tag>
3920
+ </docblock>
3921
+ </method>
3922
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="905" package="Media Library Assistant">
3923
  <name>_compose_iptc_exif_tab</name>
3924
  <full_name>_compose_iptc_exif_tab</full_name>
3925
+ <docblock line="897">
3926
  <description><![CDATA[Compose the IPTC/EXIF tab content for the Settings subpage]]></description>
3927
  <long-description><![CDATA[]]></long-description>
3928
+ <tag line="897" name="since" description="1.00"/>
3929
+ <tag line="897" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3930
+ <tag line="897" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
3931
  <type by_reference="false">array</type>
3932
  </tag>
3933
  </docblock>
3934
  </method>
3935
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="977" package="Media Library Assistant">
3936
  <name>_compose_documentation_tab</name>
3937
  <full_name>_compose_documentation_tab</full_name>
3938
+ <docblock line="969">
3939
  <description><![CDATA[Compose the Documentation tab content for the Settings subpage]]></description>
3940
  <long-description><![CDATA[]]></long-description>
3941
+ <tag line="969" name="since" description="0.80"/>
3942
+ <tag line="969" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
3943
+ <tag line="969" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
3944
  <type by_reference="false">array</type>
3945
  </tag>
3946
  </docblock>
3947
  </method>
3948
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="996" package="Media Library Assistant">
3949
  <name>mla_render_settings_page</name>
3950
  <full_name>mla_render_settings_page</full_name>
3951
+ <docblock line="989">
3952
  <description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
3953
  <long-description><![CDATA[]]></long-description>
3954
+ <tag line="989" name="since" description="0.1"/>
3955
+ <tag line="989" name="return" description="Echoes HTML markup for the Settings subpage" type="void">
3956
  <type by_reference="false">void</type>
3957
  </tag>
3958
  </docblock>
3959
  </method>
3960
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1046" package="Media Library Assistant">
3961
  <name>_save_gallery_settings</name>
3962
  <full_name>_save_gallery_settings</full_name>
3963
+ <docblock line="1037">
3964
  <description><![CDATA[Save MLA Gallery settings to the options table]]></description>
3965
  <long-description><![CDATA[]]></long-description>
3966
+ <tag line="1037" name="since" description="0.80"/>
3967
+ <tag line="1037" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
3968
+ <tag line="1037" name="return" description="Message(s) reflecting the results of the operation" type="array">
3969
  <type by_reference="false">array</type>
3970
  </tag>
3971
  </docblock>
3972
  </method>
3973
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1279" package="Media Library Assistant">
3974
+ <name>_process_custom_field_mapping</name>
3975
+ <full_name>_process_custom_field_mapping</full_name>
3976
+ <docblock line="1268">
3977
+ <description><![CDATA[Process custom field settings against all image attachments
3978
+ without saving the settings to the mla_option]]></description>
3979
+ <long-description><![CDATA[]]></long-description>
3980
+ <tag line="1268" name="since" description="1.10"/>
3981
+ <tag line="1268" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
3982
+ <tag line="1268" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$settings">
3983
+ <type by_reference="false">array</type>
3984
+ </tag>
3985
+ <tag line="1268" name="return" description="Message(s) reflecting the results of the operation" type="array">
3986
+ <type by_reference="false">array</type>
3987
+ </tag>
3988
+ </docblock>
3989
+ <argument line="1279">
3990
+ <name>$settings</name>
3991
+ <default><![CDATA[NULL]]></default>
3992
+ <type/>
3993
+ </argument>
3994
+ </method>
3995
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1331" package="Media Library Assistant">
3996
+ <name>_delete_custom_field</name>
3997
+ <full_name>_delete_custom_field</full_name>
3998
+ <docblock line="1322">
3999
+ <description><![CDATA[Delete a custom field from the wp_postmeta table]]></description>
4000
+ <long-description><![CDATA[]]></long-description>
4001
+ <tag line="1322" name="since" description="1.10"/>
4002
+ <tag line="1322" name="param" description="specific custom_field_mapping rule" type="array" variable="$value">
4003
+ <type by_reference="false">array</type>
4004
+ </tag>
4005
+ <tag line="1322" name="return" description="Message(s) reflecting the results of the operation" type="array">
4006
+ <type by_reference="false">array</type>
4007
+ </tag>
4008
+ </docblock>
4009
+ <argument line="1331">
4010
+ <name>$value</name>
4011
+ <default><![CDATA[]]></default>
4012
+ <type/>
4013
+ </argument>
4014
+ </method>
4015
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1355" package="Media Library Assistant">
4016
+ <name>_save_custom_field_settings</name>
4017
+ <full_name>_save_custom_field_settings</full_name>
4018
+ <docblock line="1345">
4019
+ <description><![CDATA[Save custom field settings to the options table]]></description>
4020
+ <long-description><![CDATA[]]></long-description>
4021
+ <tag line="1345" name="since" description="1.10"/>
4022
+ <tag line="1345" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4023
+ <tag line="1345" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$new_values">
4024
+ <type by_reference="false">array</type>
4025
+ </tag>
4026
+ <tag line="1345" name="return" description="Message(s) reflecting the results of the operation" type="array">
4027
+ <type by_reference="false">array</type>
4028
+ </tag>
4029
+ </docblock>
4030
+ <argument line="1355">
4031
+ <name>$new_values</name>
4032
+ <default><![CDATA[NULL]]></default>
4033
+ <type/>
4034
+ </argument>
4035
+ </method>
4036
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1395" package="Media Library Assistant">
4037
  <name>_process_iptc_exif_standard</name>
4038
  <full_name>_process_iptc_exif_standard</full_name>
4039
+ <docblock line="1385">
4040
  <description><![CDATA[Process IPTC/EXIF standard field settings against all image attachments
4041
  without saving the settings to the mla_option]]></description>
4042
  <long-description><![CDATA[]]></long-description>
4043
+ <tag line="1385" name="since" description="1.00"/>
4044
+ <tag line="1385" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4045
+ <tag line="1385" name="return" description="Message(s) reflecting the results of the operation" type="array">
4046
  <type by_reference="false">array</type>
4047
  </tag>
4048
  </docblock>
4049
  </method>
4050
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1439" package="Media Library Assistant">
4051
  <name>_process_iptc_exif_taxonomy</name>
4052
  <full_name>_process_iptc_exif_taxonomy</full_name>
4053
+ <docblock line="1429">
4054
  <description><![CDATA[Process IPTC/EXIF taxonomy term settings against all image attachments
4055
  without saving the settings to the mla_option]]></description>
4056
  <long-description><![CDATA[]]></long-description>
4057
+ <tag line="1429" name="since" description="1.00"/>
4058
+ <tag line="1429" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4059
+ <tag line="1429" name="return" description="Message(s) reflecting the results of the operation" type="array">
4060
  <type by_reference="false">array</type>
4061
  </tag>
4062
  </docblock>
4063
  </method>
4064
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1484" package="Media Library Assistant">
4065
  <name>_process_iptc_exif_custom</name>
4066
  <full_name>_process_iptc_exif_custom</full_name>
4067
+ <docblock line="1474">
4068
  <description><![CDATA[Process IPTC/EXIF custom field settings against all image attachments
4069
  without saving the settings to the mla_option]]></description>
4070
  <long-description><![CDATA[]]></long-description>
4071
+ <tag line="1474" name="since" description="1.00"/>
4072
+ <tag line="1474" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4073
+ <tag line="1474" name="return" description="Message(s) reflecting the results of the operation" type="array">
4074
  <type by_reference="false">array</type>
4075
  </tag>
4076
  </docblock>
4077
  </method>
4078
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1528" package="Media Library Assistant">
4079
  <name>_save_iptc_exif_settings</name>
4080
  <full_name>_save_iptc_exif_settings</full_name>
4081
+ <docblock line="1519">
4082
  <description><![CDATA[Save IPTC/EXIF settings to the options table]]></description>
4083
  <long-description><![CDATA[]]></long-description>
4084
+ <tag line="1519" name="since" description="1.00"/>
4085
+ <tag line="1519" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4086
+ <tag line="1519" name="return" description="Message(s) reflecting the results of the operation" type="array">
4087
  <type by_reference="false">array</type>
4088
  </tag>
4089
  </docblock>
4090
  </method>
4091
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1565" package="Media Library Assistant">
4092
  <name>_save_general_settings</name>
4093
  <full_name>_save_general_settings</full_name>
4094
+ <docblock line="1556">
4095
  <description><![CDATA[Save General settings to the options table]]></description>
4096
  <long-description><![CDATA[]]></long-description>
4097
+ <tag line="1556" name="since" description="0.1"/>
4098
+ <tag line="1556" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4099
+ <tag line="1556" name="return" description="Message(s) reflecting the results of the operation" type="array">
4100
  <type by_reference="false">array</type>
4101
  </tag>
4102
  </docblock>
4103
  </method>
4104
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1623" package="Media Library Assistant">
4105
  <name>_reset_general_settings</name>
4106
  <full_name>_reset_general_settings</full_name>
4107
+ <docblock line="1616">
4108
  <description><![CDATA[Delete saved settings, restoring default values]]></description>
4109
  <long-description><![CDATA[]]></long-description>
4110
+ <tag line="1616" name="since" description="0.1"/>
4111
+ <tag line="1616" name="return" description="Message(s) reflecting the results of the operation" type="array">
4112
  <type by_reference="false">array</type>
4113
  </tag>
4114
  </docblock>
4115
  </method>
4116
  </class>
4117
  </file>
4118
+ <file path="includes\class-mla-shortcodes.php" hash="9f05e59a901b060e3f32fd7683ab3a71" package="Media Library Assistant">
4119
  <docblock line="2">
4120
  <description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
4121
  <long-description><![CDATA[]]></long-description>
4156
  </tag>
4157
  </docblock>
4158
  </property>
4159
+ <property final="false" static="true" visibility="private" line="1036" namespace="global" package="Media Library Assistant">
4160
  <name>$mla_iptc_records</name>
4161
  <default><![CDATA[array("1#000" => "Model Version", "1#005" => "Destination", "1#020" => "File Format", "1#022" => "File Format Version", "1#030" => "Service Identifier", "1#040" => "Envelope Number", "1#050" => "Product ID", "1#060" => "Envelope Priority", "1#070" => "Date Sent", "1#080" => "Time Sent", "1#090" => "Coded Character Set", "1#100" => "UNO", "1#120" => "ARM Identifier", "1#122" => "ARM Version", "2#000" => "Record Version", "2#003" => "Object Type Reference", "2#004" => "Object Attribute Reference", "2#005" => "Object Name", "2#007" => "Edit Status", "2#008" => "Editorial Update", "2#010" => "Urgency", "2#012" => "Subject Reference", "2#015" => "Category", "2#020" => "Supplemental Category", "2#022" => "Fixture Identifier", "2#025" => "Keywords", "2#026" => "Content Location Code", "2#027" => "Content Location Name", "2#030" => "Release Date", "2#035" => "Release Time", "2#037" => "Expiration Date", "2#038" => "Expiration Time", "2#040" => "Special Instructions", "2#042" => "Action Advised", "2#045" => "Reference Service", "2#047" => "Reference Date", "2#050" => "Reference Number", "2#055" => "Date Created", "2#060" => "Time Created", "2#062" => "Digital Creation Date", "2#063" => "Digital Creation Time", "2#065" => "Originating Program", "2#070" => "Program Version", "2#075" => "Object Cycle", "2#080" => "By-line", "2#085" => "By-line Title", "2#090" => "City", "2#092" => "Sub-location", "2#095" => "Province or State", "2#100" => "Country or Primary Location Code", "2#101" => "Country or Primary Location Name", "2#103" => "Original Transmission Reference", "2#105" => "Headline", "2#110" => "Credit", "2#115" => "Source", "2#116" => "Copyright Notice", "2#118" => "Contact", "2#120" => "Caption or Abstract", "2#122" => "Caption Writer or Editor", "2#125" => "Rasterized Caption", "2#130" => "Image Type", "2#131" => "Image Orientation", "2#135" => "Language Identifier", "2#150" => "Audio Type", "2#151" => "Audio Sampling Rate", "2#152" => "Audio Sampling Resolution", "2#153" => "Audio Duration", "2#154" => "Audio Outcue", "2#200" => "ObjectData Preview File Format", "2#201" => "ObjectData Preview File Format Version", "2#202" => "ObjectData Preview Data", "7#010" => "Size Mode", "7#020" => "Max Subfile Size", "7#090" => "ObjectData Size Announced", "7#095" => "Maximum ObjectData Size", "8#010" => "Subfile", "9#010" => "Confirmed ObjectData Size")]]></default>
4162
+ <docblock line="1026">
4163
  <description><![CDATA[IPTC Dataset identifiers and names]]></description>
4164
  <long-description><![CDATA[<p>This array contains the identifiers and names of Datasets defined in
4165
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
4166
+ <tag line="1026" name="since" description="0.90"/>
4167
+ <tag line="1026" name="var" description="" type="array">
4168
  <type by_reference="false">array</type>
4169
  </tag>
4170
  </docblock>
4171
  </property>
4172
+ <property final="false" static="true" visibility="public" line="1135" namespace="global" package="Media Library Assistant">
4173
  <name>$mla_iptc_keys</name>
4174
  <default><![CDATA[array('model-version' => '1#000', 'destination' => '1#005', 'file-format' => '1#020', 'file-format-version' => '1#022', 'service-identifier' => '1#030', 'envelope-number' => '1#040', 'product-id' => '1#050', 'envelope-priority' => '1#060', 'date-sent' => '1#070', 'time-sent' => '1#080', 'coded-character-set' => '1#090', 'uno' => '1#100', 'arm-identifier' => '1#120', 'arm-version' => '1#122', 'record-version' => '2#000', 'object-type-reference' => '2#003', 'object-attribute-reference' => '2#004', 'object-name' => '2#005', 'edit-status' => '2#007', 'editorial-update' => '2#008', 'urgency' => '2#010', 'subject-reference' => '2#012', 'category' => '2#015', 'supplemental-category' => '2#020', 'fixture-identifier' => '2#022', 'keywords' => '2#025', 'content-location-code' => '2#026', 'content-location-name' => '2#027', 'release-date' => '2#030', 'release-time' => '2#035', 'expiration-date' => '2#037', 'expiration-time' => '2#038', 'special-instructions' => '2#040', 'action-advised' => '2#042', 'reference-service' => '2#045', 'reference-date' => '2#047', 'reference-number' => '2#050', 'date-created' => '2#055', 'time-created' => '2#060', 'digital-creation-date' => '2#062', 'digital-creation-time' => '2#063', 'originating-program' => '2#065', 'program-version' => '2#070', 'object-cycle' => '2#075', 'by-line' => '2#080', 'by-line-title' => '2#085', 'city' => '2#090', 'sub-location' => '2#092', 'province-or-state' => '2#095', 'country-or-primary-location-code' => '2#100', 'country-or-primary-location-name' => '2#101', 'original-transmission-reference' => '2#103', 'headline' => '2#105', 'credit' => '2#110', 'source' => '2#115', 'copyright-notice' => '2#116', 'contact' => '2#118', 'caption-or-abstract' => '2#120', 'caption-writer-or-editor' => '2#122', 'rasterized-caption' => '2#125', 'image-type' => '2#130', 'image-orientation' => '2#131', 'language-identifier' => '2#135', 'audio-type' => '2#150', 'audio-sampling-rate' => '2#151', 'audio-sampling-resolution' => '2#152', 'audio-duration' => '2#153', 'audio-outcue' => '2#154', 'objectdata-preview-file-format' => '2#200', 'objectdata-preview-file-format-version' => '2#201', 'objectdata-preview-data' => '2#202', 'size-mode' => '7#010', 'max-subfile-size' => '7#020', 'objectdata-size-announced' => '7#090', 'maximum-objectdata-size' => '7#095', 'subfile' => '8#010', 'confirmed-objectdata-size' => '9#010')]]></default>
4175
+ <docblock line="1125">
4176
  <description><![CDATA[IPTC Dataset friendly name/slug and identifiers]]></description>
4177
  <long-description><![CDATA[<p>This array contains the sanitized names and identifiers of Datasets defined in
4178
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
4179
+ <tag line="1125" name="since" description="0.90"/>
4180
+ <tag line="1125" name="var" description="" type="array">
4181
  <type by_reference="false">array</type>
4182
  </tag>
4183
  </docblock>
4184
  </property>
4185
+ <property final="false" static="true" visibility="private" line="1234" namespace="global" package="Media Library Assistant">
4186
  <name>$mla_iptc_descriptions</name>
4187
  <default><![CDATA[array("1#000" => "2 octet binary IIM version number", "1#005" => "Max 1024 characters of Destination (ISO routing information); repeatable", "1#020" => "2 octet binary file format number, see IPTC-NAA V4 Appendix A", "1#022" => "2 octet binary file format version number", "1#030" => "Max 10 characters of Service Identifier and product", "1#040" => "8 Character Envelope Number", "1#050" => "Max 32 characters subset of provider's overall service; repeatable", "1#060" => "1 numeric character of envelope handling priority (not urgency)", "1#070" => "8 numeric characters of Date Sent by service - CCYYMMDD", "1#080" => "11 characters of Time Sent by service - HHMMSS±HHMM", "1#090" => "Max 32 characters of control functions, etc.", "1#100" => "14 to 80 characters of eternal, globally unique identification for objects", "1#120" => "2 octet binary Abstract Relationship Model Identifier", "1#122" => "2 octet binary Abstract Relationship Model Version", "2#000" => "2 octet binary Information Interchange Model, Part II version number", "2#003" => "3 to 67 Characters of Object Type Reference number and optional text", "2#004" => "3 to 67 Characters of Object Attribute Reference number and optional text; repeatable", "2#005" => "Max 64 characters of the object name or shorthand reference", "2#007" => "Max 64 characters of the status of the objectdata", "2#008" => "2 numeric characters of the type of update this object provides", "2#010" => "1 numeric character of the editorial urgency of content", "2#012" => "13 to 236 characters of a structured definition of the subject matter; repeatable", "2#015" => "Max 3 characters of the subject of the objectdata, DEPRECATED", "2#020" => "Max 32 characters (each) of further refinement of subject, DEPRECATED; repeatable", "2#022" => "Max 32 characters identifying recurring, predictable content", "2#025" => "Max 64 characters (each) of tags; repeatable", "2#026" => "3 characters of ISO3166 country code or IPTC-assigned code; repeatable", "2#027" => "Max 64 characters of publishable country/geographical location name; repeatable", "2#030" => "8 numeric characters of Release Date - CCYYMMDD", "2#035" => "11 characters of Release Time (earliest use) - HHMMSS±HHMM", "2#037" => "8 numeric characters of Expiration Date (latest use) - CCYYMDD", "2#038" => "11 characters of Expiration Time (latest use) - HHMMSS±HHMM", "2#040" => "Max 256 Characters of editorial instructions, e.g., embargoes and warnings", "2#042" => "2 numeric characters of type of action this object provides to a previous object", "2#045" => "Max 10 characters of the Service ID (1#030) of a prior envelope; repeatable", "2#047" => "8 numeric characters of prior envelope Reference Date (1#070) - CCYYMMDD; repeatable", "2#050" => "8 characters of prior envelope Reference Number (1#040); repeatable", "2#055" => "8 numeric characters of intellectual content Date Created - CCYYMMDD", "2#060" => "11 characters of intellectual content Time Created - HHMMSS±HHMM", "2#062" => "8 numeric characters of digital representation creation date - CCYYMMDD", "2#063" => "11 characters of digital representation creation time - HHMMSS±HHMM", "2#065" => "Max 32 characters of the program used to create the objectdata", "2#070" => "Program Version - Max 10 characters of the version of the program used to create the objectdata", "2#075" => "1 character where a=morning, p=evening, b=both", "2#080" => "Max 32 Characters of the name of the objectdata creator, e.g., the writer, photographer; repeatable", "2#085" => "Max 32 characters of the title of the objectdata creator; repeatable", "2#090" => "Max 32 Characters of the city of objectdata origin", "2#092" => "Max 32 Characters of the location within the city of objectdata origin", "2#095" => "Max 32 Characters of the objectdata origin Province or State", "2#100" => "3 characters of ISO3166 or IPTC-assigned code for Country of objectdata origin", "2#101" => "Max 64 characters of publishable country/geographical location name of objectdata origin", "2#103" => "Max 32 characters of a code representing the location of original transmission", "2#105" => "Max 256 Characters of a publishable entry providing a synopsis of the contents of the objectdata", "2#110" => "Max 32 Characters that identifies the provider of the objectdata (Vs the owner/creator)", "2#115" => "Max 32 Characters that identifies the original owner of the intellectual content", "2#116" => "Max 128 Characters that contains any necessary copyright notice", "2#118" => "Max 128 characters that identifies the person or organisation which can provide further background information; repeatable", "2#120" => "Max 2000 Characters of a textual description of the objectdata", "2#122" => "Max 32 Characters that the identifies the person involved in the writing, editing or correcting the objectdata or caption/abstract; repeatable", "2#125" => "7360 binary octets of the rasterized caption - 1 bit per pixel, 460x128-pixel image", "2#130" => "2 characters of color composition type and information", "2#131" => "1 alphabetic character indicating the image area layout - P=portrait, L=landscape, S=square", "2#135" => "2 or 3 aphabetic characters containing the major national language of the object, according to the ISO 639:1988 codes", "2#150" => "2 characters identifying monaural/stereo and exact type of audio content", "2#151" => "6 numeric characters representing the audio sampling rate in hertz (Hz)", "2#152" => "2 numeric characters representing the number of bits in each audio sample", "2#153" => "6 numeric characters of the Audio Duration - HHMMSS", "2#154" => "Max 64 characters of the content of the end of an audio objectdata", "2#200" => "2 octet binary file format of the ObjectData Preview", "2#201" => "2 octet binary particular version of the ObjectData Preview File Format", "2#202" => "Max 256000 binary octets containing the ObjectData Preview data", "7#010" => "1 numeric character - 0=objectdata size not known, 1=objectdata size known at beginning of transfer", "7#020" => "4 octet binary maximum subfile dataset(s) size", "7#090" => "4 octet binary objectdata size if known at beginning of transfer", "7#095" => "4 octet binary largest possible objectdata size", "8#010" => "Subfile DataSet containing the objectdata itself; repeatable", "9#010" => "4 octet binary total objectdata size")]]></default>
4188
+ <docblock line="1224">
4189
  <description><![CDATA[IPTC Dataset descriptions]]></description>
4190
  <long-description><![CDATA[<p>This array contains the descriptions of Datasets defined in
4191
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
4192
+ <tag line="1224" name="since" description="0.90"/>
4193
+ <tag line="1224" name="var" description="" type="array">
4194
  <type by_reference="false">array</type>
4195
  </tag>
4196
  </docblock>
4197
  </property>
4198
+ <property final="false" static="true" visibility="private" line="1333" namespace="global" package="Media Library Assistant">
4199
  <name>$mla_iptc_formats</name>
4200
  <default><![CDATA[array(0 => "No ObjectData", 1 => "IPTC-NAA Digital Newsphoto Parameter Record", 2 => "IPTC7901 Recommended Message Format", 3 => "Tagged Image File Format (Adobe/Aldus Image data)", 4 => "Illustrator (Adobe Graphics data)", 5 => "AppleSingle (Apple Computer Inc)", 6 => "NAA 89-3 (ANPA 1312)", 7 => "MacBinary II", 0 => "IPTC Unstructured Character Oriented File Format (UCOFF)", 0 => "United Press International ANPA 1312 variant", 10 => "United Press International Down-Load Message", 11 => "JPEG File Interchange (JFIF)", 12 => "Photo-CD Image-Pac (Eastman Kodak)", 13 => "Microsoft Bit Mapped Graphics File [*.BMP]", 14 => "Digital Audio File [*.WAV] (Microsoft & Creative Labs)", 15 => "Audio plus Moving Video [*.AVI] (Microsoft)", 16 => "PC DOS/Windows Executable Files [*.COM][*.EXE]", 17 => "Compressed Binary File [*.ZIP] (PKWare Inc)", 18 => "Audio Interchange File Format AIFF (Apple Computer Inc)", 19 => "RIFF Wave (Microsoft Corporation)", 20 => "Freehand (Macromedia/Aldus)", 21 => "Hypertext Markup Language - HTML (The Internet Society)", 22 => "MPEG 2 Audio Layer 2 (Musicom), ISO/IEC", 23 => "MPEG 2 Audio Layer 3, ISO/IEC", 24 => "Portable Document File (*.PDF) Adobe", 25 => "News Industry Text Format (NITF)", 26 => "Tape Archive (*.TAR)", 27 => "Tidningarnas Telegrambyrå NITF version (TTNITF DTD)", 28 => "Ritzaus Bureau NITF version (RBNITF DTD)", 29 => "Corel Draw [*.CDR]")]]></default>
4201
+ <docblock line="1323">
4202
  <description><![CDATA[IPTC file format identifiers and descriptions]]></description>
4203
  <long-description><![CDATA[<p>This array contains the file format identifiers and descriptions defined in
4204
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 1#020.</p>]]></long-description>
4205
+ <tag line="1323" name="since" description="0.90"/>
4206
+ <tag line="1323" name="var" description="" type="array">
4207
  <type by_reference="false">array</type>
4208
  </tag>
4209
  </docblock>
4210
  </property>
4211
+ <property final="false" static="true" visibility="private" line="1376" namespace="global" package="Media Library Assistant">
4212
  <name>$mla_iptc_image_types</name>
4213
  <default><![CDATA[array("M" => "Monochrome", "Y" => "Yellow Component", "M" => "Magenta Component", "C" => "Cyan Component", "K" => "Black Component", "R" => "Red Component", "G" => "Green Component", "B" => "Blue Component", "T" => "Text Only", "F" => "Full colour composite, frame sequential", "L" => "Full colour composite, line sequential", "P" => "Full colour composite, pixel sequential", "S" => "Full colour composite, special interleaving")]]></default>
4214
+ <docblock line="1366">
4215
  <description><![CDATA[IPTC image type identifiers and descriptions]]></description>
4216
  <long-description><![CDATA[<p>This array contains the image type identifiers and descriptions defined in
4217
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 2#130, octet 2.</p>]]></long-description>
4218
+ <tag line="1366" name="since" description="0.90"/>
4219
+ <tag line="1366" name="var" description="" type="array">
4220
  <type by_reference="false">array</type>
4221
  </tag>
4222
  </docblock>
4267
  <type/>
4268
  </argument>
4269
  </method>
4270
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="689" package="Media Library Assistant">
4271
  <name>mla_get_shortcode_attachments</name>
4272
  <full_name>mla_get_shortcode_attachments</full_name>
4273
+ <docblock line="679">
4274
  <description><![CDATA[Parses shortcode parameters and returns the gallery objects]]></description>
4275
  <long-description><![CDATA[]]></long-description>
4276
+ <tag line="679" name="since" description=".50"/>
4277
+ <tag line="679" name="param" description="Post ID of the parent" type="int" variable="$post_parent">
4278
  <type by_reference="false">int</type>
4279
  </tag>
4280
+ <tag line="679" name="param" description="Attributes of the shortcode" type="array" variable="$attr">
4281
  <type by_reference="false">array</type>
4282
  </tag>
4283
+ <tag line="679" name="return" description="List of attachments returned from WP_Query" type="array">
4284
  <type by_reference="false">array</type>
4285
  </tag>
4286
  </docblock>
4287
+ <argument line="689">
4288
  <name>$post_parent</name>
4289
  <default><![CDATA[]]></default>
4290
  <type/>
4291
  </argument>
4292
+ <argument line="689">
4293
  <name>$attr</name>
4294
  <default><![CDATA[]]></default>
4295
  <type/>
4296
  </argument>
4297
  </method>
4298
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1009" package="Media Library Assistant">
4299
  <name>mla_shortcode_query_posts_where_filter</name>
4300
  <full_name>mla_shortcode_query_posts_where_filter</full_name>
4301
+ <docblock line="996">
4302
  <description><![CDATA[Filters the WHERE clause for shortcode queries]]></description>
4303
  <long-description><![CDATA[<p>Captures debug information. Adds whitespace to the post_type = 'attachment'
4304
  phrase to circumvent subsequent Role Scoper modification of the clause.
4305
  Defined as public because it's a filter.</p>]]></long-description>
4306
+ <tag line="996" name="since" description="0.70"/>
4307
+ <tag line="996" name="param" description="query clause before modification" type="string" variable="$where_clause">
4308
  <type by_reference="false">string</type>
4309
  </tag>
4310
+ <tag line="996" name="return" description="query clause after modification" type="string">
4311
  <type by_reference="false">string</type>
4312
  </tag>
4313
  </docblock>
4314
+ <argument line="1009">
4315
  <name>$where_clause</name>
4316
  <default><![CDATA[]]></default>
4317
  <type/>
4364
  </docblock>
4365
  </constant>
4366
  </file>
4367
+ <file path="index.php" hash="02737436972fd0776c16a9ba63c5a0f2" package="Media Library Assistant">
4368
  <docblock line="2">
4369
  <description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
4370
  <long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
4371
  will the rest of the plugin be loaded and run.</p>]]></long-description>
4372
  <tag line="2" name="package" description="Media Library Assistant"/>
4373
+ <tag line="2" name="version" description="1.10"/>
4374
  </docblock>
4375
  <include line="103" type="Require Once" package="Media Library Assistant">
4376
  <name>includes/mla-plugin-loader.php</name>
readme.txt CHANGED
@@ -1,22 +1,26 @@
1
  === Plugin Name ===
2
  Contributors: dglingren
3
  Donate link: http://fairtradejudaica.org/make-a-difference/donate/
4
- Tags: attachment, attachments, documents, gallery, image, images, media, library, media library, media-tags, media tags, tags, media categories, categories, IPTC, exif, meta, metadata, photo, photos, photograph, photographs, photoblog, photo albums
5
  Requires at least: 3.3
6
  Tested up to: 3.5
7
- Stable tag: 1.00
8
  License: GPLv2 or later
9
  License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
 
11
- Enhances the Media Library; powerful[mla_gallery], taxonomy support, IPTC/EXIF processing, 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 query and display support for WordPress categories, tags, custom taxonomies and custom fields, 2) support for all post_mime_type values, not just images 3) media Library items need not be "attached" to the post, and 4) control over the styles, markup and content of each gallery using Style and Markup Templates.
18
 
19
- * **IPTC** and **EXIF** metadata can be assigned to standard WordPress fields, taxonomy terms and Custom fields. You can update all existing attachments from the Settings page IPTC/EXIF tab, groups of existing attachments with a Bulk Action or one existing attachment from the Edit Media/Edit Single Item screen. Display **IPTC** and **EXIF** metadata with `[mla_gallery]` custom templates.
 
 
 
 
20
 
21
  * **Enhanced Search Media box**. Search can be extended to the name/slug, ALT text and caption fields. The connector between search terms can be "and" or "or".
22
 
@@ -38,7 +42,8 @@ This plugin was inspired by my work on the WordPress web site for our nonprofit,
38
 
39
  1. Upload `media-library-assistant` and its subfolders to your `/wp-content/plugins/` directory
40
  1. Activate the plugin through the "Plugins" menu in WordPress
41
- 1. Visit the settings page to customize category and tag support
 
42
  1. Visit the "Assistant" submenu in the Media admin section
43
  1. Click the Screen Options link to customize the display
44
  1. Use the enhanced Edit, Quick Edit and Bulk Edit pages to assign categories and tags
@@ -46,6 +51,10 @@ This plugin was inspired by my work on the WordPress web site for our nonprofit,
46
 
47
  == Frequently Asked Questions ==
48
 
 
 
 
 
49
  = How can I use Categories, Tags and custom taxonomies to select images for display in my posts and pages? =
50
 
51
  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.
@@ -83,7 +92,7 @@ For example, if you add Tags support to the Assistant and then assign tag values
83
 
84
  Hover over the item you want to modify and click the "Edit" action. On the Edit Single Item page, set the ID portion of the Parent Info field to zero (0), then click "Update" to record your changes. If you change your mind, click "Cancel" to return to the main page without recording any changes.
85
 
86
- = The Media Library Assistant table listing seems sluggish; is there anything I can do to make it faster? =
87
 
88
  Some of the MLA features such as where-used reporting and ALT Text sorting/searching require a lot of database procesing. If this is an issue for you, go to the Settings page and adjust the "Where-used database access tuning" settings. For any where-used category you can enable or disable processing. For the "Gallery in" and "MLA Gallery in" you can also choose to update the results on every page load or to cache the results for fifteen minutes between updates. The cache is also flushed automatically when posts, pages or attachments are inserted or updated.
89
 
@@ -97,31 +106,42 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
97
 
98
  == Screenshots ==
99
 
100
- 1. The Media Library Assistant submenu showing the available columns, including "Featured in", "Inserted in", "Att. Categories" and "Att. Tags"; also shows the Quick Edit area.
101
- 2. The Media Library Assistant submenu showing the Bulk Edit area with taxonomy Add, Remove and Replace options; also shows the tags suggestion popup.
102
  3. A typical edit taxonomy page, showing the "Attachments" column.
103
  4. The enhanced Edit page showing additional fields, categories and tags.
104
  5. The Settings page General tab, where you can customize support of Att. Categories, Att. Tags and other taxonomies, where-used reporting and the default sort order.
105
  6. The Settings page MLA Gallery tab, where you can add custom style and markup templates for `[mla_gallery]` shortcode output.
106
  7. The Settings page IPTC &amp; EXIF Processing Options screen, where you can map image metadata to standard fields (e.g. caption), taxonomy terms and custom fields.
 
107
 
108
  == Changelog ==
109
 
 
 
 
 
 
 
 
 
 
 
110
  = 1.00 =
111
- * New: IPTC and EXIF metadata can be assigned to standard WordPress fields, taxonomy terms and Custom fields. You can update all existing attachments from the Settings page IPTC/EXIF tab, groups of existing attachments with a Bulk Action or one existing attachment from the Edit Media/Edit Single Item screen.
112
  * New: Where-used processing can be tuned or disabled on the Settings page, General tab.
113
  * New: "Gallery in" and "MLA Gallery in" results are cached for fifteen minutes, avoiding repetitive database access. The cache is automatically flushed when pages, posts or attachments are inserted or updates, and can be manually flushed or disabled on the Settings page, General tab.
114
  * New: Default `[mla_gallery]` style and markup templates can be specified on the Settings page.
115
  * New: `[mla_gallery]` parameter "mla_float" allows control of gallery item "float" attribute.
116
  * Fix: Field-level substitution parameters (custom fields, taxonomy terms, IPTC metadata and EXIF metadata) are now available for mla_link_text, mla_rollover_text and mla_caption parameters.
117
- * Fix: Attachment/Parent relationships are reported consistently on the edit pages and the Assistant table listing.
118
  * Fix: Defect in generating mla_debug messages has been corrected.
119
  * Fix: Default "Order by" option now includes "None".
120
  * Fix: For WordPress 3.5, Custom Field support for attachments enabled in admin_init action.
121
 
122
  = 0.90 =
123
  * New: Field-level IPTC and EXIF metadata support for `[mla_gallery]` display using custom markup templates.
124
- * New: Field-level Custom field and taxonomy term support for `[mla_gallery]` display using custom markup templates.
125
  * New: Contextual help tabs added to WordPress 3.5+ Edit Media Screen, explaining MLA enhancements.
126
  * Updated for WordPress version 3.5!
127
 
@@ -136,7 +156,7 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
136
  * New: The `[mla_gallery]` "mla_debug" parameter provides debugging information for query parameters.
137
  * New: Quick Edit area now includes caption field.
138
  * New: Settings page now divided into three tabbed subpages for easier access to settings and documentation.
139
- * New: For WordPress 3.5, Custom Field support added to attachments and to the WordPress standard Edit Media Screen.
140
  * New: For WordPress version 3.5, the WordPress standard Edit Media screen now includes Last Modified date, Parent Info, Menu Order, Image Metadata and all "where-used" information.
141
  * New: For WordPress versions before 3.5, the MLA Edit Single Item screen now includes "Gallery in" and "MLA Gallery in" information.
142
  * Fix: Bulk edit now supports "No Change" option for Author.
@@ -213,6 +233,9 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
213
 
214
  == Upgrade Notice ==
215
 
 
 
 
216
  = 1.00 =
217
  Map IPTC and EXIF metadata to standard fields, taxonomy terms and custom fields. Get improved performance for where-used reporting. Specify default `[mla_gallery]` style and markup templates. Five other fixes.
218
 
@@ -247,7 +270,7 @@ Upgrade for the new Bulk Edit area; add, remove or replace taxonomy terms for se
247
  Upgrade to support ALL taxonomies, including the standard Categories and Tags, your custom taxonomies and the Assistant's pre-defined Att. Categories and Att. Tags. Add taxonomy columns to the Assistant admin screen, filter on any taxonomy, assign terms and list the attachments for a term.
248
 
249
  = 0.20 =
250
- You should upgrade to this version if you need "Quick Edit" functionality.
251
 
252
  = 0.11 =
253
  You should upgrade to this version if you are getting "404 Not Found" errors when updating single items.
@@ -257,13 +280,15 @@ Initial release.
257
 
258
  == Other Notes ==
259
 
260
- In this section:
261
 
262
  * Acknowledgements
263
  * MLA Gallery Shortcode Documentation
 
264
  * MLA Gallery Style and Markup Template Documentation
 
265
  * IPTC &amp; EXIF Processing Options
266
- * Online Help Summary (Assistant Submenu - Attachment List Table)
267
 
268
  == Acknowledgements ==
269
 
@@ -410,9 +435,15 @@ The search parameter ("s=keyword") will perform a keyword search. A cursory insp
410
 
411
  The "mla_debug" parameter controls the display of information about the query parameters and SQL statements used to retrieve gallery items. If you code `mla_debug=true` you will see a lot of information added to the post or page containing the gallery. Of course, this parameter should <strong>only</strong> be used in a development/debugging environment; it's quite ugly.
412
 
 
 
 
 
 
 
413
  == MLA Gallery Style and Markup Templates ==
414
 
415
- The Style and Markup templates give you great flexibility for the content and format of each <code>[mla_gallery]</code>. You can define as many templates as you need.
416
 
417
  Style templates provide gallery-specific CSS inline styles. Markup templates provide the HTML markup for 1) the beginning of the gallery, 2) the beginning of each row, 3) each gallery item, 4) the end of each row and 5) the end of the gallery. The attachment-specific markup parameters let you choose among most of the attachment fields, not just the caption.
418
 
@@ -499,7 +530,7 @@ The optional <strong>",single" indicator</strong> defines how to handle fields w
499
 
500
  There are four prefix values for field-level data. Prefix values must be coded as shown; all lowercase letters.
501
 
502
- * `custom`: WordPress Custom Fields, which you can define and populate on the Edit Media screen. The field name, or key, can contain spaces and some punctuation characters. You <strong>cannot use the plus sign ('+')</strong> in a field name you want to use with `[mla_gallery]`. Custom field names are case-sensitive; "client" and "Client" are not the same.
503
  * `terms`: WordPress Category, tag or custom taxonomy terms. For this category, you code the name of the taxonomy as the field name. The term(s) associated with the attachment will be displayed in the `[mla_gallery]`. Note that you must use the name/slug string for taxonomy, not the "title" string. For example, use "attachment-category" or "attachment-tag", not "Att. Category" or "Attachment Category".
504
 
505
  * `iptc`: The IPTC (International Press Telecommunications Council) metadata, if any, embedded in the image file. For this category, you can code any of the IPTC DataSet tag and field identifiers, e.g., "2#025" for the Keywords field. You can also use the "friendly name" MLA defines for most of the IPTC fields; see the table of identifiers and friendly names in the MLA documentation. You can find more information in the <a href="http://www.iptc.org/std/IIM/4.1/specification/IIMV4.1.pdf" title="IPTC-NAA Information Interchange Model Version No. 4.1 specification" target="_blank">IPTC-NAA Information Interchange Model Version No. 4.1 specification</a>.
@@ -573,7 +604,62 @@ Here's a small example that shows a gallery using table markup. The Item markup
573
 
574
  </table>
575
 
576
- ==IPTC &amp; EXIF Processing Options</h==
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
577
 
578
  Some image file formats such as JPEG DCT or TIFF Rev 6.0 support the addition of data about the image, or <em>metadata</em>, in the image file. Many popular image processing programs such as Adobe PhotoShop allow you to populate metadata fields with information such as a copyright notice, caption, the image author and keywords that categorize the image in a larger collection. WordPress uses some of this information to populate the Title, Slug and Description fields when you add an image to the Media Library.
579
 
@@ -581,7 +667,7 @@ The Media Library Assistant has powerful tools for copying image metadata to:
581
 
582
  * the WordPress standard fields, e.g., the Caption
583
  * taxonomy terms, e.g., in categories, tags or custom taxonomies
584
- * WordPress Custom Fields
585
 
586
  You can define the rules for mapping metadata on the "IPTC/EXIF" tab of the Settings page. You can choose to automatically apply the rules when new media are added to the Library (or not). You can click the "Map IPTC/EXIF metadata" button on the Edit Media/Edit Single Item screen or in the bulk edit area to selectivelly apply the rules to one or more images. You can click the "Map All Attachments Now" to apply the rules to <strong>all of the images in your library</strong> at one time.
587
 
@@ -589,7 +675,7 @@ You can define the rules for mapping metadata on the "IPTC/EXIF" tab of the Sett
589
 
590
  The three mapping tables on the IPTC/EXIF tab have the following columns:
591
 
592
- * `Field Title`: The standard field title, taxonomy name or Custom Field name. In the Custom Field table you can define a new field by entering its name in the blank box at the bottom of the list; the value will be saved when you click "Save Changes" at the bottom of the screen.
593
 
594
  * `IPTC Value`: The IPTC (International Press Telecommunications Council) metadata, if any, embedded in the image file. For this category, you can select any of the IPTC DataSet tag and field identifiers, e.g., "2#025" for the Keywords field. The dropdown list has the identifier and the "friendly name" MLA defines for most of the IPTC fields; see the table of identifiers and friendly names in the table below. You can find more information in the <a href="http://www.iptc.org/std/IIM/4.1/specification/IIMV4.1.pdf" title="IPTC-NAA Information Interchange Model Version No. 4.1 specification" target="_blank">IPTC-NAA Information Interchange Model Version No. 4.1 specification</a>.
595
 
@@ -635,9 +721,9 @@ The priority order for mapping the post_content value from non-blank IPTC/EXIF m
635
 
636
  == Online Help Summary ==
637
 
638
- <p><strong><em>Assistant Submenu - Attachment List Table</em></strong></p>
639
  <h4>Overview</h4>
640
- <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>
641
  <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>
642
  <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>
643
  <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>
@@ -647,7 +733,7 @@ The priority order for mapping the post_content value from non-blank IPTC/EXIF m
647
  <p>You can also use the information in the &#8220;Title/Name&#8221; column to identify &#8220;Orphan&#8221; items that are not used in any post or page and items with a &#8220;Bad Parent&#8221; (a parent that does contain any reference to the item) or an &#8220;Invalid Parent&#8221; (a parent that does not exist).</p>
648
  <p>If performance is a concern, you can go to the Settings page and disable either or both of these columns.</p>
649
  <h4>Gallery/MLA Gallery</h4>
650
- <p>The &#8220;Gallery in&#8221; and &#8220;MLA Gallery in&#8221; columns are a powerful tool for managing your attachments. They show you where each attachment is returned by a <code>[gallery]</code> or <code>[mla_gallery]</code> shortcode in a post or page. These columns do <strong>not</strong> use the post_parent (attached to) status of the item; they actually execute each shortcode and tabulate the attachments they return.</p>
651
  <p>You can also use the information in the &#8220;Title/Name&#8221; column to identify &#8220;Orphan&#8221; items that are not used in any post or page and items with a &#8220;Bad Parent&#8221; (a parent that does contain any reference to the item) or an &#8220;Invalid Parent&#8221; (a parent that does not exist).</p>
652
  <p>If performance is a concern, you can go to the Settings page and disable either or both of these columns. You can also adjust the settings to cache the results for fifteen minutes between updates. Results are automatically updated after a post, page or attachment is added or updated.</p>
653
  <h4>Taxonomy Support</h4>
@@ -655,6 +741,8 @@ The priority order for mapping the post_content value from non-blank IPTC/EXIF m
655
  <p>The Media Library Assistant provides two pre-defined taxonomies, &#8220;Att. Categories&#8221; and &#8220;Att. Tags&#8221; which are enabled by default. You can add or remove support for any registered taxonomy on the Settings screen. The standard WordPress Categories and Tags as well as any custom taxonomies can be supported.</p>
656
  <p>When you add support for a taxonomy it is visible on the main screen. If you want to hide the column simply use the Screen Options to uncheck the Show on screen box.</p>
657
  <p>Supported taxonomies also appear as submenus below the Media menu at the left of the screen. You can edit the taxonomy terms by clicking these submenus. The taxonomy edit screens include an &#8220;Attachments&#8221; column which displays the number of attachment objects for each term. You can display a filtered list of the attachments by clicking on the number in this column.</p>
 
 
658
  <h4>Search Media</h4>
659
  <p>The &#8220;Search Media&#8221; box supports a keyword search of several attachment fields; enter words and/or phrases in the box, separated by spaces. Click the Search Media button for a case-insensitive "SQL LIKE" search. Each keyword in the search phrase is matched independently, so the order of search words does not have to match the order in the text. For example, searching on "friend" and "best" will match "Best Friend". If you put quotes around a search phrase then word order is required for a match (and spaces between words must match as well). You can also match on partial words, e.g., "rien" will match "friend".</p>
660
  <p>Once you&#8217;ve entered the terms you want, use the options below the box to tailor your search. You can pick the connector used between search terms; "or" means any of the terms will match, "and" means all of the terms must match. Use the checkboxes to extend your search to more fields in the database.</p>
@@ -675,7 +763,8 @@ The priority order for mapping the post_content value from non-blank IPTC/EXIF m
675
  WordPress 3.5 introduced a much-improved Edit Media screen. Media Library Assistant incorporates and adds several enhancements to the new screen:
676
 
677
  * Displays Last Modified date and time
678
- * Supports Custom fields, which `[mla_gallery]` can use for query and display
 
679
  * Supports Parent Info and Menu Order
680
  * Displays Image Metadata
681
  * Displays where-used information; Featured in, Inserted in, Gallery in and MLA Gallery in
@@ -689,6 +778,9 @@ WordPress 3.5 introduced a much-improved Edit Media screen. Media Library Assist
689
  <h4>Parent Info</h4>
690
  <p>The &#8220;Parent Info&#8221; field displays the Post ID, type and title of the post or page to which the item is attached. It will display &#8220;0 (unattached)&#8221; if there is no parent post or page.</p>
691
  <p>You can change the post or page to which the item is attached by changing the Post ID value and clicking the &#8220;Update&#8221; button. Changing the Post ID value to zero (0) will &#8220;unattach&#8221; the item.</p>
 
 
 
692
  <p><strong><em>Edit Hierarchical Taxonomies (Categories)</em></strong></p>
693
  <h4>Overview</h4>
694
  <p>You can use <strong>categories</strong> to define sections of your site and group related attachments. The default is &#8220;none&#8221;, i.e., the attachment is not associated with any category.</p>
1
  === Plugin Name ===
2
  Contributors: dglingren
3
  Donate link: http://fairtradejudaica.org/make-a-difference/donate/
4
+ Tags: attachment, attachments, documents, gallery, image, images, media, library, media library, media-tags, media tags, tags, media categories, categories, IPTC, EXIF, meta, metadata, photo, photos, photograph, photographs, photoblog, photo albums
5
  Requires at least: 3.3
6
  Tested up to: 3.5
7
+ Stable tag: 1.10
8
  License: GPLv2 or later
9
  License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
 
11
+ Enhances the Media Library; powerful [mla_gallery], taxonomy support, IPTC/EXIF processing, 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 WordPress `[gallery]` shortcode; it is compatible with `[gallery]` and provides many enhancements. These include: 1) full query and display support for WordPress categories, tags, custom taxonomies and custom fields, 2) support for all post_mime_type values, not just images 3) media Library items need not be "attached" to the post, and 4) control over the styles, markup and content of each gallery using Style and Markup Templates.
18
 
19
+ * **Integrates with Photonic Gallery** (plugin), so you can add slideshows, thumbnail strips and special effects to your `[mla_gallery]` galleries.
20
+
21
+ * **Attachment metadata** such as file size, image dimensions and where-used issues can be assigned to WordPress custom fields. You can then use the custom fields in your `[mla_gallery]` display and you can add custom fields as sortable columns in the Media/Assistant submenu table.
22
+
23
+ * **IPTC** and **EXIF** metadata can be assigned to standard WordPress fields, taxonomy terms and custom fields. You can update all existing attachments from the Settings page IPTC/EXIF tab, groups of existing attachments with a Bulk Action or one existing attachment from the Edit Media/Edit Single Item screen. Display **IPTC** and **EXIF** metadata with `[mla_gallery]` custom templates.
24
 
25
  * **Enhanced Search Media box**. Search can be extended to the name/slug, ALT text and caption fields. The connector between search terms can be "and" or "or".
26
 
42
 
43
  1. Upload `media-library-assistant` and its subfolders to your `/wp-content/plugins/` directory
44
  1. Activate the plugin through the "Plugins" menu in WordPress
45
+ 1. Visit the Settings page to customize category and tag support
46
+ 1. Visit the Settings page Custom Fields and IPTC/EXIF tabs to map metadata to attachment fields
47
  1. Visit the "Assistant" submenu in the Media admin section
48
  1. Click the Screen Options link to customize the display
49
  1. Use the enhanced Edit, Quick Edit and Bulk Edit pages to assign categories and tags
51
 
52
  == Frequently Asked Questions ==
53
 
54
+ = How can I sort the Media/Assistant submenu table on values such as File Size? =
55
+
56
+ You can add support for many attachment metadata values such as file size by visiting the Custom Fields tab on the Settings page. There you can define a rule that maps the data to a WordPress custom field and check the "MLA Column" box to make that field a sortable column in the Media/Assistant submenu table. You can also use the field in your `[mla_gallery]` shortcodes.
57
+
58
  = How can I use Categories, Tags and custom taxonomies to select images for display in my posts and pages? =
59
 
60
  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.
92
 
93
  Hover over the item you want to modify and click the "Edit" action. On the Edit Single Item page, set the ID portion of the Parent Info field to zero (0), then click "Update" to record your changes. If you change your mind, click "Cancel" to return to the main page without recording any changes.
94
 
95
+ = The Media/Assistant submenu seems sluggish; is there anything I can do to make it faster? =
96
 
97
  Some of the MLA features such as where-used reporting and ALT Text sorting/searching require a lot of database procesing. If this is an issue for you, go to the Settings page and adjust the "Where-used database access tuning" settings. For any where-used category you can enable or disable processing. For the "Gallery in" and "MLA Gallery in" you can also choose to update the results on every page load or to cache the results for fifteen minutes between updates. The cache is also flushed automatically when posts, pages or attachments are inserted or updated.
98
 
106
 
107
  == Screenshots ==
108
 
109
+ 1. The Media/Assistant submenu table showing the available columns, including "Featured in", "Inserted in", "Att. Categories" and "Att. Tags"; also shows the Quick Edit area.
110
+ 2. The Media/Assistant submenu table showing the Bulk Edit area with taxonomy Add, Remove and Replace options; also shows the tags suggestion popup.
111
  3. A typical edit taxonomy page, showing the "Attachments" column.
112
  4. The enhanced Edit page showing additional fields, categories and tags.
113
  5. The Settings page General tab, where you can customize support of Att. Categories, Att. Tags and other taxonomies, where-used reporting and the default sort order.
114
  6. The Settings page MLA Gallery tab, where you can add custom style and markup templates for `[mla_gallery]` shortcode output.
115
  7. The Settings page IPTC &amp; EXIF Processing Options screen, where you can map image metadata to standard fields (e.g. caption), taxonomy terms and custom fields.
116
+ 8. The Settings page Custom Field Processing Options screen, where you can map attachment metadata to custom fields for display in [mla_gallery] shortcodes and as sortable columns in the Media/Assistant submenu.
117
 
118
  == Changelog ==
119
 
120
+ = 1.10 =
121
+ * New: Attachment metadata such as file size, dimensions and where-used status can be assigned to WordPress custom fields. These custom fields can be added to the Media/Assistant submenu table as sortable columns and displayed in `[mla_gallery]` shortcode output.
122
+ * New: Integrates with Photonic Gallery (plugin), so you can add slideshows, thumbnail strips and special effects to your `[mla_gallery]` galleries.
123
+ * Fix: Edit Media screen with appropriate message displayed after "Map ... Metadata" actions.
124
+ * Fix: SQL View (supporting ALT Text sorting/searching) now created only when required and dropped immediately after use. Avoids conflicts with database backup/restore utilities.
125
+ * Fix: "Map IPTC/EXIF Metadata" link moved from Image Metadata box to Save Metadata box.
126
+ * Fix: Field-level debug information removed from bulk edit messages.
127
+ * Fix: PHP Notice for NULL post metadata keys resolved.
128
+ * Fix: PHP Notice for images without "sizes" metadata array resolved.
129
+
130
  = 1.00 =
131
+ * New: IPTC and EXIF metadata can be assigned to standard WordPress fields, taxonomy terms and custom fields. You can update all existing attachments from the Settings page IPTC/EXIF tab, groups of existing attachments with a Bulk Action or one existing attachment from the Edit Media/Edit Single Item screen.
132
  * New: Where-used processing can be tuned or disabled on the Settings page, General tab.
133
  * New: "Gallery in" and "MLA Gallery in" results are cached for fifteen minutes, avoiding repetitive database access. The cache is automatically flushed when pages, posts or attachments are inserted or updates, and can be manually flushed or disabled on the Settings page, General tab.
134
  * New: Default `[mla_gallery]` style and markup templates can be specified on the Settings page.
135
  * New: `[mla_gallery]` parameter "mla_float" allows control of gallery item "float" attribute.
136
  * Fix: Field-level substitution parameters (custom fields, taxonomy terms, IPTC metadata and EXIF metadata) are now available for mla_link_text, mla_rollover_text and mla_caption parameters.
137
+ * Fix: Attachment/Parent relationships are reported consistently on the edit pages and the Media/Assistant submenu table.
138
  * Fix: Defect in generating mla_debug messages has been corrected.
139
  * Fix: Default "Order by" option now includes "None".
140
  * Fix: For WordPress 3.5, Custom Field support for attachments enabled in admin_init action.
141
 
142
  = 0.90 =
143
  * New: Field-level IPTC and EXIF metadata support for `[mla_gallery]` display using custom markup templates.
144
+ * New: Field-level custom field and taxonomy term support for `[mla_gallery]` display using custom markup templates.
145
  * New: Contextual help tabs added to WordPress 3.5+ Edit Media Screen, explaining MLA enhancements.
146
  * Updated for WordPress version 3.5!
147
 
156
  * New: The `[mla_gallery]` "mla_debug" parameter provides debugging information for query parameters.
157
  * New: Quick Edit area now includes caption field.
158
  * New: Settings page now divided into three tabbed subpages for easier access to settings and documentation.
159
+ * New: For WordPress 3.5, custom field support added to attachments and to the WordPress standard Edit Media Screen.
160
  * New: For WordPress version 3.5, the WordPress standard Edit Media screen now includes Last Modified date, Parent Info, Menu Order, Image Metadata and all "where-used" information.
161
  * New: For WordPress versions before 3.5, the MLA Edit Single Item screen now includes "Gallery in" and "MLA Gallery in" information.
162
  * Fix: Bulk edit now supports "No Change" option for Author.
233
 
234
  == Upgrade Notice ==
235
 
236
+ = 1.10 =
237
+ Map attachment metadata to custom fields; add them to [mla_gallery] display and as sortable columns on the Media/Assistant submenu table. Get Photonic Gallery (plugin) integration and six other fixes.
238
+
239
  = 1.00 =
240
  Map IPTC and EXIF metadata to standard fields, taxonomy terms and custom fields. Get improved performance for where-used reporting. Specify default `[mla_gallery]` style and markup templates. Five other fixes.
241
 
270
  Upgrade to support ALL taxonomies, including the standard Categories and Tags, your custom taxonomies and the Assistant's pre-defined Att. Categories and Att. Tags. Add taxonomy columns to the Assistant admin screen, filter on any taxonomy, assign terms and list the attachments for a term.
271
 
272
  = 0.20 =
273
+ Upgrade to this version to get "Quick Edit" functionality.
274
 
275
  = 0.11 =
276
  You should upgrade to this version if you are getting "404 Not Found" errors when updating single items.
280
 
281
  == Other Notes ==
282
 
283
+ In this section, scroll down to see:
284
 
285
  * Acknowledgements
286
  * MLA Gallery Shortcode Documentation
287
+ * Support for &ldquo;Photonic Gallery for Flickr, Picasa, SmugMug, 500px and Instagram&rdquo;
288
  * MLA Gallery Style and Markup Template Documentation
289
+ * Custom Field Processing Options
290
  * IPTC &amp; EXIF Processing Options
291
+ * Online Help Summary (Media/Assistant submenu, Edit Media screen, Taxonomy edit screens)
292
 
293
  == Acknowledgements ==
294
 
435
 
436
  The "mla_debug" parameter controls the display of information about the query parameters and SQL statements used to retrieve gallery items. If you code `mla_debug=true` you will see a lot of information added to the post or page containing the gallery. Of course, this parameter should <strong>only</strong> be used in a development/debugging environment; it's quite ugly.
437
 
438
+ == Support for &ldquo;Photonic Gallery for Flickr, Picasa, SmugMug, 500px and Instagram&rdquo; ==
439
+
440
+ The <a href="http://wordpress.org/extend/plugins/photonic/" title="Photonic Gallery plugin directory page" target="_blank">Photonic Gallery for Flickr, Picasa, SmugMug, 500px and Instagram</a> plugin adds several new parameters to the `[mla_gallery]` shortcode to enhance your galleries. All you have to do is install the plugin, then add a "style=" parameter to your `[mla_gallery]` shortcode to use the Photonic styling and markup in place of the native `[mla_gallery]` style and markup templates.
441
+
442
+ You can use the "Photonic" screen of the Insert Media dialog to build the display portion of your shortcode parameters. After you click "Insert into post", change the shortcode name from "gallery" to "mla_gallery" and add the query parameters you need to select the attachments for the gallery. The `[mla_gallery]` code will compile the list of attachments for your gallery, then hand control over to Photonic to format the results.
443
+
444
  == MLA Gallery Style and Markup Templates ==
445
 
446
+ The Style and Markup templates give you great flexibility for the content and format of each `[mla_gallery]`. You can define as many templates as you need.
447
 
448
  Style templates provide gallery-specific CSS inline styles. Markup templates provide the HTML markup for 1) the beginning of the gallery, 2) the beginning of each row, 3) each gallery item, 4) the end of each row and 5) the end of the gallery. The attachment-specific markup parameters let you choose among most of the attachment fields, not just the caption.
449
 
530
 
531
  There are four prefix values for field-level data. Prefix values must be coded as shown; all lowercase letters.
532
 
533
+ * `custom`: WordPress custom fields, which you can define and populate on the Edit Media screen. The field name, or key, can contain spaces and some punctuation characters. You <strong>cannot use the plus sign ('+')</strong> in a field name you want to use with `[mla_gallery]`. Custom field names are case-sensitive; "client" and "Client" are not the same.
534
  * `terms`: WordPress Category, tag or custom taxonomy terms. For this category, you code the name of the taxonomy as the field name. The term(s) associated with the attachment will be displayed in the `[mla_gallery]`. Note that you must use the name/slug string for taxonomy, not the "title" string. For example, use "attachment-category" or "attachment-tag", not "Att. Category" or "Attachment Category".
535
 
536
  * `iptc`: The IPTC (International Press Telecommunications Council) metadata, if any, embedded in the image file. For this category, you can code any of the IPTC DataSet tag and field identifiers, e.g., "2#025" for the Keywords field. You can also use the "friendly name" MLA defines for most of the IPTC fields; see the table of identifiers and friendly names in the MLA documentation. You can find more information in the <a href="http://www.iptc.org/std/IIM/4.1/specification/IIMV4.1.pdf" title="IPTC-NAA Information Interchange Model Version No. 4.1 specification" target="_blank">IPTC-NAA Information Interchange Model Version No. 4.1 specification</a>.
604
 
605
  </table>
606
 
607
+ ==Custom Field Processing Options==
608
+
609
+ On the Custom Fields tab of the Settings screen you can define the rules for mapping several types of file and image metadata to WordPress custom fields. Custom field mapping can be applied automatically when an attachment is added to the Media Library. You can refresh the mapping for <strong><em>ALL</em></strong> attachments using the command buttons on the screen. You can selectively apply the mapping in the bulk edit area of the Media/Assistant submenu table and/or on the Edit Media screen for a single attachment.
610
+
611
+ This is a powerful tool, but it comes at the price of additional database storage space processing time to maintain and retrieve the data. <strong><em>Think carefully about your needs before you use this tool.</em></strong> You can disable or delete any rules you create, so you might want to set up some rules for a special project or analysis of your library and then discard them when you're done. That said, the advantages of mapping metadata to custom fields are:
612
+
613
+ * You can add the data to an [mla_gallery] with a field-level markup substitution parameter. For example, add the image dimensions or a list of all the intermediate sizes available for the image.
614
+
615
+ * You can add the data as a sortable column to the Media/Assistant submenu table. For example, you can find all the "orphans" in your library by adding "reference_issues" and then sorting by that column.
616
+
617
+ Most of the data elements are static, i.e., they do not change after the attachment is added to the Media Library. The parent/reference information (parent_type, parent_name, parent_issues, reference_issues) is dynamic; it will change as you define galleries, insert images in posts, define featured images, etc. Because of the database processing required to update this information, <strong><em>parent and reference data are NOT automatically refreshed</em></strong>. If you use these elements, you must manually refresh them with the "map data" buttons on the Settings screen, the bulk edit area or the Edit Media screen.
618
+
619
+ Several of the data elements are sourced from the WordPress "image_meta" array. The credit, caption, copyright and title elements are taken from the IPTC/EXIF metadata (if any), but they go through a number of filtering rules that are not easy to replicate with the MLA IPTC/EXIF processing rules. You may find these "image_meta" elements more useful than the raw IPTC/EXIF metadata.
620
+
621
+ <h4>Data sources for custom field mapping</h4>
622
+
623
+ <strong>NOTE:</strong> Sorting by custom fields in the Media/Assistant submenu is by string values. For numeric data this can cause odd-looking results, e.g., dimensions of "1200x768" will sort before "640x480". The "file_size", "pixels", "width" and "height" data sources are converted to srtings and padded on the left with spaces if you use the "commas" format. This padding makes them sort more sensibly.
624
+
625
+ * `path`: path portion of the base_file value, e.g., 2012/11/
626
+ * `file_name`: file name portion of the base_file value, e.g., image.jpg
627
+ * `extension`: extension portion of the base_file value, e.g., jpg
628
+ * `file_size`: file size in bytes
629
+ * `dimensions`: for image types, width x height, e.g., 1024x768
630
+ * `pixels`: for image types, size in pixels, e.g., 307200 for a 640x480 image
631
+ * `width`: for image types, width in pixels
632
+ * `height`: for image types, height in pixels
633
+ * `hwstring_small`: HTML dimensions of a "small" image, i.e., 128 or less width, 96 or less height. Not computed for images uploaded in WordPress 3.5 and later.
634
+ * `size_keys`: image size names for thumbnail versions of the image, e.g., "thumbnail, medium, large"
635
+ * `size_names`: image file names for thumbnail versions of the image, e.g., "image-150x150.jpg, image-300x225.jpg, image-600x288.jpg"
636
+ * `size_bytes`: file size in bytes for thumbnail versions of the image, e.g., "5127, 11829, 33968"
637
+ * `size_pixels`: image size in pixels for thumbnail versions of the image, e.g., "22500, 67500, 172800"
638
+ * `size_dimensions`: image dimensions for thumbnail versions of the image, e.g., "150x150, 300x225, 600x288"
639
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">size_name[size]`: image file name for a specific thumbnail version, e.g., size_name[medium] = image-300x225.jpg; set to empty string if the specified size does not exist. There will be a [size] choice for every thumbnail version registered with WordPress for the site.
640
+ * `size_bytes[size]`: file size in bytes for a specific thumbnail version, e.g., size_bytes[medium] = "11829"
641
+ * `size_pixels[size]`: image size in pixels for a specific thumbnail version, e.g., size_pixels[medium] = "67500"
642
+ <tr>
643
+ <tr>
644
+ <td style="width: 12em; padding-right: 10px; vertical-align: top; font-weight:bold">size_dimensions[size]`: image dimensions for a specific thumbnail version, e.g., size_dimensions[medium] = 300x225; set to empty string if the specified size does not exist. There will be a [size] choice for every thumbnail version registered with WordPress for the site.
645
+ * `parent_type`: for "attached" (post_parent not zero) objects, post type of the parent object
646
+ <tr>
647
+ * `parent_name`: for "attached" (post_parent not zero) objects, post title of the parent object
648
+ <tr>
649
+ * `parent_issues`: summary of parent status (only) "issues", e.g., bad parent, invalid parent, unattached
650
+ * `reference_issues`: summary of all reference and parent status "issues", e.g., orphan, bad parent, invalid parent, unattached
651
+ * `aperture`: for image types, the value stored in WordPress "image_meta" array
652
+ * `credit`: for image types, the value stored in WordPress "image_meta" array
653
+ * `camera`: for image types, the value stored in WordPress "image_meta" array
654
+ * `caption`: for image types, the value stored in WordPress "image_meta" array
655
+ * `created_timestamp`: for image types, the value stored in WordPress "image_meta" array
656
+ * `copyright`: for image types, the value stored in WordPress "image_meta" array
657
+ * `focal_length`: for image types, the value stored in WordPress "image_meta" array
658
+ * `iso`: for image types, the value stored in WordPress "image_meta" array
659
+ * `shutter_speed`: for image types, the value stored in WordPress "image_meta" array
660
+ * `title`: for image types, the value stored in WordPress "image_meta" array
661
+
662
+ ==IPTC &amp; EXIF Processing Options==
663
 
664
  Some image file formats such as JPEG DCT or TIFF Rev 6.0 support the addition of data about the image, or <em>metadata</em>, in the image file. Many popular image processing programs such as Adobe PhotoShop allow you to populate metadata fields with information such as a copyright notice, caption, the image author and keywords that categorize the image in a larger collection. WordPress uses some of this information to populate the Title, Slug and Description fields when you add an image to the Media Library.
665
 
667
 
668
  * the WordPress standard fields, e.g., the Caption
669
  * taxonomy terms, e.g., in categories, tags or custom taxonomies
670
+ * WordPress custom fields
671
 
672
  You can define the rules for mapping metadata on the "IPTC/EXIF" tab of the Settings page. You can choose to automatically apply the rules when new media are added to the Library (or not). You can click the "Map IPTC/EXIF metadata" button on the Edit Media/Edit Single Item screen or in the bulk edit area to selectivelly apply the rules to one or more images. You can click the "Map All Attachments Now" to apply the rules to <strong>all of the images in your library</strong> at one time.
673
 
675
 
676
  The three mapping tables on the IPTC/EXIF tab have the following columns:
677
 
678
+ * `Field Title`: The standard field title, taxonomy name or custom field name. In the Custom Field table you can define a new field by entering its name in the blank box at the bottom of the list; the value will be saved when you click "Save Changes" at the bottom of the screen.
679
 
680
  * `IPTC Value`: The IPTC (International Press Telecommunications Council) metadata, if any, embedded in the image file. For this category, you can select any of the IPTC DataSet tag and field identifiers, e.g., "2#025" for the Keywords field. The dropdown list has the identifier and the "friendly name" MLA defines for most of the IPTC fields; see the table of identifiers and friendly names in the table below. You can find more information in the <a href="http://www.iptc.org/std/IIM/4.1/specification/IIMV4.1.pdf" title="IPTC-NAA Information Interchange Model Version No. 4.1 specification" target="_blank">IPTC-NAA Information Interchange Model Version No. 4.1 specification</a>.
681
 
721
 
722
  == Online Help Summary ==
723
 
724
+ <p><strong><em>Media/Assistant Submenu Table</em></strong></p>
725
  <h4>Overview</h4>
726
+ <p>All the files you&#8217;ve uploaded are listed in the Media/Assistant submenu 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>
727
  <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>
728
  <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>
729
  <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>
733
  <p>You can also use the information in the &#8220;Title/Name&#8221; column to identify &#8220;Orphan&#8221; items that are not used in any post or page and items with a &#8220;Bad Parent&#8221; (a parent that does contain any reference to the item) or an &#8220;Invalid Parent&#8221; (a parent that does not exist).</p>
734
  <p>If performance is a concern, you can go to the Settings page and disable either or both of these columns.</p>
735
  <h4>Gallery/MLA Gallery</h4>
736
+ <p>The &#8220;Gallery in&#8221; and &#8220;MLA Gallery in&#8221; columns are a powerful tool for managing your attachments. They show you where each attachment is returned by a `[gallery]` or `[mla_gallery]` shortcode in a post or page. These columns do <strong>not</strong> use the post_parent (attached to) status of the item; they actually execute each shortcode and tabulate the attachments they return.</p>
737
  <p>You can also use the information in the &#8220;Title/Name&#8221; column to identify &#8220;Orphan&#8221; items that are not used in any post or page and items with a &#8220;Bad Parent&#8221; (a parent that does contain any reference to the item) or an &#8220;Invalid Parent&#8221; (a parent that does not exist).</p>
738
  <p>If performance is a concern, you can go to the Settings page and disable either or both of these columns. You can also adjust the settings to cache the results for fifteen minutes between updates. Results are automatically updated after a post, page or attachment is added or updated.</p>
739
  <h4>Taxonomy Support</h4>
741
  <p>The Media Library Assistant provides two pre-defined taxonomies, &#8220;Att. Categories&#8221; and &#8220;Att. Tags&#8221; which are enabled by default. You can add or remove support for any registered taxonomy on the Settings screen. The standard WordPress Categories and Tags as well as any custom taxonomies can be supported.</p>
742
  <p>When you add support for a taxonomy it is visible on the main screen. If you want to hide the column simply use the Screen Options to uncheck the Show on screen box.</p>
743
  <p>Supported taxonomies also appear as submenus below the Media menu at the left of the screen. You can edit the taxonomy terms by clicking these submenus. The taxonomy edit screens include an &#8220;Attachments&#8221; column which displays the number of attachment objects for each term. You can display a filtered list of the attachments by clicking on the number in this column.</p>
744
+ <h4>Custom Fields</h4>
745
+ <p>You can add sortable columns to the Media/Assistant submenu table by visiting the Custom Fields tab on the Settings page. There you define rules that map attachment metadata such as file size to WordPress custom fields. The &#8220;MLA Column&#8221; checkbox for each rule lets you select which rules will appear on this screen.</p>
746
  <h4>Search Media</h4>
747
  <p>The &#8220;Search Media&#8221; box supports a keyword search of several attachment fields; enter words and/or phrases in the box, separated by spaces. Click the Search Media button for a case-insensitive "SQL LIKE" search. Each keyword in the search phrase is matched independently, so the order of search words does not have to match the order in the text. For example, searching on "friend" and "best" will match "Best Friend". If you put quotes around a search phrase then word order is required for a match (and spaces between words must match as well). You can also match on partial words, e.g., "rien" will match "friend".</p>
748
  <p>Once you&#8217;ve entered the terms you want, use the options below the box to tailor your search. You can pick the connector used between search terms; "or" means any of the terms will match, "and" means all of the terms must match. Use the checkboxes to extend your search to more fields in the database.</p>
763
  WordPress 3.5 introduced a much-improved Edit Media screen. Media Library Assistant incorporates and adds several enhancements to the new screen:
764
 
765
  * Displays Last Modified date and time
766
+ * Supports mapping of Custom Field and ITPC/EXIF metadata for this attachment
767
+ * Supports custom fields, which `[mla_gallery]` can use for query and display
768
  * Supports Parent Info and Menu Order
769
  * Displays Image Metadata
770
  * Displays where-used information; Featured in, Inserted in, Gallery in and MLA Gallery in
778
  <h4>Parent Info</h4>
779
  <p>The &#8220;Parent Info&#8221; field displays the Post ID, type and title of the post or page to which the item is attached. It will display &#8220;0 (unattached)&#8221; if there is no parent post or page.</p>
780
  <p>You can change the post or page to which the item is attached by changing the Post ID value and clicking the &#8220;Update&#8221; button. Changing the Post ID value to zero (0) will &#8220;unattach&#8221; the item.</p>
781
+ <h4>Metadata Mapping</h4>
782
+ <p>The &#8220;Map Custom Field Metadata&#8221; and &#8220;Map IPTC/EXIF Metadata&#8221; links let you create or update attachment values by applying the rules you define on the Media Library Assistant Settings page. The links are located in the &#8220;Save&#8221; metabox in the upper-right part of the screen, just below the Last Modified date and time.</p>
783
+ <p>When you click on one of the two links, all of the mapping rules for that type of metadata will be applied to the attachment you are editing. The updates are immediate; you do not need to click the &#8220;Update&#8221; button to make them permanent.</p>
784
  <p><strong><em>Edit Hierarchical Taxonomies (Categories)</em></strong></p>
785
  <h4>Overview</h4>
786
  <p>You can use <strong>categories</strong> to define sections of your site and group related attachments. The default is &#8220;none&#8221;, i.e., the attachment is not associated with any category.</p>
tpls/admin-display-settings-page.tpl CHANGED
@@ -201,6 +201,41 @@
201
  [+_wp_http_referer+]
202
  </form>
203
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
204
  <!-- template="iptc-exif-tab" -->
205
  <h3>IPTC &amp; EXIF Processing Options</h3>
206
  <p>In this tab you can define the rules for mapping IPTC (International Press Telecommunications Council) and EXIF (EXchangeable Image File) metadata to WordPress standard attachment fields, taxonomy terms and custom fields. <strong>NOTE:</strong> settings changes will not be made permanent until you click "Save Changes" at the bottom of this page.</p>
201
  [+_wp_http_referer+]
202
  </form>
203
 
204
+ <!-- template="custom-field-tab" -->
205
+ <h3>Custom Field Processing Options</h3>
206
+ <p>
207
+ In this tab you can define the rules for mapping several types of image metadata to WordPress custom fields. <strong>NOTE:</strong> changes to a single rule will be made permanent if you click the "Update Rule" button for that rule. The rule will be applied to existing attachments if you click the "Map All Attachments" button for that rule.
208
+ </p>
209
+ <p>
210
+ Custom field mapping can be applied automatically when an attachment is added to the Media Library. You can refresh the mapping for <strong><em>ALL</em></strong> attachments using the command buttons on this screen. You can selectively apply the mapping in the bulk edit area of the Media/Assistant screen and/or on the Media/Edit Media screen for a single attachment.
211
+ </p>
212
+ <p>
213
+ If you click any of the "Map All Attachments" buttons, the rule currently displayed for that field will be immediately applied to <strong><em>ALL</em></strong> of the attachments in your site. Rule changes are <strong><em>NOT</em></strong> saved when you click any of these buttons, and <strong><em>THERE IS NO UNDO FOR THESE ACTIONS!</em></strong>
214
+ </p>
215
+ <p>
216
+ You can find more information about all of these topics on the <a href="http:/wp-admin/options-general.php?page=mla-settings-menu&amp;mla_tab=documentation#mla_custom_field_mapping" title="Custom Field Processing Options documentation">Documentation tab</a>.
217
+ </p>
218
+ <p>
219
+ <strong>NOTE:</strong> Check the box in the "MLA Column" column to make the field a sortable column in the Media/Assistant submenu table. The "file_size", "pixels", "width" and "height" data sources will sort more sensibly if you use the "Commas" format.
220
+ </p>
221
+ <form method="post" class="mla-display-settings-page" id="mla-display-settings-custom-field-tab">
222
+ &nbsp;<br />
223
+ [+options_list+]
224
+ <h4>Custom field mapping</h4>
225
+ <table class="optiontable">
226
+ [+custom_options_list+]
227
+ </table>
228
+ <p class="submit" style="padding-bottom: 0;">
229
+ <input name="custom-field-options-save" type="submit" class="button-primary" value="Save Changes" />
230
+ <input name="custom-field-options-map" type="submit" class="button-secondary" style="margin-left: 20px" value="Map All Rules, All Attachments Now" />
231
+ </p>
232
+ <p>
233
+ Click Save Changes to update the "Enable custom field mapping..." checkbox and/or all rule changes and additions at once.<br />
234
+ Click Map All Rules, All Attachments Now to apply all the rules at once (rule changes will be applied but not saved).
235
+ [+_wpnonce+]
236
+ [+_wp_http_referer+]
237
+ </form>
238
+
239
  <!-- template="iptc-exif-tab" -->
240
  <h3>IPTC &amp; EXIF Processing Options</h3>
241
  <p>In this tab you can define the rules for mapping IPTC (International Press Telecommunications Council) and EXIF (EXchangeable Image File) metadata to WordPress standard attachment fields, taxonomy terms and custom fields. <strong>NOTE:</strong> settings changes will not be made permanent until you click "Save Changes" at the bottom of this page.</p>
tpls/admin-inline-edit-form.tpl CHANGED
@@ -91,7 +91,8 @@
91
  <p class="submit inline-edit-save">
92
  <a accesskey="c" href="#inline-edit" title="Cancel" class="button-secondary cancel alignleft">Cancel</a>
93
  <input accesskey="s" type="submit" name="bulk_edit" id="bulk_edit" class="button-primary alignright" value="Update" />
94
- <input accesskey="m" type="submit" name="bulk_map" id="bulk_map" class="button-secondary alignright" value="Map IPTC/EXIF metadata" />
 
95
  <input type="hidden" name="page" value="mla-menu" />
96
  <input type="hidden" name="screen" value="media_page_mla-menu" />
97
  <span class="error" style="display:none"></span> <br class="clear" />
91
  <p class="submit inline-edit-save">
92
  <a accesskey="c" href="#inline-edit" title="Cancel" class="button-secondary cancel alignleft">Cancel</a>
93
  <input accesskey="s" type="submit" name="bulk_edit" id="bulk_edit" class="button-primary alignright" value="Update" />
94
+ <input accesskey="i" type="submit" name="bulk_map" id="bulk_map" class="button-secondary alignright" value="Map IPTC/EXIF metadata" style="margin-right: 1em" />
95
+ <input accesskey="m" type="submit" name="bulk_custom_field_map" id="bulk_custom_field_map" class="button-secondary alignright" value="Map Custom Field metadata" style="margin-right: 1em" />
96
  <input type="hidden" name="page" value="mla-menu" />
97
  <input type="hidden" name="screen" value="media_page_mla-menu" />
98
  <span class="error" style="display:none"></span> <br class="clear" />
tpls/documentation-settings-tab.tpl CHANGED
@@ -1,11 +1,14 @@
1
  <!-- template="documentation-tab" -->
2
- <div class="mla-display-settings-page" id="mla-display-settings-documentation-tab">
3
  <h3>In this tab, jump to:</h3>
4
  <ul style="list-style-position:inside; list-style:disc; line-height: 18px">
5
  <li>
6
  <a href="#mla_gallery"><strong>MLA Gallery Shortcode</strong></a>
7
  </li>
8
  <li>
 
 
 
9
  <a href="#mla_gallery_templates"><strong>Style and Markup Templates</strong></a>
10
  </li>
11
  <li>
@@ -24,6 +27,12 @@
24
  <a href="#mla_table_example"><strong>A table-based template example</strong></a>
25
  </li>
26
  <li>
 
 
 
 
 
 
27
  <a href="#mla_iptc_exif_mapping"><strong>IPTC &amp; EXIF Processing Options</strong></a>
28
  </li>
29
  <li>
@@ -40,7 +49,6 @@ have a look at the <a title="Consult the phpDocs documentation" href="[+phpDocs_
40
  <p>
41
  <a href="#backtotop">Go to Top</a>
42
  </p>
43
- <div class="mla_gallery_help" style="width:700px">
44
  <h3>MLA Gallery Shortcode</h3>
45
  <p>
46
  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:
@@ -77,7 +85,6 @@ Three [mla_gallery] parameters provide control over the placement, size and spac
77
  <td>specifies the float attribute of the ".gallery-item" style. Acceptable values are "left", "none", "right"; the default value is "right" if current locale is RTL, "left" on LTR (left-to-right inline flow, e.g., English).</td>
78
  </tr>
79
  <tr>
80
- <tr>
81
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_margin</td>
82
  <td>specifies the margin attribute (in percent) of the ".gallery-item" style. The default value is "1.5" percent.</td>
83
  </tr>
@@ -219,17 +226,28 @@ The search parameter ("s=keyword") will perform a keyword search. A cursory insp
219
  </p>
220
  <h4>Debugging Output</h4>
221
  <p>
222
- The "mla_debug" parameter controls the display of information about the query parameters and SQL statements used to retrieve gallery items. If you code `mla_debug=true` you will see a lot of information added to the post or page containing the gallery. Of course, this parameter should <strong>only</strong> be used in a development/debugging environment; it's quite ugly.
 
 
 
 
 
 
 
 
 
 
 
 
223
  </p>
224
  <a name="mla_gallery_templates"></a>
225
  &nbsp;
226
  <p>
227
  <a href="#backtotop">Go to Top</a>
228
  </p>
229
- <div class="mla_gallery_help" style="width:700px">
230
  <h3>MLA Gallery Style and Markup Templates</h3>
231
  <p>
232
- The Style and Markup templates give you great flexibility for the content and format of each <code>[mla_gallery]</code>. You can define as many templates as you need.
233
  </p>
234
  <p>
235
  Style templates provide gallery-specific CSS inline styles. Markup templates provide the HTML markup for 1) the beginning of the gallery, 2) the beginning of each row, 3) each gallery item, 4) the end of each row and 5) the end of the gallery. The attachment-specific markup parameters let you choose among most of the attachment fields, not just the caption.
@@ -540,11 +558,11 @@ There are four prefix values for field-level data. Prefix values must be coded a
540
  <table>
541
  <tr>
542
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">custom</td>
543
- <td>WordPress Custom Fields, which you can define and populate on the Edit Media screen. The field name, or key, can contain spaces and some punctuation characters. You <strong>cannot use the plus sign ('+')</strong> in a field name you want to use with <code>[mla_gallery]</code>. Custom field names are case-sensitive; "client" and "Client" are not the same.</td>
544
  </tr>
545
  <tr>
546
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">terms</td>
547
- <td>WordPress Category, tag or custom taxonomy terms. For this category, you code the name of the taxonomy as the field name. The term(s) associated with the attachment will be displayed in the <code>[mla_gallery]</code>. Note that you must use the name/slug string for taxonomy, not the "title" string. For example, use "attachment-category" or "attachment-tag", not "Att. Category" or "Attachment Category".</td>
548
  </tr>
549
  <tr>
550
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">iptc</td>
@@ -637,6 +655,170 @@ The Item markup section shows how to use the "terms", "custom", "iptc" and "exif
637
  <td><code>&lt;/table&gt;</code></td>
638
  </tr>
639
  </table>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
640
  <a name="mla_iptc_exif_mapping"></a>
641
  &nbsp;
642
  <p>
@@ -653,7 +835,7 @@ The Media Library Assistant has powerful tools for copying image metadata to:
653
  <li>taxonomy terms, e.g., in categories, tags or custom taxonomies</li>
654
  <li>WordPress Custom Fields</li>
655
  </ul>
656
- You can define the rules for mapping metadata on the "IPTC/EXIF" tab of the Settings page. You can choose to automatically apply the rules when new media are added to the Library (or not). You can click the "Map IPTC/EXIF metadata" button on the Edit Media/Edit Single Item screen or in the bulk edit area to selectivelly apply the rules to one or more images. You can click the "Map All Attachments Now" to apply the rules to <strong>all of the images in your library</strong> at one time.
657
  </p>
658
  <h4>Mapping tables</h4>
659
  <p>
@@ -681,11 +863,11 @@ The three mapping tables on the IPTC/EXIF tab have the following columns:
681
  </dl>
682
  <h4>Map All Attachments Now</h4>
683
  <p>
684
- To the right of each table heading is a "Map All Attachments Now" button. When you click one of these buttons, the mapping rules in that table are applied to <strong>all of the images in the Media Library.</strong> This is a great way to bring your media items up to date, but it is <strong>not reversible</strong>, so think carefully before you click!
685
  Each button applies the rules in just one category, so you can update taxonomy terms without disturbing standard or custom field values.
686
  </p>
687
  <p>
688
- These buttons <strong>do not</strong> save any rules changes you've made, so you can make a temporary rule change and process your attachments without disturbing the standing rules.
689
  </p>
690
  <h4>Other mapping techniques</h4>
691
  <p>
@@ -697,6 +879,7 @@ There are two other ways you can perform metadata mapping to one or more existin
697
  <dt>Bulk Action edit area</dt>
698
  <dd>To perform mapping for a group of attachments you can use the Bulk Action facility on the main Assistant screen. Check the attachments you want to map, select "edit" from the Bulk Actions dropdown list and click "Apply". The bulk edit area will open with a list of the checked attachments in the left-hand column. You can click the "Map IPTC/EXIF metadata" button in the lower left corner of the area to apply the standing mapping rules to the attachments in the list.
699
  </dd>
 
700
  </p>
701
  <h4>WordPress default title, slug and description mapping</h4>
702
  <p>
1
  <!-- template="documentation-tab" -->
2
+ <div class="mla-display-settings-page" id="mla-display-settings-documentation-tab" style="width:700px">
3
  <h3>In this tab, jump to:</h3>
4
  <ul style="list-style-position:inside; list-style:disc; line-height: 18px">
5
  <li>
6
  <a href="#mla_gallery"><strong>MLA Gallery Shortcode</strong></a>
7
  </li>
8
  <li>
9
+ <a href="#photonic_gallery"><strong>Support for &#8220;Photonic Gallery&#8221;</strong></a>
10
+ </li>
11
+ <li>
12
  <a href="#mla_gallery_templates"><strong>Style and Markup Templates</strong></a>
13
  </li>
14
  <li>
27
  <a href="#mla_table_example"><strong>A table-based template example</strong></a>
28
  </li>
29
  <li>
30
+ <a href="#mla_custom_field_mapping"><strong>Custom Field Processing Options</strong></a>
31
+ </li>
32
+ <li>
33
+ <a href="#mla_custom_field_parameters"><strong>Data sources for custom field mapping</strong></a>
34
+ </li>
35
+ <li>
36
  <a href="#mla_iptc_exif_mapping"><strong>IPTC &amp; EXIF Processing Options</strong></a>
37
  </li>
38
  <li>
49
  <p>
50
  <a href="#backtotop">Go to Top</a>
51
  </p>
 
52
  <h3>MLA Gallery Shortcode</h3>
53
  <p>
54
  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:
85
  <td>specifies the float attribute of the ".gallery-item" style. Acceptable values are "left", "none", "right"; the default value is "right" if current locale is RTL, "left" on LTR (left-to-right inline flow, e.g., English).</td>
86
  </tr>
87
  <tr>
 
88
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_margin</td>
89
  <td>specifies the margin attribute (in percent) of the ".gallery-item" style. The default value is "1.5" percent.</td>
90
  </tr>
226
  </p>
227
  <h4>Debugging Output</h4>
228
  <p>
229
+ The "mla_debug" parameter controls the display of information about the query parameters and SQL statements used to retrieve gallery items. If you code `mla_debug=true` you will see a lot of information added to the post or page containing the gallery. Of course, this parameter should <strong><em>ONLY</em></strong> be used in a development/debugging environment; it's quite ugly.
230
+ </p>
231
+ <a name="photonic_gallery"></a>
232
+ &nbsp;
233
+ <p>
234
+ <a href="#backtotop">Go to Top</a>
235
+ </p>
236
+ <h3>Support for &#8220;Photonic Gallery for Flickr, Picasa, SmugMug, 500px and Instagram&#8221;</h3>
237
+ <p>
238
+ The <a href="http://wordpress.org/extend/plugins/photonic/" title="Photonic Gallery plugin directory page" target="_blank">Photonic Gallery for Flickr, Picasa, SmugMug, 500px and Instagram</a> plugin adds several new parameters to the [mla_gallery] shortcode to enhance your galleries. All you have to do is install the plugin, then add a "style=" parameter to your [mla_gallery] shortcode to use the Photonic styling and markup in place of the native [mla_gallery] style and markup templates.
239
+ </p>
240
+ <p>
241
+ You can use the "Photonic" screen of the Insert Media dialog to build the display portion of your shortcode parameters. After you click "Insert into post", change the shortcode name from "gallery" to "mla_gallery" and add the query parameters you need to select the attachments for the gallery. The [mla_gallery] code will compile the list of attachments for your gallery, then hand control over to Photonic to format the results.
242
  </p>
243
  <a name="mla_gallery_templates"></a>
244
  &nbsp;
245
  <p>
246
  <a href="#backtotop">Go to Top</a>
247
  </p>
 
248
  <h3>MLA Gallery Style and Markup Templates</h3>
249
  <p>
250
+ The Style and Markup templates give you great flexibility for the content and format of each [mla_gallery]. You can define as many templates as you need.
251
  </p>
252
  <p>
253
  Style templates provide gallery-specific CSS inline styles. Markup templates provide the HTML markup for 1) the beginning of the gallery, 2) the beginning of each row, 3) each gallery item, 4) the end of each row and 5) the end of the gallery. The attachment-specific markup parameters let you choose among most of the attachment fields, not just the caption.
558
  <table>
559
  <tr>
560
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">custom</td>
561
+ <td>WordPress Custom Fields, which you can define and populate on the Edit Media screen. The field name, or key, can contain spaces and some punctuation characters. You <strong><em>cannot use the plus sign ('+')</em></strong> in a field name you want to use with [mla_gallery]. Custom field names are case-sensitive; "client" and "Client" are not the same.</td>
562
  </tr>
563
  <tr>
564
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">terms</td>
565
+ <td>WordPress Category, tag or custom taxonomy terms. For this category, you code the name of the taxonomy as the field name. The term(s) associated with the attachment will be displayed in the [mla_gallery]. Note that you must use the name/slug string for taxonomy, not the "title" string. For example, use "attachment-category" or "attachment-tag", not "Att. Category" or "Attachment Category".</td>
566
  </tr>
567
  <tr>
568
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">iptc</td>
655
  <td><code>&lt;/table&gt;</code></td>
656
  </tr>
657
  </table>
658
+ <a name="mla_custom_field_mapping"></a>
659
+ &nbsp;
660
+ <p>
661
+ <a href="#backtotop">Go to Top</a>
662
+ </p>
663
+ <h3>Custom Field Processing Options</h3>
664
+ <p>
665
+ On the Custom Fields tab of the Settings screen you can define the rules for mapping several types of file and image metadata to WordPress custom fields. Custom field mapping can be applied automatically when an attachment is added to the Media Library. You can refresh the mapping for <strong><em>ALL</em></strong> attachments using the command buttons on the screen. You can selectively apply the mapping in the bulk edit area of the Media/Assistant submenu table and/or on the Edit Media screen for a single attachment.
666
+ </p>
667
+ <p>
668
+ This is a powerful tool, but it comes at the price of additional database storage space processing time to maintain and retrieve the data. <strong><em>Think carefully about your needs before you use this tool.</em></strong> You can disable or delete any rules you create, so you might want to set up some rules for a special project or analysis of your library and then discard them when you're done. That said, the advantages of mapping metadata to custom fields are:
669
+ </p>
670
+ <ul class="mla_settings">
671
+ <li>You can add the data to an [mla_gallery] with a field-level markup substitution parameter. For example, add the image dimensions or a list of all the intermediate sizes available for the image.</li>
672
+ <li>You can add the data as a sortable column to the Media/Assistant submenu table. For example, you can find all the "orphans" in your library by adding "reference_issues" and then sorting by that column.</li>
673
+ </ul>
674
+ <p>
675
+ Most of the data elements are static, i.e., they do not change after the attachment is added to the Media Library.
676
+ The parent/reference information (parent_type, parent_name, parent_issues, reference_issues) is dynamic; it will change as you define galleries, insert images in posts, define featured images, etc. Because of the database processing required to update this information, <strong><em>parent and reference data are NOT automatically refreshed</em></strong>. If you use these elements, you must manually refresh them with the "map data" buttons on the Settings screen, the bulk edit area or the Edit Media screen.
677
+ </p>
678
+ <p>
679
+ Several of the data elements are sourced from the WordPress "image_meta" array. The credit, caption, copyright and title elements are taken from the IPTC/EXIF metadata (if any), but they go through a number of filtering rules that are not easy to replicate with the MLA IPTC/EXIF processing rules. You may find these "image_meta" elements more useful than the raw IPTC/EXIF metadata.
680
+ </p>
681
+ <a name="mla_custom_field_parameters"></a>
682
+ &nbsp;
683
+ <p>
684
+ <a href="#backtotop">Go to Top</a>
685
+ </p>
686
+ <h4>Data sources for custom field mapping</h4>
687
+ <p>
688
+ <strong>NOTE:</strong> Sorting by custom fields in the Media/Assistant submenu is by string values. For numeric data this can cause odd-looking results, e.g., dimensions of "1200x768" will sort before "640x480". The "file_size", "pixels", "width" and "height" data sources are converted to srtings and padded on the left with spaces if you use the "commas" format. This padding makes them sort more sensibly.
689
+ </p>
690
+ <table>
691
+ <tr>
692
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">path</td>
693
+ <td>path portion of the base_file value, e.g., 2012/11/</td>
694
+ </tr>
695
+ <tr>
696
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">file_name</td>
697
+ <td>file name portion of the base_file value, e.g., image.jpg</td>
698
+ </tr>
699
+ <tr>
700
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">extension</td>
701
+ <td>extension portion of the base_file value, e.g., jpg</td>
702
+ </tr>
703
+ <tr>
704
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">file_size</td>
705
+ <td>file size in bytes</td>
706
+ </tr>
707
+ <tr>
708
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">dimensions</td>
709
+ <td>for image types, width x height, e.g., 1024x768</td>
710
+ </tr>
711
+ <tr>
712
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">pixels</td>
713
+ <td>for image types, size in pixels, e.g., 307200 for a 640x480 image</td>
714
+ </tr>
715
+ <tr>
716
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">width</td>
717
+ <td>for image types, width in pixels</td>
718
+ </tr>
719
+ <tr>
720
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">height</td>
721
+ <td>for image types, height in pixels</td>
722
+ </tr>
723
+ <tr>
724
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">hwstring_small</td>
725
+ <td>HTML dimensions of a "small" image, i.e., 128 or less width, 96 or less height. Not computed for images uploaded in WordPress 3.5 and later.</td>
726
+ </tr>
727
+ <tr>
728
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">size_keys</td>
729
+ <td>image size names for thumbnail versions of the image, e.g., "thumbnail, medium, large"</td>
730
+ </tr>
731
+ <tr>
732
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">size_names</td>
733
+ <td>image file names for thumbnail versions of the image, e.g., "image-150x150.jpg, image-300x225.jpg, image-600x288.jpg"</td>
734
+ </tr>
735
+ <tr>
736
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">size_bytes</td>
737
+ <td>file size in bytes for thumbnail versions of the image, e.g., "5127, 11829, 33968"</td>
738
+ </tr>
739
+ <tr>
740
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">size_pixels</td>
741
+ <td>image size in pixels for thumbnail versions of the image, e.g., "22500, 67500, 172800"</td>
742
+ </tr>
743
+ <tr>
744
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">size_dimensions</td>
745
+ <td>image dimensions for thumbnail versions of the image, e.g., "150x150, 300x225, 600x288"</td>
746
+ </tr>
747
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">size_name[size]</td>
748
+ <td>image file name for a specific thumbnail version, e.g., size_name[medium] = image-300x225.jpg; set to empty string if the specified size does not exist. There will be a [size] choice for every thumbnail version registered with WordPress for the site.</td>
749
+ </tr>
750
+ <tr>
751
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">size_bytes[size]</td>
752
+ <td>file size in bytes for a specific thumbnail version, e.g., size_bytes[medium] = "11829"</td>
753
+ </tr>
754
+ <tr>
755
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">size_pixels[size]</td>
756
+ <td>image size in pixels for a specific thumbnail version, e.g., size_pixels[medium] = "67500"</td>
757
+ </tr>
758
+ <tr>
759
+ <tr>
760
+ <td style="width: 12em; padding-right: 10px; vertical-align: top; font-weight:bold">size_dimensions[size]</td>
761
+ <td>image dimensions for a specific thumbnail version, e.g., size_dimensions[medium] = 300x225; set to empty string if the specified size does not exist. There will be a [size] choice for every thumbnail version registered with WordPress for the site.</td>
762
+ </tr>
763
+ <tr>
764
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">parent_type</td>
765
+ <td>for "attached" (post_parent not zero) objects, post type of the parent object</td>
766
+ </tr>
767
+ <tr>
768
+ <tr>
769
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">parent_name</td>
770
+ <td>for "attached" (post_parent not zero) objects, post title of the parent object</td>
771
+ </tr>
772
+ <tr>
773
+ <tr>
774
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">parent_issues</td>
775
+ <td>summary of parent status (only) "issues", e.g., bad parent, invalid parent, unattached</td>
776
+ </tr>
777
+ <tr>
778
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">reference_issues</td>
779
+ <td>summary of all reference and parent status "issues", e.g., orphan, bad parent, invalid parent, unattached</td>
780
+ </tr>
781
+ <tr>
782
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">aperture</td>
783
+ <td>for image types, the value stored in WordPress "image_meta" array</td>
784
+ </tr>
785
+ <tr>
786
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">credit</td>
787
+ <td>for image types, the value stored in WordPress "image_meta" array</td>
788
+ </tr>
789
+ <tr>
790
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">camera</td>
791
+ <td>for image types, the value stored in WordPress "image_meta" array</td>
792
+ </tr>
793
+ <tr>
794
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">caption</td>
795
+ <td>for image types, the value stored in WordPress "image_meta" array</td>
796
+ </tr>
797
+ <tr>
798
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">created_timestamp</td>
799
+ <td>for image types, the value stored in WordPress "image_meta" array</td>
800
+ </tr>
801
+ <tr>
802
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">copyright</td>
803
+ <td>for image types, the value stored in WordPress "image_meta" array</td>
804
+ </tr>
805
+ <tr>
806
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">focal_length</td>
807
+ <td>for image types, the value stored in WordPress "image_meta" array</td>
808
+ </tr>
809
+ <tr>
810
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">iso</td>
811
+ <td>for image types, the value stored in WordPress "image_meta" array</td>
812
+ </tr>
813
+ <tr>
814
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">shutter_speed</td>
815
+ <td>for image types, the value stored in WordPress "image_meta" array</td>
816
+ </tr>
817
+ <tr>
818
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">title</td>
819
+ <td>for image types, the value stored in WordPress "image_meta" array</td>
820
+ </tr>
821
+ </table>
822
  <a name="mla_iptc_exif_mapping"></a>
823
  &nbsp;
824
  <p>
835
  <li>taxonomy terms, e.g., in categories, tags or custom taxonomies</li>
836
  <li>WordPress Custom Fields</li>
837
  </ul>
838
+ You can define the rules for mapping metadata on the "IPTC/EXIF" tab of the Settings page. You can choose to automatically apply the rules when new media are added to the Library (or not). You can click the "Map IPTC/EXIF metadata" button on the Edit Media/Edit Single Item screen or in the bulk edit area to selectivelly apply the rules to one or more images. You can click the "Map All Attachments Now" to apply the rules to <strong><em>ALL of the images in your library</em></strong> at one time.
839
  </p>
840
  <h4>Mapping tables</h4>
841
  <p>
863
  </dl>
864
  <h4>Map All Attachments Now</h4>
865
  <p>
866
+ To the right of each table heading is a "Map All Attachments Now" button. When you click one of these buttons, the mapping rules in that table are applied to <strong><em>ALL of the images in the Media Library</em></strong>. This is a great way to bring your media items up to date, but it is <strong><em>NOT REVERSIBLE</em></strong>, so think carefully before you click!
867
  Each button applies the rules in just one category, so you can update taxonomy terms without disturbing standard or custom field values.
868
  </p>
869
  <p>
870
+ These buttons <strong><em>DO NOT</em></strong> save any rules changes you've made, so you can make a temporary rule change and process your attachments without disturbing the standing rules.
871
  </p>
872
  <h4>Other mapping techniques</h4>
873
  <p>
879
  <dt>Bulk Action edit area</dt>
880
  <dd>To perform mapping for a group of attachments you can use the Bulk Action facility on the main Assistant screen. Check the attachments you want to map, select "edit" from the Bulk Actions dropdown list and click "Apply". The bulk edit area will open with a list of the checked attachments in the left-hand column. You can click the "Map IPTC/EXIF metadata" button in the lower left corner of the area to apply the standing mapping rules to the attachments in the list.
881
  </dd>
882
+ </dl>
883
  </p>
884
  <h4>WordPress default title, slug and description mapping</h4>
885
  <p>
tpls/help-for-edit_attachment.tpl CHANGED
@@ -6,6 +6,9 @@
6
  Displays Last Modified date and time
7
  </li>
8
  <li>
 
 
 
9
  Supports Custom fields, which <code>[mla_gallery]</code> can use for query and display
10
  </li>
11
  <li>
@@ -26,3 +29,7 @@ Displays where-used information; Featured in, Inserted in, Gallery in and MLA Ga
26
  <!-- title="Parent Info" order="3" -->
27
  <p>The &#8220;Parent Info&#8221; field displays the Post ID, type and title of the post or page to which the item is attached. It will display &#8220;0 (unattached)&#8221; if there is no parent post or page.</p>
28
  <p>You can change the post or page to which the item is attached by changing the Post ID value and clicking the &#8220;Update&#8221; button. Changing the Post ID value to zero (0) will &#8220;unattach&#8221; the item.</p>
 
 
 
 
6
  Displays Last Modified date and time
7
  </li>
8
  <li>
9
+ Supports mapping of Custom Field and ITPC/EXIF metadata for this attachment
10
+ </li>
11
+ <li>
12
  Supports Custom fields, which <code>[mla_gallery]</code> can use for query and display
13
  </li>
14
  <li>
29
  <!-- title="Parent Info" order="3" -->
30
  <p>The &#8220;Parent Info&#8221; field displays the Post ID, type and title of the post or page to which the item is attached. It will display &#8220;0 (unattached)&#8221; if there is no parent post or page.</p>
31
  <p>You can change the post or page to which the item is attached by changing the Post ID value and clicking the &#8220;Update&#8221; button. Changing the Post ID value to zero (0) will &#8220;unattach&#8221; the item.</p>
32
+ <!-- template="mla-mapping-actions" -->
33
+ <!-- title="Metadata Mapping" order="4" -->
34
+ <p>The &#8220;Map Custom Field Metadata&#8221; and &#8220;Map IPTC/EXIF Metadata&#8221; links let you create or update attachment values by applying the rules you define on the Media Library Assistant Settings page. The links are located in the &#8220;Save&#8221; metabox in the upper-right part of the screen, just below the Last Modified date and time.</p>
35
+ <p>When you click on one of the two links, all of the mapping rules for that type of metadata will be applied to the attachment you are editing. The updates are immediate; you do not need to click the &#8220;Update&#8221; button to make them permanent.</p>
tpls/help-for-media_page_mla-menu.tpl CHANGED
@@ -1,6 +1,6 @@
1
  <!-- template="mla-overview" -->
2
  <!-- title="Overview" order="1" -->
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>
@@ -21,12 +21,15 @@
21
  <p>The Media Library Assistant provides two pre-defined taxonomies, &#8220;Att. Categories&#8221; and &#8220;Att. Tags&#8221; which are enabled by default. You can add or remove support for any registered taxonomy on the Settings screen. The standard WordPress Categories and Tags as well as any custom taxonomies can be supported.</p>
22
  <p>When you add support for a taxonomy it is visible on the main screen. If you want to hide the column simply use the Screen Options to uncheck the Show on screen box.</p>
23
  <p>Supported taxonomies also appear as submenus below the Media menu at the left of the screen. You can edit the taxonomy terms by clicking these submenus. The taxonomy edit screens include an &#8220;Attachments&#8221; column which displays the number of attachment objects for each term. You can display a filtered list of the attachments by clicking on the number in this column.</p>
 
 
 
24
  <!-- template="mla-search-media" -->
25
- <!-- title="Search Media" order="5" -->
26
  <p>The &#8220;Search Media&#8221; box supports a keyword search of several attachment fields; enter words and/or phrases in the box, separated by spaces. Click the Search Media button for a case-insensitive "SQL LIKE" search. Each keyword in the search phrase is matched independently, so the order of search words does not have to match the order in the text. For example, searching on "friend" and "best" will match "Best Friend". If you put quotes around a search phrase then word order is required for a match (and spaces between words must match as well). You can also match on partial words, e.g., "rien" will match "friend".</p>
27
  <p>Once you&#8217;ve entered the terms you want, use the options below the box to tailor your search. You can pick the connector used between search terms; "or" means any of the terms will match, "and" means all of the terms must match. Use the checkboxes to extend your search to more fields in the database.</p>
28
  <!-- template="mla-bulk-actions" -->
29
- <!-- title="Bulk Actions" order="6" -->
30
  <p>The &#8220;Bulk Actions&#8221; dropdown list works with the check box column to let you make changes to many items at once. Click the check box in the column title row to select all items on the page, or click the check box in a row to select items individually.</p>
31
  <p>Once you&#8217;ve selected the items you want, pick an action from the dropdown list and click Apply to perform the action on the selected items. The available actions will vary depending on the file type/status view you have picked.</p>
32
  <p>If you have enabled Trash support (define MEDIA_TRASH in wp-config.php) you can use bulk actions to move items to and from the Trash or delete them permamently.</p>
@@ -34,11 +37,11 @@
34
  <p>Bulk Edit support for taxonomy terms allows you to <strong>add, remove or completely replace</strong> terms for the selected attachments. Below each taxonomy edit box are three radio buttons that let you select the action you&#8217;d like to perform.</p>
35
  <p>The taxonomies that appear in the Bulk Edit area can be a subset of the taxonomies supported on the single item edit screen. You can select which taxonomies appear by entering your choice(s) on the Media Libray Assistant Settings screen.</p>
36
  <!-- template="mla-available-actions" -->
37
- <!-- title="Available Actions" order="7" -->
38
  <p>Hovering over a row reveals action links such as Edit, Quick Edit, Move to Trash and Delete Permanently. Clicking Edit displays a simple screen to edit that individual file&#8217;s metadata. Clicking Move to Trash will assign the file to the Trash pile but will not affect pages or posts to which it is attached. Clicking Delete Permanently will delete the file from the media library (as well as from any posts to which it is currently attached). Clicking Quick Edit displays an inline form to edit the file's metadata without leaving the menu screen.</p>
39
  <p>The taxonomies that appear in the Quick Edit area can be a subset of the taxonomies supported on the single item edit screen. You can select which taxonomies appear by entering your choice(s) on the Media Libray Assistant Settings screen.</p>
40
  <!-- template="mla-attaching-files" -->
41
- <!-- title="Attaching Files" order="8" -->
42
  <p>If a media file has not been attached to any post, you will see (unattached) in the Attached To column. You can click on the Edit or Quick Edit action to attach the file by assigning a value to the Parent ID field.</p>
43
  <!-- template="sidebar" -->
44
  <p><strong>For more information:</strong></p>
1
  <!-- template="mla-overview" -->
2
  <!-- title="Overview" order="1" -->
3
+ <p>All the files you&#8217;ve uploaded are listed in the Media/Assistant submenu 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>
21
  <p>The Media Library Assistant provides two pre-defined taxonomies, &#8220;Att. Categories&#8221; and &#8220;Att. Tags&#8221; which are enabled by default. You can add or remove support for any registered taxonomy on the Settings screen. The standard WordPress Categories and Tags as well as any custom taxonomies can be supported.</p>
22
  <p>When you add support for a taxonomy it is visible on the main screen. If you want to hide the column simply use the Screen Options to uncheck the Show on screen box.</p>
23
  <p>Supported taxonomies also appear as submenus below the Media menu at the left of the screen. You can edit the taxonomy terms by clicking these submenus. The taxonomy edit screens include an &#8220;Attachments&#8221; column which displays the number of attachment objects for each term. You can display a filtered list of the attachments by clicking on the number in this column.</p>
24
+ <!-- template="mla-custom-fields" -->
25
+ <!-- title="Custom Fields" order="5" -->
26
+ <p>You can add sortable columns to the Media/Assistant submenu table by visiting the Custom Fields tab on the Settings page. There you define rules that map attachment metadata such as file size to WordPress custom fields. The &#8220;MLA Column&#8221; checkbox for each rule lets you select which rules will appear on this screen.</p>
27
  <!-- template="mla-search-media" -->
28
+ <!-- title="Search Media" order="6" -->
29
  <p>The &#8220;Search Media&#8221; box supports a keyword search of several attachment fields; enter words and/or phrases in the box, separated by spaces. Click the Search Media button for a case-insensitive "SQL LIKE" search. Each keyword in the search phrase is matched independently, so the order of search words does not have to match the order in the text. For example, searching on "friend" and "best" will match "Best Friend". If you put quotes around a search phrase then word order is required for a match (and spaces between words must match as well). You can also match on partial words, e.g., "rien" will match "friend".</p>
30
  <p>Once you&#8217;ve entered the terms you want, use the options below the box to tailor your search. You can pick the connector used between search terms; "or" means any of the terms will match, "and" means all of the terms must match. Use the checkboxes to extend your search to more fields in the database.</p>
31
  <!-- template="mla-bulk-actions" -->
32
+ <!-- title="Bulk Actions" order="7" -->
33
  <p>The &#8220;Bulk Actions&#8221; dropdown list works with the check box column to let you make changes to many items at once. Click the check box in the column title row to select all items on the page, or click the check box in a row to select items individually.</p>
34
  <p>Once you&#8217;ve selected the items you want, pick an action from the dropdown list and click Apply to perform the action on the selected items. The available actions will vary depending on the file type/status view you have picked.</p>
35
  <p>If you have enabled Trash support (define MEDIA_TRASH in wp-config.php) you can use bulk actions to move items to and from the Trash or delete them permamently.</p>
37
  <p>Bulk Edit support for taxonomy terms allows you to <strong>add, remove or completely replace</strong> terms for the selected attachments. Below each taxonomy edit box are three radio buttons that let you select the action you&#8217;d like to perform.</p>
38
  <p>The taxonomies that appear in the Bulk Edit area can be a subset of the taxonomies supported on the single item edit screen. You can select which taxonomies appear by entering your choice(s) on the Media Libray Assistant Settings screen.</p>
39
  <!-- template="mla-available-actions" -->
40
+ <!-- title="Available Actions" order="8" -->
41
  <p>Hovering over a row reveals action links such as Edit, Quick Edit, Move to Trash and Delete Permanently. Clicking Edit displays a simple screen to edit that individual file&#8217;s metadata. Clicking Move to Trash will assign the file to the Trash pile but will not affect pages or posts to which it is attached. Clicking Delete Permanently will delete the file from the media library (as well as from any posts to which it is currently attached). Clicking Quick Edit displays an inline form to edit the file's metadata without leaving the menu screen.</p>
42
  <p>The taxonomies that appear in the Quick Edit area can be a subset of the taxonomies supported on the single item edit screen. You can select which taxonomies appear by entering your choice(s) on the Media Libray Assistant Settings screen.</p>
43
  <!-- template="mla-attaching-files" -->
44
+ <!-- title="Attaching Files" order="9" -->
45
  <p>If a media file has not been attached to any post, you will see (unattached) in the Attached To column. You can click on the Edit or Quick Edit action to attach the file by assigning a value to the Parent ID field.</p>
46
  <!-- template="sidebar" -->
47
  <p><strong>For more information:</strong></p>
tpls/mla-option-templates.tpl CHANGED
@@ -41,6 +41,159 @@
41
  </td>
42
  </tr>
43
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
44
  <!-- template="iptc-exif-standard-table" -->
45
  <tr valign="top">
46
  <td colspan="2" style="text-align:left;">
41
  </td>
42
  </tr>
43
 
44
+ <!-- template="custom-field-table" -->
45
+ <tr valign="top">
46
+ <td colspan="2" style="text-align:left;">
47
+ <table class="iptc-exif-custom-table">
48
+ <thead>
49
+ <tr style="text-align:center">
50
+ <th scope="col">
51
+ Field Title
52
+ </th>
53
+ <th scope="col">
54
+ Data Source
55
+ </th>
56
+ <th scope="col">
57
+ Existing Text
58
+ </th>
59
+ <th scope="col">
60
+ Format
61
+ </th>
62
+ <th scope="col">
63
+ MLA Column
64
+ </th>
65
+ </tr>
66
+ </thead>
67
+ <tbody>
68
+ [+table_rows+]
69
+ </tbody>
70
+ </table>
71
+ <div style="font-size:8pt;padding-bottom:10px;">[+help+]</div>
72
+ </td></tr>
73
+
74
+ <!-- template="custom-field-select-option" -->
75
+ <option [+selected+] value="[+value+]">[+text+]</option>
76
+
77
+ <!-- template="custom-field-empty-row" -->
78
+ <tr>
79
+ <td colspan="[+column_count+]" style="font-weight:bold; height: 4em; text-align:center; vertical-align:middle">
80
+ No Custom Field Mapping Rules Defined
81
+ </td>
82
+ </tr>
83
+ <!-- template="custom-field-rule-row" -->
84
+ <tr valign="top">
85
+ <td style="text-align:left; vertical-align:middle">
86
+ [+name+]&nbsp;
87
+ <input type="hidden" name="custom_field_mapping[[+key+]][name]" id="custom_field_name_[+key+]" value="[+name+]" />
88
+ </td>
89
+ <td style="text-align:left;">
90
+ <select name="custom_field_mapping[[+key+]][data_source]" id="custom_field_data_source_[+key+]">
91
+ [+data_source_options+]
92
+ </select>
93
+ </td>
94
+ <td style="text-align:left;">
95
+ <select name="custom_field_mapping[[+key+]][keep_existing]" id="custom_field_keep_existing_[+key+]">
96
+ <option [+keep_selected+] value="1">Keep</option>
97
+ <option [+replace_selected+] value="">Replace</option>
98
+ </select>
99
+ </td>
100
+ <td style="text-align:left;">
101
+ <select name="custom_field_mapping[[+key+]][format]" id="custom_field_format_[+key+]">
102
+ <option [+native_format+] value="native">Native</option>
103
+ <option [+commas_format+] value="commas">Commas</option>
104
+ </select>
105
+ </td>
106
+ <td style="text-align:center;">
107
+ <input type="checkbox" name="custom_field_mapping[[+key+]][mla_column]" id="custom_field_mla_column_[+key+]" [+mla_column_checked+] value="checked" />
108
+ </td>
109
+ </tr>
110
+ <tr valign="top">
111
+ <td colspan="[+column_count+]" style="padding-bottom: 10px">
112
+ <input type="submit" name="custom_field_mapping[[+key+]][action][delete_rule]" class="button-primary" style="height: 18px; line-height: 16px" value="Delete Rule" />
113
+ <input type="submit" name="custom_field_mapping[[+key+]][action][delete_field]" class="button-primary" style="height: 18px; line-height: 16px" value="Delete Rule AND Field" />
114
+ <input type="submit" name="custom_field_mapping[[+key+]][action][update_rule]" class="button-primary" style="height: 18px; line-height: 16px" value="Update Rule" />
115
+ <input type="submit" name="custom_field_mapping[[+key+]][action][map_now]" class="button-secondary" style="height: 18px; line-height: 16px" value="Map All Attachments" />
116
+ </td>
117
+ </tr>
118
+
119
+ <!-- template="custom-field-new-rule-row" -->
120
+ <tr>
121
+ <td colspan="[+column_count+]" style="font-weight:bold; height: 3em; vertical-align:bottom">
122
+ Add a new Mapping Rule
123
+ </td>
124
+ </tr>
125
+ <tr valign="top">
126
+ <td style="text-align:left;">
127
+ <select name="custom_field_mapping[[+key+]][name]" id="custom_field_name_[+key+]">
128
+ [+field_name_options+]
129
+ </select>
130
+ </td>
131
+ <td style="text-align:left;">
132
+ <select name="custom_field_mapping[[+key+]][data_source]" id="custom_field_data_source_[+key+]">
133
+ [+data_source_options+]
134
+ </select>
135
+ </td>
136
+ <td style="text-align:left;">
137
+ <select name="custom_field_mapping[[+key+]][keep_existing]" id="custom_field_keep_existing_[+key+]">
138
+ <option [+keep_selected+] value="1">Keep</option>
139
+ <option [+replace_selected+] value="">Replace</option>
140
+ </select>
141
+ </td>
142
+ <td style="text-align:left;">
143
+ <select name="custom_field_mapping[[+key+]][format]" id="custom_field_format_[+key+]">
144
+ <option [+native_format+] value="native">Native</option>
145
+ <option [+commas_format+] value="commas">Commas</option>
146
+ </select>
147
+ </td>
148
+ <td style="text-align:center;">
149
+ <input type="checkbox" name="custom_field_mapping[[+key+]][mla_column]" id="custom_field_mla_column_[+key+]" [+mla_column_checked+] value="checked" />
150
+ </td>
151
+ </tr>
152
+ <tr valign="top">
153
+ <td colspan="[+column_count+]">
154
+ <input type="submit" name="custom_field_mapping[[+key+]][action][add_rule]" type="submit" class="button-primary" value="Add Rule" />
155
+ <input type="submit" name="custom_field_mapping[[+key+]][action][add_rule_map]" type="submit" class="button-secondary" value="Add Rule and Map All Attachments" />
156
+ </td>
157
+ </tr>
158
+
159
+ <!-- template="custom-field-new-field-row" -->
160
+ <tr>
161
+ <td colspan="[+column_count+]" style="font-weight:bold; height: 3em; vertical-align:bottom">
162
+ Add a new Custom Field and Mapping Rule
163
+ </td>
164
+ </tr>
165
+ <tr valign="top">
166
+ <td style="text-align:left;">
167
+ <input name="custom_field_mapping[[+key+]][name]" id="custom_field_name_[+key+]" type="text" size="[+field_name_size+]" value="" />
168
+ </td>
169
+ <td style="text-align:left;">
170
+ <select name="custom_field_mapping[[+key+]][data_source]" id="custom_field_data_source_[+key+]">
171
+ [+data_source_options+]
172
+ </select>
173
+ </td>
174
+ <td style="text-align:left;">
175
+ <select name="custom_field_mapping[[+key+]][keep_existing]" id="custom_field_keep_existing_[+key+]">
176
+ <option [+keep_selected+] value="1">Keep</option>
177
+ <option [+replace_selected+] value="">Replace</option>
178
+ </select>
179
+ </td>
180
+ <td style="text-align:left;">
181
+ <select name="custom_field_mapping[[+key+]][format]" id="custom_field_format_[+key+]">
182
+ <option [+native_format+] value="native">Native</option>
183
+ <option [+commas_format+] value="commas">Commas</option>
184
+ </select>
185
+ </td>
186
+ <td style="text-align:center;">
187
+ <input type="checkbox" name="custom_field_mapping[[+key+]][mla_column]" id="custom_field_mla_column_[+key+]" [+mla_column_checked+] value="checked" />
188
+ </td>
189
+ </tr>
190
+ <tr valign="top">
191
+ <td colspan="[+column_count+]">
192
+ <input type="submit" name="custom_field_mapping[[+key+]][action][add_field]" type="submit" class="button-primary" value="Add Field" />
193
+ <input type="submit" name="custom_field_mapping[[+key+]][action][add_field_map]" type="submit" class="button-secondary" value="Add Field and Map All Attachments" />
194
+ </td>
195
+ </tr>
196
+
197
  <!-- template="iptc-exif-standard-table" -->
198
  <tr valign="top">
199
  <td colspan="2" style="text-align:left;">