WordPress Plugin

The WordPress plugin can be downloaded
from the official plugin directory.

For WordPress users there is a free plugin which provides an easy to use interface for all of the Auction Affiliate options (similar to the code snippet builder) directly from the WordPress admin area. This enables users to quickly add eBay items to their WordPress pages or posts.

Installing and activating the plugin

Details of how to install WordPress plugins can be found on the official WordPress site.

Adding Auction Affiliate to pages / posts

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 marker [auction-affiliate] (known as a shortcode) in to your post content editor to specify where the listings will appear. Read the using shortcodes section below for more on shortcodes.

Specifying defaults

Default values 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. You are able to specify the following default values:

  • eBay Site
  • EPN Campaign ID
  • EPN Custom ID
  • Theme
  • Primary Colour
  • Secondary Colour
  • Background Colour

Using shortcodes

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 and 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"]

Refer to the parameters page for an explanation of each parameter and allowed values.

Adding Auction Affiliate within your theme

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"]'); ?>