Shariff Wrapper

Beschreibung

Die originalen Teilenbuttons senden automatisch Informationen über die eigenen Webseitenbesucher an die sozialen Netzwerke. Es ist dabei nicht erforderlich, dass diese dafür aktiv auf einen der Buttons klicken, sondern dies passiert bereits beim Aufrufen der Seite im Hintergrund. Die Nutzer haben daher keine Wahl, ob sie Informationen an Facebook und Co. senden möchten oder nicht. Dies verstößt ausdrücklich gegen das deutsche Datenschutzgesetz und kann daher zu Abmahnungen führen. Das Computermagazin c’t hat daher den „Shariff“ (/ˈʃɛɹɪf/) entwickelt, mit dem sich datenschutzkonforme Teilenbuttons erstellen lassen. Dieses Plugin setzt das Shariff-Konzept in einer einfach einzusetzenden Form für WordPress um. Im Moment unterstützt es 22 Dienste, darunter unter anderem Facebook, Twitter, GooglePlus, Xing, LinkedIn und viele weitere.

Mehr Informationen über das Shariff-Projekt können im original Github-Projekt gefunden werden oder auf der Informationsseite des c’t-Magazins.

Die Teilenbuttons können mit diesem Plugin automatisch zu Beiträgen, Seiten, der Blogseite, Produktseiten und vielen mehr hinzugefügt werden. Außerdem ist es möglich diese mittels eines Widgets oder manuell mit Hilfe des Shortcodes [shariff] in Seiten und im Theme einzubinden.

Screenshots

  • Unterschiedlich gestaltete Teilen-Buttons (alle klein).
  • Basis-Einstellungen.
  • Design-Einstellungen.
  • Erweiterte Einstellungen.
  • Mailformular-Einstellungen.
  • Hilfe.
  • Manueller Shortcode inklusive verschiedener Optionen in einem Beitrag.
  • Widget-Menü. Der Shortcode funktioniert wie in Beiträgen.

Installation

  1. Lade alles per FTP in das Verzeichnis /wp-content/plugins/ hoch.
  2. Aktiviere den Shariff Wrapper im Plugin-Menü von WordPress.
  3. Jetzt kann[shariff] überall in Beiträgen oder auf Seiten verwendet werden.

Um die Teilen-Buttons für alle Beiträge oder Seiten zu aktivieren, wirf einen Blick in die Plugin-Einstellungen.

FAQ

F: Kann ich die Shariff-Buttons in meinem Theme nutzen?

A: Yes.

You can use all options of the shorttag as described on the help tab in the plugin settings.

F: Kann ich die gesamte Anzahl an Zählungen in meinem Theme ausgeben?

A: Yes. You can use

to simply output the total amount of shares for a post in the loop. It will return the number itself wrapped in a <span class="shariff-totalnumber"></span> in order for the shariff.js to update the count. Also only cached data is used, in order to not slow down your site.

Q: Is there an action hook to use the share counts every time they get updated?

A: Yes. You can use
function your_awesome_function( $share_counts ) {
// $share_counts is an array including all enabled services, the timestamp of the update and the url of the post.
// do stuff
}
add_action( ’shariff_share_counts‘, ‚your_awesome_function‘ );
WARNING: This hook will get called A LOT. So be sure you know what you are doing.

F: Wie kann ich das Widget konfigurieren?

A: It uses the same options that have been configured on the plugin options page. However, you can put in a shorttag that overwrites the default options. It has the same format as you use in posts. Take a look at the help section of the plugin options page for more information.

F: Kann ich die Einstellungen für einen einzelnen Beitrag ändern?

A: Ja. Alle Optionen können mittels des Shorttags in der Shariff-Metabox auf der rechten Seite des Beitragsbearbeitungsseite geändert werden.

F: Wieso sind die Shares nicht gelistet?

A: Shariff tries to protect the privacy of your visitors. In order to do this, the statistics have to be requested by your server, so social networks only see a request of your server and not from your visitor. However, we do not know, if you want this. Therefore it is not enabled by default.

