CMS.SOCHI
Документация · Версия 8.3.0

Ваш сайт, по-вашему.

CMS.SOCHI управляет профессиональными сайтами: страницы, собранные блок за блоком, блог, виджеты, формы, медиа и меню на любом количестве языков, с простой администрацией и встроенной безопасностью. Расширения добавляют то, что нужно вашему бизнесу.

  • CMS.SOCHI 8.3.0
  • PHP 8.2 – 8.5
  • MySQL 5.7+ · MariaDB 10.3+
  • Адаптивный · Многоязычный · RTL
www.your-site.com
Главная страница сайта на CMS.SOCHI: слайдер и возможности
Та же главная страница на телефоне
Введение

Спасибо, что выбрали CMS.SOCHI

Это руководство проведёт вас от загрузки файлов до готового сайта, затем через каждый экран панели управления. Оно написано как для владельцев сайтов, так и для веб-разработчиков: для управления сайтом не нужно программировать, а последние главы — для тех, кто хочет пойти дальше.

CMS.SOCHI управляет самим сайтом: страницы, статьи, меню, виджеты, медиа, формы, языки, пользователи и электронная почта, с адаптивной темой. Её расширения добавляют целые функции без изменения её кода, как CMSbooking и SochiPansionat добавляют систему бронирования отелей, для нескольких отелей или для одного.

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

Основные возможности

Всё, что нужно сайту

То, что нужно профессиональному сайту, в одной панели управления, без необходимости искать плагины.

Просто управлять

Страницы, статьи, виджеты и слайды редактируются в одинаковых понятных формах, с вкладкой на каждый язык и черновиком, сохраняющимся по мере ввода.

Конструктор страниц

Создавайте страницу с контейнерами, колонками, текстами, изображениями, видео, кнопками и карточками, перетаскиванием, затем редактируйте каждый блок на месте.

Виджеты везде

Слайдер, баннеры, параллакс и видео фоны, сетки статей, отзывы, контактные данные: размещайте на каждой странице или на выбранных.

На всех языках

Каждая страница, статья, виджет, меню и электронное письмо на каждом языке сайта, включая справа-налево, с переключателем языка.

Формы без кода

Создавайте форму поле за полем, размещайте на любой странице с помощью шорткода, получайте ответы по электронной почте и храните их в панели управления.

Медиатека

Папки, изображения изменяются под каждый экран с более лёгкой копией WebP, и точка фокусировки каждого изображения сохраняется при кадрировании.

Находят поисковики

Чистые адреса, заголовки и описания, канонические и hreflang теги, карта сайта, и старые адреса перенаправляются при изменении.

Безопасность по умолчанию

Защищённые формы, строгие заголовки безопасности, современное хеширование паролей, ограничение попыток входа, баннер cookies с «Отклонить все».

Расширения

Модули, страницы, виджеты, настройки и запланированные задачи добавляются расширениями, которые устанавливаются и обновляются в один клик.

Ваш бренд

Ваш логотип и два цвета устанавливаются в настройках, и дочерняя тема для более глубоких изменений, которые обновления никогда не перезапишут.

Создано для телефонов

Каждая страница сайта и панели управления работает на телефоне и планшете.

Экран диагностики

PHP, база данных, сервер и запланированные задачи проверяются за вас, с отчётом для отправки в поддержку.

Для клиентов версии 7

Новое в версии 8

Версия 8 — это новое поколение CMS.SOCHI для PHP 8.2 до 8.5: усиленная, расширяемая и более простая в использовании каждый день. См. Обновление с версии 7 перед переносом сайта.

