Plugin Directory

Media Library Assistant

Enhances the Media Library; powerful [mla_gallery], taxonomy support, IPTC/EXIF/PDF processing, bulk/quick edit actions and where-used reporting.


  • New: For the [mla_gallery] shortcode, the Google File Viewer (mla_viewer) has been replaced by two new featues. First, a "Featured Image" can be assigned to Media Library items; it will replace the MIME type icon as the thumbnail for the item. Second, PDF documents can generate a thumbnail image for the item if Imagemagick, Imagick and Ghostscript are available on the server. See the Other Notes section section or the Settings/Media Library Assistant Documentation tab for more information.
  • New: XMP metadata can be extracted from JPEG and TIFF images and used in [mla_gallery] shortcodes and IPTC/EXIF or Custom Field mapping rules.
  • New: Several simple MLA Gallery examples have been added to the Documentation tab.
  • New: A Media/Assistant submenu table custom view example plugin, mla-custom-view-example.php.txt has been added to the /media-library-assistant/examples/ directory. The example adds two custom views for "Attached" items and "Unpublished" items that are attached to a parent whose post_status is 'draft', 'future', 'pending' or 'trash' .
  • New: Two new filters for the "Media/Assistant Submenu Hooks" allow you to record or modify the new values for Bulk Edit fields. The /media-library-assistant/examples/mla-list-table-hooks-example.php.txt example plugin has been updated with the new filters.
  • New: A Terms Search "exact" option has been added to eliminate false matches such as "man" within "woman".
  • New: A new field-level data source, "alt_text" is available for use in shortcodes and mapping rules.
  • New: A new field-level option value, "substr(s,l)" is available for use in shortcodes and mapping rules. It uses the PHP substr() function to extract a portion of a field-level value.
  • New: If you add define( 'MLA_DEBUG_LEVEL', 1 ); to your wp-config.php file a new Settings/Media Library Assistant Debug tab is available. The new tab lets you view, download and reset (empty) the PHP error log file.
  • New: The Development Version date and MLA debug level, if applicable, are now added to the title of the Settings/Media library Assistant submenu.
  • Fix: Text and Textarea option settings containing backslashes are now cleaned up with stripslashes.
  • Fix: In the Media Manager Modal Window, CSS styles have been updated to improve the layout of the toolbar.
  • Fix: If 'Enable "bulk edit" area' is checked, bulk edit on Add New uploads will be run even if all four "enable mapping" options are disabled.
  • Fix: Terms Search performance has been improved by eliminating redundant table joins.
  • Fix: For the Media/Assistant submenu table, sorting on custom fields now works correctly.
  • Fix: For the Media/Assistant submenu table, Search Media with the terms option now works correctly.
  • Fix: The /media-library-assistant/examples/mla-acf-checkbox-example.php.txt example plugin has been re-written to use the new filters and to confrom to changes made in MLA version 2.01.
  • Fix: The /media-library-assistant/examples/mla-image-source-control-example.php.txt example plugin has been re-written to use the new filters and to confrom to changes made in MLA version 2.01.
  • Fix: Where-used reporting now identifies posts and pages in the Trash.
  • Fix: For IPTC/EXIF mapping, single/double quotes in the EXIF/Template Value field are now handled correctly, without adding backslash characters to the new values.
  • Fix: Field-level option values containing multiple arguments are now parsed correctly.
  • Fix: Several changes to the Translation/Localization strings to reduce translation effort.


  • New: For the Media/Add New screen, a new Bulk Edit area lets you assign taxonomy terms and change standard or custom fields as new items are uploaded to the Media Library.
  • New: An enhanced array of "CAMERA"-related fields is provided as part of the EXIF metadata. They contain more attractive and useful versions of "ExposureBiasValue", "ExposureTime", "Flash", "FNumber", "FocalLength", "ShutterSpeed" and a number of "Other Tags". See the Other Notes section section or the Settings/Media Library Assistant Documentation tab for more information.
  • New: For IPTC/EXIF and Custom Field mapping, you can cancel and then resume mapping activity. You can also specify a starting offset for the resumes activity, allowing you to skip over previously-processed items or to re-process items.
  • New: For mapping rules and [mla_gallery], "timestamp", "date" and "fraction" format options can be used to format IPTC/EXIF metadata values, custom fields and other Data Sources. See the Other Notes section section or the Settings/Media Library Assistant Documentation tab for more information.
  • New: For [mla_gallery], parent_name (slug) and parent_permalink have been added to the Attachment-specific substitution parameters for the markup template Item part.
  • New: For [mla_gallery], the mla_terms_taxonomies parameter can be used for "Keyword(s) Search" to control which taxonomies are included if mla_search_fields includes "terms".
  • New: The "checked on top" option for checklist-style taxonomy meta boxes can be set or cleared on the Settings/Media Library Assistant General tab.
  • New: For IPTC/EXIF and Custom Field mapping, [+iptc:ALL_IPTC+] is now a synonym for [+exif:ALL_IPTC+].
  • New: Coverage of field-level substitution parameters in the Settings/Media Library Assistant Documentation tab has been re-organized, clarified and expanded.
  • New: A reference to plugin translation and the MLA Internationalization Guide have been added to the Settings/Media Library Assistant Documentation tab.
  • Fix: For the Media Manager/Media Grid Enhancements, PHP notice messages are avoided when the WordPress "current_screen" value is not set by other themes and plugins, such as the "Total theme and Visual Composer".
  • Fix: Multiple ALT Text (_wp_attachment_image_alt) values no longer cause PHP Warning messages; only the first value is used for [mla_gallery] and the Quick Edit area.
  • Fix: Some of the "Creating a new Translation" instructions in the MLA Internationalization Guide have been improved.
  • Fix: many of the translation strings have been re-organized to simplify translation efforts.
  • Fix: For [mla_gallery], any "alt=" and "class=" attributes coded in the mla_image_attributes parameter will override and replace the existing "alt=" and/or "class=" attributes in the "img" tag. This avoids the confusion of having two instances of the attribute(s) in the tag.
  • Fix: For [mla_gallery], documentation of a WordPress 4.0+ change that affects taxonomy, date and custom field (meta) queries has been added, including a work-around to avoid "Invalid mla_gallery tax_query" errors.
  • Fix: For [mla_gallery], the Google File Viewer (mla_viewer) has been replaced. Recent changes by Google, beyond MLA control, have removed support for the original feature. The interim fix allows you to substitute an appropriate icon for non-image file types. See the Documentation tab for more information.
  • Fix: For IPTC/EXIF and Custom Field mapping, custom field names with mixed case, spaces and punctuation characters are now properly handled. Custom field names with HTML reserved characters such as quotes and angle brackerts are properly escaped for display purposes.
  • Fix: For the Media/Assistant submenu table, column headers containing HTML reserved characters are now properly escaped for display purposes.
  • Fix: For the Media/Assistant submenu table, unnecessary processing and database access are avoided when all four "where-used" reporting options are disabled.
  • Fix: For [mla_gallery] and [mla_tag_cloud], duplicate mla_page_parameter query arguments have been eliminated from links in the gallery or cloud.
  • Fix: For [mla_gallery] and [mla_tag_cloud], damage caused by line-breaks between shortcode parameters is (usually) repaired.


  • New: For IPTC/EXIF mapping of taxonomy terms, significant performance improvements. Explicit handling of special cases and new caching code for "map all" processing eliminates unnecessary database queries.
  • New: For the Media/Assistant submenu, the "where-used" displays have improved. The post status (Draft, Pending, Future) is now included (it is also included in the "Parent Info" meta box on the Media/Edit Media screen). The parent post/page is moved to the top of the references list. The "Inserted in" file name is no longer displayed for the "base" option to save space.
  • New: For [mla_gallery] and [mla_tag_cloud], several new galley-/cloud- substitution values have been added. You can use these, for example, to add page-level information like Title or Date to data selection parameters.
  • New: An example of Media/Assistant submenu support for Advanced Custom Fields Checkbox variables is provided at /media-library-assistant/examples/mla-acf-checkbox-example.txt
  • New: An example of mapping PDF metadata to Standard Fields and Taxonomy Terms has been added to the "IPTC/EXIF Mapping for PDF Documents" section of the Settings/Media Library Assistant Documentation tab.
  • Fix: For [mla_gallery], the Google File Viewer parameter (mla_viewer) has been disabled. Recent changes by Google, beyond MLA control, have removed support for this feature.
  • Fix: Where-used reference information is no longer computed during file uploads, improving performance.
  • Fix: For the Media/Assistant submenu Bulk Edit area, updates to the "Categories" taxonomy are now handled correctly.
  • Fix: For [mla_gallery], a defect in the default handling of the post_parent parameter has been fixed. The defect was introduced in version 2.00.
  • Fix: For [mla_gallery], a defect in the handling of the exact=true parameter has been fixed.
  • Fix: For the "Select Parent" popup window, a defect in handling invalid post_status values has been fixed.


  • New: Requires WordPress v3.5 or greater.
  • New: Enhanced Keyword(s) Search and Taxonomy term keyword(s) search for the [mla_gallery] shortcode. See the Other Notes section section or the Settings/Media Library Assistant Documentation tab for more information.
  • New: Ajax-powered Bulk Edit processing lets you see the progress of large update batches and prevents script timeouts.
  • New: Ajax-powered Custom Field and IPTC/EXIF mapping lets you see the progress of large update runs and prevents script timeouts.
  • New: For custom field mapping rules, the "Raw" Format avoids the conversion of numeric zero values to blanks.
  • New: On the Media/Assistant submenu table Content Templates, including template:[+empty+], have been added to the Bulk Edit area processing for custom fields.
  • New: On the Media/Assistant submenu table the Download rollover action is more secure. Downloads now require a WordPress admin-mode nonce check to succeed.
  • New: For the [mla_tag_cloud] shortcode, the mla_get_terms_clauses filter lets you inspect or modify the SQL clauses used to retrieve terms for the cloud.
  • New: Two (2) new filters for the Media/Assistant submenu table let you intercept the beginning and end of Bulk Edit actions.
  • Fix: For [mla_gallery], the keyword search parameter ("s") now works properly when the user is not logged in.
  • Fix: For IPTC/EXIF mapping of custom fields, field names containing uppercase letters, whitespace and punctuation are now handled correctly.

