BlueBook Feed Sync

描述

BlueBook Feed Sync is a professional WordPress plugin that displays your social page feed with multiple layouts, full customization, multi-feed management, and an interactive lightbox. Easy setup, fully customizable, and lightweight. Multiple layouts, interactive lightbox, video support, and multi-feed management.

Multi-Feed Manager

Create unlimited feeds, each with their own settings. Perfect for sites that need different feeds on different pages.

  • Feed selector dropdown to switch between feeds
  • Create, duplicate, rename, and delete feeds
  • New feeds automatically inherit connection settings from the primary feed
  • Per-feed shortcodes with unique ID
  • Override any setting directly in the shortcode

Layouts

  • List — Single-column vertical feed (max-width 960px)
  • Masonry — Pinterest-style multi-column grid
  • Carousel — Multi-card horizontal slider with snap-based swipe navigation, dot indicators, and arrow buttons
  • Boxed — Clean CSS Grid layout with subtle borders

Header Styles

Visual Header with 4 layout presets: Classic, Compact, Banner, and Clean.

Text Header with Facebook icon and custom text.

Both header types support custom backgrounds (theme, solid color, gradient, transparent), page name override, show bio toggle, and bio/description override.

Lightbox

All posts open in a split-layout lightbox with full-size image or inline video, post text, author info, engagement stats, thumbnail strip for multi-photo galleries, arrow and swipe navigation, and keyboard support. Infinite scroll — when you reach the last loaded post, the next batch loads automatically so you can keep browsing without leaving the lightbox. Text-only posts display in a clean full-width layout instead of a split view.

Video Support

  • YouTube — Auto-detected from shared links with privacy-enhanced embedding
  • Facebook Videos — Thumbnail with play button, embedded via Facebook plugin

Color System

Three built-in schemes (Inherit, Light, Dark) plus a full custom palette with 9 individually configurable colors.

Third-Party Services

This plugin connects to external services to retrieve and display social media content. No data is sent without your explicit configuration.

Facebook Graph API

Used to fetch page posts, page info (name, bio, avatar, cover photo), and to verify your access token.

Data sent: your Facebook Page ID and Page Access Token. Requests are made server-side when the feed cache expires or when you click “Verify Connection” in the admin panel.

Facebook SDK (JavaScript)

Loaded on the front end to render the optional Like Box (Facebook Page Plugin widget).

Facebook Video Embed

When a visitor clicks play on a Facebook video, the video is embedded via an iframe from Facebook’s servers.

YouTube

When your Facebook posts contain YouTube links, the plugin loads the YouTube iframe API to enable inline video playback and fetches thumbnail images from YouTube’s servers.

