Документация макросов
Библиотека готовых тегов для генерации данных, символов, значений. Используйте в шаблоне, в теме или теле письма, для создания сложных конструкций рандомизации.
Shortcode
Формат - не парный.
Тег подставляет значения персональных шорткодов пользователя.
| Атрибут | Описание | Пример | Результат |
|---|---|---|---|
|
|
Указывает какой shortcode необходимо подставить
|
|
Alexsandra
|
|
|
Все теги 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'}onetwothree{/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'}onetwothree{/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
|