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 newmla_alt_shortcode
andmla_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
andposts_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. Thelink=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 | 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 +90 -23
- includes/class-mla-edit-media.php +2 -2
- includes/class-mla-list-table.php +4 -1
- includes/class-mla-main.php +6 -4
- includes/class-mla-media-modal.php +2 -0
- includes/class-mla-objects.php +7 -3
- includes/class-mla-options.php +245 -114
- includes/class-mla-settings.php +109 -32
- includes/class-mla-shortcodes.php +232 -102
- index.php +2 -2
- js/mla-media-modal-scripts.js +1 -0
- js/mla-media-modal-scripts.min.js +1 -1
- phpDocs/classes/MLA.html +2 -2
- phpDocs/classes/MLAData.html +32 -1
- phpDocs/classes/MLAEdit.html +1 -1
- phpDocs/classes/MLAModal.html +1 -1
- phpDocs/classes/MLAObjects.html +1 -1
- phpDocs/classes/MLAOptions.html +8 -8
- phpDocs/classes/MLASettings.html +26 -2
- phpDocs/classes/MLAShortcodes.html +56 -1
- phpDocs/classes/MLATest.html +1 -1
- phpDocs/classes/MLA_List_Table.html +1 -1
- phpDocs/deprecated.html +1 -1
- phpDocs/errors.html +1 -1
- phpDocs/graph_class.html +1 -1
- phpDocs/index.html +1 -1
- phpDocs/markers.html +1 -1
- phpDocs/namespaces/global.html +1 -1
- phpDocs/packages/Media Library Assistant.html +1 -1
- phpDocs/structure.xml +985 -858
- readme.txt +100 -135
- tpls/admin-display-settings-page.tpl +12 -5
- tpls/documentation-settings-tab.tpl +96 -17
- tpls/mla-option-templates.tpl +135 -2
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 |
-
|
1011 |
-
|
1012 |
-
|
1013 |
-
|
1014 |
-
|
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 |
-
}
|
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
|
1677 |
-
$
|
1678 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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', '
|
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">
|
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 |
-
|
|
|
|
|
|
|
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.
|
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['
|
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 |
-
|
97 |
-
|
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
|
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 |
-
|
642 |
-
|
643 |
-
|
644 |
-
|
645 |
-
|
646 |
-
|
647 |
-
|
648 |
-
|
649 |
-
|
650 |
-
|
651 |
-
|
652 |
-
|
653 |
-
|
654 |
-
|
655 |
-
|
656 |
-
|
657 |
-
|
658 |
-
|
659 |
-
|
660 |
-
|
661 |
-
|
662 |
-
|
663 |
-
|
664 |
-
|
665 |
-
|
666 |
-
|
667 |
-
|
668 |
-
|
669 |
-
|
670 |
-
|
671 |
-
|
672 |
-
|
673 |
-
|
|
|
674 |
} // foreach
|
675 |
|
676 |
return $templates;
|
@@ -1063,22 +1072,20 @@ class MLAOptions {
|
|
1063 |
'sizes' => array()
|
1064 |
);
|
1065 |
|
1066 |
-
$
|
|
|
|
|
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 |
-
|
1077 |
-
$
|
1078 |
-
|
1079 |
-
|
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
|
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, $
|
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 |
-
|
|
|
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 |
-
|
|
|
1378 |
$old_text = get_metadata( 'post', $post_id, $new_key, true );
|
1379 |
-
|
1380 |
-
|
1381 |
-
|
1382 |
-
|
1383 |
-
$custom_updates[ $new_value['name'] ] =
|
|
|
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 =
|
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 (
|
|
|
|
|
|
|
|
|
|
|
|
|
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 |
-
|
2469 |
-
|
2470 |
-
|
|
|
|
|
|
|
|
|
2471 |
|
2472 |
/*
|
2473 |
-
*
|
2474 |
*/
|
2475 |
-
|
2476 |
-
|
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 (
|
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
|
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 |
-
'
|
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 |
-
|
927 |
-
|
928 |
-
|
929 |
-
|
930 |
-
|
931 |
-
|
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 |
-
|
941 |
-
|
942 |
-
|
943 |
-
|
944 |
-
|
945 |
-
|
946 |
-
|
947 |
-
|
948 |
-
|
949 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
|
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 (
|
1503 |
-
|
|
|
|
|
|
|
|
|
|
|
1504 |
|
1505 |
-
if (
|
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', $
|
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> <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 |
-
$
|
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
|
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
|
339 |
*/
|
340 |
$query_placeholders = array();
|
|
|
|
|
|
|
|
|
|
|
341 |
$terms_placeholders = array();
|
342 |
$custom_placeholders = array();
|
343 |
$iptc_placeholders = array();
|
344 |
$exif_placeholders = array();
|
345 |
|
346 |
-
$
|
347 |
-
if (
|
348 |
$markup_values['mla_markup'] = 'default';
|
349 |
-
$
|
350 |
}
|
351 |
|
352 |
-
if (
|
353 |
-
$
|
354 |
|
355 |
-
|
356 |
-
|
357 |
-
|
358 |
|
359 |
-
|
360 |
-
|
361 |
-
|
362 |
-
|
363 |
-
|
364 |
-
|
365 |
-
|
366 |
-
|
367 |
-
|
368 |
-
|
369 |
-
|
370 |
-
|
371 |
-
|
372 |
-
|
373 |
-
|
374 |
-
|
375 |
-
|
376 |
-
|
377 |
-
|
378 |
-
|
379 |
-
|
380 |
-
|
381 |
-
|
382 |
-
|
383 |
-
|
384 |
-
|
385 |
-
|
386 |
-
|
387 |
-
|
388 |
-
|
389 |
-
|
390 |
-
|
391 |
-
|
392 |
-
|
393 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
394 |
|
395 |
-
|
396 |
-
|
397 |
-
|
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 |
-
|
|
|
|
|
|
|
|
|
|
|
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 |
-
|
447 |
-
|
448 |
-
|
|
|
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 |
-
|
492 |
-
|
493 |
-
|
494 |
-
|
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 |
-
*
|
868 |
-
*
|
869 |
-
* @since .50
|
870 |
*
|
871 |
-
* @
|
872 |
-
* @param array Attributes of the shortcode
|
873 |
*
|
874 |
-
* @
|
875 |
*/
|
876 |
-
|
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(
|
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 |
-
|
1218 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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 |
-
|
1226 |
-
|
1227 |
-
|
1228 |
-
self::$mla_debug_messages .= '<p><strong>mla_debug</strong>
|
|
|
|
|
|
|
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
|
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
|
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.
|
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.
|
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-
|
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-
|
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-
|
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-
|
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-
|
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,
|
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>$
|
705 |
-
<code>
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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="
|
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="
|
44 |
<name>$query_parameters</name>
|
45 |
<default><![CDATA[array()]]></default>
|
46 |
-
<docblock line="
|
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="
|
54 |
-
<tag line="
|
55 |
<type by_reference="false">array</type>
|
56 |
</tag>
|
57 |
</docblock>
|
58 |
</property>
|
59 |
-
<property final="false" static="true" visibility="private" line="
|
60 |
<name>$galleries</name>
|
61 |
<default><![CDATA[null]]></default>
|
62 |
-
<docblock line="
|
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="
|
75 |
-
<tag line="
|
76 |
<type by_reference="false">array</type>
|
77 |
</tag>
|
78 |
</docblock>
|
79 |
</property>
|
80 |
-
<property final="false" static="true" visibility="private" line="
|
81 |
<name>$mla_galleries</name>
|
82 |
<default><![CDATA[null]]></default>
|
83 |
-
<docblock line="
|
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="
|
89 |
-
<tag line="
|
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="
|
185 |
<name>mla_count_list_table_items</name>
|
186 |
<full_name>mla_count_list_table_items</full_name>
|
187 |
-
<docblock line="
|
188 |
<description><![CDATA[Get the total number of attachment posts]]></description>
|
189 |
<long-description><![CDATA[]]></long-description>
|
190 |
-
<tag line="
|
191 |
-
<tag line="
|
192 |
<type by_reference="false">array</type>
|
193 |
</tag>
|
194 |
-
<tag line="
|
195 |
<type by_reference="false">integer</type>
|
196 |
</tag>
|
197 |
</docblock>
|
198 |
-
<argument line="
|
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="
|
205 |
<name>mla_query_list_table_items</name>
|
206 |
<full_name>mla_query_list_table_items</full_name>
|
207 |
-
<docblock line="
|
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="
|
212 |
-
<tag line="
|
213 |
<type by_reference="false">array</type>
|
214 |
</tag>
|
215 |
-
<tag line="
|
216 |
<type by_reference="false">int</type>
|
217 |
</tag>
|
218 |
-
<tag line="
|
219 |
<type by_reference="false">int</type>
|
220 |
</tag>
|
221 |
-
<tag line="
|
222 |
<type by_reference="false">array</type>
|
223 |
</tag>
|
224 |
</docblock>
|
225 |
-
<argument line="
|
226 |
<name>$request</name>
|
227 |
<default><![CDATA[]]></default>
|
228 |
<type/>
|
229 |
</argument>
|
230 |
-
<argument line="
|
231 |
<name>$offset</name>
|
232 |
<default><![CDATA[]]></default>
|
233 |
<type/>
|
234 |
</argument>
|
235 |
-
<argument line="
|
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="
|
242 |
<name>mla_query_media_modal_items</name>
|
243 |
<full_name>mla_query_media_modal_items</full_name>
|
244 |
-
<docblock line="
|
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="
|
248 |
-
<tag line="
|
249 |
<type by_reference="false">array</type>
|
250 |
</tag>
|
251 |
-
<tag line="
|
252 |
<type by_reference="false">int</type>
|
253 |
</tag>
|
254 |
-
<tag line="
|
255 |
<type by_reference="false">int</type>
|
256 |
</tag>
|
257 |
-
<tag line="
|
258 |
<type by_reference="false">array</type>
|
259 |
</tag>
|
260 |
</docblock>
|
261 |
-
<argument line="
|
262 |
<name>$request</name>
|
263 |
<default><![CDATA[]]></default>
|
264 |
<type/>
|
265 |
</argument>
|
266 |
-
<argument line="
|
267 |
<name>$offset</name>
|
268 |
<default><![CDATA[]]></default>
|
269 |
<type/>
|
270 |
</argument>
|
271 |
-
<argument line="
|
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="
|
278 |
<name>_prepare_list_table_query</name>
|
279 |
<full_name>_prepare_list_table_query</full_name>
|
280 |
-
<docblock line="
|
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="
|
285 |
-
<tag line="
|
286 |
<type by_reference="false">array</type>
|
287 |
</tag>
|
288 |
-
<tag line="
|
289 |
<type by_reference="false">int</type>
|
290 |
</tag>
|
291 |
-
<tag line="
|
292 |
<type by_reference="false">int</type>
|
293 |
</tag>
|
294 |
-
<tag line="
|
295 |
<type by_reference="false">array</type>
|
296 |
</tag>
|
297 |
</docblock>
|
298 |
-
<argument line="
|
299 |
<name>$raw_request</name>
|
300 |
<default><![CDATA[]]></default>
|
301 |
<type/>
|
302 |
</argument>
|
303 |
-
<argument line="
|
304 |
<name>$offset</name>
|
305 |
<default><![CDATA[0]]></default>
|
306 |
<type/>
|
307 |
</argument>
|
308 |
-
<argument line="
|
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="
|
315 |
<name>_execute_list_table_query</name>
|
316 |
<full_name>_execute_list_table_query</full_name>
|
317 |
-
<docblock line="
|
318 |
<description><![CDATA[Add filters, run query, remove filters]]></description>
|
319 |
<long-description><![CDATA[]]></long-description>
|
320 |
-
<tag line="
|
321 |
-
<tag line="
|
322 |
<type by_reference="false">array</type>
|
323 |
</tag>
|
324 |
-
<tag line="
|
325 |
<type by_reference="false">object</type>
|
326 |
</tag>
|
327 |
</docblock>
|
328 |
-
<argument line="
|
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="
|
335 |
<name>mla_query_posts_search_filter</name>
|
336 |
<full_name>mla_query_posts_search_filter</full_name>
|
337 |
-
<docblock line="
|
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="
|
341 |
-
<tag line="
|
342 |
<type by_reference="false">string</type>
|
343 |
</tag>
|
344 |
-
<tag line="
|
345 |
<type by_reference="false">object</type>
|
346 |
</tag>
|
347 |
-
<tag line="
|
348 |
<type by_reference="false">string</type>
|
349 |
</tag>
|
350 |
</docblock>
|
351 |
-
<argument line="
|
352 |
<name>$search_string</name>
|
353 |
<default><![CDATA[]]></default>
|
354 |
<type/>
|
355 |
</argument>
|
356 |
-
<argument line="
|
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="
|
363 |
<name>mla_query_posts_join_filter</name>
|
364 |
<full_name>mla_query_posts_join_filter</full_name>
|
365 |
-
<docblock line="
|
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="
|
369 |
-
<tag line="
|
370 |
<type by_reference="false">string</type>
|
371 |
</tag>
|
372 |
-
<tag line="
|
373 |
<type by_reference="false">string</type>
|
374 |
</tag>
|
375 |
</docblock>
|
376 |
-
<argument line="
|
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="
|
383 |
<name>mla_query_posts_where_filter</name>
|
384 |
<full_name>mla_query_posts_where_filter</full_name>
|
385 |
-
<docblock line="
|
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="
|
390 |
-
<tag line="
|
391 |
<type by_reference="false">string</type>
|
392 |
</tag>
|
393 |
-
<tag line="
|
394 |
<type by_reference="false">string</type>
|
395 |
</tag>
|
396 |
</docblock>
|
397 |
-
<argument line="
|
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="
|
404 |
<name>mla_query_posts_orderby_filter</name>
|
405 |
<full_name>mla_query_posts_orderby_filter</full_name>
|
406 |
-
<docblock line="
|
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="
|
411 |
-
<tag line="
|
412 |
<type by_reference="false">string</type>
|
413 |
</tag>
|
414 |
-
<tag line="
|
415 |
<type by_reference="false">string</type>
|
416 |
</tag>
|
417 |
</docblock>
|
418 |
-
<argument line="
|
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="
|
425 |
<name>mla_get_attachment_by_id</name>
|
426 |
<full_name>mla_get_attachment_by_id</full_name>
|
427 |
-
<docblock line="
|
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="
|
432 |
-
<tag line="
|
433 |
-
<tag line="
|
434 |
<type by_reference="false">int</type>
|
435 |
</tag>
|
436 |
-
<tag line="
|
437 |
<type by_reference="false">NULL</type>
|
438 |
<type by_reference="false">array</type>
|
439 |
</tag>
|
440 |
</docblock>
|
441 |
-
<argument line="
|
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="
|
448 |
<name>mla_fetch_attachment_parent_data</name>
|
449 |
<full_name>mla_fetch_attachment_parent_data</full_name>
|
450 |
-
<docblock line="
|
451 |
<description><![CDATA[Returns information about an attachment's parent, if found]]></description>
|
452 |
<long-description><![CDATA[]]></long-description>
|
453 |
-
<tag line="
|
454 |
-
<tag line="
|
455 |
<type by_reference="false">int</type>
|
456 |
</tag>
|
457 |
-
<tag line="
|
458 |
<type by_reference="false">array</type>
|
459 |
</tag>
|
460 |
</docblock>
|
461 |
-
<argument line="
|
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="
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
468 |
<name>mla_fetch_attachment_metadata</name>
|
469 |
<full_name>mla_fetch_attachment_metadata</full_name>
|
470 |
-
<docblock line="
|
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="
|
476 |
-
<tag line="
|
477 |
<type by_reference="false">int</type>
|
478 |
</tag>
|
479 |
-
<tag line="
|
480 |
<type by_reference="false">array</type>
|
481 |
</tag>
|
482 |
</docblock>
|
483 |
-
<argument line="
|
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="
|
490 |
<name>mla_fetch_attachment_references</name>
|
491 |
<full_name>mla_fetch_attachment_references</full_name>
|
492 |
-
<docblock line="
|
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="
|
497 |
-
<tag line="
|
498 |
<type by_reference="false">int</type>
|
499 |
</tag>
|
500 |
-
<tag line="
|
501 |
<type by_reference="false">int</type>
|
502 |
</tag>
|
503 |
-
<tag line="
|
504 |
<type by_reference="false">array</type>
|
505 |
</tag>
|
506 |
</docblock>
|
507 |
-
<argument line="
|
508 |
<name>$ID</name>
|
509 |
<default><![CDATA[]]></default>
|
510 |
<type/>
|
511 |
</argument>
|
512 |
-
<argument line="
|
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="
|
519 |
<name>mla_flush_mla_galleries</name>
|
520 |
<full_name>mla_flush_mla_galleries</full_name>
|
521 |
-
<docblock line="
|
522 |
<description><![CDATA[Invalidates the $mla_galleries or $galleries array and cached values]]></description>
|
523 |
<long-description><![CDATA[]]></long-description>
|
524 |
-
<tag line="
|
525 |
-
<tag line="
|
526 |
<type by_reference="false">string</type>
|
527 |
</tag>
|
528 |
-
<tag line="
|
529 |
<type by_reference="false">void</type>
|
530 |
</tag>
|
531 |
</docblock>
|
532 |
-
<argument line="
|
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="
|
539 |
<name>mla_save_post_action</name>
|
540 |
<full_name>mla_save_post_action</full_name>
|
541 |
-
<docblock line="
|
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="
|
545 |
-
<tag line="
|
546 |
<type by_reference="false">integer</type>
|
547 |
</tag>
|
548 |
-
<tag line="
|
549 |
<type by_reference="false">void</type>
|
550 |
</tag>
|
551 |
</docblock>
|
552 |
-
<argument line="
|
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="
|
559 |
<name>_build_mla_galleries</name>
|
560 |
<full_name>_build_mla_galleries</full_name>
|
561 |
-
<docblock line="
|
562 |
<description><![CDATA[Builds the $mla_galleries or $galleries array]]></description>
|
563 |
<long-description><![CDATA[]]></long-description>
|
564 |
-
<tag line="
|
565 |
-
<tag line="
|
566 |
<type by_reference="false">string</type>
|
567 |
</tag>
|
568 |
-
<tag line="
|
569 |
<type by_reference="false">array</type>
|
570 |
</tag>
|
571 |
-
<tag line="
|
572 |
<type by_reference="false">string</type>
|
573 |
</tag>
|
574 |
-
<tag line="
|
575 |
<type by_reference="false">boolean</type>
|
576 |
</tag>
|
577 |
-
<tag line="
|
578 |
<type by_reference="false">boolean</type>
|
579 |
</tag>
|
580 |
</docblock>
|
581 |
-
<argument line="
|
582 |
<name>$option_name</name>
|
583 |
<default><![CDATA[]]></default>
|
584 |
<type/>
|
585 |
</argument>
|
586 |
-
<argument line="
|
587 |
<name>$galleries_array</name>
|
588 |
<default><![CDATA[]]></default>
|
589 |
<type/>
|
590 |
</argument>
|
591 |
-
<argument line="
|
592 |
<name>$shortcode</name>
|
593 |
<default><![CDATA[]]></default>
|
594 |
<type/>
|
595 |
</argument>
|
596 |
-
<argument line="
|
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="
|
603 |
<name>_search_mla_galleries</name>
|
604 |
<full_name>_search_mla_galleries</full_name>
|
605 |
-
<docblock line="
|
606 |
<description><![CDATA[Search the $mla_galleries or $galleries array]]></description>
|
607 |
<long-description><![CDATA[]]></long-description>
|
608 |
-
<tag line="
|
609 |
-
<tag line="
|
610 |
<type by_reference="false">array</type>
|
611 |
</tag>
|
612 |
-
<tag line="
|
613 |
<type by_reference="false">int</type>
|
614 |
</tag>
|
615 |
-
<tag line="
|
616 |
<type by_reference="false">array</type>
|
617 |
</tag>
|
618 |
</docblock>
|
619 |
-
<argument line="
|
620 |
<name>$galleries_array</name>
|
621 |
<default><![CDATA[]]></default>
|
622 |
<type/>
|
623 |
</argument>
|
624 |
-
<argument line="
|
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="
|
631 |
<name>mla_exif_metadata_value</name>
|
632 |
<full_name>mla_exif_metadata_value</full_name>
|
633 |
-
<docblock line="
|
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="
|
638 |
-
<tag line="
|
639 |
<type by_reference="false">string</type>
|
640 |
</tag>
|
641 |
-
<tag line="
|
642 |
<type by_reference="false">string</type>
|
643 |
</tag>
|
644 |
-
<tag line="
|
645 |
<type by_reference="false">string</type>
|
646 |
</tag>
|
647 |
</docblock>
|
648 |
-
<argument line="
|
649 |
<name>$key</name>
|
650 |
<default><![CDATA[]]></default>
|
651 |
<type/>
|
652 |
</argument>
|
653 |
-
<argument line="
|
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="
|
660 |
<name>mla_fetch_attachment_image_metadata</name>
|
661 |
<full_name>mla_fetch_attachment_image_metadata</full_name>
|
662 |
-
<docblock line="
|
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="
|
666 |
-
<tag line="
|
667 |
<type by_reference="false">int</type>
|
668 |
</tag>
|
669 |
-
<tag line="
|
670 |
<type by_reference="false">string</type>
|
671 |
</tag>
|
672 |
-
<tag line="
|
673 |
<type by_reference="false">array</type>
|
674 |
</tag>
|
675 |
</docblock>
|
676 |
-
<argument line="
|
677 |
<name>$post_id</name>
|
678 |
<default><![CDATA[]]></default>
|
679 |
<type/>
|
680 |
</argument>
|
681 |
-
<argument line="
|
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="
|
688 |
<name>mla_update_single_item</name>
|
689 |
<full_name>mla_update_single_item</full_name>
|
690 |
-
<docblock line="
|
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="
|
695 |
-
<tag line="
|
696 |
<type by_reference="false">int</type>
|
697 |
</tag>
|
698 |
-
<tag line="
|
699 |
<type by_reference="false">array</type>
|
700 |
</tag>
|
701 |
-
<tag line="
|
702 |
<type by_reference="false">array</type>
|
703 |
</tag>
|
704 |
-
<tag line="
|
705 |
<type by_reference="false">array</type>
|
706 |
</tag>
|
707 |
-
<tag line="
|
708 |
<type by_reference="false">array</type>
|
709 |
</tag>
|
710 |
</docblock>
|
711 |
-
<argument line="
|
712 |
<name>$post_id</name>
|
713 |
<default><![CDATA[]]></default>
|
714 |
<type/>
|
715 |
</argument>
|
716 |
-
<argument line="
|
717 |
<name>$new_data</name>
|
718 |
<default><![CDATA[]]></default>
|
719 |
<type/>
|
720 |
</argument>
|
721 |
-
<argument line="
|
722 |
<name>$tax_input</name>
|
723 |
<default><![CDATA[NULL]]></default>
|
724 |
<type/>
|
725 |
</argument>
|
726 |
-
<argument line="
|
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="
|
733 |
<name>_remove_tags</name>
|
734 |
<full_name>_remove_tags</full_name>
|
735 |
-
<docblock line="
|
736 |
<description><![CDATA[Remove tags from a term ids list]]></description>
|
737 |
<long-description><![CDATA[]]></long-description>
|
738 |
-
<tag line="
|
739 |
-
<tag line="
|
740 |
<type by_reference="false">array</type>
|
741 |
</tag>
|
742 |
-
<tag line="
|
743 |
<type by_reference="false">array</type>
|
744 |
</tag>
|
745 |
-
<tag line="
|
746 |
<type by_reference="false">object</type>
|
747 |
</tag>
|
748 |
-
<tag line="
|
749 |
<type by_reference="false">array</type>
|
750 |
</tag>
|
751 |
</docblock>
|
752 |
-
<argument line="
|
753 |
<name>$terms_before</name>
|
754 |
<default><![CDATA[]]></default>
|
755 |
<type/>
|
756 |
</argument>
|
757 |
-
<argument line="
|
758 |
<name>$tags</name>
|
759 |
<default><![CDATA[]]></default>
|
760 |
<type/>
|
761 |
</argument>
|
762 |
-
<argument line="
|
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="
|
769 |
<name>_hex_dump</name>
|
770 |
<full_name>_hex_dump</full_name>
|
771 |
-
<docblock line="
|
772 |
<description><![CDATA[Format printable version of binary data]]></description>
|
773 |
<long-description><![CDATA[]]></long-description>
|
774 |
-
<tag line="
|
775 |
-
<tag line="
|
776 |
<type by_reference="false">string</type>
|
777 |
</tag>
|
778 |
-
<tag line="
|
779 |
<type by_reference="false">integer</type>
|
780 |
</tag>
|
781 |
-
<tag line="
|
782 |
<type by_reference="false">\intger</type>
|
783 |
</tag>
|
784 |
-
<tag line="
|
785 |
<type by_reference="false">string</type>
|
786 |
</tag>
|
787 |
</docblock>
|
788 |
-
<argument line="
|
789 |
<name>$data</name>
|
790 |
<default><![CDATA[]]></default>
|
791 |
<type/>
|
792 |
</argument>
|
793 |
-
<argument line="
|
794 |
<name>$limit</name>
|
795 |
<default><![CDATA[0]]></default>
|
796 |
<type/>
|
797 |
</argument>
|
798 |
-
<argument line="
|
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="
|
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="
|
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="
|
1402 |
<name>column_cb</name>
|
1403 |
<full_name>column_cb</full_name>
|
1404 |
-
<docblock line="
|
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="
|
1409 |
-
<tag line="
|
1410 |
<type by_reference="false">array</type>
|
1411 |
</tag>
|
1412 |
-
<tag line="
|
1413 |
<type by_reference="false">string</type>
|
1414 |
</tag>
|
1415 |
</docblock>
|
1416 |
-
<argument line="
|
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="
|
1423 |
<name>column_icon</name>
|
1424 |
<full_name>column_icon</full_name>
|
1425 |
-
<docblock line="
|
1426 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1427 |
<long-description><![CDATA[]]></long-description>
|
1428 |
-
<tag line="
|
1429 |
-
<tag line="
|
1430 |
<type by_reference="false">array</type>
|
1431 |
</tag>
|
1432 |
-
<tag line="
|
1433 |
<type by_reference="false">string</type>
|
1434 |
</tag>
|
1435 |
</docblock>
|
1436 |
-
<argument line="
|
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="
|
1443 |
<name>_build_rollover_actions</name>
|
1444 |
<full_name>_build_rollover_actions</full_name>
|
1445 |
-
<docblock line="
|
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="
|
1450 |
-
<tag line="
|
1451 |
<type by_reference="false">object</type>
|
1452 |
</tag>
|
1453 |
-
<tag line="
|
1454 |
<type by_reference="false">string</type>
|
1455 |
</tag>
|
1456 |
-
<tag line="
|
1457 |
<type by_reference="false">array</type>
|
1458 |
</tag>
|
1459 |
</docblock>
|
1460 |
-
<argument line="
|
1461 |
<name>$item</name>
|
1462 |
<default><![CDATA[]]></default>
|
1463 |
<type/>
|
1464 |
</argument>
|
1465 |
-
<argument line="
|
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="
|
1472 |
<name>_build_inline_data</name>
|
1473 |
<full_name>_build_inline_data</full_name>
|
1474 |
-
<docblock line="
|
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="
|
1478 |
-
<tag line="
|
1479 |
<type by_reference="false">object</type>
|
1480 |
</tag>
|
1481 |
-
<tag line="
|
1482 |
<type by_reference="false">string</type>
|
1483 |
</tag>
|
1484 |
</docblock>
|
1485 |
-
<argument line="
|
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="
|
1492 |
<name>column_ID_parent</name>
|
1493 |
<full_name>column_ID_parent</full_name>
|
1494 |
-
<docblock line="
|
1495 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1496 |
<long-description><![CDATA[]]></long-description>
|
1497 |
-
<tag line="
|
1498 |
-
<tag line="
|
1499 |
<type by_reference="false">array</type>
|
1500 |
</tag>
|
1501 |
-
<tag line="
|
1502 |
<type by_reference="false">string</type>
|
1503 |
</tag>
|
1504 |
</docblock>
|
1505 |
-
<argument line="
|
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="
|
1512 |
<name>column_title_name</name>
|
1513 |
<full_name>column_title_name</full_name>
|
1514 |
-
<docblock line="
|
1515 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1516 |
<long-description><![CDATA[]]></long-description>
|
1517 |
-
<tag line="
|
1518 |
-
<tag line="
|
1519 |
<type by_reference="false">array</type>
|
1520 |
</tag>
|
1521 |
-
<tag line="
|
1522 |
<type by_reference="false">string</type>
|
1523 |
</tag>
|
1524 |
</docblock>
|
1525 |
-
<argument line="
|
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="
|
1532 |
<name>column_post_title</name>
|
1533 |
<full_name>column_post_title</full_name>
|
1534 |
-
<docblock line="
|
1535 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1536 |
<long-description><![CDATA[]]></long-description>
|
1537 |
-
<tag line="
|
1538 |
-
<tag line="
|
1539 |
<type by_reference="false">array</type>
|
1540 |
</tag>
|
1541 |
-
<tag line="
|
1542 |
<type by_reference="false">string</type>
|
1543 |
</tag>
|
1544 |
</docblock>
|
1545 |
-
<argument line="
|
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="
|
1552 |
<name>column_post_name</name>
|
1553 |
<full_name>column_post_name</full_name>
|
1554 |
-
<docblock line="
|
1555 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1556 |
<long-description><![CDATA[]]></long-description>
|
1557 |
-
<tag line="
|
1558 |
-
<tag line="
|
1559 |
<type by_reference="false">array</type>
|
1560 |
</tag>
|
1561 |
-
<tag line="
|
1562 |
<type by_reference="false">string</type>
|
1563 |
</tag>
|
1564 |
</docblock>
|
1565 |
-
<argument line="
|
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="
|
1572 |
<name>column_parent</name>
|
1573 |
<full_name>column_parent</full_name>
|
1574 |
-
<docblock line="
|
1575 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1576 |
<long-description><![CDATA[]]></long-description>
|
1577 |
-
<tag line="
|
1578 |
-
<tag line="
|
1579 |
<type by_reference="false">array</type>
|
1580 |
</tag>
|
1581 |
-
<tag line="
|
1582 |
<type by_reference="false">string</type>
|
1583 |
</tag>
|
1584 |
</docblock>
|
1585 |
-
<argument line="
|
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="
|
1592 |
<name>column_menu_order</name>
|
1593 |
<full_name>column_menu_order</full_name>
|
1594 |
-
<docblock line="
|
1595 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1596 |
<long-description><![CDATA[]]></long-description>
|
1597 |
-
<tag line="
|
1598 |
-
<tag line="
|
1599 |
<type by_reference="false">array</type>
|
1600 |
</tag>
|
1601 |
-
<tag line="
|
1602 |
<type by_reference="false">string</type>
|
1603 |
</tag>
|
1604 |
</docblock>
|
1605 |
-
<argument line="
|
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="
|
1612 |
<name>column_featured</name>
|
1613 |
<full_name>column_featured</full_name>
|
1614 |
-
<docblock line="
|
1615 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1616 |
<long-description><![CDATA[]]></long-description>
|
1617 |
-
<tag line="
|
1618 |
-
<tag line="
|
1619 |
<type by_reference="false">array</type>
|
1620 |
</tag>
|
1621 |
-
<tag line="
|
1622 |
<type by_reference="false">string</type>
|
1623 |
</tag>
|
1624 |
</docblock>
|
1625 |
-
<argument line="
|
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="
|
1632 |
<name>column_inserted</name>
|
1633 |
<full_name>column_inserted</full_name>
|
1634 |
-
<docblock line="
|
1635 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1636 |
<long-description><![CDATA[]]></long-description>
|
1637 |
-
<tag line="
|
1638 |
-
<tag line="
|
1639 |
<type by_reference="false">array</type>
|
1640 |
</tag>
|
1641 |
-
<tag line="
|
1642 |
<type by_reference="false">string</type>
|
1643 |
</tag>
|
1644 |
</docblock>
|
1645 |
-
<argument line="
|
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="
|
1652 |
<name>column_galleries</name>
|
1653 |
<full_name>column_galleries</full_name>
|
1654 |
-
<docblock line="
|
1655 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1656 |
<long-description><![CDATA[]]></long-description>
|
1657 |
-
<tag line="
|
1658 |
-
<tag line="
|
1659 |
<type by_reference="false">array</type>
|
1660 |
</tag>
|
1661 |
-
<tag line="
|
1662 |
<type by_reference="false">string</type>
|
1663 |
</tag>
|
1664 |
</docblock>
|
1665 |
-
<argument line="
|
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="
|
1672 |
<name>column_mla_galleries</name>
|
1673 |
<full_name>column_mla_galleries</full_name>
|
1674 |
-
<docblock line="
|
1675 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1676 |
<long-description><![CDATA[]]></long-description>
|
1677 |
-
<tag line="
|
1678 |
-
<tag line="
|
1679 |
<type by_reference="false">array</type>
|
1680 |
</tag>
|
1681 |
-
<tag line="
|
1682 |
<type by_reference="false">string</type>
|
1683 |
</tag>
|
1684 |
</docblock>
|
1685 |
-
<argument line="
|
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="
|
1692 |
<name>column_alt_text</name>
|
1693 |
<full_name>column_alt_text</full_name>
|
1694 |
-
<docblock line="
|
1695 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1696 |
<long-description><![CDATA[]]></long-description>
|
1697 |
-
<tag line="
|
1698 |
-
<tag line="
|
1699 |
<type by_reference="false">array</type>
|
1700 |
</tag>
|
1701 |
-
<tag line="
|
1702 |
<type by_reference="false">string</type>
|
1703 |
</tag>
|
1704 |
</docblock>
|
1705 |
-
<argument line="
|
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="
|
1712 |
<name>column_caption</name>
|
1713 |
<full_name>column_caption</full_name>
|
1714 |
-
<docblock line="
|
1715 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1716 |
<long-description><![CDATA[]]></long-description>
|
1717 |
-
<tag line="
|
1718 |
-
<tag line="
|
1719 |
<type by_reference="false">array</type>
|
1720 |
</tag>
|
1721 |
-
<tag line="
|
1722 |
<type by_reference="false">string</type>
|
1723 |
</tag>
|
1724 |
</docblock>
|
1725 |
-
<argument line="
|
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="
|
1732 |
<name>column_description</name>
|
1733 |
<full_name>column_description</full_name>
|
1734 |
-
<docblock line="
|
1735 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1736 |
<long-description><![CDATA[]]></long-description>
|
1737 |
-
<tag line="
|
1738 |
-
<tag line="
|
1739 |
<type by_reference="false">array</type>
|
1740 |
</tag>
|
1741 |
-
<tag line="
|
1742 |
<type by_reference="false">string</type>
|
1743 |
</tag>
|
1744 |
</docblock>
|
1745 |
-
<argument line="
|
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="
|
1752 |
<name>column_post_mime_type</name>
|
1753 |
<full_name>column_post_mime_type</full_name>
|
1754 |
-
<docblock line="
|
1755 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1756 |
<long-description><![CDATA[]]></long-description>
|
1757 |
-
<tag line="
|
1758 |
-
<tag line="
|
1759 |
<type by_reference="false">array</type>
|
1760 |
</tag>
|
1761 |
-
<tag line="
|
1762 |
<type by_reference="false">string</type>
|
1763 |
</tag>
|
1764 |
</docblock>
|
1765 |
-
<argument line="
|
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="
|
1772 |
<name>column_base_file</name>
|
1773 |
<full_name>column_base_file</full_name>
|
1774 |
-
<docblock line="
|
1775 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1776 |
<long-description><![CDATA[]]></long-description>
|
1777 |
-
<tag line="
|
1778 |
-
<tag line="
|
1779 |
<type by_reference="false">array</type>
|
1780 |
</tag>
|
1781 |
-
<tag line="
|
1782 |
<type by_reference="false">string</type>
|
1783 |
</tag>
|
1784 |
</docblock>
|
1785 |
-
<argument line="
|
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="
|
1792 |
<name>column_date</name>
|
1793 |
<full_name>column_date</full_name>
|
1794 |
-
<docblock line="
|
1795 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1796 |
<long-description><![CDATA[]]></long-description>
|
1797 |
-
<tag line="
|
1798 |
-
<tag line="
|
1799 |
<type by_reference="false">array</type>
|
1800 |
</tag>
|
1801 |
-
<tag line="
|
1802 |
<type by_reference="false">string</type>
|
1803 |
</tag>
|
1804 |
</docblock>
|
1805 |
-
<argument line="
|
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="
|
1812 |
<name>column_modified</name>
|
1813 |
<full_name>column_modified</full_name>
|
1814 |
-
<docblock line="
|
1815 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1816 |
<long-description><![CDATA[]]></long-description>
|
1817 |
-
<tag line="
|
1818 |
-
<tag line="
|
1819 |
<type by_reference="false">array</type>
|
1820 |
</tag>
|
1821 |
-
<tag line="
|
1822 |
<type by_reference="false">string</type>
|
1823 |
</tag>
|
1824 |
</docblock>
|
1825 |
-
<argument line="
|
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="
|
1832 |
<name>column_author</name>
|
1833 |
<full_name>column_author</full_name>
|
1834 |
-
<docblock line="
|
1835 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1836 |
<long-description><![CDATA[]]></long-description>
|
1837 |
-
<tag line="
|
1838 |
-
<tag line="
|
1839 |
<type by_reference="false">array</type>
|
1840 |
</tag>
|
1841 |
-
<tag line="
|
1842 |
<type by_reference="false">string</type>
|
1843 |
</tag>
|
1844 |
</docblock>
|
1845 |
-
<argument line="
|
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="
|
1852 |
<name>column_attached_to</name>
|
1853 |
<full_name>column_attached_to</full_name>
|
1854 |
-
<docblock line="
|
1855 |
<description><![CDATA[Supply the content for a custom column]]></description>
|
1856 |
<long-description><![CDATA[]]></long-description>
|
1857 |
-
<tag line="
|
1858 |
-
<tag line="
|
1859 |
<type by_reference="false">array</type>
|
1860 |
</tag>
|
1861 |
-
<tag line="
|
1862 |
<type by_reference="false">string</type>
|
1863 |
</tag>
|
1864 |
</docblock>
|
1865 |
-
<argument line="
|
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="
|
1872 |
<name>get_columns</name>
|
1873 |
<full_name>get_columns</full_name>
|
1874 |
-
<docblock line="
|
1875 |
<description><![CDATA[This method dictates the table's columns and titles]]></description>
|
1876 |
<long-description><![CDATA[]]></long-description>
|
1877 |
-
<tag line="
|
1878 |
-
<tag line="
|
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="
|
1884 |
<name>get_hidden_columns</name>
|
1885 |
<full_name>get_hidden_columns</full_name>
|
1886 |
-
<docblock line="
|
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="
|
1891 |
-
<tag line="
|
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="
|
1897 |
<name>get_sortable_columns</name>
|
1898 |
<full_name>get_sortable_columns</full_name>
|
1899 |
-
<docblock line="
|
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="
|
1905 |
-
<tag line="
|
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="
|
1911 |
<name>get_views</name>
|
1912 |
<full_name>get_views</full_name>
|
1913 |
-
<docblock line="
|
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="
|
1917 |
-
<tag line="
|
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="
|
1923 |
<name>get_bulk_actions</name>
|
1924 |
<full_name>get_bulk_actions</full_name>
|
1925 |
-
<docblock line="
|
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="
|
1930 |
-
<tag line="
|
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="
|
1936 |
<name>extra_tablenav</name>
|
1937 |
<full_name>extra_tablenav</full_name>
|
1938 |
-
<docblock line="
|
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="
|
1942 |
-
<tag line="
|
1943 |
<type by_reference="false">string</type>
|
1944 |
</tag>
|
1945 |
-
<tag line="
|
1946 |
<type by_reference="false">array</type>
|
1947 |
</tag>
|
1948 |
</docblock>
|
1949 |
-
<argument line="
|
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="
|
1956 |
<name>prepare_items</name>
|
1957 |
<full_name>prepare_items</full_name>
|
1958 |
-
<docblock line="
|
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="
|
1965 |
-
<tag line="
|
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="
|
1971 |
<name>single_row</name>
|
1972 |
<full_name>single_row</full_name>
|
1973 |
-
<docblock line="
|
1974 |
<description><![CDATA[Generates (echoes) content for a single row of the table]]></description>
|
1975 |
<long-description><![CDATA[]]></long-description>
|
1976 |
-
<tag line="
|
1977 |
-
<tag line="
|
1978 |
<type by_reference="false">object</type>
|
1979 |
</tag>
|
1980 |
-
<tag line="
|
1981 |
<type by_reference="false">void</type>
|
1982 |
</tag>
|
1983 |
</docblock>
|
1984 |
-
<argument line="
|
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="
|
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.
|
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="
|
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="
|
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="
|
2561 |
<name>_restore_single_item</name>
|
2562 |
<full_name>_restore_single_item</full_name>
|
2563 |
-
<docblock line="
|
2564 |
<description><![CDATA[Restore a single item from the Trash]]></description>
|
2565 |
<long-description><![CDATA[]]></long-description>
|
2566 |
-
<tag line="
|
2567 |
-
<tag line="
|
2568 |
<type by_reference="false">array</type>
|
2569 |
</tag>
|
2570 |
-
<tag line="
|
2571 |
<type by_reference="false">array</type>
|
2572 |
</tag>
|
2573 |
</docblock>
|
2574 |
-
<argument line="
|
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="
|
2581 |
<name>_trash_single_item</name>
|
2582 |
<full_name>_trash_single_item</full_name>
|
2583 |
-
<docblock line="
|
2584 |
<description><![CDATA[Move a single item to Trash]]></description>
|
2585 |
<long-description><![CDATA[]]></long-description>
|
2586 |
-
<tag line="
|
2587 |
-
<tag line="
|
2588 |
<type by_reference="false">array</type>
|
2589 |
</tag>
|
2590 |
-
<tag line="
|
2591 |
<type by_reference="false">array</type>
|
2592 |
</tag>
|
2593 |
</docblock>
|
2594 |
-
<argument line="
|
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="
|
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="
|
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="
|
2871 |
<name>mla_taxonomy_get_columns_filter</name>
|
2872 |
<full_name>mla_taxonomy_get_columns_filter</full_name>
|
2873 |
-
<docblock line="
|
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="
|
2878 |
-
<tag line="
|
2879 |
<type by_reference="false">array</type>
|
2880 |
</tag>
|
2881 |
-
<tag line="
|
2882 |
<type by_reference="false">array</type>
|
2883 |
</tag>
|
2884 |
</docblock>
|
2885 |
-
<argument line="
|
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="
|
2892 |
<name>mla_taxonomy_column_filter</name>
|
2893 |
<full_name>mla_taxonomy_column_filter</full_name>
|
2894 |
-
<docblock line="
|
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="
|
2899 |
-
<tag line="
|
2900 |
<type by_reference="false">string</type>
|
2901 |
</tag>
|
2902 |
-
<tag line="
|
2903 |
<type by_reference="false">array</type>
|
2904 |
</tag>
|
2905 |
-
<tag line="
|
2906 |
<type by_reference="false">array</type>
|
2907 |
</tag>
|
2908 |
-
<tag line="
|
2909 |
<type by_reference="false">array</type>
|
2910 |
</tag>
|
2911 |
</docblock>
|
2912 |
-
<argument line="
|
2913 |
<name>$place_holder</name>
|
2914 |
<default><![CDATA[]]></default>
|
2915 |
<type/>
|
2916 |
</argument>
|
2917 |
-
<argument line="
|
2918 |
<name>$column_name</name>
|
2919 |
<default><![CDATA[]]></default>
|
2920 |
<type/>
|
2921 |
</argument>
|
2922 |
-
<argument line="
|
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="
|
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> Dynamic = once every page load, Cached = once every login, Disabled = never.<br> 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> Dynamic = once every page load, Cached = once every login, Disabled = never.<br> 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> Click Save Changes at the bottom of the screen if you change this option.<br> Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'), 'custom_field_mapping' => array('tab' => '', 'help' => ' <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> 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="
|
3134 |
<name>$mla_option_templates</name>
|
3135 |
<default><![CDATA[null]]></default>
|
3136 |
-
<docblock line="
|
3137 |
<description><![CDATA[Style and Markup templates]]></description>
|
3138 |
<long-description><![CDATA[]]></long-description>
|
3139 |
-
<tag line="
|
3140 |
-
<tag line="
|
3141 |
<type by_reference="false">array</type>
|
3142 |
</tag>
|
3143 |
</docblock>
|
3144 |
</property>
|
3145 |
-
<property final="false" static="true" visibility="private" line="
|
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="
|
3149 |
<description><![CDATA[Array of Data Source names for custom field mapping]]></description>
|
3150 |
<long-description><![CDATA[]]></long-description>
|
3151 |
-
<tag line="
|
3152 |
-
<tag line="
|
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="
|
3158 |
<name>initialize</name>
|
3159 |
<full_name>initialize</full_name>
|
3160 |
-
<docblock line="
|
3161 |
<description><![CDATA[Initialization function, similar to __construct()]]></description>
|
3162 |
<long-description><![CDATA[]]></long-description>
|
3163 |
-
<tag line="
|
3164 |
-
<tag line="
|
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="
|
3170 |
<name>_load_option_templates</name>
|
3171 |
<full_name>_load_option_templates</full_name>
|
3172 |
-
<docblock line="
|
3173 |
<description><![CDATA[Load style and markup templates to $mla_templates]]></description>
|
3174 |
<long-description><![CDATA[]]></long-description>
|
3175 |
-
<tag line="
|
3176 |
-
<tag line="
|
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="
|
3182 |
<name>mla_fetch_gallery_template</name>
|
3183 |
<full_name>mla_fetch_gallery_template</full_name>
|
3184 |
-
<docblock line="
|
3185 |
<description><![CDATA[Fetch style or markup template from $mla_templates]]></description>
|
3186 |
<long-description><![CDATA[]]></long-description>
|
3187 |
-
<tag line="
|
3188 |
-
<tag line="
|
3189 |
<type by_reference="false">string</type>
|
3190 |
</tag>
|
3191 |
-
<tag line="
|
3192 |
<type by_reference="false">string</type>
|
3193 |
</tag>
|
3194 |
-
<tag line="
|
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="
|
3201 |
<name>$key</name>
|
3202 |
<default><![CDATA[]]></default>
|
3203 |
<type/>
|
3204 |
</argument>
|
3205 |
-
<argument line="
|
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="
|
3212 |
<name>mla_get_style_templates</name>
|
3213 |
<full_name>mla_get_style_templates</full_name>
|
3214 |
-
<docblock line="
|
3215 |
<description><![CDATA[Get ALL style templates from $mla_templates, including 'default']]></description>
|
3216 |
<long-description><![CDATA[]]></long-description>
|
3217 |
-
<tag line="
|
3218 |
-
<tag line="
|
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="
|
3225 |
<name>mla_put_style_templates</name>
|
3226 |
<full_name>mla_put_style_templates</full_name>
|
3227 |
-
<docblock line="
|
3228 |
<description><![CDATA[Put user-defined style templates to $mla_templates and database]]></description>
|
3229 |
<long-description><![CDATA[]]></long-description>
|
3230 |
-
<tag line="
|
3231 |
-
<tag line="
|
3232 |
<type by_reference="false">array</type>
|
3233 |
</tag>
|
3234 |
-
<tag line="
|
3235 |
<type by_reference="false">boolean</type>
|
3236 |
</tag>
|
3237 |
</docblock>
|
3238 |
-
<argument line="
|
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="
|
3245 |
<name>mla_get_markup_templates</name>
|
3246 |
<full_name>mla_get_markup_templates</full_name>
|
3247 |
-
<docblock line="
|
3248 |
<description><![CDATA[Get ALL markup templates from $mla_templates, including 'default']]></description>
|
3249 |
<long-description><![CDATA[]]></long-description>
|
3250 |
-
<tag line="
|
3251 |
-
<tag line="
|
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="
|
3258 |
<name>mla_put_markup_templates</name>
|
3259 |
<full_name>mla_put_markup_templates</full_name>
|
3260 |
-
<docblock line="
|
3261 |
<description><![CDATA[Put user-defined markup templates to $mla_templates and database]]></description>
|
3262 |
<long-description><![CDATA[]]></long-description>
|
3263 |
-
<tag line="
|
3264 |
-
<tag line="
|
3265 |
<type by_reference="false">array</type>
|
3266 |
</tag>
|
3267 |
-
<tag line="
|
3268 |
<type by_reference="false">boolean</type>
|
3269 |
</tag>
|
3270 |
</docblock>
|
3271 |
-
<argument line="
|
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="
|
3278 |
<name>mla_get_option</name>
|
3279 |
<full_name>mla_get_option</full_name>
|
3280 |
-
<docblock line="
|
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="
|
3284 |
-
<tag line="
|
3285 |
<type by_reference="false">string</type>
|
3286 |
</tag>
|
3287 |
-
<tag line="
|
3288 |
<type by_reference="false">mixed</type>
|
3289 |
</tag>
|
3290 |
</docblock>
|
3291 |
-
<argument line="
|
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="
|
3298 |
<name>mla_update_option</name>
|
3299 |
<full_name>mla_update_option</full_name>
|
3300 |
-
<docblock line="
|
3301 |
<description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
|
3302 |
<long-description><![CDATA[]]></long-description>
|
3303 |
-
<tag line="
|
3304 |
-
<tag line="
|
3305 |
<type by_reference="false">string</type>
|
3306 |
</tag>
|
3307 |
-
<tag line="
|
3308 |
<type by_reference="false">mixed</type>
|
3309 |
</tag>
|
3310 |
-
<tag line="
|
3311 |
<type by_reference="false">boolean</type>
|
3312 |
</tag>
|
3313 |
</docblock>
|
3314 |
-
<argument line="
|
3315 |
<name>$option</name>
|
3316 |
<default><![CDATA[]]></default>
|
3317 |
<type/>
|
3318 |
</argument>
|
3319 |
-
<argument line="
|
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="
|
3326 |
<name>mla_delete_option</name>
|
3327 |
<full_name>mla_delete_option</full_name>
|
3328 |
-
<docblock line="
|
3329 |
<description><![CDATA[Delete the stored value of a defined MLA option]]></description>
|
3330 |
<long-description><![CDATA[]]></long-description>
|
3331 |
-
<tag line="
|
3332 |
-
<tag line="
|
3333 |
<type by_reference="false">string</type>
|
3334 |
</tag>
|
3335 |
-
<tag line="
|
3336 |
<type by_reference="false">boolean</type>
|
3337 |
</tag>
|
3338 |
</docblock>
|
3339 |
-
<argument line="
|
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="
|
3346 |
<name>mla_taxonomy_support</name>
|
3347 |
<full_name>mla_taxonomy_support</full_name>
|
3348 |
-
<docblock line="
|
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="
|
3353 |
-
<tag line="
|
3354 |
<type by_reference="false">string</type>
|
3355 |
</tag>
|
3356 |
-
<tag line="
|
3357 |
<type by_reference="false">string</type>
|
3358 |
</tag>
|
3359 |
-
<tag line="
|
3360 |
<type by_reference="false">boolean</type>
|
3361 |
<type by_reference="false">string</type>
|
3362 |
</tag>
|
3363 |
</docblock>
|
3364 |
-
<argument line="
|
3365 |
<name>$tax_name</name>
|
3366 |
<default><![CDATA[]]></default>
|
3367 |
<type/>
|
3368 |
</argument>
|
3369 |
-
<argument line="
|
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="
|
3376 |
<name>mla_taxonomy_option_handler</name>
|
3377 |
<full_name>mla_taxonomy_option_handler</full_name>
|
3378 |
-
<docblock line="
|
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="
|
3382 |
-
<tag line="
|
3383 |
-
<tag line="
|
3384 |
<type by_reference="false">string</type>
|
3385 |
</tag>
|
3386 |
-
<tag line="
|
3387 |
<type by_reference="false">string</type>
|
3388 |
</tag>
|
3389 |
-
<tag line="
|
3390 |
<type by_reference="false">array</type>
|
3391 |
</tag>
|
3392 |
-
<tag line="
|
3393 |
<type by_reference="false">array</type>
|
3394 |
</tag>
|
3395 |
-
<tag line="
|
3396 |
<type by_reference="false">string</type>
|
3397 |
</tag>
|
3398 |
</docblock>
|
3399 |
-
<argument line="
|
3400 |
<name>$action</name>
|
3401 |
<default><![CDATA[]]></default>
|
3402 |
<type/>
|
3403 |
</argument>
|
3404 |
-
<argument line="
|
3405 |
<name>$key</name>
|
3406 |
<default><![CDATA[]]></default>
|
3407 |
<type/>
|
3408 |
</argument>
|
3409 |
-
<argument line="
|
3410 |
<name>$value</name>
|
3411 |
<default><![CDATA[]]></default>
|
3412 |
<type/>
|
3413 |
</argument>
|
3414 |
-
<argument line="
|
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="
|
3421 |
<name>mla_add_attachment_action</name>
|
3422 |
<full_name>mla_add_attachment_action</full_name>
|
3423 |
-
<docblock line="
|
3424 |
<description><![CDATA[Perform ITC/EXIF mapping on just-inserted attachment]]></description>
|
3425 |
<long-description><![CDATA[]]></long-description>
|
3426 |
-
<tag line="
|
3427 |
-
<tag line="
|
3428 |
<type by_reference="false">integer</type>
|
3429 |
</tag>
|
3430 |
-
<tag line="
|
3431 |
<type by_reference="false">void</type>
|
3432 |
</tag>
|
3433 |
</docblock>
|
3434 |
-
<argument line="
|
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="
|
3441 |
<name>mla_update_attachment_metadata_filter</name>
|
3442 |
<full_name>mla_update_attachment_metadata_filter</full_name>
|
3443 |
-
<docblock line="
|
3444 |
<description><![CDATA[Perform Custom Field mapping on just-inserted or updated attachment]]></description>
|
3445 |
<long-description><![CDATA[]]></long-description>
|
3446 |
-
<tag line="
|
3447 |
-
<tag line="
|
3448 |
<type by_reference="false">array</type>
|
3449 |
</tag>
|
3450 |
-
<tag line="
|
3451 |
<type by_reference="false">integer</type>
|
3452 |
</tag>
|
3453 |
-
<tag line="
|
3454 |
<type by_reference="false">void</type>
|
3455 |
</tag>
|
3456 |
</docblock>
|
3457 |
-
<argument line="
|
3458 |
<name>$data</name>
|
3459 |
<default><![CDATA[]]></default>
|
3460 |
<type/>
|
3461 |
</argument>
|
3462 |
-
<argument line="
|
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="
|
3469 |
<name>mla_custom_field_option_value</name>
|
3470 |
<full_name>mla_custom_field_option_value</full_name>
|
3471 |
-
<docblock line="
|
3472 |
<description><![CDATA[Fetch custom field option value given a slug]]></description>
|
3473 |
<long-description><![CDATA[]]></long-description>
|
3474 |
-
<tag line="
|
3475 |
-
<tag line="
|
3476 |
<type by_reference="false">string</type>
|
3477 |
</tag>
|
3478 |
-
<tag line="
|
3479 |
<type by_reference="false">array</type>
|
3480 |
</tag>
|
3481 |
</docblock>
|
3482 |
-
<argument line="
|
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="
|
3489 |
<name>mla_custom_field_support</name>
|
3490 |
<full_name>mla_custom_field_support</full_name>
|
3491 |
-
<docblock line="
|
3492 |
<description><![CDATA[Evaluate file information for custom field mapping]]></description>
|
3493 |
<long-description><![CDATA[]]></long-description>
|
3494 |
-
<tag line="
|
3495 |
-
<tag line="
|
3496 |
<type by_reference="false">string</type>
|
3497 |
</tag>
|
3498 |
-
<tag line="
|
3499 |
<type by_reference="false">array</type>
|
3500 |
</tag>
|
3501 |
</docblock>
|
3502 |
-
<argument line="
|
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="
|
3509 |
<name>_evaluate_file_information</name>
|
3510 |
<full_name>_evaluate_file_information</full_name>
|
3511 |
-
<docblock line="
|
3512 |
<description><![CDATA[Evaluate file information for custom field mapping]]></description>
|
3513 |
<long-description><![CDATA[]]></long-description>
|
3514 |
-
<tag line="
|
3515 |
-
<tag line="
|
3516 |
<type by_reference="false">string</type>
|
3517 |
</tag>
|
3518 |
-
<tag line="
|
3519 |
<type by_reference="false">array</type>
|
3520 |
</tag>
|
3521 |
-
<tag line="
|
3522 |
<type by_reference="false">array</type>
|
3523 |
</tag>
|
3524 |
-
<tag line="
|
3525 |
<type by_reference="false">integer</type>
|
3526 |
</tag>
|
3527 |
-
<tag line="
|
3528 |
<type by_reference="false">array</type>
|
3529 |
</tag>
|
3530 |
</docblock>
|
3531 |
-
<argument line="
|
3532 |
<name>$upload_dir</name>
|
3533 |
<default><![CDATA[]]></default>
|
3534 |
<type/>
|
3535 |
</argument>
|
3536 |
-
<argument line="
|
3537 |
<name>$wp_attached_files</name>
|
3538 |
<default><![CDATA[]]></default>
|
3539 |
<type/>
|
3540 |
</argument>
|
3541 |
-
<argument line="
|
3542 |
<name>$wp_attachment_metadata</name>
|
3543 |
<default><![CDATA[]]></default>
|
3544 |
<type/>
|
3545 |
</argument>
|
3546 |
-
<argument line="
|
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="
|
3553 |
<name>_evaluate_data_source</name>
|
3554 |
<full_name>_evaluate_data_source</full_name>
|
3555 |
-
<docblock line="
|
3556 |
<description><![CDATA[Evaluate custom field mapping data source]]></description>
|
3557 |
<long-description><![CDATA[]]></long-description>
|
3558 |
-
<tag line="
|
3559 |
-
<tag line="
|
3560 |
<type by_reference="false">integer</type>
|
3561 |
</tag>
|
3562 |
-
<tag line="
|
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="
|
3569 |
-
<type by_reference="false">
|
3570 |
</tag>
|
3571 |
-
<tag line="
|
3572 |
<type by_reference="false">array</type>
|
3573 |
</tag>
|
3574 |
-
<tag line="
|
3575 |
<type by_reference="false">string</type>
|
3576 |
</tag>
|
3577 |
</docblock>
|
3578 |
-
<argument line="
|
3579 |
<name>$post_id</name>
|
3580 |
<default><![CDATA[]]></default>
|
3581 |
<type/>
|
3582 |
</argument>
|
3583 |
-
<argument line="
|
3584 |
<name>$category</name>
|
3585 |
<default><![CDATA[]]></default>
|
3586 |
<type/>
|
3587 |
</argument>
|
3588 |
-
<argument line="
|
3589 |
-
<name>$
|
3590 |
<default><![CDATA[]]></default>
|
3591 |
<type/>
|
3592 |
</argument>
|
3593 |
-
<argument line="
|
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="
|
3605 |
<name>mla_evaluate_custom_field_mapping</name>
|
3606 |
<full_name>mla_evaluate_custom_field_mapping</full_name>
|
3607 |
-
<docblock line="
|
3608 |
<description><![CDATA[Evaluate custom field mapping updates for a post]]></description>
|
3609 |
<long-description><![CDATA[]]></long-description>
|
3610 |
-
<tag line="
|
3611 |
-
<tag line="
|
3612 |
<type by_reference="false">integer</type>
|
3613 |
</tag>
|
3614 |
-
<tag line="
|
3615 |
<type by_reference="false">string</type>
|
3616 |
</tag>
|
3617 |
-
<tag line="
|
3618 |
<type by_reference="false">array</type>
|
3619 |
</tag>
|
3620 |
-
<tag line="
|
3621 |
<type by_reference="false">array</type>
|
3622 |
</tag>
|
3623 |
-
<tag line="
|
3624 |
<type by_reference="false">array</type>
|
3625 |
</tag>
|
3626 |
</docblock>
|
3627 |
-
<argument line="
|
3628 |
<name>$post_id</name>
|
3629 |
<default><![CDATA[]]></default>
|
3630 |
<type/>
|
3631 |
</argument>
|
3632 |
-
<argument line="
|
3633 |
<name>$category</name>
|
3634 |
<default><![CDATA[]]></default>
|
3635 |
<type/>
|
3636 |
</argument>
|
3637 |
-
<argument line="
|
3638 |
<name>$settings</name>
|
3639 |
<default><![CDATA[NULL]]></default>
|
3640 |
<type/>
|
3641 |
</argument>
|
3642 |
-
<argument line="
|
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="
|
3649 |
<name>_compose_custom_field_option_list</name>
|
3650 |
<full_name>_compose_custom_field_option_list</full_name>
|
3651 |
-
<docblock line="
|
3652 |
<description><![CDATA[Compose a Custom Field Options list with current selection]]></description>
|
3653 |
<long-description><![CDATA[]]></long-description>
|
3654 |
-
<tag line="
|
3655 |
-
<tag line="
|
3656 |
-
<tag line="
|
3657 |
<type by_reference="false">string</type>
|
3658 |
</tag>
|
3659 |
-
<tag line="
|
|
|
|
|
|
|
3660 |
<type by_reference="false">string</type>
|
3661 |
</tag>
|
3662 |
</docblock>
|
3663 |
-
<argument line="
|
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="
|
3670 |
<name>_compose_data_source_option_list</name>
|
3671 |
<full_name>_compose_data_source_option_list</full_name>
|
3672 |
-
<docblock line="
|
3673 |
<description><![CDATA[Compose a (Custom Field) Data Source Options list with current selection]]></description>
|
3674 |
<long-description><![CDATA[]]></long-description>
|
3675 |
-
<tag line="
|
3676 |
-
<tag line="
|
3677 |
-
<tag line="
|
3678 |
<type by_reference="false">string</type>
|
3679 |
</tag>
|
3680 |
-
<tag line="
|
3681 |
<type by_reference="false">string</type>
|
3682 |
</tag>
|
3683 |
</docblock>
|
3684 |
-
<argument line="
|
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="
|
3691 |
<name>_update_custom_field_mapping</name>
|
3692 |
<full_name>_update_custom_field_mapping</full_name>
|
3693 |
-
<docblock line="
|
3694 |
<description><![CDATA[Update custom field mappings]]></description>
|
3695 |
<long-description><![CDATA[]]></long-description>
|
3696 |
-
<tag line="
|
3697 |
-
<tag line="
|
3698 |
<type by_reference="false">array</type>
|
3699 |
</tag>
|
3700 |
-
<tag line="
|
3701 |
<type by_reference="false">array</type>
|
3702 |
</tag>
|
3703 |
-
<tag line="
|
3704 |
<type by_reference="false">array</type>
|
3705 |
</tag>
|
3706 |
</docblock>
|
3707 |
-
<argument line="
|
3708 |
<name>$current_values</name>
|
3709 |
<default><![CDATA[]]></default>
|
3710 |
<type/>
|
3711 |
</argument>
|
3712 |
-
<argument line="
|
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="
|
3719 |
<name>mla_custom_field_option_handler</name>
|
3720 |
<full_name>mla_custom_field_option_handler</full_name>
|
3721 |
-
<docblock line="
|
3722 |
<description><![CDATA[Render and manage custom field mapping options]]></description>
|
3723 |
<long-description><![CDATA[]]></long-description>
|
3724 |
-
<tag line="
|
3725 |
-
<tag line="
|
3726 |
-
<tag line="
|
3727 |
<type by_reference="false">string</type>
|
3728 |
</tag>
|
3729 |
-
<tag line="
|
3730 |
<type by_reference="false">string</type>
|
3731 |
</tag>
|
3732 |
-
<tag line="
|
3733 |
<type by_reference="false">array</type>
|
3734 |
</tag>
|
3735 |
-
<tag line="
|
3736 |
<type by_reference="false">array</type>
|
3737 |
</tag>
|
3738 |
-
<tag line="
|
3739 |
<type by_reference="false">string</type>
|
3740 |
</tag>
|
3741 |
</docblock>
|
3742 |
-
<argument line="
|
3743 |
<name>$action</name>
|
3744 |
<default><![CDATA[]]></default>
|
3745 |
<type/>
|
3746 |
</argument>
|
3747 |
-
<argument line="
|
3748 |
<name>$key</name>
|
3749 |
<default><![CDATA[]]></default>
|
3750 |
<type/>
|
3751 |
</argument>
|
3752 |
-
<argument line="
|
3753 |
<name>$value</name>
|
3754 |
<default><![CDATA[]]></default>
|
3755 |
<type/>
|
3756 |
</argument>
|
3757 |
-
<argument line="
|
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="
|
3764 |
<name>mla_evaluate_iptc_exif_mapping</name>
|
3765 |
<full_name>mla_evaluate_iptc_exif_mapping</full_name>
|
3766 |
-
<docblock line="
|
3767 |
<description><![CDATA[Evaluate IPTC/EXIF mapping updates for a post]]></description>
|
3768 |
<long-description><![CDATA[]]></long-description>
|
3769 |
-
<tag line="
|
3770 |
-
<tag line="
|
3771 |
<type by_reference="false">object</type>
|
3772 |
</tag>
|
3773 |
-
<tag line="
|
3774 |
<type by_reference="false">string</type>
|
3775 |
</tag>
|
3776 |
-
<tag line="
|
3777 |
<type by_reference="false">array</type>
|
3778 |
</tag>
|
3779 |
-
<tag line="
|
3780 |
<type by_reference="false">array</type>
|
3781 |
</tag>
|
3782 |
</docblock>
|
3783 |
-
<argument line="
|
3784 |
<name>$post</name>
|
3785 |
<default><![CDATA[]]></default>
|
3786 |
<type/>
|
3787 |
</argument>
|
3788 |
-
<argument line="
|
3789 |
<name>$category</name>
|
3790 |
<default><![CDATA[]]></default>
|
3791 |
<type/>
|
3792 |
</argument>
|
3793 |
-
<argument line="
|
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="
|
3800 |
<name>_compose_iptc_option_list</name>
|
3801 |
<full_name>_compose_iptc_option_list</full_name>
|
3802 |
-
<docblock line="
|
3803 |
<description><![CDATA[Compose an IPTC Options list with current selection]]></description>
|
3804 |
<long-description><![CDATA[]]></long-description>
|
3805 |
-
<tag line="
|
3806 |
-
<tag line="
|
3807 |
-
<tag line="
|
3808 |
<type by_reference="false">string</type>
|
3809 |
</tag>
|
3810 |
-
<tag line="
|
3811 |
<type by_reference="false">string</type>
|
3812 |
</tag>
|
3813 |
</docblock>
|
3814 |
-
<argument line="
|
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="
|
3821 |
<name>_compose_parent_option_list</name>
|
3822 |
<full_name>_compose_parent_option_list</full_name>
|
3823 |
-
<docblock line="
|
3824 |
<description><![CDATA[Compose an hierarchical taxonomy Parent options list with current selection]]></description>
|
3825 |
<long-description><![CDATA[]]></long-description>
|
3826 |
-
<tag line="
|
3827 |
-
<tag line="
|
3828 |
-
<tag line="
|
3829 |
<type by_reference="false">string</type>
|
3830 |
</tag>
|
3831 |
-
<tag line="
|
3832 |
<type by_reference="false">integer</type>
|
3833 |
</tag>
|
3834 |
-
<tag line="
|
3835 |
<type by_reference="false">string</type>
|
3836 |
</tag>
|
3837 |
</docblock>
|
3838 |
-
<argument line="
|
3839 |
<name>$taxonomy</name>
|
3840 |
<default><![CDATA[]]></default>
|
3841 |
<type/>
|
3842 |
</argument>
|
3843 |
-
<argument line="
|
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="
|
3850 |
<name>_update_iptc_exif_standard_mapping</name>
|
3851 |
<full_name>_update_iptc_exif_standard_mapping</full_name>
|
3852 |
-
<docblock line="
|
3853 |
<description><![CDATA[Update Standard field portion of IPTC/EXIF mappings]]></description>
|
3854 |
<long-description><![CDATA[]]></long-description>
|
3855 |
-
<tag line="
|
3856 |
-
<tag line="
|
3857 |
<type by_reference="false">array</type>
|
3858 |
</tag>
|
3859 |
-
<tag line="
|
3860 |
<type by_reference="false">array</type>
|
3861 |
</tag>
|
3862 |
-
<tag line="
|
3863 |
<type by_reference="false">array</type>
|
3864 |
</tag>
|
3865 |
</docblock>
|
3866 |
-
<argument line="
|
3867 |
<name>$current_values</name>
|
3868 |
<default><![CDATA[]]></default>
|
3869 |
<type/>
|
3870 |
</argument>
|
3871 |
-
<argument line="
|
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="
|
3878 |
<name>_update_iptc_exif_taxonomy_mapping</name>
|
3879 |
<full_name>_update_iptc_exif_taxonomy_mapping</full_name>
|
3880 |
-
<docblock line="
|
3881 |
<description><![CDATA[Update Taxonomy term portion of IPTC/EXIF mappings]]></description>
|
3882 |
<long-description><![CDATA[]]></long-description>
|
3883 |
-
<tag line="
|
3884 |
-
<tag line="
|
3885 |
<type by_reference="false">array</type>
|
3886 |
</tag>
|
3887 |
-
<tag line="
|
3888 |
<type by_reference="false">array</type>
|
3889 |
</tag>
|
3890 |
-
<tag line="
|
3891 |
<type by_reference="false">array</type>
|
3892 |
</tag>
|
3893 |
</docblock>
|
3894 |
-
<argument line="
|
3895 |
<name>$current_values</name>
|
3896 |
<default><![CDATA[]]></default>
|
3897 |
<type/>
|
3898 |
</argument>
|
3899 |
-
<argument line="
|
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="
|
3906 |
<name>_update_iptc_exif_custom_mapping</name>
|
3907 |
<full_name>_update_iptc_exif_custom_mapping</full_name>
|
3908 |
-
<docblock line="
|
3909 |
<description><![CDATA[Update Custom field portion of IPTC/EXIF mappings]]></description>
|
3910 |
<long-description><![CDATA[]]></long-description>
|
3911 |
-
<tag line="
|
3912 |
-
<tag line="
|
3913 |
<type by_reference="false">array</type>
|
3914 |
</tag>
|
3915 |
-
<tag line="
|
3916 |
<type by_reference="false">array</type>
|
3917 |
</tag>
|
3918 |
-
<tag line="
|
3919 |
<type by_reference="false">array</type>
|
3920 |
</tag>
|
3921 |
</docblock>
|
3922 |
-
<argument line="
|
3923 |
<name>$current_values</name>
|
3924 |
<default><![CDATA[]]></default>
|
3925 |
<type/>
|
3926 |
</argument>
|
3927 |
-
<argument line="
|
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="
|
3934 |
<name>_get_custom_field_names</name>
|
3935 |
<full_name>_get_custom_field_names</full_name>
|
3936 |
-
<docblock line="
|
3937 |
<description><![CDATA[Generate a list of all (post) Custom Field names]]></description>
|
3938 |
<long-description><![CDATA[]]></long-description>
|
3939 |
-
<tag line="
|
3940 |
-
<tag line="
|
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="
|
3946 |
<name>mla_iptc_exif_option_handler</name>
|
3947 |
<full_name>mla_iptc_exif_option_handler</full_name>
|
3948 |
-
<docblock line="
|
3949 |
<description><![CDATA[Render and manage iptc/exif support options]]></description>
|
3950 |
<long-description><![CDATA[]]></long-description>
|
3951 |
-
<tag line="
|
3952 |
-
<tag line="
|
3953 |
-
<tag line="
|
3954 |
<type by_reference="false">string</type>
|
3955 |
</tag>
|
3956 |
-
<tag line="
|
3957 |
<type by_reference="false">string</type>
|
3958 |
</tag>
|
3959 |
-
<tag line="
|
3960 |
<type by_reference="false">array</type>
|
3961 |
</tag>
|
3962 |
-
<tag line="
|
3963 |
<type by_reference="false">array</type>
|
3964 |
</tag>
|
3965 |
-
<tag line="
|
3966 |
<type by_reference="false">string</type>
|
3967 |
</tag>
|
3968 |
</docblock>
|
3969 |
-
<argument line="
|
3970 |
<name>$action</name>
|
3971 |
<default><![CDATA[]]></default>
|
3972 |
<type/>
|
3973 |
</argument>
|
3974 |
-
<argument line="
|
3975 |
<name>$key</name>
|
3976 |
<default><![CDATA[]]></default>
|
3977 |
<type/>
|
3978 |
</argument>
|
3979 |
-
<argument line="
|
3980 |
<name>$value</name>
|
3981 |
<default><![CDATA[]]></default>
|
3982 |
<type/>
|
3983 |
</argument>
|
3984 |
-
<argument line="
|
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="
|
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="
|
4019 |
<name>$page_template_array</name>
|
4020 |
<default><![CDATA[null]]></default>
|
4021 |
-
<docblock line="
|
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="
|
4026 |
-
<tag line="
|
4027 |
<type by_reference="false">array</type>
|
4028 |
</tag>
|
4029 |
</docblock>
|
4030 |
</property>
|
4031 |
-
<property final="false" static="true" visibility="private" line="
|
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="
|
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="
|
4043 |
-
<tag line="
|
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="
|
4073 |
<name>mla_activation_hook</name>
|
4074 |
<full_name>mla_activation_hook</full_name>
|
4075 |
-
<docblock line="
|
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="
|
4079 |
-
<tag line="
|
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="
|
4085 |
<name>mla_deactivation_hook</name>
|
4086 |
<full_name>mla_deactivation_hook</full_name>
|
4087 |
-
<docblock line="
|
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="
|
4091 |
-
<tag line="
|
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="
|
4097 |
<name>mla_admin_menu_action</name>
|
4098 |
<full_name>mla_admin_menu_action</full_name>
|
4099 |
-
<docblock line="
|
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="
|
4104 |
-
<tag line="
|
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="
|
4110 |
<name>mla_add_plugin_settings_link</name>
|
4111 |
<full_name>mla_add_plugin_settings_link</full_name>
|
4112 |
-
<docblock line="
|
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="
|
4116 |
-
<tag line="
|
4117 |
<type by_reference="false">array</type>
|
4118 |
</tag>
|
4119 |
-
<tag line="
|
4120 |
<type by_reference="false">string</type>
|
4121 |
</tag>
|
4122 |
-
<tag line="
|
4123 |
<type by_reference="false">array</type>
|
4124 |
</tag>
|
4125 |
</docblock>
|
4126 |
-
<argument line="
|
4127 |
<name>$links</name>
|
4128 |
<default><![CDATA[]]></default>
|
4129 |
<type/>
|
4130 |
</argument>
|
4131 |
-
<argument line="
|
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="
|
4138 |
<name>_update_option_row</name>
|
4139 |
<full_name>_update_option_row</full_name>
|
4140 |
-
<docblock line="
|
4141 |
<description><![CDATA[Update or delete a single MLA option value]]></description>
|
4142 |
<long-description><![CDATA[]]></long-description>
|
4143 |
-
<tag line="
|
4144 |
-
<tag line="
|
4145 |
-
<tag line="
|
4146 |
<type by_reference="false">string</type>
|
4147 |
</tag>
|
4148 |
-
<tag line="
|
4149 |
<type by_reference="false">array</type>
|
4150 |
</tag>
|
4151 |
-
<tag line="
|
4152 |
<type by_reference="false">string</type>
|
4153 |
</tag>
|
4154 |
</docblock>
|
4155 |
-
<argument line="
|
4156 |
<name>$key</name>
|
4157 |
<default><![CDATA[]]></default>
|
4158 |
<type/>
|
4159 |
</argument>
|
4160 |
-
<argument line="
|
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="
|
4167 |
<name>_compose_option_row</name>
|
4168 |
<full_name>_compose_option_row</full_name>
|
4169 |
-
<docblock line="
|
4170 |
<description><![CDATA[Compose the table row for a single MLA option]]></description>
|
4171 |
<long-description><![CDATA[]]></long-description>
|
4172 |
-
<tag line="
|
4173 |
-
<tag line="
|
4174 |
-
<tag line="
|
4175 |
<type by_reference="false">string</type>
|
4176 |
</tag>
|
4177 |
-
<tag line="
|
4178 |
<type by_reference="false">array</type>
|
4179 |
</tag>
|
4180 |
-
<tag line="
|
4181 |
<type by_reference="false">string</type>
|
4182 |
</tag>
|
4183 |
</docblock>
|
4184 |
-
<argument line="
|
4185 |
<name>$key</name>
|
4186 |
<default><![CDATA[]]></default>
|
4187 |
<type/>
|
4188 |
</argument>
|
4189 |
-
<argument line="
|
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="
|
4196 |
<name>_compose_settings_tabs</name>
|
4197 |
<full_name>_compose_settings_tabs</full_name>
|
4198 |
-
<docblock line="
|
4199 |
<description><![CDATA[Compose the navigation tabs for the Settings subpage]]></description>
|
4200 |
<long-description><![CDATA[]]></long-description>
|
4201 |
-
<tag line="
|
4202 |
-
<tag line="
|
4203 |
-
<tag line="
|
4204 |
<type by_reference="false">string</type>
|
4205 |
</tag>
|
4206 |
-
<tag line="
|
4207 |
<type by_reference="false">string</type>
|
4208 |
</tag>
|
4209 |
</docblock>
|
4210 |
-
<argument line="
|
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="
|
4217 |
<name>_compose_general_tab</name>
|
4218 |
<full_name>_compose_general_tab</full_name>
|
4219 |
-
<docblock line="
|
4220 |
<description><![CDATA[Compose the General tab content for the Settings subpage]]></description>
|
4221 |
<long-description><![CDATA[]]></long-description>
|
4222 |
-
<tag line="
|
4223 |
-
<tag line="
|
4224 |
-
<tag line="
|
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="
|
4230 |
<name>_compose_mla_gallery_tab</name>
|
4231 |
<full_name>_compose_mla_gallery_tab</full_name>
|
4232 |
-
<docblock line="
|
4233 |
<description><![CDATA[Compose the MLA Gallery tab content for the Settings subpage]]></description>
|
4234 |
<long-description><![CDATA[]]></long-description>
|
4235 |
-
<tag line="
|
4236 |
-
<tag line="
|
4237 |
-
<tag line="
|
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="
|
4243 |
<name>_compose_custom_field_tab</name>
|
4244 |
<full_name>_compose_custom_field_tab</full_name>
|
4245 |
-
<docblock line="
|
4246 |
<description><![CDATA[Compose the Custom Field tab content for the Settings subpage]]></description>
|
4247 |
<long-description><![CDATA[]]></long-description>
|
4248 |
-
<tag line="
|
4249 |
-
<tag line="
|
4250 |
-
<tag line="
|
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="
|
4256 |
<name>_compose_iptc_exif_tab</name>
|
4257 |
<full_name>_compose_iptc_exif_tab</full_name>
|
4258 |
-
<docblock line="
|
4259 |
<description><![CDATA[Compose the IPTC/EXIF tab content for the Settings subpage]]></description>
|
4260 |
<long-description><![CDATA[]]></long-description>
|
4261 |
-
<tag line="
|
4262 |
-
<tag line="
|
4263 |
-
<tag line="
|
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="
|
4269 |
<name>_compose_documentation_tab</name>
|
4270 |
<full_name>_compose_documentation_tab</full_name>
|
4271 |
-
<docblock line="
|
4272 |
<description><![CDATA[Compose the Documentation tab content for the Settings subpage]]></description>
|
4273 |
<long-description><![CDATA[]]></long-description>
|
4274 |
-
<tag line="
|
4275 |
-
<tag line="
|
4276 |
-
<tag line="
|
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="
|
4282 |
<name>mla_render_settings_page</name>
|
4283 |
<full_name>mla_render_settings_page</full_name>
|
4284 |
-
<docblock line="
|
4285 |
<description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
|
4286 |
<long-description><![CDATA[]]></long-description>
|
4287 |
-
<tag line="
|
4288 |
-
<tag line="
|
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="
|
4294 |
<name>_save_gallery_settings</name>
|
4295 |
<full_name>_save_gallery_settings</full_name>
|
4296 |
-
<docblock line="
|
4297 |
<description><![CDATA[Save MLA Gallery settings to the options table]]></description>
|
4298 |
<long-description><![CDATA[]]></long-description>
|
4299 |
-
<tag line="
|
4300 |
-
<tag line="
|
4301 |
-
<tag line="
|
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="
|
4307 |
<name>_process_custom_field_mapping</name>
|
4308 |
<full_name>_process_custom_field_mapping</full_name>
|
4309 |
-
<docblock line="
|
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="
|
4314 |
-
<tag line="
|
4315 |
-
<tag line="
|
4316 |
<type by_reference="false">array</type>
|
4317 |
</tag>
|
4318 |
-
<tag line="
|
4319 |
<type by_reference="false">array</type>
|
4320 |
</tag>
|
4321 |
</docblock>
|
4322 |
-
<argument line="
|
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="
|
4329 |
<name>_delete_custom_field</name>
|
4330 |
<full_name>_delete_custom_field</full_name>
|
4331 |
-
<docblock line="
|
4332 |
<description><![CDATA[Delete a custom field from the wp_postmeta table]]></description>
|
4333 |
<long-description><![CDATA[]]></long-description>
|
4334 |
-
<tag line="
|
4335 |
-
<tag line="
|
4336 |
<type by_reference="false">array</type>
|
4337 |
</tag>
|
4338 |
-
<tag line="
|
4339 |
<type by_reference="false">array</type>
|
4340 |
</tag>
|
4341 |
</docblock>
|
4342 |
-
<argument line="
|
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="
|
4349 |
<name>_save_custom_field_settings</name>
|
4350 |
<full_name>_save_custom_field_settings</full_name>
|
4351 |
-
<docblock line="
|
4352 |
<description><![CDATA[Save custom field settings to the options table]]></description>
|
4353 |
<long-description><![CDATA[]]></long-description>
|
4354 |
-
<tag line="
|
4355 |
-
<tag line="
|
4356 |
-
<tag line="
|
4357 |
<type by_reference="false">array</type>
|
4358 |
</tag>
|
4359 |
-
<tag line="
|
4360 |
<type by_reference="false">array</type>
|
4361 |
</tag>
|
4362 |
</docblock>
|
4363 |
-
<argument line="
|
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="
|
4370 |
<name>_process_iptc_exif_standard</name>
|
4371 |
<full_name>_process_iptc_exif_standard</full_name>
|
4372 |
-
<docblock line="
|
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="
|
4377 |
-
<tag line="
|
4378 |
-
<tag line="
|
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="
|
4384 |
<name>_process_iptc_exif_taxonomy</name>
|
4385 |
<full_name>_process_iptc_exif_taxonomy</full_name>
|
4386 |
-
<docblock line="
|
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="
|
4391 |
-
<tag line="
|
4392 |
-
<tag line="
|
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="
|
4398 |
<name>_process_iptc_exif_custom</name>
|
4399 |
<full_name>_process_iptc_exif_custom</full_name>
|
4400 |
-
<docblock line="
|
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="
|
4405 |
-
<tag line="
|
4406 |
-
<tag line="
|
|
|
|
|
|
|
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="
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4412 |
<name>_save_iptc_exif_settings</name>
|
4413 |
<full_name>_save_iptc_exif_settings</full_name>
|
4414 |
-
<docblock line="
|
4415 |
<description><![CDATA[Save IPTC/EXIF settings to the options table]]></description>
|
4416 |
<long-description><![CDATA[]]></long-description>
|
4417 |
-
<tag line="
|
4418 |
-
<tag line="
|
4419 |
-
<tag line="
|
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="
|
4425 |
<name>_save_general_settings</name>
|
4426 |
<full_name>_save_general_settings</full_name>
|
4427 |
-
<docblock line="
|
4428 |
<description><![CDATA[Save General settings to the options table]]></description>
|
4429 |
<long-description><![CDATA[]]></long-description>
|
4430 |
-
<tag line="
|
4431 |
-
<tag line="
|
4432 |
-
<tag line="
|
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="
|
4438 |
<name>_reset_general_settings</name>
|
4439 |
<full_name>_reset_general_settings</full_name>
|
4440 |
-
<docblock line="
|
4441 |
<description><![CDATA[Delete saved settings, restoring default values]]></description>
|
4442 |
<long-description><![CDATA[]]></long-description>
|
4443 |
-
<tag line="
|
4444 |
-
<tag line="
|
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="
|
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="
|
4493 |
<name>$query_parameters</name>
|
4494 |
<default><![CDATA[array()]]></default>
|
4495 |
-
<docblock line="
|
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="
|
4504 |
-
<tag line="
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4505 |
<type by_reference="false">array</type>
|
4506 |
</tag>
|
4507 |
</docblock>
|
4508 |
</property>
|
4509 |
-
<property final="false" static="true" visibility="private" line="
|
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="
|
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="
|
4517 |
-
<tag line="
|
4518 |
<type by_reference="false">array</type>
|
4519 |
</tag>
|
4520 |
</docblock>
|
4521 |
</property>
|
4522 |
-
<property final="false" static="true" visibility="public" line="
|
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="
|
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="
|
4530 |
-
<tag line="
|
4531 |
<type by_reference="false">array</type>
|
4532 |
</tag>
|
4533 |
</docblock>
|
4534 |
</property>
|
4535 |
-
<property final="false" static="true" visibility="private" line="
|
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="
|
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="
|
4543 |
-
<tag line="
|
4544 |
<type by_reference="false">array</type>
|
4545 |
</tag>
|
4546 |
</docblock>
|
4547 |
</property>
|
4548 |
-
<property final="false" static="true" visibility="private" line="
|
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="
|
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="
|
4556 |
-
<tag line="
|
4557 |
<type by_reference="false">array</type>
|
4558 |
</tag>
|
4559 |
</docblock>
|
4560 |
</property>
|
4561 |
-
<property final="false" static="true" visibility="private" line="
|
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="
|
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="
|
4569 |
-
<tag line="
|
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="
|
4621 |
<name>_sanitize_query_specification</name>
|
4622 |
<full_name>_sanitize_query_specification</full_name>
|
4623 |
-
<docblock line="
|
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="
|
4627 |
-
<tag line="
|
4628 |
<type by_reference="false">string</type>
|
4629 |
</tag>
|
4630 |
-
<tag line="
|
4631 |
<type by_reference="false">string</type>
|
4632 |
</tag>
|
4633 |
</docblock>
|
4634 |
-
<argument line="
|
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="
|
4641 |
<name>_validate_sql_orderby</name>
|
4642 |
<full_name>_validate_sql_orderby</full_name>
|
4643 |
-
<docblock line="
|
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="
|
4648 |
-
<tag line="
|
4649 |
<type by_reference="false">array</type>
|
4650 |
</tag>
|
4651 |
-
<tag line="
|
4652 |
<type by_reference="false">string</type>
|
4653 |
<type by_reference="false">bool</type>
|
4654 |
</tag>
|
4655 |
</docblock>
|
4656 |
-
<argument line="
|
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="
|
4663 |
<name>mla_get_shortcode_attachments</name>
|
4664 |
<full_name>mla_get_shortcode_attachments</full_name>
|
4665 |
-
<docblock line="
|
4666 |
<description><![CDATA[Parses shortcode parameters and returns the gallery objects]]></description>
|
4667 |
<long-description><![CDATA[]]></long-description>
|
4668 |
-
<tag line="
|
4669 |
-
<tag line="
|
4670 |
<type by_reference="false">int</type>
|
4671 |
</tag>
|
4672 |
-
<tag line="
|
4673 |
<type by_reference="false">array</type>
|
4674 |
</tag>
|
4675 |
-
<tag line="
|
4676 |
<type by_reference="false">array</type>
|
4677 |
</tag>
|
4678 |
</docblock>
|
4679 |
-
<argument line="
|
4680 |
<name>$post_parent</name>
|
4681 |
<default><![CDATA[]]></default>
|
4682 |
<type/>
|
4683 |
</argument>
|
4684 |
-
<argument line="
|
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="
|
4691 |
<name>mla_shortcode_query_posts_where_filter</name>
|
4692 |
<full_name>mla_shortcode_query_posts_where_filter</full_name>
|
4693 |
-
<docblock line="
|
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="
|
4700 |
-
<tag line="
|
4701 |
<type by_reference="false">string</type>
|
4702 |
</tag>
|
4703 |
-
<tag line="
|
4704 |
<type by_reference="false">string</type>
|
4705 |
</tag>
|
4706 |
</docblock>
|
4707 |
-
<argument line="
|
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="
|
4714 |
<name>mla_shortcode_query_posts_orderby_filter</name>
|
4715 |
<full_name>mla_shortcode_query_posts_orderby_filter</full_name>
|
4716 |
-
<docblock line="
|
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="
|
4721 |
-
<tag line="
|
4722 |
<type by_reference="false">string</type>
|
4723 |
</tag>
|
4724 |
-
<tag line="
|
4725 |
<type by_reference="false">string</type>
|
4726 |
</tag>
|
4727 |
</docblock>
|
4728 |
-
<argument line="
|
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="
|
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.
|
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 "LEFT JOIN view ON post_id" 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 "detached" 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 => 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 <div> 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'=>'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 => 'ID_parent, 1 => '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'=>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 => 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'=>'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'=>'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> Dynamic = once every page load, Cached = once every login, Disabled = never.<br> 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> Dynamic = once every page load, Cached = once every login, Disabled = never.<br> 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> Click Save Changes at the bottom of the screen if you change this option.<br> Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'), 'custom_field_mapping' => array('tab' => '', 'help' => ' <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> 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 => 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 => 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 => 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 => 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' => '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->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->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' => HTML message(s) reflecting results, 'values' => updated iptc_exif_mapping values, 'changed' => 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' => HTML message(s) reflecting results, 'values' => updated iptc_exif_mapping values, 'changed' => 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' => HTML message(s) reflecting results, 'values' => updated iptc_exif_mapping values, 'changed' => 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' => HTML message(s) reflecting results, 'values' => updated iptc_exif_mapping values, 'changed' => 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., "Activate"" 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' => status/error messages, 'body' => 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' => status/error messages, 'body' => 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' => status/error messages, 'body' => 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' => status/error messages, 'body' => 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' => status/error messages, 'body' => 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.
|
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
|
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
|
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
|
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
|
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.
|
281 |
-
|
282 |
|
283 |
== Other Notes ==
|
284 |
|
@@ -291,6 +305,8 @@ In this section, scroll down to see:
|
|
291 |
* Custom Field Processing Options
|
292 |
* IPTC & 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
|
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 |
-
*
|
|
|
327 |
|
328 |
-
|
329 |
|
330 |
-
|
|
|
|
|
331 |
|
332 |
<h4>Gallery Display Content</h4>
|
333 |
|
334 |
-
Five
|
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 |
-
|
349 |
-
|
350 |
-
|
|
|
|
|
351 |
|
352 |
<h4>Google File Viewer Support</h4>
|
353 |
|
354 |
-
Four
|
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 |
-
*
|
361 |
-
|
362 |
-
*
|
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 |
-
|
369 |
-
|
370 |
-
*
|
371 |
-
*
|
372 |
-
*
|
373 |
-
*
|
374 |
-
*
|
375 |
-
*
|
376 |
-
*
|
377 |
-
*
|
378 |
-
*
|
379 |
-
*
|
380 |
-
*
|
381 |
-
*
|
382 |
-
*
|
383 |
-
*
|
384 |
-
*
|
385 |
-
*
|
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.
|
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 |
-
|
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 |
-
|
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 |
-
|
436 |
|
437 |
-
|
438 |
|
439 |
-
|
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 |
-
|
448 |
|
449 |
-
|
450 |
|
451 |
-
|
452 |
-
* `[mla_gallery tax_query="array(array('taxonomy' => 'attachment_category','field' => 'id','terms' => array(11, 12)))" post_parent=current post_mime_type='']`
|
453 |
|
454 |
-
|
455 |
|
456 |
-
|
457 |
|
458 |
-
|
|
|
459 |
|
460 |
-
|
461 |
|
462 |
-
|
463 |
|
464 |
-
|
465 |
|
466 |
-
|
467 |
|
468 |
-
|
469 |
|
470 |
-
|
471 |
|
472 |
-
|
473 |
|
474 |
-
|
475 |
|
476 |
-
|
477 |
|
478 |
-
|
479 |
|
480 |
-
<
|
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 “Photonic Gallery for Flickr, Picasa, SmugMug, 500px and Instagram” ==
|
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
|
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,
|
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
|
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 |
-
|
|
|
|
|
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 |
-
|
538 |
-
|
539 |
-
|
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
|
624 |
|
625 |
-
A complete list of the <strong>32 data source elements</strong> is on the plugin's Settings page.
|
626 |
|
627 |
==IPTC & 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
|
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 & 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 |
+
* <keyname>, 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 “Photonic Gallery for Flickr, Picasa, SmugMug, 500px and Instagram” ==
|
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 & 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
|
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 & 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&mla_tab=documentation#mla_iptc_exif_mapping" title="IPTC & 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 |
<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 & 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&mla_tab=documentation#mla_iptc_exif_mapping" title="IPTC & 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 |
<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 “Photonic Gallery”</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
|
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
|
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 |
|
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
|
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
|
|
|
|
|
673 |
</p>
|
674 |
<p>
|
675 |
-
The optional <strong>",
|
676 |
</p>
|
677 |
<p>
|
678 |
-
There are
|
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.
|
706 |
<br /> <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 /> <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".
|
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 |
|
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
|
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.
|
990 |
<br /> <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 /> <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
|
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
|
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 “Photonic Gallery”</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 |
+
|
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 |
|
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 ",export" 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., "<strong>sizes.thumbnail.file</strong>" 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 /> <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 /> <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 |
|
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 /> <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 /> <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+]
|
|
|
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 |
+
|
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 |
+
|
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 |
+
|
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 |
+
|
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 |
+
|
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 |
+
|
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+]
|
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'>
|