Envira Gallery

This article was last updated on the January 2, 2017.

In this article, we’ll cover some usage examples of how you can utilize Envira Gallery within your X powered site. We’ll mainly be focusing on how to use Envira Gallery and so may skip over some finer details.

Note: This article covers only a small portion of what you can achieve with Envira Gallery, make sure you take a look at the official documentation which is linked to in the Documentation section below to explore the full possibilities of this powerful tool.

Getting Started

Make sure you already have Envira Gallery installed and activated, then in your wp-admin, you should see the Envira Gallery menu item like this:

Envira Gallery Menu Item

Go ahead and click on Envira Gallery, once you’ve clicked that, you’ll see the Envira Gallery main admin screen like this:

Envira Gallery main admin

Documentation

As we mentioned further up, we’re only going to cover how to use Envira Gallery and not every option it provides, to learn more about Envira Gallery check out the official documentation here.

Adding a new Envira Gallery

In this article we’ll cover creating a Envira Gallery and then adding it to a new page on our website.

Go ahead and click Add New on the main Envira Gallery admin page. This will take you to the screen to add a new gallery like this:

New Envira Gallery

Enter in your Envira Gallery title. Once you’ve done that there’s two options you can either click on Select Files which will mean choosing images on your PC/Computer, or you can click on Click Here to Insert from Other Image Sources. For this article, we’re going to use the other image sources option. So go ahead and click on that. Clicking on that will allow you to select images from your WordPress media library to add to the gallery like this:

Select Images to use

If for some reason the image you want to select doesn’t show, just click on Load More Images from Library and then scroll down to find the image(s) you wish to use.

Once you’ve selected the images you wish to use, click on Insert Media into Gallery. Once you’ve done that, you’ll see the images in your gallery like this:

Images in Gallery

Clicking on the red x will remove that specific image from the gallery. Clicking on the i (for info) button will allow you to edit the Photo’s meta data like this:

Image Meta data

As you can see you can update:

  • Title
  • Caption
  • Alt Text
  • URL

Once you’ve updated the meta data just click on Save Metadata to save your changes and then click the x top right to return to the screen you was on.

If you scroll back to the top of the page, you’ll see there are various other tabs which contain different options you can set for your Envira Gallery:

Other Envira Gallery options

This allows you to set things such as how many columns your gallery has, the individual image dimensions and if they should be cropped. Whether to enable the lightbox when clicking on a gallery image and whether to create a mobile specific gallery for mobile devices among many other options. As explained further up in the article, we won’t cover every option here and will leave everything set to it’s default settings. But feel free to play around and find the best option suitable for your gallery.

Once you are happy with your gallery go ahead and click on Publish on the right hand side of the screen. If the publishing/saving was successful, you should see a notice at the top of your page reading Envira gallery published.

Envira Gallery and Cornerstone

For the purpose of this article we’re going to cover adding Envira Gallery on a new page through Cornerstone, but you can add it to a existing page/post anywhere you want. Load up the page/post you want to add it to in Cornerstone.

If it’s a new page/post, add a new section in Cornerstone which will contain the Envira Gallery. Scroll down the elements list in Cornerstone and you’ll see the Envira Gallery element like this:

Envira Gallery add

Drag and drop that Envira Gallery element into the new section you just created. If you have created multiple galleries, you’ll need to click on the gallery it adds and then select the gallery you wish to use from the dropdown option in Cornerstone:

Envira Gallery dropdown

Once you’ve added the slider and any other content to the page, you’ll notice in the Cornerstone preview area that the gallery doesn’t display, this is because the Envira Gallery element does not currently support the Cornerstone preview area. Save the changes and you’ll then be able to see the gallery when you visit the page on your site like this:

Envira Galery Added

Clicking on any of the images in your gallery will open the image in a lightbox, which will allow you to also browse through the rest of the gallery like this:

Envira Gallery Lightbox

We’ve only scratched the surface of what you can do with Envira Gallery, there are many more options, configurations and styles you can use all of which is covered by the official documentation.

Bundled Version

Users will frequently inquire about the version of Envira Gallery being utilized within X. Because of the way that we are utilizing the plugin with in X, it should be noted that the version of Envira Gallery included with the theme is made intentionally for numerous reasons. The following is just a few of the reasons why we do not always utilize the latest version of the Envira Gallery plugin:

We have removed the Settings page from Envira Gallery and Soliloquy per some code provided by Thomas (plugin author) as we provide them in an “integrated” fashion. You can add this back in if you have extensions you would like to use by adding a function to your functions.php file in your child theme like so:


function x_envira_gallery_remove_license_functionality() { return true; } 

This will overwrite our custom functionality in /x/functions/global/plugins/envira-gallery.php and should make things behave in a default manner again.

Keep in mind that this will also display the no valid license warning as well, so if you don’t have a personal license or plan on using Envira extensions it is recommended you do not overwrite this.

  • Stability – Newer versions of software do not always equal greater stability. Oftentimes there are undiscovered bugs that are introduced with certain versions and are unknown until the product has been released to the public for some time. The version of the plugin that we bundle with the theme is more or less guaranteed to work without any issues as we take a great deal of time to test all functionality thoroughly before releasing it along with the theme.
  • Release Cycles – While we try to include the latest version of Envira Gallery with each release, occasionally the release cycle of the plugin will prevent this from being possible. Essentially, since we have no idea when Envira Gallery will be releasing new versions of the plugin, we cannot plan our releases around this. Because of this, if we have already begun the process of finalizing our release and submitting it to ThemeForest for review while Envira Gallery is putting out a new version of the plugin, that version of the plugin will not be able to make it into the theme until the next release at the earliest.
  • Not Always Necessary – Some of Envira Gallery releases have only included simple “bug fixes” without any huge additions or modifications to the rest of the plugin. Because of situations like this, it is up to our discretion whether or not a new release will make it into the theme or not based on the nature of the update.

Because of these reasons (among others), there is no need to register your license for Envira Gallery if you happen to have one. In fact, doing so is discouraged in order to prevent any potential conflicts when updating, as previously mentioned. If you happen see a notification in your WordPress admin panel asking you to register Envira Gallery upon activation, simply dismiss this notice.

Conclusion

Hopefully the information provided above has helped you to gain a better understanding of what to expect from utilizing Envira Gallery within X. Ultimately, there are a few things to take away from this article:

  • Envira Gallery is a extremely powerful and flexible plugin that will assist you with creating the perfect website.
  • The version of Envira Gallery included with the theme is an modified version of the plugin with the main settings screen removed.
  • We do our best to ensure that the version of Envira Gallery included with X is as up-to-date as possible; however, this might not always be the case based on the reasons listed in the “Bundled Version” section above, which includes stability, release cycles, and the fact that not all updates are necessary.
  • Any questions concerning the usage of a Envira Gallery feature should be directed to the online documentation referenced in the article further up.