Automattic\WooCommerce\EmailEditor\Engine\PersonalizationTags

HTML_Tag_Processor{} │ WC 1.0└─ WP_HTML_Tag_Processor

Class based on WP_HTML_Tag_Processor which is extended to replace tokens with their values in the email content.

This class was inspired by a concept from the WordPress core, which could help us to avoid refactoring in the future.

No Hooks.

Usage

$HTML_Tag_Processor = new HTML_Tag_Processor();
// use class methods

Methods

1. public flush_updates()
2. public replace_token( string $new_content )

HTML_Tag_Processor{} HTML Tag Processor{} code ^{WC 10.6.2}

class HTML_Tag_Processor extends WP_HTML_Tag_Processor {
	/**
	 * List of deferred updates which will be replaced after calling flush_updates().
	 *
	 * @var WP_HTML_Text_Replacement[]
	 */
	private $deferred_updates = array();

	/**
	 * Replaces the token with the new content.
	 *
	 * @param string $new_content The new content to replace the token.
	 */
	public function replace_token( string $new_content ): void {
		$this->set_bookmark( 'here' );
		$here                     = $this->bookmarks['here'];
		$this->deferred_updates[] = new WP_HTML_Text_Replacement(
			$here->start,
			$here->length,
			$new_content
		);
	}

	/**
	 * Flushes the deferred updates to the lexical updates.
	 */
	public function flush_updates(): void {
		foreach ( $this->deferred_updates as $key => $update ) {
			$this->lexical_updates[] = $update;
			unset( $this->deferred_updates[ $key ] );
		}
	}
}