Онлайн-руководство разработчика NetCat
Модуль «Поиск по сайту» 13.2.1Начало работы с модулем 13.2.2Язык запросов 13.2.3Способы хранения индекса 13.2.4Интерфейс модуля в панели управления сайтом 13.2.5Области индексирования 13.2.6Области HTML-страниц 13.2.7Области поиска на сайте 13.2.8Индексирование по расписанию, запуск индексирования в фоновом режиме 13.2.9Правила индексирования 13.2.10Постановка задачи переиндексирования в очередь 13.2.11Интеграция модуля в макеты дизайна сайта 13.2.12Простая форма поиска 13.2.13Расширенная форма поиска 13.2.14Вывод результатов поиска 13.2.15Стилизация списка подсказок 13.2.16Расширенные настройки 13.2.17Разработка расширений модуля 13.2.18Обзор архитектуры модуля 13.2.19Обработчики документов различных типов 13.2.20Текстовые фильтры 13.2.21Анализаторы текста 13.2.22Корректировщики запросов 13.2.23Подключение других поисковых систем 13.2.24Решение проблем с поиском 13.2.25Решение проблем с индексированием 13.2.26Справочник API

Шаблон письма

Все письмо можно разделить на три части: хэдер, содержательная (контентная) часть и футер.

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

Во всех частях письма можно использовать следующие переменные:

Переменная Описание
$current_user массив с параметрами пользователя, которому отправляется письмо
$mailer массив с информацией о рассылке
$current_catalogue, $current_sub, $current_cc используются для подписки на раздел
$classID номер компонента (для подписок на раздел)
логин пользователя
ссылка для отказа от рассылки
ссылка на страницу управления подписками; для незарегистрированных пользователей содержит хэш для входа в раздел управления подписками
ссылка на страницу управления подписками с хэшем для входа в систему (для всех пользователей); доступно с версии 5.6.0.16040

Допустим, пользователь подписан на рассылку «Новости» с периодичностью 2 часа, и за эти два часа администратор добавил три новости, тогда письмо для этого пользователя схематично будет выглядеть так:

Хэдер
Контентная часть для 1-ой новости
Контентная часть для 2-ой новости
Контентная часть для 3-ой новости
Футер

Для регулярных и сервисных рассылок схема письма такая:

Хэдер
Контентная часть
Футер

Для рассылок типа «серийная рассылка» содержательная часть будет соответствовать объекту урока который должен получить подписчик.

Допустим, пользователь уже получил три урока, следующе письмо будет содержать:

Хэдер
Контентная часть для 4-го урока
Футер

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

Шаблоны писем (хэдер, содержательная часть, футер) — это php строка, вставка функций и кода выполняется соответствующе (синтаксис v4).

Для вставки функций можно воспользоваться следующей конструкцией:

html-код ".some_function()." html-код

Возвращаемое значение этой функции войдет в письмо.

Для вставки php-кода можно применить следующую схему:

HTML-код
";
    php-код
$result .= "

Если в шаблоне отсутствует использование массива $current_user, то обработка будет производиться только один раз для всех пользователей.

Для выполнения условий, получение хэдера, футера и содержательной части письма каждый раз вызывается функция, поэтому переменные, объявленные в, допустим, условие рассылки недоступны в футере письма. Чтобы все-таки передавать между ними некоторые значения, можно воспользоваться заранее определённым статическим массивом $static_vars.

Например, в условие рассылки пишем:

$static_vars['my_var'] = 123;

тогда в футере будет доступен элемент массива $static_vars['my_var'] со значением 123.

Тема письма

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

Новый ответ на форуме ".$current_sub['Subdivision_Name']."
Письмо для ".$current_user['Name']."

Хэдер и футер

В верхней и нижних частях используются те же переменные, что и в теме.

Пример использования. В футере добавить ссылку для отписки:

Надоело получать рассылку? Вы можете <a href=''>отписаться</a>.

Основная часть

В основной части письма добавляется ряд новых переменных

Переменная Описание
$f_RowID номер объекта
$f_UserID номер пользователя, добавившего объект
$f_ИмяПоля значение поля объекта

Использование $f_ИмяПоля аналогично использованию такой же переменной в компонентах. Допустим есть рассылка новостей, а в компоненте «Новости» используются поля Title (для заголовка), Announce (для анонса). В этом случае шаблон для основной части может выглядить так:

<h2><a href='".nc_message_link( $f_RowID, $classID )."'>".$f_Title."</a></h2>
<p>".$f_Announce."</p>

Список переменных, которые нельзя переопределять в условиях и шаблонах рассылок:

  • $item
  • $cache

Комментарии 3

Дмитрий  Life-work 19 марта 2015, 15:52:13
вставка поля файл
$f_Picture
приводит к неправильному результату:

xsscleaned="nc_row_img" всем.jpg:image="" jpeg:7598:115="" 134="" skidki_vsem.jpg'=""

думаю с мультизагрузкой тоже не пойдет, позже посмотрю.
   
Дмитрий  Life-work 19 марта 2015, 16:04:58
Лечение:
[CODE]
";
$pic = explode(":",$f_Picture);
$result .= "
<img src='http://".$current_catalogue['Domain']."/netcat_files/".$pic[3]."' />
[/CODE]
   
Raul  N-Studio 20 марта 2015, 11:53:57
А почему в документации забыли указать про замечательную переменную
$f_LastUserID номер пользователя, изменившего объект?

И еще неплохо бы написать, как этими переменными $f_UserID, $f_LastUserID пользоваться для того, чтобы вытянуть информацию о пользователе.

[QUOTE]$db->get_var("SELECT `Login` FROM `User` WHERE `User_ID` = '".$f_LastUserID."' ");[/QUOTE]
   
Описание проекта