{"id":54535,"date":"2017-02-22T00:12:33","date_gmt":"2017-02-22T00:12:33","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/match-me-for-buddypress\/"},"modified":"2026-03-05T01:57:53","modified_gmt":"2026-03-05T01:57:53","slug":"match-me-for-buddypress","status":"publish","type":"plugin","link":"https:\/\/roh.wordpress.org\/plugins\/match-me-for-buddypress\/","author":8693134,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.0.0","stable_tag":"2.0.0","tested":"6.9.4","requires":"5.9","requires_php":"7.4","requires_plugins":null,"header_name":"Match Me for BuddyPress & BuddyBoss","header_author":"MeshPros","header_description":"","assets_banners_color":"acccbe","last_updated":"2026-03-05 01:57:53","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/meshpros.com\/","header_author_uri":"https:\/\/meshpros.com\/","rating":4.6,"author_block_rating":0,"active_installs":200,"downloads":18405,"num_ratings":12,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"2.0.0":{"tag":"2.0.0","author":"XpertOne","date":"2026-03-05 01:57:53"}},"upgrade_notice":{"2.0.0":"

Major rewrite. Field weights from v1.3 are automatically migrated. Old plugin files are no longer needed.<\/p>"},"ratings":{"1":0,"2":1,"3":0,"4":2,"5":9},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3475050,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3475050,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3475050,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3475050,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Admin settings with field configuration table","2":"Circle progress display on member profile","3":"Badge display style","4":"Members directory with lazy loading match percentages","5":"Cache management and system info","6":"Field comparison mode settings with weight bar"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[13955,204,3005,132274,257138],"plugin_category":[44],"plugin_contributors":[83911],"plugin_business_model":[],"class_list":["post-54535","plugin","type-plugin","status-publish","hentry","plugin_tags-buddyboss","plugin_tags-buddypress","plugin_tags-compatibility","plugin_tags-matchmaking","plugin_tags-member-matching","plugin_category-discussion-and-community","plugin_contributors-xpertone","plugin_committers-xpertone"],"banners":{"banner":"https:\/\/ps.w.org\/match-me-for-buddypress\/assets\/banner-772x250.jpg?rev=3475050","banner_2x":"https:\/\/ps.w.org\/match-me-for-buddypress\/assets\/banner-1544x500.jpg?rev=3475050","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/match-me-for-buddypress\/assets\/icon-128x128.png?rev=3475050","icon_2x":"https:\/\/ps.w.org\/match-me-for-buddypress\/assets\/icon-256x256.png?rev=3475050","generated":false},"screenshots":[],"raw_content":"\n

Match Me for BuddyPress & BuddyBoss<\/strong> 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.<\/p>\n\n

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.<\/p>\n\n

Works with BuddyPress and BuddyBoss Platform.<\/strong> The plugin auto detects which one is active. No configuration needed.<\/p>\n\n

