# Overview

Complete guide to mastering your WooCommerce Add to Cart button control.

{% hint style="info" %}
**Welcome to Conditional Add to Cart Pro**

This documentation will help you get the most out of your plugin. Start with Installation and License Activation, then explore the features.
{% endhint %}

### What is Conditional Add to Cart Pro?

Conditional Add to Cart Pro is a powerful WooCommerce plugin that gives you complete control over the "Add to Cart" button. Create unlimited conditional rules to hide, customize, or replace the button based on products, user roles, cart content, date/time and more.

### Key Features

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><h4>Unlimited Rules</h4></td><td>Create as many conditional rules as you need with no restrictions.</td><td><a href="/files/K5FlRTC7V3pPv011eSoy">/files/K5FlRTC7V3pPv011eSoy</a></td></tr><tr><td><h4>Advanced Conditions</h4></td><td>Target by cart content, price, user roles, stock status, and more.</td><td><a href="/files/5NoAa7fhEXoDF40ol9AY">/files/5NoAa7fhEXoDF40ol9AY</a></td></tr><tr><td>Advanced Actions</td><td></td><td><a href="/files/uyAuvbju3KCdMeooeFg9">/files/uyAuvbju3KCdMeooeFg9</a></td></tr><tr><td><h4>Variable Products</h4></td><td>Full support for variable products and individual variations.</td><td><a href="/files/B9HgCMdAVZImyGpYndRr">/files/B9HgCMdAVZImyGpYndRr</a></td></tr><tr><td></td><td></td><td><a href="/files/wQqoaaNa9c3lXcqGEUtM">/files/wQqoaaNa9c3lXcqGEUtM</a></td></tr><tr><td><h4>Quote System</h4></td><td>Replace Add to Cart with a professional quote request form.</td><td><a href="/files/ffsZ0BuJgT06XdZzR1hp">/files/ffsZ0BuJgT06XdZzR1hp</a></td></tr></tbody></table>

### Quick Start Guide

{% hint style="info" %}

#### **Need Help?**

If you have questions or need assistance, we're here to help:

<a class="button secondary" data-icon="question">FAQ</a><a href="mailto:support@condicart.com" class="button primary" data-icon="envelope">Contact Support</a>
{% endhint %}


# Installation

Get Conditional Add to Cart Pro up and running in minutes.

{% hint style="info" %}

#### **Requirements**

Before installing, make sure your site meets these requirements:

* WordPress 5.0 or higher
* WooCommerce 3.0 or higher
* PHP 7.0 or higher
  {% endhint %}

### Installation Methods

#### Method 1: WordPress Admin Upload (Recommended)

{% stepper %}
{% step %}
**Download the plugin ZIP file**

After purchasing, download the `conditional-add-to-cart.zip` file from your account.
{% endstep %}

{% step %}
**Navigate to Plugins → Add New**

In your WordPress admin, go to **Plugins → Add New**
{% endstep %}

{% step %}
**Click "Upload Plugin"**

Click the **Upload Plugin** button at the top of the page
{% endstep %}

{% step %}
**Choose file and install**

Click **Choose File**, select the ZIP file, then click **Install Now**
{% endstep %}

{% step %}
**Activate the plugin**

After installation completes, click **Activate Plugin**
{% endstep %}
{% endstepper %}

#### Method 2: FTP Upload

{% stepper %}
{% step %}
Unzip the `conditional-add-to-cart-pro.zip` file on your computer
{% endstep %}

{% step %}
Connect to your site via FTP
{% endstep %}

{% step %}
Upload the unzipped folder to `/wp-content/plugins/`
{% endstep %}

{% step %}
Go to **Plugins** in WordPress admin and activate the plugin
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Installation Complete!**

The plugin is now installed. Next, you'll need to activate your license to unlock all Pro features.
{% endhint %}

### Verifying Installation

