=== Media Library Assistant Blocks ===
Contributors: dglingren
Donate link: http://davidlingren.com/#donate
Tags: blocks, gutenberg blocks, gutenberg, block editor, media
Tested up to: 7.1
Stable tag: 1.0.0
Requires at least: 6.8
Requires PHP: 7.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Provides Gutenberg blocks for all shortcodes provided by the popular Media Library Assistant.

== Description ==

Media Library Assistant Blocks provides Gutenberg blocks for all shortcodes provided by the popular [Media Library Assistant](https://wordpress.org/plugins/media-library-assistant/) plugin. The blocks offer an easy way to compose MLA shortcodes by customizing the look and feel of shortcode output with controls in the Block Editor's Inspector Panel.

### Custom MLA Blocks
- **MLA Gallery**: The `[mla_gallery]` shortcode displays a gallery of images and/or other Media Library items (such as PDF documents). MLA Gallery is a superset of the [gallery] shortcode in the WordPress core; it is compatible with [gallery] and provides many enhancements.
- **MLA Tag Cloud**: The `[mla_tag_cloud]` shortcode displays a list of taxonomy terms in what is called a 'tag cloud', where the size of each term is determined by how many times that particular term has been assigned to Media Library items (attachments). The cloud works with both flat (e.g., Att. Tags) and hierarchical taxonomies (e.g., Att. Categories) MLA Tag Cloud provides many enhancements to the basic "cloud" display.
- **MLA Term List**: The `[mla_term_list]` shortcode displays hierarchical taxonomy terms in a variety of formats; link lists, dropdown controls and checkbox lists. The list works with both flat (e.g., Att. Tags) and hierarchical taxonomies (e.g., Att. Categories). 
- **MLA Custom Field List**: The `[mla_custom_list]` shortcode displays a list of WordPress custom field values in a variety of formats, including a "cloud", where the size of each list item is determined by how many times that particular value has been added to Media Library items (attachments). MLA Custom Field List provides many enhancements to the basic flat/cloud display.
- **MLA Archive List**: The `[mla_archive_list]` shortcode displays date-oriented values in a variety of formats, including a "cloud", where the size of each list item is determined by how many Media Library items (attachments) have the corresponding date value. The archive list works with year, month, week and day values. 

**NOTE:** Complete documentation is included in the Documentation tab on the Settings/Media Library Assistant admin screen and the drop-down "Help" content in the admin screens. You can find a stand-alone version of the Documentation on my web site: [Media Library Assistant Documentation](http://davidlingren.com/assets/mla-doc.html)

**I do not solicit nor accept personal donations in support of the plugin.** WordPress and its global community means a lot to me and I am happy to give something back.

If you find the Media Library Assistant plugin useful and would like to support a great cause, consider a [tax-deductible donation](http://secure.alsnetwork.org/goto/Chateau_Seaview_Fund) to our [Chateau Seaview Fund](http://secure.alsnetwork.org/goto/Chateau_Seaview_Fund) at the ALS Network. Every dollar of the fund goes to make the lives of people with ALS, their families and caregivers easier. Thank you!

== Installation ==

1. Install and activate the "Media Library Assistant" plugin

2. Upload `media-library-assistant-blocks` and its subfolders to your `/wp-content/plugins/` directory, **OR** Visit the Plugins/Add New page and search for "Media Library Assistant Blocks"; click "Install Now" to upload it

3. Activate the plugin through the "Plugins" menu in WordPress

4. Look for the "MLA Blocks" category in the Block Editor "Block Inserter" panel, or search for "MLA" in the "choose a block" popup.

5. Add and configure one or more MLA blocks to your post/page.

== Frequently Asked Questions ==

= Do the blocks support all of the shortcode parameters? =

The blocks allow you to see and configure all of the shortcode parameters needed for most applications. There are additional parameters used for more complicated applications; you can enter these directly, as you would when using the shortcode.

== Screenshots ==

1. The Block Editor showing the MLA Block icons in the Block Inserter and the MLA Gallery Block attributes in the Block Inspector.
2. The Settings/MLA Blocks Documentation tab, with information on what the plugin does and how it works.

== Changelog ==

= 1.0.0 =
* Initial Release

== Upgrade Notice ==

= 1.0.0 =
Initial Release.
