Blocks

Usage

Syntax

{block
    param1="value1"
    param2="value2"
    ...
}

{block
    param1="My text with \" symbol."
    param2="<div class=\"myclass\">bla bla</div>"
}

{block
    param1="<div class='myclass'>bla bla</div>"
}

{block
    param1="Here is <a href='{url page="page-reference-id"}'>my URL</a>."
}

{beginblock param1="value1" param2="value2" ...}
    {block
        param1="value3"
        param2="value4"
        ...
    }
    {block
        param1="value5"
        param2="value6"
        ...
    }
    ...
{endblock}

A/B testing

• The A/B testing can be enabled on a home page of the website. When the visitor opens website for the 1st time then he is assigned with one of available versions on that page randomly. After a version assignment his version is saved for him for 7 days and during that period only blocks of appropriate version are shown for him.
• To show block on a certain version set abType parameter with appropriate version value of format "Test_id:Letter" (e.g. "a1b2c3:A", where "a1b2c3" is test ID and "A" is test value). If the block does not have "abType" property it will be shown for everybody. The same version can also be assigned for multiple blocks. Example:

  {block layout="..."
      abType="test1:A"
      ...
  }
  {block layout="..."
      abType="test1:B"
      ...
  }
  {block layout="..."
      abType="test1:A"
      ...
  }
  {block layout="..."
      abType="test1:C"
      ...
  }
  {block layout="..."
      ...
  }

  Before loading such page, firstly all versions are collected. In this example there are 3 versions available: "A", "B" and "C" all of test "test1".
  The visitor is randomly assigned to one of these versions when visits website home page.
  If he is assigned to version "A" then blocks 1, 3 and 5 will be shown for him.
  If he is assigned to version "B" then blocks 2 and 5 will be shown for him.
  If he is assigned to version "C" then blocks 4 and 5 will be shown for him.
• Use abType="-" (minus symbol) to the block which should be used for all the rest who were not assigned to any A/B testing letter.

A/B with specific limits

• Blocks also can be limited by the following options:
  • by country — parameter abTypeCountry
    example: abTypeCountry=["US", "IT"]
  • by currency — parameter abTypeCurrency
    example: abTypeCurrency=["USD", "EUR"]
  • by language — parameter abTypeLanguage
    example: abTypeLanguage=["EN", "BR"]
• Limited blocks will be shown only for those clients who match all specified limits in this block, then all not-limited blocks with "abType" property will be ignored for them.
  On the other hand, for those clients who do not match limits of any limited block - only not-limited blocks will be shown, and all limited blocks will be ignored for them. Example:

  {block layout="..."
      abType="test1:A"
      abTypeLanguage=["EN", "RU"]
      ...
  }
  {block layout="..."
      abType="test1:B"
      abTypeCurrency=["BRL", "EUR"]
      ...
  }
  {block layout="..."
      abType="test1:C"
      ...
  }
  {block layout="..."
      ...
  }

  Before loading such page visitor's country, currency and language will be checked.
  If the visitor opens website in English or Russian language, then he can only be assigned of version "A" and no other versions are considered for him.
  If the visitor opens website in any language but with currency "BRL" or "EUR" then he can only be assigned of version "B".
  If the visitor opens website neither in English, nor Russian language + neither with currency "BRL, nor "EUR" then he can only be assigned of version "C".
• Blocks can also be limited by device by using abTypeDevice property.
  Example:
  • abTypeDevice="mobile"
  • abTypeDevice="tablet"
  • abTypeDevice="desktop"
  • abTypeDevice=["desktop","mobile"]
  • abTypeDevice=["tablet","desktop"]
  • abTypeDevice=["mobile","tablet"]

A/B preview block

• To check how the home page of a specific A/B version looks like, open it with an appropriate link:
  

  https://site.pro/?ab=test1:A

  where put any A/B version letter in place of "A".
  To open page on another language, open Site.pro home page as usual and choose desired language. Then manually append part "?ab=A" to URL in address bar.

Multiple A/B tests

• To set up multiple tests at once (can be on mulitple pages as well), just use different test IDs. Example:

  {block layout="..."
      abType="-"
      ...
  }
  {block layout="..."
      abType="test1:A"
      abTypeCountry="LT"
      ...
  }
  {block layout="..."
      abType="test1:B"
      abTypeCountry="LT"
      ...
  }
  {block layout="..."
      abType="test2:C"
      abTypeDevice="mobile"
      abTypeLanguage="TR"
      ...
  }
  {block layout="..."
      abType="test2:D"
      abTypeDevice="mobile"
      abTypeLanguage="TR"
      ...
  }
  {block layout="..."
      ...
  }

  Here are 2 tests "test1" and "test2".
  Test "test1" has blocks "A" and "B" set up only for LT country.
  Test "test2" has blocks "C" and "D" (letters may not necessarily be different) set up for mobile devices and for TR language.
  The block with abType="-" (common block) will be shown for all the rest who were not assigned to any of the block from any of the tests.

"Custom langs" pages

