Miaalo Connector

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. In your WordPress dashboard, go to Plugins -> Add New Plugin and search for Miaalo Connector.
  2. Click Install Now, then click Activate.
  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.
  6. (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_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.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Miaalo Connector” is open source software. The following people have contributed to this plugin.

Contributors

Translate “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.