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

From within Wordpress:

  1. Log in to your WordPress admin panel
  2. Go to Plugins > Add New
  3. Search for "Auction Affiliate"
  4. Click Install Now next to Auction Affiliate
  5. Confirm OK in the dialogue box
  6. Once the plugin has been downloaded and installed, click Activate Plugin
  7. The plugin is now installed and activated

To install the plugin manually:

  1. Download and unzip the plugin
  2. Upload the auction-affiliate directory to /wp-content/plugins/
  3. Activate the plugin through the Plugins menu in WordPress

Further 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 following marker (known as a shortcode) in to your post content editor to specify where the listings will appear:


You can have as many shortcodes as you like on your page. You do this by overriding parameters by passing them to the shortcode as shortcode parameters.

Shortcode Parameters

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

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.

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

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