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