Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Instagram Addon

Share This Post!

Are you an avid Instagram user that wants to show off your images? The Instagram Addon for Envira Gallery gives you that option! This doc will show you how to display galleries populated with Instagram images based on user.


Requirements

Installation

First you will need to install the Instagram Addon for Envira. Please follow our instructions on how to install and activate addons.

Setup

To begin, please follow the steps below.

Step 1 – Enable & Authenticate Instagram

Your first step is to authenticate your Instagram account with Envira. This gives Envira permission to access your Instagram images.

Click the Envira Gallery » Settings and select the Instagram tab. Next, select the Click Here to Authenticate Envira with Instagram button.

Select the button in the Instagram settings tab to authenticate your Instagram account with Envira Gallery.

Next, you’ll be prompted to login to your Instagram account if you aren’t already.

Click the Authorize button. This connects Envira to your Instagram account.

You'll need to select the Authorize button when prompted to connect Envira Gallery with your Instagram account.

Once the authentication process is completed, you’ll see on screen confirmation.

A success message will appear when you've finished authenticating Instagram with Envira.

Step 2 – Add Instagram Images to your Gallery

When creating or editing an existing gallery, select the External Gallery tab as the gallery type you’re creating. Next, select the Instagram icon to create your Instagram gallery.

Select Instagram as the service you want to populate your gallery with to begin creating an Instagram gallery.

You’ll then be able to configure your gallery settings on the Images tab with the following options:

  • Feed Type – The only Feed Type currently available is My Instagram Photos
  • Number of Instagram Photos – The number of images to pull from your Instagram feed.
  • Image Resolution – Determines the image resolution and size to use from Instagram. Options: Thumbnail (150×150), Low Resolution (306×306), Standard Resolution (640×640), Full Non-Cropped Resolution
  • Link to Instagram Location? – Links the photo to its original location on Instagram.
  • Open In New Tab? – Opens the link to Instagram in a new browser tab.
  • Use Photo Caption? – Displays the photo caption from Instagram on the slide.
  • Limit Caption Length – Limits the number of words to display for each caption.
  • Cache Data from Instagram? – Caches the data from Instagram to improve performance (recommended).

Finally, Publish or Update your gallery and view to see the Instagram gallery.

Would you like to try creating a similar gallery using images from your blog posts? Why not check out our documentation on Envira’s Featured Content Addon.


FAQs

Q: How can I use Lightbox with Instagram images?

A: Instead of directing your visitors to Instagram, you can display your Instagram photos in a Lightbox by going to the Images tab and setting Link to Photo? to “Direct Image on Instagram”.

Then navigate to the Lightbox tab, enable, and configure your options. Once you enable and set those options and save, you will be all set to display your photos in a beautiful Lightbox gallery!


Q: Why can’t I set my image sizes?

A: When creating an Instagram gallery, the images only have reading access. This means Envira can only see the images from your Instagram and use the image URLs. Envira does not have the permission to create image sizes or force image sizes.

The image sizes you can use for your Instagram gallery can be found on the Images tab of the gallery settings.Here are your image size options available for your Instagram gallery


Configuration Options

This table describes the available configuration options for your Envira Galleries when using this Addon.

The Programmatic Name and Programmatic Values columns are used when configuring the Dynamic Addon’s shortcode or template tag, or when overriding the default settings for creating a new Gallery.

Config Item Description Options Programmatic Name Programmatic Values
Feed Type The type of images to pull from Instagram My Instagram Photos instagram_type users_self_media_recent
users_self_media_liked
tags_tag_media_recent
Number of Instagram Photos The number of images to pull from your Instagram feed instagram_number Numeric
Image Resolution Determines the image resolution and size to use from Instagram Thumbnail (150×150)
Low Resolution (306×306)
Standard Resolution (640×640)
Full Non-Cropped Resolution
instagram_res thumbnail
low_resolution
standard_resolution
full
Link to Instagram Location? Links the photo to its original location on Instagram (note: using this will disable Lightbox functionality) instagram_link 0,1
Open In New Tab? Opens the link to Instagram in a new browser tab instagram_link_target 0,1
Use Photo Caption? Displays the photo caption from Instagram on the slide in Lightbox and Gallery (if supported by the Gallery Theme) instagram_caption 0,1
Limit Caption Length Limits the number of words to display for each caption. instagram_caption_limit Numeric
Cache Data from Instagram? Caches the data from Instagram for one day to improve performance (recommended).  Cache can be cleared by re-saving the Gallery. instagram_cache 0,1

Changelog

1.2.1 (08-08-2017)

  • Fixed: Instagram Links not working

    1.2.0 (07-06-2017)

    • Fix: API auth.Fix: Minor bug fixes.

    1.1.9 (06-27-2017)

    • Fix: Removed PHP notices.Fix: Add preview window.
    • Fix: Minor bug fixes.

    1.1.8 (05-16-2017)

    • Fix: Minor bug fixes.

    1.1.7 (04-13-2017)

    • Fix: Minor bug fixes.

    1.1.6 (02-15-2017)

    • Fix: Minor bug fixes.

    1.1.5 (02-01-2017)

    • Fix: Resolve image limit at 66 images
    • Fix: Minor bug fixes.

    1.1.4 (2016-01-10)

    • New API Key
    • Minor bug fixes.

    1.1.3 (2016-12-08)

    • UI Enhancement’s
    • Fix: Images sill linking to url if disabled

    1.1.2 (2016-11-03)

    • Added: Hi-res image size
    • Added: Open Instagram links in new window

    1.1.1 (2016-09-16)

    • Updated: Removed "tag" option due to changes in Instagram API.

    1.1.0 (2016-06-30)

    • Updated: Due to new Instagram API changes, we have removed the option to show your favorite Instagrams and Instagrams by hashtag.

    1.0.9 (2016-05-31)

    • Fix: Fixing cropping issue.

    1.0.8 (2016-05-12)

    • Fix: Don’t try to filter Album Gallery cover image when editing a non-Instagram Gallery in an Album.

    1.0.7 (2016-05-05)

    • Updated: Standardised edit screen titles and descriptions

    1.0.6.1 (2016-04-22)

    • Fix: Incorrect oAuth callback URL

    1.0.6 (2016-04-21)

    • Added: Support for Album Cover Image selection
    • Updated: Spanish translation

    1.0.5 (2016-04-16)

    • Added: Live Preview for Envira Gallery 1.5.0+
    • Added: Inline authentication within Gallery Add/Edit screen for Envira Gallery 1.5.0+
    • Fix: Prevent success / error notices on Settings screen from jumping

    1.0.4 (2016-03-10)

    • Fix: Don’t show Instagram as a Gallery Type when editing a Default or Dynamic Gallery

    1.0.3 (2016-02-25)

    • Updated: Spanish Translations

    1.0.2 (2016-01-07)

    • Added: Instagram Galleries can now be displayed within Albums
    • Updated: Spanish translations

    1.0.1 (2015-12-03)

    • Added: Spanish translation

    1.0.0 (2015-10-07)

    • Initial release of the addon.
Share This Post!