Макросы

Макросы, которые применяются в макете:

[bloglink] - адрес ссылки блога

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

В шаблоне дайджеста, например, в подписи, указать - Адрес блога в сети: [bloglink]

Получатель рассылки увидит - Адрес блога в сети: http://ivanovo.newsmine.ru

[blogname] - наименование блога

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

В шаблоне дайджеста, например, в подписи, указать - С уважением ваш [blogname]!

Получатель рассылки увидит - С уважением ваш Мой Консультант!

Целесообразно использовать этот макрос в сочетании с макросом [bloglink], указывая его в виде ссылки. На уровне html-разметки это будет выглядеть следующим образом - С уважением ваш <a href="[bloglink]">[blogname]</a>!

Получатель рассылки увидит - С уважением ваш Мой Консультант!

[br] - тэг <br> - начало новой строки, перенос на новую строку

[name] - имя пользователя

[patron] - отчество пользователя

[surname] - фамилия пользователя

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

В шаблоне дайджеста, например, в обращении, указать - Уважаемый [name] [patron] [surname]!

Получатель рассылки увидит - Уважаемый Иван Иванович Иванов!

[email] - электронный адрес получателя
[client_name] - наименование клиента
[service_enterprise] - наименование обслуживающей организации
[ric_emails] - электронные адреса РИЦ, указанные в справочнике КонсРИЦ на вкладке "NewsMine" в табличной части Контактные данные
[ric_phones] - телефоны РИЦ, указанные в справочнике КонсРИЦ на вкладке "NewsMine" в табличной части Контактные данные
[cats] - список рубрик

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

В шаблоне дайджеста, например, в его общей части, указать - Вы подписаны на рубрики: [cats].

Получатель рассылки увидит - Вы подписаны на рубрики: Семинары К+, Тестирование программисты, Бухучет, налоги, Юрист, Спецрежимы, Охрана труда и техника безопасности, Кадры,трудовое законодательство, Зарплата, Бюджетники, Бухгалтерия, Корпоративная рубрика.

[count] - количество статей в дайджесте

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

В шаблоне дайджеста, например, в подписи, указать - В дайджесте [count] статей.

Получатель рассылки увидит - В дайджесте 5 статей.

[date format="%e %vmg %Y"] - выводит текущую дату

Параметры:

  • format - формат вывода даты (%vmg - месяц прописью в родительном падеже, остальные форматы даты используются,  как это принято в php)

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

В шаблоне дайджеста, например, в подписи, указать - Дайджест сформирован [date format="%e %vmg %Y %T"].

Получатель рассылки увидит - Дайджест сформирован 13 декабря 2016 08:44:31.

[digdate] - дата формирования дайджеста

[digtime] - время формирования дайджеста

[digmonth] - месяц формирования рассылки, определяется по дате запуска рассылки

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

В шаблоне дайджеста, например, в подписи, указать - Дайджест сформирован [digdate] [digtime].

Получатель рассылки увидит - Дайджест сформирован 07.12.2016 09:08:49.

[num_dig] - номер рассылки

[user_url] - формирует ссылку, по которой пользователь может войти в личный кабинет: url_сайта/auth/токен_клиента

Параметры:

  • text – текст ссылки, который будет вставлен в теге <a> (по умолчанию, Личный кабинет)
  • urlonly – если значение="true", то будет выведена только ссылка, иначе ссылка, обернутая в тэг <a>

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

В шаблоне дайджеста, например, в подписи, указать - Вы можете зайти в свой личный кабинет по ссылке: [user_url]!

Получатель рассылки увидит - Вы можете зайти в свой личный кабинет по ссылке: Личный кабинет!

В шаблоне дайджеста, например, в подписи, указать - Вы можете зайти в [user_url text="свой личный кабинет"]!

Получатель рассылки увидит - Вы можете зайти в свой личный кабинет!

[unsubscribe_url] – формирует ссылку для отписки от рассылки

Параметры:

  • text – текст ссылки, который будет вставлен в теге <a> (по умолчанию, Отписаться)
  • urlonly – если значение="true", то будет выведена только ссылка, иначе ссылка, обернутая в тэг <a>

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

