<repository> Element

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

Element Tree Structure

<editLiveForJava>
    <mediaSettings>
        <images>
            <webdav>
                <repository>

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

Required Attributes

Attribute Description
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 Java 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 Java concerned.  See the <base> element for more information on setting the document root directory in EditLive! for Java.

Optional Attributes

Attribute Description
name The human-readable name for this WebDAV repository.
defaultDir The initial directory that EditLive! for Java 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.
Note:  This attribute has two possible values; true or false.
Default:  The default value for this attribute is true.

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 Java which has the root directory http://www.yourserver.com/editliveforjava.  It uses a relative URL to define the location of the WebDAV repository.

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

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 Java running on a server different to that of the WebDAV repository.  Thus, an absolute URL must be used.

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

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 Java XML configuration file is the default WebDAV repository.

See Also