Создание мультисайта на MODX REVO

Лучше поздно, чем никогда. Как и обещал https://modx.pro/help/5194/ пишу про создание мультисайта на MODX REVO. Выкладываю в блог Готовые решения, т.к. в статье есть чуть-чуть кода.

Смысл всей затеи — упростить поддержку сайтов.

Под поддержкой понимаются любые действия связанные с работой сайта:
— размещение контента
— технические доработки сайта (программирование, верстка)
— консультирование модераторов, сеошников и т.д.
— бэкапы и восстановление информации

Кроме того, для упрощения работы необходимо внедрить стандарты, чтобы упростить рутину. Звучит громко, но на самом деле все просто — по «узким» моментам единожды принимаем какое-то решение и дальше просто поступаем по образцу, чтобы не тратить время на изобретение велосипедов. По принятому решению пишем короткую заметку в Евернот, чтобы потом когда понадобится можно было быстро найти, на чем основывалось решение.

В таких «стандартах» у меня:
— ресайз картинок с примерами кода
— настройки галереи fancybox с примерами кода
— создание файловых архивов
— названия чанков, например почти везде у меня есть чанки HEADER.site1, FOOTER.site1, ASIDE.site1 (в названии используем название контекста).
— и т.д. и т.п.

Т.е. единожды продумываем тонкости и решаем, что будем делать именно так и никак иначе. В дальнейшем это позволит избежать бардака и существенно ускорит процесс переноса существующих сайтов в мультисайт или разработку новых сайтов.

Плюсы и особенности «мультисайта»:

• у админа единый интерфейс управления всеми сайтами
• модераторы заходят в админки своих сайтов по своим адресам, т.е. site1.ru/manager/, site2.ru/manager/ и т.д. и со своей настроенной админкой
• похожий интерфейс бекэнда у все сайтов, т.е. можно отвечать на вопросы модераторов и сеошников просто по памяти без компьютера и интернета под рукой.
• меньше времени на обновление программного обеспечения сайтов, т.к. один раз для мультисайта, а не для каждого отдельно.
• во время переноса, некоторые сайты были переверстаны на bootstrap, соответственно потом, в случае доработок сильно экономим на верстке + сайт получается адаптированным для смартфонов (гугль утверждает, что это важно).

Недостатки «мультисайта», или то, на что «сходу» не нашел решения, может быть кто-то подскажет:

• в редакторе TinyMCE при вставке гиперссылки из редактора отображаются/ищутся все ресурсы мультисайта, т.е. но ограничивается текущим контекстом.
• не нашел как спрятать шаблоны не относящиеся к текущему контексту.

Как оказалось, самое сложное в мультисайте — перенести контент. На текущий момент до сих пор не все сайты перенесены. Потому-что, раз «уж взялись», и чтобы «два раза не вставать», то и реорганизовать контент, исправить какие-то ошибки (смысловые, интерфейсные, юзабилити, грамматические, SEO и т.д. и т.п.), отказаться от «форума» в пользу «тикетов», подправить верстку, уменьшить количество сущностей (шаблонов, чанков и т.д.). А это все происходит долго.

Важный момент, на который нужно обратить внимание по каждому сайту:
Не навредить SEO! Поскольку «вылететь» из поисковой выдачи Яндекса и Гугла — это плохо. Один из сайтов «вылетел», пришлось в срочном порядке восстанавливать все адреса + дополнительно настраивать контекстную рекламу, поскольку у владельца сайта это был основной канал коммуникации с клиентами.

Про мультисайты на modx не так много статей, когда я все это задумал, мне казалось, что или все слишком очевидно или просто особо этим никто не занимается.
При поиске через гугль нашел это:
_http://www.wiseguydigital.com/blog/2010/how-to-build-multi-site-modx-installations
_http://modx.ws/blog/uroki-modx-revolution/multisajt-na-modx-revolution.html
_http://www.belafontecode.com/modx-revolution-hosting-multiple-domains/

— в статьях описано примерно одно и тоже.

Как сделал я:

1. Сайты на виртуальном сервере, все домены ссылаются в одну папку, таким образом прекрасно работает плагин от Василия Наумкина bezumkin.ru/sections/tips_and_tricks/2439/, который переадресует каждый домен на свой контекст.
upd. Переадресация идет, если имя домена совпадает с настройкой контекста http_host.



2. Соответственно для каждого домена сделан отдельный контекст. В настройках контекста прописаны обязательные настройки:
site_start – ID главной страницы сайта (этот параметр написан ввиде цифры в скобках в конце каждого документа в меню Resources)
base_url – установите этот параметр “/” (без кавычек)
http_host – укажите в этом параметре домен вашего дополнительного сайта “имя.ru” (если речь идет о домейне третьего уровня, то в этом параметре необходимо указать имя.имя.ru)
site_url – укажите в этом параметре полный адрес вашего дополнительного сайта “http://имя.ru/” (можете указать с www)
— без них работать не будет.

