Upgrading

Upgrading from 2.x to 3.x

Due to the migration to the offical Shopify PHP library this update is being treated as a breaking change.

The following .env variables are now required:

SHOPIFY_ADMIN_TOKEN SHOPIFY_AUTH_KEY SHOPIFY_AUTH_PASSWORD SHOPIFY_WEBHOOK_SECRET

If all of these are not defined please follow instructions in setup.

Upgrading from 1.x to 2.x

There are a number of breaking changes in the 2.x update:

Changes to tags

Most tags have been prefixed with shopify (eg {{ shopify:tokens }}) and a number of tags have been removed or changed. Please refer to the tags documentation for the list of tags.

An overview of the changes is as follows:

{{ shopify_tokens }} is now {{ shopify:tokens }}

{{ product_price }} is now {{ shopify:product_price }}

{{ product_variants:generate }} is now {{ shopify:variants:generate }}

{{ product_variants:loop }} is now {{ shopify:variants }}

{{ product_variants:from_title }} no longer exists, use {{ shopify:variants title:is="title_value" }}

{{ product_variants:from_index }} no longer exists, use {{ {shopify:variants}[index] }}

{{ in_stock }} is now {{ shopify:in_stock }}

Changes to urls

Any action URLs, webhook URLs or publish URLs have been changed from statamic-shopify to shopify e.g. the Product Create webhook is now https://YOURSITE/!/shopify/webhook/product/create

Edit this page on GitHub Updated at Mon, Oct 23, 2023