134 lines
3.5 KiB
PHP
134 lines
3.5 KiB
PHP
<?php
|
|
/**
|
|
* Statistics_Controller file.
|
|
*
|
|
* @package Activitypub
|
|
*/
|
|
|
|
namespace Activitypub\Rest\Admin;
|
|
|
|
use Activitypub\Collection\Actors;
|
|
use Activitypub\Statistics;
|
|
|
|
use function Activitypub\user_can_act_as_blog;
|
|
|
|
/**
|
|
* ActivityPub Statistics_Controller class.
|
|
*
|
|
* Provides REST endpoints for ActivityPub statistics.
|
|
*/
|
|
class Statistics_Controller extends \WP_REST_Controller {
|
|
|
|
/**
|
|
* The namespace of this controller's route.
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $namespace = ACTIVITYPUB_REST_NAMESPACE;
|
|
|
|
/**
|
|
* The base of this controller's route.
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $rest_base = 'admin/stats';
|
|
|
|
/**
|
|
* Register routes.
|
|
*/
|
|
public function register_routes() {
|
|
\register_rest_route(
|
|
$this->namespace,
|
|
'/' . $this->rest_base . '/(?P<user_id>[\d]+)',
|
|
array(
|
|
array(
|
|
'methods' => \WP_REST_Server::READABLE,
|
|
'callback' => array( $this, 'get_item' ),
|
|
'permission_callback' => array( $this, 'get_item_permissions_check' ),
|
|
'args' => array(
|
|
'user_id' => array(
|
|
'description' => 'The user ID to get stats for.',
|
|
'type' => 'integer',
|
|
'required' => true,
|
|
),
|
|
),
|
|
),
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Checks if a given request has access to get stats.
|
|
*
|
|
* @param \WP_REST_Request $request The request object.
|
|
*
|
|
* @return true|\WP_Error True if the request has access, WP_Error otherwise.
|
|
*/
|
|
public function get_item_permissions_check( $request ) {
|
|
$user_id = (int) $request->get_param( 'user_id' );
|
|
|
|
// Check if user can access stats for this actor.
|
|
if ( Actors::BLOG_USER_ID === $user_id ) {
|
|
if ( ! user_can_act_as_blog() ) {
|
|
return new \WP_Error(
|
|
'rest_forbidden',
|
|
\__( 'You do not have permission to view blog stats.', 'activitypub' ),
|
|
array( 'status' => 403 )
|
|
);
|
|
}
|
|
} elseif ( \get_current_user_id() !== $user_id ) {
|
|
return new \WP_Error(
|
|
'rest_forbidden',
|
|
\__( 'You do not have permission to view this user\'s stats.', 'activitypub' ),
|
|
array( 'status' => 403 )
|
|
);
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Retrieves statistics for a user.
|
|
*
|
|
* @param \WP_REST_Request $request The request object.
|
|
*
|
|
* @return \WP_REST_Response|\WP_Error Response object or WP_Error object.
|
|
*/
|
|
public function get_item( $request ) {
|
|
$user_id = (int) $request->get_param( 'user_id' );
|
|
$transient_key = 'activitypub_stats_' . $user_id;
|
|
|
|
$response = \get_transient( $transient_key );
|
|
|
|
if ( false === $response ) {
|
|
$stats = Statistics::get_current_stats( $user_id, 'month' );
|
|
$comparison = Statistics::get_period_comparison( $user_id, $stats );
|
|
$monthly_data = Statistics::get_rolling_monthly_breakdown( $user_id );
|
|
$comment_types = Statistics::get_comment_types_for_stats();
|
|
|
|
$stats_response = array(
|
|
'posts_count' => $stats['posts_count'],
|
|
'followers_total' => $stats['followers_total'],
|
|
'top_posts' => $stats['top_posts'],
|
|
'top_multiplicator' => $stats['top_multiplicator'],
|
|
);
|
|
|
|
// Include per-type engagement counts from current period stats.
|
|
foreach ( \array_keys( $comment_types ) as $type ) {
|
|
$stats_response[ $type . '_count' ] = $stats[ $type . '_count' ] ?? 0;
|
|
}
|
|
|
|
$response = array(
|
|
'stats' => $stats_response,
|
|
'comparison' => $comparison,
|
|
'monthly' => \array_values( $monthly_data ),
|
|
'comment_types' => $comment_types,
|
|
);
|
|
|
|
\set_transient( $transient_key, $response, 15 * MINUTE_IN_SECONDS );
|
|
}
|
|
|
|
return \rest_ensure_response( $response );
|
|
}
|
|
}
|