Dato Seeder
A Node JS library that lets you import Commerce Layer seed data into DatoCMS.
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 seeder is the easiest way to bulk import a set of products, based on a specific content model — both brought to you by Commerce Layer — into your DatoCMS project.
Before running the seeder, make sure you've set up the content model in question into DatoCMS (you can use our dedicated content model importer).
This seeder is built for Node.js and doesn't run in the browser.
Getting Started
To be ready to use the Dato Seeder, you need to install it and then get the credentials that will allow you to manage your DatoCMS project.
Installation
Dato Seeder is available as an npm package:
// npm
npm install @commercelayer/dato-seeder
// yarn
yarn add @commercelayer/dato-seeder
Import
You can use the ES6 default import as follows:
import seeder from '@commercelayer/dato-seeder'
Usage
The seeder function
The seeder
function returns a promise an
-
apiToken: string
— your DatoCMS full-access API token (required) -
locale: string
— your DatoCMS locale (optional / default:en
) -
maxVariants: number
— the maximum number of variants that will be imported (optional / default:15
), set this parameter to-1
if you want to import all the variants from the seed -
sizes: { load?: boolean, externalUrl?: string }
— predefined set of sizes (optional / default:{ load: true }
) -
variants: { load?: boolean, externalUrl?: string }
— predefined set of variants (optional / default:{ load: true }
) -
taxons: { load?: boolean, externalUrl?: string }
— predefined set of taxons (optional / default:{ load: true }
) -
taxonomies: { load?: boolean, externalUrl?: string }
— predefined set of taxonomies (optional / default:{ load: true }
) -
catalogs: { load?: boolean, externalUrl?: string }
— predefined set of catalogs (optional / default:{ load: true }
) -
countries: { load?: boolean, externalUrl?: string }
— predefined set of countries (optional / default:{ load: true }
)
// default import — 15 variants, no taxonomies, en locale
seeder({ apiToken: 'your-full-access-token' }).then((result) => {
console.log(result)
})
// custom import — 10 variants, with external countries, it locale
seeder({
apiToken: 'your-full-access-token',
locale: 'it',
maxVariants: 10, // -1 for all variants
countries: {
externalUrl: 'your-external-url'
}
}).then((result) => {
console.log(result)
})
The returned object
The promise returned by the seeder
function is an object containing all the items imported, by content type:
{
sizes: [
{ id: '1st-size-id', name: 'First Size Name' },
{ id: '2nd-size-id', name: 'Second Size Name' },
...
],
variants: [
{
id: '1st-variant-id',
name: 'First Variant Name',
image: [Object],
reference: '1STVARIANTREF'
},
{
id: '2nd-variant-id',
name: 'Second Variant Name',
image: [Object],
reference: '2NDVARIANTREF'
},
...
],
products: [
{
id: '1st-product-id',
name: 'First Product Name',
reference: '1STPRODUCTREF'
},
{
id: '2nd-product-id',
name: 'Second Product Name',
reference: '2NDPRODUCTREF'
},
...
],
taxonomies: [
{ id: '1st-taxonomy-id', name: 'First Taxonomy Name' },
{ id: '2nd-taxonomy-id', name: 'Second Taxonomy Name' },
...
]
}
License
This repository is published under the MIT license.