126 lines
4.3 KiB
Markdown
126 lines
4.3 KiB
Markdown
=== Share On Bluesky ===
|
|
Contributors: eugenewebdoctor
|
|
Tags: bluesky, social media, cross-posting, atproto
|
|
Requires at least: 5.0
|
|
Tested up to: 6.7
|
|
Requires PHP: 7.4
|
|
Stable tag: 1.0.0
|
|
License: MIT
|
|
License URI: https://opensource.org/licenses/MIT
|
|
|
|
A simple WordPress plugin for automatically sharing your posts to Bluesky with support for featured images and customizable formatting.
|
|
|
|
== Description ==
|
|
|
|
Share On Bluesky is a lightweight WordPress plugin that enables automatic cross-posting to Bluesky. When you publish a post, it automatically shares it to your Bluesky account with proper formatting and image support.
|
|
|
|
= Key Features =
|
|
|
|
* One-click connection to Bluesky using your handle and app password
|
|
* Automatic post sharing when you publish
|
|
* Featured image support with auto-resizing
|
|
* Customizable post format with title and excerpt options
|
|
* Manual post/repost controls from post editor
|
|
* Secure token management with automatic refresh
|
|
|
|
== Installation ==
|
|
|
|
There are two ways to install the Share On Bluesky plugin:
|
|
|
|
= From WordPress Dashboard (Recommended) =
|
|
|
|
1. Go to your WordPress Dashboard > Plugins > Add New
|
|
2. Search for "Share On Bluesky"
|
|
3. Click "Install Now" next to the Share On Bluesky plugin
|
|
4. After installation completes, click "Activate"
|
|
5. Go to Settings > Bluesky to configure your connection
|
|
|
|
= Manual Installation =
|
|
|
|
1. Download the 'share-on-bluesky' plugin from this repo.
|
|
2. Go to your WordPress Dashboard > Plugins > Add New > Upload Plugin
|
|
3. Choose the downloaded zip file and click "Install Now"
|
|
4. After installation completes, click "Activate"
|
|
5. Go to Settings > Bluesky to configure your connection
|
|
|
|
= After Installation =
|
|
|
|
1. Enter your Bluesky handle (username.bsky.social)
|
|
2. Generate and enter an app password from your Bluesky account settings
|
|
3. Choose your preferred post format options
|
|
4. Test by publishing a new post
|
|
|
|
== Frequently Asked Questions ==
|
|
|
|
= Where do I find my Bluesky app password? =
|
|
|
|
You can generate an app password in your Bluesky account settings under "App Passwords". Never use your main account password.
|
|
|
|
= How are images handled? =
|
|
|
|
The plugin automatically uploads your post's featured image to Bluesky when sharing. Images are resized if needed to meet Bluesky's size limits.
|
|
|
|
= Can I manually control what gets posted? =
|
|
|
|
Yes! Each post has a Bluesky status box where you can manually share, retry, or repost content.
|
|
|
|
== Screenshots ==
|
|
|
|
1. Settings page showing connection and format options
|
|
2. Post editor integration with Bluesky status and controls
|
|
|
|
== Changelog ==
|
|
|
|
= 1.0.0 =
|
|
* Initial release
|
|
* Automatic post sharing with featured images
|
|
* Customizable post formatting
|
|
* Manual post controls
|
|
* Secure token management
|
|
|
|
== Privacy Policy ==
|
|
|
|
This plugin connects to Bluesky's servers (bsky.social) to share your posts. It stores:
|
|
* Your Bluesky handle
|
|
* Authentication tokens (securely encrypted)
|
|
* Post sharing status metadata
|
|
|
|
No other personal data is collected or shared.
|
|
|
|
== Credits ==
|
|
|
|
Developed by [Eugene Web Doctor](https://eugenewebdoctor.com)
|
|
|
|
== License ==
|
|
|
|
MIT License
|
|
|
|
Copyright (c) 2024 Eugene Web Doctor
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
SOFTWARE.
|
|
|
|
== Support Development ==
|
|
|
|
If you find this plugin useful, consider supporting its development:
|
|
|
|
Lightning Network:
|
|
`enki@zap.sovbit.host`
|
|
|
|
On-Chain Bitcoin:
|
|
`bc1pe60ykxhl6h8j6w7dpwrn7qzcyay6l52dkfeulkgg72eezgmms3wss3ul42` |