Managing Themes

Themes are the most generic templates that allow you to have all general elements of your email design (such as headers, styles, and footers) in one place. When designing a template, you can just select a theme and specify the message - the rest will be done by our extension.

To create a new theme, visit Marketing -> Follow Up Email -> Email Designer -> Manage Themes and press the Add Theme button.

The theme consists of the following properties:

• Name - name of the template.
• Type - template type. There's two available types: HTML (default) and Text.
• Template - the basic design template, which will use all subsequent templates.

The Template covers all email areas - including headers, footers and even the main content. These editable areas are defined using special liquid variables:

• {{ 'header' | area: 'Email header here...' }} - places a header area
• {{ 'content' | area: 'Email text here...' }} - places a main body area
• {{ 'footer' | area: 'Email footer here...' }} - places a footer area

{% if 'content' | area %}
    {{ 'content' | area: 'Email text here...' }}
{% endif %}

You can also use Variables and Callouts in your design.

All these parts can be previewed on the Preview Pane in both Desktop and Mobile versions.

Save the theme and proceed with Templates creation.

Managing Templates

All templates used in Follow-Up Emails are located at their respective Grid at Marketing -> Email Designer -> Manage Templates.

Actions performed on templates can be selected from the Actions drop-down. Here you can Edit or Remove Template.

How to Create New Template

Go to Marketing -> Email Designed -> Manage Templates, and press the Add Template button. It will bring you to the first stage of Template creation, with the following basic properties:

• Name - name of the template
• Theme - one of the themes, defined at Marketing -> Email Designed -> Manage Themes. Read more in the Themes section.
• Subject - the default subject which will be used in emails, based on this template.

Saving a template at this stage does not actually create a template, but a draft stub. After it is saved, you need to reopen it using the Edit action, and enter contents.

The Template Edit Page breaks into two panels - left (Areas Pane) and right (Preview Pane).

Areas are parts of your email. They depend on your store's design, and your desired look & feel, but should consist of three areas:

• Header - will be displayed at the very top of your email.
• Content - is the main body of your template. Here you can enter your message and other details.
• Footer - will be displayed at the very bottom of your email.

You can use Variables in any part of template. The Insert Variables button will help you to pick up the desired variable interactively.

All of these parts can be previewed on the Preview Pane in both Desktop and Mobile versions.

{% for item in this.all_visible_items %}

---

{% endfor %}

{% for item in this.first_visible_item %}

---

{% endfor %}

Variables & Methods

Our extension allows you to use variables and PHP callouts in your emails, which can greatly enhance and personalize them.

Liquid Variables

Liquid variables are a new way to enhance email templates. This syntax was introduced in version 1.1.15 and is the preferred syntax for use in Email Templates.

All variables should be enclosed in curly brackets. Each variable can also have a filter, added after pipe sign, and have one or more parameters.

These variables can be added interactively from edit pages of Theme or Template.

You just need to press the button Insert Variable near the content element, and select the variable you want to use - as shown below:

Modifying Variables with Filters

Filters are methods that allow you to alter or enhance the output of a variable. They also should be enclosed to the variable block {{ }}, but separated from the variable with a pipe (|) character. The parameters of filters are added using the colon (:) character.

Here is the list of available filters, grouped into categories, with examples:

• String/HTML Filters

  • downcase - converts a string into lowercase.

    {{ item.product.name | downcase }}

    • Original: Dash Digital Watch
    • Output: dash digital watch

  • upcase - converts a string into uppercase.

    {{ item.product.name | upcase }}

    • Original: Dash Digital Watch
    • Output: DASH DIGITAL WATCH

  • replace - replaces all occurrences of a string with a substring.

    {{ item.product.name | replace: 'Digital', 'Analog' }}

    • Original: Dash Digital Watch
    • Output: Dash Analog watch

  • append - appends characters to a string.

    {{ item.product.name | append: ' - best choice' }}

    • Original: Dash Digital Watch
    • Output: Dash Digital Watch - best choice

  • prepend - prepends characters to a string.

    {{ item.product.name | prepend: 'Best choice - ' }}

    • Original: Dash Digital Watch
    • Output: Best choice - Dash Digital Watch

  • capitalize - capitalizes words in the input sentence.

    {{ item.product.color | capitalize }}

    • Original: dark red
    • Output: Dark red

  • escape - escapes HTML tags in a string.

    {{ item.product.description | escape }

  • newline_to_br - inserts a <br> linebreak HTML tag in front of each line break in a string.

    {{ item.product.short_description | newline_to_br }

  • remove - removes all occurrences of a substring from a string.

    {{ item.product.name | remove: 'Digital' }}

    • Original: Dash Digital Watch
    • Output: Dash Watch

  • strip_html - strips all HTML tags from a string.

    {{ item.product.description | strip_html }

  • truncate - truncates a string down to 'x' characters.

    {{ item.product.name | truncate: '15' }}

    • Original: Dash Digital Watch
    • Output: ash Digital Wa

  • if_empty - return argument, if the value is an empty string

    Dear {{ customer_name | if_empty: 'Client' }}!

    • Original: empty string
    • Output: Dear Client!

  • date - converts a string to a specified date-time format.

    {{ item.product.created_at | date: '%d.%m.%Y %H:%M' }}

    • Original: 2016-02-18 10:11:12
    • Output: 18.02.2016 10:11

    Full list of formatters can be found here

  • format_date - converts a string to a specified date-time format.

    {{ item.product.created_at | format_date: 3 }}

    • Original: 2016-02-18 10:11:12
    • Output: 18/02/16

    Possible formatters: 0, 1 , 2 , 3

• Numeric Filters

  • ceil - rounds the output up to the nearest integer.

    {{ item.product.weight | ceil }}

    • Original: 1.423
    • Output: 2

  • floor - rounds the output down to the nearest integer.

    {{ item.product.weight | floor }}

    • Original: 1.423
    • Output: 1

  • round - rounds the output to the nearest integer or specified decimal digits.

    {{ item.product.weight | round: '2' }}

    • Original: 1.423
    • Output: 1.42

    {{ item.product.weight | round }}

    • Original: 1.423
    • Output: 1

  • number_format - formats number to specified format (php function).

    {{ item.product.price | number_format: '2', '.', ',' }}

• Price/Currency Filters

  • format_price - formats price to default format.

    {{ item.product.price | format_price }}

    • Original: 100.42
    • Output: $100.42

  • convert - converts a price from base currency to specified currency.

    {{ item.product.price | convert: 'EUR' }}

    • Original: 100
    • Output: 92.28

• Array Filters

  • first - return first element in array.

  • last - return last element in array.

  • join - join array to string using glue.

  • size - return the size of an array or a string.

• URL Filters

  • resume - resume customer's session and redirect it to base URL

    {{ item.product.product_url | resume }}

• Image Filters

  • resize - resize image

    {{ item.product.image | resize: 'small_image', 100, 100 }}

    • Original: http://example.com/pub/media/catalog/product/m/h/mh03-black_main.jpg
    • Output: http://example.com/pub/media/cache/100x100/catalog/product/m/h/mh03-black_main.jpg

PHP Callouts

PHP Callouts is a very powerful tool to enhance your templates. It allows you to include PHP code directly to the HTML Code.

Here is the list of possible callouts with respective examples:

• Global Methods

  • getUnsubscribeUrl - a direct link to unsubscribe from current trigger.

    The customer will be unsubscribed from all already scheduled emails (Follow Up Email -> Mail Log (Queue)) for the current trigger.

    This link does not unsubscribe customers from future emails (triggered by other events) or native Magento subscription.

    Usage: <a href="<?php echo $this->getUnsubscribeUrl() ?>">Unsubscribe</a>

  • getUnsubscribeAllUrl - a direct link to unsubscribe from all triggers

    The customer will be unsubscribed from all already scheduled emails (Follow Up Email -> Mail Log (Queue)) for all triggers.

    This link does not unsubscribe customers from native Magento subscription.

    Usage: <a href="<?php echo $this->getUnsubscribeAllUrl() ?>">Unsubscribe</a>

  • getViewInBrowserUrl - a direct link to open email in browser

    Usage: <a href="<?php echo $this->getViewInBrowserUrl() ?>">View it in your browser.</a>

  • getResumeUrl - a direct link to resume (restore, log in) customer session

    Usage: <a href="<?php echo $this->getResumeUrl() ?>">Open</a>

    i.e., the customer will be automatically authorized in the store.

    Additionally, you can pass a parameter to the method to redirect the customer to a specific URL after authorization.

    Example

        <?php foreach($this->getOrder()->getAllVisibleItems() as $item): ?>
          <tr>
            <td>
              <a href="<?php echo $this->getResumeUrl($item->getProduct()->getProductUrl()) ?>">Review <?php echo $item->getName() ?></a>
            </td>
          </tr>
        <?php endforeach ?>

    i.e., the customer will be redirected to the product page to leave a review after automatic authorization.

  • getStoreUrl - a direct link to the store home page

    Usage: <?php echo $this->getStoreUrl() ?>

  • getStoreName - a curent store name

    Usage: <?php echo $this->getStoreName() ?>

  • getStorePhone - a curent store phone

    Usage: <?php echo $this->getStorePhone() ?>

  • getStoreAddress - a curent store address

    Usage: <?php echo $this->getStoreAddress() ?>

  • getStoreEmail - a curent store general transactional email

    Usage: <?php echo $this->getStoreEmail() ?>

• Customer Methods

  • getCustomerName - returns customer's full name

    Usage: Dear <?php echo $this->getCustomerName() ?>

    You can pass a parameter to the method getCustomerName() which will be used instead of the customer name, if the customer's name is empty: Dear <?php echo $this->getCustomerName(null, 'Customer') ?>, results in Dear Customer, if customer's name is empty (since version 1.0.34).

  • getFirstname - returns customer's firstname (since version 1.0.36)

    Usage: Dear <?php echo $this->getFirstname() ?>

  • getLastname - returns customer's lastname (since version 1.0.36)

    Usage: Dear <?php echo $this->getLastname() ?>

  • getCustomer - retrurns customer's object (only for registered customers)

    Usage: Hi <?php echo $this->getCustomer()->getFirstname() ?>

    <?php echo $this->getCustomer()->getEmail() ?>

• Shopping Cart Methods

  • getRestoreCartUrl - a direct link to customer shopping cart

    Usage: <a href="<?php echo $this->getRestoreCartUrl() ?>">Finish Checkout!</a>

  • getReorderCartUrl - redirects the customer to the quote with the products purchased from the previous order

    Usage: <a href="<?php echo $this->getReorderCartUrl() ?>">Reorder</a>

  • getQuote()->getAllVisibleItems() - return collection of products in cart for feature output

    Usage:

        <?php foreach ($this->getQuote()->getAllVisibleItems() as $item): ?>
            <?php echo $item->getName() ?>
        <?php endforeach ?>

    How to display only the first product:

    Example

        <?php $i = 0 ?>
        <?php foreach ($this->getQuote()->getAllVisibleItems() as $item): ?>
            <?php if ($i++ >= 1): ?>
                <?php break ?>
            <?php endif ?>
            ...
            other methods
            ...
        <?php endforeach ?>

• Order Methods

  • getOrder()->getStatus() - the status of order

    Usage: order status is <?php echo $this->getOrder()->getStatus() ?>

  • getOrder()->getIncrementId() - the order number

    Usage: Order #<?php echo $this->getOrder()->getIncrementId() ?>

  • getOrder()->getStoreGroupName() - the store name of order

    Usage: You placed order in <?php echo $this->getOrder()->getStoreGroupName() ?>

  • getOrder()->getAllVisibleItems() - return list of products in order for feature output

    Usage:

        <?php foreach ($this->getOrder()->getAllVisibleItems() as $item): ?>
            <?php echo $item->getName() ?>
        <?php endforeach ?>

    How to display only the first product:

    Example

        <?php $i = 0 ?>
        <?php foreach ($this->getOrder()->getAllVisibleItems() as $item): ?>
            <?php if ($i++ >= 1): ?>
                <?php break ?>
            <?php endif ?>
            ...
            other methods
            ...
        <?php endforeach ?>

  • Additional Methods

    Usage:

        <?php echo $this->getOrder()->getBaseTaxAmount() ?>
        <?php echo $this->getOrder()->getBaseGrandTotal() ?>
        <?php echo $this->getOrder()->getBaseShippingAmount() ?>
        <?php echo $this->getOrder()->getShippingDescription() ?> - returns shipping method name

• Coupons

  • getCoupon()->getCode() - get the expiration date of an autogenerated coupon code

    Usage: Expiration date: <?php echo $this->formatDate($this->getCoupon()->getExpirationDate()) ?>

    Different date formats:

        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate()) ?>
        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::MEDIUM) ?>
        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::LONG) ?>

    Example

        <?php if ($this->getCoupon()): ?>
            Let us offer you a discount to complete your purchase.<br>
            Your coupon code: <?php echo $this->getCoupon()->getCode() ?> valid till <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::MEDIUM) ?>
        <?php endif ?>

    i.e., we only display this text block if a coupon is available.

  • getCoupon()->getExpirationDate() - the autogenerated coupon code

    Usage: Your coupon code: <?php echo $this->getCoupon()->getCode() ?>

    Example

        <?php if ($this->getCoupon()): ?>
            Let us offer you a discount to complete your purchase.<br>
            Your coupon code: <?php echo $this->getCoupon()->getCode() ?>
        <?php endif ?>

    i.e., we only display this text block if a coupon is available.

