A WordPress plugin that lets each author connect to their Bluesky account.
Updated March 20, 2026 (version 1.2.0) | How to install or update safely
Let each author at your WordPress website connect to their Bluesky account. When they publish a post, it is sent to their Bluesky account. (There is a 1 to 2+ minute delay depending on whether a token has expired and/or if something like the image upload fails at first.)
Here’s how it works
1. Connecting Bluesky Account
Each author can connect their Bluesky account by using the provided shortcode [bsky_connect]. This renders a connection form for the author to connect or disconnect their Bluesky account.
2. Scheduling Auto-Post
When a post is published, the plugin schedules an auto-post to Bluesky with a delay of 1 minute using the wilcosky_bsky_schedule_auto_post function.
3. Auto-Posting to Bluesky
The wilcosky_bsky_auto_post function is triggered to perform the following steps:
- Check Post Status: Ensure the post is published and not already posted.
- Retrieve Post and User Meta: Get the post details and user meta information.
- Check Open Graph Data: Retrieve Open Graph data (title, description, and image) from the post link.
- Upload Image (if available): If an Open Graph image is found, upload it to Bluesky.
- Prepare Post Data: Prepare the data for posting, including text and embed (if image is uploaded).
- Post to Bluesky: Attempt to post the data to Bluesky.
- Token Handling: If the token is expired, the refresh token is used. If the refresh token is also expired, re-authentication is performed.
4. Retry Mechanism
If the initial posting attempt fails:
- First Attempt: The plugin will try to post again after a short delay.
- Second Attempt: If the first retry fails, it will attempt again.
- Third Attempt: As a foolproof mechanism, a third attempt will be made.
5. Frontend Log
Authors can view a log of their auto-post attempts, including any errors or successful posts, directly from the frontend.
6. Disconnecting Bluesky Account
Authors can disconnect their Bluesky account using the disconnect form rendered by the [bsky_connect] shortcode. This will remove all stored session tokens and credentials.
Now, each author at your multi-author blog can send their posts to their Bluesky account.
Changelog
March 2026 – v1.2.0
- Bluesky API changes
- Upgrading logging
April 2025 – v1.1.0
- Stable, well-tested version launched







