Skip to content
  1. Extras
  2. Localizator
  3. System settings

System settings

Component settings use the localizator_ prefix.

Where to change: Manage → System settings — filter by name or find keys with the localizator_ prefix.

Required setting for pdoTools

For pdoTools snippets (pdoResources, pdoMenu, etc.) to fetch localized resources, set the system setting pdoFetch.class (pdotools namespace) to pdotools.pdofetchlocalizator.

Page content output

All resource fields are replaced by localized values except the content field. Content is output via $_modx->resource.localizator_content (in Fenom: {$_modx->resource.localizator_content}).

mFilter2

For mFilter2 to work correctly, set the system setting mse2_filters_handler_class to mse2LocalizatorFilter.

Localizator settings table

SettingDefaultDescription
localizator_default_languageNoDefault localization key (main language version)
localizator_check_permissionsNoCheck permissions to edit resource localizations
localizator_disabled_templatesComma-separated template IDs; the “Localizator” tab is hidden for resources using these templates
localizator_default_translatorYandexTranslator for auto-translation: Yandex, Google, DeepL or empty (copy without translation)
localizator_key_yandexNoAPI key for Yandex Translate
localizator_key_googleNoAPI key for Google Translate
localizator_key_deeplNoAPI key for DeepL
localizator_translate_fieldspagetitle, longtitle, …Fields to translate when auto-translating (including TVs)
localizator_translate_translatedNoWhen auto-translating, translate empty fields in existing localizations
localizator_translate_translated_fieldsNoWhen auto-translating, overwrite all localization fields
localizator_tv_fieldsNoTV names to edit in localizations. Empty — all TVs with “Available in localizations” enabled in TV settings; use a leading minus to exclude (e.g. -image)

site.com/en/ style setup

To support URLs like site.com/en/..., add rules to your web server config.

Apache (.htaccess)

apache
RewriteRule ^(ru|en)/assets(.*)$ assets$2 [L,QSA]

Nginx

nginx
location ~ ^/(ru|en) {
  rewrite ^/(ru|en)/(favicon.ico|assets.*)$ /$2 redirect;
  try_files $uri $uri/ @rewrite;
}