Meet us in Chicago on September 10-14, 2017
  1. Aurigma Customer's Canvas 4.1.3
  2. Configuration Files

Web.config

This topic describes the Customer's Canvas configuration settings that you specify in the web.config configuration file. You can find this file in the Customer's Canvas root folder.

In web.config, there are three sections where you can set up the application parameters:

appSettings

The following snippet shows all available parameters of Customer's Canvas, which you can set up in the appSettings section, with their default values.

XML 
<configuration>
    ...
    <appSettings>
        <add key="AllCategoryName" value="all" />
        <add key="RootCategoryName" value="root" />
        <add key="PublicGalleryFolder" value="~/PublicGalleryFolder" />
        <add key="MasterUserId" value="masteruser" />
        <add key="DefaultUserId" value="default" />
        <add key="UserDataFolder" value="~/UserDataFolder" />
        <add key="AnonymousModeEnabled" value="False" />
        <add key="DemoModeEnabled" value="False" />
        <add key="FontSubstitutionEnabled" value="True" />
        <add key="SubstitutionFontPostScriptName" value="ArialMT" />
        <add key="DefaultFontPostScriptName" value="ArialMT" />
        <add key="ParagraphTextEnabled" value="False" />
        <add key="StateFileStorageEnabled" value="False" />
        <add key="ApiSecurityKey" value="" />
        <add key="HttpHeaderAllowOriginDomains" value="*" />
        <add key="ProofImageDownloadEnabled" value="False" />
        <add key="DefaultPlaceholderCoverModeEnabled" value="False" />
    </appSettings>
</configuration>
Note

All parameters defining paths are either relative or absolute. Relative paths to folders are specified from your site root and start with ~/ (for example, ~/UserDataFolder). Absolute paths are complete ones; they start either with a drive letter (for example, C:\) or \\ for network locations. When you use absolute paths to external folders, make sure that the user account, under which Customer's Canvas runs in ASP.NET/IIS, has the read/write access to the remote folders.

Name Description Possible values
Gallery
AllCategoryName The alias for the category containing images from the public images folder and all its subfolders. The default value is all. string
RootCategoryName The alias for the category containing images from the public images folder. The default value is root. string
PublicGalleryFolder The folder path where public images are stored. The default value is ~/PublicGalleryFolder. folder path
Users
MasterUserId The identifier of the master user. Templates and images that belong to the master user can be used by any user. The default value is masteruser. string
DefaultUserId The identifier of the default user. The default value is default. string
UserDataFolder The folder path where the user data is stored. The default value is ~/UserDataFolder. folder path
AnonymousModeEnabled Enables the anonymous site mode. The default value is False. True, False
DemoModeEnabled Enables the demonstration mode. The default value is False. True, False
Font Substitution
FontSubstitutionEnabled Enables the font substitution feature. If a font required by a product is not found on the server, depending on this value, it triggers an exception (for the False value) or substitutes the font (for the True value). If you turn it off, make sure that all fonts from all your templates are imported to Customer's Canvas as explained in Custom Fonts topic. NOTE: For auto-scaled texts, this option is ignored and it always throws an exception if it meets an unknown font in a template. The default value is True. True, False
SubstitutionFontPostScriptName The PostScript name of the font to substitute a missing font with. By default, it is the DefaultFontPostScriptName value. PostScript font name
Default Font
DefaultFontPostScriptName The PostScript name of the default font used for any new text. The default value is ArialMT. PostScript font name
Loading Templates
ParagraphTextEnabled Defines how to load uniformly formatted paragraph text from Photoshop templates. If True, the text is loaded as paragraph text, otherwise - as rich text; it is not recommended enabling this parameter as it is supported for backward compatibility. The default value is False. True, False
State Files
StateFileStorageEnabled Enables the space-saving mode of state files. This mode is helpful if you use large product template files. The default value is False. True, False
Security
ApiSecurityKey Enables access to Web API. You have to include this key in every header of HTTP requests as the X-CustomersCanvasAPIKey field to perform file operations on your server. Web API works if the value of this key passed in a request matches the value defined in web.config. The value is an arbitrary string (a unique value). For more details, refer to the Deploying Customer's Canvas to Windows Servers topic. string
HttpHeaderAllowOriginDomains Restricts embedding the editor to pages hosted only on listed domains. If your site and Customer's Canvas run on different domains, you can specify your site domain name in HttpHeaderAllowOriginDomains to disallow access to the web-to-print editor from other domains. The value is a comma-separated string. For example, it could be like "http://domain1.com,http://domain2.net". The "*" default value allows access from any domain. string
Proof Images
ProofImageDownloadEnabled Enables downloading of proof images instead of opening them in a tab when opening a proof image link in a browser. The default value is False. True, False
Image Placeholders
DefaultPlaceholderCoverModeEnabled Enables the cover mode. If True, the cover mode is enabled for image placeholders without using the <PACM> marker. The default value is False. True, False

