Change import parameters for images

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 saves users from having to update an image after it is created, and it restricts 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 time spent selecting values during each image upload.

To change import parameters for images:

  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 may have 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>
    • Users can only add PNG, GIF, JPEG, and JPG image files for the LowRes format. These image files default to LowRes for upload.
    • Users can only add SVG image files for the HiRes format. These image files default to HiRes for upload.
    • All remaining image files default to Source when uploaded. However, a user can upload any image file, including PNG, GIF, JPEG, and SVG, 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. Do not remove 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. The default names for these types are Screen Capture, Line Art, and Equation. Your deployment configuration might use different names.

    List filename extensions with spaces between them. Do not use periods.

    Desired functionality Setting
    Let users pick an image format type for any image Leave the file-extensions attribute empty, set it to "*", or delete it
    Make an image format 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 a user 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

    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 predefine 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.
The import parameters for images are updated and ready for use.