In this section · 3 articles

Language fields, settings and permissions

Every field on the language form and column of the Languages list, the Translation Strings editor, the Language Settings panel, and the permissions for each screen and action.

Applies to
Language 1.3 and later
Who can do this
Platform owner, Administrator, Developer
Where
Languages
On this page

The language form

Languages, then New Languages or a row's Edit. See Add a language.

SectionFieldWhat it doesRules
Language DetailsNameThe language's name in English.Required. Up to 255 characters.
Language DetailsCodeThe two-letter code that ties the language to its translation files, people's choice and translated content.Required. Exactly 2 lowercase letters, unique. Can't be changed after the language is added.
Language DetailsNativeThe language's name in its own script, shown in the language lists.Required. Up to 255 characters.
Language DetailsDirectionLTR (left to right) or RTL (right to left).Required.
Language DetailsStatusEnabled: staff can use Laramin's screens in this language. Disabled: they can't.Required.
Language DetailsWebsitePublished: you can write content in this language, and your website is offered it. Not published: it isn't.Required.
Typography (optional)Font FamilyThe font for this language's script. Blank uses the admin theme's font.One of the fonts offered.
Typography (optional)Heading Font FamilyA different font for headings. Blank uses Font Family.One of the fonts offered.
Typography (optional)Font Size ScaleMakes all text a little bigger or smaller, for example 0.94 for a script that looks large.From 0.5 to 1.5. Blank means no change.
Typography (optional)Line HeightSpace between lines of body text, for example 1.6.From 1 to 2.5. Blank uses the theme's.
Typography (optional)Letter SpacingSpace between letters, such as normal or 0.01em.Leave blank for Indian scripts and Arabic, where spacing breaks the letters' shapes.
The empty Create Languages form, with Name, Code, Native, Direction, Status and Website under Language Details, and font, size scale, line height and letter spacing under Typography (optional).

The Languages list

ColumnWhat it shows
Name, Code, NativeAs set on the form.
DirectionLTR or RTL.
StatusEnabled or Disabled.
WebsitePublished or Not published.
Updated AtWhen the language was last changed.
The Languages list showing all seven languages with their Name, Code, Native, Direction, Status, Website and Updated At columns, and the Tamil row's actions menu open with Translation Strings, Edit and Delete.

Each row has a Translation Strings link and, in its actions menu, Edit and Delete. English has no Delete.

The Translation Strings editor

A language's Translation Strings link. See Translate screen text.

ControlWhat it does
File / ModuleWhich set of screen text to edit: Core / Default for Laramin itself, or name Module for an add-on.
SearchFinds rows by key or English text.
Untranslated onlyShows only rows with no translation.
done of total translatedHow many rows in this set have a translation.
Key, Source (English), TranslationThe text's key, its English wording, and your translation.
Save changesSaves the rows you changed.
Back to LanguagesReturns to the list.
The Translation Strings editor for Tamil, showing File / Module set to Core / Default, the search box, Untranslated only, 4523 of 4526 translated, and the Key, Source (English) and Translation columns.

Translations for Core / Default are saved in Laramin's own file for the language. Translations for an add-on are saved in a separate file per add-on and language, which is used ahead of the add-on's own translations.

Language Settings

The Language Settings panel, under General in the Settings hub, has two fields: System Name (required, at least 5 characters) and Icon. Nothing in your Laramin uses these two settings, so you can leave them as they are.

The Language Settings panel, selected under General in the Settings hub, showing the required System Name field set to "language" and the Icon upload area.

The public list of languages

While the Language add-on is on, your website and apps can read the languages set to Published from your Laramin's public reference API, at /api/v1/public/reference/languages. Each entry gives the language's name, code, native name and direction, whether it's the Default Language, and its typography. Languages that aren't published aren't listed.

Permissions

In the role editor, the permissions are under Languages.

The role editor's permission list with the Language group expanded and highlighted, showing 0 of 7 granted and the Languages rows Language and Settings, both set to None.
PermissionLabelAllows
feature.lang.language.listList LanguageOpening Languages.
feature.lang.language.viewView LanguageOpening a language's Translation Strings, read-only.
feature.lang.language.createCreate LanguageAdding languages.
feature.lang.language.editEdit LanguageChanging languages, including Status and Website, and saving translations in Translation Strings.
feature.lang.language.deleteDelete LanguageDeleting languages.
feature.lang.settings.viewView SettingsOpening Language Settings.
feature.lang.settings.editEdit SettingsSaving Language Settings.

Translating a record's content needs permission to edit that record, not a Language permission. Everyone who can sign in can choose their own interface language.

Careful: Edit Language changes what your public website offers, through Website, and every word on Laramin's screens, through Translation Strings. Give it only to people you trust with both.

To give these permissions, see Give someone a role.