Cloned repo from GitHub. ⚠️ This is NOT upstream. Use at your own risk https://github.com/stefanbohacek/fediverse-share-button/
Find a file
2024-05-20 16:44:58 -04:00
fediverse-share-button Delay button state change. 2024-05-20 12:31:24 -04:00
images Additional thumbnail. 2024-05-20 14:35:10 -04:00
video Added demo video recording. 2024-05-17 10:05:41 -04:00
captain-definition Fixed demo site deployment. 2024-05-17 08:21:42 -04:00
Dockerfile First commit. 2024-05-17 08:19:39 -04:00
index.html Updated share prompt text. 2024-05-20 10:46:58 -04:00
LICENSE.md First commit. 2024-05-17 08:19:39 -04:00
README.md Better wording. 2024-05-20 16:44:58 -04:00

A screenshot of the fediverse sharing prompt, which consists of an input field for domain name and a button with the text "Share" preceded by a Mastodon logo

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. For a list of supported platforms, visit my blog.

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:

<form class="fsb-prompt">
  <label>Share this page from your fediverse server</label>
  <div class="fsb-input-group mb-3">
    <span class="fsb-input-group-text">https://</span>
    <input required
      type="text"
      name="fediverse-domain"
      placeholder="mastodon.social"
      class="fsb-input fsb-domain"
      aria-label="Server domain">
    <button class="fsb-button"
      type="submit"><img src="https://fediverse-share-button.stefanbohacek.dev/fediverse-share-button/icons/mastodon.svg"
        class="fsb-icon"></span>Share</button>
  </div>
  <p class="fsb-support-note fsb-d-none">This server does not support sharing. Please visit <a
      class="fsb-support-note-link"
      target="_blank"
      href=""></a>.</p>
</form>
<link rel="stylesheet" href="https://fediverse-share-button.stefanbohacek.dev/fediverse-share-button/styles.min.css">
<script src="https://fediverse-share-button.stefanbohacek.dev/fediverse-share-button/script.min.js" defer class="fsb-script"></script>

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 section.

FAQ

Q: How does this work?

Some fediverse platforms let you open a sharing prompt via a URL, much like many corporate social media sites.

My sharing button detects the software running on the platform based on the provided URL, and shows a matching fediverse logo (courtesy of Liaizon Wakest).

Q: Does this button or the fediverse-info server collect any information?

None at all. The 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.

The last domain used in the domain input field and the fediverse software it's running are both stored in the site visitor's browser so that when they view another page, or visit the site again later, this information can be reused.

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 project itself.

Additional projects include:

Q: Is this really free to use?

Yep. But if you do have any extra cash, see stefanbohacek.com/support-my-work.

Q: Any way I can share feedback and suggestions?

Yes, feel free to open an issue on this repo, or find my contact information on my website.

See also the To-do section below for planned features and changes.

Tutorials

To-do

  • Make a WordPress plugin version.
  • Add missing icons, see icons/todo.txt.
  • Better development workflow.
  • Localization.

Development

After making changes to the JS and CSS files, make sure to minify them.

npm install terser -g
npm install minify -g
terser fediverse-share-button/script.js > fediverse-share-button/script.min.js
minify fediverse-share-button/styles.css > fediverse-share-button/styles.min.css

Attributions

Icons

JS and CSS code