Макросы

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

[bloglink] — адрес ссылки (url) блога

Пример использования:
в шаблоне дайджеста, например, в подписи, указать — Адрес блога в сети: [bloglink]
получатель рассылки увидит — Адрес блога в сети: http://ivanovo.newsmine.ru

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

Пример использования:
в шаблоне дайджеста, например, в подписи, указать — С уважением ваш [blogname]!
получатель рассылки увидит — С уважением ваш Мой Консультант!

Целесообразно использовать этот макрос в сочетании с макросом [bloglink], указывая его в виде ссылки. На уровне html-разметки это будет выглядеть следующим образом — С уважением ваш <a href=»[bloglink]»>[blogname]</a>.
Практически это делается следующим образом:
— выделить макрос [blogname] в тексте шаблона;
— на панели инструментов редактора нажать кнопку «Вставить/изменить ссылку (Ctrl+K)»;
— в поле ввода ссылки ввести макрос [bloglink];
— нажать кнопку «Применить».
получатель рассылки увидит — С уважением ваш Мой Консультант!

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

[cats] — список рубрик

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

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

text – текст ссылки, который будет вставлен в теге <a> в html форме ссылки
urlonly – если значение = true — выдает только ссылку, иначе выдает ссылку, обернутую в тэг <a> (по умолчанию имеет значение = false)
desc — комментарий, который будет вставлен в счет
template – либо id шаблона счета, либо id документа образовательной услуги

! Внимание : данный макрос используется только в конкретных статьях и публикациях (записях), в пределах дайджеста он не работает

