Localize Article editor UI based on Bolt backend locale by Vondry · Pull Request #49 · bolt/article

Vondry · 2026-07-03T06:42:53Z

Localize the Article editor UI

Adds full localization to the Article rich-text editor. Previously the editor shipped no language files and was English-only, with no way to follow the per-user Bolt backend locale that Bolt already resolves.

What changed

Locale-driven editor UI — ArticleConfig sets editor.lang to the current request locale after the config merge, so the toolbar and popups always follow each user's Bolt admin locale (via LocaleSubscriber / _backend_locale). This is intentionally not overridable.
Auto-loaded language files — article_includes() loads the matching assets/article/langs/<code>.js before the plugin scripts, so each plugin's own translations.en deep-merges on top and the English fallback stays complete for every enabled plugin.
Safe fallback — the locale is resolved against the actually-shipped language file, so editor.lang and the loaded file always agree. Unknown or unshipped locales fall back to the built-in English instead of rendering an empty toolbar.
Shipped locales — English (en.js, the canonical editable set) plus Czech, German, Spanish, French, Croatian, Italian, Dutch, Polish, Russian, Slovak, and Slovenian.

Adding a language

Copy langs/en.js → langs/<code>.js and translate. Missing keys fall back to English automatically.

Also

Updated the plugin options list in config.yaml.
Documented the localization behaviour in the README.

Testing

bolt-cms-article-localized.mp4

The Article editor had no localization: it shipped no language files and its UI was English-only, with no way to follow the per-user Bolt backend locale that Bolt already resolves (LocaleSubscriber sets the request locale from the user's `_backend_locale`). - ArticleConfig sets `editor.lang` to the current request locale after the config merge, so the toolbar/popups always follow each user's Bolt locale. It is intentionally not overridable — driven solely by the user's Bolt admin locale. - article_includes() auto-loads the matching `assets/article/langs/<code>.js`, emitted BEFORE the plugin scripts so each plugin's own `translations.en` deep-merges on top and the English fallback stays complete for every enabled plugin. Locales without a file fall back to the built-in English. - Ship `langs/en.js` (the canonical, editable English set) and `langs/cs.js` (Czech). Adding a language is copy en.js -> <code>.js and translate; missing keys fall back to English. - Document the behaviour in the README.

resolveLocale() set editor.lang to the raw request locale even when no matching langs/<code>.js is shipped, while article_includes() skipped the missing file. The editor does not fall back on its own: an unknown lang table resolves every toolbar label to undefined, rendering an empty UI. Resolve the locale against the actually-shipped language file so editor.lang and the loaded file always agree, falling back to English otherwise.

Audited all twelve editor language files against the strings the editor and plugins actually resolve, then fixed what was wrong in the eleven translated locales. en.js needed no change: its 235 keys and values are byte-identical to the built-in English set in article-editor.min.js plus each plugin's own `translations.en`. Structure - cs.js was the only locale whose inline comments had been translated; restored to English so all eleven files mirror en.js exactly. Key sets and key order already matched everywhere. Grammar - add-column-after/before (and add-row-below/above in cs, sk) were translated word-for-word, leaving dangling prepositions. Reworded directionally in cs, sk, pl, ru, hr, sl. Wrong language - sl.js carried the Croatian `Neuredivo` for blocks.noneditable. Wrong meaning for the context - handle.handle labels the @-mention autocomplete plugin, not a drag grip; every locale had translated it as a physical handle. - selector.selector edits a block's id/class, so cs `Výběr`, sk `Výber` and sl `Izbirnik` become `Selektor`. - ru filelink.title is a link label field, not a heading. - editor.multiple is the breadcrumb for a multi-block selection; bare adjectives read as fragments, so use noun phrases. Label collisions on one surface - fr blocks.line vs blocks.row, sl blocks.address vs blocks.heading, hr and sl clips vs snippets. Spanish consistency - File is es-ES throughout: `Vídeo`, and `Incrustar` for embed so it no longer collides with `Insertar`; caption split into `Leyenda` for embeds and `Pie de imagen` for images; shorter `Sobresalir` for outset. Czech and Slovak accessibility.help-label dropped "rich". Left alone deliberately: fr/it share `Annuler`/`Annulla` for undo and cancel, which is standard and appears on different surfaces, and blocks.paragraph/quoteitem share a label upstream because a quote item is a paragraph.

Copilot

Copilot review overview

🟡 Changes recommended

The locale value requires validation to prevent path traversal, and the merge-target comment needs correction.

Review effort: Lite
Findings: 1

Open (1)

Unvalidated locale enables path traversal in script loading · New

What changed in this PR

Adds locale-aware Article editor UI localization using Bolt’s backend locale, with English fallback and translated language assets.

Changes:

Resolves and applies the active editor locale.
Loads language files before plugin scripts.
Adds translations, documentation, and configuration updates.

File	Summary
`src/TwigExtension.php`	Loads the matching language asset before plugins.
`src/ArticleConfig.php`	Resolves and applies the editor locale.
`README.md`	Documents localization behavior.
`config/services.yaml`	Supplies localization path parameters.
`config/config.yaml`	Updates plugin option documentation.
`assets/article/langs/sl.js`	Adds Slovenian translations.
`assets/article/langs/sk.js`	Adds Slovak translations.
`assets/article/langs/ru.js`	Adds Russian translations.
`assets/article/langs/pl.js`	Adds Polish translations.
`assets/article/langs/nl.js`	Adds Dutch translations.
`assets/article/langs/it.js`	Adds Italian translations.
`assets/article/langs/hr.js`	Adds Croatian translations.
`assets/article/langs/fr.js`	Adds French translations.
`assets/article/langs/es.js`	Adds Spanish translations.
`assets/article/langs/en.js`	Adds canonical English translations.
`assets/article/langs/de.js`	Adds German translations.
`assets/article/langs/cs.js`	Adds Czech translations.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

bobvandevijver · 2026-09-26T09:14:08Z

+        if ($locale === '') {
+            return false;
+        }


This is valid, but the same comment as made on the Redactor one apply. So, no check needed in the Config, but there needs to be a check in the Extension.

Also removes the need of some of the new arguments to this class by the way.

bobvandevijver

Lot's of similarities with bolt/redactor#41, so comments made there can also apply here.

bobvandevijver · 2026-09-26T09:14:08Z

+        if ($locale === '') {
+            return false;
+        }


This is valid, but the same comment as made on the Redactor one apply. So, no check needed in the Config, but there needs to be a check in the Extension.

Also removes the need of some of the new arguments to this class by the way.

bobvandevijver · 2026-09-26T09:32:20Z

+        if (! isset($this->config['editor']) || ! is_array($this->config['editor'])) {
+            $this->config['editor'] = [];
+        }


Suggested change

if (! isset($this->config['editor']) || ! is_array($this->config['editor'])) {

$this->config['editor'] = [];

}

$this->config['editor'] ??= [];

bobvandevijver · 2026-09-26T09:33:16Z

+            return '';
+        }
+
+        return sprintf('<script src="%s"></script>', $relative) . "\n";


