LeadMachine Connector

Àpèjúwe

LeadMachine Connector allows you to easily capture leads from your WordPress website and automatically send them to your LeadMachine CRM account.

Features

  • Easy setup Ìtumọ̀ Yorùbá: – just enter your Company ID and API Key
  • Native lead capture forms Ìtumọ̀ Yorùbá: – customizable shortcode-based contact forms
  • Newsletter signup forms Ìtumọ̀ Yorùbá: – lightweight form with just name, email, and opt-in
  • Analytics & tracking Ìtumọ̀ Yorùbá: – automatic UTM, ad click IDs, and browser data collection
  • Gravity Forms integration Ìtumọ̀ Yorùbá: – connect any Gravity Form to LeadMachine
  • Spam protection Ìtumọ̀ Yorùbá: – built-in honeypot and time-based bot detection
  • Responsive design Ìtumọ̀ Yorùbá: – works on all devices
  • AJAX form submission Ìtumọ̀ Yorùbá: – smooth user experience without page reloads
  • Automatic lead creation Ìtumọ̀ Yorùbá: – leads instantly appear in your LeadMachine dashboard
  • Tag support Ìtumọ̀ Yorùbá: – automatically tag leads from different forms
  • Customizable styling Ìtumọ̀ Yorùbá: – colors, button text, success messages
  • Blog post sync Ìtumọ̀ Yorùbá: – sync posts to LeadMachine for automated email newsletters
  • Conversion tracking Ìtumọ̀ Yorùbá: – fires events for Google Analytics, Facebook Pixel, LinkedIn, TikTok, and more

Native Form Usage

  1. Install and activate the plugin
  2. Go to LeadMachine settings in your WordPress admin
  3. Enter your LeadMachine Company ID and API Key
  4. Customize your form settings
  5. Add the shortcode [leadmachine_form] to any page or post

Gravity Forms Integration

Already using Gravity Forms? Connect your existing forms to LeadMachine:

  1. Go to LeadMachine settings > Gravity Forms tab
  2. Enable Gravity Forms integration
  3. Select a form and map fields to LeadMachine:
    • First Name
    • Last Name
    • Email
    • Phone
    • Company
    • Message
  4. Optionally add tags for each form
  5. Save settings Ìtumọ̀ Yorùbá: – submissions now flow to LeadMachine automatically!

Shortcode Options

Customize individual forms using shortcode attributes:

[leadmachine_form title="Contact Us" description="We'd love to hear from you!" tags="Contact Form,Website"]

Available attributes:

  • title Ìtumọ̀ Yorùbá: – Form title (overrides global setting)
  • description Ìtumọ̀ Yorùbá: – Form description text
  • button_text Ìtumọ̀ Yorùbá: – Submit button text
  • button_color Ìtumọ̀ Yorùbá: – Button background color (hex)
  • tags Ìtumọ̀ Yorùbá: – Comma-separated tags to apply to leads
  • background Ìtumọ̀ Yorùbá: – Form background color (use “transparent” for none)
  • title_color Ìtumọ̀ Yorùbá: – Title text color
  • description_color Ìtumọ̀ Yorùbá: – Description text color
  • label_color Ìtumọ̀ Yorùbá: – Form label text color

Examples:

Contact form: [leadmachine_form tags="Contact Form,High Priority"]

Newsletter Form

For simple newsletter signups, use the dedicated newsletter shortcode:

[leadmachine_newsletter]

This form only collects:
* Full Name
* Email Address
* Opt-in checkbox

Newsletter shortcode attributes:

  • title Ìtumọ̀ Yorùbá: – Form title (default: “Subscribe to Our Newsletter”)
  • description Ìtumọ̀ Yorùbá: – Form description text
  • button_text Ìtumọ̀ Yorùbá: – Submit button text (default: “Subscribe”)
  • tags Ìtumọ̀ Yorùbá: – Comma-separated tags (default: “newsletter”)
  • optin_text Ìtumọ̀ Yorùbá: – Opt-in checkbox text (supports HTML for links)
  • name_label Ìtumọ̀ Yorùbá: – Label for name field
  • email_label Ìtumọ̀ Yorùbá: – Label for email field
  • All color attributes from the contact form

Examples:

Newsletter signup: [leadmachine_newsletter title="Stay Updated" tags="newsletter,blog"]

