@@ -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 ) { |