(before known as "English only")
If the page has checkbox "Custom langs" enabled, then it will not be supported in all available languages as normal page, but only in those languages which the page will have URLs to.
The "Custom langs" marked page has URL when it has "Custom URL" or "Name" set that language.
To specify custom URL for such page in other languages than English, expand custom URL dropdown next to it and specify values in needed languages each from the new line. Example:
Custom URL is: My-Page and value in dropdown is:
lt: Mano-Puslapis
ru: Моя-Страница
Specify the name, title and description in the similar way.

To specify text in other languages, use the same text field with special placeholders. Example:

My text
in English.


---LT---
Mano tekstas
lietuvių kalba.
---/LT---


---RU---
Мой текст
на русском.
---/RU---

Affiliates

Blocks can be shown/hidden for specific referral links.
For example, if you want to show a specific block for those who access Site.pro page with a referral link of some affiliate then use parameter affiliateSessionUserId, like this:

{block layout="..."
    affiliateSessionUserId="123"
    ...
}
{block layout="..."
    affiliateSessionUserId="other"
    ...
}

There the 1st block will be shown only for customers who open referral link of affiliate with ID 123.
Add parameter affiliateSessionUserId="other" to other block(s) if you want to hide it from customers who open referral link of affiliate with ID 123.

Show/hide blocks

Blocks can be shown/hidden by the following options:

• by country — parameters:
  showOnlyForCountry / showForAllCountriesExcept
  example: showOnlyForCountry=["US", "IT"]
• by currency — parameters:
  showOnlyForCurrency / showForAllCurrenciesExcept
  example: showOnlyForCurrency=["USD", "EUR"]
• by language — parameters:
  showOnlyForLanguage / showForAllLanguagesExcept
  example: showOnlyForLanguage=["EN", "BR"]
• by locale — parameters:
  showOnlyForLocale / showForAllLocalesExcept
  example: showOnlyForLocale=["lt-lt", "ru-ru", "es-*"]
  (where 1st part is language code and 2nd part is country code)
• by coupon — parameter
  showOnlyForCoupon or showForAllCouponsExcept / showOnlyForNoCoupon
  example: showOnlyForCoupon=["give10", "give50"] or showOnlyForNoCoupon="true"
• by logged/not logged users — parameter
  showOnlyForLogged or showOnlyForNotLogged
  example: showOnlyForLogged="true" or showOnlyForNotLogged="true"

Important: Do not confuse these parameters with A/B parameters "abTypeCountry", "abTypeCurrency" and "abTypeLanguage". Parameters "showOnlyFor..." have nothing common with A/B testing whereas parameters "abType..." are used only for A/B testing purpose.

Example 1:

{block layout="..."
    showOnlyForCountry=["US", "IT"]
    ...
}
{block layout="..."
    showOnlyForLanguage=["EN", "RU"]
    ...
}
{block layout="..."
    ...
}

Example 2:

{block layout="..."
    showOnlyForLanguage=["EN"]
    ...
}
{block layout="..."
    showForAllLanguagesExcept=["EN"]
    ...
}
{block layout="..."
    ...
}

Example 3:

{block layout="..."
    showOnlyForLocale=["ru-ru"]
    ...
}
{block layout="..."
    showOnlyForLocale=["lt-lt"]
    ...
}
{block layout="..."
    showForAllLocalesExcept=["ru-ru", "lt-lt", "*-es", "*-br"]
    ...
}
{block layout="..."
    showOnlyForLocale=["*-es", "*-br"]
    ...
}

Block headings

Many blocks support parameter "title". When using it in block it will generate heading in that block with one of tags <h1>, <h2>, <h3>, <h4>, <h5> or <h6>.
By default the tag <h2> is used for all blocks supporting "title" parameter except 1st block on page — it uses tag <h1>.

Almost each block supporting parameter "title" also support parameters "titletag" and "titleclass". By default some blocks use their own values of these parameters. If you specify values for these parameters in the text, then default values will be overwritten with your values.

For example, block slider supports "title" parameter, and by default it uses <h2> for "titletag" and <h4> for "titleclass". But if you specify your own values for these parameters, then they will be used instead of default values.

Tags are important for SEO of landing pages. It is recommended to keep only one <h1> tag on the whole page. If you need more <h1>-styled titles on the page, then you should better use combination of titletag="h2" and titleclass="h1".

Translations

• In order to use translation variables, add them within "{{...}}" brackets, like this: {{Translation variable}}
• If translation variable contains dynamic variables inside ("%s" symbols), they must be replaced using "|" symbol, like this: {{Translation %s variable %s|first replacement|second replacement}}. As a result, the translated text will be: Translation first replacement variable second replacement
• Replacement can also be another variable: {{Translation %s variable|{{another variable}}}}
• There can be cases when you need to use translation which is not translated to all languages at that time. Then you can add another similar translation as a fallback to the first one after symbol "??", like this: {{First variable ?? Second variable}}. If the first translation is not translated to the particular language, the second translation will be used. Note that even if the second translation is not translated, then it will still be used in the text.
  There can be more than one fallback translations: {{First variable ?? Second variable ?? Third translation ?? ...}}
• Fallback translation variables can also have dynamic variables inside ("%s" symbols), like this: {{First %s variable ?? Second %s variable|replacement}}