Socialshareprivacy_XH - a CMSimple_XH Plugin

Socialshareprivacy_XH facilitates to have Facebook, Twitter and Google+ buttons on your website without violating your visitor's privacy. Before the buttons are actually shown, the visitor has to agree explicitely. This plugin is only a wrapper around the jQuery plugin socialshareprivacy, which is developed by heise online. Socialshareprivacy_XH doesn't provide any additional features, but is merely meant as a simple way to use and configure the jQuery plugin without the need to mess around in JS files.

Please do read this documentation before you encounter any problems!

Important Notice

Socialshareprivacy_XH couldn't be tested so far in various environments. It is a so called BETA version. Use with caution!

Requirements

Socialshareprivacy_XH is a plugin for CMSimple_XH. It requires a UTF-8 encoded version and jQuery4CMSimple, which is already bundled with CMSimple_XH since version 1.4.1.

Installation

The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.

  1. Backup the data on your server.
  2. Unzip the distribution on your computer.
  3. Upload the whole directory socialshareprivacy/ to your server into CMSimple_XH's plugins directory.
  4. Set write permissions to the subdirectories config/, css/, js/ and languages/.
  5. Switch to "Socialshareprivacy" in the back-end to check if all requirements are fulfilled.

Settings

The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select "Socialshareprivacy" from "Plugins".

You can change the default settings of Socialshareprivacy_XH in "Plugin Config". Hints for the options will be displayed when hovering over the help icon with your mouse.

Localization is done in "Plugin Language". You can translate the character strings to your own language, or customize them according to your needs.

The look of the Socialshareprivacy_XH can be customized in "Plugin Stylesheet".

Usage

Just insert the following to the template or a CMSimple page where you want the social buttons to be shown:

<div class="socialshareprivacy"></div>

You can insert this code several times, if you like. The buttons will be embedded automatically inside those divs.

License

Socialshareprivacy_XH is licensed under GPLv3.

© 2012 Christoph M. Becker

Credits

Many thanks to Christian for pointing me to socialshareprivacy.

This plugin uses free applications icons from Aha-Soft. Many thanks for making these icons freely available.

And last but not least many thanks to Peter Harteg, the "father" of CMSimple, and all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.