Ektron® eWebEditPro Developer's Reference Guide

Media File Object
gif,jpg,png,jpeg,jif
Dynamically Selecting Upload Destinations
The Media File Object is the interface to a selected file’s internet properties.
Effective use of the Media File Object is the key to manipulating the upload
mechanism. The object contains information on uploading, referencing, and
displaying the file.
To retrieve the interface to the object, using the MediaFile method.
var objMedia =
eWebEditPro.instances[sEditorName].editor.MediaFile();
or
var objMedia =
eWebEditPro.instances[sEditorName].editor.MediaFile();
Use these Media File Object methods to affect upload information.
getProperty(PropertyName as string, vData as Variant)
getPropertyString(PropertyName as string) as Variant
Use these properties to affect the upload mechanism, location, and reference.
TransferMethod as String – Method of Upload
DefDestinationDir as String – Upload path location
(TransferRoot as String – alias for DefDestinationDir)
WebRoot as String – Path reference from a Web page
WebRoot only inherits the value of DefDestinationDir when it is not assigned
a value anywhere, including in the configuration data. As a result, ASP, Cold
Fusion, and other scripting that use the same domain and directory structure for
transfers and referencing can work with the single DefDestinationDir
property.
See Also: ”Media File Object” on page 19
Modifying the Upload Location
Configuration Data
Any customization should begin with the configuration data, since all default
settings are defined there. In this case, the mediafiles section is the focus. The
following example explains how to address these issues.
• Since the example changes the upload mechanism programmatically, it
defaults to the internal FTP setting.
• The default upload destination directory is defined in the configuration file.
• Since the Web reference path is the same as the destination, the example
does not include a webroot element. As a result, the WebRoot property
inherits the value defined in the xferdir element and any value assigned to
the DefDestinationDir property.
Ektron® eWebEditPro Developer’s Reference Guide, Release 5.1, Revision 1 451