Configuring Alokai
Before configuring your Alokai app, it's necessary to configure BigCommerce first. If you haven't done this yet, see the Configuring BigCommerce guide.
Set up environment variables
Alokai application is using following environment variables to create a connection with BigCommerce API:
| Environment variable | Description |
|---|---|
| BIGCOMMERCE_API_CLIENT_ID | Client ID obtained during creating an API account |
| BIGCOMMERCE_API_CLIENT_SECRET | Client secret obtained during creating an API account |
| BIGCOMMERCE_API_URL | API path obtained during creating an API account |
| BIGCOMMERCE_API_ACCESS_TOKEN | Access token obtained during creating an API account |
| BIGCOMMERCE_STORE_ID | store_hash included in API path between /stores/ and /v3/ |
| BIGCOMMERCE_STORE_GUEST_TOKEN | Preview code from Review & test your store block |
| DEFAULT_CHANNEL_ID | channel_id of the default storefront |
| API_BASE_URL | Url to the API |
| GRAPHQL_MAX_RETRY | Number of allowed retries for graphql requests |
Cookies (optional)
Some cookies are set by the middleware server and are out of the theme scope, therefore we introduce the possibility to customize its options. To override the default cookie options you must use the cookie name as a key and CookieOptions as a configuration object. The list of cookies set by the server:
customer-data - token cookie
// middleware.config.js
module.exports = {
integrations: {
bigcommerce: {
configuration: {
cookie_options: { // optional cookie options field
'customer-data': { // cookie name
httpOnly: true,
secure: true,
sameSite: 'lax'
}
},
}
}
}
};