Sylius

Sylius is an Open Source Headless eCommerce Platform for mid-market and enterprise brands that need custom solutions. It's written in PHP with the Symfony framework and you can check their Github repository for more information.

We integrated a small eCommerce integration, that allows you to select products and categories (taxons) from the Sylius API directly in Storyblok. We will use the shop endpoints to retrieve products and categories for our integration. To allow the integration to read products, we will need a token from the /api/v2/shop/authentication-token endpoint. You can use the following request to retrieve the token by passing your API endpoint and the email and password.

curl -X 'POST' \
  'https://master.demo.sylius.com/api/v2/shop/authentication-token' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "shop@example.com",
  "password": "sylius"
}'

For more details on the API endpoints, you can check the Sylius API demo.

Shopify Apps

You can also follow this Sylius authentication tutorial to retrieve a JWT token. Be aware that this token will expire within a certain time, so you will need to renew it to retrieve the content. Once you have all your credentials, you can jump to configuring your plugin within your Storyblok space. You will need to following two required options:

option value
endpoint https://master.demo.sylius.com
token JWT token generated from ​/api​/v2​/shop​/authentication-token endpoint
language (optional) language key to display the name and description in a specific language, e.g. en_US
selectOnly (optional) category or product