Часто задаваемые вопросы (FAQ-A)

SubScript для выпусков рассылки

Версия 1.36 от 30.01.2012

[ НОВОЕ 30/I ] Новые команды issue_dt_* позволяет вставить дату выпуска в нужном вам формате

[ НОВОЕ 02/IX ] Новая команда video позволяет вставить видеоролик в выпуск рассылки

[ НОВОЕ 04/II ] Новые команды member_surname, member_name и member_fathname позволяют обратиться к подписчику по имени

Полное название выпуска рассылки - issue_name
Добавление к названию выпуска рассылки - issue_name_add
Адрес выпуска в архиве - issue_archive_url
Адрес предыдущего выпуска в архиве - issue_archive_prev_url
Номер выпуска рассылки - issue_number
Номер выпуска рассылки с начала года - issue_number_year
Дата выпуска - issue_date
Время выпуска - issue_time
Дата и время выпуска - issue_datetime
Компоненты даты и времени выпуска - issue_dt_Y,issue_dt_M,issue_dt_D,issue_dt_h,issue_dt_m,issue_dt_s [ НОВОЕ 02/IX ]
Метка начала подписи - --
Имя отправителя письма в лист - issue_sender
Номер письма отправителя в лист - issue_sender_letter
Фамилия подписчика - member_surname
Имя подписчика - member_name
Отчество подписчика - member_fathname
Код рассылки - list_id
Название рассылки - list_name
Адрес сайта рассылки - list_url
Возраст рассылки в днях - list_age_days
Титул автора рассылки - list_author_title
Имя автора рассылки - list_author_name
Адрес автора рассылки - list_author_email
Ссылка на адрес автора рассылки - list_author_mailto
Стандартный адрес для писем автору - list_owner_email
Стандартный общий адрес для писем автору - list_author_email_std
Счетчик количества подписчиков - list_count
Количество подписчиков - list_count_text
Адрес кнопки-счетчика количества подписчиков - list_count_url
Динамика количества подписчиков за вчера - list_dynamo
Динамика количества подписчиков за последнии 7 дней - list_dynamo7
Включение содержимого произвольной веб-страницы - http://
Включение содержимого файла по FTP - ftp://
Включение видеоролика по url источника - video
Ссылка на архив рассылки - list_archive
Адрес архива рассылки - list_archive_url
Ссылка на описание рассылки - list_descr
Адрес описания рассылки - list_about_url и list_about_email
Адрес логотипа рассылки - list_logo_url
Адрес правил листа - list_rules_url и list_rules_email
Адрес FAQ листа - list_faq_url и list_faq_email
Адрес для писем в лист - list_submit
Адрес подписки на рассылки или лист - list_subscribe_email
Адрес отписки от рассылки или лист - list_unsubscribe_email
Адрес подписки на дайджест листа - list_subscribe_digest_email
Адрес подписки "только веб" на лист - list_subscribe_webonly_email
Ссылка на статистику рассылки - list_stat
Адрес статистики рассылки - list_stat_url
Ссылка на каталог картинок рассылки - list_image_url
Шкала оценки выпуска через сайт - list_votebar_site
Шкала оценки выпуска через почту - list_votebar_site
Форма быстрой подписки - form_quick
Установить переменную - set
Получить переменную - var
Условие выбора по коду рассылки - list

Условие выбора по коду текущей службы ЗаРаз! - gate

Адрес выпуска в архиве [ SUBSCRIBE issue_archive_url ]

Описание - адрес выпуска в архиве

Образец - https://subscribe.ru/news.citycat/200405/04053456.html

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

Адрес предыдущего выпуска в архиве [ SUBSCRIBE issue_archive_prev_url номер]

Описание - адрес предыдущего выпуска в архиве

"Номер" - не обязательный параметр показывающий на сколько выпусков назад требуется ссылка. Допустимы значения начиная с единицы. Для ссылки просто на непосредственно предыдущий выпуск значение номера равное одному можно не писать.

Образец - https://subscribe.ru/news.citycat/nav/prev/200405/04053456.html

Только для новостных рассылок.

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

Полное название выпуска рассылки [ SUBSCRIBE issue_name ]

Описание - полное название выпуска рассылки

Образец - Новости Городского Кота от 4 мая

