The Shariff plugin adds social media buttons to the website without compromising the privacy of website users, using Shariff (https://github.com/heiseonline/shariff) solution.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
locale Merge pull request #10 from tgc/locale_update Jun 18, 2018
shariff cleaning up Mar 8, 2018
templates cleaning up Mar 8, 2018
LICENSE clean up Sep 25, 2015
README.md cleaning up Mar 8, 2018
ShariffBlockPlugin.inc.php cleaning up Mar 8, 2018
ShariffPlugin.inc.php cleaning up Mar 8, 2018
ShariffSettingsForm.inc.php cleaning up Mar 8, 2018
index.php cleaning up Mar 8, 2018
settings.xml cleaning up Mar 8, 2018
version.xml cleaning up Mar 8, 2018

README.md

Shariff plugin

This plugin adds social media buttons to your web site (to the footer of each page or the sidebar) without compromising the privacy of website users. It implements shariff by heise (Github, article) in Open Journal Systems.

Features

Available social media services are:

  • AddThis
  • diaspora*
  • facebook
  • Flattr
  • Google+
  • LinkedIn
  • Mail
  • Pinterest
  • Print
  • Qzone
  • reddit
  • StumbleUpon
  • Tencent Weibo
  • Threema
  • Tumblr
  • Twitter
  • Weibo
  • WhatsApp
  • XING

Shariff buttons

Additionally an info button that links to the heise article can be added. You can also add a mail icon.

The plugin offers a selection of settings like themes, orientation and position of the social media buttons (see settings below).

The plugins will be displayed in the language of the website.

You can add the Shariff PHP Backend to display the number of likes (see below).

License

This plugin is licensed under the GNU General Public License v2. See the file LICENSE for the complete terms of this license.

System Requirements

This plugin is compatible with OJS 3.x version and OMP 3.x version.

Installation

Clone this repo in your plugin folder (/plugins/generic) or download the code and tar.gz it and upload it via the gui (Website Settings > Plugins).

Settings

The following settings are available:

  • choose the services you would like to provide on the journal pages (see list above)
  • choose a provided theme for the social media buttons (standard, white, grey)
  • determine the position of the social media buttons on your journal web site (footer, sidebar or article/book page)
  • choose the orientation of the social media buttins (vertical or horizontal)

Shariff settings

Usage

Install the plugin as described above, activate it and choose the settings you prefer. If you choose the sidebar option, you need to enable the new block under management/settings/website.

Display numbers

To display the numbers how often a page is shared in social media, you need to add the Shariff PHP Backend (https://github.com/heiseonline/shariff-backend-php/releases) to you OJS installation. To set up the backend you need to have access to the code. Follow the steps:

  1. Download the Shariff PHP Backend release zip file and unzip it.
  2. Copy the folder to the top level of your installation, name it "shariff-backend" and make it writable.
  3. Change the domain in index.php to your domain.
  4. The installation registers the folder if is named "shariff-backend" and everything should be working.

Contact/Support

Documentation, bug listings, and updates can be found on this plugin's homepage at http://github.com/ojsde/shariff. Contact us via support@ojs-de.net. Find out more about the project OJS-de.net.

Version History

  • 2.0 - Adaption to OJS/OMP 3
  • 1.0 - Shariff plugin for OJS 2

Technical Documentation

This plugin works for OJS and OMP 3 (the code is the same). The shariff solution by heise (version v2.0.4) is included in the plugin code (MIT License). It adds the social media buttons using html, css and js. The plugin uses hooks to add content, no existing templates are being overwritten. No database access is needed.

Hooks

The buttons are added via template hooks:

  • Templates::Common::Footer::PageFooter
  • Templates::Article::Details
  • Templates::Catalog::Book::Details

To add the plugin to the sidebar, this plugin is also a block plugin.

Attributes

The shariff solution offers different settings (see data attributes https://github.com/heiseonline/shariff). A selection of them are used in this plugin (some are filled automatically, some can be chosen by the user in the plugin setting):

  • data-lang: The plugin reads the selected language of the GUI automatically and uses it to display the buttons in that language.
  • data-services: The user can choose from a list of services in the plugin settings (see above).
  • data-mail-url: The automatically set string "mailto" allows the usage of local mail clients.
  • data-mail-body: The plugin enters the respective url automatically.
  • data-backend-url: The backend url is read automatically if the folder exists. The folder has to be placed at the document root and named "shariff-backend".
  • data-theme: The user can choose between different themes in the plugin settings (see above).
  • data-orientation: The user can choose between two orientation in the plugin settings (see above).
  • data-url: The plugin adds the respective url automatically.