The Group Members Loop / bp_group_has_members()

Codex HomeDeveloper DocsCustom BuddyPress Loops → The Group Members Loop / bp_group_has_members()

The group members loop can be used to display members that have joined a group. It can be used nested inside the bp_has_groups() loop, or on its own with a group_id parameter.

Standard Loop

<?php if ( bp_group_has_members() ) : ?>

  <div id="member-count" class="pag-count">
    <?php bp_group_member_pagination_count() ?>
  </div>

  <div id="member-pagination" class="pagination-links">
    <?php bp_group_member_pagination() ?>
  </div>

  <ul id="member-list" class="item-list">
  <?php while ( bp_group_members() ) : bp_group_the_member(); ?>

    <li>
      <!-- Example template tags you can use -->
      <?php bp_group_member_avatar() ?>
	  <?php bp_group_member_link() ?>
      <?php bp_group_member_joined_since() ?>
	</li>
  <?php endwhile; ?>
  </ul>

<?php else: ?>

  <div id="message" class="info">
    <p>This group has no members.</p>
  </div>

<?php endif;?>

↑ Top ↑

Accepted Parameters

The bp_group_has_members() function will accept a number of parameters that will manipulate the data being returned.

  • group_id required

    The ID of the group to fetch members for. Required when either: outside of the normal BuddyPress groups URL (/group/i-love-bp/members/) or not nested within a bp_has_groups() loop.

    • Default value: false
  • per_page optional

    The number of members to display on a page before they are paginated to the next page.

    • Default value: 10
  • max optional

    The total number of members to return.

    • Default value: false (no limit)
  • exclude_admins_mods optional

    If you set this to true, only users with normal access (not a group administrator or moderator) will be returned in the members list.

    • Default value: true
  • exclude_banned optional

    If you set this to true, any users that are banned from the group will not be returned in the members list.

    • Default value: true

↑ Top ↑

Advanced Usage

Fetch all the members from the group with ID 15 and show 10 per page.

<?php if ( bp_group_has_members( 'group_id=15&per_page=10' ) ) : ?>