\ud83d\udd27 How It Works<\/h4>\n\n
    \n
  1. Pick which profile fields to use for matching in the admin panel<\/li>\n
  2. Assign a weight to each field so important fields count more<\/li>\n
  3. Choose a comparison mode for each field (exact, overlap, range, or partial)<\/li>\n
  4. Members browse the site and see compatibility percentages on every profile and in the members directory<\/li>\n<\/ol>\n\n

    \u2699\ufe0f Matching Engine<\/h4>\n\n
      \n
    • Weighted scoring<\/strong> Assign a percentage weight to each xProfile field. Fields that matter more contribute more toward the final compatibility score.<\/li>\n
    • 4 comparison modes<\/strong> 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.<\/li>\n
    • Hard exclusions<\/strong> 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.<\/li>\n
    • Deal breakers<\/strong> A softer penalty that reduces the score when an important field does not match, without zeroing it completely.<\/li>\n
    • Confidence indicator<\/strong> 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.<\/li>\n<\/ul>\n\n

      \u26a1 Performance<\/h4>\n\n
        \n
      • SQL first architecture<\/strong> All scoring runs through optimized database queries, not slow PHP loops. A single query handles an entire directory page with hundreds of members.<\/li>\n
      • Database caching<\/strong> A dedicated cache table stores computed scores with configurable expiration. Scores are automatically cleared when a member updates their profile.<\/li>\n
      • Lazy loading directory<\/strong> Match percentages load on demand as members scroll into view using IntersectionObserver. The page loads instantly without waiting for match calculations.<\/li>\n
      • Batch recalculation<\/strong> WP Cron powered background processing recalculates scores in bulk for large communities.<\/li>\n<\/ul>\n\n

        \ud83c\udfa8 Display<\/h4>\n\n
          \n
        • Circle and badge styles<\/strong> Choose between an SVG circle progress indicator or a compact pill badge. Both are mobile responsive and lightweight.<\/li>\n
        • Color thresholds<\/strong> Configure which colors represent high, medium, and low compatibility so members can read scores at a glance.<\/li>\n
        • Shortcode support<\/strong> Use [matchme]<\/code> to display a match score anywhere on your site. The legacy [mp_match_percentage]<\/code> shortcode still works for backward compatibility.<\/li>\n<\/ul>\n\n

          \ud83d\udd0c Developer Friendly<\/h4>\n\n
            \n
          • REST API<\/strong> GET \/matchme\/v1\/match\/{user_id}<\/code> returns percentage, confidence, and optional field breakdown in JSON.<\/li>\n
          • 13 hooks<\/strong> Actions and filters let themes and addons extend the matching engine, display output, admin settings, and API responses without modifying plugin files.<\/li>\n
          • Field completion nudges<\/strong> Automatic prompts encourage members to fill in missing profile fields that would improve their match quality.<\/li>\n<\/ul>\n\n

            \ud83d\udee1\ufe0f Secure and Private<\/h4>\n\n

            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.<\/p>\n\n

            \ud83d\udc8e Pro (Coming Soon)<\/h4>\n\n
              \n
            • Per field breakdown<\/strong> Detailed tooltip showing exactly what matched, what did not, and which fields were missing for each member pair<\/li>\n
            • Advanced directory filters<\/strong> Filter the members directory by minimum match percentage and specific field values<\/li>\n
            • Unlimited top matches<\/strong> Show an unlimited number of top matches on each member profile<\/li>\n
            • Bar and heart display styles<\/strong> Additional display options with a color customizer and animations<\/li>\n
            • Advanced export and reports<\/strong> CSV and JSON export with date filters, scheduled email reports, and delivery options<\/li>\n<\/ul>\n\n

              \ud83c\udfe2 Business (Coming Soon)<\/h4>\n\n
                \n
              • Match based notifications<\/strong> Automatic email alerts when a high compatibility match is discovered<\/li>\n
              • Message unlock rules<\/strong> Require a minimum match percentage or mutual match before members can message each other<\/li>\n
              • Role to role match rules<\/strong> Control which member types and roles can match using a visual matrix<\/li>\n
              • Match analytics<\/strong> Distribution charts, trend graphs, and per member match history<\/li>\n
              • Automation and webhooks<\/strong> Trigger external actions when match thresholds are reached, with CRM and email platform integration<\/li>\n
              • Geo and distance matching<\/strong> Radius based matching with configurable location weighting<\/li>\n
              • Saved segments<\/strong> Create smart member lists such as \"80% or higher compatibility and active in the last 7 days\"<\/li>\n<\/ul>\n\n\n
                  \n
                1. Go to Plugins > Add New<\/strong> in your WordPress admin<\/li>\n
                2. Search for Match Me for BuddyPress & BuddyBoss<\/strong><\/li>\n
                3. Click Install Now<\/strong>, then Activate<\/strong><\/li>\n
                4. Go to Match Me<\/strong> in the admin menu to configure your fields<\/li>\n<\/ol>\n\n

                  Or upload the match-me-for-buddypress<\/code> folder to your plugins directory and activate.<\/p>\n\n

                  Requires BuddyPress or BuddyBoss Platform to be installed and active.<\/p>\n\n\n

                  \n

                  What platforms are supported?<\/h3><\/dt>\n

                  BuddyPress and BuddyBoss Platform. The plugin auto detects which one is active.<\/p><\/dd>\n

                  What kind of sites can use this?<\/h3><\/dt>\n

                  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.<\/p><\/dd>\n

                  How are matches calculated?<\/h3><\/dt>\n

                  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.<\/p><\/dd>\n

                  What are comparison modes?<\/h3><\/dt>\n

                  Exact<\/strong> scores 100% when values match, 0% otherwise. Best for dropdowns and radio buttons.<\/p>\n\n

                  Overlap<\/strong> uses Jaccard similarity for multi value fields like checkboxes. More shared selections means a higher score.<\/p>\n\n

                  Range<\/strong> scores by how close two numbers are within a configurable tolerance. Best for numeric fields like age or budget.<\/p>\n\n

                  Partial<\/strong> scores by text similarity. Best for free text fields like job titles or interests.<\/p><\/dd>\n

                  What is a hard exclusion?<\/h3><\/dt>\n

                  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.<\/p><\/dd>\n

                  What is the confidence score?<\/h3><\/dt>\n

                  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.<\/p><\/dd>\n

                  Does it scale to large communities?<\/h3><\/dt>\n

                  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.<\/p><\/dd>\n

                  Is match data visible to everyone?<\/h3><\/dt>\n

                  Match scores are visible to all logged in members. Anonymous visitors see nothing.<\/p><\/dd>\n

                  Can I customize the display?<\/h3><\/dt>\n

                  Yes. Choose between circle progress and badge styles, and configure separate colors for high, medium, and low match thresholds in the admin.<\/p><\/dd>\n

                  Is the old shortcode still supported?<\/h3><\/dt>\n

                  Yes. [mp_match_percentage]<\/code> still works and renders the same output as the new [matchme]<\/code> shortcode.<\/p><\/dd>\n

                  Can I request custom development?<\/h3><\/dt>\n

                  Yes. We offer custom feature development for tailored matching algorithms, display styles, and third party integrations. Contact hello@meshpros.com for a quote.<\/p><\/dd>\n

                  Does it phone home or require external services?<\/h3><\/dt>\n

                  No. Everything runs on your server. No external requests, no tracking, no analytics, and no third party dependencies.<\/p><\/dd>\n\n<\/dl>\n\n\n

                  2.0.0<\/h4>\n\n

                  Complete rewrite from the ground up.<\/p>\n\n

                    \n
                  • SQL first matching engine replacing the PHP loop approach<\/li>\n
                  • 4 comparison modes: exact, overlap, range, partial<\/li>\n
                  • Hard exclusion and deal breaker support<\/li>\n
                  • Confidence score alongside match percentage<\/li>\n
                  • Dedicated cache table with auto invalidation<\/li>\n
                  • Lazy loading directory via IntersectionObserver<\/li>\n
                  • Modern admin with tabbed settings and AJAX save<\/li>\n
                  • Field completion nudges for members<\/li>\n
                  • REST API endpoint for developers<\/li>\n
                  • 13 extension hooks for themes and addons<\/li>\n
                  • Full security: nonces, capability checks, sanitized inputs<\/li>\n
                  • SVG circle and badge display styles<\/li>\n
                  • Backward compatible shortcode support<\/li>\n
                  • Clean uninstall with complete table removal<\/li>\n<\/ul>\n\n

                    1.3<\/h4>\n\n

                    Regular update and maintenance.<\/p>","raw_excerpt":"Turn your BuddyPress or BuddyBoss community into a matchmaking platform with weighted compatibility scoring and smart comparison.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/54535","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=54535"}],"author":[{"embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/xpertone"}],"wp:attachment":[{"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=54535"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=54535"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=54535"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=54535"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=54535"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/roh.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=54535"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}