spree-frontend-integration v1.0.3

Spree Frontend Integration

spree-frontend-integration is a JavaScript library which allows easy access to Spree API. It can be integrated with any frontend framework, or can also be used with simple JS.

Dependency

You need to install Spree AMS gem.

To access all endpoints add below line of code in your routes.rb.

namespace :api do
  match '*path' => 'ams/cors#preflight_check', via: [:options]
end

Installation

Node:

npm install --save spree-themes-integration

Bower:

bower install spree-themes-integration

You may need to use browserify to properly install the package in case of bower. You can take the help of the following tutorial

Configurations

Spree Frontend Integration Provides a number of configurations which allow you to customize the integration according to your needs.

List of JS methods

SpreeApi.login

Use this method to login into Spree Backend. This methods needs to essential parameters email & password to successfully login. It actually saves token returned by Spree API to the cookie in encrypted form.

(new SpreeApi.login()).sendRequest({params: {
  users: {
    email: 'spree@vinsol.com',
    password: 'spree123'
  }
}})

SpreeApi.signUp

Use this method to signUp into Spree Backend. This methods needs to essential parameters email & password to successfully create a new user.

(new SpreeApi.signUp()).sendRequest({params: {
  users: {
    email: 'spree@vinsol.com',
    password: 'spree123'
  }
}})

SpreeApi.profile*

Use this method to get user details from Spree Backend.

(new SpreeApi.profile()).sendRequest({})

SpreeApi.productsList

Use this method to get a list of products from Spree Backend.

(new SpreeApi.productsList()).sendRequest({params:{ per_page: 25, page: 1}})

SpreeApi.productShow

Use this method to get details of a specific product from Spree Backend.

(new SpreeApi.productShow()).sendRequest({params:{ id: 1 }})
Note: here id is product id/slug.

SpreeApi.taxonsList

Use this method to get the taxon list from Spree Backend.

(new SpreeApi.taxonsList()).sendRequest({})

SpreeApi.taxonomyList

Use this method to get the taxonomy & taxons list from Spree Backend.

(new SpreeApi.taxonomyList()).sendRequest({})

SpreeApi.countryLists

Use this method to get a list of countries from Spree Backend.

(new SpreeApi.countryLists()).sendRequest({})

SpreeApi.statesList

Use this method to get a list of states for a specific country from Spree Backend.

(new SpreeApi.statesList()).sendRequest({params: { id: 1 }})
Note: here id is country_id

SpreeApi.optionTypesList

Use this method to get a list of option types from Spree Backend.

(new SpreeApi.optionTypesList()).sendRequest({})

SpreeApi.createOrder*

This method is to create a new order at Spree Backend and returns order response.

(new SpreeApi.createOrder()).sendRequest({})

SpreeApi.updateOrder*

This method is to update(Add a line item) a prevously created order at Spree Backend and returns order response.

(new SpreeApi.updateOrder()).sendRequest({})

SpreeApi.checkoutOrder*

This method should be used for checkout steps, with valid & complete information the order will be automatically proceeded to the next step. It returns the order response.

(new SpreeApi.checkoutOrder()).sendRequest({params: {
  id: 1,
  bill_address_attributes: {...},
  ship_address_attributes: {...},
  payments_attributes: {...},
  shipments_attributes: {...}
}})

SpreeApi.myOrders*

This method returns all completed orders of the loggedIn user.

(new SpreeApi.myOrders()).sendRequest({})

SpreeApi.currentOrder*

This method returns the current order in progress of the loggedIn user.

(new SpreeApi.currentOrder()).sendRequest({})

SpreeApi.emptyOrder*

This method removes all the line items from the current order.

(new SpreeApi.emptyOrder()).sendRequest({params: {id: 1}})

SpreeApi.deleteOrder*

This method deletes the current order.

(new SpreeApi.deleteOrder()).sendRequest({params: {id: 1}})

*= Login Required