@commercelayer/dato-algolia-adapter

A Node JS library that lets you export your ecommerce catalog from DatoCMS and makes it ready to be imported into Algolia.

Usage no npm install needed!

<script type="module">
  import commercelayerDatoAlgoliaAdapter from 'https://cdn.skypack.dev/@commercelayer/dato-algolia-adapter';
</script>

README

Dato Algolia Adapter

A Node JS library that lets you export your ecommerce catalog from DatoCMS and makes it ready to be imported into Algolia.

What is Commerce Layer?

Commerce Layer is a headless platform that lets you easily build enterprise-grade ecommerce into any website, by using the language, CMS, and tools you already master and love.

Table of contents

How it works

This adapter assumes that you've already imported a set of products, based on a specific content model — both brought to you by Commerce Layer — into your DatoCMS project. Please find below the correct workflow, with all the preliminary steps included:

  1. import the content model into DatoCMS using our dedicated content model importer
  2. populate the content model with some data (feel free to use our Dato Seeder)
  3. add at least one catalog and one country to the content model in DatoCMS
  4. run this adapter
  5. import your catalog into Algolia by using our importer.

This adapter is built for Node.js and doesn't run in the browser.

Getting Started

To be ready to use the Dato Algolia Adapter, you need to install it and then get the credentials that will allow you to manage your space in Contentful.

Installation

Dato Algolia Adapter is available as an npm package:

// npm
npm install @commercelayer/dato-algolia-adapter

// yarn
yarn add @commercelayer/dato-algolia-adapter

Import

You can use the ES6 default import as follows:

import adapter from '@commercelayer/dato-algolia-adapter'

Usage

The adapter function

The adapter function returns a promise and you need to pass to it as a parameter a string containing your DatoCMS full-access API token:

adapter('your-full-access-token').then((result) => {
  console.log(result)
})

The returned array

The promise returned by the adapter function is an array of objects, ready to be set as the items parameter of our Algolia importer.

License

This repository is published under the MIT license.