Напомним, что оно составляется из названия рассылки и возможного добавления к нему, задаваемого при вводе рассылки или оператором issue_name_add.

Добавление к названию выпуска рассылки

Получение:

[ SUBSCRIBE issue_name_add ]

Описание - добавление к названию выпуска рассылки

Образец - от 4 мая

Изменение:

[ SUBSCRIBE issue_name_add добавка к названию ]

Описание - изменение добавления к названию выпуска рассылки

Образец - пусто, оператор не имеет видимого результата

Результат - Последующие операторы issue_name и issue_name_add вывод значение с учетом внесенного изменения. Соответственно изменится и значение поля Subject: (Тема:) письма. Если надо вообще отменить добавку, то используйте [ SUBSCRIBE issue_name_add - ]

Основное назначение - возможность менять добавление к названию выпуска через страницу выкачиваемую оператором http://.

Номер выпуска рассылки [ SUBSCRIBE issue_number ]

Описание - номер выпуска рассылки

Образец - 123

Номер выпуска рассылки увеличивается на один с каждым HTML-выпуском рассылки или любым выпуском листа.

Переменная имеет самостоятельную нумерацию для каждой службы подключённой через сервис ЗаРаз!.

Установить первоначальные значения всем вариантам переменной и менять их в последующем можно в "Настройке выпусков".

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

Эту команду можно использовать в теме выпуска рассылки, записав её там как просто issue_number

Номер выпуска рассылки с начала года [ SUBSCRIBE issue_number_year ]

Описание - номер выпуска рассылки с начала года

Образец - 12345

Номер выпуска рассылки c начала года увеличивается на один с каждым HTML-выпуском рассылки или любым выпуском листа в текущем году.

Эту команду можно использовать в теме выпуска рассылки, записав её там как просто issue_number_year

Дата выпуска рассылки [ SUBSCRIBE issue_date ]

Описание - дата выпуска рассылки

Образец - 2000-02-31

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

Писать нам про "странный формат" не стоит - это единственный формат для представления даты, который не вызывает проблем с опознанием где день, а где месяц.

Используя команды issue_dt_* можно создать формат по своему вкусу.

Владельцы дискуссионных листов, обратите внимание, что это не то, что у писем в Date:

Эту команду можно использовать в теме выпуска рассылки, записав её там как просто issue_date

Время выпуска рассылки [ SUBSCRIBE issue_time ]

Описание - время выпуска рассылки

Образец - 25:44:12

Учтите, что выпуск рассылки может быть задержана на время выпуска более приоритетных рассылок, и время может быть не то, которое Вы ожидаете.

Используя команды issue_dt_* можно создать формат по своему вкусу.

Дискуссионные листы, обратите внимание, что это не то, что у писем в Date:

Эту команду можно использовать в теме выпуска рассылки, записав её там как просто issue_time

Дата и время выпуска рассылки [ SUBSCRIBE issue_datetime ]

Описание - дата и время выпуска рассылки

Образец - 2000-02-31 25:44:12

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

Используя команды issue_dt_* можно создать формат по своему вкусу.

Дискуссионные листы, обратите внимание, что это не то, что у писем в Date:

Эту команду можно использовать в теме выпуска рассылки, записав её там как просто issue_datetime

Компоненты даты и времени выпуска рассылки [ НОВОЕ 30/I ] [ SUBSCRIBE issue_dt_Y ]
[ SUBSCRIBE issue_dt_M ]
[ SUBSCRIBE issue_dt_D ]
[ SUBSCRIBE issue_dt_h ]
[ SUBSCRIBE issue_dt_m ]
[ SUBSCRIBE issue_dt_s ]

Описание - Компоненты даты и времени выпуска рассылки.
Y - Год. всегда 4 цифры.
M - Месяц. всегда 2 цифры.
D - День. всегда 2 цифры.
h - Час. всегда 2 цифры.
m - Минута. всегда 2 цифры.
s - Секунда. всегда 2 цифры.

Дискуссионные листы, обратите внимание, что это не то, что у писем в Date:

Эту команду можно использовать в теме выпуска рассылки, записав её там как просто issue_dt_

Метка начала подписи [ SUBSCRIBE -- ]