Simple signup: [leadmachine_newsletter button_text="Sign Up" button_color="#22c55e"]

Analytics & Tracking

Both forms automatically collect browser and tracking data:

  • UTM parameters Ìtumọ̀ Yorùbá: – utm_source, utm_medium, utm_campaign, utm_term, utm_content
  • Ad platform click IDs Ìtumọ̀ Yorùbá: – Google Ads (gclid), Facebook (fbclid), LinkedIn, TikTok, Microsoft/Bing
  • Browser data Ìtumọ̀ Yorùbá: – device type, screen size, language, timezone
  • Referrer Ìtumọ̀ Yorùbá: – where the visitor came from
  • Tracking cookies Ìtumọ̀ Yorùbá: – Google Analytics, Facebook Pixel, HubSpot, LinkedIn

Form submissions also fire conversion events for:
* Google Analytics 4 (gtag.js)
* Google Analytics Universal (legacy)
* Facebook Pixel
* LinkedIn Insight Tag
* TikTok Pixel
* Microsoft/Bing UET
* Google Tag Manager dataLayer

Ìgbéwọlẹ̀

  1. Download the plugin zip file
  2. Go to WordPress Admin > Plugins > Add New
  3. Click “Upload Plugin” and choose the zip file
  4. Click “Install Now” and then “Activate”
  5. Go to LeadMachine settings and enter your Company ID and API Key

FAQ

Where do I find my Company ID and API Key?

Log in to your LeadMachine dashboard at https://app.leadmachine.fyi and go to Settings > Company > WordPress Plugin to find your credentials.

Does this work with Gravity Forms?

Yes! Version 2.0+ includes full Gravity Forms integration. You can map any Gravity Form fields to LeadMachine and automatically send submissions as leads.

Can I use multiple forms on the same site?

Absolutely. You can use the native [leadmachine_form] shortcode on multiple pages with different settings, and/or connect multiple Gravity Forms Ìtumọ̀ Yorùbá: – each with their own field mappings and tags.

How does spam protection work?

The plugin uses two methods: a honeypot field (invisible to humans but bots fill it) and time-based validation (forms submitted too quickly are rejected). No CAPTCHA required.

Will this work with my theme?

Yes! The plugin is designed to work with any WordPress theme. Form styling is minimal and adapts to your themeÌtumọ̀ Yorùbá: ’s styles.

Is the form submission secure?

Yes. All submissions use WordPress nonces for CSRF protection and are transmitted securely to your LeadMachine account via HTTPS.

Àwọn àgbéyẹ̀wò

Ka gbogbo àgbéyẹ̀wò 1

Àwọn Olùkópa & Olùgbéejáde

“LeadMachine Connector” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí.

Àwọn Olùkópa

Túmọ̀ “LeadMachine Connector” sí èdè rẹ.

Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè?

Ṣàwárí koodu, ṣàyẹ̀wò ibi ìpamọ́ SVN, tàbí ṣe àgbékalẹ̀ sí àkọsílẹ̀ ìdàgbàsókè nípasẹ̀ RSS.

Àkọsílẹ̀ àwọn àyípadà

2.6.0

  • NEW: Google Ads conversion tracking tab — configure Conversion ID + Label to fire gtag events on form submit
  • NEW: GCLID/GBRAID/WBRAID capture via cookie (30-day window) for offline conversion upload
  • NEW: Gravity Forms GCLID injection — click IDs from cookies forwarded to LeadMachine API automatically
  • NEW: analytics_data.gclid forwarded to LeadMachine on all form submissions for first-touch attribution

2.5.1

  • FIX: Default form background is now transparent (was incorrectly white)
  • FIX: Opt-in checkbox links now inherit label color instead of hardcoded blue
  • FIX: Newsletter form labels now left-justified with their fields
  • FIX: Opt-in text now uses muted styling (smaller, reduced opacity)

2.5.0

  • NEW: Full-width form layout by default
  • Newsletter form now displays inline on desktop (Name, Email, Button side by side)
  • Stacks responsively on mobile devices
  • NEW: Input styling settings in Contact Form tab
  • Input background color, border color, and text color now customizable
  • Newsletter form styling now shared from Contact Form settings
  • Added styling info link in Newsletter settings tab
  • Improved overall form responsiveness

