PHPackages                             automattic/buddypress-auto-group-join-request - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. automattic/buddypress-auto-group-join-request

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

automattic/buddypress-auto-group-join-request
=============================================

Automatically sends join requests to BuddyPress groups based on user profile field values.

1.0.0(1y ago)2381GPL-2.0-or-laterPHPPHP >=8.2CI passing

Since May 12Pushed 1mo ago4 watchersCompare

[ Source](https://github.com/Automattic/BuddyPress-Auto-Group-Join-Request)[ Packagist](https://packagist.org/packages/automattic/buddypress-auto-group-join-request)[ RSS](/packages/automattic-buddypress-auto-group-join-request/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (7)Used By (0)

BuddyPress Auto Group Join Request
==================================

[](#buddypress-auto-group-join-request)

**Contributors:** garyj
**Tags:** BuddyPress, BuddyBoss, groups, automatic join requests, profile fields
**Requires at least:** 6.6
**Tested up to:** 6.9
**Stable tag:** 1.0.0
**License:** GPLv2 or later
**License URI:**

Automatically sends join requests to BuddyPress groups based on any profile field value.

Description
-----------

[](#description)

This plugin automatically sends join requests to BuddyPress groups when users have specific profile field values. It's particularly useful for:

- Automatically adding users to relevant groups based on any profile field (name, location, interests, profile type, etc.)
- Streamlining the group membership process
- Ensuring users are connected to the right communities based on their profile information

The plugin integrates with BuddyPress/BuddyBoss's profile fields and group management to provide a seamless user experience.

Features
--------

[](#features)

- Automatic group join requests based on any profile field value
- Configurable profile-field-to-group mapping
- Handles multiple group configurations
- Prevents duplicate requests
- Logs all actions for troubleshooting

Installation
------------

[](#installation)

1. Upload the `buddypress-auto-group-join-request` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure the profile-field-to-group mapping (see Configuration section below)

Configuration
-------------

[](#configuration)

The plugin uses a simple array-based configuration for mapping profile field values to groups. Add the following code to your theme's `functions.php` file or in a custom plugin:

```
add_filter(
    'bp_auto_group_join_config',
    function( $config ) {
        // Example 1: Add users with profile type "Partner" to group 2
        $config['partners'] = array(
            'profile_field_name' => 'Profile Type',
            'profile_field_value' => 47,
            'group_id' => 2,
        );

        // Example 2: Add users named "Dave" to group 3
        $config['daves'] = array(
            'profile_field_name' => 'Name',
            'profile_field_value' => 'Dave',
            'group_id' => 3,
        );

        return $config;
    }
);
```

### Finding the Required Values

[](#finding-the-required-values)

1. **Profile Field Name**:

    - Go to BuddyPress → Settings → Profile Fields
    - Find the field you want to use
    - The name is exactly as shown in the admin interface
2. **Profile Field Value**:

    - In the same Profile Fields section
    - For dropdown/radio/checkbox fields, the value is the ID of the option
    - For text fields, use the exact text value
    - For name fields, use the exact name as it appears in the profile
3. **Group ID**:

    - Go to the group's page in wp-admin
    - Look at the URL - it will contain something like `group_id=123`
    - The number is your group ID

You can add multiple configurations by adding more entries to the `$config` array:

```
$config['partner'] = array(
    'profile_field_name' => 'Profile Type',
    'profile_field_value' => 47,
    'group_id' => 2,
);
$config['student'] = array(
    'profile_field_name' => 'Profile Type',
    'profile_field_value' => 48,
    'group_id' => 3,
);
$config['daves'] = array(
    'profile_field_name' => 'Name',
    'profile_field_value' => 'Dave',
    'group_id' => 4,
);
```

Requirements
------------

[](#requirements)

- WordPress 6.6 or higher
- BuddyPress or BuddyBoss Platform
- Member types and profile fields configured in BuddyPress/BuddyBoss
- Groups created in BuddyPress/BuddyBoss

Troubleshooting
---------------

[](#troubleshooting)

The plugin logs all actions to the WordPress error log. If something isn't working as expected:

1. Check your WordPress error log
2. Verify the profile field name matches exactly
3. Confirm the profile field value is correct
4. Ensure the group ID exists
5. Check that the user isn't already a member or has a pending request

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for a complete list of changes.

License
-------

[](#license)

This plugin is licensed under the GPLv2 or later. See [LICENSE](LICENSE) for details.

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance72

Regular maintenance activity

Popularity15

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 92.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

365d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ba7751eebec0f74a4963e9a062f49e58222b97872bf193d95f0505f3df321d09?d=identicon)[GaryJones](/maintainers/GaryJones)

![](https://www.gravatar.com/avatar/7c5869ecbb8e0eac7e8b8e0f3cf7bdd8d5fcdc4abc10a72281872c53f8639d44?d=identicon)[automattic](/maintainers/automattic)

---

Top Contributors

[![GaryJones](https://avatars.githubusercontent.com/u/88371?v=4)](https://github.com/GaryJones "GaryJones (26 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")

---

Tags

buddypress-grbuddypress-pluginwordpresswordpress-pluginswpvip-plugin

### Embed Badge

![Health badge](/badges/automattic-buddypress-auto-group-join-request/health.svg)

```
[![Health](https://phpackages.com/badges/automattic-buddypress-auto-group-join-request/health.svg)](https://phpackages.com/packages/automattic-buddypress-auto-group-join-request)
```

###  Alternatives

[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)[rainlab/builder-plugin

Builder plugin for October CMS

17147.2k1](/packages/rainlab-builder-plugin)[pfefferle/wordpress-activitypub

The ActivityPub protocol is a decentralized social networking protocol based upon the ActivityStreams 2.0 data format.

5671.4k1](/packages/pfefferle-wordpress-activitypub)[civicrm/civicrm-drupal-8

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

18238.1k2](/packages/civicrm-civicrm-drupal-8)[mediawiki/semantic-glossary

A terminology markup extension with a Semantic MediaWiki back-end

1352.4k](/packages/mediawiki-semantic-glossary)[humanmade/lottie-lite

A lightweight Lottie Animations Extension for WordPress

374.3k](/packages/humanmade-lottie-lite)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)