Описание - Полезно для дискуссионных листов. На место команды вставляется стандартная последовательность "-- \n" обозначающая, что далее в письме идет подпись. Это позволяет не включать подпись исходного письма в его цитату при написании на него ответа.

В отличие от всех других команд, данная команда имеет следующие особенности:

Она должна быть записана с начала строки
После нее в строке должно быть или совсем ничего или только символы пробела
Команда удаляет за собой перевод строки, в которой она написана (так как во вставляемом тексте перевод строки и так есть)
В уже обработанной части письма не должно быть другого экземпляра метки начала подписи

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

Код рассылки [ SUBSCRIBE list_id ]

Описание - код рассылки

Образец - news.citycat

Название рассылки [ SUBSCRIBE list_name ]

Описание - название рассылки

Образец - Новости Городского Кота

Адрес сайта рассылки [ SUBSCRIBE list_url ]

Описание - адрес сайта рассылки как он указан в конфигурации рассылки

Образец - http://www.citycat.ru

Возраст рассылки в днях [ SUBSCRIBE list_age_days ]

Описание - Количество дней с момента открытия рассылки

Образец - 12345

Имя отправителя письма в лист [ SUBSCRIBE issue_sender_name ]

Описание - Имя отправителя из поля От:

Образец - Иван Иванович

Для рассылок - пусто

Номер письма подписчика в лист [ SUBSCRIBE issue_sender_letter ]

Описание - Номер письма подписчика в лист. Т.е. сколько писем от него уже было в этот лист+1.

Образец - 12345

Для рассылок - пусто

Фамилия подписчика [ SUBSCRIBE member_surname ]

Описание - Фамилия подписчика из анкеты, может быть пусто

Образец - Пупкина

Для выпусков - фамилия или пусто

Для авторских копий - слово Фамилия

Для архива - пусто

Имя подписчика [ SUBSCRIBE member_name ]

Описание - подписчика из анкеты, может быть пусто

Образец - Октябрина

Для выпусков - имя или пусто

Для авторских копий - слово Имя

Для архива - пусто

Отчество подписчика [ SUBSCRIBE member_fathname ]

Описание - подписчика из анкеты, может быть пусто

Образец - Натальевна

Для выпусков - отчество или пусто

Для авторских копий - слово Отчество

Для архива - пусто

Титул автора рассылки [ SUBSCRIBE list_author_title ]

Описание - титул автора рассылки как он указан в Конфигурации рассылки

Образец - Ведущий рассылки

Имя автора рассылки [ SUBSCRIBE list_author_name ]

Описание - имя автора рассылки как оно указано в Конфигурации рассылки

Образец - Городской Кот

Адрес автора рассылки [ SUBSCRIBE list_author_email ]

Описание - адрес автора рассылки как он указан в Конфигурации рассылки

Образец - ask@citycat.ru

Ссылка на адрес автора рассылки [ SUBSCRIBE list_author_mailto ]

Описание - титул и имя автора рассылки, ссылка с который ведет на его адрес

Образец в HTML - Ведущий рассылки Городской Кот

Образец в Тексте и SMS - Ведущий рассылки Городской Кот - ask@citycat.ru

Стандартный адрес для писем автору [ SUBSCRIBE list_owner_email ]

Описание - адрес вида код.рассылки-owner@subscribe.ru

Если адрес не настроен или рассылка "Бронзовая", или в Дискуссионном листе было менее 10 выпусков, то адрес не функционирует и в результате команды подставляется 'не активен'.

Стандартный общий адрес для писем автору [ SUBSCRIBE list_author_email_std ]

Описание - адрес автора вида -author@subscribe.ru

Образец - 0-author@subscribe.ru

Счетчик количества подписчиков [ SUBSCRIBE list_count]

Описание - счетчик количества подписчиков

Образец в HTML -

Образец в Тексте и SMS - 123456

Количество подписчиков [ SUBSCRIBE list_count_text ]

Описание - количество подписчиков на момент формирования письма

Образец - 123456

Адрес кнопки-счетчика количества подписчиков [ SUBSCRIBE list_count_url ]

Описание - адрес кнопки-счетчика количества подписчиков

Образец - https://subscribe.ru/stat/news.citycat/count.gif

Динамика количества подписчиков за вчера [ SUBSCRIBE list_dynamo ]

Описание - Динамика количества подписчиков за вчера

