Tiresias – Recommendation Engine for WooCommerce

Installatie

Before proceeding please make sure that you are running WordPress 3.5 or above and WooCommerce 2.0.0 or above.

Please refer to the WordPress documentation on how to get the plugin to appear in your installation admin section.

Once the plugin appears in your installation, you must activate it. Navigate to the “Plugins” section and locate the
“WooCommerce Tiresias Tagging” plugin. The activation is done simply by clicking the “Activate” link next to the plugin
name in the list.

The activation procedure will create a new page called “Top Sellers”. This page can be found and edited under the
“Pages” section in the backend. The page contains a single div element that is used to show product recommendations. A
link to the page should appear in the shops main navigation menu.

The plugin uses the WordPress Action API to add content to the shop. However, there are a few actions that will have to
be added to the shops theme in order for the plugin to function to its full extent.

• wcnt_before_search_result
  • This action should be called above the search result list on the on search pages
  • You need to add <?php do_action('wcnt_before_search_result'); ?> in your themes search page template at the
    appropriate location
  • Please note that this only applies to the WordPress search and not the WooCommerce search
    • If you are using the WooCommerce search, you do not need to add any actions to the templates
• wcnt_after_search_result
  • This action should be called below the search result list on the on search pages
  • You need to add <?php do_action('wcnt_after_search_result'); ?> in your themes search page template at the
    appropriate location
  • Please note that this only applies to the WordPress search and not the WooCommerce search
    • If you are using the WooCommerce search, you do not need to add any actions to the templates
• wcnt_before_main_content
  • This action should be called at the beginning of every page in the shop
  • You need to add <?php do_action('wcnt_before_main_content'); ?> in your themes header template, inside the main
    content section
• wcnt_after_main_content
  • This action should be called at the end of every page in the shop
  • You need to add <?php do_action('wcnt_after_main_content'); ?> in your themes footer template, inside the main
    content section

Once you have activated the plugin and added the necessary actions, you need to configure the plugin. The plugins
configuration page can be found under the “Settings->Store” section, in the tab called “Tiresias Tagging”.

The configuration page consists of three settings:

• Server address
  • This is the server address for the Tiresias marketing automation service
  • It will have the default value of “connect.tiresias.com” and you do not need to change this
• Account name
  • This is your Tiresias marketing automation service account name that you got when registering for the service
• Use default Tiresias elements
  • This setting controls if the plugin should create and output the default Tiresias elements for showing the product
    recommendations
  • You can disable the defaults if you want to use your own elements in your theme

All of the above settings are needed for the plugin to work.

The “Tiresias Tagging” widget added by the plugin for showing Tiresias elements in the shops sidebars, needs to be configured
if you wish to use it. The widget can be found under the “Appearance->Widgets” section and it works like any other
WordPress widget. After dropping the widget in the appropriate sidebar container, you need to configure its Tiresias ID.
This ID is used as the Tiresias element div ID attribute and can be whatever you decide.