Dynamic Addon

Would you like to create galleries on the fly from within your page or post? Envira’s Dynamic Addon gives you the freedom to generate galleries without the need manual of intervention. It’s simple, fast and incredibly easy to do.

1. Requirements
2. Addon Compatibility
3. Installation
4. Setup
5. Outputting a Dynamic Gallery
   • Output the current Page/Post/CPT’s attached images
   • Output specific images in the WordPress Media Library
   • Images from a folder in the WordPress Content Directory
   • Overriding the default WordPress Gallery output with an Envira Gallery
   • Output images from a NextGen Gallery
   • Output Gallery from specified Tag(s) (if the Tags Addon is activated).
6. Outputting a Dynamic Album
   • Output Album from specified Envira Gallery IDs
   • Output Album comprising of all Envira Galleries
7. Overriding Global Configuration Settings
8. FAQs
   • The ‘title_display’ isn’t showing in my caption display on the lightbox
   • Pagination isn’t working on my Dynamic gallery?
   • I don’t see the Watermark Tab on the Dynamic Gallery?
   • Why are images from my subdirectory are not being displayed.
   • Are there any restrictions on naming my dynamic shortcode?
   • Why aren’t my tagged images displaying in my dynamic gallery?
   • How can I use Password Protection with my Dynamic Gallery?
   • My images aren’t loading or they’re loading another Dynamic Gallery’s images. What should I do?

Requirements

• Ultimate, Agency or Pro Envira license. You can read how to upgrade to one of these licenses here.
• WordPress 4.4+
• Envira Gallery 1.3.4.1+

Addon Compatibility

At this time, the Dynamic Addon is not compatible with the Pagination Addon‘s AJAX pagination options, specifically:

• On Pagination Click (AJAX)
• On Button Click (AJAX)

Due to this limitation, you are unable to select the Display All Images in Lightbox? from the Pagination Tab:

Installation

Please follow our instructions on how to install and activate addons.

In this instance, you’ll be activating the Envira Dynamic Addon.

Setup

Once the Addon has been installed and activated, there will be a new gallery item named Envira Dynamic Gallery. This is used to define the default, global settings which are then used by any Envira Dynamic Gallery instance.

The settings configured for the Envira Dynamic Gallery only apply to Dynamic Galleries (that is, galleries created using the Dynamic shortcode or template tag).

For details on the available settings, please see the Creating Your First Envira Gallery document, which includes a breakdown of all available configuration options.

Outputting a Dynamic Gallery

The Dynamic Addon can be used to create galleries from images in a number of different scenarios:

1. Output the current Page/Post/CPT’s attached images
2. Output specific images in the WordPress Media Library
3. Images from a folder in the WordPress Content Directory
4. Overriding the default WordPress Gallery output with an Envira Gallery
5. Output images from a NextGen Gallery
6. Output Gallery from specified Tag(s) (if the Tags Addon is activated).

There are two methods available to output an Envira Dynamic Gallery:

• shortcode
• template tag

The shortcode output is typically used within a Visual Editor on your WordPress Page, Post or Custom Post Type, and is:
[envira-gallery-dynamic]

The template tag output is typically used within your WordPress Theme’s PHP code, and is:
envira_dynamic();

Shortcodes and template tags accept a number of configuration options (or arguments) to customize the output of the gallery: [envira-gallery-dynamic id="tags-food"].

Output the current Page/Post/CPT’s attached images

Shortcode:
[envira-gallery-dynamic id="123"]

Template Tag:
envira_dynamic( array( 'id' => 123 ) );

Notes:

1. Replace ‘123’ with your Page/Post/CPT’s ID.

Output specific images in the WordPress Media Library

Shortcode:
[envira-gallery-dynamic id="custom-XXX" images="600,601,602"]

Template Tag:
envira_dynamic( array( 'id' => 'custom-XXX', 'images' => '600,601,602' ) );

Notes:

1. Replace ‘XXX’ with a unique name (this can be anything).
2. Set the ‘images’ parameter to be a comma separated list of Media Library attachment IDs.

Images from a folder in the WordPress Content Directory

Shortcode:
[envira-gallery-dynamic id="folder-gallery"]

Template Tag:
envira_dynamic( array( 'id' => 'folder-gallery' ) );

Notes:

1. The folder name begins after folder-; in the example above you would need a folder called gallery inside your wp-content folder.
2. The parent folder must be directly within the wp-content directory e.g. wp-content/gallery. Subdirectories (wp-content/gallery/gallery) will also work.
3. Files within the folder must not contain spaces. For best compatibility, stick to alphanumeric characters
4. JPG, JPEG, PNG and GIF images are supported
5. Performance may be slower than adding your images to an Envira Gallery – this should only be used for a small number of images.

