<MvLOCALIZED>

   Also See:   MvLOCALIZED-TOKEN MvLOCALIZED-TEXT  

Report a language bug  |  Report a documentation error
The localized tags allow you to design Miva Script programs that can display in various languages. In this way your programs can become truly international. <MvLOCALIZED> Starts the localization process. The tag can create a variable for output.
Syntax 
<MvLOCALIZED NAME = "string: {  expression } | literal"
             ID = "string: {  expression } | literal"
             STANDARDOUTPUTLEVEL = "keyword">
             
<MvLOCALIZED-TOKEN 
             NAME = "string: {  expression } | literal"
             VALUE = "{ expression } | literal">
                   
<MvLOCALIZED-TEXT 
             LANGUAGE = "string: {  expression } | literal language_id"> 
</MvLOCALIZED>
  • Closed Tag

Localization allows you embed language specific prompts in your scripts.

Attributes

  • NAME: Optional. If specified, the output from the tag is stored in the variable named by this attribute instead of being sent to the browser.
  • ID: Optional. For informational purposes and is not currently used by Miva Script.
  • STANDARDOUTPUTLEVEL: Optional keywords: html, text, null string. Specifies what displays in browser.
    • html: HTML is output to the browser. Default.
    • text: text (non html) is output to the browser. Default.
    • null string: will cause Miva Script to suppress output.

Language Identifiers

There are two language identifiers (current and default) that are set using two built-in functions:

  • miva_setdefaultlanguage (language) : sets the current language.
    language has two components: language-country code

The default is "en-US" for English-United States.

This example sets language to German.

Example:

<MvASSIGN NAME="l.ok" VALUE="{ miva_setlanguage ('de-DE') }">

The system variables s.miva_defaultlanguage retrieve the current language settings.

Example:

The current language is <MvEVAL EXPR="{ s.miva_defaultlanguage }">

Localization Blocks

The <MvLOCALIZED> tag starts the localization process. The tag can create a variable for output.

Example:

<MvLOCALIZED NAME="l.output" ID="001"  STANDARDOUTPUTLEVEL="">

...

</MvLOCALIZED>

Localized Text

Defines the text for the language specified by the LANGUAGE attribute. HTML is allowed, but no Miva tags may exist between the <MvLOCALIZED-TEXT> and </MvLOCALIZED-TEXT> tags.

You can include localized text for as many languages as you like. This examples displays the text for the previously set language.

Example:

<MvLOCALIZED-TEXT LANGUAGE = "en-US">Category: </MvLOCALIZED-TEXT>
<MvLOCALIZED-TEXT LANGUAGE = "de-DE">Kategorie: </MvLOCALIZED-TEXT>

Localized Token

Creates a "token" (or representation) which can then be displayed in localized text. Must be inside the <MvLOCALIZED> block and must precede any <MvLOCALIZED-TEXT> blocks that use the token.

You can include localized text for as many languages as you like. This examples displays the text for the previously set language.

Example:

<MvLOCALIZED NAME = "g.Message" ID = "MER-ADM-00224">
    <MvLOCALIZED-TOKEN NAME = "store_name" 
        VALUE = "{ encodeentities(Stores.d.name) }">
    <MvLOCALIZED-TEXT LANGUAGE = "en-US">
        Database Files for Store '%store_name%' Packed.</MvLOCALIZED-TEXT>
    <MvLOCALIZED-TEXT LANGUAGE = "de-DE">
        Datenbankdateien f¸r Laden '%store_name%' gepackt.</MvLOCALIZED-TEXT>
</MvLOCALIZED>

Localization Example

In this example, a user select a language from a form. When submitted the default language is set and a message is displayed in the correct language.

Example:

<form method = "get">
    <select name = "Language">
        <option value = "en-US">English</option>
        <option value = "de-DE">German</option>
    </select >
    <input type = "submit">
</form>

<MvIF EXPR = "{ len( g.Language ) }">
    <MvEVAL EXPR = "{ miva_setlanguage( g.Language ) }">
</MvIF>

<MvLOCALIZED>
    <MvLOCALIZED-TEXT LANGUAGE = "en-US">This is the english.</MvLOCALIZED-TEXT>
    <MvLOCALIZED-TEXT LANGUAGE = "de-DE">Dies ist das deutsche.</MvLOCALIZED-TEXT>
</MvLOCALIZED>
+ Add a note
User Annotations: MvLOCALIZED