buttercms

ButterCMS node.js client

Documentation

For a comprehensive list of examples, check out the API documentation.

Installation

Requires node.js version 4 or greater.

npm install buttercms

Overview

Every resource is accessed via your butter instance:

var butter = require('buttercms')(' your butter API token ');

Every resource method returns a promise:

butter.post.list({page: 1, page_size: 10})
  .then(function(response) {
    console.log(response)
  }).catch(function(response) {
    console.log(response)
  });


butter.post.retrieve("hello-world")
  .then(function(response) {
    console.log(response)
  }).catch(function(response) {
    console.log(response)
  });

// Try our new custom content feature
butter.content.retrieve(["homepage_html_title", "homepage_meta_description"])
  .then(function(response) {
    console.log(response)
  }).catch(function(response) {
    console.log(response)
  });

See our node app for a full example.

Available resources & methods

Where you see params it is a plain js object, e.g. {page: 1}

• post
  • retrieve(slug[, params])
  • list([params])
  • search(query[, params])
• category
  • retrieve(slug[, params])
  • list([params])
• tag
  • retrieve(slug[, params])
  • list([params])
• author
  • retrieve(slug[, params])
  • list([params])
• feed
  • retrieve(type[, params])
• content
  • retrieve(keys)

Test mode

Test mode can be used to setup a staging website for previewing content or for testing content during local development. To fetch content from test mode add an additional argument, true, to the package initialization:

var butter = require('buttercms')('your butter API token', true);

Or use an environment variable:

var butter = require('buttercms')('your butter API token', process.env.BUTTER_TEST_MODE);

Documentation

Documentation is available at https://buttercms.com/docs/api/node