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
- 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.
- 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.
- 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:
- Go to the WordPress Editor
- Navigate to Appearance > Editor
- Access the Listing Template
- In the left column, click Templates
- Locate the GD Single template
- Edit the GD Single Template
- Click the three dots icon (actions) next to the template name
- Select Edit
- 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
- 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:
- Go to the WordPress Editor
- Navigate to Appearance > Editor
- Access the Listing Template
- In the left column, click Templates
- Locate the GD Single template
- Edit the GD Single Template
- Click the three dots icon (actions) next to the template name
- Select Edit
- 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
- 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.