Руководство для владельцев сайтов

Как установить CMS ARGELIT на хостинг и вести сайт: страницы, меню, формы, почта, SEO, резервные копии и обновления. Программировать для этого не нужно. Если вы делаете темы и плагины — вам в документацию для разработчиков.

Установка

Что нужно хостингу

  • PHP 8.3 или новее с расширениями pdo_mysql, mbstring, openssl, fileinfo, gd, tokenizer, ctype, dom; для резервных копий и обновлений — ещё zip и sodium.
  • База MySQL 5.7+ или MariaDB 10.3+.
  • Apache с обработкой файлов .htaccess (есть почти на любом хостинге) или Nginx.

Подойдёт большинство хостингов: Beget, Timeweb, REG.RU, Sprinthost и другие. Мастер установки сам проверит PHP и расширения и подскажет, что исправить.

По шагам

  1. Сайт. В панели хостинга создайте сайт для домена или поддомена (site.ru, blog.site.ru) и выберите для него PHP 8.3 или новее. В подпапку (site.ru/cms) CMS не ставится.
  2. База. Там же создайте пустую базу MySQL. Запишите имя базы, имя пользователя и пароль. Сервер базы на обычном хостинге — localhost.
  3. Файлы. Скачайте архив на cms.argelit.com и загрузите содержимое папки cms-argelit в корень сайта (например, в public_html) через файловый менеджер хостинга или по FTP. Удобнее загрузить сам архив и распаковать его прямо в панели хостинга.
  4. Мастер установки. Откройте адрес сайта. Мастер проверит хостинг, спросит данные базы, название сайта, ваш email и пароль администратора.
  5. Готово. Админка открывается по адресу /admin.

Пройдите установку сразу после загрузки файлов: пока CMS не установлена, мастер открыт любому посетителю. Если база находится на другом сервере (не localhost), мастер попросит подтвердить, что сайт ваш: откройте в папке сайта файл install-code.php и впишите код из него. После установки файл удалится сам.

Корень сайта

Сайт работает из папки public. Если хостинг позволяет выбрать корневую папку сайта, укажите public — это лучший вариант. Если нет — ничего делать не нужно: файл .htaccess в корне сам направит посетителей в public и закроет служебные файлы.

Для Nginx укажите корнем папку public и передавайте все адреса в index.php:

root /путь/к/сайту/public;
index index.php;

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Если что-то пошло не так

Что видно Что сделать
«База не пустила: неверное имя пользователя или пароль» Скопируйте имя пользователя и пароль базы из панели хостинга ещё раз, без пробелов.
«Сервер базы не отвечает» На обычном хостинге сервер базы — localhost, порт — 3306. Точные данные есть в разделе баз в панели хостинга.
Белая страница или «Что-то пошло не так» Проверьте, что для сайта выбран PHP 8.3 или новее и включены нужные расширения. Подробности ошибки — в папке storage/logs.
Сайт открывается только по адресу /public Хостинг не выполняет .htaccess: укажите корнем сайта папку public в настройках сайта в панели хостинга.
Мастер просит код подтверждения Откройте файл install-code.php в папке сайта и впишите код из него.

Первые шаги

  • Настройки → Общие — название и описание сайта, часовой пояс, формат даты.
  • Страницы — сделайте «О компании», «Услуги», «Контакты». Страница собирается из блоков: абзацы, заголовки, картинки, обложка, карточки, вопросы и ответы, форма. Нажмите «Добавить блок» или «+» между блоками.
  • Внешний вид → Меню — какие страницы показывать в меню сайта и в каком порядке.
  • Настройки → Чтение — что показывать на главной (последние записи или выбранную страницу) и какая страница — политика конфиденциальности.
  • Записи — новости и статьи блога: они показываются лентой и разбиваются по рубрикам.

Как редактор бережёт текст

  • Сохранение без перезагрузки. «Сохранить черновик», «Опубликовать» и «Обновить» сохраняют запись, не перезагружая страницу: внизу появится сообщение, а под кнопками — время сохранения. Сохранить можно и клавишами Ctrl+S (на Mac — Cmd+S).
  • Автосохранение раз в минуту. Черновик сохраняется на сайте сам. У опубликованной записи правки сохраняются отдельно — посетители видят прежнюю версию, пока вы не нажмёте «Обновить». Если вы закрыли вкладку, не сохранив правки, при следующем открытии редактор предложит «Сравнить и восстановить».
  • Предпросмотр. Кнопка «Предпросмотр» («Предпросмотр изменений» у опубликованной записи) открывает запись в новой вкладке с несохранёнными правками заголовка и текста. Видите это только вы. Изображение записи, рубрики и SEO меняются на сайте после «Сохранить» или «Обновить».
  • Отмена удаления блока. Удалили блок по ошибке — нажмите «Отменить» в сообщении внизу или Ctrl+Z (когда курсор не в тексте).
  • Черновик в браузере. Если вы долго писали, а сессия закончилась, после входа редактор предложит восстановить текст.

