initial commit

2021-12-10 12:03:04 +00:00
commit c46c7ddbf0
3643 changed files with 582794 additions and 0 deletions
--- a/includes/tracks/events/class-wc-extensions-tracking.php
+++ b/includes/tracks/events/class-wc-extensions-tracking.php
@ -0,0 +1,101 @@
+<?php
+/**
+ * WooCommerce Extensions Tracking
+ *
+ * @package WooCommerce\Tracks
+ */
+
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * This class adds actions to track usage of the WooCommerce Extensions page.
+ */
+class WC_Extensions_Tracking {
+	/**
+	 * Init tracking.
+	 */
+	public function init() {
+		add_action( 'load-woocommerce_page_wc-addons', array( $this, 'track_extensions_page' ) );
+		add_action( 'woocommerce_helper_connect_start', array( $this, 'track_helper_connection_start' ) );
+		add_action( 'woocommerce_helper_denied', array( $this, 'track_helper_connection_cancelled' ) );
+		add_action( 'woocommerce_helper_connected', array( $this, 'track_helper_connection_complete' ) );
+		add_action( 'woocommerce_helper_disconnected', array( $this, 'track_helper_disconnected' ) );
+		add_action( 'woocommerce_helper_subscriptions_refresh', array( $this, 'track_helper_subscriptions_refresh' ) );
+		add_action( 'woocommerce_addon_installed', array( $this, 'track_addon_install' ), 10, 2 );
+	}
+
+	/**
+	 * Send a Tracks event when an Extensions page is viewed.
+	 */
+	public function track_extensions_page() {
+		// phpcs:disable WordPress.Security.NonceVerification.Recommended
+		$properties = array(
+			'section' => empty( $_REQUEST['section'] ) ? '_featured' : wc_clean( wp_unslash( $_REQUEST['section'] ) ),
+		);
+
+		$event      = 'extensions_view';
+		if ( 'helper' === $properties['section'] ) {
+			$event = 'subscriptions_view';
+		}
+
+		if ( ! empty( $_REQUEST['search'] ) ) {
+			$event                     = 'extensions_view_search';
+			$properties['search_term'] = wc_clean( wp_unslash( $_REQUEST['search'] ) );
+		}
+		// phpcs:enable
+
+		WC_Tracks::record_event( $event, $properties );
+	}
+
+	/**
+	 * Send a Tracks even when a Helper connection process is initiated.
+	 */
+	public function track_helper_connection_start() {
+		WC_Tracks::record_event( 'extensions_subscriptions_connect' );
+	}
+
+	/**
+	 * Send a Tracks even when a Helper connection process is cancelled.
+	 */
+	public function track_helper_connection_cancelled() {
+		WC_Tracks::record_event( 'extensions_subscriptions_cancelled' );
+	}
+
+	/**
+	 * Send a Tracks even when a Helper connection process completed successfully.
+	 */
+	public function track_helper_connection_complete() {
+		WC_Tracks::record_event( 'extensions_subscriptions_connected' );
+	}
+
+	/**
+	 * Send a Tracks even when a Helper has been disconnected.
+	 */
+	public function track_helper_disconnected() {
+		WC_Tracks::record_event( 'extensions_subscriptions_disconnect' );
+	}
+
+	/**
+	 * Send a Tracks even when Helper subscriptions are refreshed.
+	 */
+	public function track_helper_subscriptions_refresh() {
+		WC_Tracks::record_event( 'extensions_subscriptions_update' );
+	}
+
+	/**
+	 * Send a Tracks event when addon is installed via the Extensions page.
+	 *
+	 * @param string $addon_id Addon slug.
+	 * @param string $section  Extensions tab.
+	 */
+	public function track_addon_install( $addon_id, $section ) {
+		$properties = array(
+			'context' => 'extensions',
+			'section' => $section,
+		);
+
+		if ( 'woocommerce-payments' === $addon_id ) {
+			WC_Tracks::record_event( 'woocommerce_payments_install', $properties );
+		}
+	}
+}