Часто задаваемые вопросы (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 надо написать

    <IMG SRC="[ 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
    ТВ программа

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

        Подписка на рассылки 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/ ]

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

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

    3. Если содержимое страницы есть HTML, то в дальнейшую обработку поступает только часть, содержащаяся между тегами <BODY> и </BODY>.
      При использовании в содержимом выпуска, отсутствие или многократное присутствие какого-либо из этих тегов считается ошибкой и выпуск прерывается. Мы не можем угадать за вас что брать со страницы в таком случае.
      При использовании в меню или дайджесте отсутвие или многократное присутвие этих тегов за ошибку не считается
    4. Полученный текст фильтруется по правилам, описанным на странице Разметка страниц.
    5. Результат фильтрации обрабатывается интерпретатором SubScript.
    6. Полученный результат автоматически преобразуется в Текст, если формируется текстовое и SMS письмо, а указана страница в HTML. И наоборот - результат автоматически преобразуется в HTML, если формируется HTML-письмо, а указанная страница текстовая.
    7. Итог включается в письмо рассылки как результат работы команды.

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

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

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

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

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

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


    Включение содержимого файла по FTP
    [ SUBSCRIBE адрес-файла ]
    [ SUBSCRIBE адрес-файла charset=xxx]

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

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

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

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

    3. Полученный результат считается текстом и автоматически преобразуется в HTML если идёт выпуск HTML-версии рассылки.
    4. Итог включается в письмо рассылки как результат работы команды.

    Особенности работы 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>
    
Наверх