WP Manifestindependent plugin directory
manifest / ecommerce / wp-community-auctions

WP Community Auction Manager

A complete auction management system for WordPress with bidding, user dashboards, and email notifications.

by billaking · github.com/billaking/wp-community-auctions · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/billaking/wp-community-auctions/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/billaking/wp-community-auctions ↗

A complete auction management system for WordPress with bidding, user dashboards, and email notifications.

Features

Core Functionality

  • Custom Auction Post Type - Dedicated post type for managing auctions
  • Real-Time Bidding - AJAX-powered bidding system with instant updates
  • Buy Now Option - Allow instant purchases at a set price
  • Reserve Pricing - Set minimum acceptable prices for auctions
  • Automatic Auction Ending - Cron job to automatically close expired auctions
  • Bid Increment Control - Define minimum bid increments

User Features

  • User Dashboards - Comprehensive dashboards for buyers and sellers
  • My Auctions - Sellers can view and manage their auctions
  • My Bids - Track all bids and see winning status
  • Frontend Auction Creation - Users can create auctions from the frontend
  • Bid Tracking - See all bids on each auction

Notification System

  • Bid Confirmation Emails - Buyers receive confirmation when they place a bid
  • Outbid Alerts - Automatic notifications when someone outbids you
  • Auction Won Emails - Winners are notified when auction ends
  • Seller Notifications - Sellers receive updates on new bids and sales

Admin Features

  • Settings Panel - Configure currency, features, and behavior
  • Bid Management - View and manage all bids across all auctions
  • Auction Categories & Tags - Organize auctions with taxonomies
  • Detailed Reporting - View auction statistics and bid history

Installation

  1. Upload the wp-community-auction-manager folder to /wp-content/plugins/
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. Go to 'Auctions' > 'Settings' to configure the plugin
  4. Create your first auction!

Usage

Creating an Auction (Admin)

  1. Go to Auctions > Add New
  2. Enter auction title and description
  3. Set the auction details:
    • Starting price
    • Reserve price (optional)
    • Buy now price (optional)
    • Bid increment
    • Start and end dates
  4. Add a featured image
  5. Assign categories/tags
  6. Publish the auction

Creating an Auction (Frontend)

Users can create auctions from the frontend using the [wcam_create_auction] shortcode.

Shortcodes

Display Auction Listings:

[wcam_auctions number="12" status="active" orderby="date" order="DESC"]

User Dashboard:

[wcam_dashboard]

My Auctions:

[wcam_my_auctions]

My Bids:

[wcam_my_bids]

Create Auction Form:

[wcam_create_auction]

Single Auction:

[wcam_auction id="123"]

Settings

Navigate to Auctions > Settings to configure:

  • Currency Symbol - Set your currency symbol (default: $)
  • Currency Position - Before or after the amount
  • Enable Buy Now - Allow instant purchases
  • Enable Reserve Price - Allow minimum selling prices
  • Auto-End Auctions - Automatically close expired auctions
  • Email Notifications - Enable/disable email notifications
  • Frontend Submission - Allow users to create auctions from frontend

Database

The plugin creates the following custom table:

  • wp_wcam_bids - Stores all bid information

Templates

You can override plugin templates by copying them to your theme:

  1. Create a folder wcam in your theme directory
  2. Copy template files from wp-community-auction-manager/templates/
  3. Customize as needed

Available templates:

  • single-auction.php - Single auction page
  • archive-auction.php - Auction listing archive
  • auction-listing.php - Shortcode auction grid
  • dashboard/main.php - Main dashboard
  • dashboard/my-auctions.php - User's auctions
  • dashboard/my-bids.php - User's bids
  • dashboard/create-auction.php - Create auction form

Hooks & Filters

Actions

// Triggered when a bid is placed
do_action('wcam_bid_placed', $bid_id, $auction_id, $user_id, $bid_amount);

// Triggered when buy now is completed
do_action('wcam_buy_now_completed', $auction_id, $user_id, $amount);

// Triggered when an auction ends
do_action('wcam_auction_ended', $auction_id);

Filters

// Modify formatted price display
apply_filters('wcam_format_price', $formatted_price, $amount);

// Modify minimum bid calculation
apply_filters('wcam_minimum_bid', $minimum_bid, $auction_id);

Requirements

  • WordPress 5.0 or higher
  • PHP 7.2 or higher
  • MySQL 5.6 or higher

Support

For support, please visit [your support URL]

Changelog

1.0.0

  • Initial release
  • Custom auction post type
  • Real-time bidding system
  • User dashboards
  • Email notifications
  • Admin settings panel
  • Frontend auction creation
  • Buy now functionality
  • Reserve pricing
  • Automatic auction ending

License

This plugin is licensed under the GPL v2 or later.

Credits

Developed by [Your Name]