Install & activate

You'll receive a code2prize.zip file after purchase on CodeCanyon.

1. 1
   Log in to wp-admin. Go to Plugins → Add New → Upload Plugin.
2. 2
   Choose code2prize.zip and click Install Now.
3. 3
   Click Activate. Two database tables — wp_prize_codes and wp_prize_winners — are created automatically.
4. 4
   A new Prize menu appears in the WordPress admin sidebar.

First-time settings

Open Prize → Settings and fill in the fields below. All settings are stored as standard WordPress options.

A guided tour of wp-admin

Every screen lives under the Prize menu — no external SaaS, no separate dashboard.

Importing codes in bulk

Use the provided codes_template.csv — one column, one code per line. Duplicates in the file and existing rows in the database are skipped automatically.

# codes_template.csv
code
ABC123XYZ
CPX7F9L2K3
CP9M2N8Q5Z
CP4J6K1T7H
# Rows are trimmed and upper-cased on import.

Defining prizes

A prize is a WordPress custom entry with a name, value, an active window (start / end date) and a failed-attempts threshold — the deterministic counter that decides when the next successful code wins that prize. Bulk import via prizes_template.csv.

# prizes_template.csv
name,value,start_date,end_date,threshold,image_url
iPhone 15 (128GB),1200,2026-06-01,2026-08-31,500,https://example.com/iphone.jpg
$100 Gift Card,100,2026-06-01,2026-08-31,50,https://example.com/gift.jpg
Free Product,10,2026-06-01,2026-12-31,25,

Rendering the entry form

Paste the primary shortcode on any page or post. That's the whole integration — no Contact Form 7, no WPForms, no Elementor required (though it plays nicely with all of them).

[code_validator_form]

What your customers see

1. Enter code → AJAX call to admin-ajax.php?action=validate_prize_code.
2. Result → invalid, already-used, no-win, or winner.
3. Claim → the winner form appears with the prize's featured image. Details are stored in wp_prize_winners.
4. Notify → the site admin gets an email; the code is locked instantly.

Managing winners

The Winners screen lists every claim: date, code, prize, personal details, IP and user agent. Includes search and pagination; export to CSV for fulfillment.

Multilingual with WPML

Code2Prize registers per-language message strings and page IDs so the same shortcode adapts to the active language automatically.

// wp_options keys registered by the plugin
code_validator_page_id_en
code_validator_page_id_el
code_validator_msg_en_invalid
code_validator_msg_el_invalid
code_validator_msg_en_used
code_validator_msg_el_used
// ...plus success, error, winner, no-win variants.

Add a new language by duplicating the pattern code_validator_msg_<lang>_<key>. The plugin picks up the active WPML locale on the fly.

Developer reference

The plugin follows standard WordPress conventions: text domain code2prize, translations in /languages, all AJAX calls routed through admin-ajax.php.

AJAX endpoints

Sample cURL — validate a code

curl -X POST https://example.com/wp-admin/admin-ajax.php \
  -d "action=validate_prize_code" \
  -d "code=CPX7F9L2K3" \
  -d "nonce=<wp_nonce>"

Sample response

{
  "success": true,
  "data": {
    "status": "winner",
    "prize_id": 42,
    "prize_name": "iPhone 15 (128GB)",
    "image": "https://…/iphone.jpg"
  }
}

Database schema

Both tables are created via dbDelta() on activation and re-checked on load.

wp_prize_codes

id            BIGINT UNSIGNED  PK, AUTO_INCREMENT
code          VARCHAR(255)     UNIQUE
status        VARCHAR(50)      -- pending | used | won
use_date      DATETIME
prize_id      BIGINT UNSIGNED
created_at    DATETIME         DEFAULT CURRENT_TIMESTAMP

wp_prize_winners

id            BIGINT UNSIGNED  PK, AUTO_INCREMENT
code          VARCHAR(255)
prize_id      BIGINT UNSIGNED
prize_name    VARCHAR(255)
full_name     VARCHAR(255)
email         VARCHAR(255)
phone         VARCHAR(50)
address       TEXT
ip_address    VARCHAR(45)
user_agent    TEXT
win_date      DATETIME         DEFAULT CURRENT_TIMESTAMP
sequence      INT

Filters & actions

Extend or override behavior from your own theme / plugin.

// Send winner notifications to Slack as well as email
add_action('code2prize_after_winner_saved', function($winner) {
  wp_remote_post('https://hooks.slack.com/…', [
    'body' => wp_json_encode([
      'text' => "🎉 New winner: {$winner['full_name']} — {$winner['prize_name']}",
    ]),
  ]);
});

// Customize the winner email body
add_filter('code2prize_winner_email_body', function($body, $winner) {
  return "Hi {$winner['full_name']},\n\n" . $body;
}, 10, 2);

FAQ & troubleshooting

All screenshots

Every screen shipped with Code2Prize v1.0.