Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/popomore/social-share

A simple and easy-to-use social share tool.
https://github.com/popomore/social-share

Last synced: 2 months ago
JSON representation

A simple and easy-to-use social share tool.

Awesome Lists containing this project

README

        

# Social Share [![Build Status](https://secure.travis-ci.org/popomore/social-share.png)](http://travis-ci.org/popomore/social-share)

A simple and easy-to-use social share tool. It can be used in both browser and nodejs.

---

First of all, view the [example](http://popomore.github.com/social-share/examples/).

## How to use

Html

```

twitter
facebook
```

Javascript

```
var list = document.getElementsByTagName('a');
Share.init(list, {
title: 'share it',
url: 'https://github.com/popomore/social-share'
});
```

Find the DOM and bind event, popup the window and redirect to the service when DOM is clicked.

`data-service` must be specified. See [Support service](#support-service)

### DATA-API

```
twitter
```

DATA-API is higher priority than options, then the share content will be "share twitter".

### Parameter

- **title** - share content
- **url** - share url
- **pic** - share picture

However, not all of the services support these parameter, view the [defference](https://github.com/popomore/social-share/wiki).

## Support service

Icon | Service | website
------ | ----- | -----
![](https://raw.github.com/popomore/social-share/master/assets/sina.png) | sina | http://weibo.com/
![](https://raw.github.com/popomore/social-share/master/assets/douban.png) | douban | http://www.douban.com/
![](https://raw.github.com/popomore/social-share/master/assets/kaixin.png) | kaixin | http://www.kaixin001.com/
![](https://raw.github.com/popomore/social-share/master/assets/netease.png) | netease | http://t.163.com/
![](https://raw.github.com/popomore/social-share/master/assets/qq_t.png) | qq_t | http://t.qq.com/
![](https://raw.github.com/popomore/social-share/master/assets/qq_zone.png) | qq_zone | http://qzone.qq.com/
![](https://raw.github.com/popomore/social-share/master/assets/renren.png) | renren | http://renren.com/
![](https://raw.github.com/popomore/social-share/master/assets/sohu.png) | sohu | http://t.sohu.com/
![](https://raw.github.com/popomore/social-share/master/assets/facebook.png) | facebook | http://www.facebook.com/
![](https://raw.github.com/popomore/social-share/master/assets/twitter.png) | twitter | http://twitter.com/

[The difference between services](https://github.com/popomore/social-share/wiki)

### Add new service

Edit `src/parser.js`, and add service url which just support three parameter(title, url, pic).

## jQuery support

If you use jQuery, it's easy to use.

```
$('selector').share({
title:'share it'
});
```

[jQuery Example](http://popomore.github.com/social-share/examples/index.jquery.html)

## Node.js support

Install social-share by npm

```
$ npm install social-share
```

Just use it

```
var share = require('social-share');
var url = share('twitter', {
title:'share it'
});
```

If you use express, you can

```
app.get('/redirect', function(req, res) {
var url = share(req.query.service, req.query);
res.redirect(url);
});
```

You can clone the repo to view the example.

```
$ git clone https://github.com/popomore/social-share.git
$ make server
```

View `http://127.0.0.1:3000/`