Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Instagram Addon

Share This Post!

The Instagram Addon for Envira Gallery allows you to display galleries comprising of Instagram images by user.

  1. Requirements
  2. Installation
  3. Setup
  4. FAQs
  5. Configuration Options

Requirements

Installation

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

Setup

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

Step 1 – Enable & Authenticate Instagram

Once the Addon is activated, you’ll need to authenticate Envira Gallery with Instagram, to grant Envira read only access to your Instagram account.

Navigate to Envira Gallery > Settings screen and select the Instagram tab. Then 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.

You’ll be prompted to login to your Instagram account if you aren’t already. Then you’ll need to Authorize Envira Gallery to connect 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. Then select Instagram as the service you want to use to populate your gallery with.

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 how your gallery is populated from Instagram in 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.


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!


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

Developers

Filters

FileFilter NameArguments
/includes/global/common.php
 envira_instagram_typesapply_filters( 'envira_instagram_types', $types )
 envira_instagram_resolutionsapply_filters( 'envira_instagram_resolutions', $resolutions )
 envira_instagram_link_optionsapply_filters( 'envira_instagram_link_options', $link_options )
/includes/global/shortcode.php
 envira_instagram_get_instagram_dataapply_filters( 'envira_instagram_get_instagram_data', $instagram_data, $body['data'], $id, $data )

Actions

FileAction NameArguments
/includes/admin/metaboxes.php
 envira_instagram_boxdo_action( 'envira_instagram_box', $post )

Changelog

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!