=== Flow-Flow Social Streams ===
Contributors: looks_awesome
Donate link: http://looks-awesome.com/
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: instagram feed, facebook feed, embed instagram, instagram widget, instagram gallery
Requires at least: 5.0
Tested up to: 7.0
Stable tag: 5.0.3

Display a mix of custom Facebook feed, Instagram feed, X (Twitter) feed in grid gallery or widget.

== Description ==

Flow-Flow — WordPress Facebook Instagram X (Twitter) Feed Grid Gallery is a multipurpose **social media wall** plugin that allows to display a mix of social media feeds in beautiful responsive galleries and widgets. Embedding user generated content (UGC) from multiple sources is a great way to add social proof to your WordPress website and increase your brand presence and boost your conversions. User behavior researches show that over 70% users won’t buy from you if you don’t have reviews or social proof of any kind.

[Check out PRO demo](https://social-streams.com/flow/demo/ "Flow-Flow PRO Demo")

= Features =

* 3 social networks in Lite version: Facebook, Instagram, X (Twitter)
* Smart caching
* AJAX loading and PageSpeed optimized
* User-friendly admin
* Easy one-click API authentication for Instagram and Facebook
* Fast CSS3 transitions and animations
* Hardware accelerated CSS3 3D Transforms
* Smart loading assets
* Optimized for any screen sizes and Touch Devices
* Responsive layout and advanced responsiveness settings
* Social media counters like comments, likes, views
* Sharing buttons to increase user engagement
* Rich design settings
* Networks sorting and search bar on top of your stream
* Loading more posts to grid via AJAX
* Exclude posts by words, usernames or URLs
* Drag & Drop grid card builder
* Powerful plugin extensions
* Translate ready
* Multisite compatible
* Well documented

All extensions are compatible and work with Lite edition of Flow-Flow. [Learn more](http://docs.social-streams.com/article/44-install-flow-wp-extensions "Learn more")

Looking for other sources like other social networks, WordPress posts and RSS? More sources and tons of fantastic features are available in PRO version! [Check out comparison table](https://social-streams.com/flow/#pricing "Flow-Flow Pricing")

= PRO version features =
* More sources to stream. In total 14 networks including Google+, YouTube, LinkedIn, Tumblr, Soundcloud, Vine, Dribbble, Flickr and others + WordPress posts and RSS feeds. [Full list of sources](https://social-streams.com/flow/#socialfeeds "Flow-Flow Social Feeds")
* Fast professional support for premium users
* Additional stream layouts: boxed/justified galleries, fixed-height grid
* Smart & beautiful lightbox with comments for Facebook, Instagram, Youtube. Classic popup and infinite feed. Available on mobiles also
* Pre-moderation posts approval system
* Filters for feeds (include and exclude only by words, usernames, URLs)
* Lightbox galleries for multi image post
* Networks sorting and search bar on top of your stream
* Database snapshots

Upgrade to PRO! [Check out comparison table](https://social-streams.com/flow/#pricing "Flow-Flow Pricing")

= Performance and Security =

Smart caching with server task allows to deliver content blazingly fast without long page loading. It's especially crucial when many networks are pulled or you have big traffic. It's great to use this plugin for streaming your news, photos, reviews and any other content you can imagine!

Plugin doesn't expose your private details (like tokens, app IDs and app secrets) to browser so we provide 100% security for any sensitive data.

= How it works =

You create streams in Flow-Flow WordPress Social Stream admin and copy generated shortcodes. Then you put these shortcodes in any block on any page of your site. When social stream is shown first time, it's got cached (takes more time for initial caching but then it will show blazingly fast) and rest of visitors see this cache for cache lifetime. So for example if you have set 20 min cache and 10000 users visit your site within these 20 min, it's **only one time** plugin will request API to pull data, for the rest of time users will see cached data almost instantly. Considering that server runs cache renew task in background it guarantees plugin's amazing performance.

Looking for even more? More sources and tons of fantastic features are available in PRO version! [Check out Live demo](https://social-streams.com/flow/demo/ "Flow-Flow Pro Demo")

== Installation ==

**This section describes how to install the plugin and get it working**


= Automatic installation =

To do an automatic install of Flow-Flow, log in to your WordPress dashboard, navigate to the Plugins menu and click Add New.

In the search field type "Flow-Flow" and click Search Plugins. Once you have found it you can install it by simply clicking "Install Now".


= Manual installation =

**Uploading via WordPress Dashboard**

1. Download `flow-flow-social-streams.zip`
2. Navigate to the 'Add New' in the plugins dashboard
3. Navigate to the 'Upload' area
4. Select `flow-flow-social-streams.zip` from your computer
5. Click 'Install Now'
6. Activate the plugin in the Plugin dashboard

**Using FTP**

1. Download `flow-flow-social-streams.zip`
2. Extract the `flow-flow-social-streams` directory to your computer
3. Upload the `flow-flow-social-streams` directory to the `/wp-content/plugins/` directory
4. Activate the plugin in the Plugin dashboard

The WordPress codex contains [instructions on how to install a WordPress plugin](http://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation).


= Updating =

You can use automatic update to update the plugin safely.


== Frequently Asked Questions ==

= Where I can find documentation? =
Please find Flow-Flow knowledge base [here](http://docs.social-streams.com/).

= Where I can find settings? =
Settings are located in WP Admin on first-level, look for Social Apps and then Flow-Flow submenu item.

= Can I use Flow-Flow extensions with Lite version? =
Yes, you can! If you have a purchased license of any extension, you can extend your Flow-Flow Social Stream with advanced features without purchasing Flow-Flow PRO. [Learn more](http://docs.social-streams.com/article/44-install-flow-wp-extensions "Learn more")

= Do you provide support? =
Flow-Flow Lite edition is distributed "as is" and doesn't contain support services. However it can be our good will to help you. Please, be advised that fast and premium support is provided with Pro version only.


== Screenshots ==

1. Social stream on site page

2. Plugin Admin page

3. Stream stylings tab

4. Adding source popup

== Changelog ==

= Version 5.0.3 =
* Fix: Feeds updating

= Version 5.0.2 =
* Fix: Minor bug fixes, PHP 8 compatibility improvements, and security hardening
* Improvement: Better UX and performance improvements

= Version 4.7.5 =
* Change: Instagram API updates

= Version 4.7.4 =
* Change: WP 6.4 and PHP 8 support tweaks

= Version 4.7.3 =
* Fix: For FB post links

= Version 4.7.2 =
* Change: For FB new API logic using page tokens

= Version 4.7.1 =
* Change: For IG feeds #100 error

= Version 4.7.0 =
* Change: WP 6.1 and PHP 8 support tweaks

= Version 4.6.26 =
* Change: WP 6.0 support

= Version 4.6.25 =
* Change: WP 5.9 support

= Version 4.6.24 =
* Change: Texts & wordings

= Version 4.6.23 =
* Change: WP 5.8 support

= Version 4.6.22 =
* Change: Improvement for outputting PHP content

= Version 4.6.21 =
* Change: Alt text for images

= Version 4.6.20 =
* Change: WP 5.7 compatibility

= Version 4.6.19 =
* Change: PHP 8 warning fixed
* Change: accessibility tweak

= Version 4.6.18 =
* Change: rating link fixed
* Change: removed debug code

= Version 4.6.17 =
* Change: removed legacy code

= Version 4.6.16 =
* Fix: browser caching

= Version 4.6.15 =
* Change: better compatibility with JS minifiers of cache plugins
* Change: removed deprecated jQuery in admin.js

= Version 4.6.14 =
* Change: added checking for existing jQuery plugins

= Version 4.6.13 =
* Change: removing deprecated jQuery
* Fix: Layout setting and not intended displaying

= Version 4.6.12 =
* Fix: Lightbox setting and not intended displaying
* Fix: Sorting setting and not intended displaying

= Version 4.6.11 =
* Fix: Instagram carousel images in hashtag feeds

= Version 4.6.10 =
* Change: Deactivation fix

= Version 4.6.9 =
* Update: Official Instagram API support
* Feature: BOOSTS cloud service
* Change: Grid design and performance improvements
* Change: Admin page design and performance improvements

= Version 3.1.66 =
* Change: Code cleanup

= Version 3.1.65 =
* Change: WP supported versions updated

= Version 3.1.64 =
* Change: PHP error catch handler

= Version 3.1.63 =
* Change: PHP notices removal

= Version 3.1.62 =
* Change: Admin links

= Version 3.1.61 =
* Change: API update for Instagram login

= Version 3.1.60 =
* Change: Admin text

= Version 3.1.59 =
* Change: Minor CSS tweaks

= Version 3.1.58 =
* Change: Minor CSS changes

= Version 3.1.57 =
* Change: Minor CSS changes

= Version 3.1.56 =
* Change: CSS tweak

= Version 3.1.55 =
* Change: Facebook API change

= Version 3.1.54 =
* Change: CSS tweak

= Version 3.1.53 =
* Change: Redundant CSS removal

= Version 3.1.52 =
* Change: Renamed Facebook group feed to Page with restrictions feed

= Version 3.1.51 =
* Change: Facebook groups feed

= Version 3.1.50 =
* Change: Small change for compliance with PHP 7.4

= Version 3.1.49 =
* Change: Google+ removal

= Version 3.1.48 =
* Change: CSS tweaks

= Version 3.1.47 =
* Change: Redundant CSS

= Version 3.1.46 =
* Change: Code timestamps updated

= Version 3.1.45 =
* Change: Redundant CSS

= Version 3.1.44 =
* Change: Public page CSS

= Version 3.1.43 =
* Change: Admin page CSS

= Version 3.1.42 =
* Change: Admin page CSS

= Version 3.1.41 =
* Change: PHP minumum version to 5.6.20

= Version 3.1.40 =
* Change: Session folder correct path

= Version 3.1.39 =
* Change: Feeds Boost URL

= Version 3.1.38 =
* Change: Admin Subscription URL

= Version 3.1.37 =
* Change: Error handling

= Version 3.1.36 =
* Change: CSS optimization

= Version 3.1.35 =
* Change: Redundant CSS removal

= Version 3.1.34 =
* Change: CSS optimization

= Version 3.1.33 =
* Change: Admin text edit

= Version 3.1.32 =
* Change: Redundant CSS removal

= Version 3.1.31 =
* Change: Version fix

= Version 3.1.30 =
* Change: Plugin description

= Version 3.1.29 =
* Change: Deactivation popup

= Version 3.1.28 =
* Change: Code formatting

= Version 3.1.27 =
* Change: Error handling

= Version 3.1.26 =
* Change: Admin text

= Version 3.1.25 =
* Change: Deactivation popup improvement

= Version 3.1.24 =
* Change: Instagram authorization flow

= Version 3.1.23 =
* Change: cUrl installation guide URL

= Version 3.1.22 =
* Change: Facebook API update for multiphoto posts

= Version 3.1.21 =
* Change: Debug file added

= Version 3.1.20 =
* Change: Facebook code tweak

= Version 3.1.19 =
* Change: Support email title

= Version 3.1.18 =
* Change: FAQ address update

= Version 3.1.17 =
* Change: code comments

= Version 3.1.16 =
* Change: Update for Facebook Graph API version (credit to @responsemf and @vlaios users)

= Version 3.1.15 =
* Change: Cron event name

= Version 3.1.14 =
* Change: Requirement message

= Version 3.1.13 =
* Change: Instagram API constants

= Version 3.1.12 =
* Change: update for Instagram comments changes

= Version 3.1.11 =
* Change: admin tooltip

= Version 3.1.10 =
* Change: admin CSS

= Version 3.1.9 =
* Change: sorting function preparation

= Version 3.1.8 =
* Change: Pinterest profile image fix

= Version 3.1.7 =
* Change: Log file destination variable

= Version 3.1.6 =
* Change: suggestions tab removed from lite version

= Version 3.1.5 =
* Change: Pinterest user feeds removed (API retired)

= Version 3.1.4 =
* Change: Fix for Instagram hashtags with special symbols

= Version 3.1.3 =
* Change: new Facebook app, please regenerate token in auth settings

= Version 3.1.2 =
* Change: correct version & code formatting

= Version 3.1.1 =
* Change: admin CSS

= Version 3.1.0 =
* Change: Required PHP version changed to 5.6+

= Version 3.0.99 =
* Change: Composer constant added

= Version 3.0.98 =
* Change: WordPress 5.1 support

= Version 3.0.97 =
* Change: default database encoding
* Change: fixed compatibility of lite version with advertising addon

= Version 3.0.96 =
* Change: code typos

= Version 3.0.95 =
* Change: Removed warning for Composer constant already defined

= Version 3.0.94 =
* Change: Additional accessibility improvements

= Version 3.0.93 =
* Change: Some accessibility improvements

= Version 3.0.92 =
* Change: Composer variable added

= Version 3.0.91 =
* Change: API library update

= Version 3.0.90 =
* Change: fix for empty feeds case

= Version 3.0.89 =
* Change: some code formatting

= Version 3.0.88 =
* Change: update for Instagram API changes and location feeds

= Version 3.0.87 =
* Change: admin JS small change

= Version 3.0.86 =
* Change: Instagram API wrapper small tweak

= Version 3.0.85 =
* Change: admin JS small optimization

= Version 3.0.84 =
* Change: admin links

= Version 3.0.83 =
* Fix: Deactivation popup

= Version 3.0.82 =
* Fix: With browser cache and streams not loading on page refresh (clear browser cache after update)

= Version 3.0.81 =
* Support: Wordpress 5.0

= Version 3.0.80 =
* Fix: JS code for Load more

= Version 3.0.79 =
* Fix: Code typo

= Version 3.0.78 =
* Change: PHP notice removal

= Version 3.0.77 =
* Fix: for feeds creation

= Version 3.0.76 =
* Change: Fix for stream preview

= Version 3.0.75 =
* Change: Fix for stream setting saving

= Version 3.0.74 =
* Change: Further improving of security and sanitization

= Version 3.0.73 =
* Change: Further improving of security and sanitization

= Version 3.0.72 =
* Change: Improved security and sanitization

= Version 3.0.71 =
* Change: 'Data too long' error

= Version 3.0.70 =
* Change: composer warnings

= Version 3.0.69 =
* Change: admin JS small change

= Version 3.0.68 =
* Change: fixed JS errors

= Version 3.0.67 =
* Change: removed console logs

= Version 3.0.66 =
* Change: pro demo links

= Version 3.0.65 =
* Change: JS fix

= Version 3.0.64 =
* Change: demo links

= Version 3.0.63 =
* Change: redundant code removal

= Version 3.0.62 =
* Fix: deactivation hook

= Version 3.0.61 =
* Fix: for broken build 3.0.60

= Version 3.0.60 =
* Change: Revert broken changes in 3.0.59

= Version 3.0.59 =
* Change: IE 8 support removed

= Version 3.0.58 =
* Change: Rendering shortcode logic adjustments

= Version 3.0.57 =
* Change: Render shortcode logic to remove issue with not displaying streams in some themes

= Version 3.0.56 =
* Change: AJAX URL setup

= Version 3.0.55 =
* Fix: small CSS fix

= Version 3.0.54 =
* Change: Reverting double ampersand fix because it caused more issues than it solved

= Version 3.0.53 =
* Change: Comments icon CSS

= Version 3.0.52 =
* Change: Removed mentioning of Stacks plugin in admin

= Version 3.0.51 =
* Change: Admin links

= Version 3.0.50 =
* Change: Facebook authorization and preparation for August 1, 2018 changes

= Version 3.0.48 =
* Tweak: Cron intervals labels

= Version 3.0.47 =
* Tweak: admin email validation in PRO

= Version 3.0.46 =
* Tweak: For rare usecase when WP parser has issues with including double ampersand

= Version 3.0.45 =
* Fix: Admin stream preview on stream creation

= Version 3.0.44 =
* Fix: Admin error message wording

= Version 3.0.43 =
* Change: JS code update for compatibility with particular AMD modules realization

= Version 3.0.42 =
* Change: removal of Facebook group feed due to Facebook API changes

= Version 3.0.41 =
* Change: card builder defaults

= Version 3.0.40 =
* Fix: For Instagram hashtags

= Version 3.0.39 =
* Fix: Requirement went from PHP 5.3 to 5.4

= Version 3.0.38 =
* Fix: For migration

= Version 3.0.37 =
* Fix: For 'Media with given code does not exist' error

= Version 3.0.36 =
* Update: Fix for previous version

= Version 3.0.35 =
* Update: New Instagram changes

= Version 3.0.34 =
* Update: Further Instagram integration

= Version 3.0.33 =
* Update: Instagram empty user feeds

= Version 3.0.32 =
* Change: Facebook groups support dropped due to API changes

= Version 3.0.31 =
* Change: intergration of 4th April Instagram API changes

= Version 3.0.30 =
* Change: re-upload latest version

= Version 3.0.29 =
* Change: admin settings defaults

= Version 3.0.28 =
* Fix: posts proportional sorting

= Version 3.0.27 =
* Fix: compat with other custom Cron intervals

= Version 3.0.26 =
* Fix: removed redundant PHP dependency

= Version 3.0.25 =
* Fix: removed PHP notices in admin

= Version 3.0.24 =
* Fix: for previous change

= Version 3.0.23 =
* Fix: for cached media URLs

= Version 3.0.22 =
* Fix: for previous change smart_order

= Version 3.0.21 =
* Fix: proportional sorting

= Version 3.0.20 =
* Fix: error messages can break admin in some cases

= Version 3.0.19 =
* Fix: admin CSS errors

= Version 3.0.18 =
* Tweak: redundant CSS removal

= Version 3.0.17 =
* Fix: likes and comments count updating in cards

= Version 3.0.16 =
* Tweak: cache building

= Version 3.0.15 =
* Tweak: cache building

= Version 3.0.14 =
* Tweak: public side CSS

= Version 3.0.13 =
* Tweak: stream defaults

= Version 3.0.12 =
* Tweak: admin tooltips

= Version 3.0.11 =
* Fix: empty feeds list style

= Version 3.0.10 =
* Fix: tab state saving in admin

= Version 3.0.9 =
* Tweak: loading animation

= Version 3.0.8 =
* Admin: other products description

= Version 3.0.7 =
* Fix: for admin notifications

= Version 3.0.6 =
* Tweak: admin hints

= Version 3.0.5 =
* Fix: premium add-ons support

= Version 3.0.4 =
* Fix: Plugin page link in admin

= Version 3.0.3 =
* Fix: JS error in IE browsers

= Version 3.0.2 =
* Fix: deactivation on multisites setup

= Version 3.0.1 =
* Tweak: admin CSS small optimization

= Version 3.0.0 =
* Feature: Social activity counters
* Feature: Drag&Drop card editor with live preview
* Feature: Various responsive settings and mobile improvements
* Design: Cards, filters, UI elements of stream were reinvented and redesigned
* Improvement: New shiny toolbar with improved design of social sharing tooltip and buttons

= Version 2.1.6 =
* Change: symbol used for filtering by URL part

= Version 2.1.5 =
* Tweak: admin code small optimization

= Version 2.1.4 =
* Tweak: code preparation for version 3

= Version 2.1.3 =
* Tweak: admin code for saving settings

= Version 2.1.2 =
* Tweak: Updated code for refreshing Facebook token

= Version 2.1.1 =
* Added: Support team member is added as contributor in readme.txt

= Version 2.1.0 =
* Added: Deactivation actions to collect users feedback

= Version 2.0.8 =
* Added: small admin performance tweak

= Version 2.0.7 =
* Added: global variable for posts cached in db

= Version 2.0.6 =
* Tweak: removed debug code from production

= Version 2.0.5 =
* Tweak: Now disabling scroll event when revealing animation is turned off

= Version 2.0.4 =
* Fix: Admin page stream tabs can fail to work in some usecases

= Version 2.0.3 =
* Fix: Admin page code for saving some settings

= Version 2.0.2 =
* Fix: Images support for Facebook status posts

= Version 2.0.1 =
* Fix: Error messages that can break admin page in earlier versions

= Version 2.0.0 =
* Feature: Reset cache for feed
* Feature: Enabling/disabling feeds
* Improvement: Reworked how streams and feeds work and connect
* Improvement: Cache populating and performance
* Improvement: Better Admin UI
* Improvement: Front-end performance and CPU usage

= Version 1.1.3 =
* Updated documentation links

= Version 1.1.2 =
* Fix for typo in code causing issue in Facebook authorization

= Version 1.1.1 =
* Fix for getting Facebook tokens

= Version 1.1.0 =
* Updated for new Facebook API tokens

= Version 1.0.5 =
* Admin link to pro version updated

= Version 1.0.4 =
* Fix for previously broken plugin slug (again)

= Version 1.0.3 =
* Pinterest added

= Version 1.0.2 =
* Fix for settings slug name that prevents creating/editing streams

= Version 1.0.1 =
* Fix for plugin slug that prevents 1.0.0 from functioning

= Version 1.0.0 =
* initial release