=== BrandProtection – Anti Counterfeit & Code Verification ===
Contributors: devkamran
Tags: anti-counterfeit, verification, product authentication, security, woocommerce
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Protect your brand with unique verification codes. Generate, assign to WooCommerce products, print QR tags, and enable frontend verification.

== Description ==

**BrandProtection** is a comprehensive WordPress plugin designed to combat counterfeit products by implementing a robust verification code system. It allows you to generate unique codes, assign them to your WooCommerce products, and provide a seamless verification experience for your customers.

Protect your brand reputation and build customer trust with unique, secure product authentication.

= Key Features =

* **Generate Unique Codes** - Create 1 to 10,000 guaranteed unique verification codes in a single batch.
* **WooCommerce Integration** - Seamlessly assign codes to specific WooCommerce products.
* **Printable QR Tags** - Generate and print professional QR code tags directly from the admin panel for your physical products.
* **Frontend Verification** - Simple shortcode `[brandprot_verify]` allows customers to verify product authenticity instantly.
* **Smart Verification Logic** - Automatically detects and flags first-time verifications, duplicate attempts, and invalid codes.
* **Comprehensive Logging** - Track all verification attempts with detailed information including IP, browser, and timestamp.
* **Admin Dashboard** - Get an overview of your system with beautiful statistics and quick action buttons.
* **CSV Export** - Export usage logs and code lists for offline analysis.
* **Security First** - Built with WordPress security best practices, including nonce verification and data sanitization.
* **GDPR Compliant** - Stores minimal data (IP address for security) with no PII collection.

= How It Works =

1. **Generate Codes**: Go to the "Generate Codes" page to create a batch of unique codes.
2. **Assign to Products**: Link these codes to your WooCommerce products.
3. **Print Tags**: Select codes and use the "Print Tags" bulk action to generate QR code labels for your packaging.
4. **Distribute**: Attach the codes/tags to your physical products.
5. **Verify**: Customers scan the QR code or enter the code on your verification page to confirm authenticity.

= Verification Statuses =

* **Valid**: The code exists and is being verified for the first time. The customer sees a success message.
* **Used**: The code has already been verified. The customer is warned that the product might be counterfeit or the code reused.
* **Invalid**: The code does not exist in the system. The customer is alerted to a potential fake product.

= Privacy & GDPR =

BrandProtection is designed with privacy in mind:
* We only store IP addresses and User Agent strings for security and fraud detection purposes.
* No personal identifiable information (PII) like names or emails is collected.
* Data collection is transparent and intended solely for system integrity.

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel.
2. Navigate to **Plugins > Add New**.
3. Search for "BrandProtection".
4. Click **Install Now** and then **Activate**.

= Manual Installation =

1. Download the plugin zip file.
2. Extract the contents.
3. Upload the `brand-protection` folder to the `/wp-content/plugins/` directory.
4. Activate the plugin through the **Plugins** menu in WordPress.

= Post-Installation Setup =

1. Ensure **WooCommerce** is installed and activated.
2. Navigate to **Brand Protection > Generate Codes**.
3. Create your first batch of codes.
4. Create a new page (e.g., "Verify product") and add the shortcode `[brandprot_verify]`.
5. Start protecting your brand!

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =
Yes, WooCommerce is required to assign verification codes to specific products.

= How many codes can I generate at once? =
You can generate up to 10,000 unique codes in a single batch.

= Can I customize the verification page? =
Yes, the verification form uses standard CSS classes. You can style it to match your theme using custom CSS.

= How do I print QR codes? =
Go to **Brand Protection > Manage Codes**, select the codes you want to print, choose "Print Tags" from the bulk actions dropdown, and click Apply.

= Is the plugin GDPR compliant? =
Yes. We only collect technical data (IP, User Agent) necessary for security and fraud prevention. No PII is stored.

== Screenshots ==

1. **Admin Dashboard** - Overview of your codes and verification stats.
2. **Generate Codes** - Interface to create and assign new codes.
3. **Usage Logs** - Detailed history of all verification attempts.
4. **Frontend Verification** - What your customers see when verifying a product.
5. **Settings Page** - Configure code formats and logging preferences.

== Changelog ==

= 1.0.0 - 2025-01-25 =
* Initial release.
* Feature: Bulk code generation (1-10,000).
* Feature: WooCommerce product assignment.
* Feature: Printable QR code tags.
* Feature: Frontend verification shortcode.
* Feature: Comprehensive usage logging and CSV export.
* Feature: Admin dashboard with statistics.

== Upgrade Notice ==

= 1.0.0 =
Initial release of BrandProtection plugin.

== Additional Information ==

= Support =
For support, bug reports, or feature requests, please contact us:
* Email: support@devkamran.com
* Website: [devkamran.com](https://devkamran.com)

= Credits =
Developed by **devkamran**.

== Technical Details ==

= Database Tables =
* `wp_brandprot_codes` - Stores verification codes and product assignments.
* `wp_brandprot_usage_logs` - Stores verification attempt history.

= Shortcodes =
* `[brandprot_verify]` - Displays the product verification form.

= System Requirements =
* WordPress 5.8 or higher
* PHP 7.4 or higher
* WooCommerce 5.0 or higher
* MySQL 5.6 or higher

== Third Party Resources ==

* **QRCode.js**
    * Source: https://github.com/davidshimjs/qrcodejs
    * License: MIT
    * License URI: https://opensource.org/licenses/MIT