Napoleonic Political Magnificence
    Have ideas to improve npm?Join in the discussion! »

    npm-woocommerce-api

    1.0.7 • Public • Published

    npm-woocommerce-api

    Connects NodeJS to the WooCommerce API even though permalink doesnt in active state.

    Speciality of this module

    In this npm module we added an option "permalink". It will help you to mention and inform to the wordpress api to provide restfull api with endpoints or non restfull api with endpoints based on "permalink" option. If you set "permalink" as "plain" (that is inactive) in your wordpress website, existing npm modules for woocommerce api wont work. But, npm-woocommerce-api will work perfectly even though you set "permalink" as "plain" in your wordpress website.

    Installation

    To install the module using NPM:

    npm install npm-woocommerce-api --save
    

    Setup

    You will need a consumer key and consumer secret to call your store's WooCommerce API. You can find instructions here

    Include the 'npm-woocommerce-api' module within your script and instantiate it with a config:

    var NPMWooCommerceAPI = require('npm-woocommerce-api');
     
    var NPMWooCommerceAPI = new NPMWooCommerceAPI({
      url: 'https://yourstore.com',
      ssl: true,
      consumerKey: 'ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
      secret: 'cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
    });

    Instantiating a NPMWooCommerceAPI instance without a url, consumerKey or secret will result in an error being thrown

    Options

    When instantiating the NPMWooCommerceAPI object you have a choice of the following configuration options:

    option type required description
    url string yes The url of your store including the protocol: http://yourstore.com, https://yoursecurestore.com
    consumerKey string yes The consumer key generated in the store admin
    secret string yes The consumer secret generated in the store admin
    ssl boolean no (default: based on protocol, https = true, http = false) this is automatically set by default, but can be forced by setting the ssl option
    logLevel number no (default: 0) 0 shows errors only, 1 shows info and errors for debugging
    apiPath string no (default: '/wc-api/v2') The path to your API, it should contain a leading slash and no trailing slash
    permalink number no (default: 1) 1: active, 0: inactive (default: 1). If your store is having permalink as "Plain", you should use this option with the value as 0. Then only, you can get valid response which consists the required data. Because, based on wordpress permalink active state, rest api will work. If wordpress permalink set as "Plain", rest api wont work and woocommerce api will give an error message.

    For your reference, kindly see the following screenshot.

    This screenshot depicts about "permalink" inactive state.

    Wordpress permalink inactive state

    Calling the API

    Your WooCommerce API can be called once the NPMWooCommerceAPI object has been instantiated (see above).

    GET

    NPMWooCommerceAPI.get('/products', function(err, data, res){
      // err will return any errors that occur
      // data will contain the body content from the request
      // res is the full response object, use this to get headers etc
    });

    POST

    For this example you have a coupon object.

    NPMWooCommerceAPI.post('/coupons', couponObject, function(err, data, res){
      // err will return any errors that occur
      // data will contain the body content from the request
      // res is the full response object, use this to get headers etc
    });

    PUT

    var couponUpdate = {
      amount: 5
    };
     
    NPMWooCommerceAPI.put('/coupons/1234', couponUpdate, function(err, data, res){
      // err will return any errors that occur
      // data will contain the body content from the request
      // res is the full response object, use this to get headers etc
    });

    DELETE

    NPMWooCommerceAPI.delete('/coupons/1234', function(err, data, res){
      // err will return any errors that occur
      // data will contain the body content from the request
      // res is the full response object, use this to get headers etc
    });

    Testing

    npm test
    

    License

    GPL 3.0

    Install

    npm i npm-woocommerce-api

    DownloadsWeekly Downloads

    2

    Version

    1.0.7

    License

    GPL-3.0

    Last publish

    Collaborators

    • avatar