F: Wie können die Zähler aktiviert bzw. angezeigt werden?

A: Enable it on the plugin options page in general or add backend="on" to the shariff shorttag in your post.

F: Die Zähler werden immer noch nicht angezeigt.

A: Please have a look at the status tab on the plugin options page. It states wether share counts are enabled and if there is a problem with a service. Please also keep in mind that the plugin has a minimum refresh time of 60 seconds and that each service has their own cache as well.

F: Warum kann ich die TTL nicht auf einen kleineren oder größeren Wert setzen?

A: The time to live (TTL) value determines, if a share count of a post or page gets refreshed when someone visits this specific page / post of your blog. Too small values create too much useless traffic, too high values negate the goal of motivating visitors to also share a post. The value can be adjusted between 60 and 7200 seconds. Keep in mind, the actual lifespan depends on the age of the post as well.

F: Ich erhalte die Fehlermeldung „request limit reached“ von der Facebook-API!

A: Facebook has a rate limit of 600 requests per 600 seconds per IP address. Especially in shared hosting environments many domains share the same IP address and therefore the same limit. To avoid this you can try to raise the TTL value or provide a Facebook App ID and Secret. Google „facebook app id secret“ will provide many guides on how to get these.

F: Wie kann ich die Position aller Buttons ändern?

A: Have a look at the alignment options in the admin menu or checkout the
style option.

F: Wie kann ich das Design ändern?

A: Have a look at the parameters „theme“, „orientation“ and „buttonsize“. They work mostly like the original code parameters that are explained at http://heiseonline.github.io/shariff/ Or you can have a look at the test page at http://shariff.3uu.net/shariff-sample-page-with-all-options to get an
overview. But please be warned: This is a test page! It is possible that you find features that are only provided in the development version. Use it only to get an impression of the design options.

F: Wie kann ich das Design eines einzelnen Buttons ändern?

A: If you are a CSS guru please feel free to modify the css file. But of course this is a bad idea, because all changes will be destroyed with the next update! Instead take a look at the style and class attribute of the shorttag. If you put in any value it will create a DIV container with the ID „ShariffSC“ around the buttons. If you are really a CSS guru you will know what does the magic from here on out. 😉

F: Wie können die Buttons während dem Scrollen fixiert bleiben?

A: No problem. Just use the style attribute to add some CSS to the shorttag. For example in a widget (adjust the width as needed):
[shariff style=“position:fixed;width:250px“]
Of course you can use all other options in that shorttag as well. It also works with the CSS style option on the plugins design options page, if you really want this applied to all buttons on your page.

F: Ich möchte eine horizontale Linie über meinen Shariff-Buttons!

A: You can use the headline option on the design tab. For example, enter the following code to create a horizontal line and a headline:

Please share this post:

F: Ich möchte eine andere oder keine Überschrift in einem einzigen Widget, Beitrag oder Seite!

A: Use the headline attribute to add or remove it. For example, you can use the following shorttag to remove a headline set on the plugins options page in a single widget:
[shariff headline=““]
Of course you can use all other options in that shorttag as well.

F: Kann ich [shariff] zu allen Beiträgen hinzufügen?

A: Ja, sieh dir die Plugin-Einstellungen an.

F: Ich will es aber auf einem einzelnen Beitrag verstecken!

A: Do you really know what you want? 😉 However, it is possible. Write anywhere in your post „hideshariff“. It will be removed and Shariff will not be added. You can also use „/hideshariff“ to write „hideshariff“ in your post. You might also want to take a look at the Shariff meta box on the right side of your post edit screen.

F: Was sind die Unterschiede zwischen den beiden Shariff-Plugins?

A: One is developed by us, one by someone else. 😉 The main difference is that this plugin has a few more options and a great support. 🙂 Neither of the plugins are „official“ or directly developed by Heise.

F: Funktioniert es mit einem CDN (Content Delivery Network)?

A: Ja.

F: Pinterest zeigt kein Bild an!

A: You can add media=“http://wwww.example.com/yourImage.png“
within the [shariff] shorttag or add it in on the plugin options page – of course with the link to your image.

