max.mehl
/
share-buttons
mirror of https://git.fsfe.org/FSFE/share-buttons.git
2
0
Fork 0
Code Issues Releases Wiki Activity
Share buttons based on those used on fsfe.org. They are completely free of JavaScript and still support dynamic input of Diaspora and GNU Social URLs. They can be extended very easily.
43 Commits 1 Branch 1 Tag 289 KiB
CSS 38.5%
HTML 31%
PHP 30.5%
Go to file
Max Mehl 9365f42de2
add sharepic button 		2022-08-23 15:05:46 +02:00
.reuse make REUSE compliant 2019-06-28 14:30:39 +02:00
LICENSES fix REUSE compliance 2019-08-07 10:54:46 +02:00
screenshots make REUSE compliant 2019-06-28 14:30:39 +02:00
services add sharepic button 2022-08-23 15:05:46 +02:00
.gitignore make users configurable without having to change share.php 2020-01-08 14:31:26 +01:00
README.md add reuse badge 2022-07-28 11:21:50 +02:00
buttons-services.css add sharepic button 2022-08-23 15:05:46 +02:00
buttons.css relicense parts of the repo to CC0-1.0 2022-07-28 11:20:46 +02:00
buttons.html add sharepic button 2022-08-23 15:05:46 +02:00
share-config.php.sample fix donate link 2020-04-21 12:15:30 +02:00
share.php add sharepic button 2022-08-23 15:05:46 +02:00

README.md

Share buttons (bar + left-side-scrolling)

REUSE status

Screenshot

These share buttons can be used for various websites, enabling its visitors to share specific URLs on social networks, or to enable them to do micro-domnations via flattr.

The buttons are much more user-friendly than many other solutions:

  • There is absolutely no JavaScript required
  • No third-party resources are loaded
  • Users of Mastodon, GNU Social and Diaspora can easily provide their pod URL and use the native sharing API

Location

The buttons are currently available as a usual "share bar", so all buttons in one horizontal line (see Screenshot 1), and as a left-side vertical bar scrolling with the screen (see Screenshot 2).

Caveats

The detection of which network the entered Fediverse pod belongs to is hacky. We check error codes of certain unique URLs. But since the different Fediverse APIs and structures can be similar, might results might appear. Contributions for a better detection are appreciated!

Extendability

Buttons can easily be added and removed by a few lines of code in the HTML, CSS, and PHP files.

  • In the HTML file, you can just copy/paste the exiting code and modify it. Note that services with user-dependent URLs (like Diaspora and GNU Social) are a bit more complicated and require another GET parameter to be added (like fediversepod) which has to be read by share.php.
  • In the PHP file the parameters are put together, depending on the format the service understands.
  • The CSS files keeps all layout information.

Contributors

The buttons have been designed by Paul Hänsch and Max Mehl in their capacity as FSFE webmasters. Current maintenainer is @max.mehl, but there are other contributors as well. Please check the file headers.

License

GNU Affero General Public License 3.0 or any later version (AGPL-3.0-or-later) for the PHP file, CC-BY-SA-4.0 for documentation, and CC0-1.0 for the rest.