MLAData \MLAData The _template functions are inspired by the book "WordPress 3 Plugin Development Essentials." Templates separate HTML markup from PHP code for easier maintenance and localization.

]]> MLA_ALT_TEXT_VIEW_SUFFIX MLA_ALT_TEXT_VIEW_SUFFIX $mla_alt_text_view array $query_parameters This array defines parameters for the query's join, where and orderby filters. The parameters are set up in the _prepare_list_table_query function, and any further logic required to translate those values is contained in the filters.

Array index values are: use_postmeta_view, postmeta_key, detached, orderby, order, s, mla-search-connector, mla-search-fields, sentence, exact

]]> array $galleries This array contains all of the objects containing one or more [gallery] shortcodes and array(s) of which attachments each [gallery] contains. The arrays are built once each page load and cached for subsequent calls.

The outer array is keyed by post_id. It contains an array of [gallery] entries numbered from one (1). Each inner array has these elements: ['parent_title'] post_title of the gallery parent, ['parent_type'] 'post' or 'page' or the custom post_type of the gallery parent, ['query'] contains a string with the arguments of the [gallery], ['results'] contains an array of post_ids for the objects in the gallery.

]]> array $mla_galleries This array contains all of the objects containing one or more [mla_gallery] shortcodes and array(s) of which attachments each [mla_gallery] contains. The arrays are built once each page load and cached for subsequent calls.

]]> array initialize initialize mla_load_template mla_load_template Loads a template to a string or a multi-part template to an array. Multi-part templates are divided by comments of the form , where "key" becomes the key part of the array.

]]> string string string array false NULL $source $type mla_parse_template mla_parse_template A simple parsing function for basic templating.

]]> string array string $tpl $hash mla_get_template_placeholders mla_get_template_placeholders string array $tpl mla_count_list_table_items mla_count_list_table_items array integer $request mla_query_list_table_items mla_query_list_table_items Supports prepare_items in class-mla-list-table.php. Modeled after wp_edit_attachments_query in wp-admin/post.php

]]> array int int array $request $offset $count _prepare_list_table_query _prepare_list_table_query Prepare the arguments for WP_Query. Modeled after wp_edit_attachments_query in wp-admin/post.php

]]> array int int array $raw_request $offset $count _execute_list_table_query _execute_list_table_query array object $request mla_query_posts_search_filter mla_query_posts_search_filter Defined as public because it's a filter.

]]> string object string $search_string $query_object mla_query_posts_join_filter mla_query_posts_join_filter Defined as public because it's a filter.

]]> string string $join_clause mla_query_posts_where_filter mla_query_posts_where_filter Modeled after _edit_attachments_query_helper in wp-admin/post.php. Defined as public because it's a filter.

]]> string string $where_clause mla_query_posts_orderby_filter mla_query_posts_orderby_filter Expands the range of sort options because the logic in WP_Query is limited. Defined as public because it's a filter.

]]> string string $orderby_clause mla_get_attachment_by_id mla_get_attachment_by_id The (associative) array will contain every field that can be found in the posts and postmeta tables, and all references to the attachment.

]]> int NULL array $post_id mla_fetch_attachment_parent_data mla_fetch_attachment_parent_data int array $parent_id mla_fetch_attachment_metadata mla_fetch_attachment_metadata Returns a filtered array of a post's meta data. Internal values beginning with '' are stripped out or converted to an 'mla' equivalent. Array data is replaced with a string containing the first array element.

]]> int array $post_id mla_fetch_attachment_references mla_fetch_attachment_references Searches all post and page content to see if the attachment is used as a Featured Image or inserted in the post as an image or link.

]]> int int array $ID $parent mla_flush_mla_galleries mla_flush_mla_galleries string void $option_name mla_save_post_action mla_save_post_action integer void $post_id _build_mla_galleries _build_mla_galleries string array string boolean boolean $option_name $galleries_array $shortcode $exclude_revisions _search_mla_galleries _search_mla_galleries array int array $galleries_array $attachment_id mla_exif_metadata_value mla_exif_metadata_value Returns a string value, converting array data to a string as necessary. Also handles the special pseudo-values 'ALL_EXIF' and 'ALL_IPTC'.

]]> string string string $key $image_metadata mla_fetch_attachment_image_metadata mla_fetch_attachment_image_metadata Returns

]]> int string array $post_id $path mla_update_single_item mla_update_single_item int array array array array $post_id $new_data $tax_input $tax_actions _remove_tags _remove_tags array array object array $terms_before $tags $taxonomy_obj _hex_dump _hex_dump string integer \intger string $data $limit $bytes_per_row MLAEdit \MLAEdit $mla_references This array contains the Featured/Inserted/Gallery/MLA Gallery references for the item. The array is built once each page load and cached for subsequent calls.

]]> array initialize initialize void mla_custom_field_support_action mla_custom_field_support_action Declared public because it is an action.

]]> void mla_post_updated_messages_filter mla_post_updated_messages_filter Declared public because it is a filter.

]]> array array $messages mla_attachment_submitbox_action mla_attachment_submitbox_action Declared public because it is an action.

]]> void mla_add_meta_boxes_action mla_add_meta_boxes_action Declared public because it is an action.

]]> string object void $post_type $post mla_edit_add_help_tab mla_edit_add_help_tab string string void $admin_title $title mla_parent_info_handler mla_parent_info_handler Declared public because it is a callback function.

]]> object void $post mla_menu_order_handler mla_menu_order_handler Declared public because it is a callback function.

]]> object void $post mla_image_metadata_handler mla_image_metadata_handler Declared public because it is a callback function.

]]> object void $post mla_featured_in_handler mla_featured_in_handler Declared public because it is a callback function.

]]> object void $post mla_inserted_in_handler mla_inserted_in_handler Declared public because it is a callback function.

]]> object void $post mla_gallery_in_handler mla_gallery_in_handler Declared public because it is a callback function.

]]> object void $post mla_mla_gallery_in_handler mla_mla_gallery_in_handler Declared public because it is a callback function.

]]> object void $post mla_edit_attachment_action mla_edit_attachment_action Declared public because it is an action.

]]> integer void $post_ID \WP_List_Table MLA_List_Table \MLA_List_Table Extends the core WP_List_Table class.

]]> $rollover_id Set to the current Post-ID when row-level actions are output for the row.

]]> int $currently_hidden Records hidden columns so row-level actions are not assigned to them.

]]> array $default_columns '', 'icon' => '', 'ID_parent' => 'ID/Parent', 'title_name' => 'Title/Name', 'post_title' => 'Title', 'post_name' => 'Name', 'parent' => 'Parent ID', 'menu_order' => 'Menu Order', 'featured' => 'Featured in', 'inserted' => 'Inserted in', 'galleries' => 'Gallery in', 'mla_galleries' => 'MLA Gallery in', 'alt_text' => 'ALT Text', 'caption' => 'Caption', 'description' => 'Description', 'post_mime_type' => 'MIME Type', 'base_file' => 'Base File', 'date' => 'Date', 'modified' => 'Last Modified', 'author' => 'Author', 'attached_to' => 'Attached to')]]> This array defines table columns and titles where the key is the column slug (and class) and the value is the column's title text. If you need a checkbox for bulk actions, use the special slug "cb".

