EditLive! 9 Documentation : repository

WebDAV support has been removed in EditLive! 9.1

Description

This element defines the configuration settings for the use of EditLive! with a WebDAV repository. Each possible use of the element is separated to allow maximum flexibility with repository setup.

Configuration Element Tree Structure

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

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

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

<editLive>
  ...
  <mediaSettings>
    ...
    <httpUpload>
      <repository ... />
    </httpUpload>
    ...
  </mediaSettings>
  ...
</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! concerned.

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

Optional Attributes

username

The username required to gain access to the server containing the WebDAV repository. If not specified and anonymous access is disabled, the user will be prompted for a login.

password

The password required, in conjuntion with the username, to gain access to the server containing the WebDAV repository.

name

The human-readable name for this WebDAV repository.

defaultDir

The initial directory that EditLive! is to access on the WebDAV server. If not specified, baseDir is used.

useMimeType

Whether or not to filter files according to their mime type. This attribute has two possible values: true or false. If this is false, the files are filtered according to their file extension.

Default: The default value for this attribute is true.

Example

The following example demonstrates how to define a WebDAV repository for image browsing. It specifies the root URL http://www.yourserver.com/webDAV for use with an instance of EditLive! 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 for hyperlink browsing. It specifies the root URL http://www.yourserver.com/webDAV for use with an instance of EditLive! running on a server different to that of the WebDAV repository. Thus, an absolute URL must be used.

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

The following example demonstrates how to enable EditLive! to upload local images to a WebDAV repository. Using the code below, a local image with a URL of file:///C:/Documents%20and%20Settings/DefaultUser/My%20Documents/My%20Pictures/ephoxlogo.gif would be uploaded to http://www.yourserver.com/webDAV/ephoxlogo.gif.

<editLive>
    ...
    <mediaSettings>
        ...
        <httpUpload>
            <repository name="Sample"
                username="admin"
                password="admin"
                baseDir="http://www.yourserver.com/webDAV"
                webDAVBaseURL="http://www.yourserver.com/webDAV"
            />
        </httpUpload>
    </mediaSettings>
    ...
</editLive>

Remarks

Using WebDAV with <httpUpload> does not allow the user to choose the upload location on the server. EditLive! will simply upload all images to the default directory.

The <repository> element can appear multiple times within each <webdav> element. Note that <httpUpload> does not contain a webdav element and only allows one <repository> element - if multiple <repository> elements are specified in this case, only the first is used.

The first repository listed within each <webdav> element is the default WebDAV repository for that feature (images, hyperlinks, or multimedia).

The <repository> element must be an empty XML tag; it cannot contain a body - only attributes. This means the tag must be specified as:

<repository name=... />