This documentation is for the old version. Go to the latest Upload Suite docs

Localization

To make Image Uploader Flash usage easier for non-English users, we provide a possibility to change all text that can ever be displayed by the control. Each text label, button caption, or error message can be changed using the appropriate class property.

Let us examine this possibility by the example of solving the following tasks:

Translating Interface into Single Language

This task implies that Image Uploader Flash user interface is translated into a single language. Here you can use the following ways:

  1. Simply specify each property when initializing an ImageUploaderFlash object.
  2. Use predefined localizations shipped with Image Uploader Flash SDK.
  3. Use your own localization scripts.

Translating Interface Manually

In the first case, necessary text properties with translation are added just like any other Image Uploader Flash property. This way is the most suitable if you use default localization and want to modify some captions and messages.

ASP.NET
<aur:ImageUploaderFlash ID="Uploader1" runat="server"
    CancelUploadButtonText="Stop"
    UploadButtonText="Send">
    <Messages PreviewNotAvailable="Preview is not available" />
</aur:ImageUploaderFlash>
PHP
$uploader = new ImageUploaderFlash("Uploader1");
$uploader->setCancelUploadButtonText("Stop");
$uploader->setUploadButtonText("Send");
$uploader->getMessages()->setPreviewNotAvailable("Preview is not available");
JavaScript
var fu = $au.imageUploaderFlash({
    cancelUploadButtonText: 'Stop',
    uploadButtonText: 'Send',
    messages:{
        previewNotAvailable: 'Preview is not available'
    }
});

Using Predefined Localizations

The second way allows you to translate Image Uploader Flash interface using just one line of code. All you need is to specify one of the available localizations via the ImageUploaderFlash.LanguageLanguage (ASP.NET)Language (PHP) property. However, this property is supported only in Image Uploader Flash ASP.NET and Image Uploader Flash PHP.

ASP.NET
<aur:ImageUploaderFlash ID="Uploader1" runat="server" 
    Language="English" />
PHP
$uploader = new ImageUploaderFlash("Uploader1");
$uploader->setLanguage("en");

In Image Uploader Flash JavaScript you should use aurigma.imageuploaderflash.X_localization.js (where X is a language code) files which come with Image Uploader Flash. These files are located in the /Scripts folder and contain all the text properties translated to the corresponding language. Thus, to translate Image Uploader Flash interface do the following:

  1. Link the aurigma.imageuploaderflash.en_localization.js file with the page where you configure an imageUploaderFlash object.
  2. Pass the en_localization object defined in this file to the imageUploaderFlash.set(Object) method.
JavaScript
<script type="text/javascript" src="Scripts/aurigma.imageuploaderflash.js">  </script>
<script type="text/javascript" src="Scripts/aurigma.imageuploaderflash.en_localization.js">  </script>
<script type="text/javascript">
var fu = $au.imageUploaderFlash({
    // Image Uploader configuration
});
fu.set(en_localization);
fu.writeHtml();
</script>

You can use the aurigma.imageuploaderflash.en_localization.js file as template to create your own localization script.

Using Custom Localization Scripts

As it was mentioned above, Image Uploader Flash JavaScript comes with predefined localization scripts. Each script defines a JavaScript object containing all the Image Uploader Flash text properties translated to a particular language. The same approach can be easily used to create your custom localization scripts.

Suppose, you want to translate Image Uploader Flash user interface into German. Then you need to do the following:

  1. Create the aurigma.imageuploaderflash.de_localization.js file in the /Scripts folder of your application (where the aurigma.imageuploaderflash.js file resides).

    Note

    Localization file should be saved in UTF-8.

  2. Declare the de_localization object and add all the Image Uploader Flash text properties.

    Here is a simplified example of this file:

    JavaScript
    var de_localization = {
        cancelUploadButtonText: 'Anhalten',
        uploadButtonText: 'Speichern',
        messages:{
            previewNotAvailable: 'Vorschau ist nicht verfugbar'
        }
    };
    
  3. Link this file with the page where you configure an imageUploaderFlash object.
  4. Pass the de_localization object to the imageUploaderFlash.set(Object) method.

    Here is a simplified example of this file:

    JavaScript
    <script type="text/javascript" src="Scripts/aurigma.imageuploaderflash.js">  </script>
    <script type="text/javascript" src="Scripts/aurigma.imageuploaderflash.de_localization.js">  </script>
    <script type="text/javascript">
    var fu = $au.imageUploaderFlash({
        // Image Uploader configuration
    });
    fu.set(de_localization);
    fu.writeHtml();
    </script>
    

The main advantage of this approach is that it allows you to keep Image Uploader Flash text parameters separately from its configuration.

Implementing Multilingual Interface

The idea is the following: add a list of links containing available languages and translate Image Uploader Flash GUI to the currently selected language. To implement this, insert links for languages you need. Each link should refer to the same page and add the lang parameter containing the selected language code. Then when the page is loading, just parse the lang parameter and configure Image Uploader Flash to use the corresponding localization.

ASP.NET
<form id="form1" runat="server">
    <ul>
        <li>
            <asp:LinkButton ID="enLangLinkButton" runat="server" OnClick="langLinkButton_Click">
                English
            </asp:LinkButton>
        </li>
        <li>
            <asp:LinkButton ID="ruLangLinkButton" runat="server" OnClick="langLinkButton_Click">
                Russian
            </asp:LinkButton>
        </li>
    </ul>
    <aur:ImageUploaderFlash ID="Uploader1" runat="server" />
</form>
C#
protected void langLinkButton_Click(object sender, EventArgs e)
{
    if (sender == enLangLinkButton)
    {
        Uploader1.Language = Aurigma.ImageUploaderFlash.Language.English;
    }
    else if (sender == ruLangLinkButton)
    {
        Uploader1.Language = Aurigma.ImageUploaderFlash.Language.Russian;
    }
}
PHP
<ul>
    <li><a href="?lang=en" id="lang_en">English</a></li>
    <li><a href="?lang=ru" id="lang_ru">Russian</a></li>
</ul>
<?php
require_once "ImageUploaderFlashPHP/Uploader.class.php";
$uploader = new ImageUploaderFlash('Uploader1');

// Set language
if (isset($_GET['lang'])) {
    switch ($_GET['lang']) {
        case 'en':
            $uploader->setLanguage('en');
            break;
        case 'ru':
            $uploader->setLanguage('ru');
            break;
    }
}

$uploader->render();
?>
JavaScript
<script type="text/javascript" src="Scripts/aurigma.imageuploaderflash.js">  </script>
<script type="text/javascript" src="Scripts/aurigma.imageuploaderflash.en_localization.js">  </script>
<script type="text/javascript" src="Scripts/aurigma.imageuploaderflash.ru_localization.js">  </script>
<ul>
    <li><a href="?lang=en" id="lang_en">English</a></li>
    <li><a href="?lang=ru" id="lang_ru">Russian</a></li>
</ul>
<script type="text/javascript">
var fu = $au.imageUploaderFlash({
    id: 'Uploader1',
    // Image Uploader configuration
});

// Apply localization
var lang = /[?&]lang=(\w{2})/.exec(location.search || location.href);
if (lang) {
    lang = lang[1];
}
      
var langObject = window[lang + '_localization'];
if (langObject) {
    fu.set(langObject);
}

fu.writeHtml();
</script>

See Also

Reference

Manual