Instagram Feed - Version 1.4.3

Version Description

Important: Due to the upcoming Instagram API changes, in order for the Instagram Feed plugin to continue working after June 1st you must update the plugin and obtain a new Access Token on the plugin's Settings page.

Download this release

Release Info

Developer	smashballoon
Plugin	Instagram Feed
Version	1.4.3
Comparing to
See all releases

Code changes from version 1.4.2 to 1.4.3

Files changed (3) hide show

README.txt +459 -87
instagram-feed-admin.php +19 -14
instagram-feed.php +2 -2

README.txt CHANGED Viewed

@@ -2,8 +2,8 @@
             Contributors: smashballoon
             Tags: Instagram, Instagram feed, Instagram photos, Instagram plugin, Instagram stream, Custom Instagram Feed, responsive Instagram, mobile Instagram, Instagram posts, Instagram wall, Instagram account, Instagram gallery, Instagram photo, Instagram post, Instagram share, Instagram customized, Instagrams, Instagram feeds, Instagram plugins, Instagram responsive, Instagram mobile feed, Instagram accounts, public Instagram feed, Instagram photography, Instagram galleries, multiple Instagram, Instagram widget, Instagram clean, beautiful Instagram, custom Instagram design
             Requires at least: 3.0
-            -
            Tested up to: 4.5.1
-            -
            Stable tag: 1.4.2
             License: GPLv2 or later
             License URI: http://www.gnu.org/licenses/gpl-2.0.html
@@ -46,37 +46,54 @@ For a pop-up photo **lightbox**, to display posts by **hashtag**, show photo **c
             == Installation ==
-            -
            1. Install the Instagram plugin either via the WordPress plugin directory, or by uploading the files to your web server (in the `/wp-content/plugins/` directory).
-            -
            2. Activate the plugin through the 'Plugins' menu in WordPress.
-            -
            3. Navigate to the 'Instagram Feed' settings page to obtain your Instagram Access Token and User ID and configure your settings.
