BuddyBoss Integration Addon

The BuddyBoss Integration Addon is a powerful tool designed to bridge the gap between your community and your calendar. It allows you to assign specific events to Social Groups, enabling each group to have its own dedicated event list. Members can submit, manage, and view events directly within their community hub, fostering higher engagement.

Initial Setup

Before you begin, ensure you have the following active on your site:

• BuddyBoss Plugin: The platform must be installed and fully configured.
• MEC: This integration functions alongside the Modern Events Calendar.
• Social Groups: Navigate to WP Dashboard > BuddyBoss > Components and ensure Social Groups is enabled.

Enabling the Integration

To activate the connection, go to WP Dashboard > BuddyBoss > Integrations > MEC.

1. Locate the Enable MEC toggle.
2. Check the box for Allow MEC events on this site.
3. Click Save Settings.

Configuring Global MEC Settings

Once enabled, a suite of options appears under BuddyBoss > Integrations > MEC to control how events interact with your community.

• DateTime Format: Enter the preferred format for how dates and times appear in your BuddyBoss feeds.
• Events Menu: Enabling this adds an Events section to the BuddyBoss menu for easier access.
• Event Groups: This allows the actual creation and display of events within Social Groups.
• Assign Event to Groups: Enables the ability to assign existing events to specific groups.
• Hide Events: Toggle this to hide group-specific events from general calendar “skins” if you want them to remain exclusive.
• Show Public Events: By default, MEC may restrict logged-out users. Enable Show single event if event is in public group for all users to allow public access.
• Enable Filters: This allows MEC events to be included in social filters on your site.
• Hide Button: Use this to hide the “Back to events list” button within the Event Submission Form for a cleaner UI.
• Show Preview: When enabled, users can see a preview of the event directly in the BuddyBoss Activity feed.

Permissions and Submission Roles

To allow users to create events from the front-end, you must define who has permission.

Global Submission Roles

In the MEC Settings, locate Event submission roles. You can select from WordPress roles or BuddyBoss-specific roles: Moderator, Organizer, and Member. You can also use the Event submission exclude users’ field to bar specific individuals from creating events.

Group-Level Permissions

Permissions must also be mirrored within the specific group settings.

1. Navigate to the desired BuddyBoss Group.
2. Go to Manage > Events.
3. Under Group Permissions, choose who can create, edit, and delete MEC events:
   • All group members.
   • Organizers and Moderators only.
   • Organizers only.

Pro Tip: Ensure the roles selected in the global Integrations menu match the permissions set inside individual Groups to avoid “Permission Denied” errors for your users.

Frontend Event Submission (FES) Setup

For members to submit events, you must set up dedicated pages using MEC shortcodes.

1. Create two new WordPress pages: One for the list and one for the submission form.
2. Add Shortcodes:
   • Place [MEC_fes_list] on the “My Events” page.
   • Place [MEC_fes_form] on the “Submit Event” page.
3. Link Pages in MEC: Navigate to MEC > Front-end Submission > Basic and select your newly created pages in the dropdown menus for Events List Page and Add/Edit Events Page.

Managing Group Events

Assigning Events to Groups

There are two ways to associate an event with a group:

From the Group: Go to the Events tab within a group and click Create New. Use the Select Group dropdown in the form to ensure it is assigned correctly.

From the Backend: Go to MEC > All Events > Edit. In the Event Details section, find the BuddyBoss Group and select the desired group.

Pro Tip: In front-end, if you are inside a specific group and click the Create New button, that group will automatically be selected as the assigned group for the event you are trying to create.

Filtering by Group

You can create customized calendars that only show events from specific groups.

• Go to the Shortcods menu.
• Locate the Filter Options > BuddyBoss Groups filter menu.
• Choose to Include By Group or Exclude By Group and select the relevant groups.

Use Cases (When This Addon is Useful)

• Niche Interest Communities: A photography group can host exclusive photo-walk events that only appear to their members.
• Professional Masterminds: Moderators can schedule private webinars or workshops specifically for their premium group tiers.
• Local Sports Leagues: Each team (group) can manage its own practice schedule and game days visible only to team members.

Situations This Addon May Not Be Ideal

• Private/Hidden Group Visibility: Events assigned to Private or Hidden groups will not appear on public calendars, which may be confusing if you want to advertise them to non-members.
• Logged-out Visitors: By default, visitors cannot see group events unless you manually enable the “Show Public Events” setting.
• Strict Role Management: If you have highly customized WordPress roles, you must ensure they have the correct publish_posts and edit_posts capabilities to use the FES form.

Troubleshooting for Beginners

• Events Not Appearing in Groups: Verify that the event is actually assigned to the group in the Event Details section. Also, check if the group is Public; events in private/hidden groups are hidden from general views.
• “Create New” Button Missing: Ensure the user has the correct role (e.g., Member or Moderator) in both the global MEC Settings and the specific Group Permissions.
• FES Form Not Loading: Double-check that you have selected the correct pages in MEC > Front-end Submission > Basic and that the shortcodes are pasted correctly.

---

FAQ