ОбластьВерсия 7Версия 8
ПлатформаPHP 7 и 8PHP 8.2 до 8.5, MySQL 8 и MariaDB, библиотеки установлены, Composer не нужен
Безопасность—Переписанные маршрутизаторы, подготовленные запросы, защита от поддельных запросов, заголовки безопасности, ограничение попыток входа, ошибки логируются, но никогда не показываются
Расширения—Страница Расширения: модули, страницы, виджеты, настройки, роли и запланированные задачи добавляются расширениями, с их обновлениями базы данных
КонтентСтраницы и статьиКонструктор страниц, конструктор форм, всплывающие окна, медиатека с папками и точками фокусировки, корзина, черновики сохраняются по мере ввода, блокировки редактирования
СайтFont Awesome, пример контента на lorem ipsumВиджеты в любой позиции, языки справа-налево, баннер cookies с «Отклонить все», страница политики конфиденциальности, иконки и фото с открытой лицензией, реальные примерные тексты
Панель управления—Меню по разделам, экран диагностики, списки с фильтрами по владельцу, семь языков панели управления
Перенос сайта—Импорт сайта версии 7 за несколько кликов: контент, аккаунты, медиа и настройки, с их адресами
Посмотрите онлайн

Демо-версия

Онлайн-демо работает на этой же версии с примерными текстами пакета. Его фото показаны только для предварительного просмотра и не включены: пакет поставляется со своими собственными примерными фото, под лицензией CC0.

Сайтcms.sochi.energy
Панель управленияcms.sochi.energy/admin
Входadmin / admin123

Панель управления демо доступна только для чтения, и то, что создают посетители (комментарии, сообщения), видно другим посетителям и удаляется каждую ночь. Не вводите реальные личные данные.

Начало работы

Требования

CMS.SOCHI работает на большинстве общих хостингов, VPS и управляемых серверов. После установки экран Диагностика проверяет каждый пункт ниже на вашем собственном сервере.

КомпонентНеобходимоРекомендуется
PHP8.2 до 8.58.3 или 8.4
Расширения PHPcurl, dom, fileinfo, gd, mbstring, openssl, pdo, pdo_mysqlintl, чтобы даты записывались на языке каждой страницы
База данныхMySQL 5.7 или MariaDB 10.3, с набором символов utf8mb4MySQL 8 или MariaDB 10.6 и новее
Веб-серверApache 2.4 с mod_rewrite и разрешёнными файлами .htaccess, или IIS с URL Rewrite (web.config включён)nginx перед Apache, как на Plesk и многих хостингах cPanel, работает как есть
Безопасное соединение—HTTPS на всём сайте (бесплатный сертификат от вашего хостинга)
Память PHP128 MB256 MB
Начало работы

Содержимое пакета

Основной файл, загруженный с CodeCanyon, содержит эту документацию и сайт, готовые к загрузке. PHP библиотеки уже установлены: вам не нужен Composer.

cms-sochi-energy-8.3.0/
├── documentation/            эта документация: откройте index.html
── upload/                   сайт: загрузите содержимое этой папки
    ├── admin/                панель управления (www.your-site.com/admin)
    ├── bin/                  командная строка: запланированные задачи и расширения
    ├── config/               конфигурация, записывается мастером установки
    ├── extensions/           расширения, которые вы добавляете
    ├── public/               публичные файлы: медиа, изображения бренда
    ├── setup/                мастер установки
    ├── templates/default/    тема сайта
    ├── vendor/               PHP библиотеки
    └── common/, core/, …     CMS.SOCHI
Начало работы

Установка

