Form Integration for Action Network and Contact Form 7

Opis

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:

1. Create an ActionNetwork Action: Set up a Form, Petition, Event, Fundraising Page, or Advocacy Campaign in ActionNetwork
2. Get the API Endpoint: Copy the API Endpoint URL from the right sidebar when editing your action
3. Configure CF7 Form: In Contact Form 7, go to the 'ActionNetwork’ tab and paste your URL
4. Smart Configuration: The plugin automatically activates when you add a URL – no separate activation needed
5. 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.