Joomla 4 Shariff Plugin

The 1-Click-Social-Button with privacy in mind

This Joomla 3 Plugin utilizes Heise Shariff Library to enable website users to share their favorite content without compromising their privacy.

Help with translation:

• https://www.transifex.com/jooag/plg_jooag_shariff/

System Requirements:

• Joomla 4.x
• PHP 8.x

Plugin features:

• Joomla Update integration
• Use this Plugins in your Modules and Articles via {shariff} shorttag
• Now with shorttag parameter support e.g. {shariff orientation=vertical theme=white}
• Languages: English, German, France (Contributed from: Simon | cinnk.com)
• Restrict the plugin execution to Menu Items or Content Categories
• Exclude Components
• Ordering for your Buttons
• Extended Shariff Backend Cache Handler
• Plugin settings for Themes, Orientation, Services and much more...

Shariff Library features:

• Services: Twitter, Facebook, GooglePlus, LinkedIn, Pinterest, Xing, Whatsapp, Addthis, tumblr
• Themes: Color, Grey, White
• Orientation: Horizontal, Vertical
• Responsive: Yes
• Shariff Languages: bg, de, en, es, fi, hr, hu, ja, ko, no, pl, pt, ro, ru, sk, sl, sr, sv, tr, zh
• Counter: Shariff Backend PHP integration

Changelog:

• v3.0 - Initial release with Heise Shariff Library and Shariff Backend integration
• v3.1 - Icon ordering, more bugifixing, facebook api integration, move assets folder to the joomla media folder
• v3.2 - Custom settings for theme and orienation in every shorttag e.g. {shariff orientation:vertical theme:grey}
• v3.2.2 - Reduce the size of the plugin (get rid of the Shariff Backend docs and fluff)
• v3.2.5 - Check the Joomla and PHP Version and prevent the installation if not the requirements met
• v3.2.8 - New: AddThis button
• v3.2.9 - New: tumblr button
• v3.3.0 - Shorttag parameter support for custom icons, backend integration and other shariff settings
• v3.3.0 - Rearrange the Plugin Options and simplify settings
• v4.0.0 - Upated Shariff Frontend and Backend Library
• v5.0.0 - Updated Shariff Frontend and Backend Library
• v6.0.0 - Joomla 4 Compatibility

Future plans & Roadmap:

• More Options for Info and Print
• Override functionality

Update Instructions:

* All previous versions before 5.0.0 * You need to uninstall the old Jooag Shariff Plugin * Make a fresh install and do the needed Settings again. * Please, make a note of your current settings.

Documentation:

First steps

• Install the latest Plugin Version.

• Login into your Joomla Backend and go to Extensions->Plugins and find the "Jooag Shariff" Plugin.

• Open the Plugin and activate it.

• Goto the "Services" Tab and add your needed services.

• Goto the "Output" Tab and go through the settings. =======

• Login into your Joomla Backend and go to Extensions->Plugins and find the "Jooag Shariff" Plugin.

• Open the Plugin and activate it.

• Goto the "Services" Tab and add your needed services.

• Goto the "Output" Tab and go through the settings.

• Goto the "Counter" Tab and activate the Counter, if you like to see the count of the shares.

Share Counter:

It's really important for the counter to use the url only with www or non-www.

To redirect www to non-www do the following steps:

1. Rename the htaccess.txt in your joomla root folder to .htaccess
2. Add following lines in the end of the .htaccess file

# www to non-www
RewriteBase /
RewriteCond %{HTTP_HOST} ^www\.(.*)$ [NC]
RewriteRule ^(.*)$ http://%1/$1 [R=301,L]

or

# non-www to www
RewriteCond %{HTTP_HOST} !^www\.
RewriteRule ^(.*)$ http://www.%{HTTP_HOST}/$1 [R=301,L]

3. At least you need to open this plugin and save it again!

Use this Plugin as a Shariff Joomla Modul

• You can put into your content or "Custom Html" module the following shortcode and set the Option "Prepare Content" to yes!

{shariff}

• You can also override the Global Plugin Settings for theme and orientation like this:

 {shariff theme=color}
 {shariff theme=grey}
 {shariff theme=white}
 {shariff orientation=horizontal}
 {shariff orientation=vertical}

• You can combine this tags, too:

 {shariff theme=color orientation=horizontal}
 {shariff theme=white orientation=vertical}

• Theme variables
• color
• grey
• white
• Orientation variables
• horizontal
• vertical

Credits:

Developed by https://joomla-agentur.de

Thanks Heise.de for this solution https://github.com/heiseonline/shariff

Thanks Joomla! our lovely CMS https://joomla.org

and for Joomla! Joomla User Group Hamburg https://jug-hamburg.de/ (the main reason for this plugin :-)

Many thanks for your help and support!

• David Jardin - https://www.djumla.de/
• Robert Deutz - https://rdbs.de/
• Tobias Zulauf - https://www.jah-tz.de/
• Viktor Vogel - https://joomla-extensions.kubik-rubik.de/
• Yves Hoppe - https://compojoom.com/