=== Instagram ===
Contributors: webdorado, progmastery 
Donate link: https://web-dorado.com/products/wordpress-instagram-feed-wd.html
Tags: : custom instagram feed, feed, instagram, hashtag, Instagram feed, instagram gallery, instagram posts, Instagram images, Instagram photos, Instagram wall, lightbox, photos
Requires at least: 3.9
Tested up to: 4.6
Stable tag: 1.1.12
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Instagram Feed WD plugin  is a user-friendly tool for displaying user or hashtag-based feeds on your website with only few clicks.

== Description ==

**IMPORTANT: Instagram changed the API. You need to get a new access token by using "Sign in with Instagram" button on the Settings page in order to keep your Instagram Feed WD plugin functioning after June 1.**

[WordPress WD Instagram Feed ](https://web-dorado.com/products/wordpress-instagram-feed-wd.html)   
[Demo](http://wpdemo.web-dorado.com/instagram-wd/)  
[User Guide](https://web-dorado.com/wordpress-instagram-feed-wd/installation-and-configuration/installation.html)    
[Support Forum](https://web-dorado.com/forum/wordpress-instagram-feed-wd.html)        

https://www.youtube.com/watch?v=ijdrpkVAfEw

Have you ever wanted to display images from Instagram on your webpages? Is simple integration not enough for your WordPress website? Do you want to display composite feeds of hashtags and users? Do you prefer to show instagram content with your custom styling? Have you ever thought it will be cool to repost your Instagram feed to WP blog? Instagram Feed WD is your best solution with its user-friendly management and easy set up. It is simply the most useful and functional WordPress Instagram plugin.

Instagram Feed WD allows displaying Instagram feeds based on public Instagram accounts and hashtags. You can create mixed feeds based on multiple accounts, multiple hashtags or any combination of both with Pro version.  WordPress Instagram plugin uses 4 layouts - 2 layouts for smaller thumbnail display  (Thumbnail and Masonry) and 2 for larger images (Blog Style and Image Browser). Thumbnail view displays images with their metadata (Pro): caption, number of likes and comments. Image Browser displays single image with navigation possibility, metadata (Pro): image caption, number of likes and comments. Masonry (Pro) layout displays images in beautiful masonry view combining the image and its metadata (Pro). Blog Style (Pro) layout combines large image with  its data similar creating a blog style display. All the layouts can display feed username and its metadata (bio, number of posts and followers).

Use Conditional Filters to display filtered feeds (Pro). Set up a filter logic (to hide or display posts), choose condition type (username, hashtag, mention,description, Instagram media link), fill in condition and display filtered feeds. Feeds can have multiple filters.

Images can be redirected to Instagram or opened in a lightbox. You can set sorting for the images (date, likes, comments, random) as well as define the order (ascending/descending). In case of combined feeds you can use front-end filtering by clicking on specific hashtag or username. The lightbox display images as a slideshow with different transition effects (Pro). In Pro version of this Instagram plugin media caption, comments, social share buttons and filmstrip also can be shown in the lightbox, making it an elegant advanced tool for viewing Instagram feed.

Theme section (available with Pro version) allows to customize colors, sizes and display styles. Each layout uses its own theme which makes this section even more compelling.

No feed data is stored in the database. All the images, videos (Pro), captions and comments  are retrieved directly from the Instagram in the front-end, which makes this WordPress Instagram plugin fast and very easy to use.


###IMPORTANT:    
If you think you found a bug in Instagram Feed WD or have any problem/question concerning this Instagram plugin, please check out [Support Forum](https://web-dorado.com/forum/wordpress-instagram-feed-wd.html) in our website. If you do not find a solution here, do not hesitate to [click here to contact us](https://web-dorado.com/support/contact-us.html).


= Instagram Feed main features include: =

*   Responsive    
*   SEO-friendly    
*   Unlimited Instagram feeds    
*   Hashtag-based Instagram feed    
*   Instagram account-based feed    
*   Instagram User meta data (image, bio, followers and posts number) display    
*   Thumbnail Layout Instagram feeds    
*   Image Browser Layout  Instagram feeds  
*   Sorting by options      
*   Load More and pagination options for Instagram feeds    
*   Elegant lightbox with media captions      
*   1 Lightbox transition effect 
*   Instagram icon for redirecting to Instagram account/Instagram hashtag feed    
*   Simple Instagram WD shortcode    
*   Instagram WD PHP shortcode support    
*   Instagram redirection possibility    
*   Instagram Feed WD Widget    
*   Original Instagram Image download     

Upgrade to [Instagram Feed Pro](https://web-dorado.com/products/wordpress-instagram-feed-wd.html) to add features:      

*   Masonry Layout Instagram feeds      
*   Blog Style Layout Instagram feeds    
*   Image meta data (Instagram image caption, comments, like) display    
*   Mixed and multiple feeds (several Instagram hashtags and Instagram public accounts)   
*   Fully Customizable Themes    
*   Vertical/horizontal filmstrip in lightbox    
*   HTML5 Video Support in Lightbox, Blog Style and Image Browser views for displaying Instagram videos   
*   15 Lightbox transition effects     
*   Social sharing buttons (Facebook, Twitter, Google+, LinkedIn and Pinterest) 
*   Infinite scroll for the feed (Similar to Instagram standard)     
*   Instagram Comments display in Lightbox      
*   Instagram Hashtag/ Instagram User account filtering options 
* Conditional Filters      

== Installation ==

#### Thank you for your interest in Instagram Feed WD.  

### Minimum requirements.  
*   Wordpress 3.9+  
*   PHP 5.x  
*   MySQL 5.x  

### Perform a new installation  

After downloading the ZIP file of the Instagram Feed WD plugin,  

1. Log in to the administrator panel.   
2. Go to Plugins Add > New > Upload.     
3. Click "Choose file" ("Browse") and select the downloaded zip file of the Instagram Feed plugin.     
*For Mac Users*     
*Go to your Downloads folder and locate the folder with the Instagram Feed WD. Right-click on the folder and select Compress. Now you have a newly created .zip file which can be installed as described here.*     
4. Click "Install Now" button.     
5. Click "Activate Plugin" button for activating the Instagram Feed WD.    
6. If the installation does not succeed, please contact us at [info@web-dorado.com](mailto:info@web-dorado.com).

== Screenshots ==

1.  WordPress Instagram Feed WD - Thumbnail layout      
2.  WordPress Instagram Feed WD - Image browser layout       
3.  WordPress Instagram Feed WD - Lightbox        
4.  WordPress Instagram Feed WD - Edit Instagram Feed    
5.  WordPress Instagram Feed WD - Theme Settings   

== Changelog ==

= 1.1.12 =
New: Feed based on liked media (Pro)  
Fixed: Hidden media in last page   
Fixed: Minor issues   

= 1.1.11 =
Added: Setting to show media descriptions in widget mode (PRO)    
Fixed: Untranslatable strings in widget editor   
Change: Featured plugins list   

= 1.1.10 =
Added: New text in uninstall page     
Fixed: Video not centering issue on blogstyle       
Added: Swedish translations     

= 1.1.9 =
New: Option to set minimal user role for adding and managing feeds and themes       
Fixed: Masonry feed thumbnails overlay opacity (Pro)     

= 1.1.8 =
Changed: Font-Awesome updated to version 4.6.3    

= 1.1.7 =
New: Featured themes admin page     
Fixed: Javascript error in hashtag feed    

= 1.1.6 =
Change: Added compatibility with "All in one SEO pack" and other plugins running shortcodes in page head    

= 1.1.5 =
Fixed: Javascript error on Firefox and Safari    

= 1.1.4 =
Fixed: Error handling in case of wrong access_token    
Fixed: Image description not opening after pagination (Pro)   
Fixed: Do not show load more button if feed media are finished   
Fixed: Infinite scroll triggering bug (Pro)   

= 1.1.3 =
New: French translation (Thanks to Guillaume Barjou)   
New: English US and UK translation files. Edit them to change default strings    
Fixed: Image sizes and overwflows in thumbnails layout    
Fixed: Lightbox filmstrip thumb styles (Pro)     


= 1.1.2 =
Fixed: Bug when saving theme data to some MySQL 5.6 databases   
Changed: Pagination of hashtag feeds restored   
Changed: Check and get user id on frontend if empty for some unknown reason   

= 1.1.1 =
Fixed: Bug when duplicating feeds    

= 1.1.0 =
**IMPORTANT: Instagram changed the API. You need to get a new access token by using "Sign in with Instagram" button on the Settings page in order to keep your Instagram Feed WD plugin functioning after June 1.**    
new: Instagram new API       
new: Spanish translation (Thanks to Alexandro Lacadena Gomez)      

= 1.0.10 =
Temporarily disable pagination in hashtag based feeds    
Changed: Russian Translations ( Thanks to Alex Petrin )     

= 1.0.9 =
Added: Option for displaying image loading buttons in widgets   
Added: Permission for authors displaying instagram feeds on posts    

= 1.0.8 = 
Fixed: Infinite Scroll bug     
Changed: Show videos play button when redirect is enabled   

= 1.0.7 = 
ADD: Image Hover Effects (Pro)   

= 1.0.6 =
New: Conditional Filters (Pro)      
New: Option for displaying username in masonry/thumbnails view (Pro)      
Fixed: Minor bugs    
New: Russian translation (Thanks to Ruslan Tertyshny).        

= 1.0.5 =
New: New year promo   

= 1.0.4 =
Fixed: Bug in layout    

= 1.0.3 =
Fixed: PHP function in feeds list    

= 1.0.2 =
Fixed: PHP error after plugin update

= 1.0.1 =
Fixed: PHP 5.3 compatibility      
Fixed: Video redirect bug      
Changed: User info styles     

= 1.0.0 =
Initial version    

== Instagram Feed WD User Manual  == 
  
= Installation =
Here are two ways of installing Instagram Feed WD: via WordPress backend and via FTP. Let’s discuss each case individually:    

Installing via WordPress    
Login to the WordPress Administrator Panel.    
Go to Plugins> Add New>Upload.     
Click Choose file button and select the zip folder of Instagram Feed WD plugin and press Install now button.     
Click Activate button.    

Installing via FTP    
Login to your hosting space via an FTP software, e.g. FileZilla.    
Unzip the downloaded Instagram Feed WD plugin folder without making any changes to the folder.   
Upload the plugin into the following location wp-content>wp-plugins.   
Login to the WordPress Administrator Panel.   
Activate Instagram Feed WD by going to Plugins and pressing Activate button.     

= Getting Instagram Access Token =
In this section you can add FAQs.    

To start using Instagram Feed you will be required to first fill in Settings section. Go to Instagram Feed>Settings tab. Press Sign in with Instagram. Pressing the button Access Token and Username will be automatically generated for the current logged-in Instagram account (if user is not logged-in, a popup offering to sign in to Instagram will appear).    

Reset access token and username button resets default user data in plugin. Use that button to get access token for other Instagram user.        

= Creating an Instagram Feed =
Go to Instagram Feed WD > Feed and press Add New. Here you can choose Instagram feed layout and manage lightbox options.    

Create an Instagram feed based on one of the available layouts- Thumbnail, Masonry, Blog Style, Image Browser.  
 
= Thumbnails and Masonry Layouts =
Since Thumbnails and Masonry Layout Instagram Feeds use identical set of properties we will discuss them jointly. When using  Thumbnail view Instagram images get identical dimensions, whereas with  Masonry view Instagram images and their properties (description, caption, hashtags) get displayed as a masonry feed.

Feed Name. Provide a title for the Instagram feed. It will be useful to provide unique title since you will need it when inserting the Instagram feed into a page or post.
Theme. Select one of the existing themes for the Instagram feed. All theme styling parameters will be applied.
Feed Usernames and Hashtags. Provide all Instagram usernames and hashtags you want to use within the Instagram feed. All all them using add button. Instagram Usernames should be provided within the following format: “webdorado”, whereas for Instagram hashtags you need to use the following format: #webdorado.
Featured Image. One of the Instagram user avatars can be used as a featured image, select the relevant Instagram user in case you have more than one image. If you use Instagram hashtag feeds, you can set hashtag image as featured image.
Feed Display Type. Select the pagination style.
Pagination. Uses standard pagination with “next” and “previous” buttons with the styles set in corresponding theme.
Load More. Loads specified number of images with Load More button. You can specify the number of image for further loads.
Infinite Scroll. Uses Instagram standard. Images are being loaded as you scroll.
Sort Images By. Choosing sorting option for the feed.
Date- based on the date when images are uploaded to Instagram 
Likes- number of Instagram likes
Comments- number of Instagram comments
Random- randomizes displayed Instagram images.
Order By. Choose between ascending and descending options.
Follow on Instagram Button. Choose whether to display follow button next to Instagram usernames or not.

Display Header. Displays featured Instagram image and feed title.
Number of Photos to Display. Define the number of Instagram images which will be displayed before using loading/pagination options.
Number of Photos to Load. Define the number of images which will be displayed with each Instagram Feed load/page.
Number of Columns. Set a default number of image columns.
Resort After Loading New Images(Load More and Infinite Scroll only). If this option is disabled, only newly loaded images will be sorted according to the value of Sort Images By field. If enabled, both newly loaded and already shown images will be resorted together. 
Show Likes. Choose whether to display the number of Instagram likes or not.
Show Description. Check to display image descriptions.
Show Comments. Check to display image Instagram comments.
Show User info. Check to display a block with Instagram user information (username, profile image, etc.).
Display User Bio. Check to display Instagram account-related bio.
Display User Posts and Followers count. Check to display the number of Instagram posts and follower for each used Instagram account. 
Disable Mobile Layout. If you disable mobile layout the images will be displayed with defined number of columns regardless of the device in use. Otherwise the feed column number will be decreased for the smaller screen devices.
Image Onclick. Select the action type when hitting the Instagram image. It can be redirected to Instagram or opened with a lightbox. 

= Blog Style Layout =
Blog style layout is perfect options if you want to post in Instagram and repost the content to WordPress website as a photo blog. The images get displayed with larger dimension with their captions, descriptions and Instagram hashtags below.
Feed Name. Provide a title for the Instagram feed. It will be useful to provide unique title since you will need it when inserting the feed within a page or post.
Theme. Select one of the existing themes for the feed. All theme styling parameters will be applied.
Feed Usernames and Hashtags. Provide all Instagram usernames and Instagram hashtags you want to use within the feed. All all them using add button. Usernames should be provided within the following format: “webdorado”, whereas for hashtags you need to use the following format: #webdorado.
Featured Image. One of the Instagram user avatars can be used as a featured image, select the relevant user in case you have more than one image. If you use hashtag feeds, you can set hashtag image as featured image.
Feed Display Type. Select the pagination style. 
Pagination. Uses standard pagination with the styles set in corresponding theme.   
Load More. Loads specified number of images with Load More button. You can specify the number of images for further loads.   
Infinite Scroll. Uses Instagram standard. Images gets loaded as you scroll.    
Sort Images By. Choosing sorting option for the feed.  
Date- based on the date when images are uploaded to Instagram     
Likes- number of Instagram likes  
Comments- number of Instagram comments    
Random- randomizes displayed Instagram images.   
Order By. Choose between ascending and descending options.   
Follow on Instagram Button. Choose whether to display follow button next to Instagram usernames or not.   
Display Header. Displays featured image and feed title.   
Number of Photos to Display. Define the number of images which will be displayed before using loading/pagination options.   
Number of Photos to Load. Define the number of images which will be displayed with each load/page.    
Resort After Loading New Images (Load More and Infinite Scroll only). If this option is disabled, only newly loaded images will be sorted according to the value of Sort Images By field. If enabled, both newly loaded and already shown images will be resorted together.    
Show Likes. Choose whether to display the number of Instagram likes or not.     
Show Description. Check to display image descriptions.    
Show Comments. Check to display Instagram image comments.    
Show User info. Check to display a block with Instagram user information (username, profile image, etc.).   
Display User Bio. Check to display Instagram account-related bio.   
Display User Posts and Followers count. Check to display the number of Instagram posts and follower for each used Instagram account.     
Image Onclick. Select the action type when hitting the image. It can be redirected to Instagram or opened with a lightbox.   

= Image Browser =
Image Browser displays a single large Instagram image with navigation buttons. You can display image properties below or above the image.

Feed Name.Provide a title for the Instagram feed. It will be useful to provide unique title since you will need it when inserting the feed within a page or post.
Theme. Select one of the existing themes for the Instagram feed. All theme styling parameters will be applied.
Feed Usernames and Hashtags. Provide all Instagram usernames and Instagram hashtags you want to use within the feed. All all them using add button. Usernames should be provided within the following format: “webdorado”, whereas for hashtags you need to use the following format: #webdorado.
Featured Image. One of the Instagram user avatars can be used as a featured image, select the relevant Instagram user in case you have more than one image.If you use hashtag feeds, you can set hashtag image as featured image.
Sort Images By. Choosing sorting option for the feed.
Date- based on the date when images are uploaded to Instagram 
Likes- number of Instagram likes
Comments- number of Instagram comments
Random- randomizes displayed Instagram images.
Order By. Choose between ascending and descending options.
Follow on Instagram Button. Choose whether to display follow button next to Instagram usernames or not.

Display Header. Displays featured image and feed title.
Number of Images To Preload. Define the number of images which will be preloaded for this view.
Number of Images To Load Each Time. Define the number of images to be loaded after the first load.
Show Likes. Choose whether to display the number of Instagram likes or not.
Show Description. Check to display image descriptions.
Show Comments. Check to display image Instagram comments.
Show User info. Check to display a block with Instagram user information (username, profile image, etc.).
Display User Bio. Check to display Instagram account-related bio.
Display User Posts and Followers count. Check to display the number of Instagram posts and follower for each used Instagram account. 
Image Onclick. Select the action type when hitting the image. It can be redirected to Instagram or opened with a lightbox. 

= Lightbox Settings =
Note: Lightbox shows only already loaded images. For viewing entire Instagram Feed, you need to load all images included within the Instagram Feed.

Full width lightbox. Check to enable full width button.
Lightbox Width. Set the lightbox width. Note that it will be used for the entire display, thus when you press to view the comment image will be resized to fit this width.
Lightbox Height. Set the lightbox height.
Lightbox Effect. Select a lightbox slide transition effect. Each lightbox can use only one effect. Or choose random to display random effect for every transition.
Lightbox autoplay. Choose whether use slideshow autoplay or not. If you decide not to use, you can instead set up control buttons.
Time Interval. Define the time interval between each slide when autoplay is turned on.
Enable filmstrip in lightbox. Choose whether to enable filmstrip within the lightbox or not. Filmstrip alignment and styling can be edited in Themes section.
Filmstrip size. Define the filmstrip height/width (depending whether you have horizontal or vertical view, the stated dimension will be applied to one property only).
Show Next / Previous Buttons. Choose whether to display Next/Previous buttons for the slideshow or not.
Display info by default. Choose whether to display image/video caption and author profile by default or not.
Full width info. Enable the option to display image/video information within entire width of the lightbox otherwise it will be displayed based on the image container width. 
Enable Loop. When loop is enabled the user the slideshow will continue to the first image/video when pressing Next button.
Enable Right Click Protection. When enabled user will not be able to Save images or videos using Right-click and pressing Save as button.
Enable control buttons. Enable to display Play,Full Width, Instagram Comments and other buttons within lightbox.
Enable info button. Enable to allow the user to read image metadata (caption and hashtags) when clicking on the button.
Enable fullscreen. Enable button to display Instagram images in fullscreen mode.
Enable comments. Enable a button to show or hide Instagram comments. 
Enable Original Image Display Button. Shows a link to the original Instagram post opened in the new window.
Enable Download Button. Enable direct image/video download from lightbox.
Enable Share Buttons. Enable social sharing buttons (Google+, Twitter, Facebook, Pinterest).

= Publishing in a Page/Post =
To use the created Instagram feeds within a page or post you should use shortcode. Open the page/post from the back end. Press on the Add Instagram Feed button within the editor. Then select the Instagram feed and press Insert button.

An alternative will be copying the shortcode from Instagram Feed WD> Feeds toolbar and pasting it within post/page.

= Publishing as a Widget =
Go to Appearance > Widgets toolbar.

Find Instagram Feed WD widget and assign it to a custom widget position. Fill in the details below:

Title. Provide a title for your Instagram Feed.
Feed. Select the Instagram feed which will be displayed as a widget.
Number of Columns. Set the number of Instagram image columns (for thumbnail and masonry view).
Number of images to display. Set a constant number of Instagram images which will be displayed with widget.
Show Likes and Comments. Check the box to display Instagram likes and comments below view thumbnails.

= Publishing by PHP function =
It is also possible to insert the created  Instagram feeds into the theme by calling it with PHP function. This feature is commonly used for adding the code to header.php for displaying Instagram feeds within header or footer position of the website. You can find the function located in Instagram Feed>Feeds section under PHP function column.


= Styling with Themes =
By default Instagram Feed WD comes with two default themes- Instagram and Elegant. You can use one of them or create your own theme. Newly created theme will be based on Default theme.

General. Here you can add an Instagram theme title, change feed container and feed wrapper colors and styles.
Feed Header. Edit styling of feed header(Instagram feed title and Instagram feed thumbnail)
User data. Edit colors and styles of elements in Instagram users/hashtags section: Instagram usernames, profile images, bio text, number of posts and followers, follow button.
Pagination. Change Load More button and Next/Previous button colors and styles. This does not apply to Instagram-like infinite load.
Thumbnails. Edit standard Instagram thumbnail styles, Instagram image wrapper styles, image metadata styles, Instagram comments and likes styles. 
Masonry. Edit masonry view thumbnail styles, Instagram image wrapper styles, image metadata styles, Instagram comments and likes styles.
Blog Style. Change blog view thumbnail and wrapper styles, Instagram image caption colors, comments and likes styles.
Image Browser. Change Image Browser image and wrapper styles, Instagram image caption colors, comments and likes styles.

= Advanced customizing options =
Instagram Feed WD comes with detailed themes section, but if you want to make specific style changes you can also use
Custom CSS field located in Instagram Feed> Settings.
Custom Javascript can be found within the same location of Instagram WD.

A Custom Javascript event is available for scripts to run after all Instagram feed images are loaded.
Suppose you have feed with thumbnails view and besides displaying your feed you want to open up captions for some photos. You can achieve this by assigning our custom wdi_feed_loaded event to feed container and set callback function for that event.
Here is quick example how to open up captions for images with 0,1,2,3 indexes.
jQuery('#wdi_feed_0').on('wdi_feed_loaded',function(){
    jQuery('.wdi_photo_title').eq(0).trigger('click');
    jQuery('.wdi_photo_title').eq(1).trigger('click');
    jQuery('.wdi_photo_title').eq(2).trigger('click');
    jQuery('.wdi_photo_title').eq(3).trigger('click');
  }); 





