A lightweight, modular WordPress plugin that simulates AI-powered tenant screening for landlords and property managers. Evaluates income, rental history, references, and fit scores — with CSV and PDF export tools. Fully client-side, privacy-safe, and built for easy future AI upgrades. “The wrong tenant never moves in.” Smart Tenant Screening Assistants – WordPress Plugin AI-Simulated Tenant Evaluation for Landlords & Property Managers
Pitch: “The wrong tenant never moves in.”
The Smart Tenant Screening Assistants plugin provides landlords with an easy, professional tool to evaluate tenant applications using simulated AI scoring. It analyzes income, rent ratio, references, and rental history — producing a clean, instant recommendation report with CSV and PDF exports.
This is the Basic Safe Version (client-side only, no external API calls). Ideal for testing, demos, landlord tools, and future AI expansion.
🚀 Features ✓ Smart Tenant Scoring (Simulated AI)
Income-to-rent ratio analysis
Rental history score
Reference stability
Final recommendation: Recommended / Needs Review / Not Recommended
✓ Client-Side Exports
Download CSV report
Generate PDF (via browser print dialog)
✓ Professional UI
Clean form design
Modern card-style results
Copy-ready landlord-friendly layout
✓ Privacy-Safe
No server storage
No external API calls
Runs fully in the browser
✓ WordPress Integration
Use anywhere with the shortcode:
[tenant_screening_assistant]
🧱 Architecture & Development Philosophy
This plugin follows three core engineering principles you requested:
- Modularization Way
The plugin is intentionally divided into small, maintainable modules:
/smart-tenant-screening │ ├── smart-tenant-screening.php # WordPress bootstrap + shortcode + assets │ ├── /assets │ ├── sts.js # UI logic, scoring engine, CSV/PDF export │ └── sts.css # Modern, clean styling │ └── /docs └── architecture-notes.md # (Suggested) Future architecture notes
Why this structure?
Easy for future AI upgrades
Code is readable, replaceable, testable
Assets remain isolated from core logic
Each module can be swapped without breaking others
- Patterns Used
To ensure consistency and future scalability, the plugin follows these design patterns:
UI Pattern: Form → Validate → Process → Display
User enters tenant data
JS validates fields (client-side)
Scoring engine analyzes the values
Result card displays fit score + recommendation
Data Pattern: Stateless Processing
All calculations occur in the browser
No data stored in WordPress
No database dependency
Ensures maximum speed and privacy
Export Pattern: Client-Side Generation
CSV generated from JS array → Blob → Download
PDF triggered via window.print() for universal compatibility
Plugin Pattern: WordPress Shortcode Design
Shortcode → Enqueue assets → Render UI → Run JS engine
- Docs Injection (Developer-Friendly Documentation)
The plugin includes structured developer notes to accelerate future development:
Injected Documentation Includes:
How to extend scoring logic
Hooks for API integration
Suggested AI roadmap
Modules list & responsibilities
Front-end UX patterns
Example of Doc Injection Comments (inside code) /**
- DOCS INJECTION: Tenant Scoring Logic
- Step 1 — Income-to-rent ratio
- Step 2 — History score weighting
- Step 3 — Final risk categorization
- To integrate real AI:
- Replace this block with API call → normalize scoring → return risk index. */
These comments make sure every future developer understands:
What happens
Why it happens
Where improvements can be added
🛠 Installation
Download the ZIP file
Go to WordPress Dashboard → Plugins → Add New
Upload the ZIP
Activate plugin
Add the shortcode to any post or page:
[tenant_screening_assistant]
📤 Exports CSV Export
Creates a downloadable CSV report containing:
Tenant name
Monthly income
Monthly rent
Rent-to-income ratio
Recommendation result
PDF Export
Print-ready PDF via browser dialog (universal across all devices).
Results are AI-generated for educational use only. Always verify with professionals and follow your local tenant screening laws.
📈 Future Enhancements (Planned)
This Basic Safe Version is prepared for:
AI-powered screening (credit-like modeling)
Third-party API integrations (background checks, payment history)
Admin dashboard to store past evaluations
Direct PDF generation using jsPDF or PDFKit
Agent / landlord role-based permissions
The architecture is modular so these features can be added without rewriting the core.
⭐ Pitch for the Plugin “The wrong tenant never moves in.”
Your AI assistant helps landlords avoid costly mistakes — quickly, cleanly, and intelligently.