EditLive! 9 Documentation : imageBrowser

This element allows for the specification of the image insertion web page component of the image insertion dialog within EditLive!. This allows a webpage to be shown that contains links to various images. Multiple <imageBrowser> elements can be included to provide access to multiple pages, or a single browser can be used with links to each page.

Configuration Element Tree Structure



Required Attributes


The location of the web page to display.

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! concerned.


This attribute specifies whether the location of an image will be represented by its absolute pathname or the path relative to where the instance of EditLive! is being called. This attribute is a boolean and can have the value of either true or false.

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

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

Using relative referencing, the URL of the image being inserted into EditLive! 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! 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.

Optional Attributes


The name that appears below the button image.

The default button name is translated for each EditLive! interface translation. Use of this attribute will override it for all languages.


The location of an image to display instead of the default Image Browser button. Note that EditLive! will not resize this image, so if it is too big it will expand to the borders of the button and hide the text. For dialog consistency, Tiny recommends using the same size as the existing buttons (32x32).


The following example demonstrates how to define the image insertion web page for an instance of EditLive!. This example sets the button name to "Tiny Website" and retains the EditLive! default Image Browser button image.

      <imageBrowser href="http://tiny.cloud" forceAbsolute="false" name="Tiny Website" />


Each <imageBrowser> element within the <images> element will appear as a new button on the dialog. Buttons will appear in the same order as they are written in the configuration file.