'; add_action( 'jetpack_modules_loaded', 'stats_load' ); /** * Load Stats. * * @access public * @return void */ function stats_load() { Jetpack::enable_module_configurable( __FILE__ ); // Only run the callback for those who can see the stats. if ( is_user_logged_in() && current_user_can( 'view_stats' ) ) { add_action( 'admin_head', 'stats_admin_bar_head', 100 ); add_action( 'wp_head', 'stats_admin_bar_head', 100 ); } Admin_Post_List_Column::register(); add_action( 'jetpack_admin_menu', 'stats_admin_menu' ); add_filter( 'pre_option_db_version', 'stats_ignore_db_version' ); // Filter for adding the Jetpack plugin version to tracking stats. add_filter( 'stats_array', 'filter_stats_array_add_jp_version' ); require_once __DIR__ . '/stats/class-jetpack-stats-upgrade-nudges.php'; add_action( 'updating_jetpack_version', array( 'Jetpack_Stats_Upgrade_Nudges', 'unset_nudges_setting' ) ); } /** * Checks if filter is set and dnt is enabled. * * @deprecated 11.5 * @return bool */ function jetpack_is_dnt_enabled() { _deprecated_function( __METHOD__, 'jetpack-11.5', 'Automattic\Jetpack\Stats\Main::jetpack_is_dnt_enabled' ); return Stats::jetpack_is_dnt_enabled(); } /** * Prevent sparkline img requests being redirected to upgrade.php. * See wp-admin/admin.php where it checks $wp_db_version. * * @access public * @param mixed $version Version. * @return string $version. */ function stats_ignore_db_version( $version ) { if ( is_admin() && isset( $_GET['page'] ) && 'stats' === $_GET['page'] && // phpcs:ignore WordPress.Security.NonceVerification.Recommended isset( $_GET['chart'] ) && strpos( $_GET['chart'], 'admin-bar-hours' ) === 0 // phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.Security.ValidatedSanitizedInput ) { global $wp_db_version; return $wp_db_version; } return $version; } /** * Maps view_stats cap to read cap as needed. * * @deprecated 11.5 * * @access public * @param mixed $caps Caps. * @param mixed $cap Cap. * @param mixed $user_id User ID. * @return array Possibly mapped capabilities for meta capability. */ function stats_map_meta_caps( $caps, $cap, $user_id ) { _deprecated_function( __METHOD__, 'jetpack-11.5', 'Automattic\Jetpack\Stats\Main::map_meta_caps' ); return Stats::map_meta_caps( $caps, $cap, $user_id ); } /** * Stats Template Redirect. * * @deprecated 11.5 * @access public * @return void */ function stats_template_redirect() { _deprecated_function( __METHOD__, 'jetpack-11.5', 'Automattic\Jetpack\Stats\Main::template_redirect' ); Stats::template_redirect(); } /** * Stats Build View Data. * * @deprecated 11.5 * @access public * @return array */ function stats_build_view_data() { _deprecated_function( __METHOD__, 'jetpack-11.5', 'Automattic\Jetpack\Stats\Tracking_Pixel::build_view_data' ); return Stats_Tracking_Pixel::build_view_data(); } /** * Stats Get Options. * * @deprecated 11.5 * * @access public * @return array */ function stats_get_options() { _deprecated_function( __METHOD__, 'jetpack-11.5', 'Automattic\Jetpack\Stats\Options::get_options' ); return Stats_Options::get_options(); } /** * Get Stats Options. * * @deprecated 11.5 * * @access public * @param mixed $option Option. * @return mixed|null */ function stats_get_option( $option ) { _deprecated_function( __METHOD__, 'jetpack-11.5', 'Automattic\Jetpack\Stats\Options::get_option' ); return Stats_Options::get_option( $option ); } /** * Stats Set Options. * * @deprecated 11.5 * * @access public * @param mixed $option Option. * @param mixed $value Value. * @return bool */ function stats_set_option( $option, $value ) { _deprecated_function( __METHOD__, 'jetpack-11.5', 'Automattic\Jetpack\Stats\Options::set_option' ); return Stats_Options::set_option( $option, $value ); } /** * Stats Set Options. * * @deprecated 11.5 * * @access public * @param mixed $options Options. * @return bool */ function stats_set_options( $options ) { _deprecated_function( __METHOD__, 'jetpack-11.5', 'Automattic\Jetpack\Stats\Options::set_options' ); return Stats_Options::set_options( $options ); } /** * Stats Upgrade Options. * * @deprecated 11.5 * * @access public * @param mixed $options Options. * @return array|bool */ function stats_upgrade_options( $options ) { _deprecated_function( __METHOD__, 'jetpack-11.5', 'Automattic\Jetpack\Stats\Options::upgrade_options' ); return Stats_Options::upgrade_options( $options ); } /** * Admin Pages. * * @access public * @return void */ function stats_admin_menu() { global $pagenow; // If we're at an old Stats URL, redirect to the new one. // Don't even bother with caps, menu_page_url(), etc. Just do it. if ( 'index.php' === $pagenow && isset( $_GET['page'] ) && 'stats' === $_GET['page'] ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended $redirect_url = str_replace( array( '/wp-admin/index.php?', '/wp-admin/?' ), '/wp-admin/admin.php?', isset( $_SERVER['REQUEST_URI'] ) ? filter_var( wp_unslash( $_SERVER['REQUEST_URI'] ) ) : null ); $relative_pos = strpos( $redirect_url, '/wp-admin/' ); if ( false !== $relative_pos ) { wp_safe_redirect( admin_url( substr( $redirect_url, $relative_pos + 10 ) ) ); exit( 0 ); } } // phpcs:ignore WordPress.Security.NonceVerification.Recommended if ( ! ( new Host() )->is_woa_site() && isset( $_GET['enable_new_stats'] ) && '1' === $_GET['enable_new_stats'] ) { // Passing true enables Odyssey Stats. // We're ignorning the return value for now. Stats_Main::update_new_stats_status( true ); } // phpcs:ignore WordPress.Security.NonceVerification.Recommended if ( ! Stats_Options::get_option( 'enable_odyssey_stats' ) || isset( $_GET['noheader'] ) ) { // Show old Jetpack Stats interface for: // - When the "enable_odyssey_stats" option is disabled. // - When being shown in the adminbar outside of wp-admin. $hook = Admin_Menu::add_menu( __( 'Stats', 'jetpack' ), __( 'Stats', 'jetpack' ), 'view_stats', 'stats', 'jetpack_admin_ui_stats_report_page_wrapper' ); add_action( "load-$hook", 'stats_reports_load' ); } else { // Enable the new Odyssey Stats experience. $stats_dashboard = new Stats_Dashboard(); $hook = Admin_Menu::add_menu( __( 'Stats', 'jetpack' ), __( 'Stats', 'jetpack' ), 'view_stats', 'stats', array( $stats_dashboard, 'render' ), 1 ); add_action( "load-$hook", array( $stats_dashboard, 'admin_init' ) ); } } /** * Stats Admin Path. * * @access public * @return string */ function stats_admin_path() { return Jetpack::module_configuration_url( __FILE__ ); } /** * Stats Reports Load. * * @access public * @return void */ function stats_reports_load() { require_once __DIR__ . '/stats/class-jetpack-stats-upgrade-nudges.php'; Jetpack_Stats_Upgrade_Nudges::init(); wp_enqueue_script( 'jquery' ); wp_enqueue_script( 'postbox' ); wp_enqueue_script( 'underscore' ); Jetpack_Admin_Page::load_wrapper_styles(); add_action( 'admin_print_styles', 'stats_reports_css' ); if ( ! empty( $_GET['nojs'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended $parsed = wp_parse_url( admin_url() ); // Remember user doesn't want JS. setcookie( 'stnojs', '1', time() + 172800, $parsed['path'], COOKIE_DOMAIN, is_ssl(), true ); // 2 days. } if ( ! empty( $_COOKIE['stnojs'] ) ) { // Detect if JS is on. If so, remove cookie so next page load is via JS. add_action( 'admin_print_footer_scripts', 'stats_js_remove_stnojs_cookie' ); } elseif ( ! isset( $_GET['noheader'] ) && empty( $_GET['nojs'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended // Normal page load. Load page content via JS. add_action( 'admin_print_footer_scripts', 'stats_script_dismiss_nudge_handler' ); } } /** * JavaScript to dismiss the Odyssey nudge. * * @access public * @return void */ function stats_script_dismiss_nudge_handler() { ?> true ) ); } else { stats_reports_page(); } } /** * Stats Report Page. * * @access public * @param bool $main_chart_only (default: false) Main Chart Only. */ function stats_reports_page( $main_chart_only = false ) { if ( isset( $_GET['dashboard'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended stats_dashboard_widget_content(); exit( 0 ); // @phan-suppress-current-line PhanPluginUnreachableCode -- Safer to include it even though stats_dashboard_widget_content() never returns. } $blog_id = Stats_Options::get_option( 'blog_id' ); $learn_url = Redirect::get_url( 'jetpack-stats-learn-more' ); $redirect_url = admin_url( 'admin.php?page=stats&enable_new_stats=1' ); $stats_bg_url = plugins_url( 'images/odyssey-upgrade/background.png', JETPACK__PLUGIN_FILE ); $stats_bg_gradient_url = plugins_url( 'images/odyssey-upgrade/gradient.png', JETPACK__PLUGIN_FILE ); if ( ! $main_chart_only && ! isset( $_GET['noheader'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended ?>

