BlueFeed
| 开发者 | alexhedstrom |
|---|---|
| 更新时间 | 2026年6月26日 14:03 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
BlueFeed lets you embed your Bluesky feed anywhere on your WordPress site using the
[bluefeed] shortcode. Choose from five beautiful layouts:
- Classic – A familiar social-media timeline look
- Cards – A responsive card grid, great for visual content
- Compact – A minimal, space-efficient list view
- Images – A square image grid showing only posts with images, with hover overlays for stats
- Videos – A card-style video grid showing only posts with videos, with natural portrait/landscape thumbnails and a play overlay on hover
- 5 layout styles (classic, cards, compact, images, videos)
- Gutenberg block with live preview and full settings panel
- Configurable column count for grid layouts
- Profile header with avatar, banner, bio, and stats
- Clickable links and @mentions auto-linked
- Follow button linking to the Bluesky profile
- Color customization via admin settings or per-shortcode attributes
- Automatic caching with configurable duration for fast page loads
- Stale-cache fallback. Serves cached content if the API is temporarily unreachable
- Test Connection button in admin to diagnose API connectivity
- Compatible with page builders (Breakdance, Elementor, Beaver Builder, etc.)
- Responsive design for all screen sizes
- Translation-ready
- Works with the public Bluesky API. No authentication required
layout– classic, cards, compact, images, or videos (default: classic)count– Number of posts (default: 9, max 100)handle– Override the Bluesky handle from settingscolumns– Grid columns for images, cards, and videos layouts (default: 3)gap– Space between posts/cards in pixels (default: auto per layout)border_radius– Corner rounding in pixels (default: 12, use 0 for square)border_width– Border thickness in pixels (default: 1, images layout defaults to 0)show_header– Show profile header: true/false (default: true)show_replies– Include replies in the feed: true/false (default: false; not used by images or videos layouts)show_images– Show images in classic/cards layouts: true/false (default: false)show_videos– Show video thumbnails in classic/cards layouts: true/false (default: false)show_follow– Show follow button: true/false (default: true)show_caption– Show post caption on hover in images layout: true/false (default: false)show_avatar– Show post author avatar: true/false (default: true)show_name– Show post author display name: true/false (default: true)show_handle– Show post author @handle: true/false (default: true)show_time– Show post timestamp: true/false (default: true)show_stats– Show stats bar (replies, reposts, likes) on all layouts including images overlay: true/false (default: true)
card_bg,placeholder_bg,post_text,meta_text,card_borderlink_color,link_hover,row_hover_bg,header_namefollow_text,follow_bg,follow_border,follow_hover_text,follow_hover_bg
安装:
- Upload the
bluefeedfolder to/wp-content/plugins/ - Activate the plugin through the 'Plugins' menu in WordPress
- Go to Settings → BlueFeed and enter your Bluesky handle
- Add the
[bluefeed]shortcode to any page or post
屏幕截图:
常见问题:
Do I need a Bluesky account?
You need a Bluesky handle to display a feed. The plugin uses the public API to fetch posts. No App Password or authentication is required.
Can I show multiple feeds on one page?
Yes! Use the handle parameter to show different accounts:
[bluefeed handle="user1.bsky.social"]
[bluefeed handle="user2.bsky.social"]
How does the Images layout work?
The Images layout automatically filters to only show posts that contain images (including gallery carousels), displaying them in a square grid. When visitors hover over an image, they see the reply, repost, and like counts.
How does the Videos layout work?
The Videos layout filters to only show posts that contain videos, using the same card body as the Cards layout. Video thumbnails keep their natural aspect ratio (portrait or landscape). A play overlay appears on hover. Clicking a thumbnail opens the post on Bluesky. You can also show video thumbnails inline in classic/cards layouts using show_videos="true".
Can I customize the colors?
Yes. You can set global default colors in Settings → BlueFeed → Color Customization, or override colors per-shortcode using color attributes like card_bg="#1a1a2e".
The feed shows a connection error. What should I do?
Go to Settings → BlueFeed and click Test Connection. This will tell you whether your server can reach the Bluesky API. If it times out, your hosting provider may be blocking outbound HTTPS requests. Contact them to whitelist public.api.bsky.app.
How does caching work?
Feed data is cached for 15 minutes by default (configurable in settings). If the API is temporarily unreachable, the plugin serves the last cached data instead of showing an error.
Is the plugin translatable?
Yes. BlueFeed is fully translation-ready. All user-facing strings in the admin settings page, Gutenberg block editor, and front-end output use the bluefeed text domain. Translators can use the included languages/bluefeed.pot template, or contribute translations via translate.wordpress.org.
更新日志:
1.0.15
- Added WordPress Dashboard widget — cache duration, cached entry count, API status, plus clear cache and test connection buttons
- Improved cache management for object-cache installs — registry tracks transient keys for accurate dashboard counts, reliable clear cache, and complete uninstall cleanup
- Enforced server-side limits for cache duration (max 86400s) and shortcode columns (1–6)
- Fixed get_profile() to check HTTP status codes before parsing the response, matching feed fetch behavior
- Redesigned admin settings page to match bluefeed.social — hero header, pill tabs, modern cards, and a new Support tab
- Refreshed layout and spacing across all admin tabs — improved alignment, input sizing, Colors section headings, and Shortcodes examples styling
- Improved settings saved notices — floating toast with dismiss and auto-close that does not push content down; your active tab stays selected after save
- Gutenberg block now uses global plugin settings for post count and post element visibility unless you override them in the block panel
- New Videos layout – card-style grid showing only posts with videos, with natural portrait/landscape thumbnails and play overlay on hover
- Added
show_videosshortcode parameter and block toggle for inline video thumbnails in classic and cards layouts - Video badge in compact layout; video thumbnails in cards layout image area
- Cards layout swipeable carousel for posts with multiple images or gallery embeds
- Added gallery carousel embed support for the images layout
- Fixed missing stats icons on cards and videos layouts; play button overlay on video thumbnails (hover)
- Fixed
show_handlenot rendering on cards and videos layouts - Validate Bluesky handle on save and in Test Connection
- Clean up transient timeout rows on cache clear and uninstall
- Hardened plugin bootstrap (guarded constants, static activation hooks)
- Fixed small bugs
- Added language translation support with full text-domain
- Added
bluefeed.pottemplate for translators - Added Bluesky handle/DID validation before API calls
- Fixed profile header banner image not displaying on WordPress 7.0 beta.
- Added
show_avatarshortcode parameter and admin setting to show/hide post author avatars (default: true) - Added
show_nameshortcode parameter and admin setting to show/hide post author display names (default: true) - Added
show_handleshortcode parameter and admin setting to show/hide post author @handles (default: true) - Added
show_timeshortcode parameter and admin setting to show/hide post timestamps (default: true) - Added
show_statsshortcode 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
gapshortcode 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_radiusshortcode 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_widthshortcode 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
- Fixed copy-to-clipboard icons missing on the admin settings page
- Initial release
- Four layout styles: classic, cards, compact, images
- Profile header with stats
- Caching system
- Public API integration