Options Reference

The plugin registers 132 options in WP wp_options. Reference table for the most-used ones.

For the full machine-generated list with type, default, sanitize callback, and consumer file:line, see the plugin's docs/options.md (auto-generated).

Naming convention

All options prefixed wkafw_*. Sub-prefixes:

Prefix	Subsystem
`wkafw_2fa_*`	Two-factor auth
`wkafw_anti_snipe_*`	Anti-snipe
`wkafw_audit_log_*`	Audit log retention
`wkafw_auto_charge_*`	Wallet auto-charge
`wkafw_bid_*`	Bidding rules
`wkafw_buyers_premium_*`	Buyer's premium fee
`wkafw_captcha_*`	CAPTCHA
`wkafw_compliance_*`	Compliance / KYC
`wkafw_countdown_*`	Countdown thresholds
`wkafw_design_*`	Design Studio
`wkafw_escrow_*`	Escrow.com
`wkafw_event_*`	Events
`wkafw_firebase_*`	Firebase push
`wkafw_fraud_*`	Fraud detection
`wkafw_klaviyo_`, `wkafw_mailchimp_`	Marketing
`wkafw_relist_*`	Auto-relist
`wkafw_stripe_*`	Stripe
`wkafw_twilio_*`	Twilio
`wkafw_type_*_enabled`	Auction type toggles
`wkafw_wallet_*`	Wallet

Most-used options

Bidding & lifecycle

Option	Default	Effect
`wkafw_default_poll_interval`	30	Front-end poll cadence (seconds)
`wkafw_bid_increment`	1	Default bid increment
`wkafw_bid_cooldown`	5	Min seconds between bids
`wkafw_bid_rate_limit`	10	Max bids/min/user
`wkafw_bid_confirmation`	no	Confirmation modal before bid
`wkafw_allow_retraction`	no	Allow bid retraction
`wkafw_retraction_window`	300	Retraction time window (seconds)
`wkafw_snipe_window`	300	Anti-snipe trigger window
`wkafw_snipe_extension`	300	Anti-snipe extension
`wkafw_payment_deadline`	48	Hours after win for payment
`wkafw_auto_relist`	no	Auto-relist failed auctions
`wkafw_max_relist_attempts`	3	Cap on relists

Auction types

Option	Default	Effect
`wkafw_type_standard_enabled`	yes	Enable standard auctions
`wkafw_type_reverse_enabled`	yes	Enable reverse auctions
`wkafw_type_sealed_enabled`	yes	Enable sealed auctions
`wkafw_type_proxy_enabled`	yes	Enable proxy auctions
`wkafw_type_silent_enabled`	no	Enable silent auctions
`wkafw_type_charity_enabled`	no	Enable charity auctions
`wkafw_type_penny_enabled`	no	Enable penny auctions
`wkafw_type_dutch_enabled`	no	Enable Dutch auctions
`wkafw_type_seated_enabled`	no	Enable seated auctions
`wkafw_type_unique_enabled`	no	Enable unique-bid auctions

Display / Design

Option	Default	Effect
`wkafw_countdown_yellow_s`	3600	Yellow stop (seconds remaining)
`wkafw_countdown_orange_s`	600	Orange stop
`wkafw_countdown_red_s`	120	Red stop (pulsing)
`wkafw_urgency_window`	10	"Ending soon" threshold (minutes)
`wkafw_show_watchers`	yes	Show watcher count on auction page
`wkafw_masked_names`	no	Mask all bidder names site-wide
`wkafw_mask_pattern`	`B***r`	Mask format
`wkafw_confetti_enabled`	yes	Confetti on win
`wkafw_sounds_default`	no	Sound on bid
`wkafw_outbid_alert_enabled`	yes	Toast on outbid

Compliance

Option	Default	Effect
`wkafw_kyc_required`	no	Require KYC verification
`wkafw_kyc_threshold`	0	KYC required above this bid amount
`wkafw_age_verification_enabled`	no	Age gate
`wkafw_min_age`	18	Min age for age-gated lots
`wkafw_age_gated_categories`	(empty)	Comma-list of category slugs
`wkafw_require_terms`	no	Force terms acceptance
`wkafw_bid_terms_page`	0	Terms page ID
`wkafw_cookie_consent_required`	no	GDPR cookie consent
`wkafw_cookie_consent_provider`	none	Provider (`cookiebot`, `iubenda`, `built-in`)
`wkafw_tax_receipt_enabled`	yes	Issue charity tax receipts
`wkafw_donor_wall_enabled`	yes	Public donor wall

