Description
This plugin captures form submissions from Contact Form 7 (wpcf7_mail_sent hook) and sends structured JSON data to Perfectum CRM API endpoints (e.g. /leads).
Main features:
- Admin panel — map any CF7 form to CRM fields without writing code (Contact → Sync with Perfectum CRM)
- Field mapping — CF7 input
nameattributes → CRM field keys - Custom fields — send values into
custom_fields[entity][id] - Static values — set required Lead Source ID and Status ID per form
- display_name prefix — automatically append page title (
page_title) to a prefix - Credentials — configure API URL/Key in the admin UI, or override via
wp-config.phpconstants - Legacy filter — still supports code-based mappers via
wl_perfectum_cf7_form_mappers - Logging — HTTP status and responses written to
debug.logwhenWP_DEBUGis enabled - i18n — English UI with Ukrainian translation included
Installation
- Upload the
weblorem-sync-cf7-perfectum-crmfolder to/wp-content/plugins/ - Activate the plugin through the Plugins menu in WordPress
- Ensure Contact Form 7 is installed and active
- Go to Contact → Sync with Perfectum CRM
- Enter API URL and API Key (or define constants in
wp-config.php) - Add a form, map CF7 fields to CRM fields, set Source/Status IDs, and save
FAQ
Where do I get the API Key?
In Perfectum CRM: Settings → System → API Keys.
How do I set credentials in wp-config.php?
Add these constants (they override the admin fields):
define( 'PERFECTUM_API_URL', 'https://crm.yourdomain.com/api' );
define( 'PERFECTUM_API_KEY', 'your_actual_api_token_here' );
What is the CF7 field name?
It is the name attribute of the form control, e.g. your-name, your-email, your-phone. Special value page_title is also supported.
Can I still use PHP mappers?
Yes. If a form is not configured (or not enabled) in the admin panel, the plugin falls back to the wl_perfectum_cf7_form_mappers filter for backwards compatibility.
Changelog
4.1.3
- Plugin Check compliance (text domain matches slug, sanitization, escaping)
- Fixed readme Stable tag and Tested up to
- Ukrainian translation (PO/MO)
4.0.2
- Full i18n support
- Security and coding standards fixes
4.0.0
- Admin UI for form and field mapping
- Custom fields, source/status, display_name prefix