Overriding the default WordPress Gallery output with an Envira Gallery

Simply check this on your Envira Dynamic Gallery and you’re all set!

Output images from a NextGen Gallery

Shortcode:
[envira-gallery-dynamic id="nextgen-ID"]

Template Tag:
envira_dynamic( array( 'id' => 'nextgen-ID' ) );

Notes:

1. Replace ‘nextgen-ID’ with the ID of your NextGen Gallery.

Output Gallery from specified Tag(s)

See our guide on how to populate a Dynamic gallery from Tags: Display a Tag Based Dynamic Gallery

Shortcode:
[envira-gallery-dynamic id="tags-food"]

Outputting a Dynamic Album

The Dynamic Addon can also be used to create albums from:

1. Output Album from specified Envira Gallery IDs
2. Output Album comprising of all Envira Galleries

Output Album from specified Envira Gallery IDs

Shortcode:
[envira-album-dynamic id="custom-XXX" galleries="607,611"]

Template Tag:
envira_dynamic_album( array( 'id' => 'custom-XXX', 'galleries' => '607,611' ) );

Notes:

1. Replace ‘XXX’ with a unique name (this can be anything).
2. Set the ‘galleries’ parameter to be a comma separated list of Envira Gallery IDs.

Output Album comprising of all Envira Galleries

Shortcode:
[envira-album-dynamic id="custom-XXX" galleries="all"]

Template Tag:
envira_dynamic_album( array( 'id' => 'custom-XXX', 'galleries' => 'all' ) );

Notes:

1. Replace ‘XXX’ with a unique name (this can be anything).
2. Set the ‘galleries’ parameter = all.

Overriding Global Configuration Settings

By default, each Envira Dynamic Gallery will use the settings defined in the Envira Dynamic Gallery item found at WordPress Administration » Envira Gallery.

To override one or more settings on a per-dynamic gallery basis, add the Programmatic Name parameter(s) to your shortcode or template tag. These can be found in the Configuring your Gallery Documentation.  For example:

Shortcode:
[envira-gallery-dynamic id="custom-ID" images="600,601,602" columns="6" gallery_theme="base" display_description="1"]

Template Tag:
envira_dynamic( array( 'id' => 'custom-ID', 'images' => '600,601,602', 'columns' => 6, 'gallery_theme' => 'base', 'display_description' => 1 ) );

FAQs

Q: The ‘title_display’ isn’t showing in my caption display on the lightbox

A: This option is not available when using the Base (Dark) or Base (Light) lightbox theme.

Q: Pagination isn’t working on my Dynamic gallery?

A: Currently the only pagination ‘type’ that can be used for Dynamic galleries is the “On Pagination Click, reloading Page”.

Q: I don’t see the Watermark Tab on the Dynamic Gallery?

A: Currently the watermarking tab is unavailable for dynamic galleries. Since the gallery is dynamic Envira does not currently have a way to confirm if the image has already been watermarked.

Q: Why are images from my subdirectory are not being displayed.

A: Dynamic galleries pulling from a folder will only look for images from the folder specified in the shortcode. It will not look into any subdirectories for additional images. If you are wanting to pull the images from a subdirectory, you will need to specify that subdirectory like so: [envira-gallery-dynamic id="folder-gallery/subdirectory"].

Q: Are there any restrictions on naming my dynamic shortcode?

A: For best practices when naming your dynamic shortcodes, it’s always best to not use any characters that can be seen as possible code. Things like semi-colons, colons, commas or number signs should be avoided.

Q: Why aren’t my tagged images displaying in my dynamic gallery?

A: In order to create a dynamic tagged gallery, those images you want to display from your tag must already be included in an Envira gallery.

Q: How can I use Password Protection with my Dynamic Gallery?

A: First, make sure that the Password Protection Addon is enabled. Once this is done, you can add the proper attributes to the Dynamic shortcode to password protect your galleries. You can define a username or email using the password_protection_email attribute and a password using the password.

Here’s an example: [envira-gallery-dynamic id="410" password_protection_email="you@you.com" password="123"]

Note: Both attributes will need to be used for your galleries to be protected.

Q: My images aren’t loading or they’re loading another Dynamic Gallery’s images. What should I do?

A: In certain circumstances, transient cache may cause issues with images in Dynamic Galleries. Please follow the guide for Disabling the Fragment Cache. This may resolve your issue!