Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stefanbohacek/fediverse-share-button
Let your site's visitors share your work with the fediverse!
https://github.com/stefanbohacek/fediverse-share-button
fediverse sharing-button social-media
Last synced: 6 days ago
JSON representation
Let your site's visitors share your work with the fediverse!
- Host: GitHub
- URL: https://github.com/stefanbohacek/fediverse-share-button
- Owner: stefanbohacek
- License: mit
- Created: 2024-05-17T12:16:20.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-05-22T12:47:19.000Z (6 months ago)
- Last Synced: 2024-05-22T13:54:17.527Z (6 months ago)
- Topics: fediverse, sharing-button, social-media
- Language: JavaScript
- Homepage: https://stefanbohacek.com/project/fediverse-sharing-button/
- Size: 223 KB
- Stars: 18
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Fediverse Sharing Button
Let your site's visitors share your work with the fediverse!
You can see a demo at [fediverse-share-button.stefanbohacek.dev](https://fediverse-share-button.stefanbohacek.dev/). For a list of supported platforms, [read below](#q-which-platforms-are-supported).
## Features
- minimalist design inspired by Bootstrap
- shows a logo of supported fediverse software
- lets you share selected text
- remembers the last fediverse domain used
- free (as in fediverse) to use!
## How to use
Add the following snippet to where you want your sharing button to show up:
```html
Share this page from your fediverse server
https://
Share
This server does not support sharing. Please visit .
```
Alternatively, you can download the code from this repo and host all the JS, CSS, and image files yourself.
For alternative uses of this project, see the [Tutorials](#tutorials) section.
## FAQ
### Q: How does this work?
Some fediverse platforms let you [open a sharing prompt via a URL](https://stefanbohacek.com/blog/making-fediverse-apps-for-everyone/#sharing-dialog), much like many [corporate social media sites](https://stefanbohacek.com/blog/simple-sharing-buttons/#facebook).
My sharing button [detects the software](https://github.com/stefanbohacek/fediverse-info) running on the platform based on the provided URL, and shows a matching fediverse logo (courtesy of [Liaizon Wakest](https://fediverse.wake.st/)).
### Q: Which platforms are supported?
- Diaspora
- Firefish
- Friendica
- Glitch-soc
- Hometown
- Hubzilla
- Lemmy (may be [broken on older versions](https://github.com/LemmyNet/lemmy-ui/issues/1913))
- Mastodon
- Misskey
- Sharkey
Threads are *technically* supported, but they don't currently provide software information, so the URL won't be recognized.
### Q: Does this widget or the fediverse-info server collect any information? Does it comply with data privacy laws? (eg GDPR)
The sharing widget uses [`localStorage`](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage) to store two pieces of information:
- `fsb-domain`: used to store the last **domain name** used in the sharing widget (eg. "mastodon.social", "pixelfed.social", etc)
- `fsb-software`: used to store the **software** used by the selected fediverse server (eg. "mastodon", "pixelfed")
When stored, this information is used to prefill the widget form upon next visit.
To prevent this information from being stored, you can set the value of `fsb-consent-given` to `"false"` before loading the main JavaScript file.
```html
localStorage.setItem("fsb-consent-given", "false");
```
Using any other value, or the lack of presence of it, will be interpreted as a consent to store and retrieve the information detailed above. Please consult any applicable laws to determine whether consent is required for this functionality.
The [fediverse-info](https://github.com/stefanbohacek/fediverse-info) server is only needed to cache the software information for each domain as not to overwhelm the original server with too many requests. This information is not tied specifically to your site's visitor.
### Q: Are there any similar projects?
Yes, see a list here: https://github.com/Uden-AI/fediverse-share#similar-projects-to-compare-to, including the [fediverse-share](https://github.com/Uden-AI/fediverse-share) project itself.
Additional projects include:
- [ShareOpenly](https://shareopenly.org/) by [Ben Werdmuller](https://about.werd.io/)
- [Mastodon Share](https://mastodonshare.com/) by [Alex Barredo](https://mastodon.social/@barredo)
### Q: Is this really free to use?
Yep. Attribution and/or link back to the project would be nice, but are not required. And if you have any extra cash, see [stefanbohacek.com/support-my-work](https://stefanbohacek.com/support-my-work/).
### Q: Any way I can share feedback and suggestions?
Yes, feel free to [open an issue](https://github.com/stefanbohacek/fediverse-share-button/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc) on this repo, or find my contact information [on my website](https://stefanbohacek.com/contact/).
See also the [#enhancement](https://github.com/stefanbohacek/fediverse-share-button/issues?q=is%3Aopen+label%3Aenhancement+sort%3Aupdated-desc) tickets for planned features and changes.
## Tutorials
- [Adding a Fediverse Share Button to my Emacs Nikola Blog](https://blog.notroot.online/posts/adding-a-fediverse-share-button-to-my-emacs-nikola-blog/) by [Notroot](https://notroot.online/@notroot)
## Development
Install dependencies and start the build script.
```sh
npm install
npm run dev
```
## Attributions
### Icons
- [fediverse.wake.st](https://fediverse.wake.st)
- [flowbite.com/icons](https://flowbite.com/icons)
- [svgrepo.com](https://www.svgrepo.com)
### JS and CSS code
- https://getbootstrap.com