=== Enhanced Media Library ===
Contributors: webbistro
Tags: media library, media category, media categories, media gallery, gallery shortcode, media tag, media tags, media taxonomy, media taxonomies, media uploader, mime type, mime, mime types, file types, media types, media filter, attachment, gallery, image, images, media, ux, user experience, wp-admin, admin, taxonomy, taxonomies
Requires at least: 4.4
Tested up to: 4.4.1
Stable tag: 2.1.5
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html



A better management for WordPress Media Library



== Description ==

The plugin will be handy for those who need to manage a lot of media files.


= Media Taxonomies =

**Categories and Tags for media items**

**Various media categories.** With the plugin installed you immediately obtain Media Categories for categorizing and filtering media items in WordPress admin. This feature alone will save you hours of searching through a media library with even as few as 100 images.

Whether you have a lot of images that need to be organized into complex structures or simply dislike the name of the default taxonomy – Media Categories – you can create and (un)assign to the media library as many taxonomies as you wish without writing a single line of code.

You can also assign to the media library built-in WordPress taxonomies – Categories and Tags – as well as any other taxonomy created by third-party plugin, theme, or hand-coded – with only plugin's UI.

**For both new and existing media items.** Categorize both new and existing media items. You can assign a category to a media item during the upload process, in the media library (preferably in the Grid Mode), in post/page editor media popup ("Add Media" button). If you need to manage a lot of media items at once, there is the PRO version of the plugin that allows to do it in bulk.

**Filter media items in WP admin.** Every media library screen is enhanced with the plugin's filters to search and sort your media files. With flexible plugin's options you can adjust what filters you will see in Grid and List modes of the media library and in post/page editor media popups, and what taxonomies you would like to edit when inserting media to posts/pages. The plugin works with custom post types as well. The options can also help you to force plugin's filters for third-party plugins or themes, manage media taxonomies archive pages, etc.

**Order options.** With two options "Order media items by" (Date, Title, and Custom Order) and "Sort order" (Ascending and Descending) you can control media items order for all screens of the media library in WP admin. "Custom Order" allows to re-order media items within a category with drag and drop. This order will be used, in particular, for the gallery based on this category. See `Media Settings > Taxonomies > Options > Filters`.


= Filter-Based Image Galleries =

**Fully compatible with WordPress native gallery shortcode**

Image categorizing can be useful for the front-end as well. To insert media galleries based on media categories you have to use the familiar format like `[gallery media_category="5" category="2" limit="10" monthnum="12" year="2015" orderby="title" order="DESC"]`. The PRO version of the plugin allows to manage gallery shortcode without "coding" at all. Just choose the settings with the plugin's UI in the familiar gallery edit popup and see your gallery live immediately in the post/page editor.

To turn on the feature set "Enhanced gallery" option on `Media Settings > Taxonomies > Options > Gallery`. Please be advised that conflicts with other gallery plugins or themes are possible. Check your front-end and back-end gallery functionality after activating the feature.


= MIME Types =

**Media File Types**

Another feature of the plugin is the MIME Types control. You can add new MIME types, delete existing ones, and point what file types are allowed for uploading. Initially, the plugin shows up the WordPress default MIME Type settings and creates the backup of them. The column "Add Filter" allows to add a MIME Type to plugin's filters so that you will be able to filter your media items not only by categories but also by the file type. You can set any label you wish to see in a filter with columns "Singular Label" and "Plural Label".


= Export / Import Plugin Settings =

If you need to move your media library to another website you should export and import WordPress content with WordPress built-in export/import. But to make the Enhanced Media Library work on the new site with the same settings you are provided with the export/import feature.


= Easy to Use and WordPress Native Functionality Oriented Plugin =

We spend hours to make plugins features work as though they were native WordPress functionality. If you are a developer and looking for a solution totally compatible with WordPress core and, at the same point, really easy to deal with for your non-geeky customers, give it a try, you won't be disappointed.


= Support =

Support is free for both versions of the plugin. "PRO"-users do not have priority. We do out best to respond in 24 hours if not sooner.