The 'cb' column is treated differently than the rest. If including a checkbox column in your table you must create a column_cb() method. If you don't need bulk actions or checkboxes, simply leave the 'cb' entry out of your array.

Taxonomy columns are added to this array by mla_admin_init_action. Custom field columns are added to this array by mla_admin_init_action.

]]> array $default_hidden_columns This array is used when the user-level option is not set, i.e., the user has not altered the selection of hidden columns.

The value on the right-hand side must match the column slug, e.g., array(0 => 'ID_parent, 1 => 'title_name').

Taxonomy columns are added to this array by mla_admin_init_action. Custom field columns are added to this array by mla_admin_init_action.

]]> array $default_sortable_columns array('ID', false), 'title_name' => array('title_name', false), 'post_title' => array('post_title', false), 'post_name' => array('post_name', false), 'parent' => array('post_parent', false), 'menu_order' => array('menu_order', false), 'alt_text' => array('_wp_attachment_image_alt', false), 'caption' => array('post_excerpt', false), 'description' => array('post_content', false), 'post_mime_type' => array('post_mime_type', false), 'base_file' => array('_wp_attached_file', false), 'date' => array('post_date', false), 'modified' => array('post_modified', false), 'author' => array('post_author', false), 'attached_to' => array('post_parent', false))]]> This array defines the table columns that can be sorted. The array key is the column slug that needs to be sortable, and the value is database column to sort by. Often, the key and value will be the same, but this is not always the case (as the value is a column name from the database, not the list table).