'true', 'proxy' => '', 'page' => 'stats', 'day' => $day, 'blog' => $blog_id, 'charset' => get_option( 'blog_charset' ), 'color' => get_user_option( 'admin_color' ), 'ssl' => is_ssl(), 'j' => sprintf( '%s:%s', JETPACK__API_VERSION, JETPACK__VERSION ), ); if ( get_locale() !== 'en_US' ) { $q['jp_lang'] = get_locale(); } // Only show the main chart, without extra header data, or metaboxes. $q['main_chart_only'] = $main_chart_only; $args = array( 'view' => array( 'referrers', 'postviews', 'searchterms', 'clicks', 'post', 'table' ), 'numdays' => 'int', 'day' => 'date', 'unit' => array( '1', '7', '31', 'human' ), 'humanize' => array( 'true' ), 'num' => 'int', 'summarize' => null, 'post' => 'int', 'width' => 'int', 'height' => 'int', 'data' => 'data', 'blog_subscribers' => 'int', 'comment_subscribers' => null, 'type' => array( 'wpcom', 'email', 'pending' ), 'pagenum' => 'int', 'masterbar' => null, ); foreach ( $args as $var => $vals ) { if ( ! isset( $_REQUEST[ $var ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended continue; } $val = wp_unslash( $_REQUEST[ $var ] ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized if ( is_array( $vals ) ) { if ( in_array( $val, $vals, true ) ) { $q[ $var ] = $val; } } elseif ( 'int' === $vals ) { $q[ $var ] = (int) $val; } elseif ( 'date' === $vals ) { if ( preg_match( '/^\d{4}-\d{2}-\d{2}$/', $val ) ) { $q[ $var ] = $val; } } elseif ( null === $vals ) { $q[ $var ] = ''; } elseif ( 'data' === $vals ) { if ( str_starts_with( $val, 'index.php' ) ) { $q[ $var ] = $val; } } } $url = 'https://' . STATS_DASHBOARD_SERVER . '/wp-admin/index.php'; if ( isset( $_GET['chart'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended if ( preg_match( '/^[a-z0-9-]+$/', $_GET['chart'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.Security.ValidatedSanitizedInput $chart = sanitize_title( $_GET['chart'] ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.Security.ValidatedSanitizedInput $url = 'https://' . STATS_DASHBOARD_SERVER . "/wp-includes/charts/{$chart}.php"; } } $url = add_query_arg( $q, $url ); $method = 'GET'; $timeout = 90; $user_id = 0; // Means use the blog token. $get = Client::remote_request( compact( 'url', 'method', 'timeout', 'user_id' ) ); $get_code = wp_remote_retrieve_response_code( $get ); if ( is_wp_error( $get ) || ( 2 !== (int) ( $get_code / 100 ) && 304 !== $get_code ) || empty( $get['body'] ) ) { stats_print_wp_remote_error( $get, $url ); } elseif ( ! empty( $get['headers']['content-type'] ) ) { $type = $get['headers']['content-type']; if ( str_starts_with( $type, 'image' ) ) { $img = $get['body']; header( 'Content-Type: ' . $type ); header( 'Content-Length: ' . strlen( $img ) ); echo $img; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped die( 0 ); } } if ( isset( $_GET['page'] ) && 'stats' === $_GET['page'] && ! isset( $_GET['chart'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended $tracking = new Tracking(); $tracking->record_user_event( 'wpa_page_view', array( 'path' => 'old_stats' ) ); } if ( isset( $_GET['noheader'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended die( 0 ); } } /** * Stats Convert Image URLs. * * @access public * @param mixed $html HTML. * @return string */ function stats_convert_image_urls( $html ) { $url = set_url_scheme( 'https://' . STATS_DASHBOARD_SERVER ); $html = preg_replace( '|(["\'])(/i/stats.+)\\1|', '$1' . $url . '$2$1', $html ); return $html; } /** * Callback for preg_replace_callback used in stats_convert_chart_urls() * * @since 5.6.0 * * @param array $matches The matches resulting from the preg_replace_callback call. * @return string The admin url for the chart. */ function jetpack_stats_convert_chart_urls_callback( $matches ) { // If there is a query string, change the beginning '?' to a '&' so it fits into the middle of this query string. return 'admin.php?page=stats&noheader&chart=' . $matches[1] . str_replace( '?', '&', $matches[2] ); } /** * Stats Convert Chart URLs. * * @access public * @param mixed $html HTML. * @return string */ function stats_convert_chart_urls( $html ) { $html = preg_replace_callback( '|https?://[-.a-z0-9]+/wp-includes/charts/([-.a-z0-9]+).php(\??)|', 'jetpack_stats_convert_chart_urls_callback', $html ); return $html; } /** * Stats Convert Post Title HTML * * @access public * @param mixed $html HTML. * @return string */ function stats_convert_post_titles( $html ) { global $stats_posts; $pattern = ".*?"; if ( ! preg_match_all( "!$pattern!", $html, $matches ) ) { return $html; } $posts = get_posts( array( 'include' => implode( ',', $matches[1] ), 'post_type' => 'any', 'post_status' => 'any', 'numberposts' => -1, 'suppress_filters' => false, ) ); foreach ( $posts as $post ) { $stats_posts[ $post->ID ] = $post; } $html = preg_replace_callback( "!$pattern!", 'stats_convert_post_title', $html ); return $html; } /** * Stats Convert Post Title Matches. * * @access public * @param mixed $matches Matches. * @return string */ function stats_convert_post_title( $matches ) { global $stats_posts; $post_id = $matches[1]; if ( isset( $stats_posts[ $post_id ] ) ) { return '' . get_the_title( $post_id ) . ''; } return $matches[0]; } /** * CSS to hide the tracking pixel smiley. * It is now hidden for everyone (used to be visible if you had set the hide_smile option). * * @access public * @return void */ function stats_hide_smile_css() { ?> '', 'proxy' => '', 'chart' => $chart, ), $args ), $url ); } /** * Stats AdminBar. * * @access public * @param mixed $wp_admin_bar WPAdminBar. * @return void */ function stats_admin_bar_menu( &$wp_admin_bar ) { $img_src = esc_attr( stats_get_image_chart_src( 'admin-bar-hours-scale' ) ); $img_src_2x = esc_attr( stats_get_image_chart_src( 'admin-bar-hours-scale-2x' ) ); $alt = esc_attr( __( 'Stats', 'jetpack' ) ); $title = esc_attr( __( 'Views over 48 hours. Click for more Jetpack Stats.', 'jetpack' ) ); $menu = array( 'id' => 'stats', 'href' => add_query_arg( 'page', 'stats', admin_url( 'admin.php' ) ), // no menu_page_url() blog-side. 'title' => "
$alt
", ); $wp_admin_bar->add_menu( $menu ); } /** * * Deprecated. The stats module should not update blog details. This is handled by Sync. * * Stats Update Blog. * * @access public * @return void * * @deprecated since 10.3. */ function stats_update_blog() { _deprecated_function( __METHOD__, 'jetpack-10.3' ); XMLRPC_Async_Call::add_call( 'jetpack.updateBlog', 0, stats_get_blog() ); } /** * Stats Get Blog. * * @deprecated 11.5 * * @access public * @return string */ function stats_get_blog() { _deprecated_function( __METHOD__, 'jetpack-11.5' ); return Stats_XMLRPC::init()->get_blog(); } /** * Stats Dashboard Widget Options. * * TODO: This should be moved into class-jetpack-stats-dashboard-widget.php. * * @access public * @return array */ function stats_dashboard_widget_options() { $defaults = array( 'chart' => 1, 'top' => 1, 'search' => 7, ); $options = get_option( 'stats_dashboard_widget' ); if ( ( ! $options ) || ! is_array( $options ) ) { $options = array(); } // Ignore obsolete option values. $intervals = array( 1, 7, 31, 90, 365 ); foreach ( array( 'top', 'search' ) as $key ) { if ( isset( $options[ $key ] ) && ! in_array( (int) $options[ $key ], $intervals, true ) ) { unset( $options[ $key ] ); } } return array_merge( $defaults, $options ); } /** * Stats Dashboard Widget Control. * * TODO: This should be moved into class-jetpack-stats-dashboard-widget.php. * * @access public * @return void */ function stats_dashboard_widget_control() { stats_dashboard_widget_controls_handle_submission(); $periods = array( '1' => __( 'day', 'jetpack' ), '7' => __( 'week', 'jetpack' ), '31' => __( 'month', 'jetpack' ), ); $intervals = array( '1' => __( 'the past day', 'jetpack' ), '7' => __( 'the past week', 'jetpack' ), '31' => __( 'the past month', 'jetpack' ), '90' => __( 'the past quarter', 'jetpack' ), '365' => __( 'the past year', 'jetpack' ), ); stats_dashboard_widget_controls_html( $intervals, $periods, stats_dashboard_widget_options() ); } /** * Handle widget controls form submission. * * TODO: This should be moved into class-jetpack-stats-dashboard-widget.php. * * @access public * @return void */ function stats_dashboard_widget_controls_handle_submission() { $options = stats_dashboard_widget_options(); $defaults = array( 'top' => 1, 'search' => 7, ); // Check if the correct form was submitted. if ( isset( $_POST['stats_id'] ) && 'dashboard_stats' === $_POST['stats_id'] ) { // Perform nonce verification. if ( isset( $_POST['dashboard-widget-nonce'] ) && wp_verify_nonce( filter_var( wp_unslash( $_POST['dashboard-widget-nonce'] ) ), 'edit-dashboard-widget_dashboard_stats' ) ) { // Update options. $options['chart'] = isset( $_POST['chart'] ) ? (int) $_POST['chart'] : 1; foreach ( array( 'top', 'search' ) as $key ) { $options[ $key ] = isset( $_POST[ $key ] ) ? (int) $_POST[ $key ] : $defaults[ $key ]; } update_option( 'stats_dashboard_widget', $options ); } } } /** * Output HTML for widget controls. * * @param array $intervals Array of intervals. * @param array $periods Array of periods. * @param array $options Array of options. * * TODO: This should be moved into class-jetpack-stats-dashboard-widget.php. * * @access public * @return void */ function stats_dashboard_widget_controls_html( $intervals, $periods, $options ) { ?>