FileCacheConfiguration

Cache parameters should be defined in the Aurigma.GraphicsMill.AjaxControls.VectorObjects.FileCacheConfiguration section.

XML 
<configuration>
    <configSections>
        <section name="Aurigma.GraphicsMill.AjaxControls.VectorObjects.FileCacheConfiguration" 
        type="System.Configuration.NameValueSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
        ...
    </configSections>
    <Aurigma.GraphicsMill.AjaxControls.VectorObjects.FileCacheConfiguration>
        <add key="MaxSize" value="10737418240" />
        <add key="CleanUpInterval" value="1800" />
        <add key="MaxUtilizationThreshold" value="95" />
        <add key="UtilizationTarget" value="70" />
        <add key="RootPath" value="~/App_Data/FileCache" />
    </Aurigma.GraphicsMill.AjaxControls.VectorObjects.FileCacheConfiguration>
</configuration>
Name Description Possible values
Cache
MaxSize The maximum size of the cache in bytes. The default value is 10737418240 (10GB). number
CleanUpInterval The interval between cleanup runs, in seconds. The default value is 1800 (30 minutes). number
MaxUtilizationThreshold The maximum cache utilization level (in percent) that triggers automatic cleanup. When the cache size reaches MaxUtilizationThreshold, the cleanup process starts. The default value is 95. number
UtilizationTarget The utilization level (in percent) to which the cache should be cleaned up. When the cleanup algorithm reaches the UtilizationTarget level, the cleanup process stops. The default value is 70. number
RootPath The folder where the cache is stored. The default value is ~/App_Data/FileCache. folder path

For more details, refer to the Configuring the Cache topic.

VectorObjects

Some other application parameters should be defined in the Aurigma.GraphicsMill.AjaxControls.VectorObjects section.

XML 
<configuration>
    <configSections>
        <section name="Aurigma.GraphicsMill.AjaxControls.VectorObjects" 
        type="System.Configuration.NameValueSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    </configSections>
    <Aurigma.GraphicsMill.AjaxControls.VectorObjects>
        <add key="RgbColorProfileFileName" value="" />
        <add key="CmykColorProfileFileName" value="" />
        <add key="GrayscaleColorProfileFileName" value="" />
        <add key="FontDirectory" value="~/Fonts" />
    </Aurigma.GraphicsMill.AjaxControls.VectorObjects>
</configuration>
Name Description Possible values
Hi-res output
RgbColorProfileFileName The name of the RGB color profile. file name
CmykColorProfileFileName The name of the CMYK color profile. file name
GrayscaleColorProfileFileName The name of the grayscale color profile. file name
Fonts
FontDirectory The folder path where fonts are stored. The default value is ~/Fonts. folder path
PsdTextBoxWorkaroundEnabled Allows for correcting a text position within the text box if Photoshop shifts this text for the used script font. The default value is False. True, False

For more details on color management, refer to the Setting Color Profile topic.

See Also

Manual