The array value also contains a boolean which is 'true' if the data is currently sorted by that column. This is computed each time the table is displayed.

Taxonomy columns, if any, are added to this array by mla_admin_init_action. Custom field columns are added to this array by mla_admin_init_action.

]]> array _default_hidden_columns _default_hidden_columns array _avail_mime_types _avail_mime_types Modeled after get_available_post_mime_types in wp-admin/includes/post.php, with additional entries.

]]> array array $num_posts mla_get_attachment_mime_types mla_get_attachment_mime_types Modeled after get_post_mime_types in wp-includes/post.php, with additional entries.

]]> array mla_get_sortable_columns mla_get_sortable_columns array mla_manage_hidden_columns_filter mla_manage_hidden_columns_filter Required because the screen.php get_hidden_columns function only uses the get_user_option result. Set when the file is loaded because the object is not created in time for the call from screen.php.

]]> string string object array $result $option $user_data mla_manage_columns_filter mla_manage_columns_filter This required filter dictates the table's columns and titles. Set when the file is loaded because the list_table object isn't created in time to affect the "screen options" setup.

]]> array mla_admin_init_action mla_admin_init_action Called in the admin_init action because the list_table object isn't created in time to affect the "screen options" setup.

]]> void __construct __construct void column_default column_default Called when the parent class can't find a method specifically built for a given column. The taxonomy columns are handled here. All other columns should have a specific method, so this function returns a troubleshooting message.

]]> array array string $item $column_name column_cb column_cb The 'cb' column is given special treatment when columns are processed.

]]> array string $item column_icon column_icon array string $item _build_rollover_actions _build_rollover_actions object string array $item $column _build_inline_data _build_inline_data object string $item column_ID_parent column_ID_parent array string $item column_title_name column_title_name array string $item column_post_title column_post_title array string $item column_post_name column_post_name array string $item column_parent column_parent array string $item column_menu_order column_menu_order array string $item column_featured column_featured array string $item column_inserted column_inserted array string $item column_galleries column_galleries array string $item column_mla_galleries column_mla_galleries array string $item column_alt_text column_alt_text array string $item column_caption column_caption array string $item column_description column_description array string $item column_post_mime_type column_post_mime_type array string $item column_base_file column_base_file array string $item column_date column_date array string $item column_modified column_modified array string $item column_author column_author array string $item column_attached_to column_attached_to array string $item get_columns get_columns array get_hidden_columns get_hidden_columns array get_sortable_columns get_sortable_columns Also notes the current sort column, if set.

]]> array get_views get_views These are listed across the top of the page and managed by WordPress.

]]> array get_bulk_actions get_bulk_actions option_title ) with the list of bulk actions available on this table.]]> array extra_tablenav extra_tablenav Modeled after class-wp-posts-list-table.php in wp-admin/includes.

]]> string array $which prepare_items prepare_items This is where you prepare your data for display. This method will usually be used to query the database, sort and filter the data, and generally get it ready to be displayed. At a minimum, we should set $this->items and $this->set_pagination_args().

]]> void single_row single_row object void $item MLA \MLA PLUGIN_NAME PLUGIN_NAME string CURRENT_MLA_VERSION CURRENT_MLA_VERSION string MIN_PHP_VERSION MIN_PHP_VERSION string MIN_WORDPRESS_VERSION MIN_WORDPRESS_VERSION string STYLESHEET_SLUG STYLESHEET_SLUG string JAVASCRIPT_SINGLE_EDIT_SLUG JAVASCRIPT_SINGLE_EDIT_SLUG string JAVASCRIPT_SINGLE_EDIT_OBJECT JAVASCRIPT_SINGLE_EDIT_OBJECT string JAVASCRIPT_INLINE_EDIT_SLUG JAVASCRIPT_INLINE_EDIT_SLUG string JAVASCRIPT_INLINE_EDIT_OBJECT JAVASCRIPT_INLINE_EDIT_OBJECT string JAVASCRIPT_MEDIA_POPUP_SLUG JAVASCRIPT_MEDIA_POPUP_SLUG string JAVASCRIPT_MEDIA_POPUP_OBJECT JAVASCRIPT_MEDIA_POPUP_OBJECT string ADMIN_PAGE_SLUG ADMIN_PAGE_SLUG string MLA_ADMIN_NONCE MLA_ADMIN_NONCE string MLA_ADMIN_SINGLE_DELETE MLA_ADMIN_SINGLE_DELETE string MLA_ADMIN_SINGLE_EDIT_DISPLAY MLA_ADMIN_SINGLE_EDIT_DISPLAY string MLA_ADMIN_SINGLE_EDIT_UPDATE MLA_ADMIN_SINGLE_EDIT_UPDATE string MLA_ADMIN_SINGLE_RESTORE MLA_ADMIN_SINGLE_RESTORE string MLA_ADMIN_SINGLE_TRASH MLA_ADMIN_SINGLE_TRASH string MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP string MLA_ADMIN_SINGLE_MAP MLA_ADMIN_SINGLE_MAP string $page_hooks array initialize initialize This function contains add_action and add_filter calls to set up the Ajax handlers, enqueue JavaScript and CSS files, and set up the Assistant submenu.

]]> void mla_admin_init_action mla_admin_init_action void mla_admin_enqueue_scripts_action mla_admin_enqueue_scripts_action string void $page_hook mla_admin_menu_action mla_admin_menu_action Add a submenu page in the "Media" section, add settings page in the "Settings" section. add settings link in the Plugins section entry for MLA.

