0tUU@)tUsensitiveparameter1%'UUU10SUpPUp@tUsensitiveparameter$'U k)F@tUȒUU1P]U0SU@itUsensitiveparameterA#'U k)F@tUUU1P]U@U@tUsensitiveparameter"'U k)F@YtUHUU1P]UU@tUsensitiveparameter 'U k)F@tUUU1P]UU@)tUsensitiveparameter'U k)F@tUȗUU1cUP]U@itUsensitiveparameterA'U k)F@tUUU1cU@U@tUsensitiveparameter'U k)F@YtUHUU1cUU@tUsensitiveparameter'U k)F@tUUU1oUcU@)tUsensitiveparameter'U k)F@tUȜUU1oUU@itUsensitiveparameterA'U k)F@tUUU1oU@U@tUsensitiveparameter'U k)F@YtUHUU1oUU@tUsensitiveparameter'U k)F@tUU; } /** * Saves the post ID for a specific email template type. * * @param string $email_type The type of email template e.g. 'customer_new_account' from the WC_Email->id property. * @param int $post_id The post ID to save. */ public function save_email_template_post_id( $email_type, $post_id ) { $option_name = $this->get_option_name( $email_type ); $previous_id = get_option( $option_name ); update_option( $option_name, $post_id ); // Invalidate caches for the previous mapping (if any). if ( ! empty( $previous_id ) ) { $this->invalidate_cache_for_template( (int) $previous_id, 'post_id' ); } // Invalidate cache for the new post_id. $this->invalidate_cache_for_template( $email_type, 'email_type' ); // Update in-memory caches with the new values. $this->post_id_to_email_type_cache[ $post_id ] = $email_type; wp_cache_set( $this->get_cache_key_for_post_id( $post_id ), $email_type, self::CACHE_GROUP, self::CACHE_EXPIRATION ); } /** * Gets the post ID for a specific email template type. * * Uses multi-level caching for improved performance. * * @param string $email_type The type of email template e.g. 'customer_new_account' from the WC_Email->id property. * @return int|false The post ID if found, false otherwise. */ public function get_email_template_post_id( $email_type ) { // Check in-memory cache first. $post_id_from_cache = array_search( $email_type, $this->post_id_to_email_type_cache, true ); if ( false !== $post_id_from_cache ) { return $post_id_from_cache; } $option_name = $this->get_option_name( $email_type ); $post_id = get_option( $option_name ); if ( ! empty( $post_id ) ) { $post_id = (int) $post_id; // Store in in-memory cache. $this->post_id_to_email_type_cache[ $post_id ] = $email_type; } return $post_id; } /** * Deletes the post ID for a specific email template type. * * @param string $email_type The type of email template e.g. 'customer_new_account' from the WC_Email->id property. */ public function delete_email_template( $email_type ) { $option_name = $this->get_option_name( $email_type ); $post_id = get_option( $option_name ); if ( ! $post_id ) { return; } delete_option( $option_name ); // Invalidate cache. $this->invalidate_cache_for_template( $post_id, 'post_id' ); } /** * Invalidates cache entries for a specific post ID or email type. * * @param int|string $value The value to invalidate cache for. * @param string $type The type of value to invalidate cache for. Can be 'post_id' or 'email_type'. * @return void */ private function invalidate_cache_for_template( $value, $type = 'post_id' ) { $post_id_array = array(); if ( 'post_id' === $type ) { $post_id_array[] = (int) $value; } elseif ( 'email_type' === $type ) { // Get all the post IDs that map to the email type. $post_id_array = array_merge( $post_id_array, array_unique( array_keys( $this->post_id_to_email_type_cache, $value, true ) ) ); } foreach ( $post_id_array as $post_id ) { unset( $this->post_id_to_email_type_cache[ $post_id ] ); // Delete from WordPress object cache. $cache_key = $this->get_cache_key_for_post_id( $post_id ); wp_cache_delete( $cache_key, self::CACHE_GROUP ); } } /** * Clears all in-memory caches. * * Useful for testing and debugging. Note that this only clears in-memory caches, * not the WordPress object cache entries (which will expire naturally). */ public function clear_caches() { $this->post_id_to_email_type_cache = array(); $this->email_class_name_cache = array(); } /** * Gets the cache key for a specific post ID. * * @param int $post_id The post ID. * @return string The cache key e.g. 'post_id_to_email_type_123'. */ public function get_cache_key_for_post_id( $post_id ) { return 'post_id_to_email_type_' . $post_id; } /** * Gets the option name for a specific email type. * * @param string $email_type The type of email template e.g. 'customer_new_account' from the WC_Email->id property. * @return string The option name e.g. 'woocommerce_email_templates_customer_new_account_post_id' */ private function get_option_name( $email_type ) { return str_replace( '%', $email_type, self::WC_OPTION_NAME ); } /** * Gets the email type from the option name. * * @param string $option_name The option name e.g. 'woocommerce_email_templates_customer_new_account_post_id'. * @return string The email type e.g. 'customer_new_account' */ private function get_email_type_from_option_name( $option_name ) { return str_replace( array( 'woocommerce_email_templates_', '_post_id', ), '', $option_name ); } /** * Gets the email type class name, e.g. 'WC_Email_Customer_New_Account' from the email ID (e.g. 'customer_new_account' from the WC_Email->id property). * * Uses in-memory caching to avoid repeated iterations through all registered emails. * * @param string $email_id The email ID. * @return string|null The email type class name. */ public function get_email_type_class_name_from_email_id( $email_id ) { // Early return if email_id is invalid. if ( empty( $email_id ) ) { return null; } // Check in-memory cache first. if ( isset( $this->email_class_name_cache[ $email_id ] ) ) { return $this->email_class_name_cache[ $email_id ]; } /** * Get all the emails registered in WooCommerce. * * @var \WC_Email[] */ $emails = WC()->mailer()->get_emails(); // Build the cache for all emails at once to avoid repeated iterations. foreach ( $emails as $email ) { $this->email_class_name_cache[ $email->id ] = get_class( $email ); } // Return the requested email class name if it exists. return $this->email_class_name_cache[ $email_id ] ?? null; } /** * Gets the email type class name, e.g. 'WC_Email_Customer_New_Account' from the post ID. * * @param int $post_id The post ID. * @return string|null The email type class name. */ public function get_email_type_class_name_from_post_id( $post_id ) { // Early return if post_id is invalid. if ( empty( $post_id ) ) { return null; } return $this->get_email_type_class_name_from_email_id( $this->get_email_type_from_post_id( $post_id ) ); } }