Macros Documentation
A library of ready-to-use tags for generating data, characters, and values. Use in the template, subject, or email body to create complex randomization structures.
Shortcode
Format - unpaired.
The tag substitutes the user’s personal shortcodes values.
| Attribute | Description | Example | Result |
|---|---|---|---|
|
|
Specifies which shortcode to substitute
|
|
Alexsandra
|
|
|
All shortcodes with the same attribute values will have identical values |
For example, if we have two shortcodes:
1. first_name: alex|dima|oleg
2. last_name: vasichkin|ivanov|petrov
The example looks like this:
{shortcode id='name' code='first_name'} +{shortcode id='name' code='last_name'} |
dima + ivanov
oleg + petrov
|
Locale
Format - unpaired.
The tag changes the default location. By default, all generations are done in English. However, if you are sending Russian text and need Russian generations, place this tag at the beginning of the email. The tag works in a top-down priority.
| Attribute | Description | Example | Result |
|---|---|---|---|
locale |
Generates random cohesive content, words, paragraphs, sentences. Default location.
|
{locale locale='en_US'}{generate} |
English
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='ru_RU'}{generate} |
Russian
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='al_AL'}{generate} |
Albanian
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='am_AM'}{generate} |
Arabic
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='az_AZ'}{generate} |
Azerbaijani
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='da_DA'}{generate} |
Danish
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='de_DE'}{generate} |
German
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='el_EL'}{generate} |
Greek
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='es_ES'}{generate} |
Spanish
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='fl_FL'}{generate} |
Finnish
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='fr_FR'}{generate} |
French
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='hu_HU'}{generate} |
Hungarian
|
locale |
Generates random cohesive content, words, paragraphs, sentences.
|
{locale locale='it_IT'}{generate} |
Italian
|
Info
Format - unpaired.
The tag provides various information that can be used in the email or subject.
| Attribute | Description | Example | Result |
|---|---|---|---|
type='email_email' |
The address to which the email is sent. The tag can be encoded in base64 or quoted-printable.
Works in modules such as Outlook, WP.PL, Mail.com, Web.de, Gmx.net.
|
|
client.email@client.domain.com
|
type='email_name' |
The subscriber's name from the database to which the email is sent.Имя подписчика с базы, на которое отправляется письмо
Works in modules such as Outlook, Mail.com, Web.de, Gmx.net.Работает в модулях Outlook, Mail.com, Web.de, Gmx.net
|
|
Client Name
|
Random
Format - paired.
The tag selects one or more values from the user-defined options randomly or in a specified way.
| Attribute | Description | Example | Result |
|---|---|---|---|
|
Randomly selects one or more values.
|
{random}Hello.|Good day.|Hey.{/random} |
Hello.
|
id |
All random tags with the same attribute ID will reflect in the same order.
|
{random id='01'}one|two|three{/random} +{random id='01'}alex|kostia|masha{/random} |
three + masha
|
type='tag' |
Item tags. Separates by tags.
|
{random type='tag'}{i}one.{/i}{i}two.{/i}{i}three.{/i}{/random} |
three.
|
type='word' |
Words. Separates by spaces.
|
{random type='word'}one two three{/random} |
one
|
type='letter' |
Letters. Each character is treated as a separate part, including spaces, punctuation, and tags.
|
{random type='letter'}hello{/random} |
h
|
type='sentence' |
Sentences. Separates by periods.
|
{random type='sentence'}I love Kiev. I was born in Kiev. I live in Kiev.{/random} |
I live in Kiev.
|
type='row' |
Lines. Separates by Enter.
|
{random type='row'}onetwothree{/random} |
two
|
Generate
Format - unpaired.
The tag generates various content: random characters, signs, dates, etc.
| Attribute | Description | Example | Result |
|---|---|---|---|
|
Generates random cohesive content in English.
|
|
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
|
locale |
Generates random cohesive content in Russian.
|
|
Lorem Ipsum text, often used in printing and web design. This text has been standard placeholder text for Latin-based texts since the 16th century.
|
id |
Generates content. All generate tags with the same attribute ID will have identical values.
|
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' |
A word will be generated.
|
|
hello
|
type='word' count='3' |
3 words will be generated.
|
|
hello world apple
|
type='sentence' |
A sentence will be generated.
|
|
In vel odio feugiat, malesuada quam condimentum, mollis mauris.
|
type='sentence' count='2 |
2 sentences will be generated.
|
|
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' |
A paragraph of text will be generated.
|
|
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 to 10 paragraphs of text will be generated.
|
|
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 to 3 paragraphs of text will be generated.
|
|
In vel odio feugiat, malesuada quam ...
Nam accumsan id ante eu imperdiet. Suspendisse in ...
|
type='text' count='1' |
A paragraph of text will be generated. The count parameter specifies the quantity. Min and max parameters are ignored if present.
|
|
In vel odio feugiat, malesuada quam ...
|
type='number' |
Generates an integer. Can be negative.
|
|
43 [The range will always be from 0 to 100].
|
type='number' min='10' max='100' |
Generates an integer. Can be negative. Min and max parameters define the range.
|
|
54 [The range will always be from 10 to 100].
|
type='number' count='5' |
Generates an integer with a specific number of digits. The count parameter specifies the number of digits. Min and max parameters are ignored if present.
|
|
82363 [The range will always be from 10000 to 99999].
|
type='float' |
Generates a number with decimal places. Can be negative.
|
|
12.64 [The range will always be from 0.00 to 100.00 with exactly two decimal places].
|
type='float' min='100' max='300' |
Generates a number with decimal places. Min and max parameters define the range.
|
|
128.64 [The range will always be from 100.00 to 300.00 with exactly two decimal places].
|
type='float' count='8' |
Generates a number with decimal places. The count parameter specifies the total number of digits. Min and max parameters are ignored if present.
|
|
123456.78 [The range will always be from 100000.00 to 999999.99 with exactly two decimal places].
|
type='float' decimals='4' |
Generates a number with decimal places. The parameter specifies the number of decimal places.
|
|
12.1234 [The range will always be from 0 to 100 with exactly 4 decimal places].
|
type='name' |
A random first and last name will be generated.
|
|
Karen Millen
|
type='name' gender='both' |
A female or male first and last name will be generated.
|
|
Karen Millen
|
type='name' gender='male' |
A male first and last name will be generated.
|
|
John Smith
|
type='name' gender='female' |
A female first and last name will be generated.
|
|
Karen Millen
|
type='name' format='both' |
A last name and first name in the specified order will be generated.
|
|
Smith John
|
type='name' format='both_reverse' |
A first name and last name in the specified order will be generated.
|
|
John Smith
|
type='name' format='first' |
A first name will be generated.
|
|
John
|
type='name' format='last' |
A last name will be generated.
|
|
Smith
|
type='date' |
Date and time.
|
|
2019-01-23 12:34:51
|
type='date' format='timestamp' |
Number of seconds since 1970-01-01 00:00:00.
|
|
1437889193
|
type='date' format='Y-m-d H:i:s' |
Date format compatible with PHP date function.
|
|
2019-01-23 12:34:51
|
type='date' min='2016-01-15' max='2018-12-31' |
Date range from and to. Must be submitted in the specified format.
|
|
2017-01-23 12:34:51
|
type='date' now |
Date and time at the time of email sending.
|
|
2019-05-12 12:34:51
|
type='string' |
Pattern for generating ASCII characters.
|
|
qB7vGnnyYADyYx2Gb2.... [40 to 100 characters will be generated (uppercase, lowercase letters + digits)].
|
type='string' min='5' max='7' |
Pattern for generating ASCII characters within the specified range.
|
|
J1jhuS [2 to 3 characters will be generated (uppercase, lowercase letters + digits)].
|
type='string' count='12' |
Pattern for generating a fixed number of ASCII characters.
|
|
BPkPsi5smJir [12 characters will be generated (uppercase, lowercase letters + digits)].
|
type='string' upper |
Pattern for generating uppercase ASCII characters.
|
|
SDGIOCXLERP....
|
type='string' lower |
Pattern for generating lowercase ASCII characters.
|
|
sdjixcownewfme...
|
type='string' numbers |
Pattern for generating digits.
|
|
12472389729034873...
|
type='string' special |
Pattern for generating special characters.
|
|
!@$@#%#$&^@%^%&^...
|
type='regex' pattern='[a-z]{3}.[0-9]{5}' |
Pattern for random generation of characters in the desired amount.
|
|
fxo.49123
|
addsimbol |
Inserts a specified character at random intervals FROM and TO.
|
|
Wo#rds# words# wo#rds#.
|
addspace |
Inserts a space at the specified interval FROM and TO.
|
|
hfRnjr gdgTOBgf gr FBK hbgfreuhu hfygfyyyfg
|
external |
Loads data from a .txt file located on a third-party VPS in random order. Up to 10,000 lines per file.
|
|
Repeat
Format - paired.
The tag forms content repetition.
| Attribute | Description | Example | Result |
|---|---|---|---|
repeat |
Repeating content.
|
|
word.word.word.word.word.word. [Content will be repeated 3 to 10 times].
|
repeat min='1' max='4' |
Repeating content from and to.
|
|
word.word.word. [Content will be repeated 1 to 4 times].
|
repeat count='3' |
Repeating content a specific number of times.
|
|
word.word.word. [Content will be repeated 3 times].
|
Chance
Format - paired.
The tag determines the probability of content display.
| Attribute | Description | Example | Result |
|---|---|---|---|
percent |
The value determines the probability of the content being displayed.
|
|
With a 50% chance, the written content will appear in the email.
|
Shuffle
Format - paired.
The tag shuffles the content in a random order.
| Attribute | Description | Example | Result |
|---|---|---|---|
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'}onetwothree{/shuffle} |
three
two
one
|
Encode
Format - paired.
The tag encodes content.
| Attribute | Description | Example | Result |
|---|---|---|---|
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
|