Модули

Материал из PantherCMS Documentation
Перейти к навигации Перейти к поиску

Формы

В этом модуле хранятся данные запросов с форм сайта. В примере ниже, есть 2 сохранённых запроса с формы “Получить консультацию”.

Формы
Формы


Откроем одну из публикаций.

Форма
Форма


Здесь мы видим:

  • Дата и время, когда пользователь сайта заполнил форму.
  • Тело письма. Из данных, которые пользователь указал в форме на основе шаблона, было сформировано это письмо. Также здесь указаны:
    • URL и название страницы, с которой был отправлен запрос.
    • Дата и время запроса.
    • IP пользователя.
  • Тема письма.
  • E-Mail получателя, кому было отправлено письмо.
  • Шаблон на основе которого сформировалось письмо.

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


Шаблоны писем

Когда посетитель сайта заполняет какую-нибудь форму, например “Получить консультацию”, данные из этой формы подставляются в шаблон письма. В таком виде они сохраняются в базу данных сайта и отправляются на email получателя.

Откроем страницу шаблонов:

Шаблоны писем
Шаблоны писем


Откроем шаблон “Получить консультацию”.

Шаблон "Получить консультацию"
Шаблон "Получить консультацию"


Здесь мы видим:

  • Тема письма.
  • Тело письма. Из текста и прочих данных, которые здесь указаны создаётся письмо. В теле письма можно использовать метки. Они заменяются на данные, которые посетитель указал в форме на сайте. Количество и названия меток настраиваются программистом при разработке сайта. Наиболее распространённые метки:
    • [[MAIL_SUBJECT]] - тема письма.
    • [[NAME]] - имя.
    • [[PHONE]] - телефон.
    • [[EMAIL]] - электронная почта.
    • [[MESSAGE]] - сообщение.
    • [[MAIL_SIGNATURE]] - подпись администрации.
    • [[MAIL_HOST]] - адрес сайта.
    • [[REQUEST_URL]] - страница, на которой заполнили форму.
    • [[MAIL_DATE]] - дата отправки формы.
    • [[MAIL_IP]] - IP посетителя.
  • Идентификатор формы.
  • Название. Название формы, которое используется списке сообщений (Модули -> Формы).
  • Категория формы.
  • Почта получателя. Письма с сайта по умолчанию отправляются на почту, указанную в Настройках.. Если нужно, чтобы письма с этого шаблона отправлялись на другую электронную почту, то нужно указать её в этом поле.
  • Имя отправителя.  Имя отправителя по умолчанию берётся из настроек почты. Если для писем этого шаблона нужно указать другое имя отправителя, его нужно вписать в это поле.
  • Почта для ответа. Почта, которая будет указана по умолчанию у пользователей, получивших письмо с этого шаблона.
  • Опубликовано. Включен/выключен шаблон. Если выключен, письма с форм, которые используют этот шаблон, отправляться не будут.

Шаблоны форм создаются программистом при разработке сайта. Администратор сайта может работать с готовыми шаблонами.


Редиректы

Редиректы используются для создания произвольных перенаправлений с одного URL сайта на другой.

Например, у нас была страница https://example.com/taburetka.html. Товара больше нет и не будет, поэтому мы решили удалить этот товар. Теперь, если посетитель сайта перейдёт по адресу https://example.com/taburetka.html у него отобразится ошибка 404. Можно оставить так, но в иногда лучше предложить посетителю похожий товар. Для этого можно использовать редирект на страницу https://example.com/stul.html. Чтобы создать редирект нужно: 1. В дереве разделов выбрать пункт “Редиректы”.

Редирект
Редирект


2. Нажать на кнопку “Создать” внизу правого блока.

Создание редиректа
Создание редиректа


3. В поле “Адрес” нужно указать URL, откуда будет происходить перенаправление. В нашем примере это “/taburetka.html”. В качестве адреса можно указать регулярное выражение. В этом случае нужно указать флаг “Регулярное выражение”, ниже поля “Адрес”.

4. В поле “Перенаправление” нужно указать URL страницы/публикации куда будет происходить перенаправление. В нашем примере это “/stul.html”.