Образец - 12345

Динамика количества подписчиков за последнии 7 дней [ SUBSCRIBE list_dynamo7 ]

Описание - Динамика количества подписчиков за последние 7 дней

Образец - 12345

Ссылка на каталог картинок рассылки [ SUBSCRIBE list_image_url ]

Описание - подставляется абсолютная ссылка на каталог картинок рассылки.

Использование - для ссылки на картинку 123.gif надо написать

Ссылка на архив рассылки [ SUBSCRIBE list_archive ]

Описание - cлова 'Архив Рассылки' со ссылкой на него

Образец в HTML - Архив рассылки

Образец в Тексте и SMS - Архив рассылки - https://subscribe.ru/archive/news.citycat

Адрес архива рассылки [ SUBSCRIBE list_archive_url ]

Описание - адрес архива рассылки

Образец - https://subscribe.ru/archive/news.citycat

Ссылка на описание рассылки [ SUBSCRIBE list_descr ]

Описание - cлова 'Описание рассылки' со ссылкой на него

Образец в HTML - Описание рассылки

Образец в Тексте и SMS - Описание Рассылки - https://subscribe.ru/catalog/news.citycat

Адрес описания рассылки или листа [ SUBSCRIBE list_about_url ] и [ SUBSCRIBE list_about_email ]

Описание - адрес описания рассылки на вебе или для получения по почте

Образцы соответственно - https://subscribe.ru/catalog/news.citycat и news.citycat-about@subscribe.ru

Адрес логотипа рассылки [ SUBSCRIBE list_logo_url ]

Описание - адрес картинки-логотипа рассылки

Образец - https://subscribe.ru/catalog/news.citycat/logo.png

Адрес правил листа [ SUBSCRIBE list_rules_url ] и [ SUBSCRIBE list_rules_email ]

Описание - адрес правил листа на вебе или для получения по почте

Образцы соответственно - https://subscribe.ru/catalog/comp.soft.others.disc/rules и comp.soft.others.disc-rules@subscribe.ru

Адрес FAQ листа [ SUBSCRIBE list_faq_url ] и [ SUBSCRIBE list_faq_email ]

Описание - адрес правил листа на вебе или для получения по почте

Образец соответственно - https://subscribe.ru/catalog/comp.soft.others.disc/faq и comp.soft.others.disc-faq@subscribe.ru

Адрес для писем в лист [ SUBSCRIBE list_submit ]

Описание - адрес для писем в лист

Образец - comp.soft.others.disc-list@subscribe.ru

Адрес для подписки на рассылку или лист [ SUBSCRIBE list_subscribe_email ]

Описание - адрес для подписки на рассылку или лист

Образец - comp.soft.others.disc-sub@subscribe.ru

Для листов есть синоним list_subscribe_normal_email дающий адрес вида -normal@

Адрес для отписки от рассылки или листа [ SUBSCRIBE list_unsubscribe_email ]

Описание - адрес для отписки от рассылки или листа

Образец - comp.soft.others.disc-unsub@subscribe.ru

Адрес для подписки на дайджест листа [ SUBSCRIBE list_subscribe_digest_email ]

Описание - адрес для подписки на дайджест листа

Образец - comp.soft.others.disc-digest@subscribe.ru

Адрес для подписки на лист в режиме "читать с веба" [ SUBSCRIBE list_subscribe_webonly_email ]

Описание - адрес для подписки на лист в режиме "читать с веба"

Образец - comp.soft.others.disc-webonly@subscribe.ru

Есть синоним list_subscribe_nomail_email дающий адрес вида -nomail@

Ссылка на статистику рассылки [ SUBSCRIBE list_stat ]

Описание - cлова 'Статистика рассылки' со ссылкой на неё

Образец в HTML - Статистика рассылки

Образец в Тексте и SMS - Статистика рассылки - https://subscribe.ru/stat/news.citycat

Адрес статистика рассылки [ SUBSCRIBE list_stat_url ]

Описание - адрес Статистики рассылки

Образец - https://subscribe.ru/stat/news.citycat

Шкала оценки выпуска через сайт или почту [ SUBSCRIBE list_votebar_site ] и [ SUBSCRIBE list_votebar_email ]

