Refer to the Auction Affiliate WordPress plugin page for much more documentation and help.
Once Auction Affiliate has been enabled, a new box will appear in the admin area when adding or editing a page / post. This box gives you sets of options which are used to specify what items are pulled in from eBay, how it is tied to your eBay Partner Network (ePN) account and how they are displayed on your page.
Once you have specified these options, you can place the following marker (known as a shortcode) in to your post content editor to specify where the listings will appear:
[auction-affiliate]
You can have as many shortcodes as you like on your pages (see below for more information)
As well as specifying where listings should appear on your page, shortcodes can be manually passed options to specify what items appear on the page. This can be useful when you wish to add multiple listings to the same page, or add them to your theme instead of within the post content editor.
Any options passed through a shortcode override any options specified on that page / post, as well as any default options set through the Auction Affiliate settings page.
Passing options to shortcodes can be achieved like so:
[auction-affiliate eKeyword="iPad mini case" eSite="0" eCount="4"]
As an example, say you want to display two sets of items – one showing six iPhones and one showing three iPads. If you want all other settings to be the same (i.e. the eBay site, your ePN custom ID, the theme etc) then you can set up the common options in the Auction Affiliate options box and then specifying two different shortcodes like so:
[auction-affiliate eKeyword="iPhone" eCount="6"] [auction-affiliate eKeyword="iPad" eCount="3"]
Refer to the parameters page for an explanation of each parameter and allowed values.
To add Auction Affiliate items within your theme files, you must use the shortcode format described above and pass it to the WordPress do_shortcode() function like so:
<?php echo do_shortcode('[auction-affiliate eKeyword="iPad mini case" eSite="0" eCount="4"]'); ?>
Default settings for some Auction Affiliate options can be specified on the Admin > Settings > Auction Affiliate page.
If specified, these defaults save you from repeatedly entering the same option each time you add Auction Affiliate to your pages or posts. Defaults can easily be overridden on a page-by-page basis.