�PNG  IHDR22?�� pHYs  �� OiCCPPhotoshop ICC profilexڝSgTS�=���BK���KoR RB���&*! J�!��Q�EEȠ�����Q, � ��!���������{�kּ������>���� �H3Q5� �B�������.@� $p�d!s�#�~<<+"��x� �M��0���B�\���t�8K�@z�B�@F���&S�`�cb�P-`'������{[�!�� e�Dh;��V�EX0fK�9�-0IWfH���� � 0Q��){`�##x��F�W<�+��*x��<�$9E�[-qWW.(�I+6aa�@.�y�2�4���������x����6��_-��"bb���ϫp@�t~��,/��;�m��%�h^ �u��f�@����W�p�~<�5�j>{�-�]c�K'Xt����o��(�h���w��?�G�%�fI�q^D$.Tʳ?�D��*�A��,���� �`6�B$��BB d�r`)��B(�Ͱ*`/�@4�Qh��p.�U�=p�a��(�� A�a!ڈb�X#����!�H�$ ɈQ"K�5H1R�T UH�=r9�\F��;�2����G1���Q=� �C��7�F� �dt1�����r�=�6��Ыhڏ>C�0��3�l0.��B�8, �c˱"� ���V����cϱw�E� 6wB aAHXLXN�H� $4� 7 �Q�'"��K�&���b21�XH,#��/{�C�7$�C2'��I��T��F�nR#�,��4H#���dk�9�, +ȅ����3��!�[ �b@q��S�(R�jJ��4�e�2AU��Rݨ�T5�ZB���R�Q��4u�9̓IK�����hh�i��t�ݕN��W���G���w ��Ljg(�gw��L�Ӌ�T071���oUX*�*|�� �J�&�*/T����ު U�U�T��^S}�FU3S� Ԗ�U��P�SSg�;���g�oT?�~Y��Y�L�OC�Q��_�� c�x,!k ��u�5�&���|v*�����=���9C3J3W�R�f?�q��tN �(���~���)�)�4L�1e\k����X�H�Q�G�6������E�Y��A�J'\'Gg����S�Sݧ �M=:��.�k���Dw�n��^��Lo��y���}/�T�m���G X� $� �<�5qo</���QC]�@C�a�a�ᄑ��<��F�F�i�\�$�m�mƣ&&!&KM�M�RM��)�;L;L���͢�֙5�=1�2��כ߷`ZxZ,����eI��Z�Yn�Z9Y�XUZ]�F���%ֻ�����N�N���gð�ɶ�����ۮ�m�}agbg�Ů��}�}��= ���Z~s�r:V:ޚΜ�?}����/gX���3��)�i�S��Ggg�s�󈋉K��.�>.���Ƚ�Jt�q]�z���������ۯ�6�i�ܟ�4�)�Y3s���C�Q��? ��0k߬~OCO�g��#/c/�W�װ��w��a�>�>r��>�<7�2�Y_�7��ȷ�O�o�_��C#�d�z����%g��A�[��z|!��?:�e����A���AA�������!h�쐭!��Α�i�P~���a�a��~ '���W�?�p�X�1�5w��Cs�D�D�Dޛg1O9�-J5*>�.j<�7�4�?�.fY��X�XIlK9.*�6nl������� �{�/�]py�����.,:�@L�N8��A*��%�w%� y��g"/�6ш�C\*N�H*Mz�쑼5y$�3�,幄'���L Lݛ:��v m2=:�1����qB�!M��g�g�fvˬe����n��/��k���Y- �B��TZ(�*�geWf�͉�9���+��̳�ې7�����ᒶ��KW-X潬j9�������(�x��oʿ�ܔ���Ĺd�f�f���-�[����n �ڴ �V����E�/��(ۻ��C���<��e����;?T�T�T�T6��ݵa��n��{��4���[���>ɾ�UUM�f�e�I���?�������m]�Nmq����#�׹���=TR��+�G�����w- 6 U����#pDy��� �� :�v�{���vg/jB��F�S��[b[�O�>����z�G��499�?r����C�d�&����ˮ/~�����јѡ�򗓿m|������������x31^�V���w�w��O�| (�h���SЧ��������c3-� cHRMz%������u0�`:�o�_�F5IDATx��ytUս�?�;���fN$$��@B�!�k��� -*�gE���j�O�kQ�ʠ`U�B_ �AÐ0%�Ȕ�@r3ޛ;߳��$�@��v����^�s����������$��ߢ !�W��5�̱'-٘������4�>�Rƫ$�G��0U�H}�_ _� #��k�MJ/=�9Du *ڲ�k�PQ;0��j|�*�$�^컂脛y���>�z×� B��� ��(�:$�ʔ_�6��C!B����MVx��a��ζyY����j��ƋY2�9�F�{r��r�딟F��Q��hY6��� x��[l��RC��������nt@��;P��3��� F�w��7��:�P���ɋ'���mj���Bƪ�$�Q�L��y��߷g��\���z����v5�p�v$�v櫻�`6~K �Y�X����,�:��"�o�e0II"(��,������l_�C���/4�+f�E�!q��:����u����c��樼.UE�@� �]K�W���$-�h]�JG���Dz)�`��.�A/ ���mᏣc�3jK� �!�>���$�Q�!�_�? \�C2(E �M$Z I{�U���s�ǣ���=��@Բe ޻��W�����@ �w����}�9v,)��.}*|"�s��di���,���G�]W�AC�������|<����[��ߕ������K�*�G nߴ!��‹��J�!��6(L�a)��Am��������;adf��:�xm��nh�;֦I��(���o�C~ډa?�=��s����h��E������xp����)���_���t��W�����´;8���`dz=(��@@�+,�;�`�fhl��XȌ�3,uI�~z(J����� �ZX�A����H'�À�㜦�82|��a�n�z2��I���� ���EY�h�ε<�0�q�{��C��v�˅��?"@��χ�x�WS+��N�~�KQ�J�8ل�� _.W��� !TU{�����,��"�� �;�������HI S� ��))�o�1�H�D� ���� (� ;����"Ҕ��,���� �F=���O��&�Ph>�`���y��߲ &S��P�<��'��1s�1cĂ�N����2)����@�u��tv��<�+�-&�����h��[!FSG���' � z z0��<����8d&�����E0�,��<��"!P�b4��� �{S�����X����.�囤���T��hEF��X�q0"-<����h���]�Py*����F⩍��@v�˂�Y08�� .q��a��s����(!<̫1�3�L�H��7sYW�`��qtu�\7��?�@�Y�� %Ka�x�GZ�*W�P��y�����N0r9��Z�c�%���q,��k�����!!,��>���IB��� �x1�Xu�Y���v-���ֺ��N������JP��a�2`�e5��w��u;�6�i���̃��(K���ťa��(l51��JL��O'%���]���ٖ뿉!��{*�p+f ���i8��D�ȑ���ܩ�M��V��ӟz��x�7Z�1i}�^͜���6e����x��)u�d�ˏ�V�eG�\�X1�����=n�U'�~Y����L�\,�(d!x ,�:�TW8� M`r���@��r+v�Q0��>^;˴�VbF��('����� �*O��i��j�Ӆ����^�S3&� ���{������.ی�� N;��NU%d0�Ce\r"�C�b��&t7N�7��� �ȪD�[%l�۪�$��'m?�A9tI�9>��NVL ��� 6v~M�����ъ�B���0����9$&=ώm��W�0���L���&��E���f�f��'+�9��hv��7,���M��6�D�&�^� �����8 D֮�����o��k^z��O��hP�8q�5d*��YVq3�{��������#LX4�?��jP=3�~�؅c�ݰ�̱�ұ��8̲��2�G�����j��έ�9��w7���U�X�w�85C��?!I&���o&����L���I#�^�eV�,�^t5�k� �xs˛\��U�8��."���{���ǵ�l4��ݼ�;��r"���G�/~���gJV�N糦��ZZ^k+NN�D��I$�=OE�z����|*�*{��%k���G��>�`9��b;�s���8,�qs��c��.b��q�%�>r��n�R�Ƨ�%�,�A��le#�8���}; 21�0�b�&�QX�f���q�00����$>�h�N�'�a3��A���/�r ��L5�8�GԲ'�����w;��c#�q1���h$*��V^�k��QĽ�b:i������� ����H F#�_���,��]g����Ը����`RUU���� ��"�qD���>-��ϤI�~��3�̴�����NZ[[555�eeek7�m����YF#[��Đ��R��i��L�H�r ��@��J-�Pŝ��_|�-��6y��ks�V�U~��6���w.����(��0A� 4��f��� /���C�xŊ�ٳ����z=6�����rg���mKo��o�/����a�g���?'9%9��P��斓��~���L{�� �H��{AW��B��$����v�1b�&Mb�ر��ر#�0`�`xMBp! )Z�Nmo�mZ�g�}�eذaWTVV ���'99��C5��&�&+5�bT>|8��PUUETT����&���t��~TE%��'������b�tEGG;RSS�S�N�v��ѯ��t����u1@�ޚ"f��͈���r'L�Ph��m��ƌ�74o��`�x�q�P���NRSS�X,�����l&&&��MFFA!-��`��ҷ�n��Yuu�����x<I�LB%����KԒ50�!�3�bz�����ʸKL���;---�l6[��`��������Ȏ;�����egg4��!D�T��jWujyZ��������K����%����p�^���X,6��sV=�ܖ����6�3�X ���4ҿ��A2�&����_k�;d�� �VfOIEND�B`�
Warning: session_start(): Session cannot be started after headers have already been sent in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 124

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 130

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 131

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 132

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 133

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 134

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 135

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 547

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 548

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 549

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 550

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 551
setup_inputs()`. * @param string|null $url As for `$this->setup_inputs()`. * @param string|null $post_body As for `$this->setup_inputs()`. * @return WPCOM_JSON_API instance */ public static function init( $method = null, $url = null, $post_body = null ) { if ( ! self::$self ) { self::$self = new static( $method, $url, $post_body ); } return self::$self; } /** * Add an endpoint. * * @param WPCOM_JSON_API_Endpoint $endpoint Endpoint to add. */ public function add( WPCOM_JSON_API_Endpoint $endpoint ) { // @todo Determine if anything depends on this being serialized rather than e.g. JSON. // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.serialize_serialize -- Legacy, possibly depended on elsewhere. $path_versions = serialize( array( $endpoint->path, $endpoint->min_version, $endpoint->max_version, ) ); if ( ! isset( $this->endpoints[ $path_versions ] ) ) { $this->endpoints[ $path_versions ] = array(); } $this->endpoints[ $path_versions ][ $endpoint->method ] = $endpoint; } /** * Determine if a string is truthy. If it's not a string, which can happen with * not well-formed data coming from Jetpack sites, we still consider it a truthy value. * * @param mixed $value true, 1, "1", "t", and "true" (case insensitive) are truthy, everything else isn't. * @return bool */ public static function is_truthy( $value ) { if ( true === $value ) { return true; } if ( 1 === $value ) { return true; } if ( ! is_string( $value ) ) { return false; } switch ( strtolower( $value ) ) { case '1': case 't': case 'true': return true; } return false; } /** * Determine if a string is falsey. * * @param mixed $value false, 0, "0", "f", and "false" (case insensitive) are falsey, everything else isn't. * @return bool */ public static function is_falsy( $value ) { if ( false === $value ) { return true; } if ( 0 === $value ) { return true; } if ( ! is_string( $value ) ) { return false; } switch ( strtolower( $value ) ) { case '0': case 'f': case 'false': return true; } return false; } /** * Constructor. * * @todo This should be private. * @param string|null $method As for `$this->setup_inputs()`. * @param string|null $url As for `$this->setup_inputs()`. * @param string|null $post_body As for `$this->setup_inputs()`. */ public function __construct( $method = null, $url = null, $post_body = null ) { $this->setup_inputs( $method, $url, $post_body ); } /** * Setup inputs. * * @param string|null $method Request HTTP method. Fetched from `$_SERVER` if null. * @param string|null $url URL requested. Determined from `$_SERVER` if null. * @param string|null $post_body POST body. Read from `php://input` if null and method is POST. */ public function setup_inputs( $method = null, $url = null, $post_body = null ) { if ( $method === null ) { $this->method = isset( $_SERVER['REQUEST_METHOD'] ) ? strtoupper( filter_var( wp_unslash( $_SERVER['REQUEST_METHOD'] ) ) ) : ''; } else { $this->method = strtoupper( $method ); } if ( $url === null ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Sniff misses the esc_url_raw. $this->url = esc_url_raw( set_url_scheme( 'http://' . ( isset( $_SERVER['HTTP_HOST'] ) ? wp_unslash( $_SERVER['HTTP_HOST'] ) : '' ) . ( isset( $_SERVER['REQUEST_URI'] ) ? wp_unslash( $_SERVER['REQUEST_URI'] ) : '' ) ) ); } else { $this->url = $url; } $parsed = wp_parse_url( $this->url ); if ( ! empty( $parsed['path'] ) ) { $this->path = $parsed['path']; } if ( ! empty( $parsed['query'] ) ) { wp_parse_str( $parsed['query'], $this->query ); } if ( ! empty( $_SERVER['HTTP_ACCEPT'] ) ) { $this->accept = filter_var( wp_unslash( $_SERVER['HTTP_ACCEPT'] ) ); } if ( 'POST' === $this->method ) { if ( $post_body === null ) { $this->post_body = file_get_contents( 'php://input' ); if ( ! empty( $_SERVER['HTTP_CONTENT_TYPE'] ) ) { $this->content_type = filter_var( wp_unslash( $_SERVER['HTTP_CONTENT_TYPE'] ) ); } elseif ( ! empty( $_SERVER['CONTENT_TYPE'] ) ) { $this->content_type = filter_var( wp_unslash( $_SERVER['CONTENT_TYPE'] ) ); } elseif ( isset( $this->post_body[0] ) && '{' === $this->post_body[0] ) { $this->content_type = 'application/json'; } else { $this->content_type = 'application/x-www-form-urlencoded'; } if ( str_starts_with( strtolower( $this->content_type ), 'multipart/' ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing $this->post_body = http_build_query( stripslashes_deep( $_POST ) ); $this->files = $_FILES; $this->content_type = 'multipart/form-data'; } } else { $this->post_body = $post_body; $this->content_type = isset( $this->post_body[0] ) && '{' === $this->post_body[0] ? 'application/json' : 'application/x-www-form-urlencoded'; } } else { $this->post_body = null; $this->content_type = null; } $this->_server_https = array_key_exists( 'HTTPS', $_SERVER ) ? filter_var( wp_unslash( $_SERVER['HTTPS'] ) ) : '--UNset--'; } /** * Initialize. * * @return null|WP_Error (although this implementation always returns null) */ public function initialize() { $this->token_details['blog_id'] = Jetpack_Options::get_option( 'id' ); return null; } /** * Checks if the current request is authorized with a blog token. * This method is overridden by a child class in WPCOM. * * @since 9.1.0 * * @param boolean|int $site_id The site id. * @return boolean */ public function is_jetpack_authorized_for_site( $site_id = false ) { if ( ! $this->token_details ) { return false; } $token_details = (object) $this->token_details; $site_in_token = (int) $token_details->blog_id; if ( $site_in_token < 1 ) { return false; } if ( $site_id && $site_in_token !== (int) $site_id ) { return false; } if ( (int) get_current_user_id() !== 0 ) { // If Jetpack blog token is used, no logged-in user should exist. return false; } return true; } /** * Checks if the current request is authorized with an upload token. * This method is overridden by a child class in WPCOM. * * @since 13.5 * @return boolean */ public function is_authorized_with_upload_token() { return false; } /** * Serve. * * @param bool $exit Whether to exit. * @return string|null Content type (assuming it didn't exit), or null in certain error cases. */ public function serve( $exit = true ) { ini_set( 'display_errors', false ); // phpcs:ignore WordPress.PHP.IniSet.display_errors_Disallowed $this->exit = (bool) $exit; // This was causing problems with Jetpack, but is necessary for wpcom // @see https://github.com/Automattic/jetpack/pull/2603 // @see r124548-wpcom . if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) { add_filter( 'home_url', array( $this, 'ensure_http_scheme_of_home_url' ), 10, 3 ); } add_filter( 'user_can_richedit', '__return_true' ); add_filter( 'comment_edit_pre', array( $this, 'comment_edit_pre' ) ); $initialization = $this->initialize(); if ( 'OPTIONS' === $this->method ) { /** * Fires before the page output. * Can be used to specify custom header options. * * @module json-api * * @since 3.1.0 */ do_action( 'wpcom_json_api_options' ); return $this->output( 200, '', 'text/plain' ); } if ( is_wp_error( $initialization ) ) { $this->output_error( $initialization ); return; } // Normalize path and extract API version. $this->path = untrailingslashit( $this->path ); if ( preg_match( '#^/rest/v(\d+(\.\d+)*)#', $this->path, $matches ) ) { $this->path = substr( $this->path, strlen( $matches[0] ) ); $this->version = $matches[1]; } $allowed_methods = array( 'GET', 'POST' ); $four_oh_five = false; $is_help = preg_match( '#/help/?$#i', $this->path ); $matching_endpoints = array(); if ( $is_help ) { $origin = get_http_origin(); if ( ! empty( $origin ) && 'GET' === $this->method ) { header( 'Access-Control-Allow-Origin: ' . esc_url_raw( $origin ) ); } $this->path = substr( rtrim( $this->path, '/' ), 0, -5 ); // Show help for all matching endpoints regardless of method. $methods = $allowed_methods; $find_all_matching_endpoints = true; // How deep to truncate each endpoint's path to see if it matches this help request. $depth = substr_count( $this->path, '/' ) + 1; if ( false !== stripos( $this->accept, 'javascript' ) || false !== stripos( $this->accept, 'json' ) ) { $help_content_type = 'json'; } else { $help_content_type = 'html'; } } elseif ( in_array( $this->method, $allowed_methods, true ) ) { // Only serve requested method. $methods = array( $this->method ); $find_all_matching_endpoints = false; } else { // We don't allow this requested method - find matching endpoints and send 405. $methods = $allowed_methods; $find_all_matching_endpoints = true; $four_oh_five = true; } // Find which endpoint to serve. $found = false; $path_pieces = array(); foreach ( $this->endpoints as $endpoint_path_versions => $endpoints_by_method ) { // @todo Determine if anything depends on this being serialized rather than e.g. JSON. // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.serialize_unserialize -- Legacy, possibly depended on elsewhere. $endpoint_path_versions = unserialize( $endpoint_path_versions ); $endpoint_path = $endpoint_path_versions[0]; $endpoint_min_version = $endpoint_path_versions[1]; $endpoint_max_version = $endpoint_path_versions[2]; // Make sure max_version is not less than min_version. if ( version_compare( $endpoint_max_version, $endpoint_min_version, '<' ) ) { $endpoint_max_version = $endpoint_min_version; } foreach ( $methods as $method ) { if ( ! isset( $endpoints_by_method[ $method ] ) ) { continue; } // Normalize. $endpoint_path = untrailingslashit( $endpoint_path ); if ( $is_help ) { // Truncate path at help depth. // @phan-suppress-next-line PhanPossiblyUndeclaredVariable -- $depth is set when $is_help is true. $endpoint_path = implode( '/', array_slice( explode( '/', $endpoint_path ), 0, $depth ) ); } // Generate regular expression from sprintf(). $endpoint_path_regex = str_replace( array( '%s', '%d' ), array( '([^/?&]+)', '(\d+)' ), $endpoint_path ); if ( ! preg_match( "#^$endpoint_path_regex\$#", $this->path, $path_pieces ) ) { // This endpoint does not match the requested path. continue; } if ( version_compare( $this->version, $endpoint_min_version, '<' ) || version_compare( $this->version, $endpoint_max_version, '>' ) ) { // This endpoint does not match the requested version. continue; } $found = true; if ( $find_all_matching_endpoints ) { $matching_endpoints[] = array( $endpoints_by_method[ $method ], $path_pieces ); } else { // The method parameters are now in $path_pieces. $endpoint = $endpoints_by_method[ $method ]; break 2; } } } if ( ! $found ) { return $this->output( 404, '', 'text/plain' ); } if ( $four_oh_five ) { $allowed_methods = array(); foreach ( $matching_endpoints as $matching_endpoint ) { $allowed_methods[] = $matching_endpoint[0]->method; } header( 'Allow: ' . strtoupper( implode( ',', array_unique( $allowed_methods ) ) ) ); return $this->output( 405, array( 'error' => 'not_allowed', 'error_message' => 'Method not allowed', ) ); } if ( $is_help ) { /** * Fires before the API output. * * @since 1.9.0 * * @param string help. */ do_action( 'wpcom_json_api_output', 'help' ); $proxied = function_exists( 'wpcom_is_proxied_request' ) ? wpcom_is_proxied_request() : false; // @phan-suppress-next-line PhanPossiblyUndeclaredVariable -- $help_content_type is set when $is_help is true. if ( 'json' === $help_content_type ) { $docs = array(); foreach ( $matching_endpoints as $matching_endpoint ) { if ( $matching_endpoint[0]->is_publicly_documentable() || $proxied || WPCOM_JSON_API__DEBUG ) { $docs[] = call_user_func( array( $matching_endpoint[0], 'generate_documentation' ) ); } } return $this->output( 200, $docs ); } else { status_header( 200 ); foreach ( $matching_endpoints as $matching_endpoint ) { if ( $matching_endpoint[0]->is_publicly_documentable() || $proxied || WPCOM_JSON_API__DEBUG ) { call_user_func( array( $matching_endpoint[0], 'document' ) ); } } } exit( 0 ); } // @phan-suppress-next-line PhanPossiblyUndeclaredVariable -- $endpoint is set when $find_all_matching_endpoints is false and $found is true, which is guaranteed here. if ( $endpoint->in_testing && ! WPCOM_JSON_API__DEBUG ) { return $this->output( 404, '', 'text/plain' ); } /** This action is documented in class.json-api.php */ // @phan-suppress-next-line PhanPossiblyUndeclaredVariable -- $endpoint is set when $find_all_matching_endpoints is false and $found is true, which is guaranteed here. do_action( 'wpcom_json_api_output', $endpoint->stat ); // @phan-suppress-next-line PhanPossiblyUndeclaredVariable -- $endpoint is set when $find_all_matching_endpoints is false and $found is true, which is guaranteed here. $response = $this->process_request( $endpoint, $path_pieces ); if ( ! $response && ! is_array( $response ) ) { return $this->output( 500, '', 'text/plain' ); } elseif ( is_wp_error( $response ) ) { return $this->output_error( $response ); } $output_status_code = $this->output_status_code; $this->set_output_status_code(); return $this->output( $output_status_code, $response, 'application/json', $this->extra_headers ); } /** * Process a request. * * @param WPCOM_JSON_API_Endpoint $endpoint Endpoint. * @param array $path_pieces Path pieces. * @return array|WP_Error Return value from the endpoint's callback. */ public function process_request( WPCOM_JSON_API_Endpoint $endpoint, $path_pieces ) { $this->endpoint = $endpoint; $this->maybe_switch_to_token_user_and_site(); return call_user_func_array( array( $endpoint, 'callback' ), $path_pieces ); } /** * Output a response or error without exiting. * * @param int $status_code HTTP status code. * @param mixed $response Response data. * @param string $content_type Content type of the response. */ public function output_early( $status_code, $response = null, $content_type = 'application/json' ) { $exit = $this->exit; $this->exit = false; if ( is_wp_error( $response ) ) { $this->output_error( $response ); } else { $this->output( $status_code, $response, $content_type ); } $this->exit = $exit; if ( ! defined( 'XMLRPC_REQUEST' ) || ! XMLRPC_REQUEST ) { $this->finish_request(); } } /** * Set output status code. * * @param int $code HTTP status code. */ public function set_output_status_code( $code = 200 ) { $this->output_status_code = $code; } /** * Output a response. * * @param int $status_code HTTP status code. * @param mixed $response Response data. * @param string $content_type Content type of the response. * @param array $extra Additional HTTP headers. * @return string Content type (assuming it didn't exit). */ public function output( $status_code, $response = null, $content_type = 'application/json', $extra = array() ) { $status_code = (int) $status_code; // In case output() was called before the callback returned. if ( $this->did_output ) { if ( $this->exit ) { exit( 0 ); } return $content_type; } $this->did_output = true; // 400s and 404s are allowed for all origins if ( 404 === $status_code || 400 === $status_code ) { header( 'Access-Control-Allow-Origin: *' ); } /* Add headers for form submission from */ if ( $this->amp_source_origin ) { header( 'Access-Control-Allow-Origin: ' . wp_unslash( $this->amp_source_origin ) ); header( 'Access-Control-Allow-Credentials: true' ); } if ( $response === null ) { $response = new stdClass(); } if ( 'text/plain' === $content_type || 'text/html' === $content_type ) { status_header( $status_code ); header( 'Content-Type: ' . $content_type ); foreach ( $extra as $key => $value ) { header( "$key: $value" ); } echo $response; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped if ( $this->exit ) { exit( 0 ); } return $content_type; } $response = $this->filter_fields( $response ); if ( isset( $this->query['http_envelope'] ) && self::is_truthy( $this->query['http_envelope'] ) ) { $response = static::wrap_http_envelope( $status_code, $response, $content_type, $extra ); $status_code = 200; $content_type = 'application/json'; } status_header( $status_code ); header( "Content-Type: $content_type" ); if ( isset( $this->query['callback'] ) && is_string( $this->query['callback'] ) ) { $callback = preg_replace( '/[^a-z0-9_.]/i', '', $this->query['callback'] ); } else { $callback = false; } if ( $callback ) { // Mitigate Rosetta Flash [1] by setting the Content-Type-Options: nosniff header // and by prepending the JSONP response with a JS comment. // [1] . echo "/**/$callback("; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- This is JSONP output, not HTML. } echo $this->json_encode( $response, JSON_UNESCAPED_SLASHES ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- This is JSON or JSONP output, not HTML. if ( $callback ) { echo ');'; } if ( $this->exit ) { exit( 0 ); } return $content_type; } /** * Wrap JSON API response into an HTTP 200 one. * * @param int $status_code HTTP status code. * @param mixed $response Response body. * @param string $content_type Content type. * @param array|null $extra Extra data. * * @return array */ public static function wrap_http_envelope( $status_code, $response, $content_type, $extra = null ) { $headers = array( array( 'name' => 'Content-Type', 'value' => $content_type, ), ); if ( is_array( $extra ) ) { foreach ( $extra as $key => $value ) { $headers[] = array( 'name' => $key, 'value' => $value, ); } } return array( 'code' => (int) $status_code, 'headers' => $headers, 'body' => $response, ); } /** * Serialize an error. * * @param WP_Error $error Error. * @return array with 'status_code' and 'errors' data. */ public static function serializable_error( $error ) { // A missing or non-numeric status resolves to 0 and defaults to 400. Valid HTTP codes, including sub-400 ones, are preserved. $data = $error->get_error_data(); $status_code = ( is_array( $data ) && isset( $data['status_code'] ) ) ? $data['status_code'] : $data; $status_code = is_numeric( $status_code ) ? (int) $status_code : 0; if ( ! $status_code ) { $status_code = 400; } $response = array( 'error' => $error->get_error_code(), 'message' => $error->get_error_message(), ); $additional_data = $error->get_error_data( 'additional_data' ); if ( $additional_data ) { $response['data'] = $additional_data; } return array( 'status_code' => $status_code, 'errors' => $response, ); } /** * Output an error. * * @param WP_Error $error Error. * @return string Content type (assuming it didn't exit). */ public function output_error( $error ) { $error_response = static::serializable_error( $error ); return $this->output( $error_response['status_code'], $error_response['errors'] ); } /** * Filter fields in a response. * * @param array|object $response Response. * @return array|object Filtered response. */ public function filter_fields( $response ) { if ( empty( $this->query['fields'] ) || ( is_array( $response ) && ! empty( $response['error'] ) ) || ! empty( $this->endpoint->custom_fields_filtering ) ) { return $response; } $fields = array_map( 'trim', explode( ',', $this->query['fields'] ) ); if ( is_object( $response ) ) { $response = (array) $response; } $has_filtered = false; if ( is_array( $response ) && empty( $response['ID'] ) ) { $keys_to_filter = array( 'categories', 'comments', 'connections', 'domains', 'groups', 'likes', 'media', 'notes', 'posts', 'services', 'sites', 'suggestions', 'tags', 'themes', 'topics', 'users', ); foreach ( $keys_to_filter as $key_to_filter ) { if ( ! isset( $response[ $key_to_filter ] ) || $has_filtered ) { continue; } foreach ( $response[ $key_to_filter ] as $key => $values ) { if ( is_object( $values ) ) { if ( is_object( $response[ $key_to_filter ] ) ) { $response[ $key_to_filter ]->$key = (object) array_intersect_key( ( (array) $values ), array_flip( $fields ) ); } elseif ( is_array( $response[ $key_to_filter ] ) ) { $response[ $key_to_filter ][ $key ] = (object) array_intersect_key( ( (array) $values ), array_flip( $fields ) ); } } elseif ( is_array( $values ) ) { $response[ $key_to_filter ][ $key ] = array_intersect_key( $values, array_flip( $fields ) ); } } $has_filtered = true; } } if ( ! $has_filtered ) { if ( is_object( $response ) ) { $response = (object) array_intersect_key( (array) $response, array_flip( $fields ) ); } elseif ( is_array( $response ) ) { $response = array_intersect_key( $response, array_flip( $fields ) ); } } return $response; } /** * Filter for `home_url`. * * If `$original_scheme` is null, turns an https URL to http. * * @param string $url The complete home URL including scheme and path. * @param string $path Path relative to the home URL. Blank string if no path is specified. * @param string|null $original_scheme Scheme to give the home URL context. Accepts 'http', 'https', 'relative', 'rest', or null. * @return string URL. */ public function ensure_http_scheme_of_home_url( $url, $path, $original_scheme ) { if ( $original_scheme ) { return $url; } return preg_replace( '#^https:#', 'http:', $url ); } /** * Decode HTML special characters in comment content. * * @param string $comment_content Comment content. * @return string */ public function comment_edit_pre( $comment_content ) { return htmlspecialchars_decode( $comment_content, ENT_QUOTES ); } /** * JSON encode. * * @param mixed $value The value to encode. * @param int $flags Options to be passed to json_encode(). Default 0. * @param int $depth Maximum depth to walk through $value. Must be greater than 0. * * @return string|false */ public function json_encode( $value, $flags = 0, $depth = 512 ) { return wp_json_encode( $value, $flags, $depth ); } /** * Test if a string ends with a string. * * @param string $haystack String to check. * @param string $needle Suffix to check. * @return bool */ public function ends_with( $haystack, $needle ) { return substr( $haystack, -strlen( $needle ) ) === $needle; } /** * Returns the site's blog_id in the WP.com ecosystem * * @return int */ public function get_blog_id_for_output() { return $this->token_details['blog_id']; } /** * Returns the site's local blog_id. * * @param int $blog_id Blog ID. * @return int */ public function get_blog_id( $blog_id ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable return $GLOBALS['blog_id']; } /** * Switch to blog and validate user. * * @param int $blog_id Blog ID. * @param bool $verify_token_for_blog Whether to verify the token. * @return int Blog ID. */ public function switch_to_blog_and_validate_user( $blog_id = 0, $verify_token_for_blog = true ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable if ( $this->is_restricted_blog( $blog_id ) ) { return new WP_Error( 'unauthorized', 'User cannot access this restricted blog', 403 ); } /** * If this is a private site we check for 2 things: * 1. In case of user based authentication, we need to check if the logged-in user has the 'read' capability. * 2. In case of site based authentication, make sure the endpoint accepts it. */ if ( ( new Status() )->is_private_site() && ! current_user_can( 'read' ) && ! $this->endpoint->accepts_site_based_authentication() ) { return new WP_Error( 'unauthorized', 'User cannot access this private blog.', 403 ); } return $blog_id; } /** * Switch to a user and blog based on the current request's Jetpack token when the endpoint accepts this feature. * * @return void */ protected function maybe_switch_to_token_user_and_site() { if ( ! $this->endpoint->allow_jetpack_token_auth ) { return; } if ( ! class_exists( 'Jetpack_Server_Version' ) ) { return; } $token = Jetpack_Server_Version::get_token_from_authorization_header(); if ( ! $token || is_wp_error( $token ) ) { return; } if ( get_current_user_id() !== $token->user_id ) { wp_set_current_user( $token->user_id ); } if ( get_current_blog_id() !== $token->blog_id ) { switch_to_blog( $token->blog_id ); } } /** * Returns true if the specified blog ID is a restricted blog * * @param int $blog_id Blog ID. * @return bool */ public function is_restricted_blog( $blog_id ) { /** * Filters all REST API access and return a 403 unauthorized response for all Restricted blog IDs. * * @module json-api * * @since 3.4.0 * * @param array $array Array of Blog IDs. */ $restricted_blog_ids = apply_filters( 'wpcom_json_api_restricted_blog_ids', array() ); return in_array( $blog_id, $restricted_blog_ids ); // phpcs:ignore WordPress.PHP.StrictInArray.MissingTrueStrict -- I don't trust filters to return the right types. } /** * Post like count. * * @param int $blog_id Blog ID. * @param int $post_id Post ID. * @return int */ public function post_like_count( $blog_id, $post_id ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable return 0; } /** * Is liked? * * @param int $blog_id Blog ID. * @param int $post_id Post ID. * @return bool */ public function is_liked( $blog_id, $post_id ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable return false; } /** * Is reblogged? * * @param int $blog_id Blog ID. * @param int $post_id Post ID. * @return bool */ public function is_reblogged( $blog_id, $post_id ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable return false; } /** * Is following? * * @param int $blog_id Blog ID. * @return bool */ public function is_following( $blog_id ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable return false; } /** * Add global ID. * * @param int $blog_id Blog ID. * @param int $post_id Post ID. * @return string */ public function add_global_ID( $blog_id, $post_id ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable, WordPress.NamingConventions.ValidFunctionName.MethodNameInvalid return ''; } /** * Return a count of comment likes. * This method is overridden by a child class in WPCOM. * * @since 13.5 * @return int */ public function comment_like_count() { func_get_args(); // @phan-suppress-current-line PhanPluginUseReturnValueInternalKnown -- This is just here so Phan realizes the wpcom version does this. return 0; } /** * Get avatar URL. * * @param string $email Email. * @param array $args Args for `get_avatar_url()`. * @return string|false */ public function get_avatar_url( $email, $args = null ) { if ( function_exists( 'wpcom_get_avatar_url' ) ) { $ret = wpcom_get_avatar_url( $email, $args['size'] ?? 96, $args['default'] ?? '', false, $args['force_default'] ?? false ); return $ret ? $ret[0] : false; } else { return null === $args ? get_avatar_url( $email ) : get_avatar_url( $email, $args ); } } /** * Counts the number of comments on a site, including certain comment types. * * @param int $post_id Post ID. * @return object The number of counts keyed by status, matching the output of https://developer.wordpress.org/reference/functions/get_comment_count/. */ public function wp_count_comments( $post_id ) { global $wpdb; if ( 0 !== $post_id ) { return wp_count_comments( $post_id ); } $counts = array( 'total_comments' => 0, 'all' => 0, ); /** * Exclude certain comment types from comment counts in the REST API. * * @since 6.9.0 * @deprecated 11.1 * @module json-api * * @param array Array of comment types to exclude (default: 'order_note', 'webhook_delivery', 'review', 'action_log') */ $exclude = apply_filters_deprecated( 'jetpack_api_exclude_comment_types_count', array( 'order_note', 'webhook_delivery', 'review', 'action_log' ), 'jetpack-11.1', 'jetpack_api_include_comment_types_count' ); // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable /** * Include certain comment types in comment counts in the REST API. * Note: the default array of comment types includes an empty string, * to support comments posted before WP 5.5, that used an empty string as comment type. * * @since 11.1 * @module json-api * * @param array Array of comment types to include (default: 'comment', 'pingback', 'trackback') */ $include = apply_filters( 'jetpack_api_include_comment_types_count', array( 'comment', 'pingback', 'trackback', '' ) ); if ( empty( $include ) ) { return wp_count_comments( $post_id ); } // The following caching mechanism is based on what the get_comments() function uses. $key = md5( serialize( $include ) ); // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.serialize_serialize $last_changed = wp_cache_get_last_changed( 'comment' ); $cache_key = "wp_count_comments:$key:$last_changed"; $count = wp_cache_get( $cache_key, 'jetpack-json-api' ); if ( false === $count ) { array_walk( $include, 'esc_sql' ); $where = sprintf( "WHERE comment_type IN ( '%s' )", implode( "','", $include ) ); // phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- `$where` is built with escaping just above. $count = $wpdb->get_results( "SELECT comment_approved, COUNT(*) AS num_comments FROM $wpdb->comments {$where} GROUP BY comment_approved " ); // phpcs:enable WordPress.DB.PreparedSQL.InterpolatedNotPrepared wp_cache_add( $cache_key, $count, 'jetpack-json-api' ); } $approved = array( '0' => 'moderated', '1' => 'approved', 'spam' => 'spam', 'trash' => 'trash', 'post-trashed' => 'post-trashed', ); // foreach ( $count as $row ) { if ( ! in_array( $row->comment_approved, array( 'post-trashed', 'trash', 'spam' ), true ) ) { $counts['all'] += $row->num_comments; $counts['total_comments'] += $row->num_comments; } elseif ( ! in_array( $row->comment_approved, array( 'post-trashed', 'trash' ), true ) ) { $counts['total_comments'] += $row->num_comments; } if ( isset( $approved[ $row->comment_approved ] ) ) { $counts[ $approved[ $row->comment_approved ] ] = $row->num_comments; } } foreach ( $approved as $key ) { if ( empty( $counts[ $key ] ) ) { $counts[ $key ] = 0; } } $counts = (object) $counts; return $counts; } /** * Traps `wp_die()` calls and outputs a JSON response instead. * The result is always output, never returned. * * @param string|null $error_code Call with string to start the trapping. Call with null to stop. * @param int $http_status HTTP status code, 400 by default. */ public function trap_wp_die( $error_code = null, $http_status = 400 ) { // Determine the filter name; based on the conditionals inside the wp_die function. if ( wp_is_json_request() ) { $die_handler = 'wp_die_json_handler'; } elseif ( wp_is_jsonp_request() ) { $die_handler = 'wp_die_jsonp_handler'; } elseif ( wp_is_xml_request() ) { $die_handler = 'wp_die_xml_handler'; } else { $die_handler = 'wp_die_handler'; } if ( $error_code === null ) { $this->trapped_error = null; // Stop trapping. remove_filter( $die_handler, array( $this, 'wp_die_handler_callback' ) ); return; } // If API called via PHP, bail: don't do our custom wp_die(). Do the normal wp_die(). if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) { if ( ! defined( 'REST_API_REQUEST' ) || ! REST_API_REQUEST ) { return; } } elseif ( ! defined( 'XMLRPC_REQUEST' ) || ! XMLRPC_REQUEST ) { return; } $this->trapped_error = array( 'status' => $http_status, 'code' => $error_code, 'message' => '', ); // Start trapping. add_filter( $die_handler, array( $this, 'wp_die_handler_callback' ) ); } /** * Filter function for `wp_die_handler` and similar filters. * * @return callable */ public function wp_die_handler_callback() { return array( $this, 'wp_die_handler' ); } /** * Handler for `wp_die` calls. * * @param string|WP_Error $message As for `wp_die()`. * @param string|int $title As for `wp_die()`. * @param string|array|int $args As for `wp_die()`. * @return never */ public function wp_die_handler( $message, $title = '', $args = array() ) { // Allow wp_die calls to override HTTP status code... $args = wp_parse_args( $args, array( 'response' => $this->trapped_error['status'], ) ); // ... unless it's 500 if ( 500 !== (int) $args['response'] ) { $this->trapped_error['status'] = $args['response']; } if ( $title ) { $message = "$title: $message"; } $this->trapped_error['message'] = wp_kses( $message, array() ); switch ( $this->trapped_error['code'] ) { case 'comment_failure': if ( did_action( 'comment_duplicate_trigger' ) ) { $this->trapped_error['code'] = 'comment_duplicate'; } elseif ( did_action( 'comment_flood_trigger' ) ) { $this->trapped_error['code'] = 'comment_flood'; } break; } // We still want to exit so that code execution stops where it should. // Attach the JSON output to the WordPress shutdown handler. add_action( 'shutdown', array( $this, 'output_trapped_error' ), 0 ); exit( 0 ); } /** * Output the trapped error. */ public function output_trapped_error() { $this->exit = false; // We're already exiting once. Don't do it twice. $this->output( $this->trapped_error['status'], (object) array( 'error' => $this->trapped_error['code'], 'message' => $this->trapped_error['message'], ) ); } /** * Finish the request. */ public function finish_request() { if ( function_exists( 'fastcgi_finish_request' ) ) { return fastcgi_finish_request(); } } /** * Initialize the locale if different from 'en'. * * @param string $locale The locale to initialize. */ public function init_locale( $locale ) { if ( 'en' !== $locale ) { // .org mo files are named slightly different from .com, and all we have is this the locale -- try to guess them. $new_locale = $locale; if ( str_contains( $locale, '-' ) ) { $locale_pieces = explode( '-', $locale ); $new_locale = $locale_pieces[0]; $new_locale .= ( ! empty( $locale_pieces[1] ) ) ? '_' . strtoupper( $locale_pieces[1] ) : ''; } else { // phpcs:ignore Universal.ControlStructures.DisallowLonelyIf.Found // .com might pass 'fr' because thats what our language files are named as, where core seems // to do fr_FR - so try that if we don't think we can load the file. if ( ! file_exists( WP_LANG_DIR . '/' . $locale . '.mo' ) ) { $new_locale = $locale . '_' . strtoupper( $locale ); } } if ( file_exists( WP_LANG_DIR . '/' . $new_locale . '.mo' ) ) { unload_textdomain( 'default' ); load_textdomain( 'default', WP_LANG_DIR . '/' . $new_locale . '.mo' ); } } } }