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.

EdwardBock

Palasthotel GmbH

It’s best practise to have only a very few page requests. This plugin aggregates all your local JavaScript files to two requests only.
<h3>Arbitrary section</h3>

Aggregator

Aggregates Javascript files to a footer and header file.

SocialEyes vs Aggregator