- Get the module via composer
composer require sailthru/sailthru-magento2-extension
- Enable the module
bin/magento module:enable Sailthru_MageSail
- Upgrade the database
bin/magento setup:upgrade
(Depending on Magento mode, you may need to runmagento setup:di:compile
) - Go to Magento Admin > Stores > Configuration > Sailthru to configure. Visit the Sailthru Documentation Site for setup documentation.
Note: If sync'ing variant products with no visible individual URL, you should enable "Preserve Fragments" in Sailthru here.
The Sailthru MageSail module comes ready to use Sailthru's new PersonalizeJs javascript. To add page-tracking and gather onsite data like pageviews and clicks:
- Add your Customer ID (found here) to vendor/sailthru/sailthru-magento2-extension/view/frontend/web/spm.js
Please contact Sailthru to learn more about and enable Site Personalization Manager.
Declare new transactional email template in ./etc/template_config.xml
file that can be created within any module.
Each template definition in ./etc/template_config.xml
has four required parameters that are defined in ./etc/template_list.xsd
file.
Required parameters are:
- id - transactional email template identifier in Magento 2
- name - template title which will be displayed in
Admin Panel -> Stores -> Configuration -> Sailthru -> Transactionals -> General Transactionals
dropdown list - custom_template_source -
Core Config Path
to native Magento 2 transactional email template ID value. Is utilized when custom email template overrides default Magento 2 email template - sort_order - template sort order
After updating the ./etc/template_config.xml
file run php bin/magento cache:clean config
to clean Config cache.
To extend or change structure of a transactional email templates override config file use ./etc/template_list.xsd
file.
Sailthru Magento 2 extension utilizes standard Magento queueing functionality.
- Go to Admin > Stores > Configuration > Sailthru > Messaging > Advanced
- Set flag "Use Magento Email Queue" to Yes and save configuration
- Make sure Magento cron is setup and running
- To test Sailthru messages queue consumer execute:
$ php bin/magento queue:consumers:start sailthru.email.send.consumer.db
OR
$ php bin/magento queue:consumers:start sailthru.email.send.consumer.amqp
Instead of standard database based queue broker RabbitMQ can be used
Refer to Magento Guide: RabittMQ Setup