Customer's Canvas is available in two versions: hosted and on-premises. This topic describes the hosted version and helps you start working with it. If you are not sure which version is the best for your needs, this write-up can help you decide whether you need hosted or on-premises version.
The main difference between the versions is that all instances of the hosted version are located on our servers, whereas on-premises instances are hosted by you. Each hosted instance is a copy of Customer's Canvas dedicated to handle one site's requests. There are pros and cons with the hosted version:
Trial access to the hosted version can be requested from Request Hosted Trial page.
When you purchase or evaluate the hosted version of Customer's Canvas, you get:
To administrate your Customer's Canvas instance follow the http://h.customerscanvas.com/ link and enter your login and password.
You can add your own images, fonts, product templates, etc. to your instance of Customer's Canvas. All the files you upload need to be placed in the correct folders in the Customer's Canvas file system in order for them to be used. Let us look at an overview of the Customer's Canvas file system:
\Configuration\folder contains the editor configuration file, localization files, and CSS custom styles.
\Fonts\folder contains custom fonts, that can be used in your products.
\ProductTemplates\designs\folder contains product templates. Templates can be organized in subfolders.
\ProductTemplates\mockups\folder contains mockups. Mockups help to visualize a product, but they are not rendered to hi resolution images.
\PublicGalleryFolder\folder contains public images, that can be utilized by users while customizing products. You can create subfolders to categorize images.
\UserDataFolder\someUserId\; this folder is created for each user who interact with Customer's Canvas.
someUserIdis the identifier you specify using the Customer's Canvas API via the userId argument. If the argument is not specified, then the
defaultuser identifier is utilized.
\UserDataFolder\someUserId\states\folder contains products created by someUserId user.
\UserDataFolder\someUserId\images\folder contains images uploaded by someUserId user.
For more information about fonts, templates, mockups, and public images see the Configuring Products section.
You can manage files and folders of your Customer's Canvas instance using the web file manager described below.
The file manager includes folder tree navigation on the left and file view on the right just like the standard Windows File Explorer.
Using the file manager you can: upload and download files, delete, move, and rename files, and open mockups and templates in the web-to-print editor.
Mainly, you need access to the file system of your Customer's Canvas instance to upload product templates. The file manager allows you to upload several files at once. All uploaded files will be placed to folder being viewed at that time. There are two ways to upload files:
You can also download, delete, copy, and move files using the file manager. To perform any of these actions:
If you want to rename file:
There are two ways to open a file in the editor:
There are two tabs in your Customer's Canvas account, that allow you to edit configuration files:
~\Configuration\clientConfig.json configuration files contain general settings applied to all products. After you have edited a configuration file, click the Save button in the bottom right corner. The Reset button resets all unsaved changes. It does not restore a configuration file to its default state.
Configuration parameters are discussed in the other topics of this documentation.
All topics in this documentation discussing such subjects as configuring the product, Customer's Canvas integration, etc. are applied to both the hosted and on-premises versions.
You can manage custom fonts simply by uploading or deleting them in the
~\Fonts\ folder using the file manager. After you have changed local fonts, you should click the Reload local fonts button to apply changes to the web-to-print editor. The button is located in the Actions tab:
By default Customer's Canvas includes localization files for English (
en) and Russian (
ru) languages. You can set one of these languages as the default interface language by setting the defaultLanguage parameter in
~\Configuration\clientConfig.json. This file is avaialble for editing in the related tab:
For example, for English interface set:
To create your own translation, you should edit the
~\Configuration\translations.json file. This file is avaialble for editing in the related tab:
For more information see the Localization of Customer's Canvas topic.
Customer's Canvas user interface is the web-to-print editor. To build the editor into your design page you use the API URL, which includes the URL to your Customer's Canvas instance. The instance URL can be found in your account.
The API URL appears as follows:
xxxxxxxx-yyyy-xxxx-yyyy-xxxxxxxxxxxx is the instance URL. The following code snippet displays the editor with the
businesscard2_side1.psd business card template loaded into it:
Just copy this code, paste it to an html file, and replace
xxxxxxxx-yyyy-xxxx-yyyy-xxxxxxxxxxxx with the identifier of your Customer's Canvas instance. Open the saved file in a browser; you should see the editor. By clicking on the Download button, you can get the high resolution output of your newly-created product. A real use case of the integration of Customer's Canvas into a web site is discussed in the Integration with E-commerce Overview topic.