Wallet

Option	Default	Effect
`wkafw_wallet_topup_product_id`	0	Top-up product (0 = auto-create)
`wkafw_wallet_ledger_per_page`	25	Customer pagination
`wkafw_wallet_pay_fees`	no	Allow auction fees from wallet
`wkafw_auto_charge_winner`	no	Auto-debit on win

Fraud / Auth

Option	Default	Effect
`wkafw_2fa_required_for_admin`	no	Force admin 2FA
`wkafw_2fa_required_for_bid`	no	Force bid 2FA
`wkafw_require_email_verify`	no	Require verified email
`wkafw_require_ssl`	no	Reject bids over HTTP
`wkafw_captcha_provider`	none	turnstile / recaptcha / hcaptcha
`wkafw_captcha_threshold`	0	When to challenge (rule trigger count)

Monetization

Option	Default	Effect
`wkafw_listing_fee`	0	Per-auction listing fee
`wkafw_featured_boost_price`	10	Featured boost fee
`wkafw_bid_fee`	0.50	Per-bid fee
`wkafw_late_penalty`	0	Penalty for overdue payment
`wkafw_buyers_premium_type`	none	none / percent / flat
`wkafw_buyers_premium_value`	0	Amount or %
`wkafw_seller_commission`	0	Multi-vendor commission %
`wkafw_invoice_prefix`	`WKAFW-`	Invoice number prefix

Integrations

Option	Effect
`wkafw_stripe_secret_key`	Stripe API
`wkafw_stripe_webhook_secret`	Stripe webhooks
`wkafw_twilio_sid` / `_token` / `_from`	Twilio
`wkafw_firebase_*` (8 keys)	Firebase
`wkafw_klaviyo_api_key`	Klaviyo
`wkafw_mailchimp_api_key` / `_list_id`	Mailchimp
`wkafw_escrow_api_key` / `_endpoint` / `_threshold`	Escrow.com

Gamification

Option	Default	Effect
`wkafw_points_per_bid`	1	Points per bid
`wkafw_points_per_win`	10	Points per win
`wkafw_points_per_review`	5	Points per review
`wkafw_leaderboard_reset`	never	never / daily / weekly / monthly
`wkafw_achievements_enabled`	yes	Master toggle

Programmatic access

// Read
$interval = (int) get_option( 'wkafw_default_poll_interval', 30 );

// Write
update_option( 'wkafw_default_poll_interval', 15 );

// All wkafw_ options at once
global $wpdb;
$rows = $wpdb->get_results(
    "SELECT option_name, option_value FROM {$wpdb->options}
     WHERE option_name LIKE 'wkafw_%'
     ORDER BY option_name"
);

Sanitization

Each option has a sanitize callback. Common ones:

Callback	Validates
`san_yesno`	`yes` or `no` only
`san_captcha_provider`	`none` / `turnstile` / `recaptcha` / `hcaptcha`
`san_premium_type`	`none` / `percent` / `flat`
`san_leaderboard_reset`	`never` / `daily` / `weekly` / `monthly`
`san_cookie_provider`	provider whitelist
`san_commission_percent`	`0` ≤ value ≤ 100
(auto)	WP standard `sanitize_text_field` / `absint` based on type

Invalid values are coerced to defaults rather than rejecting the save.

Reset to defaults

Tools → Database → Reset settings to defaults wipes every wkafw_* option:

wp wkafw settings reset --all

Use only for clean test installs.

Migration / backup

Plugin options are part of the standard wp_options table. Backup tools (mysqldump, plugin backup tools) include them automatically.

For migrating settings between sites:

# Export
wp option list --search="wkafw_*" --format=json > wkafw_options.json

# Import
cat wkafw_options.json | jq -c '.[]' | while read row; do
    name=$(echo $row | jq -r '.option_name')
    value=$(echo $row | jq -r '.option_value')
    wp option set "$name" "$value"
done