Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More →

meddelare-server

Package Overview

Dependencies

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

meddelare-server

Install social share counters on your website with your own hosted solution which only makes 1 API request and loads minimal or zero assets to display the counters.

1.0.0
Source
npm

Version published: 9 years ago

Weekly downloads: 3; increased by200%

Maintainers: 1

Weekly downloads

Created: 9 years ago

Source

Install social share counters on your website with your own hosted solution which only makes 1 API request and loads minimal or zero assets to display the counters.

This is an open source and self-hosted alternative to services such as AddThis and ShareThis.

Because you run the middle man server your self, you are also defending your users privacy against the social networks. (Users only opt into the tracking once they decide to share and not just because they visited your page)

Features

Heroku enabled, create an app and deploy instantly
Has cache control variable(default 4 mins) so you can throw CloudFront in front with ease which result in faster API calls and less chance of getting rate limited

Getting started

Clone(or fork) the repository
Install dependencies npm install
Run the server node social-buttons-server.js
Access your stats at http://localhost:5000/?networks=facebook,twitter,googleplus&url=http://meddelare.com
Optionally push to a heroku app to automatically deploy

Options

Options are passed through query parameters in the url

Networks

Currently only Twitter, Facebook and Google Plus are supported

You use the networks query parameter to specify which ones you want to use as a comma-separated list e.g.

networks=facebook,twitter,googleplus or networks=facebook

Url

You use the url parameter to specify the address which you want to count the total number of shares for e.g. url=http://1984day.com

If you don't specify a url then the server will try to get the referring urls total share count. So if you make the API call on your homepage without the url parameter, the API server will return the numbe rof shares for your homepage url.

CloudFront

You don't want to be hitting the social networks API's constantly so it would be wise to throw up a cache in front such as CloudFront.

In CloudFront just make sure you to inherit cache control directives from the server and enable query string forwarding.

Eithr use your CloudFront url to access the API server or cname it with a custom domain of your choice.

Cross domain

The server as it is has CORS enabled which means any website can call the API SERVER. You can easily white list if this becomes a problem.

HTML Widgets

We would love to start collecting widgets that people design and want to share, please submit them in a pull request to meddelare-examples and we will create a new section to list them

You can do anything you want to display your share totals when using the API. There are the examples linked at the top of the README and some short code below. Notice that we are using a CloudFront distribution in the examples.

<html>
	<head>
	</head>
	<body>
		<h3>Twitter</h3>
    <span id="twitter"></span>
    <h3>Facebook</h3>
    <span id="facebook"></span>
    <h3>Google Plus</h3>
    <span id="googleplus"></span>

  <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/2.0.3/jquery.min.js"></script>
  <script type="text/javascript">
    $.ajax('https://d12cncu17l9pr5.cloudfront.net/?networks=facebook,twitter,googleplus&url=http://meddelare.com', {
      success: function (res, err) {
        $.each(res, function(network, value){
          $('#'+network).text(value);
        })      
      }
    })
  </script>
	</body>
</html>

Thanks

Many thanks goes out to Taskforce for their social-buttons-server (released into the Public Domain) -- especially the creator @thomasdavis and contributor @beaugunderson. This software, meddelare-node-server, is based on their work.

When using meddelare-node-server, comply to the MIT license.

FAQs

What is meddelare-server?

Is meddelare-server popular?

Is meddelare-server well maintained?

Package last updated on 05 Jul 2015

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install