<imageBrowser> Configuration Element

This element allows for the specification of the image insertion web page component of the image insertion dialog, within Ephox EditLive! for XML. This allows a webpage to be shown that can contain links to various images.

Configuration Element Tree Structure

<editlive>
   <mediasettings>
      <imageBrowser.../>
   </mediasettings>
</editlive>

Required Attributes

href

The location of the web page to display.

Note

This may either be a relative or absolute URL defining the location of the image insertion web page. If this is a relative URL then it defines the location of the image insertion web page relative to the document root directory of the instance of EditLive! for XML concerned.

forceAbsolute

This attribute specifies whether the location of an image will be represented by it's absolute pathname or the path relative to where the instance of EditLive! for XML is being called.

For example, if a web page specified in the href attribute contains the following line of code:

<a href="images/ephoxImage.gif">An Ehox Image</a>

Using relative referencing, the URL of the image being inserted into EditLive! for XML would be:

<img src="images/ephoxImage.gif">

If using absolute referencing, the URL of the image being inserted would in this format:

<img src="http://www.ephox.com/images/ephoxImage.gif">

If all instances of EditLive! for XML are operating on the same server as the location of the images, forceAbsolute can be set to false. Otherwise, it is advised to set forceAbsolute to true.

Possible Values:

This attribute is boolean and can have the value of either true or false.

Example

The following example demonstrates how to define the image insertion web page for an instance of @@!Productname!@@.

<editLive>
    ...
    <images>
      <imageBrowser href="http://www.ephox.com" forceAbsolute="false" />
    </images>
    ...
</editLive> 

Remarks

The <imageBrowser> element can only appear once within the <mediasettings> element.