Easy Instagram

Description

The “Easy Instagram” plugin can display an Instagram image from a single Instagram user’s
photo collection or from images throughout Instagram hashtagged with a specified Tag.
It can also create a gallery of up to ten images fed either from the Instagram User ID or the Tag.

“Easy Instagram” contains:

  • Streamlined code for optimized plugin performance
  • Simple instructions
  • Widget & shortcode options
  • A bare-minimum feature set
  • Flexibility – ready for custom css

“Easy Instagram” supports:

  • A single photo feed or up to ten fed from a single User ID
  • A single photo feed or up to ten fed from a single Tag
  • Multiple photo feeds, of up to twenty images, each from a different Tag

“Easy Instagram” features:

  • Option to display the image author’s username, and change lead text
  • Image author’s username links to their Instagram profile page
  • Option to limit image description character display
  • Option to display time since image was posted
  • Option to display date and time image was posted
  • Option to hide/display the images hashtags
  • Option to, on click, open image in Instagram on a new tab
  • Option to, on click, open image in a Thickbox or Colorbox popup

Usage

To create one or more Instagram photo feeds, use the Easy Instagram widget, or use the following shortcodes to generate an Instagram feed in the content area of a Post or Page.
By default the shortcode will display a single image.

Examples:

  • [easy-instagram user_id=’123456789′]
  • [easy-instagram tag=’puppy’ limit=2]
  • [easy-instagram user_id=’123456789′ limit=4]
  • [easy-instagram tag=’puppy’ limit=2 caption_hashtags=false]
  • [easy-instagram user_id=’123456789′ author_format=’published by %s’]
  • [easy-instagram user_id=’123456789′ limit=4 thumb_click=’thickbox’]
  • [easy-instagram user_id=’123456789′ limit=4 thumb_click=’thickbox’ thumb_size=90]
  • [easy-instagram user_id=’123456789′ limit=4 thumb_size=90 thumb_click=’colorbox’ template=’grid’]

