=== Spotlight Social Media Feeds ===

Contributors: RebelCode, spotlightsocialfeeds, markzahra, Mekku, jeangalea
Plugin URI: https://spotlightwp.com
Tags: Instagram, Instagram feed, Instagram feeds, Instagram widget, Instagram embed, social media, social media feed, social media feeds, Instagram posts, Instagram gallery, Instagram stories, hashtag
Requires at least: 5.0
Requires PHP: 7.1
Tested up to: 5.7
Stable tag: 0.6.1
License: GPLv3

Instagram feeds for your WordPress site. A simple no-code solution to connect your Instagram account, design responsive feeds, and embed them anywhere you want.

== Description ==

**Embed your [Instagram](https://www.instagram.com/) feed anywhere on your website.** Connect your Instagram account and design unlimited photo and video galleries to embed across your website. A simple no-code solution to sharing your Instagram content with the world in a beautiful gallery.

[**Spotlight Instagram Demos**](https://spotlightwp.com/demo/?utm_source=readme&utm_medium=readme_desc&utm_campaign=readme_desc_topdemos) | [Compare Free vs PRO](https://spotlightwp.com/features/compare-free-vs-pro/?utm_source=readme&utm_medium=readme_desc&utm_campaign=readme_desc_topcomparecta) | [Spotlight PRO](https://spotlightwp.com/pricing/?utm_source=readme&utm_medium=readme_desc&utm_campaign=readme_desc_topbuypro)

== Embed your Instagram feed in under 2 minutes ==

Follow **3 simple steps** from start to finish:

1. Connect your [Instagram](https://www.instagram.com/) account.
2. Design your Instagram feed's look.
3. Add it to any **page, sidebar, footer, post, etc**.

No coding or complex shortcodes required. Check out the 2-minute video below for a quick overview of how to embed your Instagram feed on any WordPress site.

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

== Free Features ==

- Connect one or **multiple Instagram accounts**.
- Combine multiple Instagram accounts in a single gallery.
- Create **unlimited Instagram feeds** to use across your site.
- **Grid layout** with various design options.
- **Customise the design**, including padding and font sizes.
- **Order Instagram posts** by date, popularity, or at random.
- Change the **number of columns** in the feed.
- Change the **number of Instagram posts** shown in the feed.
- Change the **size of the Instagram feed** or have it to automatically take up any area it is embedded into.
- **Popup lightbox** on click to display full-size photos and playable videos directly on your website.
- **Feed header** with your Instagram account's avatar and bio.
- Add a **custom bio text and profile photo** per account or feed.
- Set custom text and colours for the **“Follow” button**.
- Set custom text and colours for the **“Load More” button**.
- Show or hide the feed header, "Follow" button", and "Load More" button.
- Applies your theme's fonts and styles to blend in automatically.
- 100% **responsive** Instagram feed, customisable per device.
- **Embed Instagram feeds on any page, post, footer or sidebar** using our Instagram block, widget and shortcode.

**PLUS: Live interactive preview** to see exactly what you're designing before embedding it anywhere on your site.

**Agencies and Developers**: Spotlight provides an [Access Token Generator](https://spotlightwp.com/access-token-generator/) so clients won't need to share Instagram login details.

== Why Instagram Feeds? Top 3 Benefits: ==

**1. Create Connections and Increase Engagement**
Boost social engagement on your website and increase your Instagram follower count. Add a "Follow on Instagram" button to your Instagram feed to turn site visitors into followers.

**2. Add Social Proof**
Instagram is a great platform for building relationships. Make the most of it by sharing your existing Instagram photos, videos, likes and comments with website visitors. Instant social proof in minutes.

**3. A Time-Saver!**
As you post new photos and videos to Instagram, Spotlight displays them on your website. Keep your site content looking fresh and updated by simply posting new content once to Instagram.

**BONUS: Enhance your "Coming soon" and "Maintenance" Pages**
Make your "Coming Soon" and "Maintenance" pages stand out by embedding an Instagram feed. Turn those otherwise lost site visitors into Instagram followers to **generate new leads**.

== Why Choose Spotlight Instagram Feeds? ==

**1. Easy to Use**
From connecting your first Instagram account to displaying an Instagram feed on your website in under 2 minutes.

**2. Fun to Set Up**
A simple live preview customiser to see all the changes you make right in your dashboard. Forget setting up Instagram feeds using complex shortcodes or long lists of settings before even seeing the result. Simply point and click.

**3. Fast and Helpful Support**
Spotlight is designed, developed and supported by Mark, Miguel and Gaby. We provide support for both the free and PRO versions of Spotlight and develop new features on a monthly basis. Whenever you have a question, we're here for you.

- [Documentation](https://docs.spotlightwp.com/)
- [Free support (forum)](https://wordpress.org/support/plugin/spotlight-social-photo-feeds/)
- [Premium support (email)](https://spotlightwp.com/support/?utm_source=readme&utm_medium=readme_desc&utm_campaign=readme_desc_support)

== PRO Features ==

Level up your Instagram feeds with **[Spotlight PRO](https://spotlightwp.com/pricing/?utm_source=readme&utm_medium=readme_desc&utm_campaign=readme_desc_upgrade)**. More layouts, new customisation options, engaging **hashtag feeds**, **filtering** and **moderation**, **shoppable Instagram feeds**, and much more.

[**Buy Spotlight PRO**](https://spotlightwp.com/pricing/?utm_source=readme&utm_medium=readme_desc&utm_campaign=readme_desc_upgradebuypro) | [Demos](https://spotlightwp.com/demo/?utm_source=readme&utm_medium=readme_desc&utm_campaign=readme_desc_upgradedemos) | [Compare Free vs PRO](https://spotlightwp.com/features/compare-free-vs-pro/?utm_source=readme&utm_medium=readme_desc&utm_campaign=readme_desc_upgradecomparecta)

Here's a look at some of the PRO features currently available:

- Hashtag feeds - most popular/recent from across Instagram
- Tagged post feeds - show where your account is tagged
- Caption filtering
- Hashtag filtering
- Visual moderation (hand-pick which posts to show/hide)
- Promote: link to posts, pages, WooCommerce products and more
- Promote: add call-to-actions to your Instagram posts
- Promote: automatically link Instagram posts by hashtag
- Highlight layout
- Masonry layout
- Slider layout
- Hover styles
- Header styles
- Show captions and like & comment counts in the feed
- Embed Instagram stories in the profile photo (just like Instagram)

**BONUS: Elementor Instagram Widget** - Officially Recommended

Watch a full [Spotlight PRO](https://spotlightwp.com/pricing/?utm_source=readme&utm_medium=readme_desc&utm_campaign=readme_desc_upgradevideo) review by WP Crafter:

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

== Testimonials - "The Best Instagram Plugin" ==

Spotlight helps thousands of WordPress site owners add Instagram feeds to their websites. There's a reason many people are switching from other Instagram feed plugins to Spotlight

**Real User Reviews**

- "You don’t need to mess around, **styling is easy and it looks good with minimal effort**. Excellent work!" - [Jennifer Line](https://wordpress.org/support/topic/excellent-plugin-6797/)

- "If you're ready to start nailing the BIG 3 C's of having a website, that is **building credibility, staying current, and having a better connection with your website visitors**, check out Spotlight Instagram feeds today." - [Adam @ WP Crafter](https://wordpress.org/support/topic/the-best-instagram-plugin-3/)

- "I used to struggle with all sorts of crappy Instagram plugins until I found this one! **The customization in unparalleled** and when I stumbled into a weird glitch (because of an error I made) their tech-support help me solve it. Love you guys <3 thank you!" - [Rogue Media Group](https://wordpress.org/support/topic/best-instagram-plugin-service/)

- "**I loved this so much I upgraded to the Pro version.** It was everything I was wishing for for years! Super easy to set up and the documentation is great. Support is also very responsive." - [Espressivo](https://wordpress.org/support/topic/works-great-7476/)

- "This plugin strongly helps me to **increase the interaction on my Instagram account from my website**. I didn’t need to watch 100 tutorials to be able to handle the plugin correctly." - [Michael Kihl](https://wordpress.org/support/topic/the-best-ig-flow/)

- "After fiddling with a couple of other plugin options for IG feeds, **I installed Spotlight and had it working in seconds**." - [Dave Von Bieker](https://wordpress.org/support/topic/clean-modern-design-and-great-support/)

**Recommended By Top Publications**:

- Hubspot: [Top 3 Free Instagram Plugins for WordPress](https://blog.hubspot.com/website/top-free-instagram-plugins-wordpress-site)
- Elementor: [Best Instagram Plugins for WordPress](https://elementor.com/blog/best-instagram-plugins-wordpress/)
- WP Mayor: [How to Import Instagram Photos to WordPress](https://wpmayor.com/import-instagram-photos-wordpress/)
- Kinsta: [WordPress Instagram Plugins](https://kinsta.com/blog/wordpress-instagram-plugin/)
- BobWP: [How to Improve WooCommerce Sales Using Instagram](https://bobwp.com/how-to-improve-woocommerce-sales-using-your-instagram-feed/)
- Avada: [Use Instagram Feeds to Boost Traffic and Conversions](https://theme-fusion.com/how-to-use-instagram-feeds-to-boost-traffic-and-conversions/)
- Elegant Themes: [7 Great Instagram Plugins for Sharing Your Feed](https://www.elegantthemes.com/blog/wordpress/instagram-plugins-for-sharing-your-feed)
- aThemes: [Best WordPress Instagram Plugins 2020](https://athemes.com/collections/best-wordpress-instagram-plugins/)
- WPExplorer: [How to Add Instagram Photos to WordPress](https://www.wpexplorer.com/add-instagram-wordpress/)

== Disclaimer ==

Spotlight Instagram Feeds, also known as Spotlight Social Media Feeds, is a RebelCode product officially verified by Facebook to make use of the official Instagram(tm) API. It is not affiliated with or endorsed by Instagram and/or Facebook.

== Installation ==

= Installation Method 1 =

1. Go to the Plugins page in your WordPress site's dashboard.
2. Click on the "Add New" button.
3. Search for “Spotlight Social Media Feeds”.
4. Click on the "Install" button next to it, then hit "Activate".
5. Go to the “Instagram Feeds” menu item to get started.

= Installation Method 2 =

1. Click on the "Download" button above.
2. Upload the zip file to your site from the Plugins page in your WordPress site's dashboard.
3. Activate the plugin.
4. Go to the “Instagram Feeds” menu item to get started.

= 1. Connect Your Instagram Account =

Follow the instructions on the screen to connect your, or your clients' Instagram account. You may connect multiple Instagram accounts and manage them all from the Instagram Feeds > Settings > Accounts page. More information on how to connect Instagram accounts in Spotlight is provided in our documentation [here](https://docs.spotlightwp.com/category/517-connecting-accounts).

= 2. Design Your Instagram Feed =

Once an Instagram account is connected, go to the Design step and start customising the feed. More information on each design option is provided in our documentation [here](https://docs.spotlightwp.com/category/509-the-editor).

**BONUS**: Spotlight's Instagram feeds are responsive by default, but you can also design your feed per device to make it look just the way you want! More information on Spotlight's responsiveness options are provided in our documentation [here](https://docs.spotlightwp.com/category/516-live-preview).

= 3. Embed Your Instagram Feed =

Spotlight provides three methods to embed your Instagram feed in its free version.

- [Block](https://docs.spotlightwp.com/article/581-block) - "Spotlight Instagram Feed"
- [Widget](https://docs.spotlightwp.com/article/580-widget) - "Spotlight Instagram Feed"
- [Shortcode](https://docs.spotlightwp.com/article/579-shortcode) - [instagram feed="456"]

== Frequently Asked Questions ==

= How do I connect my Instagram account? =

Once you install Spotlight, a welcome screen appears that guides you on how to connect your first Instagram user account. Click on the connect button and it will show you two options, [Personal or Business](https://docs.spotlightwp.com/article/553-what-is-the-difference-between-instagram-personal-and-business-accounts). Pick the one that applies to you, authorise Spotlight through the popup that appears and you’re all set.

- - -

= How many Instagram accounts can I connect? =

Spotlight has no limit on the number of Instagram accounts you may connect. So long as you have legitimate access to those accounts, you can connect them directly through Spotlight or by using an Instagram access token (for developers).

- - -

= Can I display posts from multiple Instagram users in one gallery? =

Yes. With Spotlight you can create feeds that feature photos and videos from multiple Instagram accounts within the same feed. Simply connect the Instagram user accounts you want to display posts from and select them in the "Connect" step of the feed editor in Spotlight.

- - -

= How many feeds can I set up? =

Spotlight sets no limit on the number of feeds you can set up. Design one for your footer, another for the sidebar, and one to fill an entire page - let your imagination run free. You can even show multiple feeds on the same page!

- - -

= Can I display multiple Instagram feeds on the same page or site? =

Yes. With Spotlight you can embed multiple Instagram feeds on a single page, a single post, in widget areas, and across your entire website. There are no limits and each feed can be unique or re-used in multiple places.

- - -

= Can I show full-size photos and play Instagram videos directly on my website? =

Yes, Spotlight's free version includes a lightbox (popup) that will display your photos and playable videos in their full size over your entire website. Keep site visitors exactly where you want them - on your website!

If you want to enhance the popup, [Spotlight PRO adds a sidebar](https://spotlightwp.com/pricing/?utm_source=readme&utm_medium=readme_faq&utm_campaign=readme_faq_fullsizeandvideos) to the lightbox which will display your Instagram captions, comments, published date, and more.

- - -

= Where can I find my Instagram Access Token and User ID? =

Option 1: Use Spotlight's [Access Token Generator](https://spotlightwp.com/access-token-generator/).

Option 2: If your Instagram account is already connected in Spotlight, go to Instagram Feeds > Settings. From the first page, Accounts, click on the Instagram username or the "info" option under Actions.

- - -

= How can I only display posts that use a particular Instagram hashtag? =

With [Spotlight PRO](https://spotlightwp.com/pricing/?utm_source=readme&utm_medium=readme_faq&utm_campaign=readme_faq_hashtag) you can use either of two options.

Firstly, you can choose to display posts that include a specific hashtag from all across Instagram. ([Learn more](https://docs.spotlightwp.com/article/622-how-to-display-hashtag-feeds)).

Secondly, you can use Hashtag filtering to show or hide posts from your connected Instagram account that use a specific hashtag. [Learn more.](https://spotlightwp.com/features/?utm_source=readme&utm_medium=readme_faq&utm_campaign=readme_faq_hashtagfeed)

- - -

= Can I hand-pick specific posts to hide or show in my Instagram feed? =

Yes, we understand that you may have certain posts that you don't want to show on your website. By using the Moderation option in Spotlight PRO you can hand-pick the photos and videos that you either want to show or hide on your website. [Learn more.](https://spotlightwp.com/features/?utm_source=readme&utm_medium=readme_faq&utm_campaign=readme_faq_moderation)

- - -

= Will the Instagram feed from Spotlight blend nicely into my website's theme? =

Yes, aside from the customisation options provided by Spotlight itself, the plugin is also set up to use your theme's fonts to completely match your brand's look and feel on your website.

- - -

= Why is my Instagram feed not showing correctly or at all? =

There are a few reasons that this may happen. We have documented the reasons and solutions [here](https://docs.spotlightwp.com/collection/524-troubleshooting).


== Screenshots ==

1. Embed your Instagram feed using Spotlight.
2. Open photos and playable videos in a popup lightbox.
3. Connect multiple Instagram accounts - Personal and Business.
4. Design your Instagram feed in our live preview customizer.
5. Fully responsive and customisable per device.
6. A hashtag feed using the Highlight layout. [Requires Spotlight Instagram Feeds PRO]
7. Sell WooCommerce products through your Instagram feed. [Requires Spotlight Instagram Feeds PRO]

== Changelog ==

= 0.6.1 (2021-03-04) =

**Changed**
- Now compatible with PHP8

**Fixed**
- An error, caused by curly braces offset access syntax, which is not supported in PHP8.

= 0.6 (2021-03-03) =

**Added**
- New option to duplicate feeds

**Fixed**
- The feed did not load on sites that send CORS preflight requests
- Fixed hashtags without spaces between them becoming a single link
- Undefined index errors during an import or update

= 0.5.4 (2021-02-11) =

**Changed**
- Now detecting a conflict with the official "Facebook for WordPress" plugin

**Fixed**
- Fixed "Argument 1 passed" error when viewing/previewing a feed

= 0.5.3 (2021-02-04) =

**Added**
- Added the ability to clear cache for a single feed only
- Added more tooltips in the editor and improved the wording of existing tooltips
- Added a notification if an error occurs while saving the settings

**Changed**
- The actions in the feeds list are now in a menu
- The feed usages in the feeds list now link to the post on the site, not the edit page
- The sources in the feeds list now link to the account info or hashtag page on Instagram
- The default click behavior on mobile devices is now set to open the popup box
- The admin interface uses the WP Admin color scheme as much as possible
- Better error messages when account connection fails
- The copied info from our access token generator can now be directly pasted into the access token field
- Unavailable images and videos now show a message in the popup box, instead of broken content
- The popup box's size in the preview now matches the device being previewed

**Fixed**
- Image and video URLs were not being renewed, causing broken content when they expire
- Thumbnails are now served using HTTPS is the site is using SSL
- The popup box is no longer too large for mobile devices
- Text in the popup box was too large
- The popup box now prevents the page from scrolling, which used to result in 2 scrollbars
- Extending the execution time during imports to prevent long imports from terminating early
- Fixed incompatibility with plugins that introduced circular references in post type objects
- Fixed an SQL error that occurs when using MySQL version 8.0 or later
- All connected accounts were being included in a feed's context, even if unused in that feed
- Scrollbars would show up in the editor preview, even when there was nothing to scroll

= 0.5.2 (2020-12-17) =

**Added**
- The plugin now checks for required PHP extensions and will show a message if one is missing

**Changed**
- The "Cookie nonce is invalid" error has been changed to highlight that you are not logged in
- Tweaked the scaling of the hover date so that it doesn't overlap with the Instagram icon

**Fixed**
- Fixed an "Invalid argument type" error that occurs during import
- When the feed loads a post with a video in an album, the feed app would crash
- On 32-bit systems, feeds would only show 1 post
- The logo in the block editor is too large when using certain themes
- The onboarding process triggered a feed load twice after connecting the account, resulting in an error
- When navigating away from the editor, the "unsaved changes" prompt did not show up

= 0.5.1 (2020-12-01) =

**Changed**
- Optimized the rendering for the grid layout, resulting in smoother loading animations

**Fixed**
- All posts in the feed would flash when more posts are loaded using the "Load more" button
- When PHP `strict_types` is enabled, a type error occurred while fetching posts from Instagram

= 0.5 (2020-11-17) =

**Added**
- New option in the feeds list to update the Instagram posts for a feed
- The "Show/hide PRO Features" selection is remembered in the browser

**Changed**
- Video thumbnails are generated for non-tagged and non-hashtag posts
- Added a notification when connecting an account using an access token fails
- Duplicate posts, even if fetched for different sources, will no longer be shown in feeds

**Fixed**
- Incompatibility with Kadence plugins caused modal popups to not appear
- Incompatibility with LiteSpeed cache when loading JS when DOM is ready
- Corrupted feed options would cause an error that prevented editing and saving feeds
- Modals no longer cover up toast notifications in the admin app
- Warnings would show up when activating the plugin on a new site
- Cron jobs would not be recreated after their schedule is changed in the settings
- Feed usage in the block editor was not detected and shown in the feeds list
- Duplicate crons would be created when run manually using WP Crontrol

= 0.4.2 (2020-10-30) =

**Changed**
- Various tiny performance optimizations
- The default optimization age limit is now 7 days, down from 30 days
- Increased the quality of generated thumbnails with minimal disk space impact

**Fixed**
- Downloading thumbnails for videos would occasionally cause a fatal error
- Custom post types used by the plugin were not properly registered

= 0.4.1 (2020-10-27) =

**Changed**
- Now using a beacon in the bottom-right of the screen for important plugin-related alerts
- Using paused videos as thumbnails, until a better solution can be found for video thumbnails

**Fixed**
- Thumbnails are now saved locally, after Instagram made an unannounced change to their API
- Thumbnails are resized and automatically and optimally scaled for the screen

= 0.4 (2020-10-26) =

**Changed**
- Greatly improved the loading time for feeds on the site
- All pages are now much more responsive and usable on mobile devices
- Filtering fields will auto-add their typed value when they lose focus
- Improved the message shown in the shortcode when a feed does not exist
- Added redundant WordPress styles to ensure a consistent look and feel

**Fixed**
- Addressed the "Cache key is invalid" entries in the debug log
- Fixed thumbnails not loading due to Instagram deprecating their thumbnails API
- Fixed an error that sometimes prevented feeds from being saved

= 0.3.2 (2020-09-30) =

**Changed**
- The plugin now clarifies whether errors come from Instagram's API or the plugin itself
- Overall performance of the editor has been greatly improved

**Fixed**
- The text size option was showing wrong values for tablets and phones
- Videos did not load and would remain as grey tiles
- The preview did not always reflect changes made to the feed's options

= 0.3.1 (2020-09-16) =

**Fixed**
- The page would not load or crash if an account has no access token expiry date
- The top navigation bar would did not update to indicate the current tab.

= 0.3 (2020-09-16) =

**Added**
- Added a block for the WordPress Gutenberg block editor
- Account information is now updated during media imports

**Changed**
- Now using the WordPress-bundled React, reducing JS file sizes
- Improved the responsiveness of the navbar

**Fixed**
- Fixed an error that caused feeds to break when not logged in

= 0.2.4 (2020-08-21) =

**Fixed**
- Some fields in the Design tab would incorrectly remain disabled
- The app no longer gets stuck on the flashing logo during loading
- Feeds did not work when other plugins encounter errors or raise warnings

= 0.2.3 (2020-08-14) =

**Changed**
- Videos use an Instagram-style video player
- The popup box is now responsive
- Now showing smaller thumbnails in smaller feeds

**Fixed**
- Front-end CSS is now correctly minimized for increased page load speeds
- Fixed app not loading correctly after an update, due to browser caching

= 0.2.2 (2020-07-30) =

**Added**
- Hover info now scales with the size of the media tiles in the layout

**Changed**
- Added reset styles to media in the popup box to improve compatibility with themes
- Improved how media in the popup box gets scaled to better match Instagram's own scaling

**Fixed**
- Media in the popup box would incorrectly have black bars
- Cancelling after clicking the Cancel button disabled the Cancel and Save buttons

= 0.2.1 (2020-07-13) =

**Fixed**
- "Too many IDs" error when a Business account has more than 50 posts

= 0.2 (2020-07-09) =

**Added**
- Freemius integration
- Admin notifications
- New "Tools" section in the settings and an option to clear the API cache
- The live preview shows a message when user options result in no posts being shown in a feed

= 0.1 (2020-06-23) =

Initial version of Spotlight Instagram Feeds.

