# PromoForge Smart Campaigns for WooCommerce

![WordPress Plugin Version](https://img.shields.io/wordpress/plugin/v/promoforge-smart-campaigns-for-woocommerce)
![WordPress Tested](https://img.shields.io/wordpress/plugin/tested/promoforge-smart-campaigns-for-woocommerce)

## 🚀 Official WordPress.org Plugin

PromoForge Smart Campaigns for WooCommerce is officially available on WordPress.org:

🔗 https://wordpress.org/plugins/promoforge-smart-campaigns-for-woocommerce/

Install directly from your WordPress dashboard.

---

PromoForge Smart Campaigns for WooCommerce is a powerful and flexible WooCommerce discount plugin that allows you to create structured, high-converting promotional campaigns without modifying global pricing rules.

Instant configuration, beautiful badge logic, and robust performance ensure that discounts apply correctly across the entire customer journey: on the Product page, Cart, and Checkout!

---

## ⚡ Free vs Pro Breakdown

Below is the difference between the base Free version (available on WordPress.org) and the Premium Pro Add-on:

| Feature | Free Tier | Pro Add-on |
| :--- | :---: | :---: |
| **Flash Offers** | Limit: 2 Active Campaigns | 🚀 Unlimited Campaigns |
| **Basic Badge Customization** | ✅ Yes | ✅ Yes |
| **Buy One Get One (BOGO)** | ❌ No | ✅ Yes |
| **Upcoming / Scheduled Offers** | ❌ No | ✅ Yes |
| **Countdown Display Timers** | ❌ No | ✅ Yes |
| **Special URL-Locked Offers** | ❌ No | ✅ Yes |
| **Detailed Reports & Analytics** | ❌ No | ✅ Yes |
| **Per-User Usage Limitations** | ❌ No | ✅ Yes |

---

## 🚀 Key Features

- 🔥 Flash Offers with time-based discounts (Free Limit: 2 active campaigns)
- ⏳ Upcoming Offers with scheduled start/end dates (Pro Add-on)
- ⭐ Special Offers with shortcode-based display (Pro Add-on)
- 🎁 BOGO Offers (Buy One Get One logic) (Pro Add-on)
- 🗂 Category-based product selection
- 🛒 Offer discounts applied on:
  - Product page
  - Cart
  - Checkout
- 🎯 Offer-specific discount logic (not global)
- ⚡ AJAX-powered admin UI
- 🧩 Shortcode support
- 🧠 Custom offer rules & conditions
- 🔐 Secure & optimized for performance
- ✅ Fully compatible with WooCommerce
- 📊 Comprehensive Reports & Analytics (Flash & BOGO performance) (Pro Add-on)
- 🔄 Real-Time License Sync: Easily manage active domain allocations for your premium addon.

---

## 🏷️ Offer Types Explained

### 🔥 Flash Offer
- Limited-time discount offers
- Price override logic
- Automatically expires after end time
*Available in Free (up to 2 simultaneous active campaigns) & Pro (unlimited).*

### ⏳ Upcoming Offer (Pro Add-on)
- Schedule offers for future dates
- Automatically activates when time starts

### ⭐ Special Offer (Pro Add-on)
- Assign products to special URL-locked campaigns
- Display products via shortcode
- Discount applies **only when accessed through specific URL**

### 🎁 BOGO Offer (Pro Add-on)
- Buy One Get One
- Buy X Get Y On Discount
- Quantity-based rules
- Applied in cart and checkout

---

## ⚙️ How It Works

1. Create an offer from WordPress Admin.
2. Choose offer type (Flash, Upcoming*, Special*, or BOGO*).
3. Select products or categories.
4. Define discount rules.
5. Offer applies automatically based on conditions.
*(*Upcoming, Special, BOGO require the Pro Add-on Upgrade).*

---

## ⚙️ How to Install Pro

When you upgrade to Pro:
1. Download the Pro Add-on ZIP file from your customer dashboard.
2. Upload it to your WordPress site via Plugins -> Add New -> Upload Plugin.
3. Activate the plugin and enter your License Key inside **Offers Settings** to unlock all features.

---

## 📦 Core Requirements

- WordPress 5.8 or higher
- WooCommerce 7.0 or higher
- PHP 7.4 – 8.2