Configuring Common Upload Settings

Image Uploader Flash is a client-side application which does not save files on server disk. It simply submits user-selected files to a page specified in its settings and redirects users to another page when the upload is completed. The present topic describes how to specify a page to which Image Uploader Flash submits files and a page where Image Uploader Flash redirects users when upload is successfully completed.

Besides these URLs, Image Uploader Flash allows to specify what and how many converted files should be sent for each user-selected file.

Upload and redirection pages can be set using the UploadSettingsUploadSettings (ASP.NET)UploadSettings (PHP)uploadSettings (JavaScript) property of the ImageUploaderFlashImageUploaderFlash (ASP.NET)ImageUploaderFlash (PHP)imageUploaderFlash (JavaScript) class. Here the upload page is specified with the ActionUrlActionUrl (ASP.NET)ActionUrl (PHP)actionUrl (JavaScript) property, and the redirection page is specified with RedirectUrlRedirectUrl (ASP.NET)RedirectUrl (PHP)redirectUrl (JavaScript).

<aur:ImageUploaderFlash ID="Uploader1" runat="server">
    <UploadSettings ActionUrl="upload.aspx" 
		RedirectUrl="gallery.aspx" />
</aur:ImageUploaderFlash>

$uploader = new ImageUploaderFlash("Uploader1");

$uploader->getUploadSettings()->setActionUrl("upload.php");
$uploader->getUploadSettings()->setRedirectUrl("gallery.php");

var fu = $au.imageUploaderFlash({
	id: 'Uploader1',
	uploadSettings: {actionUrl:'upload.aspx', 
		redirectUrl:'gallery.aspx'}
});	

The ActionUrl property specifies a URL to the page where files are posted. That page should contain the server code which parses the upload request, saves files to the necessary folders on server, and performs other additional actions. Usually, this URL must have a specific extension (depending on the web server settings). For ASP.NET platform it should be .aspx, for PHP it is .php, for Perl it can be .pl or .cgi, etc. In other words, the file containing this script should have the extension registered in the settings of your web server as a server page. Otherwise, upload would fail. If you want to submit files to the same page where Image Uploader Flash is hosted, specify the dot character (.) as a value of this property.

When users upload files using the standard <input type="file"> element, they expect to be redirected to the page where they have submitted the files. However, Image Uploader Flash works in a different way. The response generated by the page, which is specified with the ActionUrl property, is sent back to Image Uploader Flash and not to the browser. As soon as Image Uploader Flash receives this response, the upload is considered completed; and the user is redirected to the page specified with the RedirectUrl property. If you do not need this redirection, set this property to an empty string.

When specifying these properties, take into account the following cases:

Using Quotation Marks and Semicolons

URLs can contain semicolon or quotation mark characters (e.g. http://upload.server.com/uploadFile;jsessionid=123?param='value'). If they do, enclose such URLs in single (' ') or double (" ") quotes to avoid parameter parsing errors. Moreover, quotation marks (both single ' and double ") inside URLs should be escaped with a backslash:

"http://upload.server.com/uploadFile;jsessionid=123?param=\'value\'"

Using Absolute and Relative URLs

URLs can be both absolute (e.g. "http://domain.com/Gallery/gallery.aspx") and relative to the current page (e.g. "/Gallery/gallery.aspx").

For instance, if Image Uploader Flash is inserted into the http://domain.com/ImageUploaderFlash/default.aspx page, the relative URLs specified via the RedirectUrl property will correspond to the following locations.