Developer Guide
Free & Pro57 pages in this section.
| Page | What it covers |
|---|---|
| Developer Overview | BuddyNext is a social-community plugin for WordPress that ships its features as REST-backed, theme-overridable modules. This page is the entry point to the developer... |
| Getting Started for Developers | This page orients you to a local BuddyNext checkout: the runtime requirements, where the code lives, the WP-CLI commands you will use during development, and how to... |
| Architecture Overview | This page is the map of how BuddyNext is put together: the five layers, the order they boot in, the canonical shape of a feature module, the DI container, and the... |
| Namespaces and Directory Layout | This page maps BuddyNext's directory tree to its PHP namespaces and lists the container service keys you resolve at runtime. Use it to decide where a new file belongs... |
| Feature Groups and Tiers | BuddyNext is plug-and-play: every Layer 2 feature is a self-contained module that the site owner can turn on or off, and a developer can override by filter. This page... |
| Data Model Overview | BuddyNext stores its social data in dedicated custom tables rather than WordPress posts and postmeta. This page covers the table-naming convention, the Scale-Contract... |
| Schema: Content and Feed | Reference for the bn tables that store posts, comments, reactions, shares, bookmarks, polls, and the hashtag registry. All tables are created in... |
| Schema: Members, Profiles, and the Social Graph | This page documents the bn tables that store member profiles, the extensible profile-field system, member types/labels, and the directional/bilateral social-graph... |
| Schema: Spaces | Reference for the bn tables behind Spaces - the sub-communities that members create and join. Covers the space record, its membership rows, the space-category... |
| Schema: Notifications and Email | Reference for the four tables that back BuddyNext's notification and email subsystem: bnnotifications, bnnotificationprefs, bnemailtemplates, and bnemaillog. All four... |
| Schema: Moderation and Trust | Reference for the tables that back BuddyNext's moderation, trust, and audit subsystem: bnreports, bnmodlog, bnuserstrikes, bnusersuspensions, bnappeals, bninvites,... |
| Schema: Auth Tokens, Search Index, and Webhooks | This page documents the bn tables for verification/security tokens, the unified full-text search index, and the inbound/outbound webhook surface. All tables are... |
| Schema: Pro Tables | This page documents every table created by BuddyNextPro\Core\Installer, grouped by domain, with a column reference for each. It is for developers querying or... |
| REST Contract | The contract every BuddyNext REST route obeys: one versioned namespace, nonce-header authentication, a uniform success/error envelope, a mandatory permission... |
| REST: Feed, Posts, Reactions, and Comments | Reference for the feed, post-lifecycle, poll, share, bookmark, content-warning, reaction, and comment routes under the buddynext/v1 namespace. These are the surfaces... |
| REST: Spaces | Reference for the core Spaces REST routes under buddynext/v1 - space lifecycle (CRUD), membership and roles, join/leave/cancel, pending requests, invites, bans,... |
| REST: Members and Profiles | This page documents the largest REST surface in BuddyNext: the self-service /me/ routes, the per-user /users/{id}/ routes, profile-field and profile-group... |
| REST: Media and Albums | This page documents the member-facing media and album REST surface that powers the profile Media tab: per-member photo and video uploads, owner gallery reads, and the... |
| REST: Social Graph | This page documents the social-graph REST surface in BuddyNext free: following, connections (mutual/two-way relationships), and the block/mute/restrict privacy... |
| REST: Notifications | Reference for the notification routes under the buddynext/v1 namespace: the in-app inbox, unread badge, read-state changes, deletion, and the three preference surfaces... |
| REST: Moderation and Trust | This page documents the moderation REST surface in BuddyNext free: member reports, the moderation queue, appeals, the per-user trust actions (warnings, strikes,... |
| REST: Auth and Account | The authentication and account-management routes under buddynext/v1. They cover front-end login, registration, two-factor verification, email verification, member... |
| REST: Search, Hashtags, and Misc Singletons | Reference for the cross-cutting buddynext/v1 routes that do not belong to a single content domain: unified search (unified, member directory, and as-you-type... |
| REST: Webhooks | BuddyNext exposes two webhook surfaces: an outbound CRUD surface that registers external endpoints the site POSTs lifecycle events to, and a single signed inbound... |
| REST: Pro namespace | The Pro plugin registers its own REST namespace, buddynext-pro/v1, with 63 registered routes (across the controllers under includes/). This page is the route... |
| Hooks Overview | BuddyNext is built to be extended through WordPress actions and filters. This page covers how hooks are named, the split between actions and filters, the difference... |
| Hooks: Template Parts | BuddyNext renders its frontend from small, reusable template parts under templates/parts/. Every part exposes the same three-hook convention so you can inject markup... |
| Hooks: Feed and Content | The action and filter seams for the activity feed and everything members post into it: posts, comments, reactions, polls, shares, bookmarks, and the composer... |
| Hooks: Members, Profiles, and Social Graph | The action and filter seams for user lifecycle, member profiles, profile fields, roles, and the social graph (follow, connection, block). This page is for developers... |
| Hooks: Spaces | The action and filter seams for spaces (groups) and their membership: creation, update, deletion, ownership, joins, requests, invitations, bans, role changes, and... |
| Hooks: Notifications and Email | The action and filter seams for the notification lifecycle and the email system. This page is for developers adding a notification channel (push, SMS), suppressing or... |
| Hooks: Moderation, Trust, and Authentication | The action and filter seams for content moderation (reports, removals, strikes, suspensions, shadow bans, appeals), the automated content-safeguard pipeline, and the... |
| Hooks: Search, Hashtags, Sidebar, and Admin | The action and filter seams for unified search, the hashtag system, the search index, the right-sidebar widgets (greeting, streak, this-week stats, leaderboard,... |
| Sidebar Widget Registry | The surface-scoped registry that renders BuddyNext's right-hand rail. New in 1.0.9, it replaces the hand-rolled templates/partials/sidebar.php with a single renderer:... |
| Pro and Integration Hooks | This page covers the hooks that cross plugin boundaries: the actions and filters BuddyNext Pro emits, the integration seams BuddyNext exposes to companion plugins... |
| Blocks Reference | BuddyNext Free ships 19 server-rendered Gutenberg blocks under the buddynext/ namespace and the buddynext editor category. This page is the contract for each block:... |
| Block Patterns | BuddyNext Free registers 4 pre-built block patterns under the buddynext/ namespace and the buddynext pattern category. Each pattern is a ready-made page layout... |
| Frontend Interactivity and Client-Side Navigation | How BuddyNext renders interactive frontend views: the WordPress Interactivity API store model, in-place client-side navigation, the shared REST client, and the rules... |
| Cron and Async Jobs | This page covers BuddyNext's scheduled jobs and background-work model: the recurring and single-shot cron hooks in Free and Pro, the Action Scheduler fan-out pattern... |
| WP-CLI Commands | BuddyNext registers up to six WP-CLI command namespaces in Free: wp buddynext demo (the demo-data seeder), wp buddynext cert (the functional-certification harness), wp... |
| Roles and Capabilities | How BuddyNext decides who can do what. This page covers the permission model developers extend: the single buddynextcan() entry point, the four resolution layers in... |
| Admin Pages and Settings | The BuddyNext admin surface and the contracts that shape it: the registered wp-admin pages (a single Hub menu with one sub-menu per populated section in free, 18... |
| Extending BuddyNext - a recipe cookbook | Short, runnable recipes for the most common ways to extend BuddyNext from an addon plugin or a theme. Each recipe states the goal, names the seam, and gives a working... |
| The Free/Pro Contract | This page documents how BuddyNext Free and BuddyNext Pro couple: the service-container keys Pro consumes and rebinds, the Free filter and action seams Pro hooks, which... |
| The Companion Install Model | BuddyNext integrates with a set of Wbcom companion plugins (MediaVerse, Jetonomy, Gamification, Career Board, Learnomy, Listora) and can install and activate any of... |
| Integration Bridges (Layer 1) | The bridge layer is how BuddyNext connects to optional companion plugins (Jetonomy forums, WPMediaVerse media + DM, wb-gamification, Career Board) and the host theme.... |
| Gamification Engine Seam | This is the contract a gamification engine implements to plug into BuddyNext. BuddyNext fires raw write-side actions, exposes recipient-perspective engagement signals... |
| Design System: Tokens, Primitives, and the Shell Contract | The contract a theme author needs to restyle, override, or extend BuddyNext's frontend: the three-layer --bn- token cascade, the component primitives, the shell model... |
| Navigation API: add menus and tabs | How to add a menu item or a tab to BuddyNext from an addon or a theme. BuddyNext has four distinct navigation surfaces and they take different APIs: the declarative... |
| Customizing cards and template parts | How to restyle and extend BuddyNext's cards - the member card, the notification row, the post card, and the shared UI primitives - without forking a template. Most... |
| Overriding templates in a child theme | How to override a BuddyNext template from your theme. BuddyNext resolves every template through a three-plan loader that checks your child theme and parent theme... |
| Shortcodes reference | BuddyNext registers a small set of shortcodes that place a full community hub - the activity feed, member directory, spaces, messages, notifications, auth, or the... |
| Coming from BuddyPress / BuddyBoss | A translation guide for developers who already know BuddyPress or BuddyBoss. BuddyNext solves the same problems - profiles, an activity stream, groups, connections,... |
| Extending a BuddyNext Interactivity Store | How another plugin adds to, or replaces, the behavior of a BuddyNext frontend store without editing BuddyNext files or copying a template. This is the JavaScript... |
| Membership Grant Bridges | This page is for connecting a system that already sells memberships - WooCommerce, Paid Memberships Pro, MemberPress, an LMS, your own CRM - to BuddyNext plans. When... |
| WPMediaVerse Surface Ownership Map | Which plugin owns the UI for each surface BuddyNext and WPMediaVerse both touch, and which one owns the data behind it. |
| Member Identity Seams - avatar, name, profile URL, cover | How a plugin (third-party or one of ours) reads a member's community identity from BuddyNext, and the contract BuddyNext follows so you can rely on the result. |