Skip to content
forked from akirk/friends

A social network between WordPresses. Privacy focused, by itself a self-hosted RSS++ reader with notifications.

License

Notifications You must be signed in to change notification settings

mikewmerritt/friends

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Friends

  • Contributors: akirk
  • Tags: friends, rss, decentralized, social-network, own-your-data
  • Requires at least: 5.0
  • Tested up to: 6.1
  • Requires PHP: 5.6
  • License: GPLv2 or later
  • Stable tag: trunk

Your own WordPress at the center of your online activity. Follow friends and other websites and establish friendship relationships between blogs.

Description

With the Friends Plugin for WordPress you can now consume content your friends (or other blogs) create, and interact with your friends on their blogs with seamless authentication.

As soon as you become friends, both of you get accounts on each other’s WordPresses that you can then use post comments or read private posts. You’ll use the account on your friend’s server just by clicking on their post on your own Friends page.

You can also use the Friends plugin as a capable self-hosted feed reader. With added parser support through plugins you can subscribe to all sorts of content, also on other social networks, allowing you to see what your friends do across social network borders.

A “friend” in the Friends Plugin doesn’t need to be a real friend, you can also subscribe to any site you like and that provides a viable means for retrieving your content.

You can turn your favorite blog into your personal newsletter by receiving full-post notification e-mails, using feed rules to filter out content you are not interested in.

Friends Plugin Demo on Youtube

Philosophy

The Friends Plugin was built to make use of what WordPress provides:

  • You use the WordPress infrastructure (Gutenberg or Classic Editor, what you prefer) to create your posts.
  • If a post is private, only logged-in friends can see it. They can only log in through their own Friends plugin on their blog.
  • Therefore, your friend is just a user on your WordPress blog, their posts are theirs, you can delete them to unfriend them.
  • No extra tables: The Friends plugin just uses a post type, options and some taxonomies to store its data. When you delete the plugin, your WordPress will be slim like before.

In future, I could see mobile apps instead of talking to a third party, to talk to your own blog. It will have your friends' posts already fetched. Maybe the apps will be specialized, like Twitter or Instagram, where you'd only interact with and create posts in the specific post format.

The logo was created by Ramon Dodd, @ramonopoly. Thank you!

Documentation for the plugin can be found on the GitHub project Wiki.

Development of this plugin is done on GitHub. Pull requests welcome. Please see issues reported there before going to the plugin forum.

Installation

  1. Upload the friends directory to the /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' menu in WordPress

Frequently Asked Questions

Does this plugin create custom tables?

No, all the functionality is achieved with standard WordPress means. Subscriptions or Friends are minimal-permission users on your install. External posts are cached in a custom post types and attributed to those users.

Why does this create users on my WordPress install?

I believe this is a very elegant way to attribute content and it allows to delete the users content when you delete them. The users have minimal privileges, so they cannot be used to post actual content to your site.

The users can only be used for login through your specific friend's WordPress install (they are created with a strong password throw-away password), if they have been upgraded to a "friend" or "aquaintance" user.

Why is the friendship established between WordPress sites and not WordPress users?

For one, this allows to stick with established WordPress configurations and terminologies. For example, you can use the WordPress mobile apps to post privately to your site.

Secondly, a lot of WordPresses are like cell phones. Some are used by more than one person but mostly there is a 1:1 relationship between a WordPress blog and a person.

If someone has multiple WordPresses this actually allows to segment your friendships. Close friends might want to follow all your blogs but you'd only add your photographer friends to your photoblog.

What if the friend request is deleted or not accepted?

You'll still see the public posts from the other WordPress, you've subscribed to its public RSS feed.

What's the point? If I want to post something privately I can use Facebook.

Well, that's actually exactly the point. Facebook owns your data, with WordPress you can decide where you want to host it and have all the benefits of running open source software.

What happens if I modify or delete a post?

There is a cache of your friends post in form of a Custom Post Type friend_post that is updated when you change a post. When you delete a post your friends' WordPresses are notified and they delete the cached post.

Screenshots

  1. You can use it like a Feed Reader
  2. But it is centered around users; you can have multiple feeds per person, even on social networks (parsing capabilities provided by plugins)
  3. Extensible with plugins itself
  4. Use the customizer to adapt it to your liking
  5. Categorize incoming content with Post Formats and view all posts of a certain format across your friends
  6. Use rules to filter incoming content (sometimes you’re not interested in everything your friends do)
  7. Friends users are plain WordPress users with low privileges
  8. A Friend Request is accepted in the users screen. Delete the user to reject it or accept the request to make them a friend
  9. You can react to a post or share it using Post Collections.

Changelog