• Cross-sell products

  • getCrossSellHtml - html block of cross sell products

    Usage: <?php echo getCrossSellHtml() ?>

    Example

        <?php if ($this->getCrossSellHtml()): ?>
            <h1>See also:</h1>
            <?php echo $this->getCrossSellHtml() ?>
        <?php endif ?>

    i.e., we only display this text block if products are available.

Variables & Methods

Our extension allows you to use variables and PHP callouts in your emails, which can greatly enhance and personalize them.

Liquid Variables

Liquid variables are a new way to enhance email templates. This syntax was introduced in version 1.1.15 and is the preferred syntax for use in Email Templates.

All variables should be enclosed in curly brackets. Each variable can also have a filter, added after pipe sign, and have one or more parameters.

These variables can be added interactively from edit pages of Theme or Template.

You just need to press the button Insert Variable near the content element, and select the variable you want to use - as shown below:

Modifying Variables with Filters

Filters are methods that allow you to alter or enhance the output of a variable. They also should be enclosed to the variable block {{ }}, but separated from the variable with a pipe (|) character. The parameters of filters are added using the colon (:) character.

Here is the list of available filters, grouped into categories, with examples:

• String/HTML Filters

  • downcase - converts a string into lowercase.

    {{ item.product.name | downcase }}

    • Original: Dash Digital Watch
    • Output: dash digital watch

  • upcase - converts a string into uppercase.

    {{ item.product.name | upcase }}

    • Original: Dash Digital Watch
    • Output: DASH DIGITAL WATCH

  • replace - replaces all occurrences of a string with a substring.

    {{ item.product.name | replace: 'Digital', 'Analog' }}

    • Original: Dash Digital Watch
    • Output: Dash Analog watch

  • append - appends characters to a string.

    {{ item.product.name | append: ' - best choice' }}

    • Original: Dash Digital Watch
    • Output: Dash Digital Watch - best choice

  • prepend - prepends characters to a string.

    {{ item.product.name | prepend: 'Best choice - ' }}

    • Original: Dash Digital Watch
    • Output: Best choice - Dash Digital Watch

  • capitalize - capitalizes words in the input sentence.

    {{ item.product.color | capitalize }}

    • Original: dark red
    • Output: Dark red

  • escape - escapes HTML tags in a string.

    {{ item.product.description | escape }

  • newline_to_br - inserts a <br> linebreak HTML tag in front of each line break in a string.

    {{ item.product.short_description | newline_to_br }

  • remove - removes all occurrences of a substring from a string.

    {{ item.product.name | remove: 'Digital' }}

    • Original: Dash Digital Watch
    • Output: Dash Watch

  • strip_html - strips all HTML tags from a string.

    {{ item.product.description | strip_html }

  • truncate - truncates a string down to 'x' characters.

    {{ item.product.name | truncate: '15' }}

    • Original: Dash Digital Watch
    • Output: ash Digital Wa

  • if_empty - return argument, if the value is an empty string

    Dear {{ customer_name | if_empty: 'Client' }}!

    • Original: empty string
    • Output: Dear Client!

  • date - converts a string to a specified date-time format.

    {{ item.product.created_at | date: '%d.%m.%Y %H:%M' }}

    • Original: 2016-02-18 10:11:12
    • Output: 18.02.2016 10:11

    Full list of formatters can be found here

  • format_date - converts a string to a specified date-time format.

    {{ item.product.created_at | format_date: 3 }}

    • Original: 2016-02-18 10:11:12
    • Output: 18/02/16

    Possible formatters: 0, 1 , 2 , 3

• Numeric Filters

  • ceil - rounds the output up to the nearest integer.

    {{ item.product.weight | ceil }}

    • Original: 1.423
    • Output: 2

  • floor - rounds the output down to the nearest integer.

    {{ item.product.weight | floor }}

    • Original: 1.423
    • Output: 1

  • round - rounds the output to the nearest integer or specified decimal digits.

    {{ item.product.weight | round: '2' }}

    • Original: 1.423
    • Output: 1.42

    {{ item.product.weight | round }}

    • Original: 1.423
    • Output: 1

  • number_format - formats number to specified format (php function).

    {{ item.product.price | number_format: '2', '.', ',' }}

• Price/Currency Filters

  • format_price - formats price to default format.

    {{ item.product.price | format_price }}

    • Original: 100.42
    • Output: $100.42

  • convert - converts a price from base currency to specified currency.

    {{ item.product.price | convert: 'EUR' }}

    • Original: 100
    • Output: 92.28

• Array Filters

  • first - return first element in array.

  • last - return last element in array.

  • join - join array to string using glue.

  • size - return the size of an array or a string.

• URL Filters

  • resume - resume customer's session and redirect it to base URL

    {{ item.product.product_url | resume }}

• Image Filters

  • resize - resize image

    {{ item.product.image | resize: 'small_image', 100, 100 }}

    • Original: http://example.com/pub/media/catalog/product/m/h/mh03-black_main.jpg
    • Output: http://example.com/pub/media/cache/100x100/catalog/product/m/h/mh03-black_main.jpg

PHP Callouts

PHP Callouts is a very powerful tool to enhance your templates. It allows you to include PHP code directly to the HTML Code.

Here is the list of possible callouts with respective examples:

• Global Methods

  • getUnsubscribeUrl - a direct link to unsubscribe from current trigger.

    The customer will be unsubscribed from all already scheduled emails (Follow Up Email -> Mail Log (Queue)) for the current trigger.

    This link does not unsubscribe customers from future emails (triggered by other events) or native Magento subscription.

    Usage: <a href="<?php echo $this->getUnsubscribeUrl() ?>">Unsubscribe</a>

  • getUnsubscribeAllUrl - a direct link to unsubscribe from all triggers

    The customer will be unsubscribed from all already scheduled emails (Follow Up Email -> Mail Log (Queue)) for all triggers.

    This link does not unsubscribe customers from native Magento subscription.

    Usage: <a href="<?php echo $this->getUnsubscribeAllUrl() ?>">Unsubscribe</a>

  • getViewInBrowserUrl - a direct link to open email in browser

    Usage: <a href="<?php echo $this->getViewInBrowserUrl() ?>">View it in your browser.</a>

  • getResumeUrl - a direct link to resume (restore, log in) customer session

    Usage: <a href="<?php echo $this->getResumeUrl() ?>">Open</a>

    i.e., the customer will be automatically authorized in the store.

    Additionally, you can pass a parameter to the method to redirect the customer to a specific URL after authorization.

    Example

        <?php foreach($this->getOrder()->getAllVisibleItems() as $item): ?>
          <tr>
            <td>
              <a href="<?php echo $this->getResumeUrl($item->getProduct()->getProductUrl()) ?>">Review <?php echo $item->getName() ?></a>
            </td>
          </tr>
        <?php endforeach ?>

    i.e., the customer will be redirected to the product page to leave a review after automatic authorization.

  • getStoreUrl - a direct link to the store home page

    Usage: <?php echo $this->getStoreUrl() ?>

  • getStoreName - a curent store name

    Usage: <?php echo $this->getStoreName() ?>

  • getStorePhone - a curent store phone

    Usage: <?php echo $this->getStorePhone() ?>

  • getStoreAddress - a curent store address

    Usage: <?php echo $this->getStoreAddress() ?>

  • getStoreEmail - a curent store general transactional email

    Usage: <?php echo $this->getStoreEmail() ?>

• Customer Methods

  • getCustomerName - returns customer's full name

    Usage: Dear <?php echo $this->getCustomerName() ?>

    You can pass a parameter to the method getCustomerName() which will be used instead of the customer name, if the customer's name is empty: Dear <?php echo $this->getCustomerName(null, 'Customer') ?>, results in Dear Customer, if customer's name is empty (since version 1.0.34).

  • getFirstname - returns customer's firstname (since version 1.0.36)

    Usage: Dear <?php echo $this->getFirstname() ?>

  • getLastname - returns customer's lastname (since version 1.0.36)

    Usage: Dear <?php echo $this->getLastname() ?>

  • getCustomer - retrurns customer's object (only for registered customers)

    Usage: Hi <?php echo $this->getCustomer()->getFirstname() ?>

    <?php echo $this->getCustomer()->getEmail() ?>

• Shopping Cart Methods

  • getRestoreCartUrl - a direct link to customer shopping cart

    Usage: <a href="<?php echo $this->getRestoreCartUrl() ?>">Finish Checkout!</a>

  • getReorderCartUrl - redirects the customer to the quote with the products purchased from the previous order

    Usage: <a href="<?php echo $this->getReorderCartUrl() ?>">Reorder</a>

  • getQuote()->getAllVisibleItems() - return collection of products in cart for feature output

    Usage:

        <?php foreach ($this->getQuote()->getAllVisibleItems() as $item): ?>
            <?php echo $item->getName() ?>
        <?php endforeach ?>

    How to display only the first product:

    Example

        <?php $i = 0 ?>
        <?php foreach ($this->getQuote()->getAllVisibleItems() as $item): ?>
            <?php if ($i++ >= 1): ?>
                <?php break ?>
            <?php endif ?>
            ...
            other methods
            ...
        <?php endforeach ?>

• Order Methods

  • getOrder()->getStatus() - the status of order

    Usage: order status is <?php echo $this->getOrder()->getStatus() ?>

  • getOrder()->getIncrementId() - the order number

    Usage: Order #<?php echo $this->getOrder()->getIncrementId() ?>

  • getOrder()->getStoreGroupName() - the store name of order

    Usage: You placed order in <?php echo $this->getOrder()->getStoreGroupName() ?>

  • getOrder()->getAllVisibleItems() - return list of products in order for feature output

    Usage:

        <?php foreach ($this->getOrder()->getAllVisibleItems() as $item): ?>
            <?php echo $item->getName() ?>
        <?php endforeach ?>

    How to display only the first product:

    Example

        <?php $i = 0 ?>
        <?php foreach ($this->getOrder()->getAllVisibleItems() as $item): ?>
            <?php if ($i++ >= 1): ?>
                <?php break ?>
            <?php endif ?>
            ...
            other methods
            ...
        <?php endforeach ?>

  • Additional Methods

    Usage:

        <?php echo $this->getOrder()->getBaseTaxAmount() ?>
        <?php echo $this->getOrder()->getBaseGrandTotal() ?>
        <?php echo $this->getOrder()->getBaseShippingAmount() ?>
        <?php echo $this->getOrder()->getShippingDescription() ?> - returns shipping method name

• Coupons

  • getCoupon()->getCode() - get the expiration date of an autogenerated coupon code

    Usage: Expiration date: <?php echo $this->formatDate($this->getCoupon()->getExpirationDate()) ?>

    Different date formats:

        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate()) ?>
        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::MEDIUM) ?>
        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::LONG) ?>

    Example

        <?php if ($this->getCoupon()): ?>
            Let us offer you a discount to complete your purchase.<br>
            Your coupon code: <?php echo $this->getCoupon()->getCode() ?> valid till <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::MEDIUM) ?>
        <?php endif ?>

    i.e., we only display this text block if a coupon is available.

  • getCoupon()->getExpirationDate() - the autogenerated coupon code

    Usage: Your coupon code: <?php echo $this->getCoupon()->getCode() ?>

    Example

        <?php if ($this->getCoupon()): ?>
            Let us offer you a discount to complete your purchase.<br>
            Your coupon code: <?php echo $this->getCoupon()->getCode() ?>
        <?php endif ?>

    i.e., we only display this text block if a coupon is available.