For WordPress versions before 3.5, add submenu page(s) for attachment taxonomies, add filter to clean up taxonomy submenu labels.

]]> void mla_add_menu_options mla_add_menu_options void mla_add_help_tab mla_add_help_tab void mla_screen_options_show_screen_filter mla_screen_options_show_screen_filter boolean string boolean $show_screen $this_screen mla_set_screen_option_filter mla_set_screen_option_filter boolean string string string void $status $option $value mla_edit_tax_redirect mla_edit_tax_redirect The custom taxonomy add/edit submenu entries go to "upload.php" by default. This filter is the only way to redirect them to the correct WordPress page. The filter is not required for WordPress 3.5 and later.

]]> void mla_parent_file_filter mla_parent_file_filter For WordPress before 3.5, the submenu entries for custom taxonomies under the "Media" menu are not set up correctly by WordPress, so this function cleans them up, redirecting the request to the right WordPress page for editing/adding taxonomy terms. For WordPress 3.5 and later, the function fixes the submenu bolding when going to the Edit Media screen.

]]> array string $parent_file mla_render_admin_page mla_render_admin_page void mla_inline_edit_action mla_inline_edit_action Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php

]]> void _build_inline_edit_form _build_inline_edit_form inspired by inline_edit() in wp-admin\includes\class-wp-posts-list-table.php.

]]> object string $MLAListTable _authors_dropdown _authors_dropdown integer string string string false $author $name $class _current_bulk_action _current_bulk_action string false _delete_single_item _delete_single_item array array $post_id _display_single_item _display_single_item int array $post_id _restore_single_item _restore_single_item array array $post_id _trash_single_item _trash_single_item array array $post_id MLAObjects \MLAObjects initialize initialize void _build_taxonomies _build_taxonomies void mla_taxonomy_get_columns_filter mla_taxonomy_get_columns_filter array array $columns mla_taxonomy_column_filter mla_taxonomy_column_filter string array array array $place_holder $column_name $term_id MLAOptions \MLAOptions Separated from class MLASettings in version 1.00

]]> MLA_VERSION_OPTION MLA_VERSION_OPTION MLA_FEATURED_IN_TUNING MLA_FEATURED_IN_TUNING MLA_INSERTED_IN_TUNING MLA_INSERTED_IN_TUNING MLA_GALLERY_IN_TUNING MLA_GALLERY_IN_TUNING MLA_MLA_GALLERY_IN_TUNING MLA_MLA_GALLERY_IN_TUNING MLA_NEW_CUSTOM_RULE MLA_NEW_CUSTOM_RULE MLA_NEW_CUSTOM_FIELD MLA_NEW_CUSTOM_FIELD $process_featured_in This setting is false if the "Featured in" database access setting is "disabled", else true.

]]> boolean $process_inserted_in This setting is false if the "Inserted in" database access setting is "disabled", else true.

]]> boolean $process_gallery_in This setting is false if the "Gallery in" database access setting is "disabled", else true.

]]> boolean $process_mla_gallery_in This setting is false if the "MLA Gallery in" database access setting is "disabled", else true.

]]> boolean $mla_option_definitions 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.
  Dynamic = once every page load, Cached = once every login, Disabled = never.
  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.
  Dynamic = once every page load, Cached = once every login, Disabled = never.
  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.
