{"id":19273794,"url":"https://github.com/delfimov/js-share","last_synced_at":"2025-04-21T22:33:13.953Z","repository":{"id":41086504,"uuid":"98665138","full_name":"delfimov/JS-Share","owner":"delfimov","description":"Social media share. This project is intended to help you integrate sharing within your code. Supports Facebook, Reddit, Twittier, Telegram, Whatsapp, VK, OK.ru and many others.","archived":false,"fork":false,"pushed_at":"2020-05-21T16:26:29.000Z","size":29,"stargazers_count":47,"open_issues_count":4,"forks_count":14,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-01T16:24:11.152Z","etag":null,"topics":["commonjs","javascript","javascript-library","js-share","messenger","share","sharing","social","social-networks","vanilla-javascript"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/delfimov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-07-28T15:55:08.000Z","updated_at":"2025-03-07T02:02:47.000Z","dependencies_parsed_at":"2022-08-03T11:45:50.807Z","dependency_job_id":null,"html_url":"https://github.com/delfimov/JS-Share","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delfimov%2FJS-Share","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delfimov%2FJS-Share/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delfimov%2FJS-Share/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delfimov%2FJS-Share/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/delfimov","download_url":"https://codeload.github.com/delfimov/JS-Share/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250145129,"owners_count":21382353,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["commonjs","javascript","javascript-library","js-share","messenger","share","sharing","social","social-networks","vanilla-javascript"],"created_at":"2024-11-09T20:44:07.686Z","updated_at":"2025-04-21T22:33:08.939Z","avatar_url":"https://github.com/delfimov.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# JS-Share - social and messengers sharing \n\nEasy to use social media share library. This project is intended to help you integrate sharing within your code.\n \n## Key features\n* Small size\n* Vanilla javascript\n* No dependency\n* IE9+, Chrome, Safari, Firefox support\n* CSS styling is up to you\n* Supports AMD/CommonJS\n\n## Installation\n\n### Package Managers\n\nJavaScript Share supports [npm](https://www.npmjs.com/package/js-share) under the name `js-share`.\n\n```bash\nnpm install js-share --save\n```\n\n### Direct download\n\nDownload the script [here](https://github.com/delfimov/JS-Share/blob/master/src/jsshare.js) and include it (unless you are packaging scripts somehow else):\n\n```html\n\u003cscript src=\"/path/to/jsshare.js\"\u003e\u003c/script\u003e\n```\n\n**Do not include the script directly from GitHub (http://raw.github.com/...).** The file is being served as text/plain and as such being blocked\nin Internet Explorer on Windows 7 for instance (because of the wrong MIME type). Bottom line: GitHub is not a CDN.\n\n\n### Module Loaders\n\nJavaScript Share can also be loaded as an AMD or CommonJS module.\n\n## Supported sharing platforms\n * Facebook\n * Twitter\n * LinkedIn\n * VK\n * OKru\n * Google+\n * GoogleBookmarks\n * Reddit\n * Tumblr\n * Pinterest\n * Weibo\n * Baidu\n * Mail.Ru\n * Line.me\n * Telegram\n * WhatsApp\n * Viber\n * Skype\n * Email\n\n\n## Basic Usage\n\nHTML code:\n```html\n    \u003cdiv\u003eShare:\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"fb\"\u003eFacebook\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"twitter\"\u003eTwitter\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"vk\"\u003eVK.com\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"ok\"\u003eOK.ru\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"mailru\"\u003eMail.Ru\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"gplus\"\u003eGoogle+\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"googlebookmarks\"\u003eGoogle Bookmarks\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"livejournal\"\u003eLiveJournal\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"tumblr\"\u003eTumblr\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"pinterest\"\u003ePinterest\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"linkedin\"\u003eLinkedIn\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"reddit\"\u003eReddit\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"mailru\"\u003eMail.ru\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"weibo\"\u003eWeibo\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"line\"\u003eLine.me\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"skype\"\u003eSkype\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"telegram\"\u003eTelegram\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"whatsapp\"\u003eWhatsapp\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"viber\"\u003eViber\u003c/button\u003e\n        \u003cbutton class=\"btn btn-default social_share\" data-type=\"email\"\u003eEmail\u003c/button\u003e\n    \u003c/div\u003e\n```\n\nJavascript code:\n\n```javascript\nimport JSShare from \"js-share\";\nvar shareItems = document.querySelectorAll('.social_share');\nfor (var i = 0; i \u003c shareItems.length; i += 1) {\n  shareItems[i].addEventListener('click', function share(e) {\n    return JSShare.go(this);\n  });\n}\n\n```\n\nor \n\n```javascript\nimport JSShare from \"js-share\";\nvar shareItems = document.querySelectorAll('.social_share');\nJSShare.options.url = \"http://www.example.com/fancy/url\";\nfor (var i = 0; i \u003c shareItems.length; i += 1) {\n  shareItems[i].addEventListener('click', function share(e) {\n    return JSShare.go(this);\n  });\n}\n```\n\nSee working demo `example.html`.\n\nData attributes:\n* `data-type` - where to share. Required. \n* `data-url` - URL to share. Default value is the current page location (`location.href`).\n* `data-title` - title to share. Default is the current page title (`document.title`). \n* `data-text` - share description. Only for vk, ok, googlebookmarks, lj, tumblr, linkedin, mailru, email. \n* `data-utm_source` - utm_source for links. Default is none.\n* `data-utm_medium` -  utm_medium for links. Default is none.\n* `data-utm_campaign` - utm_campaign for links. Default is none.\n* `data-popup_width` - popup width. Default is `626` pixels.\n* `data-popup_height` - popup height. Default is `436` pixels.\n\nSame options could be used on script initialization.\n\n`data-title` and `data-text` are optional and will be ignored by some services. \nSocial networks usually get all required data from [Open Graph](http://ogp.me/) metadata (`og:*` tags).\n\n\n## More examples\n\n```html\n    \u003cbutton class=\"social_share\" utm_source=\"messengers\" data-utm_medium=\"telegram\" data-type=\"telegram\"\u003eTelegram\u003c/button\u003e\n    \u003cbutton class=\"social_share\" utm_source=\"messengers\" data-utm_medium=\"whatsapp\" data-type=\"whatsapp\"\u003eWhatsapp\u003c/button\u003e\n    \u003cbutton class=\"social_share\" utm_source=\"messengers\" data-utm_medium=\"viber\" data-type=\"viber\"\u003eViber\u003c/button\u003e\n```\n\nor\n\n```html\n    \u003cbutton class=\"social_share\" utm_source=\"messengers\" data-utm_medium=\"vk\" data-url=\"http://www.example.com/fancy/url\" data-type=\"vk\"\u003eVK.com\u003c/button\u003e\n    \u003cbutton class=\"social_share\" utm_source=\"messengers\" data-utm_medium=\"fb\" data-url=\"http://www.example.com/fancy/url\" data-type=\"fb\"\u003eFacebook\u003c/button\u003e\n    \u003cbutton class=\"social_share\" utm_source=\"messengers\" data-utm_medium=\"ok\" data-url=\"http://www.example.com/fancy/url\" data-type=\"ok\"\u003eOK.ru\u003c/button\u003e\n```\n\n\n## License\n\nMIT © Dmitry Elfimov.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdelfimov%2Fjs-share","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdelfimov%2Fjs-share","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdelfimov%2Fjs-share/lists"}