Form Integration for Action Network and Contact Form 7
by procomdev3 on WordPress.org
Seamlessly connect Contact Form 7 to ActionNetwork with smart field mapping, country detection, and comprehensive tagging support!
Main section of the plugin, where you just enter the Action NEtwork API Endpoint.
Contact Form 7 (CF7) is a widely-used plugin by millions of WordPress websites for creating forms.
The Form Integration for Action Network and Contact Form 7 plugin provides a powerful bridge between your WordPress forms and ActionNetwork’s organizing platform. Designed for nonprofits, advocacy groups, and political campaigns, this plugin automatically maps CF7 form fields to ActionNetwork’s person data structure with intelligent field recognition and enhanced features.
Key Features
🎯 Smart Field Mapping: Automatically recognizes common form field patterns and maps them to ActionNetwork’s standard fields
🌍 Auto Country Detection: Automatically detects user location when country isn’t provided in forms
🏷️ Advanced Tagging: Add or remove tags from ActionNetwork contacts with simple configuration
📧 Email Integration: Control ActionNetwork autoresponse emails and skip CF7 emails to prevent duplicates
🔒 Security First: WordPress.org compliant with proper nonces, sanitization, and permission checks
🎨 Modern Admin UI: Clean, responsive interface with real-time URL validation
📊 Source Tracking: Automatic referrer data and custom source identification
🔄 Retry Logic: Built-in exponential backoff for reliable delivery
Disclaimer: This plugin was created without any encouragement from ActionNetwork or CF7 developers.
How to Use
Setting up the integration is simple:
- Create an ActionNetwork Action: Set up a Form, Petition, Event, Fundraising Page, or Advocacy Campaign in ActionNetwork
- Get the API Endpoint: Copy the API Endpoint URL from the right sidebar when editing your action
- Configure CF7 Form: In Contact Form 7, go to the ‘ActionNetwork’ tab and paste your URL
- Smart Configuration: The plugin automatically activates when you add a URL – no separate activation needed
- Optional Enhancements: Configure country detection, tags, source tracking, and autoresponse settings
Supported ActionNetwork Actions
The plugin automatically detects and properly formats data for:
– Forms /submissions
– Petitions /signatures
– Events /attendances
– Fundraising Pages /donations
– Advocacy Campaigns /outreaches
Smart Field Mapping
The plugin intelligently recognizes common CF7 field names and automatically maps them to ActionNetwork’s person structure:
Email Variations:
your-email, email, email-address Email address
Name Variations:
your-name, first-name, firstname, given-name First name
your-last-name, last-name, lastname, family-name, surname Last name
Contact Information:
your-phone, phone, phone-number, telephone, mobile Phone number
Address Components:
your-address, address, street-address Street address
your-city, city, locality, town City
your-state, state, province, region State/Region
your-zip, zip, zipcode, postal-code Postal code
your-country, country Country
Custom Fields: Any fields that don’t match these patterns are automatically included as custom fields in ActionNetwork.
Advanced Features
Country Auto-Detection: When enabled, automatically detects user’s country using:
– IP geolocation services
– CloudFlare country headers
– Browser language preferences
Tag Management:
– Add tags to new contacts (comma-separated list)
– Remove specific tags from contacts
– Tag operations run automatically on form submission
Source Tracking:
– Configurable source name for campaign tracking
– Automatic referrer URL capture
– Support for ?source= URL parameters
External Services
This plugin connects to external services to provide its functionality. Here are the third-party services used:
ActionNetwork API
What it’s used for: This plugin’s primary function is to send form submission data to ActionNetwork’s organizing platform for contact management and campaign actions.
What data is sent: All form field data submitted through Contact Form 7, including but not limited to names, email addresses, phone numbers, addresses, and any custom fields. This data is formatted according to ActionNetwork’s person data structure.
When data is sent: Data is transmitted to ActionNetwork every time a Contact Form 7 form is submitted on forms where ActionNetwork integration is configured.
Service provider: ActionNetwork
Terms of service: https://actionnetwork.org/terms
Privacy policy: https://actionnetwork.org/privacy
IP Geolocation Service (ipapi.co)
What it’s used for: Automatic country detection when the country auto-detection feature is enabled and the user’s country cannot be determined through other methods.
What data is sent: The user’s IP address is sent to determine their country location.
When data is sent: Only when country auto-detection is enabled and a form is submitted without a country field or when other country detection methods fail.
Service provider: ipapi.co
Terms of service: https://ipapi.co/terms/
Privacy policy: https://ipapi.co/privacy/
Note: This service is only used as a fallback when other country detection methods (GeoIP functions, CloudFlare headers, browser language) are unavailable. You can disable country auto-detection in the plugin settings if you prefer not to use this service.
