FAQ

Logicanvas Auctions is a WooCommerce plugin for timed and live auctions. Store owners and approved third-party holders can list lots. Registered bidders place bids on the server. Winners pay through normal WooCommerce checkout, tax, shipping, and payment gateways.

Yes. WooCommerce must be installed and active. The plugin shows an admin notice and fails gracefully if WooCommerce is missing. It never stores card numbers and never bypasses your store’s payment gateways.

No. Elementor is optional. Shortcodes, templates, REST endpoints, and dashboards work without Elementor. If Elementor is active, dedicated widgets and dynamic tags become available.

WordPress 6.4 or newer, PHP 8.1 or newer, and WooCommerce 8.0 or newer. HPOS (High-Performance Order Storage) and block checkout compatibility are declared.

In wp-admin open Auctions → Setup and click Create auction pages. The wizard creates ordinary WordPress pages with shortcodes. You can edit them in the block editor or Elementor. Deleted pages are not recreated automatically unless you run setup again for missing keys.

wcap_auction_grid, wcap_single_auction, wcap_live_room, wcap_live_host, wcap_submit_auction, wcap_holder_dashboard, wcap_bidder_dashboard, wcap_my_bids, wcap_my_wins, wcap_pay_award, wcap_holder_apply, wcap_login, wcap_register, wcap_countdown, wcap_bid_panel, wcap_bid_history. See the shortcodes section in guided docs for attributes.

Not by default (1.2.0+). disable_wc_catalog is off unless you enable Disable WooCommerce shop and single product pages in Setup or Settings. When enabled, the shop catalog and single product pages are hidden while cart, checkout, and My Account stay available for winner payment. Auction-linked products may still stay catalog-hidden so they sell only through winner checkout.

From 1.1.0 the auction CPT rewrite slug defaults to auctions (for example /auctions/my-lot/). Category archives default to /auction-category/{slug}/. Customize both under Settings → Permalinks (Auction base and Auction category base). After changing bases or upgrading, Save Permalinks once to flush rewrite rules.

Visit any wp-admin page once so rewrite rules flush, or open Settings → Permalinks and click Save. Confirm auction URLs use /auctions/… (or your custom base). Review Auctions → Categories and Settings → Disable WooCommerce shop and single product pages if you still need a normal shop.

After frontend pages exist, open Auctions → Setup and use Create demo auction. The demo is clearly marked and can be deleted from the same screen. It lets you try bidding without building a full listing first. The catalog empty state also points admins to Setup or Add Auction.

From 1.2.0, activation opens Auctions → Setup and the dashboard shows a short checklist until pages and a first lot exist. replace_wp_login, disable_wc_catalog, login_redirect_dashboard, and restrict_wp_admin default to off. Optional store modes are explained on Setup and in Settings. The Plugins list includes a Setup action link.

Setup demo auction create/delete, Buy Now on timed auctions, Relist for finished lots (admin + seller dashboard), and a clearer empty catalog message. See the changelog for the full 1.2.0 appearance and soft-defaults release.

A timed auction runs for a fixed start and end window. Bidders place bids until the auction closes automatically (with optional soft-close extensions). A live auction uses a lobby and live room controlled by the holder: open lobby, start, pause/resume, going once/twice, extend, sell, mark unsold, or cancel. In both modes the server—not the browser—is authoritative for price, winner, and state.

Public (listed), unlisted (share link, not in public listings), and private/invite-only (invitation required). Invitation tokens are stored as hashes, can expire or be revoked, and never replace authentication for bidding.

Administrators manage Auction Categories under Auctions → Categories. Holders can assign a category on submit and edit listing forms (Category field is always visible). Holders with edit_own_auctions can assign terms. A default General category is seeded when the taxonomy is empty.

Version 1.1.0 adds a gallery lightbox, Details and Share tabs (no verification UI), QR codes for sharing, formatted HTML content, fulfilment notes, and an Edit listing button when the viewer can edit.

Authenticated users with bidding capability can bid on auctions they are allowed to access. Guests can usually view public auctions but must log in (or register) before bidding. Nobody may bid on their own auction, including administrators acting as holders.

No. Self-bidding is always rejected by the server, even if the user has both holder and bidder capabilities.

Every bid is validated on the server: auction state, time window, eligibility, currency, minimum increment, rate limits, and idempotency. The auction row is locked during acceptance. Duplicate clicks with the same idempotency key return the original result instead of creating another bid. The first valid committed bid wins a tie.

On timed auctions, if a valid bid arrives within the last soft-close window (default 120 seconds), the end time is extended (default +120 seconds), up to a maximum number of extensions (default 20). The new end time is stored and broadcast from the server.

If the auction ends below the reserve price, it can close as reserve not met / unsold according to the state machine. Public displays typically show only whether the reserve is met, not the hidden reserve amount (configurable reserve display policy).

Proxy / maximum bidding for timed auctions exists as a strategy but is off by default in settings. It is not enabled for live auctions by default. Maximum values stay private.

Timed auctions accept bids only while active. Live auctions accept bids while live, going once, or going twice. A bid during going once/twice can reset the live state back to live. Lobby and paused states do not accept bidding.