• Cross-sell products

  • getCrossSellHtml - html block of cross sell products

    Usage: <?php echo getCrossSellHtml() ?>

    Example

        <?php if ($this->getCrossSellHtml()): ?>
            <h1>See also:</h1>
            <?php echo $this->getCrossSellHtml() ?>
        <?php endif ?>

    i.e., we only display this text block if products are available.

Variables & Methods

Our extension allows you to use variables and PHP callouts in your emails, which can greatly enhance and personalize them.

Liquid Variables

Liquid variables are a new way to enhance email templates. This syntax was introduced in version 1.1.15 and is the preferred syntax for use in Email Templates.

All variables should be enclosed in curly brackets. Each variable can also have a filter, added after pipe sign, and have one or more parameters.

These variables can be added interactively from edit pages of Theme or Template.

You just need to press the button Insert Variable near the content element, and select the variable you want to use - as shown below:

Modifying Variables with Filters

Filters are methods that allow you to alter or enhance the output of a variable. They also should be enclosed to the variable block {{ }}, but separated from the variable with a pipe (|) character. The parameters of filters are added using the colon (:) character.

Here is the list of available filters, grouped into categories, with examples:

• String/HTML Filters

  • downcase - converts a string into lowercase.

    {{ item.product.name | downcase }}

    • Original: Dash Digital Watch
    • Output: dash digital watch

  • upcase - converts a string into uppercase.

    {{ item.product.name | upcase }}

    • Original: Dash Digital Watch
    • Output: DASH DIGITAL WATCH

  • replace - replaces all occurrences of a string with a substring.

    {{ item.product.name | replace: 'Digital', 'Analog' }}

    • Original: Dash Digital Watch
    • Output: Dash Analog watch

  • append - appends characters to a string.

    {{ item.product.name | append: ' - best choice' }}

    • Original: Dash Digital Watch
    • Output: Dash Digital Watch - best choice

  • prepend - prepends characters to a string.

    {{ item.product.name | prepend: 'Best choice - ' }}

    • Original: Dash Digital Watch
    • Output: Best choice - Dash Digital Watch

  • capitalize - capitalizes words in the input sentence.

    {{ item.product.color | capitalize }}

    • Original: dark red
    • Output: Dark red

  • escape - escapes HTML tags in a string.

    {{ item.product.description | escape }

  • newline_to_br - inserts a <br> linebreak HTML tag in front of each line break in a string.

    {{ item.product.short_description | newline_to_br }

  • remove - removes all occurrences of a substring from a string.

    {{ item.product.name | remove: 'Digital' }}

    • Original: Dash Digital Watch
    • Output: Dash Watch

  • strip_html - strips all HTML tags from a string.

    {{ item.product.description | strip_html }

  • truncate - truncates a string down to 'x' characters.

    {{ item.product.name | truncate: '15' }}

    • Original: Dash Digital Watch
    • Output: ash Digital Wa

  • if_empty - return argument, if the value is an empty string

    Dear {{ customer_name | if_empty: 'Client' }}!

    • Original: empty string
    • Output: Dear Client!

  • date - converts a string to a specified date-time format.

    {{ item.product.created_at | date: '%d.%m.%Y %H:%M' }}

    • Original: 2016-02-18 10:11:12
    • Output: 18.02.2016 10:11

    Full list of formatters can be found here

  • format_date - converts a string to a specified date-time format.

    {{ item.product.created_at | format_date: 3 }}

    • Original: 2016-02-18 10:11:12
    • Output: 18/02/16

    Possible formatters: 0, 1 , 2 , 3

• Numeric Filters

  • ceil - rounds the output up to the nearest integer.

    {{ item.product.weight | ceil }}

    • Original: 1.423
    • Output: 2

  • floor - rounds the output down to the nearest integer.

    {{ item.product.weight | floor }}

    • Original: 1.423
    • Output: 1

  • round - rounds the output to the nearest integer or specified decimal digits.

    {{ item.product.weight | round: '2' }}

    • Original: 1.423
    • Output: 1.42

    {{ item.product.weight | round }}

    • Original: 1.423
    • Output: 1

  • number_format - formats number to specified format (php function).

    {{ item.product.price | number_format: '2', '.', ',' }}

• Price/Currency Filters

  • format_price - formats price to default format.

    {{ item.product.price | format_price }}

    • Original: 100.42
    • Output: $100.42

  • convert - converts a price from base currency to specified currency.

    {{ item.product.price | convert: 'EUR' }}

    • Original: 100
    • Output: 92.28

• Array Filters

  • first - return first element in array.

  • last - return last element in array.

  • join - join array to string using glue.

  • size - return the size of an array or a string.

• URL Filters

  • resume - resume customer's session and redirect it to base URL

    {{ item.product.product_url | resume }}

• Image Filters

  • resize - resize image

    {{ item.product.image | resize: 'small_image', 100, 100 }}

    • Original: http://example.com/pub/media/catalog/product/m/h/mh03-black_main.jpg
    • Output: http://example.com/pub/media/cache/100x100/catalog/product/m/h/mh03-black_main.jpg

PHP Callouts

PHP Callouts is a very powerful tool to enhance your templates. It allows you to include PHP code directly to the HTML Code.

Here is the list of possible callouts with respective examples:

• Global Methods

  • getUnsubscribeUrl - a direct link to unsubscribe from current trigger.

    The customer will be unsubscribed from all already scheduled emails (Follow Up Email -> Mail Log (Queue)) for the current trigger.

    This link does not unsubscribe customers from future emails (triggered by other events) or native Magento subscription.

    Usage: <a href="<?php echo $this->getUnsubscribeUrl() ?>">Unsubscribe</a>

  • getUnsubscribeAllUrl - a direct link to unsubscribe from all triggers

    The customer will be unsubscribed from all already scheduled emails (Follow Up Email -> Mail Log (Queue)) for all triggers.

    This link does not unsubscribe customers from native Magento subscription.

    Usage: <a href="<?php echo $this->getUnsubscribeAllUrl() ?>">Unsubscribe</a>

  • getViewInBrowserUrl - a direct link to open email in browser

    Usage: <a href="<?php echo $this->getViewInBrowserUrl() ?>">View it in your browser.</a>

  • getResumeUrl - a direct link to resume (restore, log in) customer session

    Usage: <a href="<?php echo $this->getResumeUrl() ?>">Open</a>

    i.e., the customer will be automatically authorized in the store.

    Additionally, you can pass a parameter to the method to redirect the customer to a specific URL after authorization.

    Example

        <?php foreach($this->getOrder()->getAllVisibleItems() as $item): ?>
          <tr>
            <td>
              <a href="<?php echo $this->getResumeUrl($item->getProduct()->getProductUrl()) ?>">Review <?php echo $item->getName() ?></a>
            </td>
          </tr>
        <?php endforeach ?>

    i.e., the customer will be redirected to the product page to leave a review after automatic authorization.

  • getStoreUrl - a direct link to the store home page

    Usage: <?php echo $this->getStoreUrl() ?>

  • getStoreName - a curent store name

    Usage: <?php echo $this->getStoreName() ?>

  • getStorePhone - a curent store phone

    Usage: <?php echo $this->getStorePhone() ?>

  • getStoreAddress - a curent store address

    Usage: <?php echo $this->getStoreAddress() ?>

  • getStoreEmail - a curent store general transactional email

    Usage: <?php echo $this->getStoreEmail() ?>

• Customer Methods

  • getCustomerName - returns customer's full name

    Usage: Dear <?php echo $this->getCustomerName() ?>

    You can pass a parameter to the method getCustomerName() which will be used instead of the customer name, if the customer's name is empty: Dear <?php echo $this->getCustomerName(null, 'Customer') ?>, results in Dear Customer, if customer's name is empty (since version 1.0.34).

  • getFirstname - returns customer's firstname (since version 1.0.36)

    Usage: Dear <?php echo $this->getFirstname() ?>

  • getLastname - returns customer's lastname (since version 1.0.36)

    Usage: Dear <?php echo $this->getLastname() ?>

  • getCustomer - retrurns customer's object (only for registered customers)

    Usage: Hi <?php echo $this->getCustomer()->getFirstname() ?>

    <?php echo $this->getCustomer()->getEmail() ?>

• Shopping Cart Methods

  • getRestoreCartUrl - a direct link to customer shopping cart

    Usage: <a href="<?php echo $this->getRestoreCartUrl() ?>">Finish Checkout!</a>

  • getReorderCartUrl - redirects the customer to the quote with the products purchased from the previous order

    Usage: <a href="<?php echo $this->getReorderCartUrl() ?>">Reorder</a>

  • getQuote()->getAllVisibleItems() - return collection of products in cart for feature output

    Usage:

        <?php foreach ($this->getQuote()->getAllVisibleItems() as $item): ?>
            <?php echo $item->getName() ?>
        <?php endforeach ?>

    How to display only the first product:

    Example

        <?php $i = 0 ?>
        <?php foreach ($this->getQuote()->getAllVisibleItems() as $item): ?>
            <?php if ($i++ >= 1): ?>
                <?php break ?>
            <?php endif ?>
            ...
            other methods
            ...
        <?php endforeach ?>

• Order Methods

  • getOrder()->getStatus() - the status of order

    Usage: order status is <?php echo $this->getOrder()->getStatus() ?>

  • getOrder()->getIncrementId() - the order number

    Usage: Order #<?php echo $this->getOrder()->getIncrementId() ?>

  • getOrder()->getStoreGroupName() - the store name of order

    Usage: You placed order in <?php echo $this->getOrder()->getStoreGroupName() ?>

  • getOrder()->getAllVisibleItems() - return list of products in order for feature output

    Usage:

        <?php foreach ($this->getOrder()->getAllVisibleItems() as $item): ?>
            <?php echo $item->getName() ?>
        <?php endforeach ?>

    How to display only the first product:

    Example

        <?php $i = 0 ?>
        <?php foreach ($this->getOrder()->getAllVisibleItems() as $item): ?>
            <?php if ($i++ >= 1): ?>
                <?php break ?>
            <?php endif ?>
            ...
            other methods
            ...
        <?php endforeach ?>

  • Additional Methods

    Usage:

        <?php echo $this->getOrder()->getBaseTaxAmount() ?>
        <?php echo $this->getOrder()->getBaseGrandTotal() ?>
        <?php echo $this->getOrder()->getBaseShippingAmount() ?>
        <?php echo $this->getOrder()->getShippingDescription() ?> - returns shipping method name

• Coupons

  • getCoupon()->getCode() - get the expiration date of an autogenerated coupon code

    Usage: Expiration date: <?php echo $this->formatDate($this->getCoupon()->getExpirationDate()) ?>

    Different date formats:

        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate()) ?>
        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::MEDIUM) ?>
        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::LONG) ?>

    Example

        <?php if ($this->getCoupon()): ?>
            Let us offer you a discount to complete your purchase.<br>
            Your coupon code: <?php echo $this->getCoupon()->getCode() ?> valid till <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::MEDIUM) ?>
        <?php endif ?>

    i.e., we only display this text block if a coupon is available.

  • getCoupon()->getExpirationDate() - the autogenerated coupon code

    Usage: Your coupon code: <?php echo $this->getCoupon()->getCode() ?>

    Example

        <?php if ($this->getCoupon()): ?>
            Let us offer you a discount to complete your purchase.<br>
            Your coupon code: <?php echo $this->getCoupon()->getCode() ?>
        <?php endif ?>

    i.e., we only display this text block if a coupon is available.