Плюс все нужные индивидуальные настройки для каждого домена, напрмер «страница 404», «статус сайта», «использовать вложенные url». И настройки почты. Я чаще всего использую ЯндексПочту для домена, все прекрасно работает. Для каждого домена задаем отдельные почтовые ящики.

3. По настройке htaccess с «www» и «без www» создал топик в разделе Работа modx.pro/work/5786-configure-htaccess-to-multisite/. Помог Василий Наумкин.
Те записи, которые есть в примере файла htaccess дистрибутива modx для доменов и с «www» и «без www» не работают, сайт пишет про циклическую ошибку (комент Ильи Уткина в вышеуказанном топике про работу).

Для сайтов «с www» нужно прописать отдельное правило для этого сайта. А там, где ниже идёт правило для редиректа всех www на без-www нужно добавить условие не редиректить тот сайт.

Итого:

# Редирект site1.ru -> www.site1.ru
RewriteCond %{HTTP_HOST}    ^site1.ru\.ru [NC]
RewriteRule ^/?(.*)         http://www.site1.ru/$1 [R=301,L]
 
# Редирект всех остальных www -> non-www, кроме site1.ru
RewriteCond %{HTTP_HOST}    !^www\.site1\.ru [NC]
RewriteCond %{HTTP_HOST}    ^www\.(.*)$ [NC]
RewriteRule ^(.*)$          http://%1/$1 [R=301,L]

4. Сделал отдельный каталог со спецдиректориями по названию доменов для их индивидуальных файлов, изображений, шаблонов и т.д.




Путь от корня мультисайта индивидуально папки получился «s/site1/», «s/site2/» и т.д. для каждого сайта. В эти папки положил важные для SEO подпапки от каждого сайта, например:
«s/site1/assets/image»
«s/site1/assets/gallery»
«s/site1/assets/files»
«s/site1/assets/cashe»

Папки image, gallery, files и т.д. — из Modx Evo, там хранится проиндексированный поисковиками контент, но для того, чтобы этот контент открывался по прежнему адресу нужно из url убрать адрес спецдиректории для каждого домена, например «s/site1/».

5. Для того, чтобы вырезать из URL пути «s/site1/», «s/site2/» Василий Наумкин написал плагин и привел пример записи в htacess.

<?php
if ($modx->event->name != 'OnWebPagePrerender') {continue;}
$urlCut = $modx->getOption('urlCut');
if (empty($urlCut)) {
    return;
}
$urls = array_map('trim', explode(',', $urlCut));

foreach ($urls as $url) {
    $modx->resource->_output = preg_replace("#(/|){$url}#i", '/', $modx->resource->_output);
}

Он работает для всех контекстов и берёт список вырезаемых url из настройки контекст urlCut. Т.е. если надо вырезать кусок из url «s/site1/», то в настройках контекста добавляем запись «urlCut».




Затем нужно научить Apache2 загружать такие файлы из спецдиректории, прописываем в htaccess:

# Работаем только для site1 и только для ненайденных файлов c указанными расширениями
RewriteCond %{HTTP_HOST}    ^www\.site1\.ru [NC]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
 
RewriteRule ^(.+)\.(png|gif|jpg|jpeg|xls|doc|pdf)$ /s/med55/$0 [L,NC]

Соответственно для каждого домена нужно прописать похожее правило.

Мы сохранили прежние пути к проиндексированным в поисковых системах файлам, хотя физически она находятся в отдельных спецдиректориях. Таким образом не вредим SEO.

Для примера, картинка у нас физически находится по адресу:
site1.ru/s/site1/assets/image/image.jpg

Но открывается она по URL
site1.ru/assets/image/image.jpg

Т.е. после добавления сайта в мультисайт адреса изображений остались прежними.

По специфичным моментам настройки каждого отдельного домена в мультисайте вроде все.

Тонкости:

Я создал один контекст для образца, со всеми индивидуальными настройками которые мне нужны для каждого домена и потом просто копировал его, чтобы каждый раз не прописывать отдельные настройки для каждого контекста. Кроме того в этом образцовом контексте созданы ресурсы 404, sitemap и т.д., они тоже копируются при копировании контекста — это удобно.

Для переноса, в мультисайте настраивается тестовый домен, контент существующего сайта переносился «вручную». После того, как все перенесли и убедились, что все ок, в настройках контекста меняли имя домена на нужное и только потом переадресовывали домен на папку мультисайта.

Настройка прав и админки для юзеров с урезанными правами — стандартная, никаких особенностей, связанных с мультисайтом там нет. Просто настраиваем нужный доступ к контексту и юзер открывает админку по адресу его сайта «site1/manager/» и в дереве ресурсов отображается только его контекст.

Для каждого отдельного контекста создана отдельная категория, соответственно все чанки, шаблоны, доп.поля, плагины складываем туда, чтобы «не в одну кучу». При необходимости, для удобства разработки, можно настроить отдельного юзера с доступом в эту категорию, чтобы другие категории не мешались. Я так не делал, поскольку во многих случаях просто копировал код с «соседнего» сайта, например чанк вывода новости со всеми прописанными полями (заголовок и длинный заголовок, ресайз картинок, альты и тайтлы к картинке, вывод дат и т.д.). Это и упрощает разработку и позволяет не забыть важные моменты, т.е. не надо каждый раз вспоминать «что же нужно прописать».

