| 1 |
# Friends |
| 2 |
|
| 3 |
- Contributors: akirk |
| 4 |
- Tags: friends, rss, decentralized, social-network, own-your-data |
| 5 |
- Requires at least: 5.0 |
| 6 |
- Tested up to: 6.5 |
| 7 |
- License: [](http://www.gnu.org/licenses/gpl-2.0.htmlGPLv2 or later](http://www.gnu.org/licenses/gpl-2.0.html](http://www.gnu.org/licenses/gpl-2.0.html) |
| 8 |
- Stable tag: 2.8.9 |
| 9 |
|
| 10 |
Your own WordPress at the center of your online activity. Follow friends and other websites and establish friendship relationships between blogs. |
| 11 |
|
| 12 |
## Description |
| 13 |
|
| 14 |
The Friends plugin allows you to follow content from other WordPress sites, and interact with them on your own site. You can follow friends and others via RSS. If you also have the ActivityPub plugin installed, you can follow people on Mastodon and other ActivityPub-compatible social networks. |
| 15 |
|
| 16 |
**Since version 2.6.0, no users will be created for subscriptions.** |
| 17 |
|
| 18 |
**Combine this plugin with the ActivityPub plugin to make your own WordPress your own Mastodon instance. Use the Enable Mastodon Apps to use mobile and desktop Mastodon apps with your own site.** |
| 19 |
|
| 20 |
The Friends Plugin also has a "friend request" function which allows blogs to become friends with each other. This then allows private publishing on your blog while each of their friends has their own blog but will be able to see your privately published posts. |
| 21 |
|
| 22 |
There are many small aspects that make it powerful self-hosted social reader: |
| 23 |
|
| 24 |
You can... |
| 25 |
- Have multiple feeds per person, so you can subscribe to their blog(s) and social media account(s). |
| 26 |
- Categorize incoming content with Post Formats and view all posts of a certain format across your friends. |
| 27 |
- Define rules to filter incoming content (sometimes you’re not interested in everything your friends do). |
| 28 |
- Turn your favorite blog into your personal newsletter by receiving full-post notification e-mails |
| 29 |
- Use feed rules to filter out content you are not interested in. |
| 30 |
- Receive ePubs of your friends' posts to your eReader (via another plugin). |
| 31 |
- Collect posts (from your feeds or around the web) in a collection for later reference (via another plugin). |
| 32 |
|
| 33 |
[](https://www.youtube.com/watch?v=4bz6GluXnsk](https://www.youtube.com/watch?v=4bz6GluXnsk](https://www.youtube.com/watch?v=4bz6GluXnsk) |
| 34 |
|
| 35 |
### Philosophy |
| 36 |
|
| 37 |
The Friends Plugin was built to make use of what WordPress provides: |
| 38 |
|
| 39 |
- You use the WordPress infrastructure (Gutenberg or Classic Editor, what you prefer) to create your posts. |
| 40 |
- 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. |
| 41 |
- Therefore, your friend is just a user on your WordPress blog, their posts are theirs, you can delete them to unfriend them. |
| 42 |
- 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. |
| 43 |
|
| 44 |
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. |
| 45 |
|
| 46 |
The logo was created by Ramon Dodd, @ramonopoly. Thank you! |
| 47 |
|
| 48 |
Documentation for the plugin can be found on the [](https://github.com/akirk/friends/wikiGitHub project Wiki](https://github.com/akirk/friends/wiki](https://github.com/akirk/friends/wiki). |
| 49 |
|
| 50 |
**Development of this plugin is done [](https://github.com/akirk/friendson GitHub](https://github.com/akirk/friends](https://github.com/akirk/friends). Pull requests welcome. Please see [](https://github.com/akirk/friends/issuesissues](https://github.com/akirk/friends/issues](https://github.com/akirk/friends/issues) reported there before going to the [](https://wordpress.org/support/plugin/friendsplugin forum](https://wordpress.org/support/plugin/friends](https://wordpress.org/support/plugin/friends).** |
| 51 |
|
| 52 |
## Installation |
| 53 |
|
| 54 |
1. Upload the `friends` directory to the `/wp-content/plugins/` directory |
| 55 |
1. Activate the plugin through the 'Plugins' menu in WordPress |
| 56 |
|
| 57 |
## Frequently Asked Questions |
| 58 |
|
| 59 |
### Does this plugin create custom tables? |
| 60 |
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. |
| 61 |
|
| 62 |
### Why does this create users on my WordPress install? |
| 63 |
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. |
| 64 |
|
| 65 |
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. |
| 66 |
|
| 67 |
### Why is the friendship established between WordPress sites and not WordPress users? |
| 68 |
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. |
| 69 |
|
| 70 |
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. |
| 71 |
|
| 72 |
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. |
| 73 |
|
| 74 |
### What if the friend request is deleted or not accepted? |
| 75 |
You'll still see the public posts from the other WordPress, you've subscribed to its public RSS feed. |
| 76 |
|
| 77 |
### What's the point? If I want to post something privately I can use Facebook. |
| 78 |
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. |
| 79 |
|
| 80 |
### What happens if I modify or delete a post? |
| 81 |
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. |
| 82 |
|
| 83 |
## Screenshots |
| 84 |
|
| 85 |
1. Compact view is like Google Reader |
| 86 |
2. You can use it like a Feed Reader |
| 87 |
3. But it is centered around users; you can have multiple feeds per person, even on social networks (parsing capabilities provided by plugins) |
| 88 |
4. Extensible with plugins itself |
| 89 |
5. Use the customizer to adapt it to your liking |
| 90 |
6. Categorize incoming content with Post Formats and view all posts of a certain format across your friends |
| 91 |
7. Use rules to filter incoming content (sometimes you’re not interested in everything your friends do) |
| 92 |
8. Friends users are plain WordPress users with low privileges |
| 93 |
9. A Friend Request is accepted in the users screen. Delete the user to reject it or accept the request to make them a friend |
| 94 |
|
| 95 |
## Changelog |
| 96 |
|
| 97 |
### 2.8.9 |
| 98 |
- One more fix to the update routine for previous version |
| 99 |
|
| 100 |
### 2.8.8 |
| 101 |
- Fix update routine for previous version |
| 102 |
|
| 103 |
### 2.8.7 |
| 104 |
- Fix the reblog button ([#299]) |
| 105 |
- Add local users to potential mentions so that it won't be trashed ([#296]) |
| 106 |
- Add Option to Disable Friendships ([#294]) |
| 107 |
- Improve Omnibox ([#292]) |
| 108 |
- Send the ActivityPub follow not to the shared inbox but the individuals inbox ([#291]) |
| 109 |
|
| 110 |
### 2.8.6 |
| 111 |
- Improve friend URL validation before trying to discover feeds ([#290]) |
| 112 |
|
| 113 |
### 2.8.5 |
| 114 |
- Add Boosting any URL and improve search field ([#287]) |
| 115 |
- Allow translator translation for the welcome box ([#286]) |
| 116 |
- Remove dysfunct double setting from Edit User Page ([#289]) |
| 117 |
|
| 118 |
### 2.8.4 |
| 119 |
- Fix adding new feeds with a Mastodon-style notation ([#282]) |
| 120 |
|
| 121 |
[Send to E-Reader plugin]: https://github.com/akirk/friends-send-to-e-reader |
| 122 |
[#299]: https://github.com/akirk/friends/pull/299 |
| 123 |
[#296]: https://github.com/akirk/friends/pull/296 |
| 124 |
[#294]: https://github.com/akirk/friends/pull/294 |
| 125 |
[#292]: https://github.com/akirk/friends/pull/292 |
| 126 |
[#291]: https://github.com/akirk/friends/pull/291 |
| 127 |
[#290]: https://github.com/akirk/friends/pull/290 |
| 128 |
[#287]: https://github.com/akirk/friends/pull/287 |
| 129 |
[#286]: https://github.com/akirk/friends/pull/286 |
| 130 |
[#289]: https://github.com/akirk/friends/pull/289 |
| 131 |
[#282]: https://github.com/akirk/friends/pull/282 |
| 132 |
|
