=== AX Social Stream ===
Contributors: axentmedia
Tags: social stream, wordpress social plugin, social feed, social tabs, social wall, social timeline, social media, social networks, feed reader, facebook, twitter, tumblr, delicious, pinterest, flickr, instagram, youtube, vimeo, deviantart, rss, soundcloud, vk, vine
Requires at least: 5.1
Tested up to: 6.1.1
Stable tag: 3.9.16
Requires PHP: 7.2.5
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Combine all your social media feeds (Facebook, Twitter, Instagram, Flickr, YouTube, RSS, ...) into one single social stream and display on your website.

== Description ==

AX Social Stream is the best WordPress plugin for those who are looking for an easy way to combine all of their social networking activities into one single social stream and display on their website.

With this plugin you can create a stylish fascinating social media feed including multiple social media pages/groups/accounts with multiple feed options, and can display them in 8 different layouts including Wall, Grid, Carousel, Timeline, Rotating Feed, Sticky Rotating Feed, Ajax Tabbed Feed & Sticky Ajax Tabbed Feed.

You can add as many as public Facebook pages, Twitter accounts or Instagram accounts managed by you or any other publisher.

It supports 14 and growing social networks and includes about 29 feed options.

Your visitors will be able to share your posts on their social accounts or reply, retweet or favorite the Twitter posts from your Social Stream. They can even filter your Social Stream by social networks or using a search phrase.

You can also change the style of your Social Stream using the theme manager and/or custom CSS stylesheets, and make it unique to your website.

= Main Usages =

* To broadcast all your social network news, photos, videos and updates from multiple social network accounts as a single stream to your visitors.
* To create a single social stream for multiple social network accounts with multiple profiles.
* To create a multi-network photo or video gallery on your website.
* To create a news stream from multiple RSS feeds on your website.
* To create social tag stream of all social network news related to a specific search term or hashtag from multiple social media channels on your website.

= Main Features =

- 8 different display modes
- Supports 14 and growing social networks
- 5 ways to add to your website
- Fully Responsive
- Ads Management Feature
- Slideshow Presentation View
- Up to 29 feed options
- Automatic updates via WordPress dashboard

= Live Demos =

