Yatoon Social Feed

Description

Yatoon Social Feed lets you show your Facebook Page photos and Instagram Business account photos side by side (or separately) anywhere on your WordPress site, using a simple shortcode.

Instead of a fragile one-click OAuth login (which frequently breaks as Meta changes its app review requirements), this plugin uses long-lived access tokens that you generate once via Meta’s own tools and paste into the settings screen. This keeps the plugin lightweight and avoids requiring you to create and maintain your own Meta Developer App with special review permissions for basic photo display.

Features

  • Connect a Facebook Page using a permanent Page Access Token
  • Connect an Instagram Business account using an Instagram Access Token
  • Automatic background sync (hourly, twice daily, or daily) — or sync manually with one click
  • Independent grid settings for Facebook and Instagram (columns, rows, spacing)
  • Optional profile header showing avatar, name, follower count, bio, and a Follow button — auto-synced from the connected accounts, no manual typing required
  • Simple shortcode: [yatoon_social_feed]
  • Lightweight: no external JavaScript SDKs loaded on your site, just your own photos

Pro Version

The free version displays a small “by Yatoon.com” credit beneath your photo grid. Upgrade to Pro to remove it.

Shortcode usage

[yatoon_social_feed]
[yatoon_social_feed platform="facebook"]
[yatoon_social_feed platform="instagram"]
[yatoon_social_feed platform="facebook" columns="3" rows="2"]

External Services

This plugin connects to external APIs provided by Meta (Facebook/Instagram) to retrieve photos and profile information. These calls are made server-side from your WordPress installation — no Meta JavaScript SDK is loaded in visitors’ browsers.

Facebook Graph API
Used to fetch your Facebook Page profile data (name, avatar, follower count, bio) and Page photos. Data is sent when you verify your token and during background sync.
– Service: Facebook / Meta Platforms, Inc.
– Endpoint: https://graph.facebook.com/
– Terms of Service: https://developers.facebook.com/terms/
– Privacy Policy: https://www.facebook.com/privacy/policy/

Instagram Graph API
Used to fetch your Instagram Business account profile data and media. Data is sent when you verify your token and during background sync.
– Service: Instagram / Meta Platforms, Inc.
– Endpoint: https://graph.instagram.com/
– Terms of Service: https://developers.facebook.com/terms/
– Privacy Policy: https://privacycenter.instagram.com/policy/

Meta CDN (image serving)
After sync, your WordPress site displays photos using their original URLs hosted on Meta’s content delivery network (e.g., scontent-*.cdninstagram.com, scontent-*.fbcdn.net). When a visitor’s browser loads your page, it fetches these image files directly from Meta’s servers. No personal visitor data is intentionally sent — this is a standard image request.
– Privacy Policy: https://www.facebook.com/privacy/policy/

No visitor data is collected or stored by this plugin. The only data transmitted to Meta’s APIs is your access token (to authenticate requests) and API query parameters (e.g., requested fields, pagination limits).

Installation

  1. Upload the plugin files to /wp-content/plugins/yatoon-social-feed, or install the plugin through the WordPress Plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Go to the Yatoon Social Feed menu item in your WordPress admin sidebar.
  4. Follow the in-plugin setup guide to generate a Facebook Page Access Token and (optionally) an Instagram Access Token.
  5. Paste the token(s) and click Verify & Save.
  6. Click “Sync” to pull in your first batch of photos.
  7. Add the [yatoon_social_feed] shortcode to any page or post.

FAQ

Do I need a Facebook Developer account?

You need a free Meta Developer account to generate the access tokens this plugin uses, since Meta requires all third-party API access to go through an App ID and App Secret. The in-plugin setup guide walks you through this step by step. You do not need to submit your app for Meta’s App Review for basic Page photo access — that’s only required for advanced permissions.

How long do the tokens last?

A Facebook Page Access Token generated the way described in our setup guide does not expire under normal use. An Instagram Access Token currently lasts about 60 days; the plugin will continue working with the last-synced photos after expiry, and you can generate a fresh token in a couple of minutes using the same setup guide.

Does this plugin load Facebook’s or Instagram’s JavaScript SDK on my site?

No. All API calls happen server-side from your WordPress installation. Visitors to your site only see the photos themselves — nothing is loaded directly from Meta’s servers in the visitor’s browser except the image files.

What data does this plugin store?

The plugin stores your Facebook/Instagram access tokens and basic profile info (name, avatar URL, follower count, bio) in the WordPress options table, and a local cache of your synced photo metadata (image URL, caption, link, date) in a custom database table. No visitor data is collected or stored.

What happens to my data if I delete the plugin?

If you delete the plugin (not just deactivate it) from the Plugins screen, all of its stored options and its database table are automatically removed.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Yatoon Social Feed” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Yatoon Social Feed” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.2

  • Updated Meta Graph API endpoints from v19.0 to v25.0.
  • Improved Facebook photo sync fallback when the full images array is unavailable.
  • Facebook photos are now cached locally during sync to prevent expired Meta CDN URLs from breaking the front-end grid.
  • Added a configurable Meta API version setting for future Graph API version changes.

1.0.1

  • Added optional Pro upgrade (removes the “by Yatoon.com” footer credit).
  • Fixed Plugin URI to a valid URL.
  • Bumped stable tag to match plugin version.

1.0.0

  • Initial public release.
  • Facebook Page photo sync via permanent Page Access Token.
  • Instagram Business photo sync via Instagram Access Token.
  • Independent grid layout settings per platform.
  • Auto-synced profile header (avatar, name, followers, bio, follow button).
  • Scheduled background sync with manual sync option.