gatsby-source-sylius-rest

Community Plugin

Description

gatsby-source-sylius-rest helps you source the data from Sylius e-Commerce framework. It sources all necessary data and creates localized pages for you.

Learning Resources

This source plugin uses API provided by SyliusShopApi bundle.

Documentation

Please check full docs here.

How to install

Using yarn:

yarn add gatsby-source-sylius-rest

or npm:

npm install --save gatsby-source-sylius-rest

Examples of usage

Add plugin configuration to your gatsby-config.js:

module.exports = {
  plugins: [
    // plugins
    {
      resolve: 'gatsby-source-sylius-rest',
      options: {
        locales: ['en', 'de'],
        url: 'https://your-sylius-shop.com/shop-api',
        pages: [
          {
            component: require.resolve('./src/templates/SyliusTaxonPage.tsx'),
            type: 'taxon',
          },
          {
            component: require.resolve('./src/templates/SyliusProductPage.tsx'),
            type: 'product',
            path: {
              de: '/:locale/produkt/:slug',
              en: '/:locale/product/:slug',
            },
          },
        ],
        schemas: {
          product: {
            variantSelectionMethod: 'String!',
          },
        },
      },
    },
  ],
};

Options

Plugin options

Please check SyliusSourcePluginOptionsInterface definition for TypeScript interface.

Name	Required	Type	Description
debug	no	boolean	Provides additional messages during Gatsby build
limits	no	SyliusSourcePluginLimits	Rows limits used for pagination for specific calls to Sylius Shop API.
locales	yes	string[]	List of supported locales. They are required for retrieving data from Sylius API, sourcing GraphQL nodes and link building.
pages	no	SyliusSourcePluginPageDefinition[]	Definitions of pages which should be created using Gatsby Node API (`createPages`). If empty, `gatsby-source-sylius-rest` will not create pages.
schemas	no	SyliusSourcePluginSchemas	Definitions of additional or overriden fields in schemas that will be sourced.
url	yes	string	URL to the Sylius shop API.

How to run tests

Write yarn run test in terminal or use launch configurations in your Visual Studio Code.

TODO

Source products attributes.
Source product variant images.
Source latest products.