The members directory is likely the most important page of your site. Woffice will enhance the BuddyPress directory page by adding several features that we will describe in this article.
As of BuddyPress 12.0, BuddyPress no longer uses regular WordPress pages. It instead generates default slugs and URLs. You can customize these from the URLs settings screen within the Settings > BuddyPress section within your WordPress dashboard. Here is some more information about this: BuddyPress URLs settings .
Layouts
Woffice gives you two different layouts for your members directory, you can select it through the Appearance > Woffice Theming Options > BuddyPress Options> Main Options > Members layout field.
The two layouts are:
- Card: Members will be displayed in a grid layout, each member will have his own card with profile picture, name, role, custom fields and BuddyPress buttons such as Private Message.
- Table: Members will be displayed in a table, each member will have his own row with name, role and custom fields.
Woffice also gives you a bunch of options to change several things in the way the members are listed (eg: order or removing specific roles).
Custom fields
In order to create custom fields, you need to be sure that the Extended Profiles BuddyPress component is enabled.
To enable a BuddyPress component, you need to go to Settings > BuddyPress > Components within your WordPress admin.
Once activated (it should be by default), go to Users > Profile fields. On this page you will be able to add as many custom fields as you want.
By default the custom fields are not displayed on the members directory. To enable them, go to Appearance > Woffice Theming Options > BuddyPress Options > Dynamic Fields section.
You will see the list of your custom fields, you can enable them one by one and pick an icon so it looks better.
The data is auto-formatted by Woffice depending on the field type. You customize this rendering process using WordPress filters.
Members Map
To enable the members map, you just need to enable it from the Appearance > Woffice Theming Options > Theme Extensions > Members Map section. That will create a new Location field.
Next, configure your Google Map API connection details first, otherwise it will not work. We have an article for you here. You will then need to add your API key within the Map API field.
If you do not see a map marker after having entered your location in a user profile, please check the following:
- The location is valid, you can enter it on Google Map and get a result
- Test to remove the country
- Be sure that the Google map connection is properly setup, you can check that from the Woffice Members page extension’s settings page.
Extended search
Woffice adds the ability to search the members by custom fields.
You can have it enabled from the: Appearance > Woffice Theming Options > BuddyPress Options > Main Options > Members advanced search field.
To choose which field will be displayed, you can check them one by one in the Appearance > Woffice Theming Options > BuddyPress Options > Dynamic Fields section and enable the option “Display fields in members directory” for the fields you wish to have rendered in advanced search.
