Managing auction listings
page last edited on 14 November 2016
This page provides information on the following actions with auction listings:
- Creating auction listings;
- Viewing existing auction listings;
- Editing auction listings;
- Deleting auction listings.
Creating auction listings
To enable auction style bidding for a product in your store, you need to create an auction listing for it.
To create an auction listing:
- In your store’s Admin area, go to the Installed Modules section (Extensions > Installed modules), locate the entry for ”Auction in X-Cart 5” and click the Settings link below it: This opens the ‘“Auction in X-Crat 5” module settings’ page.
- Select the Products tab:
- Click Add product: A popup window titled “Create auction listing” will be displayed:
- In the Create auction listing window, provide the auction listing details:
- Product: Select the product you wish to sell at auction: Simply start typing the product name or SKU and enter at least three characters. As you type, products with matching names / SKU will be displayed as a drop-down list below the Product field. Locate the product for which you want to add an auction and click on its name. The product name will be entered in the Product field.
- Auction type: Choose an auction type for this listing. Currently an only type - Classic auction - is supported.
- Quantity: Specify the number of product units that you want to sell at auction as a single lot.
- Starting price (for specified quantity): Specfy the starting price of this lot. This will be the initial point from which bidding will start for this lot. The value specified here will be displayed as the “Current price” of this lot before any bids are offered. The suggested first bid amount in the “Your bid” field will be calculated as “Starting price + Minimum bid increment”.
- Minimum bid increment: Set the minimum bid increment amount (the minimum amount by which an auction participant’s bid will be raised).
- Duration: Set the listing duration.
- Click the Create auction listing button in the lower part of the popup window to save the changes.
The listing will be created and added to the list of auction listings:
Viewing existing auction listings
You can view your store’s currently existing auction listings. Currently existing auction listings are listings that are either Active (available for bidding) or Awaiting payment (won by someone and awaiting to be paid for). Information about past listings (listings that got no bids before they expired and listings that were won and successfully paid for) is not stored.
To view your store’s currently existing auction listings:
- In your store’s Admin area, go to the Installed Modules section (Extensions > Installed modules), locate the entry for ”Auction in X-Cart 5” and click the Settings link below it. This opens the ‘“Auction in X-Crat 5” module settings’ page.
- Select the Products tab: This opens the section where you can see the list of your store’s auction listngs in the form of a table:
For each listing in the table the following information is provided:
- SKU: SKU of the product on auction.
- Name: Name of the product on auction.
- Status: Current status of the auction listing (Active or Awaiting payment).
- Number of bids: Number of bids that have been placed in the auction.
- Qty: Quantity of product units in the auction lot.
- Starting price: Starting price of the auction lot.
- Current price: Current highest bid on the lot.
- End date: Date and time of the auction end.
To find one or more specific auction listings, use the filter at the top of the page:
Editing auction listings
It is possible to edit currently exising auction listings, no matter if they are Active or Awaiting payment.
To edit an auction listing:
- In the list of currently existing auction listings, locate the listing you want to edit and click on the Edit button at the far right of the respective table row: A popup window titled “Edit auction listing” will be displayed:
- In the Edit auction listing popup window, edit the parameters of the listing you want to change.
- Click the Save changes button to save the changes.
Deleting auction listings
You can delete auction listings before they expire. To delete an auction listing:
- In the Viewing existing auction listings, locate the listing you wish to delete and select it for removal by clicking on the Trash icon at the far right of the respective table row:
- Click Save changes: The listing will be removed.
In this section:
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.