FRS Lead Pages

Version: 1.4.0 Repository: derintolu/frs-lead-pages

Lead generation landing page builder with multi-step wizards. Create Open House, Customer Spotlight, and Event pages with LO/Partner co-branding support.

Features

Implemented

Feature	Description
Open House Wizard	Create property open house landing pages
Customer Spotlight Wizard	Testimonial/case study pages
Special Event Wizard	Event promotion pages
Mortgage Calculator Wizard	Calculator landing pages
Rate Quote Wizard	Rate quote request pages
Apply Now Wizard	Loan application landing pages
Bi-Directional Mode	LO creates solo or co-branded; Partner selects LO
Partner Selection	Co-branding between LOs and Partners

URLs

URL	Purpose
/marketing/lead-pages/	Main Lead Pages dashboard
/generation-station/	Lead Pages wizard page

Wizards

All wizards render modal containers via wp_footer on every frontend page.

Wizard	Shortcode	Trigger Class	Theme
Open House	[open_house_wizard_button]	oh-wizard-trigger	Teal
Customer Spotlight	[customer_spotlight_wizard_button]	cs-wizard-trigger	Blue
Special Event	[special_event_wizard_button]	se-wizard-trigger	Amber
Mortgage Calculator	[mortgage_calculator_wizard_button]	mc-wizard-trigger	Blue
Rate Quote	[rate_quote_wizard_button]	rq-wizard-trigger	Emerald
Apply Now	[apply_now_wizard_button]	an-wizard-trigger	Indigo

User Modes

The plugin supports bi-directional mode detection for different user types:

Mode	Constant	Behavior
Loan Officer	MODE_LOAN_OFFICER	Solo page or co-branded with Partner
Partner	MODE_PARTNER	Must select LO partner (required)
Admin	MODE_ADMIN	Can act as either via ?mode= param

Mode Detection

use FRSLeadPages\Core\UserMode;

// Get current mode
$mode = UserMode::get_mode();

// Check specific mode
if (UserMode::is_loan_officer()) {
    // Show solo/co-branded options
}

if (UserMode::is_partner()) {
    // Show LO selection (required)
}

Admin Mode Override

Administrators can test either mode via URL parameter:

• ?mode=lo or ?mode=loan_officer → LO mode
• ?mode=partner → Partner mode

Dependencies

• frs-wp-users - User profile data, NMLS lookup

NMLS Lookup

The plugin provides a helper function to get user NMLS from multiple sources:

// Gets NMLS from (in priority order):
// 1. FRS Profiles table (frs-wp-users)
// 2. Linked person post meta
// 3. User meta fallback
$nmls = frs_get_user_nmls($user_id);

File Structure

frs-lead-pages/
├── frs-lead-pages.php          # Main plugin file
├── includes/
│   ├── Core/
│   │   ├── UserMode.php        # LO vs Partner mode detection
│   │   ├── Realtors.php        # Fetch partner list for LOs
│   │   └── LoanOfficers.php    # Fetch LO list for Partners
│   ├── OpenHouse/Wizard.php
│   ├── CustomerSpotlight/Wizard.php
│   ├── SpecialEvent/Wizard.php
│   ├── MortgageCalculator/Wizard.php
│   ├── RateQuote/Wizard.php
│   └── ApplyNow/Wizard.php

Related Documentation

• Hub System - Portal integration
• frs-wp-users - User profiles