BlueBook Feed Sync

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.

Hide FAQ

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