BuddyPress

BuddyPress is composed of several core functional modules that provide social networking capabilities to a website. These components include:

• BuddyPress Core: The foundational engine of the plugin.
• Community Members: Management and display of site users.
• Extended Profiles: Ability for users to add custom information to their profiles.
• Friend Connections: Systems for users to connect and manage social relationships.
• Account Settings: User-facing controls for managing personal account details.
• User Groups: Tools for creating and managing community interest groups.
• Activity Streams: Real-time feeds of user actions and site updates.
• Private Messages: Direct communication between users.
• Notifications: Alerts for user interactions and system updates.
• Site Tracking: Monitoring of user activity and engagement.

BuddyPress provides several entry points for advanced customization to modify the user experience, appearance, and core behavior. You can customize the following areas:

• Templates: Override default BuddyPress template files to change the HTML structure of components.
• Styles: Modify the visual presentation using CSS.
• Functionalities: Extend or alter core logic and features.
• Texts: Translate or change the strings displayed throughout the interface.
• BP Base URL: Change the URL structure used by BuddyPress (e.g., changing /buddypress/ to something else).

The BuddyPress User Handbook is the central documentation hub for users and developers. It is organized into several key sections to help you navigate the platform:

• Getting Started: Initial setup and basic usage.
• Frequently Asked Questions (FAQ): Common queries and troubleshooting.
• BuddyPress Components: Detailed information on the core features and modules of the platform.
• BuddyPress Administration: Guides for managing the BuddyPress installation and user settings.
• Advanced Customizations: Instructions for extending BuddyPress functionality through code or advanced configuration.

The BuddyPress REST API v2 (introduced in BuddyPress 15.0.0) provides endpoints for interacting with BuddyPress community action data types via JSON. It allows developers to create, read, and update user-generated content from client-side JavaScript or external applications.

Note: The v1 API is deprecated. If you require v1, you must use the archived BuddyPress RESTful API plugin, but upgrading to v2 is strongly advised.

Use the BP REST API to:

• Build Single Page Applications (SPAs) on top of BuddyPress.
• Create Template Packs for new front-end experiences.
• Develop interactive community features or Gutenberg blocks.
• Replace the admin-ajax API to improve performance and structure data flow.

BuddyPress administration is managed directly within the WordPress Dashboard. BuddyPress extends the standard WordPress interface by adding custom top-level menus and submenus. These menus allow you to customize community features, moderate member-generated content, and manage site-wide community settings.

Key administration areas available in the WordPress Dashboard include:

• Settings: Configure core BuddyPress functionality.
• Tools: Access maintenance and management utilities.
• Navigation menus: Manage how users navigate the community areas.
• Users: Manage member profiles and user-related data.
• Activity: Moderate and view the site's activity stream.
• Groups: Manage community groups and group settings.
• Emails: Configure community-related email notifications.
• Site Health Screen: Monitor the technical health of the BuddyPress installation.

BuddyPress provides a suite of social networking components including:

• Activity Streams: Global, personal, and group streams with threaded commenting, @mentions, and RSS/email support.
• Extended Profiles: Customizable profile fields for users to describe themselves.
• User Settings: Controls for users to manage their own profile and notification preferences.
• Extensible Groups: Public, private, or hidden groups that can be extended via the group extension API.
• Friend Connections: Tools for users to connect and track activity from specific members.
• Private Messaging: One-on-one and group messaging capabilities.
• Site Tracking: Integration with activity streams to track posts and comments.
• Notifications: Toolbar and email notifications to keep members updated on activity.

BuddyPress administration is divided into three primary management areas:

1. Components: Manage the various functional modules of BuddyPress (e.g., Activity Streams, Groups, Members).
2. URLs: Configure the URL structures and permalink settings for BuddyPress features.
3. Options: Configure general BuddyPress behavior and global settings.

BuddyPress provides a dedicated API for extending the functionality of Groups. Developers can use this to add new features, modify existing group behaviors, or integrate third-party services. To extend groups, you should consult the following two primary resources:

1. Database Schema: Understand the underlying tables used to store group data and relationships.
2. Group Extension API: Use the provided API to programmatically interact with and extend group functionality.

Refer to the specific documentation for db-schema.md and extension.md within the developer documentation directory to implement these extensions.

BuddyPress provides a dedicated administration menu within your WordPress Dashboard. This menu allows administrators to manage all community groups created on the site.

For detailed management tasks, refer to the specific documentation for:

• Groups: General group management.
• Group types: Configuration and management of different group classifications.

The BuddyPress Add-ons Developer Handbook provides several specialized technical areas for developers to extend the platform:

• BuddyPress Functions: Documentation on the core functions available for use within your add-on.
• BuddyPress Components: Information regarding the various components that make up the BuddyPress ecosystem.
• BuddyPress Theme Compatibility: Guidance on ensuring your add-on works correctly with different BuddyPress themes.
• BuddyPress Execution Contexts: Understanding the different environments and contexts in which BuddyPress code runs.
• BuddyPress REST API (v2): Documentation for interacting with BuddyPress via the version 2 REST API.