Terroir - Easy Instagram Plugin

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_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"
• thumb_click = define the action on thumbnail click. Default: no action.
• "thickbox" -> Open the image in a Thickbox popup
• "colorbox" -> Open the image in a Colorbox popup
• "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 formats 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.