Documentation

Changelog

Added show_avatar shortcode parameter and admin setting to show/hide post author avatars (default: true)
Added show_name shortcode parameter and admin setting to show/hide post author display names (default: true)
Added show_handle shortcode parameter and admin setting to show/hide post author @handles (default: true)
Added show_time shortcode parameter and admin setting to show/hide post timestamps (default: true)
Added show_stats shortcode parameter and admin setting to show/hide the stats bar (replies, reposts, likes) on all layouts including the images overlay (default: true)
New “Post Elements” checkboxes in admin under Layout & Spacing to set global defaults for avatar, name, handle, timestamp, and stats visibility
All new visibility options available as Gutenberg block toggle controls in the Visibility panel

Added Gutenberg block (BlueFeed) with live preview, full settings panel (layout, display, visibility, colors), and server-side rendering

Frontend CSS is now only loaded on pages that use the BlueFeed shortcode or block

Added circuit breaker for Bluesky API requests. When the API is unresponsive, the plugin now serves cached content instantly instead of waiting for the request to time out
Added a long-lived stale backup cache (24 hours) so cached data survives beyond the normal cache TTL during extended outages

After a failed API call, subsequent requests skip the API for 5 minutes and serve stale cache immediately, eliminating slow page loads when Bluesky is down

Redesigned admin settings page with a tabbed navigation (General, Layout & Spacing, Colors, Shortcodes) for easier navigation

Fixed profile header breaking when the Bluesky profile has no banner image. The banner area now always renders with a placeholder background color so the avatar is not cut off
Fixed bare domain URLs without a protocol (e.g. example.com) not being clickable in the profile bio and post text

Added configurable gap/spacing between posts in classic, cards, and images layouts
New “Card Gap” setting in admin (Settings → BlueFeed → Layout & Spacing)
New gap shortcode parameter to override spacing per-shortcode (e.g. [bluefeed layout="cards" gap="24"])
Each layout retains its own default spacing when no gap is set (Classic: 12px, Cards: 16px, Images: 4px)
Added configurable border radius for all card/post elements
New “Border Radius” setting in admin (Settings → BlueFeed → Layout & Spacing)
New border_radius shortcode parameter (e.g. [bluefeed border_radius="0"] for square corners)
Added configurable border width for all card/post/divider borders
New “Border Width” setting in admin (Settings → BlueFeed → Layout & Spacing)
New border_width shortcode parameter (default: 1px, images layout defaults to 0)
URLs, @mentions, and #hashtags are now clickable in the profile bio
Added #hashtag linking in post text. Links to Bluesky hashtag search
URLs in posts and bio now display without the http/https prefix for cleaner appearance
Layout & Spacing settings moved to their own admin section with a dedicated reset button

Fixed compact layout hover background bleeding outside rounded corners on first and last rows
Fixed card image radius gap when using larger border widths
Fixed double line-break spacing in profile bio when URLs or domains are present

Added “View Details” link on the Plugins page that opens the WordPress.org plugin information modal

Added External services section to readme for third-party API disclosure compliance

Fixed copy-to-clipboard button showing both icons at the same time before being clicked

Improved compact layout – tighter spacing, smaller avatars, and single-line flow for name and time on both desktop and mobile