Пример использования:
в тексте конкретной записи (в начале или ее конце) указать — [ 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

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

Пример использования:
в шаблоне дайджеста, например, в подписи, указать — В дайджесте [count] статей.
получатель рассылки увидит — В дайджесте 5 статей.

[date format=»%e %vmg %Y»] — выводит текущую дату. %vmg — месяц прописью в родительном падеже, остальные форматы даты используются,  как это принято в php.

Пример использования:
в шаблоне дайджеста, например, в подписи, указать — Дайджест сформирован [date format=»%e %vmg %Y %T»].
получатель рассылки увидит — Дайджест сформирован 13 декабря 2016 08:44:31.

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

Пример использования:
в шаблоне дайджеста, например, в подписи, указать — Дайджест сформирован [digdate] [digtime].
получатель рассылки увидит — Дайджест сформирован 07.12.2016 09:08:49.

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

Пример использования:
в шаблоне дайджеста, например, в подписи, указать — Дайджест сформирован [digdate] [digtime].
получатель рассылки увидит — Дайджест сформирован 07.12.2016 09:08:49.

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

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

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

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

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

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

action – тип обратной связи, который можно посмотреть и задать в справочнике «NM_ТипыОбратнойСвязи» в КИС «Восточный экспресс» в поле тип обратной связи

Справочник NM_ТипОбратнойСвязи

redirect — ссылка, на которую переходит пользователь после перехода по ссылке голосования

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

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

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

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

Пример использования:
в шаблоне дайджеста, например, в обращении, указать — Уважаемый [name] [patron] [surname]!
получатель рассылки увидит — Уважаемый Иван Иванович Иванов!

[user_url] — адрес ссылки (url), по которой пользователь может войти в личный кабинет: url_сайта/auth/токен_клиента

text – текст ссылки, который будет вставлен в теге <a> в html форме ссылки
urlonly – если значение=»true» — выдает только ссылку, иначе выдает ссылку, обернутую в тэг <a>

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

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

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

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

urlonly – если значение=»true» — выдает только ссылку, иначе выдает ссылку, обернутую в тэг <a>, в виде текста Отписаться

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

в шаблоне дайджеста, например, в подписи, указать — Чтобы отписаться от рассылки перейдите по ссылке: [unsubscribe_url urlonly=»true»].
получатель рассылки увидит — Чтобы отписаться от рассылки перейдите по ссылке: http://ivanovo.newsmine.ru/nm/unsubscribe?token=b4962e49fe8a6511087a94f744feee8e86708f8

Дивы

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

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

categs – параметр, который принимает ярлык рубрики, статьи которых должны попадать в этот раздел. Ярлык рубрики можно узнать в списке рубрик блога «Записи/Рубрики».
Рубрики, которые не попадают ни в один из указанных в условии разделов, попадают в раздел [div categs=»others»][/div].

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

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

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

tags – параметр, который служит элементом отбора и группировки статей в соответствии с указанными в них метками. Данный параметр не имеет значений, и при его использовании следует оставлять пусты, т.е. tags=»»

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

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

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

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

Пример использования:
в макете рассылки в нужном месте разместите конструкцию подобную этой:

[div tags=»»]

==============[tag_name]=================

[posts]

 [thumbnail]  [title] [content]
Читать далее
[date]

[/posts]

[/div]

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

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

Если personal=”false” – то раздел будет отражаться только в том случае, если в разделе «Личный кабинет» карточки контактного лица в «Восточном экспрессе» отмечено, что основной email не персональный

Если personal=”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” можно использовать следующие тэги:

[resp_name]                   =>  Имя ответственного,
[resp_surname]             =>  Фамилия ответственного,
[resp_patronymic]        =>  Отчество ответственного,
[resp_position]              =>  Должность ответственного,
[resp_department]       =>  Наименование подразделения ответственного.

Пример использования
в шаблоне дайджеста, например, в подписи, сформировать два раздела:

[div ishaveresp=»true»]
Ответственный по обслуживанию:
[resp_name] [resp_patronymic] [resp_surname]
[resp_position] / [resp_department]
[/div]

[div ishaveresp=»false»]
Вас обслуживает РИЦХХХ. Телефон для связи: 11-22-33
[/div]

Если за организацией получателя рассылки закреплен ответственный по обслуживанию, то получатель рассылки увидит: Ответственный по обслуживанию:
Марина Александровна Гайдук
специалист по информационному обслуживанию / Департамент информационного обслуживания

Иначе получатель рассылки увидит:
Вас обслуживает РИЦХХХ. Телефон для связи: 11-22-33

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

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

unit – параметр меню, который принимает 2 значения post и section:

post – меню формируется из заголовков статей
section – меня формируется из наименований разделов div categs, если вы используете их в теле шаблона

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

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

! Внимание : На данный момент технология формирования меню была протестирована на gmail, mail, yandex, rambler, outlook, thunderbird — она поддерживается во всех этих сервисах, кроме rambler —  это нужно учитывать. Мы написали письмо в rambler, возможно они сделают поддержку данной технологии

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

Макросы для статьи:

[posts] … [/posts]  — теги тела статьи

Для тега [posts][/posts] добавлена возможность указать параметр type. Параметр type может принимать следующие значения:

«post» — рассылка только статей
«post, seminar,webinar» — рассылка и статей и семинаров в одной ленте
«seminar» — рассылка только семинаров

Пример:

[posts type=»seminar»]
[/posts]

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

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

[title] — наименование статьи (анонса)
[content] — текст статьи (анонса)
[date] — дата публикации статьи (анонса)
[post_url] — url статьи, который сформирован по следующим правилам — url_сайта/news/токен_клиента/id_статьи
[thumbnail_url] — ссылка на миниатюру статьи
[thumbnail] — ссылка на миниатюру статьи, но обернутая в тэг img и с указанием размера 128 на 128 пикселей

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

[seminar_invitation] — ссылка на запись, поддерживает параметры

urlonly — только ссылка
text — текст для тега <a>, по умолчанию выводится тег <а> с текстом «записаться»

[seminar_begin_date] — дата начала в формате 21.03.2017 10:00
[seminar_end_date] — дата начала в формате 22.03.2017 18:00
[seminar_price] — цена семинара, если услуга бесплатна, то выводится «Бесплатно»
[seminar_location] — место проведения мероприятия.
[lecturer_name] — фио лектора
[lecturer_thumbnail_url] — ссылка на миниатюру лектора
[lecturer_thumbnail] — ссылка на миниатюру лектора, но обернутая в тэг img и с указанием размера 128 на 128 пикселей

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

[webinar_start_date] — дата проведения вебинара.
[lecturer_name] — фио лектора
[lecturer_thumbnail_url] — ссылка на миниатюру лектора
[lecturer_thumbnail] — ссылка на миниатюру лектора, но обернутая в тэг img и с указанием размера 128 на 128 пикселей

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