Use Coupon Code BF2022 to get 30% off New License Purchases!

Classic Editor / TinyMCE

Prerequisites and Setup

  • Any Media Library Organizer Pro license
  • Media Library Organizer Pro 1.4.1 or higher

Overview

Dynamic Galleries allow image galleries to be embedded in WordPress content, where the contents (images) of the gallery are dynamically queried – for example, by Media Category, Author or Search Terms.

Media Library Organizer Pro 1.4.1, releasing Thursday 10th November 2022 23:59, removes the existing Insert Dynamic Gallery button and UI.  You’ll now use the TinyMCE Dynamic Gallery button, which is available in any TinyMCE instance.

When editing a Page, Post or Custom Post Type using TinyMCE (whether the Classic Editor, or a supported Page Builder block/widget that uses TinyMCE), you’ll see a button in the Visual Editor to add a Dynamic Gallery:
Media Library Organizer: Dynamic Galleries: TinyMCE: Button

Click this button, and a modal dialog window will be displayed, where you can specify several attributes for your Gallery.

Taxonomy Query

Taxonomy queries will display images in the Dynamic Gallery that do (or do not) belong to some (or all) of the specified Taxonomy Terms (such as Media Categories).

Media Library Organizer: Dynamic Galleries: TinyMCE: Query

Attribute Description
Include Media Categories Start typing to search and specify one or more Categories.  Images will be displayed that are assigned to these Categories.
Include Media Categories Operator Determines whether Images should have all or any of the Categories above assigned to be eligible for display in the Gallery.
Exclude Media Categories Start typing to search and specify one or more Categories.  Images will be displayed that are not assigned to these Categories.
Exclude Media Categories Operator Determines whether Images should not have all or any of the Categories above assigned to be eligible for display in the Gallery.
Any Taxonomies defined and enabled in the Taxonomy Manager will also be displayed on this screen.

Authors

Authors will include or exclude images belonging to specified WordPress Users.

To display images in a Dynamic Gallery belonging to a specific author defined in the EXIF metadata, refer to the EXIF documentation.

Media Library Organizer: Dynamic Galleries: TinyMCE: Authors

Attribute Description
Include Author(s) Start typing to search and specify one or more WordPress Usernames.  Images will be displayed that were uploaded by user(s) chosen here.
Exclude Author(s) Start typing to search and specify one or more WordPress Usernames.  Images will be displayed that were not uploaded by user(s) chosen here.

Search Terms

Search Terms query images by a range of Attachment fields, such as the Title or Alt Text.

Media Library Organizer: Dynamic Galleries: TinyMCE: Search Terms

Attribute Description
Search Terms Specify freeform search terms or words.  Images will be displayed that contain these search terms in the Title, Caption, Alt Text or Description.
Title Specify freeform search terms or words.  Images will be displayed that contain these search terms in the Title.
Alt Text Specify freeform search terms or words.  Images will be displayed that contain these search terms in the Alt Text.
Caption Specify freeform search terms or words.  Images will be displayed that contain these search terms in the Caption.
Description Specify freeform search terms or words.  Images will be displayed that contain these search terms in the Description.

Custom Fields

Custom Fields allows for one or more conditions to be set, to query for images matching the given key/value pairs.

Media Library Organizer: Dynamic Galleries: TinyMCE: Custom Fields

To add a Custom Field condition:

  • Click the Add button
  • Specify the Custom Field programmatic name (or key)
    Media Library Organizer: Dynamic Galleries: TinyMCE: Custom Fields: Field
  • Specify the value that the key must match

Multiple Custom Field conditions can be specified, repeating the above process.  Where multiple Custom Field conditions are specified, all conditions must match for the image to be included in the Dynamic Gallery.

Querying Advanced Custom Fields

To query for images based on an ACF field’s value:

  • Navigate to Custom Fields > Field Groups
      Media Library Organizer: Dynamic Galleries: ACF: Menu
  • Create or edit a Field Group that is set to display on Attachments under the Location rule:
    Media Library Organizer: Dynamic Galleries: ACF: Location
  • Make a note of the applicable field’s Field Name (in this example, country)
    Media Library Organizer: Dynamic Galleries: ACF: Field
  • In Dynamic Galleries, navigate to Custom Fields
  • Click the Add button
  • Specify the Custom Field programmatic name (or key), based on the Field Name you made a note of above, and the value that the Field must match
    Media Library Organizer: Dynamic Galleries: Custom Fields: ACF Example

Pagination

Pagination options, if enabled, display numerical and previous/next links within a Dynamic Gallery, if the number of images exceeds the Total Number of Images setting.

Media Library Organizer: Dynamic Galleries: TinyMCE: Pagination

Attribute Description
Enable Pagination When checked / selected, pagination will be displayed if the Total Number of Images (per Page) setting is less than the total number of Images in the Gallery.
Total Number of Images (per Page)  The maximum number of Images to display in the Gallery.  When Pagination is enabled, this setting becomes the maximum number of Images to display per Page in the Gallery
Pagination Position If Pagination is enabled, whether to display the Pagination above, below or above and below the Gallery.
Previous Link Label The text to display for the Previous Page Link in the Pagination.
Next Link Label The text to display for the Next Page Link in the Pagination.

Display Options

Display options determine the order of the image output, the number of columns to display, and the size of the images to display.

Media Library Organizer: Dynamic Galleries: TinyMCE: Display

Attribute Description
Order Determines how to order the output of images found based on the above attributes.
Link To What each image should link to.
Columns The number of columns to display in the Gallery.
Size The size to display for each image.  Sizes are WordPress registered image sizes.

Once you have defined the Dynamic Gallery settings, click the Insert button.

A [[media_library_organizer_dynamic_gallery]] shortcode will then appear in the TinyMCE Editor, comprising of the attributes defined above:
Media Library Organizer: Dynamic Galleries: TinyMCE: Shortcode Output

Viewing the Page will then display the images based on the Dynamic Gallery configuration:
[]