' . __('This site may record page, product, cart, checkout, account, country, language, and technical session events to operate and analyze the ValueSpace assistant. Accepted events are synchronized securely with ValueSpace. Known automated crawler traffic is excluded, and event retention is limited.', 'valuespace') . '

' )); } function vasp_event_register_exporter($exporters) { $exporters['valuespace-events'] = [ 'exporter_friendly_name' => __('ValueSpace events', 'valuespace'), 'callback' => 'vasp_event_personal_data_exporter', ]; return $exporters; } function vasp_event_register_eraser($erasers) { $erasers['valuespace-events'] = [ 'eraser_friendly_name' => __('ValueSpace events', 'valuespace'), 'callback' => 'vasp_event_personal_data_eraser', ]; return $erasers; } /** Build the site-bound generic activity-erasure request. */ function vasp_event_erasure_request($wp_user_id, $visitor_ids) { $wp_user_id = max(0, (int) $wp_user_id); $visitor_limit = $wp_user_id > 0 ? 98 : 100; $visitor_ids = array_slice(array_values(array_unique(array_filter(array_map( function($visitor_id) { $visitor_id = strtolower((string) $visitor_id); return wp_is_uuid($visitor_id, 4) ? $visitor_id : null; }, (array) $visitor_ids )))), 0, $visitor_limit); $subjects = []; if ($wp_user_id > 0) { foreach (['wordpress_user', 'woocommerce_customer'] as $provider) { $subjects[] = ['provider' => $provider, 'id' => (string) $wp_user_id]; } } return [ 'schemaVersion' => 1, 'externalSubjects' => $subjects, 'visitorIds' => $visitor_ids, ]; } function vasp_event_personal_data_exporter($email_address, $page = 1) { global $wpdb; $vasp_index_table = vasp_event_index_table(); $user = get_user_by('email', $email_address); if ((!$user && $wpdb->last_error) || ($user && !vasp_event_storage_schema_ready())) { return vasp_create_error(VASP_ERROR_DATABASE_ERROR, ['reason' => 'event_privacy_export_read_failed']); } if (!$user) { return ['data' => [], 'done' => true]; } $page = max(1, (int) $page); $limit = 100; $offset = ($page - 1) * $limit; $rows = $wpdb->get_results($wpdb->prepare( 'SELECT event_id, occurred_at, event_type, session_id, country, language, payload FROM %i WHERE wp_user_id = %d ORDER BY event_id ASC LIMIT %d OFFSET %d', $vasp_index_table, (int) $user->ID, $limit, $offset ), ARRAY_A); if ($wpdb->last_error || !is_array($rows)) { return vasp_create_error(VASP_ERROR_DATABASE_ERROR, ['reason' => 'event_privacy_export_read_failed']); } $data = []; foreach ($rows as $row) { $payload = json_decode($row['payload'], true); $data[] = [ 'group_id' => 'valuespace-events', 'group_label' => __('ValueSpace events', 'valuespace'), 'item_id' => 'valuespace-event-' . (int) $row['event_id'], 'data' => [ ['name' => __('Time', 'valuespace'), 'value' => $row['occurred_at']], ['name' => __('Event type', 'valuespace'), 'value' => $row['event_type']], ['name' => __('Session', 'valuespace'), 'value' => $row['session_id']], ['name' => __('Country', 'valuespace'), 'value' => $row['country']], ['name' => __('Language', 'valuespace'), 'value' => $row['language']], ['name' => __('Event details', 'valuespace'), 'value' => wp_json_encode(is_array($payload) ? $payload : [])], ], ]; } return ['data' => $data, 'done' => count($rows) < $limit]; } /** Retain personal data until its local presence can be read reliably. */ function vasp_event_privacy_erasure_read_failure() { vasp_create_error(VASP_ERROR_DATABASE_ERROR, ['reason' => 'event_privacy_erase_read_failed']); return [ 'items_removed' => false, 'items_retained' => true, 'messages' => [__('Local event erasure could not be completed. Please retry the privacy request.', 'valuespace')], 'done' => false, ]; } function vasp_event_personal_data_eraser($email_address, $page = 1) { global $wpdb; $vasp_index_table = vasp_event_index_table(); $user = get_user_by('email', $email_address); if ((!$user && $wpdb->last_error) || ($user && !vasp_event_storage_schema_ready())) { return vasp_event_privacy_erasure_read_failure(); } if (!$user) { return ['items_removed' => false, 'items_retained' => false, 'messages' => [], 'done' => true]; } $delivery_lock = function_exists('vasp_event_acquire_delivery_lock') ? vasp_event_acquire_delivery_lock() : null; if ($delivery_lock === false) { return [ 'items_removed' => false, 'items_retained' => true, 'messages' => [__('ValueSpace event synchronization is currently busy. Please retry the privacy request.', 'valuespace')], 'done' => false, ]; } try { $rows = $wpdb->get_results($wpdb->prepare( 'SELECT event_id, occurred_at, event_type, object_type, object_id, object_title, canonical_url, default_object_id, default_object_title, default_canonical_url, session_id, country, language, is_internal, delivery_status, payload FROM %i WHERE wp_user_id = %d ORDER BY event_id ASC LIMIT 100', $vasp_index_table, (int) $user->ID ), ARRAY_A); if ($wpdb->last_error || !is_array($rows)) { return vasp_event_privacy_erasure_read_failure(); } if (!$rows) { return ['items_removed' => false, 'items_retained' => false, 'messages' => [], 'done' => true]; } $sessions = []; foreach ($rows as $row) { $session_id = (string) ($row['session_id'] ?? ''); if (wp_is_uuid($session_id, 4)) { $sessions[$session_id] = $session_id; } } $response = vasp_api_request( 'events_erase_endpoint', 'POST', vasp_event_erasure_request((int) $user->ID, array_values($sessions)), [], [], 'application/json', 15 ); if (is_wp_error($response) || empty($response['success'])) { return [ 'items_removed' => false, 'items_retained' => true, 'messages' => [__('Synchronized events could not be erased yet. Please retry the privacy request.', 'valuespace')], 'done' => false, ]; } $wpdb->query('START TRANSACTION'); $ids = []; foreach ($rows as $row) { $event = [ 'event_type' => (string) $row['event_type'], 'timestamp' => (string) $row['occurred_at'], 'country' => (string) $row['country'], 'language' => (string) $row['language'], 'is_internal' => (int) $row['is_internal'], 'data' => json_decode((string) $row['payload'], true) ?: [], ]; $fields = [ 'object_type' => (string) $row['object_type'], 'object_id' => (int) $row['object_id'], 'object_title' => (string) $row['object_title'], 'canonical_url' => (string) $row['canonical_url'], 'default_object_id' => (int) $row['default_object_id'], 'default_object_title' => (string) $row['default_object_title'], 'default_canonical_url' => (string) $row['default_canonical_url'], ]; if (vasp_event_delivery_status_is_projected($row['delivery_status'] ?? '') && !vasp_event_decrement_projection($event, $fields)) { $wpdb->query('ROLLBACK'); return [ 'items_removed' => false, 'items_retained' => true, 'messages' => [__('Local event erasure could not be completed. Please retry the privacy request.', 'valuespace')], 'done' => false, ]; } $ids[] = (int) $row['event_id']; } $placeholders = implode(',', array_fill(0, count($ids), '%d')); $deleted = $wpdb->query($wpdb->prepare( "DELETE FROM %i WHERE event_id IN ({$placeholders})", array_merge([$vasp_index_table], $ids) )); if ($deleted === false || $wpdb->last_error) { $wpdb->query('ROLLBACK'); return [ 'items_removed' => false, 'items_retained' => true, 'messages' => [__('Local event erasure could not be completed. Please retry the privacy request.', 'valuespace')], 'done' => false, ]; } $wpdb->query('COMMIT'); foreach ($sessions as $session_id) { vasp_event_remove_user_from_session_transient($session_id, (int) $user->ID); } return [ 'items_removed' => (int) $deleted > 0, 'items_retained' => false, 'messages' => [], 'done' => count($rows) < 100, ]; } finally { if ($delivery_lock !== null) { vasp_event_release_delivery_lock($delivery_lock); } } } /** Remove one user without discarding unrelated events in the same session. */ function vasp_event_remove_user_from_session_transient($session_id, $wp_user_id) { $lock = vasp_event_acquire_session_lock($session_id); $current_key = vasp_event_session_transient_key($session_id); $legacy_key = 'vasp_session_' . (string) $session_id; if ($lock === false) { vasp_delete_dynamic_transient($current_key); vasp_delete_dynamic_transient($legacy_key); return; } try { $events = array_values(array_filter( vasp_event_read_session_events($session_id, true), function($event) use ($wp_user_id) { return !is_array($event) || (int) ($event['wp_user_id'] ?? 0) !== $wp_user_id; } )); if ($events) { vasp_set_dynamic_transient( $current_key, $events, vasp_event_retention_days() * DAY_IN_SECONDS ); } else { vasp_delete_dynamic_transient($current_key); } vasp_delete_dynamic_transient($legacy_key); } finally { vasp_event_release_session_lock($lock); } }