Skip to main content

BuddyPress Setup

When BuddyPress is active, Events Manager joins in without any setup. Members get an Events section on their profile where they can see and manage their events and bookings, group admins can attach events to their groups, and bookings and new events show up in the activity stream.

There is nothing to switch on and no BuddyPress settings screen in Events Manager. What each member sees is decided by settings you already have: their role's capabilities, and whether bookings and locations are enabled.

The Events section on member profiles​

Every member profile gains an Events tab, with a count of that member's upcoming events. The same links appear under the member's account menu in the toolbar.

Sub-pageWho sees itWhat it shows
My ProfileEveryone, including other members and visitors who can view the profileThe upcoming events the member is running, and the events they are attending.
Events I'm AttendingThe member only. Needs bookings to be enabledThe member's own bookings, the same list as the My Bookings page, where they can cancel if you allow it.
My EventsThe member only. Needs the edit_events capabilityThe member's events, with links to add, edit and delete them using the front-end event form.
My LocationsThe member only. Needs edit_locations, and locations to be enabledThe member's locations, with the front-end location form.
My Event BookingsThe member only. Needs manage_bookings, and bookings to be enabledBookings made for the member's events, with the tools to approve, reject and edit them.

On a default install, Authors and above have all three capabilities and Subscribers have none, so a Subscriber sees only My Profile and Events I'm Attending. To let ordinary members submit events, give their role edit_events (and publish_events if their events should go live without approval) in Events then Settings then General then User Capabilities.

Events created here are ordinary events. Once published they appear on your events page and in every list and calendar.

Links such as "edit this event" and "manage bookings" on the front end point to the member's BuddyPress profile pages. The exception is when you have assigned your own front-end pages under Other Pages in Events then Settings then Pages. An edit events, edit locations or manage bookings page set there is used in place of the profile page for that kind of link.

Group events​

If the BuddyPress User Groups component is on, events can belong to a group.

Attach an event to a group​

  1. Create or edit an event, in wp-admin or with the front-end form.

  2. Find Group Ownership (a box in the sidebar of the wp-admin editor) and choose the group. You can pick from the groups you are an admin of. Site administrators on a network can pick any group.

  3. Save the event. To detach it later, choose Not a Group Event and save again.

The box says No groups defined yet. if you don't administer any group.

What a group event does​

  • The group's page gets an Events tab listing its events, with a count.
  • Each member's Groups menu gets an Events item listing the events of all their groups.
  • Other admins of the group can edit the event and manage its bookings, provided their role has the capability for that action. Being a group admin doesn't replace the capability.
  • If the group is private or hidden, the event is made private as well. Only members of the group can open it or see it in lists, and everyone else gets a "not found" page.

List group events anywhere​

With groups active, event lists accept a group search attribute:

ValueShows
A group ID, such as group="12"Events of that group.
group="my"Events of every group the logged-in member belongs to.
group="this"Events of the group whose page is being viewed.
[events_list group="my" limit="5"]

Activity stream​

Events Manager adds entries to the BuddyPress activity stream when the Activity Streams component is on:

WhenEntry
An event is published for the first timeName added the event Event, with the group named if it is a group event. Group events are recorded in the group's own activity too.
A booking is confirmedName is attending Event.
A booking is cancelled or rejectedName will not be attending Event anymore.

The stream's filter menu gains New Event and Bookings.

Notifications​

With the Notifications component on, the owner of an event gets a BuddyPress notification when someone books it, when a booking is confirmed and when a booking is cancelled. Each links to My Event Bookings. Bookings made without a user account, in No-User Booking Mode, don't create notifications.

These are in addition to the booking emails, which are sent as usual.

Change the layouts​

The profile and group screens are template files, so you can override them from your theme. See Using template files. The relevant files, relative to the plugin's templates folder:

FileScreen
buddypress/profile.phpMy Profile
buddypress/my-events.phpMy Events
buddypress/my-locations.phpMy Locations
buddypress/my-bookings.phpMy Event Bookings
buddypress/group-events.phpA group's Events tab
buddypress/my-group-events.phpEvents under a member's Groups menu
templates/my-bookings.phpEvents I'm Attending
forms/event-editor.php, forms/location-editor.phpThe add and edit forms

Troubleshooting​

Members don't see My Events​

Their role lacks edit_events. Tick it for the role in the capability settings.

The Events tab is missing from profiles​

Check that both plugins are active. On a multisite network, the tab's contents follow the member's capabilities on the site where BuddyPress runs, so set capabilities there.

An event in a private group is visible to everyone​

The event is only made private when it is saved as published with a group selected, by someone who is a member of that group. Open the event, check Group Ownership, and save it again.