Ваш первый сайт

От пустой установки до передачи сайта владельцу. Команды выполняются из корневой директории сайта, web/, от имени пользователя сайта.

1. Установка без демо-контента

Выполните установку, как описано в разделе Установка, пропустив команду setup demo: клиентский сайт начинается с чистого листа. В нём уже есть главная страница, вход, регистрация, восстановление пароля и панель управления.

2. Создание страниц по шаблонам

Войдите в систему по адресу /login/ и откройте «Управление структурой» по адресу /admin/structure/.

  • Главная страница: выберите её, нажмите «Редактировать» и выберите «Лендинг» в «Содержимое страницы». Её секции: первый экран, услуги, отзывы, призыв к действию и контакты.
  • Услуга: нажмите «Добавить» под главной страницей и выберите «Услуга»: первый экран, собственный текст страницы, цены, вопросы и ответы, призыв к действию.
  • Контакты: добавьте страницу с шаблоном «Контакты»: текст страницы и секция контактов.
  • Другие страницы могут использовать «Текстовая страница», «Список подразделов» или «Карта сайта».

Создать собственный шаблон можно одной командой:

php index.php setup page --name=about --title="О компании" --sections=hero,services,reviews,cta

Она создаёт файл site/modules/main/templates/content/about.content.xml и название шаблона для списка (--title на русском, --title-ua на украинском), загружает название в базу данных и запускает setup linker, благодаря чему шаблон сразу появляется в «Содержимое страницы». См. Шаблоны страниц и секции.

3. Написание текстов для секций

Владелец включает «Режим редактирования» на панели администратора и пишет текст прямо на странице. Пустая секция на сайте не отображается; в режиме редактирования в ней показан текст-образец для замены. Изображение вставляется кнопкой вставки картинки в редакторе; изображение в первом экране становится его фоном.

Здесь нет форм обратной связи и вложений: контакты оформляются ссылками, а галерея — это изображения в тексте.

4. Покажите владельцу возможности сайта

  • Битые ссылки. «Битые ссылки» по адресу /admin/links/ выводят список ссылок на отсутствующие или отключённые страницы и на отсутствующие файлы; команда php index.php setup checklinks делает то же самое в консоли и завершается с кодом 1 при их обнаружении. На сайте битая ссылка отображается обычным текстом, а администратор видит её выделенной.
  • Справка. Знак ? в правом верхнем углу окна панели управления объясняет текущий экран.
  • История текста. В режиме редактирования «История» показывает 20 последних версий текста на текущем языке и позволяет восстановить любую из них.
  • Подготовка языка. В редакторе языков снимите отметку «Открыт посетителям»: посетители будут получать 404 для этого языка, пока он не будет готов. Основной язык закрыть нельзя.
  • Руководство для владельца. Команда php index.php setup manual --out=/home/me/manual.md формирует краткое руководство для владельца с подставленными адресами сайта; передайте его вместе с доступами. Не храните этот файл в web/.

5. Ваши цвета и шрифт

Цвета, шрифт, радиус скругления углов и ширина страницы — это переменные в одном файле, site/modules/main/stylesheets/theme.css: светлая тема в :root, тёмная — в @media (prefers-color-scheme: dark). Изменяйте значения, сохраняя имена переменных. Затем пересоберите стили:

bash ../private/energine/tools/get-tailwind.sh   # once per machine: downloads the Tailwind CSS binary
php index.php setup css

Соблюдайте контрастность текста и кнопок не менее 4.5:1 в обеих темах. См. Тема оформления.

6. Проверка

php index.php setup check

Она выводит строки OK, WARN и FAIL, завершается с кодом 1 в случае ошибок и ничего не изменяет.

  • FAIL: включён режим отладки, не указан адрес сайта, статический web/robots.txt, демонстрационные пользователи, включённая страница без названия на открытом языке, битые ссылки, непереведённые строки интерфейса, отсутствует расширение GD.
  • WARN: язык в процессе подготовки, страница без текста, NOINDEX на обычной странице, нет SMTP-сервера, оставлен адрес отправителя из шаблона.

Браузерные аудиты репозитория проверяют контрастность в обеих темах, ширину от 320 px и отсутствие ошибок JavaScript на страницах; для них требуются Node, Playwright и Chrome — см. tests/README.md в репозитории.

7. Перенос на хостинг

Ваша тема, шаблоны и строки интерфейса находятся в директории site/ репозитория, а скомпилированная таблица стилей также зафиксирована в git: хостингу не требуются ни Tailwind, ни Node, но ему нужна ваша копия репозитория, а не чистый клон Energine Simple.

  1. Разместите вашу копию в private/energine на хостинге: закоммитьте изменения и клонируйте собственный репозиторий либо скопируйте папку без configs/system.config.*.php, tests/local.php и tools/tailwindcss.
  2. Выполните шаги из раздела Установка, начиная со шага 2, в пустую базу данных: установщик запишет конфигурацию для хостинга и создаст администратора.
  3. Загрузите поверх неё дамп вашей рабочей базы данных — структура таблиц совпадает; администраторы и пароли теперь будут взяты из вашей рабочей копии. Адрес сайта хранится только в конфигурации и никогда — в базе данных.
  4. Скопируйте web/uploads/; владельцем этих файлов должен быть пользователь сайта.
  5. Выполните php index.php setup linker.