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.

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