Zakeke

To connect your Zakeke account to ShopWired:

1. Navigate to Apps > Manage > Zakeke
2. Copy the Store URL and Products API URL values displayed in the app
3. In a new tab in your browser, log into your Zakeke account
   • If you don’t have an account with Zakeke, create one here.
4. In Zakeke, navigate to the Connections page
5. Select API
6. Enter the Store URL and Products API URL from step (2) above
7. Ensure the Base currency is the same currency as the one your ShopWired account uses
8. In Zakeke, navigate to Your account > API keys
9. Copy the provided Client ID and Secret key
10. In the browser tab for the ShopWired Zakeke app, copy the keys into the Client ID and Secret key settings
11. Select connect

Once connected, a confirmation message will be displayed.

If you are using the offline payment method and you want to export orders to Zakeke that are created using the offline payment method, select this setting. If the setting is not selected, these orders will display in the Export errors section of the app.

Use the Customise button text setting to customise the text displayed for the button that appears for Zakeke product pages on your website. This is the button that is used by website visitors to launch the Zakeke window.

To allow your customers to customise or configure products on your ShopWired website, you will need to create these products separately within your Zakeke account. Depending on your needs, you can use either the customiser or configurator tools in Zakeke to set up these products.

When you connect your ShopWired and Zakeke accounts, your ShopWired products will be imported into your Zakeke account for configuration. Any new products that you create in your ShopWired account after the connection is established will also appear in your Zakeke account.

The customiser tool in Zakeke allows you to create 2D customisable products for your ShopWired store. To get started:

1. Log in to your Zakeke account
2. Navigate to customizable products > add
3. From the list of products from your ShopWired account, select the product you want to customise
4. Follow the instructions in Zakeke to customise the product according to your preferences

Once you have customised your product, it will be listed in the 2D customisable products section of the Zakeke app within ShopWired.

The configurator tool in Zakeke is used to create 3D configurable products. These products allow customers to adjust or modify specific aspects of a product, such as selecting different components or materials. To configure a product:

1. Log in to your Zakeke account
2. Navigate to products in the side menu
3. Select + add new product in the top right corner
4. From the list of products in your ShopWired account, select the product you want to configure
5. Follow the guides in Zakeke to configure the product as needed

For both 2D customisable and 3D configurable products, you can use the view option in the Zakeke app (in either the 2D customisable products or 3D configurable products sections) to see how the product appears on your ShopWired website. This allows you to check that the customisation or configuration options are displayed correctly to website visitors.

For each product in Zakeke that is available to be displayed on your ShopWired website, you can choose:

• Whether to enable the Zakeke customiser on the product on your website
• Whether to enable visitors to add the product to the basket without customising it

To enable the Zakeke customiser for the product, locate the product in either the 2D customisable products or 3D customisable products section and select enable customisation. Enabling this setting for the product ensures that the customise button appears on the product page on the website. If this setting is disabled, the product's normal add to basket button will be displayed.

To enable visitors to add the product to the basket without customising it, locate the product in either the 2D customisable products or 3D customisable products section and select show the add to basket button. Enabling this setting for the product allows visitors to add the product to the basket without customising it.

Orders received on your ShopWired website containing a Zakeke customisable/configurable product will be exported to Zakeke automatically. Orders are usually exported to Zakeke within a few minutes.

Occasionally, the app may encounter an error when trying to export an order to Zakeke. Errors that fail to export will be displayed in the Export errors section.

When this happens, the details of the failed order will appear in the export errors section:

1. Review the error in the Export errors section
2. Fix the issue (e.g., update the order or product details)
3. Retry the export by selecting retry auto-export

Code for this app needs to be added to your ShopWired theme:

• To display the Zakeke customiser on product pages
• To support products with variations
• To display information about the customised/configured product in the visitor's shopping basket
• To display information about the customised/configured product during checkout

Using the code editor, within the product_form.twig file, add the Javascript code below before the closing {% endblock %} in the {% block product_form %} block.

Using the code editor, within the product_form.twig file:

Locate the <select element that contains the class product-option required and add the code below before the closing > tag

data-option-id="{{ option.id }}"

Locate the <div element that contains the class product-option and add the code below before the closing > tag

data-option-id="{{ option.id }}"

Using the code editor, within the checkout_basket.twig file, locate the <td element that contains the class basket-item-image and, directly after this line, add the code below

You will also need to add the code below to the Advanced customisation section in the Custom Javascript setting of the checkout page.