• Cross-sell products

  • getCrossSellHtml - html block of cross sell products

    Usage: <?php echo getCrossSellHtml() ?>

    Example

        <?php if ($this->getCrossSellHtml()): ?>
            <h1>See also:</h1>
            <?php echo $this->getCrossSellHtml() ?>
        <?php endif ?>

    i.e., we only display this text block if products are available.

Variables & Methods

Our extension allows you to use variables and PHP callouts in your emails, which can greatly enhance and personalize them.

Liquid Variables

Liquid variables are a new way to enhance email templates. This syntax was introduced in version 1.1.15 and is the preferred syntax for use in Email Templates.

All variables should be enclosed in curly brackets. Each variable can also have a filter, added after pipe sign, and have one or more parameters.

These variables can be added interactively from edit pages of Theme or Template.

You just need to press the button Insert Variable near the content element, and select the variable you want to use - as shown below:

Modifying Variables with Filters

Filters are methods that allow you to alter or enhance the output of a variable. They also should be enclosed to the variable block {{ }}, but separated from the variable with a pipe (|) character. The parameters of filters are added using the colon (:) character.

Here is the list of available filters, grouped into categories, with examples:

• String/HTML Filters

  • downcase - converts a string into lowercase.

    {{ item.product.name | downcase }}

    • Original: Dash Digital Watch
    • Output: dash digital watch

  • upcase - converts a string into uppercase.

    {{ item.product.name | upcase }}

    • Original: Dash Digital Watch
    • Output: DASH DIGITAL WATCH

  • replace - replaces all occurrences of a string with a substring.

    {{ item.product.name | replace: 'Digital', 'Analog' }}

    • Original: Dash Digital Watch
    • Output: Dash Analog watch

  • append - appends characters to a string.

    {{ item.product.name | append: ' - best choice' }}

    • Original: Dash Digital Watch
    • Output: Dash Digital Watch - best choice

  • prepend - prepends characters to a string.

    {{ item.product.name | prepend: 'Best choice - ' }}

    • Original: Dash Digital Watch
    • Output: Best choice - Dash Digital Watch

  • capitalize - capitalizes words in the input sentence.

    {{ item.product.color | capitalize }}

    • Original: dark red
    • Output: Dark red

  • escape - escapes HTML tags in a string.

    {{ item.product.description | escape }

  • newline_to_br - inserts a <br> linebreak HTML tag in front of each line break in a string.

    {{ item.product.short_description | newline_to_br }

  • remove - removes all occurrences of a substring from a string.

    {{ item.product.name | remove: 'Digital' }}

    • Original: Dash Digital Watch
    • Output: Dash Watch

  • strip_html - strips all HTML tags from a string.

    {{ item.product.description | strip_html }

  • truncate - truncates a string down to 'x' characters.

    {{ item.product.name | truncate: '15' }}

    • Original: Dash Digital Watch
    • Output: ash Digital Wa

  • if_empty - return argument, if the value is an empty string

    Dear {{ customer_name | if_empty: 'Client' }}!

    • Original: empty string
    • Output: Dear Client!

  • date - converts a string to a specified date-time format.

    {{ item.product.created_at | date: '%d.%m.%Y %H:%M' }}

    • Original: 2016-02-18 10:11:12
    • Output: 18.02.2016 10:11

    Full list of formatters can be found here

  • format_date - converts a string to a specified date-time format.

    {{ item.product.created_at | format_date: 3 }}

    • Original: 2016-02-18 10:11:12
    • Output: 18/02/16

    Possible formatters: 0, 1 , 2 , 3

• Numeric Filters

  • ceil - rounds the output up to the nearest integer.

    {{ item.product.weight | ceil }}

    • Original: 1.423
    • Output: 2

  • floor - rounds the output down to the nearest integer.

    {{ item.product.weight | floor }}

    • Original: 1.423
    • Output: 1

  • round - rounds the output to the nearest integer or specified decimal digits.

    {{ item.product.weight | round: '2' }}

    • Original: 1.423
    • Output: 1.42

    {{ item.product.weight | round }}

    • Original: 1.423
    • Output: 1

  • number_format - formats number to specified format (php function).

    {{ item.product.price | number_format: '2', '.', ',' }}

• Price/Currency Filters

  • format_price - formats price to default format.

    {{ item.product.price | format_price }}

    • Original: 100.42
    • Output: $100.42

  • convert - converts a price from base currency to specified currency.

    {{ item.product.price | convert: 'EUR' }}

    • Original: 100
    • Output: 92.28

• Array Filters

  • first - return first element in array.

  • last - return last element in array.

  • join - join array to string using glue.

  • size - return the size of an array or a string.

• URL Filters

  • resume - resume customer's session and redirect it to base URL

    {{ item.product.product_url | resume }}

• Image Filters

  • resize - resize image

    {{ item.product.image | resize: 'small_image', 100, 100 }}

    • Original: http://example.com/pub/media/catalog/product/m/h/mh03-black_main.jpg
    • Output: http://example.com/pub/media/cache/100x100/catalog/product/m/h/mh03-black_main.jpg

PHP Callouts

PHP Callouts is a very powerful tool to enhance your templates. It allows you to include PHP code directly to the HTML Code.

Here is the list of possible callouts with respective examples:

• Global Methods

  • getUnsubscribeUrl - a direct link to unsubscribe from current trigger.

    The customer will be unsubscribed from all already scheduled emails (Follow Up Email -> Mail Log (Queue)) for the current trigger.

    This link does not unsubscribe customers from future emails (triggered by other events) or native Magento subscription.

    Usage: <a href="<?php echo $this->getUnsubscribeUrl() ?>">Unsubscribe</a>

  • getUnsubscribeAllUrl - a direct link to unsubscribe from all triggers

    The customer will be unsubscribed from all already scheduled emails (Follow Up Email -> Mail Log (Queue)) for all triggers.

    This link does not unsubscribe customers from native Magento subscription.

    Usage: <a href="<?php echo $this->getUnsubscribeAllUrl() ?>">Unsubscribe</a>

  • getViewInBrowserUrl - a direct link to open email in browser

    Usage: <a href="<?php echo $this->getViewInBrowserUrl() ?>">View it in your browser.</a>

  • getResumeUrl - a direct link to resume (restore, log in) customer session

    Usage: <a href="<?php echo $this->getResumeUrl() ?>">Open</a>

    i.e., the customer will be automatically authorized in the store.

    Additionally, you can pass a parameter to the method to redirect the customer to a specific URL after authorization.

    Example

        <?php foreach($this->getOrder()->getAllVisibleItems() as $item): ?>
          <tr>
            <td>
              <a href="<?php echo $this->getResumeUrl($item->getProduct()->getProductUrl()) ?>">Review <?php echo $item->getName() ?></a>
            </td>
          </tr>
        <?php endforeach ?>

    i.e., the customer will be redirected to the product page to leave a review after automatic authorization.

  • getStoreUrl - a direct link to the store home page

    Usage: <?php echo $this->getStoreUrl() ?>

  • getStoreName - a curent store name

    Usage: <?php echo $this->getStoreName() ?>

  • getStorePhone - a curent store phone

    Usage: <?php echo $this->getStorePhone() ?>

  • getStoreAddress - a curent store address

    Usage: <?php echo $this->getStoreAddress() ?>

  • getStoreEmail - a curent store general transactional email

    Usage: <?php echo $this->getStoreEmail() ?>

• Customer Methods

  • getCustomerName - returns customer's full name

    Usage: Dear <?php echo $this->getCustomerName() ?>

    You can pass a parameter to the method getCustomerName() which will be used instead of the customer name, if the customer's name is empty: Dear <?php echo $this->getCustomerName(null, 'Customer') ?>, results in Dear Customer, if customer's name is empty (since version 1.0.34).

  • getFirstname - returns customer's firstname (since version 1.0.36)

    Usage: Dear <?php echo $this->getFirstname() ?>

  • getLastname - returns customer's lastname (since version 1.0.36)

    Usage: Dear <?php echo $this->getLastname() ?>

  • getCustomer - retrurns customer's object (only for registered customers)

    Usage: Hi <?php echo $this->getCustomer()->getFirstname() ?>

    <?php echo $this->getCustomer()->getEmail() ?>

• Shopping Cart Methods

  • getRestoreCartUrl - a direct link to customer shopping cart

    Usage: <a href="<?php echo $this->getRestoreCartUrl() ?>">Finish Checkout!</a>

  • getReorderCartUrl - redirects the customer to the quote with the products purchased from the previous order

    Usage: <a href="<?php echo $this->getReorderCartUrl() ?>">Reorder</a>

  • getQuote()->getAllVisibleItems() - return collection of products in cart for feature output

    Usage:

        <?php foreach ($this->getQuote()->getAllVisibleItems() as $item): ?>
            <?php echo $item->getName() ?>
        <?php endforeach ?>

    How to display only the first product:

    Example

        <?php $i = 0 ?>
        <?php foreach ($this->getQuote()->getAllVisibleItems() as $item): ?>
            <?php if ($i++ >= 1): ?>
                <?php break ?>
            <?php endif ?>
            ...
            other methods
            ...
        <?php endforeach ?>

• Order Methods

  • getOrder()->getStatus() - the status of order

    Usage: order status is <?php echo $this->getOrder()->getStatus() ?>

  • getOrder()->getIncrementId() - the order number

    Usage: Order #<?php echo $this->getOrder()->getIncrementId() ?>

  • getOrder()->getStoreGroupName() - the store name of order

    Usage: You placed order in <?php echo $this->getOrder()->getStoreGroupName() ?>

  • getOrder()->getAllVisibleItems() - return list of products in order for feature output

    Usage:

        <?php foreach ($this->getOrder()->getAllVisibleItems() as $item): ?>
            <?php echo $item->getName() ?>
        <?php endforeach ?>

    How to display only the first product:

    Example

        <?php $i = 0 ?>
        <?php foreach ($this->getOrder()->getAllVisibleItems() as $item): ?>
            <?php if ($i++ >= 1): ?>
                <?php break ?>
            <?php endif ?>
            ...
            other methods
            ...
        <?php endforeach ?>

  • Additional Methods

    Usage:

        <?php echo $this->getOrder()->getBaseTaxAmount() ?>
        <?php echo $this->getOrder()->getBaseGrandTotal() ?>
        <?php echo $this->getOrder()->getBaseShippingAmount() ?>
        <?php echo $this->getOrder()->getShippingDescription() ?> - returns shipping method name

• Coupons

  • getCoupon()->getCode() - get the expiration date of an autogenerated coupon code

    Usage: Expiration date: <?php echo $this->formatDate($this->getCoupon()->getExpirationDate()) ?>

    Different date formats:

        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate()) ?>
        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::MEDIUM) ?>
        <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::LONG) ?>

    Example

        <?php if ($this->getCoupon()): ?>
            Let us offer you a discount to complete your purchase.<br>
            Your coupon code: <?php echo $this->getCoupon()->getCode() ?> valid till <?php echo $this->formatDate($this->getCoupon()->getExpirationDate(), \IntlDateFormatter::MEDIUM) ?>
        <?php endif ?>

    i.e., we only display this text block if a coupon is available.

  • getCoupon()->getExpirationDate() - the autogenerated coupon code

    Usage: Your coupon code: <?php echo $this->getCoupon()->getCode() ?>

    Example

        <?php if ($this->getCoupon()): ?>
            Let us offer you a discount to complete your purchase.<br>
            Your coupon code: <?php echo $this->getCoupon()->getCode() ?>
        <?php endif ?>

    i.e., we only display this text block if a coupon is available.

