Налаштування контекстів MODX для мультисайтовості

Налаштування контекстів MODX для мультисайтовості

Вам потрібно запустити три сайти — російський, англійський та білоруський. Кожен зі своїм доменом, шаблонами та контентом. Зазвичай це означає три установки MODX: потрійні оновлення, бекапи, налаштування. Контексти MODX вирішують цю проблему: один двигун, різні сайти. Налаштування займає 2-3 дні замість тижня на три установки. Згідно з документацією MODX, контексти забезпечують повну ізоляцію без дублювання ядра. Наші інженери з 5-річним досвідом гарантують стабільну роботу мультисайтової структури. Понад 50 успішних проєктів на MODX. Середня економія на підтримці — 30%, на хостингу — до 40%.

Що таке контексти і для чого вони потрібні?

Контексти — це ізольовані середовища в межах однієї установки MODX. Кожен контекст має власні налаштування, кореневі ресурси, шаблони та навіть мовні параметри. Порівняйте з іншими підходами:

Налаштування контекстів у 3 рази швидше, ніж розгортання окремих установок. Економія на хостингу — до 40%, а витрати на підтримку скорочуються на 30% в середньому за нашими проєктами. Додатково ви отримуєте єдину точку входу для управління: оновлення MODX, плагіни та компоненти керуються централізовано.

Як налаштувати контексти: покрокове керівництво

Створення та параметри контексту

Система → Контексти → Створити → ключ en (тільки латиниця, короткий). Після створення налаштуйте параметри:

Ключ: en Ім'я: English Version Налаштування (Settings): base_url: /en/ site_url: https://yourdomain.com/en/ site_start: 55 (ID кореневого ресурсу) error_page: 56 default_template: 3 cultureKey: en locale: en_US.UTF-8 

Автоматичне перемикання за доменом

Плагін на подію OnHandleRequest перемикає контекст на основі HTTP_HOST або URI:

$host = $_SERVER['HTTP_HOST']; $uri = $_SERVER['REQUEST_URI']; $contextMap = [ 'ru.company.com' => 'ru', 'en.company.com' => 'en', 'by.company.com' => 'by', ]; if (isset($contextMap[$host])) { $contextKey = $contextMap[$host]; if ($modx->context->key !== $contextKey) { $modx->switchContext($contextKey); } return; } $prefixMap = ['/ru/' => 'ru', '/en/' => 'en', '/uk/' => 'uk']; foreach ($prefixMap as $prefix => $contextKey) { if (strpos($uri, $prefix) === 0) { if ($modx->context->key !== $contextKey) { $modx->switchContext($contextKey); } return; } } 

Конфігурація Nginx для піддоменів

server { listen 443 ssl http2; server_name ru.company.com en.company.com by.company.com; root /var/www/company.com; location ~ \.php$ { fastcgi_pass unix:/var/run/php/php8.3-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param HTTP_HOST $host; include fastcgi_params; } } 

Ресурси та крос-контекстні посилання

Кожен ресурс прив'язується до контексту через поле context_key. Для створення ресурсу в контексті en використовуйте:

$resource = $modx->newObject('modDocument'); $resource->set('pagetitle', 'About Us'); $resource->set('alias', 'about-us'); $resource->set('context_key', 'en'); $resource->set('template', 3); $resource->set('parent', 55); $resource->save(); 

Для крос-контекстних посилань вкажіть контекст: [[~42? &context=en]].

Синхронізація налаштувань

Системні налаштування мають пріоритет: Global > Context > Namespace. Контекстні налаштування перевизначають глобальні. Приклад отримання URL для поточного контексту:

$siteUrl = $modx->getOption('site_url'); 

Чому контексти вигідніші за окремі установки?

• Економія ресурсів: одна база даних, одне ядро.
• Єдина адмінка: управління всіма сайтами з одного інтерфейсу.
• Швидке розгортання: новий контекст налаштовується за годину.
• Легкі оновлення: оновлюєте MODX один раз.

Переконайтеся самі: зв'яжіться з нами для консультації. Наші інженери з 5-річним досвідом допоможуть оцінити ваш проєкт. Отримайте точну оцінку та план впровадження.

Які типові помилки виникають при налаштуванні контекстів?

Навіть досвідчені розробники допускають кілька промахів. Найчастіша — неправильна прив'язка кореневого ресурсу site_start. Якщо ресурс не належить контексту, MODX не зможе відобразити сайт. Друга проблема — відсутність плагіна перемикання: без нього всі домени ведуть на один контекст. Третя — конфлікт кешу: контексти використовують спільний кеш MODX, тому налаштування можуть перезаписуватися. Рішення — розділяти кеш за контекстом, увімкнувши опцію cache_context. Четверта — забувають налаштувати cultureKey для мультимовності, через що локалізація не працює. П'ята — помилки в Nginx: неправильна директива server_name або відсутність HTTP_HOST у fastcgi_param.

Ці нюанси ми враховуємо при налаштуванні під ключ.

Чек-лист налаштування контекстів

1. Створити контекст і задати параметри.
2. Прив'язати кореневий ресурс (site_start).
3. Налаштувати плагін перемикання (домен/префікс).
4. Оновити Nginx (передача HTTP_HOST).
5. Перевірити крос-контекстні посилання.
6. Протестувати перемикання.

Що входить у налаштування під ключ

• Аудит поточної структури сайту.
• Створення контекстів і прив'язка доменів.
• Розробка плагіна перемикання.
• Конфігурація сервера (Nginx/Apache).
• Перенесення контенту в нові контексти.
• Документація та навчання адміністраторів.
• Технічна підтримка на 2 тижні.

Замовте налаштування контекстів MODX під ключ. Зв'яжіться з нами — обговоримо деталі вашого проєкту. Отримайте готове рішення за 2-3 дні з гарантією працездатності.