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.
