bluesky-Connector/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](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`