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

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

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

• 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. Вывод переключателя языков на сайте

<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. Настройка маршрутов (опционально)

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

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

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

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;
    }
}

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

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

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

Заключение

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