Skip to content

geoffreycrofte/bluesky-social-plugin-for-wordpress

Repository files navigation

Social Integration for BlueSky

Provides auto syndication (optional), a profile banner, and a last posts Gutenberg blocks for BlueSky Social.

Description

This plugin provides your website with Gutenberg blocks including a configurable profile banner (followers, posts and followings counts, banner, avatar, and name) and a list of your latest posts on BlueSky. A Shortcodes ([bluesky_profile] and [bluesky_last_posts]) and Widgets are given as well for older sites.

An option is available for syndication of posts for BlueSky Social.

Some other included features:

  • Embedded posts in the feed
  • Youtube URL detection
  • Embedded video
  • Quote embedded
  • Link reference (embedded card)
  • App Password for a more secure connection
  • Cache for a more performant display and avoid BlueSky request limitations
  • Dark/Light mode (by default is system/user choice)
  • Lots of options in the display of your profile banner
  • Gallery of images

Shortcode usage

In the shortcodes below, the complete list of attributes is displayed. You can omit them if you want, as the default values or the global values will be used if you omit them.

Display the last posts

[bluesky_profile theme="system" styleClass="" displayBanner="true" displayAvatar="true" displayCounters="true" displayBio="true"]

  • theme: displays a different set of colors supporting dark and light modes (values: system, light, dark)
  • styleClass: accept any string class-valid to customise the class attribute
  • displayBanner: either you want to display your profile banner image or not (values: true, false)
  • displayAvatar: either you want to display your profile avatar or not (values: true, false)
  • displayCounters: either you want to display your followers, following and posts, or not (values: true, false)
  • displayBio: either you want to display your profile description or not (values: true, false)

Display your profile banne

[bluesky_last_posts displayEmbeds="true" theme="system" numberOfPosts="5"]

  • displaysEmbeds: either you want to display only your posts, or include the embeds too (values: true, false)
  • noReplies: either you want to hide your replies, or include them in your feed (values: true, false)
  • theme: displays a different set of colors supporting dark and light modes (values: system, light, dark)
  • numberOfPosts: any number of posts to display. (advice, don't set a too high value)

Installation

  1. Install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the 'Plugins' screen in WordPress.
  3. Use the settings screen in your WordPress admin area to configure the plugin with at least your BlueSky IDs.

Frequently Asked Questions

Is this plugin secure?

Yes, this plugin uses a mix of secret keys, salts and OpenSSL methods to secure your BlueSky IDs.

Do you care for performance?

No I don't. Just kidding, I do care for performance. The plugin uses caching to reduce the number of calls to the BlueSky API.

What are the current options?

You have some options available like multiple ways to display your profile card and posts, the number of posts to display, whether to display embedded records or not, and the theme of the profile card and posts.

How do I report issues?

The plugin is new. Be patient, and report issues via the support forum or the GitHub repository: https://github.com/geoffreycrofte/bluesky-social-plugin-for-wordpress/issues

How do I ask for a feature support?

The plugin is new, so feel free to ask for new features or better support at: https://github.com/geoffreycrofte/bluesky-social-plugin-for-wordpress/issues The more info you give, the better the support will be. Be patient, I work alone.

Is this an official BlueSky Plugin

No it is not, but it is under evaluation of BlueSky's Team to take part of the developpement of this plugin.

Screenshots

  1. The profile card in light theme.
  2. The list of posts in light theme.
  3. The profile card in dark theme.
  4. The list of posts in dark theme.
  5. The Gutenberg block lists. (the last one isn't ours)
  6. The BlueSky Posts Feed Gutenberg options.
  7. The BlueSky Profile Gutenberg options.
  8. The plugin settings screen.
  9. A post automatically shared after a WordPress publication.

Changelog

1.1.1

WordPress still distributing 1.0.1 instead of 1.1.0. Forcing a version number update.

1.1.0

  • Bug fix:
  • Connexion with bluesky should be more consistent now.
  • Light mode in non-system mode wasn't overriding the system preference.
  • Features:
  • Deactivate syndication for a specific post before publishing your post
  • Remove the replies from the post feed
  • Display the 2 shortcodes in demo within the admin page

1.0.1

Adds the proper information about the shortcodes in the setting page, the plugin description and the mini-description.

1.0.0

  • Initial release.

Upgrade Notice

1.1.0

Important bug fix on maintaining the connexion with Bluesky Services

1.0.0

Initial release. Please backup your site before installing.

Notes

This plugin is open source and licensed under GPLv2 or later. Contributions are welcome via GitHub.

Known Bugs & Improvements

Known Bugs

  • On the Gutenberg editor, the blocks are not clickable. You need to open the block layers panel to select them. I'm working on it.

Planned Improvements

  • Add support for the embedded records options in the posts feed.
  • Enhance customization options for profile cards and posts.
  • Add color scheme options for the profile card and posts.
  • Adds an option within the post review to disable the syndication, post by post.

Other feature requests and bugs fixing at: https://github.com/users/geoffreycrofte/projects/1/views/1?layout=table