Change import parameters for images in CCMS Web

You can change the default settings for images that users import into IXIASOFT CCMS Web.

You can configure CCMS Web so that the filename extension of an image determines the default format an image is given when a user initially creates an image by uploading it. The same configuration also limits which image file types can be upload to a format in an existing image.

Changing these settings lets you limit the format that an image file should use when uploaded. This save users from having to update an image after it is created, and it constrains the formats available for images to those appropriate for specific filename extensions.

Also, you can limit the type for images by their filename extension. This can save a user from selecting values each time an image is uploaded.

  1. In the TEXTML Administration perspective, connect to your server.
  2. In the repository's /system/conf collection, locate the multiimage.xml file.
  3. Check out the file and open it for editing.
  4. For the <formatname> elements, add files types to the file-extensions attribute to limit which image files are allowed for each format.
    List filename extensions with spaces between them. Do not use periods. If file-extensions="" is empty, set to "*", or does not exist, then no limitations are set for the format and all images with any filename extension are accepted.

    If you add a filename extension to multiple formats, CCMS Web picks the first allowed format as the default when uploading. If you want a 'catch all' format, it should be the last format listed in multiimage.xml.

    For example, the default names for these formats are LowRes, HiRes, and Source (your deployment might be configured with different names). This configuration has the following results:

    <formatname file-extensions="png gif jpeg jpg">LowRes</formatname>
    <formatname file-extensions="svg">HiRes</formatname>
    <formatname file-extensions="">Source</formatname>
    • Only png, gif, jpeg, and jpg image files can be added to the LowRes format. These image files default to LowRes when uploaded.
    • Only svg image files are allowed for HiRes. These image files default to HiRes when uploaded.
    • All remaining image files default to Source when uploaded. But any image file (including png, gif, jpeg, and svg) can be uploaded to this format from the Image Editor.
    Warning: Removing an image file type from the file-extensions attribute will make any existing images in the CCMS with this image types for that format invalid. Check before removing a file extension.
  5. For the <type> elements, add filename extensions to the file-extensions attribute to set the default or possible types for images according to the types configured in your deployment.

    List filename extensions with spaces between them. Do not use periods. The following summarizes some possible configurations:

    Desired functionality Setting
    Let users pick that type for any image Leave the file-extensions attribute empty, set it to "*", or delete it.
    Make a type the default for all images with a specific filename extension Add the filename extension to the file-extensions attribute for only that type.
    Allow users to select multiple types for images with a specific filename extension Add the filename extension to the file-extensions attributes of multiple types and/or leave the file-extensions attributes for some types blank.

    For example, the default names for these types are Screen Capture, Line Art, and Equation (your deployment might be configured with different names). The code below lets users select any type for png, screen capture or line art for svg, and limits all other image files to screen capture:

    <type file-extensions="">Screen Capture</type>
    <type file-extensions="png svg">Lne Art</type>
    <type file-extensions="png">Equation</type>

    You can also pre-define the following for any image type:

    • translate: whether to mark the image as requiring translation
    • description: a description of the image
  6. Save, close, and check in the file.