Check the "Inline Edit" box to display the taxonomy in the Quick Edit and Bulk Edit areas.
Use the "List Filter" option to select the taxonomy on which to filter the Assistant table listing.', 'std' => array('tax_support' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_quick_edit' => array('attachment_category' => 'checked', 'attachment_tag' => 'checked'), 'tax_filter' => 'attachment_category'), 'type' => 'custom', 'render' => 'mla_taxonomy_option_handler', 'update' => 'mla_taxonomy_option_handler', 'delete' => 'mla_taxonomy_option_handler', 'reset' => 'mla_taxonomy_option_handler'), 'orderby_heading' => array('tab' => 'general', 'name' => 'Default Table Listing Sort Order', 'type' => 'header'), 'default_orderby' => array('tab' => 'general', 'name' => 'Order By', 'type' => 'select', 'std' => 'title_name', 'options' => array('none', 'title_name'), 'texts' => array('None', 'Title/Name'), 'help' => 'Select the column for the sort order of the Assistant table listing.'), 'default_order' => array('tab' => 'general', 'name' => 'Order', 'type' => 'radio', 'std' => 'ASC', 'options' => array('ASC', 'DESC'), 'texts' => array('Ascending', 'Descending'), 'help' => 'Choose the sort order.'), 'template_heading' => array('tab' => 'mla-gallery', 'name' => 'Default [mla_gallery] Templates', 'type' => 'header'), 'default_style' => array('tab' => 'mla-gallery', 'name' => 'Style Template', 'type' => 'select', 'std' => 'default', 'options' => array(), 'texts' => array(), 'help' => 'Select the default style template for your [mla_gallery] shortcodes.'), 'default_markup' => array('tab' => 'mla-gallery', 'name' => 'Markup Template', 'type' => 'select', 'std' => 'default', 'options' => array(), 'texts' => array(), 'help' => 'Select the default markup template for your [mla_gallery] shortcodes.'), 'style_templates' => array('tab' => '', 'type' => 'hidden', 'std' => array()), 'markup_templates' => array('tab' => '', 'type' => 'hidden', 'std' => array()), 'enable_custom_field_mapping' => array('tab' => 'custom-field', 'name' => 'Enable custom field mapping when adding new media', 'type' => 'checkbox', 'std' => '', 'help' => 'Check this option to enable mapping when uploading new media (attachments).
  Click Save Changes at the bottom of the screen if you change this option.
  Does NOT affect the operation of the "Map" buttons on the bulk edit, single edit and settings screens.'), 'custom_field_mapping' => array('tab' => '', 'help' => ' 
Update the custom field mapping values above, then click Save Changes to make the updates permanent.
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).
  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.
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.
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'))]]> Each option is defined by an array with the following elements:

