Ultimate Uploader for PHP v1.3 Installation Guide |
What is Ultimate Uploader for PHP
Ultimate Uploader for PHP is the component intended for create new or integration into existing PHP web sites for the purpose of fast creation of application providing easy and convenient uploading multiple files on a server through Internet from a web browser. The control contains base client module embed in web page as object and customizabe PHP handler receiving files on the server side.
Key Features
Common requirements
Server side
Any web server with PHP server technology. On the web server following MIME types should be registered:
.xap application/x-silverlight-app .xaml application/xaml+xml .xbap application/x-ms-xbap
Client side
The Silverlight runtime environment (web browser plugin) will be automatically offered for installation at the first opening of page.
Integration into PHP web site
<object id="ultimateUploader" data="data:application/x-silverlight-2," type="application/x-silverlight-2" width="100%" height="100%"> <param name="source" value="ImageUpload.xap"/> <param name="background" value="white" /> <param name="minRuntimeVersion" value="3.0.40624.0" /> <param name="autoUpgrade" value="true" /> <param name="onLoad" value="onSilverlightLoaded" /> <param name="initParams" value="ChunkSize=0,UploadHandler=/upload.php,FileTypesFilter=All files (*.*)|*.*,MaxFileSize=0,ConcurrentUploads=1" /> <a href="http://go.microsoft.com/fwlink/?LinkID=149156&v=3.0.40624.0" style="text-decoration: none;"> <img src="http://go.microsoft.com/fwlink/?LinkId=108181" alt="Get Microsoft Silverlight" style="border-style: none"/> </a> </object>
Available upload control parameters list
Note: you can omit any parameter, in this case it will be set to default value.
Parameter name | Parameter description | Example | Default value |
Height | Height in pixels of the upload control. | Height=480 | 400 |
Width | Width in pixels of the upload control. | Width=640 | 600 |
BackColor | Color of upload control background. | BackColor=#CCFFFF | #FFFFFF |
ForeColor | Color of upload control text elements. | ForeColor=#3366CC | #000000 |
FontFamily | Name of upload control text elements font family. | FontFamily=Arial | Verdana |
FontSize | Size in pixels of upload control text elements font. | FontSize=12 | 11 |
FontStyle | Style of the font face, Normal or Italic. | FontStyle=Italic | Normal |
FontWeight | Weight of the font, such as Light, Normal, or Bold. | FontWeight=Bold | Normal |
UploadHandler | URL of the handler that receives uploaded files. | UploadHandler=http://mysite.com/upload.php | http://<AppPath>/Upload.ashx |
ChunkSize | The size in bytes of the chunks sent to the server, or 0 for automatic optimal size selection. | ChunkSize=262144 | 0 |
FileTypesFilter | Filter of file types allowed for upload to the server. | FileTypesFilter=Jpeg images (*.jpg)|*.jpg | All files (*.*)|*.* |
ConcurrentUploads | Maximum number of parallel uploads. | ConcurrentUploads=3 | 1 |
MaxFileSize | Maximum size in bytes of the file that can be uploaded to the server, 0 if unlimited. | MaxFileSize=8388608 | 0 |
ImageSize | Target size in pixels of the images if they need to be resized, 0 if don't need. | ImageSize=1024 | 0 |
ThumbnailSize | Size in pixels of the image thumbnails if they have to be uploaded with images, otherwise 0. | ThumbnailSize=128 | 0 |
ThumbNameTemplate | Template of thumbnail files naming. Should contain "{0}" literal meaning an original filename, otherwise will be ignored. | ThumbNameTemplate=_{0} | {0}_thumb |
JpegQuality | Quality (from 1 to 100) of resized JPEG images and thumbnails. | JpegQuality=95 | 90 |
ExistenceBehavior |
Definers behavior of the program in case of file part existence. Acceptable
values:
"Resume" - resume file uploading from point on which it has been interrupted earlier. "Overwrite" - start file uploading over again, having rewritten existing file part. "AskUser" - ask the user about what to do. |
ExistenceBehavior=AskUser | Resume |
HideUploadButton | Defines whether the upload button should be hidden in the user interface. | HideUploadButton=true | false |
HideCancelButton | Defines whether the cancel button should be hidden in the user interface. | HideCancelButton=true | false |
HideHelpButton | Defines whether the help button should be hidden in the user interface. | HideHelpButton=true | false |
HelpUrl | URL of help page opening at help button click. | HelpUrl=http://mysite.com/Guide.aspx | http://<AppPath>/Help.html |