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
Redirect to the Edit Tags/Categories page
mla_edit_tax_redirect() : void
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.
Ajax handler for inline editing (quick and bulk edit)
mla_inline_edit_action() : void
Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php
Cleanup menus for Edit Tags/Categories page
mla_parent_file_filter(array $parent_file) : string
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.
Parameters
$parent_file
array
The top-level menu page
Returns
string
The updated top-level menu page
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(boolean $status, string $option, string $value) : string | void
Parameters
$status
boolean
Unknown - always false?
$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
Get the edit Authors dropdown box, if user has suitable permissions
_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
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
Display a single item sub page; prepare the form to
change the meta data for a single attachment.
_display_single_item(int $post_id) : array
Parameters
$post_id
int
The WordPress Post ID of the attachment item
Returns
array
message and/or HTML content
Restore a single item from the Trash
_restore_single_item(array $post_id) : array
Parameters
$post_id
array
The form POST data
Returns
array
success/failure message and NULL content
Move a single item to Trash
_trash_single_item(array $post_id) : array
Parameters
$post_id
array
The form POST data
Returns
array
success/failure message and NULL content
Properties
Holds screen ids to match help text to corresponding screen
$page_hooks : array
Constants
Slug for adding plugin submenu
ADMIN_PAGE_SLUG : string
Current version number
CURRENT_MLA_VERSION : string
Object name for localizing JavaScript - MLA List Table
JAVASCRIPT_INLINE_EDIT_OBJECT : string
Slug for localizing and enqueueing JavaScript - MLA List Table
JAVASCRIPT_INLINE_EDIT_SLUG : string
Object name for localizing JavaScript - edit single item page
JAVASCRIPT_SINGLE_EDIT_OBJECT : string
Slug for localizing and enqueueing JavaScript - edit single item page
JAVASCRIPT_SINGLE_EDIT_SLUG : string
Action name; uniquely identifies the nonce
MLA_ADMIN_NONCE : string
mla_admin_action value for mapping Custom Field metadata
MLA_ADMIN_SINGLE_CUSTOM_FIELD_MAP : string
mla_admin_action value for permanently deleting a single item
MLA_ADMIN_SINGLE_DELETE : string
mla_admin_action value for displaying a single item
MLA_ADMIN_SINGLE_EDIT_DISPLAY : string
mla_admin_action value for updating a single item
MLA_ADMIN_SINGLE_EDIT_UPDATE : string
mla_admin_action value for mapping IPTC/EXIF metadata
MLA_ADMIN_SINGLE_MAP : string
mla_admin_action value for restoring a single item from the trash
MLA_ADMIN_SINGLE_RESTORE : string
mla_admin_action value for moving a single item to the trash
MLA_ADMIN_SINGLE_TRASH : string
Display name for this plugin
PLUGIN_NAME : string
Slug for registering and enqueueing plugin style sheet
STYLESHEET_SLUG : string