array key => HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)

tab => Settings page tab id for the option name => admin page label or heading text type => 'checkbox', 'header', 'radio', 'select', 'text', 'textarea', 'custom', 'hidden' std => default value help => help text size => text size, default 40 cols => textbox columns, default 90 rows => textbox rows, default 5 options => array of radio or select option values texts => array of radio or select option display texts render => rendering function for 'custom' options. Usage: $options_list .= ['render']( 'render', $key, $value ); update => update function for 'custom' options; returns nothing. Usage: $message = ['update']( 'update', $key, $value, $_REQUEST ); delete => delete function for 'custom' options; returns nothing. Usage: $message = ['delete']( 'delete', $key, $value, $_REQUEST ); reset => reset function for 'custom' options; returns nothing. Usage: $message = ['reset']( 'reset', $key, $value, $_REQUEST );

]]> $mla_option_templates array $custom_field_data_sources array initialize initialize void _load_option_templates _load_option_templates void mla_fetch_gallery_template mla_fetch_gallery_template string string string boolean null $key $type mla_get_style_templates mla_get_style_templates array null mla_put_style_templates mla_put_style_templates array boolean $templates mla_get_markup_templates mla_get_markup_templates array null mla_put_markup_templates mla_put_markup_templates array boolean $templates mla_get_option mla_get_option string mixed $option mla_update_option mla_update_option string mixed boolean $option $newvalue mla_delete_option mla_delete_option string boolean $option mla_taxonomy_support mla_taxonomy_support string string boolean string $tax_name $support_type mla_taxonomy_option_handler mla_taxonomy_option_handler string string array array string $action $key $value $args mla_add_attachment_action mla_add_attachment_action integer void $post_id mla_update_attachment_metadata_filter mla_update_attachment_metadata_filter array integer void $data $post_id mla_custom_field_option_value mla_custom_field_option_value string array $slug mla_custom_field_support mla_custom_field_support string array $support_type _evaluate_file_information _evaluate_file_information string array array integer array $upload_dir $wp_attached_files $wp_attachment_metadata $post_id _evaluate_data_source _evaluate_data_source integer string string string array string $post_id $category $data_source $format $attachment_metadata mla_evaluate_custom_field_mapping mla_evaluate_custom_field_mapping integer string array array array $post_id $category $settings $attachment_metadata _compose_custom_field_option_list _compose_custom_field_option_list string string $selection _compose_data_source_option_list _compose_data_source_option_list string string $selection _update_custom_field_mapping _update_custom_field_mapping array array array $current_values $new_values mla_custom_field_option_handler mla_custom_field_option_handler string string array array string $action $key $value $args mla_evaluate_iptc_exif_mapping mla_evaluate_iptc_exif_mapping object string array array $post $category $settings _compose_iptc_option_list _compose_iptc_option_list string string $selection _compose_parent_option_list _compose_parent_option_list string integer string $taxonomy $selection _update_iptc_exif_standard_mapping _update_iptc_exif_standard_mapping array array array $current_values $new_values _update_iptc_exif_taxonomy_mapping _update_iptc_exif_taxonomy_mapping array array array $current_values $new_values _update_iptc_exif_custom_mapping _update_iptc_exif_custom_mapping array array array $current_values $new_values _get_custom_field_names _get_custom_field_names array mla_iptc_exif_option_handler mla_iptc_exif_option_handler string string array array string $action $key $value $args MLASettings \MLASettings MLA_SETTINGS_SLUG MLA_SETTINGS_SLUG $page_template_array This array contains all of the template parts for the Settings page(s). The array is built once each page load and cached for subsequent use.

]]> array $mla_tablist 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'))]]> array key => HTML id/name attribute and option database key (OMIT MLA_OPTION_PREFIX)

