Super Gift by Cart Pro - Documentation v3.1.0
🎁 WooCommerce Plugin v3.1.0

Super Gift by Cart Pro

Advanced gift system with BOGO auto-add, cart total rules, scheduling, category conditions, customizable badges, and beautiful UX for your WooCommerce store.

Multiple Rule Types

Choose the perfect gift strategy for your store

🛒

Cart Total

Gift when cart reaches a minimum amount. Shows promo banner on shop pages.

🎫

BOGO

Buy X Get Y Free with auto-add to cart. 4 different BOGO types available.

📁

Category

Gift for specific category purchases with minimum spend requirements.

🔢

Quantity

Gift based on total items in cart. Can target specific products.

📦

Product

Gift when specific products are in cart together (bundle gift).

Powerful Features

Everything you need to boost sales with smart gifting

📊

Progress Indicator

"Add €15 more for a free gift!" - Animated progress bar with smart messages for each rule type.

🏷️

Custom Badges

Customizable badge colors, gradients, text, and emoji for each rule. Live preview in admin.

📅

Scheduling

Set start and end dates for promotions. Perfect for Black Friday, Christmas, or seasonal sales.

🎯

Usage Limits

Set total usage limits or per-customer limits. Create urgency with limited availability.

👥

Customer Restrictions

Target new customers only, logged-in users, or specific user roles like wholesale.

BOGO Auto-Add

Free items automatically added to cart when conditions are met. No customer action needed.

🛍️

Shop Page Banners

Cart Total rules show promotional banners on shop and product pages to encourage purchases.

🎨

6 Banner Styles

Choose from Gradient, Festive, Minimal, Urgent, Eco, or Luxury banner designs.

📋

Order Tracking

Gift and BOGO items are marked in orders for easy tracking in admin and customer emails.

🎫 BOGO Auto-Add System

Buy One Get One - Automatically adds free items to cart

👕

Same Product

Buy 2 shirts, get 1 shirt free (same product auto-added)

📱

Specific Product

Buy phone, get free case (different product auto-added)

🏷️

Category Based

Buy from Electronics, get accessory free (category trigger)

💰

Cheapest Free

Buy 3 items, cheapest is free (existing item becomes free)

💡 Key Features: Auto-add to cart • Shows "FREE" badge in cart • Locked from removal • Tracked in orders

🛍️ Shop Page Display

How promotions appear on your shop and product pages

Cart Total Banner

Shows at the top of shop/product pages for Cart Total rules:

🎁 Spend €50 and get a FREE gift! Only €35 more to go!

Product Badges

Badges appear on product images for applicable rules:

Buy 2 Get 1 Free 🎁 Free Gift at €100+ 🎁 Free Gift with 5+ items

Badge Display Logic

Smart badge placement based on rule type:

  • Cart Total: Shop page banner (not on products)
  • BOGO: On trigger products only
  • Category: On products in required category
  • Quantity: On required products (if set)
  • Product: On required products only

🎨 Badge Customization

Each rule can have its own unique badge style

Buy 2 Get 1 Free
Buy 2 Get Case Free
Buy 4+ Cheapest Free
🎁 Free Gift at €100+
🎁 Free Gift with 5+ Items
🎁 Free Gift with Bundle

🎨 Customization Options (per rule)

  • Badge Color From: Start color of gradient
  • Badge Color To: End color of gradient
  • Text Color: Badge text color
  • Custom Text: Override default badge text
  • Show Emoji: Add 🎁 emoji before text
  • Live Preview: See changes in real-time in admin

🛒 Cart Display

How gifts and BOGO items appear in the cart

👕

Premium T-Shirt (x2)

€58.00
👕

Premium T-Shirt (BOGO)

🎉 Buy 2 Get 1 FREE
€29.00
FREE
🎁

Free Gift - Tote Bag

🎁 Free Gift
€15.00
FREE

🔒 Gift items are locked and cannot be removed manually - they're auto-managed by the plugin

📋 Order Tracking

Gifts are clearly marked in orders for easy tracking

👤 Customer Order View

Premium T-Shirt x2
Premium T-Shirt x1🎉 BOGO FREE
Tote Bag x1🎁 Free Gift

👨‍💼 Admin Order View

