saleor-apps-redis_apl/apps/cms
2023-03-24 13:36:59 +01:00
..
docs CMS providers update (#309) 2023-03-20 12:21:19 +01:00
graphql Product data updates in CMS variant objects (#324) 2023-03-24 13:36:59 +01:00
src Product data updates in CMS variant objects (#324) 2023-03-24 13:36:59 +01:00
.env.example Add CMS hub app (#262) 2023-03-16 11:17:00 +01:00
.eslintrc Add CMS hub app (#262) 2023-03-16 11:17:00 +01:00
.graphqlrc.yml Add CMS hub app (#262) 2023-03-16 11:17:00 +01:00
CHANGELOG.md [vercel deploy] 2023-03-20 12:36:28 +01:00
CONTRIBUTING.md CMS providers update (#309) 2023-03-20 12:21:19 +01:00
next-env.d.ts Add CMS hub app (#262) 2023-03-16 11:17:00 +01:00
next.config.js CMS: Add Sentry setup (#311) 2023-03-20 10:25:36 +01:00
package.json [vercel deploy] 2023-03-20 12:36:28 +01:00
README.md Update README.md (#318) 2023-03-20 18:23:57 +01:00
saleor-app.ts Add CMS hub app (#262) 2023-03-16 11:17:00 +01:00
sentry.client.config.js CMS: Add Sentry setup (#311) 2023-03-20 10:25:36 +01:00
sentry.edge.config.js CMS: Add Sentry setup (#311) 2023-03-20 10:25:36 +01:00
sentry.server.config.js CMS: Add Sentry setup (#311) 2023-03-20 10:25:36 +01:00
tsconfig.json Add CMS hub app (#262) 2023-03-16 11:17:00 +01:00
vitest.config.ts CMS setup tests fix (#294) 2023-03-16 12:13:16 +01:00

CMS

CMS

Overview

What is it?

CMS Hub is a Saleor app that exports products from Saleor to several popular CMSes.

Here is a list of currently supported CMSes and their configuration guides:

How does it work?

  1. cms listens to Saleor product variant events through webhooks.
  2. When an event is triggered, we extract the product data and pass it to the CMS Client.
  3. CMS Client checks what CMS you picked, transforms the data to the format the CMS expects, and sends it over.

Mapping fields

Currently, the CMS Hub does not support mapping Saleor fields to your CMS fields. Your product model should have the following fields:

  • strings fields: saleor_id, name, product_id, product_name, product_slug,
  • JSON fileds: channels.

Known issues

CMS Hub updates product variants in CMS providers on create, update or delete product variant webook events. They are triggered on product variant channel listing added or updated, but they currently don't trigger on deleting channel listing due to the core issue #12247. To make it working on deleting channel listing, you can additionally modify other product variant field e.g. name, so webhook handlers receive the updated channel listings as well.

How to use it?

  1. Install the application in your Dashboard and open it.
  2. Go to Providers.
  3. Add CMS provider instance with proper configuration.
  4. Go to Channels.
  5. Turn on provider instances for desired channels.
  6. Go to Products in Dashboard.
  7. Add, edit or remove product variant to see it is added, updated or removed in configured CMS provider accordingly.

How can I contribute?

See CONTRIBUTING.md.