bkwld/craft-importable-shopify-feeds

A Craft plugin that maps Shopify data into feeds that are more easily consumed by FeedMe.

1.9.0 2024-04-08 18:59 UTC

This package is auto-updated.

Last update: 2024-10-08 19:56:11 UTC


README

A Craft plugin that maps Shopify data into feeds that are more easily consumed by FeedMe.

Setup

This expects that your Craft .env file has:

SHOPIFY_URL=https://your-store.myshopify.com
SHOPIFY_ADMIN_API_ACCESS_TOKEN=xxxxxxxxxxx

In addition, you'll need to give your Custom App the following permissions:

  • Product listings
    • read_product_listings
  • Products
    • read_products

Usage

Set up FeedMe to query either of the following routes. We're only exposing a minimum set of data that can be used to create matching Craft products. It's assumed that Shopify is the source of truth for all other fields and their data shouldn't be cached in Craft.

Products

https://cms-domain.com/actions/importable-shopify-feeds/feeds/products

[
  {
    "title": "Product Title",
    "handle": "product-title"
  },
]

Variants

https://cms-domain.com/actions/importable-shopify-feeds/feeds/variants

[
  {
    "title": "Variant Title",
    "sku": "413071",
    "product":{
      "title": "Product Title",
      "handle": "product-title"
    },
    "dashboardTitle": "Product Title - Variant Title (413071)"
  },
]

Collections

https://cms-domain.com/actions/importable-shopify-feeds/feeds/collections

[
	{
		"title": "Collection Title",
		"handle": "collection-title"
	},
]

Multiple Shopify stores

If you have multiple Shopify stores but one Craft instance (like if you are using Craft's multi-site feature to manage multiple Shopify stores), you can should can specify the Shopify ENV credentials using an arbitrary namespace suffix. Like:

SHOPIFY_URL=https://your-store.myshopify.com
SHOPIFY_ADMIN_API_ACCESS_TOKEN=xxxxxxxxxxx
SHOPIFY_URL_CANADA=https://your-canadian-store.myshopify.com
SHOPIFY_ADMIN_API_ACCESS_TOKEN_CANADA=xxxxxxxxxxx

Then, you can use that namesapce in all of the feed URLs like so:

https://cms-domain.com/actions/importable-shopify-feeds/feeds/products?store=CANADA