=== Birthday Rewards for WooCommerce – NeoLite Birthday Bash ===
Contributors: MTPamir
Tags: woocommerce, coupons, birthday, discount, marketing
Requires at least: 6.4
Tested up to: 6.9
Stable tag: 1.1.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automate WooCommerce birthday coupons. Drive repeat sales with seamless auto-apply rewards, high-speed logic, and festive customer delight.

== Description ==

**Stop losing customers on their special day. 🎂**
Birthday emails are the secret weapon of high-growth WooCommerce stores. Statistics show that birthday rewards have a **481% higher transaction rate** and **342% more revenue per email** compared to regular promotions.

**NeoLite Birthday Bash** is the architect-grade solution for store owners who value speed. While other automation suites are heavy and complex, NeoLite is built to be a **Micro-Satellite**: lightweight, standalone, and incredibly fast.

https://www.youtube.com/watch?v=pUqgreI-3yw

[🚀 Live Demo: Try it in the Playground](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/mtpamir/wp-playground/main/birth-bash.json)

**🚀 100% Standalone: No Dependencies Required.**
Unlike other birthday tools that require heavy automation suites or complex parent plugins, **NeoLite Birthday Bash** is a self-contained extension. The only thing you need is WooCommerce.

**NeoLite Birthday Bash** is built for the "Performance Purist." We’ve replaced bloated automation workflows with a "Zero-Bloat" architecture that underpins your store's speed while maximizing customer retention.

**✨ Key Features:**
*   **Automated Conversion:** Automatically send unique coupons 7 days before the event to drive early "Hype" traffic.
*   **Intelligent Data Collection:** Collect birth dates via My Account, Registration forms, or directly in the modern **Checkout Block** (Gutenberg supported).
*   **Architect-Grade Performance:** Implemented with object caching and optimized database queries to ensure zero lag on your store.
*   **Can't-Resist Coupons:** Configure fixed or percentage discounts with automatic expiry to create a psychological "Use it or Lose it" trigger.
*   **NeoPlugin Ecosystem:** Built to work seamlessly alongside **NeoGrow** for a complete 365-day loyalty strategy. 

== Screenshots ==

1. Birthday Bash Settings: Field Configuration Area.
2. Birthday Information Form on Registration Page: Input Birthday Data.
3. Birthday Information Form on Checkout Page: Input Birthday Data.

== Installation ==

1.  Navigate to `Plugins` > `Add New` in your WordPress Dashboard.
2.  Search for **NeoLite Birthday Bash**.
3.  Click `Install Now` and then `Activate`.
4.  Find the **NeoPlugin** menu in your sidebar to configure your first birthday campaign.

== Frequently Asked Questions ==

= How does NeoLite compare to all-in-one automation suites? =
While all-in-one tools are excellent for complex marketing workflows, they often come with significant database overhead. NeoLite is a **Micro-Satellite**—it is 10x lighter, requires zero configuration of "work-flows," and operates independently without requiring expensive parent plugins.

= Does it work with the new WooCommerce Cart and Checkout Blocks? =
Yes! We have implemented full compatibility with the latest WooCommerce Blocks. Whether you use the classic shortcode-based checkout or the modern Blocks interface, the birthday features integrate seamlessly.

= Can I customize the birthday email? =
Absolutely. You can upload your logo, customize the greeting, and write your own message. We provide a Live Email Preview feature so you can see exactly what your customers will receive.

= Is it compatible with WooCommerce HPOS? =
Yes. NeoLite was architected with High-Performance Order Storage (HPOS) in mind. Your store remains future-proof and performance-ready.

= Can I use this with NeoGrow? =
Absolutely. While Birthday Bash handles the "Event," **NeoGrow** handles the "Loyalty." Using them together allows you to reward customers for birthdays AND every other purchase they make.

**Q: Will this plugin slow down my WooCommerce store?**
A: Not at all. As part of the NeoLite suite, it is built with a "Performance-First" architecture. We use optimized database queries and only load necessary assets on specific pages to ensure zero bloat and lightning-fast load times.

**Q: Does it work with the new WooCommerce Cart and Checkout Blocks?**
A: Yes! We have implemented full compatibility with the latest WooCommerce Blocks. Whether you use the classic shortcode-based checkout or the modern Blocks interface, the birthday features will integrate seamlessly.

**Q: Can I customize the birthday email to match my brand?**
A: Absolutely. You can upload your logo, customize the greeting, and write your own message. We also provide a Live Email Preview feature so you can see exactly what your customers will receive before you hit "Send."

**Q: Is it possible to make the birthday field mandatory at checkout?**
A: Yes, the admin has the option to make the birthday collection field mandatory or optional during the checkout process or on the account registration page.

**Q: Where can I see which coupons have been issued?**
A: The plugin includes a dedicated Birthday Logs dashboard. You can track which user received a coupon, when it was generated, and whether it has been redeemed for a purchase.

**Q: What happens if a customer already has a birthday coupon?**
A: The system performs a "Duplicate Check" before issuing a new one. If an active, unused birthday coupon already exists for that user, it won't create a second one, keeping your coupon database clean.

== Changelog ==

== 1.1.1 ==
**🚀 New in Version 1.1.1: Flexibility & Integration**
*   **Shortcode Power:** Use `[birthday_bash_form]` to place the collection form anywhere on your site.
*   **Block Checkout Ready:** Use `[birthday_bash_checkout_input]` to add birthday fields to the modern WooCommerce Checkout Block.
*   **Native Account Integration:** Birthday fields now automatically appear in the 'Account Details' section for a seamless user experience.
*   **Live Demo:** Explore the plugin instantly via the WordPress Playground link on our repository page.

= 1.1.0 =
* **Major Refactor:** New `NeoPlugin\NeoLite` namespace architecture for better performance and isolation.
* **New Feature:** Birthday Form Design Area.
* **UI Update:** Integrated into the new Neo Hub admin menu.
* **UI Update:** Updated Brand Logo Integration in Email.
* **UI Update:** Email Preview in Admin.

= 1.0.0 =
* Initial release. Core birthday coupon automation and data collection.

== Upgrade Notice ==

= 1.1.1 =
🚀 New in Version 1.1.1: Flexibility & Integration