TRANSLATED property

Checks whether the setting "Page is completely translated to this language" is activated

The setting “Page is completely translated to this language” can be activated for a form (only at the page level in the Page Store). By activating this option, the editor can define whether the contents have already been fully translated for the corresponding language. If the option is deactivated, the contents in the corresponding language are not taken into account when generating the project.

The TRANSLATED property has a dependence on the “Language substitution” project property. This means: Even if the TRANSLATED property is deactivated for a form, contents can still be generated for that form, e.g., by using the language substitution settings “Ignore” or “Use master language” (see Substitutions (→Documentation for Administrators)).

The TRANSLATED setting can be checked using a rule. The expression <PROPERTY source='#global' name='TRANSLATED'/> can be used for the rule definition in the value determination area and checks whether or not the option was set for the page. The expression returns a Boolean value. Since this is a generally applicable form property, the #global object has to be assigned to the source attribute.

This setting is related, at the page level, to the setting “include this section in the output” at the section level. This can be checked using the INCLUDED attribute.

Note: Depending on the configuration, individual elements of a form may be language-dependent and others may be language-independent. If the language tabs are displayed within the language-independent subform (via the show-language-tabs parameter for section lists) by mistake, the configuration is incorrect, which, in conjunction with a rule definition, can prevent the ability to save the corresponding form.

The TRANSLATED property (<PROPERTY source="#global" name="TRANSLATED"/>) is not available within link templates.

Examples

Displaying a form element if the page is translated completely

The following form contains two design elements of type CMS_GROUP with different form contents. A dynamic form is to be used to ensure that just one specific form content is shown depending on the setting “Page is completely translated to this language”.

Because this option is only available in the Page Store, two conditions are checked in the value determination.

• If the form was opened in the Page Store AND the option “Page is completely translated to this language” was activated, form content A is shown.
• If the form was opened in the page store AND the option “Page is completely translated to this language” was deactivated, form content B appears.

...
<RULE>
    <WITH>
        <AND>
            <EQUAL>
                <PROPERTY source="#global" name="STORETYPE"/>
                <TEXT>pagestore</TEXT>
            </EQUAL>
            <PROPERTY source="#global" name="TRANSLATED"/>
        </AND>
    </WITH>
    <DO>
        <PROPERTY source="#form.A" name="VISIBLE"/>
    </DO>
</RULE>

<RULE>
    <WITH>
        <AND>
            <EQUAL>
                <PROPERTY source="#global" name="STORETYPE"/>
                <TEXT>pagestore</TEXT>
            </EQUAL>
            <NOT>
                <PROPERTY source="#global" name="TRANSLATED"/>
            </NOT>
        </AND>
    </WITH>
    <DO>
        <PROPERTY source="#form.B" name="VISIBLE"/>
    </DO>
</RULE>
...