Skip to content

๐Ÿš€ Easily generate share links for Facebook, Twitter, LinkedIn and Email

Notifications You must be signed in to change notification settings

Alex61NN5/easy-social-share-links

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

16 Commits
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ Easy Social Share Links

npm version bundlephobia twitter

Easily generate share links for Facebook, Twitter, LinkedIn and Email!

Demo ๐Ÿ„โ€โ™‚๏ธ

https://easysocialsharelinks.netlify.com/

Features ๐Ÿ”ฅ

  • Less than 2kb! (under 1kb minified)
  • Zero Dependencies
  • Easy to use! ๐Ÿ’ช

Install ๐Ÿ”ฎ

$ npm install easy-social-share-links

or

$ yarn add easy-social-share-links

Usage ๐Ÿ’ป

import shareLink from "easy-social-share-links"

shareLink('fb', 'https://github.com/Alex61NN5/easy-social-share-links');

Input

The method takes 2 arguments with an optional third and fourth.

First argument is the provider, the options are 'fb', 'tw', 'li', 'em'.

fb = facebook
tw = twitter
li = linkedIn
em = email

Second argument is the link you wish to share eg. 'https://github.com/Alex61NN5/easy-social-share-links'

Third argument is optional and will work will all providers except for fb as of writing this facebook does not have a standard way to add text to a share link (if this ever changes please submit a pull request). The third argument is some text that will go before the link in either a tweet or linkedIn share, for em it will become the subject of the email.

Fourth Argument is optional and will only work when using 'em' which is emailBody, this is some text you can write before the link is shared in the email.

Output

Examples:

// Facebook share
shareLink('fb', 'https://github.com');
'https://www.facebook.com/sharer/sharer.php?u=https://github.com'

// Twitter share no text
shareLink('tw', 'https://github.com');
'https://twitter.com/intent/tweet?url=https://github.com'

// Twitter share with text
shareLink('tw', 'https://github.com', 'Check out this awesome site!');
'https://twitter.com/intent/tweet?url=https://github.com&text=Check out this awesome site!'

// LinkedIn share
shareLink('li', 'https://github.com')
'https://www.linkedin.com/shareArticle?mini=true&url=https://github.com'

// email share no subject or body
shareLink('em', 'https://github.com')
'mailto:&body=https://github.com'

// email share with subject
shareLink('em', 'https://github.com', 'Check out this website')
'mailto:?subject=Check out this website&body=https://github.com'

// email share with subject and body
shareLink('em', 'https://github.com', 'Check out this website', 'no really check it out heres the link')
'mailto:?subject=Check out this website&body=no really check it out heres the link https://github.com'

Support ๐Ÿ’ฌ

  • ๐Ÿž For Bug Reports and Enhancements please use the issues section

  • ๐Ÿ•Š๏ธ To contact me directly you can find me via my twitter