Sign In Try For Free
View Categories

Directorist – BuddyPress Integration

1. Overview #

BuddyPress is a popular social networking plugin that adds community features to a WordPress site. The Directorist – BuddyPress Integration extension connects your directory to a BuddyPress-powered community, so members can view, add, and manage listings without leaving their BuddyPress profile.

With this extension active, members can:

  • View their listings and favorited listings from their BuddyPress profile
  • Add a new listing directly from their profile
  • Favorite listings from the archive or single listing page
  • Assign listings to a BuddyPress group, visible only to that group’s members
  • Share a listing, or a “new listing” activity update, to the BuddyPress activity feed
  • Message a listing owner using BuddyPress Private Messaging, from the listing card or the single listing page
  • Have Directorist’s login and registration pages redirect to BuddyPress’s own login and registration pages

Prerequisites #

  • Directorist (core plugin) installed and active
  • BuddyPress plugin installed and active
  • A BuddyPress-compatible theme is recommended, though not required

2. Installation and Configuration #

Step 1 – Install the extension #

  1. Make sure Directorist and BuddyPress are both installed and active before you install this extension.
  2. Go to WP Admin → Directorist → Themes and Extensions, and log in with your Directorist account to install and activate Directorist – BuddyPress Integration.

Step 2 – Configure the extension #

Path: WP Admin → Directorist → Directorist Settings → Extension Settings → BuddyPress

The settings panel is split into three sections: User Profile, Group Directory, and Pages.

User Profile #

  1. Turn on Add Listing Sharing to let users share an activity update on the timeline or activity feed whenever they create a new listing.
  1. Turn on Allow Listing Sharing to add a “share to timeline” option to the Single Listing page’s Share menu, letting any visitor share that listing to their own timeline or activity feed.
  1. Set Share Button Text to change the label shown for the sharing option (defaults to “On Timeline”).
  2. Set My Listings Default View to Grid View, List View, or Map View to control how listings are displayed by default on the member’s My Listings and Favorites tabs.
  3. Set Listings Per Page to control how many listings load at once on those tabs. Keep this number low (3–12) for faster page loads.
  4. Click Save.

Group Directory #

  1. Turn on Enable Group Directory Listings to let group admins attach directory listings to their BuddyPress group. Listings assigned to one group are only visible to members of that group.
  2. Set Listings Default View (Grid View, List View, or Map View) for how listings display inside a group’s Listings tab.
  3. Set Listings Per Page for how many listings load at once inside a group’s Listings tab.
  4. Click Save.

Group listings only work if the Groups component is active in BuddyPress. To check this, go to WP Admin → Settings → BuddyPress → Components and make sure User Groups is turned on.

See Add Listings to Groups for the full walkthrough of assigning listings to a group.

Pages #

  1. Turn on Login Redirect to send visitors to the BuddyPress login page instead of Directorist’s own login page.
  2. Turn on Registration Redirect to send visitors to the BuddyPress registration page instead of Directorist’s own registration page.
  3. Click Save.

3. Add Listings #

Once the extension is active, a Listings tab is added to every member’s BuddyPress profile, and a matching Listings item is added under My Account in the WP Admin Toolbar.

Step 1 – Open the Add Listing tab #

On your own BuddyPress profile, click the Listings tab, then click the Add Listing sub-tab. This sub-tab is only visible when you’re viewing your own profile.

Alternatively, from the WP Admin Toolbar, go to My Account → Listings → Add Listing.

Step 2 – Fill in and submit the listing #

Fill in the listing form and submit it the same way you would from Directorist’s regular front-end submission form. The fields shown here come from your directory type’s Add Listing form, configured through the Directorist Builder.

To change which fields appear on this form, go to Directorist → Directory Builder → Add Listing Form for the relevant directory type.

4. Add Listings to Groups #

Assigning listings to a BuddyPress group makes those listings visible only to that group’s members.

Prerequisites #

  • The Groups component must be active. Go to WP Admin → Settings → BuddyPress → Components and turn on User Groups.
  • Enable Group Directory Listings must be turned on under Directorist → Directorist Settings → Extension Settings → BuddyPress → Group Directory. See Installation and Configuration.

Step 1 – Turn on listings while creating a new group #

While creating a new BuddyPress group, on the group creation step for listings, check Yes, I want this group to have a directory listings.

Step 2 – Turn on and assign listings for an existing group #

  1. Go to the group’s page and click Manage.
  2. Open the Listings panel (labeled Group Listings Settings).
  3. Check Yes, I want this group to have a directory listings if it isn’t already checked.
  4. Under Connected Listings, search for listings by name and select the ones you want to assign to this group. You can add as many as you want.
  5. Click Save Settings.

Viewing the result #

Group members can see all assigned listings on the group’s Listings tab, which only appears once listings are enabled for that group.

5. How to Use BuddyPress Private Messaging in Directorist #

This lets a visitor message a listing owner directly through BuddyPress’s Private Messaging, from either the listing card on the archive page or the single listing page.

Prerequisites #

The Private Messaging component must be active. Go to WP Admin → Settings → BuddyPress → Components and turn on Private Messaging.

Step 1 – Add the message button to listing cards (All Listings Page) #

  1. Go to Directorist Listings → Builder → All Listings Page for the relevant directory type.
  2. In the card layout editor, drag the BuddyPress Message widget into the card’s footer.
  3. Click on the widget to open its settings, and set the Button Text (defaults to “Send Message”) and, optionally, an Icon.
  4. Click Update to save the layout.

This adds a message button to every listing card.

Step 2 – Add the message button to the single listing page #

  1. Go to Directorist Listings → Builder → Single Listing Page for the relevant directory type.
  2. Under Other Fields, drag the BuddyPress Message widget into the Active Fields area.
  3. Click on the widget to open its settings, and set the Button Text and, optionally, an Icon.
  4. Click Update to save the layout.

Viewing the result #

After adding the widget, a message button appears on the single listing page. Clicking it takes the visitor to the BuddyPress messaging interface, addressed to the listing owner.

The listing owner receives the message in their BuddyPress inbox as usual.

What are your Feelings