= Available Languages (Assistance with the translation is highly appreciated) =

* Dutch
* German
* Hebrew
* Korean
* Polish
* Swedish

Many thanks to the authors of the translations! If you wish to be credited here please just let us know what name and URL we have to use.


= Compatibility with Other Plugins =

* Advanced Custom Fields
* Search & Filter
* WooCommerce
* Meta Slider
* Jetpack Carousel
* Jetpack Tiled Galleries
* Simple Lightbox
* Responsive Lightbox by dFactory

Please let us know if you find any issue with the plugins from the list above or others.


= Incompatibility =

Please notice that you use the Enhanced Media Library with other plugins that add media categories, media folders, and manage MIME Types at your own risk. We cannot guarantee their compatibility because of different approach to the same functionality. It does NOT mean that we do not recommend using those plugins, it just means we do not recommend to use them at the same time with the Enhanced Media Library. Please choose the one you prefer.


> #### Enhanced Media Library PRO

> The key features:

> * Media files can be categorized in bulk (multiple files to multiple taxonomies at once) both just uploaded and existing
> * Media files within a category can be selected in bulk with a single click
> * Selected media files can be deleted in bulk in the Grid mode of the media library or in the post/page editor media popup
> * Filter-based gallery in two clicks, no need to figure out your media category IDs, nor to delve into the text editor shortcode


= Useful Links =

