flagrow/linguist

Customize translations


Keywords
translation, locale, extension, flarum, flagrow, linguist, translation-key
License
MIT

Documentation

Linguist by FriendsOfFlarum

MIT license Latest Stable Version Total Downloads

With this extension you can configure alternate or missing translation strings for your forum. Includes:

  • No manual translation file editing required, everything is configured via the admin UI
  • Translate frontend or backend strings
  • Override the translation for a specific locale or all installed locales
  • Easily search for strings by name or value in any language
  • Multiple filters to find strings that are missing translations or belong to a specific extension

After editing translations, Linguist will offer you the opportunity to clear the forum cache. For performance reasons, Linguist won't attempt to clear the cache by itself.

If the new translations don't show up, try clearing the cache again by using Dashboard > Tools > Clear cache or by running php flarum cache:clear.

Also note Flarum uses a "one place, one translation key" approach to translations, so you might have to edit several keys to replace a specific keyword.

Installation

composer require fof/linguist

Updating

composer require fof/linguist
php flarum migrate
php flarum cache:clear

Updating from Flagrow

This extension replaces Flagrow Linguist.

To upgrade from the old extension to the new one:

  • Disable the Linguist extension in the admin panel.

  • Run:

composer require fof/linguist

Composer should let you know that flagrow/linguist has been automatically removed.

  • Enable the new extension in the admin panel.

  • Your existing translations will be migrated to FoF Linguist automatically.

  • Edit a translation or clear the cache to apply the existing translations to the forum.

Configuration

Once enabled, a new tab will show up in the admin to configure translations.

The tab will list all translations strings registered by extensions on your forum. You can customize the text by entering your own value in the field.

A special field "all" allows you to define a single text that will be shown in all languages.

Keep in mind some strings contain references in the form {referencename} that you have to keep identical if you want the data to show up.

An extension by FriendsOfFlarum