WP_REST_Server::CREATABLE, 'callback' => array( $this, 'handle_event_endpoint' ), 'permission_callback' => array( $this, 'verify_user_can_edit' ), 'args' => [ self::PROP_EVENT_LABEL => [ 'description' => __( 'The Event Label', 'kadence-starter-templates' ), 'type' => 'string', 'sanitize_callback' => 'sanitize_text_field', ], self::PROP_EVENT_DATA => [ 'description' => __( 'The Event Data', 'kadence-starter-templates' ), 'type' => 'object', ], ], ) ) ); } /** * Checks if the current user has access to edit posts. * * @return bool */ public function verify_user_can_edit(): bool { return current_user_can( 'edit_posts' ); } /** * Get the current license key for the plugin. * * @return string */ public function get_current_license_key() { $license_data = kadence_starter_templates_get_license_data(); if ( ! empty( $license_data['api_key'] ) ) { return $license_data['api_key']; } return ''; } /** * Sends events to Prophecy WP (if the user has opted in through AI auth). * * @action kadencestartertemplates/ai/event * * @return void */ public function handle_event( string $name, array $context ): void { // Only pass tracking events if AI has been activated through Opt in. $slug = class_exists( '\KadenceWP\KadenceBlocks\App' ) ? 'kadence-blocks' : 'kadence-starter-templates'; if ( class_exists( '\KadenceWP\KadenceBlocks\App' ) ) { $token = \KadenceWP\KadenceBlocks\StellarWP\Uplink\get_authorization_token( $slug ); } else { $token = get_authorization_token( $slug ); } $license_key = $this->get_current_license_key(); $is_authorized = false; if ( ! empty( $token ) && ! empty( $license_key ) ) { $is_authorized = is_authorized( $license_key, apply_filters( 'kadence-blocks-auth-slug', $slug ), $token, get_license_domain() ); } if ( ! $is_authorized ) { return; } /** * Filters the URL used to send events to. * * @param string The URL to use when sending events. */ $url = apply_filters( 'kadenceblocks/ai/event_url', self::DOMAIN . self::ENDPOINT ); wp_remote_post( $url, array( 'timeout' => 20, 'blocking' => false, 'headers' => array( 'X-Prophecy-Token' => $this->get_prophecy_token_header(), 'Content-Type' => 'application/json', ), 'body' => wp_json_encode( [ 'name' => $name, 'context' => $context, ] ), ) ); } /** * Constructs a consistent X-Prophecy-Token header. * * @param array $args An array of arguments to include in the encoded header. * * @return string The base64 encoded string. */ public function get_prophecy_token_header( $args = [] ) { $site_name = get_bloginfo( 'name' ); $license_data = kadence_starter_templates_get_license_data(); $product_slug = ( ! empty( $license_data['product'] ) ? $license_data['product'] : 'kadence-starter-templates' ); $defaults = [ 'domain' => ! empty( $license_data['site_url'] ) ? $license_data['site_url'] : '', 'key' => ! empty( $license_data['api_key'] ) ? $license_data['api_key'] : '', 'site_name' => sanitize_title( $site_name ), 'product_slug' => apply_filters( 'kadence-blocks-auth-slug', $product_slug ), 'product_version' => KADENCE_STARTER_TEMPLATES_VERSION, 'product_source' => 'kadence-starter-templates', ]; $parsed_args = wp_parse_args( $args, $defaults ); return base64_encode( json_encode( $parsed_args ) ); } /** * Configures various event requests to the /analytics/event endpoint * and sends them to ProphecyWP. * * @param WP_REST_Request $request The request to the endpoint. */ public function handle_event_endpoint( WP_REST_Request $request ): WP_REST_Response { $event_label = $request->get_param( self::PROP_EVENT_LABEL ); $event_data = $request->get_param( self::PROP_EVENT_DATA ); $event = ''; $context = array(); switch ( $event_label ) { case 'ai_wizard_started': $event = 'AI Wizard Started'; break; case 'ai_wizard_update': $event = 'AI Wizard Update'; $context = [ 'organization_type' => $event_data['entityType'] ?? '', 'location_type' => $event_data['locationType'] ?? '', 'location' => $event_data['location'] ?? '', 'industry' => $event_data['industry'] ?? '', 'mission_statement' => $event_data['missionStatement'] ?? '', 'keywords' => $event_data['keywords'] ?? '', 'tone' => $event_data['tone'] ?? '', 'collections' => $event_data['customCollections'] ?? '', 'goals' => $event_data['goals'] ?? '', 'lang' => $event_data['lang'] ?? '', ]; break; case 'ai_wizard_complete': $event = 'AI Wizard Complete'; $context = [ 'organization_type' => $event_data['entityType'] ?? '', 'location_type' => $event_data['locationType'] ?? '', 'location' => $event_data['location'] ?? '', 'industry' => $event_data['industry'] ?? '', 'mission_statement' => $event_data['missionStatement'] ?? '', 'keywords' => $event_data['keywords'] ?? '', 'tone' => $event_data['tone'] ?? '', 'collections' => $event_data['customCollections'] ?? '', 'goals' => $event_data['goals'] ?? '', 'lang' => $event_data['lang'] ?? '', ]; break; case 'import_ai_starter_template': $event = 'Imported AI Starter Template'; $context = [ 'starter_slug' => $event_data['slug'] ?? '', 'starter_name' => $event_data['name'] ?? '', 'starter_is_dark' => $event_data['is_dark'] ?? false, 'is_pro' => $event_data['is_pro'] ?? false, 'plugins' => ( ! empty( $event_data['plugins'] ) && is_array( $event_data['plugins'] ) ? implode( ',', $event_data['plugins'] ) : '' ), 'pages' => ( ! empty( $event_data['pages'] ) && is_array( $event_data['pages'] ) ? implode( ',', $event_data['pages'] ) : '' ), 'font_pair' => $event_data['font_pair'] ?? '', 'custom_color' => $event_data['custom_color'] ?? false, 'has_content' => $event_data['has_content'] ?? false, 'starter_has_woo' => $event_data['has_woo'] ?? false, 'starter_has_posts' => $event_data['has_posts'] ?? false, 'goals' => $event_data['goals'] ?? '', 'lang' => $event_data['lang'] ?? '', ]; break; case 'collection_updated': $event = 'Collection Updated'; $context = [ 'collection_name' => $this->get_custom_collection_name_by_id( $event_data['customCollections'], $event_data['photoLibrary'] ), ]; break; } if ( strlen( $event ) !== 0 ) { do_action( 'kadencestartertemplates/ai/event', $event, $context ); return new WP_REST_Response( [ 'message' => 'Event handled.' ], 200 ); } return new WP_REST_Response( array( 'message' => 'Event not handled.' ), 500 ); } /** * Searches an array of collections for the name of a collection with a specific ID. * * @param array $collections An array of collections. * @param string $id The ID of a collection. * * @return array */ private function get_custom_collection_name_by_id( array $collections, string $id ): string { foreach ( $collections as $collection ) { if ( $collection['value'] === $id ) { return $collection['label'] ?? ''; } return ''; } } }