Документация макросов

Библиотека готовых тегов для генерации данных, символов, значений. Используйте в шаблоне, в теме или теле письма, для создания сложных конструкций рандомизации.

Shortcode

Формат - не парный.

Тег подставляет значения персональных шорткодов пользователя.

Атрибут Описание Пример Результат

code
Указывает какой shortcode необходимо подставить
Alexsandra

id

 Все теги shortcode с одинаковыми значениями этого атрибута, будут иметь одинаковое значение
Допустим, у нас есть два шорткода:
1. first_name: alex|dima|oleg
2. last_name: vasichkin|ivanov|petrov

Пример получается такой:
{shortcode id='name' code='first_name'} +
{shortcode id='name' code='last_name'}
dima + ivanov
oleg + petrov

Locale

Формат - не парный.

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

Атрибут Описание Пример Результат
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения. Локация по умолчанию.
{locale locale='en_US'}
{generate}
Английский язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='ru_RU'}
{generate}
Русский язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='al_AL'}
{generate}
Албанский язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='am_AM'}
{generate}
Арабский язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='az_AZ'}
{generate}
Азейбарджанский язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='da_DA'}
{generate}
Датский язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='de_DE'}
{generate}
Немецкий язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='el_EL'}
{generate}
Греческий язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='es_ES'}
{generate}
Испанский язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='fl_FL'}
{generate}
Финский язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='fr_FR'}
{generate}
Французский язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='hu_HU'}
{generate}
Венгерский язык
locale
Генерирует рандомный связанный контент, слова, абзацы, параграфы, предложения.
{locale locale='it_IT'}
{generate}
Итальянский язык

Info

Формат - не парный.

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

Атрибут Описание Пример Результат
type='email_email'
Адрес на который отправляется письмо. Тег можно кодировать в base64 или quoted-printable.

Работает в модулях Outlook, WP.PL, Mail.com, Web.de, Gmx.net
client.email@client.domain.com
type='email_name'
Имя подписчика с базы, на которое отправляется письмо

Работает в модулях Outlook, Mail.com, Web.de, Gmx.net
Client Name

Random

Формат - парный.

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

Атрибут Описание Пример Результат
Случайным образом выбирает одно или несколько значений
{random}Hello.|Good day.|Hey.{/random}
Hello.
id
Все теги random с одинаковыми значениями атрибута ID, будут отражены в одинаковом порядке
{random id='01'}one|two|three{/random} +
{random id='01'}alex|kostia|masha{/random}
three + masha
type='tag'
Теги item. Разделяет по тегам
{random type='tag'}{i}one.{/i}{i}two.{/i}{i}three.{/i}{/random}
three.
type='word'
Слова. Разделяет по пробелу
{random type='word'}one two three{/random}
one
type='letter'
Буквы. Каждый символ берет как отдельную часть, в том числе пробелы, пунктуацию и теги
{random type='letter'}hello{/random}
h
type='sentence'
Предложения. Разделяет по точке
{random type='sentence'}I love Kiev. I was born in Kiev. I live in Kiev.{/random}
I live in Kiev.
type='row'
Строки. Разделяет по Enter
{random type='row'}
one
two
three
{/random}
two

Generate

Формат - не парный.

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

Атрибут Описание Пример Результат
Генерирует рандомный связанный контент на английском языке
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
locale
Генерирует рандомный связанный контент на русском языке
Текст-"рыба", часто используемый в печати и вэб-дизайне.Этот текст является стандартной "рыбой" для текстов на латинице с начала XVI века.
id
Генерирует контент. Все теги generate с одинаковыми значениями атрибута ID, будут иметь одинаковые значения
1: {generate id='01'}
2: {generate}
3: {generate id='01'}
1: It has survived not only five centuries...
2: Lorem Ipsum is simply dummy text...
3: It has survived not only five centuries...
type='word'
Будет сгенерировано слово
hello
type='word' count='3'
Будет сгенерировано 3 слова
hello world apple
type='sentence'
Будет сгенерировано предложение
In vel odio feugiat, malesuada quam condimentum, mollis mauris.
type='sentence' count='2
Будет сгенерировано 2 предложения
Quisque convallis, nunc vel euismod tincidunt, nisl risus faucibus est, nec varius lacus ante vel dolor. Nulla lacinia euismod magna, in faucibus dolor bibendum et.
type='paragraph'
Будет сгенерирован параграф текста
Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.
type='text'
Будет сгенерировано от 3 до 10 параграфов текста
In vel odio feugiat, malesuada quam ...
Nam accumsan id ante eu imperdiet. Suspendisse in ...
Nunc vestibulum erat sit amet tellus sodales ...
type='text' min='1' max='3'
Будет сгенерировано от 1 до 3 параграфов текста
In vel odio feugiat, malesuada quam ...
Nam accumsan id ante eu imperdiet. Suspendisse in ...
type='text' count='1'
Будет сгенерирован параграф текста. Параметр count указывает количество. Параметры min и max игнорируются, если они есть
In vel odio feugiat, malesuada quam ...
type='number'
Генерирует целое число. Может быть отрицательным
43 [Всегда будут числа от 0 до 100]
type='number' min='10' max='100'
Генерирует целое число. Может быть отрицательным. Параметрами min и max указываем диапазон числа
54 [Всегда будут числа от 10 до 100]
type='number' count='5'
Генерирует целое число необходимого количества знаков. Параметр count указывает количество символов. Параметры min и max игнорируются, если они есть
82363 [Всегда будут числа от 10000 до 99999]
type='float'
Генерирует число со знаками после запятой. Может быть отрицательным
12,64 [Всегда будет число от 0,00 до 100,00 с двумя знаками после запятой обязательно]
type='float' min='100' max='300'
Генерирует число со знаками после запятой. Параметрами min и max указываем диапазон числа
128,64 [Всегда будет число от 100,00 до 300,00 с двумя знаками после запятой обязательно]
type='float' count='8'
Генерирует число со знаками после запятой. Параметр count указывает общее количество символов. Параметры min и max игнорируются, если они есть
123456,78 [Всегда будет число от 100000,00 до 999999,99 с двумя знаками после запятой обязательно]
type='float' decimals='4'
Генерирует число со знаками после запятой. Параметр указывает количество знаков после запятой
12,1234 [Всегда будет число от 0 до 100 с 4 знаками после запятой обязательно]
type='name'
Будет сгенерировано произвольные фамилия и имя
Karen Millen
type='name' gender='both'
Будет сгенерировано женское или мужское имя и фамилия
Karen Millen
type='name' gender='male'
Будет сгенерировано мужское имя и фамилия
John Smith
type='name' gender='female'
Будет сгенерировано женское имя и фамилия
Karen Millen
type='name' format='both'
Будет сгенерированы фамилия и имя в указанном порядке
Smith John
type='name' format='both_reverse'
Будет сгенерированы имя и фамилия в указанном порядке
John Smith
type='name' format='first'
Будет сгенерировано имя
John
type='name' format='last'
Будет сгенерирована фамилия
Smith
type='date'
Дата и время
2019-01-23 12:34:51
type='date' format='timestamp'
Количество секунд с 1970-01-01 00:00:00
1437889193
type='date' format='Y-m-d H:i:s'
Формат даты совмесный с PHP функцией date
2019-01-23 12:34:51
type='date' min='2016-01-15' max='2018-12-31'
Диапазон даты от и до. Обязательно подавать в указанном формате
2017-01-23 12:34:51
type='date' now
Дата и время на момент отправки письма
2019-05-12 12:34:51
type='string'
Шаблон для генерации символов asci
qB7vGnnyYADyYx2Gb2.... [Будет сгенерировано от 40 до 100 символов (буквы большие, маленькие + цифри)]
type='string' min='5' max='7'
Шаблон для генерации символов asci. Будут сгенерированы символы в диапазоне от и до
J1jhuS [Будет сгенерировано от 2 до 3 символов (букви большие, маленькие + цифри)]
type='string' count='12'
Шаблон для генерации символов asci. Будет сгенерировано ровное количество символов
BPkPsi5smJir [Будет сгенерировано 12 символов (букви большие, маленькие + цифри)]
type='string' upper
Шаблон для генерации символов asci большим регистром
SDGIOCXLERP....
type='string' lower
Шаблон для генерации символов asci маленьким регистром
sdjixcownewfme...
type='string' numbers
Шаблон для генерации цифр
12472389729034873...
type='string' special
Шаблон для генерации специальных символов
!@$@#%#$&^@%^%&^...
type='regex' pattern='[a-z]{3}.[0-9]{5}'
Шаблон для произвольной генерации символов в нужном количестве
fxo.49123
addsimbol
Вставляет указанный символ через рандомное количество ОТ и ДО
Сл#ова# слова# сл#ова#
addspace
Вставляет пробел через указанное количество символов ОТ и ДО
hfRnjr gdgTOBgf gr FBK hbgfreuhu hfygfyyyfg
external
Подгружает данные с файла .txt находящийся на стороннем VPS в рандомном порядке. До 10 000 строк в файл.

Repeat

Формат - парный.

Тег формирует повторение контента.

Атрибут Описание Пример Результат
repeat
Повторение контента
word.word.word.word.word.word. [Контент будет повторен от 3 до 10 раз]
repeat min='1' max='4'
Повторение контента от и до
word.word.word. [Контент будет повторен от 1 до 4 раз]
repeat count='3'
Повторение контента определенное кол-во раз
word.word.word. [Контент будет повторен 3 раза]

Chance

Формат - парный.

Тег отвечает за вероятность отображения контента.

Атрибут Описание Пример Результат
percent
Значение отвечает за вероятность, с которой контент будет отображен.
С вероятностью в 50% написанный контент будет в письме

Shuffle

Формат - парный.

Тег перемешивает контент в рандомном порядке.

Атрибут Описание Пример Результат
shuffle
Перемешивает контент. Разделяет по слеш
Two.Three.One.
shuffle type='tag'
Перемешивает контент. Разделяет по тегу
two.one.three.
shuffle type='word'
Перемешивает контент. Разделяет по пробелу.
two three one
shuffle type='letter'
Перемешивает контент. Разделяет по буквам. Каждый символ берет как отдельную часть, включая числа, пробелы, пунктуацию.
leohl
shuffle type='sentence'
Перемешивает контент. Разделяет по точке.
Three. One. Two.
shuffle type='row'
Перемешивает контент. Разделяет по Enter.
{shuffle type='row'}
one
two
three
{/shuffle}
three
two
one

Encode

Формат - парный.

Тег кодирует контент.

Атрибут Описание Пример Результат
encoding='base64'
Контент будет закодирован в base64
0KDRg9GH0LrQsA==
encoding='quoted'
Контент будет закодирован в quoted-printable
=D0=A0=D1=83=D1=87=D0=BA=D0=B0
encoding='ascii'
Контент будет транслитерированный в ascii символы нижнего реестра. Пробелы будут заменены на подчеркивания. charset будет проигнорирован.
ruchka