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 #
- Purchase the addon from wpgeobuddy.com/downloads/geobuddy-broadcast-messages/
- Go to WordPress Dashboard → Plugins → Add New → Upload Plugin
- Upload the ZIP file and click Install Now, then Activate
- Broadcast settings will appear under GeoBuddy → Settings → Broadcast tab
- 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.
