Description
Miaalo Connector eliminates manual PHP snippets by giving site administrators a clean, isolated interface under Settings -> Miaalo Connector to connect WordPress forms directly to their CRM or API endpoint.
Key Features
- Multi-Form Support (Shared Credentials): Connect multiple forms on the same website using repeatable Form Connection blocks that share a single HTTPS Endpoint URL and encrypted API Key, each with its own field mappings and enable/disable toggle.
- Universal Form Builder Support: Automatically discovers and captures submissions from WPForms, Divi 4 & Divi 5 (across all post types and Theme Builder layouts), Contact Form 7, Elementor Pro, Gravity Forms, Fluent Forms, and Forminator.
- All-Forms Auto-Detect Mode: Choose All Forms to automatically extract and forward
name,phone,email, andmessagefrom every form on your site—no per-form setup required. - Zero Hardcoded Endpoints: Configure each site’s unique HTTPS endpoint URL and API key directly in
wp-adminor viawp-config.phpconstants (MIAALO_ENDPOINT_URLandMIAALO_API_KEY). - One-Click Field Discovery & Editable Mapping: Select any specific form and click Fetch & Auto-Map (or Re-retrieve & Update) to extract field IDs, labels, and sanitization rules while previewing the exact outgoing JSON payload.
- Authenticated Encryption at Rest: Encrypts saved API keys using OpenSSL AES-256-GCM (with AES-256-CBC + HMAC-SHA256 fallback) derived from WordPress salts.
- Self-Healing & Auto-Retry: Falls back to semantic field matching if a form field ID changes, and queues failed deliveries in an encrypted WP-Cron retry queue (up to 3 attempts).
External Services Disclosure
This plugin connects to a user-configured external HTTPS API endpoint (such as the Miaalo CRM service at https://miaalo.com/, governed by https://miaalo.com/terms) solely when a visitor submits a mapped form or when an administrator clicks Send Test Submission. Only the form fields explicitly mapped by the site administrator and the configured API key are transmitted over HTTPS via wp_safe_remote_post(). No tracking, telemetry, or background data is sent to any third party.
Installation
- In your WordPress dashboard, go to Plugins -> Add New Plugin and search for Miaalo Connector.
- Click Install Now, then click Activate.
- Navigate to Settings -> Miaalo Connector.
- Enter your site’s HTTPS Endpoint URL and API Key.
- Select All Forms or a specific form, click Fetch & Auto-Map, review the mappings, click + Add Another Form if you need additional form setups, and click Save All Settings.
- (Optional) Open the Activity Log & Test tab and click Send Test Submission to verify your connection.
FAQ
-
Which form builders are supported?
-
Miaalo Connector supports WPForms, Divi Contact Form (Divi 4 & Divi 5), Contact Form 7, Elementor Pro Forms, Gravity Forms, Fluent Forms, and Forminator.
-
Can I connect multiple forms on the same website?
-
Yes. Enter your HTTPS Endpoint URL and API Key once at the top, then click + Add Another Form to add as many independent Form Connection blocks as you need—each with its own form selection, field mappings, and enable/disable toggle.
-
How is my API key stored securely?
-
Your API key is encrypted with AES-256-GCM using your site’s
AUTH_SALTandSECURE_AUTH_SALTbefore being written towp_options(withautoloaddisabled). You can also defineMIAALO_API_KEYandMIAALO_ENDPOINT_URLinwp-config.phpso credentials never touch the database. -
Will a failed API request break my visitor’s form submission?
-
No. All submission handling is wrapped in a
Throwableexception boundary so form confirmations and email notifications always complete normally.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Miaalo Connector” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Miaalo Connector” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
5.4.0
- Added repeatable multi-form connection blocks so multiple forms on one site can share a single API key and HTTPS endpoint with independent field mappings.
- Added universal form discovery and submission handling across WPForms, Divi 4 & 5, Contact Form 7, Elementor Pro, Gravity Forms, Fluent Forms, and Forminator.
- Added Universal All Forms auto-detect mode and automatic phone country-code normalization.
