Skip to content

Language Package Installation Plugin#

Registers new language items.

Components#

The languagecode attribute is required and should specify the ISO-639-1 language code.

The top level <language> node must contain a languagecode attribute.

<category>#

Each category must contain a name attribute containing two or three components consisting of alphanumeric character only, separated by a single full stop (., U+002E).

<item>#

Each language item must contain a name attribute containing at least three components consisting of alphanumeric character only, separated by a single full stop (., U+002E). The name of the parent <category> node followed by a full stop must be a prefix of the <item>’s name.

Wrap the text content inside a CDATA to avoid escaping of special characters.

Do not use the {lang} tag inside a language item.

The text content of the <item> node is the value of the language item. Language items that are not in the wcf.global category support template scripting.

Example#

Prior to version 5.5, there was no support for deleting language items and the category elements had to be placed directly as children of the language element, see the migration guide to version 5.5.

language/en.xml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<?xml version="1.0" encoding="UTF-8"?>
<language xmlns="http://www.woltlab.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.woltlab.com http://www.woltlab.com/XSD/2019/language.xsd" languagecode="en">
    <import>
        <category name="wcf.example">
            <item name="wcf.example.foo"><![CDATA[<strong>Look!</strong>]]></item>
        </category>
    </import>
    <delete>
        <item name="wcf.example.obsolete"/>
    </delete>
</language>

Last update: 2021-06-07