{"id":313326,"date":"2026-06-13T05:24:17","date_gmt":"2026-06-13T05:24:17","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/feedworks\/"},"modified":"2026-06-13T05:23:46","modified_gmt":"2026-06-13T05:23:46","slug":"socialeyes","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/socialeyes\/","author":23487865,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.3","stable_tag":"1.0.3","tested":"7.0","requires":"5.0","requires_php":"7.4","requires_plugins":null,"header_name":"SocialEyes","header_author":"The SaaS Factory","header_description":"Modular social feed aggregator - displays Social Networks posts in beautiful presentations","assets_banners_color":"","last_updated":"2026-06-13 05:23:46","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/thesaasfactory.com\/socialeyes","header_author_uri":"https:\/\/thesaasfactory.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":27,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.3":{"tag":"1.0.3","author":"thesaasfactory","date":"2026-06-13 05:23:46"}},"upgrade_notice":{"1.0.2":"

Minor code quality improvements. Recommended update.<\/p>","1.0.1":"

WordPress.org compliance fixes. Recommended update for all users.<\/p>","1.0.0":"

Initial release. Display Facebook Page posts in a beautiful template.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3570845,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.3"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[5636,157,252,311,154],"plugin_category":[56],"plugin_contributors":[262541],"plugin_business_model":[],"class_list":["post-313326","plugin","type-plugin","status-publish","hentry","plugin_tags-aggregator","plugin_tags-facebook","plugin_tags-feed","plugin_tags-instagram","plugin_tags-social-media","plugin_category-social-and-sharing","plugin_contributors-thesaasfactory","plugin_committers-thesaasfactory"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/socialeyes\/assets\/icon-256x256.png?rev=3570845","icon_2x":"https:\/\/ps.w.org\/socialeyes\/assets\/icon-256x256.png?rev=3570845","generated":false},"screenshots":[],"raw_content":"\n

SocialEyes<\/strong> is a modular social feed aggregator that displays posts from Facebook, Instagram, Twitter, and other platforms in beautiful skin styles on your WordPress site.<\/p>\n\n

Current version includes:<\/strong><\/p>\n\n

\u2014 Facebook integration<\/strong> \u2014 display posts from any Facebook Page you manage\n\u2014 Masonry skin<\/strong> \u2014 Pinterest-style grid, 3 columns on desktop, 2 on tablet, 1 on mobile\n\u2014 Light and dark themes<\/strong> \u2014 automatic system preference detection or force a specific theme\n\u2014 Click to expand<\/strong> \u2014 full post modal with images and complete text\n\u2014 Auto-advance<\/strong> \u2014 optional automatic rotation on mouseover\n\u2014 Customizable via CSS variables<\/strong> \u2014 full control over colors and styling<\/p>\n\n

SocialEyes is built with a modular architecture. Future updates will add Instagram, Twitter, TikTok, RSS feeds, and additional skins like Masonry grids and more.<\/p>\n\n