Описание - Команды подставляют таблицу из пяти ячеек в каждой из которых содержится одна из оценок в виде цифры и ведущей с неё ссылки для голосования через сайт или почту. В архиве вместо таблицы подставляется <SPAN> с поясняющим текстом.

Для управления внешним видом используйте классы стилей sub_vote_table, sub_vote_a и sub_vote_span.

Команды работают только для информационных рассылок и только в HTML-версии Результат различается в письме подписчику и в архивной копии.

Образец в HTML-письме - 5 4 3 2 1

Образец в HTML-архиве - "Оценка выпуска возможна только из письма рассылки и не поддерживается в архиве"

Форма быстрой подписки [ SUBSCRIBE form_quick код1 код2 ... кодN ]

Описание - форма быстрой подписки на рассылки, коды которых указаны как параметры команды, c выбором формата и кодировки. Неизвестные коды рассылок молча игнорируются. При отсутствии параметров результат - пусто.

Пример - [ SUBSCRIBE form_quick news.citycat tv.all ]

Образец в SMS: - пусто, оператор игнорируется

Образец в HTML:

Образец в ТЕКСТ:

    Подписка на рассылки Subscribe.Ru:

      Новости проекта CityCat
        https://subscribe.ru/catalog/news.citycat

      ТВ программа.
        https://subscribe.ru/catalog/tv.all

Включение содержимого произвольной веб-страницы

[ SUBSCRIBE адрес-веб-страницы ]
[ SUBSCRIBE адрес-веб-страницы charset=xxx]

Описание - команда включает в текст письма содержимое указанной веб-страницы

