1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

<?php
/**
 * WooCommerce MC Stats package
 */

declare( strict_types = 1 );

namespace Automattic\WooCommerce\Internal;

use Automattic\Jetpack\A8c_Mc_Stats;

/**
 * Class MC Stats, used to record internal usage stats for Automattic.
 *
 * This class is a wrapper around the Jetpack MC Stats package.
 * See https://github.com/Automattic/jetpack-a8c-mc-stats/tree/trunk for more details.
 */
class McStats extends A8c_Mc_Stats {

    /**
     * Return the stats from a group in an array ready to be added as parameters in a query string
     *
     * Jetpack MC Stats package prefixes group names with "x_jetpack-" so we override this method to prefix group names with "x_woocommerce-".
     *
     * @param string $group_name The name of the group to retrieve.
     * @return array Array with one item, where the key is the prefixed group and the value are all stats concatenated with a comma. If group not found, an empty array will be returned
     */
    public function get_group_query_args( $group_name ) {
        $stats = $this->get_current_stats();
        if ( isset( $stats[ $group_name ] ) && ! empty( $stats[ $group_name ] ) ) {
            return array( "x_woocommerce-{$group_name}" => implode( ',', $stats[ $group_name ] ) );
        }
        return array();
    }

    /**
     * Outputs the tracking pixels for the current stats and empty the stored stats from the object
     *
     * @return void
     */
    public function do_stats() {
        if ( ! \WC_Site_Tracking::is_tracking_enabled() ) {
            return;
        }

        parent::do_stats();
    }

    /**
     * Runs stats code for a one-off, server-side.
     *
     * @param string $url string The URL to be pinged. Should include `x_woocommerce-{$group}={$stats}` or whatever we want to store.
     *
     * @return bool If it worked.
     */
    public function do_server_side_stat( $url ) {
        if ( ! \WC_Site_Tracking::is_tracking_enabled() ) {
            return false;
        }

        return parent::do_server_side_stat( $url );
    }

    /**
     * Pings the stats server for the current stats and empty the stored stats from the object
     *
     * @return void
     */
    public function do_server_side_stats() {
        if ( ! \WC_Site_Tracking::is_tracking_enabled() ) {
            return;
        }

        parent::do_server_side_stats();
    }
}