You are here

README.txt in Sharerich 7.2

Same filename and directory in other branches
  1. 8 README.txt
  2. 7.3 README.txt
  3. 7 README.txt
Module: Sharerich

Description
===========
Customisable Share buttons for social media.

Dependencies
- ctools
- token
- libraries

Supports
- google_analytics_et (If the module is enabled, GA event tracking will be added to the share buttons)

Installation
============
Put the modules into your sites/module/contrib folder;

Make sure rrssb is in the libraries folder.
If you use drush and make files, it should clone it automatically into /libraries/rrssb

To run the drush command manually, go to the drupal installation folder and run:
$ drush make --no-core ./sites/all/modules/contrib/sharerich/sharerich.make

The command above will download rrssb into ./sites/all/libraries/rrsb folder.

Alternativelly, you can download rrssb library manually from
https://github.com/kni-labs/rrssb/releases/tag/v1.6.0 and place it inside ./sites/all/libraries/rrssb folder.
Sharerich currently supports rrssb version v1.6.0.

Now you can enable Sharerich.
Go to the permissions page and set them accordingly.

Configuration
=============
- Visit /admin/structure/sharerich and create your own button sets;
- Visit /admin/structure/sharerich/settings for general settings;
- Go to each content type, open the Sharerich tab and select how many button sets you want to create.
- Go to each display of the content type and choose which button set to use with each Sharerich field.

Alternativelly, Sharerich creates blocks for each button set (if you tick the box when creating button sets).
see /admin/structure/block

Notes
=====

  - Facebook share:

  It looks like Facebook is now ignoring any custom parameters on the share widget (https://developers.facebook.com/x/bugs/357750474364812/)
  Since facebook.inc service uses www.facebook.com/sharer/sharer.php, it will pull the information from the Open graph tags of the Url being shared.
  If you want to use custom information, you need to use the widget below. Please note that you will need to have a Facebook App Id and Site Url.

  <a href="https://www.facebook.com/dialog/feed?redirect_uri=[sharerich:fb_site_url]&display=popup&app_id=[sharerich:fb_app_id]&link=[sharerich:url]&name=[sharerich:title]&description=[sharerich:summary]" class="popup">
    <span class="icon">
        <svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" width="28px" height="28px" viewBox="0 0 28 28" enable-background="new 0 0 28 28" xml:space="preserve">
            <path d="M27.825,4.783c0-2.427-2.182-4.608-4.608-4.608H4.783c-2.422,0-4.608,2.182-4.608,4.608v18.434
                c0,2.427,2.181,4.608,4.608,4.608H14V17.379h-3.379v-4.608H14v-1.795c0-3.089,2.335-5.885,5.192-5.885h3.718v4.608h-3.726
                c-0.408,0-0.884,0.492-0.884,1.236v1.836h4.609v4.608h-4.609v10.446h4.916c2.422,0,4.608-2.188,4.608-4.608V4.783z"/>
        </svg>
    </span>
    <span class="text">facebook</span>
  </a>


  - To alter the buttons markup.

  hook_sharerich_buttons_alter(&$buttons) {

  }

File

README.txt
View source
  1. Module: Sharerich
  2. Description
  3. ===========
  4. Customisable Share buttons for social media.
  5. Dependencies
  6. - ctools
  7. - token
  8. - libraries
  9. Supports
  10. - google_analytics_et (If the module is enabled, GA event tracking will be added to the share buttons)
  11. Installation
  12. ============
  13. Put the modules into your sites/module/contrib folder;
  14. Make sure rrssb is in the libraries folder.
  15. If you use drush and make files, it should clone it automatically into /libraries/rrssb
  16. To run the drush command manually, go to the drupal installation folder and run:
  17. $ drush make --no-core ./sites/all/modules/contrib/sharerich/sharerich.make
  18. The command above will download rrssb into ./sites/all/libraries/rrsb folder.
  19. Alternativelly, you can download rrssb library manually from
  20. https://github.com/kni-labs/rrssb/releases/tag/v1.6.0 and place it inside ./sites/all/libraries/rrssb folder.
  21. Sharerich currently supports rrssb version v1.6.0.
  22. Now you can enable Sharerich.
  23. Go to the permissions page and set them accordingly.
  24. Configuration
  25. =============
  26. - Visit /admin/structure/sharerich and create your own button sets;
  27. - Visit /admin/structure/sharerich/settings for general settings;
  28. - Go to each content type, open the Sharerich tab and select how many button sets you want to create.
  29. - Go to each display of the content type and choose which button set to use with each Sharerich field.
  30. Alternativelly, Sharerich creates blocks for each button set (if you tick the box when creating button sets).
  31. see /admin/structure/block
  32. Notes
  33. =====
  34. - Facebook share:
  35. It looks like Facebook is now ignoring any custom parameters on the share widget (https://developers.facebook.com/x/bugs/357750474364812/)
  36. Since facebook.inc service uses www.facebook.com/sharer/sharer.php, it will pull the information from the Open graph tags of the Url being shared.
  37. If you want to use custom information, you need to use the widget below. Please note that you will need to have a Facebook App Id and Site Url.
  38. facebook
  39. - To alter the buttons markup.
  40. hook_sharerich_buttons_alter(&$buttons) {
  41. }