Miaalo Connector

By Keshav Grover

0+ active installationsVersion 5.4.0

Connect WPForms, Divi, Contact Form 7, Elementor, Gravity Forms, Fluent Forms, and Forminator submissions to any HTTPS CRM or webhook endpoint.

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, and message from 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-admin or via wp-config.php constants (MIAALO_ENDPOINT_URL and MIAALO_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

  1. Upload the miaalo-connector folder to /wp-content/plugins/, or upload miaalo-connector.zip via Plugins -> Add New -> Upload Plugin.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Navigate to Settings -> Miaalo Connector.
  4. Enter your site’s HTTPS Endpoint URL and API Key.
  5. 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.

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.

How is my API key stored securely?

Your API key is encrypted with AES-256-GCM using your site’s AUTH_SALT and SECURE_AUTH_SALT before being written to wp_options (with autoload disabled). You can also define MIAALO_API_KEY and MIAALO_ENDPOINT_URL in wp-config.php so credentials never touch the database.

Will a failed API request break my visitor’s form submission?

No. All submission handling is wrapped in a Throwable exception boundary so form confirmations and email notifications always complete normally.

Changelog

5.4.0

  • Added repeatable multi-form connection blocks so multiple forms on one site can share a single API key and endpoint with independent field mappings.

5.3.0

  • Added universal form discovery and submission handling across WPForms, Divi 4/5 (all post types), Contact Form 7, Elementor Pro, Gravity Forms, Fluent Forms, and Forminator.
  • Added Universal All-Forms auto-detect mode in the form selector.

5.2.1

  • Updated plugin display name to Miaalo Connector for Guideline 17 compliance.
  • Enabled automatic 91 country-code normalization by default and stripped leading zeros on 11-digit phone numbers.
  • Fixed Divi string field ID persistence on settings save.