TGL Instagram API

Version 1.1

This is an ExpressionEngine 2 module for interacting with the Instagram API. The module has a CP backend, which directs the user through the oAuth process.

Follow me on Twitter here: http://twitter.com/bryant_

Acknowledgements

This module uses the Instagram PHP API class writen by macuenca: https://github.com/macuenca/Instagram-PHP-API

Installation

• Move tgl_instagram folder into your EE third-party directory
• Install Module
• Follow steps to authenticating
• When registering a new client with Instagram, make sure the OAuth redirect_uri value is set correct. For more information see here: http://instagram.com/developer/auth/

Tag Pairs

The following tags can be used for looping through images:

Feed

{exp:tgl_instagram:feed}{/exp:tgl_instagram:feed}

This tag loops through the authenticated user's feed. The feed displays pictures from other instagram user's the authenticated user follows as well as their own images.

Parameters

limit

the number of images you want to see

cache

the number of minutes you want the information to be cached for. 0 = no caching

User Feed

{exp:tgl_instagram:user_feed}{/exp:tgl_instagram:user_feed}

This tag loops though a specified user's feed, and only displays image they have shared.

Parameters

limit

the number of images you want to display

cache

the number of minutes you want the information to be cached for. 0 = no caching

username

the username of the specific user, who you want to display images from.

Popular Images

{exp:tgl_instagram:popular}{/exp:tgl_instagram:popular}

This tag loops though all popular images

Parameters

limit

the number of images you want to display

cache

the number of minutes you want the information to be cached for. 0 = no caching

Image Data

These tags can be used within the above tag pairs.

{filter}

The filer used on the image

{created_at}

Timestamp of when the image was created

{link}

Link to Instagram's site displaying the picture

{caption}

Image's caption

{username}

The username of the user who submitted the image

{website}

The website of the user who submitted the image

{bio}

The bio of the user who submitted the image

{profile_picture}

The profile picture of the user who submitted the image

{full_name}

The full name of the user who sumitted the image

{thumbnail_url}

The url to the thumbnail version of the image (150px x 150px)

{thumbnail}

The thumbnail version of the image, wrapped in an tag (150px x 150px)

{low_resolution_url}

The url to the low resolution version of the image (306px x 306px)

{low_resolution}

The low resolution version of the image, wrapped in an tag (306px x 306px)

{standard_resolution_url}

The url to the standard resolution version of the image (612px x 612px)

{standard_resolution}

The standard resolution version of the image, wrapped in an tag (612px x 612px)

{tag_count}

Number of tags for the specific images

{likes_count}

Number of "likes" for the specific image

{comment_count}

Number of comments for the specific image

Image Data Tag Pairs

Within each image's loop, there are a few more items you can loop over to get more information about each image

Comments

{comments}{/comments}

Loop over the comments for each picture

Single Tags

{comment_text}

Text from a specific comment

{comment_username}

Username from the user who submitted the comment

{comment_profile_picture}

The profile picture from the user who submitted the comment

{comment_full_name}

The full name of the user who submitted the comment

Likes

{likes}{/likes}

Loop over each image's likes

Single Tags

{like_username}

Username of the user who liked the photo

{like_full_name}

Full name of the user who liked the photo

{like_profile_picture}

Profile picture of the user who liked the photo

Tags

{tags}{/tags}

Loop over each images tags

Single Tags

{tag}

The tag name

Changelog

v 1.1

• Bug fix causeing plugin page in EECP to show up white
• Added ability to list popular images

v 1.0

• Initial Release
• Ability to list media from authenticated users feed
• Ability to list media from specified user