Optional on timed auctions (1.2.1+). When a Buy Now price is set and still above the current bid, an eligible bidder can purchase immediately. The lot ends, an award is created at the Buy Now amount, and the buyer is sent to payment — same WooCommerce checkout path as a normal win. Live auctions do not use Buy Now.

The default realtime mode is authenticated REST polling by event sequence (about 1 second while live, slower in lobby/paused). Push providers can notify clients that new state exists, but clients must still load authoritative state from WordPress. A push message cannot accept a bid or declare a winner.

Site administrators can create and manage auctions. Third-party users must apply to become an auction holder, be approved by an administrator, and then create or submit auctions from the holder dashboard. Suspended holders cannot publish or host.

Open the Become an auction holder page (created by Setup, shortcode [wcap_holder_apply]), submit the application, and wait for administrator approval. Statuses are pending, approved, rejected, or suspended.

Yes (1.1.0+). Owners can edit draft, rejected, pending review, and scheduled auctions from the seller dashboard Edit view or the Edit listing control on the single auction page. Updates use REST PUT/PATCH. Live or ended auctions are not editable this way. Listing Edit links open the seller dashboard and do not require wp-admin edit_post access.

Yes (1.2.1+). From the admin Auctions list or the seller dashboard, Relist duplicates a finished lot as a new draft with fresh dates and no bids. Edit the draft (prices, schedule, gallery) then submit or publish as usual.

When an auction closes with a winner, an award record is created with the final amount and a payment deadline (default 48 hours). Only that winner can start checkout. Quantity is locked to one and the line price is the awarded amount. Taxes and shipping use WooCommerce. Coupons and mixed carts can be disallowed in settings.

After the payment deadline, the award can be marked defaulted. The plugin does not automatically charge bidders. It does not automatically offer the lot to a runner-up unless that policy is explicitly enabled.

No. Payments are processed only through configured WooCommerce gateways. The plugin never collects or stores raw card details.

The website is the checkout merchant. Each auction records its holder. Settlements track gross amount, commission, fees, refunds, net amount, and payout status. V1 supports manual payout tracking (pending, approved, paid, reversed, disputed). There is no automatic marketplace payout (for example Stripe Connect) in this edition; a payout provider interface exists for later integrations. Holders can request payouts and upload proof where the UI allows; administrators manage settlement status.

Each auction is locked to the store currency at creation. If the store currency changes later, mixed-currency settlement should be blocked until handled explicitly. Multi-currency auction settlement needs a dedicated integration.

Yes. Setup creates a Log in page with [wcap_login] for login, register, lost password, and reset flows. Redirecting wp-login.php to that page is optional (replace_wp_login, off by default). Settings can also redirect users to holder/bidder dashboards after login and optionally restrict wp-admin for those roles (both off by default).

No, not by default (1.2.0+). Setup still creates a Log in page with [wcap_login], but wp-login.php keeps working unless you enable Replace WordPress login (replace_wp_login) in Setup or Settings. Escape hatch when that mode is on: wp-login.php?wcap_core=1. Cart, checkout, and My Account are never replaced. Sites that already used the plugin login page before 1.2.0 keep replace_wp_login on via a one-time migration.

Notifications cover approval/rejection, scheduling, live start, bid accepted, outbid, reserve met (without revealing hidden reserve), extensions, winner, unsuccessful bidders, payment reminders, deadline expiry, payment received, holder sale, settlement updates, and cancellations. Users may manage preferences where offered. Noisy live-session emails can be throttled.

The plugin integrates with WordPress personal data export and erase tools. Financial/transaction rows may be anonymized rather than deleted when retention requires them. Public bidder identities are masked/aliased. IP addresses can be hashed. Terms acceptance can record timestamp and terms version.

Deactivation never deletes business data. Uninstall deletes tables and auction posts only if Remove all plugin data on uninstall is enabled in settings (default is off).

Under the Auctions menu (wcap-dashboard): Dashboard, Add Auction, All Auctions, Holders, Bids, Awards, Settlements, Settings, Diagnostics, and Setup Wizard. Exact items depend on capabilities.

Auctions use the Classic Editor (TinyMCE) in wp-admin, with product, gallery, and full settings meta boxes. Frontend create keeps textareas; the dedicated seller edit page also uses Classic Editor-style content handling.

Yes. Copy templates into your-theme/logicanvas-auctions/ using the same relative paths as the plugin templates/ folder.

Open Auctions → Settings → Appearance (1.2.0+). Choose Classic, Midnight, Auction house, Ocean, Minimal, or Ember. Optionally override accent color, corner radius, spacing density, card style, or add custom CSS scoped to .wcap-root. Theme tokens style heroes, sidebars, live rooms, and dashboards.

Closing uses WooCommerce Action Scheduler (WP-Cron fallback). If cron is delayed, opening an auction page or state endpoint after end time still runs an idempotent close. Check WooCommerce → Status → Scheduled Actions and hosting cron reliability.

Do not activate this edition on a site that already runs the branded auction-platform plugin. They share the wcap_ table prefix and must not be installed together.

Yes. Namespace logicanvas-auctions/v1. Cookie authentication plus a REST nonce is required for write routes. Public GET responses hide private fields such as emails, IPs, and proxy maxima.

Yes: wp logicanvas-auctions list, close, overdue, rebuild, schema, diagnostics, reschedule, migrate.