The YouTube iframe API script (https://www.youtube.com/iframe_api) is loaded on pages that display the feed. Thumbnail images are fetched from https://img.youtube.com/. Video embeds use the privacy-enhanced domain https://www.youtube-nocookie.com/.

区块

该插件提供了 1 个区块.

  • BlueBook Feed Display a customizable social page feed.

安装

  1. Download bluebook-feed-sync.zip.
  2. In WordPress admin, go to Plugins > Add New > Upload Plugin.
  3. Upload the zip file and click Install Now.
  4. Activate the plugin.
  5. Go to BlueBook Feed in the admin menu to configure your connection.

常见问题

How do I get a Facebook Access Token?

You need to create a Meta (Facebook) App at developers.facebook.com, then use the Graph API Explorer to generate a Page Access Token. See the full guide in the plugin’s admin page or the included README.md.

Can I display multiple feeds on the same site?

Yes. Use the Multi-Feed Manager to create additional feeds, each with their own settings. Display them using the shortcode with an ID parameter, e.g. [bbfsync_feed id="2"].

Can I override settings in the shortcode?

Yes. Any setting key can be used as a shortcode attribute, e.g. [bbfsync_feed layout="carousel" posts_desktop="6" color_scheme="dark"].

How does caching work?

The plugin caches API responses to minimize Facebook API calls. You can clear the cache from the Connect tab in the plugin settings (under “Advanced”). The minimum cache duration is 15 minutes.

评价

此插件暂无评价。

贡献者及开发者

「BlueBook Feed Sync」是开源软件。 以下人员对此插件做出了贡献。

贡献者

更新日志

3.9.28

  • New: Text Preview Lines setting — limits post text in grid layouts (masonry, boxed, carousel) to keep cards compact
  • New: Expand indicator (line with caret) appears below clamped text — click to expand inline
  • New: Setting configurable per feed (0–20 lines, default 14, 0 = unlimited), also available as shortcode attribute and Gutenberg block control
  • Improved: Mobile single-column layouts lift the text clamp for full readability
  • Improved: “See more” link hidden in grid layouts — lightbox and expand indicator handle full text

3.9.27

  • Improved: Setup guide Step 3 now clarifies that a User token (not Page token) must be selected, and that your own app must be chosen
  • Improved: Setup guide Step 4 adds easier recommended method via Access Token Debugger “Extend Access Token” button
  • Improved: Setup guide Step 5 now uses direct Page ID URL instead of /me/accounts for more reliable token retrieval
  • Improved: Added troubleshooting tip for “Error validating client secret” in Step 4
  • Fixed: Header followers label now uses the customizable “Followers label” setting from Components tab

3.9.26

  • Improved: Simplified “Find your Page ID” step — now uses Graph API Explorer for quick lookup

3.9.25

  • Improved: Setup guide now correctly explains the 3-step token process (short-lived long-lived User permanent Page)
  • Improved: Added link to Access Token Debugger for verifying token permanence
  • Improved: Each setup step links to the exact tool or page where it is performed

3.9.24

  • Removed debug HTML comment from follow card output
  • Fixed double-escaping in follow card CSS class builder
  • Fixed stale version fallback in block asset file

3.9.23

  • New: Like Box replaced with custom follow card — no longer depends on Facebook’s deprecated Page Plugin SDK
  • The follow card uses Graph API data (avatar, page name, follower count) and renders reliably at all sizes
  • Cover photo shown in Large mode, all existing settings (position, size, display mode, width) still apply
  • Removed Facebook JS SDK dependency — one fewer external script loaded on the frontend

3.9.22

  • Fixed: Lightbox prev/next navigation arrows now visible on text-only posts
  • Fixed: Text-only lightbox no longer stretches to full viewport height — shrinks to fit content on all screen sizes

3.9.21

  • New: Infinite lightbox browsing — next batch of posts loads automatically when you reach the last post
  • New: Text-only posts display in a clean full-width lightbox layout instead of an empty black media panel
  • New: Customisable Mute, Unmute, and Fullscreen button labels in Features Labels & Text
  • Fixed: Per-feed CSS scoping — multiple feeds with different custom colours on the same page no longer conflict
  • Fixed: Reset palette defaults now match the settings defaults exactly
  • Fixed: Version consistency across .pot file and all plugin surfaces
  • Changed: README.md excluded from distribution zip

3.9.20

  • Fixed: Page name now displays correctly when entered manually in text header mode
  • Fixed: Bio display logic made consistent across all header styles
  • Fixed: Lightbox now renders above sticky headers and page builder containers
  • Improved: Facebook Graph API version centralised as a single constant for easier updates
  • Improved: API retry logic now logs failures and successes when WP_DEBUG_LOG is enabled
  • Improved: Dark color scheme error message styling
  • Changed: Legacy migration now runs only on plugin activation instead of every page load

3.9.18

  • New: Like Box display mode setting — Always visible or Reveal on scroll
  • Reveal on scroll: Like Box is hidden initially and fades in when the user scrolls near the bottom of the feed
  • Display mode option only shown when Like Box position is set to Bottom
  • Admin UI shows contextual description for each display mode

3.9.17

  • Improved: Load More button now meets WCAG AAA touch target (44px minimum height)
  • Improved: Button has larger padding, font size, and subtle shadow for better visibility
  • Changed: Like Box and Load More button no longer share the same footer bar — Like Box renders independently above the sticky Load More bar for clearer visual separation

3.9.16

  • Fixed: Video playback now works on iPad and mobile devices
  • Touch devices open lightbox for video instead of broken inline embed
  • All Facebook videos (landscape + portrait) show play button on touch devices
  • Safari/WebKit: Facebook videos open directly on Facebook (iOS ITP workaround)
  • Customizable Safari video hint text in admin settings
  • Stale-cache fallback: feed remains visible when API is temporarily unavailable
  • “Last successful fetch” timestamp shown in admin cache settings

3.7.2

  • Carousel video no longer cropped by 220px height limit — shows full frame in natural proportions
  • Portrait and landscape videos both display uncropped in carousel

3.7.1

  • Video thumbnails now display full frame without cropping (object-fit: contain)
  • Removed fixed height constraint on carousel video — shows natural proportions
  • Container dimensions locked from thumbnail before iframe replacement

3.7.0

  • One-click video playback on all browsers — autoplay with mute for reliable instant play
  • Facebook video in lightbox now fills entire media area for immersive viewing
  • Applies to both feed/carousel and lightbox video embeds

3.6.3

  • Lightbox video loads iframe directly (no thumbnail step) — eliminates double-click on mobile
  • Portrait video in lightbox now centered horizontally instead of left-aligned
  • Removed “Watch on Facebook” overlay from lightbox video embeds

3.6.1

  • Tightened gallery gap from 4px to 2px for cleaner, more professional image grids

3.6.0

  • Pro gallery grid: 6-column CSS Grid matching Facebook/Smash Balloon layout patterns
  • 2 images: equal side-by-side; 3: large left + 2 stacked right; 4: 2×2; 5+: 2 top + 3 bottom
  • Up to 5 visible images per gallery with +N overlay on last
  • Subtle inset border on gallery cells (Facebook-style depth)
  • All images use object-fit: cover for consistent look with mixed portrait/landscape

3.5.9

  • Redesigned gallery grid: 2 side-by-side, 3 L-shape, 4 as 2×2, 5+ as 2-top/3-bottom (Facebook pattern)
  • Gallery now shows up to 5 visible images with +N overlay for remaining
  • Improved gallery proportions and spacing across all layouts

3.5.8

  • Fixed multi-image posts: explicit subattachment fields in API request and fallback for multiple attachments
  • Increased subattachment limit to 25 images per post

3.5.7

  • Facebook-inspired gallery grid: 2 images side-by-side, 3 images L-shaped, 4+ with top hero and thumbnail row
  • Gallery uses CSS Grid with center-crop for consistent layout across all image orientations
  • +N overlay on last visible image when posts contain more than 4 photos
  • Carousel layout now accommodates gallery grids with adaptive height
  • Portrait video thumbnails use 4:5 aspect ratio matching Facebook feed standard
  • Cleaned up duplicate play button CSS and legacy portrait video placeholder rules

3.5.6

  • Gallery main image capped at 400px height for consistent layout with mixed portrait/landscape images
  • Gallery thumbnails increased from 100px to 120px height

3.5.5

  • Fixed portrait video playback: container height locked before iframe replaces thumbnail
  • Portrait videos in lightbox now render in correct aspect ratio
  • Portrait video detection propagated to lightbox for consistent display

3.5.4

  • Portrait video thumbnails now display in natural aspect ratio instead of being cropped to 16:9

3.5.3

  • Added “Loading Text” admin setting for Load More button loading state

3.5.2

  • Added “Watch on Facebook” fallback link for copyright-blocked video embeds
  • Fallback appears on hover in feed, always visible in lightbox

3.5.1

  • Added esc_attr() wrappers on assembled style attributes for Plugin Check compliance
  • Added esc_url() in linkify() for proper URL escaping in href attributes
  • Added phpcs:ignore comments for pre-escaped concatenated output
  • Added “No posts found” admin-only message for empty feeds
  • Prefixed uninstall.php variables for codesniffer compliance

3.5.0

  • Admin panel redesign: reduced from 4 tabs to 3 (Connect, Appearance, Features)
  • Header settings moved into Appearance tab as a section (no longer a separate tab)
  • Content settings (page name, bio, avatar, cover) shown directly without accordion
  • Mobile header toggles shown inline (removed Mobile accordion)
  • Backwards-compatible URL mapping for old tab names (layout-style, header)

3.4.3

  • Added constant definition guards to prevent redefinition errors
  • Fixed unprepared DB query in legacy migration (now uses $wpdb->prepare)
  • Added privacy policy suggestion via wp_add_privacy_policy_content()
  • Removed hardcoded BBFSYNC_LAST_UPDATED constant

3.4.2

  • Whitespace cleanup across PHP, CSS, and JS files

3.4.1

  • Fixed unprefixed variables in uninstall.php
  • Added missing contributor to readme.txt

3.4.0

  • Admin panel UX redesign: reorganised from 6 tabs to 4 (Connect, Layout & Style, Header, Features)
  • Client-side tab switching — no page reloads when navigating between settings tabs
  • Header tab now uses collapsible accordion sections (Content, Background, Typography, Mobile)
  • Features tab merges Sections and Lightbox into card-based toggles with enable/disable switches
  • Layout & Style tab merges Layout and Colours into one tab with clear visual sections
  • Connect tab: collapsible Advanced section for cache settings, auto-expanding setup guide
  • Two-row feed management bar with shortcode badge and copy button
  • Sticky save button with unsaved changes indicator
  • Connection status banner shows setup progress at a glance
  • Unsaved changes warning when navigating away from modified settings
  • Backwards-compatible URL mapping for old tab names

3.3.0

  • Fixed Facebook video playback (black screen on play) with direct iframe embed
  • Added feed Export/Import functionality in admin panel
  • Added header text color option for text-style headers
  • Fixed inline SVG icons being stripped by output escaping

3.2.0

  • Added lightbox image counter for multi-photo posts
  • Security hardening: feed management actions use POST requests
  • Mobile carousel improvements (auto-height images, swipe navigation)
  • Added mobile-specific toggles for header page name and bio visibility
  • Two-level lightbox navigation: images within posts, then between posts
  • WordPress.org audit compliance improvements

3.0.0

  • Multi-Feed Manager — Create unlimited feeds with individual settings
  • Feed selector dropdown with create, duplicate, rename, delete
  • Per-feed shortcodes with ID parameter
  • Shortcode attribute overrides for any setting
  • New feeds inherit API connection from primary feed

2.9.0

  • Header redesign with 4 visual styles (Classic, Compact, Banner, Clean)
  • Header backgrounds: Theme, Solid color, Gradient, Transparent
  • Visual style picker with mini preview cards in admin
  • Show Bio toggle shared across header types

2.8.0

  • Header style picker with visual preview cards
  • Text header: transparent background option, custom text size
  • Visual header: reorganised settings with size/color controls

2.7.0

  • Dark color scheme with OLED-friendly pure grey palette
  • Reset to Default button for custom color palette

2.6.0

  • Sticky footer bar combining Like Box and Load More

2.5.0

  • Carousel swipe with snap-based passive touch navigation
  • List layout width increased to 960px

2.4.0

  • Multi-card carousel with responsive columns
  • Dot pagination and arrow navigation

2.0.0

  • Touch swipe in lightbox
  • Facebook video iframe embed
  • Video touch zones for mobile

1.9.0

  • YouTube auto-detection and click-to-play

1.8.0

  • Universal post lightbox with split layout

1.7.0

  • 9-color customization system

1.6.0

  • Boxed layout, author links, image galleries, engagement bar

1.5.0

  • Carousel slider, video lightbox, cursor-based pagination

1.0.0

  • Initial release with List and Masonry layouts