Выделите около пяти минут.

  1. Создайте базу данных

    В панели хостинга (MySQL Databases в cPanel, Databases в Plesk) создайте пустую базу данных с набором символов utf8mb4 и пользователя, имеющего все привилегии на неё. Сохраните её имя, пользователя, пароль и хост (часто localhost) под рукой.

  2. Загрузите файлы

    Загрузите содержимое папки upload/ в корневую папку вашего домена (часто public_html/ или httpdocs/), или в подпапку, такую как public_html/site/. Самый быстрый способ — загрузить zip через файловый менеджер вашего хостинга, распаковать его там, затем переместить содержимое upload/ на место. С FTP клиентом убедитесь, что скрытые файлы .htaccess также отправлены.

  3. Запустите мастер установки

    Откройте адрес вашего сайта: мастер запустится сам. Укажите название сайта, его публичный адрес (https://www.your-site.com, без слеша в конце), адрес электронной почты, который получает уведомления, логин и пароль администратора (не менее 12 символов), затем данные базы данных. Нажмите Установить.

    www.your-site.com
    Мастер установки с полями Общие и База данных

    Мастер записывает config/config.php и public/robots.txt: PHP должен иметь разрешение на запись в config/ и public/ во время работы, что верно для большинства хостингов.

  4. Войдите

    Нажмите Войти и войдите под учётной записью администратора: откроется панель управления, и ваш сайт готов стать вашим.

Сайт работает в подпапке и на поддомене: его базовый путь находится автоматически. Панель управления находится по адресу https://www.your-site.com/admin/.

После установки сайта мастер блокируется. Вы всё ещё можете удалить папку setup/ и удалить право записи на config/config.php, две хорошие привычки на рабочем сервере.

Начало работы

Примеры контента

Новый сайт не открывается на пустой странице: он показывает, что может каждый блок, на английском и французском, готовый быть заменён вашими собственными словами.

Главная страница

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

Страницы

Страница Возможности, созданная конструктором страниц, с четырьмя статьями; страница Контакты с формой и картой; Юридическая информация и Политика конфиденциальности для заполнения; блог, страница поиска и страница «Не найдено».

Фото под лицензией CC0 и видео в общественном достоянии: вы можете оставить их на своём сайте. Каждый образец редактируется или снимается с публикации как любой контент. Сайт с одним языком сохраняет английские тексты.

Начало работы

Чеклист запуска

Настройки для проверки перед открытием вашего сайта, в порядке, который экономит время.

  1. Общие настройки

    Настройки › Общие: название сайта, публичный URL сайта, часовой пояс, форматы даты и времени, языки (Включить иностранные языки) и шаблон.

    www.your-site.com/admin/module=settings
    Вкладка Общие настроек
  2. Контактные данные и электронная почта

    Настройки › Контакты: название, адрес, телефоны и электронная почта вашей компании, отображаемые в шапке, футере и странице контактов. Настройки › Настройки email: отправитель и SMTP сервер вашего почтового ящика для надёжной доставки.

  3. Ваш бренд

    Настройки › Оформление: логотип, логотип футера, баннер email, favicon и фирменные цвета. См. Брендинг и тема.

  4. Ваш контент

    Замените примерные тексты и фото, страница за страницей: главную страницу и её виджеты, страницу Возможности, статьи и футер.

  5. Ваши юридические страницы

    Страницы Юридическая информация и Политика конфиденциальности содержат типовые тексты: заполните passages между скобками.

  6. Проверка на роботов

    Создайте ключи reCAPTCHA на google.com/recaptcha и вставьте их в Настройки › Общие (Captcha: публичный ключ и секретный ключ): тогда контактная форма, формы и комментарии будут проверяться.

  7. Ваши пользователи

    Измените пароль администратора при необходимости и создайте учётную запись для каждого человека, который редактирует сайт, с правильной ролью (Пользователи и роли).

Для клиентов версии 7

Обновление с версии 7

Версия 8 — это новое поколение: её база данных имеет новые таблицы и столбцы, её панель управления новые экраны, и её тема новые позиции виджетов. Она устанавливается как новый сайт рядом с вашим сайтом версии 7, затем импортирует его контент за несколько кликов. Старый сайт только для чтения: он продолжает работать, пока вы не переключитесь.

  1. Резервное копирование

    Файлы и базу данных вашего сайта версии 7.

  2. Установите версию 8

    Следуйте установке в папке рядом со старым сайтом, на том же хостинге (временный поддомен идеален), с новой, пустой базой данных: никогда не используйте ту же, что у старого сайта.

  3. Импортируйте ваш сайт

    В Настройки › База данных нажмите Импортировать сайт CMS.SOCHI 7. Предлагаются найденные сайты рядом с новым: выберите старый или введите его папку, ту, что содержит его папку config. Экран перечисляет, что он содержит; отметьте подтверждение, нажмите Импорт и держите страницу открытой до отчёта, обычно в течение минуты.

  4. Прочитайте отчёт

    Он перечисляет, что осталось сделать: установите ваши фирменные цвета, снова посмотрите на страницы, макет которых вы изменили в теме версии 7, заполните страницу политики конфиденциальности, которая была добавлена. Затем просмотрите новый сайт.

  5. Переключите домен

    Направьте ваш домен на папку нового сайта и обновите Публичный URL сайта в Настройки › Общие.

Импорт берёт языки, страницы, статьи, меню, виджеты, слайды, медиатеку, комментарии, сообщения, всплывающие окна, тексты, электронные письма и аккаунты старого сайта, файлы его медиа, его логотипы и его настройки. Каждая страница и статья сохраняет свой адрес, чтобы ссылки и поисковый рейтинг перешли, и каждый аккаунт свой пароль. То, что добавляет версия 8, сохраняется, на ваших языках: её новые тексты и электронные письма, страница политики конфиденциальности и виджет слайдера. Контент нового сайта заменяется; его учётная запись администратора остаётся.

Импорт также запускается из командной строки, удобно для большого сайта: php bin/pandao import:v7 /path/to/old-site показывает, что он содержит, и --run импортирует его. Импорт, остановленный на полпути, возобновляется там, где остановился.

Держите старый сайт и его базу данных офлайн несколько недель. Если нужна помощь, наша поддержка ответит.

Начало работы

Обновление

Новые версии публикуются на SOCHI.ENERGY, в ваших Загрузках, с их заметками в истории изменений.

  1. Резервное копирование

    Файлы и базу данных сайта.

  2. Загрузите новые файлы

    Загрузите содержимое папки upload/ нового пакета поверх вашего сайта. Ваша конфигурация (config/config.php), ваши медиа и изображения бренда не в пакете: они сохраняются. Изменения, внесённые в тему, принадлежат дочерней теме (см. Кастомизация), чтобы обновление никогда не перезаписало их.

  3. Примените обновления расширений

    Когда расширение получает новые файлы, каждый экран панели управления показывает баннер с его новой версией и кнопкой Обновить сейчас (также предлагается в Расширения). Нажмите её, когда загрузка завершена: его база данных обновляется за несколько секунд. До тех пор его страницы говорят вашим посетителям, что сайт обновляется, с кодом, который поисковики читают как временный.

Контент

Панель управления

Всё управляется с https://www.your-site.com/admin/, на компьютере, планшете или телефоне.

www.your-site.com/admin/
Панель управления

Меню слева группирует модули по разделам: Контент (страницы, статьи, слайдер, виджеты, всплывающие окна, меню, медиа, теги), Коммуникация (комментарии, сообщения, формы, шаблоны email) и Настройки (тексты, социальные ссылки, языки, локации, валюты, пользователи). Каждое расширение добавляет свой раздел. Настройки, Расширения, Диагностика и Корзина находятся рядом.

Каждый модуль имеет список, с поиском, фильтрами, сортировкой перетаскиванием, когда порядок важен, и действиями над несколькими элементами сразу (опубликовать, снять с публикации, удалить), и форму, с вкладкой на каждый язык для того, что переводится.

Контент

Страницы и конструктор

Страницы формируют дерево вашего сайта: каждая имеет своё место, свою модель, свой адрес и свой текст.

www.your-site.com/admin/module=page&view=list
Список страниц

Конструктор страниц

Текст страницы создаётся конструктором страниц: перетаскивайте контейнеры, строки от одной до четырёх колонок, заголовки, тексты, изображения, видео (YouTube, Vimeo или файл), кнопки, карточки и разделители, затем пишите в каждом блоке. Код показывает HTML страницы, чтобы скопировать его или вставить.

www.your-site.com/admin/module=page&view=form
Конструктор страниц с блоками страницы Возможности

Форма, созданная в Формы, размещается на странице или виджете с её шорткодом, таким как [form id="quote"].

Контент

Статьи и блог

Статьи — это новости, посты и истории сайта. Каждая статья принадлежит странице, которая перечисляет её (страница блога или любая страница), и имеет свою собственную страницу тоже.

www.your-site.com/en/features
Страница Возможности с её текстом и статьями
Контент

Слайдер и виджеты

Блоки страниц — это виджеты, которые вы размещаете, упорядочиваете, переводите и скрываете в Контент › Виджеты, не касаясь никакого кода.

www.your-site.com/admin/module=widget&view=list
Список виджетов

Виджеты темы

Слайдер, полноширинный баннер, параллакс фон, видео фон, список с иконками, рекомендуемая статья, рекомендуемые статьи, последние статьи, сетка статей, карусель изображений, отзывы, отзывы Google, контактная информация, список страниц, меню футера и ваш собственный HTML контент.

Куда они идут

Каждый виджет имеет позицию (верх страницы, до или после основного контента, левая или правая колонка, колонки футера), её страницы или все, её порядок и её языки. Расширения добавляют свои виджеты.

Слайды редактируются в Контент › Слайдер: изображение или видео YouTube и текст с заголовком, на каждом языке. На главной странице заголовок первого слайда — это главный заголовок страницы для поисковиков.

Контент

Медиатека

Все изображения и файлы сайта, в папках, в Контент › Медиа и из текстового редактора.

www.your-site.com/admin/module=media&view=list
Медиатека с её папками
Контент

Всплывающие окна

Всплывающее окно (Контент › Всплывающие окна) показывает сообщение поверх страницы, один раз за визит: объявление, предложение, уведомление о закрытии. Оно имеет свой текст на каждом языке, свой цвет фона, свои страницы или все и свои даты публикации.

Коммуникация

Формы и сообщения

Создавайте формы, которые вам нужны, поле за полем, без кода: цитата, регистрация, опрос.

  1. Создайте форму

    В Коммуникация › Формы: её название, её идентификатор (используется в шорткоде), адреса, которые получают ответы, сохраняются ли ответы в панели управления, тема электронного письма, метка кнопки и сообщение, показываемое после отправки.

  2. Добавьте её поля

    Текст, email, телефон, число, дата, длинный текст, список, чекбоксы или радио кнопки, с их меткой, их заполнителем и тем, являются ли они обязательными, на каждом языке.

  3. Разместите её

    Вставьте её шорткод, такой как [form id="quote"], на страницу или виджет.

Сообщения контактной страницы и сохранённые ответы перечислены в Коммуникация › Сообщения. Формы защищены от роботов reCAPTCHA, когда даны её ключи, и ограничены на посетителя.

Коммуникация

Комментарии и рейтинги

Включите комментарии и рейтинги в форме страницы или статьи. Комментарий ждёт в Коммуникация › Комментарии, пока вы его опубликуете. Опубликованные комментарии с рейтингом страницы показываются виджетом Отзывы этой страницы.

Коммуникация

Электронная почта

Каждое электронное письмо сайта — это шаблон Коммуникация › Содержимое email, на каждом языке, с переменными, такими как {name} или {site_url}, заменяемыми при отправке: подтверждение аккаунта, запрос нового пароля и сам пароль, сообщение контактной страницы. Расширения добавляют свои шаблоны.

Электронные письма несут баннер Настройки › Оформление и отправляются через SMTP сервер Настройки › Настройки email, когда вы его указываете. Microsoft 365 с OAuth требует библиотеку league/oauth2-client, установленную с Composer. Адрес отправителя вашего собственного домена и записи SPF и DKIM вашего домена, установленные с вашим хостингом, очень помогают доставке.

Настройки

Языки и тексты

Предложите ваш сайт на любом количестве языков, включая справа-налево.

  1. Включите Включить иностранные языки в Настройки › Общие: переключатель языка появляется в шапке, и адреса несут язык (/en/…, /fr/…).
  2. В Настройки › Языки опубликуйте или добавьте язык: его название, его код (de), его локаль (de_DE), его флаг и, для арабского или иврита, справа налево. Каждый контент получает копию для перевода, на основном языке.
  3. Переведите контент в каждой форме (вкладка на язык), затем интерфейс: Настройки › Тексты для текстов сайта и Коммуникация › Содержимое email для электронных писем.
www.your-site.com/fr
Главная страница на французском, с открытым переключателем языка

На языке справа-налево весь сайт отражён: меню, карусели, формы и кнопки. Панель управления доступна на английском, французском, испанском, португальском, голландском, русском и турецком, выбирается в Настройки › Общие (Язык панели админ).

Настройки

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

В Настройки › Пользователи каждый аккаунт имеет роль:

РольЧто делает
АдминистраторВсё, включая настройки, расширения и пользователей.
МенеджерКонтент и коммуникация всего сайта.
РедакторКонтент сайта, согласно разрешениям каждого модуля.
ЗарегистрированныйЧлен сайта, со своей страницей аккаунта, когда сайт предлагает одну: нет доступа к панели управления.

Расширения добавляют свои роли, с единственными разрешениями, которые им нужны. Каждый пользователь меняет своё имя, email и пароль в Настройки › Профиль.

Настройки

Брендинг и тема

Ваш логотип и ваши цвета, без редактирования файла: Настройки › Оформление.

www.your-site.com/admin/module=settings#appearance
Вкладка Оформление: визуальная идентичность и фирменные цвета

Сайт использует тему по умолчанию CMS.SOCHI, выбранную в Настройки › Общие › Шаблон. Чтобы изменить саму тему, создайте дочернюю тему (см. Кастомизация).

Настройки

Соцсети, локации и другое

Сайт

SEO

Сайт

Конфиденциальность и безопасность

Конфиденциальность

  • Баннер cookies (Настройки › Общие) с Принять все, Отклонить все и Настроить, как требуют европейские регуляторы. Его тексты на каждом языке (Настройки › Тексты, COOKIES_*).
  • Страница политики конфиденциальности с типовым текстом для заполнения, на которую ссылается баннер и которую расширения дополняют своим разделом.
  • Члены удаляют свой аккаунт сами со своей страницы аккаунта.

Безопасность

  • Подготовленные SQL запросы, защита каждой формы от поддельных запросов, заголовки безопасности и маршруты, ограниченные тем, что существует.
  • Пароли хешируются текущими алгоритмами; попытки входа ограничены на адрес и на аккаунт.
  • Ошибки записываются в лог сервера, никогда не показываются посетителям.
  • Загрузки проверяются по их содержимому, и медиа хранятся в своих папках.
  • Секретные ключи никогда не отображаются снова после сохранения.
Сайт

Режим обслуживания

Включите Режим обслуживания в Настройки › Общие, пока готовите ваш сайт: посетители видят страницу с вашим сообщением, и поисковикам говорят вернуться позже (код 503), пока вы, вошедшие в панель управления, просматриваете сайт как обычно.

Сайт

Корзина, черновики и блокировки

Сайт

Диагностика

Экран Диагностика, рядом с настройками, проверяет PHP, базу данных, сервер и запланированные задачи и говорит, что спросить у вашего хостинга.

www.your-site.com/admin/module=diagnostic
Экран Диагностика

Копировать отчёт копирует отчёт без какого-либо пароля, для отправки в поддержку.

Запланированные задачи

CMS.SOCHI запускает запланированные задачи своих расширений: сайт без расширения не имеет их. Когда расширение нуждается в них, добавьте cron job, который запускает bin/pandao cron каждую минуту: Диагностика › Расширенная конфигурация показывает точную строку для вашего сервера, с путём его PHP. Это выглядит так:

* * * * * /usr/bin/php /home/your-account/public_html/bin/pandao cron >/dev/null 2>&1

Без cron job сайт запускает задачи сам после визита, не чаще каждых десяти минут, на хостингах, использующих PHP-FPM (большинство из них).

Разработчикам

Кастомизация

Держите ваши изменения вне файлов пакета, чтобы каждое обновление оставалось простой загрузкой.

Дочерняя тема

Тема — это папка templates/. Дочерняя тема содержит только файлы, которые она изменяет: каждый файл, которого у неё нет, берётся из темы по умолчанию.

  1. Создайте templates/my-theme/ (строчные буквы, цифры, дефисы).
  2. Добавьте ваши стили в templates/my-theme/assets/css/custom.css, загружаемые после стилей темы.
  3. Чтобы изменить шаблон, скопируйте его по тому же пути из темы по умолчанию: views/partials/header.php, views/partials/footer.php, views/page.php, widgets/featured_home.php…
  4. Выберите её в Настройки › Общие › Шаблон.

Скопированный шаблон больше не получает улучшений обновлений: предпочитайте CSS, когда этого достаточно, копируйте только то, что должны, и сравнивайте ваши копии с новыми версиями после обновления.

Тексты и электронные письма не требуют кода: они редактируются в панели управления.

Разработчикам

Расширения

Расширение добавляет целую функцию на сайт (движок бронирования, магазин, каталог) без касания файлов CMS.SOCHI, чтобы каждое обновлялось отдельно.

www.your-site.com/admin/module=extensions
Страница Расширения

Аддоны, продаваемые для CMS.SOCHI: Multi Resorts, полный движок бронирования отелей для нескольких объектов (отели, тарифы, онлайн бронирование и платежи, календари платформы) и Panda Resort, тот же движок для одного отеля, курорта или гостевого дома; оба для CMS.SOCHI 8.2 или новее.

Разработчикам

Создание расширения

Расширение — это папка extensions/, имя которой — её идентификатор (строчные буквы, цифры и подчёркивания).

extensions/my_extension/
├── extension.json            его манифест
├── src/Extension.php         Pandao\Extensions\MyExtension\Extension
├── admin/modules/            его модули панели управления
├── admin/langs/              его тексты панели управления
├── templates/views/          его страницы, которые тема может переопределить
├── public/                   CSS, JS и изображения, подаются под /extensions/my_extension/
└── migrations/0001_create_tables.php
{
    "name": "my_extension",
    "title": "My extension",
    "description": "Короткий текст, показываемый в панели управления.",
    "version": "1.0.0",
    "requires": { "pandao": "^8.1", "php": ">=8.2" },
    "admin": { "title": "My extension", "icon": "puzzle-piece", "menu": ["item"] }
}

Метод register() его класса Extension объявляет, что он добавляет: маршруты страниц и системные маршруты, XHR действия, экраны и действия панели управления с их разрешением, виджеты, настройки, роли, запланированные задачи и хуки (действия и фильтры), такие как front.head, front.footer, admin.dashboard или sitemap.entries. Он только объявляет: он запускается при каждом запросе, не касаясь базы данных.

Миграция — это PHP файл, который возвращает static function (\PDO $db): void; миграции запускаются в порядке их номеров, один раз, при активации и при каждом обновлении, и их история сохраняется. "multilingual": true в манифесте открывает новый сайт на его языках, когда расширение поставляется с CMS.SOCHI в пакете.

Разработчикам

Командная строка

Из папки сайта, с PHP сайта и его пользователем:

php bin/pandao cron                                # запускает запланированные задачи, которые должны быть выполнены
php bin/pandao extension:list                      # перечисляет расширения и их состояние
php bin/pandao extension:enable my_extension       # включает расширение, как страница Расширения
php bin/pandao extension:update my_extension       # применяет обновление расширения
php bin/pandao extension:disable my_extension      # отключает его и сохраняет его данные
php bin/pandao import:v7 /path/to/old-site         # что содержит сайт версии 7
php bin/pandao import:v7 /path/to/old-site --run   # импортирует его в этот сайт

Чтобы отобразить ошибки PHP, пока вы исследуете проблему, добавьте define('PMS_DEBUG', 1); в config/config.php, затем удалите его: рабочий сайт никогда не показывает свои ошибки, он записывает их в PHP лог сервера.

Помощь

Устранение неполадок и FAQ

Начните с экрана Диагностика: он проверяет PHP, базу данных, сервер и запланированные задачи и говорит, что спросить у вашего хостинга.

Мастер не открывается или каждая страница отвечает «Not found»

Файлы .htaccess не загружены (они скрыты: покажите скрытые файлы в вашем FTP клиенте) или сервер игнорирует их. Попросите ваш хостинг включить mod_rewrite и разрешить файлы .htaccess (AllowOverride All). На IIS URL Rewrite читает файл web.config.

Открывается только главная страница, другие говорят «No input file specified»

Ваш хостинг запускает PHP как CGI или FastCGI, который отказывает адресам, которые CMS.SOCHI 8.2.1 и ранее передают index.php. Версия 8.3.0 исправляет это. Пока вы не обновите, откройте public/.htaccess и замените его последние строки, с RewriteRule ^(.*/)?index\.php$ до конца блока, этими:

    RewriteCond %{THE_REQUEST} ^\S+\s[^?\s]*index\.php[?\s]
    RewriteRule ^(.*/)?index\.php$ %{ENV:BASE}$1 [R=301,L]

    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^ index.php [L,QSA]
</IfModule>

Пустая страница или «error 500»

Проверьте версию и расширения PHP (см. Требования), затем лог ошибок PHP вашей панели хостинга. define('PMS_DEBUG', 1); в config/config.php показывает ошибку на время.

Электронные письма не приходят

Укажите SMTP сервер вашего почтового ящика в Настройки › Настройки email, с адресом отправителя вашего собственного домена и посмотрите в папке спама.

Карта контактной страницы пуста

Укажите ключ Google Maps в Настройки › Общие и хотя бы одно место в Настройки › Локации.

Изображение выглядит обрезанным

Установите его точку фокусировки в медиатеке: часть изображения, которую вы выберете, остаётся в поле зрения.

Язык отсутствует в переключателе

Включите Включить иностранные языки и опубликуйте язык в Настройки › Языки.

Расширение показано как Несовместимо

Оно требует другую версию CMS.SOCHI или PHP: его строка говорит какую. Обновите CMS.SOCHI или попросите ваш хостинг о версии PHP, которую оно требует.

Помощь

Поддержка

Мы отвечаем через вкладку Поддержка страницы CMS.SOCHI на SOCHI.ENERGY.

Страница товараcodecanyon.net
Авторsochi.energy
Демоcms.sochi.energy
Помощь

Авторы и лицензии

CMS.SOCHI создана ENERGY и продаётся под лицензиями. Она включает следующие ресурсы, каждый под своей лицензией. Фото онлайн демо, которые показывают скриншоты этого руководства, только для предварительного просмотра и не включены.

РесурсЛицензия
Примерные фото и видеоCC0 (StockSnap) и общественное достояние (NASA): docs/CREDITS.md
Phosphor IconsMIT
Rubik, Urbanist, Sora (шрифты)SIL Open Font License 1.1
Bootstrap 5, jQuery, jQuery UIMIT
Owl Carousel, Magnific Popup, Animate.css, imagesLoaded, jQuery Appear, jQuery matchHeight, js-cookie, c-shareMIT
jQuery LazyMIT или GPL-2.0
Bootstrap Star RatingBSD-3-Clause
IsotopeGPL-3.0 или коммерческая лицензия Metafizzy
MeanMenuGPL-3.0
CKEditor 5 (текстовый редактор панели управления)GPL-2.0 или новее или коммерческая лицензия CKSource
UploadiFive (загрузки панели управления)UploadiFive Standard License
PHPMailerLGPL-2.1
Помощь

История изменений

Версия 8.3.0 Новое

Версия 8.2.1

Версия 8.2.0

Первая версия 8 CMS.SOCHI, продаваемая отдельно. Новое поколение для PHP 8.2 до 8.5 (см. Новое в версии 8):