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.

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