Setup

Prerequisites

• Any Media Library Organizer Pro license

Overview

Settings are used to control the taxonomies that are available to Attachments in the Media Library

By default, Media Library Organizer provides the Media Categories Taxonomy.

With the Taxonomy Manager, you can choose to define additional Taxonomies – for example, you might have a Location Taxonomy and assign Attachments based on their location.

In the WordPress Administration interface, click on Media Library Organizer > Settings

Settings

Clicking the Taxonomy Manager tab allows you to add, edit and remove additional Taxonomies:

Add Taxonomy

To add a Taxonomy:

• Click the Add Taxonomy button
  
• Define the following options in the new row that appears in the table:
  • Name (Plural): The plural name for this Taxonomy e.g. Media Categories
  • Name (Singular): The singular name for this Taxonomy e.g. Media Category
  • Hierarchical:
    • Yes: Terms in this Taxonomy can be optionally assigned to a Parent Term. This is how Media Categories performs.
    • No: Terms in this Taxonomy cannot be assigned to a Parent Term.  They’re sometimes called ‘flat’ Taxonomies or Tags.
  • Enabled:
    • Yes: Terms can be assigned to Attachments in the Media Library, and Terms can be added/edited/deleted
    • No: Terms cannot be assigned to Attachments in the Media Library. Terms cannot be added/edited/deleted
  • Enable on Frontend:
    • Yes: An archive of Attachments assigned to a given Taxonomy Term can be viewed on the frontend site.
    • No: An archive of Attachments assigned to a given Taxonomy Term cannot be viewed on the frontend site.
• Click the Save button at the bottom of the screen

Edit Taxonomy

To edit a Taxonomy:

• Identify the Taxonomy in the table
• Change the following options:
  • Name (Plural): The plural name for this Taxonomy e.g. Media Categories
  • Name (Singular): The singular name for this Taxonomy e.g. Media Category
  • Hierarchical:
    • Yes: Terms in this Taxonomy can be optionally assigned to a Parent Term. This is how Media Categories performs.
    • No: Terms in this Taxonomy cannot be assigned to a Parent Term.  They’re sometimes called ‘flat’ Taxonomies or Tags.
  • Enabled:
    • Yes: Terms can be assigned to Attachments in the Media Library, and Terms can be added/edited/deleted
    • No: Terms cannot be assigned to Attachments in the Media Library. Terms cannot be added/edited/deleted
  • Enable on Frontend:
    • Yes: An archive of Attachments assigned to a given Taxonomy Term can be viewed on the frontend site.
    • No: An archive of Attachments assigned to a given Taxonomy Term cannot be viewed on the frontend site.
• Click the Save button at the bottom of the screen

Delete Taxonomy

To delete a Taxonomy:

• Click the Delete button in the Taxonomy table row
  
• Click the Save button at the bottom of the screen

Save

Once you have added, edited and/or deleted Taxonomies, click the Save button.

On screen confirmation will display to confirm that the settings have been updated.

Enable Taxonomy as Filter

You may want to now enable your new Taxonomy / Taxonomies as dropdown filters in the Media Library.  Refer to the Documentation on steps to do this.

Enable on Frontend

When enabled for a given Taxonomy (such as Media Categories), it is possible to view all Attachments assigned to a given Taxonomy Term, by:

• Navigating to Media > Media Categories (or any other configured Taxonomy)
  
• Clicking View for the Taxonomy Term
  

An archive of Attachments assigned to the Taxonomy Term will be displayed; clicking an Attachment will display a page comprising of that individual Attachment.

Enable on Frontend: Styling

The above output is controlled by your Theme’s Taxonomy or Archive template.

Depending on your Theme, there are different ways to customize the styling for the output:

• Block based Themes: Using WordPress’ Editor, you may edit the Archive template’s Query Loop block, which controls what is output for each individual item within an archive:
  
  
  Making changes to the Query Loop block will also apply to your Post or Custom Post Archives (Taxonomies, Date etc).
• Non-Block based Themes: It may be possible to duplicate your Theme’s archive.php file, naming it to e.g. taxonomy-{taxonomy}.php, where {taxonomy} is the programmatic name (for example, mlo-category).