• Cross-sell products

  • getCrossSellHtml - html block of cross sell products

    Usage: <?php echo getCrossSellHtml() ?>

    Example

        <?php if ($this->getCrossSellHtml()): ?>
            <h1>See also:</h1>
            <?php echo $this->getCrossSellHtml() ?>
        <?php endif ?>

    i.e., we only display this text block if products are available.

Mail Log (Queue)

This extension allows you to track triggered emails.

Go to Marketing > Follow Up Email > Mail Log (Queue). You will see the following fields:

• ID - ID of the mail
• Status - current status of the trigger email. You can track emails with these statuses:
  • Ready to go - email is ready to be delivered
  • Sent - email has already been delivered
  • Canceled - email delivery was cancelled
  • Error - error has occured while email was being delivered
  • Missed - email delivery didn't occur
  • Unsubscribed - customer unsubscribed from the email newsletter
• Trigger - name of the email trigger
• Scheduled At - time when email was added to the queue
• Sent At - time when email was delivered to the recipient
• Recipient Email - customer email
• Recipient Name - customer name
• Action - actions on the selected emails in the queue:
  • Cancel - cancel processing of the trigger email in the queue
  • Send - send the trigger email to the Recipient Email (available in the mass actions)
  • Change Status - allows you to change the Status of the trigger email

Click on the triggered email. You will see detailed information about the triggered email in the next tabs: General information, History, Variables.

Event Log

This extension allows you to track triggered events at the store.

Go to Marketing > Follow Up Email > Event Log. You will see the following fields:

• ID - ID of the event.
• Event - a certain action of a visitor (login, registration, placing an order) or action of a system (change order status, change of price), which can be used as a trigger for emails.
• Created At - time when the event occurred.
• Arguments - additional data of the event (uniq_key, customer email, name, quote_id, order_id, store_id, time).
• Triggers - information about the amount and status of triggers for the current event.
• Actions - actions on the selected events:
  • Reset & Process - allows you to reset the current event's trigger status and bring it back to the queue.
  • Delete - remove the event from the list.

GDPR Compliance Tips

Since our module collects user data for sending emails, please check out some tips for making the extension fully compliant with the GDPR:

1. Send emails only to confirmed customers. You can use the rules to filter the target audience:

   Example

   • Customer: Is subscriber of the newsletter is Yes
2. There is a cron job email_clean_history which removes a month's worth of old emails and events
3. You can disable automatic guest user data capturing
4. You can manually delete all of the stored user data:
   • To remove emails, go to Marketing > Follow Up Email > Mail Log, select the required emails, choose the Delete option in the Actions dropdown, and press Submit.
   • To remove registered events, go to Marketing > Follow Up Email > Event Log, select the required events, choose the Delete option in the Actions dropdown, and press Submit.
   • To reset a particular statistics go to Marketing > Follow Up Email > Settings, press the button Reset Statistics at the Statistics tab.
5. Do not forget to include the unsubscription link to the emails using the variable {{ url.unsubscribe_newsletter_url }} - to unsubscribe from all triggers and the newsletter.

Troubleshoot

This section describes the most common problems that customers report and how they can be resolved:

• The email does not show the coupon code
• The related, upsell or cross-sell products are not displayed
• How do I translate an email template?

The email does not show the coupon code

The coupon code is not visible in the email.

Solution:

1. Make sure the coupon code is enabled in the email settings of your trigger.
2. If there are no available Cart Price Rules in the email settings, make sure that the option Use Auto Generation is checked at least in one rule.

   Note

   The Use Auto Generation checkbox is available in the Cart Price rules only when you choose the Specific Coupon option at the Coupon field of your Cart Price Rule.

The related, upsell or cross sell products are not displayed

The block with the selected cross-sell, related, or upsell products is not displayed in the email.

The products for the cross-sell block are selected based on the products associated with the customer's orders or shopping cart.
Before using one of the types as the source for cross-sell block, make sure that an appropriate type of product is configured.

Solution:

Make sure your products have the cross-sell, related, or upsell products:

1. Open one of your products in the admin panel in edit mode.
2. Scroll down and expand the Related Products, Up-Sells, and Cross-Sells section.
3. You'll see products there if you have configured these settings earlier, but if there are no products, you should configure them.

For more information refer to Magento documentation: https://docs.magento.com/m2/ce/user_guide/catalog/settings-advanced-related-products.html. Also you may find interesting to insert our Related Products for Magento 2 in your emails.

How do I translate an email template?

There are several ways to translate emails:

1. Separate email templates per language:

   1. Create a new email template in the desired language.
   2. Create a separate trigger per store and for emails using templates in the corresponding language.