[Wall layout demo](https://axentmedia.com/ax-social-stream/wall-demo-1/)

[Timeline layout demo](https://axentmedia.com/ax-social-stream/timeline-demo-1/)

[Grid layout demo](https://axentmedia.com/ax-social-stream/grid-demo-1/)

[Carousel feed demo](https://axentmedia.com/ax-social-stream/carousel-demo-3/)

[Rotating feed layout demo](https://axentmedia.com/ax-social-stream/rotating-feed-demo-1/)

= Online Documentation =

Online documentation, can be [find here](https://axentmedia.com/ax-social-stream-docs/)

= Support =

If you have any questions or suggestions concerning to AX Social Stream plugin, please contact us [via our page on CodeCanyon](https://codecanyon.net/user/axentmedia) or [via our website](https://axentmedia.com/support/).

== Installation ==

= Requirements =

* PHP version 7.2.5 or higher (PHP 7.2.10 is recommended)
* MySQL version 5.0 or higher (MySQL 5.6 or greater is recommended)
* This plugin requires both PHP's multibyte string extension AND iconv extension (enabled by default)
* PHP's XML extension is required (enabled by default)
* PHP's cURL extension is recommended (required for Facebook feed)
* WordPress version 5.0.2 or higher

= Installation using WordPress dashboard =

Installation of AX Social Stream is straight forward and on average should take no longer than just a few minutes.

Read the [instructions on how to install this plugin here](https://axentmedia.com/ax-social-stream-docs/#installation).

= Updating =

Read the [instructions on how to upgrade this plugin here](https://axentmedia.com/ax-social-stream-docs/#installation-upgrade).

== FAQ ==

= Can I use the plugin in WordPress Multisite (WPMU) mode? =
Yes, this plugin works with WordPress Multisite.
But, if you have encountered any problem after installation:

- Please note, you need to install the plugin in network admin section e.g. http://yourwebsite.com/wp-admin/network/plugin-install.php?tab=upload
- Try, activating the plugin in the network admin.

== Changelog ==
= 3.12.3 - 29.10.2025 =
- TikTok refresh token issue resolved.

= 3.12.2 - 25.05.2025 =
- Twitter feed support using inbuilt app removed.

= 3.12.1 - 17.04.2025
- X share button fixed.

= 3.12.0 - 07.04.2025
- X API upgraded.

= 3.11.2 - 13.12.2024 =
- Instagram Display API deprecated and replaced with the Instagram API for business/professional accounts.

= 3.11.1 - 05.10.2024 =
- Vimeo 'Unsupported response format' issue fixed.

= 3.11.0 - 09.07.2024 =
- TikTok feed support added.
- Fixed a few PHP 8.2 deprecation notices like Creation of dynamic property ... is deprecated.
- Fixing the Instagram hashtag feed first load display problem.

= 3.10.1 - 15.10.2023 =
- Fixed the ... link to rest of content for Twitter items.
- Fixed an issue related to Instagram hashtag feed photo.
- Handling and loading some API errors within the plugin.
- Fixing some issues related to PHP v8.

= 3.10.0 - 29.08.2023 =
- Twitter API upgraded to v2.
- YouTube private videos removed of the playlist.

= 3.9.16 - 19.01.2023 =
- Fixed a Warning error in widgets module.
- Admin framework upgraded to the latest version.
- Fixing the hashtag and username linking in item text.

= 3.9.15 - 21.12.2022 =
- Fixing the lightbox items filtering problem.
- Fixing an issue in Stream Output feature.
- Fixing the Hero theme hover effects.
- Fixing the Facebook group feed API problem.

= 3.9.14 - 20.10.2022 =
- Fixing the Pinterest duplicate items issue.
- Fixing an issue related to the opening of lightbox.
- Fixing an issue related to Link whole item to original feature.

= 3.9.13 - 16.08.2022 =
- Fixed some issues in lightbox view.
- Handling comments error while API is not providing data.
- Fixing the Instagram reel video type displaying problem.
- Fixing empty image problem on some Facebook items.

= 3.9.12 - 14.07.2022 =
- Carousel widget sliding problem fixed.
- Carousel Hero layout one row display problem fixed.
- Fixed the carousel share icons problem on mobile.
- Instagram business carousel video item problem fixed.

= 3.9.11 - 08.05.2022 =
- Instagram connection using Our App is back.

= 3.9.10 - 07.04.2022 =
- Facebook connection using Our App is back.

= 3.9.9 - 24.03.2022 =
- SoundCloud API problem fixed.
- Adding feed by search term to SoundCloud.
- Fixing onload relayout problem on big screens.

= 3.9.8 - 19.02.2022 =
- Instagram location feed option removed.
- Instagram full media information feature removed.
- Instagram login connection obsoleted and removed.
- Facebook and Instagram connection using Our App temporarily removed.
- Facebook comments error #200 Missing Permissions fixed.

= 3.9.7 - 17.02.2022 =
- Instagram Own App token URI problem fixed.
- Facebook connect by access token feature added.

= 3.9.6 - 10.01.2022 =
- Feature to be able to link the whole item to the original post.
- Feature to limit chinese characters count on the items.
- Fixing upgrade error message.

= 3.9.5 - 13.11.2021 =
- Fixing the retweet user photo problem.
- Fixing the Instagram load more problem on personal API.
- Displaying of social stream shortcode in the WordPress dashboard has been fixed.

= 3.9.4 - 07.10.2021 =
- Linking images to original post problem fixed.
- Filter in/out limited content problem fixed.
- Fixed a problem with PHP v8.
- Handling invalid RSS feed warning.

= 3.9.3 - 27.09.2021 =
- VK API updated problem fixed.
- Facebook connect by access token feature added.

= 3.9.2 - 30.08.2021 =
- Filter in and filter out feature added.
- Instagram API updated to the latest version.

= 3.9.1 - 20.08.2021 =
- Theme options displaying issue happened in v3.9.0 has been fixed.
- Problem of displaying of some other Facebook users posts on the stream has been fixed.

= 3.9.0 - 23.07.2021 =
- Some code structure quality fixes.

= 3.8.9 - 25.04.2021 =
- Fixing the Instagram hashtag feed problem.
- Adding hover effects to the default themes.

= 3.8.8 - 12.04.2021 =
- Twitter API credentials suspended app problem fixed.

= 3.8.7 - 03.04.2021 =
- Fixing the Twitter retweets user profile image problem.
- Adding alt tag to comments and likes profile images.
- Fixing the Facebook link posts displaying problem.
- Facebook status type removed.
- Fixing show more button issue.
- Fixing Instagram feed after parameter problem.

= 3.8.6 - 02.01.2021 =
- Fixing the Infinite load more issue on mobile.
- Fixing the Facebook tagged feed problem.
- Fixing some Instagram cache issues.
- Fixing the Instagram API conflicting problems.

= 3.8.5 - 14.12.2020 =
- Handling 429 error happened on 3.8.4 version.
- Fixing Instagram video lightbox size.
- Fixing the get feed by ID problem on Instagram business API.
- Fixing Instagram items information display problem on Instagram business API.
- Instagram business API comments loading problem fixed.

= 3.8.4 - 10.12.2020 =
- Instagram/Facebook official Graph API user and hashtag feed feature added.
- Instagram/Facebook official API authentication setup added.
- Instagram personal display API access token automatic refresh added.
- Instagram private login/password credentials setup added.
- Stream Auto Refresh feature removed.

= 3.8.3 - 26.11.2020 =
- Add disable option for Show More feature.
- Fixing the timeline layout load more images loading issue.
- Fixing carousel hidden arrow problem.
- Fixing Metro theme user styling problem.
- GLOBALS variable notice error fixed.

= 3.8.2 - 02.11.2020 =
- Set "Item Width Definition" option on "Based on container width" by default.
- Fixing the default filtering problem in Masonry layout.
- Fixing the page auto scroll problem on Grid layout.
- Handling the Instagram official API and SoundCloud errors.
- Fixed the Instagram official API feed cache problem.

= 3.8.1 - 31.10.2020 =
- Fixing the Instagram API Credentials problem due to latest API changes.

= 3.8.0 - 30.09.2020 =
- Added translation for Show More text.
- Added noopener attribute to the links.
- Fixing the filtering items in grid.
- Fixing the Instagram lightbox gallery displaying problem in timeline layout.
- Networks filter ordering problem fixed.
- Facebook comments count problem fixed.
- Grid "Based on container width" option problem fixed.
- Grid load more problem fixed.
- Fixing the items gap problem when filtering or searching in Grid.

= 3.7.19 - 07.09.2020 =
- Instagram hashtag problem happened after rlease 3.7.18 has beed fixed.

= 3.7.18 - 06.09.2020 =
- Instagram API credentials setting is back for banned servers.

= 3.7.17 - 27.08.2020 =
- Fixed an incompatibility issue with WordPress 5.5 regarding radio buttons.
- Feature to display Instagram image gallery in carousel mode.
- Adding the show more feature.

= 3.7.16 - 15.07.2020 =
- Feature to display WordPress internal posts on the social stream.
- Fixing the Instagram Feed duplicated items problem on load more action.
- Adding retweets into language files.

= 3.7.15 - 09.07.2020 =
- Feed loading issues due to Instagram API changes fixed.

= 3.7.14 - 08.06.2020 =
- Elementor widget message problem fixed.

= 3.7.13 - 06.06.2020 =
- Fixing the Instagram API change 'Response code is 200' problem.
- Type wall changed to masonry in shortcode and widget.
- VK Search Term/Hashtag feed added.
- Integration with Elementor page builder added.
- Fixing the display of Facebook user feed.
- Adding scroll bar to rotating feed mode.

= 3.7.12 - 26.05.2020 =
- Fixing the Instagram API change 'Media with this code does not exist' problem.

= 3.7.11 - 20.05.2020 =
- Fixing the double facebook.com url in links occured after release 3.7.10.

= 3.7.10 - 05.05.2020 =
- Instagram login error handling problem fixed.
- Fixing the links when getting Facebook video feed.
- Instagram and YouTube Ajax comments loading problem fixed.

= 3.7.9 - 26.03.2020 =
- Allowing lang and locale parameters in Twitter search feed.
- Fixing the Instagram hashtag feed item description problem.
- Fixing the CacheManager multi instanced drivers error.
- Fixing the filtering problem while there are two streams on the same page.

= 3.7.8 - 04.03.2020 =
- Fixing the "This content isn't available right now" problem on Facebook.
- Instagram profile information display problem fixed.
- Instagram official API v1 credentials setup removed of the plugin.

= 3.7.7 - 28.02.2020 =
- Latest problem of loading some Facebook images on Safari due to API change has been fixed.
- Latest problem of displaying of user information on Facebook items has been fixed.

= 3.7.6 - 29.01.2020 =
- Allowing Instagram to get more than 50 items in each request.
- Instagram library required PHP version downgraded to 5.6.x.
- Some PHP notice errors and HTML issues fixed.

= 3.7.5 - 02.01.2020 =
- Instagram getting feed by location ID problem fixed.
- Instagram getting feed by geographical location removed.
- Instagram login information setup added.

= 3.7.4 - 13.12.2019 =
- Instagram IP banned restriction problem resolved.

= 3.7.3 - 10.12.2019 =
- Fixing the duplicate user info on items when getting Instagram hashtag feed.
- Load more feature added for grid layout.
- Fixing the grid layout problem when unchecking info in item output parts or set width on container based.
- Feature to have stream cached items listed by date is ascending order.

= 3.7.2 - 15.11.2019 =
- Use Facebook user token if no page is connected to the plugin.
- Fixing the carousel layout in single row display.
- Instagram conflicting of cached feeds problem fixed.
- Fixing the item gap problem in photo gallery display mode.

= 3.7.1 - 23.10.2019 =
- Instagram lacking user info problem fixed.
- Authenticated accounts removal after upgrade problem fixed.
- Facebook getting personal profile feed feature added.
- LinkedIn removed of the plugin.
- StumbleUpon removed of the plugin.
- Making sharing buttons responsive.

= 3.7.0 - 04.10.2019 =
- Duplicate description problem fixed.
- Access token added into the Authenticated Accounts section.
- Setup multiple Facebook pages listing problem fixed.

= 3.6.9 - 17.09.2019 =
- Facebook problem with API v4 fixed.
- Page username problem in Facebook API Credentials setup fixed.

= 3.6.8 - 16.09.2019 =
- Instagram access token tool public_content permission problem fixed.
- Instagram multi account authentication feature added.
- Facebook multi account authentication feature added.

= 3.6.7 - 10.09.2019 =
- Instagram proxy setting authentication problem fixed.
- Fixing an issue in Instagram user cache.

= 3.6.6 - 08.09.2019 =
- Instagram access token tool removed.

= 3.6.5 - 01.09.2019 =
- Adding own App credentials setup for Facebook.
- Ordering results by default added to settings.

= 3.6.4 - 25.07.2019 =
- Fixing the Linkedin v2 paging problem.
- Adding own App credentials setup for LinkedIn.

= 3.6.3 - 22.07.2019 =
- LinkedIn API upgraded to v2.
- array_change_key_case notice error fixed.

= 3.6.2 - 16.07.2019 =
- Fixed the html special chars problem in item body limiting and formatting functionality.
- Fixing the likes data problem on items happened after release 3.6.0.
- Fixing the likes and comments display problem on slideshow happened after release 3.6.0.
- Feature to display comments replies for Facebook.

= 3.6.1 - 19.06.2019 =
- Custom filtering keywords hidden problem in admin fixed.
- Admin stylesheet file loading problem fixed.
- Facebook shared links image problem fixed.
- Fixed the problem of loading the wall and feed minimized css files.
- Fixed the stream sloppy problem while using the same theme for different streams on the same page.

= 3.6.0 - 12.06.2019 =
- Grid carousel layout added.
- Custom sized grid layout added.
- Making some changes in custom theme class.
- Separating themes options in back-end.
- Implementing hooks for customizing themes.
- Added a feature to convert Facebook shared links to embedded item.
- Displaying the Twitter embed links with a custom style.
- Feature to display the date on items in different formats.
- Unnecessary profiles image and link redirect chain on Facebook resolved.
- Feature to control displaying text labels on items.
- Feature to add multiple keywords in custom filtering tabs.
- Vimeo thumbnail display problem fixed.
- Fixing the problem of compatibility with Wordpress.com servers.

= 3.5.8 - 09.03.2019 =
- API proxy setup setting added.
- Twitter embedding connection refused error handled.
- Google+ API deprecated and removed from the plugin.

= 3.5.7 - 02.03.2019 =
- Fixing the problem of displaying Instagram user info on items.
- Fixing the load more problem of Instagram user items.
- Fixing the images lazy loading problem which was occurred after v3.4.4.
- Feature to disable images lazy loading on the social stream.
- Added the sb-img class to all image tags on social stream.
- Fixed the 'call stack size exceeded' issue on wall filtering.
- The problem of wall relayouting while doing load more fixed.
- Adding meta data to carousel items.

= 3.5.5 - 15.12.2018 =
- Instagram hashtag feed API deprecated and replaced with a new solution.
- Feature to get other Instagram user public feeds without an access token.

= 3.5.4 - 03.12.2018 =
- Fixing the problem of displaying the Debug tab in WP Dashboard.
- The problem of listing custom layouts in Add/Edit Theme page has been fixed.
- LinkedIn post direct link problem fixed.
- Flickr Photoset/Album feed support added.

= 3.5.3 - 05.11.2018 =
- Display a preview of simple shared links in tweets on the item.
- Feature to add custom height for carousel items.
- Feature to connect and generate Twitter, Facebook and LinkedIn API credentials directly in plugin.

= 3.5.2 - 15.10.2018 =
- A fix to stop multiple conversion of Twitter shared links to Embed codes.
- Problem of low-quality video images in Facebook page videos feed has been fixed.
- SoundCloud user playlists feed added.

= 3.5.1 - 22.09.2018 =
- Instagram multi-account feed access token reading problem fixed.
- Facebook hashtags linking added.
- Feature to disable filtering ad items along with social items.

= 3.5.0 - 20.09.2018 =
- Instagram private posts light-box video problem fixed.
- The problem of extra items more than limit in some cases fixed.
- Carousel library updated.
- Added a feature to convert shared links on Twitter to Embed codes.
- Instagram hashtags linking problem fixed.

= 3.4.9 - 08.07.2018 =
- LinkedIn datetime problem on timeline fixed.
- Facebook comments & likes count display problem fixed.
- Facebook link post title to the original resource which is shared.
- Instagram and YouTube show comments feature added.
- Auto trigger show comments in lightbox slideshow mode.
- Add an admin notice if, layouts activation is not passed.
- Feature to control the position of the plugin associated files on your website.
- Load media over https set to true by default.

= 3.4.8 - 10.06.2018 =
- Facebook Graph API v3.0 updated.
- Facebook's cover photo title problem has been fixed.
- Clear cache problem fixed.
- Plugin renamed to AX Social Stream.

= 3.4.7 - 10.04.2018 =
- Instagram user public feed deprecated problem fixed.

= 3.4.6 - 16.03.2018 =
- Twitter search API 140 characters limit and image displaying problem has been fixed.

= 3.4.5 - 18.02.2018 =
- Trimming the RSS data to fix reading by XML parser.

= 3.4.4 - 12.02.2018 =
- Page scroll lazy load problem fixed.
- Plugin renamed.
- Fixing some Notice errors because of API Changes.

= 3.4.3 - 26.01.2018 =
- Facebook Graph API v2.11 updated and it will no longer display Facebook comment user info.
- Feature to define a custom size for YouTube videos.

= 3.4.2 - 30.11.2017 =
- Ajax tabbed `There is no feed` problem has been fixed.

= 3.4.1 - 10.11.2017 =
- Conflicting problem with HTML widgets has been fixed.
- Twitter OAuth library has been updated.
- Twitter hashtag feed duplicates problem fixed.
- The wall relayout problem on fixed height mode has been fixed.
- SVG image converted to base64 inline SVG.

= 3.4.0 - 15.08.2017 =
- SoundCloud API updated.
- SoundCloud tracks' artworks iamge size fixed.
- Facebook image resize got temporarily disabled.
- Option to re-layout wall based on page scroll or images load.
- VK API updated and access token setup is required.
- Wall twitching problem on IE and some other browsers has been fixed.
- Facebook multi-share images problem fixed.
- Fixing the problem that was stopping displaying ads when adding the Social Stream through Visual Composer.
- The problem of opening videos in system inbuilt player instead of lightbox on IE and Safari has been fixed.
- Custom filtering tabs feature added.
- Moving the custom layouts folder to the out of the plugin directory to avoid deleting the layout files after plugin updates.
- Fixing a problem with showing the links in tweets body.
- Problem of not displaying more RSS feed items on load more has been fixed.
- Stream Output setting added to shortcode parameters.
- Added the feature to disable specific filtering buttons.

= 3.3.5 - 25.04.2017 =
- Facebook image resize on demand problem has been fixed.
- Problem with session handling when, stream auto update is enabled has been fixed.
- Problem with pinned items when, stream auto update is enabled has been fixed.
- Carousel display problem with text only posts has been fixed.
- A responsive problem in lightbox slideshow has been fixed.
- Unchecking Title in Stream Output block had not any effect on stream output.
- Wall sort by date problem on "Stream Auto Update" has been fixed.
- Changing carousel shortcode from `type="feed" carousel="on"` to `type="carousel"`.
- Feature to set custom defined height and width for wall layout.
- Feature to set wall items responsive breakpoints based on container width.
- RSS extra new lines problem has been fixed.

= 3.3.1 - 17.11.2016 =
- Facebook enable lightbox view for direct GIF animation links.
- Twitter item text display in lightbox view has been fixed.
- Facebook notice errors while WP_DEBUG was on, is resolved.
- Displaying original retweet post instead of the RT text.
- Framework upgraded to the latest release.

= 3.3.0 - 31.10.2016 =
- Ads management feature added.
- Infinite scroll feature added to the the loading more functionality.
- Plugin update checker problem fixed.

= 3.2.7 - 19.10.2016 =
- Search placeholder added to translation.
- Notice errors while no twitter search terms result exist resolved.
- Changing from compatibility to extended mode for Twitter API latest updates.
- Facebook Graph API v2.7 updated.

= 3.2.6 - 02.09.2016 =
- Gutter X size issue fixed, when set to less than 10 it was displaying post in full width.
- Limiting access to plugin settings only for users with manage_options capability.
- New W3 Markup Validation passed for output HTML contents.
- Twitter unknown video lightbox problem fixed.
- Twitter videos problem when using hashtags with search API fixed.
- Pinterest feed problem fixed.
- Problem with decimal separator in different locale settings has been fixed.

= 3.2.5 - 01.06.2016 =
- An issue with reading RSS media content tag fixed.
- Images lazy load problem with jQuery 1.12.x fixed.
- Problem with loading images on first page load has been fixed.
- Problem with hidding images on auto stream update has been fixed.
- CSS & JS files combined for each display mode.
- The feature to define the number of columns shwoing on each row for different viewport sizes on wall layout.
- Duplicate Instagram items problem on load more fixed.
- Video lightbox support added for Twitter.

= 3.2 - 20.04.2016 =
- Fixed the video auto-resize problem with responsive lightbox window.
- Instagram feed, user search problem fixed.
- Plugin licensing and one year automatic update added.
- W3 Markup Validation passed for Stream HTML content.
- Stream Output setting moved to Social Stream management page.
- Added an option to define the height of Rotating Feed block.
- Visual Composer integration problem fixed.
- Flickr profile image problem fixed.
- Problem with reading incorrect RSS media enclosure tag fixed.
- Fixed an error that was thrown when an RSS feed thumbnail was not exit.
- Problem with pinned & remove items fixed.
- Images lazy load feature added.
- Duplicate items problem from tag feeds fixed.

= 3.1 - 10.02.2016 =
- A new theme/layout named Metro is added.
- Tumblr lightbox video support added.
- Vine item output upgraded.
- Added an option to define, how to display the image for each item.
- Added an option to allow loading images over https
- Vimeo upgraded to the latest API with paging.
- Some CSS styling fixes.
- Filtering the Stream items using a search phrase.

= 3.0 - 22.12.2015 =
- RSS feed first image added to the item as thumbnail.
- Scroll bars removed from lightbox window.
- Auto-resize responsive lightbox window.
- Twitter OAuth library confliction fixed.
- Integrated with Cornerstone and Visual Composer.
- The gap that appearing at the Stream footer on wall filtering fixed.
- Feature to display Social Stream items as lightbox slideshow.
- Loading icon added on images.
- Pinterest board problem fixed.
- CSS files compressed.
- LinkedIn and Vine networks added.

[See the complete changelog](https://axentmedia.com/ax-social-stream-docs/#changelog).
