Ваш перший сайт

Від порожньої інсталяції до сайту, переданого замовнику. Команди виконуються з кореневої директорії документів сайту, 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 пікселів і сторінки на відсутність помилок 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.