2.2.0

  • Fix remote friends plugin detection on public Friends page when headers are stripped (#160).
  • Permissions: Allow using the friends plugin as an Editor (#121). An administrator account no longer required, you only need one to set the main user and adjust blog-level settings.
  • Automatic status: Add option to disable creation of automatic status post drafts (#141).
  • ActivityPub: Support for outgoing mentions (prepared in activitypub#213 by removing the parser from there for quicker iteration). Implemented in #137.
  • ActivityPub: Use the avatar from ActivityPub (#142) and allow setting it after the fact (it won't change automatically).
  • ActivityPub: Add outbox support (#163) which means that when you now subscribe to someone new, it will fetch old posts.

2.1.3

  • Feeds: fixed a bug where when adding a new user and subscribing to an ActivityPub feed at the same time, the ActivityPub account won't be followed (would need a deactivate/actiate of the feed).
  • Taxonomies: Hide the user-feed and reactions taxonomies from the public and delete their entries when uninstalling the plugin (#132).
  • Improved PHP8 compatibility and start testing with PHP8.2 in the CI.

2.1.2

  • Frontend: add option to show/hide hidden entries on a user page (#124).
  • Admin: Fix that the main settings page would not save.
  • Plugins (ActivityPub): Add a function to get all friends for a specific parser. This is for activitypub#213.
  • Plugins: Allow plugins to suggest a better display name and username for friends via two new hooks friends_suggest_user_login and friends_suggest_display_name.

2.1.1

  • Friends messages and status posting UI: Bring back the Gutenberg Editor using the updated blocks-everywhere (#122).
  • Admin: Fix a redirect problem on the autostatus admin page.
  • Status posts: fix collapsing them and only output the status post box on the main status feed to avoid confusion when your posts don't show up on an author status page.

2.1.0

  • Plugins: Add filters for allowing ActivityPub integrations (see activitypub#172): friends_rewrite_incoming_url, friends_user_feed_activated, friends_user_feed_deactivated.
  • Plugins: Add ActivityPub to the Friends Plugins installer.
  • Frontend: Add ability to read a post's comments inside the Friends plugin using the comments button (if it supplies a comments feed in its RSS which all WordPresses do) (#113).
  • Frontend: Add different styling for images and status feed. Add a "post status" box to the status feed.
  • Frontend: Allow starring friends + new widget to display those starred friends for convenient access.
  • Frontend: Add a recent friends widget that displays your newest friends and subscriptions for convenient access.
  • Admin: Introduce tabs on various friends settings for a better overview (#116).
  • Admin: Remove the Welcome admin notice in favor a Welcome screen inside the friends plugin.
  • Admin: Improve the friend space usage calculation for friends with many posts.
  • Admin: Improve Automattic Status (#111).
  • Core: Improved the WP_Query for the frontend to allow to show your reactions to the posts (#114).
  • Core: allow frontend detection earlier in the WordPress boot process allowing our add_theme_support()s to kick in based on whether we are on the frontend.
  • Core: Fetch feeds based on their due date. This will allow adjusting feed fetch intervals individually for feeds (#109).
  • Multisite: Improve activation code so that the friend roles should now be created more reliably on new multisite blogs (#107).
  • Plugins: Add filters for the Friends roles plugin: friends_plugin_roles.

2.0.2

  • Fix namespace on activation, deactivation and uninstall hooks

2.0.1

  • Fix a problem with retrieving and up to date plugins.json file from Github

2.0.0

  • Improved handling of updated feed items and how they are stored as revisions
  • PHP: Introduced a namespace, changed the plugin hooks to friends_loaded and friends_load_parsers
  • Add checks for diagnosing the correct functioning to Site Health

1.9.1

  • Fix a fatal error

1.9.0

  • New feature: Keyword Matcher (get a notification if an incoming post contains keywords you can specify)
  • New feature: Automatic status posts (automatically create draft status posts for certain events, they need to be published manually)
  • Disable Gutenberg in messages until Gutenberg-Everywhere has been fixed

1.8.5

  • Multisite: fix adding user to site instead of requiring a new username

1.8.4

  • Fixes for a PHP fatal and some notices

1.8.3

  • Improve default feed selection when adding a friend
  • Fix improper plugin directory when a friends plugin installed from Github

1.8.2

  • Move plugin updater data to Github

1.8.1

  • Fix whitespace missing in feed additions

1.8.0

  • Small bugfixes (main query modification, menu conflict, show the friends menu in wp-admin, allow regex to match post length)
  • Use the Gutenberg editor for blog to blog messaging

1.7.0

  • Add Emoji reactions
  • Add blog to blog messaging

About

A social network between WordPresses. Privacy focused, by itself a self-hosted RSS++ reader with notifications.

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 94.2%
  • JavaScript 3.5%
  • Other 2.3%