Для удобства, в названиях чанков, шаблонов, доп.полей и т.д. используем названия контекста, чтобы было понятно, к чему он относится. Выше я писал про HEADER.site1.

Настроил ежедневный бэкап сайта по крону. Но своим клиентам раз в две недели автоматически рассылаю письма, что «создан полный бэкап сайта».

Неочевидный для меня момент — настройка шаблона тикетов по умолчанию, сначала пробовал вставлять этот шаблон в настройках контекста, ничего не получилось. В итоге настройка нашлась непосредственно в разделе с тикетами.




Стандартные компоненты, сниппеты и плагины прекрасно работают в мультисайте.
Для настройки меню сайта от корня достаточно указать необходимый контекст [[pdoMenu? &context=`site1`]]

Выводы:
Вставлять в мультисайт какие-то сложные сайты (интернет-магазины и т.д.) наверно не стоит.

Но что-то проще:
— лендинги;
— сайты без какого-либо сложного функционала, например сайт организации с лентой новостей, каталогом товаров и услуг — можно и по временным затратам встроить в мультисайт проще чем создать отдельный новый сайт + сильно экономим время на обслуживании.

Новые сайты я однозначно буду запускать в мультисайте. Если вдруг их нужно быть вынести в отдельный сайт — это очень просто, копируем полностью сайт, удаляем оттуда ненужные контексты и папки категорий.
Разработка сильно упростилась, поскольку все лежит в одном месте и можно копировать код кусками с работающих сайтов.

Наверняка я что-то упустил, если есть какие-то вопросы, спрашивайте.

onclick="yaCounter[[++[[*context_key]].yaKey]].reachGoal('something'); return true;"

<VirtualHost *:80>
  DocumentRoot /home/y/sssr/основной-домен.ru/public_html
  ServerName новый-домен.ru
  ServerAlias www.новый-домен.ru
  SetEnvIf X-Forwarded-Proto https HTTPS=on
  TimeOut 300
  ScriptAlias /cgi-bin/ /home/y/sssr/основной-домен.ru/public_html/cgi-bin/
  <Directory /home/y/sssr/основной-домен.ru>
    Options All -Indexes
    AllowOverride All
  </Directory>
</VirtualHost>

if (!defined('MODX_HTTP_HOST')) {
    if(defined('PHP_SAPI') && (PHP_SAPI == "cli" || PHP_SAPI == "embed")) {
        $http_host='основной-домен.ru';
        define('MODX_HTTP_HOST', $http_host);
    } else {
        $http_host= array_key_exists('HTTP_HOST', $_SERVER) ? $_SERVER['HTTP_HOST'] : 'основной-домен.ru';
        if ($_SERVER['SERVER_PORT'] != 80) {
            $http_host= str_replace(':' . $_SERVER['SERVER_PORT'], '', $http_host); // remove port from HTTP_HOST
        }
        $http_host .= ($_SERVER['SERVER_PORT'] == 80 || $isSecureRequest) ? '' : ':' . $_SERVER['SERVER_PORT'];
        define('MODX_HTTP_HOST', $http_host);
    }
}

<img src="assets/template/images/logo [[++site_name]].png" alt="" />

RewriteCond %{HTTP_HOST} .
RewriteCond %{HTTP_HOST} !^сайт\.ru [NC]
RewriteRule (.*) https://сайт.ru/$1 [R=301,L]

# Редирект site1.ru -> www.site1.ru
RewriteCond %{HTTP_HOST}    ^site1.ru\.ru [NC]
RewriteRule ^/?(.*)         http://www.site1.ru/$1 [R=301,L]
 
# Редирект всех остальных www -> non-www, кроме site1.ru
RewriteCond %{HTTP_HOST}    !^www\.site1\.ru [NC]
RewriteCond %{HTTP_HOST}    ^www\.(.*)$ [NC]
RewriteRule ^(.*)$          http://%1/$1 [R=301,L]

RewriteCond %{HTTP_HOST}    ^www\.sub.domen-1\.ru [NC]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)\.(ico|png|gif|jpg|jpeg|pdf|css|js)$ /site/sub.domen-1.ru/$0 [L,NC]

if ($host = "www.sub.domen-1.ru"){ rewrite ^/(.+)\.(ico|png|gif|jpg|jpeg|pdf|css|js)$ /site/sub.domen-1/$1 break;}

RewriteCond %{HTTP_HOST} .
RewriteCond %{HTTP_HOST} !^domen\.ru [NC]
RewriteRule (.*) https://domen.ru/$1 [R=301,L]

RewriteCond %{SERVER_PORT} !^443$ 
RewriteRule ^(.*)$ https://domen.ru/$1 [R=301,L]

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?q=$1 [L,QSA]