1.90 - 1.95

  • 1.95: New [mla_gallery] parameters, Download rollover action, Media/Assistant submenu filters. Eleven enhancements, seven fixes.
  • 1.94: Media Manager fixes and new "current-item" parameters for [mla_tag_cloud]. Two other enhancements, seven fixes.
  • 1.93: WordPress 4.0 Media Grid enhancements (optional) and compatibility fixes. New auto-fill option for Media Manager taxonomy meta boxes. One other enhancement, three other fixes.
  • 1.92: Three bug fixes, one serious.
  • 1.91: WordPress 4.0 support! New "Edit Media meta box" and "Media Modal Initial Values" filters and example plugins. Four other enhancements, six fixes.
  • 1.90: New "Terms Search" popup window and Search Media "Terms" checkbox. Post Type filter and pagination for "Select Parent" popup. Ten other enhancements, five fixes.

1.80 - 1.83

  • 1.83: Corrects serious defect, restoring Quick Edit, Bulk Edit and Screen Options to Media/Assistant submenu. Three other fixes.
  • 1.82: "Select Parent" popup window (Media/Edit Media, Attached to column, Quick Edit area), SVG support and several new filter examples. Five other enhancements, three other fixes.
  • 1.81: Corrects serious defect in Media Manager Modal Window file uploading. Adds item-specific tag clouds. One other enhancement, five other fixes.
  • 1.80: Full taxonomy meta box support in the Media Manager Modal Window. Checkbox-style meta box for flat taxonomies. Fourteen other enhancements, nine fixes.

