mirror of
https://github.com/WenPai-org/bbpress-api-server.git
synced 2025-08-18 06:11:34 +08:00
1263 lines
43 KiB
PHP
1263 lines
43 KiB
PHP
|
<?php
|
||
|
|
/**
|
||
|
|
* Plugin Name: bbPress API Server
|
||
|
|
* Plugin URI: https://cyberforums.com/document/bbpress-api-server
|
||
|
|
* Description: Provides comprehensive API endpoints for bbPress forums, topics, and replies
|
||
|
|
* Version: 1.0.0
|
||
|
|
* Author: Cyberforums
|
||
|
|
* Author URI: https://cyberforums.com
|
||
|
|
* Text Domain: bbpress-api-server
|
||
|
|
* License: GPL-2.0+
|
||
|
|
* License URI: http://www.gnu.org/licenses/gpl-2.0.txt
|
||
|
|
*/
|
||
|
|
|
||
|
|
// Exit if accessed directly
|
||
|
|
if (!defined('ABSPATH')) {
|
||
|
|
exit;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Define plugin constants
|
||
|
|
define('BBPAS_VERSION', '1.0.0');
|
||
|
|
define('BBPAS_PLUGIN_DIR', plugin_dir_path(__FILE__));
|
||
|
|
define('BBPAS_PLUGIN_URL', plugin_dir_url(__FILE__));
|
||
|
|
|
||
|
|
// API namespace and version
|
||
|
|
define('BBPAS_API_NAMESPACE', 'bbpas/v1');
|
||
|
|
|
||
|
|
// Check if bbPress is active
|
||
|
|
function bbpas_check_required_plugins() {
|
||
|
|
if (!class_exists('bbPress')) {
|
||
|
|
add_action('admin_notices', 'bbpas_admin_notice');
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
return true;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Admin notice if required plugins are not active
|
||
|
|
function bbpas_admin_notice() {
|
||
|
|
?>
|
||
|
|
<div class="notice notice-error">
|
||
|
|
<p><?php _e('bbPress API Server requires bbPress to be installed and activated.', 'bbpress-api-server'); ?></p>
|
||
|
|
</div>
|
||
|
|
<?php
|
||
|
|
}
|
||
|
|
|
||
|
|
// Register REST API routes
|
||
|
|
function bbpas_register_routes() {
|
||
|
|
// === Test endpoint ===
|
||
|
|
register_rest_route(BBPAS_API_NAMESPACE, '/test', array(
|
||
|
|
'methods' => 'GET',
|
||
|
|
'callback' => 'bbpas_test_connection',
|
||
|
|
'permission_callback' => '__return_true',
|
||
|
|
));
|
||
|
|
|
||
|
|
// === Forum endpoints ===
|
||
|
|
// Get all forums
|
||
|
|
register_rest_route(BBPAS_API_NAMESPACE, '/forums', array(
|
||
|
|
'methods' => 'GET',
|
||
|
|
'callback' => 'bbpas_get_forums',
|
||
|
|
'permission_callback' => '__return_true',
|
||
|
|
'args' => array(
|
||
|
|
'parent' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param) || $param === '0';
|
||
|
|
},
|
||
|
|
'default' => null,
|
||
|
|
'description' => 'Filter forums by parent ID. Use 0 for root forums.',
|
||
|
|
),
|
||
|
|
'per_page' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param) && ($param == -1 || ($param > 0 && $param <= 100));
|
||
|
|
},
|
||
|
|
'default' => -1,
|
||
|
|
'description' => 'Number of forums to return per page. Use -1 to return all.',
|
||
|
|
),
|
||
|
|
'page' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param) && $param > 0;
|
||
|
|
},
|
||
|
|
'default' => 1,
|
||
|
|
'description' => 'Current page of forum results.',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
));
|
||
|
|
|
||
|
|
// Get single forum details
|
||
|
|
register_rest_route(BBPAS_API_NAMESPACE, '/forum/(?P<id>\d+)', array(
|
||
|
|
'methods' => 'GET',
|
||
|
|
'callback' => 'bbpas_get_forum_details',
|
||
|
|
'permission_callback' => '__return_true',
|
||
|
|
'args' => array(
|
||
|
|
'id' => array(
|
||
|
|
'required' => true,
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param);
|
||
|
|
},
|
||
|
|
'description' => 'Forum ID',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
));
|
||
|
|
|
||
|
|
// === Topic endpoints ===
|
||
|
|
// Get topics (with optional forum filter)
|
||
|
|
register_rest_route(BBPAS_API_NAMESPACE, '/topics', array(
|
||
|
|
'methods' => 'GET',
|
||
|
|
'callback' => 'bbpas_get_topics',
|
||
|
|
'permission_callback' => '__return_true',
|
||
|
|
'args' => array(
|
||
|
|
'forum_id' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param);
|
||
|
|
},
|
||
|
|
'description' => 'Filter topics by forum ID',
|
||
|
|
),
|
||
|
|
'per_page' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param) && $param > 0 && $param <= 100;
|
||
|
|
},
|
||
|
|
'default' => 10,
|
||
|
|
'description' => 'Number of topics to return per page',
|
||
|
|
),
|
||
|
|
'page' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param) && $param > 0;
|
||
|
|
},
|
||
|
|
'default' => 1,
|
||
|
|
'description' => 'Current page of topic results',
|
||
|
|
),
|
||
|
|
'orderby' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return in_array($param, ['date', 'title', 'activity', 'popularity']);
|
||
|
|
},
|
||
|
|
'default' => 'activity',
|
||
|
|
'description' => 'Order topics by parameter: date, title, activity, popularity',
|
||
|
|
),
|
||
|
|
'order' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return in_array(strtoupper($param), ['ASC', 'DESC']);
|
||
|
|
},
|
||
|
|
'default' => 'DESC',
|
||
|
|
'description' => 'Order direction: ASC or DESC',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
));
|
||
|
|
|
||
|
|
// Get single topic details
|
||
|
|
register_rest_route(BBPAS_API_NAMESPACE, '/topic/(?P<id>\d+)', array(
|
||
|
|
'methods' => 'GET',
|
||
|
|
'callback' => 'bbpas_get_topic_details',
|
||
|
|
'permission_callback' => '__return_true',
|
||
|
|
'args' => array(
|
||
|
|
'id' => array(
|
||
|
|
'required' => true,
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param);
|
||
|
|
},
|
||
|
|
'description' => 'Topic ID',
|
||
|
|
),
|
||
|
|
'with_replies' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return rest_is_boolean($param);
|
||
|
|
},
|
||
|
|
'default' => false,
|
||
|
|
'description' => 'Include topic replies',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
));
|
||
|
|
|
||
|
|
// === Reply endpoints ===
|
||
|
|
// Get replies for a topic
|
||
|
|
register_rest_route(BBPAS_API_NAMESPACE, '/replies', array(
|
||
|
|
'methods' => 'GET',
|
||
|
|
'callback' => 'bbpas_get_replies',
|
||
|
|
'permission_callback' => '__return_true',
|
||
|
|
'args' => array(
|
||
|
|
'topic_id' => array(
|
||
|
|
'required' => true,
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param);
|
||
|
|
},
|
||
|
|
'description' => 'Topic ID to get replies from',
|
||
|
|
),
|
||
|
|
'per_page' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param) && $param > 0 && $param <= 100;
|
||
|
|
},
|
||
|
|
'default' => 20,
|
||
|
|
'description' => 'Number of replies to return per page',
|
||
|
|
),
|
||
|
|
'page' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param) && $param > 0;
|
||
|
|
},
|
||
|
|
'default' => 1,
|
||
|
|
'description' => 'Current page of reply results',
|
||
|
|
),
|
||
|
|
'order' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return in_array(strtoupper($param), ['ASC', 'DESC']);
|
||
|
|
},
|
||
|
|
'default' => 'ASC',
|
||
|
|
'description' => 'Order direction: ASC or DESC',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
));
|
||
|
|
|
||
|
|
// Get single reply details
|
||
|
|
register_rest_route(BBPAS_API_NAMESPACE, '/reply/(?P<id>\d+)', array(
|
||
|
|
'methods' => 'GET',
|
||
|
|
'callback' => 'bbpas_get_reply_details',
|
||
|
|
'permission_callback' => '__return_true',
|
||
|
|
'args' => array(
|
||
|
|
'id' => array(
|
||
|
|
'required' => true,
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param);
|
||
|
|
},
|
||
|
|
'description' => 'Reply ID',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
));
|
||
|
|
|
||
|
|
// === User endpoints ===
|
||
|
|
// Get user forum activity
|
||
|
|
register_rest_route(BBPAS_API_NAMESPACE, '/user/(?P<id>\d+)/activity', array(
|
||
|
|
'methods' => 'GET',
|
||
|
|
'callback' => 'bbpas_get_user_activity',
|
||
|
|
'permission_callback' => '__return_true',
|
||
|
|
'args' => array(
|
||
|
|
'id' => array(
|
||
|
|
'required' => true,
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param);
|
||
|
|
},
|
||
|
|
'description' => 'User ID',
|
||
|
|
),
|
||
|
|
'type' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return in_array($param, ['topics', 'replies', 'all']);
|
||
|
|
},
|
||
|
|
'default' => 'all',
|
||
|
|
'description' => 'Activity type: topics, replies, or all',
|
||
|
|
),
|
||
|
|
'per_page' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param) && $param > 0 && $param <= 50;
|
||
|
|
},
|
||
|
|
'default' => 10,
|
||
|
|
'description' => 'Number of activities to return',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
));
|
||
|
|
|
||
|
|
// === Search endpoint ===
|
||
|
|
register_rest_route(BBPAS_API_NAMESPACE, '/search', array(
|
||
|
|
'methods' => 'GET',
|
||
|
|
'callback' => 'bbpas_search',
|
||
|
|
'permission_callback' => '__return_true',
|
||
|
|
'args' => array(
|
||
|
|
'query' => array(
|
||
|
|
'required' => true,
|
||
|
|
'description' => 'Search query',
|
||
|
|
),
|
||
|
|
'type' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return in_array($param, ['forum', 'topic', 'reply', 'all']);
|
||
|
|
},
|
||
|
|
'default' => 'all',
|
||
|
|
'description' => 'Type of content to search: forum, topic, reply, all',
|
||
|
|
),
|
||
|
|
'per_page' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param) && $param > 0 && $param <= 50;
|
||
|
|
},
|
||
|
|
'default' => 10,
|
||
|
|
'description' => 'Number of results to return',
|
||
|
|
),
|
||
|
|
'page' => array(
|
||
|
|
'validate_callback' => function($param) {
|
||
|
|
return is_numeric($param) && $param > 0;
|
||
|
|
},
|
||
|
|
'default' => 1,
|
||
|
|
'description' => 'Current page of search results',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
));
|
||
|
|
|
||
|
|
// === Stats endpoint ===
|
||
|
|
register_rest_route(BBPAS_API_NAMESPACE, '/stats', array(
|
||
|
|
'methods' => 'GET',
|
||
|
|
'callback' => 'bbpas_get_stats',
|
||
|
|
'permission_callback' => '__return_true',
|
||
|
|
));
|
||
|
|
|
||
|
|
}
|
||
|
|
|
||
|
|
// === Test endpoint function ===
|
||
|
|
function bbpas_test_connection() {
|
||
|
|
if (!function_exists('bbp_get_forum_post_type')) {
|
||
|
|
return new WP_Error('bbpress_not_active', __('bbPress is not active', 'bbpress-api-server'), array('status' => 500));
|
||
|
|
}
|
||
|
|
|
||
|
|
return array(
|
||
|
|
'success' => true,
|
||
|
|
'message' => __('Connection successful', 'bbpress-api-server'),
|
||
|
|
'version' => BBPAS_VERSION,
|
||
|
|
'bbpress_version' => bbp_get_version(),
|
||
|
|
'api_namespace' => BBPAS_API_NAMESPACE,
|
||
|
|
);
|
||
|
|
}
|
||
|
|
|
||
|
|
// === Forum endpoint functions ===
|
||
|
|
|
||
|
|
function bbpas_get_forums($request) {
|
||
|
|
if (!function_exists('bbp_get_forum_post_type')) {
|
||
|
|
return new WP_Error('bbpress_not_active', __('bbPress is not active', 'bbpress-api-server'), array('status' => 500));
|
||
|
|
}
|
||
|
|
|
||
|
|
$parent = $request->get_param('parent');
|
||
|
|
$per_page = $request->get_param('per_page');
|
||
|
|
$page = $request->get_param('page');
|
||
|
|
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_forum_post_type(),
|
||
|
|
'post_status' => 'publish',
|
||
|
|
'posts_per_page' => $per_page,
|
||
|
|
'paged' => $page,
|
||
|
|
'orderby' => 'menu_order',
|
||
|
|
'order' => 'ASC',
|
||
|
|
);
|
||
|
|
|
||
|
|
// If parent parameter is set, filter by parent forum
|
||
|
|
if ($parent !== null) {
|
||
|
|
$args['post_parent'] = $parent;
|
||
|
|
}
|
||
|
|
|
||
|
|
$forums_query = new WP_Query($args);
|
||
|
|
$forums = array();
|
||
|
|
|
||
|
|
if ($forums_query->have_posts()) {
|
||
|
|
while ($forums_query->have_posts()) {
|
||
|
|
$forums_query->the_post();
|
||
|
|
$forum_id = get_the_ID();
|
||
|
|
|
||
|
|
// Skip hidden forums or forums user doesn't have access to
|
||
|
|
if (!bbp_is_forum_public($forum_id)) {
|
||
|
|
continue;
|
||
|
|
}
|
||
|
|
|
||
|
|
$forums[] = bbpas_prepare_forum_data($forum_id);
|
||
|
|
}
|
||
|
|
wp_reset_postdata();
|
||
|
|
}
|
||
|
|
|
||
|
|
// Add pagination info to response
|
||
|
|
$response = rest_ensure_response($forums);
|
||
|
|
$response->header('X-WP-Total', $forums_query->found_posts);
|
||
|
|
$response->header('X-WP-TotalPages', $forums_query->max_num_pages);
|
||
|
|
|
||
|
|
return $response;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_get_forum_details($request) {
|
||
|
|
$forum_id = $request->get_param('id');
|
||
|
|
|
||
|
|
if (!bbp_is_forum($forum_id)) {
|
||
|
|
return new WP_Error('invalid_forum', __('Invalid forum ID', 'bbpress-api-server'), array('status' => 404));
|
||
|
|
}
|
||
|
|
|
||
|
|
if (!bbp_is_forum_public($forum_id)) {
|
||
|
|
return new WP_Error('private_forum', __('This forum is not public', 'bbpress-api-server'), array('status' => 403));
|
||
|
|
}
|
||
|
|
|
||
|
|
return bbpas_prepare_forum_data($forum_id, true);
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_prepare_forum_data($forum_id, $with_subforums = false) {
|
||
|
|
$forum_data = array(
|
||
|
|
'id' => $forum_id,
|
||
|
|
'title' => bbp_get_forum_title($forum_id),
|
||
|
|
'permalink' => bbp_get_forum_permalink($forum_id),
|
||
|
|
'description' => bbp_get_forum_content($forum_id),
|
||
|
|
'topic_count' => bbp_get_forum_topic_count($forum_id),
|
||
|
|
'reply_count' => bbp_get_forum_reply_count($forum_id),
|
||
|
|
'total_topic_count' => bbp_get_forum_topic_count($forum_id, true),
|
||
|
|
'total_reply_count' => bbp_get_forum_reply_count($forum_id, true),
|
||
|
|
'last_active' => bbp_get_forum_last_active_time($forum_id),
|
||
|
|
'last_active_time' => get_post_meta($forum_id, '_bbp_last_active_time', true),
|
||
|
|
'parent_forum' => bbp_get_forum_parent_id($forum_id),
|
||
|
|
'status' => bbp_get_forum_status($forum_id),
|
||
|
|
'is_category' => bbp_is_forum_category($forum_id),
|
||
|
|
'forum_type' => bbp_get_forum_type($forum_id),
|
||
|
|
'visibility' => bbp_get_forum_visibility($forum_id),
|
||
|
|
);
|
||
|
|
|
||
|
|
// Add last topic info if available
|
||
|
|
$last_topic_id = bbp_get_forum_last_topic_id($forum_id);
|
||
|
|
if ($last_topic_id) {
|
||
|
|
$forum_data['last_topic'] = array(
|
||
|
|
'id' => $last_topic_id,
|
||
|
|
'title' => bbp_get_forum_last_topic_title($forum_id),
|
||
|
|
'permalink' => bbp_get_topic_permalink($last_topic_id),
|
||
|
|
'author_id' => bbp_get_topic_author_id($last_topic_id),
|
||
|
|
'author_name' => bbp_get_topic_author_display_name($last_topic_id),
|
||
|
|
);
|
||
|
|
}
|
||
|
|
|
||
|
|
// Include subforums if requested
|
||
|
|
if ($with_subforums) {
|
||
|
|
$subforums = bbp_forum_get_subforums($forum_id);
|
||
|
|
if ($subforums) {
|
||
|
|
$forum_data['subforums'] = array();
|
||
|
|
foreach ($subforums as $subforum) {
|
||
|
|
if (bbp_is_forum_public($subforum->ID)) {
|
||
|
|
$forum_data['subforums'][] = bbpas_prepare_forum_data($subforum->ID);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
return $forum_data;
|
||
|
|
}
|
||
|
|
|
||
|
|
// === Topic endpoint functions ===
|
||
|
|
|
||
|
|
function bbpas_get_topics($request) {
|
||
|
|
if (!function_exists('bbp_get_topic_post_type')) {
|
||
|
|
return new WP_Error('bbpress_not_active', __('bbPress is not active', 'bbpress-api-server'), array('status' => 500));
|
||
|
|
}
|
||
|
|
|
||
|
|
$forum_id = $request->get_param('forum_id');
|
||
|
|
$per_page = $request->get_param('per_page');
|
||
|
|
$page = $request->get_param('page');
|
||
|
|
$orderby = $request->get_param('orderby');
|
||
|
|
$order = $request->get_param('order');
|
||
|
|
|
||
|
|
// Map API orderby parameter to WP_Query parameters
|
||
|
|
$orderby_map = array(
|
||
|
|
'date' => 'date',
|
||
|
|
'title' => 'title',
|
||
|
|
'activity' => 'meta_value',
|
||
|
|
'popularity' => 'meta_value_num'
|
||
|
|
);
|
||
|
|
|
||
|
|
$wp_orderby = isset($orderby_map[$orderby]) ? $orderby_map[$orderby] : 'meta_value';
|
||
|
|
$meta_key = ($orderby === 'popularity') ? '_bbp_voice_count' : '_bbp_last_active_time';
|
||
|
|
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_topic_post_type(),
|
||
|
|
'post_status' => bbp_get_public_status_id(),
|
||
|
|
'posts_per_page' => $per_page,
|
||
|
|
'paged' => $page,
|
||
|
|
'orderby' => $wp_orderby,
|
||
|
|
'order' => $order,
|
||
|
|
);
|
||
|
|
|
||
|
|
// Add meta key for ordering if needed
|
||
|
|
if (in_array($orderby, ['activity', 'popularity'])) {
|
||
|
|
$args['meta_key'] = $meta_key;
|
||
|
|
}
|
||
|
|
|
||
|
|
// If forum ID is provided, filter by forum
|
||
|
|
if ($forum_id) {
|
||
|
|
// Check if forum exists and is public
|
||
|
|
if (!bbp_is_forum($forum_id) || !bbp_is_forum_public($forum_id)) {
|
||
|
|
return new WP_Error('invalid_forum', __('Invalid or inaccessible forum', 'bbpress-api-server'), array('status' => 404));
|
||
|
|
}
|
||
|
|
|
||
|
|
$args['meta_query'] = array(
|
||
|
|
array(
|
||
|
|
'key' => '_bbp_forum_id',
|
||
|
|
'value' => $forum_id,
|
||
|
|
),
|
||
|
|
);
|
||
|
|
}
|
||
|
|
|
||
|
|
// Handle sticky topics
|
||
|
|
$sticky_topics = array();
|
||
|
|
if ($forum_id) {
|
||
|
|
$sticky_topics = bbp_get_stickies($forum_id);
|
||
|
|
}
|
||
|
|
|
||
|
|
$topics_query = new WP_Query($args);
|
||
|
|
$topics = array();
|
||
|
|
|
||
|
|
// Add sticky topics first if forum_id is provided and we're on the first page
|
||
|
|
if ($page == 1 && !empty($sticky_topics) && $forum_id) {
|
||
|
|
foreach ($sticky_topics as $sticky_id) {
|
||
|
|
if (bbp_is_topic($sticky_id) && bbp_is_topic_published($sticky_id)) {
|
||
|
|
$topics[] = bbpas_prepare_topic_data($sticky_id);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// Add regular topics
|
||
|
|
if ($topics_query->have_posts()) {
|
||
|
|
while ($topics_query->have_posts()) {
|
||
|
|
$topics_query->the_post();
|
||
|
|
$topic_id = get_the_ID();
|
||
|
|
|
||
|
|
// Skip sticky topics as they've already been added
|
||
|
|
if ($page == 1 && !empty($sticky_topics) && in_array($topic_id, $sticky_topics)) {
|
||
|
|
continue;
|
||
|
|
}
|
||
|
|
|
||
|
|
$topics[] = bbpas_prepare_topic_data($topic_id);
|
||
|
|
}
|
||
|
|
wp_reset_postdata();
|
||
|
|
}
|
||
|
|
|
||
|
|
// Add pagination info to response
|
||
|
|
$response = rest_ensure_response($topics);
|
||
|
|
$response->header('X-WP-Total', $topics_query->found_posts);
|
||
|
|
$response->header('X-WP-TotalPages', $topics_query->max_num_pages);
|
||
|
|
|
||
|
|
return $response;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_get_topic_details($request) {
|
||
|
|
$topic_id = $request->get_param('id');
|
||
|
|
$with_replies = $request->get_param('with_replies');
|
||
|
|
|
||
|
|
if (!bbp_is_topic($topic_id)) {
|
||
|
|
return new WP_Error('invalid_topic', __('Invalid topic ID', 'bbpress-api-server'), array('status' => 404));
|
||
|
|
}
|
||
|
|
|
||
|
|
$topic_data = bbpas_prepare_topic_data($topic_id, true);
|
||
|
|
|
||
|
|
// Include replies if requested
|
||
|
|
if ($with_replies) {
|
||
|
|
$replies_data = bbpas_get_replies(new WP_REST_Request('GET', '/bbpas/v1/replies'));
|
||
|
|
$topic_data['replies'] = $replies_data;
|
||
|
|
}
|
||
|
|
|
||
|
|
return $topic_data;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_prepare_topic_data($topic_id, $with_content = false) {
|
||
|
|
$last_active = get_post_meta($topic_id, '_bbp_last_active_time', true);
|
||
|
|
$forum_id = bbp_get_topic_forum_id($topic_id);
|
||
|
|
|
||
|
|
$topic_data = array(
|
||
|
|
'id' => $topic_id,
|
||
|
|
'title' => bbp_get_topic_title($topic_id),
|
||
|
|
'permalink' => bbp_get_topic_permalink($topic_id),
|
||
|
|
'forum_id' => $forum_id,
|
||
|
|
'forum_title' => bbp_get_forum_title($forum_id),
|
||
|
|
'forum_permalink' => bbp_get_forum_permalink($forum_id),
|
||
|
|
'created' => get_post_time('c', true, $topic_id),
|
||
|
|
'last_active' => $last_active,
|
||
|
|
'last_active_gmt' => get_gmt_from_date($last_active),
|
||
|
|
'last_active_relative' => bbp_get_topic_last_active_time($topic_id),
|
||
|
|
'author_id' => bbp_get_topic_author_id($topic_id),
|
||
|
|
'author_name' => bbp_get_topic_author_display_name($topic_id),
|
||
|
|
'author_avatar' => bbpas_get_author_avatar_url(bbp_get_topic_author_id($topic_id)),
|
||
|
|
'reply_count' => bbp_get_topic_reply_count($topic_id),
|
||
|
|
'voice_count' => bbp_get_topic_voice_count($topic_id),
|
||
|
|
'is_sticky' => bbp_is_topic_sticky($topic_id),
|
||
|
|
'is_super_sticky' => bbp_is_topic_super_sticky($topic_id),
|
||
|
|
'status' => bbp_get_topic_status($topic_id),
|
||
|
|
'excerpt' => bbp_get_topic_excerpt($topic_id, 100),
|
||
|
|
);
|
||
|
|
|
||
|
|
// Include full content if requested
|
||
|
|
if ($with_content) {
|
||
|
|
$topic_data['content'] = bbp_get_topic_content($topic_id);
|
||
|
|
}
|
||
|
|
|
||
|
|
// Get tags if any
|
||
|
|
$topic_data['tags'] = array();
|
||
|
|
$tags = wp_get_object_terms($topic_id, bbp_get_topic_tag_tax_id());
|
||
|
|
if (!empty($tags) && !is_wp_error($tags)) {
|
||
|
|
foreach ($tags as $tag) {
|
||
|
|
$topic_data['tags'][] = array(
|
||
|
|
'id' => $tag->term_id,
|
||
|
|
'name' => $tag->name,
|
||
|
|
'slug' => $tag->slug,
|
||
|
|
'permalink' => bbp_get_topic_tag_link($tag->term_id)
|
||
|
|
);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// Add last reply info if available
|
||
|
|
$last_reply_id = bbp_get_topic_last_reply_id($topic_id);
|
||
|
|
if ($last_reply_id && $last_reply_id != $topic_id) {
|
||
|
|
$topic_data['last_reply'] = array(
|
||
|
|
'id' => $last_reply_id,
|
||
|
|
'excerpt' => bbp_get_reply_excerpt($last_reply_id, 55),
|
||
|
|
'author_id' => bbp_get_reply_author_id($last_reply_id),
|
||
|
|
'author_name' => bbp_get_reply_author_display_name($last_reply_id),
|
||
|
|
'author_avatar' => bbpas_get_author_avatar_url(bbp_get_reply_author_id($last_reply_id)),
|
||
|
|
'created' => get_post_time('c', true, $last_reply_id),
|
||
|
|
);
|
||
|
|
}
|
||
|
|
|
||
|
|
return $topic_data;
|
||
|
|
}
|
||
|
|
|
||
|
|
// === Reply endpoint functions ===
|
||
|
|
|
||
|
|
function bbpas_get_replies($request) {
|
||
|
|
if (!function_exists('bbp_get_reply_post_type')) {
|
||
|
|
return new WP_Error('bbpress_not_active', __('bbPress is not active', 'bbpress-api-server'), array('status' => 500));
|
||
|
|
}
|
||
|
|
|
||
|
|
$topic_id = $request->get_param('topic_id');
|
||
|
|
$per_page = $request->get_param('per_page');
|
||
|
|
$page = $request->get_param('page');
|
||
|
|
$order = $request->get_param('order');
|
||
|
|
|
||
|
|
if (!bbp_is_topic($topic_id)) {
|
||
|
|
return new WP_Error('invalid_topic', __('Invalid topic ID', 'bbpress-api-server'), array('status' => 404));
|
||
|
|
}
|
||
|
|
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_reply_post_type(),
|
||
|
|
'post_status' => bbp_get_public_status_id(),
|
||
|
|
'post_parent' => $topic_id,
|
||
|
|
'posts_per_page' => $per_page,
|
||
|
|
'paged' => $page,
|
||
|
|
'orderby' => 'date',
|
||
|
|
'order' => $order,
|
||
|
|
);
|
||
|
|
|
||
|
|
$replies_query = new WP_Query($args);
|
||
|
|
$replies = array();
|
||
|
|
|
||
|
|
if ($replies_query->have_posts()) {
|
||
|
|
while ($replies_query->have_posts()) {
|
||
|
|
$replies_query->the_post();
|
||
|
|
$reply_id = get_the_ID();
|
||
|
|
|
||
|
|
$replies[] = bbpas_prepare_reply_data($reply_id);
|
||
|
|
}
|
||
|
|
wp_reset_postdata();
|
||
|
|
}
|
||
|
|
|
||
|
|
// Add pagination info to response
|
||
|
|
$response = rest_ensure_response($replies);
|
||
|
|
$response->header('X-WP-Total', $replies_query->found_posts);
|
||
|
|
$response->header('X-WP-TotalPages', $replies_query->max_num_pages);
|
||
|
|
|
||
|
|
return $response;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_get_reply_details($request) {
|
||
|
|
$reply_id = $request->get_param('id');
|
||
|
|
|
||
|
|
if (!bbp_is_reply($reply_id)) {
|
||
|
|
return new WP_Error('invalid_reply', __('Invalid reply ID', 'bbpress-api-server'), array('status' => 404));
|
||
|
|
}
|
||
|
|
|
||
|
|
return bbpas_prepare_reply_data($reply_id, true);
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_prepare_reply_data($reply_id, $with_content = false) {
|
||
|
|
$reply_data = array(
|
||
|
|
'id' => $reply_id,
|
||
|
|
'permalink' => bbp_get_reply_permalink($reply_id),
|
||
|
|
'topic_id' => bbp_get_reply_topic_id($reply_id),
|
||
|
|
'topic_title' => bbp_get_topic_title(bbp_get_reply_topic_id($reply_id)),
|
||
|
|
'forum_id' => bbp_get_reply_forum_id($reply_id),
|
||
|
|
'created' => get_post_time('c', true, $reply_id),
|
||
|
|
'author_id' => bbp_get_reply_author_id($reply_id),
|
||
|
|
'author_name' => bbp_get_reply_author_display_name($reply_id),
|
||
|
|
'author_avatar' => bbpas_get_author_avatar_url(bbp_get_reply_author_id($reply_id)),
|
||
|
|
'excerpt' => bbp_get_reply_excerpt($reply_id, 100),
|
||
|
|
);
|
||
|
|
|
||
|
|
// Include full content if requested
|
||
|
|
if ($with_content) {
|
||
|
|
$reply_data['content'] = bbp_get_reply_content($reply_id);
|
||
|
|
}
|
||
|
|
|
||
|
|
return $reply_data;
|
||
|
|
}
|
||
|
|
|
||
|
|
// === User endpoint functions ===
|
||
|
|
|
||
|
|
function bbpas_get_user_activity($request) {
|
||
|
|
$user_id = $request->get_param('id');
|
||
|
|
$type = $request->get_param('type');
|
||
|
|
$per_page = $request->get_param('per_page');
|
||
|
|
|
||
|
|
if (!get_userdata($user_id)) {
|
||
|
|
return new WP_Error('invalid_user', __('Invalid user ID', 'bbpress-api-server'), array('status' => 404));
|
||
|
|
}
|
||
|
|
|
||
|
|
$activity = array();
|
||
|
|
|
||
|
|
// Get user's topics if requested
|
||
|
|
if ($type === 'topics' || $type === 'all') {
|
||
|
|
$topics = bbpas_get_user_topics($user_id, $per_page);
|
||
|
|
if ($type === 'topics') {
|
||
|
|
return $topics;
|
||
|
|
} else {
|
||
|
|
$activity['topics'] = $topics;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// Get user's replies if requested
|
||
|
|
if ($type === 'replies' || $type === 'all') {
|
||
|
|
$replies = bbpas_get_user_replies($user_id, $per_page);
|
||
|
|
if ($type === 'replies') {
|
||
|
|
return $replies;
|
||
|
|
} else {
|
||
|
|
$activity['replies'] = $replies;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// If type is 'all', we're returning both
|
||
|
|
return $activity;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_get_user_topics($user_id, $per_page = 10) {
|
||
|
|
$args = array(
|
||
|
|
'author' => $user_id,
|
||
|
|
'post_type' => bbp_get_topic_post_type(),
|
||
|
|
'post_status' => array(bbp_get_public_status_id()),
|
||
|
|
'posts_per_page' => $per_page,
|
||
|
|
'orderby' => 'date',
|
||
|
|
'order' => 'DESC',
|
||
|
|
);
|
||
|
|
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
$topics = array();
|
||
|
|
|
||
|
|
if ($query->have_posts()) {
|
||
|
|
while ($query->have_posts()) {
|
||
|
|
$query->the_post();
|
||
|
|
$topics[] = bbpas_prepare_topic_data(get_the_ID());
|
||
|
|
}
|
||
|
|
wp_reset_postdata();
|
||
|
|
}
|
||
|
|
|
||
|
|
return $topics;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_get_user_replies($user_id, $per_page = 10) {
|
||
|
|
$args = array(
|
||
|
|
'author' => $user_id,
|
||
|
|
'post_type' => bbp_get_reply_post_type(),
|
||
|
|
'post_status' => array(bbp_get_public_status_id()),
|
||
|
|
'posts_per_page' => $per_page,
|
||
|
|
'orderby' => 'date',
|
||
|
|
'order' => 'DESC',
|
||
|
|
);
|
||
|
|
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
$replies = array();
|
||
|
|
|
||
|
|
if ($query->have_posts()) {
|
||
|
|
while ($query->have_posts()) {
|
||
|
|
$query->the_post();
|
||
|
|
$replies[] = bbpas_prepare_reply_data(get_the_ID());
|
||
|
|
}
|
||
|
|
wp_reset_postdata();
|
||
|
|
}
|
||
|
|
|
||
|
|
return $replies;
|
||
|
|
}
|
||
|
|
|
||
|
|
// === Search endpoint function ===
|
||
|
|
|
||
|
|
function bbpas_search($request) {
|
||
|
|
$query = $request->get_param('query');
|
||
|
|
$type = $request->get_param('type');
|
||
|
|
$per_page = $request->get_param('per_page');
|
||
|
|
$page = $request->get_param('page');
|
||
|
|
|
||
|
|
if (empty($query)) {
|
||
|
|
return new WP_Error('empty_search', __('Search query cannot be empty', 'bbpress-api-server'), array('status' => 400));
|
||
|
|
}
|
||
|
|
|
||
|
|
// Determine post types to search
|
||
|
|
$post_types = array();
|
||
|
|
switch ($type) {
|
||
|
|
case 'forum':
|
||
|
|
$post_types[] = bbp_get_forum_post_type();
|
||
|
|
break;
|
||
|
|
case 'topic':
|
||
|
|
$post_types[] = bbp_get_topic_post_type();
|
||
|
|
break;
|
||
|
|
case 'reply':
|
||
|
|
$post_types[] = bbp_get_reply_post_type();
|
||
|
|
break;
|
||
|
|
case 'all':
|
||
|
|
default:
|
||
|
|
$post_types = array(
|
||
|
|
bbp_get_forum_post_type(),
|
||
|
|
bbp_get_topic_post_type(),
|
||
|
|
bbp_get_reply_post_type()
|
||
|
|
);
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
|
||
|
|
$args = array(
|
||
|
|
'post_type' => $post_types,
|
||
|
|
'post_status' => 'publish',
|
||
|
|
's' => $query,
|
||
|
|
'posts_per_page' => $per_page,
|
||
|
|
'paged' => $page,
|
||
|
|
'orderby' => 'relevance',
|
||
|
|
);
|
||
|
|
|
||
|
|
$search_query = new WP_Query($args);
|
||
|
|
$results = array();
|
||
|
|
|
||
|
|
if ($search_query->have_posts()) {
|
||
|
|
while ($search_query->have_posts()) {
|
||
|
|
$search_query->the_post();
|
||
|
|
$post_id = get_the_ID();
|
||
|
|
$post_type = get_post_type($post_id);
|
||
|
|
|
||
|
|
$result = array(
|
||
|
|
'id' => $post_id,
|
||
|
|
'type' => $post_type,
|
||
|
|
'title' => get_the_title($post_id),
|
||
|
|
'permalink' => get_permalink($post_id),
|
||
|
|
'date' => get_post_time('c', true, $post_id),
|
||
|
|
'excerpt' => get_the_excerpt($post_id),
|
||
|
|
);
|
||
|
|
|
||
|
|
// Add type-specific data
|
||
|
|
if ($post_type === bbp_get_forum_post_type()) {
|
||
|
|
$result['topic_count'] = bbp_get_forum_topic_count($post_id);
|
||
|
|
$result['reply_count'] = bbp_get_forum_reply_count($post_id);
|
||
|
|
} elseif ($post_type === bbp_get_topic_post_type()) {
|
||
|
|
$result['forum_id'] = bbp_get_topic_forum_id($post_id);
|
||
|
|
$result['forum_title'] = bbp_get_forum_title($result['forum_id']);
|
||
|
|
$result['reply_count'] = bbp_get_topic_reply_count($post_id);
|
||
|
|
} elseif ($post_type === bbp_get_reply_post_type()) {
|
||
|
|
$result['topic_id'] = bbp_get_reply_topic_id($post_id);
|
||
|
|
$result['topic_title'] = bbp_get_topic_title($result['topic_id']);
|
||
|
|
$result['forum_id'] = bbp_get_reply_forum_id($post_id);
|
||
|
|
}
|
||
|
|
|
||
|
|
$results[] = $result;
|
||
|
|
}
|
||
|
|
wp_reset_postdata();
|
||
|
|
}
|
||
|
|
|
||
|
|
// Add pagination info to response
|
||
|
|
$response = rest_ensure_response($results);
|
||
|
|
$response->header('X-WP-Total', $search_query->found_posts);
|
||
|
|
$response->header('X-WP-TotalPages', $search_query->max_num_pages);
|
||
|
|
|
||
|
|
return $response;
|
||
|
|
}
|
||
|
|
|
||
|
|
// === Stats endpoint function ===
|
||
|
|
|
||
|
|
function bbpas_get_stats() {
|
||
|
|
return array(
|
||
|
|
'forums' => array(
|
||
|
|
'total' => bbpas_count_total_forums(),
|
||
|
|
'active' => bbpas_count_active_forums(),
|
||
|
|
),
|
||
|
|
'topics' => array(
|
||
|
|
'total' => bbpas_count_total_topics(),
|
||
|
|
'open' => bbpas_count_open_topics(),
|
||
|
|
'closed' => bbpas_count_closed_topics(),
|
||
|
|
),
|
||
|
|
'replies' => array(
|
||
|
|
'total' => bbpas_count_total_replies(),
|
||
|
|
),
|
||
|
|
'users' => array(
|
||
|
|
'total' => bbpas_count_total_users(),
|
||
|
|
),
|
||
|
|
'last_24_hours' => array(
|
||
|
|
'topics' => bbpas_count_topics_last_24_hours(),
|
||
|
|
'replies' => bbpas_count_replies_last_24_hours(),
|
||
|
|
),
|
||
|
|
'last_7_days' => array(
|
||
|
|
'topics' => bbpas_count_topics_last_7_days(),
|
||
|
|
'replies' => bbpas_count_replies_last_7_days(),
|
||
|
|
),
|
||
|
|
);
|
||
|
|
}
|
||
|
|
|
||
|
|
// Helper functions for stats
|
||
|
|
|
||
|
|
function bbpas_count_total_forums() {
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_forum_post_type(),
|
||
|
|
'post_status' => 'publish',
|
||
|
|
'posts_per_page' => 1,
|
||
|
|
'fields' => 'ids',
|
||
|
|
);
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
return $query->found_posts;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_count_active_forums() {
|
||
|
|
// Active forums have at least one topic
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_forum_post_type(),
|
||
|
|
'post_status' => 'publish',
|
||
|
|
'meta_query' => array(
|
||
|
|
array(
|
||
|
|
'key' => '_bbp_topic_count',
|
||
|
|
'value' => 0,
|
||
|
|
'compare' => '>',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
'posts_per_page' => 1,
|
||
|
|
'fields' => 'ids',
|
||
|
|
);
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
return $query->found_posts;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_count_total_topics() {
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_topic_post_type(),
|
||
|
|
'post_status' => 'publish',
|
||
|
|
'posts_per_page' => 1,
|
||
|
|
'fields' => 'ids',
|
||
|
|
);
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
return $query->found_posts;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_count_open_topics() {
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_topic_post_type(),
|
||
|
|
'post_status' => bbp_get_public_status_id(),
|
||
|
|
'meta_query' => array(
|
||
|
|
array(
|
||
|
|
'key' => '_bbp_status',
|
||
|
|
'value' => 'closed',
|
||
|
|
'compare' => '!=',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
'posts_per_page' => 1,
|
||
|
|
'fields' => 'ids',
|
||
|
|
);
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
return $query->found_posts;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_count_closed_topics() {
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_topic_post_type(),
|
||
|
|
'post_status' => bbp_get_public_status_id(),
|
||
|
|
'meta_query' => array(
|
||
|
|
array(
|
||
|
|
'key' => '_bbp_status',
|
||
|
|
'value' => 'closed',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
'posts_per_page' => 1,
|
||
|
|
'fields' => 'ids',
|
||
|
|
);
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
return $query->found_posts;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_count_total_replies() {
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_reply_post_type(),
|
||
|
|
'post_status' => 'publish',
|
||
|
|
'posts_per_page' => 1,
|
||
|
|
'fields' => 'ids',
|
||
|
|
);
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
return $query->found_posts;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_count_total_users() {
|
||
|
|
$count = count_users();
|
||
|
|
return $count['total_users'];
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_count_topics_last_24_hours() {
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_topic_post_type(),
|
||
|
|
'post_status' => 'publish',
|
||
|
|
'date_query' => array(
|
||
|
|
array(
|
||
|
|
'after' => '1 day ago',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
'posts_per_page' => 1,
|
||
|
|
'fields' => 'ids',
|
||
|
|
);
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
return $query->found_posts;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_count_replies_last_24_hours() {
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_reply_post_type(),
|
||
|
|
'post_status' => 'publish',
|
||
|
|
'date_query' => array(
|
||
|
|
array(
|
||
|
|
'after' => '1 day ago',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
'posts_per_page' => 1,
|
||
|
|
'fields' => 'ids',
|
||
|
|
);
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
return $query->found_posts;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_count_topics_last_7_days() {
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_topic_post_type(),
|
||
|
|
'post_status' => 'publish',
|
||
|
|
'date_query' => array(
|
||
|
|
array(
|
||
|
|
'after' => '7 days ago',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
'posts_per_page' => 1,
|
||
|
|
'fields' => 'ids',
|
||
|
|
);
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
return $query->found_posts;
|
||
|
|
}
|
||
|
|
|
||
|
|
function bbpas_count_replies_last_7_days() {
|
||
|
|
$args = array(
|
||
|
|
'post_type' => bbp_get_reply_post_type(),
|
||
|
|
'post_status' => 'publish',
|
||
|
|
'date_query' => array(
|
||
|
|
array(
|
||
|
|
'after' => '7 days ago',
|
||
|
|
),
|
||
|
|
),
|
||
|
|
'posts_per_page' => 1,
|
||
|
|
'fields' => 'ids',
|
||
|
|
);
|
||
|
|
$query = new WP_Query($args);
|
||
|
|
return $query->found_posts;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Helper functions
|
||
|
|
|
||
|
|
function bbpas_get_author_avatar_url($user_id, $size = 96) {
|
||
|
|
return get_avatar_url($user_id, array('size' => $size));
|
||
|
|
}
|
||
|
|
|
||
|
|
// === Legacy compatibility functions ===
|
||
|
|
|
||
|
|
function wbapi_test_connection() {
|
||
|
|
$response = bbpas_test_connection();
|
||
|
|
|
||
|
|
// Add a deprecation notice
|
||
|
|
$response['deprecated'] = true;
|
||
|
|
$response['notice'] = __('This endpoint is deprecated. Please use the new endpoint: /bbpas/v1/test', 'bbpress-api-server');
|
||
|
|
|
||
|
|
return $response;
|
||
|
|
}
|
||
|
|
|
||
|
|
function wbapi_get_forums() {
|
||
|
|
$response = bbpas_get_forums(new WP_REST_Request('GET', '/' . BBPAS_API_NAMESPACE . '/forums'));
|
||
|
|
|
||
|
|
// Add a deprecation notice
|
||
|
|
if (is_array($response->get_data())) {
|
||
|
|
$data = $response->get_data();
|
||
|
|
$data['deprecated'] = true;
|
||
|
|
$data['notice'] = __('This endpoint is deprecated. Please use the new endpoint: /bbpas/v1/forums', 'bbpress-api-server');
|
||
|
|
$response->set_data($data);
|
||
|
|
}
|
||
|
|
|
||
|
|
return $response;
|
||
|
|
}
|
||
|
|
|
||
|
|
function wbapi_get_topics($request) {
|
||
|
|
$forum_id = $request->get_param('forum_id');
|
||
|
|
$count = $request->get_param('count');
|
||
|
|
|
||
|
|
// Create a new request object for the new API
|
||
|
|
$new_request = new WP_REST_Request('GET', '/' . BBPAS_API_NAMESPACE . '/topics');
|
||
|
|
$new_request->set_param('forum_id', $forum_id);
|
||
|
|
$new_request->set_param('per_page', $count);
|
||
|
|
|
||
|
|
$response = bbpas_get_topics($new_request);
|
||
|
|
|
||
|
|
// Add a deprecation notice
|
||
|
|
if (is_array($response->get_data())) {
|
||
|
|
$data = $response->get_data();
|
||
|
|
$data['deprecated'] = true;
|
||
|
|
$data['notice'] = __('This endpoint is deprecated. Please use the new endpoint: /bbpas/v1/topics', 'bbpress-api-server');
|
||
|
|
$response->set_data($data);
|
||
|
|
}
|
||
|
|
|
||
|
|
return $response;
|
||
|
|
}
|
||
|
|
|
||
|
|
function wbapi_get_forum_details($request) {
|
||
|
|
$forum_id = $request->get_param('id');
|
||
|
|
|
||
|
|
// Create a new request object for the new API
|
||
|
|
$new_request = new WP_REST_Request('GET', '/' . BBPAS_API_NAMESPACE . '/forum/' . $forum_id);
|
||
|
|
|
||
|
|
$response = bbpas_get_forum_details($new_request);
|
||
|
|
|
||
|
|
// Add a deprecation notice if this is a valid response
|
||
|
|
if (!is_wp_error($response)) {
|
||
|
|
$response['deprecated'] = true;
|
||
|
|
$response['notice'] = __('This endpoint is deprecated. Please use the new endpoint: /bbpas/v1/forum/{id}', 'bbpress-api-server');
|
||
|
|
}
|
||
|
|
|
||
|
|
return $response;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Initialize the plugin
|
||
|
|
|
||
|
|
// Add action to check if bbPress is active and register REST routes
|
||
|
|
add_action('plugins_loaded', function() {
|
||
|
|
if (bbpas_check_required_plugins()) {
|
||
|
|
add_action('rest_api_init', 'bbpas_register_routes');
|
||
|
|
}
|
||
|
|
});
|
||
|
|
|
||
|
|
// Add admin menu
|
||
|
|
add_action('admin_menu', function() {
|
||
|
|
if (!bbpas_check_required_plugins()) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
|
||
|
|
add_submenu_page(
|
||
|
|
'options-general.php',
|
||
|
|
__('bbPress API Server', 'bbpress-api-server'),
|
||
|
|
__('bbPress API', 'bbpress-api-server'),
|
||
|
|
'manage_options',
|
||
|
|
'bbpress-api-server',
|
||
|
|
'bbpas_admin_page'
|
||
|
|
);
|
||
|
|
});
|
||
|
|
|
||
|
|
// Admin page
|
||
|
|
function bbpas_admin_page() {
|
||
|
|
?>
|
||
|
|
<div class="wrap">
|
||
|
|
<h1><?php _e('bbPress API Server', 'bbpress-api-server'); ?></h1>
|
||
|
|
|
||
|
|
<div class="card">
|
||
|
|
<h2><?php _e('API Information', 'bbpress-api-server'); ?></h2>
|
||
|
|
<p><?php _e('This plugin provides REST API endpoints for bbPress forums, topics, and replies.', 'bbpress-api-server'); ?></p>
|
||
|
|
<p><strong><?php _e('API Namespace:', 'bbpress-api-server'); ?></strong> <?php echo BBPAS_API_NAMESPACE; ?></p>
|
||
|
|
<p><strong><?php _e('Plugin Version:', 'bbpress-api-server'); ?></strong> <?php echo BBPAS_VERSION; ?></p>
|
||
|
|
<p><strong><?php _e('bbPress Version:', 'bbpress-api-server'); ?></strong> <?php echo bbp_get_version(); ?></p>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="card">
|
||
|
|
<h2><?php _e('Available Endpoints', 'bbpress-api-server'); ?></h2>
|
||
|
|
<table class="widefat">
|
||
|
|
<thead>
|
||
|
|
<tr>
|
||
|
|
<th><?php _e('Endpoint', 'bbpress-api-server'); ?></th>
|
||
|
|
<th><?php _e('Method', 'bbpress-api-server'); ?></th>
|
||
|
|
<th><?php _e('Description', 'bbpress-api-server'); ?></th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody>
|
||
|
|
<tr>
|
||
|
|
<td><code>/<?php echo BBPAS_API_NAMESPACE; ?>/test</code></td>
|
||
|
|
<td>GET</td>
|
||
|
|
<td><?php _e('Test if the API is working', 'bbpress-api-server'); ?></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>/<?php echo BBPAS_API_NAMESPACE; ?>/forums</code></td>
|
||
|
|
<td>GET</td>
|
||
|
|
<td><?php _e('Get a list of forums', 'bbpress-api-server'); ?></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>/<?php echo BBPAS_API_NAMESPACE; ?>/forum/{id}</code></td>
|
||
|
|
<td>GET</td>
|
||
|
|
<td><?php _e('Get details of a specific forum', 'bbpress-api-server'); ?></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>/<?php echo BBPAS_API_NAMESPACE; ?>/topics</code></td>
|
||
|
|
<td>GET</td>
|
||
|
|
<td><?php _e('Get a list of topics, optionally filtered by forum', 'bbpress-api-server'); ?></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>/<?php echo BBPAS_API_NAMESPACE; ?>/topic/{id}</code></td>
|
||
|
|
<td>GET</td>
|
||
|
|
<td><?php _e('Get details of a specific topic', 'bbpress-api-server'); ?></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>/<?php echo BBPAS_API_NAMESPACE; ?>/replies</code></td>
|
||
|
|
<td>GET</td>
|
||
|
|
<td><?php _e('Get replies for a topic', 'bbpress-api-server'); ?></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>/<?php echo BBPAS_API_NAMESPACE; ?>/reply/{id}</code></td>
|
||
|
|
<td>GET</td>
|
||
|
|
<td><?php _e('Get details of a specific reply', 'bbpress-api-server'); ?></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>/<?php echo BBPAS_API_NAMESPACE; ?>/user/{id}/activity</code></td>
|
||
|
|
<td>GET</td>
|
||
|
|
<td><?php _e('Get forum activity for a specific user', 'bbpress-api-server'); ?></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>/<?php echo BBPAS_API_NAMESPACE; ?>/search</code></td>
|
||
|
|
<td>GET</td>
|
||
|
|
<td><?php _e('Search forums, topics, and replies', 'bbpress-api-server'); ?></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td><code>/<?php echo BBPAS_API_NAMESPACE; ?>/stats</code></td>
|
||
|
|
<td>GET</td>
|
||
|
|
<td><?php _e('Get forum statistics', 'bbpress-api-server'); ?></td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="card">
|
||
|
|
<h2><?php _e('Instructions', 'bbpress-api-server'); ?></h2>
|
||
|
|
<ol>
|
||
|
|
<li><?php _e('Install this plugin on a WordPress site with bbPress activated.', 'bbpress-api-server'); ?></li>
|
||
|
|
<li><?php _e('Ensure that pretty permalinks are enabled (recommended to use "Post name" format).', 'bbpress-api-server'); ?></li>
|
||
|
|
<li><?php _e('Use the API in the following ways:', 'bbpress-api-server'); ?>
|
||
|
|
<ul>
|
||
|
|
<li><?php _e('Directly call REST API endpoints.', 'bbpress-api-server'); ?></li>
|
||
|
|
<li><?php _e('Use the official SDK (available on our website).', 'bbpress-api-server'); ?></li>
|
||
|
|
<li><?php _e('Integrate with third-party services:', 'bbpress-api-server'); ?>
|
||
|
|
<br>- WooCommerce Forum Integration Plugin
|
||
|
|
<br>- LearnDash Course Community Plugin
|
||
|
|
<br>- WeChat Mini Program Integration Solution
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li><?php _e('Advanced configuration recommendations:', 'bbpress-api-server'); ?>
|
||
|
|
<ul>
|
||
|
|
<li><?php _e('Enable caching in load-balanced environments.', 'bbpress-api-server'); ?></li>
|
||
|
|
<li><?php _e('Use JWT for authentication (requires extension plugin).', 'bbpress-api-server'); ?></li>
|
||
|
|
<li><?php _e('Customize response fields using the `bbpas_response_data` filter.', 'bbpress-api-server'); ?></li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p><?php _e('For complete developer documentation, visit:', 'bbpress-api-server'); ?>
|
||
|
|
<a href="https://wpsdk.com/?p=1076" target="_blank">
|
||
|
|
https://wpsdk.com/?p=1076
|
||
|
|
</a>
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<?php
|
||
|
|
}
|
||
|
|
|
||
|
|
// Activation hook
|
||
|
|
register_activation_hook(__FILE__, function() {
|
||
|
|
// Check if bbPress is active
|
||
|
|
if (!class_exists('bbPress')) {
|
||
|
|
deactivate_plugins(plugin_basename(__FILE__));
|
||
|
|
wp_die(__('bbPress API Server requires bbPress to be installed and activated.', 'bbpress-api-server'));
|
||
|
|
}
|
||
|
|
|
||
|
|
// Flush rewrite rules on activation
|
||
|
|
flush_rewrite_rules();
|
||
|
|
});
|
||
|
|
|
||
|
|
// Deactivation hook
|
||
|
|
register_deactivation_hook(__FILE__, function() {
|
||
|
|
// Flush rewrite rules on deactivation
|
||
|
|
flush_rewrite_rules();
|
||
|
|
});
|