F: Kann ich eine feste URL zum Teilen festlegen?

A: You can use the „url“ parameter within the shortcode
[shariff url=“http://www.example.com/“]
This is also available within widgets. However, it is not a good idea to manipulate the URI, because it could mislead your visitors. So you should only use it, if this is really needed and you do really know what you are doing. Therefore it is not available on the plugin options page in general.

F: Was ist der Unterschied zwischen den Diensten `mailform` und `mailto`?

A: mailform will provide an e-mail form on top of the post or page and mailto will draw a link with the mailto-protocol to open the default e-mail application of the client.

F: Was ist mit `mail` passiert?

A: Mail wurde durch das E-Mailformular ersetzt, um eine bessere Unterscheidung der beiden Arten von E-Mail-Schaltflächen zu ermöglichen.

F: Kann ich das Mail-Formular vollständig deaktivieren?

A: Ja, unter dem Reiter „Mail Form“ in den Plugin-Einstellungen.

F: Was ist mit den Twitter-Zählern (share counts) passiert und was ist OpenShareCount?

A: Bitte lies: https://www.jplambeck.de/twitter-saveoursharecounts/

F: Die Buttons werden nicht richtig in meinem selbst erstellten Theme angezeigt!

A: Bitte stelle sicher, dass wp_footer (); in deinem Theme vorhanden ist. Für weitere Informationen besuche bitte: https://codex.wordpress.org/Function_Reference/wp_footer

EXPERIMENTELLE FUNKTIONEN

Features marked as „experimental“ in the admin menu are experimental! This means: We think it is a good extension to our plugin that we would like to include in a future version, but we are not sure yet about the best solution that works for all or most people. So please feel free to use and test it and report back to us about it. Experimental features might be removed in an update, if it does not work out. So please pay close attention to our changelog!

F: Was ist die externe API-Funktion?

A: First of all: Usually you do not need it! The plugin requests all share counts itself. However, there are some reasons to put the backend on another server:
– avoid requests from you WP server to all the social networks
– use a more powerful server for the statistic
– use the original backend implementation of Heise or your own solution
– make your own backend available for more than one WP installation
But please have in mind that there are also some good reasons not to use external servers:
– you need an additional installation of WP and the plugin or have to create your own implementation of a Shariff backend
– some plugin settings (backend checks, statistic, etc.) will only work on the external server
– you have to use SHARIFF_FRONTENDS as an array with all your frontend domains to enable the backend or find your own solution
– we CANNOT provide support for your own implementation

F: Wie kann die externe API konfiguriert werden?

A: In the statistic settings fill in the URL to the API of the external server. For the WordPress installation on the external server you have to create a „constant“ called SHARIFF_FRONTENDS to permit other domains to use it. Please have in mind that you have to fill in all subdomains you want to use! The domains must be defined like this:
define( ‚SHARIFF_FRONTENDS‘, ‚example.com|www.example.com|blog.example.com|another-domain.com‘ );

F: Was bedeutet „Kontaktiere die externe API direkt.“?

A: By default, the browser request the share counts from the server your site is running on. If you have entered an external API your server will then request the counts from this external API instead of fetching them itself. Therefore, the external server will only see the IP from your server and not the one from your visitors. If you check this option, the browser of your visitors will instead directly request the share counts from the external API and therefore reveal their IP address to them. This might be faster, but it is less secure. Please also make sure to set the Access-Control-Allow-Origin header right. If your site is available using https, your external API will need to be reached by https as well. Otherwise the request will get blocked for security reasons. All options and features (e.g. the ranking tab) regarding the statistic will only work on the external server.

BEKANNTE FEHLER

These are bugs or unexpected glitches that we know of, but that do not
have an impact on the majority of users, are not security relevant and will perhaps be
fixed in the future – if we have time to spend or you provide us with a lot of „Kölsch“ 😉

  • Wenn der erste Beitrag auf der Startseite passwortgeschützt ist und Shariff auf passwortgeschützten Beiträgen deaktiviert ist, wird ein Widget am Ende der Schleife nicht dargestellt.

Rezensionen

Simply the best

I was never really happy with oter social share plugins until I found this one. It’s fast and nothing is missing. Wow… in my opinion this is the best ever social plugin!

Style im Footer?

Absolut brauchbar und empfehlenswert!
Einzige was mich stört: Wieso wird shariff.min.css zusammen mit den shariff Skripten im Footer geladen? CSS sollte im Head geladen werden. Denn jetzt habe ich aktuell das Problem, dass das CSS zu spät gerendert wird und dadurch die Optik der Buttons für eine kurze Sekunde springt.

Beste Wahl !!!

Passt, funktioniert erstklassig und ist datenschutzkonform.
Es wäre noch schön, wenn Instagram dazu käme.

Großartiges Plugin für mehr Datenschutz

Allein die Umsetzung verdient schon fünf Sterne, wirklich großartig gemacht. Endlich kann man als Webmaster soziale Medien datenschutzkonform in die eigene Website einbinden.

Leider gibt es auch etwas Luft nach oben: Die Zählmechanismen arbeiten nicht immer hundertprozentig zuverlässig (getestet bei Facebook und Twitter) und die Dokumentation könnte in bestimmten Punkten etwas ausführlicher sein.

Dennoch habe ich bislang kein besseres Plugin für die sichere Einbindung sozialer Medien gefunden.

Lies alle 60 Rezensionen

Mitwirkende & Entwickler

„Shariff Wrapper“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt.

Mitwirkende

„Shariff Wrapper“ wurde auf German übersetzt. Danke an die Übersetzer für ihre Mitwirkung.

Übersetze „Shariff Wrapper“ in deine Sprache.

Interessiert an der Entwicklung?

Durchstöbere den Code oder abonniere das Entwicklungsprotokoll per RSS.

Changelog

4.3.0

  • neuer Dienst Odnoklassniki (Dank an rockhit)
  • new meta box allows for individual settings per post or page
  • Neue Option Zählungen zu verstecken, die 0 betragen
  • new option to disable dynamic cache lifespan (not recommended)
  • new option to set the button size to small, medium or large
  • new option to add a custom class to the container around Shariff
  • new option to open links in a popup (thanks to jackennils)
  • Neue Option NewShareCount statt OpenShareCount (Twitter) zu benutzen
  • Die Zeitstempelvariable ist nun über Shortcodes zugänglich
  • Beitrags-Zeitstempel für das Caching unter bestimmten Bedingungen behoben
  • fixed Facebook share count error for never crawled pages
  • fixed empty tab after sharing on certain mobile devices
  • fixed custom title attribute (thanks to kschlager)
  • Flattr Benutzer ID für die Zukunft aktualisiert (Dank an poetaster)
  • Änderungsprotokoll auf wordpress.org reduziert (Dank an timse201)
  • kleinere CSS-Verbesserungen
  • Hilfe überarbeitet

4.2.1

  • Fehler beim WhatsApp-Button unter Android behoben, wenn Chrome genutzt wurde
  • Shariff wird nun nicht mehr unter bestimmten Bedingungen in RSS-Feeds hinzugefügt
  • updated to latest Facebook Graph API for share count requests

4.2.0

  • new option to set the rate limit for sending mails using the mail form
  • added home url as fallback for share count requests
  • Weitere Anti-Spam-Schutzmechaniken hinzugefügt
  • noopener und noreferrer zu den teilenden Links hinzugefügt
  • fixed double encoding of share count request links
  • updated media uploader request for translation
  • updated handling of admin notices following WordPress core
  • Für WordPress 4.6 getestet und optimiert

4.1.2

  • new fallback for share count requests in case pretty permalinks are disabled
  • new filter shariff3UU_render_atts to change options on the fly (thx Ov3rfly)
  • fixed share title in cases with html encoded characters
  • Problem behoben, das unter bestimmten Bedingungen im Ranking-Tab zu doppelten Zählungen führte
  • fixed php info notice in admin notices

4.1.1

  • Neue Option Shariff-Buttons außerhalb der Hauptschleife zu deaktivieren
  • fixed Facebook App ID request
  • kleinere CSS-Ausbesserung

4.1.0

  • new design option to set a custom button color for all buttons
  • new design option to set a border radius for the round theme (up to a square)
  • new design option to hide all buttons until the page is fully loaded
  • new mailform option to use a html anchor (again)
  • new statistic option to fill the cache automatically
  • new statistic option to set the amount of posts for the ranking tab
  • new statistic option to use share counts with PHP < 5.4
  • fixed preventing buttons from beeing added to excerpts under certain conditions
  • fixed urlencoding of share count requests
  • improved handling of wrong or mistyped service entries
  • kleinere Fehler behoben

4.0.8

  • neue Behelfslösung für Webseiten, die mit PHP 5.2 und älter betrieben werden

4.0.7

  • new option for WordPress installations with REST API not reachable in root

4.0.6

  • Einen Fehler in Verbindung mit bbpress behoben
  • einen Fehler mit sehr alten PHP Versionen behoben
  • Ranking Tab repariert
  • kleinere CSS-Verbesserungen

4.0.5

  • E-Mail-Formular-Link repariert
  • xmlns für w3c behoben

4.0.4

  • removed some remaining wrong text domains for translations
  • kleinere CSS-Ausbesserungen

4.0.3

  • Problem behoben, dass mobile Dienste auf bestimmten Tablets nicht angezeigt wurden
  • fixed type error on totalnumber when cache is empty
  • fixed share count requests when WordPress is installed in a subdirectory
  • fixed urlencoding of share url, title and media
  • added width and height to SVGs to prevent large initial icons prior to css
  • new classes shariff-buttons and shariff-link added
  • removed local translation files due to switching to wordpress.org language packs
  • kleinere CSS Korrekturen

4.0.2

  • added minor css resets to prevent influence of theme css
  • LinkedIn Share Link korrigiert

4.0.1

  • prevent php warning messages on unsuccessful includes while WP_DEBUG is active
  • changed text domain to match plugin slug

4.0.0

  • komplette Überarbeitung des Plugin-Kerns
  • Die Buttons funktionieren jetzt auch ohne JavaScript
  • Icon-Schrift wurde entfernt und durch SVGs ersetzt
  • Teilen-Zähler nutzen nun die WP REST API
  • share counts now always show the last cached counts prior to updating them
  • doppelte Zähler-Anfragen behoben
  • Neuer Ranking-Tab zeigt die Zählungen der letzten 100 Beiträge
  • neuer Dienst Pocket
  • new option to show the total amount of shares in the headline with %total
  • new option to use the total amount of shares in your theme (see FAQ)
  • new action hook shariff_share_counts (see FAQ)
  • neue Option, um die Priorität der Shortcode-Filter zu ändern
  • Neue Unterstützung für selektive Auffrischung, das in WP 4.5 eingeführt wurde
  • new external API feature replaces the external host option (experimental, see FAQ)
  • neue Unterstützung für SCRIPT_DEBUG
  • CSS- und JavaScript-Dateien werden nun nur noch auf Seiten mit Shariff-Buttons geladen
  • Kompatibilität mit dem Autoptimize-Plugin verbessert (Erzwingen von Skripten im Header)
  • Kompatibilität mit verschiedenen Caching-Plugins verbessert
  • alle Shortcodes werden nun aus dem E-Mail-Text entfernt
  • mögliches doppeltes versenden von E-Mails behoben
  • Alle jQuery-Abhängigkeiten entfernt
  • benötigt mindestens WordPress 4.4 (nur für die Zähler bzw. Share Counts)
  • wir unterstützen nicht länger den IE 8 (falls es jemals funktionierte)
  • Status-Tab überarbeitet
  • Hilfe überarbeitet
  • kleinere Fehler behoben
  • Quelltext gesäubert

Das vollständige Changelog kann hier eingesehen werden: https://plugins.svn.wordpress.org/shariff/trunk/changelog.txt