5. В поле “Код” выбираем код перенаправления.

6. Обязательно указать флаг “Активно”, иначе перенаправление работать не будет.

Настройка редиректа
Настройка редиректа


7. Нажать на кнопку “Сохранить”. Редирект создан.

Список перенаправлений
Список перенаправлений


Теперь при переходе на страницу “/taburetka.html” сайта будет открываться страница “/stul.html”.

Виджеты

Виджеты используются для размещения стороннего js-кода на сайте. Например, онлайн-консультанта.

Чтобы создать виджет нужно:

1. В дереве разделов выбрать пункт “Виджеты”.

Виджеты
Виджеты


2. Нажать на кнопку “Создать” внизу правого блока.

Создать виджет
Создать виджет


3. Заполнить поля:

  • Имя переменной. Любое название.
  • Описание. Краткое описание виджета. Используется только в панели, в списке виджетов для удобства.
  • Страницы. Отметить страницы, на которых должен отображаться виджет.
  • HTML. В это поле вставить код виджета
  • Опубликовано. Если не указано, виджет отображаться не будет.
Виджет онлайн-консультант
Виджет онлайн-консультант


4. Нажать на кнопку “Сохранить”. Виджет создан.

Виджет создан
Виджет создан


Сниппеты

Некоторые страницы состоят из нескольких блоков. Например, главная страница сайта pantera.kz:

Страница из сниппетов
Страница из сниппетов


Для создания таких страниц используются сниппеты. Сниппет - самостоятельный фрагмент страницы, как элемент конструктора. Сниппет можно использовать на одной странице или на нескольких. От этого зависит расположение сниппета. Если сниппет используется на одной странице, он и располагается на ней. Если на нескольких страницах, то его располагают в “Модули” -> “Сниппеты”.  Рассмотрим на примере главной страницы.

Чтобы создать на странице сниппеты нужно:

1. В дереве разделов выбрать страницу и кликнуть по ней правой кнопкой мыши.

2. В открывшемся меню выбрать пункт “Свойства”.

Свойства страницы
Свойства страницы


3. Указать тип данных “Сниппет”, отображение “Сниппеты” и нажать на кнопку “Сохранить”.

Страница "Сниппет"
Страница "Сниппет"


Теперь, если нажать на страницу в дереве разделов, в правом блоке мы можем создавать сниппеты этой страницы.

Создать сниппет
Создать сниппет


Если нажмём на кнопку создать, откроется окно создания. Здесь мы видим:

  • Название. Нужно для удобства. Отображается только в гриде и в списке сниппетов.
  • Текущая страница. Если флаг установлен, то сниппет отображается только на странице, на которой создан. Если не установлен, можно настроить отображение на нескольких страницах.
  • Идентификатор. Используется программистом при разработке. Лучше оставить как есть.
  • Метка. Используется программистом при разработке. Лучше оставить как есть.
  • Шаблон сниппета. Это фрагмент HTML-разметки, он отвечает за внешний вид блока на странице. Список шаблонов создаётся во время разработки сайта и в дальнейшем в сниппетах используются шаблоны из этого списка. Чтобы добавить новый шаблон в список нужны навыки вёрстки сайтов.
  • Контроллер сниппета. Это программный код сниппета. Список контроллеров создаётся программистом во время разработки сайтов. Используется в паре с шаблоном сниппета. Не все шаблоны и контроллеры взаимно совместимы. Обычно совместимые шаблоны и контроллеры имеют одинаковое название. Например шаблон - block_news.latte, контроллер block_news.php. О назначениях шаблонов/контроллеров можно узнать у программиста. Но обычно оно указывается в названиях. Например слово news в названии указывает на то, что эти шаблон и контроллер выводят на страницу новости.
  • Источник данных. Эта опция нужна, чтобы передать в сниппет содержимое другой страницы.
  • Стиль (CSS). Если к сниппету применяется особый стиль отображения, он выбирается из списка. Список стилей настраивается при разработке сайта.
  • Копия сниппета. Если сниппет должен быть полной копией другого сниппета.
  • Индекс. Отвечает за порядок отображения сниппетов на странице, от меньшего к большему.
  • Опубликовано. Если флаг не установлен, сниппет не отображается на странице.
