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

Бібліотека готових тегів для генерації даних, символів, значень. Використовуйте у шаблоні, в темі або тілі листа, для створення складних конструкцій рандомізації.

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
type='email_name'
Ім’я підписника з бази, на яке відправляється листИмя подписчика с базы, на которое отправляется письмо

Працює у модулях Outlook, Mail.com, Web.de, Gmx.netРаботает в модулях 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
Генерує рандомний пов’язаний контент російською мовою
Текст-"риба", часто використовується в друці та веб-дизайні.
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 вказує кількість.
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'
Шаблон для генерації символів ASCII
qB7vGnnyYADyYx2Gb2... [Буде згенеровано від 40 до 100 символів (літери великі, малі + цифри)]
type='string' min='5' max='7'
Шаблон для генерації символів ASCII. Будуть згенеровані символи в діапазоні "від" і "до"
J1jhuS [Буде згенеровано від 2 до 3 символів (літери великі, малі + цифри)]
type='string' count='12'
Шаблон для генерації символів ASCII. Буде згенеровано точну кількість символів
BPkPsi5smJir [Буде згенеровано 12 символів (літери великі, малі + цифри)]
type='string' upper
Шаблон для генерації символів ASCII великим регістром
SDGIOCXLERP....
type='string' lower
Шаблон для генерації символів ASCII малим регістром
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

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

The tag determines the probability of content display.

Атрибут Опис Приклад Результат
percent
The value determines the probability of the content being displayed.
With a 50% chance, the written content will appear in the email.

Shuffle

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

The tag shuffles the content in a random order.

Атрибут Опис Приклад Результат
shuffle
Shuffles content. Separates by slash.
Two.Three.One.
shuffle type='tag'
Shuffles content. Separates by tag.
two.one.three.
shuffle type='word'
Shuffles content. Separates by space.
two three one
shuffle type='letter'
Shuffles content. Separates by letters. Each character is treated as a separate part, including numbers, spaces, punctuation.
leohl
shuffle type='sentence'
Shuffles content. Separates by period.
Three. One. Two.
shuffle type='row'
Shuffles content. Separates by Enter.
{shuffle type='row'}
one
two
three
{/shuffle}
three
two
one

Encode

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

The tag encodes content.

Атрибут Опис Приклад Результат
encoding='base64'
The content will be encoded in base64.
0KDRg9GH0LrQsA==
encoding='quoted'
The content will be encoded in quoted-printable.
=D0=A0=D1=83=D1=87=D0=BA=D0=B0
encoding='ascii'
The content will be transliterated into lowercase ASCII characters. Spaces will be replaced with underscores. Charset will be ignored.
ruchka