Wordpress Plugin

Sailthru has partnered with Automattic to provide our customers a quick and easy way to get started with Sailthru on the WordPress platform.

If you’re a WordPress VIP customer just enable the Sailthru plugin to get started. You’ll see a Sailthru link on the sidebar.

Note: The VIP Wordpress Plugin is compatible with the non-VIP Wordpress.   

Click the “Add your Sailthru API & Key” to display the form and add your API key, Secret and horizon domain. You can find these in your my.sailthru.com account on the Settings page.

 

Once you’ve saved the information you’ll be asked what template you wish to associate with the WordPress installation. You’ll need to create a template in your Sailthru account with {subject} as the subject line. In the body of the email place the zephyr variable {body}. This will be replaced with email content from wordpress.

NOTE: The VIP platform has disabled the overriding of all emails via Sailthru, so although this step is necessary for the setup the feature is disabled. This requirement may be removed in later upgrades.

You’re almost done

Simply by adding your Sailthru account settings you’re already ready to go with Horizon. The plugin will automatically add the necessary JavaScript to the footer of your theme. We’ll also automatically add the necessary Sailthru Meta Tags to your page for you. When you tag a piece of content in WordPress you won’t have to worry about adding those meta tags to the post, it’ll be there for you.
<meta name='sailthru.date' content='2011-09-20 01:25:16' />
<meta name='sailthru.title' content='This is a Sticky Post' />
<meta name='sailthru.tags' content='announcement, panache' />
<meta name='sailthru.description' content='This is an example of a sticky post. You can read more about them here.' />
Expiring content.
Sometimes you don’t want your content displaying in future recommendations. So for each post you’ll be able to set the content expiry date. This will tell Sailthru to remove this piece of content from Sailthru recommendations after the set date.
 

Enabling Concierge

Concierge is a Horizon-powered on-site recommendation tool, allowing a small "slider" to appear in a user's browser window at the end of an article. The slider will suggest another story based on a user's interest.

To enable Concierge on your site click on the Concierge tab and check the box and click save. Once enabled you’ll be presented with a simple form to configure Concierge behaviour.

For full documentation on Concierge options check out the Concierge documentation page. The plugin simple makes those options available via a form.

Enabling Scout

Scout is an on-site tool that displays relevant content to users when viewing a particular page. The tool is powered by Sailthru's Horizon intelligence, which gathers data on your users' individual interests, based on activity on your website, mobile device and tablet, all tied to each user's email address.

To enable Scout on your site click on the Scout tab and check the box to enable it. You’ll be presented with a screen allowing you to configure the options via a simple form.

The plugin creates a “Recommended for you page”. Please disable the page if you only wish to use the widget.

 

Widgets

The Sailthru plugin provides two widgets. The first "Sailthru Recommends" is a widget that displays recommended content via Scout. If you've enabled Scout then you'll be able to use this widget anywhere your theme allows you to place content. The content provided by Sailthru Recommends is powered by Horizon and so recommends content based on the horizon domain field that you provide in the plugin settings screen.
 

Subscribe Widget

 
We've also provided a simple "Subscribe" widget which you can use to easily provide signup for newsletters. You'll be able to add users to one or more lists when they sign up. Quick and easy.
 
By default the widget displays an email field but you can add additional fields to the widget if you'd like to gather more information from your subscribers.  To use this feature click on the Subscribe Widget Fields in the Sailthru admin screen. 
 
The screen displays any fields you have already configured and a form to easily add new ones. Any fields added to the admin will be available to all widgets. You can add a number of different HTML fields that can be used for different types of information, for example a "select" field can be used for data like gender. 
 
 
Text fields are used to collect information where the user will type in their answer, select fields are drop down fields that can be used for fields like State or Country. Hidden fields are not visible to the user but allow you to gather information that might be important to you such as the source of the campaign.
 

Shortcodes

The subscribe widget is available as a shortcode too using the following syntax.

[sailthru_widget fields="names,of,fields" sailthru_list="list_name"]
Parameter Description Values
fields Comma separated list of field names as displayed on the Subscribe Widget Fields admin screen.  field name(s)
modal Display widget as a modal window (optional)  true  or false
sailthru_list comma separated list of lists to add the user to list name(s) 
You'll find both these widgets in WordPress's widget section.