jQuery plugins - Sharrre
jan 31

Sharrre

Közösségi megosztások

Verzió: beta v1.2.0
Kiadás dátuma: 2012/12/14
Fejlesztő: Julien Hany
Liszensz: MIT, GPL v2

Bevezető

A Sharrre segítségével kitehetjük weblapunkra a fontosabb közösségi oldalak megosztási gombjait, valamint azok kinézetét tetszés szerintire szabhatjuk. Az 1.2.0 beta verzió által támogatott közösségi oldalak a következők:

Implementálás

CSS

            <link rel="stylesheet" type="text/css" href="css/style.css" />
          

JavaScript

            <script type="text/javascript" src="js/jquery.js"></script>
            <script type="text/javascript" src="js/jquery.sharrre-1.2.0.min.js"></script>
          

Deklaráció

            $(document).ready(function(){
              $('#pelda').sharrre({
                share: {
                  googlePlus: true,
                  facebook: true,
                  twitter: true
                },
                buttons: {
                  googlePlus: { size: 'tall' },
                  facebook: { layout: 'box_count' },
                  twitter: { count: 'vertical', via: '_JulienH' }
                },
                hover: function(api, options){
                  $(api.element).find('.buttons').show();
                },
                hide: function(api, options){
                  $(api.element).find('.buttons').hide();
                },
                enableTracking: true
              });
            });
          

Teljes paraméterlista

  • share: az egyes közösségi oldalak megosztási gombjainak engedélyezése/tiltása
    (googlePlus, facebook, twitter, digg, deliciouse, stumbleupon, linkedin)
    Példa:
                    share: {
                      googlePlus: true,
                      facebook: true,
                      twitter: true,
                      digg: false,
                      deliciouse: false,
                      stumbleupon: false,
                      linkedin: false
                    }
                  
  • template: a gombok egyéni testreszabása (példa a használatra: sharrre.com - 2. példa)
  • title: felirat a megosztás blokkhoz
  • url: a hivatkozott honlap elérhetősége (alapértelmezett: document.location.href)
  • urlCurl: a PHP fájl (a letölthető állományban megtalálható) URL-je a Google Plus számlálójának használatához - üres sztring esetén a 'Google Plus' gomb számláló nélkül jelenik meg
  • count: az egyes közösségi megosztások számának lekérdezése
    (példa a használatra: sharrre.com - 4. példa)
  • total: 'összes megosztás' (példa a használatra: sharrre.com - 2. példa) (alapértelmezett: 0)
  • shorterTotal: az 'összes megosztás' rövidített formátumának (pl. 1.2K, 5M) engedélyezése/tiltása (true | false) (alapértelmezett: true)
  • enableHover: megosztás gombok engedélyezése/tiltása (true | false) (alapértelmezett: true)
  • enableCounter: összesített számláló megjelenítésének engedélyezése/tiltása (true | false) (alapértelmezett: true)
  • enableTracking: közösségi megosztások nyomonkövetésének engedélyezése/tiltása a Google Analytics felületén (bővebben a plugin oldalán: sharrre.com) (true | false) (alapértelmezett: false)
  • hover: függvény a hover esemény testreszabására
  • hide: függvény a hide esemény testreszabására
  • click: függvény a click esemény testreszabására
  • render: függvény a render esemény testreszabására
  • buttons: megosztási gombok testreszabása
    Példa:
                    buttons: {
                      googlePlus: { size: 'tall' },
                      facebook: { layout: 'box_count' },
                      twitter: { count: 'vertical' },
                      digg: { type: 'DiggMedium' },
                      delicious: { size: 'tall' }
                    }
                  

Metódusok

  • openPopup (site): megadott közösségi oldal megnyitása felugró ablakban és a nyomkövetés hozzáadása (ha engedélyezve van)
    Példa:
                    click: function(api, options) {
                      api.openPopup('facebook');
                    }
                  
  • simulateClick (): adott gombon a klikkelés szimulációja klikkelést követően - még ha nem is vagyunk adott közösségi oldalra bejelentkezve. Látszólagosan eggyel növeli a megosztás értékét.