What's New

User Manual
1. Introduction
2. Basic Uploads
3. Config Params
4. Advanced
5. International
6. File Downloads

Object Reference
Live Demos

Download & Buy

Other Products
Contact Us

Chapter 6. File Download Functionality Chapter 4: Advanced Features Chapter 5: Internationalization

5.1 Unicode Support
5.2 Translation of Text Strings & User Messages

5.1 Unicode Support

Starting with version 3.0, XUpload is a fully Unicode-enabled product. Unlike older versions, XUpload 3.0 accepts files containing Unicode characters in their paths. It also accepts text form items with Unicode characters.

During an upload, XUpload 3.0 uses UTF-8 encoding to transfer Unicode file paths and text fields to the server. Server-side scripts invoked by XUpload must therefore be UTF-8 enabled to convert the encoded text strings back to Unicode.

ASP.NET is UTF-8 enabled by default. If your server-side script is based on classic ASP and AspUpload, you must explicitly enable UTF-8 by setting AspUpload's CodePage property to 65001 (which is the UTF-8 "code page" number), as follows:

Server-Side VBScript:
Set Upload = Server.CreateObject("Persits.Upload")
Upload.CodePage = 65001
nCount = Upload.Save("c:\upload")

See the AspUpload User Manual (Chapter 8) for more information on UTF-8.

5.2 Translation of Text Strings & User Messages

Starting with Version 3.0, XUpload's captions, menu items and user messages can be replaced by their equivalents in a foreign language of your choice:

(We thank Benjamin Hsieh for helping create this sample in Mandarine)

You as a developer are responsible for providing the foreign-language equivalents of the standard English-language strings such as "Files", "Size", "Upload", etc. We have provided a web-based form where you need to enter your translations in a language of your choice:

Click to open the Internationalization form

The form is located at http://support.persits.com/xupload/international.aspx.

The left side of the form lists the English-language text strings used by XUpload along with explanations where specifically each string is used. The right side of the form is where you enter your foreign-language equivalents of the strings.

Note that many strings in the User Error and Warning Messages section of the form contain special placeholder symbols such as %s, %d and %lu. It is very important that these placeholders be preserved in the translations. The order in which multiple placeholders appear within the same string must also be preserved.

Once you have entered the translations of all text strings, click the Submit button. At the bottom of the page, a <PARAM> tag will be generated similar to this:

<PARAM NAME="International" VALUE="

This Base64-encoded data contains the translated text strings you have entered. Include this <PARAM> tag in your <OBJECT> among other parameters, as follows:

<param name="server" value="localhost">
<param name="script" value="/xupload/01_simple_upload.asp">

<PARAM NAME="International" VALUE="   aABkADEAPQCUakhoIwAjAGgAZAAyAD0Ad5Wm...


Click the links below to run this code sample:


Chapter 6. File Download Functionality Chapter 4: Advanced Features 

Copyright © 1998 - 2010 Persits Software, Inc.
All Rights Reserved.
XUpload™ is a trademark of Persits Software, Inc.