Suggested change

return sprintf('<script src="%s"></script>', $relative) . "\n";

return sprintf('<script src="%s"></script>', $relative);

Vondry added 4 commits July 2, 2026 18:50

feat(article): add editor locale translations

6d77c8b

docs(article): update plugin options list

31abe1f

Vondry changed the title ~~Localize the Article editor UI~~ Localize the Article editor UI based on Bolt backend locale Jul 3, 2026

Vondry mentioned this pull request Jul 20, 2026

Fix all translations files and harden their consistency bolt/core#3753

Open

Vondry changed the title ~~Localize the Article editor UI based on Bolt backend locale~~ Localize Article editor UI based on Bolt backend locale Jul 20, 2026

Vondry mentioned this pull request Aug 4, 2026

feat(translations): add Slovak (sk) catalogues for messages, validators and security bolt/core#3786

Merged

Vondry force-pushed the feature/reactive-editor-locale branch from 75b9202 to 29b61b1 Compare September 9, 2026 08:55

bobvandevijver requested a lite review from Copilot September 26, 2026 08:42

Copilot started reviewing on behalf of bobvandevijver September 26, 2026 08:43 View session

Copilot AI reviewed Sep 26, 2026

View reviewed changes

bobvandevijver requested changes Sep 26, 2026

View reviewed changes

Navigation Menu

Uh oh!

Localize Article editor UI based on Bolt backend locale - #49

Localize Article editor UI based on Bolt backend locale#49
Vondry wants to merge 5 commits into
bolt:mainfrom
Vondry:feature/reactive-editor-locale

Vondry commented Jul 3, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

bobvandevijver Sep 26, 2026

Uh oh!

bobvandevijver left a comment

Uh oh!

bobvandevijver Sep 26, 2026

Uh oh!

bobvandevijver Sep 26, 2026

Uh oh!

bobvandevijver Sep 26, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

	return sprintf('<script src="%s"></script>', $relative) . "\n";
	return sprintf('<script src="%s"></script>', $relative);

Uh oh!

Conversation

Vondry commented Jul 3, 2026

Localize the Article editor UI

What changed

Adding a language

Also

Testing

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot review overview

🟡 Changes recommended

Uh oh!

bobvandevijver Sep 26, 2026

Choose a reason for hiding this comment

Uh oh!

bobvandevijver left a comment

Choose a reason for hiding this comment

Uh oh!

bobvandevijver Sep 26, 2026

Choose a reason for hiding this comment

Uh oh!

bobvandevijver Sep 26, 2026

Choose a reason for hiding this comment

Uh oh!

bobvandevijver Sep 26, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants