mburbage78

A simple tool to load your Facebook feed on your site.

Social Feed Ez

A simple tool to load your Facebook feed on your site.

thesaasfactory

SocialEyes is a modular social feed aggregator that displays posts from Facebook, Instagram, Twitter, and other platforms in beautiful skin styles on your WordPress site.
Current version includes:
— Facebook integration — display posts from any Facebook Page you manage 
— Masonry skin — Pinterest-style grid, 3 columns on desktop, 2 on tablet, 1 on mobile 
— Light and dark themes — automatic system preference detection or force a specific theme 
— Click to expand — full post modal with images and complete text 
— Auto-advance — optional automatic rotation on mouseover 
— Customizable via CSS variables — full control over colors and styling
SocialEyes is built with a modular architecture. Future updates will add Instagram, Twitter, TikTok, RSS feeds, and additional skins like Masonry grids and more.
<h3>How it works</h3>
<ol>
<li>Connect your Facebook Page (requires Page ID and Access Token)</li>
<li>Add the <code>[socialeyes]</code> shortcode to any page or post</li>
<li>Posts are fetched from Facebook’s Graph API and cached for performance</li>
<li>Visitors see a beautiful masonry grid of your latest posts</li>
<li>Click any post to view full content in a modal</li>
</ol>
Posts are cached for 30 minutes by default (configurable in settings). SocialEyes fetches fresh posts automatically when the cache expires.
<h3>Key features</h3>
Modular architecture 
— sources and skins are discovered automatically. Drop new modules into folders and they appear in the admin panel. No code changes needed.
Facebook source 
— fetch posts from any Facebook Page you manage. Control image handling (prefer images, all posts, or images only) and number of posts to fetch.
Masonry skin (after Pin Interest model) 
— 3 columns of posts visible on desktop, 1 on mobile. Click to expand, swipe gestures, keyboard navigation. Infinite loop for seamless browsing.
Theme system 
— light and dark themes with CSS variables. Force a theme via shortcode or let users’ system preferences decide. Full customization available via CSS.
Performance optimized 
— feeds are cached in WordPress transients. Configurable cache duration (5 minutes to 24 hours). AJAX loading prevents page blocking.
Clean admin panel 
— tabbed interface organized by Settings, Themes, and Sources. Clear separation of concerns makes configuration intuitive.
<h3>Roadmap</h3>
v1.0.4 — Standalone JavaScript widget (use outside WordPress) 
v1.1 — Instagram Business integration 
v1.2 — Twitter/X integration 
v1.3 — Grid skin 
v1.4 — Multi-source feed mixing
<h3>Getting your Facebook credentials</h3>
Page ID: 
1. Go to your Facebook Page 
2. Click About in the left sidebar 
3. Scroll down to find your Page ID
Access Token: 
1. Go to <a href="https://developers.facebook.com/" rel="nofollow ugc">Facebook Developers</a> 
2. Create an app or use an existing one 
3. Add the Pages product 
4. Generate a Page Access Token with <code>pages_read_engagement</code> permission 
5. For long-lived tokens, exchange your short-lived token using the Token Debugger
<h3>External Services</h3>
This plugin connects to the Facebook Graph API to fetch posts from Facebook Pages.
What is sent: 
– Your Facebook Page ID 
– Your Facebook Access Token 
– Request parameters (number of posts, fields to retrieve)
When data is sent: 
– When the plugin fetches posts from Facebook (every 30 minutes by default, or when cache expires) 
– Data is sent from your WordPress server to Facebook’s servers 
– No visitor data is sent to Facebook – only your server-side credentials
Service information: 
– Service: Facebook Graph API (provided by Meta Platforms, Inc.) 
– Privacy Policy: https://www.facebook.com/privacy/policy/ 
– Terms of Service: https://www.facebook.com/terms.php 
– Developer Terms: https://developers.facebook.com/terms
The plugin does not send any visitor information to Facebook. It only fetches publicly available posts from Pages you manage using your own API credentials. All communication happens server-side between your WordPress installation and Facebook’s API.

SocialEyes

Display social media feeds from Facebook, Instagram, and other platforms in beautiful, customizable skins.

Social Feed Ez vs SocialEyes