A WordPress plugin for building guided lead capture flows with step-based logic, session tracking, and a floating chat-style UI.
Guided Flow Leads helps you create interactive, step-by-step flows that guide visitors through questions, choices, and input fields, then store lead and session data inside WordPress.
It is designed for businesses that want a lightweight guided selling, lead qualification, or conversational form experience without building a full custom application.
- Step-based flow builder in WordPress admin
- Support for guided choice and input steps
- Option branching with Next Step ID
- Floating frontend chat-style launcher
- Lead data collection and storage
- Session tracking and resume support
- REST API endpoints for flow actions
- Admin-side usage guide
- GitHub Actions release packaging
Guided Flow Leads can be used for:
- product recommendation flows
- quote pre-qualification
- sales lead capture
- conversational inquiry forms
- guided support funnels
- landing page conversion flows
Create steps in the Flow Editor and define how users move from one step to the next.
For choice-based steps, define:
- Label — what the user sees
- Value — what gets stored
- Next Step ID — where the flow goes next
Display the guided experience on the frontend through the plugin’s UI integration.
The plugin stores both lead information and session progress for follow-up and future expansion.
The plugin currently includes:
- Flow Editor
- Settings
- Usage Guide
These areas help site admins configure flows, understand setup, and manage future workflow expansion.
The plugin uses dedicated database tables for:
- lead entries
- session progress
This makes it possible to support resumable guided flows and structured lead capture.
- Download the latest plugin package from Releases
- Go to WordPress Admin → Plugins → Add New → Upload Plugin
- Upload the zip file
- Activate the plugin
- Open Guided Flow Leads from the WordPress admin menu
This repository uses GitHub Actions to automatically build installable plugin zip packages for tagged releases.
- Update code locally
- Commit changes
- Push to GitHub
- Create a new tag such as
v1.1.0 - Push the tag
- GitHub Actions builds the plugin package and attaches it to the Release
This project is actively being refined.
Recent work includes:
- improving flow editor behavior
- fixing option row rendering
- adding a professional admin usage guide
- stabilizing GitHub Actions packaging and release flow
Planned improvements may include:
- better lead management UI
- improved session inspection tools
- richer frontend rendering controls
- shortcode/embed documentation
- onboarding improvements
- FAQ and help documentation
This plugin is a good fit for:
- WordPress developers
- B2B business websites
- lead-generation landing pages
- quote and inquiry systems
- guided product selection experiences
This repository is being maintained as an active custom WordPress plugin project.
Structured suggestions, bug fixes, and UX improvements are welcome.
This project is licensed under the MIT License.