-            -
            4. Use the shortcode `[instagram-feed]` in your page, post or widget to display your photos.
 . You can display multiple Instagram feeds by using shortcode options, for example: `[instagram-feed num=6 cols=3]`
             For simple step-by-step directions on how to set up the Instagram Feed plugin please refer to our [setup guide](http://smashballoon.com/instagram-feed/free/ 'Instagram Feed setup guide').
             = Shortcode Options =
             * **General Options**
             * **id** - An Instagram User ID - Example: `[instagram-feed id=AN_INSTAGRAM_USER_ID]`
-            -
            * **width** - The width of your feed. Any number - Example: `[instagram-feed width=50]`
-            -
            * **widthunit** - The unit of the width. 'px' or '%' - Example: `[instagram-feed widthunit=%]`
-            -
            * **height** - The height of your feed. Any number - Example: `[instagram-feed height=250]`
-            -
            * **heightunit** - The unit of the height. 'px' or '%' - Example: `[instagram-feed heightunit=px]`
-            -
            * **background** - The background color of the feed. Any hex color code - Example: `[instagram-feed background=#ffff00]`
-            -
            * **class** - Add a CSS class to the feed container - Example: `[instagram-feed class=feedOne]`
+            *
             * **Photo Options**
-            -
            * **sortby** - Sort the posts by Newest to Oldest (none) or Random (random) - Example: `[instagram-feed sortby=random]`
-            -
            * **num** - The number of photos to display initially. Maximum is 33 - Example: `[instagram-feed num=10]`
-            -
-            -
            * **cols** - The number of columns in your feed. 1 - 10 - Example: `[instagram-feed cols=5]`
-            -
            * **imageres** - The resolution/size of the photos. 'auto', full', 'medium' or 'thumb' - Example: `[instagram-feed imageres=full]`
-            -
            * **imagepadding** - The spacing around your photos - Example: `[instagram-feed imagepadding=10]`
-            -
            * **imagepaddingunit** - The unit of the padding. 'px' or '%' - Example: `[instagram-feed imagepaddingunit=px]`
-            -
            * **disablemobile** - Disable the mobile layout. 'true' or 'false' - Example: `[instagram-feed disablemobile=true]`
+            *
             * **Header Options**
-            -
            * **showheader** - Whether to show the feed Header. 'true' or 'false' - Example: `[instagram-feed showheader=false]`
-            -
            * **headercolor** - The color of the Header text. Any hex color code - Example: `[instagram-feed headercolor=#333]`
+            *
             * **'Load More' Button Options**
             * **showbutton** - Whether to show the 'Load More' button. 'true' or 'false' - Example: `[instagram-feed showbutton='false']`
@@ -86,12 +103,32 @@ For simple step-by-step directions on how to set up the Instagram Feed plugin pl
+            *
             * **'Follow on Instagram' Button Options**
             * **showfollow** - Whether to show the 'Follow on Instagram' button. 'true' or 'false' - Example: `[instagram-feed showfollow=true]`
-            -
            * **followcolor** - The background color of the button. Any hex color code - Example: `[instagram-feed followcolor=#ff0000]`
-            -
            * **followtextcolor** - The text color of the button. Any hex color code - Example: `[instagram-feed followtextcolor=#fff]`
-            -
            * **followtext** - The text used for the button - Example: `[instagram-feed followtext="Follow me"]`
             For more shortcode options, check out the [Pro version](http://smashballoon.com/instagram-feed/ 'Instagram Feed Pro').
             == Frequently Asked Questions ==
             = Can I display multiple Instagram feeds on my site or on the same page? =
@@ -115,7 +152,7 @@ There are a few common reasons for this:
             * **Your Access Token may not be valid.** Try clicking on the blue Instagram login button on the plugin's Settings page again and copy and paste the Instagram token it gives you into the plugin's Access Token field.
             * **Your Instagram account may be set to private.** Your Instagram account may be set to private. Instagram doesn't allow photos from private Instagram accounts to be displayed publicly.
             * **Your User ID may not be valid**. Be sure you're not using your Instagram username instead of your User ID. You can find your Instagram User ID by using [this tool](http://www.otzberg.net/iguserid/).
-            -
            * **The plugin’s JavaScript file isn’t being included in your page.** This is most likely because your WordPress theme is missing the WordPress [wp_footer](http://codex.wordpress.org/Function_Reference/wp_footer) function which is required for plugins to be able to add their JavaScript files to your page. You can fix this by opening your theme's **footer.php** file and adding the following directly before the closing </body> tag: `<?php wp_footer(); ?>`
             * **Your website may contain a JavaScript error which is preventing JavaScript from running.** The plugin uses JavaScript to load the Instagram photos into your page and so needs JavaScript to be running in order to work. You would need to remove any existing JavaScript errors on your website for the plugin to be able to load in your feed.
             If you're still having an issue displaying your feed then please open a ticket in the [Support forum](http://wordpress.org/support/plugin/instagram-feed 'Instagram Feed Support Forum') with a link to the page where you're trying to display the Instagram feed and, if possible, a link to your Instagram account.
@@ -132,32 +169,68 @@ This is a feature of the [Pro version](http://smashballoon.com/instagram-feed/ '
             You can embed your Instagram feed directly into a template file by using the WordPress [do_shortcode](http://codex.wordpress.org/Function_Reference/do_shortcode) function: `<?php echo do_shortcode('[instagram-feed]'); ?>`.
             = What are the available shortcode options that I can use to customize my Instagram feed? =
             The below options are available on the Instagram Feed Settings page but can also be used directly in the `[instagram-feed]` shortcode to customize individual Instagram feeds on a feed-by-feed basis.
             * **General Options**
             * **id** - An Instagram User ID - Example: `[instagram-feed id=AN_INSTAGRAM_USER_ID]`
-            -
            * **width** - The width of your feed. Any number - Example: `[instagram-feed width=50]`
-            -
            * **widthunit** - The unit of the width. 'px' or '%' - Example: `[instagram-feed widthunit=%]`
-            -
            * **height** - The height of your feed. Any number - Example: `[instagram-feed height=250]`
-            -
            * **heightunit** - The unit of the height. 'px' or '%' - Example: `[instagram-feed heightunit=px]`
-            -
            * **background** - The background color of the feed. Any hex color code - Example: `[instagram-feed background=#ffff00]`
-            -
            * **class** - Add a CSS class to the feed container - Example: `[instagram-feed class=feedOne]`
+            *
             * **Photo Options**
-            -
            * **sortby** - Sort the posts by Newest to Oldest (none) or Random (random) - Example: `[instagram-feed sortby=random]`
-            -
            * **num** - The number of photos to display initially. Maximum is 33 - Example: `[instagram-feed num=10]`
-            -
-            -
            * **cols** - The number of columns in your feed. 1 - 10 - Example: `[instagram-feed cols=5]`
-            -
            * **imageres** - The resolution/size of the photos. 'auto', full', 'medium' or 'thumb' - Example: `[instagram-feed imageres=full]`
-            -
            * **imagepadding** - The spacing around your photos - Example: `[instagram-feed imagepadding=10]`
-            -
            * **imagepaddingunit** - The unit of the padding. 'px' or '%' - Example: `[instagram-feed imagepaddingunit=px]`
-            -
            * **disablemobile** - Disable the mobile layout. 'true' or 'false' - Example: `[instagram-feed disablemobile=true]`
+            *
             * **Header Options**
-            -
            * **showheader** - Whether to show the feed Header. 'true' or 'false' - Example: `[instagram-feed showheader=false]`
-            -
            * **headercolor** - The color of the Header text. Any hex color code - Example: `[instagram-feed headercolor=#333]`
+            *
             * **'Load More' Button Options**
             * **showbutton** - Whether to show the 'Load More' button. 'true' or 'false' - Example: `[instagram-feed showbutton='false']`
@@ -167,9 +240,9 @@ The below options are available on the Instagram Feed Settings page but can also
+            *
             * **'Follow on Instagram' Button Options**
             * **showfollow** - Whether to show the 'Follow on Instagram' button. 'true' or 'false' - Example: `[instagram-feed showfollow=true]`
-            -
            * **followcolor** - The background color of the button. Any hex color code - Example: `[instagram-feed followcolor=#ff0000]`
-            -
            * **followtextcolor** - The text color of the button. Any hex color code - Example: `[instagram-feed followtextcolor=#fff]`
-            -
            * **followtext** - The text used for the button - Example: `[instagram-feed followtext="Follow me"]`
             For more shortcode options, check out the [Pro version](http://smashballoon.com/instagram-feed/ 'Instagram Feed Pro').
@@ -185,13 +258,312 @@ For more FAQs related to the Instagram Feed plugin please visit the [FAQ section
 . Just copy and paste the shortcode into any page, post or widget on your site
 . The Instagram Feed plugin Settings pages
             == Upgrade Notice ==
-            -
            = 1.4.2 =
             **Important:** Due to the upcoming Instagram API changes, in order for the Instagram Feed plugin to continue working after **June 1st** you must update the plugin and obtain a new Access Token on the plugin's Settings page.
             == Changelog ==
             = 1.4.2 =
             * **IMPORTANT: Due to the upcoming Instagram API changes, in order for the Instagram Feed plugin to continue working after June 1st you must obtain a new Access Token by using the Instagram button on the plugin's Settings page.**
             * New: Compatible with Instagram's new API changes effective June 1st
@@ -202,68 +574,68 @@ For more FAQs related to the Instagram Feed plugin please visit the [FAQ section
             * Fix: Minified CSS and JS files
             = 1.3.11 =
-            -
            * Fix: Fixed a bug which was causing the height of the photos to be shorter than they should have been in some themes
-            -
            * Fix: Fixed an issue where when a feed was initially hidden (in a tab, for example) then the photo resolution was defaulting to 'thumbnail'
             = 1.3.10 =
-            -
            * Fix: Fixed an issue which was setting the visibility of some photos to be hidden in certain browsers
-            -
            * Fix: The new square photo cropping is no longer being applied to feeds displaying images at less than 150px wide as the images from Instagram at this size are already square cropped
             * Fix: Fixed a JavaScript error in Internet Explorer 8 caused by the 'addEventListener' function not being supported
             = 1.3.9 =
-            -
            * Fix: Fixed an issue where photos wouldn't appear in the Instagram feed if it was initially being hidden inside of a tab or some other element
-            -
            * Fix: Fixed an issue where the new image cropping fuction was failing to run on some sites and causing the images to appear as blank
             = 1.3.8 =
-            -
            * Fix: If you have uploaded a photo in portrait or landscape then the plugin will now display the square cropped version of the photo in your feed
             = 1.3.7 =
-            -
            * Fix: Fixed an issue with double quotes in photo captions (used in the photo alt tags) which caused a formatting issue
             = 1.3.6 =
             * Fix: Fixed an issue introduced in version 1.3.4 which was causing theme settings to not be applied in some themes
             = 1.3.5 =
             * Fix: Reverted the 'prop' function introduced in the last update back to 'attr' as prop isn't supported in older versions of jQuery
-            -
            * Fix: Removed the image load function as it was causing images not to be displayed for some users
             = 1.3.4 =
-            -
            * Fix: Used the photo caption to add a more descriptive alt tag to the images
-            -
            * Fix: Images are now only displayed once they're fully loaded
             * Fix: Added a stricter CSS implementation for some elements to prevent styles being overridden by themes
-            -
            * Fix: Added CSS opacity property to images to prevent issues with lazy loading in some themes
             * Fix: Removed a line of code which was disabling WordPress Debug/Error Reporting. If needed, this can be disabled again by using the setting at the bottom of the plugin's 'Customize' settings page.
-            -
            * Fix: Made some JavaScript improvements to the core plugin code
             = 1.3.3 =
-            -
            * Fix: Fixed an issue with the 'Load more' button not always showing when displaying Instagram photos from multiple User IDs
             * Fix: Moved the initiating sbi_init function outside of the jQuery ready function so that it can be called externally if needed by Ajax powered themes/plugins
             = 1.3.2 =
-            -
            * New: Added an option to disable the mobile layout
-            -
            * New: Added an setting which allows you to use the plugin with an Ajax powered theme
-            -
            * New: Added a 'class' shortcode option which allows you to add a CSS to class to each individual feed: `[instagram-feed class=feedOne]`
             * New: Added a Support tab which contains System Info to help with troubleshooting
             * New: Added friendly error messages which display only to WordPress admins
-            -
            * New: Added validation to the User ID field to prevent usernames being entered instead of IDs
-            -
            * Tweak: Made the Access Token field slightly wider to prevent tokens being copy and pasted incorrectly
             * Fix: Fixed a JavaScript bug which caused the feed not to load photos correctly in IE8
             = 1.3.1 =
-            -
            * Fix: Fixed an issue with the Instagram icon not appearing in the 'Follow on Instagram' button or in the header
-            -
            * Fix: Addressed a few CSS issues which were causing some minor formatting issues on certain themes
             = 1.3 =
-            -
            * New: You can now display photos from multiple Instagram User IDs. Simply separate your IDs by commas.
-            -
            * New: Added an optional header to the feed which contains your Instagram profile picture, username and bio. You can activate this on the Customize page.
-            -
            * New: The plugin now includes an 'Auto-detect' option for the Image Resolution setting which will automatically set the correct image resolution based on the size of your feed.
-            -
            * New: Added an optional 'Follow on Instagram' button which can be displayed at the bottom of your feed. You can activate this on the Customize page.
             * New: Added the ability to use your own custom text for the 'Load More' button
-            -
            * New: Added a loader icon to indicate that the photos are loading
             * New: Added a unique ID to each Instagram photo so that they can be targeted individually via CSS
-            -
            * Tweak: Added a subtle fade effect to the photos when hovering over them
-            -
            * Tweak: Improved the responsive layout behavior of the feed
-            -
            * Tweak: Improved the documentation within the plugin settings pages
             * Tweak: Included a link to [step-by-step setup directions](http//:smashballoon.com/instagram-feed/free/ 'Instagram feed setup directions') for the plugin
             * Fix: Fixed an issue with the feed not clearing other widgets correctly
@@ -271,36 +643,36 @@ For more FAQs related to the Instagram Feed plugin please visit the [FAQ section
             * Fix: Replaced the 'on' function with the 'click' function to increase compatibility with themes using older versions of jQuery
             = 1.2.2 =
-            -
            * Tweak: Added an initialize function to the plugin
             * Fix: Fixed an occasional issue with the 'Sort Photos By' option being undefined
             = 1.2.1 =
-            -
            * Fix: Fixed a minor issue with the Custom JavaScript being run before the photos are loaded
             * Fix: Removed stray PHP notices
             * Fix: Changed the double quotes to single quotes on the 'data-options' attribute
             = 1.2 =
-            -
            * New: Added Custom CSS and Custom JavaScript sections which allow you to add your own custom CSS and JavaScript to the plugin
             * New: Added an option to display your Instagram photos in random order
-            -
            * New: A new tabbed layout has been implemented on the plugin's settings pages
-            -
            * New: Added an option to preserve your settings when uninstalling the plugin
-            -
            * New: Added a [Pro version](http://smashballoon.com/instagram-feed/ 'Instagram Feed Pro') of the plugin which allows you to display photos by hashtag, display captions, view photos in a pop-up lightbox, show the number of likes & comments and more
-            -
            * Tweak: The 'Load More' button now automatically hides if there are no more photos to load
             * Tweak: Added a small gap to the top of the 'Load More' button
             * Tweak: Added a icon to the Instagram Feed menu item
             = 1.1.6 =
-            -
            * Fix: A maximum width is now only applied to the feed when the photos are displayed in one column
             = 1.1.5 =
             * Fix: Added a line of code which enables shortcodes to be used in widgets for themes which don't have it enabled
             = 1.1.4 =
-            -
            * Fix: Fixed an issue with the Instagram Access Token and User ID retrieval functionality in certain web browsers
             = 1.1.3 =
             * Fix: Fixed an issue with the maximum Instagram image width
-            -
            * Fix: Corrected a typo in the Shortcode Options table
             = 1.1.1 =
             * Pre-tested for the upcoming WordPress 4.0 update
@@ -310,10 +682,10 @@ For more FAQs related to the Instagram Feed plugin please visit the [FAQ section
             * New: Added an option to set the number of Instagram photos to be initially displayed
             * New: Added an option to show or hide the 'Load More' button
             * New: Added 'Step 3' to the Instagram Feed Settings page explaining how to display your feed using the [instagram-feed] shortcode
-            -
            * New: Added a full list of all available shortcode options to help you if customizing multiple Instagram feeds
             = 1.0.2 =
-            -
            * Fix: Fixed an issue with the Instagram login URL on the plugin's Settings page
             = 1.0.1 =
             * Fix: Fixed an issue with the Instagram Feed 'Load More' button opening an empty browser window in Firefox


2	Contributors: smashballoon
3	Tags: Instagram, Instagram feed, Instagram photos, Instagram plugin, Instagram stream, Custom Instagram Feed, responsive Instagram, mobile Instagram, Instagram posts, Instagram wall, Instagram account, Instagram gallery, Instagram photo, Instagram post, Instagram share, Instagram customized, Instagrams, Instagram feeds, Instagram plugins, Instagram responsive, Instagram mobile feed, Instagram accounts, public Instagram feed, Instagram photography, Instagram galleries, multiple Instagram, Instagram widget, Instagram clean, beautiful Instagram, custom Instagram design
4	Requires at least: 3.0
5	+ Tested up to: 4.5.2
6	+ Stable tag: 1.4.3
7	License: GPLv2 or later
8	License URI: http://www.gnu.org/licenses/gpl-2.0.html
9

46
47	== Installation ==
48
49	+ 1. Install the Instagram Feed plugin either via the WordPress plugin directory, or by uploading the files to your web server (in the `/wp-content/plugins/` directory).
50	+ 2. Activate the Instagram Feed plugin through the 'Plugins' menu in WordPress.
51	+ 3. Navigate to the 'Instagram Feed' settings page to obtain your Instagram Access Token and Instagram User ID and configure your settings.
52	+ 4. Use the shortcode `[instagram-feed]` in your page, post or widget to display your Instagram photos.
53	5. You can display multiple Instagram feeds by using shortcode options, for example: `[instagram-feed num=6 cols=3]`
54
55	For simple step-by-step directions on how to set up the Instagram Feed plugin please refer to our [setup guide](http://smashballoon.com/instagram-feed/free/ 'Instagram Feed setup guide').
56
57	+ = Display your Feed =
58	+
59	+ Single Instagram Feed
60	+
61	+ Copy and paste the following shortcode directly into the page, post or widget where you'd like the Instagram feed to show up: `[instagram-feed]`
62	+
63	+ Multiple Instagram Feeds
64	+
65	+ If you'd like to display multiple Instagram feeds then you can set different settings directly in the shortcode like so: `[instagram-feed num=9 cols=3]`
66	+
67	+ You can display as many different Instagram feeds as you like, on either the same page or on different pages, by just using the shortcode options below. For example:
68	+ `[instagram-feed]`
69	+ `[instagram-feed id="ANOTHER_USER_ID"]`
70	+ `[instagram-feed id="ANOTHER_USER_ID, YET_ANOTHER_USER_ID" num=4 cols=4 showfollow=false]`
71	+
72	+ See the table below for a full list of available shortcode options:
73	+
74	= Shortcode Options =
75	* General Options
76	* id - An Instagram User ID - Example: `[instagram-feed id=AN_INSTAGRAM_USER_ID]`
77	+ * width - The width of your Instagram feed. Any number - Example: `[instagram-feed width=50]`
78	+ * widthunit - The unit of the width of your Instagram feed. 'px' or '%' - Example: `[instagram-feed widthunit=%]`
79	+ * height - The height of your Instagram feed. Any number - Example: `[instagram-feed height=250]`
80	+ * heightunit - The unit of the height of your Instagram feed. 'px' or '%' - Example: `[instagram-feed heightunit=px]`
81	+ * background - The background color of the Instagram feed. Any hex color code - Example: `[instagram-feed background=#ffff00]`
82	+ * class - Add a CSS class to the Instagram feed container - Example: `[instagram-feed class=feedOne]`
83	*
84	* Photo Options
85	+ * sortby - Sort the Instagram posts by Newest to Oldest (none) or Random (random) - Example: `[instagram-feed sortby=random]`
86	+ * num - The number of Instagram posts to display initially. Maximum is 33 - Example: `[instagram-feed num=10]`
87	+
88	+ * cols - The number of columns in your Instagram feed. 1 - 10 - Example: `[instagram-feed cols=5]`
89	+ * imageres - The resolution/size of the Instagram photos. 'auto', full', 'medium' or 'thumb' - Example: `[instagram-feed imageres=full]`
90	+ * imagepadding - The spacing around your Instagram photos - Example: `[instagram-feed imagepadding=10]`
91	+ * imagepaddingunit - The unit of the padding in your Instagram feed. 'px' or '%' - Example: `[instagram-feed imagepaddingunit=px]`
92	+ * disablemobile - Disable the mobile layout for your Instagram feed. 'true' or 'false' - Example: `[instagram-feed disablemobile=true]`
93	*
94	* Header Options
95	+ * showheader - Whether to show the Instagram feed Header. 'true' or 'false' - Example: `[instagram-feed showheader=false]`
96	+ * headercolor - The color of the Instagram feed Header text. Any hex color code - Example: `[instagram-feed headercolor=#333]`
97	*
98	* 'Load More' Button Options
99	* showbutton - Whether to show the 'Load More' button. 'true' or 'false' - Example: `[instagram-feed showbutton='false']`

103	*
104	* 'Follow on Instagram' Button Options
105	* showfollow - Whether to show the 'Follow on Instagram' button. 'true' or 'false' - Example: `[instagram-feed showfollow=true]`
106	+ * followcolor - The background color of the 'Follow on Instagram' button. Any hex color code - Example: `[instagram-feed followcolor=#ff0000]`
107	+ * followtextcolor - The text color of the 'Follow on Instagram' button. Any hex color code - Example: `[instagram-feed followtextcolor=#fff]`
108	+ * followtext - The text used for the 'Follow on Instagram' button - Example: `[instagram-feed followtext="Follow me"]`
109
110	For more shortcode options, check out the [Pro version](http://smashballoon.com/instagram-feed/ 'Instagram Feed Pro').
111
112	+ = Setting up the Free Instagram Feed WordPress Plugin =
113	+
114	+ 1) Once you've installed the Instagram Feed plugin click on the Instagram Feed item in your WordPress menu
115	+
116	+ 2) Click on the large blue Instagram button to log into your Instagram account and get your Instagram Access Token and Instagram User ID
117	+
118	+ 3) Copy and paste the Instagram Access Token and Instagram User ID into the relevant Instagram Access Token and Instagram User ID fields. If you're having trouble retrieving your Instagram information from Instagram then try using the Instagram button on [this page](https://smashballoon.com/instagram-feed/token/) instead.
119	+
120	+ You can also display photos from other Instagram accounts by using [this tool](http://www.otzberg.net/iguserid/) to find their Instagram User ID.
121	+
122	+ 4) Navigate to the Instagram Feed customize page to customize your Instagram feed.
123	+
124	+ 5) Once you've customized your Instagram feed, click on the Display Your Feed tab to grab the [instagram-feed] shortcode.
125	+
126	+ 6) Copy the Instagram Feed shortcode and paste it into any page, post or widget where you want the Instagram feed to appear.
127	+
128	+ 7) You can paste the Instagram Feed shortcode directly into your page editor.
129	+
130	+ 8) You can use the default WordPress 'Text' widget to display your Instagram Feed in a sidebar or other widget area.
131	+
132	== Frequently Asked Questions ==
133
134	= Can I display multiple Instagram feeds on my site or on the same page? =

152	* Your Access Token may not be valid. Try clicking on the blue Instagram login button on the plugin's Settings page again and copy and paste the Instagram token it gives you into the plugin's Access Token field.
153	* Your Instagram account may be set to private. Your Instagram account may be set to private. Instagram doesn't allow photos from private Instagram accounts to be displayed publicly.
154	* Your User ID may not be valid. Be sure you're not using your Instagram username instead of your User ID. You can find your Instagram User ID by using [this tool](http://www.otzberg.net/iguserid/).
155	+ * The plugin's JavaScript file isn't being included in your page. This is most likely because your WordPress theme is missing the WordPress [wp_footer](http://codex.wordpress.org/Function_Reference/wp_footer) function which is required for plugins to be able to add their JavaScript files to your page. You can fix this by opening your theme's footer.php file and adding the following directly before the closing </body> tag: `<?php wp_footer(); ?>`
156	* Your website may contain a JavaScript error which is preventing JavaScript from running. The plugin uses JavaScript to load the Instagram photos into your page and so needs JavaScript to be running in order to work. You would need to remove any existing JavaScript errors on your website for the plugin to be able to load in your feed.
157
158	If you're still having an issue displaying your feed then please open a ticket in the [Support forum](http://wordpress.org/support/plugin/instagram-feed 'Instagram Feed Support Forum') with a link to the page where you're trying to display the Instagram feed and, if possible, a link to your Instagram account.

169
170	You can embed your Instagram feed directly into a template file by using the WordPress [do_shortcode](http://codex.wordpress.org/Function_Reference/do_shortcode) function: `<?php echo do_shortcode('[instagram-feed]'); ?>`.
171
172	+ = My Feed Stopped Working – All I see is a Loading Symbol =
173	+
174	+ If your Instagram photos aren't loading and all your see is a loading symbol then there are a few common reasons:
175	+
176	+ 1) There's an issue with the Instagram Access Token that you are using
177	+
178	+ You can obtain a new Instagram Access Token on the Instagram Feed Settings page by clicking the blue Instagram login button and then copy and pasting it into the plugin's 'Access Token' field.
179	+
180	+ Occasionally the blue Instagram login button does not produce a working access token. You can try [this link](https://smashballoon.com/instagram-feed/token/) as well.
181	+
182	+ 2) Your Instagram User ID is incorrect or is from a private Instagram account
183	+
184	+ Please double check the Instagram User ID that you are using. Please note that your Instagram User ID is different from your Instagram username. To find your Instagram User ID simply enter your Instagram username into [this tool](http://www.otzberg.net/iguserid/).
185	+
186	+ If your Instagram User ID doesn't show any Instagram photos then it may be that your Instagram account is private and that the Instagram photos aren't able to be displayed.
187	+
188	+ 3) The plugin's JavaScript file isn't being included in your page
189	+
190	+ This is most likely because your WordPress theme is missing the WordPress wp_footer function which is required for plugins to be able to add their JavaScript files to your page. You can fix this by opening your theme's footer.php file and adding the following directly before the closing </body> tag:
191	+
192	+ <?php wp_footer(); ?>
193	+
194	+ 4) There's a JavaScript error on your site which is preventing the plugin's JavaScript file from running
195	+
196	+ You find find out whether this is the case by right clicking on your page, selecting 'Inspect Element', and then clicking on the 'Console' tab, or by selecting the 'JavaScript Console' option from your browser's Developer Tools.
197	+
198	+ If a JavaScript error is occurring on your site then you'll see it listed in red along with the JavaScript file which is causing it.
199	+
200	+ 5) The feed you are trying to display has no Instagram posts
201	+
202	+ If you are trying to display an Instagram feed that has no posts made to it, a loading symbol may be all that shows for the Instagram feed or nothing at all. Once you add an Instagram post the Instagram feed should display normally
203	+
204	+ 6) The shortcode you are using is incorrect
205	+
206	+ You may have an error in the Instagram Feed shortcode you are using or are missing a necessary argument.
207	+
208	= What are the available shortcode options that I can use to customize my Instagram feed? =
209
210	The below options are available on the Instagram Feed Settings page but can also be used directly in the `[instagram-feed]` shortcode to customize individual Instagram feeds on a feed-by-feed basis.
211
212	* General Options
213	* id - An Instagram User ID - Example: `[instagram-feed id=AN_INSTAGRAM_USER_ID]`
214	+ * width - The width of your Instagram feed. Any number - Example: `[instagram-feed width=50]`
215	+ * widthunit - The unit of the width of your Instagram feed. 'px' or '%' - Example: `[instagram-feed widthunit=%]`
216	+ * height - The height of your Instagram feed. Any number - Example: `[instagram-feed height=250]`
217	+ * heightunit - The unit of the height of your Instagram feed. 'px' or '%' - Example: `[instagram-feed heightunit=px]`
218	+ * background - The background color of the Instagram feed. Any hex color code - Example: `[instagram-feed background=#ffff00]`
219	+ * class - Add a CSS class to the Instagram feed container - Example: `[instagram-feed class=feedOne]`
220	*
221	* Photo Options
222	+ * sortby - Sort the Instagram posts by Newest to Oldest (none) or Random (random) - Example: `[instagram-feed sortby=random]`
223	+ * num - The number of Instagram posts to display initially. Maximum is 33 - Example: `[instagram-feed num=10]`
224	+
225	+ * cols - The number of columns in your Instagram feed. 1 - 10 - Example: `[instagram-feed cols=5]`
226	+ * imageres - The resolution/size of the Instagram photos. 'auto', full', 'medium' or 'thumb' - Example: `[instagram-feed imageres=full]`
227	+ * imagepadding - The spacing around your Instagram photos - Example: `[instagram-feed imagepadding=10]`
228	+ * imagepaddingunit - The unit of the padding in your Instagram feed. 'px' or '%' - Example: `[instagram-feed imagepaddingunit=px]`
229	+ * disablemobile - Disable the mobile layout for your Instagram feed. 'true' or 'false' - Example: `[instagram-feed disablemobile=true]`
230	*
231	* Header Options
232	+ * showheader - Whether to show the Instagram feed Header. 'true' or 'false' - Example: `[instagram-feed showheader=false]`
233	+ * headercolor - The color of the Instagram feed Header text. Any hex color code - Example: `[instagram-feed headercolor=#333]`
234	*
235	* 'Load More' Button Options
236	* showbutton - Whether to show the 'Load More' button. 'true' or 'false' - Example: `[instagram-feed showbutton='false']`

240	*
241	* 'Follow on Instagram' Button Options
242	* showfollow - Whether to show the 'Follow on Instagram' button. 'true' or 'false' - Example: `[instagram-feed showfollow=true]`
243	+ * followcolor - The background color of the 'Follow on Instagram' button. Any hex color code - Example: `[instagram-feed followcolor=#ff0000]`
244	+ * followtextcolor - The text color of the 'Follow on Instagram' button. Any hex color code - Example: `[instagram-feed followtextcolor=#fff]`
245	+ * followtext - The text used for the 'Follow on Instagram' button - Example: `[instagram-feed followtext="Follow me"]`
246
247	For more shortcode options, check out the [Pro version](http://smashballoon.com/instagram-feed/ 'Instagram Feed Pro').
248

258	6. Just copy and paste the shortcode into any page, post or widget on your site
259	7. The Instagram Feed plugin Settings pages
260
261	+ == Other Notes ==
262	+
263	+ Add beautifully clean, customizable, and responsive Instagram feeds to your website. Super simple to set up and tons of customization options to seamlessly match the look and feel of your site.
264	+
265	+ = Why do I need this? =
266	+
267	+ Increase Social Engagement
268	+ Increase engagement between you and your Instagram followers. Increase your number of Instagram followers by displaying your Instagram content directly on your site.
269	+
270	+ Save Time
271	+ Don't have time to update your photos on your site? Save time and increase efficiency by only posting your photos to Instagram and automatically displaying them on your website.
272	+
273	+ Display Your Content Your Way
274	+ Customize your Instagram feeds to look exactly the way you want, so that they blend seemlessly into your site or pop out at your visitors!
275	+
276	+ Keep Your Site Looking Fresh
277	+ Automatically push your new Instagram content straight to your site to keep it looking fresh and keeping your audience engaged.
278	+
279	+ No Coding Required
280	+ Choose from tons of built-in Instagram Feed customization options to create a truly unique feed of your Instagram content.
281	+
282	+ Super simple to set up
283	+ Once installed, you can be displaying your Instagram photos within 30 seconds! No confusing steps or Instagram Developer account needed.
284	+
285	+ Mind-blowing Customer Support
286	+ We understand that sometimes you need help, have issues or just have questions. We love our users and strive to provide the best support experience in the business. We're experts in the Instagram API and can provide unparalleled service and expertise. If you need support then just let us know and we'll get back to you right away.
287	+
288	+ = What can it do? =
289	+
290	+ * Display Instagram photos from any non-private Instagram account.
291	+ * Completely responsive and mobile ready –your Instagram feed layout looks great on any screen size and in any container width
292	+ * Display multiple Instagram feeds on the same page or on different pages throughout your site by using our powerful Instagram Feed shortcode options
293	+ * Display posts from multiple Instagram User IDs
294	+ * Use the built-in shortcode options to completely customize each of your Instagram feeds
295	+ * Infinitely load more of your Instagram photos with the 'Load More' button
296	+ * Plus more features added all the time!
297	+
298	+ = Completely Customizable =
299	+
300	+ * By default the Instagram feed will adopt the style of your website, but can be completely customized to look however you like!
301	+ * Set the number of Instagram photos you want to display
302	+ * Choose how many columns to display your Instagram photos in and the size of the Instagram photos
303	+ * Choose to show or hide certain parts of the Instagram feed, such as the header, 'Load More', and 'Follow' buttons
304	+ * Control the width, height and background color of your Instagram feed
305	+ * Set the spacing/padding between the Instagram photos
306	+ * Display Instagram photos in chronological or random order
307	+ * Use your own custom text and colors for the 'Load More' and 'Follow' buttons
308	+ * Enter your own custom CSS or JavaScript for even deeper customization
309	+ * Use the shortcode options to style multiple Instagram feeds in completely different ways
310	+ * Plus more customization options added all the time!
311	+
312	+ = What Others are Saying =
313	+
314	+ Brilliant plugin and even better support! By Deanobenzino, June 23, 2015 for WP 4.2.2
315	+ I searched for a while to find a decent plugin for an Instagram Feed. This is by far the best, the most stable and very intuitive to use. That being said, the support that I received when asking about a certain functionality I was looking for was fantastic. They were quick to respond and immediately gave me potential solutions. Very professional. Thanks guys!
316	+
317	+ Works beautifully and simply! By Melissa, July 4, 2015 for WP 4.2.2
318	+ I've been using a different Instagram plugin on my site, but saw this implemented recently so I tested it against the other plugin — and this one wins hands down.
319	+ Easy to set up. Beautiful, clean feed. Everything I need! I'll be upgrading to pro soon! Thanks for the great work!
320	+
321	+ great plugin and 5 star support By frurosborg, June 9, 2015 for WP 4.2.2
322	+ i have used many many instagram plugins but this one is the best yet and the support is outstanding. they got back to me and fixed my problem in the hour! do not hesitate. just get it!
323	+
324	+ 5 starsExcellent Plugin, even better support! By soerfi, January 15, 2015 for WP 4.1
325	+ For 2 years I was searching for a plugin like this and I bought the Pro right away without hesitating. Exactly what I was looking for! I just had a small issue with the plugin and the alignment from my Template. David solved this within 2 hours!
326	+ 2 thumbs up!
327	+
328	+ **5 starsGreat plugin - Fantastic support By inventia, January 1, 2015 for WP 4.1
329	+ The plugin is easy to install and setup, AND it looks great!
330	+ Needed to customize it with some CSS and sent a question to the developer. He responded a few hours later (ON CHRISTMAS EVE!!!) with a CSS code that I could copy&paste to the plugins Custom CSS Section.
331	+ Great plugin and fantastic support!
332	+
333	+ 5 starsawesome plugin / amazing support By seiran1, December 22, 2014 for WP 4.1
334	+ getting things up and running was really straight forward and easy. because of the some custom features the client wanted, I ended up buying the pro version - which was well worth it. I started including some custom coding and when I hit a brick wall, John at Smash Balloon was incredibly quick to give me a hand and stuck in there when I fired off a ton of questions.
335	+ thanks again for the awesome plugin and the top-notch support. the plugin is definitely recommended and beats every single other plugin I tried for an instagram tie-in.
336	+
337	+ 5 starsGreat plugin, greater support! By rezza_marco, January 8, 2015 for WP 4.1
338	+ This plugin is what i was looking for, and it's also very easy to use.
339	+ But the best part is about the support. I needed some advices and css customization. I had an email exchange with John, he always answered really fast (matter of few hours) and was totally helpful.
340	+ Thumbs up!!!
341	+
342	+ Outstanding support By leanderbraunschweig, June 12, 2015 for WP 4.2.2
343	+ First things first: The plugin does a great job. I needed an Instagram plugin that was flexible and lightweight enough to work in a corporate environment and am very satisfied.
344	+ But what surprised me the most was the brilliant support I got – responsive, professional and last but not least also very friendly.
345	+ Kudos Smashballoon! Thanks + keep up the good work.
346	+
347	+ Exactly what I was looking for! By orthostice, July 4, 2015 for WP 4.2.2
348	+ Great stuff-- there are a few other instagram gallery plugins out there, but they're not as easy to customize and, importantly, they don't get the presentation right. I don't want borders or drop shadows or to emulate what instagram's home page looks like-- I want my photos pulled from that service and displayed on my website in a way that matches the rest of my work and my other galleries. Great support, fantastic plugin!
349	+
350	+ Incredibly good service and a super solid plugin... By skafte, July 29, 2015 for WP 4.2.3
351	+ Incredibly good service and a super solid plugin that does exactly what you want it to do. One of my very best (plugin/theme) customer experiences ever! Thanks!
352	+
353	+ Great support! By jillybekkers, November 24, 2015
354	+ When I was trying something out, I bumped into a problem.
355	+ The service wasn't only super fast but also extremely helpful!
356	+ In 2 mails, they understood exactly what I wanted and fixed it.
357	+ Thanks a lot!!
358	+
359	+ Amazing possibilities, great support By conchrisoulis, November 23, 2015 for WP 4.3.1
360	+ I needed the Instagram Feed for the needs of my clients who are launching a baby clothes store and wanted to mirror their Instagram Feed on their front page.
361	+ The Feed is customized and works easily (via a simple link in a Page) and most importantly is provided immediate support by its creator, John, through the plug-in's WordPress support page.
362	+ Highly recommended.
363	+
364	+ Love this plugin! By YvonneOH, November 18, 2015 for WP 4.3.1
365	+ I had to make some adjustments to how the Instagram feed would display on my website and the support was very efficient and quick in helping me get the job done. Thanks! :)
366	+
367	+ Best Instagram plugg! By adeb, November 17, 2015 for WP 4.3.1
368	+ Easy to work with and customize, great pluggin!
369	+
370	+ Fantastic Support By hugo85, November 12, 2015
371	+ i had a problem and received a fast solution! Great Product freat Suport.
372	+
373	+ Awesome and GREAT support! By Manyears, November 12, 2015
374	+ This plugin is soooo goooood and the support is the best one! Support answers very fast!
375	+
376	+ Easy to use yet flexible. By ringworld, November 11, 2015 for WP 4.3.1
377	+ I started using this plug-in several months ago. Very impressed with the ease in set up. Also impressed that with various upgrades to WP platform this still goes on running. Great to plug-in to help consolidate your digital footprint.
378	+
379	+ Great Support By hodori_tiger, November 10, 2015 for WP 4.3.1
380	+ Plugin is great! Had some issues with getting the plugin to work on Win 10 and the Edge browser. Support I received from SmashBalloon was awesome.
381	+
382	+ Fantastic customer service By bheyde, November 9, 2015 for WP 4.3.1
383	+ Very nice, very helpful individualized customer service. So impressed.
384	+
385	+ Awesome instagram plugin By flow__, November 9, 2015 for WP 4.3.1
386	+ Fantastic plug with lots of options. Result: a beautiful instagram feed on your wordpress page!
387	+ Support extremely helpful, helping me to make the feed look exactly as I want. THANKS!
388	+
389	+ Works like a charm at one... By RevistaWebVe, November 7, 2015 for WP 4.3.1
390	+ Im so pleased with this plugin, make everything that promise and even more. I wrote to the developer asking for support and get reply fast and accurate. They are a role model in wordpress developer community. Wish you the best guys!!!
391	+
392	+ Great plugin By rocked18, November 7, 2015 for WP 4.3.1
393	+ Really good support on the pro version too, very happy with the Smash Balloon guys.
394	+
395	+ Fantastic Support By SharonVL, November 4, 2015 for WP 4.3.1
396	+ I had a problem an received a super fast response. I wish every company was this responsive. Thanks for the great product and support.
397	+ Sharon
398	+
399	+ Love it! By leloosh, November 4, 2015 for WP 4.3.1
400	+ Very customizable and the interface provides a straight forward way to do so. The lightbox is wonderful and their support is top notch. Highly recommended.
401	+
402	+ Well worth buying By lhescott6, November 3, 2015 for WP 4.3.1
403	+ Perfect. This plugin looks snappy and is really easy to set up. The support is excellent as well - I had a compatibility issue, that was sorted within an afternoon.
404	+
405	+ Buy this plugin By joepunchteam, November 2, 2015 for WP 4.3.1
406	+ Finally an Instagram plugin that works and is easy to use. These guys nailed it. Buy this plugin, thank them later.
407	+
408	+ Just perfect. By parabasvat, October 31, 2015 for WP 4.3.1
409	+ Perfect. It is responsive and very eye catching. Thanks and greetings from Greece.
410	+
411	+ Very good. By romanbon, October 28, 2015 for WP 4.3.1
412	+ Very good plugin that works excellent.
413	+
414	+ Great app with amazing support! By lancegputnam, October 27, 2015
415	+ This plugin is so easy to use and implement onto websites. The support is also amazing - I would definitely recommend this plugin!
416	+
417	+ AMAZEBALLS! By kristinachilds, October 21, 2015 for WP 4.3.1
418	+ I have the pro version, which is well worth it. The plugin is highly customizable, easy to use and the support team is extremely responsive, nice and actually helpful. 6/5 stars!!
419	+
420	+ best! By rh41, October 16, 2015
421	+ best instagram plugin!
422	+
423	+ awesome plugin and fantastic support By chingchingching, October 15, 2015 for WP 4.3.1
424	+ plugin exactly meets my need with all customised settings for both those who prefer a fancy layout or simple one! Love their really quick and responsive technical support as well!
425	+ highly recommended!
426	+
427	+ Highly customizable with great customer service By BJIFashionGroup, October 14, 2015 for WP 4.3.1
428	+ This plugin is awesome! We tried out many Instagram feed plugins and this is by far the best one. It is highly customizable and allows the feed to be generated using many hashtags and many usernames; it also allows many images to be hidden if they are spam/inappropriate/unnecessary for your specific feed.
429	+ A couple months into using this plugin we ran into a bit of a problem/bug with the functionality and the Smash Balloon staff was SO HELPFUL and friendly. They fixed the problem in a timely matter and were very patient with my questions.
430	+ I definitely recommend this plugin!
431	+
432	+ Neat By BeatIdo, October 12, 2015
433	+ Neat plugin and responsive support !
434	+
435	+ Best Instagram Plugin By Le Claqueur de Doigts, October 10, 2015 for WP 4.3.1
436	+ If you're looking for the best Instagram plugin, look no further.
437	+ Not only Instagram Feed is fully customizable so that you can tweak it to taste and make it fit the way that suits you best on your site, but the support team is also simply awesome.
438	+ Faster than light feedbacks, clear and detailed solutions is what you can expect from the team if you need an extra help.
439	+ By far my best experience with a support.
440	+ Thanks again David ! :)
441	+
442	+ Does exactly what I wanted By wrightm1992, October 8, 2015
443	+ Loving this plugin so far, works a treat and the support is really quick and helpful.
444	+
445	+ Don't look any further By songbirdechoes, October 8, 2015 for WP 4.3.1
446	+ Besides the fact that I am in love with this plugin which came pre-installed with my Pipdig theme, I must say the support is also great! John is fairly prompt with his responses and provides detailed and clear solutions. Look no further for the perfect Instagram plugin for your site :)
447	+
448	+ Fantastic support By Dhruv, October 7, 2015
449	+ Quick to revert on support and get things going!
450	+
451	+ CSS padding By namaste364, October 7, 2015 for WP 4.3.1
452	+ Unbelievable support!!!
453	+ As it tuned out it wasn't anything to do with the plugin, it was a problem on my site. David was so helpful and suggested a fix for it.
454	+ Very,very impressive!
455	+
456	+ Perfect! By shashankkumar, October 7, 2015 for WP 4.3.1
457	+ Special thanks for helping me iron out issues with my site.
458	+
459	+ Great plugin with fantastic support! By betheroots, October 6, 2015 for WP 4.3.1
460	+ This plugin does everything that I wanted it to do with a clean and simple design. Support was super quick and personal. Suggestions were made to deal with an issue which wasn't even caused by this plugin. Thanks :)
461	+
462	+ Just great By antonk52, October 5, 2015 for WP 4.3.1
463	+ Works perfect, custom attributes come in handy when integrating the feed with a multilingual site
464	+
465	+ Stunning! By RynoDekker, September 28, 2015 for WP 4.3.1
466	+ Absolutely amazing! So easy to use, customize and apply. I am currently on the free version, but suspect that the PRO version is on the horizon for me! Thank you so much for all the INCREDIBLE work that went into this!
467	+
468	+ Superb plugin. Superb customer support. By michaeltakano, September 28, 2015 for WP 4.3.1
469	+ This instagram plugin is a marvel. Super fast. Easy to configure. All features available through the settings panel AND through short-codes. This makes configuration super easy and allows for multiple and different instances of the plugin within a single site.
470	+ The customer service is fast, courteous and understanding.
471	+ Look no further for your Instagram plugin.
472	+
473	+ Awesome Customer Service By owenow, September 28, 2015 for WP 4.3.1
474	+ Tried the free standard edition and had a simple issue which was easily fixed due to awesome customer support from David. Have now purchased the Pro version and extremely happy.
475	+
476	+ Works great and super helpful By omniscientlust, September 26, 2015
477	+ Super helpful and I highly recommend, do not hesitate to contact them if you need any help, they replied to my query immediately and also followed up on it! super satisfied user
478	+
479	+ Great support By lauravink, September 25, 2015 for WP 4.3.1
480	+ Very detailed respons to my questions.
481	+
482	+ Great plugin and support By NinaLee, September 22, 2015
483	+ The plugin works fantastically, highly customizable. When I had a brief problem with it I sent an email and received a friendly response the day of, even though it was a weekend. Thanks so much!
484	+
485	+ Great plugin with great support and service By northguide, September 21, 2015 for WP 4.3.1
486	+ I've deployed many wordpress plugins over the years and this plugin is easily one of the best. The installation was flawless. I was able to set up my instagram feeds in minutes and able to get the look I wanted using the options in the short code with only a few, minor tweakings. I had some questions about additional capabilities and was impressed how quickly I support got back to me with some solutions. Solid performance in all aspects so far. Never been happier with a plugin purchase.
487	+
488	+ Support that works By Petervee, September 17, 2015 for WP 4.3.1
489	+ I've been developing with WordPress for over 5 years. I have submitted numerous support queries in the past to developers with no or very little interaction or reply. This morning I had a question for the guys at Smash Balloon and sent off a form to support. I got a personalised email back with steps on how to solve my issues. Thanks guys, your service and your plugin are amazing!
490	+ The Smash Balloon guys are ROCK STARS!
491	+
492	+ Great product and quick support! By nayeonkim, September 16, 2015 for WP 4.3.1
493	+ This plugin is one of the best ones out there for Instagram feed. Great product and support! I recommend this plugin.
494	+
495	+ = Instagram Platform Policy =
496	+
497	+ By using the Instagram APIs, you agree to this policy. We reserve the right to change this policy at any time without notice, so please check it regularly. Your continued use of the Instagram APIs constitutes acceptance of any changes. You also agree to and are responsible for ensuring that you comply with the Instagram Terms of Use and Instagram Community Guidelines.
498	+
499	+ We provide the Instagram APIs to support several types of apps and services. First, we provide them to help members of our community share their own content with apps or services. We also support apps and services that help brands and advertisers understand and manage their audience, develop their content strategy, and obtain digital rights. Finally, we provide the Instagram APIs to help broadcasters and publishers discover content, get digital rights to media, and share media using web embeds. The Instagram APIs are not intended for other types of apps or services. For those we do support, the following terms and information also apply:
500	+
501	+ A. General Terms
502	+ Ensure your app is stable and easily navigable.
503	+ Don't confuse, deceive, defraud, mislead, or harass anyone.
504	+ Be transparent about your identity and your app's identity.
505	+ Don't use the Instagram APIs for any app that constitutes, promotes or is used in connection with spyware, adware, or any other malicious programs or code.
506	+ Don't store or cache Instagram login credentials.
507	+ Follow any instructions we include in our technical documentation.
508	+ Provide meaningful customer support for your app, and make it easy for people to contact you.
509	+ Provide a publicly accessible privacy policy that tells people what you collect and how you will use this information.
510	+ If you allow third parties to serve content, including advertisements, or collect information directly from visitors, including placing or recognizing cookies on visitors' browsers, disclose this in your privacy policy.
511	+ Comply with your privacy policy.
512	+ Comply with any requirements or restrictions imposed on usage of Instagram user photos and videos ("User Content") by their respective owners. You are solely responsible for making use of User Content in compliance with owners' requirements or restrictions.
513	+ Remove within 24 hours any User Content or other information that the owner asks you to remove.
514	+ Obtain a person's consent before including their User Content in any ad.
515	+ Only store or cache User Content for the period necessary to provide your app's service.
516	+ If you store or cache User Content, keep it up to date. For example, if a user marks a photo as "private", you must reflect that change by removing the content as soon as reasonably possible.
517	+ Don't use the Instagram API to simply display User Content, import or backup content, or manage Instagram relationships, without our prior permission.
518	+ Don't apply computer vision technology to User Content, without our prior permission.
519	+ Don't participate in any "like", "share", "comment" or "follower" exchange programs.
520	+ Don't use follower information for anything other than analytics without our prior permission. For example, don't display these relationships in your app.
521	+ Only use the POST and DELETE endpoints after a business has taken an explicit action in your app requesting you to do so.
522	+ Only use the POST and DELETE likes, comments, and relationships endpoints to enable businesses to manage communication with people who have expressed interest in them. Don't use these endpoints for non-business purposes.
523	+ Ensure your comments are uniquely tailored for each person. Don't post unauthorized commercial communication or spam on Instagram.
524	+ Don't enable a business to take more than one action on Instagram at a time.
525	+ Add something unique to the community. Don't use the Instagram APIs to replicate or attempt to replace the functionality or essential user experiences of Instagram.com or any of Instagram's apps.
526	+ Respect the way Instagram looks and functions. Don't offer experiences that change it.
527	+ Don't attempt to build an ad network on Instagram.
528	+ Don't attempt to identify groups of individuals or create demographic clusters for the purpose of contacting or targeting Instagram members on or off Instagram.
529	+ Don't transfer any data that you receive from us (including anonymous, aggregate, or derived data) to any ad network, data broker, influencer network, or other advertising or monetization-related service.
530	+ You can administer a promotion on Instagram if you comply with all applicable laws and regulations, but don't directly incentivize other actions.
531	+ If you want to facilitate or promote online gambling, online real money games of skill, or online lotteries, get our written permission before using any of our products.
532	+ Don't use an unreasonable amount of bandwidth, or adversely impact the stability of Instagram.com servers or the behavior of other apps using the Instagram APIs.
533	+ Don't reverse engineer the Instagram APIs or any of Instagram's apps.
534	+ Don't sell, lease, or sublicense the Instagram APIs or any data derived through the APIs.
535	+ Comply with all applicable laws or regulations. Don't violate any rights of any person, including but not limited to intellectual property rights, rights of privacy, or rights of personality. Don't expose Instagram or people who use Instagram to harm or legal liability.
536	+
537	+ B. Brand Assets
538	+ Comply with Instagram's Brand Guidelines. Don't use the trademarks of Instagram or its affiliates without written permission, including as authorized by applicable brand guidelines.
539	+
540	+ C. Things you should know
541	+ Instagram primarily communicates with developers through email. Please ensure that the email addresses associated with your Instagram account are current and that you don't filter out these messages.
542	+ Instagram may rate limit or block apps that make a large number of calls to the API that are not primarily in response to direct user actions.
543	+ Enforcement is both automated and manual, and can include disabling your app, restricting you and your app's access to Instagram APIs, requiring that you delete data, terminating our agreements with you or any other action that we deem appropriate.
544	+ Instagram may change, suspend, or discontinue the availability of any Instagram APIs at any time. In addition, Instagram may impose limits on certain features and services or restrict your access to parts or all of the Instagram APIs or the Instagram website without notice or liability.
545	+ If Instagram elects to provide you with support or modifications for the Instagram APIs, this support may be terminated at any time without notice to you.
546	+ Instagram reserves the right to charge fees for future use of or access to the Instagram APIs.
547	+ Instagram doesn't guarantee that any Instagram APIs are free of inaccuracies, errors, bugs, or interruptions, or are reliable, accurate, complete, or otherwise valid.
548	+ Licensed Uses and Restrictions: The Instagram APIs are owned by Instagram and are licensed to you on a worldwide (except as limited below), non-exclusive, non-sublicenseable basis in accordance with these terms. Your license to the Instagram APIs continues until it is terminated by either party. Please note that User Content is owned by users and not by Instagram. All rights not expressly granted to you are reserved by Instagram.
549	+ Disclaimer of Any Warranty: Instagram APIs and all data derived through such APIs are provided "as is" with no warranty, express or implied, of any kind and Instagram expressly disclaims any and all warranties and conditions, including but not limited to, any implied warranty of merchantability, fitness for a particular purpose, availability, security, title and non-infringement. You are solely responsible for any damage that results from the use of any Instagram APIs and all any data derived through such APIs including, but not limited to, any damage to your computer system or loss of data.
550	+ Limitation of Liability: Instagram shall not, under any circumstances, be liable to you for any indirect, incidental, consequential, special or exemplary damages arising out of or in connection with use of the Instagram APIs and any data derived through such APIs, whether based on breach of contract, breach of warranty, tort (including negligence, product liability or otherwise), or any other pecuniary loss, whether or not Instagram has been advised of the possibility of such damages. Under no circumstances shall Instagram be liable to you for any amount.
551	+ Release and Waiver: To the maximum extent permitted by applicable law, you hereby release and waive all claims against Instagram, and its subsidiaries, affiliates, officers, agents, licensors, co-branders or other partners, and employees from any and all liability for claims, damages (actual and/or consequential), costs and expenses (including litigation costs and attorneys' fees) of every kind and nature, arising from or in any way related to your use of the Instagram APIs and data derived through such APIs. If you are a California resident, you waive your rights under California Civil Code 1542, which states, "A general release does not extend to claims which the creditor does not know or suspect to exist in his favor at the time of executing the release, which if known by him must have materially affected his settlement with the debtor." You understand that any fact relating to any matter covered by this release may be found to be other than now believed to be true and you accept and assume the risk of such possible differences in fact. In addition, you expressly waive and relinquish any and all rights and benefits which you may have under any other state or federal statute or common law principle of similar effect, to the fullest extent permitted by law.
552	+ Hold Harmless and Indemnify: To the maximum extent permitted by applicable law, you agree to hold harmless and indemnify Instagram and its subsidiaries, affiliates, officers, agents, licensors, co-branders or other partners, and employees from and against any third-party claim arising from or in any way related to your use of the Instagram APIs and any data derived through the APIs, including any liability or expense arising from all claims, losses, damages (actual and/or consequential), suits, judgments, litigation costs and attorneys' fees, of every kind and nature. Instagram shall use good faith efforts to provide you with written notice of such claim, suit or action.
553	+ Relationship of the Parties: Notwithstanding any provision hereof, for all purposes of the Instagram API Terms, you and Instagram shall be and act independently and not as partner, joint venturer, agent, employee or employer of the other. You don't have any authority to assume or create any obligation for or on behalf of Instagram, express or implied, and you must not attempt to bind Instagram to any contract.
554	+ Invalidity of Specific Terms: If any provision of the Instagram API Terms is found by a court of competent jurisdiction to be invalid, the parties nevertheless agree that the court should endeavor to give effect to the parties' intentions as reflected in the provision and that the other provisions remain in full force and effect.
555	+ No Waiver of Rights by Instagram: Instagram's failure to exercise or enforce any right or provision of the Instagram API Terms shall not constitute a waiver of such right or provision.
556	+
557	== Upgrade Notice ==
558
559	+ = 1.4.3 =
560	Important: Due to the upcoming Instagram API changes, in order for the Instagram Feed plugin to continue working after June 1st you must update the plugin and obtain a new Access Token on the plugin's Settings page.
561
562	== Changelog ==
563
564	+ = 1.4.3 =
565	+ * Fix: Important notice added in the last update is now only visible to admins
566	+
567	= 1.4.2 =
568	* IMPORTANT: Due to the upcoming Instagram API changes, in order for the Instagram Feed plugin to continue working after June 1st you must obtain a new Access Token by using the Instagram button on the plugin's Settings page.
569	* New: Compatible with Instagram's new API changes effective June 1st

574	* Fix: Minified CSS and JS files
575
576	= 1.3.11 =
577	+ * Fix: Fixed a bug which was causing the height of the Instagram photos to be shorter than they should have been in some themes
578	+ * Fix: Fixed an issue where when an Instagram feed was initially hidden (in a tab, for example) then the Instagram photo resolution was defaulting to 'thumbnail'
579
580	= 1.3.10 =
581	+ * Fix: Fixed an issue which was setting the visibility of some Instagram photos to be hidden in certain browsers
582	+ * Fix: The new square photo cropping is no longer being applied to Instagram feeds displaying images at less than 150px wide as the images from Instagram at this size are already square cropped
583	* Fix: Fixed a JavaScript error in Internet Explorer 8 caused by the 'addEventListener' function not being supported
584
585	= 1.3.9 =
586	+ * Fix: Fixed an issue where Instagram photos wouldn't appear in the Instagram feed if it was initially being hidden inside of a tab or some other element
587	+ * Fix: Fixed an issue where the new Instagram image cropping fuction was failing to run on some sites and causing the Instagram images to appear as blank
588
589	= 1.3.8 =
590	+ * Fix: If you have uploaded an Instagram photo in portrait or landscape then the plugin will now display the square cropped version of the photo in your Instagram feed
591
592	= 1.3.7 =
593	+ * Fix: Fixed an issue with double quotes in photo captions (used in the Instagram photo alt tags) which caused a formatting issue
594
595	= 1.3.6 =
596	* Fix: Fixed an issue introduced in version 1.3.4 which was causing theme settings to not be applied in some themes
597
598	= 1.3.5 =
599	* Fix: Reverted the 'prop' function introduced in the last update back to 'attr' as prop isn't supported in older versions of jQuery
600	+ * Fix: Removed the image load function as it was causing Instagram images not to be displayed for some users
601
602	= 1.3.4 =
603	+ * Fix: Used the Instagram photo caption to add a more descriptive alt tag to the Instagram photos
604	+ * Fix: Instagram photos are now only displayed once they're fully loaded
605	* Fix: Added a stricter CSS implementation for some elements to prevent styles being overridden by themes
606	+ * Fix: Added CSS opacity property to Instagram images to prevent issues with lazy loading in some themes
607	* Fix: Removed a line of code which was disabling WordPress Debug/Error Reporting. If needed, this can be disabled again by using the setting at the bottom of the plugin's 'Customize' settings page.
608	+ * Fix: Made some JavaScript improvements to the core Instagram Feed plugin code
609
610	= 1.3.3 =
611	+ * Fix: Fixed an issue with the 'Load more' button not always showing when displaying Instagram photos from multiple Instagram User IDs
612	* Fix: Moved the initiating sbi_init function outside of the jQuery ready function so that it can be called externally if needed by Ajax powered themes/plugins
613
614	= 1.3.2 =
615	+ * New: Added an option to disable the Instagram Feed mobile layout
616	+ * New: Added an setting which allows you to use the Instagram Feed plugin with an Ajax powered theme
617	+ * New: Added a 'class' shortcode option which allows you to add a CSS to class to each individual Instagram feed: `[instagram-feed class=feedOne]`
618	* New: Added a Support tab which contains System Info to help with troubleshooting
619	* New: Added friendly error messages which display only to WordPress admins
620	+ * New: Added validation to the Instagram User ID field to prevent usernames being entered instead of IDs
621	+ * Tweak: Made the Instagram Access Token field slightly wider to prevent tokens being copy and pasted incorrectly
622	* Fix: Fixed a JavaScript bug which caused the feed not to load photos correctly in IE8
623
624	= 1.3.1 =
625	+ * Fix: Fixed an issue with the Instagram icon not appearing in the 'Follow on Instagram' button or in the Instagram Feed header
626	+ * Fix: Addressed a few CSS issues which were causing some minor formatting issues in the Instagram Feed on certain themes
627
628	= 1.3 =
629	+ * New: You can now display Instagram photos from multiple Instagram User IDs. Simply separate your Instagram IDs by commas.
630	+ * New: Added an optional header to the Instagram feed which contains your Instagram profile picture, Instagram username and Instagram bio. You can activate this on the Instagram Feed Customize page.
631	+ * New: The Instagram Feed plugin now includes an 'Auto-detect' option for the Instagram Image Resolution setting which will automatically set the correct Instagram image resolution based on the size of your Instagram feed.
632	+ * New: Added an optional 'Follow on Instagram' button which can be displayed at the bottom of your Instagram feed. You can activate this on the Instagram Feed Customize page.
633	* New: Added the ability to use your own custom text for the 'Load More' button
634	+ * New: Added a loader icon to indicate that the Instagram photos are loading
635	* New: Added a unique ID to each Instagram photo so that they can be targeted individually via CSS
636	+ * Tweak: Added a subtle fade effect to the Instagram photos when hovering over them
637	+ * Tweak: Improved the responsive layout behavior of the Instagram feed
638	+ * Tweak: Improved the documentation within the Instagram Feed plugin settings pages
639	* Tweak: Included a link to [step-by-step setup directions](http//:smashballoon.com/instagram-feed/free/ 'Instagram feed setup directions') for the plugin
640	* Fix: Fixed an issue with the feed not clearing other widgets correctly
641

643	* Fix: Replaced the 'on' function with the 'click' function to increase compatibility with themes using older versions of jQuery
644
645	= 1.2.2 =
646	+ * Tweak: Added an initialize function to the Instagram Feed plugin
647	* Fix: Fixed an occasional issue with the 'Sort Photos By' option being undefined
648
649	= 1.2.1 =
650	+ * Fix: Fixed a minor issue with the Custom JavaScript being run before the Instagram photos are loaded
651	* Fix: Removed stray PHP notices
652	* Fix: Changed the double quotes to single quotes on the 'data-options' attribute
653
654	= 1.2 =
655	+ * New: Added Custom CSS and Custom JavaScript sections which allow you to add your own custom CSS and JavaScript to the Instagram Feed plugin
656	* New: Added an option to display your Instagram photos in random order
657	+ * New: A new tabbed layout has been implemented on the Instagram Feed plugin's settings pages
658	+ * New: Added an option to preserve your Instagram Feed settings when uninstalling the plugin
659	+ * New: Added a [Pro version](http://smashballoon.com/instagram-feed/ 'Instagram Feed Pro') of the Instagram Feed plugin which allows you to display Instagram photos by hashtag, display Instagram captions, view Instagram photos in a pop-up lightbox, show the number of Instagram likes & comments and more
660	+ * Tweak: The 'Load More' button now automatically hides if there are no more Instagram photos to load
661	* Tweak: Added a small gap to the top of the 'Load More' button
662	* Tweak: Added a icon to the Instagram Feed menu item
663
664	= 1.1.6 =
665	+ * Fix: A maximum width is now only applied to the Instagram feed when the Instagram photos are displayed in one column
666
667	= 1.1.5 =
668	* Fix: Added a line of code which enables shortcodes to be used in widgets for themes which don't have it enabled
669
670	= 1.1.4 =
671	+ * Fix: Fixed an issue with the Instagram Access Token and Instagram User ID retrieval functionality in certain web browsers
672
673	= 1.1.3 =
674	* Fix: Fixed an issue with the maximum Instagram image width
675	+ * Fix: Corrected a typo in the Instagram Feed Shortcode Options table
676
677	= 1.1.1 =
678	* Pre-tested for the upcoming WordPress 4.0 update

682	* New: Added an option to set the number of Instagram photos to be initially displayed
683	* New: Added an option to show or hide the 'Load More' button
684	* New: Added 'Step 3' to the Instagram Feed Settings page explaining how to display your feed using the [instagram-feed] shortcode
685	+ * New: Added a full list of all available Instagram Feed shortcode options to help you if customizing multiple Instagram feeds
686
687	= 1.0.2 =
688	+ * Fix: Fixed an issue with the Instagram login URL on the plugin's Instagram Feed Settings page
689
690	= 1.0.1 =
691	* Fix: Fixed an issue with the Instagram Feed 'Load More' button opening an empty browser window in Firefox

instagram-feed-admin.php CHANGED Viewed

@@ -1048,23 +1048,28 @@ function sbi_add_settings_link( $links, $file ) {
             add_action('admin_notices', 'sbi_new_token_notice');
             function sbi_new_token_notice() {
-            -
                global $current_user;
-            -
                    $user_id = $current_user->ID;
-            -
                // Use this to show notice again
-            -
                // delete_user_meta($user_id, 'sb_instagram_ignore_notice');
-            -
                /* Check that the user hasn't already clicked to ignore the message */
-            -
                if ( ! get_user_meta($user_id, 'sb_instagram_ignore_notice') ) {
-            -
                _e("
-            -
                <div class='sb_instagram_notice'>
-            -
                    <p class='sb_instagram_notice_title'><i class='fa fa-exclamation-circle' aria-hidden='true'></i> <b>Important</b></p>
-            -
                    <p><b>Just installed the plugin?</b> You can ignore this notice and hide it using the 'Dismiss' button in the top right corner.</p>
-            -
                    <p><b>Just updated the plugin?</b> Due to the upcoming Instagram API changes, in order for the Instagram Feed plugin to continue working after <b><u>June 1st</u></b> you must obtain a new Access Token by using the Instagram button on the plugin's <a href='".get_admin_url()."admin.php?page=sb-instagram-feed'>Settings page</a>.</p>
-            -
                    <a class='sb_instagram_dismiss' href='" .esc_url( add_query_arg( 'sb_instagram_token_nag_ignore', '0' ) ). "'><i class='fa fa-times-circle' aria-hidden='true'></i> Dismiss</a>
-            -
                </div>
-            -
                ");
+                }


1048	add_action('admin_notices', 'sbi_new_token_notice');
1049	function sbi_new_token_notice() {
1050
1051	+ //Only show to admins
1052	+ if( current_user_can('manage_options') ){
1053	+
1054	+ global $current_user;
1055	+ $user_id = $current_user->ID;
1056	+
1057	+ // Use this to show notice again
1058	+ // delete_user_meta($user_id, 'sb_instagram_ignore_notice');
1059
1060	+ /* Check that the user hasn't already clicked to ignore the message */
1061	+ if ( ! get_user_meta($user_id, 'sb_instagram_ignore_notice') ) {
1062
1063	+ _e("
1064	+ <div class='sb_instagram_notice'>
1065	+ <p class='sb_instagram_notice_title'><i class='fa fa-exclamation-circle' aria-hidden='true'></i> <b>Important</b></p>
1066	+ <p><b>Just installed the plugin?</b> You can ignore this notice and hide it using the 'Dismiss' button in the top right corner.</p>
1067	+ <p><b>Just updated the plugin?</b> Due to the upcoming Instagram API changes, in order for the Instagram Feed plugin to continue working after <b><u>June 1st</u></b> you must obtain a new Access Token by using the Instagram button on the plugin's <a href='".get_admin_url()."admin.php?page=sb-instagram-feed'>Settings page</a>.</p>
1068	+ <a class='sb_instagram_dismiss' href='" .esc_url( add_query_arg( 'sb_instagram_token_nag_ignore', '0' ) ). "'><i class='fa fa-times-circle' aria-hidden='true'></i> Dismiss</a>
1069	+ </div>
1070	+ ");
1071
1072	+ }







1073
1074	}
1075

instagram-feed.php CHANGED Viewed

	@@ -3,7 +3,7 @@
3	Plugin Name: Instagram Feed
4	Plugin URI: http://smashballoon.com/instagram-feed
5	Description: Display beautifully clean, customizable, and responsive Instagram feeds
6	- Version: 1.4.2
7	Author: Smash Balloon
8	Author URI: http://smashballoon.com/
9	License: GPLv2 or later
	@@ -23,7 +23,7 @@ along with this program; if not, write to the Free Software
23	Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
24	*/
25
26	- define( 'SBIVER', '1.4.2' );
27
28	//Include admin
29	include dirname( __FILE__ ) .'/instagram-feed-admin.php';


3	Plugin Name: Instagram Feed
4	Plugin URI: http://smashballoon.com/instagram-feed
5	Description: Display beautifully clean, customizable, and responsive Instagram feeds
6	+ Version: 1.4.3
7	Author: Smash Balloon
8	Author URI: http://smashballoon.com/
9	License: GPLv2 or later

23	Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
24	*/
25
26	+ define( 'SBIVER', '1.4.3' );
27
28	//Include admin
29	include dirname( __FILE__ ) .'/instagram-feed-admin.php';