Broadcast Messages — Setup & Configuration

4 min read

The GeoBuddy Broadcast Messages addon automatically distributes a Ninja Forms submission lead to nearby GeoDirectory listings — connecting users with local businesses instantly, without any manual effort.

[screenshot: broadcast messages flow — user submits a form and nearby listings receive the lead by email]


Requirements

Before installing, make sure the following plugins are active on your site:

  • GeoBuddy (required)
  • GeoDirectory (required)
  • Ninja Forms (required)

Installation

  1. Purchase the addon from wpgeobuddy.com/downloads/geobuddy-broadcast-messages/
  2. Go to WordPress Dashboard → Plugins → Add New → Upload Plugin
  3. Upload the ZIP file and click Install Now, then Activate
  4. Broadcast settings will appear under GeoBuddy → Settings → Broadcast tab
  5. Broadcast logs will be available under GeoBuddy → Broadcast Logs

[screenshot: GeoBuddy admin menu showing Settings and Broadcast Logs submenu items]


How It Works

When a visitor submits a Ninja Form on your site, the addon automatically identifies GeoDirectory listings near the location specified in the form. It then broadcasts the lead — the form submission details — to the owners of those nearby listings by email. This turns a single inquiry into multiple business opportunities with no manual work required.

[screenshot: diagram or example of a submitted form triggering emails to nearby listing owners]


Configuration

Broadcast Settings

Go to GeoBuddy → Settings → Broadcast to configure the addon.

[screenshot: GeoBuddy → Settings → Broadcast tab]

  • Select Ninja Form — choose which form submission triggers the broadcast
  • Broadcast radius — set the distance (in km or miles) within which nearby listings will receive the lead
  • Listing post type — select which GeoDirectory post type to target (e.g. Places, Services)
  • Email subject — customize the subject line of the broadcast email sent to listing owners
  • Email message — customize the body of the broadcast email; use available field tags to include form submission data dynamically
  • Throttle limit — control how many emails can be sent per submission to avoid spam
  • User consent field — map a Ninja Forms checkbox field to ensure GDPR opt-in before broadcasting

[screenshot: Broadcast settings fields filled in with example values]

Broadcast Logs

Go to GeoBuddy → Broadcast Logs to view a full history of every broadcast triggered on your site.

[screenshot: Broadcast Logs list showing form submissions, number of listings reached, and status]

  • See which form submission triggered each broadcast
  • View how many listings were reached per broadcast
  • Check delivery status and debug any failed sends

Use Cases

Broadcast Messages is suitable for any directory-driven website that wants to improve lead distribution:

  • Business directories — connect service seekers with multiple local providers
  • Local service marketplaces — distribute job requests to nearby contractors or freelancers
  • Real estate directories — share property enquiries with relevant agents
  • Healthcare directories — route patient enquiries to nearby clinics or specialists
  • Home service directories — send repair or maintenance requests to local tradespeople
  • Event and tourism listings — distribute booking enquiries to nearby venues or guides

Best Practices

  • Always include a consent checkbox in your Ninja Form and map it to the User consent field in Broadcast Settings to stay GDPR compliant
  • Set a sensible throttle limit to avoid overwhelming listing owners with too many emails per submission
  • Use dynamic field tags in the email message to include the user’s name, enquiry details, and contact information so listing owners can respond directly
  • Check Broadcast Logs regularly to monitor delivery and catch any configuration issues early
  • Test the full flow with a real form submission before going live to confirm emails are reaching the correct listings

Frequently Asked Questions

Which form plugin does this addon work with?

Broadcast Messages requires Ninja Forms. It is not compatible with other form plugins such as Gravity Forms or WPForms at this time.

How are nearby listings determined?

The addon uses the location data from the form submission and the coordinates stored in GeoDirectory listings to calculate proximity. Listings within the configured broadcast radius receive the lead.

Can I control how many listing owners receive each broadcast?

Yes. Use the Throttle limit setting to cap the number of emails sent per form submission.

Is user consent required before broadcasting?

The addon includes a User consent field mapping option. You can link a Ninja Forms checkbox to this field to ensure the user has opted in before their details are shared with listing owners.

Where can I see which broadcasts have been sent?

Go to GeoBuddy → Broadcast Logs to view a full history of every broadcast, including which form triggered it, how many listings were reached, and delivery status.

What happens if GeoBuddy, GeoDirectory, or Ninja Forms is not active?

The addon will display an admin notice and will not function until all three required plugins are installed and activated.

Updated on May 19, 2026

Share This Article: