@@ -35,6 +35,9 @@ discard block |
||
| 35 | 35 | public $amp_source_origin = null; |
| 36 | 36 | |
| 37 | 37 | /** |
| 38 | + * @param string $method |
|
| 39 | + * @param string $url |
|
| 40 | + * @param string $post_body |
|
| 38 | 41 | * @return WPCOM_JSON_API instance |
| 39 | 42 | */ |
| 40 | 43 | static function init( $method = null, $url = null, $post_body = null ) { |
@@ -348,6 +351,9 @@ discard block |
||
| 348 | 351 | return call_user_func_array( array( $endpoint, 'callback' ), $path_pieces ); |
| 349 | 352 | } |
| 350 | 353 | |
| 354 | + /** |
|
| 355 | + * @param integer $status_code |
|
| 356 | + */ |
|
| 351 | 357 | function output_early( $status_code, $response = null, $content_type = 'application/json' ) { |
| 352 | 358 | $exit = $this->exit; |
| 353 | 359 | $this->exit = false; |
@@ -572,11 +578,18 @@ discard block |
||
| 572 | 578 | return wp_json_encode( $data ); |
| 573 | 579 | } |
| 574 | 580 | |
| 581 | + /** |
|
| 582 | + * @param string $needle |
|
| 583 | + */ |
|
| 575 | 584 | function ends_with( $haystack, $needle ) { |
| 576 | 585 | return $needle === substr( $haystack, -strlen( $needle ) ); |
| 577 | 586 | } |
| 578 | 587 | |
| 579 | 588 | // Returns the site's blog_id in the WP.com ecosystem |
| 589 | + |
|
| 590 | + /** |
|
| 591 | + * @return integer |
|
| 592 | + */ |
|
| 580 | 593 | function get_blog_id_for_output() { |
| 581 | 594 | return $this->token_details['blog_id']; |
| 582 | 595 | } |
@@ -599,6 +612,10 @@ discard block |
||
| 599 | 612 | } |
| 600 | 613 | |
| 601 | 614 | // Returns true if the specified blog ID is a restricted blog |
| 615 | + |
|
| 616 | + /** |
|
| 617 | + * @param integer $blog_id |
|
| 618 | + */ |
|
| 602 | 619 | function is_restricted_blog( $blog_id ) { |
| 603 | 620 | /** |
| 604 | 621 | * Filters all REST API access and return a 403 unauthorized response for all Restricted blog IDs. |
@@ -648,7 +665,7 @@ discard block |
||
| 648 | 665 | /** |
| 649 | 666 | * Counts the number of comments on a site, excluding certain comment types. |
| 650 | 667 | * |
| 651 | - * @param $post_id int Post ID. |
|
| 668 | + * @param integer $post_id int Post ID. |
|
| 652 | 669 | * @return array Array of counts, matching the output of https://developer.wordpress.org/reference/functions/get_comment_count/. |
| 653 | 670 | */ |
| 654 | 671 | public function wp_count_comments( $post_id ) { |