1.70 - 1.71

  • 1.71: Searchable Category meta boxes for the Media/Edit Media screen. Support for the WordPress "Attachment Display Settings". Six fixes.
  • 1.70: Internationalization and localization support! Custom Field and IPTC/EXIF Mapping hooks. One other enhancement, six fixes.

1.60 - 1.61

  • 1.61: Three fixes, including one significant fix for item-specific markup substitution parameters. Tested for compatibility with WP 3.8.
  • 1.60: New [mla_tag_cloud] shortcode and shortcode-enabled MLA Text Widget. Five other enhancements, four fixes.

1.50 - 1.52

  • 1.52: Corrected serious defect in [mla_gallery] that incorrectly limited the number of items returned for non-paginated galleries. One other fix.
  • 1.51: Attachment Metadata mapping/updating, [mla_gallery] "apply_filters" hooks, multiple paginated galleries per page, "ALL_CUSTOM" pseudo value. Three other enhancements, six fixes.
  • 1.50: PDF and GPS Metadata support. Content Templates; mix literal text with data values, test for empty values and choose among two or more alternatives for [mla_gallery] and data mapping. Four other enhancements, seven fixes.

1.40 - 1.43

  • 1.43: Generalized pagination support with "mla_output=paginate_links". One other enhancement, four fixes.
  • 1.42: Pagination support for [mla_gallery]! Improved CSS width (itemwidth) and margin handling. Eight other enhancements, six fixes.
  • 1.41: New [mla_gallery] "previous link" and "next link" output for gallery navigation. New "request" substitution parameter to access $_REQUEST variables. Three other enhancements, seven fixes.
  • 1.40: Better performance! New custom table views, Post MIME Type and Upload file/MIMEs control; 112 file type icons to choose from. Four new Gallery Display Content parameters. four other enhancements, twelve fixes.