Сниппет "Текст"
Сниппет "Текст"


Создание сниппета с источником данных

Добавим сниппет “Новости”. Он будет выводить несколько последних новостей. Для этого нужно следующее:

1. Нажать на кнопку “Создать”.

Создать сниппет "Новости"
Создать сниппет "Новости"


2. В открывшемся окне указать название.

Создать сниппет "Новости"
Создать сниппет "Новости"


3. В открывшемся окне редактирования записи раскрыть вкладку “Настройки”.

Настройки сниппета
Настройки сниппета


4. В настройках обязательно выбрать шаблон сниппета из списка.

Шаблон сниппета
Шаблон сниппета


5. В настройках обязательно выбрать контроллер сниппета.

Контроллер сниппета
Контроллер сниппета


6. Указать источник данных. В нашем примере у нас есть отдельная страница “Новости”. Чтобы не дублировать записи новостей мы просто передаём их в сниппет. Укажем в источнике данных страницу “Новости” и нажмем “Сохранить”.

Создать сниппет "Новости"
Создать сниппет "Новости"


Сниппет создан. Теперь при изменении публикаций на странице “Новости”, они будут меняться в этом блоке.

Создан сниппет "Новости"
Создан сниппет "Новости"


Создание сниппета из содержимого другого сниппета

Если сниппет у нас уже есть и нам нужно создать такой же на другой странице, мы можем передать содержимое сниппета в другой сниппет.

Например, у нас есть сниппет “Форма консультации”, который должен отображаться на Главной странице и на странице “О компании”.

Сниппет
Сниппет


Для этого нужно:

1. Создать сниппет для Главной и указать шаблон и контроллер.

2. В поле “Копия сниппета” выбираем “Сниппет - Форма консультации” и сохраняем сниппет.

Сниппет из другого сниппета
Сниппет из другого сниппета


Сниппет для Главной страницы создан.

Сниппет создан
Сниппет создан


3. Повторяем те же действия для страницы “О компании”.

Такой же сниппет для страницы "О компании"
Такой же сниппет для страницы "О компании"


Теперь, если мы внесём изменения в “Модули” -> “Сниппеты” -> “Сниппет - Форма консультации”. То изменятся формы на Главной странице и на странице “О компании”.


Управление сниппетами с дополнительными полями

Для некоторых сниппетов при разработке сайта создаются дополнительные поля для содержимого.

Пример такого сниппета:

Содержимое сниппета "Карусель"
Содержимое сниппета "Карусель"


В этом случае содержимое берётся из самого сниппета и указывать источник данных не нужно. Нужно только заполнить содержимое. Добавим слайды.

Для этого нужно:

1. Кликнуть на слайд.

Слайды сниппета
Слайды сниппета


2. Добавить изображение и указать заголовок.

Первый слайд сниппета
Первый слайд сниппета
Первый слайд
Первый слайд


3. Повторить для других слайдов.

Слайды
Слайды переименованы


Если нужны ещё слайды, нажать на кнопку “Добавить новую запись”.

Добавить слайд
Добавить слайд


Если слайд не нужен, его можно удалить.

Удалить слайд
Удалить слайд


Также можно изменить порядок отображения слайдов при помощи кнопок “Вверх” и “Вниз”. Для примера сделаем слайд “Товары для дома” первым, передвинем его вверх.

Переместить слайд вверх
Переместить слайд вверх


Результат:

Результат
Результат


Копирование сниппета

Копировать сниппеты можно только между страницами с типом данных “Сниппет”.

Тип страницы "Сниппет"
Тип страницы "Сниппет"


Для примера скопируем сниппет “Новости” с Главной страницы на страницу “О компании”.

Чтобы скопировать сниппет нужно:

1. Кликнуть по сниппету правой кнопкой мыши.

2. В открывшемся меню выбрать пункт “Копировать”.

