The social sharing buttons that aren’t shabby
The social sharing buttons that aren’t shabby.
Version 3.1 is out
See Likely in action on its homepage. More on choosing a theme
Likely supports following social networks and messengers:
facebook – Facebooklinkedin – LinkedInodnoklassniki – OK (Odnoklassniki)pinterest – Pinterestreddit – Reddittelegram – Telegramtwitter – Twitterviber – Vibervkontakte – VKwhatsapp – WhatsAppDownload the last release and move likely.js and
likely.css to the desired directory.
Or use npm or Bower:
$ npm install ilyabirman-likely --saveAlso you can use Likely from CDN:
https://unpkg.com/ilyabirman-likely@2/release/likely.min.css
https://unpkg.com/ilyabirman-likely@2/release/likely.min.js
or
https://unpkg.com/ilyabirman-likely@2/release/likely.css
https://unpkg.com/ilyabirman-likely@2/release/likely.js
Link the files likely.css and likely.js from the compiled sources. Minified .min. versions also can be used for this.
If downloaded directly:
If installed with npm:
Then, create a div with the class likely and list necessary social networks:
If you need several Likely widgets on the page, just create another div with the class likely and list the social networks in it.
Likely can be used as a CommonJS module, so you can use it within webpack or browserify build systems.
First, install Likely using npm:
$ npm install ilyabirman-likely --saveThen, use it as CommonJS module somewhere in your program:
var likely = require('ilyabirman-likely');
// Finds all the widgets in the DOM and initializes them
likely.initiate();You can configure Likely by specifying data-* attributes on a button group with the likely class or on the button of a specific service.
Top-level options are passed down to all the services. They can also be overridden on an individual service tag.
data-url – URL to share and load counters for, defaults to the current page URL. ⚠ Specify the full URL with the protocol – like in https://ilyabirman.com – because some social networks don’t recognize the partial one.data-title – Text that will be added to the shared URL. Defaults to the page title.In 2020 most social networks rely on what is called Open Graph Protocol to extract the information about shared links. Below there is more information regarding how individual services support it, but it's highly recommended to set up the proper tags for your page, to work in conjunction with Likely.
Facebook Open Graph protocol documentation
Linkedin Open Graph protocol documentation.
OK Open Graph protocol documentation.
Pinterest Open Graph protocol documentation.
Reddit counter is calculated as a sum score of the 5 most up-voted posts for a given link, across all sub-reddits.
Reddit Open Graph protocol documentation.
Telegram Open Graph protocol documentation.
My page: https://google.com/ via @ilyabirmanTwitter Open Graph protocol documentation.
⚠ Viber share messages are not editable in the client application,
so if you don't want the title to appear, please set empty data-title="" attribute on the Viber button.
⚠ Viber button works only if the user has Viber installed on their device.
Viber Open Graph protocol documentation
VK Open Graph protocol documentation (switch to Russian language, English docs are incomplete).
Whatsapp Open Graph protocol documentation.
If you need to dynamically change the widget's configuration, you can re-initialize it:
// Use global object, created by the library
likely.initiate();
// If you need to refresh the counters, pass the corresponding param,
// but be aware that it will issue xhr calls to all the relevant services.
likely.initiate({forceUpdate: true});Counters are enabled by default, but there are two ways to disable them:
data-counters attribute on the upper likely div with "no"value to disable all counters.data-counter attribute of the specific services.
Likely won't do an API request for those services and just display the given value instead.From version 4 Likely uses Shadow Dom, but attributes role and aria-label on top-level
### Light / dark theme
It's possible to use alternative (dark-mode suitable) styling by adding `likely-dark-theme` (or its old alias `likely-light`) class to the main `div.likely`
```html
Additionally, if your website is responsive to users' color theme preferences, having .likely-color-theme-based will result in conditional switch between the themes.
We support IE 10+, Safari 9+ and the latest versions of Chrome, Firefox and Edge. Likely might work in the older versions too but we don’t maintain the compatibility on purpose.
Please use the Github commit style. Before pushing make sure the tests are green and the linter does not complain.
npm test
npm run-script check-codestyleAlso, please, add your own tests if you are submitting a feature.
No open issues yet, or sync has not completed.