Title: Match Me for BuddyPress & BuddyBoss Author: Muhammad Kashif Published: February 22, 2017 Last modified: March 5, 2026 --- Search plugins ![](https://ps.w.org/match-me-for-buddypress/assets/banner-772x250.jpg?rev=3475050) ![](https://ps.w.org/match-me-for-buddypress/assets/icon-256x256.png?rev=3475050) # Match Me for BuddyPress & BuddyBoss By [Muhammad Kashif](https://profiles.wordpress.org/xpertone/) [Download](https://downloads.wordpress.org/plugin/match-me-for-buddypress.2.0.0.zip) * [Details](https://wordpress.org/plugins/match-me-for-buddypress/#description) * [Reviews](https://wordpress.org/plugins/match-me-for-buddypress/#reviews) * [Installation](https://wordpress.org/plugins/match-me-for-buddypress/#installation) * [Development](https://wordpress.org/plugins/match-me-for-buddypress/#developers) [Support](https://wordpress.org/support/plugin/match-me-for-buddypress/) ## Description **Match Me for BuddyPress & BuddyBoss** is a compatibility matching plugin that calculates how well members align based on their profile fields. Whether you are building a dating site, a networking community, a roommate finder, a mentor matching platform, or any community where connecting the right people matters, Match Me gives every member pair a compatibility percentage they can see on profiles and the members directory. You choose which xProfile fields to include, how much each one matters, and how values should be compared. The plugin handles the rest: scoring, caching, and displaying results automatically across your site. **Works with BuddyPress and BuddyBoss Platform.** The plugin auto detects which one is active. No configuration needed. #### 🔧 How It Works 1. Pick which profile fields to use for matching in the admin panel 2. Assign a weight to each field so important fields count more 3. Choose a comparison mode for each field (exact, overlap, range, or partial) 4. Members browse the site and see compatibility percentages on every profile and in the members directory #### ⚙️ Matching Engine * **Weighted scoring** Assign a percentage weight to each xProfile field. Fields that matter more contribute more toward the final compatibility score. * **4 comparison modes** Exact match for dropdowns and radio buttons, overlap ( Jaccard similarity) for checkboxes and multi select fields, range for numeric values, and partial for free text similarity. * **Hard exclusions** Mark any field as must match. If two members do not match on a hard exclude field, their compatibility drops to 0% instantly. Useful for language, location, or any critical criteria. * **Deal breakers** A softer penalty that reduces the score when an important field does not match, without zeroing it completely. * **Confidence indicator** Shows what percentage of weighted fields both members actually filled out. A 92% match with low confidence means only a few fields were compared. Helps members understand how reliable a score is. #### ⚡ Performance * **SQL first architecture** All scoring runs through optimized database queries, not slow PHP loops. A single query handles an entire directory page with hundreds of members. * **Database caching** A dedicated cache table stores computed scores with configurable expiration. Scores are automatically cleared when a member updates their profile. * **Lazy loading directory** Match percentages load on demand as members scroll into view using IntersectionObserver. The page loads instantly without waiting for match calculations. * **Batch recalculation** WP Cron powered background processing recalculates scores in bulk for large communities. #### 🎨 Display * **Circle and badge styles** Choose between an SVG circle progress indicator or a compact pill badge. Both are mobile responsive and lightweight. * **Color thresholds** Configure which colors represent high, medium, and low compatibility so members can read scores at a glance. * **Shortcode support** Use `[matchme]` to display a match score anywhere on your site. The legacy `[mp_match_percentage]` shortcode still works for backward compatibility. #### 🔌 Developer Friendly * **REST API** `GET /matchme/v1/match/{user_id}` returns percentage, confidence, and optional field breakdown in JSON. * **13 hooks** Actions and filters let themes and addons extend the matching engine, display output, admin settings, and API responses without modifying plugin files. * **Field completion nudges** Automatic prompts encourage members to fill in missing profile fields that would improve their match quality. #### 🛡️ Secure and Private Nonce verification, capability checks, and input sanitization on every request. Match data is only visible to logged in members. No anonymous access, no external API calls, no tracking, and no third party dependencies. Everything runs entirely on your server. #### 💎 Pro (Coming Soon) * **Per field breakdown** Detailed tooltip showing exactly 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** Show an unlimited number of top matches on each member profile * **Bar and heart display styles** Additional display options with a color customizer and animations * **Advanced export and reports** CSV and JSON export with date filters, scheduled email reports, and delivery options #### 🏢 Business (Coming Soon) * **Match based notifications** Automatic email alerts when a high compatibility match is discovered * **Message unlock rules** Require a minimum match percentage or mutual match before members can message each other * **Role to role match rules** Control which member types and roles can match using a visual matrix * **Match analytics** Distribution charts, trend graphs, and per member match history * **Automation and webhooks** Trigger external actions when match thresholds are reached, with CRM and email platform integration * **Geo and distance matching** Radius based matching with configurable location weighting * **Saved segments** Create smart member lists such as “80% or higher compatibility and active in the last 7 days” ## Installation 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 to configure your fields Or upload the `match-me-for-buddypress` folder to your plugins directory and activate. Requires BuddyPress or BuddyBoss Platform to be installed and active. ## FAQ ### What platforms are supported? BuddyPress and BuddyBoss Platform. The plugin auto detects which one is active. ### What kind of sites can use this? Any community where connecting compatible members matters. Dating and relationship sites, professional networking platforms, roommate and housing finders, mentor and mentee matching, study group formation, co founder matching, and more. ### How are matches calculated? Each xProfile field gets a weight and comparison mode. The engine fetches both members’ field values in a single SQL query, scores each field according to its mode, and combines them into a weighted percentage. ### What are comparison modes? **Exact** scores 100% when values match, 0% otherwise. Best for dropdowns and radio buttons. **Overlap** uses Jaccard similarity for multi value fields like checkboxes. More shared selections means a higher score. **Range** scores by how close two numbers are within a configurable tolerance. Best for numeric fields like age or budget. **Partial** scores by text similarity. Best for free text fields like job titles or interests. ### What is a hard exclusion? A must match field. If two members do not match on a hard exclude field, their entire compatibility drops to 0%. Use for critical criteria like language, location, or gender preference. ### What is the confidence score? It shows what percentage of configured field weights both members actually have data for. High confidence means most fields were compared. Low confidence means many fields were left empty by one or both members. ### Does it scale to large communities? Yes. The engine uses optimized SQL queries and a dedicated cache table. A directory page with 100 members loads match data in 1 to 2 queries. Uncached results calculate lazily via AJAX as members scroll into view. ### Is match data visible to everyone? Match scores are visible to all logged in members. Anonymous visitors see nothing. ### Can I customize the display? Yes. Choose between circle progress and badge styles, and configure separate colors for high, medium, and low match thresholds in the admin. ### Is the old shortcode still supported? Yes. `[mp_match_percentage]` still works and renders the same output as the new `[ matchme]` shortcode. ### Can I request custom development? Yes. We offer custom feature development for tailored matching algorithms, display styles, and third party integrations. Contact hello@meshpros.com for a quote. ### Does it phone home or require external services? No. Everything runs on your server. No external requests, no tracking, no analytics, and no third party dependencies. ## Reviews ![](https://secure.gravatar.com/avatar/bbc42b85a5ff9b9f93f5d1686b5ce8f736cd81b86e638caff8a38ef51ca6eee4? s=60&d=retro&r=g) ### 󠀁[Nice it’s free but didn’t work for me](https://wordpress.org/support/topic/nice-its-free-but-didnt-work-for-me/)󠁿 [tanboxer](https://profiles.wordpress.org/tanboxer/) July 27, 2024 Whatever I tried, I just seemed to be getting low match percentages. Maybe because of my custom profile fields and lack of plugin updates. ![](https://secure.gravatar.com/avatar/06be585f819993000e82e57525f38989ac7ab8c6a8c480cb5b8d11c29d4193f0? s=60&d=retro&r=g) ### 󠀁[Good](https://wordpress.org/support/topic/good-7990/)󠁿 [immirabel](https://profiles.wordpress.org/immirabel/) June 1, 2023 I’ve been using it for a while, I like it. would be good if there was a way to link up gender accurately ![](https://secure.gravatar.com/avatar/23c410a3d526a52d0597f250c38aeaa21fa13d796891bd6641092d1e3e09829b? s=60&d=retro&r=g) ### 󠀁[Diligent author!](https://wordpress.org/support/topic/diligent-author/)󠁿 [valueplant](https://profiles.wordpress.org/valueplant/) June 3, 2020 1 reply I got a warning message from Match me for BuddyPress. I realized that this plugin functions one of major features of purchased premium theme. So, I contacted this author to take a look if the warning message could be disappeared. Very impressed to see Mr. Kashif didn’t mind solving the issue though it was not the problem for everyone. Thank you, Kashif. ![](https://secure.gravatar.com/avatar/0d0d081d82ac8f0550361a8f712329cc0ff4613bb7af2c7254c4e64ed9fe59cd? s=60&d=retro&r=g) ### 󠀁[Great Plugin](https://wordpress.org/support/topic/great-plugin-26141/)󠁿 [a3132](https://profiles.wordpress.org/a3132/) May 17, 2020 1 reply Great Plugin and Great Customer Service ![](https://secure.gravatar.com/avatar/16b04f038a8a2103af0d5fcbabdb71c518111357e5ade669da43235322616386? s=60&d=retro&r=g) ### 󠀁[It works really good!](https://wordpress.org/support/topic/it-works-really-good-2/)󠁿 [imborx](https://profiles.wordpress.org/imborx/) January 31, 2020 It does what it says. I’ll wait for the PRO version. ![](https://secure.gravatar.com/avatar/ec2a12a378b763f14ead82dd8426d7f1f27f7e36250bb7e3bd88718ebd67074e? s=60&d=retro&r=g) ### 󠀁[Simple and Straight forward](https://wordpress.org/support/topic/simple-and-straight-forward-23/)󠁿 [cheryljbarnes](https://profiles.wordpress.org/cheryljbarnes/) May 25, 2018 Its an amazing plugin , would be great if there is feature of matching opposite values. [ Read all 12 reviews ](https://wordpress.org/support/plugin/match-me-for-buddypress/reviews/) ## Contributors & Developers “Match Me for BuddyPress & BuddyBoss” is open source software. The following people have contributed to this plugin. Contributors * [ Muhammad Kashif ](https://profiles.wordpress.org/xpertone/) [Translate “Match Me for BuddyPress & BuddyBoss” into your language.](https://translate.wordpress.org/projects/wp-plugins/match-me-for-buddypress) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/match-me-for-buddypress/), check out the [SVN repository](https://plugins.svn.wordpress.org/match-me-for-buddypress/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/match-me-for-buddypress/) by [RSS](https://plugins.trac.wordpress.org/log/match-me-for-buddypress/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.0.0 Complete rewrite from the ground up. * SQL first matching engine replacing the 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 tabbed settings and AJAX save * Field completion nudges for members * REST API endpoint for developers * 13 extension hooks for themes and addons * Full security: nonces, capability checks, sanitized inputs * SVG circle and badge display styles * Backward compatible shortcode support * Clean uninstall with complete table removal #### 1.3 Regular update and maintenance. ## Meta * Version **2.0.0** * Last updated **4 months ago** * Active installations **200+** * WordPress version ** 5.9 or higher ** * Tested up to **6.9.4** * PHP version ** 7.4 or higher ** * Tags * [buddyboss](https://wordpress.org/plugins/tags/buddyboss/)[buddypress](https://wordpress.org/plugins/tags/buddypress/) [compatibility](https://wordpress.org/plugins/tags/compatibility/)[matchmaking](https://wordpress.org/plugins/tags/matchmaking/) * [Advanced View](https://wordpress.org/plugins/match-me-for-buddypress/advanced/) ## Ratings 4.6 out of 5 stars. * [ 9 5-star reviews ](https://wordpress.org/support/plugin/match-me-for-buddypress/reviews/?filter=5) * [ 2 4-star reviews ](https://wordpress.org/support/plugin/match-me-for-buddypress/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/match-me-for-buddypress/reviews/?filter=3) * [ 1 2-star review ](https://wordpress.org/support/plugin/match-me-for-buddypress/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/match-me-for-buddypress/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/match-me-for-buddypress/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/match-me-for-buddypress/reviews/) ## Contributors * [ Muhammad Kashif ](https://profiles.wordpress.org/xpertone/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/match-me-for-buddypress/)