6. Usage of Affiliate-Toolkit with WooCommerce

Our plugin comes with WooCommerce interface. Thereby you can use all APIs from Affiliate-Toolkit with WooCommerce as well. Everything you need for this process is an installed WooCommerce plugin.

WooCommerce-API

The following tasks need to be completed before installing our plugin.

Check permalink structure

The permalink structure of your WordPress needs to be set to everything but “simple” to ensure that the WooCommerce API will be available.

Go to “settings” -> “permalinks” and check the following setting:

Generate API keys

Within the menu open “WooCommerce” -> “Settings” -> “API” -> “Keys/Apps” and create a new key.

 

1. Enter description

Enter a random description here, but later on you should still know what the key stands for.

2. Pick a user

Choose a user here for creating and updating your products. The user should have sufficierent access rights (e.g. editor).

3. Read/Write-permission

In order to be able to create and update API-products, read and write permissions are also required here.

4. Create key

After clicking on the button, a new window will pop open presenting your generated keys.

API key and API secret

The best option is to save these keys. You can’t open the generated key again later.

Setting up WooCommerce

In order to be able to use our plugin with the popular shop system, you need to go to the menu and click on “Affiliate-Toolkit” -> “Tools” -> “WooCommerce.” Then the following form will appear.

1. WooCommerce mode

Herewith you configurate if you want to create products from the Affiliate-Toolkit in WooCommerce or vice versa.

We recommend “Affiliate-Toolkit -> WooCommerce”. The other direction is designed in case you e.g. already have hundreds of products in WooCommerce and want to add them via EAN. Then the products will be automatically created within the Affiliate-Toolkit (as manual product) and the price comparison will be started. The ideal solution in case you e.g. want to switch from Affiliate-Booster to Affiliate-Toolkit and don’t want to import all products again.

2. Consumer Key

The API-key which we already created above in WooCommerce.

3. Consumer Secret

The API-secret, which we already created above.

4. Price comparison tab

This option allows you to display the price comparison tab within the WooCommerce product. Can look differently depending on WordPress theme.

5. Price comparison template

With this tool, you can override the template which is used for the price comparison tab. Instead of the standard template, this template will be displayed.

6. Regular price

Here you can decide whether you want to use the list price of the ATP product (standard) as list price or if you want to use the cheapest resp. most expensive offer from the price comparison.

7. Sale price

Here you can decide whether you want to use the retail price of the ATP product (standard) as retail price or if you want to use the cheapest resp. most expensive offer from the price comparison.

8. Key type

Here you can decide whether you would like to use the EAN or the internal product ID of Affiliate-Toolkit for the link between WooCommerce and the Affiliate-Toolkit.

We recommend using an Affiliate-Toolkit-ID, as this is a distinct ID. An EAN may not always exist. The EAN should only be used when you already use WooCommerce products with EAN and want to change that now.

9. Replace IDs

This way you can exchange EANs for IDs or the other way around within a WooCommerce product. This means you can change the key type from EAN to ID and switch directions as well. Only use this option when you are well aware of the function!

10. User defined EAN field

By default WooCommerce uses the field “_sku”. In case you would like to use your own field for that or in case you already have a field, you can enter the field name here.

11. Shop Button destination

Button destination of WooCommerce product. Here you can switch between standard, cheapest, and most expensive offer.

12. Product picture

Whether you want to import product pictures (and have them updated regularly) or rather want to link to the external product picture directly can be set here.

Attention: not every theme supports the external product picture.

13. Picture gallery

Here you can also choose if you want to import a product picture or if you want to use an external picture.

14. Export description

If you click on this option, the description will be overridden during each update of WooCommerce.

15. Export abbreviated description

If you click on this option, the abbreviated description will be overridden during each update of WooCommerce.

16. Display disclaimer of liability

Presents the disclaimer of liability on every WooCommerce product page along with update date and time.

17. Last import

This field will be filled when you choose the WooCommerce -> Affiliate-Toolkit direction. Because then the corresponding WooCommerce products will be created as independent AT-products using the EAN then.

WooCommerce product import

Once your WooCommerce interface has been set up, you can import products via the product import form. Additional information can be found here.

In case you would you like to import products using CSV-lists, additional information can be found here.

WooCommerce hints and tricks

Using widget with WooCommerce

The widget of the Affiliate-Toolkit allows you to make products in your sidebar depend on your current product.

This way you can e.g. depending on your product on the main display additional information of the product. You can also define your own templates here as well.

All you need to do is move the widget to the sidebar and click on “Use main product”. If no product has been selected, the widget will be automatically hidden. In case you choose an additional product, this will be displayed as fallback on all other pages.

Using Shortcodes with WooCommerce

You can use the Affiliate-Toolkit-Shortcode with WooCommerce products without entering your own product ID. So, just use:

[atkp_ product template=’wide’][/atkp_product]

and it will be automatically display the template “full width” with the proper product.

This shortcode can also be presented with one of your own templates (of the theme). Always the product ID of the current product page will be used. This way you can e.g. define own AT-templates and use them for your own WooCommerce products.

 

Switching from WooCommerce to AT-products quickly

Within the overview for WooCommerce products you can find a link to the product, this allows you to switch from WooCommerce product to Affiliate-Toolkit product quickly.

Do you still have questions? No problem :-)
We are happy to answer your questions in our forum.