- Главная
- Документация
- Ваш первый сайт
Ваш первый сайт
От пустой установки до передачи сайта владельцу. Команды выполняются из корневой директории сайта, 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.
- Разместите вашу копию в
private/energineна хостинге: закоммитьте изменения и клонируйте собственный репозиторий либо скопируйте папку безconfigs/system.config.*.php,tests/local.phpиtools/tailwindcss. - Выполните шаги из раздела Установка, начиная со шага 2, в пустую базу данных: установщик запишет конфигурацию для хостинга и создаст администратора.
- Загрузите поверх неё дамп вашей рабочей базы данных — структура таблиц совпадает; администраторы и пароли теперь будут взяты из вашей рабочей копии. Адрес сайта хранится только в конфигурации и никогда — в базе данных.
- Скопируйте
web/uploads/; владельцем этих файлов должен быть пользователь сайта. - Выполните
php index.php setup linker.