title => tab label / heading text render => rendering function for tab messages and content. Usage: $tab_content = 'render';

]]> array initialize initialize void _version_upgrade _version_upgrade void mla_activation_hook mla_activation_hook Adds a view to the database to support sorting the listing on 'ALT Text'.

]]> void mla_deactivation_hook mla_deactivation_hook Removes (if present) a view from the database that supports sorting the listing on 'ALT Text'.

]]> void mla_admin_menu_action mla_admin_menu_action void mla_add_plugin_settings_link mla_add_plugin_settings_link array string array $links $file _update_option_row _update_option_row string array string $key $value _compose_option_row _compose_option_row string array string $key $value _compose_settings_tabs _compose_settings_tabs string string $active_tab _compose_general_tab _compose_general_tab array _compose_mla_gallery_tab _compose_mla_gallery_tab array _compose_custom_field_tab _compose_custom_field_tab array _compose_iptc_exif_tab _compose_iptc_exif_tab array _compose_documentation_tab _compose_documentation_tab array mla_render_settings_page mla_render_settings_page void _save_gallery_settings _save_gallery_settings array _process_custom_field_mapping _process_custom_field_mapping array array $settings _delete_custom_field _delete_custom_field array array $value _save_custom_field_settings _save_custom_field_settings array array $new_values _process_iptc_exif_standard _process_iptc_exif_standard array _process_iptc_exif_taxonomy _process_iptc_exif_taxonomy array _process_iptc_exif_custom _process_iptc_exif_custom array _save_iptc_exif_settings _save_iptc_exif_settings array _save_general_settings _save_general_settings array _reset_general_settings _reset_general_settings array MLAShortcodes \MLAShortcodes $mla_debug_messages string $mla_debug boolean $query_parameters This array defines parameters for the query's where filter, mla_shortcode_query_posts_where_filter. The parameters are set up in the mla_get_shortcode_attachments function, and any further logic required to translate those values is contained in the filter.

Array index values are: post_parent

]]> array $mla_iptc_records "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")]]> This array contains the identifiers and names of Datasets defined in the "IPTC-NAA Information Interchange Model Version No. 4.1".

]]> array $mla_iptc_keys '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')]]> This array contains the sanitized names and identifiers of Datasets defined in the "IPTC-NAA Information Interchange Model Version No. 4.1".

]]> array $mla_iptc_descriptions "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")]]> This array contains the descriptions of Datasets defined in the "IPTC-NAA Information Interchange Model Version No. 4.1".

]]> array $mla_iptc_formats "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]")]]> This array contains the file format identifiers and descriptions defined in the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 1#020.

]]> array $mla_iptc_image_types "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")]]> This array contains the image type identifiers and descriptions defined in the "IPTC-NAA Information Interchange Model Version No. 4.1" for dataset 2#130, octet 2.

]]> array initialize initialize void mla_attachment_list_shortcode mla_attachment_list_shortcode void mla_gallery_shortcode mla_gallery_shortcode This is a superset of the WordPress Gallery shortcode for displaying images on a post, page or custom post type. It is adapted from /wp-includes/media.php gallery_shortcode. Enhancements include many additional selection parameters and full taxonomy support.

]]> array string $attr mla_get_shortcode_attachments mla_get_shortcode_attachments int array array $post_parent $attr mla_shortcode_query_posts_where_filter mla_shortcode_query_posts_where_filter Captures debug information. Adds whitespace to the post_type = 'attachment' phrase to circumvent subsequent Role Scoper modification of the clause. Handles post_parent "any" and "none" cases. Defined as public because it's a filter.

]]> string string $where_clause Defines constants and loads all of the classes and functions required to run the plugin. This file is only loaded if the naming conflict tests in index.php are passed.

]]> MLA_OPTION_PREFIX \MLA_OPTION_PREFIX This file contains several tests for name conflicts with other plugins. Only if the tests are passed will the rest of the plugin be loaded and run.

]]> includes/mla-plugin-loader.php MLA_PLUGIN_PATH \MLA_PLUGIN_PATH MLA_PLUGIN_URL \MLA_PLUGIN_URL mla_name_conflict_reporting_action \mla_name_conflict_reporting_action MLATest \MLATest $wordpress_3point5_plus boolean initialize initialize void min_php_version min_php_version string string void $min_version $plugin_name min_WordPress_version min_WordPress_version string string void $min_version $plugin_name todo fixme