=== WP Social Ninja – Embed Social Feeds, User Reviews & Chat Widgets ===
Contributors: techjewel, adreastrian, devutpol, sabbir345, wpmanageninja
Tags: Customer Reviews, Google Reviews, Social Reviews, Social Feeds,  Instagram Feeds
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 4.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add Facebook feeds, Instagram feeds, TikTok feeds, Facebook reviews, WhatsApp Chat, Messenger chat, Testimonial, and others using a single dashboard.
== Description ==
= Easy to Use and Feature-rich Social Media Plugin to Connect Feeds, Reviews, Chat Widgets, Notification Popups, and More. =

👉 Official Website: [WP Social Ninja](https://wpsocialninja.com/)

👉 Get Demo: [View The Demo](https://wpsocialninja.com/demo-page/)

👉 Guidelines: [Official Documentation](https://docs.wpsocialninja.com/)

👉 Join Our Community: [WP Social Ninja Community](https://community.wpmanageninja.com/portal/space/wp-social-ninja/home)

[youtube https://www.youtube.com/watch?v=da87i4ZR6OU]

=  🔥WP Social Ninja - A Comprehensive Social Media Plugin =

[WP Social Ninja](https://wpsocialninja.com/) is a social media marketing tool designed to build trust, create urgency, and encourage conversions. This easy-to-use plugin lets you meet all your targets. You can embed **Instagram Feed**, **Facebook Feed**, **YouTube Feed**, **TikTok Feed**, and other platforms. For example, you can display your social feed gallery with user-generated content using hashtags and even embed product feed from Instagram [shoppable feeds](https://wpsocialninja.com/shoppable-feed/) for direct sales.

This business reviews plugin also collects and displays [customer reviews](https://wpsocialninja.com/platforms/social-reviews/) from 9+ popular platforms, helping you build trust. You can display these reviews on dedicated pages or as notification popups. You can connect reviews from Google Business Profile, Yelp, Airbnb, Facebook, WooCommerce, and other platforms.

Need a [social chat](https://wpsocialninja.com/platforms/social-chat/) or customer support solution? Don’t worry, using WP Social Ninja, you can connect 15+ social chat widgets. You can add chat buttons to your site, such as WhatsApp Chat, Messenger Chat, Telegram Chat, and other chat widgets. This user-friendly social plugin offers unlimited features, customization, and styling options.

**👉[Get the Pro Version](https://wpsocialninja.com/price/) | [View the Demo](https://wpsocialninja.com/demo-page/)**

### 🔌 Embed Preferred Platforms in 3 Quick Steps:

Connect any types of feeds to your site in just three simple steps with WP Social Ninja:

* Connect and create your desired feed
* Customize and style to match your brand
* Copy the shortcode and display it on the website

👉 [Get the Pro](https://wpsocialninja.com/price/) | [Learn Detail Steps](https://docs.wpsocialninja.com/guide/getting-started/install-upgrade-activate-license.html)
### 🖼️ Social Feeds Key Platforms & Features

Connect and embed [Instagram](https://www.instagram.com/) feeds, [Facebook](https://www.facebook.com/) Feeds, [YouTube](https://www.youtube.com/) Feeds, or TikTok Feeds anywhere on your website. You can design eye-catching social feed galleries by choosing a stylish layout and customizing them.

= Instagram Feed =

Integrate **[Instagram feeds](https://wpsocialninja.com/platforms/instagram-feed/)** in WordPress to display Instagram photos on your website. This Instagram widget and Instagram Shoppable feed can improve your e-commerce business growth. The shoppable feature is only available for the Instagram feed Pro version.

= Facebook Feed =

Create a personalized **[Facebook feed](https://wpsocialninja.com/platforms/facebook-feed/)** on a website with our Facebook feed feature. Using this Facebook feed plugin, you can show **[Facebook Album Feed](https://wpsocialninja.com/how-to-embed-facebook-album-feed-on-your-website-easy-way/)** and the **[Facebook Event Feed](https://wpsocialninja.com/facebook-events-feed/)** without using multiple plugins.

= YouTube Feed =

Embed **[YouTube feed](https://wpsocialninja.com/platforms/youtube-feed/)** on WordPress website with WP Social Ninja and let your audience be introduced to your YouTube channel through our plugin.

= TikTok Feed =

Decorate your website with your TikTok posts through a customized **[TikTok feed](https://wpsocialninja.com/platforms/tiktok-feed/)** by our TikTok plugin and promote your business to increase engagement.

**Explore Social Feed features (Free):**

* Designed for all users
* Easy integration
* Limited layouts and templates
* Basic customization
* Custom feed header
* Control YouTube feed playback with autoplay
* YouTube feeds with custom play mode
* Load More to keep visitors engaged
* Feed issue Email alerts
* Page builder compatible
* Auto Sync to keep content fresh
* Save Images Locally
* GDPR Compliant

**Explore Social Feed Features (Pro):**

* Connect and manage multiple business accounts
* Versatile feed types from Hashtag, Photos, Videos, or Live Streams
* Facebook Event Feed
* Facebook Album Feed
* Shoppable Instagram Feed
* Multiple layout options like Grid, Carousel, or Masonry
* Filter by date range for Facebook feed
* “Follow Us” Button to Increase followers
* Deep template styling
* Lightbox popups to display feed content on popups
* Show likes, comments, and captions
* Filter posts by keyword/hashtag

**👉 [Check All Feed Features](https://wpsocialninja.com/platforms/social-feeds/)**
### ⭐ Business Reviews Platforms & Features
Show your **Customer Reviews** using WP Social Ninja! With pre-built templates, you can easily highlight Google Reviews, Facebook Reviews, and other review platforms. You can also collect and display custom review feeds and filter reviews to boost customer trust, improve SEO scores, and drive more sales.
= Google Reviews (Free) =
Embed **Google Business Profile reviews** using our [Google reviews plugin](https://wpsocialninja.com/platforms/google-reviews/) to improve trust and grow your business.
= Airbnb Reviews (Free) =
Display **[Airbnb reviews](https://wpsocialninja.com/platforms/airbnb-reviews/)** to engage customers and encourage quick decisions.
= WooCommerce Reviews (Pro) =
Collect customer reviews for WooCommerce and highlight your **[WooCommerce product reviews](https://wpsocialninja.com/platforms/woocommerce-reviews/)** on your WooCommerce website to build loyalty and drive more sales.
= Facebook Reviews (Pro) =
Display **[Facebook reviews and recommendations](https://wpsocialninja.com/platforms/facebook-reviews/)** to improve business credibility.
= Fluent Forms reviews (Pro) =
Collect and display on-site **[Fluent Forms reviews](https://wpsocialninja.com/platforms/fluent-forms-reviews/)** and display your custom reviews on your website.



**Other Pro customer review Platforms:** Yelp Reviews, Booking.com Reviews, Tripadvisor Reviews, AliExpress Reviews, Custom reviews, and Others. (Pro)

**Explore Business Reviews Features (Free):**

* Customizable layouts & templates
* Auto & manual syncing for review updates
* Specify the number of reviews
* Show review by order
* Language-specific reviews fetch (for Tripadvisor & Booking.com)
* Maintain equal height
* Enable external links
* Optimize the review image
* Pagination for the load more button
* GDPR Compliance
* Shortcodes are supported
* SEO-Optimized and Schema Snippet support
* Shorten long reviews and display clean, concise feedback
* Anonymize reviewer Info and hide names or profile photos
* Hide specific reviews and exclude reviews you don’t want to show
* Optimize review count, column structure, and layout for all devices

**Explore Business Reviews Features (Pro):**

* Combine & display multiple site reviews in a single feed
* Manage and display multiple business accounts
* Filter by Rating and show only the best reviews
* AI overview for all reviews
* Verified reviewers badge
* Hide reviews without text
* Sort reviews by rating
* Display review header
* Styling option for better review presentation
* Import/export custom reviews

**👉 [Check All Review Features](https://wpsocialninja.com/platforms/social-reviews/)**
### 💬 Chat Widgets Key Platforms & Features
**WP Social Ninja** makes it easy for your website visitors to connect with you instantly through popular messaging platforms. With **15+ supported chat widgets**, you can add a floating chat button to your website and provide real-time customer communication.

Whether it’s **WhatsApp**, **Messenger**, **Telegram**, or other platforms, you can link your business accounts and keep your support accessible anywhere on your site.
= WhatsApp Chat (Free) =
Provide real-time assistance via **[WhatsApp chat](https://wpsocialninja.com/platforms/whatsapp-chat/)** to close sales faster and enhance customer satisfaction, all without complex setups.
= Messenger Chat (Free) =
Give proper customer support with **[Messenger Chat](https://wpsocialninja.com/platforms/messenger-chat/)** to boost trust and grow your business.
= Telegram Chat (Free) =
Take your user engagement to another level with our **[Telegram Chat Widget](https://wpsocialninja.com/platforms/telegram-chat/)**.


**Other Pro Social Chat Platforms:** Instagram Page Chat, Instagram DM, Phone, SMS, Email, LinkedIn Chat, X (Twitter), Microsoft Teams Chat, Snapchat, WeChat, Slack, and others. (Pro)

**Explore Social Chat Features (Free):**

* Messenger, WhatsApp & WhatsApp Business chat support
* One-click chat launch
* Add multiple chat accounts
* Different templates and layout types
* Customize chat button text
* Set chat header (Profile/page name, picture/logo)
* Floating button placement
* Set chat button position
* Custom prefilled welcome message
* Include pages to display chat
* Display chat button by post type
* Chat opens in popup window
* Hide chat on desktop/mobile
* Show label (works on chat box)
* Set the close button color
* Style the header background, title, caption, and color
* Set priority for widgets to show on appropriate pages

**Explore Social Chat Features (Pro):**

* Custom pre-set welcome messages
* Multiple chat bubble icons
* Upload custom chat bubble icon
* Customize bubble text
* Specify chat language
* Exclude pages to hide chat
* Show online/offline status
* Create a different chat widget for different languages

**👉 [Check All Chat Features](https://wpsocialninja.com/platforms/social-chat/)**
### 🔔 Notification Popup
Display [Notification Popups](https://wpsocialninja.com/notification-popup/) on any website page to instantly grab your visitors’ attention and build trust in your brand.

Whether it's a 5-star rating, a customer recommendation, or a recent review from platforms like Google, Facebook, WooCommerce, or any other supported review source, you can showcase them in real time using the notification feature.

These popups add credibility to your business, enhance user engagement, increase social proof, and boost your brand value where it matters most.

**👉 [Check Notification Popup Features](https://wpsocialninja.com/notification-popup/)**
### 📝 Testimonial
Highlight your best customer feedback using WP Social Ninja’s [Testimonial feature](https://wpsocialninja.com/testimonial-widget/). With complete customization options, you can design and style the testimonials slider to create an engaging and professional look.

**Why use WP Social Ninja for Testimonials?**

WP Social Ninja is one of the most dynamic testimonial slider plugins for WordPress websites. It allows you to:

* Easily create and manage testimonials
* Display them on any post, page, or template
* Customize the layout, styling, and design to match your branding

We have an integration with Fluent Forms, so you can collect your Testimonials using Fluent Forms and display them on your website to improve credibility.

**👉 [Check Testimonial Features](https://wpsocialninja.com/testimonial-widget/)**
### 🔥 Social Feeds, Reviews & Chats Demos
Want to see how social proof looks on a website? Visit our **[demo page](https://wpsocialninja.com/demo-page/)**. You can see examples of **Instagram Feed**, **YouTube Feed**, **Google Reviews**, **Facebook Reviews**, along with social chat widgets - **WhatsApp Chat**, **Messenger Chat**, and others.
### 🔥 Page Builder and Other Integrations
* Elementor
* Gutenberg
* Beaver Builder
* Oxygen Builder
* Fluent Forms
### 🗣️ End-user Reviews and Rating
Our customers’ feedback proves what we deliver and how they love WP Social Ninja. Let’s see a few:
>__Very best social and testimonial plugin__
> This is the pure gold. It is an all-in-one plugin you must have on your web. Especially if you want to show your best testimonials from customers or just looking for the best social feed plugin. Now I don’t need a live chat free plugin and the Smash Balloon Instagram plugin._ flu5ky; [Source](https://wordpress.org/support/topic/very-best-social-and-testimonial-plugin/)

>__Excellent Social Toolbox for Business__
>Everything works as promised, and support levels are great for any small bugs if found._ rich9000; [Source](https://wordpress.org/support/topic/excellent-social-toolbox-for-business/)

### 🔥 Expert Insights on WP Social Ninja


[youtube https://www.youtube.com/watch?v=DNlOgKElRMg]

[youtube https://www.youtube.com/watch?v=h0sh_HMGzbU]

[youtube https://www.youtube.com/watch?v=VcNkfgodM4E]

[youtube https://www.youtube.com/watch?v=2u9suUNU0oQ]


### 🔥 Documentation and Quick Customer Support

WP Social Ninja is all about powering your online presence, packed with customization, rock-solid performance, and super-fast support that’s got your back!

Are you curious about something or stuck on a feature? Our excellent support crew is here to assist you, ready to dive in and deliver top-tier help for both free and premium users:

👉 [Check Documentation](https://docs.wpsocialninja.com/)

👉 [Get Free and Premium Support](https://wpmanageninja.com/support-tickets/)
### Other WordPress Solutions by WPManageNinja
**[Custom Feed for TikTok – Social Post Feed Plugin for TikTok](https://wordpress.org/plugins/custom-feed-for-tiktok/)**

**[Fluent Forms – Customizable Contact Forms, Survey, & Conversational Form Builder](https://wordpress.org/plugins/fluentform/)**

**[FluentCRM – Email Marketing, Newsletter, Email Automation and CRM Plugin](https://wordpress.org/plugins/fluent-crm/)**

**[Ninja Tables – Best WP DataTables Plugin for WordPress](https://wordpress.org/plugins/ninja-tables/)**
== Installation ==
This section describes how to install and get the plugin working.
Install from WordPress Admin Panel:
1. Log in to your WordPress Admin Area
2. Go to Plugins -> Add New
3. Type "WP Social Ninja" into the Search and hit Enter
4. Find this plugin, click "Install Now"
5. Activate The Plugin
6. Use [wp_social_ninja id="template_id" platform="platform_name"] Shortcode on your next page or post
= Manual Installation =
1. Download the plugin from the WordPress.org repository
2. On your WordPress admin dashboard, go to Plugins -> Add New -> Upload Plugin
3. Upload the downloaded plugin file (wp-social-reviews.zip) and click Install Now
4. Activate "WP Social Ninja" from your Plugins page
5. Use WP Social Ninja on your site from the dashboard
== FAQ ==

= How many social reviews can be displayed on the website? =

You can display an unlimited number of reviews and ratings from Google reviews or Facebook reviews, WooCommerce reviews on your website from the Number of Reviews section.

= How do I connect my Instagram feed? =

Connecting your Instagram feed is easy with WP Social Ninja. You will get multiple configuration options; you can choose the most convenient one.

= Instagram feed is not loading. How to fix it? =

There could be several reasons that cause your feed not to load and show. Check out the [link](https://wpsocialninja.com/instagram-feed-not-loading) for detailed information.

= Can I display feeds from multiple Facebook pages? =

Surely you can! You can display Facebook posts and Facebook feeds from multiple Facebook pages. Also, you can create multiple Facebook feed templates and choose any one of them to showcase on your site.

= How do I customize my Facebook feed? =

WP Social Ninja gives you fully customizable template options where you can customize and style your custom Facebook feed and Facebook posts.

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

Yes. You can easily do that with the filter options from the editor panel, where you can hide or show specific Instagram photos or posts by choosing specific keywords or hashtags.

= Can I hide specific reviews and ratings on my website? =

Yes, you can. WP Social Ninja is a fully featured review plugin with unique features. To hide a particular review on your website, you need to upgrade to the Pro version.

= Is WP Social Ninja compatible with my theme or design? =

WP Social Ninja works perfectly with themes Elementor, Gutenberg, Beaver Builder, and Oxygen Builder.

= How can I get support if the plugin is not working? =
If you face any problem with WP Social Ninja or if something is not working as it should, follow these basic steps:
First, make sure the error is not caused by the theme you are using, and if your themes are compatible with WP Social Ninja.
Deactivate other plugins and check if the problem is still occurring.
Ensure that you’re using the latest version of this plugin and your themes. Also, check if the problem you are experiencing has not already been solved in a later plugin update.
Still, if any of these don't work for you, then submit a [support ticket](https://wpmanageninja.com/support-tickets/) and explain your problem accurately when our support agent responds to you.
= Where can I report bugs? =
You can report your bugs in our [support ticket](https://wpmanageninja.com/support-tickets/). Our support team is 24/7 available to assist you.
= Where can I report security issues? =
We handle all security issues with the Patchstack vdp program. Please report any security issues [here](https://wpmanageninja.com/report-a-security-issue/).

= I want to contribute to the plugin. Where can I find the code repository? =
The code repository for WP Social Ninja is hosted on GitHub. You can find it [here](https://github.com/WPManageNinja/wp-social-reviews/).

= Do you want to encourage us for future improvement? =

If you like this plugin, please give us [5 stars](https://wordpress.org/plugins/wp-social-reviews/#reviews) to encourage us for future improvement. Thank you!
== Screenshots ==

1. Embed social feeds, reviews, chat widgets & more
2. Display your social reviews, and show the best feedback
3. Bring Facebook content on your website through Facebook Feed and customize it
4. Display Instagram posts on the website through Instagram Feed
5. Decorate your YouTube feed with Playlists, Livestream, and different Play Modes
6. Connect multiple accounts to display your TikTok content
7. Customize your chat widget templates with your own style
8. Make templates your own way, and all will look perfect on any screen

== Changelog ==

4.3.0 ( Date: July 20, 2026 )
- Introduced a centralized OAuth bridge connection flow for Google Reviews, YouTube, Instagram, Facebook, and TikTok, replacing legacy per-platform OAuth redirects
- Added WhatsApp message context modes to chat widgets
- Added FluentCRM integration that tags a customer's contact when their WooCommerce or FluentCart product review is approved, enabling review-based follow-up automations (Pro)
- Added Quick Setup for WooCommerce and FluentCart, creating a review form, display template, and enabling WP Social Ninja as the main review hub in a single step (Pro)
- Updated the core WPFluent framework to v2.12.3
- Added PHP 8.4 compatibility
- Added a resizable and collapsible settings sidebar with a keyboard-accessible drag handle to the Reviews, Chats, and Feed template editors
- Added scroll-based pagination to the WooCommerce/FluentCart connected-products list so large catalogs load incrementally
- Optimized WooCommerce and FluentCart connected-product loading by removing per-product N+1 queries and fixing list ordering during pagination (Pro)
- Added encryption at rest for stored YouTube API keys (Security)
- Added a "Sync All Reviews" button to the WooCommerce connect modal, matching FluentCart's existing bulk sync action
- Added a per-product override indicator for FluentCart and WooCommerce products, flagging when a conflicting setting elsewhere overrides WP Social Ninja's own display configuration, with a direct link to resolve it (Pro)
- Added plain-PHP mb_* fallbacks so the plugin no longer fatals on hosts missing the mbstring PHP extension
- Added a generic affiliate-link filter for partner attribution on Pro upgrade links
- Added Block API v3 support for the Social Ninja block, enabling the Gutenberg iframe editor
- Improved the FluentCart/WooCommerce "not connected" alert to distinguish between the plugin being inactive and the store having no products yet
- Improved WooCommerce review sync to report accurate cumulative success/skip totals across multi-batch imports instead of only the most recent batch (Pro)
- Fixed custom source review imports so exported reviews can be imported into a different target custom source, with correct handling for Fluent Forms and native review form sources and clearer errors on empty imports (Pro)
- Fixed reviews connection modal reopening unexpectedly when switching admin tabs after connecting a platform
- Fixed relative date-range Facebook feeds (e.g. Event feeds) freezing at the time the cache was first created instead of continuously tracking the current time
- Fixed future events leaking into "past" date-range Facebook event feeds
- Fixed frontend review script failing to load on page builders with late script enqueueing, such as Elementor and Oxygen
- Fixed WooCommerce bulk-sync completion message showing the total review count instead of the number of newly imported reviews
- Fixed YouTube video duration display showing a missing leading zero
- Added a hard limit to Facebook Graph pagination requests to prevent unbounded page-fetch loops on accounts with many managed pages

4.2.2 ( Date: May 22, 2026 )
- Improved translation coverage for admin UI strings
- Fixed reviewer avatar and notification popup platform icon images to include explicit dimensions, reducing layout shift on review template pages
- Fixed "Write a Review" button allowing save with a blank custom URL — the editor now validates and blocks save when the custom URL is empty
- Fixed "Write a Review" button not rendering on the frontend when a custom URL source was configured (Pro)
- Fixed FluentCart reviews not showing the Edit action in the admin review list (Pro)
- Removed incomplete "View Submissions" action from the native review form actions menu (Pro)
- Added extra security checks for YouTube video popup and Facebook album requests (Pro)
- Improved validation to prevent editing the wrong templates, widgets, or notifications

4.2.1 ( Date: 24 April 2026 )
- Fix custom review images with optimization enabled
- Fix optimized image localization fallback
- Fix review keyword filter matching
- Fix YouTube GDPR error message shape
- Add WP Social Ninja WP-CLI commands
- Unify Airbnb review ID dedupe
- Optimized database queries and improved security

4.2.0 ( Date: 17 April 2026 )
- Added native review form builder for FluentCart, WooCommerce, and Custom Sources, removing the need for additional plugins for basic review collection. (Pro)
- Added FluentCart integration to collect and display product reviews with product sync, primary review hub support, and customizable “Write a Review” button via templates. (Pro)
- Replaced default WooCommerce review fields with WP Social Ninja review forms, providing full control over form design and review display. (Pro)
- Added support for Custom Source review forms via shortcode for easy embedding anywhere on the site. (Pro)
- Improved FluentCart review drawer (slide-in) experience Pro)
- Added flexible rating click actions for WooCommerce (drawer/scroll) Pro)
- Added show review images toggle to review template editor settings
- Enhanced performance with server-side search and async multi-select
- Optimized database queries and improved security
- Fixed YouTube channel “No videos found” issue
- Fixed YouTube header banner display issue
- Fixed Google Business Profile location name issue
- Fixed formatting issues in reviews and testimonials
- Fixed review auto-sync input update issue

4.1.0 ( Date: 29 January 2026 )
- Introduced review status controls: Publish, Unpublish, and Spam.
- Added advanced review moderation with manual approval and intelligent auto-publishing rules based on rating, content length, and keywords.
- Added spam marking and unmarking for reviews, including bulk actions.
- Added advanced style options for review and feed templates, including box shadow, border radius, hover effects, and padding and spacing controls. (Pro)
- Added device-based responsive control for ‘Load More’ behavior.
- Added advanced Product Review Schema and optimized review structured data for improved SEO.
- Added the ability to clear cache by individual feed template for better control.
- Introduced Facebook Event sorting options to display events in the preferred order. (Pro)
- Optimized SQL queries for review counts, rating breakdowns, and business information.
- Preserved manual review approval status during sync to prevent unintentionally re-approving disabled reviews.
- Improved WooCommerce template handling and business information processing. (Pro)
- Fixed and improved Airbnb business information handling via the GraphQL API. (Pro)
- Improved facebook event feed handling and account filtering logic. (Pro)
- Fixed an issue where woocommerce product reviews were incorrectly inserted into non-review comments and processed as reviews. (Pro)
- Fixed an issue where WP Social Ninja custom cron events could be automatically removed on certain server environments.
- Resolved a masonry layout rendering issue. (Pro)
- Fixed review count update issues when enabling or disabling reviews.
- Fixed incorrect post ID usage in asset loading logic for WooCommerce products.
- Fixed chat widget Viber configuration issue. (Pro)
- Fixed time picker, date range type design issue.
- Filter out Instagram trial reels from account feed
- Fixed review show/hide reviews based on keyword issue (Pro)

4.0.2 ( Date: 04 December 2025 )
- Enhanced sanitization and permission validation for REST API requests.

4.0.1 ( Date: 02 December, 2025 )
- Fixed: Unpublished reviews were being displayed on the frontend.
- Fixed: Reviewer name mapping issue in Fluent Forms integration. (Pro)
- Fixed: Duplicate reviews appearing from Booking.com sources. (Pro)
- Fixed: Custom image upload conflict caused by certain plugins. (Pro)
- Fixed: Incorrect pro feature toggle behavior inside feed and review editors.
- Improved: added Loader animation when switching layouts inside the Template Editor panel

4.0.0 ( Date: 21 November 2025 )
- Revamped UI and improved UX for modern and streamlined experience
- Added smooth onboarding to simplify first-time setup
- Introduced Custom Sources to add and display reviews from any platform (Pro)
- Added Import & Export feature for Custom Sources (Pro)
- Added Screen Options to easily hide or show platforms
- Added Bulk Actions for templates, reviews, chat widgets, and notifications
- Improved overall performance
- Introduced Dark Mode for the plugin dashboard
- Rebuilt WP Social Ninja Admin area using Vue 3 and Element Plus
- Security: Enhance HTML sanitization for user-generated content
- Security: Covered Plugin Check (PCP) Requirements for better security compliance
- Fixed Uncaught Error: Call to a member function get_ID() on null in actions.php when the woocommerce_comments called. (Pro)
- Fixed facebook event feed order issue (Pro)

3.20.3 ( Date: 17 November, 2025 )
- Improved sanitization and escaping for imported reviews and feed content

3.20.2 ( Date: 10 November, 2025 )
- Fixed compatibility issue with the Facebook Event API (Pro)
- Improved Judge.me review import process and fixed review display issues inside the product reviews tab (Pro)
- Displayed place id for Airbnb business names to help distinguish between businesses with the same name (Pro)
- Displayed Airbnb business place id in the business selection dropdown to avoid confusion when multiple businesses share the same name (Pro)
- Added missing translator strings and translator comments.
- Added additional permission checks for REST API requests to improve overall data handling security.

3.20.1 ( Date: 25 September, 2025 )
- Media upload issue resolved.
- Resolved notifications and badge reviews popup modal CSS conflict issue.
- Fixed Facebook feed “Order by” and keyword/hashtag filtering issues.
- Fixed PHP deprecated warnings by reordering optional and required parameters in Reviews Template

3.20.0 ( Date: 18 September, 2025 )
- Added Judge.me reviews migration import option (Pro)
- Added the fresh and modern "Polaris" Reviews Template. (Pro)
- Added WooCommerce product reviews synchronization with WP Social Ninja, allowing you to manage and display all your reviews directly from Social Ninja. (Pro)
- Added Advanced WooCommerce reviews customization — choose layouts, templates, form styles, and control visibility options directly in WP Social Ninja, without configuring each product’s settings individually. (Pro)
- Added a Social Ninja Reviews Template placement option in WooCommerce product settings. (Pro)
- Added a Reviews Form option in WooCommerce product settings to collect WooCommerce reviews using Fluent Forms, or you can use the WooCommerce default reviews form. (Pro)
- Added a new header template for WooCommerce, fluent forms and custom reviews. (Pro)
- Added option to collect custom reviews using Fluent Forms. (Pro)
- Added Review photo support — collect images along with review text via Fluent Forms. (Pro)
- Added Fluent Forms review collection with approval support for custom and WooCommerce reviews. (Pro)
- Added Fluent Forms Rating Field: You can now add rating fields in Fluent Forms without needing Fluent Forms Pro, if you have Social Ninja Pro.
- Added Responsive Post Count Filter: Use the new "wpsocialreviews/responsive_post_count" filter to customize the number of posts displayed based on the device (desktop, tablet, or mobile).
- Added Fetch More Facebook Feed Attachments: Enable the "wpsocialreviews/facebook_feed_should_fetch_more_attachments" filter to include additional child attachment photos in your Facebook feeds.
- Updated Swiper Library: Upgraded to version 8.4.7 to resolve conflicts with Power Pack ticker.
- Improved Error Handling: Added encryption error detection for Facebook Reviews, Facebook Feed, and Instagram, with clear, user-friendly error messages (includes error code 999 for access token issues).
- Improved Facebook Feed Cache: Optimized cache handling for relative date ranges, making your feeds faster and more reliable. (Pro)
- Improved Tripadvisor API configuration and cleared downloadReviewsUrl for non-business URL credentials for a seamless experience.
- Improved button links and accessibility for Facebook feeds, making them easier to navigate.
- Fixed Airbnb reviews fetching issue & added support for Airbnb v3 (note: experiences and services business name & average rating not supported)
- Fixed accessibility issue with slider pagination (Pro)
- Fixed PHP deprecation issue (get_class() without arguments) for better compatibility with newer PHP versions
- Fixed error display for Facebook Reviews in the admin panel.
- Fixed missing <br> tags in Instagram post captions on the frontend for better formatting.
- Fixed Issue with Business Hours & Timezone Settings for WhatsApp Widget (Pro)
- Fixed input device activation for total posts/reviews in the editor's responsive mode, with better device key selection logic.
- Fixed issues with uploading custom images. (Pro)
- Fixed Chat Widget close button color change issue.
- Fixed Chat Widget Template Config handling for array values, resolving a PHP 8.3 compatibility issue that caused a fatal error.
- Fixed WooCommerce Template rating icon spacing and color issues.
- Fixed Facebook feed album and single album image optimization and display issues. (Pro)
- Fixed: Facebook feed now only shows public posts (subscriber-only posts are hidden).
- Fixed Facebook feed popup left arrow icon issue in the editor.
- Fixed Instagram Feed posts hashtag links with umlauts being incorrectly generated.
- Fixed Inline Instagram videos now pause other videos, preventing multiple from playing at once.
- Fixed YouTube Feed live stream data update and fetch issues. (Pro)
- Fixed YouTube Feed empty header display issue.
- Fixed search functionality in the admin panel for all reviews.
- Fixed syntax error in Reviews Template "Rigel" within the editor. (Pro)
- Fixed sorting logic for feed and review posts to display them in the correct order.
- Fixed reviews template CSS loading in the footer on the WooCommerce product page.
- Resolved PHP maximum execution time exceeded error in the `feedsByRandom` method logic

3.19.0 ( Date: 14 July, 2025 )
- Added Get Reviews via QR Code Module. (Pro)
- Added verified badge support for review platforms. (Pro)
- Fixed Instagram account feeds max 100 feed limit issue
- Fixed Hashtag filter functionality for Facebook album and single album feeds. (Pro)
- Fixed chat widget CSS selectors and added closing animation to chat box
- Fixed chat widget to correctly reflect user’s local timezone. (Pro)
- Refactored rating stars and improved AI platform detection on notification popups. (Pro)
- Fixed TikTok feed disconnection issue by improving token management, adding a safety buffer for expiration checks, and enhancing error handling.
- Updated Babel configuration for ES module support: Removed unused script from production version
- Improve Accessibility for reviews and facebook feed buttons. (Pro)
- Airbnb review integration is temporarily unavailable due to changes in the external API. A notice has been added to the configuration screen.

3.18.0 ( Date: 29 May, 2025 )
- Introduced an AI-powered summarizer for Reviews templates with customizable display options. (Pro)
- Reviewer Name Format Option – Added setting to allow users to customize how reviewer names are displayed. (Pro)
- Optimized Image Format Setting – Introduced an option to choose between JPG or WebP image formats for better optimization.
- Star Rating Icon – Improved excessive DOM size for rating icons to enhance performance.
- Edit Button Visibility – Resolved visibility issue with the Edit button on reviews templates.
- Feed Popup Layout – Fixed height adjustment issue to ensure consistent layout in the feed popup.
- "Write a Review" Button – Updated element type to prevent template layout breakage. (Pro)
- Review Business Info & Button URL – Fixed issues related to displaying business info and custom "Write a Review" button URL. (Pro)
- Reviews Popup Styling – Fixed issue with styling not updating in the notifications reviews popup.(Pro)
- Fixed the restriction issue affecting optimized image URLs
- Fixed the no default translation string issue in translation settings.

3.17.0 ( Date: 06 May, 2025 )
- Added SMS chat widget. (Pro)
- Added Microsoft Teams chat widget. (Pro)
- Added Instagram DM chat widget. (Pro)
- Added support for Facebook Single Photo Album via Album ID. (Pro)
- Added support for Facebook Specific Video Playlist via Playlist URL. (Pro)
- Added option to show Fluent Forms or custom URLs in Reviews business info/badge section. (Pro)
- Added support for YouTube feed – users can now collect feeds using channel handle, username, or channel ID.
- WhatsApp Pro is now available in the Free version (other Pro features remain locked).
- Added prefilled support for SMS and WhatsApp widgets (layout types: box and icons). (Pro)
- Added official 3:4 aspect ratio support for Instagram templates.
- Enhanced WeChat widget. (Pro)
- Improved Facebook Events API integration – users can now collect Facebook event feeds. (Pro)
- Improved: User can display likes, comments count and header bio text, fullname for instagram business basic account.
- Resolved issue with multiple Fluent Forms overlapping in the chat widget. (Pro)
- Updated Twitter/X official logo on twitter template.
- Fixed issues with editing and deleting chat widgets.
- Resolved Oxygen Builder escaping issue.
- Fixed manual Instagram connection issue.
- Fixed issue with reviews media URLs when image optimization is enabled.
- Resolved "Load More" issue in reviews (Pro)
- Fixed Instagram account feed video media URL issue.
- Removed Skype from the chat widget due to Microsoft discontinuing support for Skype integration

3.16.2 ( Date: 11 March, 2025 )
- Improve data escaping and overall plugin security.
- Restricted direct access to plugin upload directory for better protection.
- Improved Queries performance

3.16.1 ( Date: 19 February, 2025 )
- Fixed a critical issue where the sort() function was incorrectly applied to a string instead of an array in the Facebook Helper.

3.16.0 ( Date: 18 February, 2025 )
- Introduced 4:5 aspect ratio for Instagram feed images.
- Improved Facebook Feed Template responsiveness to ensure optimal display across devices.
- Fixed an issue causing unknown Facebook API error messages.
- Fixed image resizing issue where only the first feed template was processing images, while other templates were not resizing them correctly. Now, all templates handle image resizing properly.
- Addressed missing Instagram video display problems.
- Fixed YouTube feed image size modifications not applying correctly when using add_filter.
- Updated Twitter/X official logo.
- Fixed Facebook feed alt tag empty issue to improve accessibility.
- Ensured Read More/Read Less truncates HTML content correctly.
- Refactored Avatar & Cover assignments to prevent undefined key issues.
- Fixed Instagram video carousel album thumbnail visibility issues.

3.15.1 ( Date: 05 December, 2024 )
- PHP Fatal Error caused by missing 'Optimize Images' table.
- Issue with the 'Template Source Empty' error displaying incorrectly.

3.15.0 ( Date: 04 December, 2024 )
- Action Required: If you have a personal account connection, please reconnect your account before December 2024 after updating to version 3.15.0 or higher. [Learn more](# "Learn more")
– Added Optimize Images settings option in Settings -> Advanced Settings -> Optimize Reviews Image Settings. This feature automatically stores local copies of Reviews images on your server.
– Added Optimize Images settings option in Settings -> Feed Platforms -> YouTube Settings. This feature automatically stores local copies of YouTube feed images on your server.
– Added YouTube Feed GDPR compliant settings option in Settings -> Advanced Settings.
– Added Optimize Images reset option in Settings -> Feed Platforms -> YouTube Settings.
– Added Optimize Image resolution settings option in Template Editor -> Feed/Settings -> Images Resolution.
- Added an option to configure pre-filled messages for WhatsApp.
- Added an address field option for schema snippets.
- Added the ability to reorder chat widget channels.
- Improved support for collecting language-specific reviews from Tripadvisor and Booking reviews.
- Fixed an issue with Instagram feed accessibility.
- Fixed an issue with Fluent Forms business info display.
- Fixed a TikTok feed filter issue on mobile devices.
- Fixed TikTok popup responsiveness issues.
- Fixed responsive styling for reviews header ratings.
- Fixed the disappearing date styling option for review platforms.
- Fixed empty business info appearing in Google Reviews configuration.
- Fixed a dependency issue with the widget for the wp-block-editor.

3.14.2 ( Date: 07 October, 2024 )
- Fixed unknown error message display issue
- Fixed reviews rating icon color display issue
- Remove unnecessary animated bg class from free version
- Fixed optimize profile photo invalid url issue

3.14.1 ( Date: 23 September, 2024 )
- Resolved an issue where database tables were not being created for subsites if the wp social ninja was installed after the subsites were created. Tables will now correctly generate for both the main site and all subsites, regardless of installation time.
- Preloader in feed templates not disappearing after storing images locally has been resolved. Preloader now correctly disappears after images are successfully stored.
- Fixed PHP 8.3 compatibility issue, which caused a fatal error due to a null argument being passed to array_keys() in the ShortcodeHandler.php file.
- Corrected the issue with the "Filter Number of Feeds to Display" limit for feeds, ensuring that the specified limit now works as intended.
- Addressed an issue with the feed display limit, ensuring it now functions correctly.
- Fixed post URL popup and redirection issue in Facebook feed template.

3.14.0 ( Date: 18 September, 2024 )
- Added Optimize Images settings option in Settings -> Feed Platforms -> Facebook,TikTok Settings. This feature automatically stores local copies of Facebook,TikTok feed images on your server.
– Added Facebook,TikTok Feed GDPR compliant settings option in Settings -> Advanced Settings.
– Added Optimize Images reset option in Settings -> Feed Platforms -> Facebook,TikTok Settings.
– Added Optimize Image resolution settings option in Template Editor -> Feed -> Images Resolution.
– Added a warning notice in the wp social ninja admin area to alert you about critical issues with your Facebook,TikTok Feed and Facebook Reviews.
– Added Email notification alerts for critical Facebook,TikTok Feed and Facebook Reviews issues. You will receive an email notification if there’s an unresolved issue with an Facebook,TikTok feed or Facebook Reviews on your website.
- Fixed the review rating problem so you see the exact rating every time.
- Fixed the Instagram feed animation issue so that images of different sizes and resolutions display perfectly on the screen.
- Fixed the problem of missing Instagram videos - now all videos will be shown properly.
- Improved Instagram image optimization by fixing the issue with multiple avatar downloads and ensuring images load from local storage.
- Fixed the Instagram videos display issue in the free version so videos can now play directly from the template.

3.13.1 ( Date: 03 April, 2024 )
- Resolved Facebook Pages and Instagram accounts connectivity problems.
- Fixed the string translation issue in the editor.

3.13.0 ( Date: 12 March, 2024 )
- Added TikTok Feed
– Introduced TikTok Feed Elementor Widget
– Introduced TikTok Feed Oxygen Widget
– Introduced TikTok Feed Beaver Widget
- Fixed chat widget query limit issue
- Chat widget improvements
- Fixed Airbnb reviews fetching issue
- Addressed ${var} deprecation issue in PHP 8.2
- Addressed translation text issue in editor panel

3.12.1 ( Date: 11 December, 2023 )
- Fixed the scrollbar issue in the feed popup.
- Fixed review load more button html closing tag issue

3.12.0 ( Date: 27 November, 2023 )
- Improved overall accessibility across the plugin.
- Added WP date option switcher for Facebook feed.
- Addressed Google Business Profile (GBP) locations limit issue.
- Resolved Facebook pages limit issue.
- Added support for selecting any post type pages in the chat widget.
- Exclude all unlisted videos from the YouTube feed.
- Resolved Reviews are automatically removed when they are deleted from Facebook or Google.

3.11.0 ( Date: 26 September, 2023 )
- Added support for Twitter API version 2.
- Increased the limit for Google Reviews locations to 200.
- We have updated the Google My Business logo and renamed the platform from Google My Business to Google Business Profile.
- Fixed an issue related to saving Instagram images when new images arrive.
- Resolved the issue of saving Instagram images of the same size when downloaded via cURL.
- Fixed the Instagram header cache creation and API error generation issue.
- Fixed an issue related to the type of arguments in base64_decode.
- Fixed the problem of connected Instagram accounts not being deleted properly.
- Fixed a PHP required parameter error.
- Fixed an issue where unnecessary style attributes were being printed.
- Fixed the missing href tag in the chat widget.
- Fixed a PHP notice in the Elementor widget class.

3.10.1 ( Date: 26 July, 2023 )
- Fixed compatible issue with oxygen page builder

3.10.0 ( Date: 26 July, 2023 )
- Added Optimize Images settings option in Settings -> Feed Platforms -> Instagram Settings. This feature automatically stores local copies of Instagram feed images on your server.
- Added Instagram Feed GDPR compliant settings option in Settings -> Advanced Settings.
- Added Optimize Images reset option in Settings -> Feed Platforms -> Instagram Settings.
- Added Optimize Image resolution settings option in Template Editor -> Post -> Images Resolution.
- Added a warning notice in the wp social ninja admin area to alert you about critical issues with your Instagram Feed.
- Added Email notification alerts for critical Instagram Feed issues. You will receive an email notification if there's an unresolved issue with an Instagram feed on your website.
- Fixed issue with editing button text in the shoppable Instagram Feed.
- Fixed an issue with fetching the number of videos in the YouTube Feed.
- Fixed multiple Google My Business (GMB) accounts auto sync issue.
- Fixed the extra slash issue in the rest route for WPML plugin.

3.9.4 ( Date: 25 May, 2023 )
- Fix Instagram API error: Tried accessing nonexisting field (comments_count) on node type (Media)

3.9.3 ( Date: 21 April, 2023 )
- Fix Instagram accounts connection auto disconnect issue

3.9.2 ( Date: 18 April, 2023 )
- Fix Instagram feeds not found issue
- Fix Instagram albums media display issue
- Fix Only admin can see error messages
- Fix Compatible with breeze plugins cache

3.9.1 ( Date: 25 March, 2023 )
Tweak: Instagram and Facebook feed data is permanently deleted from your site after deauthorizing the WP Social Ninja app. Due to Meta's platform requirements, any Meta's platform data on your site must be deleted within a reasonable time after the app has been deauthorized.
Tweak: Facebook and Instagram access tokens are now encrypted in your WordPress database.

3.9.0 ( Date: 30 December, 2022 )
- Add Facebook Feed access token manually connect option
- Add Facebook Reviews access token manually connect option
- Add support for PHP 8.1
- Add external urls hide option in reviews settings
- Added date option, title & author spacing option in testimonial module
- Fix Google My Bussiness access token expired issue
- Fix Google My Bussiness accounts limit issue
- Fix CRON JOB issue
- Fix YouTube feed popup scrolling issue
- Fix php mb_strpos function undefined issue
- Fix autoptimizeCache method undefined issue
- Fix Instagram video issue in inline mode for iphone

3.8.0 ( Date: 16 November, 2022 )
- Added Instagram shoppable feed module
- Added responsive slider option
- Added YouTube Feed custom banner upload option
- Added Twitter Item Box style option
- Added filter hook for facebook feed api data limit
- Instagram, Facebook, Twitter feed compatible with siteground cache
- Twitter feed compatible with caching plugins
- Improve facebook and instagram profile header in editor
- Fix web dev errors for chat widget
- Fix permalink issue on facebook feed

3.7.2 ( Date: 12 October, 2022 )
- Fix Add Notifications and Add Testimonial button display issue

3.7.1 ( Date: 11 October, 2022 )
- Migrate Google my business APP
- Compatible with Godaddy Cache, WP-Optimize Cache , WP Fastest Cache, Autoptimize Cache plugin
- Added on-hover tooltip text option for chat widget icons layout
- Added reviews title for amazon, tripadvisor, trustpilot, aliexpress, booking dot com
- Improve platforms page UI
- Improve route reload issue in settings
- Remove Instagram empty media URL feeds from feed object
- Fix oxygen page builder wpsn templates CSS loading in the footer issue
- Fix business info issue
- Fix responsive bar selected device and scroll issue
- Fix Facebook feed incorrect media type issue
- Fix Tripadvisor reviews Unicode text support issue
- Fix Tripadvisor total reviews count

3.7.0 ( Date: 24 August, 2022 )
- Add Template Style Module for all platform
- Add a responsive query option for all platform
- Add a responsive column breakpoint option for all platform
- Add Show/hide reviews by specific words option
- Add hide date option for reviews
- Add collect testimonials using Fluent Forms
- Add hide facebook feed shared posts features
- Add booking.com 1-10 starts filter option
- Add google locations and facebook pages clear option
- Improve Chat widget compatible with Litespeed cache
- Improve IG, FB feed compatible with wp rocket plugin
- Improve API Integrations
- Fix Youtube Feed - live streams videos incorrect date display issue
- Fix include/exclude feeds count issue
- Fix booking.com average rating issue
- Fix reviews business info issue
- Fix Google reviews locations return false issue
- Fix Facebook feed image undefined issue
- Fix review empty URL issue
- Fix YT and IG popup open issue
- Fix Compatible issue with elementor pro
- Refactored Editor Panel VueJS Components for better performance
- Refactored App Controller and Models
- Internal improvements

3.6.1 ( Date: June 1, 2022 )
- Fix business info auto delete issue
- Fix reviews cache key delete issue
- Improve YouTube feed include, exclude filter

3.6.0 ( Date: May 30, 2022 )
- Add Testimonial Module
- Add Custom reviews Import & Export feature
- Add manually auto-sync option
- Add reviews sorting option in the admin panel
- Improve Airbnb reviews API
- Fix Facebook and Instagram feed line breaks issues for different language
- Fix GMB duplicate reviews issue
- Fix the number of feeds issue
- Fix IG video thumbnail display issue in IOS device
- Fix the Booking.com platform name alignment issue
- Fix write a review button display issue

3.5.7 ( Date: April 22, 2022 )
- Fix slider issue

3.5.6 ( Date: April 20, 2022 )
- Remove Copyrighted media assets
- Updated Assets and Readme file change

3.5.5 ( Date: April 20, 2022 )
- Fix the google locations limit issue
- Fix the Redis object cache compatibility issue
- Fix the phone number chat widget open in the new tab issue
- Fix chat widget email and phone number plain text issue
- Fix Twitter header display issue in the template editor panel
- Fix elementor reviews widget reviewer name styling issue
- Add read more/less styling option for elementor reviews widget

3.5.4 ( Date: March 30, 2022 )
- Add translate option in settings panel
- Add filter hook for reviews platform icon
- Add class name in all html elements
- Improve notification popup settings panel
- Improve global settings panel design
- Improve Instagram feed compatible with Litespeed cache
- Improve hide chat widget from elementor, oxygen, beaver builder editor panel
- Update tripadvisor icon
- Remove GMB deprecated API end points
- Fix chat widget close button in only icons layout
- Fix facebook header number format issue
- Fix twitter hashtag url 404 not found issue
- Fix slider issue in Oxygen page builder
- Fix fluent forms chat widget info message
- Fix 'ago' translate issue
- Fix reviews template web accessibility issue
- Fix Elementor 3.6.x compatibility issue
- Fix http issue in GMB write a review URL

3.5.3 ( Date: February 03, 2022 )
- Fix critical error issue

3.5.2 ( Date: February 02, 2022 )
- Add header title option for Fluent Forms channel in Chat widgets
- Fix js error in oxygen page builder issue
- Fix Facebook Feed curl error issue
- Fix Facebook Feed page profile picture image quality issue
- Fix Facebook Feed Masonry Layout overlapping issue in Firefox browser
- Fix Tripadvisor invalid date issue
- Fix Tripadvisor header rating issue
- Fix custom review and fluent forms review merge issue

3.5.1 ( Date: January 25, 2022 )
- Fix database issue
- Improve localize script compatible for wp 5.9
- Improve small css

3.5.0 ( Date: January 24, 2022 )
- Add Facebook Feed
- Add Facebook Feed Elementor Widget
- Add Facebook Feed Oxygen Widget
- Add Facebook Feed Beaver Widget
- Fix others platform reviews not showing when Fluent Forms reviews are added
- Fix swiper slider conflict with elementor 3.5.0
- Fix YouTube auto play issue in chrome browser
- Fix fluent form chat widget icon issue
- Fix reviews popup template scrollbar issue
- Improve instagram template caption font size in mobile device
- Improve GMB reviews limit is 100
- Remove important tag from all button css

[See changelog for all versions.](https://docs.wpsocialninja.com/guide/troubleshooting-support/change-log.html)