1.00 - 1.30

  • 1.30: 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.
  • 1.20: Media Manager (Add Media, etc.) enhancements: filter by more MIME types, date, taxonomy terms; enhanced search box for name/slug, ALT text, caption and attachment ID. New [mla_gallery] sort options. Four other enhancements, four fixes.
  • 1.14: New [mla_gallery] mla_target and tax_operator parameters, tax_query cleanup and ids/include fix. Attachments column fix. IPTC/EXIF and Custom Field mapping fixes. Three other fixes.
  • 1.13: Add custom fields to the quick and bulk edit areas; sort and search on them in the Media/Assistant submenu. Expanded EXIF data access, including COMPUTED values. Google File Viewer support, two other enhancements and two fixes.
  • 1.11: Search by attachment ID, avoid fatal errors and other odd results when adding taxonomy terms. One other fix.
  • 1.10: Map attachment metadata to custom fields; add them to [mla_gallery] display and as sortable columns on the Media/Assistant submenu table. Get Photonic Gallery (plugin) integration and six other fixes.
  • 1.00: Map IPTC and EXIF metadata to standard fields, taxonomy terms and custom fields. Improved performance for where-used reporting. Specify default [mla_gallery] style and markup templates. Five other fixes.

0.11 - 0.90

  • [mla_gallery] support for custom fields, taxonomy terms and IPTC/EXIF metadata. Updated for WordPress 3.5!
  • Improved default Style template, [mla_gallery] parameters "mla_itemwidth" and "mla_margin" for control of gallery item spacing. Quick edit support of WordPress standard Categories taxonomy has been fixed.
  • MLA Gallery Style and Markup Templates for control over CSS styles, HTML markup and data content of [mla_gallery] shortcode output. Eight other enhancements and four fixes.
  • Removed (!) Warning displays for empty Gallery in and MLA Gallery in column entries.
  • New "Gallery in" and "MLA Gallery in" where-used reporting to see where items are returned by the [gallery] and [mla_gallery] shortcodes. Two other enhancements and two fixes.
  • Enhanced Search Media box. Extend search to the name/slug, ALT text and caption fields. Connect search terms with "and" or "or". Five other enhancements and two fixes.
  • New [mla_gallery] shortcode, a superset of the [gallery] shortcode that provides many enhancements. These include taxonomy support and all post_mime_type values (not just images). Media Library items need not be "attached" to the post.
  • SQL View (supporting ALT Text sorting) now created for automatic plugin upgrades
  • Bulk Edit area; add, remove or replace taxonomy terms for several attachments at once. Sort your media listing on ALT Text, exclude revisions from where-used reporting.
  • Support ALL taxonomies, including the standard Categories and Tags, your custom taxonomies and the Assistant's pre-defined Att. Categories and Att. Tags. Add taxonomy columns to the Assistant admin screen, filter on any taxonomy, assign terms and list the attachments for a term.
  • Quick Edit action for inline editing of attachment metadata
  • Fixed "404 Not Found" errors when updating single items.


  • Initial release.

Requires: 3.5.0 or higher
Compatible up to: 4.2.2
Last Updated: 2015-4-23
Active Installs: 20,000+


4.6 out of 5 stars


32 of 46 support threads in the last two months have been resolved.

Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

0,1,0 100,1,1
100,1,1 100,4,4 100,2,2 100,1,1 100,1,1
100,2,2 100,1,1 100,1,1 100,2,2 100,1,1
0,1,0 100,3,3
100,2,2 50,2,1
100,2,2 100,1,1
100,1,1 100,3,3
100,2,2 0,1,0
100,2,2 100,2,2
100,1,1 100,1,1
100,1,1 100,3,3