Формы и заявки

Формы → Добавить форму — поля (имя, телефон, email, сообщение, галочка согласия), кому отправлять письма и текст после отправки. Форму ставят на страницу блоком «Форма». Заявки хранятся в разделе Формы → Заявки, их можно выгрузить в таблицу Excel. От спама форма защищена сама, капча не нужна.

Галочка «Согласен на обработку персональных данных» станет ссылкой на политику конфиденциальности, когда вы выберете её страницу в Настройки → Чтение. По закону о персональных данных (152-ФЗ) такая ссылка нужна в каждой форме, где посетитель оставляет имя, телефон или email.

Почта

Чтобы заявки приходили на почту, откройте Настройки → Почта и выберите способ отправки:

  • Почтовый ящик через SMTP — надёжнее всего. Есть готовые настройки для Яндекса, Mail.ru, Gmail, Beget и Timeweb. Для Яндекса, Mail.ru и Gmail нужен пароль приложения, а не обычный пароль от почты — его создают в настройках безопасности почтового ящика.
  • Почта хостинга (sendmail) — работает не на всех хостингах.

Кнопка «Отправить тестовое письмо» сразу покажет, работает ли почта. Пока почта не настроена, заявки всё равно сохраняются в админке.

SEO

  • В редакторе каждой страницы есть блок «SEO»: заголовок и описание для поисковиков, картинка для превью ссылки, «не показывать в поисковиках».
  • Настройки → SEO — картинка для соцсетей по умолчанию, коды подтверждения Яндекс.Вебмастера и Google Search Console, код счётчиков (например, Яндекс.Метрики). Если ставите счётчики, упомяните их в политике конфиденциальности.
  • Карта сайта (/sitemap.xml) и правила для поисковиков (/robots.txt) создаются сами.
  • RSS-лента записей — по адресу /feed (у каждой рубрики и метки своя: адрес рубрики + /feed). На неё подписываются читалки новостей и агрегаторы, например Яндекс. В Настройки → Чтение — сколько записей в ленте и что в ней показывать: полный текст или только отрывок.
  • Картинки на сайте загружаются в подходящем размере: телефону — уменьшенная копия, большому экрану — побольше. Ничего настраивать не нужно.
  • Пока сайт в разработке, отметьте в Настройки → Чтение «Попросить поисковые системы не индексировать сайт» — и не забудьте снять галочку при запуске.

Резервные копии и перенос сайта

Инструменты → Резервные копии — копия базы, загруженных файлов, плагинов и тем в один zip. Скачайте её и храните у себя. Из копии сайт восстанавливается кнопкой «Восстановить», а перед восстановлением CMS сама делает страховочную копию.

Перенос на другой хостинг: установите CMS на новом хостинге, загрузите туда копию («Загрузить копию») и восстановите сайт из неё.

Инструменты → Здоровье сайта подскажет, что стоит исправить на сервере и в настройках, и покажет сведения для поддержки хостинга.

Обновления

Когда выходит новая версия, у пункта Консоль появляется отметка, а в разделе Консоль → Обновления — кнопка «Обновить». Заменяются только файлы CMS: ваши страницы, загруженные файлы, плагины, темы и настройки остаются. Каждая версия подписана: сайт проверяет подпись и не установит архив, если его подменили. Перед обновлением на всякий случай сделайте резервную копию.

Пользователи и роли

Пользователи → Добавить нового — дайте доступ сотрудникам. Роли как в WordPress:

Роль Что может
Администратор всё: настройки, плагины, темы, пользователи
Редактор все записи и страницы, медиатека, заявки с форм
Автор свои записи и картинки
Участник пишет записи, но публикует их редактор
Подписчик только свой профиль

Если забыли пароль

На странице входа нажмите «Забыли пароль?». Если почта на сайте настроена, придёт письмо со ссылкой для смены пароля. Если нет — нажмите «Получить код в файле»: сайт запишет код в файл reset-password-code.php в папке сайта. Откройте его в файловом менеджере хостинга или по FTP и впишите код вместе с новым паролем. Код действует 30 минут.