Languages

107 vues Markdown

Enable or disable installed languages to offer clients only ready language choices and restore them later without deleting translations.

Reaching the Screen

Panel menu: Languages then Browse Languages: {admin}/languages

Staff who can only view languages see no submenu: for them Languages opens this list directly.

What Is on the Screen

A short page: two notices, one button and the list of installed languages.

Notices Two bands above the list. The first says what this screen is for, the second warns that bulk text editing is meant for wording only: keys, variables and HTML tags have to stay as they are.
Find and Replace Opens the search screen that works across every language pack at once. Shown only to staff who can edit languages. An installed module can add its own buttons to the same strip.
The list One row per installed language, whether it is on or off. There is no paging trouble here: an installation carries a fixed set of languages.
Search and download The usual list controls sit above the table: a search box, the rows-per-page selector and a download icon that saves the list as a file.

A row

The language name is a link to its edit screen, and the folder code sits right next to it in small type. That code is the language's real identity: it is what appears in addresses as /de/ (the default language is the exception, its addresses carry no prefix) and what every text file of that language lives under.

The default language is at the top of the list. A language that is switched off drops to the bottom and is shown faded, so the set your customers actually see can be read at a glance.

Fields

Language Name The name visitors see in the language picker, followed by the folder code. Both come from the language package itself. The edit screen shows the display name read-only, and the folder code is the language's directory name, which cannot be changed from the panel at all.
Translated How much of the language is actually translated, as a percentage of English. Hover the badge for the counts behind it. The figure is read from a cache, so a change you have just made may take a while to show up here.
Default A tick marks the language your site falls back to. Exactly one language carries it; the others show a dash instead. Which one it is set on the language's own edit screen.
Status The switch that offers the language to your customers or takes it away. It saves the moment you click it, with no separate save button. The switch is closed on the default language and for staff without editing rights.
Edit The row menu at the end of the line. It holds a single action, and it is only there for staff who can edit languages. There is no delete action here.

Tasks

Stop offering a language

  1. Find its row in the list.
  2. Click the switch in the Status column.
  3. The row fades at once and a saved confirmation appears; the language disappears from your site's language picker. It moves to the bottom of the list the next time the page is loaded. The same switch brings it back.

See how complete a language is

  1. Read the badge in the Translated column: green is nearly complete, yellow is partial, red means most of it is still English.
  2. Hover the badge to see how many texts of the total have actually been translated.
  3. English carries a Reference badge instead of a percentage: it is the yardstick every other language is measured against.

Open a language

  1. Click the language name, or use Edit in the row menu.
  2. The edit screen opens: display name, sort order, the default flag, and the JSON export and import used for bulk text changes.

Things to Watch

Languages are not created or deleted here

They ship with the product, so the panel edits the ones already installed and nothing else. If a language should not reach your customers, switch it off: that is reversible, whereas removing a language tree would leave an installation you could not repair from here.

Switching off hides, it does not erase

Everything already written in that language stays where it is. The language simply stops being offered, and switching it back on returns it exactly as it was.

The default language cannot be switched off

Its switch is closed, because the site has to be able to fall back somewhere. To hand the role to another language, open that language and set it as the default there; the previous one becomes an ordinary language again and can then be switched off.

Required Privileges

The screen opens for staff holding LANGUAGES_LOOK or LANGUAGES_OPERATION. Everything that changes something needs LANGUAGES_OPERATION: without it the status switches are closed, and neither the Find and Replace button nor the row menu is shown. Downloading the list follows TABLE_EXPORT.

Cet article vous a-t-il été utile ?

Merci pour votre retour !

Besoin d'aide supplémentaire ?

Notre équipe d'assistance est disponible 24h/24 pour tout ce que vous ne trouvez pas ci-dessus.