Installation of Postlet couldn't be simpler. All that is required is that you drop the Postlet.jar file into a directory on your webserver, and then edit an HTML page to look similar to my example page.
The following is a list of parameters (and possible values) that Postlet supports (∗ required):
- destination ∗
This is the URL of the server side script which will accept files for upload.
The language to use for Postlet's user interface. A list of available languages is displayed on the Postlet home page. Defaults to English
- backgroundcolour †
The colour to use for the background of Postlet, defaults to grey.
- tableheadercolour †
The colour to use for the text of the Table Headers, defaults to black.
- tableheaderbackgroundcolour †
The colour to use for the background of the Table Headers, defaults to grey.
A comma delimited list of file extensions to limit the display to. The first element should be a text description e.g. "Image files,jpg,bmp,gif"
Whether to show the warning message once the upload button is pressed. Possible value="true", default is false
Whether to automatically upload files once they are selected (without having to press upload). Possible value="true", default is false
- helpbutton (**Versions >0.10.0**)
Whether or not to display the "Help" button. Possible value="true", default is false
Maximum number of connections to use. Possible values 1,2,3,4,5 - Use 5 if you have a server with low traffic on a fast connection, default is 5
URL to take the user to once upload has completed
URL to show if the user clicks the help button. Defaults to http://www.postlet.com/help/
Whether or not to show the popup message listing the files that failed to upload. Default is false.
- maxpixels (**Versions >0.13**)
This is the maximum number of pixels allowed for GIF, JPEG and PNG images when uploaded. If files exceed this limit, they are resized to the set limit. Note, GIF images if resized, are uploaded as PNG images.
Getting file upload support on your server however, may be much more difficult. For this reason, I've written a very short HTML page which mimics the way that Postlet sends files to a server. It is recommended that you get file uploads to work with this first, before trying to get them to work with Postlet.
If you're still having problems, then please post a message to the forums hosted on Sourceforge.
The format of the messages returned by server side scripts are shown below:
All reply messages should start with "POSTLET REPLY" followed by a line break
All reply messages should end with "END POSTLET REPLY" followed by a line break
The following are examples of the currently supported reply messages
- Successful upload
POSTLET REPLY POSTLET:YES END POSTLET REPLY
- File type not allowed, do not retry
POSTLET REPLY POSTLET:NO POSTLET:FILE TYPE NOT ALLOWED POSTLET:ABORT THIS END POSTLET REPLY
- File too large, do not retry
POSTLET REPLY POSTLET:NO POSTLET:TOO LARGE POSTLET:ABORT THIS END POSTLET REPLY
- Server error, do not upload any more files ∗
POSTLET REPLY POSTLET:NO POSTLET:SERVER ERROR POSTLET:ABORT ALL END POSTLET REPLY
- Unknown error, try and upload file again
POSTLET REPLY POSTLET:NO POSTLET:UNKNOWN ERROR POSTLET:RETRY END POSTLET REPLY
∗ Doesn't currently abort all files