В шаблоне дайджеста, например, в подписи, указать - [unsubscribe_url] от рассылки.

Получатель рассылки увидит - Отписаться от рассылки.

В шаблоне дайджеста, например, в подписи, указать - Чтобы отписаться от рассылки перейдите по ссылке: [unsubscribe_url urlonly="true"].

Получатель рассылки увидит - Чтобы отписаться от рассылки перейдите по ссылке: http://ivanovo.newsmine.ru/nm/unsubscribe?token=b4962e49fe8a6511087a94f744feee8e86708f8

[feedback_url] – формирует ссылку для обратной связи

Параметры:

  • action – тип обратной связи, который можно посмотреть и задать в справочнике "NM_ТипыОбратнойСвязи" в КИС "Восточный экспресс" (например, like, dislike, neutral)
  • redirect – ссылка на страницу, на которую переходит пользователь после выставления оценки
  • redirect2 - ссылка на страницу, на которую переходит пользователь после указания комментария

Внимание: [feedback_like_url], [feedback_dislike_url], [feedback_neutral_url] – эти теги все еще поддерживаются, но являются устаревшими, вместо них советуем использовать [feedback_url]

[feedback_like_url] - ссылка на оценку дайджеста "Like" - "Нравится"

[feedback_dislike_url] - ссылка на оценку дайджеста "Dislike" - "Не нравится"

[feedback_neutral_url] - формирует ссылку нейтральной оценки дайджеста

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

[reaction_url] – формирует ссылку для реакций

Параметры:

  • action – значение поля Реакция из справочника "NM_РеакцииВРассылке" в КИС "Восточный экспресс"
  • redirect – ссылка на страницу, на которую переходит пользователь после выставления реакции
  • redirect2 - ссылка на страницу, на которую переходит пользователь после указания комментария

[create_bill_url] – формирует ссылку скачивания счета

Параметры:

  • text – текст ссылки, который будет вставлен в теге <a> (по умолчанию, Скачать счет)
  • urlonly – если значение="true", то будет выведена только ссылка, иначе ссылка, обернутая в тэг <a> (по умолчанию, false)
  • desc - комментарий, который будет вставлен в счет
  • template – ид шаблона счета или ид документа образовательной услуги
Внимание: данный макрос используется только в конкретных статьях и публикациях (записях), в пределах дайджеста он не работает

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

В тексте конкретной записи (в начале или ее конце) указать - [create_bill_url template="394166847" text="Скачать счет" desc="30.11.2016"]

Получатель рассылки увидит в тексте конкретной публикации - Скачать счет

В тексте конкретной записи (в начале или ее конце) указать - [create_bill_url template="394166847" urlonly="true" desc="30.11.2016"]

Получатель рассылки увидит в тексте конкретной публикации - http://ivanovo.newsmine.ru/nm/createbill?token=8aa01c112811d5b16b344d47d24696e43cbbdb5e&template=394166847&descr=30.11.2016

Макросы для статей:

[posts] ... [/posts] - формирует список записей, упорядоченных по дате публикации

Параметры:

  • type – тип записей, который принимает следующие значения:
    • post - рассылка только статей
    • post,seminar,webinar - рассылка и статей и семинаров в одной ленте
    • seminar - рассылка только семинаров

    Если параметр type не указан, то по умолчанию в рассылку попадают только статьи

Пример

[posts type="seminar"][/posts]

Внутри тегов [posts] ... [/posts] могут использоваться следующие макросы статьи:

[title] - наименование статьи (анонса)
[post_url] - url статьи, который сформирован по следующим правилам - url_сайта/news/токен_клиента/id_статьи

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

Целесообразно использовать этот макрос в сочетании с макросом [title], указывая его в виде ссылки. На уровне html-разметки это будет выглядеть следующим образом - <a href="[post_url]">[title]</a>

Также этот макрос можно использовать для ссылки Читать далее

[content] - текст статьи (анонса)
[date] - дата публикации статьи (анонса)

[thumbnail_url] - ссылка на миниатюру статьи

[thumbnail] - ссылка на миниатюру статьи, но обернутая в тэг <img> размером 128 на 128 пикселей

Если рассылка выполняется только для семинаров (параметр type="seminar"), то поддерживаются следующие специфические теги:

[seminar_invitation] - формирует ссылку на запись

Параметры:

  • text – текст ссылки, который будет вставлен в теге <a> (по умолчанию, Записаться)
  • urlonly – если значение="true", то будет выведена только ссылка, иначе ссылка, обернутая в тэг <a>

[seminar_begin_date] - дата начала в формате 21.03.2017 10:00

[seminar_end_date] - дата окончания в формате 22.03.2017 18:00

Параметры:

  • format - формат вывода даты (%vmg - месяц прописью в родительном падеже, остальные форматы даты используются,  как это принято в php)
[seminar_price] - цена семинара, если услуга бесплатна, то выводится "Бесплатно"
[seminar_location] - место проведения мероприятия

[seminar_type] - вид семинара

[seminar_start_color] - начальный цвет градиента у вида семинара

[seminar_end_color] - конечный цвет градиента у вида семинара

Если рассылка выполняется только для вебинаров (параметр type="webinar"), то  поддерживаются все стандартные тэги для статьи, а также следующие специфические теги:

[webinar_start_date] - дата проведения вебинара в формате 21.03.2017 10:00

[webinar_invitation] - формирует ссылку на покупку видеозаписи

Параметры:

  • text – текст ссылки, который будет вставлен в теге <a> (по умолчанию, Купить запись)
  • urlonly – если значение="true", то будет выведена только ссылка, иначе ссылка, обернутая в тэг <a>
[webinar_price] - цена видеозаписи

Также для семинаров и вебинаров доступны теги для вывода лекторов:

[lecturers] ... [/lecturers] - формирует список лекторов

Внутри тегов [lecturers] ... [/lecturers] могут использоваться следующие макросы лектора:

[lecturer_name] - ФИО лектора

[lecturer_thumbnail_url] - ссылка на миниатюру лектора

[lecturer_thumbnail] - ссылка на миниатюру лектора, но обернутая в тэг <img> размером 128 на 128 пикселей

Внимание: данные макросы можно использовать без использования тега [lecturers] ... [/lecturers], но тогда будет выведен только один первый лектор

Макросы для формирования меню:

[toc] ... [/toc] - позволяет сформировать меню или краткое содержание дайджеста

Параметры:

  • unit – параметр меню, который принимает следующие значения:
    • post – меню формируется из заголовков статей
    • section – меня формируется из наименований разделов div categs, если вы используете их в теле шаблона
Внимание: на данный момент технология формирования меню была протестирована на gmail, mail, yandex, rambler, outlook, thunderbird - она поддерживается во всех этих сервисах, кроме rambler - это нужно учитывать. Мы написали письмо в rambler, возможно они сделают поддержку данной технологии

Внутри [toc] ... [/toc] могут быть следующие теги:

[toc-item] - ссылка, обернутая в тэг <а>, в текст ссылки подставляется заголовок статьи или наименование раздела

[toc-item-url] - ссылка на запись/раздел

[toc-item-title] - заголовок статьи/наименование раздела

Дивы:

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

[div categs="cat_slug1, cat_slug2, cat_slug3"] ... [/div] – раздел для статей определенных рубрик

Параметры:

  • categs – параметр, который принимает ярлык рубрики, статьи которых должны попадать в этот раздел. Ярлык рубрики можно узнать в списке рубрик блога "Записи/Рубрики"

Рубрики, которые не попадают ни в один из указанных в условии разделов, попадают в раздел [div categs="others"][/div]

В этих разделах должны использоваться макросы вывода статей [post] ... [/post].

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

[div tags=""] ... [/div] – группировка статей по разделам в соответствии с указанными в них метками

Параметры:

  • tags – данный параметр не имеет значений, при его использовании значение следует оставлять пустым

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

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

[tag_name] - наименование метки

В этом разделе должны использоваться макросы вывода статей [post] ... [/post].

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

[div seminar_type=""] ... [/div] – группировка семинаров по виду

Параметры:

  • seminar_type – данный параметр не имеет значений, при его использовании значение следует оставлять пустым

Для вывода наименования видов в начало группы используйте тег:

[term_name] - наименование вида

В этом разделе должны использоваться макросы вывода семинаров [post type="seminar"] ... [/post].

