Class MLA (Media Library Assistant) provides several enhancements to the handling
of images and files held in the WordPress Media Library.
Methods
Initialization function, similar to __construct()
initialize() : void
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.
Add contextual help tabs to all the MLA pages
mla_add_help_tab() : void
Load the plugin's Style Sheet and Javascript files
mla_admin_enqueue_scripts_action(string $page_hook) : void
Parameters
$page_hook
string
Name of the page being loaded
Load the plugin's Ajax handler or process Edit Media update actions
mla_admin_init_action() : void
Print optional in-lne styles for Media/Assistant submenu table
mla_admin_print_styles_action()
Get the edit Authors dropdown box, if user has suitable permissions
mla_authors_dropdown(integer $author, string $name, string $class) : string | false
Parameters
$author
integer
Optional User ID of the current author, default 0
$name
string
Optional HTML name attribute, default 'post_author'
$class
string
Optional HTML class attribute, default 'authors'
Returns
string
false
HTML markup for the dropdown field or False
Clear the Media/Assistant submenu Filter-by variables
mla_clear_filter_by(array $preserves) : void
Parameters
$preserves
array
Filters to be retained
Ajax handler for inline editing
mla_inline_edit_ajax_action() : void
Adapted for Quick Edit from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php
Displays name conflict error messages at the top of the Dashboard
mla_name_conflict_reporting_action()
Cleanup menus for Edit Tags/Categories page
mla_parent_file_filter(array $parent_file) : string
Fixes the submenu bolding when going to the Edit Media screen.
Parameters
$parent_file
array
The top-level menu page
Returns
string
The updated top-level menu page
Prepare Bulk Edit field-level updates
mla_prepare_bulk_edits(integer $post_id, array $request, array $custom_field_map) : array
Parameters
$post_id
integer
Current post ID
$request
array
Form elements, e.g., from $_REQUEST
$custom_field_map
array
Form id to field name mapping
Returns
array
Non-empty form elements
Process bulk action for one or more attachments
mla_process_bulk_action(string $bulk_action, array $request) : array
Parameters
$bulk_action
string
Bulk action slug: delete, edit, restore, trash, custom action
$request
array
Form elements, e.g., from $_REQUEST
Returns
array
messages and page content: ( 'message', 'body', 'unchanged', 'success', 'failure', 'item_results' )
Render the "Assistant" subpage in the Media section, using the list_table package
mla_render_admin_page() : void
Only show screen options on the table-list screen
mla_screen_options_show_screen_filter(boolean $show_screen, string $this_screen) : boolean
Parameters
$show_screen
boolean
True to display "Screen Options", false to suppress them
$this_screen
string
Name of the page being loaded
Returns
boolean
True to display "Screen Options", false to suppress them
Save the "Entries per page" option set by this user
mla_set_screen_option_filter(mixed $status, string $option, string $value) : string | void
Parameters
$status
mixed
false or value returned by previous filter
$option
string
Name of the option being changed
$value
string
New value of the option
Returns
string
void
New value if this is our option, otherwise nothing
Ajax handler for bulk editing and mapping
_bulk_edit_ajax_handler() : void
Compose a Post Type Options list with current selection
_compose_post_type_select(array $templates, string $selection) : string
Parameters
$templates
array
template parts
$selection
string
current selection or 'all' (default)
Returns
string
HTML markup with select field options
Get the current action selected from the bulk actions dropdown
_current_bulk_action() : string | false
Returns
string
false
The action name or False if no action was selected
Delete a single item permanently
_delete_single_item(array $post_id) : array
Parameters
$post_id
array
The form POST data
Returns
array
success/failure message and NULL content
Process bulk edit area fields, which may contain a Content Template
_process_bulk_value(integer $post_id, string $bulk_value) : string
Parameters
$post_id
integer
Current post ID
$bulk_value
string
Field value as entered
Returns
string
Empty, or new value for the field
Process secure file download
_process_mla_download_file() : void
Requires _wpnonce, mla_download_file and mla_download_type in $_REQUEST; mla_download_disposition is optional.
Restore a single item from the Trash
_restore_single_item(integer $post_id) : array
Parameters
$post_id
integer
The WordPress Post ID of the attachment item
Returns
array
success/failure message and NULL content
Move a single item to Trash
_trash_single_item(integer $post_id) : array
Parameters
$post_id
integer
The WordPress Post ID of the attachment item
Returns
array
success/failure message and NULL content
Properties
Accumulates error messages from name conflict tests
$mla_language_support_error_messages
Holds screen ids to match help text to corresponding screen
$page_hooks : array
Constants
Object name for localizing JavaScript - MLA List Table
JAVASCRIPT_INLINE_EDIT_OBJECT : string
mla_admin_action value for setting an item's parent object
MLA_ADMIN_SET_PARENT : string
mla_admin_action value for mapping Custom Field metadata
MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP : string
mla_admin_action value to display a single item for editing
MLA_ADMIN_SINGLE_EDIT_DISPLAY : string
Used by class-mla-view-list-table.php and class-mla-upload-list-table.php
mla_admin_action value for updating a single item
MLA_ADMIN_SINGLE_EDIT_UPDATE : string
Used by class-mla-view-list-table.php and class-mla-upload-list-table.php
mla_admin_action value for mapping IPTC/EXIF metadata
MLA_ADMIN_SINGLE_MAP : string
mla_admin_action value for searching taxonomy terms
MLA_ADMIN_TERMS_SEARCH : string
Current date for Development Version, empty for production versions
MLA_DEVELOPMENT_VERSION : string