=== VDL Competition Entries for WooCommerce ===
Contributors: gtech25, boss25pc
Tags: competition, woocommerce, entries, number board, ecommerce
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 0.2.12
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Run WooCommerce-backed competition entries with optional number boards, skill questions, winner tools, and CSV export.

== Description ==

Run WooCommerce-backed promotional competitions with selectable number boards or simple quantity-based entries. Includes skill questions, free-entry information blocks, manual winner tools, CSV export, shortcode embeds, and mobile-friendly frontend layouts.

WooCommerce handles checkout, orders, customer emails, refunds, and payment gateway support. This plugin provides the entry selection, automatic entry assignment, reservation, and order meta layer.

This plugin provides tools for running competition entries. Site owners are responsible for ensuring their competitions comply with applicable laws and payment provider rules.

== Installation ==

1. Install and activate WooCommerce.
2. Upload this plugin to `/wp-content/plugins/` or install it from the WordPress admin.
3. Activate **VDL Competition Entries for WooCommerce**.
4. Create a competition in **Competition Boards → Boards**.
5. Choose Number Board or Simple Entries mode and link a WooCommerce product in the settings.
6. Add the shortcode `[slotkit_board id="123"]` to a page (replace `123` with your board ID).

== Frequently Asked Questions ==

= Does this plugin process payments directly? =

No. WooCommerce and your configured WooCommerce payment gateways handle payments and order processing.

= Can I run boards without WooCommerce? =

Lite v1 is built around WooCommerce checkout and orders. WooCommerce should be active for normal operation.

= How are selected numbers stored? =

Numbers are reserved as temporary holds, then marked sold when WooCommerce orders are paid (`processing`/`completed`).

= Can customers buy entries without choosing numbers? =

Yes. Simple Entries mode lets customers choose an entry quantity. Entry numbers are assigned automatically after WooCommerce payment.

= What happens on failed, cancelled, or refunded orders? =

Failed/cancelled pre-sale holds are released. Refunded entries remain in sold history for auditability and admin review.

= Does this plugin guarantee legal compliance? =

No. The plugin provides tooling only. Site owners are responsible for compliance with local laws and payment provider rules.

== External services ==

This plugin can create WhatsApp, Facebook, and X share links when users choose to share a competition or board. The plugin does not send data to these services automatically. When a visitor clicks one of these share links, their browser is directed to the selected service with the configured share text and URL.

Service provider: WhatsApp / Meta Platforms, Inc.
Terms: https://www.whatsapp.com/legal/terms-of-service
Privacy: https://www.whatsapp.com/legal/privacy-policy

Service provider: Facebook / Meta Platforms, Inc.
Terms: https://www.facebook.com/legal/terms
Privacy: https://www.facebook.com/privacy/policy/

Service provider: X Corp.
Terms: https://x.com/en/tos
Privacy: https://x.com/en/privacy

== Screenshots ==

1. Competition board frontend with available/held/sold number states.
2. Simple Entries frontend with quantity selector and automatic number assignment.
3. Board settings metabox in wp-admin.
4. Holds screen for active reservations.
5. WooCommerce checkout handoff flow.
6. Stats/export screen with CSV entry export.
7. Winner tools for manual winner selection.

== Changelog ==

= 0.2.12 =
* Renamed the plugin for WordPress.org review, added the WooCommerce dependency header, documented WhatsApp share links, tightened public REST read permissions, and moved inline admin/preview assets into WordPress enqueue APIs.

= 0.2.11 =
* Improved public board layout width, moved action controls before large number grids, refined hero proportions, and clarified disabled action states.

= 0.2.10 =
* Frontend visual overhaul with a larger prize-style hero, light mobile-first entry surface, floating progress strip, larger number tiles, and cleaner Simple Entries controls.

= 0.2.9 =
* Added Simple Entries mode for quantity-based WooCommerce competition entries without a visible number grid.
* Entry numbers are assigned automatically after WooCommerce payment.
* CSV/export source now records entry mode.
* Winner tools now work for both number boards and automatically assigned entries.
* Improved frontend entry overview, progress display, mobile checkout summary, and visible tile state labels.
* Added clearer admin readiness checks for launch/setup workflows.

= 0.2.7 =
* Public-facing copy repositioned as a WooCommerce number board competition plugin.
* WooCommerce checkout is now the default Lite v1 flow.
* Added board-level free-entry / postal-entry information fields and public info blocks.
* Removed Lite admin surfaces that are not suitable for a WordPress.org distribution flow.
* Fixed board refresh behavior that could clear selected numbers in some timing windows.

= 0.2.6 – 2026-01-14 =
* Disable auto bank checkout in admin and REST (fail closed).

= 0.2.3 – 2025-12-01 =
* Version sync for licensing/updater baseline.
* No functional changes; groundwork for auto-update diagnostics.

= 0.2.0 =
* Woo card takeover and CSS polish.
* Single board hero layout.
* Stripe checkout flow.
* Stats and CSV export.
* Embed wizard and archive cards.

= 0.1.0 =
* Initial board, holds, and WooCommerce bridge release.
