Match Me for BuddyPress & BuddyBoss

Match Me for BuddyPress & BuddyBoss turns any BuddyPress or BuddyBoss community into a matchmaking platform. Members see compatibility scores based on their profile fields, weighted and scored using smart comparison modes.

🚀 How It Works

1. Configure fields in the admin by assigning weights and comparison modes to your xProfile fields
2. Members browse and match percentages appear automatically on profiles and the members directory
3. Smart caching stores results in a dedicated table and recalculates only when profiles change

✨ Core Features

🎯 Weighted matching engine Assign a percentage weight to each xProfile field. Fields that matter more count more toward the final score.

⚡ SQL first performance All matching runs through optimized database queries, not slow PHP loops. One query handles a full directory page with hundreds of members.

🔄 4 comparison modes Exact match for dropdowns, overlap (Jaccard) for checkboxes, range for numbers, and partial for text similarity.

🛡️ Hard exclusions Mark fields as must match. If a hard exclude field does not match, the pair gets 0% instantly.

⚠️ Deal breakers Soft penalty that reduces the score when an important field does not match, without zeroing it.

📊 Confidence indicator Shows how many configured fields both users actually answered. A 90% match with low confidence means few fields were comparable.

🔵 Circle and badge display SVG circle progress and pill badge included. Clean, mobile responsive, no bloated CSS.

🔍 Lazy loading directory Match percentages load via IntersectionObserver as members scroll into view. No blocking on page load.

💾 Database caching Dedicated cache table with configurable TTL. Auto invalidation when profiles change. Batch recalculation via WP Cron.

🎨 Modern admin interface Settings page with Plus Jakarta Sans, AJAX save with toast notifications, and inline confirmations.

🧩 Shortcode support [matchme] displays a match score anywhere. [mp_match_percentage] still works for backward compatibility.

🔌 REST API GET /matchme/v1/match/{user_id} returns percentage, confidence, and optional breakdown.

📝 Field completion nudges Prompts users to fill missing profile fields that improve match quality.

🔒 Secure by default Nonce verification, capability checks, sanitized inputs. No anonymous access to match data.

🧱 Extension ready 13 hooks (actions and filters) let addons extend the engine, display, admin, and API without touching core files.

💎 Upcoming Pro

Premium features coming soon to supercharge your matchmaking community:

🧮 Per field breakdown Detailed tooltip showing what matched, what did not, and which fields were missing for each member pair.

🔎 Advanced directory filters Filter the members directory by minimum match percentage and specific field values.

🏆 Unlimited top matches Display an unlimited number of top matches on member profiles.

🎨 Bar and heart display styles Additional display options with color customizer and animations beyond the free circle and badge styles.

📤 Advanced export and reports CSV and JSON export with date filters, scheduled reports, and email delivery.

🏢 Upcoming Business

Enterprise grade features for large communities and professional matchmaking platforms:

🔔 Match based notifications Email alerts when a high compatibility match is found.

💬 Message unlock rules Set matching thresholds, mutual match requirements, and cooldown periods before members can message each other.

👥 Role to role match rules Member type and role matrix for controlling which roles can match with each other.

📈 Match analytics Distribution charts, trends, and per user match history.

🤖 Automation and webhooks Trigger actions on match thresholds with CRM and email integration support.

🧪 A/B scoring profiles Test different scoring models before publishing them to all members.

📍 Geo and distance matching Radius based matching with location weighting.

📋 Saved segments Smart lists such as members with 80% or higher match scores who were active recently.

⏱️ Scheduled recalculation Background recalculation jobs with queue controls.

👆 Swipe Addon

A separate Swipe addon is also planned, adding a card based discovery UI for browsing matches.

1. Go to Plugins > Add New in your WordPress admin
2. Search for Match Me for BuddyPress & BuddyBoss
3. Click Install Now, then Activate
4. Go to Match Me in the admin menu

Or upload the match-me-for-buddypress folder to your plugins directory and activate.

Requires BuddyPress or BuddyBoss Platform to be installed and active.

2.0.0

🎉 Complete rewrite from the ground up

⚡ SQL first matching engine replacing PHP loop approach
🔄 4 comparison modes: exact, overlap, range, partial
🛡️ Hard exclusion and deal breaker support
📊 Confidence score alongside match percentage
💾 Dedicated cache table with auto invalidation
🔍 Lazy loading directory via IntersectionObserver
🎨 Modern admin with 4 tabs and AJAX save
📝 Field completion nudges
🔌 REST API endpoint
🧩 13 extension hooks for addons
🔒 Full security: nonces, capability checks, no nopriv endpoints
🔵 SVG circle and badge display
🧱 Backward compatible [mp_match_percentage] shortcode
🧹 Clean uninstall with table removal

1.3

Regular update and maintenance.