.

.

.

'true', 'proxy' => '', 'blog' => $blog_id, 'page' => 'stats', 'chart' => '', 'unit' => $options['chart'], 'color' => get_user_option( 'admin_color' ), 'width' => $_width, 'height' => $_height, 'ssl' => is_ssl(), 'j' => sprintf( '%s:%s', JETPACK__API_VERSION, JETPACK__VERSION ), ); $url = 'https://' . STATS_DASHBOARD_SERVER . '/wp-admin/index.php'; $url = add_query_arg( $q, $url ); $method = 'GET'; $timeout = 90; $user_id = 0; // Means use the blog token. $get = Client::remote_request( compact( 'url', 'method', 'timeout', 'user_id' ) ); $get_code = wp_remote_retrieve_response_code( $get ); if ( is_wp_error( $get ) || ( 2 !== (int) ( $get_code / 100 ) && 304 !== $get_code ) || empty( $get['body'] ) ) { stats_print_wp_remote_error( $get, $url ); } else { $body = stats_convert_post_titles( $get['body'] ); $body = stats_convert_chart_urls( $body ); $body = stats_convert_image_urls( $body ); echo $body; // phpcs:ignore WordPress.Security.EscapeOutput } $post_ids = array(); $csv_end_date = current_time( 'Y-m-d' ); $csv_args = array( 'top' => "&limit=6&end=$csv_end_date", 'search' => "&limit=5&end=$csv_end_date", ); $top_posts = stats_get_csv( 'postviews', "days=$options[top]$csv_args[top]" ); foreach ( $top_posts as $i => $post ) { if ( 0 === $post['post_id'] ) { unset( $top_posts[ $i ] ); continue; } $post_ids[] = $post['post_id']; } // Cache. get_posts( array( 'include' => implode( ',', array_unique( $post_ids ) ) ) ); $searches = array(); $search_terms = stats_get_csv( 'searchterms', "days=$options[search]$csv_args[search]" ); foreach ( $search_terms as $search_term ) { if ( 'encrypted_search_terms' === $search_term['searchterm'] ) { continue; } $searches[] = esc_html( $search_term['searchterm'] ); } ?>

