| Server IP : 167.235.224.122 / Your IP : 216.73.216.110 Web Server : Apache/2.4.58 (Ubuntu) System : Linux newplayground 6.8.0-136-generic #136-Ubuntu SMP PREEMPT_DYNAMIC Wed Jul 1 21:33:11 UTC 2026 aarch64 User : deploy ( 1000) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/axel/wp-content/plugins/activitypub/includes/rest/ |
Upload File : |
<?php
/**
* Stats_Image_Controller file.
*
* @package Activitypub
* @since 8.1.0
*/
namespace Activitypub\Rest;
use Activitypub\Cache\Stats_Image;
/**
* REST controller that serves stats share images.
*
* Provides two endpoints:
* - /stats/image/{user_id}/{year} — serves the image binary
* - /stats/image-url/{user_id}/{year} — returns the image URL as JSON
*/
class Stats_Image_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 = 'stats/image';
/**
* Common route args for user_id and year.
*
* @return array The route args.
*/
private function get_common_args() {
return array(
'user_id' => array(
'description' => \__( 'The user ID to generate the stats image for.', 'activitypub' ),
'type' => 'integer',
'required' => true,
'sanitize_callback' => 'absint',
'validate_callback' => array( $this, 'validate_user_id' ),
),
'year' => array(
'description' => \__( 'The year to display stats for.', 'activitypub' ),
'type' => 'integer',
'required' => true,
'sanitize_callback' => 'absint',
'minimum' => 2000,
'maximum' => (int) \gmdate( 'Y' ),
),
);
}
/**
* Validate the user_id parameter.
*
* @param mixed $value The parameter value.
*
* @return true|\WP_Error True if valid, error otherwise.
*/
public function validate_user_id( $value ) {
$user_id = (int) $value;
// Blog user ID (0) is always valid.
if ( 0 === $user_id ) {
return true;
}
// Check that the user exists.
if ( ! \get_user_by( 'id', $user_id ) ) {
return new \WP_Error( 'invalid_user', \__( 'Invalid user ID.', 'activitypub' ), array( 'status' => 404 ) );
}
return true;
}
/**
* Register routes.
*/
public function register_routes() {
$route_pattern = '/(?P<user_id>[\d]+)/(?P<year>[\d]{4})';
// Serve the image binary.
\register_rest_route(
$this->namespace,
'/' . $this->rest_base . $route_pattern,
array(
array(
'methods' => \WP_REST_Server::READABLE,
'callback' => array( $this, 'get_item' ),
'permission_callback' => '__return_true',
'args' => $this->get_common_args(),
),
)
);
// Return the image URL as JSON.
\register_rest_route(
$this->namespace,
'/' . $this->rest_base . '-url' . $route_pattern,
array(
array(
'methods' => \WP_REST_Server::READABLE,
'callback' => array( $this, 'get_url' ),
'permission_callback' => '__return_true',
'args' => $this->get_common_args(),
),
)
);
}
/**
* Serve the stats image binary.
*
* @param \WP_REST_Request $request The request object.
*
* @return void|\WP_Error Streams image and exits, or returns error.
*/
public function get_item( $request ) {
return Stats_Image::serve(
(int) $request->get_param( 'user_id' ),
(int) $request->get_param( 'year' )
);
}
/**
* Return the resolved image URL as JSON.
*
* Returns the cached file URL if available, otherwise the REST
* endpoint URL. Filtered via `activitypub_stats_image_url` so
* it can be routed through a CDN or image proxy like Photon.
*
* @param \WP_REST_Request $request The request object.
*
* @return \WP_REST_Response|\WP_Error JSON response with the URL.
*/
public function get_url( $request ) {
$url = Stats_Image::get_url(
(int) $request->get_param( 'user_id' ),
(int) $request->get_param( 'year' )
);
if ( \is_wp_error( $url ) ) {
return $url;
}
return \rest_ensure_response( array( 'url' => $url ) );
}
}