This tutorial will explain how to organise internationality-related aspects of templates and how they are used in practice. In this context, ‘internationality’ refers to the distinctions between countries and languages for the purposes of the Weagree Wizard. Date formats and phrases may differ per culture and the general country list can be edited to include or exclude any jurisdiction, as well as to include translations for different user-interface languages.
A. BASIC INTRODUCTION
To start organising internationality, follow the next steps:
1. Open a template in the Template Creation Tool. Ensure that the advanced-functionalities button in the top-right corner is switched on.
2. Click Organise internationality (language and date-format).
3. The pop-up that appears is divided into three subtabs, which are interconnected:
a. Languages. Each culture is connected to, and each jurisdiction may have translations for, any of the languages listed on this subtab. Each language itself is connected to the list of country codes also used for the Weagree Wizard’s user-interface languages. These are also used to create translations of standard text phrases (for more information on phrases, click here) and entity types (more on which here).
b. Cultures. These are used by templates to determine which date format and which translation for any given standard text phrase to use.
c. Jurisdictions. The jurisdictions that appear in the Weagree Wizard’s general country list (used in questionnaires, but also for example in the party database) and their translations can be edited here.
B. ORGANISING LANGUAGES
The Languages subtab allows for adding, editing and deleting languages.
1. To add a language, first click Add new language. A new pop-up will appear.
a. Select the applicable language.
b. Insert a description that will be used in the Weagree Wizard (e.g. English (UK)).
c. Optionally, tick Default language. This will in effect determine the default culture for your template.
d. Click Save.
2. To edit a language, click Edit language and then repeat steps 1a-1c insofar as needed. Click Save when finished.
3. To delete a language, click Remove language.
Note: you may re-add a deleted language, but there is no undo-functionality. Be sure there are no templates left using a particular language (culture) before removing it.
C. ORGANISING CULTURES
The Cultures subtab allows for adding, editing and deleting cultures.
1. To add a culture, first click Add new culture. A new pop-up will appear.
a. Insert a description that will be used in the Weagree Wizard (e.g. English).
b. Select the appropriate language. The options match those listed on the Languages subtab.
c. Select the applicable region. The options will be narrowed down to those where the selected language is spoken.
d. Insert the required date format. A few rules apply:
i. The format should include the day, month and year, but these can be in any order.
ii. For the day, d will produce one or two digits (e.g. 1 or 11), dd will always produce two digits (e.g. 01 or 11) and dddd will produce the day of the week (e.g. Monday). You can also combine dddd with dd or d to produce both the day of the week and day of the month.
iii. For the month, M will produce one or two digits, MM will always produce two digits and MMMM will produce the month in words (e.g. January).
iv. For year, yyyy will produce the four-digit year (e.g. 2024). It is also possible to abbreviate it to the last two digits with yy (e.g. 24), though this is not recommended.
v. Day, month and year can be separated by any character like a slash, hypen, period or space, or a combination of multiple characters.
e. Click Save.
2. To edit a culture, click Edit culture and then repeat steps 1a-1d insofar as needed. Click Save when finished.
3. To delete a culture, click Remove culture.
Note: as with languages, a culture may be re-added, but there is no undo-functionality. Be sure there are no templates left using a particular culture before removing it.
D. ORGANISING JURISDICTIONS
The Jurisdictions subtab allows for adding, editing and deleting jurisdictions.
1. To add a new jurisdiction, first click Add new jurisdiction. A new pop-up will appear.
a. Insert the international two-character jurisdiction code.
b. Insert the international three-letter jurisdiction code.
c. Insert the jurisidiction’s ISO number.
Note: the applicable codes and ISO numbers can be found on the ISO Online Browsing Platform.
d. Tick Active? if this jurisdiction should appear in the Weagree Wizard’s general country list.
e. Tick Default? if this jurisdiction should be the default country list option.
f. Optionally, tick Is EU member? if applicable.
g. Click Save.
2. To edit a jurisdiction, click Edit jurisdiction and then repeat steps 1a-1f insofar as needed. Click Save when finished.
3. To delete a jurisdiction, click Remove.
Note: as with language and cultures, a jurisdiction may be re-added, but there is no undo-functionality. Keep in mind that a jurisdiction may have been selected in any questionnaire with a country question, or as the (incorporation) country of any number of entities in the party database. It may be therefore more practical to deactivate a jurisdiction (i.e. hide it from the general country list) than to delete it.
E. USING INTERNATIONALITY
Internationality settings are applied automatically, but are dependent on two variables: the language selected for the Weagree Wizard’s interface and the culture selected for any given template.
1. User-interface language
How to organise user-interface languages is explained in detail here. Once languages corresponding to the ones set up as described above have been configured, selecting any from the top of the Weagree Wizard will automatically load any available translations into the general country list (and list of entity types).
2. Template culture
Independently of the user-interface languages, any culture set up as described above can be applied to a template. This will ensure use of the correct date format and translations of standard text phrases (if available).
1. In the Template Creation Tool, click on the template name at the top of the outline.
2. Click Edit the template settings.
3. Select the desired culture.
4. Click Save.