How it works<\/h3>\n\n
    \n
  1. Connect your Facebook Page (requires Page ID and Access Token)<\/li>\n
  2. Add the [socialeyes]<\/code> shortcode to any page or post<\/li>\n
  3. Posts are fetched from Facebook's Graph API and cached for performance<\/li>\n
  4. Visitors see a beautiful masonry grid of your latest posts<\/li>\n
  5. Click any post to view full content in a modal<\/li>\n<\/ol>\n\n

    Posts are cached for 30 minutes by default (configurable in settings). SocialEyes fetches fresh posts automatically when the cache expires.<\/p>\n\n

    Key features<\/h3>\n\n

    Modular architecture<\/strong>\n\u2014 sources and skins are discovered automatically. Drop new modules into folders and they appear in the admin panel. No code changes needed.<\/p>\n\n

    Facebook source<\/strong>\n\u2014 fetch posts from any Facebook Page you manage. Control image handling (prefer images, all posts, or images only) and number of posts to fetch.<\/p>\n\n

    Masonry skin (after Pin Interest model)<\/strong>\n\u2014 3 columns of posts visible on desktop, 1 on mobile. Click to expand, swipe gestures, keyboard navigation. Infinite loop for seamless browsing.<\/p>\n\n

    Theme system<\/strong>\n\u2014 light and dark themes with CSS variables. Force a theme via shortcode or let users' system preferences decide. Full customization available via CSS.<\/p>\n\n

    Performance optimized<\/strong>\n\u2014 feeds are cached in WordPress transients. Configurable cache duration (5 minutes to 24 hours). AJAX loading prevents page blocking.<\/p>\n\n

    Clean admin panel<\/strong>\n\u2014 tabbed interface organized by Settings, Themes, and Sources. Clear separation of concerns makes configuration intuitive.<\/p>\n\n

    Roadmap<\/h3>\n\n

    v1.0.4<\/strong> \u2014 Standalone JavaScript widget (use outside WordPress)\nv1.1<\/strong> \u2014 Instagram Business integration\nv1.2<\/strong> \u2014 Twitter\/X integration
    \nv1.3<\/strong> \u2014 Grid skin\nv1.4<\/strong> \u2014 Multi-source feed mixing<\/p>\n\n

    Getting your Facebook credentials<\/h3>\n\n

    Page ID:<\/strong>\n1. Go to your Facebook Page\n2. Click About<\/strong> in the left sidebar\n3. Scroll down to find your Page ID<\/p>\n\n

    Access Token:<\/strong>\n1. Go to Facebook Developers<\/a>\n2. Create an app or use an existing one\n3. Add the Pages<\/strong> product\n4. Generate a Page Access Token with pages_read_engagement<\/code> permission\n5. For long-lived tokens, exchange your short-lived token using the Token Debugger<\/p>\n\n

    External Services<\/h3>\n\n

    This plugin connects to the Facebook Graph API to fetch posts from Facebook Pages.<\/strong><\/p>\n\n

    What is sent:<\/strong>\n- Your Facebook Page ID\n- Your Facebook Access Token\n- Request parameters (number of posts, fields to retrieve)<\/p>\n\n

    When data is sent:<\/strong>\n- When the plugin fetches posts from Facebook (every 30 minutes by default, or when cache expires)\n- Data is sent from your WordPress server to Facebook's servers\n- No visitor data is sent to Facebook - only your server-side credentials<\/p>\n\n

    Service information:<\/strong>\n- Service: Facebook Graph API (provided by Meta Platforms, Inc.)\n- Privacy Policy: https:\/\/www.facebook.com\/privacy\/policy\/\n- Terms of Service: https:\/\/www.facebook.com\/terms.php\n- Developer Terms: https:\/\/developers.facebook.com\/terms<\/p>\n\n

    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.<\/p>\n\n\n

      \n
    1. Upload the socialeyes<\/code> folder to \/wp-content\/plugins\/<\/code><\/li>\n
    2. Activate the plugin through the Plugins<\/strong> menu in WordPress<\/li>\n
    3. Go to SocialEyes<\/strong> in the admin menu<\/li>\n
    4. Navigate to Sources<\/strong> tab and enter your Facebook Page ID and Access Token<\/li>\n

    5. Add the shortcode to any page or post:<\/p>\n\n

      [socialeyes source=\"facebook\" skin=\"masonry\"]<\/p><\/li>\n<\/ol>\n\n

      To force a theme, add theme=\"light\"<\/code> or theme=\"dark\"<\/code>:<\/p>\n\n

      [socialeyes source=\"facebook\" skin=\"masonry\" theme=\"dark\"]\n<\/code><\/pre>\n\n\n
      \n
      Do I need a Facebook account?<\/h3><\/dt>\n
      Yes. SocialEyes fetches posts from Facebook Pages via the Graph API. You need to manage the Page you want to display and have API credentials.<\/p><\/dd>\n
      Is SocialEyes free?<\/h3><\/dt>\n
      Yes. This version of SocialEyes is completely free and open source under GPL v2. No external services, no subscriptions, no hidden costs.\nWe are developing a significantly enhanced version of this product - \"SocialEyes Blender\" - which will combine feeds from multiple sources and offer more skin choices etc. This will be a commercial product.\nThis basic free version will always remain.<\/p><\/dd>\n
      What social networks are supported?<\/h3><\/dt>\n
      Version 1.0 supports Facebook Page posts. \nInstagram, Twitter, TikTok, and RSS feeds are coming in future updates.<\/p><\/dd>\n
      Can I customize the appearance?<\/h3><\/dt>\n
      Yes. SocialEyes uses CSS variables for theming. You can override colors in Appearance \u2192 Customize \u2192 Additional CSS<\/strong>:<\/p>\n\n
      :root {\n  --socialeyes-primary: #your-color;\n  --socialeyes-accent: linear-gradient(135deg, #color1, #color2);\n}\n<\/code><\/pre>\n\n
      Full variable reference available in the documentation.<\/p><\/dd>\n
      Does it work with page builders?<\/h3><\/dt>\n
      Yes. The [socialeyes]<\/code> shortcode works anywhere WordPress shortcodes are supported, including Elementor, Divi, Gutenberg (Shortcode block), and all major page builders.<\/p><\/dd>\n
      How often are posts updated?<\/h3><\/dt>\n
      SocialEyes caches posts for 30 minutes by default (configurable in Settings<\/strong>). This reduces API calls and improves performance. Cache is automatically refreshed when expired.<\/p><\/dd>\n
      Can I display multiple sources together?<\/h3><\/dt>\n
      Not yet. Version 1.0 displays one source at a time. Multi-source feed mixing is coming in \"Blender\".<\/p><\/dd>\n
      Will it slow down my site?<\/h3><\/dt>\n
      No. Posts are cached and loaded via AJAX after the page loads. The plugin uses vanilla JavaScript with no dependencies (no jQuery), keeping the footprint small.<\/p><\/dd>\n\n<\/dl>\n\n\n
      1.0.3<\/h4>\n\n
        \n
      • Added: Masonry skin \u2014 Pinterest-style grid layout<\/li>\n
      • Added: SocialEyes Blender promo in admin Skins tab<\/li>\n
      • Improved: Modal close button z-index and image max-height<\/li>\n
      • Improved: Removed unimplemented notifications UI (coming in Blender)<\/li>\n
      • Fixed: Complete rename from FeedWorks to SocialEyes (at the request of wordpress.org)<\/li>\n<\/ul>\n\n
        1.0.2<\/h4>\n\n
          \n
        • Fixed: Added wp_unslash() to $_GET variables as recommended by plugin-check<\/li>\n
        • Improved: Code quality and WordPress coding standards compliance<\/li>\n<\/ul>\n\n
          1.0.1<\/h4>\n\n
            \n
          • Fixed: Proper wp_enqueue usage for scripts<\/li>\n
          • Fixed: Facebook Graph API disclosure in External Services section<\/li>\n
          • Fixed: Nonce sanitization with wp_unslash and sanitize_text_field<\/li>\n
          • Improved: Compliance with WordPress.org plugin guidelines<\/li>\n<\/ul>\n\n
            1.0.0<\/h4>\n\n
              \n
            • Initial public release<\/li>\n
            • Facebook Page integration via Graph API<\/li>\n
            • Masonry skin - Pinterest-style grid, 3 columns on desktop<\/li>\n
            • Light and dark theme support with CSS variables<\/li>\n
            • Auto-advance on hover, click to expand modal<\/li>\n
            • Configurable cache duration and post count<\/li>\n
            • Modular architecture for future expansion<\/li>\n<\/ul>","raw_excerpt":"Display social media feeds from Facebook, Instagram, and other platforms in beautiful, customizable skins.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/313326","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=313326"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/thesaasfactory"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=313326"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=313326"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=313326"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=313326"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=313326"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=313326"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}