Premium T-Shirt x2€58.00
Premium T-Shirt x1🎉 BOGO FREE€0.00
Tote Bag x1🎁 Free Gift€0.00

Easy Installation

Get started in minutes

📦 WordPress Upload

  • 1

    Download the plugin ZIP file

  • 2

    Go to Plugins → Add New → Upload

  • 3

    Choose ZIP file and click Install Now

  • 4

    Click Activate Plugin

📁 FTP Upload

  • 1

    Extract the plugin ZIP file

  • 2

    Upload folder to /wp-content/plugins/

  • 3

    Go to Plugins → Installed Plugins

  • 4

    Find plugin and click Activate

Configuration Options

Navigate to Gift Rules in WordPress admin

⚙️ Basic Settings

  • Enable/Disable rule
  • Select rule type (5 types)
  • Set min/max cart total
  • Exclude sale items

🎁 Gift Products

  • Select multiple gift options
  • Set number of gifts allowed
  • Search products easily
  • Show product prices

📅 Schedule & Limits

  • Set start/end dates
  • Total usage limit
  • Per customer limit
  • Track usage count

👥 Restrictions

  • Require login
  • New customers only
  • Specific user roles
  • Required products/categories

🎨 Display Options

  • 6 banner styles
  • Custom badge colors
  • Custom badge text & emoji
  • Mini cart notice

🎫 BOGO Settings

  • 4 BOGO types
  • Buy X Get Y quantities
  • Select gift product
  • Max free items limit

Rule Types Comparison

Quick reference for all rule types

Rule TypeTriggerBadge LocationGift Method
Cart TotalSpend €X amountShop page bannerCustomer selects from modal
BOGO - SameBuy X of same productOn trigger productsAuto-add same product
BOGO - SpecificBuy trigger productOn trigger productsAuto-add gift product
BOGO - CategoryBuy from categoryOn category productsAuto-add gift product
BOGO - CheapestBuy X items totalAll productsCheapest becomes free
CategorySpend €X in categoryOn category productsCustomer selects from modal
QuantityHave X items in cartOn required productsCustomer selects from modal
ProductHave specific productsOn required productsCustomer selects from modal

Banner Styles

6 beautiful designs to match your store

🎁 Gradient
🎄 Festive
📦 Minimal
⚡ Urgent
🌿 Eco
✨ Luxury

Use Case Examples

Popular gift rule configurations

💎

Tiered Rewards

€50+ = 1 gift, €100+ = 2 gifts, €200+ = 3 premium gifts (Cart Total rules)

👕

Buy 2 Get 1 Free

Classic BOGO on selected products - free item auto-adds to cart

📱

Phone + Case Bundle

Buy iPhone, automatically get free case (BOGO Specific Product)

💰

Cheapest Item Free

Buy 4 items, cheapest is free - shows savings in cart (BOGO Cheapest)

🆕

Welcome Gift

Free gift for first-time customers only (New Customer restriction)

🎄

Holiday Special

Scheduled Dec 1-25, festive banner, custom red badge, limited to 500 uses

🏪

Wholesale Bonus

Extra gifts for wholesale user role only (User Role restriction)

🔢

Bulk Purchase Reward

Buy 5+ items from T-Shirt category, get free tote bag (Quantity rule)

Requirements

What you need to get started

📦

WordPress

5.8+
🛒

WooCommerce

6.0+
🐘

PHP

7.4+
🗄️

MySQL

5.6+

Version History

What's new in each release

🆕 v3.1.0 (Current)

  • BOGO auto-add system (4 types)
  • Custom badge colors & text
  • Shop page promo banners
  • Smart badge placement
  • Improved progress messages
  • Order tracking for gifts

📦 v3.0.0

  • 5 rule types system
  • Scheduling & limits
  • 6 banner styles
  • Customer restrictions
  • Category conditions
  • Progress indicators

📦 v2.0.0

  • Modern UI redesign
  • Multi-gift selection
  • Gift selection modal
  • Cart total rules
  • Basic BOGO support
  • Mobile responsive

Ready to Boost Your Sales?

Start offering smart gifts and watch your average order value increase!

🌐 Visit Nasir.fr 📖 Need Help?

Made with ❤️ by Nasir Mehmood | Version 3.1.0

Super Gift by Cart Pro Logo
Super Gift by Cart Pro