2.4.0

  • NEW: Newsletter signup form shortcode [leadmachine_newsletter]
  • NEW: Lightweight form with just Full Name, Email, and Opt-in fields
  • NEW: Analytics & tracking data collection for all forms
  • Captures UTM parameters, ad click IDs (Google, Facebook, LinkedIn, TikTok, etc.)
  • Collects browser data (device type, screen size, language, timezone)
  • Records tracking cookies (GA, Facebook Pixel, HubSpot, LinkedIn)
  • NEW: Conversion tracking events for major ad platforms
  • Fires events for GA4, Facebook Pixel, LinkedIn, TikTok, Microsoft/Bing
  • Pushes events to Google Tag Manager dataLayer
  • Form view and submit events for analytics attribution
  • All tracking data included in lead notes for attribution analysis

2.3.0

  • NEW: Blog Post Sync for email campaigns
  • Automatically sync posts to LeadMachine when published
  • Bulk sync existing posts with one click
  • Category sync for targeted newsletter campaigns
  • Posts are summarized by AI for engaging email content
  • Select which categories to include in nurture campaigns

2.2.0

  • NEW: Advanced spam detection for Gravity Forms submissions
  • Blocks known spam bot name patterns (e.g., “taics” suffix bots)
  • Detects gibberish names, repeating patterns, suspicious email TLDs
  • Filters disposable email domains and spam keywords in messages
  • Respects Gravity Forms spam status for entries marked as spam
  • Debug logging for blocked spam (when WP_DEBUG is enabled)

2.1.2

  • Added wp_unslash() before all input sanitization per WordPress coding standards
  • Prefixed all global variables with leadmachine_ for namespace compliance
  • Wrapped debug logging in WP_DEBUG checks
  • Improved $_SERVER variable sanitization
  • Reduced readme tags to maximum of 5

2.1.1

  • Fixed output escaping for improved security
  • Improved JSON field sanitization with content validation
  • Security hardening for WordPress.org compliance

2.1.0

  • Added spam protection with honeypot field
  • Added time-based bot detection (rejects instant submissions)
  • Spam attempts are logged with IP address for monitoring
  • Forms expire after 1 hour for additional security

2.0.1

  • Bug fixes and stability improvements
  • Improved error handling for API responses

2.0.0

  • NEW: Gravity Forms integration
  • Map any Gravity Form to LeadMachine fields
  • Per-form tag configuration for Gravity Forms
  • Default tags option for all Gravity Forms submissions
  • AJAX field loading for Gravity Forms mapping
  • Improved admin UI with tabbed settings

1.1.5

  • Enhanced admin instructions with step-by-step Quick Start Guide
  • Added clear instructions on where to find Company ID in LeadMachine
  • Added dedicated “Using Tags” section with examples
  • Improved sidebar documentation for better user onboarding

1.1.4

  • Moved color customization to WordPress admin settings page
  • Added color pickers for: Form Background, Title Color, Description Color, Label Color
  • Colors can now be set globally in settings and optionally overridden per-form via shortcode
  • Improved user experience Ìtumọ̀ Yorùbá: – configure once, use everywhere

1.1.3

  • Form now hides after successful submission, showing only success message
  • Added background attribute Ìtumọ̀ Yorùbá: – supports hex colors or “transparent”
  • Added title_color attribute for custom title text color
  • Added description_color attribute for custom description text color
  • Added label_color attribute for custom form label color
  • Improved styling flexibility to match any website design

1.1.2

  • Added Terms of Service and Privacy Policy consent checkbox (required)
  • Records opt-in timestamp in database for GDPR/compliance
  • Captures IP address and consent confirmation in lead notes

1.1.1

  • Fixed JavaScript form validation bug for split name fields
  • Resolved “First name, last name, and email are required” error

1.1.0

  • Added tag support Ìtumọ̀ Yorùbá: – automatically tag leads from different forms
  • Split name field into first_name and last_name for better data accuracy
  • Source field now shows the actual page URL where form was submitted
  • Improved note formatting Ìtumọ̀ Yorùbá: – cleaner, more professional structure
  • Fixed all database column mismatches
  • Mobile responsive split fields

1.0.1

  • Improved error handling and logging
  • Added detailed error messages for debugging
  • Better API error reporting

1.0.0

  • Initial release
  • Lead capture form with customizable fields
  • Admin settings page
  • Integration with LeadMachine API
  • Responsive design
  • AJAX form submission