2. Use the Magento translation mechanism:
   For example, you want to translate the text Shop Now in the Welcome email template. To translate it, copy the source string with this text to the CSV file located in your theme directory. The translation may look as follows:

   Example

   <a href="{{ store.store_url }}">Shop Now</a>   
   <a href="{{ store.store_url }}">Shop Right Now</a>

   Or if you want translate the subject:

   Example

   Hello {{ customer_name }}!, Hola {{ customer_name }}!

   Note

   If the string you want to translate contains commas, then you should wrap the translation string with the double quotation mark ("). But if the string in addition to comma contains a double quotation mark, then you should replace all double quotes in the original text with the single quotation mark (').

After extension update php code in the templates stopped working

According to the Magento security policies starting with the module-email version 2.1.28 and module-email-designer version 1.1.31 ability to use php code in the templates was disabled.

If this ability is vital for your store, it is possible to revert the function code located at the file vendor/mirasvit/module-email-designer/src/EmailDesigner/Service/TemplateEngine/Php.php

After a Magento or extension update, the event log is empty and emails don't send.

To fix this, open the /app/etc/env.php file and check if you have the consumers section.

...
    'cron_consumers_runner' => [
        'cron_run' => false,
        'max_messages' => 20000,
        'consumers' => [
            'consumer1',
            'consumer2'
        ]
    ],
...

If you have it, you should add our job 'mirasvit.event.mq.register' to the list. Once added, run the command php -f bin/magento queue:consumers:start mirasvit.event.mq.register to start it.

Example:

...
    'cron_consumers_runner' => [
        'cron_run' => false,
        'max_messages' => 20000,
        'consumers' => [
            'product_action_attribute.update',
            'inventory.source.items.cleanup',
            'mirasvit.event.mq.register'
        ]
    ],
...

How to upgrade the extension

To upgrade the extension, take the following steps:

1. Back up your store's database and web directory.
2. Log in to the SSH console of your server and navigate to root directory of the Magento 2 store.
3. Run the command composer require mirasvit/module-email:* --update-with-dependencies to update the current extension with all dependencies.

   Note

   In some cases, the command above is not applicable, or you are unable to update just the current module, and need to upgrade all Mirasvit modules in a bundle. In this case, the command above will have no effect.
   
   Instead, run the composer update mirasvit/* command. It will update all Mirasvit modules installed in your store.
   
   
4. Run the command php -f bin/magento setup:upgrade to install updates.
5. Run the command php -f bin/magento cache:clean to clean the cache.

6. Deploy static view files

   rm -rf pub/static/*; rm -rf var/view_preprocessed/*; php -f bin/magento setup:static-content:deploy

Disabling Extension

Temporarily Disable

To temporarily disable the extension, please take the following steps:

1. Log in to the SSH console on your server and navigate to the root directory of the Magento 2 store.
2. Run the command php -f bin/magento module:disable Mirasvit_Email Mirasvit_EmailDesigner Mirasvit_EmailReport to disable the extension.
3. Log in to the Magento backend and refresh the store cache (if enabled).

Extension Removal

To uninstall the extension, please take the following steps:

1. Log in to the SSH console on your server and navigate to the root directory of the Magento 2 store.
2. Run the command composer remove mirasvit/module-email to remove the extension.
3. Log in to the Magento backend and refresh the store cache (if enabled).

Change Log

2.7.5

(2024-12-18)

Features

• Integration with Mirasvit Related Products (ability to use products selections from Related Products blocks for a crosssell variable)

2.7.4

(2024-12-10)

Fixed

• Corrected data type in subject column from text to varchar to optimize database size

2.7.3

(2024-12-02)

Improvements

• Added the "alt" attribute to the <img> tag for improved accessibility and SEO compliance.

2.7.2

(2024-11-25)

Improvements

• Added the "Unsubscription List" user role to the access control list

Fixed

• Fixed the issue with the quick data bar (MySQL error)
• Fixed the issue with the restore_cart_url (MySQL error)

2.7.1

(2024-10-02)

Fixed

• Fixed the issue with Facebook and Twitter URLs (email templates)

2.7.0

(2024-07-24)

Features

• Added "Reward Variables" to email templates (integration with the Mirasvit "Reward Points" module)
• Added time range selector

2.6.4

(2024-06-14)

Fixed

• Fixed the issue with the "Send Test Email" button

2.6.3

(2024-06-03)

Fixed

• Fixed the issue with tracking opened email when BODY tag is not present in the email layout

2.6.2

(2024-05-27)

Features

• Added new cancellation event

Fixed

• Fixed the issue with abandoned cart emails scheduled with incorrect date (1 hour earlier)

2.6.1

(2024-04-11)

Improvements

• Ensure directory is not writable before modifying permissions

Fixed

• Fixed email cancellation issue for order status change events
• Fixed the date picker display issue

2.6.0

(2024-03-06)

Features

• Added integration with the remote storage

2.5.10

(2024-02-13)

Fixed

• Fixed the issue with deleting an email template (Creation of dynamic property Mirasvit\EmailDesigner\Controller\Adminhtml\Template\Delete\Interceptor::$chainRepository is deprecated)

2.5.9

(2024-01-25)

Improvements

• Added output escaping

2.5.8

(2024-01-18)

Fixed

• Fixed the issue with wrong links in email when sending via cron (some cases)

2.5.7

(2023-12-19)

Fixed

• Fixed the issue with the click tracker ("strpos(): Argument [#1]() ($haystack) must be of type string, bool given")

2.5.6

(2023-12-08)

Fixed

• Fixed the success message when a customer unsubscribes from trigger emails

2.5.5

(2023-11-10)

Fixed

• Fixed the issue with the "{% if crosssell.cross_sell_html %}" condition

2.5.4

(2023-11-06)

Features

• Added the "Cleanup Period" configuration to set the number of days after which cron deletes old events and emails

2.5.3

(2023-10-13)

Features

• Added error handling to prevent the cron schedule from hanging

Improvements

• Check trigger events for selected stores only

Fixed

• Fixed the return type of the getTemplate() function
• Fixed the issue with the "Excluded Weekdays" field on the "Edit Email" page
• Fixed the issue with the chain saving (some cases)

2.5.2

(2023-08-15)

Fixed

• Fixed the issue with cancelation events when multiple abandoned carts processed in one cron run

2.5.1

(2023-08-02)

Fixed

• fixed an error in the email templates: "Creation of dynamic property ... $context is deprecated"
• fixed an error: "Undefined variable $result in /vendor/mirasvit/module-email/src/Email/Model/Config/Source/TriggerSource.php"

2.5.0

(2023-07-06)

Improvements

• Added protection against deleting themes used in templates
• Added protection against deleting templates used in created campaigns
• After clicking on the email unsubscribe button, the unsubscribe message will not be displayed on the main page, but on a separate page

Fixed

• Fixed an issue with not working trigger 'active from' and 'active to' dates
• Fixed an error when trying to send a test email
• Fixed an issue with not updating email template after selecting 'Auto Refresh' button
• Fixed an error when trying to send email 'Argument [#1]() () must be of type Magento\Sales\Model\Order\Address, null given'

2.4.9

(2023-06-15)

Fixed

• Undefined method on the unsubscription grid page (admin)

2.4.8

(2023-06-13)

Fixed

• Issue with processing events, when trigger is not assigned to store

2.4.7

(2023-06-05)

Improvements

• Revamped the campaigns overview interface
• Changed the Queue and Event interfaces to UI components
• Added the ability to validate events based on trigger audience rules

2.4.6

(2023-03-27)

Fixed

• Fixed issue with abandoned cart emails when triggered Cancellation events didn't cancel sending emails

2.4.5

(2023-02-07)

Fixed

• Canceling email only for events related to the current entity (previously all emails assigned to email were canceled)
• PHP8.1 compatibility issue. Mirasvit\Email\Model\Unsubscription::unsubscribe. ($triggerId) must be of type ?int, string given

2.4.3

(2022-10-13)

Improvements

• Small code improvements for Magento Marketplace

2.4.2

(2022-10-12)

Improvements

• small changes for Magento Marketplace

2.4.1

(2022-09-16)

Fixed

• updated button styles in the preinstalled templates
• fixed an issue with the missing products in the wishlist emails
• fixed an issue with the changing 'Delivery Time Delay' period in the email template

2.4.0

(2022-08-16)

Improvements

• Support of Magento MQ

Fixed

• PHP8.1 compatibility issue

2.3.5

(2022-08-09)

Fixed

• fixed an issue with the variables errors in the email templates

2.3.4

(2022-07-15)

Fixed

• Fixed the issue with processing events
• Fixed an issue with using number_format function

2.3.3

(2022-07-13)

Fixed

• fixed the error with base64_encode function
• fixed the error with sending test emails
• fixed the error with redirecting email links

2.3.2

(2022-06-28)

Fixed

• Fixed the issue with emails not being sent

2.3.1

(2022-06-23)

Fixed

• Fixed the issue with errors related to return types

2.3.0

(2022-06-22)

Improvements

• Remove db_schema_whitelist.json
• Code refactoring
• module-email-design and module-email-report merged into module-email
• Removed service and repository interfaces
• Updated admin interface

Fixed

• Fixed the issue with variables (docblock)

2.2.4

(2022-06-20)

Improvements

• remove db_schema_whitelist.json

Fixed

• Fixed the issue with variables (docblock)

2.2.3

(2022-05-25)

Fixed

• Fixed an issue with the page styles on Magento 2.4.4
• Issue with decalrative schema

2.2.0

(2022-05-23)

Improvements

• Migrate to declarative schema

2.1.45

(2020-11-03)

Fixed

• fixed an issue with the missing test email send button at the Magento 2.4.x
• fixed an issue with the checkout processing
• fixed an issue with the event grid filtering

2.1.44

(2020-09-07)

Fixed

• fixed an issue with the checkout processing M2.4

2.1.43

(2020-07-29)

Improvements

• Support of Magento 2.4

2.1.42

(2020-06-18)

Fixed

• fixed an issue with the emails delivery via 'Send' action button at the Mail Log (Queue)

2.1.41

(2020-05-27)

Fixed

• show warning message before sending test email that trigger 'Event' was not specified
• fixed an issue with the showing html text in the emails

2.1.40

(2020-03-13)

Fixed

• added Mageplaza Smtp compatibility

2.1.39

(2020-03-04)

Fixed

• fixed an issue with incorrect redirect urls of the cross-sell products

2.1.38

(2020-02-26)

Fixed

• fixed an issue with incorrect redirect urls of the cross-sell products

2.1.37

(2020-02-18)

Features

• added new template coupon variable 'Get coupon expiration date'

2.1.36

(2020-02-10)

Features

• added new template url variable 'Get URL used to create a new checkout cart for reorder'

2.1.35

(2020-01-08)

Improvements

• added functionality to manage emails subscriptions and unsubscriptions at Marketing > Follow Up Email > Unsubscription List
• added recipient email validation before sending

2.1.34

(2020-01-08)

Improvements

• added mass action for the events: 'Reset & Process'

2.1.33

(2019-12-16)

Improvements

• added trigger event "Change Group"

2.1.32

(2019-12-05)

Fixed

• show only in stock and enabled products at the template cross sell block

2.1.31

(2019-12-03)

Improvements

• added compatibility with the Mageplaza Smtp

Fixed

• fixed an issue with the active coupon status after his expiration date

2.1.30

(2019-11-05)

Fixed

• Issue with call to undefined method EmailMessage::setSubject()

2.1.29

(2019-10-31)

Fixed

• Compatibility with Magento 2.3.3

2.1.28

(2019-08-14)

Fixed

• EQP code refactoring

2.1.27

(2019-07-30)

Fixed

• Conflict with mageplaza smtp

2.1.26

(2019-07-11)

Fixed

• fixed an issue with the events processing

2.1.25

(2019-06-26)

Fixed

• fixed an issue with the incorrect displaying 'Scheduled At' emails date

2.1.24

(2019-04-22)

Fixed

• Compatibility with Ebizmarts Mandrill

2.1.23

(2019-03-27)

Fixed

• fixed an issue with the incorrect 'Sender From' name at the emails

2.1.22

(2019-03-22)

Fixed

• fixed an issue with missing Google Analytics parameters at the email urls

2.1.21

(2019-03-18)

Fixed

• Compatibility with M2.1
• fixed an issue with the sending test emails
• Issue deleting trigger' email chain from campaign

2.1.20

(2019-02-21)

Fixed

• Fix compilation error for Magento 2.1

Documentation

• Update path to Event settings

2.1.19

(2019-02-11)

Fixed

• Issue saving active to/from dates for trigger #116

2.1.18

(2019-02-08)

Fixed

• Fix error blocking Magento installation
• View email in browser shows wrong email
• Possible issue with sending emails. Error message like "The recipient address < ...> is not a valid RFC-5321"

2.1.17

(2018-12-24)

Fixed

• Error after navigation by link through email

2.1.16

(2018-12-10)

Fixed

• Trigger's rule edit section does not work

2.1.15

(2018-11-30)

Improvements

• support for M2.3

2.1.14

(2018-10-22)

Fixed

• Wrong emails report
• CSS issue

2.1.12

(2018-10-03)

Improvements

• Improved Reports

2.1.11

(2018-09-26)

Fixed

• Test emails continue to be sent automatically
• Error opening a campaign when email chain template has been removed
• DI compilation error

Documentation

• changes to getCustomerName callout

2.1.10

(2018-09-06)

Fixed

• Do not enqueue email if there is no recipient email address

2.1.9

(2018-09-05)

Fixed

• Mass send function does not work in Mail Log

Documentation

• Troubleshoot for translation of email templates

2.1.8

(2018-08-30)

Fixed

• Test email is not sent, when admin URL does not match front URL

2.1.7

(2018-08-29)

Fixed

• unsubscribe variable does not work

Documentation

• troubleshoot for coupon code and block with cross-sell products

2.1.6

(2018-08-03)

Fixed

• Campaign edit page is not loaded after update: emaildesigner keyword added 2 times

2.1.5

(2018-07-31)

Fixed

• Manage campaigns pages is not loaded on Magento 2.1.0 version

2.1.4

(2018-07-13)

Features

• Ability to disable Magento Newsletter's Success Email Template

Documentation

• How to disable the default Magento Newsletter's Success Email Template

2.1.3

(2018-07-09)

Improvements

• Refactoring

2.1.2

(2018-07-09)

Fixed

• fixed an issue with incorrect output of Facebook and Twitter Urls in emails

2.1.1

(2018-07-03)

Improvements

• Properly retrieve cross-sell products
• Ability to translate email template text via i18n CSV files
• Mute 'payment' error when rendering native Magento email templates and log them instead
• Use latest order information in test and preview emails

Fixed

• Properly create campaigns from template
• Email template editor loses focus on Safari
• Avoid error for test and preview emails during product image rendering
• Properly render native Magento email templates
• Error on 'setup:di:compile' on Magento versions prior to 2.2 (affects from 1.1.20)

2.1.0

(2018-06-28)

Features

• Ability to use native Magento email templates

Improvements

• Improve product image select algorithm in email templates

Fixed

• Product price change triggers the Abandoned Cart event of a cart which contains this product

2.0.4

(2018-05-31)

Fixed

• Invalid trigger link on Queue Preview page
• Cannot save trigger: properly handle resource permissions

2.0.3

(2018-05-24)

Fixed

• Error during running command 'setup:update' after module installation

2.0.2

(2018-05-17)

Fixed

• Error opening campaigns on Magento prior to 2.2 versions: 'Element modal is not expected'

2.0.1

(2018-05-11)

Fixed

• Error during update: use correct version of Email Designer module
• Error during compiling DI files

2.0.0

(2018-05-11)

Features

• New major update: UI, Campaigns, Statistic and other improvements

Documentation

• GDPR Compliance Tips

1.1.25

(2018-04-27)

Improvements

• Compatibility with latest email report module

Fixed

• Error previewing templates - negative offset in SQL
• Issue saving active to/from dates

1.1.24

(2018-03-02)

Fixed

• remove 'custom' area from the default email design

Documentation

• Update installation instruction

1.1.23

(2018-02-27)

Fixed

• Emails are sent to all store views instead of chosen only (affects since 1.1.19)

1.1.22

(2018-02-16)

Fixed

• Do not use same coupon code across different emails of the same trigger #60

Documentation

• correct command to update module
• product view event
• liquid is supported with Email Themes now
• Documentation for liquid syntax #45

1.1.21

(2018-02-12)

Improvements

• Move Email Theme editor to liquid syntax mirasvit/module-email-designer#4
• Liquid syntax allows to avoid blocking of templates rendering by server extension "ModSecurity"

Bugfixes

• Do not show coupon block in emails even if it disabled

1.1.20

(2018-02-09)

Features

• New condition 'Recipient does not have emails for triggers' #53
• Product View event #33
• Default trigger for Product View event #58
• Email template for Product View event #54

Bugfixes

• Cross sell products are not displayed in emails #55

Improvements

• Register only active events mirasvit/module-event#9

1.1.19

(2018-01-30)

Improvements

• Process events in realtime with message-queue #19

1.1.18

(2018-01-26)

Bugfixes

• Solve error during performing setup:di:compile command
• Fix error for restore checkout method - use correct alias for Quote model

1.1.17

(2018-01-24)

Improvements

• Create a new cart if the previous one has already been finished earlier #46

1.1.16

(2018-01-18)

Bugfixes

• test emails are not sent

Documentation

• Update for manual installation instruction

1.1.15

(2018-01-16)

Features

• new UI for working with variables in emails mirasvit/module-email-designer
• Liquid template engine and menu with available variables

Bugfixes

• correctly emulate store to retrieve correct product URL
• fixed an issue with the incorrect restore cart url redirect from email ()

Improvements

• add liquid variables
• Set queue status to 'Error' if it throws errors during sending

1.1.10

(2017-12-11)

Fixed

• Use product URLs with a correct store base URL
• Show global Follow Up Email settings for website and store view
• Use sender name and email from store scope when available
• Do not duplicate trigger on save
• Fixed an issue with the incorrect restore cart url redirect from email

1.1.9

(2017-12-01)

Fixed

• Validate only triggering events on the event check stage

1.1.8

(2017-11-23)

Improvements

• Rename column's title
• Remove old files

1.1.7

(2017-11-03)

Fixed

• Ignore test events

1.1.6

(2017-11-01)

Fixed

• Problem with trigger excluded weekdays setting

1.1.5

(2017-11-01)

Fixed

• Installation error
• Error opening trigger listing due to loading trigger rules

Documentation

• Update installation docs

1.1.4

(2017-10-30)

Fixed

• Use correct MySQL column type for updated/created at columns

1.1.3

(2017-10-30)

Fixed

• Compatibility with PHP > 7.0.0

1.1.2

(2017-10-27)

Fixed

• Properly migrate rules

1.1.1

(2017-10-27)

Fixed

• Disable console command
• Remove unused classes
• Update dates

1.1.0

(2017-10-26)

Improvements

• Add Sample Triggers
• Update Trigger's Rules On Event Changing
• Show Only Events Available For Follow Up Email
• Integrate With Module-event

Fixed

• Remove Unnecessary Files
• Correct Trigger Link In Queue View
• Ignore Shopping Carts That Have Associated Orders
• Filter Payment Methods Without Labels

1.0.57

(2017-09-28)

Fixed

• Fix error during compilation

1.0.56

(2017-09-27)

Improvements

• Compatibility with Magento 2.2

1.0.55

(2017-09-05)

Fixed

• Properly create Administrator triggers

1.0.54

(2017-09-04)

Documentation

• Improve documentation

1.0.53

(2017-09-04)

Fixed

• Compatibility with Magento 2.2.0rc

1.0.52

(2017-09-01)

Fixed

• Fix incorrect dependency error during compilation

1.0.51

(2017-09-01)

Improvements

• UI improvements

1.0.50

(2017-08-31)

Fixed

• Use correct source of events

1.0.49

(2017-08-31)

Documentation

• Delete old information

1.0.47

(2017-08-30)

Improvements

• Improve UI

1.0.46

(2017-08-11)

Documentation

• Mail Log

1.0.45

(2017-08-10)

Improvements

• Cancel emails whose email chain was removed from trigger
• Add identifier to cross sell block

Fixed

• Allow deselect the cancellation event
• correctly define email delay when sending email at specific time using 'at' option

Documentation

• Documentation for coupon code expiration date and displaying only first item

1.0.44

(2017-07-19)

Fixed

• YAML require

1.0.43

(2017-07-14)

Improvements

• Ability to delete email queues

1.0.42

(2017-07-14)

Bugfixes

• Escape colon character in yaml files

Improvements

• Performance (added indexes to db tables)

1.0.41

(2017-06-29)

Documentation

• Description of template methods and Mail Log section

1.0.40

(2017-06-29)

Features

• New condition 'Product Attribute Value Comparison'

Improvements

• Show more information about email queue cancellation event

1.0.39

(2017-06-21)

Bugfixes

• Compatibility with Ebizmarts Mandrill

1.0.38

(2017-06-20)

Bugfixes

• Problem with serializing email arguments
• Do not add 'test' subject for emails sent manually through email queue

Improvements

• Display cancellation event key

1.0.37

(2017-06-13)

Fixed

• Issue with queue

1.0.36

(2017-06-12)

Bugfixes

• Email is not sent to admin if multiple email addresses specified

1.0.35

(2017-05-12)

Features

• New conditions for order condition group

Bugfixes

• Error displaying cross sell products

1.0.34

(2017-05-04)

Bugfixes

• Properly place fragment part in generated URLs
• Fix issue with the product subselection condition

1.0.33

(2017-05-03)

Bugfixes

• Compatibility with the versions before introducing ability to send emails every X period (affects since 1.0.32)
• Add cross-sell html to base theme

1.0.32

(2017-04-28)

Features

• Ability to send emails every X days/weeks/months/years

Bugfixes

• Header is displayed like a field

Improvements

• Order event, use customer name from address if it's empty in order

1.0.31

(2017-04-19)

Bugfixes

• Show correct time values at the Mail Log message

Improvements

• Separate cron group for Follow Up Email extension

1.0.30

(2017-04-12)

Features

• New method 'getResumeUrl' to automatically login customers

1.0.29

(2017-03-29)

Features

• Ability to validate concrete number of products in cart/order
• New event 'Customer Review Approved'

1.0.28

(2017-03-24)

Bugfixes

• Fix error while restoring shopping cart

1.0.27

(2017-03-20)

Features

• Ability to validate events in mass action according trigger's rules

Bugfixes

• Correctly set numbers of affected records in response messages
• Fix issue with the condition "Shopping Cart products available for purchase"

1.0.26

(2017-03-17)

Bugfixes

• Trigger email chains reset after changing status of triggers in mass action

1.0.25

(2017-03-16)

Improvements

• Check order object before processing it

1.0.24

(2017-03-07)

Bugfixes

• Fix issue with 'Shipping Address' rules

1.0.23

(2017-03-02)

Bugfixes

• Use correct store ID for new product review event (affects all)

1.0.21

(2017-02-20)

Fixed

• Fixed an issue with abandoned cart trigger

1.0.20

(2017-01-30)

Bugfixes

• Correctly display email queue view page (affects all)

1.0.19

(2017-01-25)

Bugfixes

• Fixed problem when using SKU condition in products selection

1.0.18

(2017-01-23)

Fixed

• Fixed an issue with utm_ tags

1.0.17

(2017-01-06)

Fixed

• Fixed an issue with restoring cart

1.0.16

(2017-01-05)

Features

• Implemented ability to send follow up emails only to specified (administrator) email. Is useful for receive internal reminders (new review, order, customer etc)

Fixed

• Fixed an issue with abandoned cart event

1.0.15

(2016-12-23)

Improvements

• Triggers grid

1.0.14

(2016-12-16)

Bugfixes

• Fixed an issue with registering the event 'Order obtained new status' (affects all)
• Fixed an issue with Review Request template (error if product already removed)

Improvements

• Ability to use product attributes in rules

1.0.13

(2016-09-14)

Fixed

• Limit number of cart rules

1.0.12

(2016-09-08)

Fixed

• Compatibility issue
• Set attribute element as a text and add available options for region condition

1.0.11

(2016-08-11)

Improvements

• New rule condition 'Shopping cart products available for purchase'

1.0.10

(2016-07-28)

Fixed

• Fixed an issue with store base url

1.0.8

(2016-06-24)

Fixed

• Compatibility with Magento 2.1

1.0.7

(2016-05-27)

Improvements

• Added store filter to events grid

1.0.6

(2016-05-20)

Improvements

• Support of different mail transfer agents

Fixed

• Fixed issue with SalesRule naming (after update to 2.0.6)
• Fixed issue with multi-store emails
• Changed external links params (code to hash)
• Issues with rules
• Fixed an issue with empty Restre Cart url
• Fixed and issue with cross sells
• Fixed possible issue with non-secure url for ajax capture

1.0.4

(2016-04-11)

Fixed

• Fixed an issue with menu

1.0.3

(2016-03-28)

Improvements

• Added new tab to customer edit page with FUE emails
• Ability to setup coupon generation rules (length, prefix, suffix, dash every X chars)
• Check coupon type (fixed or auto generation)
• Improved clean history (logs) feature
• Improved current time (local/gmt) validation
• i18n

Fixed

• Fixed an issue with cross-sell products
• Fixed wrong link in menu
• Fixed an issue with wrong link to Settings

Documentation

• Updated installation steps

1.0.2

(2016-02-18)

Fixed

• Fixed an issue with cronjob (wrong path to class)
• Fixed an issue with parse error in crontab.xml

Improvements

• Added new column to trigger grid with general information
• Added ability to preview cross-sell products in template preview

Documentation

• Added base user manual

Submodule mirasvit/module-email-designer

1.0.15

(2017-10-30)

Fixed

• Сompatibility with PHP > 7.0.0

1.0.14

(2017-09-04)

Fixed

• Fix for compatibility with Magento 2.2.0rc

1.0.13

(2017-08-31)

Improvements

• Create repository for templates
• Method 'getItemOptions' for displaying options selected for ordered item

1.0.12

(2017-05-29)

Improvements

• Methods to retrieve wishlist products
• Fallback mechanism for method 'getCustomerName()' in order context

1.0.11

(2017-04-28)

Improvements

• Fallback mechanism for method 'getCustomerName()' in order context

1.0.10

(2017-03-16)

Bugfixes

• Fix some variables do not exist until they explicitly called (affects all)

1.0.9

(2017-01-27)

Bugfixes

• Display value for method 'getCustomerEmail' in preview emails (affects all)

1.0.8

(2017-01-26)

Bugfixes

• Display coupon code in preview mode (affects all)
• Fixed an issue with image path

1.0.6 1.0.7

(2016-09-08)

Fixed

• Fixed an issue with image URL

1.0.5

(2016-06-21)

Fixed

• Fixed an issue with hard coded store id

1.0.3 1.0.4

(2016-05-06)

Fixed

• Fixed an issue with multi-store

1.0.2

(2016-04-18)

Fixed

• Fixed an issue during compilation (setup:di:compile-multi-tenant)
• Fixed an issue with fatal error when orders/carts are not exists

Improvements

• Ability to use wishlists in template
• i18n
• Showing php error, if template syntax not correct

Submodule mirasvit/module-report

1.2.27

(2017-12-07)

Fixed

• filters by "Customers > Products" and "Abandoned Carts > Abandoned Products" columns

1.2.26

(2017-12-06)

Fixed

• filter by "Products" column

1.2.25

(2017-12-05)

Fixed

• Issue with active dimension column

1.2.24

(2017-11-30)

Fixed

• Issue with export in Magento 2.1.8

1.2.23

(2017-11-27)

Fixed

• Issue with "Total" value of non-numeric columns

1.2.22

(2017-11-15)

Fixed

• Issue with export to XML

1.2.21

(2017-11-03)

Fixed

• Properly replicate temporary tables
• An issue with builing relations
• Issue with finding way to join tables

1.2.20

(2017-10-30)

Fixed

• An issue with sales overview report when customer segments used

1.2.19

(2017-10-30)

Fixed

• Issue with export to CSV (Magento 2.1.9)

1.2.18

(2017-10-26)

Fixed

• Issue with long replication

1.2.17

(2017-10-20)

Fixed

• Fixed css bug
• Compare for leap year

1.2.16

(2017-09-28)

Fixed

• Compatibility with php 7.1.9

1.2.15

(2017-09-26)

Fixed

• M2.2

1.2.14

(2017-09-18)

Fixed

• Fix report email notification using 'Send Now' function

1.2.13

(2017-08-09)

Fixed

• Conflict with other reports extensions

1.2.12

(2017-08-02)

Improvements

• New Report Columns

1.2.11

(2017-07-19)

Fixed

• Display option labels instead of values for dashboard widgets

1.2.10

(2017-07-12)

Fixed

• Issue with Eav attributes

1.2.9

(2017-07-11)

Improvements

• New Charts

1.2.8

(2017-06-21)

Fixed

• Proper filter product details report by current product ID

1.2.7

(2017-06-21)

Improvements

• Refactoring

1.2.6

(2017-06-01)

1.2.5

(2017-05-31)

Improvements

• Added field to relation

1.2.4

(2017-05-15)

Fixed

• Issue with column ordering

1.2.3

(2017-05-04)

Bugfixes

• Fixed an issue with compound columns of type simple

Improvements

• Changed default multiselect control to ui-select
• Chart resizing

1.2.2

(2017-03-21)

Improvements

• Performance

Fixed

• Fixed an issue with join returing customers

1.2.1

(2017-03-06)

Improvements

• Disabled wrong filters for day/hour/month/quarter/week/year

Fixed

• Fixed an issue with table joining
• Fixed an issue with filters
• Issue with rounding numbers in chart

1.2.0

(2017-02-27)

Fixed

• Minor issues
• Fixed an issue with replication

1.1.14

(2017-01-31)

Fixed

• Dashboard

1.1.12

(2017-01-25)

Fixed

• Backward compatibility
• Fixed an issue with bookmarks

1.1.11

(2017-01-20)

Fixed

• fixed an issue with tz

1.1.9, 1.1.10

(2017-01-13)

Fixed

• Fixed an issue with timezones
• Fixed an issue with dates

1.1.7, 1.1.8

(2016-12-15)

Fixed

• Fixed an issue in toolbar
• Fixed an issue with date filter

1.1.6

(2016-12-09)

Improvements

• Compatibility with M2.2

1.1.5

(2016-09-27)

Fixed

• Fixed an issue with moment js

1.1.4

(2016-09-13)

Fixed

• Removed limit on export reports (was 1000 rows)

1.1.3

(2016-09-05)

Improvements

• Changed product type column type

1.1.2

(2016-09-01)

Improvements

• Added Product Type column

1.1.1

(2016-08-15)

Fixed

• Fixed an issue with exporting

1.1.0

(2016-07-01)

Fixed

• Rename report.xml to mreport.xsd (compatiblity with module-support)

1.0.4

(2016-06-24)

Fixed

• Compatibility with Magento 2.1

1.0.3

(2016-05-31)

Fixed

• Fixed an issue with currency symbol

1.0.2

(2016-05-27)

Fixed

• Add store filter

1.0.1

(2016-05-25)

Fixed

• Removed font-awesome

1.0.0

(2016-05-19)

Improvements

• Export
• Refactoring
• Table join logic

Fixed

• Fixed an issue with joining tables
• Chart - multi columns

Submodule mirasvit/module-email-report

1.0.4

(2017-10-30)

Fixed

• compatibility with PHP > 7.0.0

1.0.3

(2017-09-19)

Fixed

• require correct version of module-report

1.0.2

(2017-09-04)

Fixed

• fix for compatibility with Magento 2.2.0rc

1.0.1

(2017-09-01)

Fixed

• Disable unfinished report provided by module

1.0.0

(2017-08-30)

Features

• integrate with Follow Up Email

0.0.0-alpha1

(2016-04-18)

Features

• Ability to manage email campaigns

Submodule mirasvit/module-message-queue

1.0.2

(2017-11-21)

Fixed

• compatibility with Magento EE

1.0.1

(2017-10-31)

Fixed

• do not enqueue messages if 'queue' table is not created yet

1.0.0

(2017-10-31)

Feature

• RabbitMQ and MySQL drivers

Publish message

/** @var \Mirasvit\Mq\Api\PublisherInterface $publisher */
$publisher = $this->objectManager->create('Mirasvit\Mq\Api\PublisherInterface');

$publisher->publish('mirasvit.event', [microtime(true)]);

Listen

di.xml

<type name="Mirasvit\Mq\Api\Repository\ConsumerRepositoryInterface">
    <arguments>
        <argument name="consumers" xsi:type="array">
            <item name="notificator" xsi:type="array">
                <item name="queue" xsi:type="string">mirasvit.event</item>
                <item name="callback" xsi:type="string">Mirasvit\Testing\Model\Processor::process</item>
            </item>
        </argument>
    </arguments>
</type>

Submodule mirasvit/module-event

1.1.10

(2017-12-01)

Fixed

• Properly retrieve attribute values
• correctly detect 'Product / QTY Reduced' event

1.1.9

(2017-11-24)

Fixed

• Missing customer_name parameter in the 'customer birthday' event

1.1.8

(2017-11-23)

Fixed

• Properly validate total count/qty of products in cart/order
• Set Customer: Group condition as multiselect
• Register 'order status change' event only when status really changed

1.1.7

(2017-11-22)

Fixed

• use customer email as unique key for newsletter events

1.1.6

(2017-11-01)

Improvements

• Move error event to module-notificator

1.1.5

(2017-10-31)

Fixed

• register method may return boolean false

1.1.4

(2017-10-30)

Fixed

• Properly load customer model

1.1.3

(2017-10-30)

Fixed

• error with review related events

1.1.2

(2017-10-26)

Improvements

• Customer condition 'Last Activity'
• Handle API errors
• Order condition 'Order Updated At Time (24H format)'
• move email capture function from follow up email to module event
• Add all follow up email conditions
• Save customer_name, customer_email values with event registration

Fixed

• Error event

1.1.1

(2017-10-19)

Fixed

• Bump version number

1.1.0

(2017-10-19)

Features

• Shipping Address Conditions
• Event 'Customer Birthday'
• Event 'Review Approved'
• Event 'New item added to wishlist'
• Event 'Wishlist shared'

Fixed

• rename attribute code

1.1.0-beta6

(2017-10-12)

Features

• Event 'Product QTY Decreased'
• new event 'New System Notification'
• Ability to add groups of conditions to events
• Product subselection conditions
• Event 'Admin Logged In'
• Event 'Failed Login Admin'
• Ability to add custom attributes and conditions to EventData

Improvements

• Last heartbeat schedule condition
• Add Store Event Data with store related conditions

Fixed

• add custom attributes only if they added

1.1.0-beta5

(2017-09-27)

Improvements

• compatibility with Magento 2.2

1.1.0-beta4

(2017-09-27)

Improvements

• expand all params specified in the getEventData method

1.1.0-beta3

(2017-09-19)

Fixed

• do not register events before module installation

1.1.0-beta2

(2017-09-18)

Fixed

• Order status event

1.1.0-beta1

(2017-09-18)

Improvements

• convert all events to plugins

1.0.1

(2017-06-15)

Fixed

• DI
• Pool