Skip to content

joomla-agency/plg_jooag_shariff

Repository files navigation

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:

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
  3. # 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]
    
  4. 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!