After activation, you should see a new menu item **Conditional Add to Cart** under the **WooCommerce** menu in your WordPress admin sidebar.


# License Activation

Activate your license to unlock all Pro features and receive updates

### Finding Your License Key

After purchasing Conditional Add to Cart Pro, you'll receive your license key via email. You can also find it in [your account dashboard](https://condicart.com/myaccount).

### Activating Your License

{% stepper %}
{% step %}
**Navigate to the License Page**

In your WordPress admin, go to **WooCommerce → Conditional Add to Cart → License**
{% endstep %}

{% step %}
**Enter Your License Key**

Paste your license key into the input field
{% endstep %}

{% step %}
**Click "Activate License"**

Click the activation button to verify your license
{% endstep %}

{% step %}
**Confirmation**

You'll see a success message when your license is activated
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**License Activated!**

All Pro features are now unlocked. You'll automatically receive plugin updates.
{% endhint %}

### Deactivating Your License

If you need to move your license to a different site:

1. In your WordPress admin, go to **WooCommerce → Conditional Add to Cart → License**
2. Click **Deactivate License**
3. Activate the license on your new site

Alternatively, you can manage your site activations by accessing [your account dashboard](https://condicart.com/myaccount).


# Creating Rules

Learn how to create and manage conditional rules for your Add to Cart button

### Creating Your First Rule

{% stepper %}
{% step %}
**Navigate to Rules Page**

Go to **WooCommerce → Conditional Add to Cart** in your WordPress admin
{% endstep %}

{% step %}
**Click "Add New Rule"**

Click the button to create a new rule
{% endstep %}

{% step %}
**Name Your Rule**

Give your rule a descriptive name (e.g., "Hide Add to Cart for Guests")
{% endstep %}

{% step %}
**Add Conditions**

Click "Add Condition" and select when the rule should activate. You can add multiple conditions that must all be true (AND logic).

For OR logic, click "Add Condition Group" to create an alternative set of conditions.
{% endstep %}

{% step %}
**Set "Which products should be affected?"**

Choose which products this rule affects:

* **All Products** - Rule applies to every product
* **Specific Products** - Select individual products
* **Product Categories** - Select categories
* **All Except Products (Pro)** - Exclude specific products
  {% endstep %}

{% step %}
**Choose Action**

Select what happens when conditions match:

* **Disable** - Remove the button completely
* **Customize** - Change button text, color, or redirect&#x20;
* **Replace** - Show custom HTML instead
* **Quote (Pro)** - Show quote request form
  {% endstep %}

{% step %}
**Save Your Rule**

Click "Save All Rules" at the bottom of the page
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Rule Created!**

Your rule is now active. Visit your product pages to see it in action.
{% endhint %}

### Managing Rules

#### Rule Priority

Rules are evaluated from top to bottom. The first rule that matches will be applied. Drag and drop rules to reorder them.

#### Enable/Disable Rules

Toggle rules on or off without deleting them. Useful for testing or seasonal rules.

#### Editing Rules

Click on any rule to expand and edit its settings. Changes are saved when you click "Save All Rules".

#### Deleting Rules

Click the trash icon to delete a rule. This action cannot be undone.

{% hint style="info" %}
**Pro Tip**

Create specific rules first, then general rules. Since rules are evaluated top-to-bottom, specific rules will take priority.
{% endhint %}

### Variable Products

The plugin fully supports variable products. You can:

* Apply rules to the parent variable product (affects all variations)
* Apply rules to specific variations only
* Use variation-specific conditions (like price or stock status)


# Conditions

### Understanding Conditions

Conditions determine when a rule should activate. You can combine multiple conditions using AND/OR logic to create sophisticated rules.

{% hint style="info" %}
**Condition Logic**

Within a condition group, ALL conditions must be true (AND logic).

Between condition groups, ANY group can be true (OR logic).
{% endhint %}

### Available Conditions

<details>

<summary><strong>User Role</strong></summary>

Target specific user roles like customers, subscribers, or custom roles.

#### Operators:

* **is** - User has this role
* **is not** - User doesn't have this role

{% hint style="info" %}

#### **Example:**

User Role **is** Guest (not logged in)
{% endhint %}

</details>

<details>

<summary><strong>Session Status</strong></summary>

Check if user is logged in or not.

**Operators:**

* **is** - Session status matches
* **is not** - Session status doesn't match

{% hint style="info" %}

#### Values:

* Logged In
* Logged Out
  {% endhint %}

</details>

<details>

<summary><strong>Product Price</strong></summary>

Check product price (useful for variable products).

**Operators:**

* Equal to
* Not equal to
* Greater than or equal to
* Less than or equal to

{% hint style="info" %}
**Example:**

Product Price **Greater than or equal to** 100
{% endhint %}

</details>

<details>

<summary><strong>Product On Sale</strong></summary>

Check if product is currently on sale.

**Operators:**

* **is** - Product is on sale
* **is not** - Product is not on sale

{% hint style="info" %}
**Values:**

* Yes
* No
  {% endhint %}

</details>

<details>

<summary><strong>Product Stock Status</strong></summary>

Check product stock availability.

**Operators:**

* **is** - Stock status matches
* **is not** - Stock status doesn't match

{% hint style="info" %}
**Values:**

* In Stock
* Out of Stock
* On Backorder
  {% endhint %}

</details>

<details>

<summary><strong>Cart Total</strong></summary>

Check the total value of items in cart.

**Operators:**

* Equal to
* Not equal to
* Greater than or equal to
* Less than or equal to

{% hint style="info" %}
**Example:**

Cart Total **Less than or equal to** 50
{% endhint %}

</details>

<details>

<summary><strong>Cart Subtotal</strong></summary>

Check cart subtotal (before taxes and shipping).

**Operators:**

* Equal to
* Not equal to
* Greater than or equal to
* Less than or equal to

</details>

<details>

<summary><strong>Cart Quantity</strong></summary>

Check total number of items in cart.

**Operators:**

* Equal to
* Not equal to
* Greater than or equal to
* Less than or equal to

</details>

<details>

<summary><strong>Cart Contains Product</strong></summary>

Check if specific product is in cart.

**Operators:**

* contains - Cart has this product
* does not contain - Cart doesn't have this product

</details>

<details>

<summary><strong>Cart Contains Category</strong></summary>

Check if products from specific category are in cart.

**Operators:**

* contains - Cart has products from this category
* does not contain - Cart doesn't have products from this category

</details>

<details>

<summary><strong>Country</strong></summary>

Target users from specific countries (based on billing/shipping address or IP).

**Operators:**

* is - User is from this country\
  is not - User is not from this country

</details>

<details>

<summary><strong>Time</strong></summary>

Check current time for daily recurring time windows (business hours, flash sales).

**Operators:**

* **is** - Current time is exactly this time
* **is not** - Current time is not this time
* **is before or at** - Current time is before or equal to this time
* **is after or at** - Current time is after or equal to this time

{% hint style="info" %}
**Example:**

Time is after or at 09:00 AND Time is before or at 17:00

*Result: Rule active during business hours (9 AM - 5 PM) every day*
{% endhint %}

</details>

<details>

<summary><strong>Date/Time</strong></summary>

Check specific date and time for one-time events (product launches, deadlines, limited offers).

**Operators:**

* **is** - Current time is exactly this time
* **is not** - Current time is not this time
* **is before or at** - Current time is before or equal to this time
* **is after or at** - Current time is after or equal to this time

{% hint style="info" %}
**Example:**

Date/Time is after or on 2024-12-25 00:00

*Result: Product becomes available at midnight on Christmas*
{% endhint %}

</details>

### Combining Conditions

#### AND Logic (Within a Group)

All conditions in a group must be true for the rule to activate.

{% hint style="info" %}
**Example: Hide button for guests on expensive products**

`Condition 1: Session Status is Logged Out`

`AND`

`Condition 2: Product Price Greater than or equal to 100`

Both conditions must be true for the rule to activate.
{% endhint %}

#### OR Logic (Between Groups)

Click "Add Condition Group" to create alternative conditions. If ANY group matches, the rule activates.

{% hint style="info" %}
**Example: Hide button for guests OR wholesale customers**

`Group 1: Session Status is Logged Out`

`OR`

`Group 2: User Role is Wholesale Customer`

If either group is true, the rule activates.
{% endhint %}

{% hint style="info" %}
**Pro Tip**

Start with simple conditions and test them. Then add more conditions to refine your rules.
{% endhint %}


# Actions

Control what happens to your Add to Cart button when conditions match

### Available Actions

#### Hide

Completely removes the Add to Cart button. The product becomes non-purchasable.

**Use Cases:**

* Restrict purchases for guests
* Disable purchasing for specific user roles
* Block sales in restricted countries
* Prevent purchases when cart minimum not met

#### Customize

Modify the button text, color, text color, or redirect to a custom URL.

**Options:**

* Button Text: Change "Add to Cart" to custom text
* Button Color: Set custom background color
* Text Color: Set custom text color
* Redirect URL: Redirect to custom page instead of adding to cart

**Use Cases:**

* Change to "Login to Purchase" for guests
* Redirect to contact form for custom orders
* Show "Pre-Order Now" for upcoming products
* Brand-specific button colors

#### Replace

Replace the button with custom HTML content. Supports shortcodes.

Use Cases:

* Show contact form
* Display custom message with links
* Embed third-party widgets
* Show availability notification form

{% hint style="info" %}
**Example HTML:**

```
<p>This product requires approval.</p>
<a href="/contact" class="button">Contact Us</a>
```

{% endhint %}

#### Quote Request

Replace button with a professional quote request form. Perfect for B2B and wholesale.

**Features:**

* Customizable button text
* Modal popup form
* Collect name, email, phone, quantity, details
* Email notifications
* Custom recipient email
* Show/hide optional fields

Learn more about the Quote System →


# Quote System

Professional quote request system for B2B and wholesale stores

{% hint style="info" %}
**What is the Quote System?**

The Quote System replaces the Add to Cart button with a "Request Quote" button. When clicked, customers fill out a form with their details, and you receive an email with their quote request.
{% endhint %}

### Setting Up Quote Requests

{% stepper %}
{% step %}
**Create a New Rule**

Go to **WooCommerce → Conditional Add to Cart** and click "Add New Rule"
{% endstep %}

{% step %}
**Set Apply To**

Choose which products should show the quote button (e.g., specific products, categories, or all products)
{% endstep %}

{% step %}
**Add Conditions (Optional)**

Add conditions if you want the quote button to show only in specific situations (e.g., for logged-out users or specific user roles)
{% endstep %}

{% step %}
**Select "Request Quote" Action**

In the Actions section, select "Quote" from the dropdown
{% endstep %}

{% step %}
**Configure Quote Settings**

Customize the quote form:

* **Button Text:** Customize the button text (default: "Request Quote")
* **Email Address:** Where quote requests are sent (default: admin email)
* **Show Phone Field:** Toggle phone number field
* **Show Quantity Field:** Toggle quantity field
* **Show Details Field:** Toggle additional details textarea
* **Custom Message:** Optional message shown in the modal
  {% endstep %}

{% step %}
**Save Your Rule**

Click "Save All Rules" to activate the quote system
{% endstep %}
{% endstepper %}

### How It Works

{% stepper %}
{% step %}
**Customer Clicks Button**

The "Request Quote" button appears instead of "Add to Cart"
{% endstep %}

{% step %}
**Modal Opens**

A professional modal popup appears with the quote request form
{% endstep %}

{% step %}
**Customer Fills Form**

Customer enters their name, email, and optional details (phone, quantity, additional info)
{% endstep %}

{% step %}
**Email Sent**

You receive an email with all the quote request details including product name, customer info, and their message
{% endstep %}

{% step %}
**You Respond**

Reply to the customer's email with your quote
{% endstep %}
{% endstepper %}

### Quote Form Fields

* **Name** <mark style="color:red;">(Required)</mark> - <mark style="color:$tint;">Customer's full name</mark>
* **Email**  <mark style="color:red;">(Required)</mark> - <mark style="color:$tint;">Customer's email address for quote response</mark>
* **Phone Number** <mark style="color:$info;">(Optional)</mark> - <mark style="color:$tint;">Customer's phone number (can be hidden via settings)</mark>
* **Quantity** <mark style="color:$info;">(Optional)</mark> - <mark style="color:$tint;">Desired quantity (can be hidden via settings)</mark>
* **Additional Details** <mark style="color:$info;">(Optional)</mark> - <mark style="color:$tint;">Free-form text area for special requests or questions (can be hidden via settings)</mark>

### Email Notifications

When a customer submits a quote request, you receive an email containing:

* Product name and link
* Customer name and email
* Phone number (if provided)
* Requested quantity (if provided)
* Additional details (if provided)
* Submission date and time

{% hint style="info" %}
**Pro Tip**

The email includes a "Reply-To" header with the customer's email, so you can simply hit reply to respond to their quote request.
{% endhint %}

### Common Use Cases

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Wholesale Orders</strong></td><td>Show quote button for bulk quantities or wholesale customers</td></tr><tr><td><strong>Custom Products</strong></td><td>Collect requirements for customizable or made-to-order products</td></tr><tr><td><strong>High-Value Items</strong></td><td>Require consultation before purchase for expensive products</td></tr><tr><td><strong>B2B Sales</strong></td><td>Negotiate pricing with business customers before finalizing orders</td></tr></tbody></table>


# Troubleshooting

Common issues and solutions

### Rule Not Working

If your rule isn't activating:

* Check that the rule is enabled (toggle switch is ON)
* Verify "Apply To" settings match your products
* Test conditions individually to find which one isn't matching
* Clear browser cache and test in incognito mode
* Check rule priority - rules are evaluated top-to-bottom

### Button Still Showing

If the Add to Cart button still appears:

* Ensure your theme uses standard WooCommerce hooks
* Check for caching plugins and clear all caches
* Disable other plugins temporarily to check for conflicts
* Try a different action (e.g., Customize instead of Hide)
* Contact support with your theme name for compatibility

### Variable Products Not Working

For variable product issues:

* Make sure you're using Pro version (free doesn't support variations)
* Select the parent product OR specific variations in "Apply To"
* Test with a simple product first to isolate the issue
* Check that variation-specific conditions are set correctly

### Quote Emails Not Sending

If quote request emails aren't arriving:

* Check spam/junk folders
* Verify email address in rule settings is correct
* Test your site's email with a plugin like WP Mail SMTP
* Check server email logs for delivery issues
* Try a different email address to rule out email provider blocks

### Customize Action Not Applying Colors

If button colors aren't changing:

* Your theme may have very specific CSS that overrides colors
* Try adding !important in custom CSS if needed
* Check browser developer tools to see which CSS is winning
* Some themes use JavaScript to style buttons - contact support

### Performance Issues

If your site is slow after installing:

* Reduce number of rules if you have many (combine where possible)
* Use specific "Apply To" instead of "All Products"
* Enable object caching on your server
* Ensure you're using the latest version of the plugin
* Contact support\` for performance optimization tips

{% hint style="warning" %}
**Still Need Help?**

If you can't resolve your issue:

Email <support@condicart.com> with:

* Your rule configuration
* Product URL where it's not working
* Theme name
* Screenshots if possible
  {% endhint %}