HTML API: Make WP_HTML_Processor::serialize_token() public.

dmsnell · dmsnell · commit 50086eb36a5d · 2025-08-13T17:56:35.000Z
The serialize_token() method was added in WordPress 6.7.0 as a protected member on the WP_HTML_Processor class. It wasn’t clear at the time of merging if it would be necessary to expose it as a public method. However, since that time a number of experiments have led to the conclusion that it would be very valuable to do so. This patch opens up the method for invocation from the outside, trivializing the generation of normative HTML subspans from a parent document. Developed in #9456 Discussed in https://core.trac.wordpress.org/ticket/63823 Follow-up to [59076]. Props dmsnell, jonsurrell. Fixes #38044. git-svn-id: https://develop.svn.wordpress.org/trunk@60633 602fd350-edb4-49c9-b593-d223f7449a82
diff --git a/src/wp-includes/html-api/class-wp-html-processor.php b/src/wp-includes/html-api/class-wp-html-processor.php
@@ -1304,10 +1304,11 @@ public function serialize(): ?string {
 	 * @see static::serialize()
 	 *
 	 * @since 6.7.0
+	 * @since 6.9.0 Converted from protected to public method.
 	 *
 	 * @return string Serialization of token, or empty string if no serialization exists.
 	 */
-	protected function serialize_token(): string {
+	public function serialize_token(): string {
 		$html       = '';
 		$token_type = $this->get_token_type();
 

Original file line number	Diff line number	Diff line change
`@@ -1304,10 +1304,11 @@ public function serialize(): ?string {`
`1304`	`1304`	`* @see static::serialize()`
`1305`	`1305`	`*`
`1306`	`1306`	`* @since 6.7.0`
	`1307`	`+ * @since 6.9.0 Converted from protected to public method.`
`1307`	`1308`	`*`
`1308`	`1309`	`* @return string Serialization of token, or empty string if no serialization exists.`
`1309`	`1310`	`*/`
`1310`		`- protected function serialize_token(): string {`
	`1311`	`+ public function serialize_token(): string {`
`1311`	`1312`	`$html = '';`
`1312`	`1313`	`$token_type = $this->get_token_type();`
`1313`	`1314`