Пример - [ SUBSCRIBE http://www.citycat.ru/~hac/ ]

Алгоритм работы:

Обращение к указанной странице для получения её содержимого. Если сервер не отвечает за 2 минуты - ошибка. Если сервер возвращает что-то отличное от текста или HTML - ошибка.
Определяется кодировка полученого результата
- Если в команде указана одна из подсказок
  - charset=koi8-r
  - charset=windows-1251
  - charset=utf-7
  - charset=utf-8
  - charset=utf-16
  то использутеся указанное в подсказке значение.
- Иначе, если ответ сервера содержит параметр кодировки, то используется указанное в параметре значение.
- Иначе, если в тип ответа HTML, проверяется наличие в полученной странице тега <META http-equiv="Content-Type" ... > и при его нахождении делается попытка найти название кодировки в параметре content.
- Если кодировка по прежнему не определилась, то веб-страница считается отданой в КОИ-8.
Если содержимое страницы есть HTML, то в дальнейшую обработку поступает только часть, содержащаяся между тегами <BODY> и </BODY>.
При использовании в содержимом выпуска, отсутствие или многократное присутствие какого-либо из этих тегов считается ошибкой и выпуск прерывается. Мы не можем угадать за вас что брать со страницы в таком случае.
При использовании в меню или дайджесте отсутвие или многократное присутвие этих тегов за ошибку не считается
Полученный текст фильтруется по правилам, описанным на странице Разметка страниц.
Результат фильтрации обрабатывается интерпретатором SubScript.
Полученный результат автоматически преобразуется в Текст, если формируется текстовое и SMS письмо, а указана страница в HTML. И наоборот - результат автоматически преобразуется в HTML, если формируется HTML-письмо, а указанная страница текстовая.
Итог включается в письмо рассылки как результат работы команды.

Особенности работы http:// в содержимом выпуска:

При использовании в меню или в дайджесте выпуска, команда http:// работает как вы и ожидаете - подставляет свой результат в ту часть письма, где она использована.

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

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

Обратите внимание:

Очень советуем проверять результат нажатием "Показать, как будет выглядеть письмо" на странице ввода рассылок.
При любой HTTP-ошибке рассылка будет прервана, а на приватный адрес автора будет отправлено уведомление.
Если при вводе рассылка откладывается для выпуска в определенное время, то обращение к указанным страницам произойдет не в момент ввода рассылки, а в момент ее реального выхода.
Если указанная страница состоит из фреймов, то результат будет совсем не тот, что Вы ожидаете. Указывайте прямой адрес страницы, входящий во фрейм.
Если указанная страница содержит скрипты на java или javascript, то они выполнены не будут.
Относительные ссылки страницы так и останутся относительными. Но только теперь они будут работать относительно письма рассылки. Если Вы включаете в рассылку свою страницу, то у Вас не должно быть проблем с указанием на этой странице абсолютных ссылок. А если чужую, то у Вас ничего соответственно и не получится без согласия автора страницы.

Включение содержимого файла по FTP

[ SUBSCRIBE адрес-файла ]
[ SUBSCRIBE адрес-файла charset=xxx]

Описание - команда включает в текст письма содержимое указанной веб-страницы

Пример - [ SUBSCRIBE ftp://ftp.funet.fi/README ]

Алгоритм работы:

Обращение за указанным файлом для получения содержимого. Если сервер не отвечает за 2 минуты - ошибка.
Определяется кодировка полученного результата
- Если в команде указана одна из подсказок
  - charset=koi8-r
  - charset=windows-1251
  - charset=utf-7
  - charset=utf-8
  - charset=utf-16
  то использутеся указанное в подсказке значение.
- Иначе, считается, что кодировка КОИ-8.
Полученный результат считается текстом и автоматически преобразуется в HTML если идёт выпуск HTML-версии рассылки.
Итог включается в письмо рассылки как результат работы команды.

Особенности работы ftp:// в содержимом выпуска:

Те же, что и описаной выше команды http://.

Обратите внимание:

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

Включение видеоролика по url источника

[ SUBSCRIBE video url ]
[ SUBSCRIBE video url width=xxx height=xxx]
[ SUBSCRIBE video url width=xxx height=xxx onerror=(ignore|stop) ]
[ SUBSCRIBE video url onerror=(ignore|stop) ]

Описание - Команда включает в текст письма скриншот видеоролика со ссылкой на выпуск в архиве, а само встроенное видео будет доступно на вебе в архиве.

Размеры скриншота в тексте письма и размеры встроенного видео в архиве задаются параметрами width (ширина) и height (высота).

Если ширина и высота не указаны, будут использованы размеры 300x150 пикселей.

В настоящее время возможность получения скриншотов доступна для сервисов youtube и rutube.

Если по каким-либо причинам скриншот получить не удалось, в текст письма будет вставлено стандартное изображение-заставка видеоролика указанных размеров.

Если в процессе анализа видео произошла ошибка (например не найден указанный источник), результат будет зависеть от значения параметра onerror.

Если onerror=ignore, то ошибка игнорируется, а в текст письма на место команды video ничего не вставляется. Иначе при возникновении ошибки рассылка будет прервана, а на приватный адрес автора будет отправлено уведомление.

Примеры:

    [ SUBSCRIBE video http://www.youtube.com/v/lAl28d6tbko&hl=en_US&fs=1&rel=0 ]

    [ SUBSCRIBE video http://www.youtube.com/v/lAl28d6tbko&hl=en_US&fs=1&rel=0 width=560 height=340]

    [ SUBSCRIBE video http://www.youtube.com/v/lAl28d6tbko&hl=en_US&fs=1&rel=0 width=560 height=340 onerror=ignore]

    [ SUBSCRIBE video http://www.youtube.com/v/lAl28d6tbko&hl=en_US&fs=1&rel=0 onerror=ignore]

Установить переменную [ SUBSCRIBE set name value ]

Описание - Команда устанавливает переменной с именем name значение val

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

Примеры:

    [SUBSCRIBE set odin раз]

    [SUBSCRIBE set neskolko_slov значение из нескольких слов]

    [SUBSCRIBE set slojnaia значие из нескольких
       слов
     записаное в несколько
        строчек
     ]

Особенность - после этой команды удаляется перевод строки (и возможные пробелы перед ним) - это позволяет избежать появления в текстовой версии пустых строк нарушающих оформление.

Подробнее - смотрите развернутый пример в описании сервиса "ЗаРаз!"

Получить переменную [ SUBSCRIBE var name ]

Описание - Подставляется значение переменной с именем name, установленное до этого командой set. Если такая переменная отсутствует, то не подставляется ничего.

Пример - [SUBSCRIBE var slojnaia]

Получим (см. примеры команды set):

    значение из нескольких
       слов
     записанное в несколько
        строчек

Подробнее - смотрите развернутый пример в описании сервиса "ЗаРаз!"

Условие выбора по коду текущей службы ЗаРаз! [ SUBSCRIBE gate code ]

Описание - команда-условие - идущий после нее текст будет включен в выпуск только если он формируется для службы ЗаРаз! с кодом code. Действие команды длится до следующей команды-условия gate, команды-условия list или до конца текста выпуска

Образец - [SUBSCRIBE gate subscribe]

Особенность - после этой команды удаляется перевод строки (и возможные пробелы перед ним) - это позволяет избежать появления в тектовой версии пустых строк нарушающих оформление.

В данный момент поддерживаются кода: all (обозначает "для всех сервисов"), subscribe, blog_0 ... blog_9.

Использование неизвестного системе кода приведет к тому, что идущий за командой текст не попадет ни в один вариант рассылки.

Предполагается, что в начале текста рассылки стоит [SUBSCRIBE gate all]. Специально эту команду указывать не надо.

Подробнее - смотрите развернутый пример в описании сервиса "ЗаРаз!"

Условие выбора по коду выпускаемой рассылки [ SUBSCRIBE list code ]

Описание - команда-условие - идущий после нее текст будет включен в выпуск только если в данный момент выпускает рассылка с кодом code. Действие команды длится до следующей команды-условия gate, команды-условия list или до конца текста выпуска

Образец - [SUBSCRIBE list news.citycat]

Специальный код all обозначает любую рассылку.

Предполагается, что в начале текста рассылки стоит [SUBSCRIBE list all]. Специально эту команду указывать не надо.

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

Не забудьте в таком шаблоне [SUBSCRIBE list all] перед кодом общего окончания шаблона !

Вот тестовый пример.
Введя его как письмо своей рассылки, нажмите "Показать, как будет выглядеть письмо" в обоих его вариантах и Вы получите наглядное представление о работе SubScript.


    <PRE>

    [ тест. это не команда ! должно остаться в письме как есть ]

    Полное название выпуска рассылки: [ SUBSCRIBE issue_name ]
    Добавка к названию выпуска рассылки: [ SUBSCRIBE issue_name_add ]
    Номер выпуска рассылки: [ SUBSCRIBE issue_number ]
    Дата выпуска рассылки: [ SUBSCRIBE issue_date ]

    Попробуем изменить добавку на 'абв где' [ SUBSCRIBE issue_name_add абв где ]
    Название: [ SUBSCRIBE issue_name ]
    Добавка: [ SUBSCRIBE issue_name_add ]

    Попробуем отменить добавку [ SUBSCRIBE issue_name_add - ]
    Название: [ SUBSCRIBE issue_name ]
    Добавка: [ SUBSCRIBE issue_name_add ]

    Код рассылки: [ SUBSCRIBE list_id ]
    Название рассылки: [ SUBSCRIBE list_name ]
    Адрес сайта рассылки: [ SUBSCRIBE list_url ]

    Титул автора рассылки: [ SUBSCRIBE list_author_title ]
    Имя автора рассылки: [ SUBSCRIBE list_author_name ]
    Адрес автора рассылки: [ SUBSCRIBE list_author_email ]
    Ссылка на адрес автора рассылки: [ SUBSCRIBE list_author_mailto ]

    Счетчик количества подписчиков: [ SUBSCRIBE list_count ]
    Количество подписчиков: [ SUBSCRIBE list_count_text ]
    Адрес кнопки-счетчика количества подписчиков: [ SUBSCRIBE list_count_url ]

    Ссылка на архив рассылки: [ SUBSCRIBE list_archive ]
    Адрес архива рассылки: [ SUBSCRIBE list_archive_url ]

    Ссылка на описание рассылки: [ SUBSCRIBE list_descr ]
    Адрес описания рассылки: [ SUBSCRIBE list_descr_url ]

    Ссылка на статистику рассылки: [ SUBSCRIBE list_stat ]
    Адрес статистики рассылки: [ SUBSCRIBE list_stat_url ]

    Форма поиска по архиву рассылки:
    [ SUBSCRIBE form_search ]

    Форма быстрой подписки на две рассылки:
    [ SUBSCRIBE form_quick news.citycat tv.all ]

    Включение содержимого произвольной веб-страницы:
    [ SUBSCRIBE http://win.subscribe.ru/ ]

    </PRE>

Рассылки Subscribe.Ru
Новости проекта CityCat ТВ программа