Работает по аналогии с [div tags=»»] ... [/div].

[div personal="true/false"] ... [/div] – разделы для безличных обращений и личных обращений в дайджесте

Параметры:

  • personal – параметр, который принимает следующие значения:
    • false – раздел будет отражаться только в том случае, если в разделе "Личный кабинет" карточки личности в КИС "Восточный экспресс" отмечено, что основной email не персональный
    • true – раздел будет отражаться, если основной email персональный

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

В шаблоне дайджеста, например, в заголовке письма, указать - [div personal="true"]Добрый день, [name] [patron][/div][div personal="false"]Добрый день, коллега[/div]!

В зависимости от значения флага "Это персональный email" получатель рассылки увидит:

- если указан персональный email - Добрый день, Иван Иванович!

- если указан не персональный email - Добрый день, коллега!

[div dateformat="true"]Привет! Вы получаете дайджест от %e %vmg %Y[/div] – раздел для отображения даты письма (%vmg - месяц прописью в родительном падеже, остальные коды, как это принято в php)

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

В шаблоне дайджеста, например, в обращении, указать - [div dateformat="true"]Привет! Вы получаете дайджест от %e %vmg %Y.[/div]

Получатель рассылки увидит - Привет! Вы получаете дайджест от 13 декабря 2016.

[div gender="муж.окончание|жен.окончание|бесполый"]Здравствуйте, уважаем%ge[/div] - окончание в соответствии с полом получателя

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

В шаблоне дайджеста, например, в обращении, указать - [div gender="ый|ая|ый(ая)"]Здравствуйте, уважаем%ge[/div] [name] [patron]!

Если у личности указан женский пол, то получатель рассылки увидит - Здравствуйте, уважаемая Маргарита Геннадьевна!

Если у личности указан мужской пол, то получатель рассылки увидит - Здравствуйте, уважаемый Михаил Федорович!

Если у личности не указан пол, то получатель рассылки увидит - Здравствуйте, уважаемый(ая) Ярослава Николаевна!

[div accessProfile=”true/false”] ... [/div] – раздел, который появляется в зависимости от того, открыт доступ к ЛК или нет

Параметры:

  • accessProfile – параметр, который принимает следующие значения:
    • true – раздел появится только для пользователей с доступом к ЛК
    • false – обратное действие

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

В шаблоне дайджеста, например, в подписи, указать: [div accessProfile='true'] Вы можете зайти в свой [user_url text="Личный кабинет"][/div] [div accessProfile='false']Обратитесь к администратору, чтобы получить доступ к личному кабинету[/div]!

Если у получателя рассылки открыта возможность доступа к личному кабинету, то он увидит - Вы можете зайти в свой Личный кабинет!

В противном случае - Обратитесь к администратору, чтобы получить доступ к личному кабинету!

[div ishaveresp=”true/false”] ... [/div] – раздел, который появляется в зависимости от того, есть ли у клиента, к которому относится контактное лицо, ответственный по обслуживанию или нет

Параметры:

  • ishaveresp – параметр, который принимает следующие значения:
    • true – раздел будет показан, если у клиента есть ответственный
    • false – обратное действие

При значении параметра ishaveresp=”true” можно использовать следующие теги:

[resp_name] - имя ответственного

[resp_surname] - фамилия ответственного

[resp_patronymic] - отчество ответственного

[resp_emails] - электронные адреса ответственного
[resp_phones] - телефоны ответственного
[resp_position] - должность ответственного
[resp_department] - наименование подразделения ответственного

[other_posts type="post" count="3"] ... [/other_posts] - раздел для самых популярных новостей по рубрикам, на которые получатель не подписан

Параметры:

  • count – количество записей
  • type – тип записей

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

[popular_posts type="post" count="3"] ... [/popular_posts] - раздел для самых популярных новостей по рубрикам, на которые получатель подписан и рубрика новости совпадает с рубрикой новости, из которой делается рассылка

Параметры:

  • count – количество записей
  • type – тип записей

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

Популярные новости подбираются по показателю «Просмотры» за последний месяц. Просмотром новости считается факт просмотра страницы новости с полным ее описанием.

Вернуться к содержанию ...