Documentation Center

Internationalizing GUI extension strings

Internationalize strings in GUI extensions to ensure that, say, Japanese users see Japanese GUI labels when they use your extension.

Procedure

Wherever your custom GUI extension requires a string to be displayed, internationalize that string by pointing to a resource string assembly and indicating the name of the property that contains the string in all languages. For example, the following specification of an additional column displays the word "Schema" (the value of the title arttribute) as its column header in all languages:
<ext:column xmlns="http://www.sdltridion.com/2009/GUI/Extensions/List"
	id="MyColumnName" type="data" 
	title="Schema"
	selector="@SchemaTitle" translate="String" />
</ext:columns>

To internationalize this string, replace the word "Schema" with {Resources: StringResource, PropertyName}, where StringResource identifies the string resource in your assembly, and PropertyName is the name of the property for which you want to retrieve the localized version. To get the localized versions of SDL Tridion strings, set StringResource to Tridion.Web.UI.Strings.

For example, the following ext:column element has a changed title attribute that retrieves the localized version of the word "Schema" by looking up the value of the Schema property for the current language in SDL Tridion's own Tridion.Web.UI.Strings string resource:

<ext:column xmlns="http://www.sdltridion.com/2009/GUI/Extensions/List"
	id="MyColumnName" type="data" 
	title="{Resources: Tridion.Web.UI.Strings, Schema}"
	selector="@SchemaTitle" translate="String" />
</ext:columns>