# WooCommerce Request a Quote Integration

## Overview

This integration adds UTM tracking capabilities to the WooCommerce Request a Quote plugin, allowing you to capture and store UTM parameters when customers submit quote requests.

[![](https://docs.utmgrabber.com/uploads/images/gallery/2025-09/scaled-1680-/image-1758836718793.png)](https://docs.utmgrabber.com/uploads/images/gallery/2025-09/image-1758836718793.png)

## Features

### 1. Hidden UTM Fields in Quote Form
- Automatically adds hidden UTM fields to the quote request form
- Fields are populated from cookies containing UTM data
- No visible impact on the user experience

### 2. UTM Data Storage
- Saves UTM parameters as quote meta data when quotes are submitted
- Stores data using the same field names as the main UTM Grabber plugin
- Compatible with existing UTM tracking infrastructure

### 3. Admin Interface Enhancements
- Adds UTM meta box to quote admin pages
- Displays UTM data in quote details
- Shows UTM columns in quote list view
- Includes UTM search functionality

### 4. Email Integration
- Option to include UTM data in admin notification emails
- Configurable via plugin settings
- Supports both HTML and plain text email formats

### 5. PDF Export Support
- UTM data is available for PDF generation
- Can be included in quote PDFs if needed

### 6. REST API Support
- UTM data is included in REST API responses
- Enables external systems to access UTM information

## Installation

1. Ensure both plugins are active:
   - HandL UTM Grabber V3
   - WooCommerce Request a Quote

2. The integration is automatically loaded when both plugins are active

3. No additional configuration is required

## Usage

### For Site Administrators

1. **View UTM Data in Quotes**:
   - Go to WooCommerce > Request a Quote > Quotes
   - Click on any quote to view details
   - UTM data will be displayed in the "HandL UTM Grabber V3" meta box

2. **Search Quotes by UTM Data**:
   - In the quotes list, use the UTM search field
   - Search by campaign, source, medium, or other UTM parameters

3. **Configure Email Notifications**:
   - Go to HandL UTM Grabber V3 settings
   - Enable "Append Quote Meta to Request a Quote Admin Emails"
   - UTM data will be included in admin notification emails

## Troubleshooting

### Common Issues

1. **UTM data not appearing**:
   - Check if UTM cookies are being set
   - Verify JavaScript is loading on quote page
   - Check browser console for errors

2. **Admin columns not showing**:
   - Ensure you're viewing the quotes list page
   - Check if the post type is `addify_quote`
   - Verify plugin is active

3. **Email data not included**:
   - Check plugin settings for email option
   - Verify email template is using the data
   - Check if the hook is firing

4. **PHP Fatal Error: Call to a member function get() on null**:
   - This error occurs when background processes (like Yoast SEO indexing) try to load the quote template without a WooCommerce session
   - The integration now includes safety checks to prevent this error
   - If you still encounter this error, ensure both plugins are updated to their latest versions

5. **PHP Fatal Error: call_user_func_array(): Argument #1 ($callback) must be a valid callback**:
   - This error occurs when WordPress tries to call a function that's not available in the current context
   - The integration now ensures all functions are properly registered and available
   - Functions include safety checks to prevent execution in inappropriate contexts
   - AJAX requests are now properly handled to prevent callback errors during "Add to Quote" actions