Копирование сниппета "Новости"
Копирование сниппета "Новости"


3. Перейти на страницу “О компании”.

Сниппет страница "О компании"
Сниппет страница "О компании"


4. Кликнуть правой кнопкой мыши в правом блоке и выбрать пункт меню “Вставить”.

Сниппет "О компании" вставить
Сниппет "О компании" вставить


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

Публикация блока "Новости"
Публикация блока "Новости"


5. Чтобы опубликовать сниппет нужно кликнуть по нему правой кнопкой мыши и выбрать пункт меню “Опубликовать”.

Опубликовать
Опубликовать


Теперь сниппет отображается на странице.


Перемещение сниппета

Перемещать сниппеты можно только между страницами с типом данных “Сниппет”.

Тип страницы "Сниппет"
Тип страницы "Сниппет"


Для примера переместим сниппет “Блок - Карусель” с Главной страницы на страницу “О компании”. Для этого нужно:

1. Кликнуть по сниппету правой кнопкой мыши и выбрать пункт меню “Вырезать”.

Вырезать "Карусель"
Вырезать "Карусель"


2. Перейти на страницу “О компании”, кликнуть правой кнопкой мыши в правом блоке и выбрать пункт меню “Вставить”.

Вставить сниппет "Карусель"
Вставить сниппет "Карусель"


Сниппет перемещается вместе с содержимым и со всеми настройками, но не опубликованным. Нужно его только опубликовать.

3. Чтобы опубликовать сниппет нужно кликнуть по нему правой кнопкой мыши и выбрать пункт меню “Опубликовать”.

Опубликовать блок "Карусель"
Опубликовать блок "Карусель"


Сниппет был добавлен в конец списка. Чтобы переместить его выше, можно изменить индекс в окне редактирования или воспользоваться стрелками справа.

Переместить блок
Переместить блок


Удаление сниппета

Чтобы удалить сниппет нужно:

1. Кликнуть по нему правой кнопкой мыши.

2. В открывшемся меню выбрать пункт “Удалить”.

Удалить блок
Удалить блок


3. Подтвердить удаление.

Подтверждение удаления блока
Подтверждение удаления блока


Блок удалён.


Стили

Для некоторых страниц или публикаций могут использоваться особые стили. Они настраиваются программистом при разработке сайта. Поэтому не рекомендуется в них что-либо менять. Посмотреть все доступные стили можно в Панели управления сайтом -> Модули -> Стили.

Стили
Стили


Чтобы применить стиль к странице нужно:

1. Кликнуть правой кнопкой мыши по странице и выбрать пункт меню “Свойства”.

Меню "Свойства"
Меню "Свойства"


2. В открывшемся меню редактирования страницы раскрыть вкладку “Дополнительные параметры”.

Вкладка "Дополнительные параметры"
Вкладка "Дополнительные параметры"


3. Выбрать стиль из списка в поле “Стиль” и сохранить изменения.

Стиль страницы "Тёмная тема"
Стиль страницы "Тёмная тема"


Если этот стиль был предусмотрен для данной страницы при разработке сайта, он будет применён.

Похожим образом стили применяются для сниппетов.

Стиль для сниппета
Стиль для сниппета



Типы ресурсов

Типы ресурсов используются, чтобы выделить страницы из числа таких же. Обычно типы ресурсов используются программистами при разработке сайтов. Поэтому не рекомендуется что-либо менять. Посмотреть все доступные стили можно в Панели управления сайтом -> Модули -> Типы ресурсов.

Типы ресурсов
Типы ресурсов


Пример использования:

У нас есть 2 одинаковых справочника: статусы заказов и города.

Одиннаковые справочники
Одиннаковые справочники


Чтобы отделить один справочник от другого присвоим справочнику “Города” тип ресурса “Города”. Для этого откроем свойства и укажем тип ресурса.

Тип ресурса: Города
Тип ресурса: Города


Теперь в коде можно при вызове справочника можно использовать идентификатор типа ресурса, в данном случае “cities”.

Идентификатор типа ресурса
Идентификатор типа ресурса