bbPress API

Description

A first attempt for a bbPress API.

WARNING This API will show all forums, topics, replies that bbPress has access to. If you have any extra plugin to restrict bbPress content, please double and triple check that everything works correctly.

Current routes for READING (GET):

  • /wp-json/bbp-api/v1/forums/ (list all forums)
  • /wp-json/bbp-api/v1/forums/id (includes latest topics and subforums)
  • /wp-json/bbp-api/v1/topics/ (latest topics from all forums)
  • /wp-json/bbp-api/v1/topics/id (includes latest replies)
  • /wp-json/bbp-api/v1/replies/id (show one reply)
  • /wp-json/bbp-api/v1/topic-tags/
  • /wp-json/bbp-api/v1/stats/

Parameters for /forums/id and /topics/id (following https://developer.wordpress.org/rest-api/using-the-rest-api/pagination/#pagination-parameters )

  • per_page (records per page)
  • page (page number)

Parameter for /topics/id (following https://developer.wordpress.org/rest-api/using-the-rest-api/linking-and-embedding/#embedding )

  • _embed (showing content for replies)

Current routes for WRITING (POST):

  • /wp-json/bbp-api/v1/forums/id (create a new topic in this forum)
  • /wp-json/bbp-api/v1/topics/id (create a reply to this topic ID)
  • /wp-json/bbp-api/v1/replies/id (create a reply to this reply ID)

Follow development on https://github.com/ePascalC/bbp-API/ !

Many thanks and credits to:

  • Daniel Turton (mistertwo) for the topics and replies POST functions
  • Tony Korologos (@tkserver) for his input and testing with his app

Consider also the following plugins:

  • bbP Toolkit
  • bbP Move Topics

Installation

Option 1:

  1. On your dashboard, go to Plugins > Add new
  2. search for bbPress API
  3. install and activate the plugin

Option 2:

  1. Unzip the contents to the “/wp-content/plugins/” directory.
  2. Activate the plugin through the “Plugins” menu in WordPress.

FAQ

Installation Instructions

Option 1:

  1. On your dashboard, go to Plugins > Add new
  2. search for bbPress API
  3. install and activate the plugin

Option 2:

  1. Unzip the contents to the “/wp-content/plugins/” directory.
  2. Activate the plugin through the “Plugins” menu in WordPress.
Can I make feature requests

Of course ! Just post something on the support tab

I love your tool

Thanks. Please leave a review or donate 1 or 2 EUR/USD for a coffee.

Reviews

Excellent plugin and even better support!

I’m using this API to build an angularjs based bbPress mobile app for iOS and Android. Without it I would not have a project. Pascal is fantastic with his support, response time, and contributions to the WP and bbP community. Thank YOU.

Read all 1 review

Contributors & Developers

“bbPress API” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.14

  • Add reply_to to the replies as a first step in threading (https://github.com/ePascalC/bbp-API/issues/25)
  • Fix total_replies and next page empty (https://github.com/ePascalC/bbp-API/issues/22)
  • Add per_page in the JSON output (https://github.com/ePascalC/bbp-API/issues/23)

1.0.13

  • Fixing https://github.com/ePascalC/bbp-API/issues/22

1.0.12

  • Add previous page (=0) even if there is none
  • Add current page

1.0.11

  • Latest topics pagination
  • Previous page, total pages and total items added for every loop
  • Fix issue where next page would not be specified

1.0.10

  • Latest topics from all visible forums

1.0.9

  • If a forum is a category, do not allow a new topic on POST
  • Fix reply to reply POST issue
  • Return an ARRAY after a POST request with all necessary elements.

1.0.8

  • Fix ID for POST requests

1.0.6

  • Add forum ID and title to topic
  • Add forum ID, title and topic ID,title to reply
  • Add a title to the reply to post and reply to topic

1.0.5

  • Rewriting of all POST actions
  • Validation of reply, topic and forum IDs

1.0.4

  • Adding parameters
  • re-Adding the orginal /forums /topics /replies routes

1.0.3

  • Switching to real forum- topic- and reply-slugs
  • Several fixes

1.0.2

  • Added the subforums to /forums/id
  • Added topic-tags

1.0.1

  • Added the stats route

1.0.0

  • Initial release with basic routes