eugenewebdoctor/bluesky-Connector
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity
A WordPress plugin for publishing posts to Bluesky with customizable formatting, image handling, and queue management.
7 Commits 2 Branches 2 Tags 85 KiB
PHP 91.5%
JavaScript 7.2%
CSS 1.3%
master
Go to file
enki 7225d76549 readme update.
2024-12-17 15:08:34 -08:00
.vscode Major cleanup: Image handling fixes and plugin updates 2024-12-17 15:00:47 -08:00
admin Initial commit 2024-11-21 01:05:37 -08:00
assets Major cleanup: Image handling fixes and plugin updates 2024-12-17 15:00:47 -08:00
includes Major cleanup: Image handling fixes and plugin updates 2024-12-17 15:00:47 -08:00
templates Major cleanup: Image handling fixes and plugin updates 2024-12-17 15:00:47 -08:00
.gitignore readme update. 2024-12-17 15:08:34 -08:00
bluesky-connector.php Major cleanup: Image handling fixes and plugin updates 2024-12-17 15:00:47 -08:00
README.md readme update. 2024-12-17 15:08:34 -08:00

README.md

=== 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

== 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