2023-10-22 22:21:44 +00:00
|
|
|
<?php
|
|
|
|
namespace Activitypub\Rest;
|
|
|
|
|
2023-12-08 23:23:36 +00:00
|
|
|
use WP_Error;
|
|
|
|
use stdClass;
|
|
|
|
use WP_REST_Server;
|
|
|
|
use WP_REST_Response;
|
|
|
|
use Activitypub\Collection\Users as User_Collection;
|
|
|
|
use Activitypub\Collection\Followers as Follower_Collection;
|
|
|
|
|
|
|
|
use function Activitypub\get_rest_url_by_path;
|
|
|
|
|
2023-10-22 22:21:44 +00:00
|
|
|
/**
|
|
|
|
* ActivityPub Followers REST-Class
|
|
|
|
*
|
|
|
|
* @author Matthias Pfefferle
|
|
|
|
*
|
|
|
|
* @see https://www.w3.org/TR/activitypub/#followers
|
|
|
|
*/
|
|
|
|
class Followers {
|
|
|
|
/**
|
|
|
|
* Initialize the class, registering WordPress hooks
|
|
|
|
*/
|
|
|
|
public static function init() {
|
2023-12-08 23:23:36 +00:00
|
|
|
self::register_routes();
|
2023-10-22 22:21:44 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Register routes
|
|
|
|
*/
|
|
|
|
public static function register_routes() {
|
|
|
|
\register_rest_route(
|
2023-12-08 23:23:36 +00:00
|
|
|
ACTIVITYPUB_REST_NAMESPACE,
|
|
|
|
'/users/(?P<user_id>[\w\-\.]+)/followers',
|
2023-10-22 22:21:44 +00:00
|
|
|
array(
|
|
|
|
array(
|
2023-12-08 23:23:36 +00:00
|
|
|
'methods' => WP_REST_Server::READABLE,
|
|
|
|
'callback' => array( self::class, 'get' ),
|
2023-10-22 22:21:44 +00:00
|
|
|
'args' => self::request_parameters(),
|
|
|
|
'permission_callback' => '__return_true',
|
|
|
|
),
|
|
|
|
)
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Handle GET request
|
|
|
|
*
|
|
|
|
* @param WP_REST_Request $request
|
|
|
|
*
|
|
|
|
* @return WP_REST_Response
|
|
|
|
*/
|
|
|
|
public static function get( $request ) {
|
|
|
|
$user_id = $request->get_param( 'user_id' );
|
2023-12-08 23:23:36 +00:00
|
|
|
$user = User_Collection::get_by_various( $user_id );
|
2023-10-22 22:21:44 +00:00
|
|
|
|
2023-12-08 23:23:36 +00:00
|
|
|
if ( is_wp_error( $user ) ) {
|
|
|
|
return $user;
|
2023-10-22 22:21:44 +00:00
|
|
|
}
|
|
|
|
|
2023-12-08 23:23:36 +00:00
|
|
|
$order = $request->get_param( 'order' );
|
|
|
|
$per_page = (int) $request->get_param( 'per_page' );
|
|
|
|
$page = (int) $request->get_param( 'page' );
|
|
|
|
$context = $request->get_param( 'context' );
|
|
|
|
|
2023-10-22 22:21:44 +00:00
|
|
|
/*
|
|
|
|
* Action triggerd prior to the ActivityPub profile being created and sent to the client
|
|
|
|
*/
|
2023-12-08 23:23:36 +00:00
|
|
|
\do_action( 'activitypub_rest_followers_pre' );
|
2023-10-22 22:21:44 +00:00
|
|
|
|
2023-12-08 23:23:36 +00:00
|
|
|
$data = Follower_Collection::get_followers_with_count( $user_id, $per_page, $page, array( 'order' => ucwords( $order ) ) );
|
|
|
|
$json = new stdClass();
|
2023-10-22 22:21:44 +00:00
|
|
|
|
|
|
|
$json->{'@context'} = \Activitypub\get_context();
|
|
|
|
|
2023-12-08 23:23:36 +00:00
|
|
|
$json->id = get_rest_url_by_path( sprintf( 'users/%d/followers', $user->get__id() ) );
|
2023-10-22 22:21:44 +00:00
|
|
|
$json->generator = 'http://wordpress.org/?v=' . \get_bloginfo_rss( 'version' );
|
2023-12-08 23:23:36 +00:00
|
|
|
$json->actor = $user->get_id();
|
2023-10-22 22:21:44 +00:00
|
|
|
$json->type = 'OrderedCollectionPage';
|
|
|
|
|
2023-12-08 23:23:36 +00:00
|
|
|
$json->totalItems = $data['total']; // phpcs:ignore
|
|
|
|
$json->partOf = get_rest_url_by_path( sprintf( 'users/%d/followers', $user->get__id() ) ); // phpcs:ignore
|
|
|
|
|
|
|
|
$json->first = \add_query_arg( 'page', 1, $json->partOf ); // phpcs:ignore
|
|
|
|
$json->last = \add_query_arg( 'page', \ceil ( $json->totalItems / $per_page ), $json->partOf ); // phpcs:ignore
|
2023-10-22 22:21:44 +00:00
|
|
|
|
2023-12-08 23:23:36 +00:00
|
|
|
if ( $page && ( ( \ceil ( $json->totalItems / $per_page ) ) > $page ) ) { // phpcs:ignore
|
|
|
|
$json->next = \add_query_arg( 'page', $page + 1, $json->partOf ); // phpcs:ignore
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( $page && ( $page > 1 ) ) { // phpcs:ignore
|
|
|
|
$json->prev = \add_query_arg( 'page', $page - 1, $json->partOf ); // phpcs:ignore
|
|
|
|
}
|
2023-10-22 22:21:44 +00:00
|
|
|
|
2023-12-08 23:23:36 +00:00
|
|
|
// phpcs:ignore
|
|
|
|
$json->orderedItems = array_map(
|
|
|
|
function( $item ) use ( $context ) {
|
|
|
|
if ( 'full' === $context ) {
|
|
|
|
return $item->to_array();
|
|
|
|
}
|
|
|
|
return $item->get_url();
|
|
|
|
},
|
|
|
|
$data['followers']
|
|
|
|
);
|
2023-10-22 22:21:44 +00:00
|
|
|
|
2023-12-08 23:23:36 +00:00
|
|
|
$response = new WP_REST_Response( $json, 200 );
|
2023-10-22 22:21:44 +00:00
|
|
|
$response->header( 'Content-Type', 'application/activity+json' );
|
|
|
|
|
|
|
|
return $response;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The supported parameters
|
|
|
|
*
|
|
|
|
* @return array list of parameters
|
|
|
|
*/
|
|
|
|
public static function request_parameters() {
|
|
|
|
$params = array();
|
|
|
|
|
|
|
|
$params['page'] = array(
|
|
|
|
'type' => 'integer',
|
2023-12-08 23:23:36 +00:00
|
|
|
'default' => 1,
|
|
|
|
);
|
|
|
|
|
|
|
|
$params['per_page'] = array(
|
|
|
|
'type' => 'integer',
|
|
|
|
'default' => 20,
|
|
|
|
);
|
|
|
|
|
|
|
|
$params['order'] = array(
|
|
|
|
'type' => 'string',
|
|
|
|
'default' => 'desc',
|
|
|
|
'enum' => array( 'asc', 'desc' ),
|
2023-10-22 22:21:44 +00:00
|
|
|
);
|
|
|
|
|
|
|
|
$params['user_id'] = array(
|
|
|
|
'required' => true,
|
2023-12-08 23:23:36 +00:00
|
|
|
'type' => 'string',
|
|
|
|
);
|
|
|
|
|
|
|
|
$params['context'] = array(
|
|
|
|
'type' => 'string',
|
|
|
|
'default' => 'simple',
|
|
|
|
'enum' => array( 'simple', 'full' ),
|
2023-10-22 22:21:44 +00:00
|
|
|
);
|
|
|
|
|
|
|
|
return $params;
|
|
|
|
}
|
|
|
|
}
|