Download or install the Zig toolchain.
Installing from a package manager is likely your easiest path.
The following command will create an order discount Function at extensions/order-discount-zig
, using our generic Wasm boilerplate.
npm run generate extension -- --type order_discounts --template wasm --name order-discount-zig
cd extensions/order-discount-zig
zig init-exe
build.zig
, update the const target
to default to WASI:const target = .{ .cpu_arch = .wasm32, .os_tag = .wasi };
Replace the contents of extensions/order-discount-zig/input.graphql
with the following from GitHub:
You need to inform Shopify about the UI paths for configuring your function. These paths are already provided by the app template you used.
In shopify.function.extension.toml
, replace the [ui.paths]
section with the following:
[ui.paths]
create = "/discount/:functionId/new"
details = "/discount/:functionId/:id"
You also need to inform Shopify about where to find GraphQL variable values that will be used when executing your input query.
Add the following to shopify.function.extension.toml
:
[input.variables]
namespace = "$app:polyglot-functions"
key = "function-configuration"
You also need to inform the Shopify CLI about how to build your Zig wasm module, and where to expect the build output.
In shopify.function.extension.toml
, replace the [build]
section with the following:
[build]
command = "zig build -Drelease-fast=true"
path = "zig-out/bin/order-discount-zig.wasm"
Update src/main.zig
and implement the following function logic, outputting appropriate JSON for an order discount function result.
IF customer has VIP metafield with a value of 'true'
AND products in their cart with tag X have a total of more than $Y
THEN discount the order by Z%
Hint: You can find a completed example on GitHub:
shopify.function.extension.toml
:npm run function:build
FunctionResult
GraphQL type:npm run function:validate
npm run function:preview
Note: Even with a successful output, Zig outputs an error message which I've been unable to resolve. It does not seem to affect execution:
error while executing at wasm backtrace:
0: 0x202 - <unknown>!<wasm function 3>
Use the following steps, selecting the order-discount-zig
discount type, and using ZIG
as your discount code.
cd ../..
npm run deploy
npm run dev
executing in a terminal window.The workshop app includes a test script which will execute all the function wasm modules you have created so far, and print a comparison of their instruction count and binary size.
cd ../..
npm run function:test-all
All our base are belong to YOU!!! Onto another language?