' . esc_html( get_the_title( $post['post_id'] ) ) . '', esc_html( number_format_i18n( $post['views'] ) ) ); ?>

%s', esc_html__( 'Jetpack Support', 'jetpack' ) ) ); ?> 

		User Agent: ""
		Page URL: "http"
		API URL: ""
		get_error_codes() as $code ) {
				foreach ( $get->get_error_messages( $code ) as $message ) {
					print esc_html( $code ) . ': "' . esc_html( $message ) . '"';
				}
			}
		} else {
			$get_code       = wp_remote_retrieve_response_code( $get );
			$content_length = strlen( wp_remote_retrieve_body( $get ) );
			?>
				Response code: ""
				Content length: ""
false, 'days' => false, 'limit' => 3, 'post_id' => false, 'summarize' => '', 'blog_id' => Jetpack_Options::get_option( 'id' ), ); $args = wp_parse_args( $args, $defaults ); $args['table'] = $table; $stats_csv_url = add_query_arg( $args, 'https://stats.wordpress.com/csv.php' ); $key = md5( $stats_csv_url ); // Get cache. $stats_cache = get_option( 'stats_cache' ); if ( ! $stats_cache || ! is_array( $stats_cache ) ) { $stats_cache = array(); } // Return or expire this key. if ( isset( $stats_cache[ $key ] ) ) { $time = key( $stats_cache[ $key ] ); if ( time() - $time < 300 ) { return $stats_cache[ $key ][ $time ]; } unset( $stats_cache[ $key ] ); } $stats_rows = array(); do { $stats = stats_get_remote_csv( $stats_csv_url ); if ( ! $stats ) { break; } $labels = array_shift( $stats ); if ( 0 === stripos( $labels[0], 'error' ) ) { break; } $stats_rows = array(); for ( $s = 0; isset( $stats[ $s ] ); $s++ ) { $row = array(); foreach ( $labels as $col => $label ) { $row[ $label ] = $stats[ $s ][ $col ]; } $stats_rows[] = $row; } } while ( 0 ); // Expire old keys. foreach ( $stats_cache as $k => $cache ) { if ( ! is_array( $cache ) || 300 < time() - key( $cache ) ) { unset( $stats_cache[ $k ] ); } } // Set cache. $stats_cache[ $key ] = array( time() => $stats_rows ); update_option( 'stats_cache', $stats_cache ); return $stats_rows; } /** * Stats get remote CSV. * * @access public * @param mixed $url URL. * @return array */ function stats_get_remote_csv( $url ) { $method = 'GET'; $timeout = 90; $user_id = 0; // Blog token. $get = Client::remote_request( compact( 'url', 'method', 'timeout', 'user_id' ) ); $get_code = wp_remote_retrieve_response_code( $get ); if ( is_wp_error( $get ) || ( 2 !== (int) ( $get_code / 100 ) && 304 !== $get_code ) || empty( $get['body'] ) ) { return array(); // @todo: return an error? } else { return stats_str_getcsv( $get['body'] ); } } /** * Recursively run str_getcsv on the stats csv. * * @since 9.7.0 Remove custom handling since str_getcsv is available on all servers running this now. * * @param mixed $csv CSV. * @return array */ function stats_str_getcsv( $csv ) { // @todo Correctly handle embedded newlines. Note, despite claims online, `str_getcsv( $csv, "\n" )` does not actually work. $lines = explode( "\n", rtrim( $csv, "\n" ) ); return array_map( function ( $line ) { // @todo When we drop support for PHP <7.4, consider passing empty-string for `$escape` here for better spec compatibility. return str_getcsv( $line, ',', '"', '\\' ); }, $lines ); } /** * Abstract out building the rest api stats path. * * @param string $resource Resource. * @return string */ function jetpack_stats_api_path( $resource = '' ) { $resource = ltrim( $resource, '/' ); return sprintf( '/sites/%d/stats/%s', Stats_Options::get_option( 'blog_id' ), $resource ); } /** * Fetches stats data from the REST API. Caches locally for 5 minutes. * * @link: https://developer.wordpress.com/docs/api/1.1/get/sites/%24site/stats/ * @access public * @deprecated 11.5 Use WPCOM_Stats available methodsinstead. * @param array $args (default: array()) The args that are passed to the endpoint. * @param string $resource (default: '') Optional sub-endpoint following /stats/. * @return array|WP_Error */ function stats_get_from_restapi( $args = array(), $resource = '' ) { _deprecated_function( __METHOD__, 'jetpack-11.5', 'Please checkout the methods available in Automattic\Jetpack\Stats\WPCOM_Stats' ); $endpoint = jetpack_stats_api_path( $resource ); $api_version = '1.1'; $args = wp_parse_args( $args, array() ); $cache_key = md5( implode( '|', array( $endpoint, $api_version, wp_json_encode( $args ) ) ) ); $transient_name = "jetpack_restapi_stats_cache_{$cache_key}"; $stats_cache = get_transient( $transient_name ); // Return or expire this key. if ( $stats_cache ) { $time = key( $stats_cache ); $data = $stats_cache[ $time ]; // WP_Error or string (JSON encoded object). if ( is_wp_error( $data ) ) { return $data; } return (object) array_merge( array( 'cached_at' => $time ), (array) json_decode( $data ) ); } // Do the dirty work. $response = Client::wpcom_json_api_request_as_blog( $endpoint, $api_version, $args ); if ( 200 !== wp_remote_retrieve_response_code( $response ) ) { // WP_Error. $data = is_wp_error( $response ) ? $response : new WP_Error( 'stats_error' ); // WP_Error. $return = $data; } else { // string (JSON encoded object). $data = wp_remote_retrieve_body( $response ); // object (rare: null on JSON failure). $return = json_decode( $data ); } // To reduce size in storage: store with time as key, store JSON encoded data (unless error). set_transient( $transient_name, array( time() => $data ), 5 * MINUTE_IN_SECONDS ); return $return; } /** * Add the Jetpack plugin version to the stats tracking data. * * @param array $kvs The stats array in key values. * @return array */ function filter_stats_array_add_jp_version( $kvs ) { $kvs['j'] = sprintf( '%s:%s', JETPACK__API_VERSION, JETPACK__VERSION ); return $kvs; } /** * Convert stats array to object after sanity checking the array is valid. * * @param array $stats_array The stats array. * @return WP_Error|Object|null */ function convert_stats_array_to_object( $stats_array ) { _deprecated_function( __FUNCTION__, 'jetpack-13.2', 'Automattic\Jetpack\Stats\WPCOM_Stats->convert_stats_array_to_object' ); return ( new WPCOM_Stats() )->convert_stats_array_to_object( $stats_array ); }