EditLive! 9 Documentation : httpUpload

This element allows for the configuration of information used when using HTTP upload within Tiny EditLive! to upload embedded image and media files.

Configuration Element Tree Structure

<editLive>
  ...
  <mediaSettings>
    <httpUpload ... />
  </mediaSettings>
  ...
</editLive>

Required Attributes

These attributes are ignored when a repository child element is used.

base

This attribute defines the location where images can be found after they have been uploaded. Each local image URL will be replaced with this URL so that images will be accessed from the server location. For more information please see the developer guide article on HTTP upload.

href

This attribute defines the location on the Web server of the script which handles image uploads. For more information please see the developer guide article on HTTP upload.

Optional Attributes

allowObjectUpload

This attribute defines whether local object files are automatically uploaded using the base and href attributes mentioned above.

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

uploadFileFieldName

This attribute defines the field name for the upload file. This attribute is a string.

Child Elements

This element is used to provide extra information when performing a HTTP upload. This can be used so that extra information is provided to your HTTP upload handler script via HTTP Header elements. Multiple elements are allowed; data is specified in name and value pairings.

<httpUploadData> elements are included in regular HTTP uploads.

This element is used to provide extra information when performing a HTTP upload. This can be used so that extra information is provided to your HTTP upload handler script via HTTP POST Elements. Multiple elements are allowed; data is specified in name and value pairings.

<httpPostData> elements are included in regular HTTP uploads.

<repository> - Deprecated

Overrides the base and href attributes of the <httpUpload> tag and instead uploads all media to a WebDAV server.

Example

The following example demonstrates how to define the base and href attributes for EditLive!.

<editLive>
    ...
    <mediaSettings>
        <httpUpload
          base="http://yourserver.com/imagedir/" 
          href="http://yourserver.com/scripts/uploadhandler.asp" 
        </httpUpload>
    </mediaSettings>
    ...
</editLive>

Remarks

The <httpUpload> element can appear only once within the <mediaSettings> element.

If there are no <httpUploadData> or <repository> elements then <httpUpload> must be a complete tag; it cannot contain a tag body. Therefore, the tag must be closed in the same line. It should appear as below:

<httpUpload base=... />

If there are <httpUploadData>, <httpPostData> or <repository> elements present then the <httpUpload> element needs to have both opening and closing tags. It should appear as below:

...
<httpUpload base=... >
  <httpUploadData name=... />
  <httpUploadData name=... />
</httpUpload>
...