pbStudio: Подключаем мультиязычность в PageBlocks

Введение

PageBlocks поддерживает мультиязычность без контекстов. Достаточно указать языки, задать поля для перевода и, при необходимости, подключить автоперевод — остальное сделает PageBlocks.

Навигация по урокам:

• pbStudio: Создаём сайт с PageBlocks – настройка и главная страница
• pbStudio: Меню и страница «О нас»
• pbStudio: Чистый контроллер или FetchIt — два способа обработки форм
• pbStudio: Портфолио, Услуги и Контакты
• pbStudio: Подключаем мультиязычность в PageBlocks

Шаг 1. Настройка мультиязычности

Чтобы включить поддержку языков, измените следующие системные настройки:

• pageblocks_context_aware = Да
• pageblocks_contexts = [{«key»:«web»,«value»:«Russian»}, {«key»:«en»,«value»:«English»}]

В MODX 2 значения языков нужно задать вручную в формате JSON.
В MODX 3 доступна удобная таблица редактирования языков.

Также нужно указать, какие поля ресурса нужно переводить:

• pageblocks_translate_resource_fields = pagetitle,longtitle,description,introtext,content,menutitle

Шаг 2. Настройка автоматического перевода (опционально)

Поддерживаются два переводчика:

ChatGPT

• pageblocks_translator = ChatGPT
• pageblocks_chatgpt_apikey = ваш API-ключ

DeepL

• pageblocks_translator = DeepL
• pageblocks_deepl_account = Free или Pro
• pageblocks_deepl_apikey = ваш API-ключ

Шаг 3. Вывод переключателя языков на сайте

Добавьте в header.tpl следующий код:

<ul class="navbar-nav ms-auto d-flex align-items-center list-unstyled mb-0">
 {'!pbLang' | snippet: [
        'tpl' => '@INLINE <li class="nav-item">
                <a class="nav-link {$activeCls}" lang="{$key}" href="{$url}">{$value}</a>
            </li>',
        'showCurrent' => 1
    ]}
</ul>

Если у вас не используется маршрутизация, шаги 4 и 5 можно пропустить.

Шаг 4. Настройка маршрутов (опционально)

При переходе на URL вида /en/ без правильного маршрута вы получите ошибку 404. Чтобы это исправить, добавьте маршрут в web.php:

Route::get('/{context}/{alias?}', [ResourceController::class, 'context'])
    ->where('context', '[a-z]{2}');

->where('context', '[a-z]{2}') — указываем, что контекст должен состоять из двух букв.

Важно: разместите этот маршрут до основного, чтобы сначала обрабатывался контекст:

Route::get('/{alias?}', [ResourceController::class, 'index']);

Шаг 5. Контроллер ResourceController (опционально)

Добавим метод context в контроллер и сразу сделаем рефакторинг, чтобы убрать дублирования кода:

class ResourceController extends Controller
{
    public $classKey = \modResource::class;

    public function index(string $alias = '')
    {
        $resource = $this->getResource($alias);
        $this->modx->resource = updateResource($resource);

        $this->modx->config['site_url'] = $this->modx->getOption('site_url');
        $this->modx->config['cultureKey'] = $this->modx->getOption('cultureKey');
        $this->modx->context->set('key', $this->modx->getOption('default_context'));

        return response()->view('templates/base');
    }

    public function context(string $context, string $alias = '')
    {
        $resource = $this->getResource($alias);
        $this->modx->resource = updateResource($resource, $context);

        $this->modx->config['site_url'] = $this->modx->getOption('site_url') . "$context/";
        $this->modx->config['cultureKey'] = $context;
        $this->modx->context->set('key', $context);

        return response()->view('templates/base');
    }

    private function getResource(string $alias = '')
    {
        $where = [
            'published' => 1,
            'deleted' => 0,
        ];
        if (empty($alias)) {
            $where['id'] = $this->modx->getOption('site_start', null, 1, true);
        } else {
            $where['alias'] = $alias;
        }

        if (!$resource = $this->modx->getObject($this->classKey, $where)) {
            abort();
        }

        return $resource;
    }
}

Теперь маршрут /en/ работает и открывает главную страницу, но она пустая — для этого контекста ещё не добавлены блоки. Давайте это исправим.

Шаг 6. Работа с контентом

После включения pageblocks_context_aware, в интерфейсе блоков и таблиц появится выпадающий список контекстов:


Теперь можно:

• Копировать блоки с одного языка на другой
• Переводить их вручную или через ИИ

Шаг 7. Перевод ресурса

Переходим во вкладку «Переводы», добавляем нужные языки и, при необходимости, активируем автоперевод полей:

Заключение

Готово! PageBlocks берёт на себя всю сложную работу по мультиязычности:

• Учитывает текущий язык во всех сниппетах
• Сниппеты pbMenu и pbResources возвращают переведённые ресурсы
• Вам остаётся лишь настроить языки и перевести контент

Field::make('title')->label('Заголовок')