Media Library Assistant - Version 1.30

Version Description

  • New: ALL metadata fields, including the new fields extracted from audio and video files in WordPress 3.6, can be mapped to custom fields and added as sortable columns to the Media/Assistant submenu table.
  • New: For [mla_gallery], field-level substitution parameters now include ALL metadata fields, including the new fields extracted from audio and video files in WordPress 3.6.
  • New: Use [mla_gallery] to determine which items are included in a gallery, then pass them on to another gallery-generating shortcode for formatting and display. The new mla_alt_shortcode and mla_alt_ids_name parameters let you use any gallery-generating shortcode that accepts a list of attachment ID values. For example, you can use the WordPress.com Jetpack Carousel and Tiled Galleries to create elegant mosaic layouts and immersive full-screen experiences. The "Other Notes" section here or the Documentation tab on the Settings/Media Library Assistant page of the plugin have details.
  • New: Improved User Interface for the "IPTC/EXIF" tab on the Settings/Media Library Assistant screen. The "Custom Fields" section of this screen is enhanced to match the "Custom Fields" Settings tab.
  • Fix: Media Manager enhanced Search Media box more reliably re-queries the server when search parameters change.
  • Fix: For [mla_gallery], posts_where and posts_orderby filters now have a very low priority to run later and avoid conflicts with other plugins, e.g, "Post Types Order".
  • Fix: For [mla_gallery], field-level "query" substitution parameters are now processed in all custom style and markup template parts.
  • Fix: For [mla_gallery], empty style and markup template parts are now allowed; empty "Open:" markup will not cause reversion to default template.
  • Fix: Default mla_style settings now include "-- none --", to suppress generation of default inline CSS styles for the [mla_gallery] shortcodes.
  • Fix: Improved handling and display of Custom fields with multiple values.
  • Fix: For [mla_gallery], link=post (added in WordPress 3.5) is now accepted to link gallery items to the corresponding attachment page. The link=permalink value continues to work as well.
  • Fix: Filtering the Media/Media Library Assistant table display on custom field values with leading spaces (i.e., format=commas) now works properly.
Download this release

Release Info

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

Code changes from version 1.20 to 1.30

includes/class-mla-data.php CHANGED
@@ -186,7 +186,7 @@ class MLAData {
186
 
187
  foreach ( $matches[0] as $match ) {
188
  $key = substr( $match, 2, (strlen( $match ) - 4 ) );
189
- $result = array( 'prefix' => '', 'value' => '', 'single' => false);
190
  $match_count = preg_match( '/\[\+(.+):(.+)/', $match, $matches );
191
  if ( 1 == $match_count ) {
192
  $result['prefix'] = $matches[1];
@@ -196,10 +196,11 @@ class MLAData {
196
  $tail = substr( $match, 2);
197
  }
198
 
199
- $match_count = preg_match( '/([^,]+)(,single)\+\]/', $tail, $matches );
200
  if ( 1 == $match_count ) {
201
- $result['single'] = true;
202
  $result['value'] = $matches[1];
 
 
203
  }
204
  else {
205
  $result['value'] = substr( $tail, 0, (strlen( $tail ) - 2 ) );
@@ -430,7 +431,13 @@ class MLAData {
430
  self::$query_parameters['detached'] = isset( $clean_request['detached'] );
431
  self::$query_parameters['orderby'] = $clean_request['orderby'];
432
  self::$query_parameters['order'] = $clean_request['order'];
433
-
 
 
 
 
 
 
434
  /*
435
  * We will handle keyword search in the mla_query_posts_search_filter.
436
  * There must be at least one search field to do a search.
@@ -555,7 +562,7 @@ class MLAData {
555
  if ( isset( $clean_request['mla-metakey'] ) && isset( $clean_request['mla-metavalue'] ) ) {
556
  $clean_request['meta_key'] = $clean_request['mla-metakey'];
557
  $clean_request['meta_value'] = $clean_request['mla-metavalue'];
558
-
559
  unset( $clean_request['mla-metakey'] );
560
  unset( $clean_request['mla-metavalue'] );
561
  } // isset mla_tax
@@ -737,9 +744,16 @@ class MLAData {
737
  public static function mla_query_posts_where_filter( $where_clause ) {
738
  global $table_prefix;
739
 
 
 
 
 
 
 
 
740
  if ( self::$query_parameters['detached'] )
741
  $where_clause .= " AND {$table_prefix}posts.post_parent < 1";
742
-
743
  return $where_clause;
744
  }
745
 
@@ -873,6 +887,50 @@ class MLAData {
873
  return $parent_data;
874
  }
875
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
876
  /**
877
  * Fetch and filter meta data for an attachment
878
  *
@@ -1006,21 +1064,15 @@ class MLAData {
1006
  if ( isset( $parent_data['parent_title'] ) )
1007
  $references['parent_title'] = $parent_data['parent_title'];
1008
 
 
1009
  $attachment_metadata = get_post_meta( $ID, '_wp_attachment_metadata', true );
1010
- if ( empty( $attachment_metadata ) ) {
1011
- $references['base_file'] = get_post_meta( $ID, '_wp_attached_file', true );
1012
- } // empty( $attachment_metadata )
1013
- else {
1014
- $references['base_file'] = $attachment_metadata['file'];
1015
- $sizes = isset( $attachment_metadata['sizes'] ) ? $attachment_metadata['sizes'] : NULL;
1016
- if ( !empty( $sizes ) ) {
1017
- /* Using the name as the array key ensures each name is added only once */
1018
- foreach ( $sizes as $size ) {
1019
- $references['files'][ $references['path'] . $size['file'] ] = $size;
1020
- }
1021
-
1022
  }
1023
- } // ! empty( $attachment_metadata )
1024
 
1025
  $references['files'][ $references['base_file'] ] = $references['base_file'];
1026
  $last_slash = strrpos( $references['base_file'], '/' );
@@ -1672,10 +1724,25 @@ class MLAData {
1672
  $old_meta_value = $post_data[ 'mla_item_' . $meta_key ];
1673
  else
1674
  $old_meta_value = '';
1675
-
1676
- if ( $old_meta_value != $meta_value ) {
1677
- $message .= sprintf( 'Changing %1$s from "%2$s" to "%3$s"<br>', $meta_key, $old_meta_value, $meta_value );
1678
- $results = update_post_meta( $post_id, $meta_key, $meta_value );
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1679
  }
1680
  } // foreach $new_meta
1681
  }
186
 
187
  foreach ( $matches[0] as $match ) {
188
  $key = substr( $match, 2, (strlen( $match ) - 4 ) );
189
+ $result = array( 'prefix' => '', 'value' => '', 'single' => false, 'export' => false );
190
  $match_count = preg_match( '/\[\+(.+):(.+)/', $match, $matches );
191
  if ( 1 == $match_count ) {
192
  $result['prefix'] = $matches[1];
196
  $tail = substr( $match, 2);
197
  }
198
 
199
+ $match_count = preg_match( '/([^,]+)(,(single|export))\+\]/', $tail, $matches );
200
  if ( 1 == $match_count ) {
 
201
  $result['value'] = $matches[1];
202
+ $result['single'] = 'single' == $matches[3];
203
+ $result['export'] = 'export' == $matches[3];
204
  }
205
  else {
206
  $result['value'] = substr( $tail, 0, (strlen( $tail ) - 2 ) );
431
  self::$query_parameters['detached'] = isset( $clean_request['detached'] );
432
  self::$query_parameters['orderby'] = $clean_request['orderby'];
433
  self::$query_parameters['order'] = $clean_request['order'];
434
+
435
+ /*
436
+ * We must patch the WHERE clause if there are leading spaces in the meta_value
437
+ */
438
+ if ( isset( $clean_request['mla-metavalue'] ) && (' ' == $clean_request['mla-metavalue'][0] ) )
439
+ self::$query_parameters['mla-metavalue'] = $clean_request['mla-metavalue'];
440
+
441
  /*
442
  * We will handle keyword search in the mla_query_posts_search_filter.
443
  * There must be at least one search field to do a search.
562
  if ( isset( $clean_request['mla-metakey'] ) && isset( $clean_request['mla-metavalue'] ) ) {
563
  $clean_request['meta_key'] = $clean_request['mla-metakey'];
564
  $clean_request['meta_value'] = $clean_request['mla-metavalue'];
565
+
566
  unset( $clean_request['mla-metakey'] );
567
  unset( $clean_request['mla-metavalue'] );
568
  } // isset mla_tax
744
  public static function mla_query_posts_where_filter( $where_clause ) {
745
  global $table_prefix;
746
 
747
+ /*
748
+ * WordPress filters meta_value thru trim() - which we must reverse
749
+ */
750
+ if ( isset( self::$query_parameters['mla-metavalue'] ) ) {
751
+ $where_clause = preg_replace( '/(^.*meta_value AS CHAR\) = \')([^\']*)/', '${1}' . self::$query_parameters['mla-metavalue'], $where_clause );
752
+ }
753
+
754
  if ( self::$query_parameters['detached'] )
755
  $where_clause .= " AND {$table_prefix}posts.post_parent < 1";
756
+
757
  return $where_clause;
758
  }
759
 
887
  return $parent_data;
888
  }
889
 
890
+ /**
891
+ * Finds the value of a key in a possibily nested array structure
892
+ *
893
+ * Used primarily to extract fields from the _wp_attachment_metadata custom field.
894
+ * Could also be used with the ID3 metadata exposed in WordPress 3.6 and later.
895
+ *
896
+ * @since 1.30
897
+ *
898
+ * @param string key value, e.g. array1.array2.element
899
+ * @param array PHP nested arrays
900
+ * @param boolean return first element of an array result
901
+ * @param boolean return results in var_export() format
902
+ *
903
+ * @return string value matching key(.key ...) or ''
904
+ */
905
+ public static function mla_find_array_element( $needle, $haystack, $single = false, $export = false ) {
906
+ $key_array = explode( '.', $needle );
907
+ if ( is_array( $key_array ) ) {
908
+ foreach( $key_array as $key ) {
909
+ if ( is_array( $haystack ) ) {
910
+ if ( isset( $haystack[ $key ] ) )
911
+ $haystack = $haystack[ $key ];
912
+ else
913
+ $haystack = '';
914
+ }
915
+ else
916
+ $haystack = '';
917
+ } // foreach $key
918
+ }
919
+ else $haystack = '';
920
+
921
+ if ( $single && is_array( $haystack ))
922
+ $haystack = current( $haystack );
923
+
924
+ if ( is_array( $haystack ) ) {
925
+ if ( $export )
926
+ $haystack = var_export( $haystack, true );
927
+ else
928
+ $haystack = implode( ',', $haystack );
929
+ }
930
+
931
+ return sanitize_text_field( $haystack );
932
+ } // mla_find_array_element
933
+
934
  /**
935
  * Fetch and filter meta data for an attachment
936
  *
1064
  if ( isset( $parent_data['parent_title'] ) )
1065
  $references['parent_title'] = $parent_data['parent_title'];
1066
 
1067
+ $references['base_file'] = get_post_meta( $ID, '_wp_attached_file', true );
1068
  $attachment_metadata = get_post_meta( $ID, '_wp_attachment_metadata', true );
1069
+ $sizes = isset( $attachment_metadata['sizes'] ) ? $attachment_metadata['sizes'] : NULL;
1070
+ if ( !empty( $sizes ) ) {
1071
+ /* Using the name as the array key ensures each name is added only once */
1072
+ foreach ( $sizes as $size ) {
1073
+ $references['files'][ $references['path'] . $size['file'] ] = $size;
 
 
 
 
 
 
 
1074
  }
1075
+ }
1076
 
1077
  $references['files'][ $references['base_file'] ] = $references['base_file'];
1078
  $last_slash = strrpos( $references['base_file'], '/' );
1724
  $old_meta_value = $post_data[ 'mla_item_' . $meta_key ];
1725
  else
1726
  $old_meta_value = '';
1727
+
1728
+ if ( is_array( $old_meta_value ) ) {
1729
+ $do_update = false;
1730
+
1731
+ foreach ( $old_meta_value as $old_key => $old_value ) {
1732
+ if ( $old_value != $meta_value ) {
1733
+ $message .= sprintf( 'Changing %1$s[%2$d] from "%3$s" to "%4$s"<br>', $meta_key, $old_key, $old_value, $meta_value );
1734
+ $do_update = true;
1735
+ }
1736
+ } // foreach $old_meta_value
1737
+
1738
+ if ($do_update)
1739
+ $results = update_post_meta( $post_id, $meta_key, $meta_value );
1740
+ }
1741
+ else {
1742
+ if ( $old_meta_value != $meta_value ) {
1743
+ $message .= sprintf( 'Changing %1$s from "%2$s" to "%3$s"<br>', $meta_key, $old_meta_value, $meta_value );
1744
+ $results = update_post_meta( $post_id, $meta_key, $meta_value );
1745
+ }
1746
  }
1747
  } // foreach $new_meta
1748
  }
includes/class-mla-edit-media.php CHANGED
@@ -123,7 +123,7 @@ class MLAEdit {
123
 
124
  $image_metadata = get_metadata( 'post', $post->ID, '_wp_attachment_metadata', true );
125
  if ( !empty( $image_metadata ) )
126
- add_meta_box( 'mla-image-metadata', 'Image Metadata', 'MLAEdit::mla_image_metadata_handler', 'attachment', 'normal', 'core' );
127
 
128
  if ( MLAOptions::$process_featured_in )
129
  add_meta_box( 'mla-featured-in', 'Featured in', 'MLAEdit::mla_featured_in_handler', 'attachment', 'normal', 'core' );
@@ -254,7 +254,7 @@ class MLAEdit {
254
  else
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
  /**
123
 
124
  $image_metadata = get_metadata( 'post', $post->ID, '_wp_attachment_metadata', true );
125
  if ( !empty( $image_metadata ) )
126
+ add_meta_box( 'mla-image-metadata', 'Attachment Metadata', 'MLAEdit::mla_image_metadata_handler', 'attachment', 'normal', 'core' );
127
 
128
  if ( MLAOptions::$process_featured_in )
129
  add_meta_box( 'mla-featured-in', 'Featured in', 'MLAEdit::mla_featured_in_handler', 'attachment', 'normal', 'core' );
254
  else
255
  $value = '';
256
 
257
+ echo '<label class="screen-reader-text" for="mla_image_metadata">Attachment 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
@@ -500,7 +500,10 @@ class MLA_List_Table extends WP_List_Table {
500
  ), 'upload.php' ) ), esc_html( $value ) );
501
  }
502
 
503
- return join( ', ', $list );
 
 
 
504
  } // 'c_'
505
  else {
506
  //Show the whole array for troubleshooting purposes
500
  ), 'upload.php' ) ), esc_html( $value ) );
501
  }
502
 
503
+ if ( count( $list ) > 1 )
504
+ return '[' . join( '], [', $list ) . ']';
505
+ else
506
+ return $list[0];
507
  } // 'c_'
508
  else {
509
  //Show the whole array for troubleshooting purposes
includes/class-mla-main.php CHANGED
@@ -38,7 +38,7 @@ class MLA {
38
  *
39
  * @var string
40
  */
41
- const CURRENT_MLA_VERSION = '1.20';
42
 
43
  /**
44
  * Slug for registering and enqueueing plugin style sheet
@@ -1185,6 +1185,8 @@ class MLA {
1185
  * Display a single item sub page; prepare the form to
1186
  * change the meta data for a single attachment.
1187
  *
 
 
1188
  * @since 0.1
1189
  *
1190
  * @param int The WordPress Post ID of the attachment item
@@ -1212,8 +1214,8 @@ class MLA {
1212
 
1213
  if ( !empty( $post_data['mla_wp_attachment_metadata'] ) ) {
1214
  $page_template_array = MLAData::mla_load_template( MLA_PLUGIN_PATH . 'tpls/admin-display-single-image.tpl' );
1215
- $width = $post_data['mla_wp_attachment_metadata']['width'];
1216
- $height = $post_data['mla_wp_attachment_metadata']['height'];
1217
  $image_meta = var_export( $post_data['mla_wp_attachment_metadata'], true );
1218
 
1219
  if ( !isset( $post_data['mla_wp_attachment_image_alt'] ) )
@@ -1412,7 +1414,7 @@ class MLA {
1412
  'side_info_column' => $side_info_column
1413
  );
1414
 
1415
- if ( !empty( $post_data['mla_wp_attachment_metadata'] ) ) {
1416
  $page_values['image_alt_attr'] = esc_attr( $post_data['mla_wp_attachment_image_alt'] );
1417
  }
1418
 
38
  *
39
  * @var string
40
  */
41
+ const CURRENT_MLA_VERSION = '1.30';
42
 
43
  /**
44
  * Slug for registering and enqueueing plugin style sheet
1185
  * Display a single item sub page; prepare the form to
1186
  * change the meta data for a single attachment.
1187
  *
1188
+ * This function is not used in WordPress 3.5 and later.
1189
+ *
1190
  * @since 0.1
1191
  *
1192
  * @param int The WordPress Post ID of the attachment item
1214
 
1215
  if ( !empty( $post_data['mla_wp_attachment_metadata'] ) ) {
1216
  $page_template_array = MLAData::mla_load_template( MLA_PLUGIN_PATH . 'tpls/admin-display-single-image.tpl' );
1217
+ $width = isset( $post_data['mla_wp_attachment_metadata']['width'] ) ? $post_data['mla_wp_attachment_metadata']['width'] : '';
1218
+ $height = isset( $post_data['mla_wp_attachment_metadata']['height'] ) ? $post_data['mla_wp_attachment_metadata']['height'] : '';
1219
  $image_meta = var_export( $post_data['mla_wp_attachment_metadata'], true );
1220
 
1221
  if ( !isset( $post_data['mla_wp_attachment_image_alt'] ) )
1414
  'side_info_column' => $side_info_column
1415
  );
1416
 
1417
+ if ( !empty( $post_data['mla_wp_attachment_image_alt'] ) ) {
1418
  $page_values['image_alt_attr'] = esc_attr( $post_data['mla_wp_attachment_image_alt'] );
1419
  }
1420
 
includes/class-mla-media-modal.php CHANGED
@@ -385,6 +385,8 @@ class MLAModal {
385
  if ( isset( $query['mla_search_value'] ) ) {
386
  if ( ! empty( $query['mla_search_value'] ) )
387
  $query['s'] = $query['mla_search_value'];
 
 
388
 
389
  unset( $query['mla_search_value'] );
390
  }
385
  if ( isset( $query['mla_search_value'] ) ) {
386
  if ( ! empty( $query['mla_search_value'] ) )
387
  $query['s'] = $query['mla_search_value'];
388
+ else
389
+ unset( $query['s'] );
390
 
391
  unset( $query['mla_search_value'] );
392
  }
includes/class-mla-objects.php CHANGED
@@ -93,9 +93,13 @@ class MLAObjects {
93
  foreach ( $taxonomies as $tax_name ) {
94
  if ( MLAOptions::mla_taxonomy_support( $tax_name ) ) {
95
  register_taxonomy_for_object_type( $tax_name, 'attachment');
96
- add_filter( "manage_edit-{$tax_name}_columns", 'MLAObjects::mla_taxonomy_get_columns_filter', 10, 1 ); // $columns
97
- add_filter( "manage_{$tax_name}_custom_column", 'MLAObjects::mla_taxonomy_column_filter', 10, 3 ); // $place_holder, $column_name, $tag->term_id
98
- }
 
 
 
 
99
  } // foreach
100
  } // _build_taxonomies
101
 
93
  foreach ( $taxonomies as $tax_name ) {
94
  if ( MLAOptions::mla_taxonomy_support( $tax_name ) ) {
95
  register_taxonomy_for_object_type( $tax_name, 'attachment');
96
+ if ( 'checked' == MLAOptions::mla_get_option( 'attachments_column' )
97
+ ) {
98
+
99
+ add_filter( "manage_edit-{$tax_name}_columns", 'MLAObjects::mla_taxonomy_get_columns_filter', 10, 1 ); // $columns
100
+ add_filter( "manage_{$tax_name}_custom_column", 'MLAObjects::mla_taxonomy_column_filter', 10, 3 ); // $place_holder, $column_name, $tag->term_id
101
+ } // option is checked
102
+ } // taxonomy support
103
  } // foreach
104
  } // _build_taxonomies
105
 
includes/class-mla-options.php CHANGED
@@ -250,6 +250,13 @@ class MLAOptions {
250
  'delete' => 'mla_taxonomy_option_handler',
251
  'reset' => 'mla_taxonomy_option_handler'),
252
 
 
 
 
 
 
 
 
253
  'orderby_heading' =>
254
  array('tab' => 'general',
255
  'name' => 'Default Table Listing Sort Order',
@@ -378,7 +385,7 @@ class MLAOptions {
378
 
379
  'iptc_exif_standard_mapping' =>
380
  array('tab' => '',
381
- '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.',
382
  'std' => NULL,
383
  'type' => 'custom',
384
  'render' => 'mla_iptc_exif_option_handler',
@@ -388,7 +395,7 @@ class MLAOptions {
388
 
389
  'iptc_exif_taxonomy_mapping' =>
390
  array('tab' => '',
391
- 'help' => 'Update the taxonomy term mapping values above, then click Save Changes or Map All Attachments Now.',
392
  'std' => NULL,
393
  'type' => 'custom',
394
  'render' => 'mla_iptc_exif_option_handler',
@@ -398,7 +405,7 @@ class MLAOptions {
398
 
399
  'iptc_exif_custom_mapping' =>
400
  array('tab' => '',
401
- '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.',
402
  'std' => NULL,
403
  'type' => 'custom',
404
  'render' => 'mla_iptc_exif_option_handler',
@@ -573,8 +580,9 @@ class MLAOptions {
573
  }
574
 
575
  $array_key = $key . '-' . $type;
576
- if ( array_key_exists( $array_key, self::$mla_option_templates ) )
577
  return self::$mla_option_templates[ $array_key ];
 
578
  else {
579
  MLAShortcodes::$mla_debug_messages .= "<p><strong>_fetch_template( {$key}, {$type} )</strong> not found";
580
  return false;
@@ -638,39 +646,40 @@ class MLAOptions {
638
 
639
  $templates = array();
640
  foreach ( self::$mla_option_templates as $key => $value ) {
641
- $tail = strrpos( $key, '-row-open-markup' );
642
- if ( ! ( false === $tail ) ) {
643
- $name = substr( $key, 0, $tail );
644
- $templates[ $name ]['row-open'] = $value;
645
- continue;
646
- }
647
-
648
- $tail = strrpos( $key, '-open-markup' );
649
- if ( ! ( false === $tail ) ) {
650
- $name = substr( $key, 0, $tail );
651
- $templates[ $name ]['open'] = $value;
652
- continue;
653
- }
654
-
655
- $tail = strrpos( $key, '-item-markup' );
656
- if ( ! ( false === $tail ) ) {
657
- $name = substr( $key, 0, $tail );
658
- $templates[ $name ]['item'] = $value;
659
- continue;
660
- }
661
-
662
- $tail = strrpos( $key, '-row-close-markup' );
663
- if ( ! ( false === $tail ) ) {
664
- $name = substr( $key, 0, $tail );
665
- $templates[ $name ]['row-close'] = $value;
666
- continue;
667
- }
668
-
669
- $tail = strrpos( $key, '-close-markup' );
670
- if ( ! ( false === $tail ) ) {
671
- $name = substr( $key, 0, $tail );
672
- $templates[ $name ]['close'] = $value;
673
- }
 
674
  } // foreach
675
 
676
  return $templates;
@@ -1063,22 +1072,20 @@ class MLAOptions {
1063
  'sizes' => array()
1064
  );
1065
 
1066
- $attached_file = isset( $wp_attached_files[ $post_id ]->meta_value ) ? $wp_attached_files[ $post_id ]->meta_value : '';
 
 
1067
  $attachment_metadata = isset( $wp_attachment_metadata[ $post_id ]->meta_value ) ? unserialize( $wp_attachment_metadata[ $post_id ]->meta_value ) : array();
1068
-
1069
  if ( !empty( $attachment_metadata ) ) {
1070
- $base_file = $attachment_metadata['file'];
1071
  $sizes = isset( $attachment_metadata['sizes'] ) ? $attachment_metadata['sizes'] : array();
1072
- $results['width'] = $attachment_metadata['width'];
1073
- $results['height'] = $attachment_metadata['height'];
1074
  $results['hwstring_small'] = isset( $attachment_metadata['hwstring_small'] ) ? $attachment_metadata['hwstring_small'] : '';
1075
 
1076
- foreach( $attachment_metadata['image_meta'] as $key => $value )
1077
- $results[ $key ] = $value;
1078
- }
1079
- else {
1080
- $base_file = $attached_file;
1081
- $sizes = array();
1082
  }
1083
 
1084
  if ( ! empty( $base_file ) ) {
@@ -1117,20 +1124,21 @@ class MLAOptions {
1117
  *
1118
  * @param integer post->ID of attachment
1119
  * @param string category/scope to evaluate against: custom_field_mapping or single_attachment_mapping
1120
- * @param string data source name
1121
- * @param string desired results format, default 'native'
1122
  * @param array (optional) attachment_metadata, default NULL (use current postmeta database value)
1123
  *
1124
  * @return string data source value
1125
  */
1126
- private static function _evaluate_data_source( $post_id, $category, $data_source, $format = 'native', $attachment_metadata = NULL ) {
1127
  global $wpdb;
1128
  static $upload_dir, $intermediate_sizes = NULL, $wp_attached_files = NULL, $wp_attachment_metadata = NULL;
1129
  static $current_id = 0, $file_info = NULL;
1130
 
1131
- if ( 'none' == $data_source )
1132
  return '';
1133
-
 
 
1134
  /*
1135
  * Do this once per page load; cache attachment metadata if mapping all attachments
1136
  */
@@ -1186,6 +1194,12 @@ class MLAOptions {
1186
  $result = '';
1187
 
1188
  switch( $data_source ) {
 
 
 
 
 
 
1189
  case 'path':
1190
  case 'file_name':
1191
  case 'extension':
@@ -1202,7 +1216,8 @@ class MLAOptions {
1202
  case 'iso':
1203
  case 'shutter_speed':
1204
  case 'title':
1205
- $result = $file_info[ $data_source ];
 
1206
  break;
1207
  case 'file_size':
1208
  $filesize = @ filesize( $file_info['absolute_path'] . $file_info['file_name'] );
@@ -1331,10 +1346,10 @@ class MLAOptions {
1331
  return '';
1332
  } // switch $data_source
1333
 
1334
- switch( $format ) {
1335
  case 'commas':
1336
  if ( is_numeric( $result ) )
1337
- $result = number_format( (float)$result );
1338
  break;
1339
  default:
1340
  // no change
@@ -1373,14 +1388,16 @@ class MLAOptions {
1373
  foreach( $settings as $new_key => $new_value ) {
1374
  if ( 'none' == $new_value['data_source'] )
1375
  continue;
1376
-
1377
- if ( $new_value['keep_existing'] )
 
1378
  $old_text = get_metadata( 'post', $post_id, $new_key, true );
1379
- else
1380
- $old_text = '';
1381
-
1382
- if ( empty( $old_text ) )
1383
- $custom_updates[ $new_value['name'] ] = self::_evaluate_data_source( $post_id, $category, $new_value['data_source'], $new_value['format'], $attachment_metadata );
 
1384
  } // foreach new setting
1385
 
1386
  if ( ! empty( $custom_updates ) )
@@ -1396,10 +1413,11 @@ class MLAOptions {
1396
  * @uses $mla_option_templates contains row and table templates
1397
  *
1398
  * @param string current selection or 'none' (default)
 
1399
  *
1400
  * @return string HTML markup with select field options
1401
  */
1402
- private static function _compose_custom_field_option_list( $selection = 'none' ) {
1403
  $option_template = self::$mla_option_templates['custom-field-select-option'];
1404
  $option_values = array (
1405
  'selected' => ( 'none' == $selection ) ? 'selected="selected"' : '',
@@ -1408,8 +1426,11 @@ class MLAOptions {
1408
  );
1409
 
1410
  $custom_field_options = MLAData::mla_parse_template( $option_template, $option_values );
1411
- $custom_field_names = MLAOptions::_get_custom_field_names();
1412
  foreach ( $custom_field_names as $value ) {
 
 
 
1413
  $option_values = array (
1414
  'selected' => ( $value == $selection ) ? 'selected="selected"' : '',
1415
  'value' => $value,
@@ -1476,15 +1497,22 @@ class MLAOptions {
1476
  */
1477
  private static function _compose_data_source_option_list( $selection = 'none' ) {
1478
  $option_template = self::$mla_option_templates['custom-field-select-option'];
 
1479
  $option_values = array (
1480
  'selected' => ( 'none' == $selection ) ? 'selected="selected"' : '',
1481
  'value' => 'none',
1482
  'text' => ' -- None (select a value) -- '
1483
  );
1484
-
1485
  $custom_field_options = MLAData::mla_parse_template( $option_template, $option_values );
1486
- $intermediate_sizes = get_intermediate_image_sizes();
1487
 
 
 
 
 
 
 
 
 
1488
  foreach ( self::$custom_field_data_sources as $value ) {
1489
  $size_pos = strpos( $value, '[size]' );
1490
  if ( $size_pos ) {
@@ -1573,7 +1601,10 @@ class MLAOptions {
1573
  'format' => 'native',
1574
  'mla_column' => false,
1575
  'quick_edit' => false,
1576
- 'bulk_edit' => false
 
 
 
1577
  );
1578
  }
1579
 
@@ -1588,6 +1619,13 @@ class MLAOptions {
1588
 
1589
  if ( $old_values['data_source'] != $new_value['data_source'] ) {
1590
  $any_setting_changed = true;
 
 
 
 
 
 
 
1591
  $message_list .= "<br>{$old_values['name']} changing Data Source from {$old_values['data_source']} to {$new_value['data_source']}.\r\n";
1592
  $old_values['data_source'] = $new_value['data_source'];
1593
  }
@@ -1654,6 +1692,41 @@ class MLAOptions {
1654
  $old_values['bulk_edit'] = $boolean_value;
1655
  }
1656
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1657
  if ( $any_setting_changed ) {
1658
  $settings_changed = true;
1659
  $current_values[ $new_key ] = $old_values;
@@ -1694,6 +1767,7 @@ class MLAOptions {
1694
  $table_rows = '';
1695
  }
1696
 
 
1697
  foreach ( $current_values as $row_name => $current_value ) {
1698
  $row_values = array (
1699
  'key' => sanitize_title( $row_name ),
@@ -1706,7 +1780,12 @@ class MLAOptions {
1706
  'mla_column_checked' => '',
1707
  'quick_edit_checked' => '',
1708
  'bulk_edit_checked' => '',
1709
- 'column_count' => 7
 
 
 
 
 
1710
  );
1711
 
1712
  if ( $current_value['keep_existing'] )
@@ -1734,6 +1813,12 @@ class MLAOptions {
1734
  if ( $current_value['bulk_edit'] )
1735
  $row_values['bulk_edit_checked'] = 'checked="checked"';
1736
 
 
 
 
 
 
 
1737
  $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
1738
  } // foreach current_value
1739
 
@@ -1743,7 +1828,7 @@ class MLAOptions {
1743
  $row_template = self::$mla_option_templates['custom-field-new-rule-row'];
1744
  $row_values = array (
1745
  'key' => self::MLA_NEW_CUSTOM_RULE,
1746
- 'field_name_options' => self::_compose_custom_field_option_list( 'none' ),
1747
  'data_source_options' => self::_compose_data_source_option_list( 'none' ),
1748
  'keep_selected' => '',
1749
  'replace_selected' => 'selected="selected"',
@@ -1752,7 +1837,12 @@ class MLAOptions {
1752
  'mla_column_checked' => '',
1753
  'quick_edit_checked' => '',
1754
  'bulk_edit_checked' => '',
1755
- 'column_count' => 7
 
 
 
 
 
1756
  );
1757
  $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
1758
 
@@ -1771,7 +1861,12 @@ class MLAOptions {
1771
  'mla_column_checked' => '',
1772
  'quick_edit_checked' => '',
1773
  'bulk_edit_checked' => '',
1774
- 'column_count' => 7
 
 
 
 
 
1775
  );
1776
  $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
1777
 
@@ -1833,7 +1928,7 @@ class MLAOptions {
1833
  if ( NULL == $settings )
1834
  $settings = self::mla_get_option( 'iptc_exif_mapping' );
1835
 
1836
- if ( $update_all || ( 'iptc_exif_standard_mapping' == $category ) ) {}{
1837
  foreach( $settings['standard'] as $new_key => $new_value ) {
1838
  $iptc_value = ( isset( $iptc_metadata[ $new_value['iptc_value'] ] ) ) ? $iptc_metadata[ $new_value['iptc_value'] ] : '';
1839
  $exif_value = MLAData::mla_exif_metadata_value( $new_value['exif_value'], $metadata );
@@ -1955,16 +2050,17 @@ class MLAOptions {
1955
  else
1956
  $new_text = $iptc_value;
1957
 
1958
- if ( $new_value['keep_existing'] )
1959
- $old_text = get_metadata( 'post', $post->ID, $new_key, true );
1960
- else
1961
- $old_text = '';
1962
-
1963
  if ( is_array( $new_text ) ) {
1964
  $new_text = implode( ',', $new_text );
1965
  }
1966
 
1967
- if ( empty( $old_text ) ) {
 
 
 
 
 
 
1968
  $custom_updates[ $new_key ] = $new_text;
1969
  }
1970
  } // foreach new setting
@@ -2228,22 +2324,37 @@ class MLAOptions {
2228
  $error_list = '';
2229
  $message_list = '';
2230
  $settings_changed = false;
 
2231
 
2232
  foreach ( $new_values['custom'] as $new_key => $new_value ) {
2233
  $any_setting_changed = false;
2234
 
2235
  /*
2236
- * Check for the addition of a new field
2237
  */
2238
  if ( self::MLA_NEW_CUSTOM_FIELD == $new_key ) {
2239
  $new_key = trim( $new_value['name'] );
2240
 
2241
  if ( empty( $new_key ) )
2242
  continue;
 
 
 
 
 
2243
 
2244
  $message_list .= "<br>Adding new field {$new_key}.\r\n";
2245
  $any_setting_changed = true;
2246
  }
 
 
 
 
 
 
 
 
 
2247
 
2248
  if ( isset( $current_values['custom'][ $new_key ] ) ) {
2249
  $old_values = $current_values['custom'][ $new_key ];
@@ -2259,6 +2370,16 @@ class MLAOptions {
2259
  );
2260
  }
2261
 
 
 
 
 
 
 
 
 
 
 
2262
  if ( $old_values['iptc_value'] != $new_value['iptc_value'] ) {
2263
  $any_setting_changed = true;
2264
  $message_list .= "<br>{$old_values['name']} changing IPTC Value from {$old_values['iptc_value']} to {$new_value['iptc_value']}.\r\n";
@@ -2465,22 +2586,21 @@ class MLAOptions {
2465
 
2466
  return MLAData::mla_parse_template( self::$mla_option_templates['iptc-exif-taxonomy-table'], $option_values );
2467
  case 'iptc_exif_custom_mapping':
2468
- $custom_field_names = MLAOptions::_get_custom_field_names();
2469
- $row_template = self::$mla_option_templates['iptc-exif-custom-row'];
2470
- $table_rows = '';
 
 
 
 
2471
 
2472
  /*
2473
- * Add fields defined here but not yet assigned to any attachments
2474
  */
2475
- foreach ( $current_values['custom'] as $row_name => $row_values ) {
2476
- if ( in_array( $row_name, $custom_field_names ) )
2477
- continue;
2478
-
2479
- $custom_field_names[] = $row_name;
2480
- }
2481
-
2482
- foreach ( $custom_field_names as $row_name ) {
2483
  $row_values = array (
 
2484
  'key' => $row_name,
2485
  'name' => $row_name,
2486
  'iptc_field_options' => '',
@@ -2491,38 +2611,49 @@ class MLAOptions {
2491
  'keep_selected' => '',
2492
  'replace_selected' => ''
2493
  );
 
 
 
2494
 
2495
- if ( array_key_exists( $row_name, $current_values['custom'] ) ) {
2496
- $current_value = $current_values['custom'][ $row_name ];
2497
- $row_values['iptc_field_options'] = self::_compose_iptc_option_list( $current_value['iptc_value'] );
2498
- $row_values['exif_text'] = $current_value['exif_value'];
2499
-
2500
- if ( $current_value['iptc_first'] )
2501
- $row_values['iptc_selected'] = 'selected="selected"';
2502
- else
2503
- $row_values['exif_selected'] = 'selected="selected"';
2504
-
2505
- if ( $current_value['keep_existing'] )
2506
- $row_values['keep_selected'] = 'selected="selected"';
2507
- else
2508
- $row_values['replace_selected'] = 'selected="selected"';
2509
- }
2510
- else {
2511
- $row_values['iptc_field_options'] = self::_compose_iptc_option_list( 'none' );
2512
  $row_values['iptc_selected'] = 'selected="selected"';
 
 
 
 
2513
  $row_values['keep_selected'] = 'selected="selected"';
2514
-
2515
- }
2516
 
2517
  $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
2518
- } // foreach row
2519
 
2520
  /*
2521
- * Add a row for defining a new Custom Field
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2522
  */
 
2523
  $row_values = array (
 
2524
  'key' => self::MLA_NEW_CUSTOM_FIELD,
2525
- 'name' => ' <input name="iptc_exif_mapping[custom][' . self::MLA_NEW_CUSTOM_FIELD . '][name]" id="iptc_exif_standard_exif_field_' . self::MLA_NEW_CUSTOM_FIELD . '" type="text" size="20" value="" />',
2526
  'iptc_field_options' => self::_compose_iptc_option_list( 'none' ),
2527
  'exif_size' => 20,
2528
  'exif_text' => '',
250
  'delete' => 'mla_taxonomy_option_handler',
251
  'reset' => 'mla_taxonomy_option_handler'),
252
 
253
+ 'attachments_column' =>
254
+ array('tab' => '',
255
+ 'name' => 'Attachments Column',
256
+ 'type' => 'hidden', // checkbox',
257
+ 'std' => 'checked',
258
+ 'help' => 'Check this option to replace the Posts column with the Attachments Column.'),
259
+
260
  'orderby_heading' =>
261
  array('tab' => 'general',
262
  'name' => 'Default Table Listing Sort Order',
385
 
386
  'iptc_exif_standard_mapping' =>
387
  array('tab' => '',
388
+ 'help' => 'Update the standard field mapping values above, then click <strong>Save Changes</strong> to make the updates permanent.<br>You can also make temporary updates and click <strong>Map All Attachments, Standard Fields Now</strong> to apply the updates to all attachments without saving the rule changes.',
389
  'std' => NULL,
390
  'type' => 'custom',
391
  'render' => 'mla_iptc_exif_option_handler',
395
 
396
  'iptc_exif_taxonomy_mapping' =>
397
  array('tab' => '',
398
+ 'help' => 'Update the taxonomy term mapping values above, then click <strong>Save Changes</strong> or <strong>Map All Attachments, Taxonomy Terms Now</strong>.',
399
  'std' => NULL,
400
  'type' => 'custom',
401
  'render' => 'mla_iptc_exif_option_handler',
405
 
406
  'iptc_exif_custom_mapping' =>
407
  array('tab' => '',
408
+ 'help' => '<strong>Update</strong> individual custom field mapping values above, or make several updates and click <strong>Save Changes</strong> below to apply them all at once.<br>You can also <strong>add a new rule</strong> for an existing field or <strong>add a new field</strong> and rule.<br>You can make temporary updates and click <strong>Map All Attachments, Custom Fields Now</strong> to apply the updates to all attachments without saving the rule changes.',
409
  'std' => NULL,
410
  'type' => 'custom',
411
  'render' => 'mla_iptc_exif_option_handler',
580
  }
581
 
582
  $array_key = $key . '-' . $type;
583
+ if ( array_key_exists( $array_key, self::$mla_option_templates ) ) {
584
  return self::$mla_option_templates[ $array_key ];
585
+ }
586
  else {
587
  MLAShortcodes::$mla_debug_messages .= "<p><strong>_fetch_template( {$key}, {$type} )</strong> not found";
588
  return false;
646
 
647
  $templates = array();
648
  foreach ( self::$mla_option_templates as $key => $value ) {
649
+ // Note order: -row-open must precede -open!
650
+ $tail = strrpos( $key, '-row-open-markup' );
651
+ if ( ! ( false === $tail ) ) {
652
+ $name = substr( $key, 0, $tail );
653
+ $templates[ $name ]['row-open'] = $value;
654
+ continue;
655
+ }
656
+
657
+ $tail = strrpos( $key, '-open-markup' );
658
+ if ( ! ( false === $tail ) ) {
659
+ $name = substr( $key, 0, $tail );
660
+ $templates[ $name ]['open'] = $value;
661
+ continue;
662
+ }
663
+
664
+ $tail = strrpos( $key, '-item-markup' );
665
+ if ( ! ( false === $tail ) ) {
666
+ $name = substr( $key, 0, $tail );
667
+ $templates[ $name ]['item'] = $value;
668
+ continue;
669
+ }
670
+
671
+ $tail = strrpos( $key, '-row-close-markup' );
672
+ if ( ! ( false === $tail ) ) {
673
+ $name = substr( $key, 0, $tail );
674
+ $templates[ $name ]['row-close'] = $value;
675
+ continue;
676
+ }
677
+
678
+ $tail = strrpos( $key, '-close-markup' );
679
+ if ( ! ( false === $tail ) ) {
680
+ $name = substr( $key, 0, $tail );
681
+ $templates[ $name ]['close'] = $value;
682
+ }
683
  } // foreach
684
 
685
  return $templates;
1072
  'sizes' => array()
1073
  );
1074
 
1075
+ $base_file = isset( $wp_attached_files[ $post_id ]->meta_value ) ? $wp_attached_files[ $post_id ]->meta_value : '';
1076
+ $sizes = array();
1077
+
1078
  $attachment_metadata = isset( $wp_attachment_metadata[ $post_id ]->meta_value ) ? unserialize( $wp_attachment_metadata[ $post_id ]->meta_value ) : array();
 
1079
  if ( !empty( $attachment_metadata ) ) {
 
1080
  $sizes = isset( $attachment_metadata['sizes'] ) ? $attachment_metadata['sizes'] : array();
1081
+ $results['width'] = isset( $attachment_metadata['width'] ) ? $attachment_metadata['width'] : '';;
1082
+ $results['height'] = isset( $attachment_metadata['height'] ) ? $attachment_metadata['height'] : '';;
1083
  $results['hwstring_small'] = isset( $attachment_metadata['hwstring_small'] ) ? $attachment_metadata['hwstring_small'] : '';
1084
 
1085
+ if ( isset( $attachment_metadata['image_meta'] ) ) {
1086
+ foreach( $attachment_metadata['image_meta'] as $key => $value )
1087
+ $results[ $key ] = $value;
1088
+ }
 
 
1089
  }
1090
 
1091
  if ( ! empty( $base_file ) ) {
1124
  *
1125
  * @param integer post->ID of attachment
1126
  * @param string category/scope to evaluate against: custom_field_mapping or single_attachment_mapping
1127
+ * @param array data source specification (name, format, meta_name, meta_single, meta_export)
 
1128
  * @param array (optional) attachment_metadata, default NULL (use current postmeta database value)
1129
  *
1130
  * @return string data source value
1131
  */
1132
+ private static function _evaluate_data_source( $post_id, $category, $data_value, $attachment_metadata = NULL ) {
1133
  global $wpdb;
1134
  static $upload_dir, $intermediate_sizes = NULL, $wp_attached_files = NULL, $wp_attachment_metadata = NULL;
1135
  static $current_id = 0, $file_info = NULL;
1136
 
1137
+ if ( 'none' == $data_value['data_source'] )
1138
  return '';
1139
+
1140
+ $data_source = $data_value['data_source'];
1141
+
1142
  /*
1143
  * Do this once per page load; cache attachment metadata if mapping all attachments
1144
  */
1194
  $result = '';
1195
 
1196
  switch( $data_source ) {
1197
+ case 'meta':
1198
+ $meta_single = ( isset( $data_value['meta_single'] ) && $data_value['meta_single'] );
1199
+ $meta_export = ( isset( $data_value['meta_export'] ) && $data_value['meta_export'] );
1200
+ $attachment_metadata = isset( $wp_attachment_metadata[ $post_id ]->meta_value ) ? unserialize( $wp_attachment_metadata[ $post_id ]->meta_value ) : array();
1201
+ $result = MLAData::mla_find_array_element( $data_value['meta_name'], $attachment_metadata, $meta_single, $meta_export );
1202
+ break;
1203
  case 'path':
1204
  case 'file_name':
1205
  case 'extension':
1216
  case 'iso':
1217
  case 'shutter_speed':
1218
  case 'title':
1219
+ if ( isset( $file_info[ $data_source ] ) )
1220
+ $result = $file_info[ $data_source ];
1221
  break;
1222
  case 'file_size':
1223
  $filesize = @ filesize( $file_info['absolute_path'] . $file_info['file_name'] );
1346
  return '';
1347
  } // switch $data_source
1348
 
1349
+ switch( $data_value['format'] ) {
1350
  case 'commas':
1351
  if ( is_numeric( $result ) )
1352
+ $result = str_pad( number_format( (float)$result ), 15, ' ', STR_PAD_LEFT );
1353
  break;
1354
  default:
1355
  // no change
1388
  foreach( $settings as $new_key => $new_value ) {
1389
  if ( 'none' == $new_value['data_source'] )
1390
  continue;
1391
+
1392
+ $new_text = self::_evaluate_data_source( $post_id, $category, $new_value, $attachment_metadata );
1393
+ if ( $new_value['keep_existing'] ) {
1394
  $old_text = get_metadata( 'post', $post_id, $new_key, true );
1395
+ if ( ( ! empty( $new_text ) ) && empty( $old_text ) )
1396
+ $custom_updates[ $new_value['name'] ] = $new_text;
1397
+ }
1398
+ else {
1399
+ $custom_updates[ $new_value['name'] ] = $new_text;
1400
+ }
1401
  } // foreach new setting
1402
 
1403
  if ( ! empty( $custom_updates ) )
1413
  * @uses $mla_option_templates contains row and table templates
1414
  *
1415
  * @param string current selection or 'none' (default)
1416
+ * @param array optional list of terms to exclude from the list
1417
  *
1418
  * @return string HTML markup with select field options
1419
  */
1420
+ private static function _compose_custom_field_option_list( $selection = 'none', $blacklist = array() ) {
1421
  $option_template = self::$mla_option_templates['custom-field-select-option'];
1422
  $option_values = array (
1423
  'selected' => ( 'none' == $selection ) ? 'selected="selected"' : '',
1426
  );
1427
 
1428
  $custom_field_options = MLAData::mla_parse_template( $option_template, $option_values );
1429
+ $custom_field_names = self::_get_custom_field_names();
1430
  foreach ( $custom_field_names as $value ) {
1431
+ if ( array_key_exists( $value, $blacklist ) )
1432
+ continue;
1433
+
1434
  $option_values = array (
1435
  'selected' => ( $value == $selection ) ? 'selected="selected"' : '',
1436
  'value' => $value,
1497
  */
1498
  private static function _compose_data_source_option_list( $selection = 'none' ) {
1499
  $option_template = self::$mla_option_templates['custom-field-select-option'];
1500
+
1501
  $option_values = array (
1502
  'selected' => ( 'none' == $selection ) ? 'selected="selected"' : '',
1503
  'value' => 'none',
1504
  'text' => ' -- None (select a value) -- '
1505
  );
 
1506
  $custom_field_options = MLAData::mla_parse_template( $option_template, $option_values );
 
1507
 
1508
+ $option_values = array (
1509
+ 'selected' => ( 'meta' == $selection ) ? 'selected="selected"' : '',
1510
+ 'value' => 'meta',
1511
+ 'text' => ' -- Metadata (see below) -- '
1512
+ );
1513
+ $custom_field_options .= MLAData::mla_parse_template( $option_template, $option_values );
1514
+
1515
+ $intermediate_sizes = get_intermediate_image_sizes();
1516
  foreach ( self::$custom_field_data_sources as $value ) {
1517
  $size_pos = strpos( $value, '[size]' );
1518
  if ( $size_pos ) {
1601
  'format' => 'native',
1602
  'mla_column' => false,
1603
  'quick_edit' => false,
1604
+ 'bulk_edit' => false,
1605
+ 'meta_name' => '',
1606
+ 'meta_single' => false,
1607
+ 'meta_export' => false
1608
  );
1609
  }
1610
 
1619
 
1620
  if ( $old_values['data_source'] != $new_value['data_source'] ) {
1621
  $any_setting_changed = true;
1622
+
1623
+ if ( 'meta' == $old_values['data_source'] ) {
1624
+ $new_value['meta_name'] = '';
1625
+ unset( $new_value['meta_single'] );
1626
+ unset( $new_value['meta_export'] );
1627
+ }
1628
+
1629
  $message_list .= "<br>{$old_values['name']} changing Data Source from {$old_values['data_source']} to {$new_value['data_source']}.\r\n";
1630
  $old_values['data_source'] = $new_value['data_source'];
1631
  }
1692
  $old_values['bulk_edit'] = $boolean_value;
1693
  }
1694
 
1695
+ if ( $old_values['meta_name'] != $new_value['meta_name'] ) {
1696
+ $any_setting_changed = true;
1697
+
1698
+ $message_list .= "<br>{$old_values['name']} changing Metavalue name from {$old_values['meta_name']} to {$new_value['meta_name']}.\r\n";
1699
+ $old_values['meta_name'] = $new_value['meta_name'];
1700
+ }
1701
+
1702
+ if ( isset( $new_value['meta_single'] ) ) {
1703
+ $boolean_value = true;
1704
+ $boolean_text = 'unchecked to checked';
1705
+ }
1706
+ else {
1707
+ $boolean_value = false;
1708
+ $boolean_text = 'checked to unchecked';
1709
+ }
1710
+ if ( $old_values['meta_single'] != $boolean_value ) {
1711
+ $any_setting_changed = true;
1712
+ $message_list .= "<br>{$old_values['name']} changing Single value from {$boolean_text}.\r\n";
1713
+ $old_values['meta_single'] = $boolean_value;
1714
+ }
1715
+
1716
+ if ( isset( $new_value['meta_export'] ) ) {
1717
+ $boolean_value = true;
1718
+ $boolean_text = 'unchecked to checked';
1719
+ }
1720
+ else {
1721
+ $boolean_value = false;
1722
+ $boolean_text = 'checked to unchecked';
1723
+ }
1724
+ if ( $old_values['meta_export'] != $boolean_value ) {
1725
+ $any_setting_changed = true;
1726
+ $message_list .= "<br>{$old_values['name']} changing Export value from {$boolean_text}.\r\n";
1727
+ $old_values['meta_export'] = $boolean_value;
1728
+ }
1729
+
1730
  if ( $any_setting_changed ) {
1731
  $settings_changed = true;
1732
  $current_values[ $new_key ] = $old_values;
1767
  $table_rows = '';
1768
  }
1769
 
1770
+ ksort( $current_values );
1771
  foreach ( $current_values as $row_name => $current_value ) {
1772
  $row_values = array (
1773
  'key' => sanitize_title( $row_name ),
1780
  'mla_column_checked' => '',
1781
  'quick_edit_checked' => '',
1782
  'bulk_edit_checked' => '',
1783
+ 'column_count' => 7,
1784
+ 'meta_name_size' => 30,
1785
+ 'meta_name' => $current_value['meta_name'],
1786
+ 'column_count_meta' => (7 - 2),
1787
+ 'meta_single_checked' => '',
1788
+ 'meta_export_checked' => ''
1789
  );
1790
 
1791
  if ( $current_value['keep_existing'] )
1813
  if ( $current_value['bulk_edit'] )
1814
  $row_values['bulk_edit_checked'] = 'checked="checked"';
1815
 
1816
+ if ( $current_value['meta_single'] )
1817
+ $row_values['meta_single_checked'] = 'checked="checked"';
1818
+
1819
+ if ( $current_value['meta_export'] )
1820
+ $row_values['meta_export_checked'] = 'checked="checked"';
1821
+
1822
  $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
1823
  } // foreach current_value
1824
 
1828
  $row_template = self::$mla_option_templates['custom-field-new-rule-row'];
1829
  $row_values = array (
1830
  'key' => self::MLA_NEW_CUSTOM_RULE,
1831
+ 'field_name_options' => self::_compose_custom_field_option_list( 'none', $current_values ),
1832
  'data_source_options' => self::_compose_data_source_option_list( 'none' ),
1833
  'keep_selected' => '',
1834
  'replace_selected' => 'selected="selected"',
1837
  'mla_column_checked' => '',
1838
  'quick_edit_checked' => '',
1839
  'bulk_edit_checked' => '',
1840
+ 'column_count' => 7,
1841
+ 'meta_name_size' => 30,
1842
+ 'meta_name' => '',
1843
+ 'column_count_meta' => (7 - 2),
1844
+ 'meta_single_checked' => '',
1845
+ 'meta_export_checked' => ''
1846
  );
1847
  $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
1848
 
1861
  'mla_column_checked' => '',
1862
  'quick_edit_checked' => '',
1863
  'bulk_edit_checked' => '',
1864
+ 'column_count' => 7,
1865
+ 'meta_name_size' => 30,
1866
+ 'meta_name' => '',
1867
+ 'column_count_meta' => (7 - 2),
1868
+ 'meta_single_checked' => '',
1869
+ 'meta_export_checked' => ''
1870
  );
1871
  $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
1872
 
1928
  if ( NULL == $settings )
1929
  $settings = self::mla_get_option( 'iptc_exif_mapping' );
1930
 
1931
+ if ( $update_all || ( 'iptc_exif_standard_mapping' == $category ) ) {
1932
  foreach( $settings['standard'] as $new_key => $new_value ) {
1933
  $iptc_value = ( isset( $iptc_metadata[ $new_value['iptc_value'] ] ) ) ? $iptc_metadata[ $new_value['iptc_value'] ] : '';
1934
  $exif_value = MLAData::mla_exif_metadata_value( $new_value['exif_value'], $metadata );
2050
  else
2051
  $new_text = $iptc_value;
2052
 
 
 
 
 
 
2053
  if ( is_array( $new_text ) ) {
2054
  $new_text = implode( ',', $new_text );
2055
  }
2056
 
2057
+ if ( $new_value['keep_existing'] ) {
2058
+ $old_value = get_metadata( 'post', $post->ID, $new_key, true );
2059
+ if ( ( ! empty( $new_text ) ) && empty( $old_value ) ) {
2060
+ $custom_updates[ $new_key ] = $new_text;
2061
+ }
2062
+ } // keep_existing
2063
+ else {
2064
  $custom_updates[ $new_key ] = $new_text;
2065
  }
2066
  } // foreach new setting
2324
  $error_list = '';
2325
  $message_list = '';
2326
  $settings_changed = false;
2327
+ $custom_field_names = self::_get_custom_field_names();
2328
 
2329
  foreach ( $new_values['custom'] as $new_key => $new_value ) {
2330
  $any_setting_changed = false;
2331
 
2332
  /*
2333
+ * Check for the addition of a new field or new rule
2334
  */
2335
  if ( self::MLA_NEW_CUSTOM_FIELD == $new_key ) {
2336
  $new_key = trim( $new_value['name'] );
2337
 
2338
  if ( empty( $new_key ) )
2339
  continue;
2340
+
2341
+ if ( in_array( $new_key, $custom_field_names ) ) {
2342
+ $error_list .= "<br>ERROR: new field {$new_key} already exists.\r\n";
2343
+ continue;
2344
+ }
2345
 
2346
  $message_list .= "<br>Adding new field {$new_key}.\r\n";
2347
  $any_setting_changed = true;
2348
  }
2349
+ elseif ( self::MLA_NEW_CUSTOM_RULE == $new_key ) {
2350
+ $new_key = trim( $new_value['name'] );
2351
+
2352
+ if ( 'none' == $new_key )
2353
+ continue;
2354
+
2355
+ $message_list .= "<br>Adding new rule for {$new_key}.\r\n";
2356
+ $any_setting_changed = true;
2357
+ }
2358
 
2359
  if ( isset( $current_values['custom'][ $new_key ] ) ) {
2360
  $old_values = $current_values['custom'][ $new_key ];
2370
  );
2371
  }
2372
 
2373
+ if ( isset( $new_value['action'] ) ) {
2374
+ if ( array_key_exists( 'delete_rule', $new_value['action'] ) || array_key_exists( 'delete_field', $new_value['action'] ) ) {
2375
+ $settings_changed = true;
2376
+ $message_list .= "<br>deleting rule for {$old_values['name']}.\r\n";
2377
+ unset( $current_values['custom'][ $new_key ] );
2378
+ $settings_changed = true;
2379
+ continue;
2380
+ } // delete rule
2381
+ } // isset action
2382
+
2383
  if ( $old_values['iptc_value'] != $new_value['iptc_value'] ) {
2384
  $any_setting_changed = true;
2385
  $message_list .= "<br>{$old_values['name']} changing IPTC Value from {$old_values['iptc_value']} to {$new_value['iptc_value']}.\r\n";
2586
 
2587
  return MLAData::mla_parse_template( self::$mla_option_templates['iptc-exif-taxonomy-table'], $option_values );
2588
  case 'iptc_exif_custom_mapping':
2589
+ if ( empty( $current_values['custom'] ) ) {
2590
+ $table_rows = MLAData::mla_parse_template( self::$mla_option_templates['iptc-exif-custom-empty-row'], array( 'column_count' => 5 ) );
2591
+ }
2592
+ else {
2593
+ $row_template = self::$mla_option_templates['iptc-exif-custom-rule-row'];
2594
+ $table_rows = '';
2595
+ }
2596
 
2597
  /*
2598
+ * One row for each existing rule
2599
  */
2600
+ ksort( $current_values['custom'] );
2601
+ foreach ( $current_values['custom'] as $row_name => $current_value ) {
 
 
 
 
 
 
2602
  $row_values = array (
2603
+ 'column_count' => 5,
2604
  'key' => $row_name,
2605
  'name' => $row_name,
2606
  'iptc_field_options' => '',
2611
  'keep_selected' => '',
2612
  'replace_selected' => ''
2613
  );
2614
+
2615
+ $row_values['iptc_field_options'] = self::_compose_iptc_option_list( $current_value['iptc_value'] );
2616
+ $row_values['exif_text'] = $current_value['exif_value'];
2617
 
2618
+ if ( $current_value['iptc_first'] )
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2619
  $row_values['iptc_selected'] = 'selected="selected"';
2620
+ else
2621
+ $row_values['exif_selected'] = 'selected="selected"';
2622
+
2623
+ if ( $current_value['keep_existing'] )
2624
  $row_values['keep_selected'] = 'selected="selected"';
2625
+ else
2626
+ $row_values['replace_selected'] = 'selected="selected"';
2627
 
2628
  $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
2629
+ } // foreach existing rule
2630
 
2631
  /*
2632
+ * Add a row for defining a new rule, existing Custom Field
2633
+ */
2634
+ $row_template = self::$mla_option_templates['iptc-exif-custom-new-rule-row'];
2635
+ $row_values = array (
2636
+ 'column_count' => 5 ,
2637
+ 'key' => self::MLA_NEW_CUSTOM_RULE,
2638
+ 'field_name_options' => self::_compose_custom_field_option_list( 'none', $current_values['custom'] ),
2639
+ 'iptc_field_options' => self::_compose_iptc_option_list( 'none' ),
2640
+ 'exif_size' => 20,
2641
+ 'exif_text' => '',
2642
+ 'iptc_selected' => 'selected="selected"',
2643
+ 'exif_selected' => '',
2644
+ 'keep_selected' => 'selected="selected"',
2645
+ 'replace_selected' => ''
2646
+ );
2647
+ $table_rows .= MLAData::mla_parse_template( $row_template, $row_values );
2648
+
2649
+ /*
2650
+ * Add a row for defining a new rule, new Custom Field
2651
  */
2652
+ $row_template = self::$mla_option_templates['iptc-exif-custom-new-field-row'];
2653
  $row_values = array (
2654
+ 'column_count' => 5 ,
2655
  'key' => self::MLA_NEW_CUSTOM_FIELD,
2656
+ 'field_name_size' => '24',
2657
  'iptc_field_options' => self::_compose_iptc_option_list( 'none' ),
2658
  'exif_size' => 20,
2659
  'exif_text' => '',
includes/class-mla-settings.php CHANGED
@@ -81,6 +81,22 @@ class MLASettings {
81
  MLAOptions::mla_update_option( 'custom_field_mapping', $new_values );
82
  } // version is less than 1.13
83
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
84
  MLAOptions::mla_update_option( MLAOptions::MLA_VERSION_OPTION, MLA::CURRENT_MLA_VERSION );
85
  }
86
 
@@ -544,6 +560,9 @@ class MLASettings {
544
  /*
545
  * Build default template selection lists
546
  */
 
 
 
547
  $templates = MLAOptions::mla_get_style_templates();
548
  ksort($templates);
549
  foreach ($templates as $key => $value ) {
@@ -920,33 +939,68 @@ class MLASettings {
920
  */
921
  private static function _compose_iptc_exif_tab( ) {
922
  /*
923
- * Check for submit buttons to change or reset settings.
924
  * Initialize page messages and content.
 
925
  */
926
- if ( !empty( $_REQUEST['iptc-exif-options-save'] ) ) {
927
- check_admin_referer( MLA::MLA_ADMIN_NONCE, '_wpnonce' );
928
- $page_content = self::_save_iptc_exif_settings( );
929
- }
930
- elseif ( !empty( $_REQUEST['iptc-exif-options-process-standard'] ) ) {
931
- check_admin_referer( MLA::MLA_ADMIN_NONCE, '_wpnonce' );
932
- $page_content = self::_process_iptc_exif_standard( );
933
- }
934
- elseif ( !empty( $_REQUEST['iptc-exif-options-process-taxonomy'] ) ) {
935
- check_admin_referer( MLA::MLA_ADMIN_NONCE, '_wpnonce' );
936
- $page_content = self::_process_iptc_exif_taxonomy( );
937
- }
938
- elseif ( !empty( $_REQUEST['iptc-exif-options-process-custom'] ) ) {
939
  check_admin_referer( MLA::MLA_ADMIN_NONCE, '_wpnonce' );
940
- $page_content = self::_process_iptc_exif_custom( );
941
- } else {
942
- $page_content = array(
943
- 'message' => '',
944
- 'body' => ''
945
- );
946
- }
947
-
948
- if ( !empty( $page_content['body'] ) ) {
949
- return $page_content;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
950
  }
951
 
952
  $page_values = array(
@@ -1354,9 +1408,9 @@ class MLASettings {
1354
 
1355
  $count = count( $post_meta_ids );
1356
  if ( $count )
1357
- return sprintf( 'Deleted custom field value from ' . _n('%s attachment.', '%s attachments.', $count), $count);
1358
  else
1359
- return 'No attachments contained this custom field';
1360
  } // _delete_custom_field
1361
 
1362
  /**
@@ -1494,15 +1548,22 @@ class MLASettings {
1494
  *
1495
  * @since 1.00
1496
  *
1497
- * @uses $_REQUEST
 
 
1498
  *
1499
  * @return array Message(s) reflecting the results of the operation
1500
  */
1501
- private static function _process_iptc_exif_custom( ) {
1502
- if ( isset( $_REQUEST['iptc_exif_mapping']['custom'][ MLAOptions::MLA_NEW_CUSTOM_FIELD ] ) )
1503
- unset( $_REQUEST['iptc_exif_mapping']['custom'][ MLAOptions::MLA_NEW_CUSTOM_FIELD ] );
 
 
 
 
 
1504
 
1505
- if ( ! isset( $_REQUEST['iptc_exif_mapping']['custom'] ) )
1506
  return array(
1507
  'message' => 'ERROR: No custom field settings to process.',
1508
  'body' => ''
@@ -1515,7 +1576,7 @@ class MLASettings {
1515
  $posts = MLAShortcodes::mla_get_shortcode_attachments( 0, $query );
1516
 
1517
  foreach( $posts as $key => $post ) {
1518
- $updates = MLAOptions::mla_evaluate_iptc_exif_mapping( $post, 'iptc_exif_custom_mapping', $_REQUEST['iptc_exif_mapping'] );
1519
 
1520
  $examine_count += 1;
1521
  if ( ! empty( $updates ) ) {
@@ -1536,6 +1597,22 @@ class MLASettings {
1536
  );
1537
  } // _process_iptc_exif_custom
1538
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1539
  /**
1540
  * Save IPTC/EXIF settings to the options table
1541
  *
81
  MLAOptions::mla_update_option( 'custom_field_mapping', $new_values );
82
  } // version is less than 1.13
83
 
84
+ if ( ((float)'1.30') > ((float)$current_version) ) {
85
+ /*
86
+ * Add metadata values to custom field mapping rules
87
+ */
88
+ $new_values = array();
89
+
90
+ foreach( MLAOptions::mla_get_option( 'custom_field_mapping' ) as $key => $value ) {
91
+ $value['meta_name'] = isset( $value['meta_name'] ) ? $value['meta_name'] : '';
92
+ $value['meta_single'] = ( isset( $value['meta_single'] ) && $value['meta_single'] ) ? true : false;
93
+ $value['meta_export'] = ( isset( $value['meta_export'] ) && $value['meta_export'] ) ? true : false;
94
+ $new_values[ $key ] = $value;
95
+ }
96
+
97
+ MLAOptions::mla_update_option( 'custom_field_mapping', $new_values );
98
+ } // version is less than 1.30
99
+
100
  MLAOptions::mla_update_option( MLAOptions::MLA_VERSION_OPTION, MLA::CURRENT_MLA_VERSION );
101
  }
102
 
560
  /*
561
  * Build default template selection lists
562
  */
563
+ MLAOptions::$mla_option_definitions['default_style']['options'][] = 'none';
564
+ MLAOptions::$mla_option_definitions['default_style']['texts'][] = '-- none --';
565
+
566
  $templates = MLAOptions::mla_get_style_templates();
567
  ksort($templates);
568
  foreach ($templates as $key => $value ) {
939
  */
940
  private static function _compose_iptc_exif_tab( ) {
941
  /*
 
942
  * Initialize page messages and content.
943
+ * Check for submit buttons to change or reset settings.
944
  */
945
+ $page_content = array(
946
+ 'message' => '',
947
+ 'body' => ''
948
+ );
949
+
950
+ if ( isset( $_REQUEST['iptc_exif_mapping'] ) && is_array( $_REQUEST['iptc_exif_mapping'] ) ) {
 
 
 
 
 
 
 
951
  check_admin_referer( MLA::MLA_ADMIN_NONCE, '_wpnonce' );
952
+
953
+ if ( !empty( $_REQUEST['iptc-exif-options-save'] ) ) {
954
+ $page_content = self::_save_iptc_exif_settings( );
955
+ }
956
+ elseif ( !empty( $_REQUEST['iptc-exif-options-process-standard'] ) ) {
957
+ $page_content = self::_process_iptc_exif_standard( );
958
+ }
959
+ elseif ( !empty( $_REQUEST['iptc-exif-options-process-taxonomy'] ) ) {
960
+ $page_content = self::_process_iptc_exif_taxonomy( );
961
+ }
962
+ elseif ( !empty( $_REQUEST['iptc-exif-options-process-custom'] ) ) {
963
+ $page_content = self::_process_iptc_exif_custom( );
964
+ }
965
+ else {
966
+ /*
967
+ * Check for single-rule action buttons
968
+ */
969
+ foreach( $_REQUEST['iptc_exif_mapping']['custom'] as $key => $value ) {
970
+ if ( isset( $value['action'] ) ) {
971
+ $settings = array( 'custom' => array( $key => $value ) );
972
+ foreach ( $value['action'] as $action => $label ) {
973
+ switch( $action ) {
974
+ case 'delete_field':
975
+ $delete_result = self::_delete_custom_field( $value );
976
+ case 'delete_rule':
977
+ case 'add_rule':
978
+ case 'add_field':
979
+ case 'update_rule':
980
+ $page_content = self::_save_iptc_exif_custom_settings( $settings );
981
+ if ( isset( $delete_result ) )
982
+ $page_content['message'] = $delete_result . $page_content['message'];
983
+ break;
984
+ case 'map_now':
985
+ $page_content = self::_process_iptc_exif_custom( $settings );
986
+ break;
987
+ case 'add_rule_map':
988
+ case 'add_field_map':
989
+ $page_content = self::_save_iptc_exif_custom_settings( $settings );
990
+ $map_content = self::_process_iptc_exif_custom( $settings );
991
+ $page_content['message'] .= '<br>&nbsp;<br>' . $map_content['message'];
992
+ break;
993
+ default:
994
+ // ignore everything else
995
+ } //switch action
996
+ } // foreach action
997
+ } /// isset action
998
+ } // foreach rule
999
+ }
1000
+
1001
+ if ( !empty( $page_content['body'] ) ) {
1002
+ return $page_content;
1003
+ }
1004
  }
1005
 
1006
  $page_values = array(
1408
 
1409
  $count = count( $post_meta_ids );
1410
  if ( $count )
1411
+ return sprintf( 'Deleted custom field value from ' . _n('%s attachment.<br>', '%s attachments.<br>', $count), $count);
1412
  else
1413
+ return 'No attachments contained this custom field.<br>';
1414
  } // _delete_custom_field
1415
 
1416
  /**
1548
  *
1549
  * @since 1.00
1550
  *
1551
+ * @uses $_REQUEST if passed a NULL parameter
1552
+ *
1553
+ * @param array | NULL specific iptc_exif_custom_mapping values
1554
  *
1555
  * @return array Message(s) reflecting the results of the operation
1556
  */
1557
+ private static function _process_iptc_exif_custom( $settings = NULL ) {
1558
+ if ( NULL == $settings ) {
1559
+ $settings = ( isset( $_REQUEST['iptc_exif_mapping'] ) ) ? $_REQUEST['iptc_exif_mapping'] : array();
1560
+ if ( isset( $settings['custom'][ MLAOptions::MLA_NEW_CUSTOM_FIELD ] ) )
1561
+ unset( $settings['custom'][ MLAOptions::MLA_NEW_CUSTOM_FIELD ] );
1562
+ if ( isset( $settings['custom'][ MLAOptions::MLA_NEW_CUSTOM_RULE ] ) )
1563
+ unset( $settings['custom'][ MLAOptions::MLA_NEW_CUSTOM_RULE ] );
1564
+ }
1565
 
1566
+ if ( empty( $settings['custom'] ) )
1567
  return array(
1568
  'message' => 'ERROR: No custom field settings to process.',
1569
  'body' => ''
1576
  $posts = MLAShortcodes::mla_get_shortcode_attachments( 0, $query );
1577
 
1578
  foreach( $posts as $key => $post ) {
1579
+ $updates = MLAOptions::mla_evaluate_iptc_exif_mapping( $post, 'iptc_exif_custom_mapping', $settings );
1580
 
1581
  $examine_count += 1;
1582
  if ( ! empty( $updates ) ) {
1597
  );
1598
  } // _process_iptc_exif_custom
1599
 
1600
+ /**
1601
+ * Save IPTC/EXIF custom field settings to the options table
1602
+ *
1603
+ * @since 1.30
1604
+ *
1605
+ * @param array specific iptc_exif_custom_mapping values
1606
+ *
1607
+ * @return array Message(s) reflecting the results of the operation
1608
+ */
1609
+ private static function _save_iptc_exif_custom_settings( $new_values ) {
1610
+ return array(
1611
+ 'message' => MLAOptions::mla_iptc_exif_option_handler( 'update', 'iptc_exif_custom_mapping', MLAOptions::$mla_option_definitions['iptc_exif_mapping'], $new_values ),
1612
+ 'body' => ''
1613
+ );
1614
+ } // _save_iptc_exif_custom_settings
1615
+
1616
  /**
1617
  * Save IPTC/EXIF settings to the options table
1618
  *
includes/class-mla-shortcodes.php CHANGED
@@ -167,14 +167,7 @@ class MLAShortcodes {
167
  /*
168
  * These are the parameters for gallery display
169
  */
170
- $default_arguments = array(
171
- 'size' => 'thumbnail', // or 'medium', 'large', 'full' or registered size
172
- 'itemtag' => 'dl',
173
- 'icontag' => 'dt',
174
- 'captiontag' => 'dd',
175
- 'columns' => 3,
176
- 'link' => 'permalink', // or 'file' or a registered size
177
- // MLA-specific
178
  'mla_style' => MLAOptions::mla_get_option('default_style'),
179
  'mla_markup' => MLAOptions::mla_get_option('default_markup'),
180
  'mla_float' => is_rtl() ? 'right' : 'left',
@@ -190,10 +183,21 @@ class MLAShortcodes {
190
  'mla_viewer_extensions' => 'doc,xls,ppt,pdf,txt',
191
  'mla_viewer_page' => '1',
192
  'mla_viewer_width' => '150',
 
 
 
 
 
 
 
 
 
 
 
193
  // Photonic-specific
194
  'id' => NULL,
195
  'style' => NULL,
196
- 'type' => 'default',
197
  'thumb_width' => 75,
198
  'thumb_height' => 75,
199
  'thumbnail_size' => 'thumbnail',
@@ -202,7 +206,8 @@ class MLAShortcodes {
202
  'fx' => 'fade',
203
  'timeout' => 4000,
204
  'speed' => 1000,
205
- 'pause' => NULL
 
206
  );
207
 
208
  /*
@@ -219,7 +224,7 @@ class MLAShortcodes {
219
 
220
  if ( empty($attachments) ) {
221
  if ( self::$mla_debug ) {
222
- $output = '<p><strong>mla_debug</strong> empty gallery, query = ' . var_export( $attr, true ) . '</p>';
223
  $output .= self::$mla_debug_messages;
224
  self::$mla_debug_messages = '';
225
  return $output;
@@ -229,6 +234,41 @@ class MLAShortcodes {
229
  }
230
  } // empty $attachments
231
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
232
  /*
233
  * Look for Photonic-enhanced gallery
234
  */
@@ -313,10 +353,10 @@ class MLAShortcodes {
313
  'selector' => "mla_gallery-{$instance}",
314
  'size_class' => sanitize_html_class( $size_class )
315
  );
316
-
317
  $style_template = $gallery_style = '';
318
  $use_mla_gallery_style = ( 'none' != strtolower( $style_values['mla_style'] ) );
319
- if ( apply_filters( 'use_mla_gallery_style', $use_mla_gallery_style ) ) {
320
  $style_template = MLAOptions::mla_fetch_gallery_template( $style_values['mla_style'], 'style' );
321
  if ( empty( $style_template ) ) {
322
  $style_values['mla_style'] = 'default';
@@ -324,6 +364,19 @@ class MLAShortcodes {
324
  }
325
 
326
  if ( ! empty ( $style_template ) ) {
 
 
 
 
 
 
 
 
 
 
 
 
 
327
  $gallery_style = MLAData::mla_parse_template( $style_template, $style_values );
328
  } // !empty template
329
  } // use_mla_gallery_style
@@ -335,67 +388,84 @@ class MLAShortcodes {
335
  $markup_values['base_dir'] = $upload_dir['basedir'];
336
 
337
  /*
338
- * Variable item-level placeholders
339
  */
340
  $query_placeholders = array();
 
 
 
 
 
341
  $terms_placeholders = array();
342
  $custom_placeholders = array();
343
  $iptc_placeholders = array();
344
  $exif_placeholders = array();
345
 
346
- $markup_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-open', 'markup' );
347
- if ( empty( $markup_template ) ) {
348
  $markup_values['mla_markup'] = 'default';
349
- $markup_template = MLAOptions::mla_fetch_gallery_template( 'default-open', 'markup' );
350
  }
351
 
352
- if ( ! empty( $markup_template ) ) {
353
- $gallery_div = MLAData::mla_parse_template( $markup_template, $markup_values );
354
 
355
- $row_open_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-row-open', 'markup' );
356
- if ( empty( $row_open_template ) )
357
- $row_open_template = '';
358
 
359
- $item_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-item', 'markup' );
360
- if ( empty( $item_template ) )
361
- $item_template = '';
362
- else {
363
- /*
364
- * Look for variable item-level placeholders
365
- */
366
- $new_text = str_replace( '{+', '[+', str_replace( '+}', '+]', $arguments['mla_link_href'] . $arguments['mla_link_text'] . $arguments['mla_rollover_text'] . $arguments['mla_caption'] ) );
367
- $placeholders = MLAData::mla_get_template_placeholders( $item_template . $new_text );
368
- foreach ($placeholders as $key => $value ) {
369
- switch ( $value['prefix'] ) {
370
- case 'query':
371
- $query_placeholders[ $key ] = $value;
372
- break;
373
- case 'terms':
374
- $terms_placeholders[ $key ] = $value;
375
- break;
376
- case 'custom':
377
- $custom_placeholders[ $key ] = $value;
378
- break;
379
- case 'iptc':
380
- $iptc_placeholders[ $key ] = $value;
381
- break;
382
- case 'exif':
383
- $exif_placeholders[ $key ] = $value;
384
- break;
385
- default:
386
- // ignore anything else
387
- } // switch
388
- } // $placeholders
389
- } // $item_template
390
-
391
- $row_close_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-row-close', 'markup' );
392
- if ( empty( $row_close_template ) )
393
- $row_close_template = '';
 
 
 
 
 
 
 
394
 
395
- $close_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-close', 'markup' );
396
- if ( empty( $close_template ) )
397
- $close_template = '';
398
- }
 
 
 
 
 
399
 
400
  if ( self::$mla_debug ) {
401
  $output = self::$mla_debug_messages;
@@ -404,7 +474,12 @@ class MLAShortcodes {
404
  else
405
  $output = '';
406
 
407
- $output .= apply_filters( 'mla_gallery_style', $gallery_style . $gallery_div, $style_values, $markup_values, $style_template, $markup_template );
 
 
 
 
 
408
 
409
  $i = 0;
410
  foreach ( $attachments as $id => $attachment ) {
@@ -443,19 +518,16 @@ class MLAShortcodes {
443
  $markup_values['author'] = 'unknown';
444
 
445
  $post_meta = MLAData::mla_fetch_attachment_metadata( $attachment->ID );
446
- if ( !empty( $post_meta['mla_wp_attachment_metadata'] ) ) {
447
- $base_file = $post_meta['mla_wp_attachment_metadata']['file'];
448
- $sizes = $post_meta['mla_wp_attachment_metadata']['sizes'];
 
449
  $markup_values['width'] = $post_meta['mla_wp_attachment_metadata']['width'];
 
450
  $markup_values['height'] = $post_meta['mla_wp_attachment_metadata']['height'];
 
451
  $markup_values['image_meta'] = wptexturize( var_export( $post_meta['mla_wp_attachment_metadata']['image_meta'], true ) );
452
- }
453
- else {
454
- $base_file = $post_meta['mla_wp_attached_file'];
455
- $sizes = array();
456
- }
457
-
458
- if ( isset( $post_meta['mla_wp_attachment_image_alt'] ) )
459
  $markup_values['image_alt'] = wptexturize( $post_meta['mla_wp_attachment_image_alt'] );
460
 
461
  if ( ! empty( $base_file ) ) {
@@ -488,12 +560,10 @@ class MLAShortcodes {
488
  /*
489
  * Add variable placeholders
490
  */
491
- foreach ( $query_placeholders as $key => $value ) {
492
- if ( isset( $attr[ $value['value'] ] ) )
493
- $markup_values[ $key ] = $attr[ $value['value'] ];
494
- else
495
- $markup_values[ $key ] = '';
496
- } // $query_placeholders
497
 
498
  foreach ( $terms_placeholders as $key => $value ) {
499
  $text = '';
@@ -520,7 +590,7 @@ class MLAShortcodes {
520
  if ( is_wp_error( $record ) || empty( $record ) )
521
  $text = '';
522
  elseif ( is_scalar( $record ) )
523
- $text = (string) $record;
524
  elseif ( is_array( $record ) ) {
525
  $text = '';
526
  foreach ( $record as $term ) {
@@ -622,6 +692,7 @@ class MLAShortcodes {
622
 
623
  switch ( $arguments['link'] ) {
624
  case 'permalink':
 
625
  $markup_values['link'] = $markup_values['pagelink'];
626
  break;
627
  case 'file':
@@ -864,20 +935,13 @@ class MLAShortcodes {
864
  }
865
 
866
  /**
867
- * Parses shortcode parameters and returns the gallery objects
868
- *
869
- * @since .50
870
  *
871
- * @param int Post ID of the parent
872
- * @param array Attributes of the shortcode
873
  *
874
- * @return array List of attachments returned from WP_Query
875
  */
876
- public static function mla_get_shortcode_attachments( $post_parent, $attr ) {
877
- /*
878
- * These are the parameters for the query
879
- */
880
- $default_arguments = array(
881
  'order' => 'ASC', // or 'DESC' or 'RAND'
882
  'orderby' => 'menu_order,ID',
883
  'id' => NULL,
@@ -929,7 +993,18 @@ class MLAShortcodes {
929
  // Search
930
  's' => ''
931
  );
932
-
 
 
 
 
 
 
 
 
 
 
 
933
  /*
934
  * Parameters passed to the where and orderby filter functions
935
  */
@@ -942,7 +1017,7 @@ class MLAShortcodes {
942
  if ( is_string( $attr ) )
943
  $attr = shortcode_parse_atts( $attr );
944
 
945
- $arguments = shortcode_atts( $default_arguments, $attr );
946
 
947
  /*
948
  * 'RAND' is not documented in the codex, but is present in the code.
@@ -1214,18 +1289,33 @@ class MLAShortcodes {
1214
  unset( $query_arguments['orderby'] );
1215
  unset( $query_arguments['order'] );
1216
 
1217
- add_filter( 'posts_orderby', 'MLAShortcodes::mla_shortcode_query_posts_orderby_filter' );
1218
- add_filter( 'posts_where', 'MLAShortcodes::mla_shortcode_query_posts_where_filter' );
 
 
 
 
 
 
 
 
 
 
 
 
1219
  $get_posts = new WP_Query;
1220
  $attachments = $get_posts->query($query_arguments);
1221
- remove_filter( 'posts_where', 'MLAShortcodes::mla_shortcode_query_posts_where_filter' );
1222
- remove_filter( 'posts_orderby', 'MLAShortcodes::mla_shortcode_query_posts_orderby_filter' );
1223
 
1224
  if ( self::$mla_debug ) {
1225
- self::$mla_debug_messages .= '<p><strong>mla_debug</strong> query = ' . var_export( $query_arguments, true ) . '</p>';
1226
- self::$mla_debug_messages .= '<p><strong>mla_debug</strong> request = ' . var_export( $get_posts->request, true ) . '</p>';
1227
- self::$mla_debug_messages .= '<p><strong>mla_debug</strong> query_vars = ' . var_export( $get_posts->query_vars, true ) . '</p>';
1228
- self::$mla_debug_messages .= '<p><strong>mla_debug</strong> post_count = ' . var_export( $get_posts->post_count, true ) . '</p>';
 
 
 
1229
  }
1230
 
1231
  return $attachments;
@@ -1250,7 +1340,7 @@ class MLAShortcodes {
1250
 
1251
  if ( self::$mla_debug ) {
1252
  $old_clause = $where_clause;
1253
- self::$mla_debug_messages .= '<p><strong>mla_debug</strong> WHERE filter = ' . var_export( $where_clause, true ) . '</p>';
1254
  }
1255
 
1256
  if ( strpos( $where_clause, "post_type = 'attachment'" ) ) {
@@ -1269,7 +1359,7 @@ class MLAShortcodes {
1269
  }
1270
 
1271
  if ( self::$mla_debug && ( $old_clause != $where_clause ) )
1272
- self::$mla_debug_messages .= '<p><strong>mla_debug</strong> modified WHERE filter = ' . var_export( $where_clause, true ) . '</p>';
1273
 
1274
  return $where_clause;
1275
  }
@@ -1289,12 +1379,52 @@ class MLAShortcodes {
1289
  public static function mla_shortcode_query_posts_orderby_filter( $orderby_clause ) {
1290
  global $wpdb;
1291
 
 
 
 
 
1292
  if ( isset( self::$query_parameters['orderby'] ) )
1293
  return self::$query_parameters['orderby'];
1294
  else
1295
  return $orderby_clause;
1296
  }
1297
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1298
  /**
1299
  * IPTC Dataset identifiers and names
1300
  *
167
  /*
168
  * These are the parameters for gallery display
169
  */
170
+ $mla_arguments = array(
 
 
 
 
 
 
 
171
  'mla_style' => MLAOptions::mla_get_option('default_style'),
172
  'mla_markup' => MLAOptions::mla_get_option('default_markup'),
173
  'mla_float' => is_rtl() ? 'right' : 'left',
183
  'mla_viewer_extensions' => 'doc,xls,ppt,pdf,txt',
184
  'mla_viewer_page' => '1',
185
  'mla_viewer_width' => '150',
186
+ 'mla_alt_shortcode' => NULL,
187
+ 'mla_alt_ids_name' => 'ids'
188
+ );
189
+
190
+ $default_arguments = array_merge( array(
191
+ 'size' => 'thumbnail', // or 'medium', 'large', 'full' or registered size
192
+ 'itemtag' => 'dl',
193
+ 'icontag' => 'dt',
194
+ 'captiontag' => 'dd',
195
+ 'columns' => 3,
196
+ 'link' => 'permalink', // or 'post' or file' or a registered size
197
  // Photonic-specific
198
  'id' => NULL,
199
  'style' => NULL,
200
+ 'type' => 'default', // also used by WordPress.com Jetpack!
201
  'thumb_width' => 75,
202
  'thumb_height' => 75,
203
  'thumbnail_size' => 'thumbnail',
206
  'fx' => 'fade',
207
  'timeout' => 4000,
208
  'speed' => 1000,
209
+ 'pause' => NULL),
210
+ $mla_arguments
211
  );
212
 
213
  /*
224
 
225
  if ( empty($attachments) ) {
226
  if ( self::$mla_debug ) {
227
+ $output = '<p><strong>mla_debug empty gallery</strong>, query = ' . var_export( $attr, true ) . '</p>';
228
  $output .= self::$mla_debug_messages;
229
  self::$mla_debug_messages = '';
230
  return $output;
234
  }
235
  } // empty $attachments
236
 
237
+ /*
238
+ * Look for user-specified alternate gallery shortcode
239
+ */
240
+ if ( is_string( $arguments['mla_alt_shortcode'] ) ) {
241
+ /*
242
+ * Replace data-selection parameters with the "ids" list
243
+ */
244
+ $blacklist = array_merge( $mla_arguments, self::$data_selection_parameters );
245
+ $new_args = '';
246
+ foreach ( $attr as $key => $value ) {
247
+ if ( array_key_exists( $key, $blacklist ) ) {
248
+ continue;
249
+ }
250
+
251
+ $slashed = addcslashes( $value, chr(0).chr(7).chr(8)."\f\n\r\t\v\"\\\$" );
252
+ if ( ( false !== strpos( $value, ' ' ) ) || ( false !== strpos( $value, '\'' ) ) || ( $slashed != $value ) ) {
253
+ $value = '"' . $slashed . '"';
254
+ }
255
+
256
+ $new_args .= empty( $new_args ) ? $key . '=' . $value : ' ' . $key . '=' . $value;
257
+ } // foreach $attr
258
+
259
+ $new_ids = '';
260
+ foreach ( $attachments as $value ) {
261
+ $new_ids .= empty( $new_ids ) ? (string) $value->ID : ',' . $value->ID;
262
+ } // foreach $attachments
263
+
264
+ $new_ids = $arguments['mla_alt_ids_name'] . '="' . $new_ids . '"';
265
+
266
+ /*
267
+ * Execute the alternate gallery shortcode with the new parameters
268
+ */
269
+ return do_shortcode( sprintf( '[%1$s %2$s %3$s]', $arguments['mla_alt_shortcode'], $new_ids, $new_args ) );
270
+ } // mla_alt_shortcode
271
+
272
  /*
273
  * Look for Photonic-enhanced gallery
274
  */
353
  'selector' => "mla_gallery-{$instance}",
354
  'size_class' => sanitize_html_class( $size_class )
355
  );
356
+
357
  $style_template = $gallery_style = '';
358
  $use_mla_gallery_style = ( 'none' != strtolower( $style_values['mla_style'] ) );
359
+ if ( apply_filters( 'use_mla_gallery_style', $use_mla_gallery_style, $style_values['mla_style'] ) ) {
360
  $style_template = MLAOptions::mla_fetch_gallery_template( $style_values['mla_style'], 'style' );
361
  if ( empty( $style_template ) ) {
362
  $style_values['mla_style'] = 'default';
364
  }
365
 
366
  if ( ! empty ( $style_template ) ) {
367
+ /*
368
+ * Look for 'query' substitution parameters
369
+ */
370
+ $placeholders = MLAData::mla_get_template_placeholders( $style_template );
371
+ foreach ($placeholders as $key => $value ) {
372
+ if ( 'query' == $value['prefix'] ) {
373
+ if ( isset( $attr[ $value['value'] ] ) )
374
+ $style_values[ $key ] = $attr[ $value['value'] ];
375
+ else
376
+ $style_values[ $key ] = '';
377
+ }
378
+ } // $placeholders
379
+
380
  $gallery_style = MLAData::mla_parse_template( $style_template, $style_values );
381
  } // !empty template
382
  } // use_mla_gallery_style
388
  $markup_values['base_dir'] = $upload_dir['basedir'];
389
 
390
  /*
391
+ * Variable 'query' placeholders can be anywhere in the markup template
392
  */
393
  $query_placeholders = array();
394
+
395
+ /*
396
+ * Variable item-level placeholders
397
+ */
398
+ $meta_placeholders = array();
399
  $terms_placeholders = array();
400
  $custom_placeholders = array();
401
  $iptc_placeholders = array();
402
  $exif_placeholders = array();
403
 
404
+ $open_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-open', 'markup' );
405
+ if ( false === $open_template ) {
406
  $markup_values['mla_markup'] = 'default';
407
+ $open_template = MLAOptions::mla_fetch_gallery_template( 'default-open', 'markup' );
408
  }
409
 
410
+ if ( empty( $open_template ) )
411
+ $open_template = '';
412
 
413
+ $row_open_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-row-open', 'markup' );
414
+ if ( empty( $row_open_template ) )
415
+ $row_open_template = '';
416
 
417
+ $item_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-item', 'markup' );
418
+ if ( empty( $item_template ) )
419
+ $item_template = '';
420
+
421
+ $row_close_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-row-close', 'markup' );
422
+ if ( empty( $row_close_template ) )
423
+ $row_close_template = '';
424
+
425
+ $close_template = MLAOptions::mla_fetch_gallery_template( $markup_values['mla_markup'] . '-close', 'markup' );
426
+ if ( empty( $close_template ) )
427
+ $close_template = '';
428
+
429
+ /*
430
+ * Look for variable query and item-level placeholders
431
+ */
432
+ $new_text = str_replace( '{+', '[+', str_replace( '+}', '+]', $arguments['mla_link_href'] . $arguments['mla_link_text'] . $arguments['mla_rollover_text'] . $arguments['mla_caption'] ) );
433
+
434
+ $placeholders = MLAData::mla_get_template_placeholders( $new_text . $open_template . $row_open_template . $item_template . $row_close_template . $close_template );
435
+ foreach ($placeholders as $key => $value ) {
436
+ switch ( $value['prefix'] ) {
437
+ case 'meta':
438
+ $meta_placeholders[ $key ] = $value;
439
+ break;
440
+ case 'query':
441
+ $query_placeholders[ $key ] = $value;
442
+ break;
443
+ case 'terms':
444
+ $terms_placeholders[ $key ] = $value;
445
+ break;
446
+ case 'custom':
447
+ $custom_placeholders[ $key ] = $value;
448
+ break;
449
+ case 'iptc':
450
+ $iptc_placeholders[ $key ] = $value;
451
+ break;
452
+ case 'exif':
453
+ $exif_placeholders[ $key ] = $value;
454
+ break;
455
+ default:
456
+ // ignore anything else
457
+ } // switch
458
+ } // $placeholders
459
 
460
+ /*
461
+ * Add 'query' placeholders
462
+ */
463
+ foreach ( $query_placeholders as $key => $value ) {
464
+ if ( isset( $attr[ $value['value'] ] ) )
465
+ $markup_values[ $key ] = $attr[ $value['value'] ];
466
+ else
467
+ $markup_values[ $key ] = '';
468
+ } // $query_placeholders
469
 
470
  if ( self::$mla_debug ) {
471
  $output = self::$mla_debug_messages;
474
  else
475
  $output = '';
476
 
477
+ if ( empty( $open_template ) )
478
+ $gallery_div = '';
479
+ else
480
+ $gallery_div = MLAData::mla_parse_template( $open_template, $markup_values );
481
+
482
+ $output .= apply_filters( 'mla_gallery_style', $gallery_style . $gallery_div, $style_values, $markup_values, $style_template, $open_template );
483
 
484
  $i = 0;
485
  foreach ( $attachments as $id => $attachment ) {
518
  $markup_values['author'] = 'unknown';
519
 
520
  $post_meta = MLAData::mla_fetch_attachment_metadata( $attachment->ID );
521
+ $base_file = $post_meta['mla_wp_attached_file'];
522
+ $sizes = isset( $post_meta['mla_wp_attachment_metadata']['sizes'] ) ? $post_meta['mla_wp_attachment_metadata']['sizes'] : array();
523
+
524
+ if ( !empty( $post_meta['mla_wp_attachment_metadata']['width'] ) )
525
  $markup_values['width'] = $post_meta['mla_wp_attachment_metadata']['width'];
526
+ if ( !empty( $post_meta['mla_wp_attachment_metadata']['height'] ) )
527
  $markup_values['height'] = $post_meta['mla_wp_attachment_metadata']['height'];
528
+ if ( !empty( $post_meta['mla_wp_attachment_metadata']['image_meta'] ) )
529
  $markup_values['image_meta'] = wptexturize( var_export( $post_meta['mla_wp_attachment_metadata']['image_meta'], true ) );
530
+ if ( !empty( $post_meta['mla_wp_attachment_image_alt'] ) )
 
 
 
 
 
 
531
  $markup_values['image_alt'] = wptexturize( $post_meta['mla_wp_attachment_image_alt'] );
532
 
533
  if ( ! empty( $base_file ) ) {
560
  /*
561
  * Add variable placeholders
562
  */
563
+ $image_metadata = get_metadata( 'post', $attachment->ID, '_wp_attachment_metadata', true );
564
+ foreach ( $meta_placeholders as $key => $value ) {
565
+ $markup_values[ $key ] = MLAData::mla_find_array_element( $value['value'], $image_metadata, $value['single'], $value['export'] );
566
+ } // $meta_placeholders */
 
 
567
 
568
  foreach ( $terms_placeholders as $key => $value ) {
569
  $text = '';
590
  if ( is_wp_error( $record ) || empty( $record ) )
591
  $text = '';
592
  elseif ( is_scalar( $record ) )
593
+ $text = sanitize_text_field( (string) $record );
594
  elseif ( is_array( $record ) ) {
595
  $text = '';
596
  foreach ( $record as $term ) {
692
 
693
  switch ( $arguments['link'] ) {
694
  case 'permalink':
695
+ case 'post':
696
  $markup_values['link'] = $markup_values['pagelink'];
697
  break;
698
  case 'file':
935
  }
936
 
937
  /**
938
+ * Data selection parameters for the WP_Query in [mla_gallery]
 
 
939
  *
940
+ * @since 1.30
 
941
  *
942
+ * @var array
943
  */
944
+ private static $data_selection_parameters = array(
 
 
 
 
945
  'order' => 'ASC', // or 'DESC' or 'RAND'
946
  'orderby' => 'menu_order,ID',
947
  'id' => NULL,
993
  // Search
994
  's' => ''
995
  );
996
+
997
+ /**
998
+ * Parses shortcode parameters and returns the gallery objects
999
+ *
1000
+ * @since .50
1001
+ *
1002
+ * @param int Post ID of the parent
1003
+ * @param array Attributes of the shortcode
1004
+ *
1005
+ * @return array List of attachments returned from WP_Query
1006
+ */
1007
+ public static function mla_get_shortcode_attachments( $post_parent, $attr ) {
1008
  /*
1009
  * Parameters passed to the where and orderby filter functions
1010
  */
1017
  if ( is_string( $attr ) )
1018
  $attr = shortcode_parse_atts( $attr );
1019
 
1020
+ $arguments = shortcode_atts( self::$data_selection_parameters, $attr );
1021
 
1022
  /*
1023
  * 'RAND' is not documented in the codex, but is present in the code.
1289
  unset( $query_arguments['orderby'] );
1290
  unset( $query_arguments['order'] );
1291
 
1292
+ if ( self::$mla_debug ) {
1293
+ add_filter( 'posts_clauses', 'MLAShortcodes::mla_shortcode_query_posts_clauses_filter', 0x7FFFFFFF, 1 );
1294
+ add_filter( 'posts_clauses_request', 'MLAShortcodes::mla_shortcode_query_posts_clauses_request_filter', 0x7FFFFFFF, 1 );
1295
+ }
1296
+
1297
+ add_filter( 'posts_orderby', 'MLAShortcodes::mla_shortcode_query_posts_orderby_filter', 0x7FFFFFFF, 1 );
1298
+ add_filter( 'posts_where', 'MLAShortcodes::mla_shortcode_query_posts_where_filter', 0x7FFFFFFF, 1 );
1299
+
1300
+ if ( self::$mla_debug ) {
1301
+ global $wp_filter;
1302
+ self::$mla_debug_messages .= '<p><strong>mla_debug $wp_filter[posts_where]</strong> = ' . var_export( $wp_filter['posts_where'], true ) . '</p>';
1303
+ self::$mla_debug_messages .= '<p><strong>mla_debug $wp_filter[posts_orderby]</strong> = ' . var_export( $wp_filter['posts_orderby'], true ) . '</p>';
1304
+ }
1305
+
1306
  $get_posts = new WP_Query;
1307
  $attachments = $get_posts->query($query_arguments);
1308
+ remove_filter( 'posts_where', 'MLAShortcodes::mla_shortcode_query_posts_where_filter', 0x7FFFFFFF, 1 );
1309
+ remove_filter( 'posts_orderby', 'MLAShortcodes::mla_shortcode_query_posts_orderby_filter', 0x7FFFFFFF, 1 );
1310
 
1311
  if ( self::$mla_debug ) {
1312
+ remove_filter( 'posts_clauses', 'MLAShortcodes::mla_shortcode_query_posts_clauses_filter', 0x7FFFFFFF, 1 );
1313
+ remove_filter( 'posts_clauses_request', 'MLAShortcodes::mla_shortcode_query_posts_clauses_request_filter', 0x7FFFFFFF, 1 );
1314
+
1315
+ self::$mla_debug_messages .= '<p><strong>mla_debug query</strong> = ' . var_export( $query_arguments, true ) . '</p>';
1316
+ self::$mla_debug_messages .= '<p><strong>mla_debug request</strong> = ' . var_export( $get_posts->request, true ) . '</p>';
1317
+ self::$mla_debug_messages .= '<p><strong>mla_debug query_vars</strong> = ' . var_export( $get_posts->query_vars, true ) . '</p>';
1318
+ self::$mla_debug_messages .= '<p><strong>mla_debug post_count</strong> = ' . var_export( $get_posts->post_count, true ) . '</p>';
1319
  }
1320
 
1321
  return $attachments;
1340
 
1341
  if ( self::$mla_debug ) {
1342
  $old_clause = $where_clause;
1343
+ self::$mla_debug_messages .= '<p><strong>mla_debug WHERE filter</strong> = ' . var_export( $where_clause, true ) . '</p>';
1344
  }
1345
 
1346
  if ( strpos( $where_clause, "post_type = 'attachment'" ) ) {
1359
  }
1360
 
1361
  if ( self::$mla_debug && ( $old_clause != $where_clause ) )
1362
+ self::$mla_debug_messages .= '<p><strong>mla_debug modified WHERE filter</strong> = ' . var_export( $where_clause, true ) . '</p>';
1363
 
1364
  return $where_clause;
1365
  }
1379
  public static function mla_shortcode_query_posts_orderby_filter( $orderby_clause ) {
1380
  global $wpdb;
1381
 
1382
+ if ( self::$mla_debug ) {
1383
+ self::$mla_debug_messages .= '<p><strong>mla_debug ORDER BY filter, incoming</strong> = ' . var_export( $orderby_clause, true ) . '<br>Replacement ORDER BY clause = ' . var_export( self::$query_parameters['orderby'], true ) . '</p>';
1384
+ }
1385
+
1386
  if ( isset( self::$query_parameters['orderby'] ) )
1387
  return self::$query_parameters['orderby'];
1388
  else
1389
  return $orderby_clause;
1390
  }
1391
 
1392
+ /**
1393
+ * Filters all clauses for shortcode queries, pre caching plugins
1394
+ *
1395
+ * This is for debug purposes only.
1396
+ * Defined as public because it's a filter.
1397
+ *
1398
+ * @since 1.30
1399
+ *
1400
+ * @param array query clauses before modification
1401
+ *
1402
+ * @return array query clauses after modification (none)
1403
+ */
1404
+ public static function mla_shortcode_query_posts_clauses_filter( $pieces ) {
1405
+ self::$mla_debug_messages .= '<p><strong>mla_debug posts_clauses filter</strong> = ' . var_export( $pieces, true ) . '</p>';
1406
+
1407
+ return $pieces;
1408
+ }
1409
+
1410
+ /**
1411
+ * Filters all clauses for shortcode queries, post caching plugins
1412
+ *
1413
+ * This is for debug purposes only.
1414
+ * Defined as public because it's a filter.
1415
+ *
1416
+ * @since 1.30
1417
+ *
1418
+ * @param array query clauses before modification
1419
+ *
1420
+ * @return array query clauses after modification (none)
1421
+ */
1422
+ public static function mla_shortcode_query_posts_clauses_request_filter( $pieces ) {
1423
+ self::$mla_debug_messages .= '<p><strong>mla_debug posts_clauses_request filter</strong> = ' . var_export( $pieces, true ) . '</p>';
1424
+
1425
+ return $pieces;
1426
+ }
1427
+
1428
  /**
1429
  * IPTC Dataset identifiers and names
1430
  *
index.php CHANGED
@@ -6,7 +6,7 @@
6
  * will the rest of the plugin be loaded and run.
7
  *
8
  * @package Media Library Assistant
9
- * @version 1.20
10
  */
11
 
12
  /*
@@ -14,7 +14,7 @@ Plugin Name: Media Library Assistant
14
  Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
15
  Description: Enhances the Media Library; powerful[mla_gallery], taxonomy support, IPTC/EXIF processing, bulk & quick edit actions and where-used reporting.
16
  Author: David Lingren
17
- Version: 1.20
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.30
10
  */
11
 
12
  /*
14
  Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
15
  Description: Enhances the Media Library; powerful[mla_gallery], taxonomy support, IPTC/EXIF processing, bulk & quick edit actions and where-used reporting.
16
  Author: David Lingren
17
+ Version: 1.30
18
  Author URI: http://fairtradejudaica.org/our-story/staff/
19
  */
20
 
js/mla-media-modal-scripts.js CHANGED
@@ -183,6 +183,7 @@
183
  mlaSettings.searchValue = event.target.value;
184
  case 'mla_search_submit':
185
  this.model.set({
 
186
  'mla_search_value': mlaSettings.searchValue,
187
  'mla_search_fields': mlaSettings.searchFields,
188
  'mla_search_connector': mlaSettings.searchConnector });
183
  mlaSettings.searchValue = event.target.value;
184
  case 'mla_search_submit':
185
  this.model.set({
186
+ 's': mlaSettings.searchValue + mlaSettings.searchFields + mlaSettings.searchConnector,
187
  'mla_search_value': mlaSettings.searchValue,
188
  'mla_search_fields': mlaSettings.searchFields,
189
  'mla_search_connector': mlaSettings.searchConnector });
js/mla-media-modal-scripts.min.js CHANGED
@@ -1 +1 @@
1
- (function(b){var d=wp.media,c={},a={};c=typeof d.view.l10n.mla_strings==="undefined"?{}:d.view.l10n.mla_strings;delete d.view.l10n.mla_strings;a=typeof wp.media.view.settings.mla_settings==="undefined"?{}:wp.media.view.settings.mla_settings;delete wp.media.view.settings.mla_settings;d.view.AttachmentFilters.Mla=d.view.AttachmentFilters.extend({createFilters:function(){var e={};_.each(a.mimeTypes||{},function(g,f){e[f]={text:g,props:{type:f,uploadedTo:null,orderby:"date",order:"DESC"}}});e.all={text:d.view.l10n.allMediaItems,props:{type:null,uploadedTo:null,orderby:"date",order:"DESC"},priority:10};e.uploaded={text:d.view.l10n.uploadedToThisPost,props:{type:null,uploadedTo:d.view.settings.post.id,orderby:"menuOrder",order:"ASC"},priority:20};this.filters=e}});d.view.AttachmentFilters.MlaMonths=d.view.AttachmentFilters.extend({className:"attachment-months",createFilters:function(){var e={};_.each(a.months||{},function(g,f){e[f]={text:g,props:{m:f,}}});this.filters=e},select:function(){var e=this.model,g="0",f=e.toJSON();_.find(this.filters,function(i,j){var h=_.all(i.props,function(l,k){return l===(_.isUndefined(f[k])?null:f[k])});if(h){return g=j}});this.$el.val(g)}});d.view.AttachmentFilters.MlaTerms=d.view.AttachmentFilters.extend({className:"attachment-terms",createFilters:function(){var e={};_.each(a.termsText||{},function(g,f){e[f]={text:g,props:{mla_filter_term:parseInt(a.termsValue[f]),}}});this.filters=e},select:function(){var e=this.model,g="0",f=e.toJSON();_.find(this.filters,function(i,j){var h=_.all(i.props,function(l,k){return l===(_.isUndefined(f[k])?null:f[k])});if(h){return g=j}});this.$el.val(g)}});d.view.MlaSearch=d.View.extend({tagName:"div",className:"mla-search-box",template:d.template("mla-search-box"),attributes:{type:"mla-search-box",placeholder:c.searchBoxPlaceholder},events:{change:"search",click:"search",search:"search",MlaSearch:"search"},render:function(){this.$el.html(this.template());return this},search:function(e){if(("click"==e.type)&&("mla_search_submit"!=e.target.name)){return}switch(e.target.name){case"mla_search_value":a.searchValue=e.target.value;case"mla_search_submit":this.model.set({mla_search_value:a.searchValue,mla_search_fields:a.searchFields,mla_search_connector:a.searchConnector});break;case"mla_search_connector":a.searchConnector=e.target.value;break;case"mla_search_title":index=a.searchFields.indexOf("title");if(-1==index){a.searchFields.push("title")}else{a.searchFields.splice(index,1)}break;case"mla_search_name":index=a.searchFields.indexOf("name");if(-1==index){a.searchFields.push("name")}else{a.searchFields.splice(index,1)}break;case"mla_search_alt_text":index=a.searchFields.indexOf("alt-text");if(-1==index){a.searchFields.push("alt-text")}else{a.searchFields.splice(index,1)}break;case"mla_search_excerpt":index=a.searchFields.indexOf("excerpt");if(-1==index){a.searchFields.push("excerpt")}else{a.searchFields.splice(index,1)}break;case"mla_search_content":index=a.searchFields.indexOf("content");if(-1==index){a.searchFields.push("content")}else{a.searchFields.splice(index,1)}break}}});d.view.AttachmentsBrowser=d.view.AttachmentsBrowser.extend({createToolbar:function(){var f,e;d.model.Query.defaultArgs.mla_source="MLA";if(a.enableSearchBox){d.model.Query.defaultArgs.mla_search_value=a.searchValue;d.model.Query.defaultArgs.mla_search_fields=a.searchFields;d.model.Query.defaultArgs.mla_search_connector=a.searchConnector}this.toolbar=new d.view.Toolbar({controller:this.controller});this.views.add(this.toolbar);f=this.options.filters;if("uploaded"===f){e=d.view.AttachmentFilters.Uploaded}else{if("all"===f){if(a.enableMimeTypes){e=d.view.AttachmentFilters.Mla}else{e=d.view.AttachmentFilters.All}}}if(e){this.toolbar.set("filters",new e({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(f&&a.enableMonthsDropdown){this.toolbar.set("months",new d.view.AttachmentFilters.MlaMonths({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(f&&a.enableTermsDropdown){this.toolbar.set("terms",new d.view.AttachmentFilters.MlaTerms({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(this.options.search){if(a.enableSearchBox){this.toolbar.set("MlaSearch",new d.view.MlaSearch({controller:this.controller,model:this.collection.props,priority:60}).render())}else{this.toolbar.set("search",new d.view.Search({controller:this.controller,model:this.collection.props,priority:60}).render())}}if(this.options.dragInfo){this.toolbar.set("dragInfo",new d.View({el:b('<div class="instructions">'+d.view.l10n.dragInfo+"</div>")[0],priority:-40}))}}})}(jQuery));
1
+ (function(b){var d=wp.media,c={},a={};c=typeof d.view.l10n.mla_strings==="undefined"?{}:d.view.l10n.mla_strings;delete d.view.l10n.mla_strings;a=typeof wp.media.view.settings.mla_settings==="undefined"?{}:wp.media.view.settings.mla_settings;delete wp.media.view.settings.mla_settings;d.view.AttachmentFilters.Mla=d.view.AttachmentFilters.extend({createFilters:function(){var e={};_.each(a.mimeTypes||{},function(g,f){e[f]={text:g,props:{type:f,uploadedTo:null,orderby:"date",order:"DESC"}}});e.all={text:d.view.l10n.allMediaItems,props:{type:null,uploadedTo:null,orderby:"date",order:"DESC"},priority:10};e.uploaded={text:d.view.l10n.uploadedToThisPost,props:{type:null,uploadedTo:d.view.settings.post.id,orderby:"menuOrder",order:"ASC"},priority:20};this.filters=e}});d.view.AttachmentFilters.MlaMonths=d.view.AttachmentFilters.extend({className:"attachment-months",createFilters:function(){var e={};_.each(a.months||{},function(g,f){e[f]={text:g,props:{m:f,}}});this.filters=e},select:function(){var e=this.model,g="0",f=e.toJSON();_.find(this.filters,function(i,j){var h=_.all(i.props,function(l,k){return l===(_.isUndefined(f[k])?null:f[k])});if(h){return g=j}});this.$el.val(g)}});d.view.AttachmentFilters.MlaTerms=d.view.AttachmentFilters.extend({className:"attachment-terms",createFilters:function(){var e={};_.each(a.termsText||{},function(g,f){e[f]={text:g,props:{mla_filter_term:parseInt(a.termsValue[f]),}}});this.filters=e},select:function(){var e=this.model,g="0",f=e.toJSON();_.find(this.filters,function(i,j){var h=_.all(i.props,function(l,k){return l===(_.isUndefined(f[k])?null:f[k])});if(h){return g=j}});this.$el.val(g)}});d.view.MlaSearch=d.View.extend({tagName:"div",className:"mla-search-box",template:d.template("mla-search-box"),attributes:{type:"mla-search-box",placeholder:c.searchBoxPlaceholder},events:{change:"search",click:"search",search:"search",MlaSearch:"search"},render:function(){this.$el.html(this.template());return this},search:function(e){if(("click"==e.type)&&("mla_search_submit"!=e.target.name)){return}switch(e.target.name){case"mla_search_value":a.searchValue=e.target.value;case"mla_search_submit":this.model.set({s:a.searchValue+a.searchFields+a.searchConnector,mla_search_value:a.searchValue,mla_search_fields:a.searchFields,mla_search_connector:a.searchConnector});break;case"mla_search_connector":a.searchConnector=e.target.value;break;case"mla_search_title":index=a.searchFields.indexOf("title");if(-1==index){a.searchFields.push("title")}else{a.searchFields.splice(index,1)}break;case"mla_search_name":index=a.searchFields.indexOf("name");if(-1==index){a.searchFields.push("name")}else{a.searchFields.splice(index,1)}break;case"mla_search_alt_text":index=a.searchFields.indexOf("alt-text");if(-1==index){a.searchFields.push("alt-text")}else{a.searchFields.splice(index,1)}break;case"mla_search_excerpt":index=a.searchFields.indexOf("excerpt");if(-1==index){a.searchFields.push("excerpt")}else{a.searchFields.splice(index,1)}break;case"mla_search_content":index=a.searchFields.indexOf("content");if(-1==index){a.searchFields.push("content")}else{a.searchFields.splice(index,1)}break}}});d.view.AttachmentsBrowser=d.view.AttachmentsBrowser.extend({createToolbar:function(){var f,e;d.model.Query.defaultArgs.mla_source="MLA";if(a.enableSearchBox){d.model.Query.defaultArgs.mla_search_value=a.searchValue;d.model.Query.defaultArgs.mla_search_fields=a.searchFields;d.model.Query.defaultArgs.mla_search_connector=a.searchConnector}this.toolbar=new d.view.Toolbar({controller:this.controller});this.views.add(this.toolbar);f=this.options.filters;if("uploaded"===f){e=d.view.AttachmentFilters.Uploaded}else{if("all"===f){if(a.enableMimeTypes){e=d.view.AttachmentFilters.Mla}else{e=d.view.AttachmentFilters.All}}}if(e){this.toolbar.set("filters",new e({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(f&&a.enableMonthsDropdown){this.toolbar.set("months",new d.view.AttachmentFilters.MlaMonths({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(f&&a.enableTermsDropdown){this.toolbar.set("terms",new d.view.AttachmentFilters.MlaTerms({controller:this.controller,model:this.collection.props,priority:-80}).render())}if(this.options.search){if(a.enableSearchBox){this.toolbar.set("MlaSearch",new d.view.MlaSearch({controller:this.controller,model:this.collection.props,priority:60}).render())}else{this.toolbar.set("search",new d.view.Search({controller:this.controller,model:this.collection.props,priority:60}).render())}}if(this.options.dragInfo){this.toolbar.set("dragInfo",new d.View({el:b('<div class="instructions">'+d.view.l10n.dragInfo+"</div>")[0],priority:-40}))}}})}(jQuery));
phpDocs/classes/MLA.html CHANGED
@@ -407,7 +407,7 @@ change the meta data for a single attachment.</h2>
407
  <pre>_display_single_item(int $post_id) : array</pre>
408
  <div class="labels"></div>
409
  <div class="row collapse"><div class="detail-description">
410
- <p class="long_description"></p>
411
  <table class="table table-bordered"><tr>
412
  <th>since</th>
413
  <td>0.1</td>
@@ -674,7 +674,7 @@ change the meta data for a single attachment.</h2>
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-03-29T17:10:59-07:00.<br></footer></div>
678
  </div>
679
  </body>
680
  </html>
407
  <pre>_display_single_item(int $post_id) : array</pre>
408
  <div class="labels"></div>
409
  <div class="row collapse"><div class="detail-description">
410
+ <p class="long_description"><p>This function is not used in WordPress 3.5 and later.</p></p>
411
  <table class="table table-bordered"><tr>
412
  <th>since</th>
413
  <td>0.1</td>
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-04-22T17:09:54-07:00.<br></footer></div>
678
  </div>
679
  </body>
680
  </html>
phpDocs/classes/MLAData.html CHANGED
@@ -59,6 +59,7 @@
59
  <li class="method public "><a href="#mla_fetch_attachment_metadata" title="mla_fetch_attachment_metadata :: Fetch and filter meta data for an attachment"><span class="description">Fetch and filter meta data for an attachment</span><pre>mla_fetch_attachment_metadata()</pre></a></li>
60
  <li class="method public "><a href="#mla_fetch_attachment_parent_data" title="mla_fetch_attachment_parent_data :: Returns information about an attachment's parent, if found"><span class="description">Returns information about an attachment's parent, if found</span><pre>mla_fetch_attachment_parent_data()</pre></a></li>
61
  <li class="method public "><a href="#mla_fetch_attachment_references" title="mla_fetch_attachment_references :: Find Featured Image and inserted image/link references to an attachment"><span class="description">Find Featured Image and inserted image/link references to an attachment</span><pre>mla_fetch_attachment_references()</pre></a></li>
 
62
  <li class="method public "><a href="#mla_flush_mla_galleries" title="mla_flush_mla_galleries :: Invalidates the $mla_galleries or $galleries array and cached values"><span class="description">Invalidates the $mla_galleries or $galleries array and cached values</span><pre>mla_flush_mla_galleries()</pre></a></li>
63
  <li class="method public "><a href="#mla_get_attachment_by_id" title="mla_get_attachment_by_id :: Retrieve an Attachment array given a $post_id"><span class="description">Retrieve an Attachment array given a $post_id</span><pre>mla_get_attachment_by_id()</pre></a></li>
64
  <li class="method public "><a href="#mla_get_template_placeholders" title="mla_get_template_placeholders :: Analyze a template, returning an array of the place holders it contains"><span class="description">Analyze a template, returning an array of the place holders it contains</span><pre>mla_get_template_placeholders()</pre></a></li>
@@ -264,6 +265,36 @@ as a Featured Image or inserted in the post as an image or link.</p></p>
264
  <code>array</code>Reference information; see $references array comments</div>
265
  </div></div>
266
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
267
  <a name="mla_flush_mla_galleries" id="mla_flush_mla_galleries"></a><div class="element clickable method public mla_flush_mla_galleries" data-toggle="collapse" data-target=".mla_flush_mla_galleries .collapse">
268
  <h2>Invalidates the $mla_galleries or $galleries array and cached values</h2>
269
  <pre>mla_flush_mla_galleries(string $option_name) : void</pre>
@@ -795,7 +826,7 @@ any further logic required to translate those values is contained in the filters
795
  <div class="row"><footer class="span12">
796
  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>
797
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
798
- generated on 2013-03-29T17:10:59-07:00.<br></footer></div>
799
  </div>
800
  </body>
801
  </html>
59
  <li class="method public "><a href="#mla_fetch_attachment_metadata" title="mla_fetch_attachment_metadata :: Fetch and filter meta data for an attachment"><span class="description">Fetch and filter meta data for an attachment</span><pre>mla_fetch_attachment_metadata()</pre></a></li>
60
  <li class="method public "><a href="#mla_fetch_attachment_parent_data" title="mla_fetch_attachment_parent_data :: Returns information about an attachment's parent, if found"><span class="description">Returns information about an attachment's parent, if found</span><pre>mla_fetch_attachment_parent_data()</pre></a></li>
61
  <li class="method public "><a href="#mla_fetch_attachment_references" title="mla_fetch_attachment_references :: Find Featured Image and inserted image/link references to an attachment"><span class="description">Find Featured Image and inserted image/link references to an attachment</span><pre>mla_fetch_attachment_references()</pre></a></li>
62
+ <li class="method public "><a href="#mla_find_array_element" title="mla_find_array_element :: Finds the value of a key in a possibily nested array structure"><span class="description">Finds the value of a key in a possibily nested array structure</span><pre>mla_find_array_element()</pre></a></li>
63
  <li class="method public "><a href="#mla_flush_mla_galleries" title="mla_flush_mla_galleries :: Invalidates the $mla_galleries or $galleries array and cached values"><span class="description">Invalidates the $mla_galleries or $galleries array and cached values</span><pre>mla_flush_mla_galleries()</pre></a></li>
64
  <li class="method public "><a href="#mla_get_attachment_by_id" title="mla_get_attachment_by_id :: Retrieve an Attachment array given a $post_id"><span class="description">Retrieve an Attachment array given a $post_id</span><pre>mla_get_attachment_by_id()</pre></a></li>
65
  <li class="method public "><a href="#mla_get_template_placeholders" title="mla_get_template_placeholders :: Analyze a template, returning an array of the place holders it contains"><span class="description">Analyze a template, returning an array of the place holders it contains</span><pre>mla_get_template_placeholders()</pre></a></li>
265
  <code>array</code>Reference information; see $references array comments</div>
266
  </div></div>
267
  </div>
268
+ <a name="mla_find_array_element" id="mla_find_array_element"></a><div class="element clickable method public mla_find_array_element" data-toggle="collapse" data-target=".mla_find_array_element .collapse">
269
+ <h2>Finds the value of a key in a possibily nested array structure</h2>
270
+ <pre>mla_find_array_element(string $needle, array $haystack, boolean $single, boolean $export) : string</pre>
271
+ <div class="labels"></div>
272
+ <div class="row collapse"><div class="detail-description">
273
+ <p class="long_description"><p>Used primarily to extract fields from the _wp_attachment_metadata custom field.
274
+ Could also be used with the ID3 metadata exposed in WordPress 3.6 and later.</p></p>
275
+ <table class="table table-bordered"><tr>
276
+ <th>since</th>
277
+ <td>1.30</td>
278
+ </tr></table>
279
+ <h3>Parameters</h3>
280
+ <div class="subelement argument">
281
+ <h4>$needle</h4>
282
+ <code>string</code><p>key value, e.g. array1.array2.element</p></div>
283
+ <div class="subelement argument">
284
+ <h4>$haystack</h4>
285
+ <code>array</code><p>PHP nested arrays</p></div>
286
+ <div class="subelement argument">
287
+ <h4>$single</h4>
288
+ <code>boolean</code><p>return first element of an array result</p></div>
289
+ <div class="subelement argument">
290
+ <h4>$export</h4>
291
+ <code>boolean</code><p>return results in var_export() format</p>
292
+ </div>
293
+ <h3>Returns</h3>
294
+ <div class="subelement response">
295
+ <code>string</code>value matching key(.key ...) or ''</div>
296
+ </div></div>
297
+ </div>
298
  <a name="mla_flush_mla_galleries" id="mla_flush_mla_galleries"></a><div class="element clickable method public mla_flush_mla_galleries" data-toggle="collapse" data-target=".mla_flush_mla_galleries .collapse">
299
  <h2>Invalidates the $mla_galleries or $galleries array and cached values</h2>
300
  <pre>mla_flush_mla_galleries(string $option_name) : void</pre>
826
  <div class="row"><footer class="span12">
827
  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>
828
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
829
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
830
  </div>
831
  </body>
832
  </html>
phpDocs/classes/MLAEdit.html CHANGED
@@ -342,7 +342,7 @@ The array is built once each page load and cached for subsequent calls.</p></p>
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-03-29T17:10:59-07:00.<br></footer></div>
346
  </div>
347
  </body>
348
  </html>
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-04-22T17:09:54-07:00.<br></footer></div>
346
  </div>
347
  </body>
348
  </html>
phpDocs/classes/MLAModal.html CHANGED
@@ -307,7 +307,7 @@ and mla_print_media_templates_action</h2>
307
  <div class="row"><footer class="span12">
308
  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>
309
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
310
- generated on 2013-03-29T17:11:00-07:00.<br></footer></div>
311
  </div>
312
  </body>
313
  </html>
307
  <div class="row"><footer class="span12">
308
  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>
309
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
310
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
311
  </div>
312
  </body>
313
  </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 2013-03-29T17:11:00-07:00.<br></footer></div>
171
  </div>
172
  </body>
173
  </html>
167
  <div class="row"><footer class="span12">
168
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
169
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
170
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
171
  </div>
172
  </body>
173
  </html>
phpDocs/classes/MLAOptions.html CHANGED
@@ -576,7 +576,7 @@ settings are being updated or reset.</h2>
576
  </div>
577
  <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">
578
  <h2>Compose a Custom Field Options list with current selection</h2>
579
- <pre>_compose_custom_field_option_list(string $selection) : string</pre>
580
  <div class="labels"></div>
581
  <div class="row collapse"><div class="detail-description">
582
  <p class="long_description"></p>
@@ -595,6 +595,9 @@ settings are being updated or reset.</h2>
595
  <h4>$selection</h4>
596
  <code>string</code><p>current selection or 'none' (default)</p>
597
  </div>
 
 
 
598
  <h3>Returns</h3>
599
  <div class="subelement response">
600
  <code>string</code>HTML markup with select field options</div>
@@ -683,7 +686,7 @@ settings are being updated or reset.</h2>
683
  </div>
684
  <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">
685
  <h2>Evaluate custom field mapping data source</h2>
686
- <pre>_evaluate_data_source(integer $post_id, string $category, string $data_source, string $format, array $attachment_metadata) : string</pre>
687
  <div class="labels"></div>
688
  <div class="row collapse"><div class="detail-description">
689
  <p class="long_description"></p>
@@ -701,11 +704,8 @@ settings are being updated or reset.</h2>
701
  <code>string</code><p>category/scope to evaluate against: custom_field_mapping or single_attachment_mapping</p>
702
  </div>
703
  <div class="subelement argument">
704
- <h4>$data_source</h4>
705
- <code>string</code><p>data source name</p></div>
706
- <div class="subelement argument">
707
- <h4>$format</h4>
708
- <code>string</code><p>desired results format, default 'native'</p>
709
  </div>
710
  <div class="subelement argument">
711
  <h4>$attachment_metadata</h4>
@@ -1042,7 +1042,7 @@ reset => reset function for 'custom' options; returns nothing. Usage:
1042
  <div class="row"><footer class="span12">
1043
  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>
1044
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1045
- generated on 2013-03-29T17:11:00-07:00.<br></footer></div>
1046
  </div>
1047
  </body>
1048
  </html>
576
  </div>
577
  <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">
578
  <h2>Compose a Custom Field Options list with current selection</h2>
579
+ <pre>_compose_custom_field_option_list(string $selection, array $blacklist) : string</pre>
580
  <div class="labels"></div>
581
  <div class="row collapse"><div class="detail-description">
582
  <p class="long_description"></p>
595
  <h4>$selection</h4>
596
  <code>string</code><p>current selection or 'none' (default)</p>
597
  </div>
598
+ <div class="subelement argument">
599
+ <h4>$blacklist</h4>
600
+ <code>array</code><p>optional list of terms to exclude from the list</p></div>
601
  <h3>Returns</h3>
602
  <div class="subelement response">
603
  <code>string</code>HTML markup with select field options</div>
686
  </div>
687
  <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">
688
  <h2>Evaluate custom field mapping data source</h2>
689
+ <pre>_evaluate_data_source(integer $post_id, string $category, array $data_value, array $attachment_metadata) : string</pre>
690
  <div class="labels"></div>
691
  <div class="row collapse"><div class="detail-description">
692
  <p class="long_description"></p>
704
  <code>string</code><p>category/scope to evaluate against: custom_field_mapping or single_attachment_mapping</p>
705
  </div>
706
  <div class="subelement argument">
707
+ <h4>$data_value</h4>
708
+ <code>array</code><p>data source specification (name, format, meta_name, meta_single, meta_export)</p>
 
 
 
709
  </div>
710
  <div class="subelement argument">
711
  <h4>$attachment_metadata</h4>
1042
  <div class="row"><footer class="span12">
1043
  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>
1044
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1045
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
1046
  </div>
1047
  </body>
1048
  </html>
phpDocs/classes/MLASettings.html CHANGED
@@ -85,6 +85,7 @@ without saving the settings to the mla_option</span><pre>_process_iptc_exif_taxo
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>
89
  <li class="method private "><a href="#_update_option_row" title="_update_option_row :: Update or delete a single MLA option value"><span class="description">Update or delete a single MLA option value</span><pre>_update_option_row()</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>
@@ -419,7 +420,7 @@ without saving the settings to the mla_option</h2>
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">
420
  <h2>Process IPTC/EXIF custom field settings against all image attachments
421
  without saving the settings to the mla_option</h2>
422
- <pre>_process_iptc_exif_custom() : array</pre>
423
  <div class="labels"></div>
424
  <div class="row collapse"><div class="detail-description">
425
  <p class="long_description"></p>
@@ -433,6 +434,10 @@ without saving the settings to the mla_option</h2>
433
  <td>\global\$_REQUEST</td>
434
  </tr>
435
  </table>
 
 
 
 
436
  <h3>Returns</h3>
437
  <div class="subelement response">
438
  <code>array</code>Message(s) reflecting the results of the operation</div>
@@ -564,6 +569,25 @@ without saving the settings to the mla_option</h2>
564
  <code>array</code>Message(s) reflecting the results of the operation</div>
565
  </div></div>
566
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
567
  <a name="_save_iptc_exif_settings" id="_save_iptc_exif_settings"></a><div class="element clickable method private _save_iptc_exif_settings" data-toggle="collapse" data-target="._save_iptc_exif_settings .collapse">
568
  <h2>Save IPTC/EXIF settings to the options table</h2>
569
  <pre>_save_iptc_exif_settings() : array</pre>
@@ -674,7 +698,7 @@ each page load and cached for subsequent use.</p></p>
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-03-29T17:11:00-07:00.<br></footer></div>
678
  </div>
679
  </body>
680
  </html>
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_custom_settings" title="_save_iptc_exif_custom_settings :: Save IPTC/EXIF custom field settings to the options table"><span class="description">Save IPTC/EXIF custom field settings to the options table</span><pre>_save_iptc_exif_custom_settings()</pre></a></li>
89
  <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="#_update_option_row" title="_update_option_row :: Update or delete a single MLA option value"><span class="description">Update or delete a single MLA option value</span><pre>_update_option_row()</pre></a></li>
91
  <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>
420
  <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">
421
  <h2>Process IPTC/EXIF custom field settings against all image attachments
422
  without saving the settings to the mla_option</h2>
423
+ <pre>_process_iptc_exif_custom(array $settings) : array</pre>
424
  <div class="labels"></div>
425
  <div class="row collapse"><div class="detail-description">
426
  <p class="long_description"></p>
434
  <td>\global\$_REQUEST</td>
435
  </tr>
436
  </table>
437
+ <h3>Parameters</h3>
438
+ <div class="subelement argument">
439
+ <h4>$settings</h4>
440
+ <code>array</code><p>| NULL specific iptc_exif_custom_mapping values</p></div>
441
  <h3>Returns</h3>
442
  <div class="subelement response">
443
  <code>array</code>Message(s) reflecting the results of the operation</div>
569
  <code>array</code>Message(s) reflecting the results of the operation</div>
570
  </div></div>
571
  </div>
572
+ <a name="_save_iptc_exif_custom_settings" id="_save_iptc_exif_custom_settings"></a><div class="element clickable method private _save_iptc_exif_custom_settings" data-toggle="collapse" data-target="._save_iptc_exif_custom_settings .collapse">
573
+ <h2>Save IPTC/EXIF custom field settings to the options table</h2>
574
+ <pre>_save_iptc_exif_custom_settings(array $new_values) : array</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"><tr>
579
+ <th>since</th>
580
+ <td>1.30</td>
581
+ </tr></table>
582
+ <h3>Parameters</h3>
583
+ <div class="subelement argument">
584
+ <h4>$new_values</h4>
585
+ <code>array</code><p>specific iptc_exif_custom_mapping values</p></div>
586
+ <h3>Returns</h3>
587
+ <div class="subelement response">
588
+ <code>array</code>Message(s) reflecting the results of the operation</div>
589
+ </div></div>
590
+ </div>
591
  <a name="_save_iptc_exif_settings" id="_save_iptc_exif_settings"></a><div class="element clickable method private _save_iptc_exif_settings" data-toggle="collapse" data-target="._save_iptc_exif_settings .collapse">
592
  <h2>Save IPTC/EXIF settings to the options table</h2>
593
  <pre>_save_iptc_exif_settings() : array</pre>
698
  <div class="row"><footer class="span12">
699
  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>
700
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
701
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
702
  </div>
703
  </body>
704
  </html>
phpDocs/classes/MLAShortcodes.html CHANGED
@@ -56,6 +56,8 @@
56
  <li class="method public "><a href="#mla_attachment_list_shortcode" title="mla_attachment_list_shortcode :: WordPress Shortcode; renders a complete list of all attachments and references to them"><span class="description">WordPress Shortcode; renders a complete list of all attachments and references to them</span><pre>mla_attachment_list_shortcode()</pre></a></li>
57
  <li class="method public "><a href="#mla_gallery_shortcode" title="mla_gallery_shortcode :: The MLA Gallery shortcode."><span class="description">The MLA Gallery shortcode.</span><pre>mla_gallery_shortcode()</pre></a></li>
58
  <li class="method public "><a href="#mla_get_shortcode_attachments" title="mla_get_shortcode_attachments :: Parses shortcode parameters and returns the gallery objects"><span class="description">Parses shortcode parameters and returns the gallery objects</span><pre>mla_get_shortcode_attachments()</pre></a></li>
 
 
59
  <li class="method public "><a href="#mla_shortcode_query_posts_orderby_filter" title="mla_shortcode_query_posts_orderby_filter :: Filters the ORDERBY clause for shortcode queries"><span class="description">Filters the ORDERBY clause for shortcode queries</span><pre>mla_shortcode_query_posts_orderby_filter()</pre></a></li>
60
  <li class="method public "><a href="#mla_shortcode_query_posts_where_filter" title="mla_shortcode_query_posts_where_filter :: Filters the WHERE clause for shortcode queries"><span class="description">Filters the WHERE clause for shortcode queries</span><pre>mla_shortcode_query_posts_where_filter()</pre></a></li>
61
  <li class="nav-header private">» Private</li>
@@ -66,6 +68,7 @@
66
  <li class="property public "><a href="#%24mla_debug_messages" title="$mla_debug_messages :: Accumulates debug messages"><span class="description">Accumulates debug messages</span><pre>$mla_debug_messages</pre></a></li>
67
  <li class="property public "><a href="#%24mla_iptc_keys" title="$mla_iptc_keys :: IPTC Dataset friendly name/slug and identifiers"><span class="description">IPTC Dataset friendly name/slug and identifiers</span><pre>$mla_iptc_keys</pre></a></li>
68
  <li class="nav-header private">» Private</li>
 
69
  <li class="property private "><a href="#%24mla_debug" title="$mla_debug :: Turn debug collection and display on or off"><span class="description">Turn debug collection and display on or off</span><pre>$mla_debug</pre></a></li>
70
  <li class="property private "><a href="#%24mla_iptc_descriptions" title="$mla_iptc_descriptions :: IPTC Dataset descriptions"><span class="description">IPTC Dataset descriptions</span><pre>$mla_iptc_descriptions</pre></a></li>
71
  <li class="property private "><a href="#%24mla_iptc_formats" title="$mla_iptc_formats :: IPTC file format identifiers and descriptions"><span class="description">IPTC file format identifiers and descriptions</span><pre>$mla_iptc_formats</pre></a></li>
@@ -167,6 +170,46 @@ Enhancements include many additional selection parameters and full taxonomy supp
167
  <code>array</code>List of attachments returned from WP_Query</div>
168
  </div></div>
169
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
170
  <a name="mla_shortcode_query_posts_orderby_filter" id="mla_shortcode_query_posts_orderby_filter"></a><div class="element clickable method public mla_shortcode_query_posts_orderby_filter" data-toggle="collapse" data-target=".mla_shortcode_query_posts_orderby_filter .collapse">
171
  <h2>Filters the ORDERBY clause for shortcode queries</h2>
172
  <pre>mla_shortcode_query_posts_orderby_filter(string $orderby_clause) : string</pre>
@@ -275,6 +318,18 @@ the "IPTC-NAA Information Interchange Model Version No. 4.1".</p></p>
275
  </tr></table>
276
  </div></div>
277
  </div>
 
 
 
 
 
 
 
 
 
 
 
 
278
  <a name="%24mla_debug" id="$mla_debug"> </a><div class="element clickable property private $mla_debug" data-toggle="collapse" data-target=".$mla_debug .collapse">
279
  <h2>Turn debug collection and display on or off</h2>
280
  <pre>$mla_debug : boolean</pre>
@@ -363,7 +418,7 @@ any further logic required to translate those values is contained in the filter.
363
  <div class="row"><footer class="span12">
364
  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>
365
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
366
- generated on 2013-03-29T17:11:00-07:00.<br></footer></div>
367
  </div>
368
  </body>
369
  </html>
56
  <li class="method public "><a href="#mla_attachment_list_shortcode" title="mla_attachment_list_shortcode :: WordPress Shortcode; renders a complete list of all attachments and references to them"><span class="description">WordPress Shortcode; renders a complete list of all attachments and references to them</span><pre>mla_attachment_list_shortcode()</pre></a></li>
57
  <li class="method public "><a href="#mla_gallery_shortcode" title="mla_gallery_shortcode :: The MLA Gallery shortcode."><span class="description">The MLA Gallery shortcode.</span><pre>mla_gallery_shortcode()</pre></a></li>
58
  <li class="method public "><a href="#mla_get_shortcode_attachments" title="mla_get_shortcode_attachments :: Parses shortcode parameters and returns the gallery objects"><span class="description">Parses shortcode parameters and returns the gallery objects</span><pre>mla_get_shortcode_attachments()</pre></a></li>
59
+ <li class="method public "><a href="#mla_shortcode_query_posts_clauses_filter" title="mla_shortcode_query_posts_clauses_filter :: Filters all clauses for shortcode queries, pre caching plugins"><span class="description">Filters all clauses for shortcode queries, pre caching plugins</span><pre>mla_shortcode_query_posts_clauses_filter()</pre></a></li>
60
+ <li class="method public "><a href="#mla_shortcode_query_posts_clauses_request_filter" title="mla_shortcode_query_posts_clauses_request_filter :: Filters all clauses for shortcode queries, post caching plugins"><span class="description">Filters all clauses for shortcode queries, post caching plugins</span><pre>mla_shortcode_query_posts_clauses_request_filter()</pre></a></li>
61
  <li class="method public "><a href="#mla_shortcode_query_posts_orderby_filter" title="mla_shortcode_query_posts_orderby_filter :: Filters the ORDERBY clause for shortcode queries"><span class="description">Filters the ORDERBY clause for shortcode queries</span><pre>mla_shortcode_query_posts_orderby_filter()</pre></a></li>
62
  <li class="method public "><a href="#mla_shortcode_query_posts_where_filter" title="mla_shortcode_query_posts_where_filter :: Filters the WHERE clause for shortcode queries"><span class="description">Filters the WHERE clause for shortcode queries</span><pre>mla_shortcode_query_posts_where_filter()</pre></a></li>
63
  <li class="nav-header private">» Private</li>
68
  <li class="property public "><a href="#%24mla_debug_messages" title="$mla_debug_messages :: Accumulates debug messages"><span class="description">Accumulates debug messages</span><pre>$mla_debug_messages</pre></a></li>
69
  <li class="property public "><a href="#%24mla_iptc_keys" title="$mla_iptc_keys :: IPTC Dataset friendly name/slug and identifiers"><span class="description">IPTC Dataset friendly name/slug and identifiers</span><pre>$mla_iptc_keys</pre></a></li>
70
  <li class="nav-header private">» Private</li>
71
+ <li class="property private "><a href="#%24data_selection_parameters" title="$data_selection_parameters :: Data selection parameters for the WP_Query in [mla_gallery]"><span class="description">Data selection parameters for the WP_Query in [mla_gallery]</span><pre>$data_selection_parameters</pre></a></li>
72
  <li class="property private "><a href="#%24mla_debug" title="$mla_debug :: Turn debug collection and display on or off"><span class="description">Turn debug collection and display on or off</span><pre>$mla_debug</pre></a></li>
73
  <li class="property private "><a href="#%24mla_iptc_descriptions" title="$mla_iptc_descriptions :: IPTC Dataset descriptions"><span class="description">IPTC Dataset descriptions</span><pre>$mla_iptc_descriptions</pre></a></li>
74
  <li class="property private "><a href="#%24mla_iptc_formats" title="$mla_iptc_formats :: IPTC file format identifiers and descriptions"><span class="description">IPTC file format identifiers and descriptions</span><pre>$mla_iptc_formats</pre></a></li>
170
  <code>array</code>List of attachments returned from WP_Query</div>
171
  </div></div>
172
  </div>
173
+ <a name="mla_shortcode_query_posts_clauses_filter" id="mla_shortcode_query_posts_clauses_filter"></a><div class="element clickable method public mla_shortcode_query_posts_clauses_filter" data-toggle="collapse" data-target=".mla_shortcode_query_posts_clauses_filter .collapse">
174
+ <h2>Filters all clauses for shortcode queries, pre caching plugins</h2>
175
+ <pre>mla_shortcode_query_posts_clauses_filter(array $pieces) : array</pre>
176
+ <div class="labels"></div>
177
+ <div class="row collapse"><div class="detail-description">
178
+ <p class="long_description"><p>This is for debug purposes only.
179
+ Defined as public because it's a filter.</p></p>
180
+ <table class="table table-bordered"><tr>
181
+ <th>since</th>
182
+ <td>1.30</td>
183
+ </tr></table>
184
+ <h3>Parameters</h3>
185
+ <div class="subelement argument">
186
+ <h4>$pieces</h4>
187
+ <code>array</code><p>query clauses before modification</p></div>
188
+ <h3>Returns</h3>
189
+ <div class="subelement response">
190
+ <code>array</code>query clauses after modification (none)</div>
191
+ </div></div>
192
+ </div>
193
+ <a name="mla_shortcode_query_posts_clauses_request_filter" id="mla_shortcode_query_posts_clauses_request_filter"></a><div class="element clickable method public mla_shortcode_query_posts_clauses_request_filter" data-toggle="collapse" data-target=".mla_shortcode_query_posts_clauses_request_filter .collapse">
194
+ <h2>Filters all clauses for shortcode queries, post caching plugins</h2>
195
+ <pre>mla_shortcode_query_posts_clauses_request_filter(array $pieces) : array</pre>
196
+ <div class="labels"></div>
197
+ <div class="row collapse"><div class="detail-description">
198
+ <p class="long_description"><p>This is for debug purposes only.
199
+ Defined as public because it's a filter.</p></p>
200
+ <table class="table table-bordered"><tr>
201
+ <th>since</th>
202
+ <td>1.30</td>
203
+ </tr></table>
204
+ <h3>Parameters</h3>
205
+ <div class="subelement argument">
206
+ <h4>$pieces</h4>
207
+ <code>array</code><p>query clauses before modification</p></div>
208
+ <h3>Returns</h3>
209
+ <div class="subelement response">
210
+ <code>array</code>query clauses after modification (none)</div>
211
+ </div></div>
212
+ </div>
213
  <a name="mla_shortcode_query_posts_orderby_filter" id="mla_shortcode_query_posts_orderby_filter"></a><div class="element clickable method public mla_shortcode_query_posts_orderby_filter" data-toggle="collapse" data-target=".mla_shortcode_query_posts_orderby_filter .collapse">
214
  <h2>Filters the ORDERBY clause for shortcode queries</h2>
215
  <pre>mla_shortcode_query_posts_orderby_filter(string $orderby_clause) : string</pre>
318
  </tr></table>
319
  </div></div>
320
  </div>
321
+ <a name="%24data_selection_parameters" id="$data_selection_parameters"> </a><div class="element clickable property private $data_selection_parameters" data-toggle="collapse" data-target=".$data_selection_parameters .collapse">
322
+ <h2>Data selection parameters for the WP_Query in [mla_gallery]</h2>
323
+ <pre>$data_selection_parameters : array</pre>
324
+ <div class="labels"></div>
325
+ <div class="row collapse"><div class="detail-description">
326
+ <p class="long_description"></p>
327
+ <table class="table table-bordered"><tr>
328
+ <th>since</th>
329
+ <td>1.30</td>
330
+ </tr></table>
331
+ </div></div>
332
+ </div>
333
  <a name="%24mla_debug" id="$mla_debug"> </a><div class="element clickable property private $mla_debug" data-toggle="collapse" data-target=".$mla_debug .collapse">
334
  <h2>Turn debug collection and display on or off</h2>
335
  <pre>$mla_debug : boolean</pre>
418
  <div class="row"><footer class="span12">
419
  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>
420
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
421
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
422
  </div>
423
  </body>
424
  </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 2013-03-29T17:11:00-07: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-04-22T17:09:54-07:00.<br></footer></div>
164
  </div>
165
  </body>
166
  </html>
phpDocs/classes/MLA_List_Table.html CHANGED
@@ -1012,7 +1012,7 @@ Custom field columns are added to this array by mla_admin_init_action.</p></p>
1012
  <div class="row"><footer class="span12">
1013
  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>
1014
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1015
- generated on 2013-03-29T17:10:59-07:00.<br></footer></div>
1016
  </div>
1017
  </body>
1018
  </html>
1012
  <div class="row"><footer class="span12">
1013
  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>
1014
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
1015
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
1016
  </div>
1017
  </body>
1018
  </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 2013-03-29T17:11:00-07:00.<br></footer></div>
66
  </div>
67
  </body>
68
  </html>
62
  <div class="row"><footer class="span12">
63
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
64
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
65
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
66
  </div>
67
  </body>
68
  </html>
phpDocs/errors.html CHANGED
@@ -77,7 +77,7 @@
77
  <div class="row"><footer class="span12">
78
  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>
79
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
80
- generated on 2013-03-29T17:11:00-07:00.<br></footer></div>
81
  </div>
82
  </body>
83
  </html>
77
  <div class="row"><footer class="span12">
78
  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>
79
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
80
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
81
  </div>
82
  </body>
83
  </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 2013-03-29T17:11:00-07:00.<br></footer></div>
63
  </div>
64
  </body>
65
  </html>
59
  </script><div class="row"><footer class="span12">
60
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
61
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
62
+ generated on 2013-04-22T17:09:55-07:00.<br></footer></div>
63
  </div>
64
  </body>
65
  </html>
phpDocs/index.html CHANGED
@@ -79,7 +79,7 @@
79
  <div class="row"><footer class="span12">
80
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
81
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
82
- generated on 2013-03-29T17:10:59-07:00.<br></footer></div>
83
  </div>
84
  </body>
85
  </html>
79
  <div class="row"><footer class="span12">
80
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
81
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
82
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
83
  </div>
84
  </body>
85
  </html>
phpDocs/markers.html CHANGED
@@ -64,7 +64,7 @@
64
  <div class="row"><footer class="span12">
65
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
66
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
67
- generated on 2013-03-29T17:11:00-07:00.<br></footer></div>
68
  </div>
69
  </body>
70
  </html>
64
  <div class="row"><footer class="span12">
65
  Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
66
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
67
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
68
  </div>
69
  </body>
70
  </html>
phpDocs/namespaces/global.html CHANGED
@@ -192,7 +192,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
192
  <div class="row"><footer class="span12">
193
  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>
194
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
195
- generated on 2013-03-29T17:10:59-07:00.<br></footer></div>
196
  </div>
197
  </body>
198
  </html>
192
  <div class="row"><footer class="span12">
193
  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>
194
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
195
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
196
  </div>
197
  </body>
198
  </html>
phpDocs/packages/Media Library Assistant.html CHANGED
@@ -216,7 +216,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
216
  <div class="row"><footer class="span12">
217
  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>
218
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
219
- generated on 2013-03-29T17:10:59-07:00.<br></footer></div>
220
  </div>
221
  </body>
222
  </html>
216
  <div class="row"><footer class="span12">
217
  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>
218
  Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
219
+ generated on 2013-04-22T17:09:54-07:00.<br></footer></div>
220
  </div>
221
  </body>
222
  </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="ac1ee7a8f3d0f5db87dce6e95c83a4e2" package="Media Library Assistant">
4
  <docblock line="2">
5
  <description><![CDATA[Database and template file access for MLA needs]]></description>
6
  <long-description><![CDATA[]]></long-description>
@@ -40,26 +40,26 @@ Templates separate HTML markup from PHP code for easier maintenance and localiza
40
  </tag>
41
  </docblock>
42
  </property>
43
- <property final="false" static="true" visibility="private" line="306" namespace="global" package="Media Library Assistant">
44
  <name>$query_parameters</name>
45
  <default><![CDATA[array()]]></default>
46
- <docblock line="293">
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>
51
 
52
  <p>Array index values are: use_postmeta_view, postmeta_key, detached, orderby, order, s, mla_search_connector, mla_search_fields, sentence, exact</p>]]></long-description>
53
- <tag line="293" name="since" description="0.30"/>
54
- <tag line="293" name="var" description="" type="array">
55
  <type by_reference="false">array</type>
56
  </tag>
57
  </docblock>
58
  </property>
59
- <property final="false" static="true" visibility="private" line="1206" namespace="global" package="Media Library Assistant">
60
  <name>$galleries</name>
61
  <default><![CDATA[null]]></default>
62
- <docblock line="1188">
63
  <description><![CDATA[Objects containing [gallery] shortcodes]]></description>
64
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [gallery] shortcodes
65
  and array(s) of which attachments each [gallery] contains. The arrays are built once
@@ -71,22 +71,22 @@ Each inner array has these elements:
71
  ['parent_type'] 'post' or 'page' or the custom post_type of the gallery parent,
72
  ['query'] contains a string with the arguments of the [gallery],
73
  ['results'] contains an array of post_ids for the objects in the gallery.</p>]]></long-description>
74
- <tag line="1188" name="since" description="0.70"/>
75
- <tag line="1188" name="var" description="" type="array">
76
  <type by_reference="false">array</type>
77
  </tag>
78
  </docblock>
79
  </property>
80
- <property final="false" static="true" visibility="private" line="1219" namespace="global" package="Media Library Assistant">
81
  <name>$mla_galleries</name>
82
  <default><![CDATA[null]]></default>
83
- <docblock line="1208">
84
  <description><![CDATA[Objects containing [mla_gallery] shortcodes]]></description>
85
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [mla_gallery] shortcodes
86
  and array(s) of which attachments each [mla_gallery] contains. The arrays are built once
87
  each page load and cached for subsequent calls.</p>]]></long-description>
88
- <tag line="1208" name="since" description="0.70"/>
89
- <tag line="1208" name="var" description="" type="array">
90
  <type by_reference="false">array</type>
91
  </tag>
92
  </docblock>
@@ -181,621 +181,666 @@ where "key" becomes the key part of the array.</p>]]></long-description>
181
  <type/>
182
  </argument>
183
  </method>
184
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="223" package="Media Library Assistant">
185
  <name>mla_count_list_table_items</name>
186
  <full_name>mla_count_list_table_items</full_name>
187
- <docblock line="214">
188
  <description><![CDATA[Get the total number of attachment posts]]></description>
189
  <long-description><![CDATA[]]></long-description>
190
- <tag line="214" name="since" description="0.30"/>
191
- <tag line="214" name="param" description="Query variables, e.g., from $_REQUEST" type="array" variable="$request">
192
  <type by_reference="false">array</type>
193
  </tag>
194
- <tag line="214" name="return" description="Number of attachment posts" type="integer">
195
  <type by_reference="false">integer</type>
196
  </tag>
197
  </docblock>
198
- <argument line="223">
199
  <name>$request</name>
200
  <default><![CDATA[]]></default>
201
  <type/>
202
  </argument>
203
  </method>
204
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="244" package="Media Library Assistant">
205
  <name>mla_query_list_table_items</name>
206
  <full_name>mla_query_list_table_items</full_name>
207
- <docblock line="230">
208
  <description><![CDATA[Retrieve attachment objects for list table display]]></description>
209
  <long-description><![CDATA[<p>Supports prepare_items in class-mla-list-table.php.
210
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
211
- <tag line="230" name="since" description="0.1"/>
212
- <tag line="230" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
213
  <type by_reference="false">array</type>
214
  </tag>
215
- <tag line="230" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
216
  <type by_reference="false">int</type>
217
  </tag>
218
- <tag line="230" name="param" description="number of rows on each page" type="int" variable="$count">
219
  <type by_reference="false">int</type>
220
  </tag>
221
- <tag line="230" name="return" description="attachment objects (posts) including parent data, meta data and references" type="array">
222
  <type by_reference="false">array</type>
223
  </tag>
224
  </docblock>
225
- <argument line="244">
226
  <name>$request</name>
227
  <default><![CDATA[]]></default>
228
  <type/>
229
  </argument>
230
- <argument line="244">
231
  <name>$offset</name>
232
  <default><![CDATA[]]></default>
233
  <type/>
234
  </argument>
235
- <argument line="244">
236
  <name>$count</name>
237
  <default><![CDATA[]]></default>
238
  <type/>
239
  </argument>
240
  </method>
241
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="288" package="Media Library Assistant">
242
  <name>mla_query_media_modal_items</name>
243
  <full_name>mla_query_media_modal_items</full_name>
244
- <docblock line="275">
245
  <description><![CDATA[Retrieve attachment objects for the WordPress Media Manager]]></description>
246
  <long-description><![CDATA[<p>Supports month-year and taxonomy-term filters as well as the enhanced search box</p>]]></long-description>
247
- <tag line="275" name="since" description="1.20"/>
248
- <tag line="275" name="param" description="query parameters from Media Manager" type="array" variable="$request">
249
  <type by_reference="false">array</type>
250
  </tag>
251
- <tag line="275" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
252
  <type by_reference="false">int</type>
253
  </tag>
254
- <tag line="275" name="param" description="number of rows on each page" type="int" variable="$count">
255
  <type by_reference="false">int</type>
256
  </tag>
257
- <tag line="275" name="return" description="attachment objects (posts)" type="array">
258
  <type by_reference="false">array</type>
259
  </tag>
260
  </docblock>
261
- <argument line="288">
262
  <name>$request</name>
263
  <default><![CDATA[]]></default>
264
  <type/>
265
  </argument>
266
- <argument line="288">
267
  <name>$offset</name>
268
  <default><![CDATA[]]></default>
269
  <type/>
270
  </argument>
271
- <argument line="288">
272
  <name>$count</name>
273
  <default><![CDATA[]]></default>
274
  <type/>
275
  </argument>
276
  </method>
277
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="322" package="Media Library Assistant">
278
  <name>_prepare_list_table_query</name>
279
  <full_name>_prepare_list_table_query</full_name>
280
- <docblock line="308">
281
  <description><![CDATA[Sanitize and expand query arguments from request variables]]></description>
282
  <long-description><![CDATA[<p>Prepare the arguments for WP_Query.
283
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
284
- <tag line="308" name="since" description="0.1"/>
285
- <tag line="308" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$raw_request">
286
  <type by_reference="false">array</type>
287
  </tag>
288
- <tag line="308" name="param" description="Optional number of rows (default 0) to skip over to reach desired page" type="int" variable="$offset">
289
  <type by_reference="false">int</type>
290
  </tag>
291
- <tag line="308" name="param" description="Optional number of rows on each page (0 = all rows, default)" type="int" variable="$count">
292
  <type by_reference="false">int</type>
293
  </tag>
294
- <tag line="308" name="return" description="revised arguments suitable for WP_Query" type="array">
295
  <type by_reference="false">array</type>
296
  </tag>
297
  </docblock>
298
- <argument line="322">
299
  <name>$raw_request</name>
300
  <default><![CDATA[]]></default>
301
  <type/>
302
  </argument>
303
- <argument line="322">
304
  <name>$offset</name>
305
  <default><![CDATA[0]]></default>
306
  <type/>
307
  </argument>
308
- <argument line="322">
309
  <name>$count</name>
310
  <default><![CDATA[0]]></default>
311
  <type/>
312
  </argument>
313
  </method>
314
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="575" package="Media Library Assistant">
315
  <name>_execute_list_table_query</name>
316
  <full_name>_execute_list_table_query</full_name>
317
- <docblock line="566">
318
  <description><![CDATA[Add filters, run query, remove filters]]></description>
319
  <long-description><![CDATA[]]></long-description>
320
- <tag line="566" name="since" description="0.30"/>
321
- <tag line="566" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
322
  <type by_reference="false">array</type>
323
  </tag>
324
- <tag line="566" name="return" description="WP_Query object with query results" type="object">
325
  <type by_reference="false">object</type>
326
  </tag>
327
  </docblock>
328
- <argument line="575">
329
  <name>$request</name>
330
  <default><![CDATA[]]></default>
331
  <type/>
332
  </argument>
333
  </method>
334
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="629" package="Media Library Assistant">
335
  <name>mla_query_posts_search_filter</name>
336
  <full_name>mla_query_posts_search_filter</full_name>
337
- <docblock line="617">
338
  <description><![CDATA[Adds a keyword search to the WHERE clause, if required]]></description>
339
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
340
- <tag line="617" name="since" description="0.60"/>
341
- <tag line="617" name="param" description="query clause before modification" type="string" variable="$search_string">
342
  <type by_reference="false">string</type>
343
  </tag>
344
- <tag line="617" name="param" description="WP_Query object" type="object" variable="$query_object">
345
  <type by_reference="false">object</type>
346
  </tag>
347
- <tag line="617" name="return" description="query clause after keyword search addition" type="string">
348
  <type by_reference="false">string</type>
349
  </tag>
350
  </docblock>
351
- <argument line="629">
352
  <name>$search_string</name>
353
  <default><![CDATA[]]></default>
354
  <type/>
355
  </argument>
356
- <argument line="629">
357
  <name>$query_object</name>
358
  <default><![CDATA[]]></default>
359
  <type/>
360
  </argument>
361
  </method>
362
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="710" package="Media Library Assistant">
363
  <name>mla_query_posts_join_filter</name>
364
  <full_name>mla_query_posts_join_filter</full_name>
365
- <docblock line="699">
366
  <description><![CDATA[Adds a JOIN clause, if required, to handle sorting/searching on ALT Text]]></description>
367
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
368
- <tag line="699" name="since" description="0.30"/>
369
- <tag line="699" name="param" description="query clause before modification" type="string" variable="$join_clause">
370
  <type by_reference="false">string</type>
371
  </tag>
372
- <tag line="699" name="return" description="query clause after &quot;LEFT JOIN view ON post_id&quot; item modification" type="string">
373
  <type by_reference="false">string</type>
374
  </tag>
375
  </docblock>
376
- <argument line="710">
377
  <name>$join_clause</name>
378
  <default><![CDATA[]]></default>
379
  <type/>
380
  </argument>
381
  </method>
382
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="737" package="Media Library Assistant">
383
  <name>mla_query_posts_where_filter</name>
384
  <full_name>mla_query_posts_where_filter</full_name>
385
- <docblock line="725">
386
  <description><![CDATA[Adds a WHERE clause for detached items]]></description>
387
  <long-description><![CDATA[<p>Modeled after _edit_attachments_query_helper in wp-admin/post.php.
388
  Defined as public because it's a filter.</p>]]></long-description>
389
- <tag line="725" name="since" description="0.1"/>
390
- <tag line="725" name="param" description="query clause before modification" type="string" variable="$where_clause">
391
  <type by_reference="false">string</type>
392
  </tag>
393
- <tag line="725" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
394
  <type by_reference="false">string</type>
395
  </tag>
396
  </docblock>
397
- <argument line="737">
398
  <name>$where_clause</name>
399
  <default><![CDATA[]]></default>
400
  <type/>
401
  </argument>
402
  </method>
403
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="758" package="Media Library Assistant">
404
  <name>mla_query_posts_orderby_filter</name>
405
  <full_name>mla_query_posts_orderby_filter</full_name>
406
- <docblock line="746">
407
  <description><![CDATA[Adds a ORDERBY clause, if required]]></description>
408
  <long-description><![CDATA[<p>Expands the range of sort options because the logic in WP_Query is limited.
409
  Defined as public because it's a filter.</p>]]></long-description>
410
- <tag line="746" name="since" description="0.30"/>
411
- <tag line="746" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
412
  <type by_reference="false">string</type>
413
  </tag>
414
- <tag line="746" name="return" description="updated query clause" type="string">
415
  <type by_reference="false">string</type>
416
  </tag>
417
  </docblock>
418
- <argument line="758">
419
  <name>$orderby_clause</name>
420
  <default><![CDATA[]]></default>
421
  <type/>
422
  </argument>
423
  </method>
424
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="816" package="Media Library Assistant">
425
  <name>mla_get_attachment_by_id</name>
426
  <full_name>mla_get_attachment_by_id</full_name>
427
- <docblock line="804">
428
  <description><![CDATA[Retrieve an Attachment array given a $post_id]]></description>
429
  <long-description><![CDATA[<p>The (associative) array will contain every field that can be found in
430
  the posts and postmeta tables, and all references to the attachment.</p>]]></long-description>
431
- <tag line="804" name="since" description="0.1"/>
432
- <tag line="804" name="uses" description="\global\$post" refers="\global\$post"/>
433
- <tag line="804" name="param" description="The ID of the attachment post" type="int" variable="$post_id">
434
  <type by_reference="false">int</type>
435
  </tag>
436
- <tag line="804" name="return" description="NULL on failure else associative array" type="NULL|array">
437
  <type by_reference="false">NULL</type>
438
  <type by_reference="false">array</type>
439
  </tag>
440
  </docblock>
441
- <argument line="816">
442
  <name>$post_id</name>
443
  <default><![CDATA[]]></default>
444
  <type/>
445
  </argument>
446
  </method>
447
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="861" package="Media Library Assistant">
448
  <name>mla_fetch_attachment_parent_data</name>
449
  <full_name>mla_fetch_attachment_parent_data</full_name>
450
- <docblock line="852">
451
  <description><![CDATA[Returns information about an attachment's parent, if found]]></description>
452
  <long-description><![CDATA[]]></long-description>
453
- <tag line="852" name="since" description="0.1"/>
454
- <tag line="852" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent_id">
455
  <type by_reference="false">int</type>
456
  </tag>
457
- <tag line="852" name="return" description="Parent information; post_date, post_title and post_type" type="array">
458
  <type by_reference="false">array</type>
459
  </tag>
460
  </docblock>
461
- <argument line="861">
462
  <name>$parent_id</name>
463
  <default><![CDATA[]]></default>
464
  <type/>
465
  </argument>
466
  </method>
467
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="889" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
468
  <name>mla_fetch_attachment_metadata</name>
469
  <full_name>mla_fetch_attachment_metadata</full_name>
470
- <docblock line="876">
471
  <description><![CDATA[Fetch and filter meta data for an attachment]]></description>
472
  <long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
473
  are stripped out or converted to an 'mla</em>' equivalent. Array data is replaced with
474
  a string containing the first array element.</p>]]></long-description>
475
- <tag line="876" name="since" description="0.1"/>
476
- <tag line="876" name="param" description="post ID of attachment" type="int" variable="$post_id">
477
  <type by_reference="false">int</type>
478
  </tag>
479
- <tag line="876" name="return" description="Meta data variables" type="array">
480
  <type by_reference="false">array</type>
481
  </tag>
482
  </docblock>
483
- <argument line="889">
484
  <name>$post_id</name>
485
  <default><![CDATA[]]></default>
486
  <type/>
487
  </argument>
488
  </method>
489
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="955" package="Media Library Assistant">
490
  <name>mla_fetch_attachment_references</name>
491
  <full_name>mla_fetch_attachment_references</full_name>
492
- <docblock line="942">
493
  <description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
494
  <long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
495
  as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
496
- <tag line="942" name="since" description="0.1"/>
497
- <tag line="942" name="param" description="post ID of attachment" type="int" variable="$ID">
498
  <type by_reference="false">int</type>
499
  </tag>
500
- <tag line="942" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent">
501
  <type by_reference="false">int</type>
502
  </tag>
503
- <tag line="942" name="return" description="Reference information; see $references array comments" type="array">
504
  <type by_reference="false">array</type>
505
  </tag>
506
  </docblock>
507
- <argument line="955">
508
  <name>$ID</name>
509
  <default><![CDATA[]]></default>
510
  <type/>
511
  </argument>
512
- <argument line="955">
513
  <name>$parent</name>
514
  <default><![CDATA[]]></default>
515
  <type/>
516
  </argument>
517
  </method>
518
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1230" package="Media Library Assistant">
519
  <name>mla_flush_mla_galleries</name>
520
  <full_name>mla_flush_mla_galleries</full_name>
521
- <docblock line="1221">
522
  <description><![CDATA[Invalidates the $mla_galleries or $galleries array and cached values]]></description>
523
  <long-description><![CDATA[]]></long-description>
524
- <tag line="1221" name="since" description="1.00"/>
525
- <tag line="1221" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
526
  <type by_reference="false">string</type>
527
  </tag>
528
- <tag line="1221" name="return" description="" type="void">
529
  <type by_reference="false">void</type>
530
  </tag>
531
  </docblock>
532
- <argument line="1230">
533
  <name>$option_name</name>
534
  <default><![CDATA[]]></default>
535
  <type/>
536
  </argument>
537
  </method>
538
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1254" package="Media Library Assistant">
539
  <name>mla_save_post_action</name>
540
  <full_name>mla_save_post_action</full_name>
541
- <docblock line="1245">
542
  <description><![CDATA[Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates]]></description>
543
  <long-description><![CDATA[]]></long-description>
544
- <tag line="1245" name="since" description="1.00"/>
545
- <tag line="1245" name="param" description="ID of post/page/attachment; not used at this time" type="integer" variable="$post_id">
546
  <type by_reference="false">integer</type>
547
  </tag>
548
- <tag line="1245" name="return" description="" type="void">
549
  <type by_reference="false">void</type>
550
  </tag>
551
  </docblock>
552
- <argument line="1254">
553
  <name>$post_id</name>
554
  <default><![CDATA[]]></default>
555
  <type/>
556
  </argument>
557
  </method>
558
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1271" package="Media Library Assistant">
559
  <name>_build_mla_galleries</name>
560
  <full_name>_build_mla_galleries</full_name>
561
- <docblock line="1259">
562
  <description><![CDATA[Builds the $mla_galleries or $galleries array]]></description>
563
  <long-description><![CDATA[]]></long-description>
564
- <tag line="1259" name="since" description="0.70"/>
565
- <tag line="1259" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
566
  <type by_reference="false">string</type>
567
  </tag>
568
- <tag line="1259" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
569
  <type by_reference="false">array</type>
570
  </tag>
571
- <tag line="1259" name="param" description="the shortcode to be searched for and processed" type="string" variable="$shortcode">
572
  <type by_reference="false">string</type>
573
  </tag>
574
- <tag line="1259" name="param" description="true to exclude revisions from the search" type="boolean" variable="$exclude_revisions">
575
  <type by_reference="false">boolean</type>
576
  </tag>
577
- <tag line="1259" name="return" description="true if the galleries array is not empty" type="boolean">
578
  <type by_reference="false">boolean</type>
579
  </tag>
580
  </docblock>
581
- <argument line="1271">
582
  <name>$option_name</name>
583
  <default><![CDATA[]]></default>
584
  <type/>
585
  </argument>
586
- <argument line="1271">
587
  <name>$galleries_array</name>
588
  <default><![CDATA[]]></default>
589
  <type/>
590
  </argument>
591
- <argument line="1271">
592
  <name>$shortcode</name>
593
  <default><![CDATA[]]></default>
594
  <type/>
595
  </argument>
596
- <argument line="1271">
597
  <name>$exclude_revisions</name>
598
  <default><![CDATA[]]></default>
599
  <type/>
600
  </argument>
601
  </method>
602
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1376" package="Media Library Assistant">
603
  <name>_search_mla_galleries</name>
604
  <full_name>_search_mla_galleries</full_name>
605
- <docblock line="1365">
606
  <description><![CDATA[Search the $mla_galleries or $galleries array]]></description>
607
  <long-description><![CDATA[]]></long-description>
608
- <tag line="1365" name="since" description="0.70"/>
609
- <tag line="1365" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
610
  <type by_reference="false">array</type>
611
  </tag>
612
- <tag line="1365" name="param" description="the attachment ID to be searched for and processed" type="int" variable="$attachment_id">
613
  <type by_reference="false">int</type>
614
  </tag>
615
- <tag line="1365" 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">
616
  <type by_reference="false">array</type>
617
  </tag>
618
  </docblock>
619
- <argument line="1376">
620
  <name>$galleries_array</name>
621
  <default><![CDATA[]]></default>
622
  <type/>
623
  </argument>
624
- <argument line="1376">
625
  <name>$attachment_id</name>
626
  <default><![CDATA[]]></default>
627
  <type/>
628
  </argument>
629
  </method>
630
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1402" package="Media Library Assistant">
631
  <name>mla_exif_metadata_value</name>
632
  <full_name>mla_exif_metadata_value</full_name>
633
- <docblock line="1389">
634
  <description><![CDATA[Parse one EXIF metadata field]]></description>
635
  <long-description><![CDATA[<p>Returns a string value, converting array data to a string as necessary.
636
  Also handles the special pseudo-values 'ALL_EXIF' and 'ALL_IPTC'.</p>]]></long-description>
637
- <tag line="1389" name="since" description="1.13"/>
638
- <tag line="1389" name="param" description="field name" type="string" variable="$key">
639
  <type by_reference="false">string</type>
640
  </tag>
641
- <tag line="1389" name="param" description="metadata array containing 'mla_exif_metadata' and 'mla_iptc_metadata' arrays" type="string" variable="$image_metadata">
642
  <type by_reference="false">string</type>
643
  </tag>
644
- <tag line="1389" name="return" description="string representation of metadata value or an empty string" type="string">
645
  <type by_reference="false">string</type>
646
  </tag>
647
  </docblock>
648
- <argument line="1402">
649
  <name>$key</name>
650
  <default><![CDATA[]]></default>
651
  <type/>
652
  </argument>
653
- <argument line="1402">
654
  <name>$image_metadata</name>
655
  <default><![CDATA[]]></default>
656
  <type/>
657
  </argument>
658
  </method>
659
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1432" package="Media Library Assistant">
660
  <name>mla_fetch_attachment_image_metadata</name>
661
  <full_name>mla_fetch_attachment_image_metadata</full_name>
662
- <docblock line="1420">
663
  <description><![CDATA[Fetch and filter IPTC and EXIF meta data for an image attachment]]></description>
664
  <long-description><![CDATA[<p>Returns</p>]]></long-description>
665
- <tag line="1420" name="since" description="0.90"/>
666
- <tag line="1420" name="param" description="post ID of attachment" type="int" variable="$post_id">
667
  <type by_reference="false">int</type>
668
  </tag>
669
- <tag line="1420" name="param" description="optional; if $post_id is zero, path to the image file." type="string" variable="$path">
670
  <type by_reference="false">string</type>
671
  </tag>
672
- <tag line="1420" name="return" description="Meta data variables" type="array">
673
  <type by_reference="false">array</type>
674
  </tag>
675
  </docblock>
676
- <argument line="1432">
677
  <name>$post_id</name>
678
  <default><![CDATA[]]></default>
679
  <type/>
680
  </argument>
681
- <argument line="1432">
682
  <name>$path</name>
683
  <default><![CDATA['']]></default>
684
  <type/>
685
  </argument>
686
  </method>
687
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1498" package="Media Library Assistant">
688
  <name>mla_update_single_item</name>
689
  <full_name>mla_update_single_item</full_name>
690
- <docblock line="1485">
691
  <description><![CDATA[Update a single item; change the meta data
692
  for a single attachment.]]></description>
693
  <long-description><![CDATA[]]></long-description>
694
- <tag line="1485" name="since" description="0.1"/>
695
- <tag line="1485" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
696
  <type by_reference="false">int</type>
697
  </tag>
698
- <tag line="1485" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_data">
699
  <type by_reference="false">array</type>
700
  </tag>
701
- <tag line="1485" name="param" description="Optional taxonomy term values, default null" type="array" variable="$tax_input">
702
  <type by_reference="false">array</type>
703
  </tag>
704
- <tag line="1485" name="param" description="Optional taxonomy actions (add, remove, replace), default null" type="array" variable="$tax_actions">
705
  <type by_reference="false">array</type>
706
  </tag>
707
- <tag line="1485" name="return" description="success/failure message and NULL content" type="array">
708
  <type by_reference="false">array</type>
709
  </tag>
710
  </docblock>
711
- <argument line="1498">
712
  <name>$post_id</name>
713
  <default><![CDATA[]]></default>
714
  <type/>
715
  </argument>
716
- <argument line="1498">
717
  <name>$new_data</name>
718
  <default><![CDATA[]]></default>
719
  <type/>
720
  </argument>
721
- <argument line="1498">
722
  <name>$tax_input</name>
723
  <default><![CDATA[NULL]]></default>
724
  <type/>
725
  </argument>
726
- <argument line="1498">
727
  <name>$tax_actions</name>
728
  <default><![CDATA[NULL]]></default>
729
  <type/>
730
  </argument>
731
  </method>
732
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1720" package="Media Library Assistant">
733
  <name>_remove_tags</name>
734
  <full_name>_remove_tags</full_name>
735
- <docblock line="1709">
736
  <description><![CDATA[Remove tags from a term ids list]]></description>
737
  <long-description><![CDATA[]]></long-description>
738
- <tag line="1709" name="since" description="0.40"/>
739
- <tag line="1709" name="param" description="The term ids currently assigned" type="array" variable="$terms_before">
740
  <type by_reference="false">array</type>
741
  </tag>
742
- <tag line="1709" name="param" description="| string The term ids (array) or names (string) to remove" type="array" variable="$tags">
743
  <type by_reference="false">array</type>
744
  </tag>
745
- <tag line="1709" name="param" description="The taxonomy object" type="object" variable="$taxonomy_obj">
746
  <type by_reference="false">object</type>
747
  </tag>
748
- <tag line="1709" name="return" description="Term ids of the surviving tags" type="array">
749
  <type by_reference="false">array</type>
750
  </tag>
751
  </docblock>
752
- <argument line="1720">
753
  <name>$terms_before</name>
754
  <default><![CDATA[]]></default>
755
  <type/>
756
  </argument>
757
- <argument line="1720">
758
  <name>$tags</name>
759
  <default><![CDATA[]]></default>
760
  <type/>
761
  </argument>
762
- <argument line="1720">
763
  <name>$taxonomy_obj</name>
764
  <default><![CDATA[]]></default>
765
  <type/>
766
  </argument>
767
  </method>
768
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1763" package="Media Library Assistant">
769
  <name>_hex_dump</name>
770
  <full_name>_hex_dump</full_name>
771
- <docblock line="1752">
772
  <description><![CDATA[Format printable version of binary data]]></description>
773
  <long-description><![CDATA[]]></long-description>
774
- <tag line="1752" name="since" description="0.90"/>
775
- <tag line="1752" name="param" description="Binary data" type="string" variable="$data">
776
  <type by_reference="false">string</type>
777
  </tag>
778
- <tag line="1752" name="param" description="Bytes to format, default = 0 (all bytes)" type="integer" variable="$limit">
779
  <type by_reference="false">integer</type>
780
  </tag>
781
- <tag line="1752" name="param" description="Bytes to format on each line" type="\intger" variable="$bytes_per_row">
782
  <type by_reference="false">\intger</type>
783
  </tag>
784
- <tag line="1752" name="return" description="Printable representation of $data" type="string">
785
  <type by_reference="false">string</type>
786
  </tag>
787
  </docblock>
788
- <argument line="1763">
789
  <name>$data</name>
790
  <default><![CDATA[]]></default>
791
  <type/>
792
  </argument>
793
- <argument line="1763">
794
  <name>$limit</name>
795
  <default><![CDATA[0]]></default>
796
  <type/>
797
  </argument>
798
- <argument line="1763">
799
  <name>$bytes_per_row</name>
800
  <default><![CDATA[16]]></default>
801
  <type/>
@@ -803,7 +848,7 @@ for a single attachment.]]></description>
803
  </method>
804
  </class>
805
  </file>
806
- <file path="includes\class-mla-edit-media.php" hash="ecf5932a9aa8974651feeb7c4b5352ab" package="Media Library Assistant">
807
  <docblock line="2">
808
  <description><![CDATA[Media Library Assistant Edit Media screen enhancements]]></description>
809
  <long-description><![CDATA[]]></long-description>
@@ -1107,7 +1152,7 @@ The array is built once each page load and cached for subsequent calls.</p>]]></
1107
  </method>
1108
  </class>
1109
  </file>
1110
- <file path="includes\class-mla-list-table.php" hash="edd0691b11eadedcc850c0318b2d8e42" package="Media Library Assistant">
1111
  <docblock line="2">
1112
  <description><![CDATA[Media Library Assistant extended List Table class]]></description>
1113
  <long-description><![CDATA[]]></long-description>
@@ -1398,590 +1443,590 @@ have a specific method, so this function returns a troubleshooting message.</p>]
1398
  <type/>
1399
  </argument>
1400
  </method>
1401
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="520" package="Media Library Assistant">
1402
  <name>column_cb</name>
1403
  <full_name>column_cb</full_name>
1404
- <docblock line="511">
1405
  <description><![CDATA[Displays checkboxes for using bulk actions.]]></description>
1406
  <long-description><![CDATA[<p>The 'cb' column
1407
  is given special treatment when columns are processed.</p>]]></long-description>
1408
- <tag line="511" name="since" description="0.1"/>
1409
- <tag line="511" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1410
  <type by_reference="false">array</type>
1411
  </tag>
1412
- <tag line="511" name="return" description="HTML markup to be placed inside the column" type="string">
1413
  <type by_reference="false">string</type>
1414
  </tag>
1415
  </docblock>
1416
- <argument line="520">
1417
  <name>$item</name>
1418
  <default><![CDATA[]]></default>
1419
  <type/>
1420
  </argument>
1421
  </method>
1422
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="536" package="Media Library Assistant">
1423
  <name>column_icon</name>
1424
  <full_name>column_icon</full_name>
1425
- <docblock line="528">
1426
  <description><![CDATA[Supply the content for a custom column]]></description>
1427
  <long-description><![CDATA[]]></long-description>
1428
- <tag line="528" name="since" description="0.1"/>
1429
- <tag line="528" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1430
  <type by_reference="false">array</type>
1431
  </tag>
1432
- <tag line="528" name="return" description="HTML markup to be placed inside the column" type="string">
1433
  <type by_reference="false">string</type>
1434
  </tag>
1435
  </docblock>
1436
- <argument line="536">
1437
  <name>$item</name>
1438
  <default><![CDATA[]]></default>
1439
  <type/>
1440
  </argument>
1441
  </method>
1442
- <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="552" package="Media Library Assistant">
1443
  <name>_build_rollover_actions</name>
1444
  <full_name>_build_rollover_actions</full_name>
1445
- <docblock line="541">
1446
  <description><![CDATA[Add rollover actions to exactly one of the following displayed columns:
1447
  'ID_parent', 'title_name', 'post_title', 'post_name']]></description>
1448
  <long-description><![CDATA[]]></long-description>
1449
- <tag line="541" name="since" description="0.1"/>
1450
- <tag line="541" name="param" description="A singular attachment (post) object" type="object" variable="$item">
1451
  <type by_reference="false">object</type>
1452
  </tag>
1453
- <tag line="541" name="param" description="Current column name" type="string" variable="$column">
1454
  <type by_reference="false">string</type>
1455
  </tag>
1456
- <tag line="541" name="return" description="Names and URLs of row-level actions" type="array">
1457
  <type by_reference="false">array</type>
1458
  </tag>
1459
  </docblock>
1460
- <argument line="552">
1461
  <name>$item</name>
1462
  <default><![CDATA[]]></default>
1463
  <type/>
1464
  </argument>
1465
- <argument line="552">
1466
  <name>$column</name>
1467
  <default><![CDATA[]]></default>
1468
  <type/>
1469
  </argument>
1470
  </method>
1471
- <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="630" package="Media Library Assistant">
1472
  <name>_build_inline_data</name>
1473
  <full_name>_build_inline_data</full_name>
1474
- <docblock line="621">
1475
  <description><![CDATA[Add hidden fields with the data for use in the inline editor]]></description>
1476
  <long-description><![CDATA[]]></long-description>
1477
- <tag line="621" name="since" description="0.20"/>
1478
- <tag line="621" name="param" description="A singular attachment (post) object" type="object" variable="$item">
1479
  <type by_reference="false">object</type>
1480
  </tag>
1481
- <tag line="621" name="return" description="HTML &lt;div&gt; with row data" type="string">
1482
  <type by_reference="false">string</type>
1483
  </tag>
1484
  </docblock>
1485
- <argument line="630">
1486
  <name>$item</name>
1487
  <default><![CDATA[]]></default>
1488
  <type/>
1489
  </argument>
1490
  </method>
1491
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="678" package="Media Library Assistant">
1492
  <name>column_ID_parent</name>
1493
  <full_name>column_ID_parent</full_name>
1494
- <docblock line="670">
1495
  <description><![CDATA[Supply the content for a custom column]]></description>
1496
  <long-description><![CDATA[]]></long-description>
1497
- <tag line="670" name="since" description="0.1"/>
1498
- <tag line="670" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1499
  <type by_reference="false">array</type>
1500
  </tag>
1501
- <tag line="670" name="return" description="HTML markup to be placed inside the column" type="string">
1502
  <type by_reference="false">string</type>
1503
  </tag>
1504
  </docblock>
1505
- <argument line="678">
1506
  <name>$item</name>
1507
  <default><![CDATA[]]></default>
1508
  <type/>
1509
  </argument>
1510
  </method>
1511
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="710" package="Media Library Assistant">
1512
  <name>column_title_name</name>
1513
  <full_name>column_title_name</full_name>
1514
- <docblock line="702">
1515
  <description><![CDATA[Supply the content for a custom column]]></description>
1516
  <long-description><![CDATA[]]></long-description>
1517
- <tag line="702" name="since" description="0.1"/>
1518
- <tag line="702" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1519
  <type by_reference="false">array</type>
1520
  </tag>
1521
- <tag line="702" name="return" description="HTML markup to be placed inside the column" type="string">
1522
  <type by_reference="false">string</type>
1523
  </tag>
1524
  </docblock>
1525
- <argument line="710">
1526
  <name>$item</name>
1527
  <default><![CDATA[]]></default>
1528
  <type/>
1529
  </argument>
1530
  </method>
1531
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="733" package="Media Library Assistant">
1532
  <name>column_post_title</name>
1533
  <full_name>column_post_title</full_name>
1534
- <docblock line="725">
1535
  <description><![CDATA[Supply the content for a custom column]]></description>
1536
  <long-description><![CDATA[]]></long-description>
1537
- <tag line="725" name="since" description="0.1"/>
1538
- <tag line="725" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1539
  <type by_reference="false">array</type>
1540
  </tag>
1541
- <tag line="725" name="return" description="HTML markup to be placed inside the column" type="string">
1542
  <type by_reference="false">string</type>
1543
  </tag>
1544
  </docblock>
1545
- <argument line="733">
1546
  <name>$item</name>
1547
  <default><![CDATA[]]></default>
1548
  <type/>
1549
  </argument>
1550
  </method>
1551
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="751" package="Media Library Assistant">
1552
  <name>column_post_name</name>
1553
  <full_name>column_post_name</full_name>
1554
- <docblock line="743">
1555
  <description><![CDATA[Supply the content for a custom column]]></description>
1556
  <long-description><![CDATA[]]></long-description>
1557
- <tag line="743" name="since" description="0.1"/>
1558
- <tag line="743" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1559
  <type by_reference="false">array</type>
1560
  </tag>
1561
- <tag line="743" name="return" description="HTML markup to be placed inside the column" type="string">
1562
  <type by_reference="false">string</type>
1563
  </tag>
1564
  </docblock>
1565
- <argument line="751">
1566
  <name>$item</name>
1567
  <default><![CDATA[]]></default>
1568
  <type/>
1569
  </argument>
1570
  </method>
1571
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="769" package="Media Library Assistant">
1572
  <name>column_parent</name>
1573
  <full_name>column_parent</full_name>
1574
- <docblock line="761">
1575
  <description><![CDATA[Supply the content for a custom column]]></description>
1576
  <long-description><![CDATA[]]></long-description>
1577
- <tag line="761" name="since" description="0.1"/>
1578
- <tag line="761" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1579
  <type by_reference="false">array</type>
1580
  </tag>
1581
- <tag line="761" name="return" description="HTML markup to be placed inside the column" type="string">
1582
  <type by_reference="false">string</type>
1583
  </tag>
1584
  </docblock>
1585
- <argument line="769">
1586
  <name>$item</name>
1587
  <default><![CDATA[]]></default>
1588
  <type/>
1589
  </argument>
1590
  </method>
1591
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="794" package="Media Library Assistant">
1592
  <name>column_menu_order</name>
1593
  <full_name>column_menu_order</full_name>
1594
- <docblock line="786">
1595
  <description><![CDATA[Supply the content for a custom column]]></description>
1596
  <long-description><![CDATA[]]></long-description>
1597
- <tag line="786" name="since" description="0.60"/>
1598
- <tag line="786" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1599
  <type by_reference="false">array</type>
1600
  </tag>
1601
- <tag line="786" name="return" description="HTML markup to be placed inside the column" type="string">
1602
  <type by_reference="false">string</type>
1603
  </tag>
1604
  </docblock>
1605
- <argument line="794">
1606
  <name>$item</name>
1607
  <default><![CDATA[]]></default>
1608
  <type/>
1609
  </argument>
1610
  </method>
1611
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="806" package="Media Library Assistant">
1612
  <name>column_featured</name>
1613
  <full_name>column_featured</full_name>
1614
- <docblock line="798">
1615
  <description><![CDATA[Supply the content for a custom column]]></description>
1616
  <long-description><![CDATA[]]></long-description>
1617
- <tag line="798" name="since" description="0.1"/>
1618
- <tag line="798" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1619
  <type by_reference="false">array</type>
1620
  </tag>
1621
- <tag line="798" name="return" description="HTML markup to be placed inside the column" type="string">
1622
  <type by_reference="false">string</type>
1623
  </tag>
1624
  </docblock>
1625
- <argument line="806">
1626
  <name>$item</name>
1627
  <default><![CDATA[]]></default>
1628
  <type/>
1629
  </argument>
1630
  </method>
1631
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="837" package="Media Library Assistant">
1632
  <name>column_inserted</name>
1633
  <full_name>column_inserted</full_name>
1634
- <docblock line="829">
1635
  <description><![CDATA[Supply the content for a custom column]]></description>
1636
  <long-description><![CDATA[]]></long-description>
1637
- <tag line="829" name="since" description="0.1"/>
1638
- <tag line="829" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1639
  <type by_reference="false">array</type>
1640
  </tag>
1641
- <tag line="829" name="return" description="HTML markup to be placed inside the column" type="string">
1642
  <type by_reference="false">string</type>
1643
  </tag>
1644
  </docblock>
1645
- <argument line="837">
1646
  <name>$item</name>
1647
  <default><![CDATA[]]></default>
1648
  <type/>
1649
  </argument>
1650
  </method>
1651
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="872" package="Media Library Assistant">
1652
  <name>column_galleries</name>
1653
  <full_name>column_galleries</full_name>
1654
- <docblock line="864">
1655
  <description><![CDATA[Supply the content for a custom column]]></description>
1656
  <long-description><![CDATA[]]></long-description>
1657
- <tag line="864" name="since" description="0.70"/>
1658
- <tag line="864" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1659
  <type by_reference="false">array</type>
1660
  </tag>
1661
- <tag line="864" name="return" description="HTML markup to be placed inside the column" type="string">
1662
  <type by_reference="false">string</type>
1663
  </tag>
1664
  </docblock>
1665
- <argument line="872">
1666
  <name>$item</name>
1667
  <default><![CDATA[]]></default>
1668
  <type/>
1669
  </argument>
1670
  </method>
1671
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="903" package="Media Library Assistant">
1672
  <name>column_mla_galleries</name>
1673
  <full_name>column_mla_galleries</full_name>
1674
- <docblock line="895">
1675
  <description><![CDATA[Supply the content for a custom column]]></description>
1676
  <long-description><![CDATA[]]></long-description>
1677
- <tag line="895" name="since" description="0.70"/>
1678
- <tag line="895" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1679
  <type by_reference="false">array</type>
1680
  </tag>
1681
- <tag line="895" name="return" description="HTML markup to be placed inside the column" type="string">
1682
  <type by_reference="false">string</type>
1683
  </tag>
1684
  </docblock>
1685
- <argument line="903">
1686
  <name>$item</name>
1687
  <default><![CDATA[]]></default>
1688
  <type/>
1689
  </argument>
1690
  </method>
1691
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="934" package="Media Library Assistant">
1692
  <name>column_alt_text</name>
1693
  <full_name>column_alt_text</full_name>
1694
- <docblock line="926">
1695
  <description><![CDATA[Supply the content for a custom column]]></description>
1696
  <long-description><![CDATA[]]></long-description>
1697
- <tag line="926" name="since" description="0.1"/>
1698
- <tag line="926" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1699
  <type by_reference="false">array</type>
1700
  </tag>
1701
- <tag line="926" name="return" description="HTML markup to be placed inside the column" type="string">
1702
  <type by_reference="false">string</type>
1703
  </tag>
1704
  </docblock>
1705
- <argument line="934">
1706
  <name>$item</name>
1707
  <default><![CDATA[]]></default>
1708
  <type/>
1709
  </argument>
1710
  </method>
1711
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="954" package="Media Library Assistant">
1712
  <name>column_caption</name>
1713
  <full_name>column_caption</full_name>
1714
- <docblock line="946">
1715
  <description><![CDATA[Supply the content for a custom column]]></description>
1716
  <long-description><![CDATA[]]></long-description>
1717
- <tag line="946" name="since" description="0.1"/>
1718
- <tag line="946" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1719
  <type by_reference="false">array</type>
1720
  </tag>
1721
- <tag line="946" name="return" description="HTML markup to be placed inside the column" type="string">
1722
  <type by_reference="false">string</type>
1723
  </tag>
1724
  </docblock>
1725
- <argument line="954">
1726
  <name>$item</name>
1727
  <default><![CDATA[]]></default>
1728
  <type/>
1729
  </argument>
1730
  </method>
1731
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="966" package="Media Library Assistant">
1732
  <name>column_description</name>
1733
  <full_name>column_description</full_name>
1734
- <docblock line="958">
1735
  <description><![CDATA[Supply the content for a custom column]]></description>
1736
  <long-description><![CDATA[]]></long-description>
1737
- <tag line="958" name="since" description="0.1"/>
1738
- <tag line="958" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1739
  <type by_reference="false">array</type>
1740
  </tag>
1741
- <tag line="958" name="return" description="HTML markup to be placed inside the column" type="string">
1742
  <type by_reference="false">string</type>
1743
  </tag>
1744
  </docblock>
1745
- <argument line="966">
1746
  <name>$item</name>
1747
  <default><![CDATA[]]></default>
1748
  <type/>
1749
  </argument>
1750
  </method>
1751
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="978" package="Media Library Assistant">
1752
  <name>column_post_mime_type</name>
1753
  <full_name>column_post_mime_type</full_name>
1754
- <docblock line="970">
1755
  <description><![CDATA[Supply the content for a custom column]]></description>
1756
  <long-description><![CDATA[]]></long-description>
1757
- <tag line="970" name="since" description="0.30"/>
1758
- <tag line="970" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1759
  <type by_reference="false">array</type>
1760
  </tag>
1761
- <tag line="970" name="return" description="HTML markup to be placed inside the column" type="string">
1762
  <type by_reference="false">string</type>
1763
  </tag>
1764
  </docblock>
1765
- <argument line="978">
1766
  <name>$item</name>
1767
  <default><![CDATA[]]></default>
1768
  <type/>
1769
  </argument>
1770
  </method>
1771
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="990" package="Media Library Assistant">
1772
  <name>column_base_file</name>
1773
  <full_name>column_base_file</full_name>
1774
- <docblock line="982">
1775
  <description><![CDATA[Supply the content for a custom column]]></description>
1776
  <long-description><![CDATA[]]></long-description>
1777
- <tag line="982" name="since" description="0.1"/>
1778
- <tag line="982" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1779
  <type by_reference="false">array</type>
1780
  </tag>
1781
- <tag line="982" name="return" description="HTML markup to be placed inside the column" type="string">
1782
  <type by_reference="false">string</type>
1783
  </tag>
1784
  </docblock>
1785
- <argument line="990">
1786
  <name>$item</name>
1787
  <default><![CDATA[]]></default>
1788
  <type/>
1789
  </argument>
1790
  </method>
1791
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1002" package="Media Library Assistant">
1792
  <name>column_date</name>
1793
  <full_name>column_date</full_name>
1794
- <docblock line="994">
1795
  <description><![CDATA[Supply the content for a custom column]]></description>
1796
  <long-description><![CDATA[]]></long-description>
1797
- <tag line="994" name="since" description="0.1"/>
1798
- <tag line="994" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1799
  <type by_reference="false">array</type>
1800
  </tag>
1801
- <tag line="994" name="return" description="HTML markup to be placed inside the column" type="string">
1802
  <type by_reference="false">string</type>
1803
  </tag>
1804
  </docblock>
1805
- <argument line="1002">
1806
  <name>$item</name>
1807
  <default><![CDATA[]]></default>
1808
  <type/>
1809
  </argument>
1810
  </method>
1811
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1031" package="Media Library Assistant">
1812
  <name>column_modified</name>
1813
  <full_name>column_modified</full_name>
1814
- <docblock line="1023">
1815
  <description><![CDATA[Supply the content for a custom column]]></description>
1816
  <long-description><![CDATA[]]></long-description>
1817
- <tag line="1023" name="since" description="0.30"/>
1818
- <tag line="1023" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1819
  <type by_reference="false">array</type>
1820
  </tag>
1821
- <tag line="1023" name="return" description="HTML markup to be placed inside the column" type="string">
1822
  <type by_reference="false">string</type>
1823
  </tag>
1824
  </docblock>
1825
- <argument line="1031">
1826
  <name>$item</name>
1827
  <default><![CDATA[]]></default>
1828
  <type/>
1829
  </argument>
1830
  </method>
1831
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1060" package="Media Library Assistant">
1832
  <name>column_author</name>
1833
  <full_name>column_author</full_name>
1834
- <docblock line="1052">
1835
  <description><![CDATA[Supply the content for a custom column]]></description>
1836
  <long-description><![CDATA[]]></long-description>
1837
- <tag line="1052" name="since" description="0.30"/>
1838
- <tag line="1052" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1839
  <type by_reference="false">array</type>
1840
  </tag>
1841
- <tag line="1052" name="return" description="HTML markup to be placed inside the column" type="string">
1842
  <type by_reference="false">string</type>
1843
  </tag>
1844
  </docblock>
1845
- <argument line="1060">
1846
  <name>$item</name>
1847
  <default><![CDATA[]]></default>
1848
  <type/>
1849
  </argument>
1850
  </method>
1851
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1081" package="Media Library Assistant">
1852
  <name>column_attached_to</name>
1853
  <full_name>column_attached_to</full_name>
1854
- <docblock line="1073">
1855
  <description><![CDATA[Supply the content for a custom column]]></description>
1856
  <long-description><![CDATA[]]></long-description>
1857
- <tag line="1073" name="since" description="0.1"/>
1858
- <tag line="1073" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1859
  <type by_reference="false">array</type>
1860
  </tag>
1861
- <tag line="1073" name="return" description="HTML markup to be placed inside the column" type="string">
1862
  <type by_reference="false">string</type>
1863
  </tag>
1864
  </docblock>
1865
- <argument line="1081">
1866
  <name>$item</name>
1867
  <default><![CDATA[]]></default>
1868
  <type/>
1869
  </argument>
1870
  </method>
1871
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1110" package="Media Library Assistant">
1872
  <name>get_columns</name>
1873
  <full_name>get_columns</full_name>
1874
- <docblock line="1103">
1875
  <description><![CDATA[This method dictates the table's columns and titles]]></description>
1876
  <long-description><![CDATA[]]></long-description>
1877
- <tag line="1103" name="since" description="0.1"/>
1878
- <tag line="1103" name="return" description="Column information: 'slugs'=&gt;'Visible Titles'" type="array">
1879
  <type by_reference="false">array</type>
1880
  </tag>
1881
  </docblock>
1882
  </method>
1883
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1122" package="Media Library Assistant">
1884
  <name>get_hidden_columns</name>
1885
  <full_name>get_hidden_columns</full_name>
1886
- <docblock line="1114">
1887
  <description><![CDATA[Returns the list of currently hidden columns from a user option or
1888
  from default values if the option is not set]]></description>
1889
  <long-description><![CDATA[]]></long-description>
1890
- <tag line="1114" name="since" description="0.1"/>
1891
- <tag line="1114" name="return" description="Column information,e.g., array(0 =&gt; 'ID_parent, 1 =&gt; 'title_name')" type="array">
1892
  <type by_reference="false">array</type>
1893
  </tag>
1894
  </docblock>
1895
  </method>
1896
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1142" package="Media Library Assistant">
1897
  <name>get_sortable_columns</name>
1898
  <full_name>get_sortable_columns</full_name>
1899
- <docblock line="1132">
1900
  <description><![CDATA[Returns an array where the key is the column that needs to be sortable
1901
  and the value is db column to sort by.]]></description>
1902
  <long-description><![CDATA[<p>Also notes the current sort column,
1903
  if set.</p>]]></long-description>
1904
- <tag line="1132" name="since" description="0.1"/>
1905
- <tag line="1132" name="return" description="Sortable column information,e.g., 'slugs'=&gt;array('data_values',boolean)" type="array">
1906
  <type by_reference="false">array</type>
1907
  </tag>
1908
  </docblock>
1909
  </method>
1910
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1169" package="Media Library Assistant">
1911
  <name>get_views</name>
1912
  <full_name>get_views</full_name>
1913
- <docblock line="1161">
1914
  <description><![CDATA[Returns an associative array listing all the views that can be used with this table.]]></description>
1915
  <long-description><![CDATA[<p>These are listed across the top of the page and managed by WordPress.</p>]]></long-description>
1916
- <tag line="1161" name="since" description="0.1"/>
1917
- <tag line="1161" name="return" description="View information,e.g., array ( id =&gt; link )" type="array">
1918
  <type by_reference="false">array</type>
1919
  </tag>
1920
  </docblock>
1921
  </method>
1922
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1244" package="Media Library Assistant">
1923
  <name>get_bulk_actions</name>
1924
  <full_name>get_bulk_actions</full_name>
1925
- <docblock line="1236">
1926
  <description><![CDATA[Get an associative array ( option_name => option_title ) with the list
1927
  of bulk actions available on this table.]]></description>
1928
  <long-description><![CDATA[]]></long-description>
1929
- <tag line="1236" name="since" description="0.1"/>
1930
- <tag line="1236" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
1931
  <type by_reference="false">array</type>
1932
  </tag>
1933
  </docblock>
1934
  </method>
1935
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1275" package="Media Library Assistant">
1936
  <name>extra_tablenav</name>
1937
  <full_name>extra_tablenav</full_name>
1938
- <docblock line="1264">
1939
  <description><![CDATA[Extra controls to be displayed between bulk actions and pagination]]></description>
1940
  <long-description><![CDATA[<p>Modeled after class-wp-posts-list-table.php in wp-admin/includes.</p>]]></long-description>
1941
- <tag line="1264" name="since" description="0.1"/>
1942
- <tag line="1264" name="param" description="'top' or 'bottom', i.e., above or below the table rows" type="string" variable="$which">
1943
  <type by_reference="false">string</type>
1944
  </tag>
1945
- <tag line="1264" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
1946
  <type by_reference="false">array</type>
1947
  </tag>
1948
  </docblock>
1949
- <argument line="1275">
1950
  <name>$which</name>
1951
  <default><![CDATA[]]></default>
1952
  <type/>
1953
  </argument>
1954
  </method>
1955
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1308" package="Media Library Assistant">
1956
  <name>prepare_items</name>
1957
  <full_name>prepare_items</full_name>
1958
- <docblock line="1296">
1959
  <description><![CDATA[Prepares the list of items for displaying]]></description>
1960
  <long-description><![CDATA[<p>This is where you prepare your data for display. This method will usually
1961
  be used to query the database, sort and filter the data, and generally
1962
  get it ready to be displayed. At a minimum, we should set $this->items and
1963
  $this->set_pagination_args().</p>]]></long-description>
1964
- <tag line="1296" name="since" description="0.1"/>
1965
- <tag line="1296" name="return" description="" type="void">
1966
  <type by_reference="false">void</type>
1967
  </tag>
1968
  </docblock>
1969
  </method>
1970
- <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1354" package="Media Library Assistant">
1971
  <name>single_row</name>
1972
  <full_name>single_row</full_name>
1973
- <docblock line="1345">
1974
  <description><![CDATA[Generates (echoes) content for a single row of the table]]></description>
1975
  <long-description><![CDATA[]]></long-description>
1976
- <tag line="1345" name="since" description=".20"/>
1977
- <tag line="1345" name="param" description="the current item" type="object" variable="$item">
1978
  <type by_reference="false">object</type>
1979
  </tag>
1980
- <tag line="1345" name="return" description="Echoes the row HTML" type="void">
1981
  <type by_reference="false">void</type>
1982
  </tag>
1983
  </docblock>
1984
- <argument line="1354">
1985
  <name>$item</name>
1986
  <default><![CDATA[]]></default>
1987
  <type/>
@@ -1989,7 +2034,7 @@ $this->set_pagination_args().</p>]]></long-description>
1989
  </method>
1990
  </class>
1991
  </file>
1992
- <file path="includes\class-mla-main.php" hash="f93c75e33c605e9d8c808debee959e7b" package="Media Library Assistant">
1993
  <docblock line="2">
1994
  <description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
1995
  <long-description><![CDATA[]]></long-description>
@@ -2026,7 +2071,7 @@ of images and files held in the WordPress Media Library.]]></description>
2026
  <constant namespace="global" line="41" package="Media Library Assistant">
2027
  <name>CURRENT_MLA_VERSION</name>
2028
  <full_name>CURRENT_MLA_VERSION</full_name>
2029
- <value><![CDATA['1.20']]></value>
2030
  <docblock line="34">
2031
  <description><![CDATA[Current version number]]></description>
2032
  <long-description><![CDATA[]]></long-description>
@@ -2536,13 +2581,13 @@ going to the Edit Media screen.</p>]]></long-description>
2536
  <type/>
2537
  </argument>
2538
  </method>
2539
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1194" package="Media Library Assistant">
2540
  <name>_display_single_item</name>
2541
  <full_name>_display_single_item</full_name>
2542
  <docblock line="1184">
2543
  <description><![CDATA[Display a single item sub page; prepare the form to
2544
  change the meta data for a single attachment.]]></description>
2545
- <long-description><![CDATA[]]></long-description>
2546
  <tag line="1184" name="since" description="0.1"/>
2547
  <tag line="1184" name="param" description="The WordPress Post ID of the attachment item" type="int" variable="$post_id">
2548
  <type by_reference="false">int</type>
@@ -2551,47 +2596,47 @@ change the meta data for a single attachment.]]></description>
2551
  <type by_reference="false">array</type>
2552
  </tag>
2553
  </docblock>
2554
- <argument line="1194">
2555
  <name>$post_id</name>
2556
  <default><![CDATA[]]></default>
2557
  <type/>
2558
  </argument>
2559
  </method>
2560
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1434" package="Media Library Assistant">
2561
  <name>_restore_single_item</name>
2562
  <full_name>_restore_single_item</full_name>
2563
- <docblock line="1425">
2564
  <description><![CDATA[Restore a single item from the Trash]]></description>
2565
  <long-description><![CDATA[]]></long-description>
2566
- <tag line="1425" name="since" description="0.1"/>
2567
- <tag line="1425" name="param" description="The form POST data" type="array" variable="$post_id">
2568
  <type by_reference="false">array</type>
2569
  </tag>
2570
- <tag line="1425" name="return" description="success/failure message and NULL content" type="array">
2571
  <type by_reference="false">array</type>
2572
  </tag>
2573
  </docblock>
2574
- <argument line="1434">
2575
  <name>$post_id</name>
2576
  <default><![CDATA[]]></default>
2577
  <type/>
2578
  </argument>
2579
  </method>
2580
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1470" package="Media Library Assistant">
2581
  <name>_trash_single_item</name>
2582
  <full_name>_trash_single_item</full_name>
2583
- <docblock line="1461">
2584
  <description><![CDATA[Move a single item to Trash]]></description>
2585
  <long-description><![CDATA[]]></long-description>
2586
- <tag line="1461" name="since" description="0.1"/>
2587
- <tag line="1461" name="param" description="The form POST data" type="array" variable="$post_id">
2588
  <type by_reference="false">array</type>
2589
  </tag>
2590
- <tag line="1461" name="return" description="success/failure message and NULL content" type="array">
2591
  <type by_reference="false">array</type>
2592
  </tag>
2593
  </docblock>
2594
- <argument line="1470">
2595
  <name>$post_id</name>
2596
  <default><![CDATA[]]></default>
2597
  <type/>
@@ -2599,7 +2644,7 @@ change the meta data for a single attachment.]]></description>
2599
  </method>
2600
  </class>
2601
  </file>
2602
- <file path="includes\class-mla-media-modal.php" hash="8f945cf6ddd10adc499c935e3f939518" package="Media Library Assistant">
2603
  <docblock line="2">
2604
  <description><![CDATA[Media Library Assistant Media Manager enhancements]]></description>
2605
  <long-description><![CDATA[]]></long-description>
@@ -2826,7 +2871,7 @@ and mla_print_media_templates_action]]></description>
2826
  </method>
2827
  </class>
2828
  </file>
2829
- <file path="includes\class-mla-objects.php" hash="fc03d333906820511d0d5f7b9d7b074c" package="Media Library Assistant">
2830
  <docblock line="2">
2831
  <description><![CDATA[Media Library Assistant Custom Taxonomy and Post Type objects]]></description>
2832
  <long-description><![CDATA[]]></long-description>
@@ -2867,59 +2912,59 @@ and mla_print_media_templates_action]]></description>
2867
  </tag>
2868
  </docblock>
2869
  </method>
2870
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="112" package="Media Library Assistant">
2871
  <name>mla_taxonomy_get_columns_filter</name>
2872
  <full_name>mla_taxonomy_get_columns_filter</full_name>
2873
- <docblock line="102">
2874
  <description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
2875
  which replaces the "Posts" column with an equivalent "Attachments" column.]]></description>
2876
  <long-description><![CDATA[]]></long-description>
2877
- <tag line="102" name="since" description="0.30"/>
2878
- <tag line="102" name="param" description="column definitions for the edit taxonomy list table" type="array" variable="$columns">
2879
  <type by_reference="false">array</type>
2880
  </tag>
2881
- <tag line="102" name="return" description="updated column definitions for the edit taxonomy list table" type="array">
2882
  <type by_reference="false">array</type>
2883
  </tag>
2884
  </docblock>
2885
- <argument line="112">
2886
  <name>$columns</name>
2887
  <default><![CDATA[]]></default>
2888
  <type/>
2889
  </argument>
2890
  </method>
2891
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="147" package="Media Library Assistant">
2892
  <name>mla_taxonomy_column_filter</name>
2893
  <full_name>mla_taxonomy_column_filter</full_name>
2894
- <docblock line="134">
2895
  <description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
2896
  which returns a count of the attachments assigned a given term]]></description>
2897
  <long-description><![CDATA[]]></long-description>
2898
- <tag line="134" name="since" description="0.30"/>
2899
- <tag line="134" name="param" description="current column value; always ''" type="string" variable="$place_holder">
2900
  <type by_reference="false">string</type>
2901
  </tag>
2902
- <tag line="134" name="param" description="name of the column" type="array" variable="$column_name">
2903
  <type by_reference="false">array</type>
2904
  </tag>
2905
- <tag line="134" name="param" description="ID of the term for which the count is desired" type="array" variable="$term_id">
2906
  <type by_reference="false">array</type>
2907
  </tag>
2908
- <tag line="134" name="return" description="HTML markup for the column content; number of attachments in the category and alink to retrieve a list of them" type="array">
2909
  <type by_reference="false">array</type>
2910
  </tag>
2911
  </docblock>
2912
- <argument line="147">
2913
  <name>$place_holder</name>
2914
  <default><![CDATA[]]></default>
2915
  <type/>
2916
  </argument>
2917
- <argument line="147">
2918
  <name>$column_name</name>
2919
  <default><![CDATA[]]></default>
2920
  <type/>
2921
  </argument>
2922
- <argument line="147">
2923
  <name>$term_id</name>
2924
  <default><![CDATA[]]></default>
2925
  <type/>
@@ -2927,7 +2972,7 @@ which returns a count of the attachments assigned a given term]]></description>
2927
  </method>
2928
  </class>
2929
  </file>
2930
- <file path="includes\class-mla-options.php" hash="7ba91b9d952194ed61098360ffd9fd84" package="Media Library Assistant">
2931
  <docblock line="2">
2932
  <description><![CDATA[Manages the plugin option settings]]></description>
2933
  <long-description><![CDATA[]]></long-description>
@@ -3103,7 +3148,7 @@ and provides functions to get and put them from/to WordPress option variables]]>
3103
  </property>
3104
  <property final="false" static="true" visibility="public" line="148" namespace="global" package="Media Library Assistant">
3105
  <name>$mla_option_definitions</name>
3106
- <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 and the Edit Media screen.<br>Check the "Inline Edit" box to display the taxonomy in the Quick Edit and Bulk Edit areas.<br>Use the "List Filter" option to select the taxonomy on which to filter the Assistant table listing.', 'std' => array('tax_support' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_quick_edit' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_filter' => 'attachment_category'), 'type' => 'custom', 'render' => 'mla_taxonomy_option_handler', 'update' => 'mla_taxonomy_option_handler', 'delete' => 'mla_taxonomy_option_handler', 'reset' => 'mla_taxonomy_option_handler'), '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.'), 'media_modal_heading' => array('tab' => 'general', 'name' => 'Media Manager Enhancements', 'type' => 'header'), self::MLA_MEDIA_MODAL_TOOLBAR => array('tab' => 'general', 'name' => 'Enable Media Manager Enhancements', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to enable/disable Media Manager Enhancements.'), self::MLA_MEDIA_MODAL_MIMETYPES => array('tab' => 'general', 'name' => 'Media Manager Enhanced MIME Type filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by more MIME Types, e.g., text, applications.'), self::MLA_MEDIA_MODAL_MONTHS => array('tab' => 'general', 'name' => 'Media Manager Month and Year filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by month and year uploaded.'), self::MLA_MEDIA_MODAL_TERMS => array('tab' => 'general', 'name' => 'Media Manager Category/Tag filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by taxonomy terms.'), self::MLA_MEDIA_MODAL_SEARCHBOX => array('tab' => 'general', 'name' => 'Media Manager Enhanced Search Media box', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to enable search box enhancements.'), 'template_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>
3107
  <docblock line="123">
3108
  <description><![CDATA[$mla_option_definitions defines the database options and admin page areas for setting/updating them.]]></description>
3109
  <long-description><![CDATA[<p>Each option is defined by an array with the following elements:</p>
@@ -3130,858 +3175,858 @@ reset => reset function for 'custom' options; returns nothing. Usage:
3130
  $message = ['reset']( 'reset', $key, $value, $_REQUEST );</p>]]></long-description>
3131
  </docblock>
3132
  </property>
3133
- <property final="false" static="true" visibility="private" line="512" namespace="global" package="Media Library Assistant">
3134
  <name>$mla_option_templates</name>
3135
  <default><![CDATA[null]]></default>
3136
- <docblock line="505">
3137
  <description><![CDATA[Style and Markup templates]]></description>
3138
  <long-description><![CDATA[]]></long-description>
3139
- <tag line="505" name="since" description="0.80"/>
3140
- <tag line="505" name="var" description="" type="array">
3141
  <type by_reference="false">array</type>
3142
  </tag>
3143
  </docblock>
3144
  </property>
3145
- <property final="false" static="true" visibility="private" line="1432" namespace="global" package="Media Library Assistant">
3146
  <name>$custom_field_data_sources</name>
3147
  <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>
3148
- <docblock line="1425">
3149
  <description><![CDATA[Array of Data Source names for custom field mapping]]></description>
3150
  <long-description><![CDATA[]]></long-description>
3151
- <tag line="1425" name="since" description="1.10"/>
3152
- <tag line="1425" name="var" description="" type="array">
3153
  <type by_reference="false">array</type>
3154
  </tag>
3155
  </docblock>
3156
  </property>
3157
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="486" package="Media Library Assistant">
3158
  <name>initialize</name>
3159
  <full_name>initialize</full_name>
3160
- <docblock line="479">
3161
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
3162
  <long-description><![CDATA[]]></long-description>
3163
- <tag line="479" name="since" description="1.00"/>
3164
- <tag line="479" name="return" description="" type="void">
3165
  <type by_reference="false">void</type>
3166
  </tag>
3167
  </docblock>
3168
  </method>
3169
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="521" package="Media Library Assistant">
3170
  <name>_load_option_templates</name>
3171
  <full_name>_load_option_templates</full_name>
3172
- <docblock line="514">
3173
  <description><![CDATA[Load style and markup templates to $mla_templates]]></description>
3174
  <long-description><![CDATA[]]></long-description>
3175
- <tag line="514" name="since" description="0.80"/>
3176
- <tag line="514" name="return" description="" type="void">
3177
  <type by_reference="false">void</type>
3178
  </tag>
3179
  </docblock>
3180
  </method>
3181
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="569" package="Media Library Assistant">
3182
  <name>mla_fetch_gallery_template</name>
3183
  <full_name>mla_fetch_gallery_template</full_name>
3184
- <docblock line="559">
3185
  <description><![CDATA[Fetch style or markup template from $mla_templates]]></description>
3186
  <long-description><![CDATA[]]></long-description>
3187
- <tag line="559" name="since" description="0.80"/>
3188
- <tag line="559" name="param" description="Template name" type="string" variable="$key">
3189
  <type by_reference="false">string</type>
3190
  </tag>
3191
- <tag line="559" name="param" description="Template type; 'style' (default) or 'markup'" type="string" variable="$type">
3192
  <type by_reference="false">string</type>
3193
  </tag>
3194
- <tag line="559" name="return" description="requested template, false if not found or null if no templates" type="string|boolean|null">
3195
  <type by_reference="false">string</type>
3196
  <type by_reference="false">boolean</type>
3197
  <type by_reference="false">null</type>
3198
  </tag>
3199
  </docblock>
3200
- <argument line="569">
3201
  <name>$key</name>
3202
  <default><![CDATA[]]></default>
3203
  <type/>
3204
  </argument>
3205
- <argument line="569">
3206
  <name>$type</name>
3207
  <default><![CDATA['style']]></default>
3208
  <type/>
3209
  </argument>
3210
  </method>
3211
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="591" package="Media Library Assistant">
3212
  <name>mla_get_style_templates</name>
3213
  <full_name>mla_get_style_templates</full_name>
3214
- <docblock line="584">
3215
  <description><![CDATA[Get ALL style templates from $mla_templates, including 'default']]></description>
3216
  <long-description><![CDATA[]]></long-description>
3217
- <tag line="584" name="since" description="0.80"/>
3218
- <tag line="584" name="return" description="name =&gt; value for all style templates or null if no templates" type="array|null">
3219
  <type by_reference="false">array</type>
3220
  <type by_reference="false">null</type>
3221
  </tag>
3222
  </docblock>
3223
  </method>
3224
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="617" package="Media Library Assistant">
3225
  <name>mla_put_style_templates</name>
3226
  <full_name>mla_put_style_templates</full_name>
3227
- <docblock line="609">
3228
  <description><![CDATA[Put user-defined style templates to $mla_templates and database]]></description>
3229
  <long-description><![CDATA[]]></long-description>
3230
- <tag line="609" name="since" description="0.80"/>
3231
- <tag line="609" name="param" description="name =&gt; value for all user-defined style templates" type="array" variable="$templates">
3232
  <type by_reference="false">array</type>
3233
  </tag>
3234
- <tag line="609" name="return" description="true if success, false if failure" type="boolean">
3235
  <type by_reference="false">boolean</type>
3236
  </tag>
3237
  </docblock>
3238
- <argument line="617">
3239
  <name>$templates</name>
3240
  <default><![CDATA[]]></default>
3241
  <type/>
3242
  </argument>
3243
  </method>
3244
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="633" package="Media Library Assistant">
3245
  <name>mla_get_markup_templates</name>
3246
  <full_name>mla_get_markup_templates</full_name>
3247
- <docblock line="626">
3248
  <description><![CDATA[Get ALL markup templates from $mla_templates, including 'default']]></description>
3249
  <long-description><![CDATA[]]></long-description>
3250
- <tag line="626" name="since" description="0.80"/>
3251
- <tag line="626" name="return" description="name =&gt; value for all markup templates or null if no templates" type="array|null">
3252
  <type by_reference="false">array</type>
3253
  <type by_reference="false">null</type>
3254
  </tag>
3255
  </docblock>
3256
  </method>
3257
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="687" package="Media Library Assistant">
3258
  <name>mla_put_markup_templates</name>
3259
  <full_name>mla_put_markup_templates</full_name>
3260
- <docblock line="679">
3261
  <description><![CDATA[Put user-defined markup templates to $mla_templates and database]]></description>
3262
  <long-description><![CDATA[]]></long-description>
3263
- <tag line="679" name="since" description="0.80"/>
3264
- <tag line="679" name="param" description="name =&gt; value for all user-defined markup templates" type="array" variable="$templates">
3265
  <type by_reference="false">array</type>
3266
  </tag>
3267
- <tag line="679" name="return" description="true if success, false if failure" type="boolean">
3268
  <type by_reference="false">boolean</type>
3269
  </tag>
3270
  </docblock>
3271
- <argument line="687">
3272
  <name>$templates</name>
3273
  <default><![CDATA[]]></default>
3274
  <type/>
3275
  </argument>
3276
  </method>
3277
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="705" package="Media Library Assistant">
3278
  <name>mla_get_option</name>
3279
  <full_name>mla_get_option</full_name>
3280
- <docblock line="696">
3281
  <description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
3282
  <long-description><![CDATA[]]></long-description>
3283
- <tag line="696" name="since" description="0.1"/>
3284
- <tag line="696" name="param" description="Name of the desired option" type="string" variable="$option">
3285
  <type by_reference="false">string</type>
3286
  </tag>
3287
- <tag line="696" name="return" description="Value(s) for the option or false if the option is not a defined MLA option" type="mixed">
3288
  <type by_reference="false">mixed</type>
3289
  </tag>
3290
  </docblock>
3291
- <argument line="705">
3292
  <name>$option</name>
3293
  <default><![CDATA[]]></default>
3294
  <type/>
3295
  </argument>
3296
  </method>
3297
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="726" package="Media Library Assistant">
3298
  <name>mla_update_option</name>
3299
  <full_name>mla_update_option</full_name>
3300
- <docblock line="716">
3301
  <description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
3302
  <long-description><![CDATA[]]></long-description>
3303
- <tag line="716" name="since" description="0.1"/>
3304
- <tag line="716" name="param" description="Name of the desired option" type="string" variable="$option">
3305
  <type by_reference="false">string</type>
3306
  </tag>
3307
- <tag line="716" name="param" description="New value for the desired option" type="mixed" variable="$newvalue">
3308
  <type by_reference="false">mixed</type>
3309
  </tag>
3310
- <tag line="716" name="return" description="True if the value was changed or false if the update failed" type="boolean">
3311
  <type by_reference="false">boolean</type>
3312
  </tag>
3313
  </docblock>
3314
- <argument line="726">
3315
  <name>$option</name>
3316
  <default><![CDATA[]]></default>
3317
  <type/>
3318
  </argument>
3319
- <argument line="726">
3320
  <name>$newvalue</name>
3321
  <default><![CDATA[]]></default>
3322
  <type/>
3323
  </argument>
3324
  </method>
3325
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="742" package="Media Library Assistant">
3326
  <name>mla_delete_option</name>
3327
  <full_name>mla_delete_option</full_name>
3328
- <docblock line="733">
3329
  <description><![CDATA[Delete the stored value of a defined MLA option]]></description>
3330
  <long-description><![CDATA[]]></long-description>
3331
- <tag line="733" name="since" description="0.1"/>
3332
- <tag line="733" name="param" description="Name of the desired option" type="string" variable="$option">
3333
  <type by_reference="false">string</type>
3334
  </tag>
3335
- <tag line="733" name="return" description="True if the option was deleted, otherwise false" type="boolean">
3336
  <type by_reference="false">boolean</type>
3337
  </tag>
3338
  </docblock>
3339
- <argument line="742">
3340
  <name>$option</name>
3341
  <default><![CDATA[]]></default>
3342
  <type/>
3343
  </argument>
3344
  </method>
3345
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="763" package="Media Library Assistant">
3346
  <name>mla_taxonomy_support</name>
3347
  <full_name>mla_taxonomy_support</full_name>
3348
- <docblock line="750">
3349
  <description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
3350
  settings are being updated or reset.]]></description>
3351
  <long-description><![CDATA[]]></long-description>
3352
- <tag line="750" name="since" description="0.30"/>
3353
- <tag line="750" name="param" description="Taxonomy name, e.g., attachment_category" type="string" variable="$tax_name">
3354
  <type by_reference="false">string</type>
3355
  </tag>
3356
- <tag line="750" name="param" description="Optional. 'support' (default), 'quick-edit' or 'filter'" type="string" variable="$support_type">
3357
  <type by_reference="false">string</type>
3358
  </tag>
3359
- <tag line="750" 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">
3360
  <type by_reference="false">boolean</type>
3361
  <type by_reference="false">string</type>
3362
  </tag>
3363
  </docblock>
3364
- <argument line="763">
3365
  <name>$tax_name</name>
3366
  <default><![CDATA[]]></default>
3367
  <type/>
3368
  </argument>
3369
- <argument line="763">
3370
  <name>$support_type</name>
3371
  <default><![CDATA['support']]></default>
3372
  <type/>
3373
  </argument>
3374
  </method>
3375
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="839" package="Media Library Assistant">
3376
  <name>mla_taxonomy_option_handler</name>
3377
  <full_name>mla_taxonomy_option_handler</full_name>
3378
- <docblock line="826">
3379
  <description><![CDATA[Render and manage taxonomy support options, e.g., Categories and Post Tags]]></description>
3380
  <long-description><![CDATA[]]></long-description>
3381
- <tag line="826" name="since" description="0.30"/>
3382
- <tag line="826" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3383
- <tag line="826" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
3384
  <type by_reference="false">string</type>
3385
  </tag>
3386
- <tag line="826" name="param" description="option name, e.g., 'taxonomy_support'" type="string" variable="$key">
3387
  <type by_reference="false">string</type>
3388
  </tag>
3389
- <tag line="826" name="param" description="option parameters" type="array" variable="$value">
3390
  <type by_reference="false">array</type>
3391
  </tag>
3392
- <tag line="826" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
3393
  <type by_reference="false">array</type>
3394
  </tag>
3395
- <tag line="826" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
3396
  <type by_reference="false">string</type>
3397
  </tag>
3398
  </docblock>
3399
- <argument line="839">
3400
  <name>$action</name>
3401
  <default><![CDATA[]]></default>
3402
  <type/>
3403
  </argument>
3404
- <argument line="839">
3405
  <name>$key</name>
3406
  <default><![CDATA[]]></default>
3407
  <type/>
3408
  </argument>
3409
- <argument line="839">
3410
  <name>$value</name>
3411
  <default><![CDATA[]]></default>
3412
  <type/>
3413
  </argument>
3414
- <argument line="839">
3415
  <name>$args</name>
3416
  <default><![CDATA[null]]></default>
3417
  <type/>
3418
  </argument>
3419
  </method>
3420
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="947" package="Media Library Assistant">
3421
  <name>mla_add_attachment_action</name>
3422
  <full_name>mla_add_attachment_action</full_name>
3423
- <docblock line="938">
3424
  <description><![CDATA[Perform ITC/EXIF mapping on just-inserted attachment]]></description>
3425
  <long-description><![CDATA[]]></long-description>
3426
- <tag line="938" name="since" description="1.00"/>
3427
- <tag line="938" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
3428
  <type by_reference="false">integer</type>
3429
  </tag>
3430
- <tag line="938" name="return" description="" type="void">
3431
  <type by_reference="false">void</type>
3432
  </tag>
3433
  </docblock>
3434
- <argument line="947">
3435
  <name>$post_id</name>
3436
  <default><![CDATA[]]></default>
3437
  <type/>
3438
  </argument>
3439
  </method>
3440
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="967" package="Media Library Assistant">
3441
  <name>mla_update_attachment_metadata_filter</name>
3442
  <full_name>mla_update_attachment_metadata_filter</full_name>
3443
- <docblock line="957">
3444
  <description><![CDATA[Perform Custom Field mapping on just-inserted or updated attachment]]></description>
3445
  <long-description><![CDATA[]]></long-description>
3446
- <tag line="957" name="since" description="1.10"/>
3447
- <tag line="957" name="param" description="Attachment metadata for just-inserted attachment" type="array" variable="$data">
3448
  <type by_reference="false">array</type>
3449
  </tag>
3450
- <tag line="957" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
3451
  <type by_reference="false">integer</type>
3452
  </tag>
3453
- <tag line="957" name="return" description="" type="void">
3454
  <type by_reference="false">void</type>
3455
  </tag>
3456
  </docblock>
3457
- <argument line="967">
3458
  <name>$data</name>
3459
  <default><![CDATA[]]></default>
3460
  <type/>
3461
  </argument>
3462
- <argument line="967">
3463
  <name>$post_id</name>
3464
  <default><![CDATA[]]></default>
3465
  <type/>
3466
  </argument>
3467
  </method>
3468
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="987" package="Media Library Assistant">
3469
  <name>mla_custom_field_option_value</name>
3470
  <full_name>mla_custom_field_option_value</full_name>
3471
- <docblock line="978">
3472
  <description><![CDATA[Fetch custom field option value given a slug]]></description>
3473
  <long-description><![CDATA[]]></long-description>
3474
- <tag line="978" name="since" description="1.10"/>
3475
- <tag line="978" name="param" description="slug, e.g., 'c_file-size' for the 'File Size' field" type="string" variable="$slug">
3476
  <type by_reference="false">string</type>
3477
  </tag>
3478
- <tag line="978" name="return" description="option value, e.g., array( 'name' =&gt; 'File Size', ... )" type="array">
3479
  <type by_reference="false">array</type>
3480
  </tag>
3481
  </docblock>
3482
- <argument line="987">
3483
  <name>$slug</name>
3484
  <default><![CDATA[]]></default>
3485
  <type/>
3486
  </argument>
3487
  </method>
3488
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1007" package="Media Library Assistant">
3489
  <name>mla_custom_field_support</name>
3490
  <full_name>mla_custom_field_support</full_name>
3491
- <docblock line="998">
3492
  <description><![CDATA[Evaluate file information for custom field mapping]]></description>
3493
  <long-description><![CDATA[]]></long-description>
3494
- <tag line="998" name="since" description="1.10"/>
3495
- <tag line="998" name="param" description="array format; 'default_columns' (default), 'default_hidden_columns', 'default_sortable_columns', 'quick_edit' or 'bulk_edit'" type="string" variable="$support_type">
3496
  <type by_reference="false">string</type>
3497
  </tag>
3498
- <tag line="998" name="return" description="default, hidden, sortable quick_edit or bulk_edit colums in appropriate format" type="array">
3499
  <type by_reference="false">array</type>
3500
  </tag>
3501
  </docblock>
3502
- <argument line="1007">
3503
  <name>$support_type</name>
3504
  <default><![CDATA['default_columns']]></default>
3505
  <type/>
3506
  </argument>
3507
  </method>
3508
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1053" package="Media Library Assistant">
3509
  <name>_evaluate_file_information</name>
3510
  <full_name>_evaluate_file_information</full_name>
3511
- <docblock line="1041">
3512
  <description><![CDATA[Evaluate file information for custom field mapping]]></description>
3513
  <long-description><![CDATA[]]></long-description>
3514
- <tag line="1041" name="since" description="1.10"/>
3515
- <tag line="1041" name="param" description="absolute path the the uploads base directory" type="string" variable="$upload_dir">
3516
  <type by_reference="false">string</type>
3517
  </tag>
3518
- <tag line="1041" name="param" description="_wp_attached_file meta_value array, indexed by post_id" type="array" variable="$wp_attached_files">
3519
  <type by_reference="false">array</type>
3520
  </tag>
3521
- <tag line="1041" name="param" description="_wp_attachment_metadata meta_value array, indexed by post_id" type="array" variable="$wp_attachment_metadata">
3522
  <type by_reference="false">array</type>
3523
  </tag>
3524
- <tag line="1041" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
3525
  <type by_reference="false">integer</type>
3526
  </tag>
3527
- <tag line="1041" name="return" description="absolute_path, base_file, path, file_name, extension, dimensions, width, height, hwstring_small, array of intermediate sizes" type="array">
3528
  <type by_reference="false">array</type>
3529
  </tag>
3530
  </docblock>
3531
- <argument line="1053">
3532
  <name>$upload_dir</name>
3533
  <default><![CDATA[]]></default>
3534
  <type/>
3535
  </argument>
3536
- <argument line="1053">
3537
  <name>$wp_attached_files</name>
3538
  <default><![CDATA[]]></default>
3539
  <type/>
3540
  </argument>
3541
- <argument line="1053">
3542
  <name>$wp_attachment_metadata</name>
3543
  <default><![CDATA[]]></default>
3544
  <type/>
3545
  </argument>
3546
- <argument line="1053">
3547
  <name>$post_id</name>
3548
  <default><![CDATA[]]></default>
3549
  <type/>
3550
  </argument>
3551
  </method>
3552
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1126" package="Media Library Assistant">
3553
  <name>_evaluate_data_source</name>
3554
  <full_name>_evaluate_data_source</full_name>
3555
- <docblock line="1113">
3556
  <description><![CDATA[Evaluate custom field mapping data source]]></description>
3557
  <long-description><![CDATA[]]></long-description>
3558
- <tag line="1113" name="since" description="1.10"/>
3559
- <tag line="1113" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
3560
  <type by_reference="false">integer</type>
3561
  </tag>
3562
- <tag line="1113" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
3563
- <type by_reference="false">string</type>
3564
- </tag>
3565
- <tag line="1113" name="param" description="data source name" type="string" variable="$data_source">
3566
  <type by_reference="false">string</type>
3567
  </tag>
3568
- <tag line="1113" name="param" description="desired results format, default 'native'" type="string" variable="$format">
3569
- <type by_reference="false">string</type>
3570
  </tag>
3571
- <tag line="1113" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
3572
  <type by_reference="false">array</type>
3573
  </tag>
3574
- <tag line="1113" name="return" description="data source value" type="string">
3575
  <type by_reference="false">string</type>
3576
  </tag>
3577
  </docblock>
3578
- <argument line="1126">
3579
  <name>$post_id</name>
3580
  <default><![CDATA[]]></default>
3581
  <type/>
3582
  </argument>
3583
- <argument line="1126">
3584
  <name>$category</name>
3585
  <default><![CDATA[]]></default>
3586
  <type/>
3587
  </argument>
3588
- <argument line="1126">
3589
- <name>$data_source</name>
3590
  <default><![CDATA[]]></default>
3591
  <type/>
3592
  </argument>
3593
- <argument line="1126">
3594
- <name>$format</name>
3595
- <default><![CDATA['native']]></default>
3596
- <type/>
3597
- </argument>
3598
- <argument line="1126">
3599
  <name>$attachment_metadata</name>
3600
  <default><![CDATA[NULL]]></default>
3601
  <type/>
3602
  </argument>
3603
  </method>
3604
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1366" package="Media Library Assistant">
3605
  <name>mla_evaluate_custom_field_mapping</name>
3606
  <full_name>mla_evaluate_custom_field_mapping</full_name>
3607
- <docblock line="1354">
3608
  <description><![CDATA[Evaluate custom field mapping updates for a post]]></description>
3609
  <long-description><![CDATA[]]></long-description>
3610
- <tag line="1354" name="since" description="1.10"/>
3611
- <tag line="1354" name="param" description="post ID to be evaluated" type="integer" variable="$post_id">
3612
  <type by_reference="false">integer</type>
3613
  </tag>
3614
- <tag line="1354" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
3615
  <type by_reference="false">string</type>
3616
  </tag>
3617
- <tag line="1354" name="param" description="(optional) custom_field_mapping values, default NULL (use current option value)" type="array" variable="$settings">
3618
  <type by_reference="false">array</type>
3619
  </tag>
3620
- <tag line="1354" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
3621
  <type by_reference="false">array</type>
3622
  </tag>
3623
- <tag line="1354" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
3624
  <type by_reference="false">array</type>
3625
  </tag>
3626
  </docblock>
3627
- <argument line="1366">
3628
  <name>$post_id</name>
3629
  <default><![CDATA[]]></default>
3630
  <type/>
3631
  </argument>
3632
- <argument line="1366">
3633
  <name>$category</name>
3634
  <default><![CDATA[]]></default>
3635
  <type/>
3636
  </argument>
3637
- <argument line="1366">
3638
  <name>$settings</name>
3639
  <default><![CDATA[NULL]]></default>
3640
  <type/>
3641
  </argument>
3642
- <argument line="1366">
3643
  <name>$attachment_metadata</name>
3644
  <default><![CDATA[NULL]]></default>
3645
  <type/>
3646
  </argument>
3647
  </method>
3648
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1402" package="Media Library Assistant">
3649
  <name>_compose_custom_field_option_list</name>
3650
  <full_name>_compose_custom_field_option_list</full_name>
3651
- <docblock line="1392">
3652
  <description><![CDATA[Compose a Custom Field Options list with current selection]]></description>
3653
  <long-description><![CDATA[]]></long-description>
3654
- <tag line="1392" name="since" description="1.10"/>
3655
- <tag line="1392" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3656
- <tag line="1392" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
3657
  <type by_reference="false">string</type>
3658
  </tag>
3659
- <tag line="1392" name="return" description="HTML markup with select field options" type="string">
 
 
 
3660
  <type by_reference="false">string</type>
3661
  </tag>
3662
  </docblock>
3663
- <argument line="1402">
3664
  <name>$selection</name>
3665
  <default><![CDATA['none']]></default>
3666
  <type/>
3667
  </argument>
 
 
 
 
 
3668
  </method>
3669
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1477" package="Media Library Assistant">
3670
  <name>_compose_data_source_option_list</name>
3671
  <full_name>_compose_data_source_option_list</full_name>
3672
- <docblock line="1467">
3673
  <description><![CDATA[Compose a (Custom Field) Data Source Options list with current selection]]></description>
3674
  <long-description><![CDATA[]]></long-description>
3675
- <tag line="1467" name="since" description="1.10"/>
3676
- <tag line="1467" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3677
- <tag line="1467" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
3678
  <type by_reference="false">string</type>
3679
  </tag>
3680
- <tag line="1467" name="return" description="HTML markup with select field options" type="string">
3681
  <type by_reference="false">string</type>
3682
  </tag>
3683
  </docblock>
3684
- <argument line="1477">
3685
  <name>$selection</name>
3686
  <default><![CDATA['none']]></default>
3687
  <type/>
3688
  </argument>
3689
  </method>
3690
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1528" package="Media Library Assistant">
3691
  <name>_update_custom_field_mapping</name>
3692
  <full_name>_update_custom_field_mapping</full_name>
3693
- <docblock line="1518">
3694
  <description><![CDATA[Update custom field mappings]]></description>
3695
  <long-description><![CDATA[]]></long-description>
3696
- <tag line="1518" name="since" description="1.10"/>
3697
- <tag line="1518" name="param" description="current custom_field_mapping values" type="array" variable="$current_values">
3698
  <type by_reference="false">array</type>
3699
  </tag>
3700
- <tag line="1518" name="param" description="new values" type="array" variable="$new_values">
3701
  <type by_reference="false">array</type>
3702
  </tag>
3703
- <tag line="1518" 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">
3704
  <type by_reference="false">array</type>
3705
  </tag>
3706
  </docblock>
3707
- <argument line="1528">
3708
  <name>$current_values</name>
3709
  <default><![CDATA[]]></default>
3710
  <type/>
3711
  </argument>
3712
- <argument line="1528">
3713
  <name>$new_values</name>
3714
  <default><![CDATA[]]></default>
3715
  <type/>
3716
  </argument>
3717
  </method>
3718
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1684" package="Media Library Assistant">
3719
  <name>mla_custom_field_option_handler</name>
3720
  <full_name>mla_custom_field_option_handler</full_name>
3721
- <docblock line="1671">
3722
  <description><![CDATA[Render and manage custom field mapping options]]></description>
3723
  <long-description><![CDATA[]]></long-description>
3724
- <tag line="1671" name="since" description="1.10"/>
3725
- <tag line="1671" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3726
- <tag line="1671" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
3727
  <type by_reference="false">string</type>
3728
  </tag>
3729
- <tag line="1671" name="param" description="option name, e.g., 'custom_field_mapping'" type="string" variable="$key">
3730
  <type by_reference="false">string</type>
3731
  </tag>
3732
- <tag line="1671" name="param" description="option parameters" type="array" variable="$value">
3733
  <type by_reference="false">array</type>
3734
  </tag>
3735
- <tag line="1671" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
3736
  <type by_reference="false">array</type>
3737
  </tag>
3738
- <tag line="1671" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
3739
  <type by_reference="false">string</type>
3740
  </tag>
3741
  </docblock>
3742
- <argument line="1684">
3743
  <name>$action</name>
3744
  <default><![CDATA[]]></default>
3745
  <type/>
3746
  </argument>
3747
- <argument line="1684">
3748
  <name>$key</name>
3749
  <default><![CDATA[]]></default>
3750
  <type/>
3751
  </argument>
3752
- <argument line="1684">
3753
  <name>$value</name>
3754
  <default><![CDATA[]]></default>
3755
  <type/>
3756
  </argument>
3757
- <argument line="1684">
3758
  <name>$args</name>
3759
  <default><![CDATA[null]]></default>
3760
  <type/>
3761
  </argument>
3762
  </method>
3763
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1828" package="Media Library Assistant">
3764
  <name>mla_evaluate_iptc_exif_mapping</name>
3765
  <full_name>mla_evaluate_iptc_exif_mapping</full_name>
3766
- <docblock line="1817">
3767
  <description><![CDATA[Evaluate IPTC/EXIF mapping updates for a post]]></description>
3768
  <long-description><![CDATA[]]></long-description>
3769
- <tag line="1817" name="since" description="1.00"/>
3770
- <tag line="1817" name="param" description="post object with current values" type="object" variable="$post">
3771
  <type by_reference="false">object</type>
3772
  </tag>
3773
- <tag line="1817" name="param" description="category to evaluate against, e.g., iptc_exif_standard_mapping or iptc_exif_mapping" type="string" variable="$category">
3774
  <type by_reference="false">string</type>
3775
  </tag>
3776
- <tag line="1817" name="param" description="(optional) iptc_exif_mapping values, default - current option value" type="array" variable="$settings">
3777
  <type by_reference="false">array</type>
3778
  </tag>
3779
- <tag line="1817" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
3780
  <type by_reference="false">array</type>
3781
  </tag>
3782
  </docblock>
3783
- <argument line="1828">
3784
  <name>$post</name>
3785
  <default><![CDATA[]]></default>
3786
  <type/>
3787
  </argument>
3788
- <argument line="1828">
3789
  <name>$category</name>
3790
  <default><![CDATA[]]></default>
3791
  <type/>
3792
  </argument>
3793
- <argument line="1828">
3794
  <name>$settings</name>
3795
  <default><![CDATA[NULL]]></default>
3796
  <type/>
3797
  </argument>
3798
  </method>
3799
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1989" package="Media Library Assistant">
3800
  <name>_compose_iptc_option_list</name>
3801
  <full_name>_compose_iptc_option_list</full_name>
3802
- <docblock line="1979">
3803
  <description><![CDATA[Compose an IPTC Options list with current selection]]></description>
3804
  <long-description><![CDATA[]]></long-description>
3805
- <tag line="1979" name="since" description="1.00"/>
3806
- <tag line="1979" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3807
- <tag line="1979" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
3808
  <type by_reference="false">string</type>
3809
  </tag>
3810
- <tag line="1979" name="return" description="HTML markup with select field options" type="string">
3811
  <type by_reference="false">string</type>
3812
  </tag>
3813
  </docblock>
3814
- <argument line="1989">
3815
  <name>$selection</name>
3816
  <default><![CDATA['none']]></default>
3817
  <type/>
3818
  </argument>
3819
  </method>
3820
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2022" package="Media Library Assistant">
3821
  <name>_compose_parent_option_list</name>
3822
  <full_name>_compose_parent_option_list</full_name>
3823
- <docblock line="2011">
3824
  <description><![CDATA[Compose an hierarchical taxonomy Parent options list with current selection]]></description>
3825
  <long-description><![CDATA[]]></long-description>
3826
- <tag line="2011" name="since" description="1.00"/>
3827
- <tag line="2011" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3828
- <tag line="2011" name="param" description="taxonomy slug" type="string" variable="$taxonomy">
3829
  <type by_reference="false">string</type>
3830
  </tag>
3831
- <tag line="2011" name="param" description="current selection or 0 (zero, default)" type="integer" variable="$selection">
3832
  <type by_reference="false">integer</type>
3833
  </tag>
3834
- <tag line="2011" name="return" description="HTML markup with select field options" type="string">
3835
  <type by_reference="false">string</type>
3836
  </tag>
3837
  </docblock>
3838
- <argument line="2022">
3839
  <name>$taxonomy</name>
3840
  <default><![CDATA[]]></default>
3841
  <type/>
3842
  </argument>
3843
- <argument line="2022">
3844
  <name>$selection</name>
3845
  <default><![CDATA[0]]></default>
3846
  <type/>
3847
  </argument>
3848
  </method>
3849
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2056" package="Media Library Assistant">
3850
  <name>_update_iptc_exif_standard_mapping</name>
3851
  <full_name>_update_iptc_exif_standard_mapping</full_name>
3852
- <docblock line="2046">
3853
  <description><![CDATA[Update Standard field portion of IPTC/EXIF mappings]]></description>
3854
  <long-description><![CDATA[]]></long-description>
3855
- <tag line="2046" name="since" description="1.00"/>
3856
- <tag line="2046" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3857
  <type by_reference="false">array</type>
3858
  </tag>
3859
- <tag line="2046" name="param" description="new values" type="array" variable="$new_values">
3860
  <type by_reference="false">array</type>
3861
  </tag>
3862
- <tag line="2046" 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">
3863
  <type by_reference="false">array</type>
3864
  </tag>
3865
  </docblock>
3866
- <argument line="2056">
3867
  <name>$current_values</name>
3868
  <default><![CDATA[]]></default>
3869
  <type/>
3870
  </argument>
3871
- <argument line="2056">
3872
  <name>$new_values</name>
3873
  <default><![CDATA[]]></default>
3874
  <type/>
3875
  </argument>
3876
  </method>
3877
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2135" package="Media Library Assistant">
3878
  <name>_update_iptc_exif_taxonomy_mapping</name>
3879
  <full_name>_update_iptc_exif_taxonomy_mapping</full_name>
3880
- <docblock line="2125">
3881
  <description><![CDATA[Update Taxonomy term portion of IPTC/EXIF mappings]]></description>
3882
  <long-description><![CDATA[]]></long-description>
3883
- <tag line="2125" name="since" description="1.00"/>
3884
- <tag line="2125" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3885
  <type by_reference="false">array</type>
3886
  </tag>
3887
- <tag line="2125" name="param" description="new values" type="array" variable="$new_values">
3888
  <type by_reference="false">array</type>
3889
  </tag>
3890
- <tag line="2125" 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">
3891
  <type by_reference="false">array</type>
3892
  </tag>
3893
  </docblock>
3894
- <argument line="2135">
3895
  <name>$current_values</name>
3896
  <default><![CDATA[]]></default>
3897
  <type/>
3898
  </argument>
3899
- <argument line="2135">
3900
  <name>$new_values</name>
3901
  <default><![CDATA[]]></default>
3902
  <type/>
3903
  </argument>
3904
  </method>
3905
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2227" package="Media Library Assistant">
3906
  <name>_update_iptc_exif_custom_mapping</name>
3907
  <full_name>_update_iptc_exif_custom_mapping</full_name>
3908
- <docblock line="2217">
3909
  <description><![CDATA[Update Custom field portion of IPTC/EXIF mappings]]></description>
3910
  <long-description><![CDATA[]]></long-description>
3911
- <tag line="2217" name="since" description="1.00"/>
3912
- <tag line="2217" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3913
  <type by_reference="false">array</type>
3914
  </tag>
3915
- <tag line="2217" name="param" description="new values" type="array" variable="$new_values">
3916
  <type by_reference="false">array</type>
3917
  </tag>
3918
- <tag line="2217" 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">
3919
  <type by_reference="false">array</type>
3920
  </tag>
3921
  </docblock>
3922
- <argument line="2227">
3923
  <name>$current_values</name>
3924
  <default><![CDATA[]]></default>
3925
  <type/>
3926
  </argument>
3927
- <argument line="2227">
3928
  <name>$new_values</name>
3929
  <default><![CDATA[]]></default>
3930
  <type/>
3931
  </argument>
3932
  </method>
3933
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2323" package="Media Library Assistant">
3934
  <name>_get_custom_field_names</name>
3935
  <full_name>_get_custom_field_names</full_name>
3936
- <docblock line="2316">
3937
  <description><![CDATA[Generate a list of all (post) Custom Field names]]></description>
3938
  <long-description><![CDATA[]]></long-description>
3939
- <tag line="2316" name="since" description="1.00"/>
3940
- <tag line="2316" name="return" description="Custom field names from the postmeta table" type="array">
3941
  <type by_reference="false">array</type>
3942
  </tag>
3943
  </docblock>
3944
  </method>
3945
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2352" package="Media Library Assistant">
3946
  <name>mla_iptc_exif_option_handler</name>
3947
  <full_name>mla_iptc_exif_option_handler</full_name>
3948
- <docblock line="2339">
3949
  <description><![CDATA[Render and manage iptc/exif support options]]></description>
3950
  <long-description><![CDATA[]]></long-description>
3951
- <tag line="2339" name="since" description="1.00"/>
3952
- <tag line="2339" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3953
- <tag line="2339" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
3954
  <type by_reference="false">string</type>
3955
  </tag>
3956
- <tag line="2339" name="param" description="option name, e.g., 'iptc_exif_mapping'" type="string" variable="$key">
3957
  <type by_reference="false">string</type>
3958
  </tag>
3959
- <tag line="2339" name="param" description="option parameters" type="array" variable="$value">
3960
  <type by_reference="false">array</type>
3961
  </tag>
3962
- <tag line="2339" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
3963
  <type by_reference="false">array</type>
3964
  </tag>
3965
- <tag line="2339" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
3966
  <type by_reference="false">string</type>
3967
  </tag>
3968
  </docblock>
3969
- <argument line="2352">
3970
  <name>$action</name>
3971
  <default><![CDATA[]]></default>
3972
  <type/>
3973
  </argument>
3974
- <argument line="2352">
3975
  <name>$key</name>
3976
  <default><![CDATA[]]></default>
3977
  <type/>
3978
  </argument>
3979
- <argument line="2352">
3980
  <name>$value</name>
3981
  <default><![CDATA[]]></default>
3982
  <type/>
3983
  </argument>
3984
- <argument line="2352">
3985
  <name>$args</name>
3986
  <default><![CDATA[null]]></default>
3987
  <type/>
@@ -3989,7 +4034,7 @@ settings are being updated or reset.]]></description>
3989
  </method>
3990
  </class>
3991
  </file>
3992
- <file path="includes\class-mla-settings.php" hash="dfe208cdbd5ff5e2a5fbe4bc00dcc9b7" package="Media Library Assistant">
3993
  <docblock line="2">
3994
  <description><![CDATA[Manages the settings page to edit the plugin option settings]]></description>
3995
  <long-description><![CDATA[]]></long-description>
@@ -4015,23 +4060,23 @@ settings are being updated or reset.]]></description>
4015
  <long-description><![CDATA[]]></long-description>
4016
  </docblock>
4017
  </constant>
4018
- <property final="false" static="true" visibility="private" line="372" namespace="global" package="Media Library Assistant">
4019
  <name>$page_template_array</name>
4020
  <default><![CDATA[null]]></default>
4021
- <docblock line="362">
4022
  <description><![CDATA[Template file for the Settings page(s) and parts]]></description>
4023
  <long-description><![CDATA[<p>This array contains all of the template parts for the Settings page(s). The array is built once
4024
  each page load and cached for subsequent use.</p>]]></long-description>
4025
- <tag line="362" name="since" description="0.80"/>
4026
- <tag line="362" name="var" description="" type="array">
4027
  <type by_reference="false">array</type>
4028
  </tag>
4029
  </docblock>
4030
  </property>
4031
- <property final="false" static="true" visibility="private" line="388" namespace="global" package="Media Library Assistant">
4032
  <name>$mla_tablist</name>
4033
  <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>
4034
- <docblock line="374">
4035
  <description><![CDATA[Definitions for Settings page tab ids, titles and handlers
4036
  Each tab is defined by an array with the following elements:]]></description>
4037
  <long-description><![CDATA[<p>array key => HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)</p>
@@ -4039,8 +4084,8 @@ Each tab is defined by an array with the following elements:]]></description>
4039
  <p>title => tab label / heading text
4040
  render => rendering function for tab messages and content. Usage:
4041
  $tab_content = <a href="">'render'</a>;</p>]]></long-description>
4042
- <tag line="374" name="since" description="0.80"/>
4043
- <tag line="374" name="var" description="" type="array">
4044
  <type by_reference="false">array</type>
4045
  </tag>
4046
  </docblock>
@@ -4069,386 +4114,414 @@ render => rendering function for tab messages and content. Usage:
4069
  </tag>
4070
  </docblock>
4071
  </method>
4072
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="96" package="Media Library Assistant">
4073
  <name>mla_activation_hook</name>
4074
  <full_name>mla_activation_hook</full_name>
4075
- <docblock line="87">
4076
  <description><![CDATA[Perform one-time actions on plugin activation]]></description>
4077
  <long-description><![CDATA[<p>Adds a view to the database to support sorting the listing on 'ALT Text'.</p>]]></long-description>
4078
- <tag line="87" name="since" description="0.40"/>
4079
- <tag line="87" name="return" description="" type="void">
4080
  <type by_reference="false">void</type>
4081
  </tag>
4082
  </docblock>
4083
  </method>
4084
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="109" package="Media Library Assistant">
4085
  <name>mla_deactivation_hook</name>
4086
  <full_name>mla_deactivation_hook</full_name>
4087
- <docblock line="100">
4088
  <description><![CDATA[Perform one-time actions on plugin deactivation]]></description>
4089
  <long-description><![CDATA[<p>Removes (if present) a view from the database that supports sorting the listing on 'ALT Text'.</p>]]></long-description>
4090
- <tag line="100" name="since" description="0.40"/>
4091
- <tag line="100" name="return" description="" type="void">
4092
  <type by_reference="false">void</type>
4093
  </tag>
4094
  </docblock>
4095
  </method>
4096
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="128" package="Media Library Assistant">
4097
  <name>mla_admin_menu_action</name>
4098
  <full_name>mla_admin_menu_action</full_name>
4099
- <docblock line="120">
4100
  <description><![CDATA[Add settings page in the "Settings" section,
4101
  add settings link in the Plugins section entry for MLA.]]></description>
4102
  <long-description><![CDATA[]]></long-description>
4103
- <tag line="120" name="since" description="0.1"/>
4104
- <tag line="120" name="return" description="" type="void">
4105
  <type by_reference="false">void</type>
4106
  </tag>
4107
  </docblock>
4108
  </method>
4109
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="146" package="Media Library Assistant">
4110
  <name>mla_add_plugin_settings_link</name>
4111
  <full_name>mla_add_plugin_settings_link</full_name>
4112
- <docblock line="136">
4113
  <description><![CDATA[Add the "Settings" link to the MLA entry in the Plugins section]]></description>
4114
  <long-description><![CDATA[]]></long-description>
4115
- <tag line="136" name="since" description="0.1"/>
4116
- <tag line="136" name="param" description="array of links for the Plugin, e.g., &quot;Activate&quot;" type="array" variable="$links">
4117
  <type by_reference="false">array</type>
4118
  </tag>
4119
- <tag line="136" name="param" description="Directory and name of the plugin Index file" type="string" variable="$file">
4120
  <type by_reference="false">string</type>
4121
  </tag>
4122
- <tag line="136" name="return" description="Updated array of links for the Plugin" type="array">
4123
  <type by_reference="false">array</type>
4124
  </tag>
4125
  </docblock>
4126
- <argument line="146">
4127
  <name>$links</name>
4128
  <default><![CDATA[]]></default>
4129
  <type/>
4130
  </argument>
4131
- <argument line="146">
4132
  <name>$file</name>
4133
  <default><![CDATA[]]></default>
4134
  <type/>
4135
  </argument>
4136
  </method>
4137
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="166" package="Media Library Assistant">
4138
  <name>_update_option_row</name>
4139
  <full_name>_update_option_row</full_name>
4140
- <docblock line="155">
4141
  <description><![CDATA[Update or delete a single MLA option value]]></description>
4142
  <long-description><![CDATA[]]></long-description>
4143
- <tag line="155" name="since" description="0.80"/>
4144
- <tag line="155" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4145
- <tag line="155" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
4146
  <type by_reference="false">string</type>
4147
  </tag>
4148
- <tag line="155" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
4149
  <type by_reference="false">array</type>
4150
  </tag>
4151
- <tag line="155" name="return" description="HTML markup for the option's table row" type="string">
4152
  <type by_reference="false">string</type>
4153
  </tag>
4154
  </docblock>
4155
- <argument line="166">
4156
  <name>$key</name>
4157
  <default><![CDATA[]]></default>
4158
  <type/>
4159
  </argument>
4160
- <argument line="166">
4161
  <name>$value</name>
4162
  <default><![CDATA[]]></default>
4163
  <type/>
4164
  </argument>
4165
  </method>
4166
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="244" package="Media Library Assistant">
4167
  <name>_compose_option_row</name>
4168
  <full_name>_compose_option_row</full_name>
4169
- <docblock line="233">
4170
  <description><![CDATA[Compose the table row for a single MLA option]]></description>
4171
  <long-description><![CDATA[]]></long-description>
4172
- <tag line="233" name="since" description="0.80"/>
4173
- <tag line="233" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4174
- <tag line="233" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
4175
  <type by_reference="false">string</type>
4176
  </tag>
4177
- <tag line="233" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
4178
  <type by_reference="false">array</type>
4179
  </tag>
4180
- <tag line="233" name="return" description="HTML markup for the option's table row" type="string">
4181
  <type by_reference="false">string</type>
4182
  </tag>
4183
  </docblock>
4184
- <argument line="244">
4185
  <name>$key</name>
4186
  <default><![CDATA[]]></default>
4187
  <type/>
4188
  </argument>
4189
- <argument line="244">
4190
  <name>$value</name>
4191
  <default><![CDATA[]]></default>
4192
  <type/>
4193
  </argument>
4194
  </method>
4195
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="406" package="Media Library Assistant">
4196
  <name>_compose_settings_tabs</name>
4197
  <full_name>_compose_settings_tabs</full_name>
4198
- <docblock line="396">
4199
  <description><![CDATA[Compose the navigation tabs for the Settings subpage]]></description>
4200
  <long-description><![CDATA[]]></long-description>
4201
- <tag line="396" name="since" description="0.80"/>
4202
- <tag line="396" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4203
- <tag line="396" name="param" description="Optional data-tab-id value for the active tab, default 'general'" type="string" variable="$active_tab">
4204
  <type by_reference="false">string</type>
4205
  </tag>
4206
- <tag line="396" name="return" description="HTML markup for the Settings subpage navigation tabs" type="string">
4207
  <type by_reference="false">string</type>
4208
  </tag>
4209
  </docblock>
4210
- <argument line="406">
4211
  <name>$active_tab</name>
4212
  <default><![CDATA['general']]></default>
4213
  <type/>
4214
  </argument>
4215
  </method>
4216
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="432" package="Media Library Assistant">
4217
  <name>_compose_general_tab</name>
4218
  <full_name>_compose_general_tab</full_name>
4219
- <docblock line="424">
4220
  <description><![CDATA[Compose the General tab content for the Settings subpage]]></description>
4221
  <long-description><![CDATA[]]></long-description>
4222
- <tag line="424" name="since" description="0.80"/>
4223
- <tag line="424" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4224
- <tag line="424" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
4225
  <type by_reference="false">array</type>
4226
  </tag>
4227
  </docblock>
4228
  </method>
4229
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="517" package="Media Library Assistant">
4230
  <name>_compose_mla_gallery_tab</name>
4231
  <full_name>_compose_mla_gallery_tab</full_name>
4232
- <docblock line="509">
4233
  <description><![CDATA[Compose the MLA Gallery tab content for the Settings subpage]]></description>
4234
  <long-description><![CDATA[]]></long-description>
4235
- <tag line="509" name="since" description="0.80"/>
4236
- <tag line="509" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4237
- <tag line="509" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
4238
  <type by_reference="false">array</type>
4239
  </tag>
4240
  </docblock>
4241
  </method>
4242
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="816" package="Media Library Assistant">
4243
  <name>_compose_custom_field_tab</name>
4244
  <full_name>_compose_custom_field_tab</full_name>
4245
- <docblock line="808">
4246
  <description><![CDATA[Compose the Custom Field tab content for the Settings subpage]]></description>
4247
  <long-description><![CDATA[]]></long-description>
4248
- <tag line="808" name="since" description="1.10"/>
4249
- <tag line="808" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4250
- <tag line="808" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
4251
  <type by_reference="false">array</type>
4252
  </tag>
4253
  </docblock>
4254
  </method>
4255
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="921" package="Media Library Assistant">
4256
  <name>_compose_iptc_exif_tab</name>
4257
  <full_name>_compose_iptc_exif_tab</full_name>
4258
- <docblock line="913">
4259
  <description><![CDATA[Compose the IPTC/EXIF tab content for the Settings subpage]]></description>
4260
  <long-description><![CDATA[]]></long-description>
4261
- <tag line="913" name="since" description="1.00"/>
4262
- <tag line="913" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4263
- <tag line="913" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
4264
  <type by_reference="false">array</type>
4265
  </tag>
4266
  </docblock>
4267
  </method>
4268
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="993" package="Media Library Assistant">
4269
  <name>_compose_documentation_tab</name>
4270
  <full_name>_compose_documentation_tab</full_name>
4271
- <docblock line="985">
4272
  <description><![CDATA[Compose the Documentation tab content for the Settings subpage]]></description>
4273
  <long-description><![CDATA[]]></long-description>
4274
- <tag line="985" name="since" description="0.80"/>
4275
- <tag line="985" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4276
- <tag line="985" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
4277
  <type by_reference="false">array</type>
4278
  </tag>
4279
  </docblock>
4280
  </method>
4281
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1012" package="Media Library Assistant">
4282
  <name>mla_render_settings_page</name>
4283
  <full_name>mla_render_settings_page</full_name>
4284
- <docblock line="1005">
4285
  <description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
4286
  <long-description><![CDATA[]]></long-description>
4287
- <tag line="1005" name="since" description="0.1"/>
4288
- <tag line="1005" name="return" description="Echoes HTML markup for the Settings subpage" type="void">
4289
  <type by_reference="false">void</type>
4290
  </tag>
4291
  </docblock>
4292
  </method>
4293
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1063" package="Media Library Assistant">
4294
  <name>_save_gallery_settings</name>
4295
  <full_name>_save_gallery_settings</full_name>
4296
- <docblock line="1054">
4297
  <description><![CDATA[Save MLA Gallery settings to the options table]]></description>
4298
  <long-description><![CDATA[]]></long-description>
4299
- <tag line="1054" name="since" description="0.80"/>
4300
- <tag line="1054" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4301
- <tag line="1054" name="return" description="Message(s) reflecting the results of the operation" type="array">
4302
  <type by_reference="false">array</type>
4303
  </tag>
4304
  </docblock>
4305
  </method>
4306
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1296" package="Media Library Assistant">
4307
  <name>_process_custom_field_mapping</name>
4308
  <full_name>_process_custom_field_mapping</full_name>
4309
- <docblock line="1285">
4310
  <description><![CDATA[Process custom field settings against all image attachments
4311
  without saving the settings to the mla_option]]></description>
4312
  <long-description><![CDATA[]]></long-description>
4313
- <tag line="1285" name="since" description="1.10"/>
4314
- <tag line="1285" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4315
- <tag line="1285" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$settings">
4316
  <type by_reference="false">array</type>
4317
  </tag>
4318
- <tag line="1285" name="return" description="Message(s) reflecting the results of the operation" type="array">
4319
  <type by_reference="false">array</type>
4320
  </tag>
4321
  </docblock>
4322
- <argument line="1296">
4323
  <name>$settings</name>
4324
  <default><![CDATA[NULL]]></default>
4325
  <type/>
4326
  </argument>
4327
  </method>
4328
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1348" package="Media Library Assistant">
4329
  <name>_delete_custom_field</name>
4330
  <full_name>_delete_custom_field</full_name>
4331
- <docblock line="1339">
4332
  <description><![CDATA[Delete a custom field from the wp_postmeta table]]></description>
4333
  <long-description><![CDATA[]]></long-description>
4334
- <tag line="1339" name="since" description="1.10"/>
4335
- <tag line="1339" name="param" description="specific custom_field_mapping rule" type="array" variable="$value">
4336
  <type by_reference="false">array</type>
4337
  </tag>
4338
- <tag line="1339" name="return" description="Message(s) reflecting the results of the operation" type="array">
4339
  <type by_reference="false">array</type>
4340
  </tag>
4341
  </docblock>
4342
- <argument line="1348">
4343
  <name>$value</name>
4344
  <default><![CDATA[]]></default>
4345
  <type/>
4346
  </argument>
4347
  </method>
4348
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1372" package="Media Library Assistant">
4349
  <name>_save_custom_field_settings</name>
4350
  <full_name>_save_custom_field_settings</full_name>
4351
- <docblock line="1362">
4352
  <description><![CDATA[Save custom field settings to the options table]]></description>
4353
  <long-description><![CDATA[]]></long-description>
4354
- <tag line="1362" name="since" description="1.10"/>
4355
- <tag line="1362" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4356
- <tag line="1362" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$new_values">
4357
  <type by_reference="false">array</type>
4358
  </tag>
4359
- <tag line="1362" name="return" description="Message(s) reflecting the results of the operation" type="array">
4360
  <type by_reference="false">array</type>
4361
  </tag>
4362
  </docblock>
4363
- <argument line="1372">
4364
  <name>$new_values</name>
4365
  <default><![CDATA[NULL]]></default>
4366
  <type/>
4367
  </argument>
4368
  </method>
4369
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1412" package="Media Library Assistant">
4370
  <name>_process_iptc_exif_standard</name>
4371
  <full_name>_process_iptc_exif_standard</full_name>
4372
- <docblock line="1402">
4373
  <description><![CDATA[Process IPTC/EXIF standard field settings against all image attachments
4374
  without saving the settings to the mla_option]]></description>
4375
  <long-description><![CDATA[]]></long-description>
4376
- <tag line="1402" name="since" description="1.00"/>
4377
- <tag line="1402" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4378
- <tag line="1402" name="return" description="Message(s) reflecting the results of the operation" type="array">
4379
  <type by_reference="false">array</type>
4380
  </tag>
4381
  </docblock>
4382
  </method>
4383
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1456" package="Media Library Assistant">
4384
  <name>_process_iptc_exif_taxonomy</name>
4385
  <full_name>_process_iptc_exif_taxonomy</full_name>
4386
- <docblock line="1446">
4387
  <description><![CDATA[Process IPTC/EXIF taxonomy term settings against all image attachments
4388
  without saving the settings to the mla_option]]></description>
4389
  <long-description><![CDATA[]]></long-description>
4390
- <tag line="1446" name="since" description="1.00"/>
4391
- <tag line="1446" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4392
- <tag line="1446" name="return" description="Message(s) reflecting the results of the operation" type="array">
4393
  <type by_reference="false">array</type>
4394
  </tag>
4395
  </docblock>
4396
  </method>
4397
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1501" package="Media Library Assistant">
4398
  <name>_process_iptc_exif_custom</name>
4399
  <full_name>_process_iptc_exif_custom</full_name>
4400
- <docblock line="1491">
4401
  <description><![CDATA[Process IPTC/EXIF custom field settings against all image attachments
4402
  without saving the settings to the mla_option]]></description>
4403
  <long-description><![CDATA[]]></long-description>
4404
- <tag line="1491" name="since" description="1.00"/>
4405
- <tag line="1491" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4406
- <tag line="1491" name="return" description="Message(s) reflecting the results of the operation" type="array">
 
 
 
4407
  <type by_reference="false">array</type>
4408
  </tag>
4409
  </docblock>
 
 
 
 
 
4410
  </method>
4411
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1548" package="Media Library Assistant">
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4412
  <name>_save_iptc_exif_settings</name>
4413
  <full_name>_save_iptc_exif_settings</full_name>
4414
- <docblock line="1539">
4415
  <description><![CDATA[Save IPTC/EXIF settings to the options table]]></description>
4416
  <long-description><![CDATA[]]></long-description>
4417
- <tag line="1539" name="since" description="1.00"/>
4418
- <tag line="1539" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4419
- <tag line="1539" name="return" description="Message(s) reflecting the results of the operation" type="array">
4420
  <type by_reference="false">array</type>
4421
  </tag>
4422
  </docblock>
4423
  </method>
4424
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1585" package="Media Library Assistant">
4425
  <name>_save_general_settings</name>
4426
  <full_name>_save_general_settings</full_name>
4427
- <docblock line="1576">
4428
  <description><![CDATA[Save General settings to the options table]]></description>
4429
  <long-description><![CDATA[]]></long-description>
4430
- <tag line="1576" name="since" description="0.1"/>
4431
- <tag line="1576" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4432
- <tag line="1576" name="return" description="Message(s) reflecting the results of the operation" type="array">
4433
  <type by_reference="false">array</type>
4434
  </tag>
4435
  </docblock>
4436
  </method>
4437
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1643" package="Media Library Assistant">
4438
  <name>_reset_general_settings</name>
4439
  <full_name>_reset_general_settings</full_name>
4440
- <docblock line="1636">
4441
  <description><![CDATA[Delete saved settings, restoring default values]]></description>
4442
  <long-description><![CDATA[]]></long-description>
4443
- <tag line="1636" name="since" description="0.1"/>
4444
- <tag line="1636" name="return" description="Message(s) reflecting the results of the operation" type="array">
4445
  <type by_reference="false">array</type>
4446
  </tag>
4447
  </docblock>
4448
  </method>
4449
  </class>
4450
  </file>
4451
- <file path="includes\class-mla-shortcodes.php" hash="672c554493b86b4eddb607ae08bf2087" package="Media Library Assistant">
4452
  <docblock line="2">
4453
  <description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
4454
  <long-description><![CDATA[]]></long-description>
@@ -4489,10 +4562,10 @@ without saving the settings to the mla_option]]></description>
4489
  </tag>
4490
  </docblock>
4491
  </property>
4492
- <property final="false" static="true" visibility="private" line="737" namespace="global" package="Media Library Assistant">
4493
  <name>$query_parameters</name>
4494
  <default><![CDATA[array()]]></default>
4495
- <docblock line="723">
4496
  <description><![CDATA[WP_Query filter "parameters"]]></description>
4497
  <long-description><![CDATA[<p>This array defines parameters for the query's where and orderby filters,
4498
  mla_shortcode_query_posts_where_filter and mla_shortcode_query_posts_orderby_filter.
@@ -4500,73 +4573,85 @@ The parameters are set up in the mla_get_shortcode_attachments function, and
4500
  any further logic required to translate those values is contained in the filter.</p>
4501
 
4502
  <p>Array index values are: orderby, post_parent</p>]]></long-description>
4503
- <tag line="723" name="since" description="1.13"/>
4504
- <tag line="723" name="var" description="" type="array">
 
 
 
 
 
 
 
 
 
 
 
 
4505
  <type by_reference="false">array</type>
4506
  </tag>
4507
  </docblock>
4508
  </property>
4509
- <property final="false" static="true" visibility="private" line="1268" namespace="global" package="Media Library Assistant">
4510
  <name>$mla_iptc_records</name>
4511
  <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>
4512
- <docblock line="1258">
4513
  <description><![CDATA[IPTC Dataset identifiers and names]]></description>
4514
  <long-description><![CDATA[<p>This array contains the identifiers and names of Datasets defined in
4515
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
4516
- <tag line="1258" name="since" description="0.90"/>
4517
- <tag line="1258" name="var" description="" type="array">
4518
  <type by_reference="false">array</type>
4519
  </tag>
4520
  </docblock>
4521
  </property>
4522
- <property final="false" static="true" visibility="public" line="1367" namespace="global" package="Media Library Assistant">
4523
  <name>$mla_iptc_keys</name>
4524
  <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>
4525
- <docblock line="1357">
4526
  <description><![CDATA[IPTC Dataset friendly name/slug and identifiers]]></description>
4527
  <long-description><![CDATA[<p>This array contains the sanitized names and identifiers of Datasets defined in
4528
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
4529
- <tag line="1357" name="since" description="0.90"/>
4530
- <tag line="1357" name="var" description="" type="array">
4531
  <type by_reference="false">array</type>
4532
  </tag>
4533
  </docblock>
4534
  </property>
4535
- <property final="false" static="true" visibility="private" line="1466" namespace="global" package="Media Library Assistant">
4536
  <name>$mla_iptc_descriptions</name>
4537
  <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>
4538
- <docblock line="1456">
4539
  <description><![CDATA[IPTC Dataset descriptions]]></description>
4540
  <long-description><![CDATA[<p>This array contains the descriptions of Datasets defined in
4541
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
4542
- <tag line="1456" name="since" description="0.90"/>
4543
- <tag line="1456" name="var" description="" type="array">
4544
  <type by_reference="false">array</type>
4545
  </tag>
4546
  </docblock>
4547
  </property>
4548
- <property final="false" static="true" visibility="private" line="1565" namespace="global" package="Media Library Assistant">
4549
  <name>$mla_iptc_formats</name>
4550
  <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>
4551
- <docblock line="1555">
4552
  <description><![CDATA[IPTC file format identifiers and descriptions]]></description>
4553
  <long-description><![CDATA[<p>This array contains the file format identifiers and descriptions defined in
4554
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 1#020.</p>]]></long-description>
4555
- <tag line="1555" name="since" description="0.90"/>
4556
- <tag line="1555" name="var" description="" type="array">
4557
  <type by_reference="false">array</type>
4558
  </tag>
4559
  </docblock>
4560
  </property>
4561
- <property final="false" static="true" visibility="private" line="1608" namespace="global" package="Media Library Assistant">
4562
  <name>$mla_iptc_image_types</name>
4563
  <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>
4564
- <docblock line="1598">
4565
  <description><![CDATA[IPTC image type identifiers and descriptions]]></description>
4566
  <long-description><![CDATA[<p>This array contains the image type identifiers and descriptions defined in
4567
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 2#130, octet 2.</p>]]></long-description>
4568
- <tag line="1598" name="since" description="0.90"/>
4569
- <tag line="1598" name="var" description="" type="array">
4570
  <type by_reference="false">array</type>
4571
  </tag>
4572
  </docblock>
@@ -4617,120 +4702,162 @@ Enhancements include many additional selection parameters and full taxonomy supp
4617
  <type/>
4618
  </argument>
4619
  </method>
4620
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="748" package="Media Library Assistant">
4621
  <name>_sanitize_query_specification</name>
4622
  <full_name>_sanitize_query_specification</full_name>
4623
- <docblock line="739">
4624
  <description><![CDATA[Cleans up damage caused by the Visual Editor to the tax_query and meta_query specifications]]></description>
4625
  <long-description><![CDATA[]]></long-description>
4626
- <tag line="739" name="since" description="1.14"/>
4627
- <tag line="739" name="param" description="query specification; PHP nested arrays" type="string" variable="$specification">
4628
  <type by_reference="false">string</type>
4629
  </tag>
4630
- <tag line="739" name="return" description="query specification with HTML escape sequences and line breaks removed" type="string">
4631
  <type by_reference="false">string</type>
4632
  </tag>
4633
  </docblock>
4634
- <argument line="748">
4635
  <name>$specification</name>
4636
  <default><![CDATA[]]></default>
4637
  <type/>
4638
  </argument>
4639
  </method>
4640
- <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="765" package="Media Library Assistant">
4641
  <name>_validate_sql_orderby</name>
4642
  <full_name>_validate_sql_orderby</full_name>
4643
- <docblock line="754">
4644
  <description><![CDATA[Translates query parameters to a valid SQL order by clause.]]></description>
4645
  <long-description><![CDATA[<p>Accepts one or more valid columns, with or without ASC/DESC.
4646
  Enhanced version of /wp-includes/formatting.php function sanitize_sql_orderby().</p>]]></long-description>
4647
- <tag line="754" name="since" description="1.20"/>
4648
- <tag line="754" name="param" description="Validated query parameters" type="array" variable="$query_parameters">
4649
  <type by_reference="false">array</type>
4650
  </tag>
4651
- <tag line="754" name="return" description="Returns the orderby clause if present, false otherwise." type="string|bool">
4652
  <type by_reference="false">string</type>
4653
  <type by_reference="false">bool</type>
4654
  </tag>
4655
  </docblock>
4656
- <argument line="765">
4657
  <name>$query_parameters</name>
4658
  <default><![CDATA[]]></default>
4659
  <type/>
4660
  </argument>
4661
  </method>
4662
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="849" package="Media Library Assistant">
4663
  <name>mla_get_shortcode_attachments</name>
4664
  <full_name>mla_get_shortcode_attachments</full_name>
4665
- <docblock line="839">
4666
  <description><![CDATA[Parses shortcode parameters and returns the gallery objects]]></description>
4667
  <long-description><![CDATA[]]></long-description>
4668
- <tag line="839" name="since" description=".50"/>
4669
- <tag line="839" name="param" description="Post ID of the parent" type="int" variable="$post_parent">
4670
  <type by_reference="false">int</type>
4671
  </tag>
4672
- <tag line="839" name="param" description="Attributes of the shortcode" type="array" variable="$attr">
4673
  <type by_reference="false">array</type>
4674
  </tag>
4675
- <tag line="839" name="return" description="List of attachments returned from WP_Query" type="array">
4676
  <type by_reference="false">array</type>
4677
  </tag>
4678
  </docblock>
4679
- <argument line="849">
4680
  <name>$post_parent</name>
4681
  <default><![CDATA[]]></default>
4682
  <type/>
4683
  </argument>
4684
- <argument line="849">
4685
  <name>$attr</name>
4686
  <default><![CDATA[]]></default>
4687
  <type/>
4688
  </argument>
4689
  </method>
4690
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1208" package="Media Library Assistant">
4691
  <name>mla_shortcode_query_posts_where_filter</name>
4692
  <full_name>mla_shortcode_query_posts_where_filter</full_name>
4693
- <docblock line="1194">
4694
  <description><![CDATA[Filters the WHERE clause for shortcode queries]]></description>
4695
  <long-description><![CDATA[<p>Captures debug information. Adds whitespace to the post_type = 'attachment'
4696
  phrase to circumvent subsequent Role Scoper modification of the clause.
4697
  Handles post_parent "any" and "none" cases.
4698
  Defined as public because it's a filter.</p>]]></long-description>
4699
- <tag line="1194" name="since" description="0.70"/>
4700
- <tag line="1194" name="param" description="query clause before modification" type="string" variable="$where_clause">
4701
  <type by_reference="false">string</type>
4702
  </tag>
4703
- <tag line="1194" name="return" description="query clause after modification" type="string">
4704
  <type by_reference="false">string</type>
4705
  </tag>
4706
  </docblock>
4707
- <argument line="1208">
4708
  <name>$where_clause</name>
4709
  <default><![CDATA[]]></default>
4710
  <type/>
4711
  </argument>
4712
  </method>
4713
- <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1249" package="Media Library Assistant">
4714
  <name>mla_shortcode_query_posts_orderby_filter</name>
4715
  <full_name>mla_shortcode_query_posts_orderby_filter</full_name>
4716
- <docblock line="1237">
4717
  <description><![CDATA[Filters the ORDERBY clause for shortcode queries]]></description>
4718
  <long-description><![CDATA[<p>This is an enhanced version of the code found in wp-includes/query.php, function get_posts.
4719
  Defined as public because it's a filter.</p>]]></long-description>
4720
- <tag line="1237" name="since" description="1.20"/>
4721
- <tag line="1237" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
4722
  <type by_reference="false">string</type>
4723
  </tag>
4724
- <tag line="1237" name="return" description="query clause after modification" type="string">
4725
  <type by_reference="false">string</type>
4726
  </tag>
4727
  </docblock>
4728
- <argument line="1249">
4729
  <name>$orderby_clause</name>
4730
  <default><![CDATA[]]></default>
4731
  <type/>
4732
  </argument>
4733
  </method>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4734
  </class>
4735
  </file>
4736
  <file path="includes\mla-plugin-loader.php" hash="b638ba24f0c701bf238f9d627df23d0a" package="Media Library Assistant">
@@ -4790,13 +4917,13 @@ This file is only loaded if the naming conflict tests in index.php are passed.</
4790
  </docblock>
4791
  </function>
4792
  </file>
4793
- <file path="index.php" hash="cfa69f4c3af98e97c20362b16a87ded6" package="Media Library Assistant">
4794
  <docblock line="2">
4795
  <description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
4796
  <long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
4797
  will the rest of the plugin be loaded and run.</p>]]></long-description>
4798
  <tag line="2" name="package" description="Media Library Assistant"/>
4799
- <tag line="2" name="version" description="1.20"/>
4800
  </docblock>
4801
  <include line="105" type="Require Once" package="Media Library Assistant">
4802
  <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="a0c27e5d40f15a0937efa9ad59473a0a" package="Media Library Assistant">
4
  <docblock line="2">
5
  <description><![CDATA[Database and template file access for MLA needs]]></description>
6
  <long-description><![CDATA[]]></long-description>
40
  </tag>
41
  </docblock>
42
  </property>
43
+ <property final="false" static="true" visibility="private" line="307" namespace="global" package="Media Library Assistant">
44
  <name>$query_parameters</name>
45
  <default><![CDATA[array()]]></default>
46
+ <docblock line="294">
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>
51
 
52
  <p>Array index values are: use_postmeta_view, postmeta_key, detached, orderby, order, s, mla_search_connector, mla_search_fields, sentence, exact</p>]]></long-description>
53
+ <tag line="294" name="since" description="0.30"/>
54
+ <tag line="294" name="var" description="" type="array">
55
  <type by_reference="false">array</type>
56
  </tag>
57
  </docblock>
58
  </property>
59
+ <property final="false" static="true" visibility="private" line="1258" namespace="global" package="Media Library Assistant">
60
  <name>$galleries</name>
61
  <default><![CDATA[null]]></default>
62
+ <docblock line="1240">
63
  <description><![CDATA[Objects containing [gallery] shortcodes]]></description>
64
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [gallery] shortcodes
65
  and array(s) of which attachments each [gallery] contains. The arrays are built once
71
  ['parent_type'] 'post' or 'page' or the custom post_type of the gallery parent,
72
  ['query'] contains a string with the arguments of the [gallery],
73
  ['results'] contains an array of post_ids for the objects in the gallery.</p>]]></long-description>
74
+ <tag line="1240" name="since" description="0.70"/>
75
+ <tag line="1240" name="var" description="" type="array">
76
  <type by_reference="false">array</type>
77
  </tag>
78
  </docblock>
79
  </property>
80
+ <property final="false" static="true" visibility="private" line="1271" namespace="global" package="Media Library Assistant">
81
  <name>$mla_galleries</name>
82
  <default><![CDATA[null]]></default>
83
+ <docblock line="1260">
84
  <description><![CDATA[Objects containing [mla_gallery] shortcodes]]></description>
85
  <long-description><![CDATA[<p>This array contains all of the objects containing one or more [mla_gallery] shortcodes
86
  and array(s) of which attachments each [mla_gallery] contains. The arrays are built once
87
  each page load and cached for subsequent calls.</p>]]></long-description>
88
+ <tag line="1260" name="since" description="0.70"/>
89
+ <tag line="1260" name="var" description="" type="array">
90
  <type by_reference="false">array</type>
91
  </tag>
92
  </docblock>
181
  <type/>
182
  </argument>
183
  </method>
184
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="224" package="Media Library Assistant">
185
  <name>mla_count_list_table_items</name>
186
  <full_name>mla_count_list_table_items</full_name>
187
+ <docblock line="215">
188
  <description><![CDATA[Get the total number of attachment posts]]></description>
189
  <long-description><![CDATA[]]></long-description>
190
+ <tag line="215" name="since" description="0.30"/>
191
+ <tag line="215" name="param" description="Query variables, e.g., from $_REQUEST" type="array" variable="$request">
192
  <type by_reference="false">array</type>
193
  </tag>
194
+ <tag line="215" name="return" description="Number of attachment posts" type="integer">
195
  <type by_reference="false">integer</type>
196
  </tag>
197
  </docblock>
198
+ <argument line="224">
199
  <name>$request</name>
200
  <default><![CDATA[]]></default>
201
  <type/>
202
  </argument>
203
  </method>
204
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="245" package="Media Library Assistant">
205
  <name>mla_query_list_table_items</name>
206
  <full_name>mla_query_list_table_items</full_name>
207
+ <docblock line="231">
208
  <description><![CDATA[Retrieve attachment objects for list table display]]></description>
209
  <long-description><![CDATA[<p>Supports prepare_items in class-mla-list-table.php.
210
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
211
+ <tag line="231" name="since" description="0.1"/>
212
+ <tag line="231" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
213
  <type by_reference="false">array</type>
214
  </tag>
215
+ <tag line="231" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
216
  <type by_reference="false">int</type>
217
  </tag>
218
+ <tag line="231" name="param" description="number of rows on each page" type="int" variable="$count">
219
  <type by_reference="false">int</type>
220
  </tag>
221
+ <tag line="231" name="return" description="attachment objects (posts) including parent data, meta data and references" type="array">
222
  <type by_reference="false">array</type>
223
  </tag>
224
  </docblock>
225
+ <argument line="245">
226
  <name>$request</name>
227
  <default><![CDATA[]]></default>
228
  <type/>
229
  </argument>
230
+ <argument line="245">
231
  <name>$offset</name>
232
  <default><![CDATA[]]></default>
233
  <type/>
234
  </argument>
235
+ <argument line="245">
236
  <name>$count</name>
237
  <default><![CDATA[]]></default>
238
  <type/>
239
  </argument>
240
  </method>
241
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="289" package="Media Library Assistant">
242
  <name>mla_query_media_modal_items</name>
243
  <full_name>mla_query_media_modal_items</full_name>
244
+ <docblock line="276">
245
  <description><![CDATA[Retrieve attachment objects for the WordPress Media Manager]]></description>
246
  <long-description><![CDATA[<p>Supports month-year and taxonomy-term filters as well as the enhanced search box</p>]]></long-description>
247
+ <tag line="276" name="since" description="1.20"/>
248
+ <tag line="276" name="param" description="query parameters from Media Manager" type="array" variable="$request">
249
  <type by_reference="false">array</type>
250
  </tag>
251
+ <tag line="276" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
252
  <type by_reference="false">int</type>
253
  </tag>
254
+ <tag line="276" name="param" description="number of rows on each page" type="int" variable="$count">
255
  <type by_reference="false">int</type>
256
  </tag>
257
+ <tag line="276" name="return" description="attachment objects (posts)" type="array">
258
  <type by_reference="false">array</type>
259
  </tag>
260
  </docblock>
261
+ <argument line="289">
262
  <name>$request</name>
263
  <default><![CDATA[]]></default>
264
  <type/>
265
  </argument>
266
+ <argument line="289">
267
  <name>$offset</name>
268
  <default><![CDATA[]]></default>
269
  <type/>
270
  </argument>
271
+ <argument line="289">
272
  <name>$count</name>
273
  <default><![CDATA[]]></default>
274
  <type/>
275
  </argument>
276
  </method>
277
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="323" package="Media Library Assistant">
278
  <name>_prepare_list_table_query</name>
279
  <full_name>_prepare_list_table_query</full_name>
280
+ <docblock line="309">
281
  <description><![CDATA[Sanitize and expand query arguments from request variables]]></description>
282
  <long-description><![CDATA[<p>Prepare the arguments for WP_Query.
283
  Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
284
+ <tag line="309" name="since" description="0.1"/>
285
+ <tag line="309" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$raw_request">
286
  <type by_reference="false">array</type>
287
  </tag>
288
+ <tag line="309" name="param" description="Optional number of rows (default 0) to skip over to reach desired page" type="int" variable="$offset">
289
  <type by_reference="false">int</type>
290
  </tag>
291
+ <tag line="309" name="param" description="Optional number of rows on each page (0 = all rows, default)" type="int" variable="$count">
292
  <type by_reference="false">int</type>
293
  </tag>
294
+ <tag line="309" name="return" description="revised arguments suitable for WP_Query" type="array">
295
  <type by_reference="false">array</type>
296
  </tag>
297
  </docblock>
298
+ <argument line="323">
299
  <name>$raw_request</name>
300
  <default><![CDATA[]]></default>
301
  <type/>
302
  </argument>
303
+ <argument line="323">
304
  <name>$offset</name>
305
  <default><![CDATA[0]]></default>
306
  <type/>
307
  </argument>
308
+ <argument line="323">
309
  <name>$count</name>
310
  <default><![CDATA[0]]></default>
311
  <type/>
312
  </argument>
313
  </method>
314
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="582" package="Media Library Assistant">
315
  <name>_execute_list_table_query</name>
316
  <full_name>_execute_list_table_query</full_name>
317
+ <docblock line="573">
318
  <description><![CDATA[Add filters, run query, remove filters]]></description>
319
  <long-description><![CDATA[]]></long-description>
320
+ <tag line="573" name="since" description="0.30"/>
321
+ <tag line="573" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
322
  <type by_reference="false">array</type>
323
  </tag>
324
+ <tag line="573" name="return" description="WP_Query object with query results" type="object">
325
  <type by_reference="false">object</type>
326
  </tag>
327
  </docblock>
328
+ <argument line="582">
329
  <name>$request</name>
330
  <default><![CDATA[]]></default>
331
  <type/>
332
  </argument>
333
  </method>
334
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="636" package="Media Library Assistant">
335
  <name>mla_query_posts_search_filter</name>
336
  <full_name>mla_query_posts_search_filter</full_name>
337
+ <docblock line="624">
338
  <description><![CDATA[Adds a keyword search to the WHERE clause, if required]]></description>
339
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
340
+ <tag line="624" name="since" description="0.60"/>
341
+ <tag line="624" name="param" description="query clause before modification" type="string" variable="$search_string">
342
  <type by_reference="false">string</type>
343
  </tag>
344
+ <tag line="624" name="param" description="WP_Query object" type="object" variable="$query_object">
345
  <type by_reference="false">object</type>
346
  </tag>
347
+ <tag line="624" name="return" description="query clause after keyword search addition" type="string">
348
  <type by_reference="false">string</type>
349
  </tag>
350
  </docblock>
351
+ <argument line="636">
352
  <name>$search_string</name>
353
  <default><![CDATA[]]></default>
354
  <type/>
355
  </argument>
356
+ <argument line="636">
357
  <name>$query_object</name>
358
  <default><![CDATA[]]></default>
359
  <type/>
360
  </argument>
361
  </method>
362
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="717" package="Media Library Assistant">
363
  <name>mla_query_posts_join_filter</name>
364
  <full_name>mla_query_posts_join_filter</full_name>
365
+ <docblock line="706">
366
  <description><![CDATA[Adds a JOIN clause, if required, to handle sorting/searching on ALT Text]]></description>
367
  <long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
368
+ <tag line="706" name="since" description="0.30"/>
369
+ <tag line="706" name="param" description="query clause before modification" type="string" variable="$join_clause">
370
  <type by_reference="false">string</type>
371
  </tag>
372
+ <tag line="706" name="return" description="query clause after &quot;LEFT JOIN view ON post_id&quot; item modification" type="string">
373
  <type by_reference="false">string</type>
374
  </tag>
375
  </docblock>
376
+ <argument line="717">
377
  <name>$join_clause</name>
378
  <default><![CDATA[]]></default>
379
  <type/>
380
  </argument>
381
  </method>
382
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="744" package="Media Library Assistant">
383
  <name>mla_query_posts_where_filter</name>
384
  <full_name>mla_query_posts_where_filter</full_name>
385
+ <docblock line="732">
386
  <description><![CDATA[Adds a WHERE clause for detached items]]></description>
387
  <long-description><![CDATA[<p>Modeled after _edit_attachments_query_helper in wp-admin/post.php.
388
  Defined as public because it's a filter.</p>]]></long-description>
389
+ <tag line="732" name="since" description="0.1"/>
390
+ <tag line="732" name="param" description="query clause before modification" type="string" variable="$where_clause">
391
  <type by_reference="false">string</type>
392
  </tag>
393
+ <tag line="732" name="return" description="query clause after &quot;detached&quot; item modification" type="string">
394
  <type by_reference="false">string</type>
395
  </tag>
396
  </docblock>
397
+ <argument line="744">
398
  <name>$where_clause</name>
399
  <default><![CDATA[]]></default>
400
  <type/>
401
  </argument>
402
  </method>
403
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="772" package="Media Library Assistant">
404
  <name>mla_query_posts_orderby_filter</name>
405
  <full_name>mla_query_posts_orderby_filter</full_name>
406
+ <docblock line="760">
407
  <description><![CDATA[Adds a ORDERBY clause, if required]]></description>
408
  <long-description><![CDATA[<p>Expands the range of sort options because the logic in WP_Query is limited.
409
  Defined as public because it's a filter.</p>]]></long-description>
410
+ <tag line="760" name="since" description="0.30"/>
411
+ <tag line="760" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
412
  <type by_reference="false">string</type>
413
  </tag>
414
+ <tag line="760" name="return" description="updated query clause" type="string">
415
  <type by_reference="false">string</type>
416
  </tag>
417
  </docblock>
418
+ <argument line="772">
419
  <name>$orderby_clause</name>
420
  <default><![CDATA[]]></default>
421
  <type/>
422
  </argument>
423
  </method>
424
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="830" package="Media Library Assistant">
425
  <name>mla_get_attachment_by_id</name>
426
  <full_name>mla_get_attachment_by_id</full_name>
427
+ <docblock line="818">
428
  <description><![CDATA[Retrieve an Attachment array given a $post_id]]></description>
429
  <long-description><![CDATA[<p>The (associative) array will contain every field that can be found in
430
  the posts and postmeta tables, and all references to the attachment.</p>]]></long-description>
431
+ <tag line="818" name="since" description="0.1"/>
432
+ <tag line="818" name="uses" description="\global\$post" refers="\global\$post"/>
433
+ <tag line="818" name="param" description="The ID of the attachment post" type="int" variable="$post_id">
434
  <type by_reference="false">int</type>
435
  </tag>
436
+ <tag line="818" name="return" description="NULL on failure else associative array" type="NULL|array">
437
  <type by_reference="false">NULL</type>
438
  <type by_reference="false">array</type>
439
  </tag>
440
  </docblock>
441
+ <argument line="830">
442
  <name>$post_id</name>
443
  <default><![CDATA[]]></default>
444
  <type/>
445
  </argument>
446
  </method>
447
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="875" package="Media Library Assistant">
448
  <name>mla_fetch_attachment_parent_data</name>
449
  <full_name>mla_fetch_attachment_parent_data</full_name>
450
+ <docblock line="866">
451
  <description><![CDATA[Returns information about an attachment's parent, if found]]></description>
452
  <long-description><![CDATA[]]></long-description>
453
+ <tag line="866" name="since" description="0.1"/>
454
+ <tag line="866" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent_id">
455
  <type by_reference="false">int</type>
456
  </tag>
457
+ <tag line="866" name="return" description="Parent information; post_date, post_title and post_type" type="array">
458
  <type by_reference="false">array</type>
459
  </tag>
460
  </docblock>
461
+ <argument line="875">
462
  <name>$parent_id</name>
463
  <default><![CDATA[]]></default>
464
  <type/>
465
  </argument>
466
  </method>
467
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="905" package="Media Library Assistant">
468
+ <name>mla_find_array_element</name>
469
+ <full_name>mla_find_array_element</full_name>
470
+ <docblock line="890">
471
+ <description><![CDATA[Finds the value of a key in a possibily nested array structure]]></description>
472
+ <long-description><![CDATA[<p>Used primarily to extract fields from the _wp_attachment_metadata custom field.
473
+ Could also be used with the ID3 metadata exposed in WordPress 3.6 and later.</p>]]></long-description>
474
+ <tag line="890" name="since" description="1.30"/>
475
+ <tag line="890" name="param" description="key value, e.g. array1.array2.element" type="string" variable="$needle">
476
+ <type by_reference="false">string</type>
477
+ </tag>
478
+ <tag line="890" name="param" description="PHP nested arrays" type="array" variable="$haystack">
479
+ <type by_reference="false">array</type>
480
+ </tag>
481
+ <tag line="890" name="param" description="return first element of an array result" type="boolean" variable="$single">
482
+ <type by_reference="false">boolean</type>
483
+ </tag>
484
+ <tag line="890" name="param" description="return results in var_export() format" type="boolean" variable="$export">
485
+ <type by_reference="false">boolean</type>
486
+ </tag>
487
+ <tag line="890" name="return" description="value matching key(.key ...) or ''" type="string">
488
+ <type by_reference="false">string</type>
489
+ </tag>
490
+ </docblock>
491
+ <argument line="905">
492
+ <name>$needle</name>
493
+ <default><![CDATA[]]></default>
494
+ <type/>
495
+ </argument>
496
+ <argument line="905">
497
+ <name>$haystack</name>
498
+ <default><![CDATA[]]></default>
499
+ <type/>
500
+ </argument>
501
+ <argument line="905">
502
+ <name>$single</name>
503
+ <default><![CDATA[false]]></default>
504
+ <type/>
505
+ </argument>
506
+ <argument line="905">
507
+ <name>$export</name>
508
+ <default><![CDATA[false]]></default>
509
+ <type/>
510
+ </argument>
511
+ </method>
512
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="947" package="Media Library Assistant">
513
  <name>mla_fetch_attachment_metadata</name>
514
  <full_name>mla_fetch_attachment_metadata</full_name>
515
+ <docblock line="934">
516
  <description><![CDATA[Fetch and filter meta data for an attachment]]></description>
517
  <long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
518
  are stripped out or converted to an 'mla</em>' equivalent. Array data is replaced with
519
  a string containing the first array element.</p>]]></long-description>
520
+ <tag line="934" name="since" description="0.1"/>
521
+ <tag line="934" name="param" description="post ID of attachment" type="int" variable="$post_id">
522
  <type by_reference="false">int</type>
523
  </tag>
524
+ <tag line="934" name="return" description="Meta data variables" type="array">
525
  <type by_reference="false">array</type>
526
  </tag>
527
  </docblock>
528
+ <argument line="947">
529
  <name>$post_id</name>
530
  <default><![CDATA[]]></default>
531
  <type/>
532
  </argument>
533
  </method>
534
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1013" package="Media Library Assistant">
535
  <name>mla_fetch_attachment_references</name>
536
  <full_name>mla_fetch_attachment_references</full_name>
537
+ <docblock line="1000">
538
  <description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
539
  <long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
540
  as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
541
+ <tag line="1000" name="since" description="0.1"/>
542
+ <tag line="1000" name="param" description="post ID of attachment" type="int" variable="$ID">
543
  <type by_reference="false">int</type>
544
  </tag>
545
+ <tag line="1000" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent">
546
  <type by_reference="false">int</type>
547
  </tag>
548
+ <tag line="1000" name="return" description="Reference information; see $references array comments" type="array">
549
  <type by_reference="false">array</type>
550
  </tag>
551
  </docblock>
552
+ <argument line="1013">
553
  <name>$ID</name>
554
  <default><![CDATA[]]></default>
555
  <type/>
556
  </argument>
557
+ <argument line="1013">
558
  <name>$parent</name>
559
  <default><![CDATA[]]></default>
560
  <type/>
561
  </argument>
562
  </method>
563
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1282" package="Media Library Assistant">
564
  <name>mla_flush_mla_galleries</name>
565
  <full_name>mla_flush_mla_galleries</full_name>
566
+ <docblock line="1273">
567
  <description><![CDATA[Invalidates the $mla_galleries or $galleries array and cached values]]></description>
568
  <long-description><![CDATA[]]></long-description>
569
+ <tag line="1273" name="since" description="1.00"/>
570
+ <tag line="1273" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
571
  <type by_reference="false">string</type>
572
  </tag>
573
+ <tag line="1273" name="return" description="" type="void">
574
  <type by_reference="false">void</type>
575
  </tag>
576
  </docblock>
577
+ <argument line="1282">
578
  <name>$option_name</name>
579
  <default><![CDATA[]]></default>
580
  <type/>
581
  </argument>
582
  </method>
583
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1306" package="Media Library Assistant">
584
  <name>mla_save_post_action</name>
585
  <full_name>mla_save_post_action</full_name>
586
+ <docblock line="1297">
587
  <description><![CDATA[Invalidates $mla_galleries and $galleries arrays and cached values after post, page or attachment updates]]></description>
588
  <long-description><![CDATA[]]></long-description>
589
+ <tag line="1297" name="since" description="1.00"/>
590
+ <tag line="1297" name="param" description="ID of post/page/attachment; not used at this time" type="integer" variable="$post_id">
591
  <type by_reference="false">integer</type>
592
  </tag>
593
+ <tag line="1297" name="return" description="" type="void">
594
  <type by_reference="false">void</type>
595
  </tag>
596
  </docblock>
597
+ <argument line="1306">
598
  <name>$post_id</name>
599
  <default><![CDATA[]]></default>
600
  <type/>
601
  </argument>
602
  </method>
603
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1323" package="Media Library Assistant">
604
  <name>_build_mla_galleries</name>
605
  <full_name>_build_mla_galleries</full_name>
606
+ <docblock line="1311">
607
  <description><![CDATA[Builds the $mla_galleries or $galleries array]]></description>
608
  <long-description><![CDATA[]]></long-description>
609
+ <tag line="1311" name="since" description="0.70"/>
610
+ <tag line="1311" name="param" description="name of the gallery's cache/option variable" type="string" variable="$option_name">
611
  <type by_reference="false">string</type>
612
  </tag>
613
+ <tag line="1311" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
614
  <type by_reference="false">array</type>
615
  </tag>
616
+ <tag line="1311" name="param" description="the shortcode to be searched for and processed" type="string" variable="$shortcode">
617
  <type by_reference="false">string</type>
618
  </tag>
619
+ <tag line="1311" name="param" description="true to exclude revisions from the search" type="boolean" variable="$exclude_revisions">
620
  <type by_reference="false">boolean</type>
621
  </tag>
622
+ <tag line="1311" name="return" description="true if the galleries array is not empty" type="boolean">
623
  <type by_reference="false">boolean</type>
624
  </tag>
625
  </docblock>
626
+ <argument line="1323">
627
  <name>$option_name</name>
628
  <default><![CDATA[]]></default>
629
  <type/>
630
  </argument>
631
+ <argument line="1323">
632
  <name>$galleries_array</name>
633
  <default><![CDATA[]]></default>
634
  <type/>
635
  </argument>
636
+ <argument line="1323">
637
  <name>$shortcode</name>
638
  <default><![CDATA[]]></default>
639
  <type/>
640
  </argument>
641
+ <argument line="1323">
642
  <name>$exclude_revisions</name>
643
  <default><![CDATA[]]></default>
644
  <type/>
645
  </argument>
646
  </method>
647
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1428" package="Media Library Assistant">
648
  <name>_search_mla_galleries</name>
649
  <full_name>_search_mla_galleries</full_name>
650
+ <docblock line="1417">
651
  <description><![CDATA[Search the $mla_galleries or $galleries array]]></description>
652
  <long-description><![CDATA[]]></long-description>
653
+ <tag line="1417" name="since" description="0.70"/>
654
+ <tag line="1417" name="param" description="by reference to the private static galleries array variable" type="array" variable="$galleries_array">
655
  <type by_reference="false">array</type>
656
  </tag>
657
+ <tag line="1417" name="param" description="the attachment ID to be searched for and processed" type="int" variable="$attachment_id">
658
  <type by_reference="false">int</type>
659
  </tag>
660
+ <tag line="1417" 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">
661
  <type by_reference="false">array</type>
662
  </tag>
663
  </docblock>
664
+ <argument line="1428">
665
  <name>$galleries_array</name>
666
  <default><![CDATA[]]></default>
667
  <type/>
668
  </argument>
669
+ <argument line="1428">
670
  <name>$attachment_id</name>
671
  <default><![CDATA[]]></default>
672
  <type/>
673
  </argument>
674
  </method>
675
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1454" package="Media Library Assistant">
676
  <name>mla_exif_metadata_value</name>
677
  <full_name>mla_exif_metadata_value</full_name>
678
+ <docblock line="1441">
679
  <description><![CDATA[Parse one EXIF metadata field]]></description>
680
  <long-description><![CDATA[<p>Returns a string value, converting array data to a string as necessary.
681
  Also handles the special pseudo-values 'ALL_EXIF' and 'ALL_IPTC'.</p>]]></long-description>
682
+ <tag line="1441" name="since" description="1.13"/>
683
+ <tag line="1441" name="param" description="field name" type="string" variable="$key">
684
  <type by_reference="false">string</type>
685
  </tag>
686
+ <tag line="1441" name="param" description="metadata array containing 'mla_exif_metadata' and 'mla_iptc_metadata' arrays" type="string" variable="$image_metadata">
687
  <type by_reference="false">string</type>
688
  </tag>
689
+ <tag line="1441" name="return" description="string representation of metadata value or an empty string" type="string">
690
  <type by_reference="false">string</type>
691
  </tag>
692
  </docblock>
693
+ <argument line="1454">
694
  <name>$key</name>
695
  <default><![CDATA[]]></default>
696
  <type/>
697
  </argument>
698
+ <argument line="1454">
699
  <name>$image_metadata</name>
700
  <default><![CDATA[]]></default>
701
  <type/>
702
  </argument>
703
  </method>
704
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1484" package="Media Library Assistant">
705
  <name>mla_fetch_attachment_image_metadata</name>
706
  <full_name>mla_fetch_attachment_image_metadata</full_name>
707
+ <docblock line="1472">
708
  <description><![CDATA[Fetch and filter IPTC and EXIF meta data for an image attachment]]></description>
709
  <long-description><![CDATA[<p>Returns</p>]]></long-description>
710
+ <tag line="1472" name="since" description="0.90"/>
711
+ <tag line="1472" name="param" description="post ID of attachment" type="int" variable="$post_id">
712
  <type by_reference="false">int</type>
713
  </tag>
714
+ <tag line="1472" name="param" description="optional; if $post_id is zero, path to the image file." type="string" variable="$path">
715
  <type by_reference="false">string</type>
716
  </tag>
717
+ <tag line="1472" name="return" description="Meta data variables" type="array">
718
  <type by_reference="false">array</type>
719
  </tag>
720
  </docblock>
721
+ <argument line="1484">
722
  <name>$post_id</name>
723
  <default><![CDATA[]]></default>
724
  <type/>
725
  </argument>
726
+ <argument line="1484">
727
  <name>$path</name>
728
  <default><![CDATA['']]></default>
729
  <type/>
730
  </argument>
731
  </method>
732
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1550" package="Media Library Assistant">
733
  <name>mla_update_single_item</name>
734
  <full_name>mla_update_single_item</full_name>
735
+ <docblock line="1537">
736
  <description><![CDATA[Update a single item; change the meta data
737
  for a single attachment.]]></description>
738
  <long-description><![CDATA[]]></long-description>
739
+ <tag line="1537" name="since" description="0.1"/>
740
+ <tag line="1537" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
741
  <type by_reference="false">int</type>
742
  </tag>
743
+ <tag line="1537" name="param" description="Field name =&gt; value pairs" type="array" variable="$new_data">
744
  <type by_reference="false">array</type>
745
  </tag>
746
+ <tag line="1537" name="param" description="Optional taxonomy term values, default null" type="array" variable="$tax_input">
747
  <type by_reference="false">array</type>
748
  </tag>
749
+ <tag line="1537" name="param" description="Optional taxonomy actions (add, remove, replace), default null" type="array" variable="$tax_actions">
750
  <type by_reference="false">array</type>
751
  </tag>
752
+ <tag line="1537" name="return" description="success/failure message and NULL content" type="array">
753
  <type by_reference="false">array</type>
754
  </tag>
755
  </docblock>
756
+ <argument line="1550">
757
  <name>$post_id</name>
758
  <default><![CDATA[]]></default>
759
  <type/>
760
  </argument>
761
+ <argument line="1550">
762
  <name>$new_data</name>
763
  <default><![CDATA[]]></default>
764
  <type/>
765
  </argument>
766
+ <argument line="1550">
767
  <name>$tax_input</name>
768
  <default><![CDATA[NULL]]></default>
769
  <type/>
770
  </argument>
771
+ <argument line="1550">
772
  <name>$tax_actions</name>
773
  <default><![CDATA[NULL]]></default>
774
  <type/>
775
  </argument>
776
  </method>
777
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1787" package="Media Library Assistant">
778
  <name>_remove_tags</name>
779
  <full_name>_remove_tags</full_name>
780
+ <docblock line="1776">
781
  <description><![CDATA[Remove tags from a term ids list]]></description>
782
  <long-description><![CDATA[]]></long-description>
783
+ <tag line="1776" name="since" description="0.40"/>
784
+ <tag line="1776" name="param" description="The term ids currently assigned" type="array" variable="$terms_before">
785
  <type by_reference="false">array</type>
786
  </tag>
787
+ <tag line="1776" name="param" description="| string The term ids (array) or names (string) to remove" type="array" variable="$tags">
788
  <type by_reference="false">array</type>
789
  </tag>
790
+ <tag line="1776" name="param" description="The taxonomy object" type="object" variable="$taxonomy_obj">
791
  <type by_reference="false">object</type>
792
  </tag>
793
+ <tag line="1776" name="return" description="Term ids of the surviving tags" type="array">
794
  <type by_reference="false">array</type>
795
  </tag>
796
  </docblock>
797
+ <argument line="1787">
798
  <name>$terms_before</name>
799
  <default><![CDATA[]]></default>
800
  <type/>
801
  </argument>
802
+ <argument line="1787">
803
  <name>$tags</name>
804
  <default><![CDATA[]]></default>
805
  <type/>
806
  </argument>
807
+ <argument line="1787">
808
  <name>$taxonomy_obj</name>
809
  <default><![CDATA[]]></default>
810
  <type/>
811
  </argument>
812
  </method>
813
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1830" package="Media Library Assistant">
814
  <name>_hex_dump</name>
815
  <full_name>_hex_dump</full_name>
816
+ <docblock line="1819">
817
  <description><![CDATA[Format printable version of binary data]]></description>
818
  <long-description><![CDATA[]]></long-description>
819
+ <tag line="1819" name="since" description="0.90"/>
820
+ <tag line="1819" name="param" description="Binary data" type="string" variable="$data">
821
  <type by_reference="false">string</type>
822
  </tag>
823
+ <tag line="1819" name="param" description="Bytes to format, default = 0 (all bytes)" type="integer" variable="$limit">
824
  <type by_reference="false">integer</type>
825
  </tag>
826
+ <tag line="1819" name="param" description="Bytes to format on each line" type="\intger" variable="$bytes_per_row">
827
  <type by_reference="false">\intger</type>
828
  </tag>
829
+ <tag line="1819" name="return" description="Printable representation of $data" type="string">
830
  <type by_reference="false">string</type>
831
  </tag>
832
  </docblock>
833
+ <argument line="1830">
834
  <name>$data</name>
835
  <default><![CDATA[]]></default>
836
  <type/>
837
  </argument>
838
+ <argument line="1830">
839
  <name>$limit</name>
840
  <default><![CDATA[0]]></default>
841
  <type/>
842
  </argument>
843
+ <argument line="1830">
844
  <name>$bytes_per_row</name>
845
  <default><![CDATA[16]]></default>
846
  <type/>
848
  </method>
849
  </class>
850
  </file>
851
+ <file path="includes\class-mla-edit-media.php" hash="d7a9cb06ea8902203032c6f880e205ff" package="Media Library Assistant">
852
  <docblock line="2">
853
  <description><![CDATA[Media Library Assistant Edit Media screen enhancements]]></description>
854
  <long-description><![CDATA[]]></long-description>
1152
  </method>
1153
  </class>
1154
  </file>
1155
+ <file path="includes\class-mla-list-table.php" hash="79dfb6eeb0c51367132190791c53462e" package="Media Library Assistant">
1156
  <docblock line="2">
1157
  <description><![CDATA[Media Library Assistant extended List Table class]]></description>
1158
  <long-description><![CDATA[]]></long-description>
1443
  <type/>
1444
  </argument>
1445
  </method>
1446
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="523" package="Media Library Assistant">
1447
  <name>column_cb</name>
1448
  <full_name>column_cb</full_name>
1449
+ <docblock line="514">
1450
  <description><![CDATA[Displays checkboxes for using bulk actions.]]></description>
1451
  <long-description><![CDATA[<p>The 'cb' column
1452
  is given special treatment when columns are processed.</p>]]></long-description>
1453
+ <tag line="514" name="since" description="0.1"/>
1454
+ <tag line="514" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1455
  <type by_reference="false">array</type>
1456
  </tag>
1457
+ <tag line="514" name="return" description="HTML markup to be placed inside the column" type="string">
1458
  <type by_reference="false">string</type>
1459
  </tag>
1460
  </docblock>
1461
+ <argument line="523">
1462
  <name>$item</name>
1463
  <default><![CDATA[]]></default>
1464
  <type/>
1465
  </argument>
1466
  </method>
1467
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="539" package="Media Library Assistant">
1468
  <name>column_icon</name>
1469
  <full_name>column_icon</full_name>
1470
+ <docblock line="531">
1471
  <description><![CDATA[Supply the content for a custom column]]></description>
1472
  <long-description><![CDATA[]]></long-description>
1473
+ <tag line="531" name="since" description="0.1"/>
1474
+ <tag line="531" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1475
  <type by_reference="false">array</type>
1476
  </tag>
1477
+ <tag line="531" name="return" description="HTML markup to be placed inside the column" type="string">
1478
  <type by_reference="false">string</type>
1479
  </tag>
1480
  </docblock>
1481
+ <argument line="539">
1482
  <name>$item</name>
1483
  <default><![CDATA[]]></default>
1484
  <type/>
1485
  </argument>
1486
  </method>
1487
+ <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="555" package="Media Library Assistant">
1488
  <name>_build_rollover_actions</name>
1489
  <full_name>_build_rollover_actions</full_name>
1490
+ <docblock line="544">
1491
  <description><![CDATA[Add rollover actions to exactly one of the following displayed columns:
1492
  'ID_parent', 'title_name', 'post_title', 'post_name']]></description>
1493
  <long-description><![CDATA[]]></long-description>
1494
+ <tag line="544" name="since" description="0.1"/>
1495
+ <tag line="544" name="param" description="A singular attachment (post) object" type="object" variable="$item">
1496
  <type by_reference="false">object</type>
1497
  </tag>
1498
+ <tag line="544" name="param" description="Current column name" type="string" variable="$column">
1499
  <type by_reference="false">string</type>
1500
  </tag>
1501
+ <tag line="544" name="return" description="Names and URLs of row-level actions" type="array">
1502
  <type by_reference="false">array</type>
1503
  </tag>
1504
  </docblock>
1505
+ <argument line="555">
1506
  <name>$item</name>
1507
  <default><![CDATA[]]></default>
1508
  <type/>
1509
  </argument>
1510
+ <argument line="555">
1511
  <name>$column</name>
1512
  <default><![CDATA[]]></default>
1513
  <type/>
1514
  </argument>
1515
  </method>
1516
+ <method final="false" abstract="false" static="false" visibility="private" namespace="global" line="633" package="Media Library Assistant">
1517
  <name>_build_inline_data</name>
1518
  <full_name>_build_inline_data</full_name>
1519
+ <docblock line="624">
1520
  <description><![CDATA[Add hidden fields with the data for use in the inline editor]]></description>
1521
  <long-description><![CDATA[]]></long-description>
1522
+ <tag line="624" name="since" description="0.20"/>
1523
+ <tag line="624" name="param" description="A singular attachment (post) object" type="object" variable="$item">
1524
  <type by_reference="false">object</type>
1525
  </tag>
1526
+ <tag line="624" name="return" description="HTML &lt;div&gt; with row data" type="string">
1527
  <type by_reference="false">string</type>
1528
  </tag>
1529
  </docblock>
1530
+ <argument line="633">
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="681" package="Media Library Assistant">
1537
  <name>column_ID_parent</name>
1538
  <full_name>column_ID_parent</full_name>
1539
+ <docblock line="673">
1540
  <description><![CDATA[Supply the content for a custom column]]></description>
1541
  <long-description><![CDATA[]]></long-description>
1542
+ <tag line="673" name="since" description="0.1"/>
1543
+ <tag line="673" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1544
  <type by_reference="false">array</type>
1545
  </tag>
1546
+ <tag line="673" 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="681">
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="713" package="Media Library Assistant">
1557
  <name>column_title_name</name>
1558
  <full_name>column_title_name</full_name>
1559
+ <docblock line="705">
1560
  <description><![CDATA[Supply the content for a custom column]]></description>
1561
  <long-description><![CDATA[]]></long-description>
1562
+ <tag line="705" name="since" description="0.1"/>
1563
+ <tag line="705" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1564
  <type by_reference="false">array</type>
1565
  </tag>
1566
+ <tag line="705" 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="713">
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="736" package="Media Library Assistant">
1577
  <name>column_post_title</name>
1578
  <full_name>column_post_title</full_name>
1579
+ <docblock line="728">
1580
  <description><![CDATA[Supply the content for a custom column]]></description>
1581
  <long-description><![CDATA[]]></long-description>
1582
+ <tag line="728" name="since" description="0.1"/>
1583
+ <tag line="728" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1584
  <type by_reference="false">array</type>
1585
  </tag>
1586
+ <tag line="728" 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="736">
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="754" package="Media Library Assistant">
1597
  <name>column_post_name</name>
1598
  <full_name>column_post_name</full_name>
1599
+ <docblock line="746">
1600
  <description><![CDATA[Supply the content for a custom column]]></description>
1601
  <long-description><![CDATA[]]></long-description>
1602
+ <tag line="746" name="since" description="0.1"/>
1603
+ <tag line="746" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1604
  <type by_reference="false">array</type>
1605
  </tag>
1606
+ <tag line="746" 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="754">
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="772" package="Media Library Assistant">
1617
  <name>column_parent</name>
1618
  <full_name>column_parent</full_name>
1619
+ <docblock line="764">
1620
  <description><![CDATA[Supply the content for a custom column]]></description>
1621
  <long-description><![CDATA[]]></long-description>
1622
+ <tag line="764" name="since" description="0.1"/>
1623
+ <tag line="764" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1624
  <type by_reference="false">array</type>
1625
  </tag>
1626
+ <tag line="764" 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="772">
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="797" package="Media Library Assistant">
1637
  <name>column_menu_order</name>
1638
  <full_name>column_menu_order</full_name>
1639
+ <docblock line="789">
1640
  <description><![CDATA[Supply the content for a custom column]]></description>
1641
  <long-description><![CDATA[]]></long-description>
1642
+ <tag line="789" name="since" description="0.60"/>
1643
+ <tag line="789" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1644
  <type by_reference="false">array</type>
1645
  </tag>
1646
+ <tag line="789" 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="797">
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="809" package="Media Library Assistant">
1657
  <name>column_featured</name>
1658
  <full_name>column_featured</full_name>
1659
+ <docblock line="801">
1660
  <description><![CDATA[Supply the content for a custom column]]></description>
1661
  <long-description><![CDATA[]]></long-description>
1662
+ <tag line="801" name="since" description="0.1"/>
1663
+ <tag line="801" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1664
  <type by_reference="false">array</type>
1665
  </tag>
1666
+ <tag line="801" 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="809">
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="840" package="Media Library Assistant">
1677
  <name>column_inserted</name>
1678
  <full_name>column_inserted</full_name>
1679
+ <docblock line="832">
1680
  <description><![CDATA[Supply the content for a custom column]]></description>
1681
  <long-description><![CDATA[]]></long-description>
1682
+ <tag line="832" name="since" description="0.1"/>
1683
+ <tag line="832" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1684
  <type by_reference="false">array</type>
1685
  </tag>
1686
+ <tag line="832" 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="840">
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="875" package="Media Library Assistant">
1697
  <name>column_galleries</name>
1698
  <full_name>column_galleries</full_name>
1699
+ <docblock line="867">
1700
  <description><![CDATA[Supply the content for a custom column]]></description>
1701
  <long-description><![CDATA[]]></long-description>
1702
+ <tag line="867" name="since" description="0.70"/>
1703
+ <tag line="867" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1704
  <type by_reference="false">array</type>
1705
  </tag>
1706
+ <tag line="867" 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="875">
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="906" package="Media Library Assistant">
1717
  <name>column_mla_galleries</name>
1718
  <full_name>column_mla_galleries</full_name>
1719
+ <docblock line="898">
1720
  <description><![CDATA[Supply the content for a custom column]]></description>
1721
  <long-description><![CDATA[]]></long-description>
1722
+ <tag line="898" name="since" description="0.70"/>
1723
+ <tag line="898" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1724
  <type by_reference="false">array</type>
1725
  </tag>
1726
+ <tag line="898" 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="906">
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="937" package="Media Library Assistant">
1737
  <name>column_alt_text</name>
1738
  <full_name>column_alt_text</full_name>
1739
+ <docblock line="929">
1740
  <description><![CDATA[Supply the content for a custom column]]></description>
1741
  <long-description><![CDATA[]]></long-description>
1742
+ <tag line="929" name="since" description="0.1"/>
1743
+ <tag line="929" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1744
  <type by_reference="false">array</type>
1745
  </tag>
1746
+ <tag line="929" name="return" description="HTML markup to be placed inside the column" type="string">
1747
  <type by_reference="false">string</type>
1748
  </tag>
1749
  </docblock>
1750
+ <argument line="937">
1751
  <name>$item</name>
1752
  <default><![CDATA[]]></default>
1753
  <type/>
1754
  </argument>
1755
  </method>
1756
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="957" package="Media Library Assistant">
1757
  <name>column_caption</name>
1758
  <full_name>column_caption</full_name>
1759
+ <docblock line="949">
1760
  <description><![CDATA[Supply the content for a custom column]]></description>
1761
  <long-description><![CDATA[]]></long-description>
1762
+ <tag line="949" name="since" description="0.1"/>
1763
+ <tag line="949" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1764
  <type by_reference="false">array</type>
1765
  </tag>
1766
+ <tag line="949" name="return" description="HTML markup to be placed inside the column" type="string">
1767
  <type by_reference="false">string</type>
1768
  </tag>
1769
  </docblock>
1770
+ <argument line="957">
1771
  <name>$item</name>
1772
  <default><![CDATA[]]></default>
1773
  <type/>
1774
  </argument>
1775
  </method>
1776
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="969" package="Media Library Assistant">
1777
  <name>column_description</name>
1778
  <full_name>column_description</full_name>
1779
+ <docblock line="961">
1780
  <description><![CDATA[Supply the content for a custom column]]></description>
1781
  <long-description><![CDATA[]]></long-description>
1782
+ <tag line="961" name="since" description="0.1"/>
1783
+ <tag line="961" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1784
  <type by_reference="false">array</type>
1785
  </tag>
1786
+ <tag line="961" name="return" description="HTML markup to be placed inside the column" type="string">
1787
  <type by_reference="false">string</type>
1788
  </tag>
1789
  </docblock>
1790
+ <argument line="969">
1791
  <name>$item</name>
1792
  <default><![CDATA[]]></default>
1793
  <type/>
1794
  </argument>
1795
  </method>
1796
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="981" package="Media Library Assistant">
1797
  <name>column_post_mime_type</name>
1798
  <full_name>column_post_mime_type</full_name>
1799
+ <docblock line="973">
1800
  <description><![CDATA[Supply the content for a custom column]]></description>
1801
  <long-description><![CDATA[]]></long-description>
1802
+ <tag line="973" name="since" description="0.30"/>
1803
+ <tag line="973" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1804
  <type by_reference="false">array</type>
1805
  </tag>
1806
+ <tag line="973" name="return" description="HTML markup to be placed inside the column" type="string">
1807
  <type by_reference="false">string</type>
1808
  </tag>
1809
  </docblock>
1810
+ <argument line="981">
1811
  <name>$item</name>
1812
  <default><![CDATA[]]></default>
1813
  <type/>
1814
  </argument>
1815
  </method>
1816
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="993" package="Media Library Assistant">
1817
  <name>column_base_file</name>
1818
  <full_name>column_base_file</full_name>
1819
+ <docblock line="985">
1820
  <description><![CDATA[Supply the content for a custom column]]></description>
1821
  <long-description><![CDATA[]]></long-description>
1822
+ <tag line="985" name="since" description="0.1"/>
1823
+ <tag line="985" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1824
  <type by_reference="false">array</type>
1825
  </tag>
1826
+ <tag line="985" name="return" description="HTML markup to be placed inside the column" type="string">
1827
  <type by_reference="false">string</type>
1828
  </tag>
1829
  </docblock>
1830
+ <argument line="993">
1831
  <name>$item</name>
1832
  <default><![CDATA[]]></default>
1833
  <type/>
1834
  </argument>
1835
  </method>
1836
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1005" package="Media Library Assistant">
1837
  <name>column_date</name>
1838
  <full_name>column_date</full_name>
1839
+ <docblock line="997">
1840
  <description><![CDATA[Supply the content for a custom column]]></description>
1841
  <long-description><![CDATA[]]></long-description>
1842
+ <tag line="997" name="since" description="0.1"/>
1843
+ <tag line="997" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1844
  <type by_reference="false">array</type>
1845
  </tag>
1846
+ <tag line="997" name="return" description="HTML markup to be placed inside the column" type="string">
1847
  <type by_reference="false">string</type>
1848
  </tag>
1849
  </docblock>
1850
+ <argument line="1005">
1851
  <name>$item</name>
1852
  <default><![CDATA[]]></default>
1853
  <type/>
1854
  </argument>
1855
  </method>
1856
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1034" package="Media Library Assistant">
1857
  <name>column_modified</name>
1858
  <full_name>column_modified</full_name>
1859
+ <docblock line="1026">
1860
  <description><![CDATA[Supply the content for a custom column]]></description>
1861
  <long-description><![CDATA[]]></long-description>
1862
+ <tag line="1026" name="since" description="0.30"/>
1863
+ <tag line="1026" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1864
  <type by_reference="false">array</type>
1865
  </tag>
1866
+ <tag line="1026" name="return" description="HTML markup to be placed inside the column" type="string">
1867
  <type by_reference="false">string</type>
1868
  </tag>
1869
  </docblock>
1870
+ <argument line="1034">
1871
  <name>$item</name>
1872
  <default><![CDATA[]]></default>
1873
  <type/>
1874
  </argument>
1875
  </method>
1876
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1063" package="Media Library Assistant">
1877
  <name>column_author</name>
1878
  <full_name>column_author</full_name>
1879
+ <docblock line="1055">
1880
  <description><![CDATA[Supply the content for a custom column]]></description>
1881
  <long-description><![CDATA[]]></long-description>
1882
+ <tag line="1055" name="since" description="0.30"/>
1883
+ <tag line="1055" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1884
  <type by_reference="false">array</type>
1885
  </tag>
1886
+ <tag line="1055" name="return" description="HTML markup to be placed inside the column" type="string">
1887
  <type by_reference="false">string</type>
1888
  </tag>
1889
  </docblock>
1890
+ <argument line="1063">
1891
  <name>$item</name>
1892
  <default><![CDATA[]]></default>
1893
  <type/>
1894
  </argument>
1895
  </method>
1896
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1084" package="Media Library Assistant">
1897
  <name>column_attached_to</name>
1898
  <full_name>column_attached_to</full_name>
1899
+ <docblock line="1076">
1900
  <description><![CDATA[Supply the content for a custom column]]></description>
1901
  <long-description><![CDATA[]]></long-description>
1902
+ <tag line="1076" name="since" description="0.1"/>
1903
+ <tag line="1076" name="param" description="A singular attachment (post) object" type="array" variable="$item">
1904
  <type by_reference="false">array</type>
1905
  </tag>
1906
+ <tag line="1076" name="return" description="HTML markup to be placed inside the column" type="string">
1907
  <type by_reference="false">string</type>
1908
  </tag>
1909
  </docblock>
1910
+ <argument line="1084">
1911
  <name>$item</name>
1912
  <default><![CDATA[]]></default>
1913
  <type/>
1914
  </argument>
1915
  </method>
1916
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1113" package="Media Library Assistant">
1917
  <name>get_columns</name>
1918
  <full_name>get_columns</full_name>
1919
+ <docblock line="1106">
1920
  <description><![CDATA[This method dictates the table's columns and titles]]></description>
1921
  <long-description><![CDATA[]]></long-description>
1922
+ <tag line="1106" name="since" description="0.1"/>
1923
+ <tag line="1106" name="return" description="Column information: 'slugs'=&gt;'Visible Titles'" type="array">
1924
  <type by_reference="false">array</type>
1925
  </tag>
1926
  </docblock>
1927
  </method>
1928
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1125" package="Media Library Assistant">
1929
  <name>get_hidden_columns</name>
1930
  <full_name>get_hidden_columns</full_name>
1931
+ <docblock line="1117">
1932
  <description><![CDATA[Returns the list of currently hidden columns from a user option or
1933
  from default values if the option is not set]]></description>
1934
  <long-description><![CDATA[]]></long-description>
1935
+ <tag line="1117" name="since" description="0.1"/>
1936
+ <tag line="1117" name="return" description="Column information,e.g., array(0 =&gt; 'ID_parent, 1 =&gt; 'title_name')" type="array">
1937
  <type by_reference="false">array</type>
1938
  </tag>
1939
  </docblock>
1940
  </method>
1941
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1145" package="Media Library Assistant">
1942
  <name>get_sortable_columns</name>
1943
  <full_name>get_sortable_columns</full_name>
1944
+ <docblock line="1135">
1945
  <description><![CDATA[Returns an array where the key is the column that needs to be sortable
1946
  and the value is db column to sort by.]]></description>
1947
  <long-description><![CDATA[<p>Also notes the current sort column,
1948
  if set.</p>]]></long-description>
1949
+ <tag line="1135" name="since" description="0.1"/>
1950
+ <tag line="1135" name="return" description="Sortable column information,e.g., 'slugs'=&gt;array('data_values',boolean)" type="array">
1951
  <type by_reference="false">array</type>
1952
  </tag>
1953
  </docblock>
1954
  </method>
1955
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1172" package="Media Library Assistant">
1956
  <name>get_views</name>
1957
  <full_name>get_views</full_name>
1958
+ <docblock line="1164">
1959
  <description><![CDATA[Returns an associative array listing all the views that can be used with this table.]]></description>
1960
  <long-description><![CDATA[<p>These are listed across the top of the page and managed by WordPress.</p>]]></long-description>
1961
+ <tag line="1164" name="since" description="0.1"/>
1962
+ <tag line="1164" name="return" description="View information,e.g., array ( id =&gt; link )" type="array">
1963
  <type by_reference="false">array</type>
1964
  </tag>
1965
  </docblock>
1966
  </method>
1967
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1247" package="Media Library Assistant">
1968
  <name>get_bulk_actions</name>
1969
  <full_name>get_bulk_actions</full_name>
1970
+ <docblock line="1239">
1971
  <description><![CDATA[Get an associative array ( option_name => option_title ) with the list
1972
  of bulk actions available on this table.]]></description>
1973
  <long-description><![CDATA[]]></long-description>
1974
+ <tag line="1239" name="since" description="0.1"/>
1975
+ <tag line="1239" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
1976
  <type by_reference="false">array</type>
1977
  </tag>
1978
  </docblock>
1979
  </method>
1980
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1278" package="Media Library Assistant">
1981
  <name>extra_tablenav</name>
1982
  <full_name>extra_tablenav</full_name>
1983
+ <docblock line="1267">
1984
  <description><![CDATA[Extra controls to be displayed between bulk actions and pagination]]></description>
1985
  <long-description><![CDATA[<p>Modeled after class-wp-posts-list-table.php in wp-admin/includes.</p>]]></long-description>
1986
+ <tag line="1267" name="since" description="0.1"/>
1987
+ <tag line="1267" name="param" description="'top' or 'bottom', i.e., above or below the table rows" type="string" variable="$which">
1988
  <type by_reference="false">string</type>
1989
  </tag>
1990
+ <tag line="1267" name="return" description="Contains all the bulk actions: 'slugs'=&gt;'Visible Titles'" type="array">
1991
  <type by_reference="false">array</type>
1992
  </tag>
1993
  </docblock>
1994
+ <argument line="1278">
1995
  <name>$which</name>
1996
  <default><![CDATA[]]></default>
1997
  <type/>
1998
  </argument>
1999
  </method>
2000
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1311" package="Media Library Assistant">
2001
  <name>prepare_items</name>
2002
  <full_name>prepare_items</full_name>
2003
+ <docblock line="1299">
2004
  <description><![CDATA[Prepares the list of items for displaying]]></description>
2005
  <long-description><![CDATA[<p>This is where you prepare your data for display. This method will usually
2006
  be used to query the database, sort and filter the data, and generally
2007
  get it ready to be displayed. At a minimum, we should set $this->items and
2008
  $this->set_pagination_args().</p>]]></long-description>
2009
+ <tag line="1299" name="since" description="0.1"/>
2010
+ <tag line="1299" name="return" description="" type="void">
2011
  <type by_reference="false">void</type>
2012
  </tag>
2013
  </docblock>
2014
  </method>
2015
+ <method final="false" abstract="false" static="false" visibility="public" namespace="global" line="1357" package="Media Library Assistant">
2016
  <name>single_row</name>
2017
  <full_name>single_row</full_name>
2018
+ <docblock line="1348">
2019
  <description><![CDATA[Generates (echoes) content for a single row of the table]]></description>
2020
  <long-description><![CDATA[]]></long-description>
2021
+ <tag line="1348" name="since" description=".20"/>
2022
+ <tag line="1348" name="param" description="the current item" type="object" variable="$item">
2023
  <type by_reference="false">object</type>
2024
  </tag>
2025
+ <tag line="1348" name="return" description="Echoes the row HTML" type="void">
2026
  <type by_reference="false">void</type>
2027
  </tag>
2028
  </docblock>
2029
+ <argument line="1357">
2030
  <name>$item</name>
2031
  <default><![CDATA[]]></default>
2032
  <type/>
2034
  </method>
2035
  </class>
2036
  </file>
2037
+ <file path="includes\class-mla-main.php" hash="6241c686a8c3e5cdad70d861c20d578f" package="Media Library Assistant">
2038
  <docblock line="2">
2039
  <description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
2040
  <long-description><![CDATA[]]></long-description>
2071
  <constant namespace="global" line="41" package="Media Library Assistant">
2072
  <name>CURRENT_MLA_VERSION</name>
2073
  <full_name>CURRENT_MLA_VERSION</full_name>
2074
+ <value><![CDATA['1.30']]></value>
2075
  <docblock line="34">
2076
  <description><![CDATA[Current version number]]></description>
2077
  <long-description><![CDATA[]]></long-description>
2581
  <type/>
2582
  </argument>
2583
  </method>
2584
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1196" package="Media Library Assistant">
2585
  <name>_display_single_item</name>
2586
  <full_name>_display_single_item</full_name>
2587
  <docblock line="1184">
2588
  <description><![CDATA[Display a single item sub page; prepare the form to
2589
  change the meta data for a single attachment.]]></description>
2590
+ <long-description><![CDATA[<p>This function is not used in WordPress 3.5 and later.</p>]]></long-description>
2591
  <tag line="1184" name="since" description="0.1"/>
2592
  <tag line="1184" name="param" description="The WordPress Post ID of the attachment item" type="int" variable="$post_id">
2593
  <type by_reference="false">int</type>
2596
  <type by_reference="false">array</type>
2597
  </tag>
2598
  </docblock>
2599
+ <argument line="1196">
2600
  <name>$post_id</name>
2601
  <default><![CDATA[]]></default>
2602
  <type/>
2603
  </argument>
2604
  </method>
2605
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1436" package="Media Library Assistant">
2606
  <name>_restore_single_item</name>
2607
  <full_name>_restore_single_item</full_name>
2608
+ <docblock line="1427">
2609
  <description><![CDATA[Restore a single item from the Trash]]></description>
2610
  <long-description><![CDATA[]]></long-description>
2611
+ <tag line="1427" name="since" description="0.1"/>
2612
+ <tag line="1427" name="param" description="The form POST data" type="array" variable="$post_id">
2613
  <type by_reference="false">array</type>
2614
  </tag>
2615
+ <tag line="1427" name="return" description="success/failure message and NULL content" type="array">
2616
  <type by_reference="false">array</type>
2617
  </tag>
2618
  </docblock>
2619
+ <argument line="1436">
2620
  <name>$post_id</name>
2621
  <default><![CDATA[]]></default>
2622
  <type/>
2623
  </argument>
2624
  </method>
2625
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1472" package="Media Library Assistant">
2626
  <name>_trash_single_item</name>
2627
  <full_name>_trash_single_item</full_name>
2628
+ <docblock line="1463">
2629
  <description><![CDATA[Move a single item to Trash]]></description>
2630
  <long-description><![CDATA[]]></long-description>
2631
+ <tag line="1463" name="since" description="0.1"/>
2632
+ <tag line="1463" name="param" description="The form POST data" type="array" variable="$post_id">
2633
  <type by_reference="false">array</type>
2634
  </tag>
2635
+ <tag line="1463" name="return" description="success/failure message and NULL content" type="array">
2636
  <type by_reference="false">array</type>
2637
  </tag>
2638
  </docblock>
2639
+ <argument line="1472">
2640
  <name>$post_id</name>
2641
  <default><![CDATA[]]></default>
2642
  <type/>
2644
  </method>
2645
  </class>
2646
  </file>
2647
+ <file path="includes\class-mla-media-modal.php" hash="244586f6e6d0d92297de5a75ddbd04b8" package="Media Library Assistant">
2648
  <docblock line="2">
2649
  <description><![CDATA[Media Library Assistant Media Manager enhancements]]></description>
2650
  <long-description><![CDATA[]]></long-description>
2871
  </method>
2872
  </class>
2873
  </file>
2874
+ <file path="includes\class-mla-objects.php" hash="67d003379547ffd329a3236834ad6bf3" package="Media Library Assistant">
2875
  <docblock line="2">
2876
  <description><![CDATA[Media Library Assistant Custom Taxonomy and Post Type objects]]></description>
2877
  <long-description><![CDATA[]]></long-description>
2912
  </tag>
2913
  </docblock>
2914
  </method>
2915
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="116" package="Media Library Assistant">
2916
  <name>mla_taxonomy_get_columns_filter</name>
2917
  <full_name>mla_taxonomy_get_columns_filter</full_name>
2918
+ <docblock line="106">
2919
  <description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
2920
  which replaces the "Posts" column with an equivalent "Attachments" column.]]></description>
2921
  <long-description><![CDATA[]]></long-description>
2922
+ <tag line="106" name="since" description="0.30"/>
2923
+ <tag line="106" name="param" description="column definitions for the edit taxonomy list table" type="array" variable="$columns">
2924
  <type by_reference="false">array</type>
2925
  </tag>
2926
+ <tag line="106" name="return" description="updated column definitions for the edit taxonomy list table" type="array">
2927
  <type by_reference="false">array</type>
2928
  </tag>
2929
  </docblock>
2930
+ <argument line="116">
2931
  <name>$columns</name>
2932
  <default><![CDATA[]]></default>
2933
  <type/>
2934
  </argument>
2935
  </method>
2936
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="151" package="Media Library Assistant">
2937
  <name>mla_taxonomy_column_filter</name>
2938
  <full_name>mla_taxonomy_column_filter</full_name>
2939
+ <docblock line="138">
2940
  <description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
2941
  which returns a count of the attachments assigned a given term]]></description>
2942
  <long-description><![CDATA[]]></long-description>
2943
+ <tag line="138" name="since" description="0.30"/>
2944
+ <tag line="138" name="param" description="current column value; always ''" type="string" variable="$place_holder">
2945
  <type by_reference="false">string</type>
2946
  </tag>
2947
+ <tag line="138" name="param" description="name of the column" type="array" variable="$column_name">
2948
  <type by_reference="false">array</type>
2949
  </tag>
2950
+ <tag line="138" name="param" description="ID of the term for which the count is desired" type="array" variable="$term_id">
2951
  <type by_reference="false">array</type>
2952
  </tag>
2953
+ <tag line="138" name="return" description="HTML markup for the column content; number of attachments in the category and alink to retrieve a list of them" type="array">
2954
  <type by_reference="false">array</type>
2955
  </tag>
2956
  </docblock>
2957
+ <argument line="151">
2958
  <name>$place_holder</name>
2959
  <default><![CDATA[]]></default>
2960
  <type/>
2961
  </argument>
2962
+ <argument line="151">
2963
  <name>$column_name</name>
2964
  <default><![CDATA[]]></default>
2965
  <type/>
2966
  </argument>
2967
+ <argument line="151">
2968
  <name>$term_id</name>
2969
  <default><![CDATA[]]></default>
2970
  <type/>
2972
  </method>
2973
  </class>
2974
  </file>
2975
+ <file path="includes\class-mla-options.php" hash="b86b031f3deb4fd1a0fb09fca05c6765" package="Media Library Assistant">
2976
  <docblock line="2">
2977
  <description><![CDATA[Manages the plugin option settings]]></description>
2978
  <long-description><![CDATA[]]></long-description>
3148
  </property>
3149
  <property final="false" static="true" visibility="public" line="148" namespace="global" package="Media Library Assistant">
3150
  <name>$mla_option_definitions</name>
3151
+ <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 and the Edit Media screen.<br>Check the "Inline Edit" box to display the taxonomy in the Quick Edit and Bulk Edit areas.<br>Use the "List Filter" option to select the taxonomy on which to filter the Assistant table listing.', 'std' => array('tax_support' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_quick_edit' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_filter' => 'attachment_category'), 'type' => 'custom', 'render' => 'mla_taxonomy_option_handler', 'update' => 'mla_taxonomy_option_handler', 'delete' => 'mla_taxonomy_option_handler', 'reset' => 'mla_taxonomy_option_handler'), 'attachments_column' => array('tab' => '', 'name' => 'Attachments Column', 'type' => 'hidden', 'std' => 'checked', 'help' => 'Check this option to replace the Posts column with the Attachments Column.'), '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.'), 'media_modal_heading' => array('tab' => 'general', 'name' => 'Media Manager Enhancements', 'type' => 'header'), self::MLA_MEDIA_MODAL_TOOLBAR => array('tab' => 'general', 'name' => 'Enable Media Manager Enhancements', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check/uncheck this option to enable/disable Media Manager Enhancements.'), self::MLA_MEDIA_MODAL_MIMETYPES => array('tab' => 'general', 'name' => 'Media Manager Enhanced MIME Type filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by more MIME Types, e.g., text, applications.'), self::MLA_MEDIA_MODAL_MONTHS => array('tab' => 'general', 'name' => 'Media Manager Month and Year filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by month and year uploaded.'), self::MLA_MEDIA_MODAL_TERMS => array('tab' => 'general', 'name' => 'Media Manager Category/Tag filter', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to filter by taxonomy terms.'), self::MLA_MEDIA_MODAL_SEARCHBOX => array('tab' => 'general', 'name' => 'Media Manager Enhanced Search Media box', 'type' => 'checkbox', 'std' => 'checked', 'help' => 'Check this option to enable search box enhancements.'), 'template_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 <strong>Save Changes</strong> to make the updates permanent.<br>You can also make temporary updates and click <strong>Map All Attachments, Standard Fields Now</strong> to apply the updates to all attachments without saving the rule changes.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_taxonomy_mapping' => array('tab' => '', 'help' => 'Update the taxonomy term mapping values above, then click <strong>Save Changes</strong> or <strong>Map All Attachments, Taxonomy Terms Now</strong>.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_custom_mapping' => array('tab' => '', 'help' => '<strong>Update</strong> individual custom field mapping values above, or make several updates and click <strong>Save Changes</strong> below to apply them all at once.<br>You can also <strong>add a new rule</strong> for an existing field or <strong>add a new field</strong> and rule.<br>You can make temporary updates and click <strong>Map All Attachments, Custom Fields Now</strong> to apply the updates to all attachments without saving the rule changes.', 'std' => NULL, 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'), 'iptc_exif_mapping' => array('tab' => '', 'help' => 'IPTC/EXIF Mapping help', 'std' => array('standard' => array('post_title' => array('name' => 'Title', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_name' => array('name' => 'Name/Slug', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'image_alt' => array('name' => 'Alternate Text', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_excerpt' => array('name' => 'Caption', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true), 'post_content' => array('name' => 'Description', 'iptc_value' => 'none', 'exif_value' => '', 'iptc_first' => true, 'keep_existing' => true)), 'taxonomy' => array(), 'custom' => array()), 'type' => 'custom', 'render' => 'mla_iptc_exif_option_handler', 'update' => 'mla_iptc_exif_option_handler', 'delete' => 'mla_iptc_exif_option_handler', 'reset' => 'mla_iptc_exif_option_handler'))]]></default>
3152
  <docblock line="123">
3153
  <description><![CDATA[$mla_option_definitions defines the database options and admin page areas for setting/updating them.]]></description>
3154
  <long-description><![CDATA[<p>Each option is defined by an array with the following elements:</p>
3175
  $message = ['reset']( 'reset', $key, $value, $_REQUEST );</p>]]></long-description>
3176
  </docblock>
3177
  </property>
3178
+ <property final="false" static="true" visibility="private" line="519" namespace="global" package="Media Library Assistant">
3179
  <name>$mla_option_templates</name>
3180
  <default><![CDATA[null]]></default>
3181
+ <docblock line="512">
3182
  <description><![CDATA[Style and Markup templates]]></description>
3183
  <long-description><![CDATA[]]></long-description>
3184
+ <tag line="512" name="since" description="0.80"/>
3185
+ <tag line="512" name="var" description="" type="array">
3186
  <type by_reference="false">array</type>
3187
  </tag>
3188
  </docblock>
3189
  </property>
3190
+ <property final="false" static="true" visibility="private" line="1452" namespace="global" package="Media Library Assistant">
3191
  <name>$custom_field_data_sources</name>
3192
  <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>
3193
+ <docblock line="1445">
3194
  <description><![CDATA[Array of Data Source names for custom field mapping]]></description>
3195
  <long-description><![CDATA[]]></long-description>
3196
+ <tag line="1445" name="since" description="1.10"/>
3197
+ <tag line="1445" name="var" description="" type="array">
3198
  <type by_reference="false">array</type>
3199
  </tag>
3200
  </docblock>
3201
  </property>
3202
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="493" package="Media Library Assistant">
3203
  <name>initialize</name>
3204
  <full_name>initialize</full_name>
3205
+ <docblock line="486">
3206
  <description><![CDATA[Initialization function, similar to __construct()]]></description>
3207
  <long-description><![CDATA[]]></long-description>
3208
+ <tag line="486" name="since" description="1.00"/>
3209
+ <tag line="486" name="return" description="" type="void">
3210
  <type by_reference="false">void</type>
3211
  </tag>
3212
  </docblock>
3213
  </method>
3214
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="528" package="Media Library Assistant">
3215
  <name>_load_option_templates</name>
3216
  <full_name>_load_option_templates</full_name>
3217
+ <docblock line="521">
3218
  <description><![CDATA[Load style and markup templates to $mla_templates]]></description>
3219
  <long-description><![CDATA[]]></long-description>
3220
+ <tag line="521" name="since" description="0.80"/>
3221
+ <tag line="521" name="return" description="" type="void">
3222
  <type by_reference="false">void</type>
3223
  </tag>
3224
  </docblock>
3225
  </method>
3226
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="576" package="Media Library Assistant">
3227
  <name>mla_fetch_gallery_template</name>
3228
  <full_name>mla_fetch_gallery_template</full_name>
3229
+ <docblock line="566">
3230
  <description><![CDATA[Fetch style or markup template from $mla_templates]]></description>
3231
  <long-description><![CDATA[]]></long-description>
3232
+ <tag line="566" name="since" description="0.80"/>
3233
+ <tag line="566" name="param" description="Template name" type="string" variable="$key">
3234
  <type by_reference="false">string</type>
3235
  </tag>
3236
+ <tag line="566" name="param" description="Template type; 'style' (default) or 'markup'" type="string" variable="$type">
3237
  <type by_reference="false">string</type>
3238
  </tag>
3239
+ <tag line="566" name="return" description="requested template, false if not found or null if no templates" type="string|boolean|null">
3240
  <type by_reference="false">string</type>
3241
  <type by_reference="false">boolean</type>
3242
  <type by_reference="false">null</type>
3243
  </tag>
3244
  </docblock>
3245
+ <argument line="576">
3246
  <name>$key</name>
3247
  <default><![CDATA[]]></default>
3248
  <type/>
3249
  </argument>
3250
+ <argument line="576">
3251
  <name>$type</name>
3252
  <default><![CDATA['style']]></default>
3253
  <type/>
3254
  </argument>
3255
  </method>
3256
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="599" package="Media Library Assistant">
3257
  <name>mla_get_style_templates</name>
3258
  <full_name>mla_get_style_templates</full_name>
3259
+ <docblock line="592">
3260
  <description><![CDATA[Get ALL style templates from $mla_templates, including 'default']]></description>
3261
  <long-description><![CDATA[]]></long-description>
3262
+ <tag line="592" name="since" description="0.80"/>
3263
+ <tag line="592" name="return" description="name =&gt; value for all style templates or null if no templates" type="array|null">
3264
  <type by_reference="false">array</type>
3265
  <type by_reference="false">null</type>
3266
  </tag>
3267
  </docblock>
3268
  </method>
3269
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="625" package="Media Library Assistant">
3270
  <name>mla_put_style_templates</name>
3271
  <full_name>mla_put_style_templates</full_name>
3272
+ <docblock line="617">
3273
  <description><![CDATA[Put user-defined style templates to $mla_templates and database]]></description>
3274
  <long-description><![CDATA[]]></long-description>
3275
+ <tag line="617" name="since" description="0.80"/>
3276
+ <tag line="617" name="param" description="name =&gt; value for all user-defined style templates" type="array" variable="$templates">
3277
  <type by_reference="false">array</type>
3278
  </tag>
3279
+ <tag line="617" name="return" description="true if success, false if failure" type="boolean">
3280
  <type by_reference="false">boolean</type>
3281
  </tag>
3282
  </docblock>
3283
+ <argument line="625">
3284
  <name>$templates</name>
3285
  <default><![CDATA[]]></default>
3286
  <type/>
3287
  </argument>
3288
  </method>
3289
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="641" package="Media Library Assistant">
3290
  <name>mla_get_markup_templates</name>
3291
  <full_name>mla_get_markup_templates</full_name>
3292
+ <docblock line="634">
3293
  <description><![CDATA[Get ALL markup templates from $mla_templates, including 'default']]></description>
3294
  <long-description><![CDATA[]]></long-description>
3295
+ <tag line="634" name="since" description="0.80"/>
3296
+ <tag line="634" name="return" description="name =&gt; value for all markup templates or null if no templates" type="array|null">
3297
  <type by_reference="false">array</type>
3298
  <type by_reference="false">null</type>
3299
  </tag>
3300
  </docblock>
3301
  </method>
3302
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="696" package="Media Library Assistant">
3303
  <name>mla_put_markup_templates</name>
3304
  <full_name>mla_put_markup_templates</full_name>
3305
+ <docblock line="688">
3306
  <description><![CDATA[Put user-defined markup templates to $mla_templates and database]]></description>
3307
  <long-description><![CDATA[]]></long-description>
3308
+ <tag line="688" name="since" description="0.80"/>
3309
+ <tag line="688" name="param" description="name =&gt; value for all user-defined markup templates" type="array" variable="$templates">
3310
  <type by_reference="false">array</type>
3311
  </tag>
3312
+ <tag line="688" name="return" description="true if success, false if failure" type="boolean">
3313
  <type by_reference="false">boolean</type>
3314
  </tag>
3315
  </docblock>
3316
+ <argument line="696">
3317
  <name>$templates</name>
3318
  <default><![CDATA[]]></default>
3319
  <type/>
3320
  </argument>
3321
  </method>
3322
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="714" package="Media Library Assistant">
3323
  <name>mla_get_option</name>
3324
  <full_name>mla_get_option</full_name>
3325
+ <docblock line="705">
3326
  <description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
3327
  <long-description><![CDATA[]]></long-description>
3328
+ <tag line="705" name="since" description="0.1"/>
3329
+ <tag line="705" name="param" description="Name of the desired option" type="string" variable="$option">
3330
  <type by_reference="false">string</type>
3331
  </tag>
3332
+ <tag line="705" name="return" description="Value(s) for the option or false if the option is not a defined MLA option" type="mixed">
3333
  <type by_reference="false">mixed</type>
3334
  </tag>
3335
  </docblock>
3336
+ <argument line="714">
3337
  <name>$option</name>
3338
  <default><![CDATA[]]></default>
3339
  <type/>
3340
  </argument>
3341
  </method>
3342
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="735" package="Media Library Assistant">
3343
  <name>mla_update_option</name>
3344
  <full_name>mla_update_option</full_name>
3345
+ <docblock line="725">
3346
  <description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
3347
  <long-description><![CDATA[]]></long-description>
3348
+ <tag line="725" name="since" description="0.1"/>
3349
+ <tag line="725" name="param" description="Name of the desired option" type="string" variable="$option">
3350
  <type by_reference="false">string</type>
3351
  </tag>
3352
+ <tag line="725" name="param" description="New value for the desired option" type="mixed" variable="$newvalue">
3353
  <type by_reference="false">mixed</type>
3354
  </tag>
3355
+ <tag line="725" name="return" description="True if the value was changed or false if the update failed" type="boolean">
3356
  <type by_reference="false">boolean</type>
3357
  </tag>
3358
  </docblock>
3359
+ <argument line="735">
3360
  <name>$option</name>
3361
  <default><![CDATA[]]></default>
3362
  <type/>
3363
  </argument>
3364
+ <argument line="735">
3365
  <name>$newvalue</name>
3366
  <default><![CDATA[]]></default>
3367
  <type/>
3368
  </argument>
3369
  </method>
3370
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="751" package="Media Library Assistant">
3371
  <name>mla_delete_option</name>
3372
  <full_name>mla_delete_option</full_name>
3373
+ <docblock line="742">
3374
  <description><![CDATA[Delete the stored value of a defined MLA option]]></description>
3375
  <long-description><![CDATA[]]></long-description>
3376
+ <tag line="742" name="since" description="0.1"/>
3377
+ <tag line="742" name="param" description="Name of the desired option" type="string" variable="$option">
3378
  <type by_reference="false">string</type>
3379
  </tag>
3380
+ <tag line="742" name="return" description="True if the option was deleted, otherwise false" type="boolean">
3381
  <type by_reference="false">boolean</type>
3382
  </tag>
3383
  </docblock>
3384
+ <argument line="751">
3385
  <name>$option</name>
3386
  <default><![CDATA[]]></default>
3387
  <type/>
3388
  </argument>
3389
  </method>
3390
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="772" package="Media Library Assistant">
3391
  <name>mla_taxonomy_support</name>
3392
  <full_name>mla_taxonomy_support</full_name>
3393
+ <docblock line="759">
3394
  <description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
3395
  settings are being updated or reset.]]></description>
3396
  <long-description><![CDATA[]]></long-description>
3397
+ <tag line="759" name="since" description="0.30"/>
3398
+ <tag line="759" name="param" description="Taxonomy name, e.g., attachment_category" type="string" variable="$tax_name">
3399
  <type by_reference="false">string</type>
3400
  </tag>
3401
+ <tag line="759" name="param" description="Optional. 'support' (default), 'quick-edit' or 'filter'" type="string" variable="$support_type">
3402
  <type by_reference="false">string</type>
3403
  </tag>
3404
+ <tag line="759" 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">
3405
  <type by_reference="false">boolean</type>
3406
  <type by_reference="false">string</type>
3407
  </tag>
3408
  </docblock>
3409
+ <argument line="772">
3410
  <name>$tax_name</name>
3411
  <default><![CDATA[]]></default>
3412
  <type/>
3413
  </argument>
3414
+ <argument line="772">
3415
  <name>$support_type</name>
3416
  <default><![CDATA['support']]></default>
3417
  <type/>
3418
  </argument>
3419
  </method>
3420
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="848" package="Media Library Assistant">
3421
  <name>mla_taxonomy_option_handler</name>
3422
  <full_name>mla_taxonomy_option_handler</full_name>
3423
+ <docblock line="835">
3424
  <description><![CDATA[Render and manage taxonomy support options, e.g., Categories and Post Tags]]></description>
3425
  <long-description><![CDATA[]]></long-description>
3426
+ <tag line="835" name="since" description="0.30"/>
3427
+ <tag line="835" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3428
+ <tag line="835" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
3429
  <type by_reference="false">string</type>
3430
  </tag>
3431
+ <tag line="835" name="param" description="option name, e.g., 'taxonomy_support'" type="string" variable="$key">
3432
  <type by_reference="false">string</type>
3433
  </tag>
3434
+ <tag line="835" name="param" description="option parameters" type="array" variable="$value">
3435
  <type by_reference="false">array</type>
3436
  </tag>
3437
+ <tag line="835" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
3438
  <type by_reference="false">array</type>
3439
  </tag>
3440
+ <tag line="835" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
3441
  <type by_reference="false">string</type>
3442
  </tag>
3443
  </docblock>
3444
+ <argument line="848">
3445
  <name>$action</name>
3446
  <default><![CDATA[]]></default>
3447
  <type/>
3448
  </argument>
3449
+ <argument line="848">
3450
  <name>$key</name>
3451
  <default><![CDATA[]]></default>
3452
  <type/>
3453
  </argument>
3454
+ <argument line="848">
3455
  <name>$value</name>
3456
  <default><![CDATA[]]></default>
3457
  <type/>
3458
  </argument>
3459
+ <argument line="848">
3460
  <name>$args</name>
3461
  <default><![CDATA[null]]></default>
3462
  <type/>
3463
  </argument>
3464
  </method>
3465
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="956" package="Media Library Assistant">
3466
  <name>mla_add_attachment_action</name>
3467
  <full_name>mla_add_attachment_action</full_name>
3468
+ <docblock line="947">
3469
  <description><![CDATA[Perform ITC/EXIF mapping on just-inserted attachment]]></description>
3470
  <long-description><![CDATA[]]></long-description>
3471
+ <tag line="947" name="since" description="1.00"/>
3472
+ <tag line="947" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
3473
  <type by_reference="false">integer</type>
3474
  </tag>
3475
+ <tag line="947" name="return" description="" type="void">
3476
  <type by_reference="false">void</type>
3477
  </tag>
3478
  </docblock>
3479
+ <argument line="956">
3480
  <name>$post_id</name>
3481
  <default><![CDATA[]]></default>
3482
  <type/>
3483
  </argument>
3484
  </method>
3485
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="976" package="Media Library Assistant">
3486
  <name>mla_update_attachment_metadata_filter</name>
3487
  <full_name>mla_update_attachment_metadata_filter</full_name>
3488
+ <docblock line="966">
3489
  <description><![CDATA[Perform Custom Field mapping on just-inserted or updated attachment]]></description>
3490
  <long-description><![CDATA[]]></long-description>
3491
+ <tag line="966" name="since" description="1.10"/>
3492
+ <tag line="966" name="param" description="Attachment metadata for just-inserted attachment" type="array" variable="$data">
3493
  <type by_reference="false">array</type>
3494
  </tag>
3495
+ <tag line="966" name="param" description="ID of just-inserted attachment" type="integer" variable="$post_id">
3496
  <type by_reference="false">integer</type>
3497
  </tag>
3498
+ <tag line="966" name="return" description="" type="void">
3499
  <type by_reference="false">void</type>
3500
  </tag>
3501
  </docblock>
3502
+ <argument line="976">
3503
  <name>$data</name>
3504
  <default><![CDATA[]]></default>
3505
  <type/>
3506
  </argument>
3507
+ <argument line="976">
3508
  <name>$post_id</name>
3509
  <default><![CDATA[]]></default>
3510
  <type/>
3511
  </argument>
3512
  </method>
3513
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="996" package="Media Library Assistant">
3514
  <name>mla_custom_field_option_value</name>
3515
  <full_name>mla_custom_field_option_value</full_name>
3516
+ <docblock line="987">
3517
  <description><![CDATA[Fetch custom field option value given a slug]]></description>
3518
  <long-description><![CDATA[]]></long-description>
3519
+ <tag line="987" name="since" description="1.10"/>
3520
+ <tag line="987" name="param" description="slug, e.g., 'c_file-size' for the 'File Size' field" type="string" variable="$slug">
3521
  <type by_reference="false">string</type>
3522
  </tag>
3523
+ <tag line="987" name="return" description="option value, e.g., array( 'name' =&gt; 'File Size', ... )" type="array">
3524
  <type by_reference="false">array</type>
3525
  </tag>
3526
  </docblock>
3527
+ <argument line="996">
3528
  <name>$slug</name>
3529
  <default><![CDATA[]]></default>
3530
  <type/>
3531
  </argument>
3532
  </method>
3533
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1016" package="Media Library Assistant">
3534
  <name>mla_custom_field_support</name>
3535
  <full_name>mla_custom_field_support</full_name>
3536
+ <docblock line="1007">
3537
  <description><![CDATA[Evaluate file information for custom field mapping]]></description>
3538
  <long-description><![CDATA[]]></long-description>
3539
+ <tag line="1007" name="since" description="1.10"/>
3540
+ <tag line="1007" name="param" description="array format; 'default_columns' (default), 'default_hidden_columns', 'default_sortable_columns', 'quick_edit' or 'bulk_edit'" type="string" variable="$support_type">
3541
  <type by_reference="false">string</type>
3542
  </tag>
3543
+ <tag line="1007" name="return" description="default, hidden, sortable quick_edit or bulk_edit colums in appropriate format" type="array">
3544
  <type by_reference="false">array</type>
3545
  </tag>
3546
  </docblock>
3547
+ <argument line="1016">
3548
  <name>$support_type</name>
3549
  <default><![CDATA['default_columns']]></default>
3550
  <type/>
3551
  </argument>
3552
  </method>
3553
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1062" package="Media Library Assistant">
3554
  <name>_evaluate_file_information</name>
3555
  <full_name>_evaluate_file_information</full_name>
3556
+ <docblock line="1050">
3557
  <description><![CDATA[Evaluate file information for custom field mapping]]></description>
3558
  <long-description><![CDATA[]]></long-description>
3559
+ <tag line="1050" name="since" description="1.10"/>
3560
+ <tag line="1050" name="param" description="absolute path the the uploads base directory" type="string" variable="$upload_dir">
3561
  <type by_reference="false">string</type>
3562
  </tag>
3563
+ <tag line="1050" name="param" description="_wp_attached_file meta_value array, indexed by post_id" type="array" variable="$wp_attached_files">
3564
  <type by_reference="false">array</type>
3565
  </tag>
3566
+ <tag line="1050" name="param" description="_wp_attachment_metadata meta_value array, indexed by post_id" type="array" variable="$wp_attachment_metadata">
3567
  <type by_reference="false">array</type>
3568
  </tag>
3569
+ <tag line="1050" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
3570
  <type by_reference="false">integer</type>
3571
  </tag>
3572
+ <tag line="1050" name="return" description="absolute_path, base_file, path, file_name, extension, dimensions, width, height, hwstring_small, array of intermediate sizes" type="array">
3573
  <type by_reference="false">array</type>
3574
  </tag>
3575
  </docblock>
3576
+ <argument line="1062">
3577
  <name>$upload_dir</name>
3578
  <default><![CDATA[]]></default>
3579
  <type/>
3580
  </argument>
3581
+ <argument line="1062">
3582
  <name>$wp_attached_files</name>
3583
  <default><![CDATA[]]></default>
3584
  <type/>
3585
  </argument>
3586
+ <argument line="1062">
3587
  <name>$wp_attachment_metadata</name>
3588
  <default><![CDATA[]]></default>
3589
  <type/>
3590
  </argument>
3591
+ <argument line="1062">
3592
  <name>$post_id</name>
3593
  <default><![CDATA[]]></default>
3594
  <type/>
3595
  </argument>
3596
  </method>
3597
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1132" package="Media Library Assistant">
3598
  <name>_evaluate_data_source</name>
3599
  <full_name>_evaluate_data_source</full_name>
3600
+ <docblock line="1120">
3601
  <description><![CDATA[Evaluate custom field mapping data source]]></description>
3602
  <long-description><![CDATA[]]></long-description>
3603
+ <tag line="1120" name="since" description="1.10"/>
3604
+ <tag line="1120" name="param" description="post-&gt;ID of attachment" type="integer" variable="$post_id">
3605
  <type by_reference="false">integer</type>
3606
  </tag>
3607
+ <tag line="1120" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
 
 
 
3608
  <type by_reference="false">string</type>
3609
  </tag>
3610
+ <tag line="1120" name="param" description="data source specification (name, format, meta_name, meta_single, meta_export)" type="array" variable="$data_value">
3611
+ <type by_reference="false">array</type>
3612
  </tag>
3613
+ <tag line="1120" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
3614
  <type by_reference="false">array</type>
3615
  </tag>
3616
+ <tag line="1120" name="return" description="data source value" type="string">
3617
  <type by_reference="false">string</type>
3618
  </tag>
3619
  </docblock>
3620
+ <argument line="1132">
3621
  <name>$post_id</name>
3622
  <default><![CDATA[]]></default>
3623
  <type/>
3624
  </argument>
3625
+ <argument line="1132">
3626
  <name>$category</name>
3627
  <default><![CDATA[]]></default>
3628
  <type/>
3629
  </argument>
3630
+ <argument line="1132">
3631
+ <name>$data_value</name>
3632
  <default><![CDATA[]]></default>
3633
  <type/>
3634
  </argument>
3635
+ <argument line="1132">
 
 
 
 
 
3636
  <name>$attachment_metadata</name>
3637
  <default><![CDATA[NULL]]></default>
3638
  <type/>
3639
  </argument>
3640
  </method>
3641
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1380" package="Media Library Assistant">
3642
  <name>mla_evaluate_custom_field_mapping</name>
3643
  <full_name>mla_evaluate_custom_field_mapping</full_name>
3644
+ <docblock line="1368">
3645
  <description><![CDATA[Evaluate custom field mapping updates for a post]]></description>
3646
  <long-description><![CDATA[]]></long-description>
3647
+ <tag line="1368" name="since" description="1.10"/>
3648
+ <tag line="1368" name="param" description="post ID to be evaluated" type="integer" variable="$post_id">
3649
  <type by_reference="false">integer</type>
3650
  </tag>
3651
+ <tag line="1368" name="param" description="category/scope to evaluate against: custom_field_mapping or single_attachment_mapping" type="string" variable="$category">
3652
  <type by_reference="false">string</type>
3653
  </tag>
3654
+ <tag line="1368" name="param" description="(optional) custom_field_mapping values, default NULL (use current option value)" type="array" variable="$settings">
3655
  <type by_reference="false">array</type>
3656
  </tag>
3657
+ <tag line="1368" name="param" description="(optional) attachment_metadata, default NULL (use current postmeta database value)" type="array" variable="$attachment_metadata">
3658
  <type by_reference="false">array</type>
3659
  </tag>
3660
+ <tag line="1368" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
3661
  <type by_reference="false">array</type>
3662
  </tag>
3663
  </docblock>
3664
+ <argument line="1380">
3665
  <name>$post_id</name>
3666
  <default><![CDATA[]]></default>
3667
  <type/>
3668
  </argument>
3669
+ <argument line="1380">
3670
  <name>$category</name>
3671
  <default><![CDATA[]]></default>
3672
  <type/>
3673
  </argument>
3674
+ <argument line="1380">
3675
  <name>$settings</name>
3676
  <default><![CDATA[NULL]]></default>
3677
  <type/>
3678
  </argument>
3679
+ <argument line="1380">
3680
  <name>$attachment_metadata</name>
3681
  <default><![CDATA[NULL]]></default>
3682
  <type/>
3683
  </argument>
3684
  </method>
3685
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1419" package="Media Library Assistant">
3686
  <name>_compose_custom_field_option_list</name>
3687
  <full_name>_compose_custom_field_option_list</full_name>
3688
+ <docblock line="1408">
3689
  <description><![CDATA[Compose a Custom Field Options list with current selection]]></description>
3690
  <long-description><![CDATA[]]></long-description>
3691
+ <tag line="1408" name="since" description="1.10"/>
3692
+ <tag line="1408" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3693
+ <tag line="1408" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
3694
  <type by_reference="false">string</type>
3695
  </tag>
3696
+ <tag line="1408" name="param" description="optional list of terms to exclude from the list" type="array" variable="$blacklist">
3697
+ <type by_reference="false">array</type>
3698
+ </tag>
3699
+ <tag line="1408" name="return" description="HTML markup with select field options" type="string">
3700
  <type by_reference="false">string</type>
3701
  </tag>
3702
  </docblock>
3703
+ <argument line="1419">
3704
  <name>$selection</name>
3705
  <default><![CDATA['none']]></default>
3706
  <type/>
3707
  </argument>
3708
+ <argument line="1419">
3709
+ <name>$blacklist</name>
3710
+ <default><![CDATA[array()]]></default>
3711
+ <type/>
3712
+ </argument>
3713
  </method>
3714
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1497" package="Media Library Assistant">
3715
  <name>_compose_data_source_option_list</name>
3716
  <full_name>_compose_data_source_option_list</full_name>
3717
+ <docblock line="1487">
3718
  <description><![CDATA[Compose a (Custom Field) Data Source Options list with current selection]]></description>
3719
  <long-description><![CDATA[]]></long-description>
3720
+ <tag line="1487" name="since" description="1.10"/>
3721
+ <tag line="1487" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3722
+ <tag line="1487" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
3723
  <type by_reference="false">string</type>
3724
  </tag>
3725
+ <tag line="1487" name="return" description="HTML markup with select field options" type="string">
3726
  <type by_reference="false">string</type>
3727
  </tag>
3728
  </docblock>
3729
+ <argument line="1497">
3730
  <name>$selection</name>
3731
  <default><![CDATA['none']]></default>
3732
  <type/>
3733
  </argument>
3734
  </method>
3735
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1555" package="Media Library Assistant">
3736
  <name>_update_custom_field_mapping</name>
3737
  <full_name>_update_custom_field_mapping</full_name>
3738
+ <docblock line="1545">
3739
  <description><![CDATA[Update custom field mappings]]></description>
3740
  <long-description><![CDATA[]]></long-description>
3741
+ <tag line="1545" name="since" description="1.10"/>
3742
+ <tag line="1545" name="param" description="current custom_field_mapping values" type="array" variable="$current_values">
3743
  <type by_reference="false">array</type>
3744
  </tag>
3745
+ <tag line="1545" name="param" description="new values" type="array" variable="$new_values">
3746
  <type by_reference="false">array</type>
3747
  </tag>
3748
+ <tag line="1545" 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">
3749
  <type by_reference="false">array</type>
3750
  </tag>
3751
  </docblock>
3752
+ <argument line="1555">
3753
  <name>$current_values</name>
3754
  <default><![CDATA[]]></default>
3755
  <type/>
3756
  </argument>
3757
+ <argument line="1555">
3758
  <name>$new_values</name>
3759
  <default><![CDATA[]]></default>
3760
  <type/>
3761
  </argument>
3762
  </method>
3763
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1756" package="Media Library Assistant">
3764
  <name>mla_custom_field_option_handler</name>
3765
  <full_name>mla_custom_field_option_handler</full_name>
3766
+ <docblock line="1743">
3767
  <description><![CDATA[Render and manage custom field mapping options]]></description>
3768
  <long-description><![CDATA[]]></long-description>
3769
+ <tag line="1743" name="since" description="1.10"/>
3770
+ <tag line="1743" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3771
+ <tag line="1743" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
3772
  <type by_reference="false">string</type>
3773
  </tag>
3774
+ <tag line="1743" name="param" description="option name, e.g., 'custom_field_mapping'" type="string" variable="$key">
3775
  <type by_reference="false">string</type>
3776
  </tag>
3777
+ <tag line="1743" name="param" description="option parameters" type="array" variable="$value">
3778
  <type by_reference="false">array</type>
3779
  </tag>
3780
+ <tag line="1743" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
3781
  <type by_reference="false">array</type>
3782
  </tag>
3783
+ <tag line="1743" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
3784
  <type by_reference="false">string</type>
3785
  </tag>
3786
  </docblock>
3787
+ <argument line="1756">
3788
  <name>$action</name>
3789
  <default><![CDATA[]]></default>
3790
  <type/>
3791
  </argument>
3792
+ <argument line="1756">
3793
  <name>$key</name>
3794
  <default><![CDATA[]]></default>
3795
  <type/>
3796
  </argument>
3797
+ <argument line="1756">
3798
  <name>$value</name>
3799
  <default><![CDATA[]]></default>
3800
  <type/>
3801
  </argument>
3802
+ <argument line="1756">
3803
  <name>$args</name>
3804
  <default><![CDATA[null]]></default>
3805
  <type/>
3806
  </argument>
3807
  </method>
3808
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1922" package="Media Library Assistant">
3809
  <name>mla_evaluate_iptc_exif_mapping</name>
3810
  <full_name>mla_evaluate_iptc_exif_mapping</full_name>
3811
+ <docblock line="1911">
3812
  <description><![CDATA[Evaluate IPTC/EXIF mapping updates for a post]]></description>
3813
  <long-description><![CDATA[]]></long-description>
3814
+ <tag line="1911" name="since" description="1.00"/>
3815
+ <tag line="1911" name="param" description="post object with current values" type="object" variable="$post">
3816
  <type by_reference="false">object</type>
3817
  </tag>
3818
+ <tag line="1911" name="param" description="category to evaluate against, e.g., iptc_exif_standard_mapping or iptc_exif_mapping" type="string" variable="$category">
3819
  <type by_reference="false">string</type>
3820
  </tag>
3821
+ <tag line="1911" name="param" description="(optional) iptc_exif_mapping values, default - current option value" type="array" variable="$settings">
3822
  <type by_reference="false">array</type>
3823
  </tag>
3824
+ <tag line="1911" name="return" description="Updates suitable for MLAData::mla_update_single_item, if any" type="array">
3825
  <type by_reference="false">array</type>
3826
  </tag>
3827
  </docblock>
3828
+ <argument line="1922">
3829
  <name>$post</name>
3830
  <default><![CDATA[]]></default>
3831
  <type/>
3832
  </argument>
3833
+ <argument line="1922">
3834
  <name>$category</name>
3835
  <default><![CDATA[]]></default>
3836
  <type/>
3837
  </argument>
3838
+ <argument line="1922">
3839
  <name>$settings</name>
3840
  <default><![CDATA[NULL]]></default>
3841
  <type/>
3842
  </argument>
3843
  </method>
3844
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2084" package="Media Library Assistant">
3845
  <name>_compose_iptc_option_list</name>
3846
  <full_name>_compose_iptc_option_list</full_name>
3847
+ <docblock line="2074">
3848
  <description><![CDATA[Compose an IPTC Options list with current selection]]></description>
3849
  <long-description><![CDATA[]]></long-description>
3850
+ <tag line="2074" name="since" description="1.00"/>
3851
+ <tag line="2074" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3852
+ <tag line="2074" name="param" description="current selection or 'none' (default)" type="string" variable="$selection">
3853
  <type by_reference="false">string</type>
3854
  </tag>
3855
+ <tag line="2074" name="return" description="HTML markup with select field options" type="string">
3856
  <type by_reference="false">string</type>
3857
  </tag>
3858
  </docblock>
3859
+ <argument line="2084">
3860
  <name>$selection</name>
3861
  <default><![CDATA['none']]></default>
3862
  <type/>
3863
  </argument>
3864
  </method>
3865
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2117" package="Media Library Assistant">
3866
  <name>_compose_parent_option_list</name>
3867
  <full_name>_compose_parent_option_list</full_name>
3868
+ <docblock line="2106">
3869
  <description><![CDATA[Compose an hierarchical taxonomy Parent options list with current selection]]></description>
3870
  <long-description><![CDATA[]]></long-description>
3871
+ <tag line="2106" name="since" description="1.00"/>
3872
+ <tag line="2106" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3873
+ <tag line="2106" name="param" description="taxonomy slug" type="string" variable="$taxonomy">
3874
  <type by_reference="false">string</type>
3875
  </tag>
3876
+ <tag line="2106" name="param" description="current selection or 0 (zero, default)" type="integer" variable="$selection">
3877
  <type by_reference="false">integer</type>
3878
  </tag>
3879
+ <tag line="2106" name="return" description="HTML markup with select field options" type="string">
3880
  <type by_reference="false">string</type>
3881
  </tag>
3882
  </docblock>
3883
+ <argument line="2117">
3884
  <name>$taxonomy</name>
3885
  <default><![CDATA[]]></default>
3886
  <type/>
3887
  </argument>
3888
+ <argument line="2117">
3889
  <name>$selection</name>
3890
  <default><![CDATA[0]]></default>
3891
  <type/>
3892
  </argument>
3893
  </method>
3894
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2151" package="Media Library Assistant">
3895
  <name>_update_iptc_exif_standard_mapping</name>
3896
  <full_name>_update_iptc_exif_standard_mapping</full_name>
3897
+ <docblock line="2141">
3898
  <description><![CDATA[Update Standard field portion of IPTC/EXIF mappings]]></description>
3899
  <long-description><![CDATA[]]></long-description>
3900
+ <tag line="2141" name="since" description="1.00"/>
3901
+ <tag line="2141" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3902
  <type by_reference="false">array</type>
3903
  </tag>
3904
+ <tag line="2141" name="param" description="new values" type="array" variable="$new_values">
3905
  <type by_reference="false">array</type>
3906
  </tag>
3907
+ <tag line="2141" 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">
3908
  <type by_reference="false">array</type>
3909
  </tag>
3910
  </docblock>
3911
+ <argument line="2151">
3912
  <name>$current_values</name>
3913
  <default><![CDATA[]]></default>
3914
  <type/>
3915
  </argument>
3916
+ <argument line="2151">
3917
  <name>$new_values</name>
3918
  <default><![CDATA[]]></default>
3919
  <type/>
3920
  </argument>
3921
  </method>
3922
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2230" package="Media Library Assistant">
3923
  <name>_update_iptc_exif_taxonomy_mapping</name>
3924
  <full_name>_update_iptc_exif_taxonomy_mapping</full_name>
3925
+ <docblock line="2220">
3926
  <description><![CDATA[Update Taxonomy term portion of IPTC/EXIF mappings]]></description>
3927
  <long-description><![CDATA[]]></long-description>
3928
+ <tag line="2220" name="since" description="1.00"/>
3929
+ <tag line="2220" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3930
  <type by_reference="false">array</type>
3931
  </tag>
3932
+ <tag line="2220" name="param" description="new values" type="array" variable="$new_values">
3933
  <type by_reference="false">array</type>
3934
  </tag>
3935
+ <tag line="2220" 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">
3936
  <type by_reference="false">array</type>
3937
  </tag>
3938
  </docblock>
3939
+ <argument line="2230">
3940
  <name>$current_values</name>
3941
  <default><![CDATA[]]></default>
3942
  <type/>
3943
  </argument>
3944
+ <argument line="2230">
3945
  <name>$new_values</name>
3946
  <default><![CDATA[]]></default>
3947
  <type/>
3948
  </argument>
3949
  </method>
3950
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2322" package="Media Library Assistant">
3951
  <name>_update_iptc_exif_custom_mapping</name>
3952
  <full_name>_update_iptc_exif_custom_mapping</full_name>
3953
+ <docblock line="2312">
3954
  <description><![CDATA[Update Custom field portion of IPTC/EXIF mappings]]></description>
3955
  <long-description><![CDATA[]]></long-description>
3956
+ <tag line="2312" name="since" description="1.00"/>
3957
+ <tag line="2312" name="param" description="current iptc_exif_mapping values" type="array" variable="$current_values">
3958
  <type by_reference="false">array</type>
3959
  </tag>
3960
+ <tag line="2312" name="param" description="new values" type="array" variable="$new_values">
3961
  <type by_reference="false">array</type>
3962
  </tag>
3963
+ <tag line="2312" 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">
3964
  <type by_reference="false">array</type>
3965
  </tag>
3966
  </docblock>
3967
+ <argument line="2322">
3968
  <name>$current_values</name>
3969
  <default><![CDATA[]]></default>
3970
  <type/>
3971
  </argument>
3972
+ <argument line="2322">
3973
  <name>$new_values</name>
3974
  <default><![CDATA[]]></default>
3975
  <type/>
3976
  </argument>
3977
  </method>
3978
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="2443" package="Media Library Assistant">
3979
  <name>_get_custom_field_names</name>
3980
  <full_name>_get_custom_field_names</full_name>
3981
+ <docblock line="2436">
3982
  <description><![CDATA[Generate a list of all (post) Custom Field names]]></description>
3983
  <long-description><![CDATA[]]></long-description>
3984
+ <tag line="2436" name="since" description="1.00"/>
3985
+ <tag line="2436" name="return" description="Custom field names from the postmeta table" type="array">
3986
  <type by_reference="false">array</type>
3987
  </tag>
3988
  </docblock>
3989
  </method>
3990
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="2472" package="Media Library Assistant">
3991
  <name>mla_iptc_exif_option_handler</name>
3992
  <full_name>mla_iptc_exif_option_handler</full_name>
3993
+ <docblock line="2459">
3994
  <description><![CDATA[Render and manage iptc/exif support options]]></description>
3995
  <long-description><![CDATA[]]></long-description>
3996
+ <tag line="2459" name="since" description="1.00"/>
3997
+ <tag line="2459" name="uses" description="\global\$mla_option_templates" refers="\global\$mla_option_templates"/>
3998
+ <tag line="2459" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
3999
  <type by_reference="false">string</type>
4000
  </tag>
4001
+ <tag line="2459" name="param" description="option name, e.g., 'iptc_exif_mapping'" type="string" variable="$key">
4002
  <type by_reference="false">string</type>
4003
  </tag>
4004
+ <tag line="2459" name="param" description="option parameters" type="array" variable="$value">
4005
  <type by_reference="false">array</type>
4006
  </tag>
4007
+ <tag line="2459" name="param" description="Optional. null (default) for 'render' else option data, e.g., $_REQUEST" type="array" variable="$args">
4008
  <type by_reference="false">array</type>
4009
  </tag>
4010
+ <tag line="2459" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
4011
  <type by_reference="false">string</type>
4012
  </tag>
4013
  </docblock>
4014
+ <argument line="2472">
4015
  <name>$action</name>
4016
  <default><![CDATA[]]></default>
4017
  <type/>
4018
  </argument>
4019
+ <argument line="2472">
4020
  <name>$key</name>
4021
  <default><![CDATA[]]></default>
4022
  <type/>
4023
  </argument>
4024
+ <argument line="2472">
4025
  <name>$value</name>
4026
  <default><![CDATA[]]></default>
4027
  <type/>
4028
  </argument>
4029
+ <argument line="2472">
4030
  <name>$args</name>
4031
  <default><![CDATA[null]]></default>
4032
  <type/>
4034
  </method>
4035
  </class>
4036
  </file>
4037
+ <file path="includes\class-mla-settings.php" hash="66ebe94c676521c0ee7a4c9735e4e506" package="Media Library Assistant">
4038
  <docblock line="2">
4039
  <description><![CDATA[Manages the settings page to edit the plugin option settings]]></description>
4040
  <long-description><![CDATA[]]></long-description>
4060
  <long-description><![CDATA[]]></long-description>
4061
  </docblock>
4062
  </constant>
4063
+ <property final="false" static="true" visibility="private" line="388" namespace="global" package="Media Library Assistant">
4064
  <name>$page_template_array</name>
4065
  <default><![CDATA[null]]></default>
4066
+ <docblock line="378">
4067
  <description><![CDATA[Template file for the Settings page(s) and parts]]></description>
4068
  <long-description><![CDATA[<p>This array contains all of the template parts for the Settings page(s). The array is built once
4069
  each page load and cached for subsequent use.</p>]]></long-description>
4070
+ <tag line="378" name="since" description="0.80"/>
4071
+ <tag line="378" name="var" description="" type="array">
4072
  <type by_reference="false">array</type>
4073
  </tag>
4074
  </docblock>
4075
  </property>
4076
+ <property final="false" static="true" visibility="private" line="404" namespace="global" package="Media Library Assistant">
4077
  <name>$mla_tablist</name>
4078
  <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>
4079
+ <docblock line="390">
4080
  <description><![CDATA[Definitions for Settings page tab ids, titles and handlers
4081
  Each tab is defined by an array with the following elements:]]></description>
4082
  <long-description><![CDATA[<p>array key => HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)</p>
4084
  <p>title => tab label / heading text
4085
  render => rendering function for tab messages and content. Usage:
4086
  $tab_content = <a href="">'render'</a>;</p>]]></long-description>
4087
+ <tag line="390" name="since" description="0.80"/>
4088
+ <tag line="390" name="var" description="" type="array">
4089
  <type by_reference="false">array</type>
4090
  </tag>
4091
  </docblock>
4114
  </tag>
4115
  </docblock>
4116
  </method>
4117
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="112" package="Media Library Assistant">
4118
  <name>mla_activation_hook</name>
4119
  <full_name>mla_activation_hook</full_name>
4120
+ <docblock line="103">
4121
  <description><![CDATA[Perform one-time actions on plugin activation]]></description>
4122
  <long-description><![CDATA[<p>Adds a view to the database to support sorting the listing on 'ALT Text'.</p>]]></long-description>
4123
+ <tag line="103" name="since" description="0.40"/>
4124
+ <tag line="103" name="return" description="" type="void">
4125
  <type by_reference="false">void</type>
4126
  </tag>
4127
  </docblock>
4128
  </method>
4129
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="125" package="Media Library Assistant">
4130
  <name>mla_deactivation_hook</name>
4131
  <full_name>mla_deactivation_hook</full_name>
4132
+ <docblock line="116">
4133
  <description><![CDATA[Perform one-time actions on plugin deactivation]]></description>
4134
  <long-description><![CDATA[<p>Removes (if present) a view from the database that supports sorting the listing on 'ALT Text'.</p>]]></long-description>
4135
+ <tag line="116" name="since" description="0.40"/>
4136
+ <tag line="116" name="return" description="" type="void">
4137
  <type by_reference="false">void</type>
4138
  </tag>
4139
  </docblock>
4140
  </method>
4141
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="144" package="Media Library Assistant">
4142
  <name>mla_admin_menu_action</name>
4143
  <full_name>mla_admin_menu_action</full_name>
4144
+ <docblock line="136">
4145
  <description><![CDATA[Add settings page in the "Settings" section,
4146
  add settings link in the Plugins section entry for MLA.]]></description>
4147
  <long-description><![CDATA[]]></long-description>
4148
+ <tag line="136" name="since" description="0.1"/>
4149
+ <tag line="136" name="return" description="" type="void">
4150
  <type by_reference="false">void</type>
4151
  </tag>
4152
  </docblock>
4153
  </method>
4154
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="162" package="Media Library Assistant">
4155
  <name>mla_add_plugin_settings_link</name>
4156
  <full_name>mla_add_plugin_settings_link</full_name>
4157
+ <docblock line="152">
4158
  <description><![CDATA[Add the "Settings" link to the MLA entry in the Plugins section]]></description>
4159
  <long-description><![CDATA[]]></long-description>
4160
+ <tag line="152" name="since" description="0.1"/>
4161
+ <tag line="152" name="param" description="array of links for the Plugin, e.g., &quot;Activate&quot;" type="array" variable="$links">
4162
  <type by_reference="false">array</type>
4163
  </tag>
4164
+ <tag line="152" name="param" description="Directory and name of the plugin Index file" type="string" variable="$file">
4165
  <type by_reference="false">string</type>
4166
  </tag>
4167
+ <tag line="152" name="return" description="Updated array of links for the Plugin" type="array">
4168
  <type by_reference="false">array</type>
4169
  </tag>
4170
  </docblock>
4171
+ <argument line="162">
4172
  <name>$links</name>
4173
  <default><![CDATA[]]></default>
4174
  <type/>
4175
  </argument>
4176
+ <argument line="162">
4177
  <name>$file</name>
4178
  <default><![CDATA[]]></default>
4179
  <type/>
4180
  </argument>
4181
  </method>
4182
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="182" package="Media Library Assistant">
4183
  <name>_update_option_row</name>
4184
  <full_name>_update_option_row</full_name>
4185
+ <docblock line="171">
4186
  <description><![CDATA[Update or delete a single MLA option value]]></description>
4187
  <long-description><![CDATA[]]></long-description>
4188
+ <tag line="171" name="since" description="0.80"/>
4189
+ <tag line="171" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4190
+ <tag line="171" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
4191
  <type by_reference="false">string</type>
4192
  </tag>
4193
+ <tag line="171" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
4194
  <type by_reference="false">array</type>
4195
  </tag>
4196
+ <tag line="171" name="return" description="HTML markup for the option's table row" type="string">
4197
  <type by_reference="false">string</type>
4198
  </tag>
4199
  </docblock>
4200
+ <argument line="182">
4201
  <name>$key</name>
4202
  <default><![CDATA[]]></default>
4203
  <type/>
4204
  </argument>
4205
+ <argument line="182">
4206
  <name>$value</name>
4207
  <default><![CDATA[]]></default>
4208
  <type/>
4209
  </argument>
4210
  </method>
4211
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="260" package="Media Library Assistant">
4212
  <name>_compose_option_row</name>
4213
  <full_name>_compose_option_row</full_name>
4214
+ <docblock line="249">
4215
  <description><![CDATA[Compose the table row for a single MLA option]]></description>
4216
  <long-description><![CDATA[]]></long-description>
4217
+ <tag line="249" name="since" description="0.80"/>
4218
+ <tag line="249" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4219
+ <tag line="249" name="param" description="HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)" type="string" variable="$key">
4220
  <type by_reference="false">string</type>
4221
  </tag>
4222
+ <tag line="249" name="param" description="Option parameters, e.g., 'type', 'std'" type="array" variable="$value">
4223
  <type by_reference="false">array</type>
4224
  </tag>
4225
+ <tag line="249" name="return" description="HTML markup for the option's table row" type="string">
4226
  <type by_reference="false">string</type>
4227
  </tag>
4228
  </docblock>
4229
+ <argument line="260">
4230
  <name>$key</name>
4231
  <default><![CDATA[]]></default>
4232
  <type/>
4233
  </argument>
4234
+ <argument line="260">
4235
  <name>$value</name>
4236
  <default><![CDATA[]]></default>
4237
  <type/>
4238
  </argument>
4239
  </method>
4240
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="422" package="Media Library Assistant">
4241
  <name>_compose_settings_tabs</name>
4242
  <full_name>_compose_settings_tabs</full_name>
4243
+ <docblock line="412">
4244
  <description><![CDATA[Compose the navigation tabs for the Settings subpage]]></description>
4245
  <long-description><![CDATA[]]></long-description>
4246
+ <tag line="412" name="since" description="0.80"/>
4247
+ <tag line="412" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4248
+ <tag line="412" name="param" description="Optional data-tab-id value for the active tab, default 'general'" type="string" variable="$active_tab">
4249
  <type by_reference="false">string</type>
4250
  </tag>
4251
+ <tag line="412" name="return" description="HTML markup for the Settings subpage navigation tabs" type="string">
4252
  <type by_reference="false">string</type>
4253
  </tag>
4254
  </docblock>
4255
+ <argument line="422">
4256
  <name>$active_tab</name>
4257
  <default><![CDATA['general']]></default>
4258
  <type/>
4259
  </argument>
4260
  </method>
4261
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="448" package="Media Library Assistant">
4262
  <name>_compose_general_tab</name>
4263
  <full_name>_compose_general_tab</full_name>
4264
+ <docblock line="440">
4265
  <description><![CDATA[Compose the General tab content for the Settings subpage]]></description>
4266
  <long-description><![CDATA[]]></long-description>
4267
+ <tag line="440" name="since" description="0.80"/>
4268
+ <tag line="440" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4269
+ <tag line="440" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
4270
  <type by_reference="false">array</type>
4271
  </tag>
4272
  </docblock>
4273
  </method>
4274
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="533" package="Media Library Assistant">
4275
  <name>_compose_mla_gallery_tab</name>
4276
  <full_name>_compose_mla_gallery_tab</full_name>
4277
+ <docblock line="525">
4278
  <description><![CDATA[Compose the MLA Gallery tab content for the Settings subpage]]></description>
4279
  <long-description><![CDATA[]]></long-description>
4280
+ <tag line="525" name="since" description="0.80"/>
4281
+ <tag line="525" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4282
+ <tag line="525" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
4283
  <type by_reference="false">array</type>
4284
  </tag>
4285
  </docblock>
4286
  </method>
4287
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="835" package="Media Library Assistant">
4288
  <name>_compose_custom_field_tab</name>
4289
  <full_name>_compose_custom_field_tab</full_name>
4290
+ <docblock line="827">
4291
  <description><![CDATA[Compose the Custom Field tab content for the Settings subpage]]></description>
4292
  <long-description><![CDATA[]]></long-description>
4293
+ <tag line="827" name="since" description="1.10"/>
4294
+ <tag line="827" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4295
+ <tag line="827" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
4296
  <type by_reference="false">array</type>
4297
  </tag>
4298
  </docblock>
4299
  </method>
4300
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="940" package="Media Library Assistant">
4301
  <name>_compose_iptc_exif_tab</name>
4302
  <full_name>_compose_iptc_exif_tab</full_name>
4303
+ <docblock line="932">
4304
  <description><![CDATA[Compose the IPTC/EXIF tab content for the Settings subpage]]></description>
4305
  <long-description><![CDATA[]]></long-description>
4306
+ <tag line="932" name="since" description="1.00"/>
4307
+ <tag line="932" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4308
+ <tag line="932" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
4309
  <type by_reference="false">array</type>
4310
  </tag>
4311
  </docblock>
4312
  </method>
4313
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1047" package="Media Library Assistant">
4314
  <name>_compose_documentation_tab</name>
4315
  <full_name>_compose_documentation_tab</full_name>
4316
+ <docblock line="1039">
4317
  <description><![CDATA[Compose the Documentation tab content for the Settings subpage]]></description>
4318
  <long-description><![CDATA[]]></long-description>
4319
+ <tag line="1039" name="since" description="0.80"/>
4320
+ <tag line="1039" name="uses" description="\global\$page_template_array" refers="\global\$page_template_array"/>
4321
+ <tag line="1039" name="return" description="'message' =&gt; status/error messages, 'body' =&gt; tab content" type="array">
4322
  <type by_reference="false">array</type>
4323
  </tag>
4324
  </docblock>
4325
  </method>
4326
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1066" package="Media Library Assistant">
4327
  <name>mla_render_settings_page</name>
4328
  <full_name>mla_render_settings_page</full_name>
4329
+ <docblock line="1059">
4330
  <description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
4331
  <long-description><![CDATA[]]></long-description>
4332
+ <tag line="1059" name="since" description="0.1"/>
4333
+ <tag line="1059" name="return" description="Echoes HTML markup for the Settings subpage" type="void">
4334
  <type by_reference="false">void</type>
4335
  </tag>
4336
  </docblock>
4337
  </method>
4338
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1117" package="Media Library Assistant">
4339
  <name>_save_gallery_settings</name>
4340
  <full_name>_save_gallery_settings</full_name>
4341
+ <docblock line="1108">
4342
  <description><![CDATA[Save MLA Gallery settings to the options table]]></description>
4343
  <long-description><![CDATA[]]></long-description>
4344
+ <tag line="1108" name="since" description="0.80"/>
4345
+ <tag line="1108" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4346
+ <tag line="1108" name="return" description="Message(s) reflecting the results of the operation" type="array">
4347
  <type by_reference="false">array</type>
4348
  </tag>
4349
  </docblock>
4350
  </method>
4351
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1350" package="Media Library Assistant">
4352
  <name>_process_custom_field_mapping</name>
4353
  <full_name>_process_custom_field_mapping</full_name>
4354
+ <docblock line="1339">
4355
  <description><![CDATA[Process custom field settings against all image attachments
4356
  without saving the settings to the mla_option]]></description>
4357
  <long-description><![CDATA[]]></long-description>
4358
+ <tag line="1339" name="since" description="1.10"/>
4359
+ <tag line="1339" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4360
+ <tag line="1339" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$settings">
4361
  <type by_reference="false">array</type>
4362
  </tag>
4363
+ <tag line="1339" name="return" description="Message(s) reflecting the results of the operation" type="array">
4364
  <type by_reference="false">array</type>
4365
  </tag>
4366
  </docblock>
4367
+ <argument line="1350">
4368
  <name>$settings</name>
4369
  <default><![CDATA[NULL]]></default>
4370
  <type/>
4371
  </argument>
4372
  </method>
4373
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1402" package="Media Library Assistant">
4374
  <name>_delete_custom_field</name>
4375
  <full_name>_delete_custom_field</full_name>
4376
+ <docblock line="1393">
4377
  <description><![CDATA[Delete a custom field from the wp_postmeta table]]></description>
4378
  <long-description><![CDATA[]]></long-description>
4379
+ <tag line="1393" name="since" description="1.10"/>
4380
+ <tag line="1393" name="param" description="specific custom_field_mapping rule" type="array" variable="$value">
4381
  <type by_reference="false">array</type>
4382
  </tag>
4383
+ <tag line="1393" name="return" description="Message(s) reflecting the results of the operation" type="array">
4384
  <type by_reference="false">array</type>
4385
  </tag>
4386
  </docblock>
4387
+ <argument line="1402">
4388
  <name>$value</name>
4389
  <default><![CDATA[]]></default>
4390
  <type/>
4391
  </argument>
4392
  </method>
4393
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1426" package="Media Library Assistant">
4394
  <name>_save_custom_field_settings</name>
4395
  <full_name>_save_custom_field_settings</full_name>
4396
+ <docblock line="1416">
4397
  <description><![CDATA[Save custom field settings to the options table]]></description>
4398
  <long-description><![CDATA[]]></long-description>
4399
+ <tag line="1416" name="since" description="1.10"/>
4400
+ <tag line="1416" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4401
+ <tag line="1416" name="param" description="| NULL specific custom_field_mapping values" type="array" variable="$new_values">
4402
  <type by_reference="false">array</type>
4403
  </tag>
4404
+ <tag line="1416" name="return" description="Message(s) reflecting the results of the operation" type="array">
4405
  <type by_reference="false">array</type>
4406
  </tag>
4407
  </docblock>
4408
+ <argument line="1426">
4409
  <name>$new_values</name>
4410
  <default><![CDATA[NULL]]></default>
4411
  <type/>
4412
  </argument>
4413
  </method>
4414
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1466" package="Media Library Assistant">
4415
  <name>_process_iptc_exif_standard</name>
4416
  <full_name>_process_iptc_exif_standard</full_name>
4417
+ <docblock line="1456">
4418
  <description><![CDATA[Process IPTC/EXIF standard field settings against all image attachments
4419
  without saving the settings to the mla_option]]></description>
4420
  <long-description><![CDATA[]]></long-description>
4421
+ <tag line="1456" name="since" description="1.00"/>
4422
+ <tag line="1456" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4423
+ <tag line="1456" name="return" description="Message(s) reflecting the results of the operation" type="array">
4424
  <type by_reference="false">array</type>
4425
  </tag>
4426
  </docblock>
4427
  </method>
4428
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1510" package="Media Library Assistant">
4429
  <name>_process_iptc_exif_taxonomy</name>
4430
  <full_name>_process_iptc_exif_taxonomy</full_name>
4431
+ <docblock line="1500">
4432
  <description><![CDATA[Process IPTC/EXIF taxonomy term settings against all image attachments
4433
  without saving the settings to the mla_option]]></description>
4434
  <long-description><![CDATA[]]></long-description>
4435
+ <tag line="1500" name="since" description="1.00"/>
4436
+ <tag line="1500" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4437
+ <tag line="1500" name="return" description="Message(s) reflecting the results of the operation" type="array">
4438
  <type by_reference="false">array</type>
4439
  </tag>
4440
  </docblock>
4441
  </method>
4442
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1557" package="Media Library Assistant">
4443
  <name>_process_iptc_exif_custom</name>
4444
  <full_name>_process_iptc_exif_custom</full_name>
4445
+ <docblock line="1545">
4446
  <description><![CDATA[Process IPTC/EXIF custom field settings against all image attachments
4447
  without saving the settings to the mla_option]]></description>
4448
  <long-description><![CDATA[]]></long-description>
4449
+ <tag line="1545" name="since" description="1.00"/>
4450
+ <tag line="1545" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4451
+ <tag line="1545" name="param" description="| NULL specific iptc_exif_custom_mapping values" type="array" variable="$settings">
4452
+ <type by_reference="false">array</type>
4453
+ </tag>
4454
+ <tag line="1545" name="return" description="Message(s) reflecting the results of the operation" type="array">
4455
  <type by_reference="false">array</type>
4456
  </tag>
4457
  </docblock>
4458
+ <argument line="1557">
4459
+ <name>$settings</name>
4460
+ <default><![CDATA[NULL]]></default>
4461
+ <type/>
4462
+ </argument>
4463
  </method>
4464
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1609" package="Media Library Assistant">
4465
+ <name>_save_iptc_exif_custom_settings</name>
4466
+ <full_name>_save_iptc_exif_custom_settings</full_name>
4467
+ <docblock line="1600">
4468
+ <description><![CDATA[Save IPTC/EXIF custom field settings to the options table]]></description>
4469
+ <long-description><![CDATA[]]></long-description>
4470
+ <tag line="1600" name="since" description="1.30"/>
4471
+ <tag line="1600" name="param" description="specific iptc_exif_custom_mapping values" type="array" variable="$new_values">
4472
+ <type by_reference="false">array</type>
4473
+ </tag>
4474
+ <tag line="1600" name="return" description="Message(s) reflecting the results of the operation" type="array">
4475
+ <type by_reference="false">array</type>
4476
+ </tag>
4477
+ </docblock>
4478
+ <argument line="1609">
4479
+ <name>$new_values</name>
4480
+ <default><![CDATA[]]></default>
4481
+ <type/>
4482
+ </argument>
4483
+ </method>
4484
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1625" package="Media Library Assistant">
4485
  <name>_save_iptc_exif_settings</name>
4486
  <full_name>_save_iptc_exif_settings</full_name>
4487
+ <docblock line="1616">
4488
  <description><![CDATA[Save IPTC/EXIF settings to the options table]]></description>
4489
  <long-description><![CDATA[]]></long-description>
4490
+ <tag line="1616" name="since" description="1.00"/>
4491
+ <tag line="1616" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4492
+ <tag line="1616" name="return" description="Message(s) reflecting the results of the operation" type="array">
4493
  <type by_reference="false">array</type>
4494
  </tag>
4495
  </docblock>
4496
  </method>
4497
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1662" package="Media Library Assistant">
4498
  <name>_save_general_settings</name>
4499
  <full_name>_save_general_settings</full_name>
4500
+ <docblock line="1653">
4501
  <description><![CDATA[Save General settings to the options table]]></description>
4502
  <long-description><![CDATA[]]></long-description>
4503
+ <tag line="1653" name="since" description="0.1"/>
4504
+ <tag line="1653" name="uses" description="\global\$_REQUEST" refers="\global\$_REQUEST"/>
4505
+ <tag line="1653" name="return" description="Message(s) reflecting the results of the operation" type="array">
4506
  <type by_reference="false">array</type>
4507
  </tag>
4508
  </docblock>
4509
  </method>
4510
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1720" package="Media Library Assistant">
4511
  <name>_reset_general_settings</name>
4512
  <full_name>_reset_general_settings</full_name>
4513
+ <docblock line="1713">
4514
  <description><![CDATA[Delete saved settings, restoring default values]]></description>
4515
  <long-description><![CDATA[]]></long-description>
4516
+ <tag line="1713" name="since" description="0.1"/>
4517
+ <tag line="1713" name="return" description="Message(s) reflecting the results of the operation" type="array">
4518
  <type by_reference="false">array</type>
4519
  </tag>
4520
  </docblock>
4521
  </method>
4522
  </class>
4523
  </file>
4524
+ <file path="includes\class-mla-shortcodes.php" hash="d1e9ede5b6e8e3e42cde312e4fccf82f" package="Media Library Assistant">
4525
  <docblock line="2">
4526
  <description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
4527
  <long-description><![CDATA[]]></long-description>
4562
  </tag>
4563
  </docblock>
4564
  </property>
4565
+ <property final="false" static="true" visibility="private" line="835" namespace="global" package="Media Library Assistant">
4566
  <name>$query_parameters</name>
4567
  <default><![CDATA[array()]]></default>
4568
+ <docblock line="821">
4569
  <description><![CDATA[WP_Query filter "parameters"]]></description>
4570
  <long-description><![CDATA[<p>This array defines parameters for the query's where and orderby filters,
4571
  mla_shortcode_query_posts_where_filter and mla_shortcode_query_posts_orderby_filter.
4573
  any further logic required to translate those values is contained in the filter.</p>
4574
 
4575
  <p>Array index values are: orderby, post_parent</p>]]></long-description>
4576
+ <tag line="821" name="since" description="1.13"/>
4577
+ <tag line="821" name="var" description="" type="array">
4578
+ <type by_reference="false">array</type>
4579
+ </tag>
4580
+ </docblock>
4581
+ </property>
4582
+ <property final="false" static="true" visibility="private" line="944" namespace="global" package="Media Library Assistant">
4583
+ <name>$data_selection_parameters</name>
4584
+ <default><![CDATA[array('order' => 'ASC', 'orderby' => 'menu_order,ID', 'id' => NULL, 'ids' => array(), 'include' => array(), 'exclude' => array(), 'post_parent' => NULL, 'author' => NULL, 'author_name' => '', 'cat' => 0, 'category_name' => '', 'category__and' => array(), 'category__in' => array(), 'category__not_in' => array(), 'tag' => '', 'tag_id' => 0, 'tag__and' => array(), 'tag__in' => array(), 'tag__not_in' => array(), 'tag_slug__and' => array(), 'tag_slug__in' => array(), 'tax_operator' => '', 'post_type' => 'attachment', 'post_status' => 'inherit', 'post_mime_type' => 'image', 'nopaging' => true, 'numberposts' => 0, 'posts_per_page' => 0, 'posts_per_archive_page' => 0, 'paged' => NULL, 'offset' => NULL, 'meta_key' => '', 'meta_value' => '', 'meta_value_num' => NULL, 'meta_compare' => '', 'meta_query' => '', 's' => '')]]></default>
4585
+ <docblock line="937">
4586
+ <description><![CDATA[Data selection parameters for the WP_Query in [mla_gallery]]]></description>
4587
+ <long-description><![CDATA[]]></long-description>
4588
+ <tag line="937" name="since" description="1.30"/>
4589
+ <tag line="937" name="var" description="" type="array">
4590
  <type by_reference="false">array</type>
4591
  </tag>
4592
  </docblock>
4593
  </property>
4594
+ <property final="false" static="true" visibility="private" line="1438" namespace="global" package="Media Library Assistant">
4595
  <name>$mla_iptc_records</name>
4596
  <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>
4597
+ <docblock line="1428">
4598
  <description><![CDATA[IPTC Dataset identifiers and names]]></description>
4599
  <long-description><![CDATA[<p>This array contains the identifiers and names of Datasets defined in
4600
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
4601
+ <tag line="1428" name="since" description="0.90"/>
4602
+ <tag line="1428" name="var" description="" type="array">
4603
  <type by_reference="false">array</type>
4604
  </tag>
4605
  </docblock>
4606
  </property>
4607
+ <property final="false" static="true" visibility="public" line="1537" namespace="global" package="Media Library Assistant">
4608
  <name>$mla_iptc_keys</name>
4609
  <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>
4610
+ <docblock line="1527">
4611
  <description><![CDATA[IPTC Dataset friendly name/slug and identifiers]]></description>
4612
  <long-description><![CDATA[<p>This array contains the sanitized names and identifiers of Datasets defined in
4613
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
4614
+ <tag line="1527" name="since" description="0.90"/>
4615
+ <tag line="1527" name="var" description="" type="array">
4616
  <type by_reference="false">array</type>
4617
  </tag>
4618
  </docblock>
4619
  </property>
4620
+ <property final="false" static="true" visibility="private" line="1636" namespace="global" package="Media Library Assistant">
4621
  <name>$mla_iptc_descriptions</name>
4622
  <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>
4623
+ <docblock line="1626">
4624
  <description><![CDATA[IPTC Dataset descriptions]]></description>
4625
  <long-description><![CDATA[<p>This array contains the descriptions of Datasets defined in
4626
  the "IPTC-NAA Information Interchange Model Version No. 4.1".</p>]]></long-description>
4627
+ <tag line="1626" name="since" description="0.90"/>
4628
+ <tag line="1626" name="var" description="" type="array">
4629
  <type by_reference="false">array</type>
4630
  </tag>
4631
  </docblock>
4632
  </property>
4633
+ <property final="false" static="true" visibility="private" line="1735" namespace="global" package="Media Library Assistant">
4634
  <name>$mla_iptc_formats</name>
4635
  <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>
4636
+ <docblock line="1725">
4637
  <description><![CDATA[IPTC file format identifiers and descriptions]]></description>
4638
  <long-description><![CDATA[<p>This array contains the file format identifiers and descriptions defined in
4639
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 1#020.</p>]]></long-description>
4640
+ <tag line="1725" name="since" description="0.90"/>
4641
+ <tag line="1725" name="var" description="" type="array">
4642
  <type by_reference="false">array</type>
4643
  </tag>
4644
  </docblock>
4645
  </property>
4646
+ <property final="false" static="true" visibility="private" line="1778" namespace="global" package="Media Library Assistant">
4647
  <name>$mla_iptc_image_types</name>
4648
  <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>
4649
+ <docblock line="1768">
4650
  <description><![CDATA[IPTC image type identifiers and descriptions]]></description>
4651
  <long-description><![CDATA[<p>This array contains the image type identifiers and descriptions defined in
4652
  the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 2#130, octet 2.</p>]]></long-description>
4653
+ <tag line="1768" name="since" description="0.90"/>
4654
+ <tag line="1768" name="var" description="" type="array">
4655
  <type by_reference="false">array</type>
4656
  </tag>
4657
  </docblock>
4702
  <type/>
4703
  </argument>
4704
  </method>
4705
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="846" package="Media Library Assistant">
4706
  <name>_sanitize_query_specification</name>
4707
  <full_name>_sanitize_query_specification</full_name>
4708
+ <docblock line="837">
4709
  <description><![CDATA[Cleans up damage caused by the Visual Editor to the tax_query and meta_query specifications]]></description>
4710
  <long-description><![CDATA[]]></long-description>
4711
+ <tag line="837" name="since" description="1.14"/>
4712
+ <tag line="837" name="param" description="query specification; PHP nested arrays" type="string" variable="$specification">
4713
  <type by_reference="false">string</type>
4714
  </tag>
4715
+ <tag line="837" name="return" description="query specification with HTML escape sequences and line breaks removed" type="string">
4716
  <type by_reference="false">string</type>
4717
  </tag>
4718
  </docblock>
4719
+ <argument line="846">
4720
  <name>$specification</name>
4721
  <default><![CDATA[]]></default>
4722
  <type/>
4723
  </argument>
4724
  </method>
4725
+ <method final="false" abstract="false" static="true" visibility="private" namespace="global" line="863" package="Media Library Assistant">
4726
  <name>_validate_sql_orderby</name>
4727
  <full_name>_validate_sql_orderby</full_name>
4728
+ <docblock line="852">
4729
  <description><![CDATA[Translates query parameters to a valid SQL order by clause.]]></description>
4730
  <long-description><![CDATA[<p>Accepts one or more valid columns, with or without ASC/DESC.
4731
  Enhanced version of /wp-includes/formatting.php function sanitize_sql_orderby().</p>]]></long-description>
4732
+ <tag line="852" name="since" description="1.20"/>
4733
+ <tag line="852" name="param" description="Validated query parameters" type="array" variable="$query_parameters">
4734
  <type by_reference="false">array</type>
4735
  </tag>
4736
+ <tag line="852" name="return" description="Returns the orderby clause if present, false otherwise." type="string|bool">
4737
  <type by_reference="false">string</type>
4738
  <type by_reference="false">bool</type>
4739
  </tag>
4740
  </docblock>
4741
+ <argument line="863">
4742
  <name>$query_parameters</name>
4743
  <default><![CDATA[]]></default>
4744
  <type/>
4745
  </argument>
4746
  </method>
4747
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1007" package="Media Library Assistant">
4748
  <name>mla_get_shortcode_attachments</name>
4749
  <full_name>mla_get_shortcode_attachments</full_name>
4750
+ <docblock line="997">
4751
  <description><![CDATA[Parses shortcode parameters and returns the gallery objects]]></description>
4752
  <long-description><![CDATA[]]></long-description>
4753
+ <tag line="997" name="since" description=".50"/>
4754
+ <tag line="997" name="param" description="Post ID of the parent" type="int" variable="$post_parent">
4755
  <type by_reference="false">int</type>
4756
  </tag>
4757
+ <tag line="997" name="param" description="Attributes of the shortcode" type="array" variable="$attr">
4758
  <type by_reference="false">array</type>
4759
  </tag>
4760
+ <tag line="997" name="return" description="List of attachments returned from WP_Query" type="array">
4761
  <type by_reference="false">array</type>
4762
  </tag>
4763
  </docblock>
4764
+ <argument line="1007">
4765
  <name>$post_parent</name>
4766
  <default><![CDATA[]]></default>
4767
  <type/>
4768
  </argument>
4769
+ <argument line="1007">
4770
  <name>$attr</name>
4771
  <default><![CDATA[]]></default>
4772
  <type/>
4773
  </argument>
4774
  </method>
4775
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1338" package="Media Library Assistant">
4776
  <name>mla_shortcode_query_posts_where_filter</name>
4777
  <full_name>mla_shortcode_query_posts_where_filter</full_name>
4778
+ <docblock line="1324">
4779
  <description><![CDATA[Filters the WHERE clause for shortcode queries]]></description>
4780
  <long-description><![CDATA[<p>Captures debug information. Adds whitespace to the post_type = 'attachment'
4781
  phrase to circumvent subsequent Role Scoper modification of the clause.
4782
  Handles post_parent "any" and "none" cases.
4783
  Defined as public because it's a filter.</p>]]></long-description>
4784
+ <tag line="1324" name="since" description="0.70"/>
4785
+ <tag line="1324" name="param" description="query clause before modification" type="string" variable="$where_clause">
4786
  <type by_reference="false">string</type>
4787
  </tag>
4788
+ <tag line="1324" name="return" description="query clause after modification" type="string">
4789
  <type by_reference="false">string</type>
4790
  </tag>
4791
  </docblock>
4792
+ <argument line="1338">
4793
  <name>$where_clause</name>
4794
  <default><![CDATA[]]></default>
4795
  <type/>
4796
  </argument>
4797
  </method>
4798
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1379" package="Media Library Assistant">
4799
  <name>mla_shortcode_query_posts_orderby_filter</name>
4800
  <full_name>mla_shortcode_query_posts_orderby_filter</full_name>
4801
+ <docblock line="1367">
4802
  <description><![CDATA[Filters the ORDERBY clause for shortcode queries]]></description>
4803
  <long-description><![CDATA[<p>This is an enhanced version of the code found in wp-includes/query.php, function get_posts.
4804
  Defined as public because it's a filter.</p>]]></long-description>
4805
+ <tag line="1367" name="since" description="1.20"/>
4806
+ <tag line="1367" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
4807
  <type by_reference="false">string</type>
4808
  </tag>
4809
+ <tag line="1367" name="return" description="query clause after modification" type="string">
4810
  <type by_reference="false">string</type>
4811
  </tag>
4812
  </docblock>
4813
+ <argument line="1379">
4814
  <name>$orderby_clause</name>
4815
  <default><![CDATA[]]></default>
4816
  <type/>
4817
  </argument>
4818
  </method>
4819
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1404" package="Media Library Assistant">
4820
+ <name>mla_shortcode_query_posts_clauses_filter</name>
4821
+ <full_name>mla_shortcode_query_posts_clauses_filter</full_name>
4822
+ <docblock line="1392">
4823
+ <description><![CDATA[Filters all clauses for shortcode queries, pre caching plugins]]></description>
4824
+ <long-description><![CDATA[<p>This is for debug purposes only.
4825
+ Defined as public because it's a filter.</p>]]></long-description>
4826
+ <tag line="1392" name="since" description="1.30"/>
4827
+ <tag line="1392" name="param" description="query clauses before modification" type="array" variable="$pieces">
4828
+ <type by_reference="false">array</type>
4829
+ </tag>
4830
+ <tag line="1392" name="return" description="query clauses after modification (none)" type="array">
4831
+ <type by_reference="false">array</type>
4832
+ </tag>
4833
+ </docblock>
4834
+ <argument line="1404">
4835
+ <name>$pieces</name>
4836
+ <default><![CDATA[]]></default>
4837
+ <type/>
4838
+ </argument>
4839
+ </method>
4840
+ <method final="false" abstract="false" static="true" visibility="public" namespace="global" line="1422" package="Media Library Assistant">
4841
+ <name>mla_shortcode_query_posts_clauses_request_filter</name>
4842
+ <full_name>mla_shortcode_query_posts_clauses_request_filter</full_name>
4843
+ <docblock line="1410">
4844
+ <description><![CDATA[Filters all clauses for shortcode queries, post caching plugins]]></description>
4845
+ <long-description><![CDATA[<p>This is for debug purposes only.
4846
+ Defined as public because it's a filter.</p>]]></long-description>
4847
+ <tag line="1410" name="since" description="1.30"/>
4848
+ <tag line="1410" name="param" description="query clauses before modification" type="array" variable="$pieces">
4849
+ <type by_reference="false">array</type>
4850
+ </tag>
4851
+ <tag line="1410" name="return" description="query clauses after modification (none)" type="array">
4852
+ <type by_reference="false">array</type>
4853
+ </tag>
4854
+ </docblock>
4855
+ <argument line="1422">
4856
+ <name>$pieces</name>
4857
+ <default><![CDATA[]]></default>
4858
+ <type/>
4859
+ </argument>
4860
+ </method>
4861
  </class>
4862
  </file>
4863
  <file path="includes\mla-plugin-loader.php" hash="b638ba24f0c701bf238f9d627df23d0a" package="Media Library Assistant">
4917
  </docblock>
4918
  </function>
4919
  </file>
4920
+ <file path="index.php" hash="bca402e9bf5129d3265eb99b4b41a836" package="Media Library Assistant">
4921
  <docblock line="2">
4922
  <description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
4923
  <long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
4924
  will the rest of the plugin be loaded and run.</p>]]></long-description>
4925
  <tag line="2" name="package" description="Media Library Assistant"/>
4926
+ <tag line="2" name="version" description="1.30"/>
4927
  </docblock>
4928
  <include line="105" type="Require Once" package="Media Library Assistant">
4929
  <name>includes/mla-plugin-loader.php</name>
readme.txt CHANGED
@@ -4,7 +4,7 @@ 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.1
7
- Stable tag: 1.20
8
  License: GPLv2 or later
9
  License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
 
@@ -93,7 +93,7 @@ Hover over the item you want to modify and click the "Edit" action. On the Edit
93
 
94
  = The Media/Assistant submenu seems sluggish; is there anything I can do to make it faster? =
95
 
96
- 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.
97
 
98
  = Are other language versions available? =
99
 
@@ -101,7 +101,7 @@ Not at this time; I don't have working knowledge of anything but English. If you
101
 
102
  = What's in the "phpDocs" directory and do I need it? =
103
 
104
- All of the MLA source code has been annotated with "DocBlocks", a special type of comment used by phpDocumentor to generate API documentation. If you'd like a deeper understanding of the code, click on "index.html" in the phpDocs dorectory and have a look. Note that these pages require JavaScript for much of their functionality.
105
 
106
  == Screenshots ==
107
 
@@ -117,6 +117,20 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
117
 
118
  == Changelog ==
119
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
120
  = 1.20 =
121
  * New: The long-awaited enhancements to the WordPress (3.5+) Media Manager (Add Media, etc.). Filter your attachments by additional MIME types, month and year uploaded and/or taxonomy terms. Keyword search can be extended to the name/slug, ALT text and caption fields. The connector between search terms can be "and" or "or". Search by attachment ID or parent ID is supported. Enable/disable any or all enhancements on the Settings page.
122
  * New: In the `[mla_gallery]` shortcode, enhanced parameters for sorting the gallery results. For example, `orderby=caption` and `orderby=description` are now available to sort gallery results by the Caption (post_excerpt) and Description (post_content) fields. You can also sort on multiple fields, e.g., `orderby="author, date DESC"`, with field-level ASC/DESC control. The "Other Notes" section here or the Documentation tab on the Settings/Media Library Assistant page of the plugin have details.
@@ -133,7 +147,7 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
133
  * New: In the `[mla_gallery]` shortcode, a new `mla_target` parameter allows you to specify the HTML `target` attribute in the gallery item links, e.g., `mla_target="_blank"` will open the items in a new window or tab.
134
  * New: In the `[mla_gallery]` shortcode, a new `tax_operator` parameter allows you to specify "AND" or "NOT IN" operators in the simple `tax_name=term(s)` version of taxonomy queries. See the Settings/Media Library Assistant Documentation page for details.
135
  * New: In the `[mla_gallery]` shortcode, `tax_query` corruption caused by the Visual mode of the post/page editor is now cleaned up before the query is submitted; Line breaks, HTML markup and escape sequences added by the Visual editor are removed.
136
- * Fix: IPTC/EXIF values containing an arrray, e.g., "2#025 keywords", will be converted to a comma-separated string before assignment to Standard fields or Custom fields.
137
  * Fix: Custom Field Mapping will always ignore rules with Data Source set to "-- None (select a value) --".
138
  * Fix: In the `[mla_gallery]` shortcode, the `orderby` parameter will override the explicit order in the `ids` parameter.
139
  * Fix: In the `[mla_gallery]` shortcode, the `ids` and `include` parameters no longer require `post_parent=all` to match items not attached to the current post/page.
@@ -194,7 +208,7 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
194
  * Fix: Quick edit support of WordPress standard Categories taxonomy fixed.
195
 
196
  = 0.80 =
197
- * New: MLA Gllery Style and Markup Templates, for control over CSS styles, HTML markup and data content of `[mla_gallery]` shortcode output.
198
  * New: The `[mla_gallery]` "mla_link_text", "mla_rollover_text" and "mla_caption", parameters allow easy customization of gallery display.
199
  * New: The `[mla_gallery]` "link" parameter now accepts size values, e.g., "medium", to generate a link to image sizes other than "full".
200
  * New: The `[mla_gallery]` "mla_debug" parameter provides debugging information for query parameters.
@@ -277,8 +291,8 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
277
 
278
  == Upgrade Notice ==
279
 
280
- = 1.20 =
281
- Media Manager (Add Media, etc.) enhancements: filter by more MIME types, date, taxonomy terms; enhanced search box for name/slug, ALT text, caption and attachment ID. New [mla_gallery] sort options. Four other enhancements, four fixes.
282
 
283
  == Other Notes ==
284
 
@@ -291,6 +305,8 @@ In this section, scroll down to see:
291
  * Custom Field Processing Options
292
  * IPTC &amp; EXIF Processing Options
293
 
 
 
294
  == Acknowledgements ==
295
 
296
  I have used and learned much from the following books (among many):
@@ -308,182 +324,129 @@ The `[mla_gallery]` shortcode is used in a post, page or custom post type to add
308
  * Support for all post_mime_type values, not just images.
309
  * Media Library items need not be "attached" to the post. You can build a gallery with any combination of items in the Library using taxonomy terms, custom fields and more.
310
  * Control over the styles, markup and content of each gallery using the Style and Markup Templates documented below.
 
311
 
312
  All of the options/parameters documented for the `[gallery]` shortcode are supported by the `[mla_gallery]` shortcode; you can find them in the WordPress Codex. Most of the parameters documented for the WP_Query class are also supported; see the WordPress Codex. Because the `[mla_gallery]` shortcode is designed to work with Media Library items, there are some parameter differences and extensions; these are documented below.
313
 
314
  <h4>Gallery Display Style</h4>
315
 
316
- Two `[mla_gallery]` parameters provide a way to apply custom style and markup templates to your `[mla_gallery]` display. These parameters replace the default style and/or markup templates with templates you define on the "MLA Gallery" tab of the Settings page. On the "MLA Gallery" tab you can also select one of your custom templates to replace the built-in default template for all `[mla_gallery`] shortcodes the do not contain one of these parameters.
317
-
318
- * `mla_style`: replaces the default style template for an `[mla_gallery]` shortcode
319
-
320
- * `mla_markup`: replaces the default markup template for an `[mla_gallery]` shortcode
321
-
322
- Three `[mla_gallery]` parameters provide control over the placement, size and spacing of gallery items without requiring the use of custom Style templates.
323
-
324
- * `mla_float`: 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).
325
 
326
- * `mla_margin`: specifies the margin attribute (in percent) of the ".gallery-item" style. The default value is "1.5" percent.
 
327
 
328
- * `mla_itemwidth`: specifies the width attribute (in percent) of the ".gallery-item" style. The default value is calculated by subtracting twice the margin from 100%, then dividing by the number of gallery columns. For example, the default value is "32", or (100 - (2 * 1.5)) / 3.
329
 
330
- These parameters are only important if the gallery thumbnails are too large to fit within the width of the page on which they appear. For example, if you code `[mla_gallery size=full]`, the browser will automatically scale down large images to fit within the width attribute (in percent) of the ".gallery-item" style. The default 1.5% margin will ensure that the images do not overlap; you can increase it to add more space between the gallery items. You can also reduce the itemwidth parameter to increase the left and right space between the items.
 
 
331
 
332
  <h4>Gallery Display Content</h4>
333
 
334
- Five `[mla_gallery]` parameters provide an easy way to control the contents of gallery items without requiring the use of custom Markup templates.
335
-
336
- * `mla_link_href`: replaces the HTML "href" attribute in the hyperlink for each gallery item; see below.
337
-
338
- * `mla_link_text`: replaces the thumbnail image or attachment title text displayed for each gallery item.
339
-
340
- * `mla_rollover_text`: replaces the attachment title text displayed when the mouse rolls or hovers over the gallery thumbnail.
341
-
342
- * `mla_caption`: replaces the attachment caption text displayed beneath the thumbnail of each gallery item.
343
-
344
- * `mla_target`: adds an HTML "target" attribute to the hyperlink for each gallery item; see below.
345
-
346
- The first four parameters support the Markup and Attachment-specific substitution arguments defined for Markup Templates. For example, if you code `mla_rollover_text='{+date+} : {+description+}'`, the rollover text will contain the upload date, a colon, and the full description of each gallery item. Simply add "{+" before the substitution parameter name and add "+}" after the name. Note that the enclosing delimiters are different than those used in the templates, since the shortcode parser reserves square brackets ("[" and "]") for its own use.
347
 
348
- The "mla_link_href" parameter is a great way to change the destination your gallery item links to or add arguments to the link for later processing. For example, to make a gallery item link back to the page/post it is attached to, you can code: "mla_link_href='{+site_url+}/?page_id={+parent+}'". You can also add arguments to the link, e.g., "mla_link_href='{+link_url+}&amp;amp;myarg=myvalue'". Note the use of the HTML entity name "&amp;amp;" to put an ampersand in the value; the WordPress "visual" post editor will replace "&", "<" and ">" with "&amp;amp;", "&amp;lt;" and "&amp;gt;" whether you like it not. The **only** markup parameter modified by this parameter is "link". Other markup parameters such as "pagelink", "filelink" and "link_url" are not modified.
349
-
350
- The "mla_target" parameter accepts any value and adds an HTML "target" attribute to the hyperlink with that value. For example, if you code `mla_target="_blank"` the item will open in a new window or tab. You can also use "_self", "_parent", "_top" or the "<em>framename</em>" of a named frame.
 
 
351
 
352
  <h4>Google File Viewer Support</h4>
353
 
354
- Four `[mla_gallery]` parameters provide an easy way to generate thumbnail images for the non-image file types.
355
-
356
- * `mla_viewer`: must be "true" to enable thumbnail generation
357
-
358
- * `mla_viewer_extensions`: a comma-delimited list of the file extensions to be processed; the default is "pdf,txt,doc,xls,ppt" (do not include the dot (".") preceding the file extension). You may add or remove extensions, but these are known to generate reasonable thumbnail images. Sadly, the newer "docx,xlsx,pptx" extensions do not work well with the Google File Viewer.
359
 
360
- * `mla_viewer_page`: the page number (default "1") to be used for the thumbnail image. If you specify a value greater than the number of pages in the file, no image is generated.
361
-
362
- * `mla_viewer_width`: the width in pixels (default "150") of the generated thumbnail image. The height will be set automatically and cannot be specified.
363
-
364
- When this feature is active, gallery items for which WordPress can generate a thumbnail image are not altered. If WordPress generation fails, the gallery thumbnail is replaced by an "img" html tag whose "src" attribute contains a url reference to the Google File Viewer. The Google File Viewer arguments include the url of the source file, the page number and the width. Note that the source file must be Internet accessible; files behind firewalls and on local servers will not generate a thumbnail image.
365
 
366
  <h4>Order, Orderby</h4>
367
 
368
- The Orderby parameter specifies which database field(s) are used to sort the gallery. You can sort the gallery by one or more of these values (there is additional information on some of these values in the Codex WP_Query class reference):
369
-
370
- * `none`: No order.
371
- * `ID`: Order by post id. Note capitalization.
372
- * `author`: Order by author (id, not display name).
373
- * `date`: Order by date uploaded.
374
- * `description, content`: Order by attachment description.
375
- * `title`: Order by attachment title.
376
- * `caption, excerpt`: Order by attachment caption.
377
- * `slug, name`: Order by attachment name.
378
- * `modified`: Order by last modified date.
379
- * `parent`: Order by `: Order by attachment parent id.
380
- * `menu_order`: Order by page order.
381
- * `mime_type`: Order by attachment MIME type.
382
- * `comment_count`: Order by number of comments.
383
- * `rand`: Random order.
384
- * `<keyname>, meta_value, meta_value_num`: Order by custom field value. Note that a 'meta_key=keyname' must also be present in the query.
385
- * `post__in`: Preserve order given in the `ids`, `include` or `post__in` array.
386
 
387
- You can sort on more than one value, e.g., `orderby="author, date DESC"` and you can specify ASC/DESC on a value by value basis. **NOTE: multiple orderby values are separated by commas, not spaces.** This is a change from WP_Query.
388
-
389
- The `order` parameter (default ASC) can give an ASC/DESC default for any value that doesn't have a specific choice. For example, `orderby="author, date DESC, mime_type" order=ASC` is the same as `orderby="author ASC, date DESC, mime_type ASC"`.
390
 
391
  <h4>Size</h4>
392
 
393
- The Size parameter specifies the image size to use for the thumbnail display. Valid values include "thumbnail", "medium", "large", "full" and any additional image size that was registered with add_image_size(). The default value is "thumbnail". You can use "none" or "" to suppress thumbnail display and substitute the item title string for the image/icon.
394
-
395
  The `[mla_gallery]` shortcode supports an additional Size value, "icon", which shows a 60x60 pixel thumbnail for image items and an appropriate icon for non-image items such as PDF or text files.
396
 
397
  <h4>Link</h4>
398
 
399
- The Link parameter specifies the target for the link from the gallery to the attachment. The default value, "permalink", links to the attachment's media page. The "file" and "full" values link directly to the attachment file.
400
-
401
  For image attachments you can also specify the size of the image file you want to link to. Valid values include "thumbnail", "medium", "large" and any additional image size that was registered with add_image_size(). If the specified size is not available or if the attachment is not an image, the link will go directly to the attachment file.
402
 
403
- <h4>Include, Exclude</h4>
404
-
405
- You can use "post_parent=all" to include or exclude attachments regardless of which post or page they are attached to. You can use "post_mime_type=all" to include or exclude attachments of all MIME types, not just images.
406
-
407
  <h4>Post ID, "ids", Post Parent</h4>
408
 
409
- The "id" parameter lets you specify a post ID for your query. If the "id" parameter is not specified, the `[mla_gallery]` behavior differs from the `[gallery]` behavior. If your query uses taxonomy or custom field parameters, "author", "author_name" or "s" (search term), then the query will NOT be restricted to items attached to the current post. This lets you build a gallery with any combination of Media Library items that match the parameters.
410
-
411
- For WordPress 3.5 and later, the "ids" parameter lets you specify a list of Post IDs. The attachment(s) matching the "ids" values will be displayed in the order specified by the list.
412
-
413
- You can use the "post_parent" to override the default behavior. If you set "post_parent" to a specific post ID, only the items attached to that post are displayed. If you set "post_parent" to "current", only the items attached to the current post are displayed. If you set "post_parent" to "all", the query will not have a post ID or post_parent parameter.
414
-
415
- For example, `[mla_gallery tag="artisan"]` will display all images having the specified tag value, regardless of which post (if any) they are attached to. If you use `[mla_gallery tag="artisan" post_parent="current"]` it will display images having the specified tag value only if they are attached to the current post.
416
 
417
  <h4>Author, Author Name</h4>
418
 
419
  You can query by author's id or the "user_nicename" value (not the "display_name" value). Multiple author ID values are allowed, but only one author name value can be entered.
420
 
421
- <h4>Category Parameters</h4>
422
-
423
- The Category parameters search in the WordPress core "Categories" taxonomy. Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
424
-
425
- <h4>Tag Parameters</h4>
426
-
427
- The Tag parameters search in the WordPress core "Tags" taxonomy. Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
428
 
429
- Note that the "tag_id" parameter requires exactly one tag ID; multiple IDs are not allowed. You can use the "tag__in" parameter to query for multiple values.
430
 
431
  <h4>Taxonomy Parameters, "tax_operator"</h4>
432
 
433
- The `[mla_gallery]` shortcode supports the simple "{tax} (string)" values (deprecated as of WordPress version 3.1) as well as the more powerful "tax_query" value.
434
 
435
- For simple queries, enter the taxonomy name and the term(s) that must be matched, e.g.:
436
 
437
- * `[mla_gallery attachment_category='separate-category,another-category']`
438
 
439
- Note that you must use the name/slug strings for taxonomy and terms, not the "title" strings. If you are using the "Att. Tag" taxonomy built in to MLA then your shortcode should be something like:
440
-
441
- * `[mla_gallery attachment_tag=artisan post_parent=all]`
442
-
443
- In this example, "attachment_tag" is the WordPress taxonomy name/slug for the taxonomy. If you're using "Att. Category", the slug would be "attachment_category".
444
-
445
- The default behavior of the simple taxonomy query will match any of the terms in the list. MLA enhances the simple taxonomy query form by providing an additional parameter, "tax_operator", which can be "IN", "NOT IN" or "AND". If you specify a "tax_operator", MLA will convert your query to the more powerful "tax_query" form, searching on the "slug" field and using the operator you specify. For example, a query for two terms in which <strong>both</strong> terms must match would be coded as:
446
 
447
- * `[mla_gallery attachment_category='separate-category,another-category' tax_operator=AND]`
448
 
449
- More complex queries can be specified by using "tax_query", e.g.:
450
 
451
- * `[mla_gallery tax_query="array(array('taxonomy' => 'attachment_tag','field' => 'slug','terms' => 'artisan'))"]`
452
- * `[mla_gallery tax_query="array(array('taxonomy' => 'attachment_category','field' => 'id','terms' => array(11, 12)))" post_parent=current post_mime_type='']`
453
 
454
- The first example is equivalent to the simple query "attachment_tag=artisan". The second example matches items of all MIME types, attached to the current post, having an attachment_category ID of 11 or 12.
455
 
456
- When embedding the shortcode in the body of a post, be very careful when coding the tax_query; it must be a valid PHP array specification. In particular, code the query on one line; splitting it across lines can insert HTML &#8249;br&#8250; tags and corrupt your query.
457
 
458
- Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
 
459
 
460
- <h4>Post Type, Post Status and Post MIME Type</h4>
461
 
462
- For compatibility with the WordPress `[gallery]` shortcode, these parameters default to "post_type=attachment", "post_status=inherit" and "post_mime_type=image". You can override the defaults to, for example, display items in the trash ("post_status=trash") or PDF documents ("post_mime_type=application/pdf") or all MIME types ("post_mime_type=all"). I'm not sure why you'd want to override "post_type", but you are welcome to experiment and let me know what you find.
463
 
464
- <h4>Pagination Parameters</h4>
465
 
466
- The `[mla_gallery]` shortcode supplies "nopaging=true" as a default parameter. If you are working with a template that supports pagination you can replace this with specific values for "posts_per_page", "posts_per_archive_page", "paged" and/or "offset" . You can also pass "paged=current" to suppress the "nopaging" default; "current" will be replaced by the appropriate value (get_query_var('paged')).
467
 
468
- <h4>Time Parameters</h4>
469
 
470
- Support for time parameters is not included in the current version. I may add it later - let me know if you need it.
471
 
472
- <h4>Custom Field Parameters</h4>
473
 
474
- The `[mla_gallery]` shortcode supports the simple custom field parameters as well as the more powerful "meta_query" parameters made available as of WordPress 3.1.
475
 
476
- When embedding the shortcode in the body of a post, be very careful when coding the meta_query; it must be a valid PHP array specification. In particular, code the query on one line; splitting it across lines can insert HTML <br> tags and corrupt your query.
477
 
478
- Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
479
 
480
- <h4>Search Keywords</h4>
481
-
482
- The search parameter ("s=keyword") will perform a keyword search. A cursory inspection of the code in /wp-includes/query.php reveals that the search includes the "post_title" and "post_content" (Description) fields but not the "post_excerpt" (Caption) field. An SQL "LIKE" clause is composed and added to the search criteria. I haven't done much testing of this parameter.
483
-
484
- <h4>Debugging Output</h4>
485
-
486
- 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.
487
 
488
  == Support for &ldquo;Photonic Gallery for Flickr, Picasa, SmugMug, 500px and Instagram&rdquo; ==
489
 
@@ -497,7 +460,7 @@ The Style and Markup templates give you great flexibility for the content and fo
497
 
498
  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.
499
 
500
- The MLA Gallery tab on the Settings page lets you add, change and delete custom templates. The default tempates are also displayed on this tab for easy reference.
501
 
502
  In a template, substitution parameters are surrounded by opening ('[+') and closing ('+]') tags to separate them from the template text; see the default templates for many examples.
503
 
@@ -515,30 +478,32 @@ A complete list of the <strong>35 attachment-specific substitution parameters</s
515
 
516
  <h3>Field-level Markup Substitution Parameters</h3>
517
 
518
- Field-level substitution parameters let you access query arguments, custom fields, taxonomy terms, IPTC metadata and EXIF metadata for display in an MLA gallery. For these parameters, the value you code within the surrounding the ('[+') and ('+]') delimiters has three parts; the prefix, the field name and the optional ",single" indicator.
519
 
520
  The <strong>prefix</strong> defines which type of field-level data you are accessing. It must immediately follow the opening ('[+') delimiter and end with a colon (':'). There can be no spaces in this part of the parameter.
521
 
522
- The <strong>field name</strong> defines which field-level data element you are accessing. It must immediately follow the colon (':'). There can be no spaces between the colon and the field name. Spaces are allowed within the field name to accomodate custom field names that contain them.
523
 
524
  The optional <strong>",single" indicator</strong> defines how to handle fields with multiple values. It must immediately follow the field name and end with the closing delimiter ('+]'). There can be no spaces in this part of the parameter. If this part of the parameter is present, only the first value of the field will be returned. Use this indicator to limit the data returned for a custom field, taxonomy or metadata field that can have many values.
525
 
526
- There are five prefix values for field-level data. Prefix values must be coded as shown; all lowercase letters.
 
 
527
 
528
  * `query`: The parameters defined in the `[mla_gallery]` shortcode. For example, if your shortcode is `[mla gallery attachment_tag=my-tag div-class=some_class]` you can access the parameters as `[+query:attachment_tag+]` and `[+query:div-class+]` respectively. Only the parameters actually coded in the shortcode are accessible; default values for parameters not actually coded are not available. You can define your own parameters, e.g., `div-class`; they will be accessible as field-level data but will otherwise be ignored.
529
  * `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.
530
  * `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".
531
 
 
 
532
  * `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>.
533
 
534
  * `exif`: The EXIF (EXchangeable Image File) metadata, if any, embedded in a JPEG DCT or TIFF Rev 6.0 image file.
535
  Though the specification is not currently maintained by any industry or standards organization, almost all camera manufacturers use it. It is also supported by many image editing programs such as Adobe PhotoShop.
536
  For this category, you can code any of the field names embedded in the image by the camera or editing software. The is no official list of standard field names, so you just have to know the names your camera and software use; field names are case-sensitive. You can find more information in the <a href="http://en.wikipedia.org/wiki/Exchangeable_image_file_format" title="IPTC-NAA Information Interchange Model Version No. 4.1 specification" target="_blank">Exchangeable image file format</a> article on Wikipedia. You can find External Links to EXIF standards and tag listings at the end of the Wikipedia article.
537
- <br />&nbsp;<br />
538
- MLA uses a standard PHP function, <a href="http://php.net/manual/en/function.exif-read-data.php" title="PHP Manual page for exif_read_data" target="_blank">exif_read_data</a>, to extract EXIF data from images. The function returns three arrays in addition to the raw EXIF data; COMPUTED, THUMBNAIL and COMMENT. You can access the array elements by prefacing the element you want with the array name. For example, the user comment text is available as "COMPUTED.UserComment" and "COMPUTED.UserCommentEncoding". You can also get "COMPUTED.Copyright" and its two parts (if present), "COMPUTED.Copyright.Photographer" and "COMPUTED.Copyright.Editor". The THUMBNAIL and COMMENT arrays work in a similar fashion.
539
- <br />&nbsp;<br />
540
- Two special exif "pseudo-values" are available; <strong>ALL_IPTC</strong> and <strong>ALL_EXIF</strong>. These return a string representation of all IPTC or EXIF data respectively. You can use these pseudo-values to examine the metadata in an image, find field names and see what values are embedded in the image.
541
-
542
  <h3>A Table-based Template Example</h3>
543
  <p>
544
  Here's a small example that shows a gallery using table markup. The Item markup section shows how to use the "terms", "custom", "iptc" and "exif" substitution parameters.
@@ -620,9 +585,9 @@ Several of the data elements are sourced from the WordPress "image_meta" array.
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
- A complete list of the <strong>32 data source elements</strong> is on the plugin's Settings page.
626
 
627
  ==IPTC &amp; EXIF Processing Options==
628
 
@@ -634,7 +599,7 @@ The Media Library Assistant has powerful tools for copying image metadata to:
634
  * taxonomy terms, e.g., in categories, tags or custom taxonomies
635
  * WordPress custom fields
636
 
637
- 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.
638
 
639
  <h4>Mapping tables</h4>
640
 
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.1
7
+ Stable tag: 1.30
8
  License: GPLv2 or later
9
  License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
 
93
 
94
  = The Media/Assistant submenu seems sluggish; is there anything I can do to make it faster? =
95
 
96
+ Some of the MLA features such as where-used reporting and ALT Text sorting/searching require a lot of database processing. 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.
97
 
98
  = Are other language versions available? =
99
 
101
 
102
  = What's in the "phpDocs" directory and do I need it? =
103
 
104
+ All of the MLA source code has been annotated with "DocBlocks", a special type of comment used by phpDocumentor to generate API documentation. If you'd like a deeper understanding of the code, click on "index.html" in the phpDocs directory and have a look. Note that these pages require JavaScript for much of their functionality.
105
 
106
  == Screenshots ==
107
 
117
 
118
  == Changelog ==
119
 
120
+ = 1.30 =
121
+ * New: **ALL** metadata fields, including the **new fields extracted from audio and video files in WordPress 3.6**, can be mapped to custom fields and added as sortable columns to the Media/Assistant submenu table.
122
+ * New: For `[mla_gallery]`, field-level substitution parameters now include **ALL** metadata fields, including the **new fields extracted from audio and video files in WordPress 3.6**.
123
+ * New: Use `[mla_gallery]` to determine which items are included in a gallery, then pass them on to another gallery-generating shortcode for formatting and display. The new `mla_alt_shortcode` and `mla_alt_ids_name` parameters let you use any gallery-generating shortcode that accepts a list of attachment ID values. For example, you can use the WordPress.com Jetpack Carousel and Tiled Galleries to create elegant mosaic layouts and immersive full-screen experiences. The "Other Notes" section here or the Documentation tab on the Settings/Media Library Assistant page of the plugin have details.
124
+ * New: Improved User Interface for the "IPTC/EXIF" tab on the Settings/Media Library Assistant screen. The "Custom Fields" section of this screen is enhanced to match the "Custom Fields" Settings tab.
125
+ * Fix: Media Manager enhanced Search Media box more reliably re-queries the server when search parameters change.
126
+ * Fix: For `[mla_gallery]`, `posts_where` and `posts_orderby` filters now have a very low priority to run later and avoid conflicts with other plugins, e.g, "Post Types Order".
127
+ * Fix: For `[mla_gallery]`, field-level "query" substitution parameters are now processed in all custom style and markup template parts.
128
+ * Fix: For `[mla_gallery]`, empty style and markup template parts are now allowed; empty "Open:" markup will not cause reversion to default template.
129
+ * Fix: Default `mla_style` settings now include "-- none --", to suppress generation of default inline CSS styles for the `[mla_gallery]` shortcodes.
130
+ * Fix: Improved handling and display of Custom fields with multiple values.
131
+ * Fix: For `[mla_gallery]`, `link=post` (added in WordPress 3.5) is now accepted to link gallery items to the corresponding attachment page. The `link=permalink` value continues to work as well.
132
+ * Fix: Filtering the Media/Media Library Assistant table display on custom field values with leading spaces (i.e., format=commas) now works properly.
133
+
134
  = 1.20 =
135
  * New: The long-awaited enhancements to the WordPress (3.5+) Media Manager (Add Media, etc.). Filter your attachments by additional MIME types, month and year uploaded and/or taxonomy terms. Keyword search can be extended to the name/slug, ALT text and caption fields. The connector between search terms can be "and" or "or". Search by attachment ID or parent ID is supported. Enable/disable any or all enhancements on the Settings page.
136
  * New: In the `[mla_gallery]` shortcode, enhanced parameters for sorting the gallery results. For example, `orderby=caption` and `orderby=description` are now available to sort gallery results by the Caption (post_excerpt) and Description (post_content) fields. You can also sort on multiple fields, e.g., `orderby="author, date DESC"`, with field-level ASC/DESC control. The "Other Notes" section here or the Documentation tab on the Settings/Media Library Assistant page of the plugin have details.
147
  * New: In the `[mla_gallery]` shortcode, a new `mla_target` parameter allows you to specify the HTML `target` attribute in the gallery item links, e.g., `mla_target="_blank"` will open the items in a new window or tab.
148
  * New: In the `[mla_gallery]` shortcode, a new `tax_operator` parameter allows you to specify "AND" or "NOT IN" operators in the simple `tax_name=term(s)` version of taxonomy queries. See the Settings/Media Library Assistant Documentation page for details.
149
  * New: In the `[mla_gallery]` shortcode, `tax_query` corruption caused by the Visual mode of the post/page editor is now cleaned up before the query is submitted; Line breaks, HTML markup and escape sequences added by the Visual editor are removed.
150
+ * Fix: IPTC/EXIF values containing an array, e.g., "2#025 keywords", will be converted to a comma-separated string before assignment to Standard fields or Custom fields.
151
  * Fix: Custom Field Mapping will always ignore rules with Data Source set to "-- None (select a value) --".
152
  * Fix: In the `[mla_gallery]` shortcode, the `orderby` parameter will override the explicit order in the `ids` parameter.
153
  * Fix: In the `[mla_gallery]` shortcode, the `ids` and `include` parameters no longer require `post_parent=all` to match items not attached to the current post/page.
208
  * Fix: Quick edit support of WordPress standard Categories taxonomy fixed.
209
 
210
  = 0.80 =
211
+ * New: MLA Gallery Style and Markup Templates, for control over CSS styles, HTML markup and data content of `[mla_gallery]` shortcode output.
212
  * New: The `[mla_gallery]` "mla_link_text", "mla_rollover_text" and "mla_caption", parameters allow easy customization of gallery display.
213
  * New: The `[mla_gallery]` "link" parameter now accepts size values, e.g., "medium", to generate a link to image sizes other than "full".
214
  * New: The `[mla_gallery]` "mla_debug" parameter provides debugging information for query parameters.
291
 
292
  == Upgrade Notice ==
293
 
294
+ = 1.30 =
295
+ New "mla_alt_shortcode" parameter combines [mla_gallery] with other gallery display shortcodes, e.g., Jetpack Carousel and Tiled Mosaic. Support for new 3.6 audio/video metadata. One other enhancement, eight fixes.
296
 
297
  == Other Notes ==
298
 
305
  * Custom Field Processing Options
306
  * IPTC &amp; EXIF Processing Options
307
 
308
+ **NOTE:** More complete documentation is included on the plugin's Settings page and the drop-down "Help" content in the admin screens.
309
+
310
  == Acknowledgements ==
311
 
312
  I have used and learned much from the following books (among many):
324
  * Support for all post_mime_type values, not just images.
325
  * Media Library items need not be "attached" to the post. You can build a gallery with any combination of items in the Library using taxonomy terms, custom fields and more.
326
  * Control over the styles, markup and content of each gallery using the Style and Markup Templates documented below.
327
+ * Combine [mla_gallery] data selection with other popular gallery-generating plugins to get the best of both.
328
 
329
  All of the options/parameters documented for the `[gallery]` shortcode are supported by the `[mla_gallery]` shortcode; you can find them in the WordPress Codex. Most of the parameters documented for the WP_Query class are also supported; see the WordPress Codex. Because the `[mla_gallery]` shortcode is designed to work with Media Library items, there are some parameter differences and extensions; these are documented below.
330
 
331
  <h4>Gallery Display Style</h4>
332
 
333
+ Two parameters provide a way to apply custom style and markup templates to your `[mla_gallery]` display: These parameters replace the default style and/or markup templates with templates you define on the "MLA Gallery" tab of the Settings page.
 
 
 
 
 
 
 
 
334
 
335
+ * mla_style
336
+ * mla_markup
337
 
338
+ Three parameters provide control over the placement, size and spacing of gallery items without requiring the use of custom Style templates.
339
 
340
+ * mla_float
341
+ * mla_margin
342
+ * mla_itemwidth
343
 
344
  <h4>Gallery Display Content</h4>
345
 
346
+ Five parameters provide an easy way to control the contents of gallery items without requiring the use of custom Markup templates.
 
 
 
 
 
 
 
 
 
 
 
 
347
 
348
+ * mla_link_href
349
+ * mla_link_text
350
+ * mla_rollover_text
351
+ * mla_caption
352
+ * mla_target
353
 
354
  <h4>Google File Viewer Support</h4>
355
 
356
+ Four parameters provide an easy way to generate thumbnail images for the non-image file types.
 
 
 
 
357
 
358
+ * mla_viewer
359
+ * mla_viewer_extensions
360
+ * mla_viewer_page
361
+ * mla_viewer_width
 
362
 
363
  <h4>Order, Orderby</h4>
364
 
365
+ You can sort the gallery by one or more of these values:
366
+
367
+ * none
368
+ * ID
369
+ * author
370
+ * date
371
+ * description, content
372
+ * title
373
+ * caption, excerpt
374
+ * slug, name
375
+ * modified
376
+ * parent
377
+ * menu_order
378
+ * mime_type
379
+ * comment_count
380
+ * rand
381
+ * &lt;keyname&gt;, meta_value, meta_value_num
382
+ * post__in
383
 
384
+ You can sort on more than one value, e.g., `orderby="author, date DESC"` and you can specify ASC/DESC on a value by value basis.
 
 
385
 
386
  <h4>Size</h4>
387
 
 
 
388
  The `[mla_gallery]` shortcode supports an additional Size value, "icon", which shows a 60x60 pixel thumbnail for image items and an appropriate icon for non-image items such as PDF or text files.
389
 
390
  <h4>Link</h4>
391
 
 
 
392
  For image attachments you can also specify the size of the image file you want to link to. Valid values include "thumbnail", "medium", "large" and any additional image size that was registered with add_image_size(). If the specified size is not available or if the attachment is not an image, the link will go directly to the attachment file.
393
 
 
 
 
 
394
  <h4>Post ID, "ids", Post Parent</h4>
395
 
396
+ You can use the "post_parent" to override the default behavior. If you set "post_parent" to "current", only the items attached to the current post are displayed. If you set "post_parent" to "all", the query will not have a post ID or post_parent parameter. If you set "post_parent" to "any", only the attached items are displayed. If you set "post_parent" to "none", only the unattached items are displayed.
 
 
 
 
 
 
397
 
398
  <h4>Author, Author Name</h4>
399
 
400
  You can query by author's id or the "user_nicename" value (not the "display_name" value). Multiple author ID values are allowed, but only one author name value can be entered.
401
 
402
+ <h4>Category and Tag Parameters</h4>
 
 
 
 
 
 
403
 
404
+ The Category parameters search in the WordPress core "Categories" taxonomy. The Tag parameters search in the WordPress core "Tags" taxonomy.
405
 
406
  <h4>Taxonomy Parameters, "tax_operator"</h4>
407
 
408
+ The `[mla_gallery]` shortcode supports the simple "{tax} (string)" values (deprecated as of WordPress version 3.1) as well as the more powerful "tax_query" value. For simple queries, enter the taxonomy name and the term(s) that must be matched. MLA enhances the simple taxonomy query form by providing an additional parameter, "tax_operator", which can be "IN", "NOT IN" or "AND". More complex queries can be specified by using "tax_query".
409
 
410
+ <h4>Post MIME Type</h4>
411
 
412
+ You can override the default to, for example, display PDF documents ("post_mime_type=application/pdf") or all MIME types ("post_mime_type=all").
413
 
414
+ <h4>Pagination Parameters</h4>
 
 
 
 
 
 
415
 
416
+ If you are working with a template that supports pagination you can use specific values for "posts_per_page", "posts_per_archive_page", "paged" and/or "offset" .
417
 
418
+ <h4>Custom Field Parameters</h4>
419
 
420
+ The `[mla_gallery]` shortcode supports the simple custom field parameters as well as the more powerful "meta_query" parameters made available as of WordPress 3.1.
 
421
 
422
+ == Support for Other Gallery-generating Shortcodes ==
423
 
424
+ The [mla_gallery] shortcode can be used in combination with other gallery-generating shortcodes to give you the data selection power of [mla_gallery] and the formatting/display power of popular alternatives such as the WordPress.com Jetpack Carousel and Tiled Galleries modules. Any shortcode that accepts "ids=" or a similar parameter listing the attachment ID values for the gallery can be used. Two parameters implement this feature:
425
 
426
+ * `mla_alt_shortcode`: the name of the shortcode to be called for gallery format and display
427
+ * `mla_alt_ids_name`: (optional, default "ids") the name of the parameter used to pass a list of attachment ID values
428
 
429
+ For example, if you want to select images using the MLA Att. Category taxonomy but want to display a "Tiled Mosaic" gallery, you can code:
430
 
431
+ `[mla_gallery attachment_category=vegetable tax_operator="NOT IN" mla_alt_shortcode=gallery type="rectangular" mla_alt_ids_name=include]`
432
 
433
+ This example selects all the images that are "NOT IN" the Att. Category "vegetable". The selected images are passed to the [gallery] shortcode in an "include" parameter, along with the "type=rectangular" parameter. The result is as if you had coded:
434
 
435
+ `[gallery include="1,2,3" type="rectangular"]`
436
 
437
+ In the above example, the "mla_alt_ids_name=include" parameter isn't really necessary, since the [gallery] shortcode accepts the "ids" parameter. It was included in the example just to show how the "mla_alt_ids_name" might be used for some other shortcode that requires a different name for the parameter.
438
 
439
+ You can pass any parameters you need through the [mla_gallery] shortcode and on to the alternate shortcode you're using. Here's another example, using the Photonic Gallery plugin:
440
 
441
+ `[mla_gallery attachment_tag=fauna orderby=rand mla_alt_shortcode=gallery type=default style=strip-below slideshow_height=320 slide_size=medium]`
442
 
443
+ Here, [mla_gallery] selects the images with an Att. Tag of "fauna" and sorts them in a random order. It then calls on the [gallery] shortcode (which Photonic also uses):
444
 
445
+ `[gallery ids="3,1,4,2,7" type=default style=strip-below slideshow_height=320 slide_size=medium]`
446
 
447
+ Photonic recognizes the "type=default" parameter and takes over, using the other three parameters to format its results. This example is a less convenient but more flexible alternative to the native Photonic support built-in to [mla_gallery] (see next section).
448
 
449
+ <strong>NOTE:</strong> When you use "mla_alt_shortcode" to pass format/display responsibility off to another shortcode you will lose the [mla_gallery] Gallery Display Style (e.g. "mla_float") and Gallery Display Content (e.g. "mla_caption") parameters. There is no reliable way for [mla_gallery] to pass this information on to the other shortcode you've specified.
 
 
 
 
 
 
450
 
451
  == Support for &ldquo;Photonic Gallery for Flickr, Picasa, SmugMug, 500px and Instagram&rdquo; ==
452
 
460
 
461
  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.
462
 
463
+ The MLA Gallery tab on the Settings page lets you add, change and delete custom templates. The default templates are also displayed on this tab for easy reference.
464
 
465
  In a template, substitution parameters are surrounded by opening ('[+') and closing ('+]') tags to separate them from the template text; see the default templates for many examples.
466
 
478
 
479
  <h3>Field-level Markup Substitution Parameters</h3>
480
 
481
+ Field-level substitution parameters let you access query arguments, custom fields, taxonomy terms, and attachment metadata for display in an MLA gallery. For these parameters, the value you code within the surrounding the ('[+') and ('+]') delimiters has three parts; the prefix, the field name and the optional ",single" indicator.
482
 
483
  The <strong>prefix</strong> defines which type of field-level data you are accessing. It must immediately follow the opening ('[+') delimiter and end with a colon (':'). There can be no spaces in this part of the parameter.
484
 
485
+ The <strong>field name</strong> defines which field-level data element you are accessing. It must immediately follow the colon (':'). There can be no spaces between the colon and the field name. Spaces are allowed within the field name to accommodate custom field names that contain them.
486
 
487
  The optional <strong>",single" indicator</strong> defines how to handle fields with multiple values. It must immediately follow the field name and end with the closing delimiter ('+]'). There can be no spaces in this part of the parameter. If this part of the parameter is present, only the first value of the field will be returned. Use this indicator to limit the data returned for a custom field, taxonomy or metadata field that can have many values.
488
 
489
+ The optional <strong>",export" indicator</strong> for display of array fields with multiple values. It must immediately follow the field name and end with the closing delimiter ('+]'). There can be no spaces in this part of the parameter. If this part of the parameter is present, the PHP `var_export` function is used to return a string representation of all the elements in an array field.
490
+
491
+ There are six prefix values for field-level data. Prefix values must be coded as shown; all lowercase letters.
492
 
493
  * `query`: The parameters defined in the `[mla_gallery]` shortcode. For example, if your shortcode is `[mla gallery attachment_tag=my-tag div-class=some_class]` you can access the parameters as `[+query:attachment_tag+]` and `[+query:div-class+]` respectively. Only the parameters actually coded in the shortcode are accessible; default values for parameters not actually coded are not available. You can define your own parameters, e.g., `div-class`; they will be accessible as field-level data but will otherwise be ignored.
494
  * `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.
495
  * `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".
496
 
497
+ * `meta`: The WordPress "attachment metadata", if any, embedded in the image/audio/video file. For this category, you can code any of the field names embedded in the `_wp_attachment_metadata` array. The "Attachment Metadata" display in the Media/Edit Media screen will show you the names and values of these fields. Note that the fields available differ among image, audio and video attachments.
498
+
499
  * `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>.
500
 
501
  * `exif`: The EXIF (EXchangeable Image File) metadata, if any, embedded in a JPEG DCT or TIFF Rev 6.0 image file.
502
  Though the specification is not currently maintained by any industry or standards organization, almost all camera manufacturers use it. It is also supported by many image editing programs such as Adobe PhotoShop.
503
  For this category, you can code any of the field names embedded in the image by the camera or editing software. The is no official list of standard field names, so you just have to know the names your camera and software use; field names are case-sensitive. You can find more information in the <a href="http://en.wikipedia.org/wiki/Exchangeable_image_file_format" title="IPTC-NAA Information Interchange Model Version No. 4.1 specification" target="_blank">Exchangeable image file format</a> article on Wikipedia. You can find External Links to EXIF standards and tag listings at the end of the Wikipedia article.
504
+
505
+ Two special exif "pseudo-values" are available; <strong>ALL_IPTC</strong> and <strong>ALL_EXIF</strong>. These return a string representation of all IPTC or EXIF data respectively. You can use these pseudo-values to examine the metadata in an image, find field names and see what values are embedded in the image.
506
+
 
 
507
  <h3>A Table-based Template Example</h3>
508
  <p>
509
  Here's a small example that shows a gallery using table markup. The Item markup section shows how to use the "terms", "custom", "iptc" and "exif" substitution parameters.
585
 
586
  <h4>Data sources for custom field mapping</h4>
587
 
588
+ <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 strings and padded on the left with spaces if you use the "commas" format. This padding makes them sort more sensibly.
589
 
590
+ A complete list of the <strong>32 data source elements</strong> is on the plugin's Settings page. In addition, you can map any of the fields found in the attachment's WordPress metadata array to a custom field.
591
 
592
  ==IPTC &amp; EXIF Processing Options==
593
 
599
  * taxonomy terms, e.g., in categories, tags or custom taxonomies
600
  * WordPress custom fields
601
 
602
+ You can define the rules for mapping metadata on the "IPTC/EXIF" tab of the Settings page. You can choose to automatically apply the rules when new media are added to the Library (or not). You can click the "Map IPTC/EXIF metadata" button on the Edit Media/Edit Single Item screen or in the bulk edit area to selectively apply the rules to one or more images. You can click the "Map All Attachments Now" to apply the rules to <strong>all of the images in your library</strong> at one time.
603
 
604
  <h4>Mapping tables</h4>
605
 
tpls/admin-display-settings-page.tpl CHANGED
@@ -235,8 +235,9 @@ You can find more information about all of these topics on the <a href="http:/wp
235
  <input name="custom-field-options-map" type="submit" class="button-secondary" style="margin-left: 20px" value="Map All Rules, All Attachments Now" />
236
  </p>
237
  <p>
238
- Click Save Changes to update the "Enable custom field mapping..." checkbox and/or all rule changes and additions at once.<br />
239
  Click Map All Rules, All Attachments Now to apply all the rules at once (rule changes will be applied but not saved).
 
240
  [+_wpnonce+]
241
  [+_wp_http_referer+]
242
  </form>
@@ -244,28 +245,34 @@ You can find more information about all of these topics on the <a href="http:/wp
244
  <!-- template="iptc-exif-tab" -->
245
  <h3>IPTC &amp; EXIF Processing Options</h3>
246
  <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>
247
- <p>If you click any of the three "Map All Attachments Now" buttons, the rules currently displayed in that category will be immediately applied to <strong>all</strong> of the attachments in your site. Rule changes are <strong>not</strong> saved when you click any of these buttons.<strong>THERE IS NO UNDO FOR THESE ACTIONS!</strong></p>
 
 
 
248
  <p>
249
  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_iptc_exif_mapping" title="IPTC &amp; EXIF Processing Options documentation">Documentation tab</a>.
250
  </p>
251
  <form method="post" class="mla-display-settings-page" id="mla-display-settings-iptc-exif-tab">
252
  &nbsp;<br />
253
  [+options_list+]
254
- <h4>Standard field mapping <input name="iptc-exif-options-process-standard" type="submit" class="button-secondary" style="margin-left: 20px" value="Map All Attachments Now" /></h4>
255
  <table class="optiontable">
256
  [+standard_options_list+]
257
  </table>
258
- <h4>Taxonomy term mapping <input name="iptc-exif-options-process-taxonomy" type="submit" class="button-secondary" style="margin-left: 10px" value="Map All Attachments Now" /></h4>
259
  <table class="optiontable">
260
  [+taxonomy_options_list+]
261
  </table>
262
- <h4>Custom field mapping <input name="iptc-exif-options-process-custom" type="submit" class="button-secondary" style="margin-left: 25px" value="Map All Attachments Now" /></h4>
263
  <table class="optiontable">
264
  [+custom_options_list+]
265
  </table>
266
  <p class="submit" style="padding-bottom: 0;">
267
  <input name="iptc-exif-options-save" type="submit" class="button-primary" value="Save Changes" />
268
  </p>
 
 
 
269
  [+_wpnonce+]
270
  [+_wp_http_referer+]
271
  </form>
235
  <input name="custom-field-options-map" type="submit" class="button-secondary" style="margin-left: 20px" value="Map All Rules, All Attachments Now" />
236
  </p>
237
  <p>
238
+ Click <strong>Save Changes</strong> to update the "Enable custom field mapping..." checkbox and/or all rule changes and additions at once. <strong>No rule mapping will be performed.</strong><br />
239
  Click Map All Rules, All Attachments Now to apply all the rules at once (rule changes will be applied but not saved).
240
+ </p>
241
  [+_wpnonce+]
242
  [+_wp_http_referer+]
243
  </form>
245
  <!-- template="iptc-exif-tab" -->
246
  <h3>IPTC &amp; EXIF Processing Options</h3>
247
  <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>
248
+ <p>If you click any of the three "Map All Attachments, ... Now" buttons, the rules currently displayed in that category will be immediately applied to <strong>all</strong> of the attachments in your site. Rule changes are <strong>not</strong> saved when you click any of these buttons.<strong>THERE IS NO UNDO FOR THESE ACTIONS!</strong></p>
249
+ <p>
250
+ If you just want to add a custom field to the Media/Assistant submenu, the quick edit area and/or the bulk edit area go to the "Custom Fields" tab and follow the instructions there.
251
+ </p>
252
  <p>
253
  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_iptc_exif_mapping" title="IPTC &amp; EXIF Processing Options documentation">Documentation tab</a>.
254
  </p>
255
  <form method="post" class="mla-display-settings-page" id="mla-display-settings-iptc-exif-tab">
256
  &nbsp;<br />
257
  [+options_list+]
258
+ <h4>Standard field mapping <input name="iptc-exif-options-process-standard" type="submit" class="button-secondary" style="margin-left: 20px" value="Map All Attachments, Standard Fields Now" /></h4>
259
  <table class="optiontable">
260
  [+standard_options_list+]
261
  </table>
262
+ <h4>Taxonomy term mapping <input name="iptc-exif-options-process-taxonomy" type="submit" class="button-secondary" style="margin-left: 10px" value="Map All Attachments, Taxonomy Terms Now" /></h4>
263
  <table class="optiontable">
264
  [+taxonomy_options_list+]
265
  </table>
266
+ <h4>Custom field mapping <input name="iptc-exif-options-process-custom" type="submit" class="button-secondary" style="margin-left: 25px" value="Map All Attachments, Custom Fields Now" /></h4>
267
  <table class="optiontable">
268
  [+custom_options_list+]
269
  </table>
270
  <p class="submit" style="padding-bottom: 0;">
271
  <input name="iptc-exif-options-save" type="submit" class="button-primary" value="Save Changes" />
272
  </p>
273
+ <p>
274
+ Click <strong>Save Changes</strong> to update the "Enable IPTC/EXIF mapping..." checkbox and/or all rule changes and additions at once. <strong>No rule mapping will be performed.</strong><br />
275
+ </p>
276
  [+_wpnonce+]
277
  [+_wp_http_referer+]
278
  </form>
tpls/documentation-settings-tab.tpl CHANGED
@@ -6,6 +6,9 @@
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>
@@ -58,6 +61,8 @@ The [mla_gallery] shortcode is used in a post, page or custom post type to add a
58
  <li>Support for all post_mime_type values, not just images.</li>
59
  <li>Media Library items need not be "attached" to the post. You can build a gallery with any combination of items in the Library using taxonomy terms, custom fields and more.</li>
60
  <li>Control over the styles, markup and content of each gallery using the Style and Markup Templates documented below.</li>
 
 
61
  </ul>
62
  <p>
63
  All of the options/parameters documented for the [gallery] shortcode are supported by the [mla_gallery] shortcode; you can find them in the WordPress Codex. Most of the parameters documented for the WP_Query class are also supported; see the WordPress Codex. Because the [mla_gallery] shortcode is designed to work with Media Library items, there are some parameter differences and extensions; these are documented below.
@@ -197,6 +202,10 @@ The Orderby parameter specifies which database field(s) are used to sort the gal
197
  <td>Order by last modified date.</td>
198
  </tr>
199
  <tr>
 
 
 
 
200
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">menu_order</td>
201
  <td>Order by page order.</td>
202
  </tr>
@@ -235,7 +244,7 @@ The [mla_gallery] shortcode supports an additional Size value, "icon", which sho
235
  </p>
236
  <h4>Link</h4>
237
  <p>
238
- The Link parameter specifies the target for the link from the gallery to the attachment. The default value, "permalink", links to the attachment's media page. The "file" and "full" values link directly to the attachment file.
239
  </p>
240
  <p>
241
  For image attachments you can also specify the size of the image file you want to link to. Valid values include "thumbnail", "medium", "large" and any additional image size that was registered with add_image_size(). If the specified size is not available or if the attachment is not an image, the link will go directly to the attachment file.
@@ -277,7 +286,7 @@ Note that the "tag_id" parameter requires exactly one tag ID; multiple IDs are n
277
  </p>
278
  <h4>Taxonomy Parameters, "tax_operator"</h4>
279
  <p>
280
- The [mla_gallery] shortcode supports the simple "{tax} (string)" values (deprecated as of WordPress version 3.1) as well as the more powerful "<a href="https://codex.wordpress.org/Class_Reference/WP_Query#Taxonomy_Parameters" title="WordPress Codex Documentaton for tax_query" target="_blank">tax_query</a>" value.
281
  </p>
282
  <p>
283
  For simple queries, enter the taxonomy name and the term(s) that must be matched, e.g.:
@@ -301,7 +310,7 @@ The default behavior of the simple taxonomy query will match any of the terms in
301
  <li>[mla_gallery attachment_category='separate-category,another-category' tax_operator=AND]</li>
302
  </ul>
303
  <p>
304
- More complex queries can be specified by using <a href="https://codex.wordpress.org/Class_Reference/WP_Query#Taxonomy_Parameters" title="WordPress Codex Documentaton for tax_query" target="_blank">WP_Query's "tax_query"</a>, e.g.:
305
  </p>
306
  <ul class="mla_settings">
307
  <li>[mla_gallery tax_query="array(array('taxonomy' => 'attachment_tag','field' => 'slug','terms' => 'artisan'))"]</li>
@@ -346,6 +355,59 @@ The search parameter ("s=keyword") will perform a keyword search. A cursory insp
346
  <p>
347
  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.
348
  </p>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
349
  <a name="photonic_gallery"></a>
350
  &nbsp;
351
  <p>
@@ -368,10 +430,10 @@ You can use the "Photonic" screen of the Insert Media dialog to build the displa
368
  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.
369
  </p>
370
  <p>
371
- 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.
372
  </p>
373
  <p>
374
- The MLA Gallery tab on the Settings page lets you add, change and delete custom templates. The default tempates are also displayed on this tab for easy reference.
375
  </p>
376
  <p>
377
  In a template, substitution parameters are surrounded by opening ('[+') and closing ('+]') delimiters to separate them from the template text; see the default templates for many examples.
@@ -663,19 +725,21 @@ In a template, substitution parameters are surrounded by opening ('[+') and clos
663
  </p>
664
  <h3>Field-level Markup Substitution Parameters</h3>
665
  <p>
666
- Field-level substitution parameters let you access query arguments, custom fields, taxonomy terms, IPTC metadata and EXIF metadata for display in an MLA gallery. For these parameters, the value you code within the surrounding the ('[+') and ('+]') delimiters has three parts; the prefix, the field name and the optional ",single" indicator.
667
  </p>
668
  <p>
669
  The <strong>prefix</strong> defines which type of field-level data you are accessing. It must immediately follow the opening ('[+') delimiter and end with a colon (':'). There can be no spaces in this part of the parameter.
670
  </p>
671
  <p>
672
- The <strong>field name</strong> defines which field-level data element you are accessing. It must immediately follow the colon (':'). There can be no spaces between the colon and the field name. Spaces are allowed within the field name to accomodate custom field names that contain them.
 
 
673
  </p>
674
  <p>
675
- The optional <strong>",single" indicator</strong> defines how to handle fields with multiple values. It must immediately follow the field name and end with the closing delimiter ('+]'). There can be no spaces in this part of the parameter. If this part of the parameter is present, only the first value of the field will be returned. Use this indicator to limit the data returned for a custom field, taxonomy or metadata field that can have many values.
676
  </p>
677
  <p>
678
- There are five prefix values for field-level data. Prefix values must be coded as shown; all lowercase letters.
679
  </p>
680
  <table>
681
  <tr>
@@ -690,6 +754,10 @@ There are five prefix values for field-level data. Prefix values must be coded a
690
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">terms</td>
691
  <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>
692
  </tr>
 
 
 
 
693
  <tr>
694
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">iptc</td>
695
  <td>
@@ -702,7 +770,7 @@ There are five prefix values for field-level data. Prefix values must be coded a
702
  <td>
703
  The EXIF (EXchangeable Image File) metadata, if any, embedded in a JPEG DCT or TIFF Rev 6.0 image file.
704
  Though the specification is not currently maintained by any industry or standards organization, almost all camera manufacturers use it. It is also supported by many image editing programs such as Adobe PhotoShop.
705
- For this category, you can code any of the field names embedded in the image by the camera or editing software. The is no official list of standard field names, so you just have to know the names your camera and software use; field names are case-sensitive.
706
  <br />&nbsp;<br />
707
  You can find more information in the <a href="http://en.wikipedia.org/wiki/Exchangeable_image_file_format" title="IPTC-NAA Information Interchange Model Version No. 4.1 specification" target="_blank">Exchangeable image file format</a> article on Wikipedia. You can find External Links to EXIF standards and tag listings at the end of the Wikipedia article.
708
  <br />&nbsp;<br />
@@ -818,14 +886,18 @@ If you just want to add a custom field to the Media/Assistant submenu, the quick
818
  </p>
819
  <h4>Data sources for custom field mapping</h4>
820
  <p>
821
- <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.
822
  </p>
823
  <table>
824
  <tr>
825
- <td style="padding-right: 10px; vertical-align: top; font-weight:bold">-- None (select a value --</td>
826
  <td>nothing, i.e., no change to existing value (if any). Use this source if you just want to add a custom field to the Media/Assistant submenu and/or the inline edit areas.</td>
827
  </tr>
828
  <tr>
 
 
 
 
829
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">path</td>
830
  <td>path portion of the base_file value, e.g., 2012/11/</td>
831
  </tr>
@@ -956,6 +1028,13 @@ If you just want to add a custom field to the Media/Assistant submenu, the quick
956
  <td>for image types, the value stored in WordPress "image_meta" array</td>
957
  </tr>
958
  </table>
 
 
 
 
 
 
 
959
  <a name="mla_iptc_exif_mapping"></a>
960
  &nbsp;
961
  <p>
@@ -972,7 +1051,7 @@ The Media Library Assistant has powerful tools for copying image metadata to:
972
  <li>taxonomy terms, e.g., in categories, tags or custom taxonomies</li>
973
  <li>WordPress Custom Fields</li>
974
  </ul>
975
- 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.
976
  </p>
977
  <h4>Mapping tables</h4>
978
  <p>
@@ -986,7 +1065,7 @@ The three mapping tables on the IPTC/EXIF tab have the following columns:
986
  </dd>
987
  <dt>EXIF Value</dt>
988
  <dd>The EXIF (EXchangeable Image File) metadata, if any, embedded in a JPEG DCT or TIFF Rev 6.0 image file.
989
- Though the specification is not currently maintained by any industry or standards organization, almost all camera manufacturers use it. For this category, you can code any of the field names embedded in the image by the camera or editing software. The is no official list of standard field names, so you just have to know the names your camera and software use; field names are case-sensitive. You can find more information in the <a href="http://en.wikipedia.org/wiki/Exchangeable_image_file_format" title="Exchangeable image file format Wikipedia article" target="_blank">Exchangeable image file format</a> article on Wikipedia. You can find External Links to EXIF standards and tag listings at the end of the Wikipedia article.
990
  <br />&nbsp;<br />
991
  MLA uses a standard PHP function, <a href="http://php.net/manual/en/function.exif-read-data.php" title="PHP Manual page for exif_read_data" target="_blank">exif_read_data</a>, to extract EXIF data from images. The function returns three arrays in addition to the raw EXIF data; COMPUTED, THUMBNAIL and COMMENT. You can access the array elements by prefacing the element you want with the array name. For example, the user comment text is available as "COMPUTED.UserComment" and "COMPUTED.UserCommentEncoding". You can also get "COMPUTED.Copyright" and its two parts (if present), "COMPUTED.Copyright.Photographer" and "COMPUTED.Copyright.Editor". The THUMBNAIL and COMMENT arrays work in a similar fashion.
992
  <br />&nbsp;<br />
@@ -1103,16 +1182,16 @@ The priority order for mapping the post_content value from non-blank IPTC/EXIF m
1103
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">country-or-primary-location-name</td><td style="padding-right: 10px; vertical-align: top">2#101</td><td style="padding-right: 10px; vertical-align: top">Max 64 characters of publishable country/geographical location name; repeatable</td></tr>
1104
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">original-transmission-reference</td><td style="padding-right: 10px; vertical-align: top">2#103</td><td style="padding-right: 10px; vertical-align: top">Max 32 characters of a code representing the location of original transmission</td></tr>
1105
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">headline</td><td style="padding-right: 10px; vertical-align: top">2#105</td><td style="padding-right: 10px; vertical-align: top">Max 256 Characters of a publishable entry providing a synopsis of the contents of the objectdata</td></tr>
1106
- <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">credit</td><td style="padding-right: 10px; vertical-align: top">2#110</td><td style="padding-right: 10px; vertical-align: top">Max 32 Characters that identifies the provider of the objectdata (Vs the owner/creator)</td></tr>
1107
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">source</td><td style="padding-right: 10px; vertical-align: top">2#115</td><td style="padding-right: 10px; vertical-align: top">Max 32 Characters that identifies the original owner of the intellectual content</td></tr>
1108
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">copyright-notice</td><td style="padding-right: 10px; vertical-align: top">2#116</td><td style="padding-right: 10px; vertical-align: top">Max 128 Characters that contains any necessary copyright notice</td></tr>
1109
- <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">contact</td><td style="padding-right: 10px; vertical-align: top">2#118</td><td style="padding-right: 10px; vertical-align: top">Max 128 characters that identifies the person or organisation which can provide further background information; repeatable</td></tr>
1110
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">caption-or-abstract</td><td style="padding-right: 10px; vertical-align: top">2#120</td><td style="padding-right: 10px; vertical-align: top">Max 2000 Characters of a textual description of the objectdata</td></tr>
1111
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">caption-writer-or-editor</td><td style="padding-right: 10px; vertical-align: top">2#122</td><td style="padding-right: 10px; vertical-align: top">Max 32 Characters that the identifies the person involved in the writing, editing or correcting the objectdata or caption/abstract; repeatable</td></tr>
1112
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">rasterized-caption</td><td style="padding-right: 10px; vertical-align: top">2#125</td><td style="padding-right: 10px; vertical-align: top">7360 binary octets of the rasterized caption - 1 bit per pixel, 460x128-pixel image</td></tr>
1113
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">image-type</td><td style="padding-right: 10px; vertical-align: top">2#130</td><td style="padding-right: 10px; vertical-align: top">2 characters of color composition type and information</td></tr>
1114
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">image-orientation</td><td style="padding-right: 10px; vertical-align: top">2#131</td><td style="padding-right: 10px; vertical-align: top">1 alphabetic character indicating the image area layout - P=portrait, L=landscape, S=square</td></tr>
1115
- <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">language-identifier</td><td style="padding-right: 10px; vertical-align: top">2#135</td><td style="padding-right: 10px; vertical-align: top">2 or 3 aphabetic characters containing the major national language of the object, according to the ISO 639:1988 codes</td></tr>
1116
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">audio-type</td><td style="padding-right: 10px; vertical-align: top">2#150</td><td style="padding-right: 10px; vertical-align: top">2 characters identifying monaural/stereo and exact type of audio content</td></tr>
1117
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">audio-sampling-rate</td><td style="padding-right: 10px; vertical-align: top">2#151</td><td style="padding-right: 10px; vertical-align: top">6 numeric characters representing the audio sampling rate in hertz (Hz)</td></tr>
1118
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">audio-sampling-resolution</td><td style="padding-right: 10px; vertical-align: top">2#152</td><td style="padding-right: 10px; vertical-align: top">2 numeric characters representing the number of bits in each audio sample</td></tr>
6
  <a href="#mla_gallery"><strong>MLA Gallery Shortcode</strong></a>
7
  </li>
8
  <li>
9
+ <a href="#alt_shortcode"><strong>Support for Other Gallery-generating Shortcodes</strong></a>
10
+ </li>
11
+ <li>
12
  <a href="#photonic_gallery"><strong>Support for &#8220;Photonic Gallery&#8221;</strong></a>
13
  </li>
14
  <li>
61
  <li>Support for all post_mime_type values, not just images.</li>
62
  <li>Media Library items need not be "attached" to the post. You can build a gallery with any combination of items in the Library using taxonomy terms, custom fields and more.</li>
63
  <li>Control over the styles, markup and content of each gallery using the Style and Markup Templates documented below.</li>
64
+ <li>You can combine [mla_gallery] data selection with other popular gallery-generating plugins to get the best of both.
65
+ </li>
66
  </ul>
67
  <p>
68
  All of the options/parameters documented for the [gallery] shortcode are supported by the [mla_gallery] shortcode; you can find them in the WordPress Codex. Most of the parameters documented for the WP_Query class are also supported; see the WordPress Codex. Because the [mla_gallery] shortcode is designed to work with Media Library items, there are some parameter differences and extensions; these are documented below.
202
  <td>Order by last modified date.</td>
203
  </tr>
204
  <tr>
205
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">parent</td>
206
+ <td>Order by post/page parent id.</td>
207
+ </tr>
208
+ <tr>
209
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">menu_order</td>
210
  <td>Order by page order.</td>
211
  </tr>
244
  </p>
245
  <h4>Link</h4>
246
  <p>
247
+ The Link parameter specifies the target for the link from the gallery to the attachment. The default value, "permalink" (or its synonym "post"), links to the attachment's media page. The "file" and "full" values link directly to the attachment file.
248
  </p>
249
  <p>
250
  For image attachments you can also specify the size of the image file you want to link to. Valid values include "thumbnail", "medium", "large" and any additional image size that was registered with add_image_size(). If the specified size is not available or if the attachment is not an image, the link will go directly to the attachment file.
286
  </p>
287
  <h4>Taxonomy Parameters, "tax_operator"</h4>
288
  <p>
289
+ The [mla_gallery] shortcode supports the simple "{tax} (string)" values (deprecated as of WordPress version 3.1) as well as the more powerful "<a href="https://codex.wordpress.org/Class_Reference/WP_Query#Taxonomy_Parameters" title="WordPress Codex Documentation for tax_query" target="_blank">tax_query</a>" value.
290
  </p>
291
  <p>
292
  For simple queries, enter the taxonomy name and the term(s) that must be matched, e.g.:
310
  <li>[mla_gallery attachment_category='separate-category,another-category' tax_operator=AND]</li>
311
  </ul>
312
  <p>
313
+ More complex queries can be specified by using <a href="https://codex.wordpress.org/Class_Reference/WP_Query#Taxonomy_Parameters" title="WordPress Codex Documentation for tax_query" target="_blank">WP_Query's "tax_query"</a>, e.g.:
314
  </p>
315
  <ul class="mla_settings">
316
  <li>[mla_gallery tax_query="array(array('taxonomy' => 'attachment_tag','field' => 'slug','terms' => 'artisan'))"]</li>
355
  <p>
356
  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.
357
  </p>
358
+ <a name="alt_shortcode"></a>
359
+ &nbsp;
360
+ <p>
361
+ <a href="#backtotop">Go to Top</a>
362
+ </p>
363
+ <h3>Support for Other Gallery-generating Shortcodes</h3>
364
+ <p>
365
+ The [mla_gallery] shortcode can be used in combination with other gallery-generating shortcodes to give you the data selection power of [mla_gallery] and the formatting/display power of popular alternatives such as the WordPress.com Jetpack Carousel and Tiled Galleries modules. Any shortcode that accepts "ids=" or a similar parameter listing the attachment ID values for the gallery can be used. Two parameters implement this feature:
366
+ </p>
367
+ <table>
368
+ <tr>
369
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_alt_shortcode</td>
370
+ <td>the name of the shortcode to be called for gallery format and display</td>
371
+ </tr>
372
+ <tr>
373
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">mla_alt_ids_name</td>
374
+ <td>(optional, default "ids") the name of the parameter used to pass a list of attachment ID values to the alternate shortcode</td>
375
+ </tr>
376
+ </table>
377
+ <p>
378
+ For example, if you want to select images using the MLA Att. Category taxonomy but want to display a "Tiled Mosaic" gallery, you can code:
379
+ </p>
380
+ <pre>
381
+ [mla_gallery attachment_category=vegetable tax_operator="NOT IN" mla_alt_shortcode=gallery type="rectangular" mla_alt_ids_name=include]
382
+ </pre>
383
+ <p>
384
+ This example selects all the images that are "NOT IN" the Att. Category "vegetable". The selected images are passed to the [gallery] shortcode in an "include" parameter, along with the "type=rectangular" parameter. The result is as if you had coded:
385
+ </p>
386
+ <pre>
387
+ [gallery include="1,2,3" type="rectangular"]
388
+ </pre>
389
+ <p>
390
+ In the above example, the "mla_alt_ids_name=include" parameter isn't really necessary, since the [gallery] shortcode accepts the "ids" parameter. It was included in the example just to show how the "mla_alt_ids_name" might be used for some other shortcode that requires a different name for the parameter.
391
+ </p>
392
+ <p>
393
+ You can pass any parameters you need through the [mla_gallery] shortcode and on to the alternate shortcode you're using. Here's another example, using the Photonic Gallery plugin:
394
+ </p>
395
+ <pre>
396
+ [mla_gallery attachment_tag=fauna orderby=rand mla_alt_shortcode=gallery type=default style=strip-below slideshow_height=320 slide_size=medium]
397
+ </pre>
398
+ <p>
399
+ Here, [mla_gallery] selects the images with an Att. Tag of "fauna" and sorts them in a random order. It then calls on the [gallery] shortcode (which Photonic also uses):
400
+ </p>
401
+ <pre>
402
+ [gallery ids="3,1,4,2,7" type=default style=strip-below slideshow_height=320 slide_size=medium]
403
+ </pre>
404
+ <p>
405
+ Photonic recognizes the "type=default" parameter and takes over, using the other three parameters to format its results. This example is a less convenient but more flexible alternative to the native Photonic support built-in to [mla_gallery] (see next section).
406
+ </p>
407
+ <p>
408
+ <strong>NOTE:</strong> When you use "mla_alt_shortcode" to pass format/display responsibility off to another shortcode you will lose the [mla_gallery] Gallery Display Style (e.g. "mla_float") and Gallery Display Content (e.g. "mla_caption") parameters. There is no reliable way for [mla_gallery] to pass this information on to the other shortcode you've specified.
409
+ </p>
410
+ <p>
411
  <a name="photonic_gallery"></a>
412
  &nbsp;
413
  <p>
430
  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.
431
  </p>
432
  <p>
433
+ Style templates provide gallery-specific CSS inline styles (you can code "mla_style=none" to suppress the addition of CSS inline styles entirely). Markup templates provide the HTML markup for 1) the beginning of the 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.
434
  </p>
435
  <p>
436
+ The MLA Gallery tab on the Settings page lets you add, change and delete custom templates. The default templates are also displayed on this tab for easy reference.
437
  </p>
438
  <p>
439
  In a template, substitution parameters are surrounded by opening ('[+') and closing ('+]') delimiters to separate them from the template text; see the default templates for many examples.
725
  </p>
726
  <h3>Field-level Markup Substitution Parameters</h3>
727
  <p>
728
+ Field-level substitution parameters let you access query arguments, custom fields, taxonomy terms, IPTC metadata and EXIF metadata for display in an MLA gallery. For these parameters, the value you code within the surrounding the ('[+') and ('+]') delimiters has three parts; the prefix, the field name and the optional ",single" or &quot;,export&quot; indicator.
729
  </p>
730
  <p>
731
  The <strong>prefix</strong> defines which type of field-level data you are accessing. It must immediately follow the opening ('[+') delimiter and end with a colon (':'). There can be no spaces in this part of the parameter.
732
  </p>
733
  <p>
734
+ The <strong>field name</strong> defines which field-level data element you are accessing. It must immediately follow the colon (':'). There can be no spaces between the colon and the field name. Spaces are allowed within the field name to accommodate custom field names that contain them. <strong>Compound names</strong> are used to access elements within arrays, e.g., &quot;<strong>sizes.thumbnail.file</strong>&quot; is used to specify the file name for the thumbnail version of an image. </p>
735
+ <p>
736
+ The optional <strong>",single" indicator</strong> defines how to handle fields with multiple values. It must immediately follow the field name and end with the closing delimiter ('+]'). There can be no spaces in this part of the parameter. If this part of the parameter is present, only the first value of the field will be returned. Use this indicator to limit the data returned for a custom field, taxonomy or metadata field that can have many values. For example, if you code `[+meta:sizes.thumbnail,single+]` the result will be "20120313-ASK_5605-150x150.jpg".
737
  </p>
738
  <p>
739
+ The optional <strong>",export" indicator</strong> for display of array fields with multiple values. It must immediately follow the field name and end with the closing delimiter ('+]'). There can be no spaces in this part of the parameter. If this part of the parameter is present, the PHP var_export function is used to return a string representation of all the elements in an array field. For example, if you code `[+meta:sizes.thumbnail,export+]` the result will be "array ('file' => '20120313-ASK_5605-150x150.jpg', 'width' => 150, 'height' => 150, 'mime-type' => 'image/jpeg'".
740
  </p>
741
  <p>
742
+ There are six prefix values for field-level data. Prefix values must be coded as shown; all lowercase letters.
743
  </p>
744
  <table>
745
  <tr>
754
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">terms</td>
755
  <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>
756
  </tr>
757
+ <tr>
758
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">meta</td>
759
+ <td>WordPress attachment metadata, if any, embedded in the image/audio/video file. For this category, you can code any of the field names embedded in the _wp_attachment_metadata array. The "Attachment Metadata" display in the Media/Edit Media screen will show you the names and values of these fields. Note that the fields available differ among image, audio and video attachments.</td>
760
+ </tr>
761
  <tr>
762
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">iptc</td>
763
  <td>
770
  <td>
771
  The EXIF (EXchangeable Image File) metadata, if any, embedded in a JPEG DCT or TIFF Rev 6.0 image file.
772
  Though the specification is not currently maintained by any industry or standards organization, almost all camera manufacturers use it. It is also supported by many image editing programs such as Adobe PhotoShop.
773
+ For this category, you can code any of the field names embedded in the image by the camera or editing software. There is no official list of standard field names, so you just have to know the names your camera and software use; field names are case-sensitive.
774
  <br />&nbsp;<br />
775
  You can find more information in the <a href="http://en.wikipedia.org/wiki/Exchangeable_image_file_format" title="IPTC-NAA Information Interchange Model Version No. 4.1 specification" target="_blank">Exchangeable image file format</a> article on Wikipedia. You can find External Links to EXIF standards and tag listings at the end of the Wikipedia article.
776
  <br />&nbsp;<br />
886
  </p>
887
  <h4>Data sources for custom field mapping</h4>
888
  <p>
889
+ <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". Data sources like "file_size", "pixels", "width" and "height" are converted to strings and padded on the left with spaces if you use the "commas" format. This padding makes them sort more sensibly.
890
  </p>
891
  <table>
892
  <tr>
893
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">-- None (select a value) --</td>
894
  <td>nothing, i.e., no change to existing value (if any). Use this source if you just want to add a custom field to the Media/Assistant submenu and/or the inline edit areas.</td>
895
  </tr>
896
  <tr>
897
+ <td style="padding-right: 10px; vertical-align: top; font-weight:bold">-- Metadata (see below) --</td>
898
+ <td>WordPress attachment metadata, from the <em>_wp_attachment_metadata</em> array. Enter the field you want in the text box below the dropdown list. More coding guidelines are given below this table.</td>
899
+ </tr>
900
+ <tr>
901
  <td style="padding-right: 10px; vertical-align: top; font-weight:bold">path</td>
902
  <td>path portion of the base_file value, e.g., 2012/11/</td>
903
  </tr>
1028
  <td>for image types, the value stored in WordPress "image_meta" array</td>
1029
  </tr>
1030
  </table>
1031
+ <h4>Custom field mapping for metadata fields</h4>
1032
+ <p>
1033
+ If you select "<strong>-- Metadata (see below) --</strong>" as the data source you must specify the name of the field you want in the text box below the data source dropdown box. Any of the fields in the <em>_wp_attachment_metadata</em> array may be named, including the new audio/video fields available with WordPress 3.6 and later. For example, "length_formatted" will return the length of a video attachment. You can specify fields within an array with a compound name, e.g., "audio.sample_rate" to get the sampling rate field from the "audio" array of a video attachment. If you simply specify "audio", you will get the values of every array element, e.g., "mp4,ISO/IEC 14496 AAC,48000,2,16,false,stereo".
1034
+ </p>
1035
+ <p>
1036
+ The "Single" and "Export" checkboxes can further refine your specification. The "Single" box will return just the first value of an array, e.g., "mp4" for the above "audio" example. The "Export" box will return all the field names and values (including nested arrays). For example, the above audio data would be returned in Export format as "array ('dataformat' => 'mp4', 'codec' => 'ISO/IEC 14496-3 AAC', 'sample_rate' => 48000, 'channels' => 2, 'bits_per_sample' => 16, 'lossless' => false, 'channelmode' => 'stereo'".
1037
+ </p>
1038
  <a name="mla_iptc_exif_mapping"></a>
1039
  &nbsp;
1040
  <p>
1051
  <li>taxonomy terms, e.g., in categories, tags or custom taxonomies</li>
1052
  <li>WordPress Custom Fields</li>
1053
  </ul>
1054
+ You can define the rules for mapping metadata on the "IPTC/EXIF" tab of the Settings page. You can choose to automatically apply the rules when new media are added to the Library (or not). You can click the "Map IPTC/EXIF metadata" button on the Edit Media/Edit Single Item screen or in the bulk edit area to selectively apply the rules to one or more images. You can click the "Map All Attachments Now" to apply the rules to <strong><em>ALL of the images in your library</em></strong> at one time.
1055
  </p>
1056
  <h4>Mapping tables</h4>
1057
  <p>
1065
  </dd>
1066
  <dt>EXIF Value</dt>
1067
  <dd>The EXIF (EXchangeable Image File) metadata, if any, embedded in a JPEG DCT or TIFF Rev 6.0 image file.
1068
+ Though the specification is not currently maintained by any industry or standards organization, almost all camera manufacturers use it. For this category, you can code any of the field names embedded in the image by the camera or editing software. There is no official list of standard field names, so you just have to know the names your camera and software use; field names are case-sensitive. You can find more information in the <a href="http://en.wikipedia.org/wiki/Exchangeable_image_file_format" title="Exchangeable image file format Wikipedia article" target="_blank">Exchangeable image file format</a> article on Wikipedia. You can find External Links to EXIF standards and tag listings at the end of the Wikipedia article.
1069
  <br />&nbsp;<br />
1070
  MLA uses a standard PHP function, <a href="http://php.net/manual/en/function.exif-read-data.php" title="PHP Manual page for exif_read_data" target="_blank">exif_read_data</a>, to extract EXIF data from images. The function returns three arrays in addition to the raw EXIF data; COMPUTED, THUMBNAIL and COMMENT. You can access the array elements by prefacing the element you want with the array name. For example, the user comment text is available as "COMPUTED.UserComment" and "COMPUTED.UserCommentEncoding". You can also get "COMPUTED.Copyright" and its two parts (if present), "COMPUTED.Copyright.Photographer" and "COMPUTED.Copyright.Editor". The THUMBNAIL and COMMENT arrays work in a similar fashion.
1071
  <br />&nbsp;<br />
1182
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">country-or-primary-location-name</td><td style="padding-right: 10px; vertical-align: top">2#101</td><td style="padding-right: 10px; vertical-align: top">Max 64 characters of publishable country/geographical location name; repeatable</td></tr>
1183
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">original-transmission-reference</td><td style="padding-right: 10px; vertical-align: top">2#103</td><td style="padding-right: 10px; vertical-align: top">Max 32 characters of a code representing the location of original transmission</td></tr>
1184
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">headline</td><td style="padding-right: 10px; vertical-align: top">2#105</td><td style="padding-right: 10px; vertical-align: top">Max 256 Characters of a publishable entry providing a synopsis of the contents of the objectdata</td></tr>
1185
+ <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">credit</td><td style="padding-right: 10px; vertical-align: top">2#110</td><td style="padding-right: 10px; vertical-align: top">Max 32 Characters that identifies the provider of the objectdata (Vs. the owner/creator)</td></tr>
1186
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">source</td><td style="padding-right: 10px; vertical-align: top">2#115</td><td style="padding-right: 10px; vertical-align: top">Max 32 Characters that identifies the original owner of the intellectual content</td></tr>
1187
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">copyright-notice</td><td style="padding-right: 10px; vertical-align: top">2#116</td><td style="padding-right: 10px; vertical-align: top">Max 128 Characters that contains any necessary copyright notice</td></tr>
1188
+ <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">contact</td><td style="padding-right: 10px; vertical-align: top">2#118</td><td style="padding-right: 10px; vertical-align: top">Max 128 characters that identifies the person or organization which can provide further background information; repeatable</td></tr>
1189
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">caption-or-abstract</td><td style="padding-right: 10px; vertical-align: top">2#120</td><td style="padding-right: 10px; vertical-align: top">Max 2000 Characters of a textual description of the objectdata</td></tr>
1190
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">caption-writer-or-editor</td><td style="padding-right: 10px; vertical-align: top">2#122</td><td style="padding-right: 10px; vertical-align: top">Max 32 Characters that the identifies the person involved in the writing, editing or correcting the objectdata or caption/abstract; repeatable</td></tr>
1191
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">rasterized-caption</td><td style="padding-right: 10px; vertical-align: top">2#125</td><td style="padding-right: 10px; vertical-align: top">7360 binary octets of the rasterized caption - 1 bit per pixel, 460x128-pixel image</td></tr>
1192
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">image-type</td><td style="padding-right: 10px; vertical-align: top">2#130</td><td style="padding-right: 10px; vertical-align: top">2 characters of color composition type and information</td></tr>
1193
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">image-orientation</td><td style="padding-right: 10px; vertical-align: top">2#131</td><td style="padding-right: 10px; vertical-align: top">1 alphabetic character indicating the image area layout - P=portrait, L=landscape, S=square</td></tr>
1194
+ <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">language-identifier</td><td style="padding-right: 10px; vertical-align: top">2#135</td><td style="padding-right: 10px; vertical-align: top">2 or 3 alphabetic characters containing the major national language of the object, according to the ISO 639:1988 codes</td></tr>
1195
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">audio-type</td><td style="padding-right: 10px; vertical-align: top">2#150</td><td style="padding-right: 10px; vertical-align: top">2 characters identifying monaural/stereo and exact type of audio content</td></tr>
1196
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">audio-sampling-rate</td><td style="padding-right: 10px; vertical-align: top">2#151</td><td style="padding-right: 10px; vertical-align: top">6 numeric characters representing the audio sampling rate in hertz (Hz)</td></tr>
1197
  <tr><td style="padding-right: 10px; vertical-align: top; font-weight:bold">audio-sampling-resolution</td><td style="padding-right: 10px; vertical-align: top">2#152</td><td style="padding-right: 10px; vertical-align: top">2 numeric characters representing the number of bits in each audio sample</td></tr>
tpls/mla-option-templates.tpl CHANGED
@@ -119,6 +119,19 @@
119
  <input type="checkbox" name="custom_field_mapping[[+key+]][bulk_edit]" id="custom_field_bulk_edit_[+key+]" [+bulk_edit_checked+] value="checked" />
120
  </td>
121
  </tr>
 
 
 
 
 
 
 
 
 
 
 
 
 
122
  <tr valign="top">
123
  <td colspan="[+column_count+]" style="padding-bottom: 10px">
124
  <input type="submit" name="custom_field_mapping[[+key+]][action][delete_rule]" class="button-primary" style="height: 18px; line-height: 16px" value="Delete Rule" />
@@ -167,6 +180,19 @@
167
  <input type="checkbox" name="custom_field_mapping[[+key+]][bulk_edit]" id="custom_field_bulk_edit_[+key+]" [+bulk_edit_checked+] value="checked" />
168
  </td>
169
  </tr>
 
 
 
 
 
 
 
 
 
 
 
 
 
170
  <tr valign="top">
171
  <td colspan="[+column_count+]">
172
  <input type="submit" name="custom_field_mapping[[+key+]][action][add_rule]" type="submit" class="button-primary" value="Add Rule" />
@@ -211,6 +237,19 @@
211
  <input type="checkbox" name="custom_field_mapping[[+key+]][bulk_edit]" id="custom_field_bulk_edit_[+key+]" [+bulk_edit_checked+] value="checked" />
212
  </td>
213
  </tr>
 
 
 
 
 
 
 
 
 
 
 
 
 
214
  <tr valign="top">
215
  <td colspan="[+column_count+]">
216
  <input type="submit" name="custom_field_mapping[[+key+]][action][add_field]" type="submit" class="button-primary" value="Add Field" />
@@ -378,10 +417,18 @@
378
  </td>
379
  </tr>
380
 
381
- <!-- template="iptc-exif-custom-row" -->
 
 
 
 
 
 
 
382
  <tr valign="top">
383
- <td>
384
  [+name+]&nbsp;
 
385
  </td>
386
  <td style="text-align:left;">
387
  <select name="iptc_exif_mapping[custom][[+key+]][iptc_value]" id="iptc_exif_custom_iptc_field_[+key+]">
@@ -404,6 +451,92 @@
404
  </select>
405
  </td>
406
  </tr>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
407
 
408
  <!-- template="default-style" -->
409
  <style type='text/css'>
119
  <input type="checkbox" name="custom_field_mapping[[+key+]][bulk_edit]" id="custom_field_bulk_edit_[+key+]" [+bulk_edit_checked+] value="checked" />
120
  </td>
121
  </tr>
122
+ <tr valign="top">
123
+ <td>
124
+ &nbsp;
125
+ </td>
126
+ <td style="text-align:left;">
127
+ <input name="custom_field_mapping[[+key+]][meta_name]" id="custom_field_meta_name_[+key+]" type="text" size="[+meta_name_size+]" value="[+meta_name+]" />
128
+ </td>
129
+ <td colspan="[+column_count_meta+]" style="text-align:left; vertical-align:middle;">
130
+ <input type="checkbox" name="custom_field_mapping[[+key+]][meta_single]" id="custom_field_meta_single_[+key+]" [+meta_single_checked+] value="checked" /> <strong>Single</strong>
131
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
132
+ <input type="checkbox" name="custom_field_mapping[[+key+]][meta_export]" id="custom_field_meta_export_[+key+]" [+meta_export_checked+] value="checked" /> <strong>Export</strong>
133
+ </td>
134
+ </tr>
135
  <tr valign="top">
136
  <td colspan="[+column_count+]" style="padding-bottom: 10px">
137
  <input type="submit" name="custom_field_mapping[[+key+]][action][delete_rule]" class="button-primary" style="height: 18px; line-height: 16px" value="Delete Rule" />
180
  <input type="checkbox" name="custom_field_mapping[[+key+]][bulk_edit]" id="custom_field_bulk_edit_[+key+]" [+bulk_edit_checked+] value="checked" />
181
  </td>
182
  </tr>
183
+ <tr valign="top">
184
+ <td>
185
+ &nbsp;
186
+ </td>
187
+ <td style="text-align:left;">
188
+ <input name="custom_field_mapping[[+key+]][meta_name]" id="custom_field_meta_name_[+key+]" type="text" size="[+meta_name_size+]" value="[+meta_name+]" />
189
+ </td>
190
+ <td colspan="[+column_count_meta+]" style="text-align:left; vertical-align:middle;">
191
+ <input type="checkbox" name="custom_field_mapping[[+key+]][meta_single]" id="custom_field_meta_single_[+key+]" [+meta_single_checked+] value="checked" /> <strong>Single</strong>
192
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
193
+ <input type="checkbox" name="custom_field_mapping[[+key+]][meta_export]" id="custom_field_meta_export_[+key+]" [+meta_export_checked+] value="checked" /> <strong>Export</strong>
194
+ </td>
195
+ </tr>
196
  <tr valign="top">
197
  <td colspan="[+column_count+]">
198
  <input type="submit" name="custom_field_mapping[[+key+]][action][add_rule]" type="submit" class="button-primary" value="Add Rule" />
237
  <input type="checkbox" name="custom_field_mapping[[+key+]][bulk_edit]" id="custom_field_bulk_edit_[+key+]" [+bulk_edit_checked+] value="checked" />
238
  </td>
239
  </tr>
240
+ <tr valign="top">
241
+ <td>
242
+ &nbsp;
243
+ </td>
244
+ <td style="text-align:left;">
245
+ <input name="custom_field_mapping[[+key+]][meta_name]" id="custom_field_meta_name_[+key+]" type="text" size="[+meta_name_size+]" value="[+meta_name+]" />
246
+ </td>
247
+ <td colspan="[+column_count_meta+]" style="text-align:left; vertical-align:middle;">
248
+ <input type="checkbox" name="custom_field_mapping[[+key+]][meta_single]" id="custom_field_meta_single_[+key+]" [+meta_single_checked+] value="checked" /> <strong>Single</strong>
249
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
250
+ <input type="checkbox" name="custom_field_mapping[[+key+]][meta_export]" id="custom_field_meta_export_[+key+]" [+meta_export_checked+] value="checked" /> <strong>Export</strong>
251
+ </td>
252
+ </tr>
253
  <tr valign="top">
254
  <td colspan="[+column_count+]">
255
  <input type="submit" name="custom_field_mapping[[+key+]][action][add_field]" type="submit" class="button-primary" value="Add Field" />
417
  </td>
418
  </tr>
419
 
420
+ <!-- template="iptc-exif-custom-empty-row" -->
421
+ <tr>
422
+ <td colspan="[+column_count+]" style="font-weight:bold; height: 4em; text-align:center; vertical-align:middle">
423
+ No Custom Field Mapping Rules Defined
424
+ </td>
425
+ </tr>
426
+
427
+ <!-- template="iptc-exif-custom-rule-row" -->
428
  <tr valign="top">
429
+ <td style="text-align:left; vertical-align:middle">
430
  [+name+]&nbsp;
431
+ <input type="hidden" name="iptc_exif_mapping[custom][[+key+]][name]" id="iptc_exif_custom_name_[+key+]" value="[+name+]" />
432
  </td>
433
  <td style="text-align:left;">
434
  <select name="iptc_exif_mapping[custom][[+key+]][iptc_value]" id="iptc_exif_custom_iptc_field_[+key+]">
451
  </select>
452
  </td>
453
  </tr>
454
+ <tr valign="top">
455
+ <td colspan="[+column_count+]" style="padding-bottom: 10px">
456
+ <input type="submit" name="iptc_exif_mapping[custom][[+key+]][action][delete_rule]" class="button-primary" style="height: 18px; line-height: 16px" value="Delete Rule" />
457
+ <input type="submit" name="iptc_exif_mapping[custom][[+key+]][action][delete_field]" class="button-primary" style="height: 18px; line-height: 16px" value="Delete Rule AND Field" />
458
+ <input type="submit" name="iptc_exif_mapping[custom][[+key+]][action][update_rule]" class="button-primary" style="height: 18px; line-height: 16px" value="Update Rule" />
459
+ <input type="submit" name="iptc_exif_mapping[custom][[+key+]][action][map_now]" class="button-secondary" style="height: 18px; line-height: 16px" value="Map All Attachments" />
460
+ </td>
461
+ </tr>
462
+
463
+ <!-- template="iptc-exif-custom-new-rule-row" -->
464
+ <tr>
465
+ <td colspan="[+column_count+]" style="font-weight:bold; height: 3em; vertical-align:bottom">
466
+ Add a new Mapping Rule
467
+ </td>
468
+ </tr>
469
+ <tr valign="top">
470
+ <td style="text-align:left;">
471
+ <select name="iptc_exif_mapping[custom][[+key+]][name]" id="iptc_exif_custom_name_[+key+]">
472
+ [+field_name_options+]
473
+ </select>
474
+ </td>
475
+ <td style="text-align:left;">
476
+ <select name="iptc_exif_mapping[custom][[+key+]][iptc_value]" id="iptc_exif_custom_iptc_field_[+key+]">
477
+ [+iptc_field_options+]
478
+ </select>
479
+ </td>
480
+ <td style="text-align:center;">
481
+ <input name="iptc_exif_mapping[custom][[+key+]][exif_value]" id="iptc_exif_custom_exif_field_[+key+]" type="text" size="[+exif_size+]" value="[+exif_text+]" />
482
+ </td>
483
+ <td style="text-align:left;">
484
+ <select name="iptc_exif_mapping[custom][[+key+]][iptc_first]" id="iptc_exif_custom_priority_[+key+]">
485
+ <option [+iptc_selected+] value="1">IPTC</option>
486
+ <option [+exif_selected+] value="">EXIF</option>
487
+ </select>
488
+ </td>
489
+ <td style="text-align:left;">
490
+ <select name="iptc_exif_mapping[custom][[+key+]][keep_existing]" id="iptc_exif_custom_existing_[+key+]">
491
+ <option [+keep_selected+] value="1">Keep</option>
492
+ <option [+replace_selected+] value="">Replace</option>
493
+ </select>
494
+ </td>
495
+ </tr>
496
+ <tr valign="top">
497
+ <td colspan="[+column_count+]">
498
+ <input type="submit" name="iptc_exif_mapping[custom][[+key+]][action][add_rule]" type="submit" class="button-primary" value="Add Rule" />
499
+ <input type="submit" name="iptc_exif_mapping[custom][[+key+]][action][add_rule_map]" type="submit" class="button-secondary" value="Add Rule and Map All Attachments" />
500
+ </td>
501
+ </tr>
502
+
503
+ <!-- template="iptc-exif-custom-new-field-row" -->
504
+ <tr>
505
+ <td colspan="[+column_count+]" style="font-weight:bold; height: 3em; vertical-align:bottom">
506
+ Add a new Custom Field and Mapping Rule
507
+ </td>
508
+ </tr>
509
+ <tr valign="top">
510
+ <td style="text-align:left;">
511
+ <input name="iptc_exif_mapping[custom][[+key+]][name]" id="iptc_exif_custom_name_[+key+]" type="text" size="[+field_name_size+]" value="" />
512
+ </td>
513
+ <td style="text-align:left;">
514
+ <select name="iptc_exif_mapping[custom][[+key+]][iptc_value]" id="iptc_exif_custom_iptc_field_[+key+]">
515
+ [+iptc_field_options+]
516
+ </select>
517
+ </td>
518
+ <td style="text-align:center;">
519
+ <input name="iptc_exif_mapping[custom][[+key+]][exif_value]" id="iptc_exif_custom_exif_field_[+key+]" type="text" size="[+exif_size+]" value="[+exif_text+]" />
520
+ </td>
521
+ <td style="text-align:left;">
522
+ <select name="iptc_exif_mapping[custom][[+key+]][iptc_first]" id="iptc_exif_custom_priority_[+key+]">
523
+ <option [+iptc_selected+] value="1">IPTC</option>
524
+ <option [+exif_selected+] value="">EXIF</option>
525
+ </select>
526
+ </td>
527
+ <td style="text-align:left;">
528
+ <select name="iptc_exif_mapping[custom][[+key+]][keep_existing]" id="iptc_exif_custom_existing_[+key+]">
529
+ <option [+keep_selected+] value="1">Keep</option>
530
+ <option [+replace_selected+] value="">Replace</option>
531
+ </select>
532
+ </td>
533
+ </tr>
534
+ <tr valign="top">
535
+ <td colspan="[+column_count+]">
536
+ <input type="submit" name="iptc_exif_mapping[custom][[+key+]][action][add_field]" type="submit" class="button-primary" value="Add Field" />
537
+ <input type="submit" name="iptc_exif_mapping[custom][[+key+]][action][add_field_map]" type="submit" class="button-secondary" value="Add Field and Map All Attachments" />
538
+ </td>
539
+ </tr>
540
 
541
  <!-- template="default-style" -->
542
  <style type='text/css'>