* [Where to start? (The complete beginners guide)](http://wpuxsolutions.com/documents/enhanced-media-library/eml-where-to-start/)
* [Enhanced Gallery Possible Conflicts](http://www.wpuxsolutions.com/documents/enhanced-media-library/enhanced-gallery-possible-conflicts/)



== Installation ==

1. Upload plugin folder to '/wp-content/plugins/' directory

2. Activate the plugin through `Plugins` menu in WordPress admin

3. Adjust plugin's settings on `Media Settings > Taxonomies` or `Media Settings > MIME Types`

4. Enjoy Enhanced Media Library!



== Frequently Asked Questions ==

= Why my custom media taxonomy's page is 404? =

Try to just re-save permalinks settings. Go to `Settings > Permalinks` and push "Save Changes" button.

= Why Media Popup of some theme/plugin does not show taxonomy filters? =

By default EML adds its filters to any media popup that already contains native WordPress filters. If a third-party plugin or theme supports native WordPress filters, EML will enhance them.

If a third-party plugin or theme does not support WordPress native filters, but you believe that you need them, try "Force filters" option (`Media Settings > Taxonomies > Options > Filters`). It allows forcing media filters for ANY media popup regardless of what was intended by its creator.

= How to show images per media category on a webpage? =

Since EML 2.1 you can use gallery shortcode with taxonomy parameters like this: `[gallery media_category="5" category="2" limit="10" monthnum="12" year="2015" orderby="title" order="DESC"]` to show filter-based gallery on the front-end. The feature should be activated on Media `Settings > Taxonomies > Options > Gallery`.

Also, you can use WP_Query ([example of the code](http://wordpress.org/support/topic/php-displaying-an-array-of-images-per-category-or-categories)).

= My gallery behavior is strange | Wrong or none media items displayed | Ligtbox/carousel/slideshow/mosaic looks broken =

The plugin enhances WordPress gallery shortcode in most gentle manner possible. Since v2.1.5 the mechanism of the enhancement is dramatically improved to avoid possible conflicts. In most cases Enhanced Media Library is compatible with any plugin that changes *native* WP gallery template in order to provide lightbox, carousel, slideshow, grid/mosaic functionality.

That said, other plugins might override WP gallery attributes or database query for media items in a way that would prevent Enhanced Media Library from displaying correct set of media items for gallery.

If you find a possible conflict and prefer third-party features to taxonomy-based gallery of the plugin, please deactivate the feature (unset "Enhanced gallery" option on `Media Settings > Taxonomies > Options > Gallery`) and let us know about the issue. We would like to find a solution!

If you are a plugin/theme developer please read [Enhanced Gallery Possible Conflicts](http://www.wpuxsolutions.com/documents/enhanced-media-library/enhanced-gallery-possible-conflicts/)

= I get "Something went wrong" error when bulk-editing in PRO =

Your server can simply not have enough time when processing a lot of media items. Increase `max_execution_time` to 300 (5 minutes) and try again. Increasing memory_limit could help as well.

= Will I lose media categories I’ve created if I upgrade from free to PRO? =

No, all your data will remain intact. Your created media categories and their ties with your images are stored in the database. When you deactivate and delete the free version and then upload and activate the PRO one nothing happens to the database.



== Screenshots ==

1. Media Taxonomies Settings

2. MIME types manager

3. Create media categories just like any others

4. Use media categories in Nav Menu

5. Attach media categories to media files like to posts

6. Attach media categories to media files from Media Library grid view

7. Attach media categories to media files in Media Popup while editing posts and pages. Filter media files by categories and file types

8. Filter media files by categories and file types in Media Library list view

9. Filter media files by categories and file types in Media Library grid view



== Changelog ==

= 2.1.5 =
*Release Date - January 14, 2016*

= Improvements =
* Gallery enhancement is dramatically (!) improved to avoid possible conflicts ([learn more](http://www.wpuxsolutions.com/documents/enhanced-media-library/enhanced-gallery-possible-conflicts/))
* Few code improvements

= Bugfixes =
Filters returned to Customizer


&nbsp;
= 2.1.4 =
*Release Date - January 10, 2016*

= New =
* Option "limit" added to the gallery shortcode
* Options "Order media items by" (orderby) and "Sort order" (order) added to admin

= Improvements =
* Bulk edit is now 3 times faster and less server resources consuming! [PRO only]
* Gallery feature are now turned off by default. Option "Turn off enhanced gallery" replaced with "Enhanced gallery"
* Minor CSS improvements

= Compatibility =
* Jetpack Tiled Galleries compatibility ensured
* We are going to abandon support for older versions of WordPress. EML 2.1.4 is still compatible with WP 4.0, but from the next release we stop testing it with older versions.

= Bugfixes =
* Characters | and > are no longer delimiters (there are no delimiters any more) and can be used for media category name.
* Few minor bugs fixed


&nbsp;
= 2.1.3 =
*Release Date - December 17, 2015*

= Bugfixes =
* Compatibility of the plugin's code with different PHP versions ensured
* "Warning: Missing argument 3 for wpuxss_eml_gallery_shortcode()" fixed
* The bug with unavailable image meta on Edit Gallery screen fixed

= Improvements =
* "Turn off enhanced gallery" option added. Allows to turn off the gallery shortcode enhancement without deactivating the whole plugin in case of incompatibility with other plugins or themes. Please inform plugin authors about the issue. We would like to fix it!


&nbsp;
= 2.1.2 =
*Release Date - December 15, 2015*

= Compatibility =
* Fixed v2.1 and Jetpack Carousel incompatibility


&nbsp;
= 2.1.1 =
*Release Date - December 15, 2015*

= Bugfixes =
* Minor incompatibility with WordPress 4.3 fixed


&nbsp;
= 2.1 =
*Release Date - December 15, 2015*

= New =
* Filter-based Image Galleries by extending native WordPress gallery shortcode
* Easy visual gallery editing with the native WordPress gallery UI [PRO only]
* Export/import of the plugin settings to JSON

= Improvements =
* Better filtering and "force filters" mechanism, sorting by 'menuOrder' by default for media taxonomy filters
* Plugin credits in admin removed from Media Settings > Taxonomies, and Media Settings > MIME Types, moved to Settings > Enhanced Media Library
* "Deactivate License" added [PRO only]
* Various code improvements for both free and PRO
* Minor UX improvements

= Compatibility =
* Fixed incompatibility with [WP Plugin Dependencies](https://github.com/xwp/wp-plugin-dependencies)
* Wordpress 4.4 compatibility ensured

= Languages =
* Korean translation added


&nbsp;
= Previous releases... =
