Модули: различия между версиями

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


3. Указать тип данных “Сниппет”, отображение “Сниппеты” и нажать на кнопку “Сохранить”.
3. Указать тип данных “Сниппет”, отображение “Сниппеты” и нажать на кнопку “Сохранить”.
[[Файл:Страница "Сниппет".png|альт=Страница "Сниппет"|без|мини|1050x1050пкс|Страница "Сниппет"]]
[[Файл:Page snippet.png|альт=Страница "Сниппет"|без|мини|1050x1050пкс|Страница "Сниппет"]]




Теперь, если нажать на страницу в дереве разделов, в правом блоке мы можем создавать сниппеты этой страницы.
[[Файл:Создать сниппет.png|альт=Создать сниппет|без|мини|1050x1050пкс|Создать сниппет]]


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


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


* '''Источник данных'''. Эта опция нужна, чтобы передать в сниппет содержимое другой страницы.
* '''Стиль (CSS)'''. Если к сниппету применяется особый стиль отображения, он выбирается из списка. Список стилей настраивается при разработке сайта.
* '''Копия сниппета'''. Если сниппет должен быть полной копией другого сниппета.
* '''Индекс'''. Отвечает за порядок отображения сниппетов на странице, от меньшего к большему.
* '''Опубликовано'''. Если флаг не установлен, сниппет не отображается на странице.
[[Файл:Сниппет "Текст".png|альт=Сниппет "Текст"|без|мини|1050x1050пкс|Сниппет "Текст"]]


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


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

Версия 17:12, 7 июня 2022

Формы

В этом модуле хранятся данные запросов с форм сайта. В примере ниже, есть 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. Нажать на кнопку “Создать”.


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

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

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

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

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

Стили

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