Caution: This documentation is for eZ Publish legacy, from version 3.x to 6.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

ConversionRules

Summary

Sets the global conversion rules for formats that are not listed in [OutputSettings] AllowedOutputFormats.

Usage

 

ConversionRules[]=image/<type_to_convert_from>;image/<type_to_convert_to>

Description

Sets the global conversion rules for formats that are not listed in [OutputSettings] AllowedOutputFormats. By default most types will be converted to JPEG.
Multiple conversion rules can be set by adding multiple ConversionRules entries for specific image types.

To convert all images to one type, an "*" (asterisk) can be used instead of "image/<type_to_convert_from>". When using an "*" (asterisk) every image type not specified with its own ConversionRules entry will be converted to the same type. See example 1 below.

The ConversionRules only applies to the image formats which are not allowed. Therefore when defining this setting, it is important to keep in mind which image types are defined in the setting AllowedOutputFormat in block [outputsettings], because these types will not be converted according to the conversion rules set here.

This setting is case sensitive.

Examples

Example1

ConversionRules[]=image/gif;image/png
ConversionRules[]=image/x-xpixmap;image/png
ConversionRules[]=*;image/jpeg

This is the default setting. The last ConversionRules entry defines that every type will be converted to jpeg, with the exception of the above mentioned gif and x-xpixmap images. Gif and x-xpixmap images will be converted to png.

Example2

ConversionRules[]=image/jpeg;image/png

This setting can be used as fallback if JPEG is disabled as output.

Ester Heylen (10/05/2010 2:22 pm)

Ester Heylen (20/08/2010 2:26 pm)


Comments

There are no comments.