vanilla-sharing

Small (1.5 KB) simple tool for sharing url, title, description and image to VK, Facebook (Feed, Dialog, Button, Messenger), Twitter, Reddit, Pinterest, Tumblr, VK, OK, Mail.ru, LinkedIn, Whatsapp, Viber, Telegram, Line.

DEMO


Motivation

Adding sharings to a project is digging in the documentation of the corresponding social networks. With this set of small functions, we have already done everything for you. Just take them and use!

Installation

From NPM

``sh
npm install --save vanilla-sharing
`

From unpkg CDN (you can use other)

`html

`

Usage

From NPM

`js
import { fbButton } from 'vanilla-sharing';

fbButton({
url: 'https://alexey-avdeev.com/vanilla-sharing/',
});
`

From CDN

`js
VanillaSharing.fbButton({
url: 'https://alexey-avdeev.com/vanilla-sharing/',
});
`

API

$3

Share on facebook.com via the Feed dialog

Documentation: https://developers.facebook.com/docs/sharing/reference/feed-dialog

`js
fbFeed({
url: string,
redirectUri: string,
fbAppId: string,
})
`

You can use getFbFeedUrl(options) for getting URL.

$3

Share on facebook.com via the Share dialog

Documentation: https://developers.facebook.com/docs/sharing/reference/share-dialog

`js
fbShare({
url: string,
redirectUri: string,
hashtag: string,
fbAppId: string,
quote: string,
})
`

You can use getFbShareUrl(options) for getting URL.

$3

Share on facebook.com using facebook share button

`js
fbButton({
url: string,
})
`

You can use getFbButtonUrl(options) for getting URL.

$3

Share via Facebook Messenger

Share method from Sharing for Messenger.

`js
messenger({
url: string,
fbAppId: string,
})
`

$3

Share on Twitter

`js
tw({
url: string,
title: string,
hashtags: array,
})
`

You can use getTwUrl(options) for getting URL.

$3

Share on Reddit

`js
reddit({
url: string,
title: string,
})
`

$3

Share on Pinterest

`js
pinterest({
url: string,
description: string,
media: image url string,
})
`

$3

Share on Tumblr

`js
tumblr({
url: string,
title: string,
caption: string,
tags: array,
})
`

$3

Share on vk.com

`js
vk({
url: string,
title: string,
description: string,
image: string,
isVkParse: boolean,
})
`

You can use getVkUrl(options) for getting URL.

$3

Share on ok.ru

Like/Share button

`js
ok({
url: string,
title: string,
image: string,
})
`

You can use getOkUrl(options) for getting URL.

$3

Share on Mail.ru

`js
mail({
url: string,
title: string,
description: string,
image: string,
})
`

$3

Share via user's email

`js
email({
to: string,
url: string,
title: string,
description: string,
subject: string,
})
`

You can use getEmailUrl(options) for getting URL.

$3

Share on LinkedIn

Share method from Share on LinkedIn.

`js
linkedin({
url: string,
title: string,
description: string,
})
`

$3

Share via Whatsapp

WhatsApp FAQ - Using Click to Chat.

`js
whatsapp({
url: string,
title: string,
phone: string,
})
`

You can use getWhatsappUrl(options) for getting URL.

$3

Share via Viber

Viber Share Button docs.

`js
viber({
url: string,
title: string,
})
`

You can use getViberUrl(options) for getting URL.

$3

Share via Telegram

`js
telegram({
url: string,
title: string,
})
`

You can use getTelegramUrl(options) for getting URL.

$3

Share via Line

`js
line({
url: string,
title: string,
})
``