Options

  • user_id = The numerical ID number for your Instagram account
    shown on the Easy Instagram Settings page
  • tag = hashtags to search for
  • limit = number of pictures to display (20 is max). Default: 1
  • caption_hashtags = show or hide hashtags from the end of image caption. Default: true
  • caption_char_limit = limit the number of characters output in caption. Set 0 for no caption output. Default: 100
  • author_text = allow setting the text format for the image author. Default: “by %s”
  • author_full_name = show author’s full name instead of Instagram username. Default: true
  • thumb_click = define the action on thumbnail click. Default: No action.
    1. “thickbox” -> Open the image in a Thickbox popup
    2. “colorbox” -> Open the image in a Colorbox popup
    3. “original” -> Open the original image from Instagram, in a new browser tab
  • time_text = defines the output format for the image time. The value “#T#” is replaced by the time value generated by the “time_format” option.
    Default: “posted #T#”
  • time_format = defines the time format. Accepts the standard PHP time format used by “strftime” (http://php.net/manual/en/function.strftime.php) or “#R#” for “relative time”. Default: “#R#”
  • thumb_size = defines the thumbnail size. Accepts an integer value for square aspect ratio or ‘W x H’ for rectangular aspect ratio. Default: Nothing (the default Instagram thumbnail size). Dynamic size for images can also be used by specifying the size as “dynamic_thumbnail”, “dynamic_normal” or “dynamic_large” in thumb_size. Dynamic size can be useful for creating responsive layouts, since it provides the images the way Instagram does, without any additional styling.
  • template = defines the template used to display the images. Options: default, horizontal, grid. Default: default (Display images one below the other). Note that if you are using dynamic images, you can control the horizontal template with css and change how big the images would be in %. If you need to use the grid template, please specify the size of the thumbnail. Custom templates can be created by copying one of the existing templates from the plugin’s templates folder, rename it as easy-instagram-NAME.php and customize the content as needed. The new template can be referenced in the shortcode and widget by the defined NAME (Example: If the theme’s template is easy-instagram-custom.php, the shortcode will use template=’custom’ for specifying the template).
  • ajax = load Instagram content via AJAX. Default: true

For multiple photo feeds each using different hashtags or user IDs, repeat the shortcode with different options set, or add the widget a second time to the same widget space, and enter different settings.

Screenshots

  • Your website when you’ve used the "Easy Instagram" shortcode in the content area.
  • Your website when you’ve used the "Easy Instagram" widget to place an Instagram photo feed in a sidebar.
  • The Instagram client registration form.
  • The Instagram client registration response.
  • The WordPress plugin settings page for "Easy Instagram".
  • The WordPress widget settings where two widgets are placed in one sidebar (pre-v1.2.3).

FAQ

Why do I have to register for an Instagram API client with this plugin?

In order to display and feed Instagram photos through a website, someone must have registered an API client with Instagram.

There are many other Instagram plugins that use the same API key for thousands of installations.
Using that kind of plugin, you share the risk – with the thousands of other users – that the plugin developer may disappear and/or not keep their API key active, effectively breaking your site feature without notice.
You also risk the plugin developer eventually charging for their plugin, especially because they’re providing an API registration service on which you’ve become dependent.

The “Easy Instagram” advantage is that only you (your website) and Instagram are involved, and that still — you don’t need to know any code whatsoever to complete the installation process.
Basically involving a series of cuts-and-pastes, most people report having registered their API client in just a few minutes.

Can I use multiple shortcodes in the same page?

Yes, but please note that in some cases an increase in page load time will occur.

Does the displayed image author user name link to their Instagram profile page?

Yes it does, as of “Easy Instagram” release 1.2.3.

Can I disable the hashtags in the caption?

Yes. Add caption_hashtags=false to your shortcode.

Can I hide the image description, the image author, or the date posted / time since post?

Yes. Check out our new widget settings (leave fields blank to disable display), and our new shortcode options on the “Help” tab of the “Easy Instagram” Settings page in your CMS.

What is the “Cache Expire Time”?

To speed up page loading, the images are downloaded from the Instagram server and stored to your local web server. At the interval specified by the “Cache Expire Time”, these files are deleted and read again from Instagram.
This means that when a new image is uploaded to Instagram, it will not appear on your website until the next cache expiry interval.

Is it possible to arrange the images horizontally?

Yes. As of “Easy Instagram” release 3.0 there are templates available. Include the attribute template=’horizontal’ in your shortcode to display images horizontally. You can also solve this using CSS styles. Each thumbnail has a div container with a CSS class on it so you can customize it the way you want.

Can I center the pictures?

Yes. Picture alignment can be customized directly in the CSS. To center align the picture, add the following in your style.css:

div.easy-instagram-thumbnail-wrapper {text-align:center;}

This will actually align all the content to the center. If you want just the image to be center aligned but keep the text aligned to the left, you also need to add:

div.easy-instagram-thumbnail-author, div.easy-instagram-thumbnail-caption, div.easy-instagram-thumbnail-time{text-align:left;}

Can I change the size of the thumbnail?

Yes. Add thumb_size=90 to the shortcode, where 90 is the width and height of the thumbnail. To specify width and height separately, use thumb_size=’W x H’ . Please note that different values for width and height will result in distorted images.

Can I feed photos with a certain tag but only from my own Instagram User ID?

Not at this time, but it’s something we’re working on for future versions. Currently you can choose from User ID, or Tag for each of your Instagram photo feeds.

Can I use Lightbox instead of Thickbox for displaying larger images?

Yes, as of “Easy Instagram” release 2.0 but you’ll have to add some code at the end of your site theme’s functions.php:

add_filter( ‘easy_instagram_thumb_link’, ‘my_theme_force_lightbox_link’ );
function my_theme_force_lightbox_link( $link ) {
$link = str_replace( ‘class=”thickbox”‘, ‘rel=”lightbox”‘, $link );
return $link;
}

Depending on the Lightbox implementation and the fact Easy Instagram is loading the content using AJAX, you might need to trigger Lightbox for the newly added DOM elements.
You can add extra Javascript code to be run after the content has loaded, by hooking your code into the ‘afterEasyInstagramLoad’ event.
For example, if you use the “wp-jquery-lightbox” plugin, add this in your theme’s Javascript:
jQuery(document).on(‘afterEasyInstagramLoad’, function() { doLightBox(); });

Reviews

For developers only

Robert

It does exactly what it's supposed to do, but be prepared to create a template and provide custom styling! If you want an out-of-the-box solution, use another plugin. If you want a skelton-feed to work with, use this!

Clean, Simple, Great plugin!

contemplate

So many Instagram plugins either do not work or charge extra for hashtag grid functionality. I've used this plugin on numerous sites I design and it works great.

Read all 21 reviews

Changelog

3.3

  • New: Exclude items by username or tag
  • New: Clear cache admin option

3.2

  • New: New Instagram policy information
  • Fix: Some images cannot be saved to cache

3.1

  • New: Add “dynamic_thumbnail”, “dynamic_normal” or “dynamic_large” in thumb_size
  • New: Prev/Next image navigation from within Thickbox or Colorbox popup
  • New: Flag for disabling AJAX content loading

3.0

  • New: Redirect URI autodetected
  • New: Option for switching the cache directory inside WP uploads directory
  • New: Templates for customizing the output
  • New: Javascript event for hooking extra functionality after content was loaded

2.0

  • Major rewrite
  • New: Configurable thumbnail size
  • New: Loading content using AJAX

1.2.5

  • Fix: Instagram login error

1.2.4

  • Fix: On some servers, in the plugin settings, the admin cannot log in to Instagram

1.2.3

  • New: Link image author display to their Instagram profile page
  • New: Add “author_format” option
  • New: Add “thumb_click” option
  • New: Add “time_text” and “time_format” options

1.2.2

  • Improve “caption_hashtags” option to remove only hashtags from the end of the caption
  • Add “caption_char_limit” option
  • Fix: Widget title missing
  • Fix: “CURLOPT_FOLLOWLOCATION cannot be activated when in safe_mode or an open_basedir is set”
  • Fix: Image author not showing when the image has no caption
  • Fix: Invalid image time when the image has no caption

1.2.1

  • Fix: “Cannot redeclare class InstagramException” for some install configurations.
  • Fix: cURL is unable to get Instagram data over https on some installs.

1.2

  • A few graphical edits.

1.1

  • Fix a few cache related bugs.
  • Add the “caption_hashtags” attribute to the shortcode.

1.0

  • First version

Contributors & Developers

This is open source software. The following people have contributed to this plugin.

Contributors

Browse the code