Installing the WooCommerce Plugin

To enable the Aurigma Personalization Plugin on your WooCommerce site, you need to install the plugin and associate WooCommerce products with your Customer's Canvas instance. This topic describes how you can perform this.

Installing the Plugin

The current Customer's Canvas distribution does not include the Personalization plugin. Please contact our support team for the actual version of this plugin.

Note

To run the plugin, you need a deployed Customer's Canvas instance - either the cloud or on-premises version will work. You can find step-by-step instructions on how to deploy the on-premises version on your server in the corresponding topic.

  1. In the WooCommerce control panel, click Plugins.
  2. Install and activate the Aurigma Personalization Plugin.

    Installing the WooCommerce plugin.

  3. Click Settings > Personalization Plugin > Editors.

    Uploading the WooCommerce plugin.

  4. Click Upload Editor and upload the Multistep.zip file.
  5. Click the uploaded editor in the list.
  6. Click Upload Config and upload the JSON file.
  7. Click the Settings tab.

    Setting up the WooCommerce plugin.

  8. Copy and paste the URL of your Customer's Canvas instance.
  9. Copy and paste your Customer's Canvas API Key.
  10. Click the Save button.

For details about editor configs, you can refer to the UI Framework Tutorials.

Getting the API Key

To get your API Key and Customer's Canvas URL, log on to your cloud control panel and click the AppSettings.config tab.

In AppSettings.config, your API Key is the value of the ApiSecurityKey parameter.

Getting the API key and URL.

If the following line is commented, uncomment it:

<add key="ApiSecurityKey" value="CustomerSecurityKey" />

Then, you need to replace the value CustomerSecurityKey with your unique key (for example, you can generate a Globally Unique Identifier (GUID)).

To get the URL of your Customer's Canvas instance, replace <yourId> with the ID of your instance in the following link:

https://h2.customerscanvas.com/Users/<yourId>/SimplePolygraphy

Associating Products with Customer's Canvas

  1. In the WooCommerce control panel, click Products and then click Personalize.

    Enabling the product personalization.

  2. Select an editor and config.
  3. Select configuration attributes (templates and mockups).
  4. Click the Apply button.

Most of the plugin configs require you to choose a design and mockup file. The Personalization plugin searches for these files on your Customer's Canvas instance. Just place them in the \ProductTemplates\designs\ and \ProductTemplates\mockups\ folders respectively, and these files will appear in the drop-down lists.

To verify that Customer's Canvas is integrated with your WooCommerce store, you can navigate to a product view and click the Personalize button to open the editor.

If you want to remove the connection between your WooCommerce product and the editor, click Unlink.

Downloading High-Resolution Outputs

To download the resulting PDF files for an order, click WooCommerce > Orders. Then, open the order details and click Download design.

Downloading hi-res PDF outputs.

See Also

Manual