EditLive! 9 Documentation : images

This element allows for the configuration of information for images and any other media within EditLive!.

Configuration Element Tree Structure

<editLive>
     ...
     <mediaSettings>
          <images>
               <!--images configuration settings-->
          </images>
     </mediaSettings>
     ...
</editLive>

Required Attributes

allowLocalImages

This attribute defines whether users have the option to browse their local directories for images in the image dialog box. This attribute may be set to true or false. If set to false, users cannot browse local images.

To turn off local image browsing, the Insert Local Image... menu item must also be absent from the configuration.

allowUserSpecified

This attribute defines whether users have the option to specify URLs for images in the image dialog box. This attribute may be set to true or false. If set to false, users cannot specify image their own URLs.

If a user specifies the URL for a local file then EditLive! will attempt to upload this file.

Optional Attributes

The following optional attributes will only work if the imageEditor plugin is used in the <Plugins> element.

preferredWidth

This attribute defines the preferred width for local images. If the user inserts a local image with a width larger than preferredWidth, EditLive! will resize the image so it has a maximum width of preferredWidth while keeping the aspect ratio constant.
The enforcement is dependent on the memory available in the client environment.

preferredHeight

This attribute defines the preferred height for local images. If the user inserts a local image with a height larger than preferredHeight, EditLive! will resize the image so it has a maximum height of preferredHeight while keeping the aspect ratio constant.
The enforcement is dependent on the memory available in the client environment.

renameResizedImages

By default, images that are resized due to exceeding the preferredWidth and preferredHeight settings are renamed as well as resized. Setting this attribute to false allows that behaviour to be disabled so that images will retain their original filename when they are resized.

Child Elements

This element provides a list of images stored on a Web server which can be accessed by the end users of EditLive!.

<webdav> - Deprecated

This element allows for the customization of the EditLive! WebDAV functionality.

Remarks

The <images> element can appear only once within the <mediaSettings> element.