Pay Per Lead

GeoDirectory Pay-per-lead Add-on

1. Overview

The GeoDirectory Pay-Per-Lead add-on allows listing owners to receive inquiries from potential customers while keeping the sender’s contact details hidden. The listing owner must pay a fee to access the full message, including the sender’s contact information. This system allows directory owners to monetize inquiries by charging listing owners to access full customer details, ensuring they only pay for leads they find valuable.

1.1 What Directory Owners Can Do

  • Generate Revenue from Leads – Directory owners can monetize their platform by charging listing owners for accessing leads.
  • Filter Out Low-Value Inquiries – Listing owners only pay for messages that are valuable to them.
  • Encourage More Engagement – Visitors can send inquiries without barriers, increasing the chances of business connections.
  • Customizable Pricing – Admins can set the price per lead and define payment methods.
  • Seamless User Experience – The system automates notifications and payments, ensuring a smooth workflow.

1.2 Example Use Cases

  1. Local Service Directories – A plumber listed on a directory receives an inquiry:"Hi, I need a quote for a bathroom remodel. Please contact me." The plumber sees the message but must pay to unlock the sender’s phone number or email.
  2. Real Estate Listings – A property owner gets an inquiry:"I'm interested in renting your apartment. Is it available?" The owner can decide if the inquiry is worth purchasing before accessing the full details.
  3. Event & Wedding Directories – A photographer listed in a wedding directory receives:"Looking for a wedding photographer for October. Are you available?" The photographer can choose to pay and connect with the lead.

This add-on helps directory owners increase revenue while allowing businesses to pay only for potential customers, making it a valuable addition to any lead-generation platform.

2. How to enable Pay-per-lead features

After activating the GeoDirectory Pay-Per-Lead plugin, all messages sent through the GD > PPL Contact Form on any listings are automatically filtered. 

The sender’s contact details remain hidden until the listing owner pays to unlock them. 

2.1 Adding the GD > PPL Contact Form to the “GD Single” Listing Template

To display the Pay-per-lead enabled contact form on the front end for each listing, follow these steps:

  1. Go to the WordPress Editor
    • Navigate to Appearance > Editor
  2. Access the Listing Template
    • In the left column, click Templates
    • Locate the GD Single template
  3. Edit the GD Single Template
    • Click the three dots icon (actions) next to the template name
    • Select Edit
  4. Add the GD > PPL Contact Form
    • Scroll to where you want to place the contact form (e.g., at the bottom of the right sidebar to replace the default BS > Contact Form Block)
    • Click on the BS > Contact Form block
    • Click the three dots icon (options) that appears at the bottom of the selected block
    • Select Add After
    • Type /PPL and select the GD > PPL Contact Form block
    • Remove the default BS > Contact Form block
  5. Save Changes
    • Click Save (twice) to save and apply the changes

The PPL Contact Form button will be displayed on each listing page, allowing users to send inquiries. Listing owners will get the leads.

2.2 Gutenberg Themes – Kadence / Astra / Neve

Add the GD > PPL Contact Form block anywhere within your GD > Single template to display the PPL Contact Form where needed.

2.3 Elementor, Bricks, and Other Non-Gutenberg Themes

Use the GD > PPL Contact Form widget or shortcode to integrate the  PPL Contact Form into your GD > Single page wherever needed.

3. Pay-per-lead Settings

3.1 General Settings

Lead Approval Required

  • Description: Enables admin approval for leads before they are sent to listing owners.
  • Effect: When enabled, leads remain in a "Pending Approval" state until approved by an administrator.
  • Default: Disabled

3.2 Lead Price Settings

Pricing Model

  • Options:
    • Fixed Price – A set price per lead.
    • Commission-Based – The lead price is calculated as a percentage of the offer or budget provided in the inquiry.

Fixed Price per Lead

  • Description: Defines a fixed cost for unlocking a lead’s contact details.
  • Example: If set to $5, listing owners must pay $5 to view the full inquiry.

Commission-Based Pricing

  • Functionality:
    • Adds an "Offer" or "Budget" field to the contact form.
    • The lead price is calculated as:(Offer amount) × (Commission percentage)
    • Example: A $1000 offer with a 10% commission results in a $100 lead price.
  • Customization: The field label (e.g., "Offer" or "Budget") can be modified in the contact form block settings.

4. Managing Leads – Admin Panel Overview

The Leads section allows directory administrators to track, approve, reject, or delete inquiries sent through listing contact forms. Each lead includes the sender’s details, the associated listing, and its payment status.


4.1 Lead Statuses

Each lead is assigned a status indicating its current state:

  • Pending Payment – The listing owner has not yet paid to unlock the lead.
  • Purchased – The lead has been paid for and is fully accessible.
  • Unlocked – The lead was automatically made available (e.g., free leads based on settings).
  • Rejected – The lead was reviewed and marked as not valid by the admin.

4.2 Lead Management

Admin Actions

  • Approve Leads – Move a lead from pending to available for purchase.
  • Reject Leads – Mark a lead as invalid or unqualified.
  • Delete Leads – Remove a lead permanently from the system.

Bulk Actions

Admins can apply actions to multiple leads at once, including:

  • Approving or rejecting
  • Deleting

Filtering & Searching

  • Leads can be filtered by Pending, Approved, Rejected, or Purchased status.
  • A search bar allows admins to find specific leads by name, email, or listing.

4.3 Lead Information Fields

Each lead entry includes:

  • Name – Sender’s name.
  • Email – Contact email (obfuscated until purchased).
  • Phone – Contact number (hidden until purchased).
  • Listing – The associated business or service.
  • Price – The cost to unlock the lead.
  • Status – The lead’s current accessibility state.
  • Date – Timestamp of when the inquiry was sent.

4.4 Admin Control & Customization

  • Admins cannot unlock leads for free but can approve or reject them.
  • Lead pricing is configurable in the Pay-Per-Lead settings panel.
  • Rejected leads remain in the system for reference but do not count as available leads.

5 Adding the Lead List to the “GD Single” Listing Template 

5.1 Blockstrap Theme – Official GD Themes or any FSE theme

To display the lead list on the front end for each listing, follow these steps:

  1. Go to the WordPress Editor
    • Navigate to Appearance > Editor
  2. Access the Listing Template
    • In the left column, click Templates
    • Locate the GD Single template
  3. Edit the GD Single Template
    • Click the three dots icon (actions) next to the template name
    • Select Edit
  4. Add the GD > Owner Leads Block
    • Scroll to where you want to place the lead list (e.g., after reviews)
    • Click on the GD > Single Reviews Block
    • Click the three dots icon (options) that appears at the bottom of the selected block
    • Select Add After
    • Type /leads and select GD > Owner Leads Block
  5. Save Changes
    • Click Save (twice) to save and apply the changes

The lead list will be displayed on each listing page, allowing listing owners to manage their leads directly from the front end.

5.2 Gutenberg Themes – Kadence / Astra / Neve

Add the GD > Owner Leads block anywhere within your GD > Single template to display the lead list for listing owners.

5.3 Elementor, Bricks, and Other Non-Gutenberg Themes

Use the GD > Owner Leads widget or shortcode to integrate the lead list into your GD > Single page wherever needed.




Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us