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

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

Shortcode

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

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

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

code

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

{shortcode code='woman_firstname'}

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='en_US'
locale='ru_RU'
{locale locale='en_US'}
{generate}

{locale locale='ru_RU'}
{generate}
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Текст-"рыба", часто используемый в печати и вэб-дизайне.Этот текст является стандартной "рыбой" для текстов на латинице с начала XVI века.

Info

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

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

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

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

Работает только в модулях Outlook
{info type='email_name'}
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

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

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

Атрибут Описание Пример Результат
Генерирует рандомный связанный контент на английском языке
{generate}
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
locale
Генерирует рандомный связанный контент на русском языке
{generate locale='ru_RU'}
Текст-"рыба", часто используемый в печати и вэб-дизайне.Этот текст является стандартной "рыбой" для текстов на латинице с начала 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'
Будет сгенерировано слово
{generate type='word'}
hello
type='word' count='3'
Будет сгенерировано 3 слова
{generate type='word' count='3'}
hello world apple
type='sentence'
Будет сгенерировано предложение
{generate type='sentence'}
In vel odio feugiat, malesuada quam condimentum, mollis mauris.
type='sentence' count='2
Будет сгенерировано 2 предложения
{generate type='sentence' count='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'
Будет сгенерирован параграф текста
{generate 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 параграфов текста
{generate type='text'}
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 параграфов текста
{generate type='text' min='1' max='3'}
In vel odio feugiat, malesuada quam ...
Nam accumsan id ante eu imperdiet. Suspendisse in ...
type='text' count='1'
Будет сгенерирован параграф текста. Параметр count указывает количество. Параметры min и max игнорируются, если они есть
{generate type='text' count='1'}
In vel odio feugiat, malesuada quam ...
type='number'
Генерирует целое число. Может быть отрицательным
{generate type='number'}
43 [Всегда будут числа от 0 до 100]
type='number' min='10' max='100'
Генерирует целое число. Может быть отрицательным. Параметрами min и max указываем диапазон числа
{generate type='number' min='10' max='100'}
54 [Всегда будут числа от 10 до 100]
type='number' count='5'
Генерирует целое число необходимого количества знаков. Параметр count указывает количество символов. Параметры min и max игнорируются, если они есть
{generate type='number' count='5'}
82363 [Всегда будут числа от 10000 до 99999]
type='float'
Генерирует число со знаками после запятой. Может быть отрицательным
{generate type='float'}
12,64 [Всегда будет число от 0,00 до 100,00 с двумя знаками после запятой обязательно]
type='float' min='100' max='300'
Генерирует число со знаками после запятой. Параметрами min и max указываем диапазон числа
{generate type='float' min='100' max='300'}
128,64 [Всегда будет число от 100,00 до 300,00 с двумя знаками после запятой обязательно]
type='float' count='8'
Генерирует число со знаками после запятой. Параметр count указывает общее количество символов. Параметры min и max игнорируются, если они есть
{generate type='float' count='8'}
123456,78 [Всегда будет число от 100000,00 до 999999,99 с двумя знаками после запятой обязательно]
type='float' decimals='4'
Генерирует число со знаками после запятой. Параметр указывает количество знаков после запятой
{generate type='float' decimals='4'}
12,1234 [Всегда будет число от 0 до 100 с 4 знаками после запятой обязательно]
type='name'
Будет сгенерировано произвольные фамилия и имя
{generate type='name'}
Karen Millen
type='name' gender='both'
Будет сгенерировано женское или мужское имя и фамилия
{generate type='name' gender='both'}
Karen Millen
type='name' gender='male'
Будет сгенерировано мужское имя и фамилия
{generate type='name' gender='male'}
John Smith
type='name' gender='female'
Будет сгенерировано женское имя и фамилия
{generate type='name' gender='female'}
Karen Millen
type='name' format='both'
Будет сгенерированы фамилия и имя в указанном порядке
{generate type='name' format='both'}
Smith John
type='name' format='both_reverse'
Будет сгенерированы имя и фамилия в указанном порядке
{generate type='name' format='both_reverse'}
John Smith
type='name' format='first'
Будет сгенерировано имя
{generate type='name' format='first'}
John
type='name' format='last'
Будет сгенерирована фамилия
{generate type='name' format='last'}
Smith
type='date'
Дата и время
{generate type='date'}
2019-01-23 12:34:51
type='date' format='timestamp'
Количество секунд с 1970-01-01 00:00:00
{generate type='date' format='timestamp'}
1437889193
type='date' format='Y-m-d H:i:s'
Формат даты совмесный с PHP функцией date
{generate type='date' format='Y-m-d H:i:s'}
2019-01-23 12:34:51
type='date' min='2016-01-15' max='2018-12-31'
Диапазон даты от и до. Обязательно подавать в указанном формате
{generate type='date' min='2016-01-15' max='2018-12-31'}
2017-01-23 12:34:51
type='date' now
Дата и время на момент отправки письма
{generate type='date' now}
2019-05-12 12:34:51
type='string'
Шаблон для генерации символов asci
{generate type='string'}
qB7vGnnyYADyYx2Gb2.... [Будет сгенерировано от 40 до 100 символов (буквы большие, маленькие + цифри)]
type='string' min='5' max='7'
Шаблон для генерации символов asci. Будут сгенерированы символы в диапазоне от и до
{generate type='string' min='5' max='7'}
J1jhuS [Будет сгенерировано от 5 до 7 символов (букви большие, маленькие + цифри)]
type='string' count='12'
Шаблон для генерации символов asci. Будет сгенерировано ровное количество символов
{generate type='string' count='12'}
BPkPsi5smJir [Будет сгенерировано 12 символов (букви большие, маленькие + цифри)]
type='string' upper
Шаблон для генерации символов asci большим регистром
{generate type='string' upper}
SDGIOCXLERP....
type='string' lower
Шаблон для генерации символов asci маленьким регистром
{generate type='string' lower}
sdjixcownewfme...
type='string' numbers
Шаблон для генерации цифр
{generate type='string' numbers}
12472389729034873...
type='string' special
Шаблон для генерации специальных символов
{generate type='string' special}
!@$@#%#$&^@%^%&^...
type='regex' pattern='[a-z]{3}.[0-9]{5}'
Шаблон для произвольной генерации символов в нужном количестве
{generate type='regex' pattern='[a-z]{3}.[0-9]{5}'}
fxo.49123
type='country'
Будет сгенерировано название страны
{generate type='country'}
Zimbabwe
type='city'
Будет сгенерирован город
{generate type='city'}
New York
type='address'
Будет сгенерирован адрес в произвольном порядке
{generate type='address'}
439 Karley Loaf Suite 897
type='address' full
Будет сгенерирован полный адрес в произвольном порядке
{generate type='address' full}
8888 Cummings Vista Apt. 101, Susanbury, NY 95473
type='phone'
Будет сгенерирован телефон
{generate type='phone'}
+380918265162
type='card'
Шаблон для генерации номера кредитной карты
{generate type='card'}
2847217284910399
type='ip'
Будет сгенерирован произвольный IP4
{generate type='ip'}
185.14.251.211
type='ip' format='ipv6'
Будет сгенерирован произвольный ipv6
{generate type='ip' format='ipv6'}
2001:0db8:85a3:0000:0000:8a2e:0370:7334

Repeat

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

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

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

Chance

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

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

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

Shuffle

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

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

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

Encode

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

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

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