Перенос данных с MaxSite CMS

Поскольку MaxSite CMS работает на базе MySQL, то нужно сделать трансфер данных в текстовые файлы, которые понимает Albireo CMS.

Общая схема трансфера

В зависимости от размера сайта на MaxSite CMS, будет зависеть и подход к переносу данных.

Если у вас мало записей, скажем 10 шт., то самым простым вариантом будет просто скопировать тексты записей и файлы изображений из MaxSite CMS в файлы Albireo CMS. В этом случае не требуются никакие дополнительные инструменты.

Если у вас много записей, то вы можете воспользоваться специальным скриптом albireo-ex, который автоматически сохранит все записи сайта в текстовые php-файлы, которые понимает Albireo CMS. Изображения будут автоматически конвертированы в формат webp. Комментарии будут сразу сохранены в готовую базу SQLite в формате Albireo CMS.

Сам трансфер — это просто перенос данных из одного формата в другой. Исходный сайт это никак не затрагивает.

Я рекомендую начать перенос именно с трансфера данных, и лишь после него подумать как перенести свой дизайн в Albireo CMS.

Трансфер albireo-ex

Для трансфера данных загрузите предлагаемый файл albireo-ex.php.txt себе на компьютер. Переименуйте его в albireo-ex.php — это type-файл для MaxSite CMS.

Файл настроен на типовую конвертацию данных, но при необходимости вы можете подредактировать его под особенности своего сайта.

Разместите файл на сервере: application/maxsite/templates/ВАШ-ШАБЛОН/type/albireo-ex/albireo-ex.php. После этого наберите в браузере ваш-сайт/albireo-ex — это сразу запустит процесс конвертации данных.

Вам нужно быть в залогиненном состоянии, чтобы скрипт сработал.

Готовые файлы для Albireo CMS будут размещены в каталоге uploads/albireo-ex. Страницы автоматически будут рассортированы по годам публикации. Static-страницы будут размещены в подкаталоге static. Если страница в статусе черновика, то её имя будет начинаться с draft-.

Изображения будут размещены в едином каталоге uploads/albireo-ex/uploads/pages в формате webp. Внутри страниц все ссылки будут автоматически заменены на адрес SITE_URL (то есть Albireo CMS будет его формировать автоматически).

Комментарии будут размещены в одном файле SQLite: comments.sqlite — в формате для Albireo CMS.

Проверка данных

Из-за того, что сайты могут иметь особенности, трансфер может не всегда корректно преобразовать исходный текст в красивый Albireo CMS. Поэтому проверьте итоговые файлы на то, как именно произошло форматирование данных. Теоретически всё должно быть выполнено верно, но если у вас, например используется какой-то шорткод, или какие-то особые html-вставки, то это может привести к неверному форматированию.

По умолчанию Albireo CMS использует парсер TextSimple и будет лучше, если итоговый текст также будет ему соответствовать. Если есть html-вставки, то их можно оставить, поскольку парсер будет с ними корректно работать (обычно это так).

Если нужно добавить какие-то правила в albireo-ex.php, то делайте это прямо в файле. После чего ещё раз в браузере запустите трансфер — файлы будут заменены.

После первого конвертирования, вы может отключить обработку изображений и комментариев с помощью соответствующих php-переменных. Это ускорит работу скрипта и снимет лишнюю нагрузку с сервера.

Таким образом, постепенно, при необходимости, вы можете подкорректировать файл albireo-ex.php так, чтобы он автоматически выполнил все необходимые замены.

Если есть трудности, вы можете попросить любой ИИ, чтобы он помог это сделать. Обычно для ИИ это не представляет сложностей.

Перенос в Albireo CMS

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

В Albireo CMS файлы страниц располагаются в website/pages — просто скопируйте в него подкаталоги с файлами.

Изображения располагаются в website/uploads — у вас уже есть готовые файлы.

Файл комментариев разместите в website/service/storage. Если там уже есть файл, просто замените его.

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

Lite-версия Albireo CMS

Возможно вам будет достаточно бесплатной lite-версии Albireo CMS хотя бы для начальной оценки и проверки работы сайта. В отличие от полной версии, в lite нет админ-панели и нет комментариев. Но в остальном всё работает идентично. Поэтому пока не уверены, что хотите покупать полную версию Albireo CMS, то закажите lite-версию и проверьте как работает новый сайт.

