=== Shariff Wrapper === Contributors: 3UU, starguide Tags: Twitter, Facebook, GooglePlus, sharebutton, sharing, privacy, social, whatsapp Requires at least: 3.0.1 Tested up to: 4.2 Stable tag: trunk License: MIT License URI: http://opensource.org/licenses/MIT Donate link: http://folge.link/?bitcoin=1Ritz1iUaLaxuYcXhUCoFhkVRH6GWiMTP This is a wrapper to Shariff. It enables shares with Twitter, Facebook ... on posts, pages and themes with no harm for visitors privacy. == Description == The "original" share buttons send data of your visitors to the social network sites, even if they do not click on a share button. The german computer magazin CT has developed "Shariff" `(/ˈʃɛɹɪf/)` that fullfills the strict data protection laws in Germany. This plugin is a wrapper to this software. It allows you to use it within your posts with the shorttag `[shariff]` and provides all design options of the original code. For more informations about the Shariff software check out the [GitHub project](https://github.com/heiseonline/shariff) and read about the project itself [c’t information page](http://ct.de/shariff) (in German). You can use this plugin on posts, pages, the main page, product sites and as a widget. == Installation == 1. Upload everything to the `/wp-content/plugins/` directory 2. Activate the plugin using the plugins menu in WordPress 3. Use [shariff] anywhere in your post and/or use the admin menu. To enable it for all posts please check the options in the admin menu. == Screenshots == 1. Insert as shorttag with options in a post. 2. Share-Buttons on the site in vertical order. 3. Options menu. 4. Widget menu. Shorttag works like in posts. 5. Also any widget can have its own design. == Frequently Asked Questions == = Q: How can I change the position of all buttons = A: Have a look at the alignment options in the admin menu or checkout the style option. = Q: Can I use it in my theme? = A: Yes. `` Backend is an example. You can use all options of the shorttag. But first you should have a look at the widget. = Q: How can I configure the widget? = A: It uses the same options that have been configured in the admin menu. However, you can put in a shorttag that overwrites the default options. It has the same format as you use in posts. = Q: Why are shares not listed? = A: Shariff tries to protect 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 blog server and not from your visitor. However, I am not sure if you want this. Therefore it is not enabled by default. = Q: How can I show the share counts? = A: Enable it in admin menu in general or add `backend="on"` to the shariff shorttag in your post. = Q: I do not see counts = A: First make sure the you have it enabled. If so, please have a look at the bottom of the admin menu. There is a hint, which directory shariff tries to use for the cache. = Q: How can I change the options of the backend? = A: The backend should work well with all common configurations. If the backend does not work and you do not have very special needs for your configuration perhaps you should think about another hoster ;-) However, there are some very special servers e.g. some load balancer that need adjustments. You can set the directory to use for temporary files of the backend with the PHP constant `define("SHARIFF_BACKEND_TMPDIR","/example/path/to/tmp");` There is also the option to change the default TTL from 60s with `define("SHARIFF_BACKEND_TTL","88");` = Q: I need some more options. How could I get them? = A: This plugin is a wrapper to the original project files of Shariff. As long as the original will not get more options, we will not add more to this plugin. = Q: How can I change the design? = A: Have a look at the parameters "theme" and "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 my test page at http://shariff.3uu.net/shariff-sample-page-with-all-options to get an overview. But please be warned: This is my 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. = Q: How can I change the design of a single button? = 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! Have a look at the style 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. ;-) = Q: Can I add [shariff] on all posts? = A: Yes, use the first checkbox in the admin menu to enable it. = Q: Can I change the design on a single post? = A: Yes. If the [shariff...] shortcut is found in a post, it has priority over all settings from the admin menu. = Q: But I want to hide it on a single post! = 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. This will make it compatible with the other plugin "Shariff for Wordpress" that has been published at the same day. You can also use "/hideshariff" to write "hideshariff" in your post. = Q: What are the differences between these two plugins? = A: One is developed by us, one by someone else. ;-) The main difference is that this plugin has a few more options. = Q: The fonts load slowly, can I use a CDN? = A: The best way would be to use a CDN for your blog host. The original shariff project has references to CDN hosted fonts. But it is possible that the hoster sends headers that force the browser to reload the fonts on any page. This would enable tracking again, depending on how honest the font hoster is. So I strongly suggest to use the copy that is within the plugin directory on your server. = Q: I do not get the numbers / Got error "tmp dir must be writable" = A: Your webserver must be able to connect to other webservers. Please check your PHP configuration and firewall settings. If you get the error "tmp dir must be writable" your webserver does not have a directory to write temporary data. Also please have in mind that the plugin has a timeout of 60 seconds, because most services do not accept more request. = Q: Pinterest does not show an image = A: You can add media="http://wwww.example.com/yourImage.png" within the [shariff...] shorttag or add it in the admin menu. Of course with the link to your image. ;-) = Q: Can I set a fixed URL to share? = A: You can use the "url" parameter within the shortcode `[shariff url="http://www.example.com/"]` This is also available within widgets. However, I think 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 within the admin menu. = Migration needed = Version 2.0: We plan to change the behavior of the service "mail" back to the original one that provides an e-mail form on the side and not a mailto-link. Therfore a new service "mailto" has been defined that provides the current mailto functionality. So please change you configuration asap. == Changelog == = 1.9.9 = - fix widget bug (wrong share links) = 1.9.8 = - add headers to avoid caching of backend data - tested with WP 4.2 beta - add option to use on custom pages (e.g. WooCommerce) - better handling of pinterest media attribute - bugfix: SHARIFF_BACKEND_TMPDIR in backend - improve uninstal of cache dir (todo: change to a better named dir) - add option to use smaller size buttons - fix again target of the mailto-link - cleanup code = 1.9.7 = - roll back to stable = 1.9.6 = - now really go back to 1st block in loop at WMPU = 1.9.5 = - nu abba: missing version update = 1.9.4 = - fix update bug on WPMS = 1.9.3 = - add missing backend files. Last change for this Sunday ;-) = 1.9.2 = - fix stupid bug with the update file :-( Sorry! - fix initialisation of REMOTEHOSTS = 1.9.1 = - merge with original Shariff JS/CSS code version 1.9.3 - CSS theme default like Heise default again + "add" theme color - fix the theme "white" - backend now up to date - disable WPDebug in backend config - improve uninstall (options shariff3UU, shariff3UUversion, widget_shariff) and compatible with multisite installations - improve deactivation = 1.9 = - add Flattr - improve version control - update frensh translations - use configuration from admin menu for blank shariff shortcodes - own (much smaller) fonts = 1.8.1 = - remove the relativ network-path from service declarations (pinterest, reddit, stumbleupon, xing) because it really makes no sense to change the protocol within a popup of a secure target to unsecure connections depending on the protocol the page is using - change name of jQuery object to avoid conflicts with other plugins/themes = 1.8 = - add options to place Shariff (right/left/center) - fix: migration check - css optimized - use the WP bundled jQuery now (save about 80% bandwidth :-) = 1.7.1 = - optimize css (thanks again to @jplambeck) - code cleanup (No more warnings in debug mode. Perhaps ;-) - sanitize admin input (thanks again to @jplambeck) - set the title attribute to overwrite get_the_title() now supported - fix: check SHARIFF_BACKEND_TMPDIR - add uninstall script = 1.7 = - CHANGES: if no attributes are configured within a shorttag first try to use the option from admin page. However if there are no services configured use the old defaults of Heise to make it backward compatible - add the new service attribut `mailto` to prepare getting the original behavior of the Heise code that provide a email form with `mail` - add option to put Shariff on overview page too - add internal version tracker to enable better migration options in the future - optimized css for the info attribute, added priority to the title attribute over DC.title attribute (thanks again to @jplambeck ) = 1.6.1 = - fix: again enable WhatsUp on mobile now also works with Mozilla. Sorry this has not been become part of the main branche. Therefor it was lost with the last update :-( - added .shariff span { color: inherit; } (thanks again to @jplambeck ) = 1.6. = - adopted new responsive css code (thanks to @jplambeck ) - update included fa-fonts - fix: descrition "printer" - fix: use WP_CONTENT_URL in admin menu = 1.5.4 = - remove alternativ css with links to external hosters. If do you really want enable breaking privacy plz feel free to code you own css = 1.5.3 = - hide counter within the theme round = 1.5.2 = - default backend temp dir now uses wp content dir - updated original shariff JS code = 1.5.1 = - fix: constant had have a wrong declaration check = 1.5.0 = - add option "url" to set a fixed URI for all sites (only in shorttag and widgets) because usually it is not a good idea to manipulate this - fix: do not show error in elseif (/tmp check in admin menu) = 1.4.4 = - add option to force frensh and spanish buttons - clean up theme selection = 1.4.3 = - look like wp_enqueue_script has problems with the shariff js code. Now own script link at the end of the site. Should also improve performance ;-) = 1.4.2 = - fix: add the attribute data-title that is needed by the shariff on some themes to render it above the other div containers. - only long PHP-Tags because auf problems with WAMPs - some code clean up. Hopefully it will become more robust on WAMP systems. = 1.4.1 = - fixed stupid typo with the SHARIFF_BACKEND_TMP constant = 1.4.0 = - add a DIV container to use positioning with CSS - remove long PHP-tags that cause parse problem on Windows = 1.3.0 = - clean up the code - add backend options (TTL and temp dir) = 1.2.7 = - fixed: enable WhatsUp on mobile now also works with Mozilla - print button does not open a new window - removed min.js make it more readable for own local changes = 1.2.6 = - add print button - add default image for pinterest to avoid broken design and giuve a hint = 1.2.5 = - hotfix for pinterest (see FAQ) = 1.2.4 = - bugfix: widget does not work if SHARIFF_ALL_POSTS is set but not enabled in the admin menu (Please remember, that SHARIFF_ALL_POSTS will be removed with next major version) - add option to add shariff at the begin of a post - merge with new original backend for counters - add spanish language on buttons; hide whatsup on mobile devices (merge with yanniks code) - add reddit - add stumbleupon = 1.2.3 = * add round theme to the admin menu = 1.2.2 = * tested with WP 4.1 * added french language for buttons * added theme "round" (round buttons without text but with fixed width) = 1.2.1 = * typos = 1.2 = * add widget support = create a Stable1.0 tag = * no new funtionality to this tag. Only bugfixes! = 1.1.1 = * add french language for the admin menu (thanks Celine ;-) * fix backend problem on shared hosting with no writeable tmp dir = 1.1 = * add whatsapp|pinterest|linkedin|xing * include latest upstream changes (fix mail etc.) * add old default selection of services to make it backward compatible = 1.0.2 = * add German translation to the admin menu (Admin-Menue in Deutsch) * code cleanup = 1.0.1 = * add PHP version check (5.4 is needed by the backend option) = 1.0 = * add admin menu page * disable the default add on a post if a special formed tag was found * add support for the theme attribute = 0.4 = * Include latest upstream changes * use get_permalink() to set the parameter data-url = 0.3 = * add support for "hideshariff" * add screenshots = 0.2 = * removed the private update server and changed test domain = 0.1 = * initial == Upgrade Notice == = 1.0 = Added admin menu. Support for SHARIFF_ALL_POSTS constant can be removed with next major release! = 0.1 = Initial code. See README