<repository> Configuration Element
Prev Chapter 18. XML Configuration API Next

<repository> Configuration Element

This element defines the configuration settings for the use of Ephox EditLive! for XML with a WebDAV repository.

Configuration Element Tree Structure

OR

OR

<editLive>
     ...
     <mediaSettings>
          <images>
               ...
               <webdav
                    <repository ... />
               </webdav>
          </images>
     </mediaSettings>
     ...
</editLive>

OR

<editLive>
     ...
     <hyperlinks>
          ...
          <webdav>
              <repository ... />
          </webdav>
          ...
     </hyperlinks>
     ...
</editLive>

Required Attributes

baseDir

The root directory for the WebDAV repository. Users will not be permitted to browse to any directories of a higher level than that of the value of the baseDir attribute.

webDAVBaseURL

The location of the WebDAV repository relative to the document root of the instance of EditLive! for XML concerned.

Note

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

Optional Attributes

name

The human-readable name for this WebDAV repository.

defaultDir

The initial directory that EditLive! for XML is to access on the WebDAV server.

useMimeType

Whether or not to filter files according to their mime type. If this is false, the files are filtered according to their file extension.

Default: The default value for this attribute is true.

Note

This attribute has two possible values; true or false.

Example

The following example demonstrates how to define a WebDAV repository with the root URL http://www.yourserver.com/webDAV for use with an instance of EditLive! for XML which has the root directory http://www.yourserver.com/editlive. It uses a relative URL to define the location of the WebDAV repository.

<editLive>
    ...
    <mediaSettings>
        <images>
            <webdav>
                <repository name="Sample" 
                    baseDir="http://www.yourserver.com/webDAV"
                    defaultDir="SampleDir" 
                    webDAVBaseURL="../webDAV"
                />
            </webdav>
        </images>
    </mediaSettings>
    ...
</editLive>

The following example demonstrates how to define a WebDAV repository with the root URL http://www.yourserver.com/webDAV for use with an instance of EditLive! for XML running on a server different to that of the WebDAV repository. Thus, an absolute URL must be used.

<editLive>
    ...
    <mediaSettings>
        <images>
            <webdav>
                <repository name="Sample" 
                    baseDir="http://www.yourserver.com/webDAV"
                    defaultDir="SampleDir" 
                    webDAVBaseURL="http://www.yourserver.com/webDAV"
                />
            </webdav>
        </images>
    </mediaSettings>
    ...
</editLive>

Remarks

For WebDAV repositories requiring user authentication the <realm> element should be used to specify the user name and password for the repository.

The <repository> element can appear multiple times within the <webdav> element.

The <repository> element must be a complete tag, it cannot contain a tag body. Therefore the tag must be closed in the same line. See the example below:

<repository name=... />

The first repository listed in the EditLive! for XML configuration file is the default WebDAV repository.

See Also


Copyright 2001-2005 Ephox Corporation. All Rights Reserved.

Prev Up Next
<webdav> Configuration Element Home <imageBrowser> Configuration Element