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

dmsnell · dmsnell · commit 65c3a8e197f1 · 2025-08-13T12:00:38.000-05:00
Trac ticket: Core-63823 Follows #7331 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. Follow-up to [[59076]](https://core.trac.wordpress.org/changeset/59076).
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`