Skip to content

Commit 4209b77

Browse files
committed
Merge branch '6.x' of github.com:craftcms/shopify into 6.x
2 parents 202e0aa + 9d54909 commit 4209b77

17 files changed

+902
-607
lines changed

CHANGELOG.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,42 @@
11
# Release Notes for Shopify
22

3+
## Unreleased
4+
5+
- Fixed a PHP error that could occur when contextual pricing countries aren’t set. ([#191](https://github.com/craftcms/shopify/issues/191))
6+
7+
## 6.1.2 - 2025-12-08
8+
9+
- Fixed a bug where syncing queue jobs could run indefinitely. ([#189](https://github.com/craftcms/shopify/issues/189))
10+
- Fixed a bug where syncing products could fail if the sync file had downloaded incorrectly.
11+
12+
## 6.1.1 - 2025-11-06
13+
14+
- Fixed a bug where file storage could be maxed out when using multiple queue workers.
15+
- Fixed a bug where contextual pricing countries weren’t being force to be capitalized.
16+
17+
## 6.1.0 - 2025-10-24
18+
19+
- Shopify for Craft now supports version `2025-07` of Shopify’s GraphQL Admin API.
20+
- Fixed a PHP error that could occur with missing environment variables. ([#178](https://github.com/craftcms/shopify/issues/178))
21+
22+
## 6.0.5 - 2025-09-09
23+
24+
- Fixed a bug where Shopify data could be overwritten when syncing products. ([#177](https://github.com/craftcms/shopify/issues/177))
25+
26+
## 6.0.4.1 - 2025-08-08
27+
28+
- Fixed a PHP error that could occur when upgrading. ([#176](https://github.com/craftcms/shopify/issues/176))
29+
30+
## 6.0.4 - 2025-08-08
31+
32+
- Fixed a PHP error that occurred when setting the Shopify host name to a non `myshopify` domain. ([#168](https://github.com/craftcms/shopify/issues/168))
33+
- Fixed a PHP error that occurred when creating product drafts. ([#176](https://github.com/craftcms/shopify/issues/176))
34+
35+
## 6.0.3 - 2025-05-27
36+
37+
- Fixed a SQL error that occurred when syncing products on MariaDB. ([#166](https://github.com/craftcms/shopify/issues/166))
38+
- Fixed a SQL error that could occur when upgrading.
39+
340
## 6.0.2 - 2025-05-19
441

542
- Fixed a bug where image sort order wasn’t being respected when syncing products. ([#161](https://github.com/craftcms/shopify/issues/161))

README.md

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ Follow [Shopify’s directions](https://help.shopify.com/en/manual/apps/custom-a
5555
- `read_product_listings`
5656
- `read_inventory`
5757

58-
Additionally (at the bottom of this screen), the **Webhook subscriptions****Event version** should be `2024-10`.
58+
Additionally (at the bottom of this screen), the **Webhook subscriptions****Event version** should be `2025-07`.
5959

6060
3. **Storefront API access scopes**: The following scopes are required for the plugin to function correctly:
6161

@@ -66,17 +66,22 @@ Follow [Shopify’s directions](https://help.shopify.com/en/manual/apps/custom-a
6666

6767
#### Store Hostname
6868

69-
The last piece of info you’ll need on hand is your store’s hostname. This is usually what appears in the browser when using the Shopify admin—it’s also shown in the Settings screen of your store:
69+
The last piece of info you’ll need on hand is your store’s hostname. This is usually what appears in the browser when using the Shopify admin—it’s also shown if you navigate to the `Settings -> Domains` screen of your store:
7070

7171
<img src="./docs/shopify-hostname.png" alt="Screenshot of the settings screen in the Shopify admin, with an arrow pointing to the store’s default hostname in the sidebar.">
7272

73-
Save this value (_without_ the leading `http://` or `https://`) in your `.env` as `SHOPIFY_HOSTNAME`. At this point, you should have the following Shopify-specific values:
73+
Save this value (_without_ the leading `http://` or `https://`) in your `.env` as `SHOPIFY_HOSTNAME`.
74+
75+
> [!NOTE]
76+
> The hostname required is the one ending with `myshopify.com` or `myshopify.io`.
77+
78+
At this point, you should have the following Shopify-specific values:
7479

7580
```env
7681
# ...
7782
7883
SHOPIFY_ADMIN_ACCESS_TOKEN="..."
79-
SHOPIFY_API_VERSION="2024-10"
84+
SHOPIFY_API_VERSION="2025-07"
8085
SHOPIFY_API_KEY="..."
8186
SHOPIFY_API_SECRET_KEY="..."
8287
SHOPIFY_HOSTNAME="my-storefront.myshopify.com"
@@ -91,7 +96,7 @@ Now that you have credentials for your custom app, it’s time to add them to Cr
9196
- **API Version**: `$SHOPIFY_API_VERSION`
9297
- **API Key**: `$SHOPIFY_API_KEY`
9398
- **API Secret Key**: `$SHOPIFY_API_SECRET_KEY`
94-
- **Access Token**: `$SHOPIFY_ACCESS_TOKEN`
99+
- **Access Token**: `SHOPIFY_ADMIN_ACCESS_TOKEN`
95100
- **Host Name**: `$SHOPIFY_HOSTNAME`
96101
3. Click **Save**.
97102

@@ -174,7 +179,7 @@ Going forward, your products are automatically kept in sync via [webhooks](#set-
174179

175180
### Native Attributes
176181

177-
In addition to the standard element attributes like `id`, `title`, and `status`, each Shopify product element contains direct accessors for these canonical Shopify [Product attributes](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Product):
182+
In addition to the standard element attributes like `id`, `title`, and `status`, each Shopify product element contains direct accessors for these canonical Shopify [Product attributes](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Product):
178183

179184
| Attribute | Description | Type |
180185
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| ---------- |
@@ -510,13 +515,13 @@ Products behave just like any other element, in Twig. Once you’ve loaded a pro
510515
### Variants and Pricing
511516

512517
Products don’t have a price, despite what the Shopify UI might imply—instead, every product has at least one
513-
[Variant](https://shopify.dev/api/admin-rest/2024-10/resources/product-variant#resource-object).
518+
[Variant](https://shopify.dev/api/admin-rest/2025-07/resources/product-variant#resource-object).
514519

515520
You can get an array of variant objects for a product by accessing `product.variants` or calling [`product.getVariants()`](#productgetvariants). The product element also provides convenience methods for getting the [default](#productgetdefaultvariant) and [cheapest](#productgetcheapestvariant) variants, but you can filter them however you like with Craft’s [`collect()`](https://craftcms.com/docs/5.x/reference/twig/functions.html#collect) Twig function.
516521

517522
Unlike products, variants in Craft…
518523

519-
- …are represented (mostly) as [the API](https://shopify.dev/api/admin-rest/2024-10/resources/product-variant#resource-object) returns them;
524+
- …are represented (mostly) as [the API](https://shopify.dev/api/admin-rest/2025-07/resources/product-variant#resource-object) returns them;
520525
- …the `metafields` property is accessible in addition to the API’s returned properties;
521526
- …use Shopify’s convention of underscores in property names instead of exposing [camel-cased equivalents](#native-attributes);
522527
- …are plain associative arrays;

composer.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@
2323
"php": "^8.2",
2424
"carnage/php-graphql-client": "^1.14",
2525
"craftcms/cms": "^5.0.0-beta.10||^4.15.0",
26-
"shopify/shopify-api": "^5.2.0"
26+
"shopify/shopify-api": "^5.11.0"
2727
},
2828
"require-dev": {
2929
"craftcms/feed-me": "^6.6.1||^5.9.0",

0 commit comments

Comments
 (0)