Если много страниц

Если у вас на старом сайте много страниц, например 5000+, то скорее всего большая их часть старые записи. Есть несколько подходов для того, чтобы упростить работу Albireo CMS с большим количеством файлов.

Первый — вы можете указать подкаталоги со старыми файлами как frozen — это ускорит работу кэша.

Второй — если старых записей много, то вы можете выделить их в отдельный сайт, поскольку Albireo CMS поддерживает мультисайтинг. Делается это очень просто. Достаточно скопировать website под другим именем, например older, archive, page и т.п. В конфигурации также прописать по умолчанию frozen. Таким образом, когда будет обращение к старым записям, они будут браться из редко обновляемого кэша. Основной сайт будет работать с уже небольшим количеством файлов.

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

Большое количество файлов — это не проблема Albireo CMS, а физические ограничение вашего диска на сервере. Обычно на хостингах используют быстрые SSD, что позволяет использовать 10к+ файлов записей без каких-либо проблем. Но если сервер слабый (например ваш ноутбук), то вы заметите, что скорость создания кэша (после его сброса) будет в несколько раз выше (например 1..5 секунд) — это много для рабочего сайта, но некритично для локального. Поэтому, чтобы избежать трудностей, лучше разделить файлы по разным подсайтам или использовать frozen для старых записей.

Перенос дизайна

После того, как записи перенесены и проверены на дефолтном выводе Albireo CMS, можно подумать о том, как следует переносить дизайн старого сайта.

Системы разные и у них немного разный подход к построению шаблона (см. документацию на этом сайте). Но, если у вас основа Default-шаблон MaxSite CMS, то скорее всего он использует тот же «стек» в виде Berry CSS и AlpineJS. Это значит, что вам не придётся привыкать к новым css-классам.

Также вам следует знать, что Albireo CMS использует подход, близкий к шаблону MF. В частности почти все блоки и компоненты MF по умолчанию доступны в Albireo CMS «из коробки». Поэтому, прежде, чем переписывать html/css/js-код старого шаблона, попробуйте подобрать шапки, подвалы, модульные сетки, которые уже есть в Albireo CMS. Подберите те, что наиболее близкие к тому, что вам нужно получить в итоге.

Только после этого скопируйте исходные файлы в my-каталог и внесите точечные изменения. В отличие от MaxSite CMS, в Albireo CMS изменения шаблона происходят на уровне отдельных файлов, без изменения исходных.

Таким образом, ваш новый шаблон может состоять всего из нескольких файлов my-каталога.

Главная страница

Настраивайте главную страницу уже после того, как настроите вывод одиночных записей. Главная страница может иметь особый порядок вывода, но важно понять, что в MaxSite CMS получение блоков главной происходило через юниты или type_foreach-файлы, а в Albireo CMS записи получаются прямо в файле home.php, либо через modules/home.

В целом же настройка главной будет сводиться к получению записей блоков (если, конечно они есть) и настройке tpl-файла под нужный дизайн. Этот подход намного проще, чем в MaxSite CMS, который «раскидывает» вывод на множество разных файлов.

Функциональность

Albireo CMS по функциональности примерно равна MaxSite CMS, с той разницей, что теперь многие вещи — это часть системы. Для неё не нужно использовать плагины или подключать особые файлы шаблона.

Большинство задач в Albireo CMS решается через поля страниц. Полей очень много, поэтому используйте эту документацию, чтобы понять их назначение. В MaxSite CMS требовалось немало ухищрений, чтобы подключить php/html/css/js-код, но Albireo CMS это делается элементарно через простые поля.

Поэтому, если вдруг вам не хватает старой функциональности, то попробуйте её сформулировать по новому.

Использование ИИ

Современные модели ИИ уже неплохо понимают устройство Albireo CMS, Berry CSS и AlpineJS. Указывайте ссылки на документацию, чтобы ИИ получил корректный контекст. Для Berry CSS есть уже готовый обучающий промпт для ИИ — используйте его — это сократит ошибки ИИ.

Для того, чтобы обучить ИИ работе с Albireo CMS, отправьте ему ссылку: https://maxsite.org/albireo/llms.txt — это стандартный файл, который понимает любой ИИ.