Client Library for the Blogvio API
This is a JavaScript client library for the Blogvio API, written in CoffeeScript, suitable for use in most browsers.
##Installation The source is available for download from GitHub. Alternatively, you can install using Node Package Manager (npm) or using Bower Package Manager (bower).
This library will be available at http://blogvio.com/sdk/sdk.js
so add the following script
tag in the head
section of your page:
<script type="text/javascript" src="http://blogvio.com/sdk/sdk.js"></script>
If you don't have node
or npm
installed go to http://nodejs.org/ and install it.
After the installation run the following command in your project's directory:
npm install blogviojs
The package will be available in node_modules/blogviojs.
####Bower
If you don't have bower
installed follow the guide at http://bower.io/ to install it then run the following command in your project's directory:
bower install blogviojs
The package will be available in your defined bower folder.
##Usage After installing the library in your page you can use the Blogvio SDK.
The library exposes a global Blogvio
variable that you can use to interact with the SDK's functions.
The first step is to initialize the SDK with your Blogvio app_id and redirect_url:
Blogvio.init('<app_id here>','<redirect_url here>');
After this step you can login using the Blogvio.auth()
function.
You can pass a Boolean
parameter that indicates if a popup should be opened or you just want to check if user is logged in. Default will open popup.
This has promise support built-in using the aye library.
//Check if user is logged in
Blogio.auth(false).then(function(){/*handle success*/},function(){/*handle fail*/});
//Open popup to login user
Blogio.auth().then(function(){/*handle success*/},function(){/*handle fail*/});
After user is logged in you call the Blogvio API using Blogvio.api(url,method,data)
.
This function returns a promise.
For example if you want to grab user info:
//Grab user info
Blogio.api('users/me').then(function(data){/*handle success*/},function(error){/*handle fail*/});