Templates: Deprecate _inject_theme_attribute_in_block_template_content().

[Bernhard Reiter]

I'd like to deprecate _inject_theme_attribute_in_block_template_content(), as it can be replaced by using _inject_theme_attribute_in_template_part_block() in combination with traverse_and_serialize_blocks() on the parsed template blocks instead. Note that the function has always had @access private set in its PHPDoc.

The only code in Core that it's called from is synced from Gutenberg (dynamic blocks' PHP code).

I'd like to deprecate _inject_theme_attribute_in_template_part_block(), as it can be replaced by using _inject_theme_attribute_in_template_part_block() in combination with traverse_and_serialize_blocks() on the parsed template blocks instead.

The only code in Core that it's called from is synced from Gutenberg (dynamic blocks' PHP code).

• It was removed from the Template Part block in ​https://github.com/WordPress/gutenberg/pull/52892. This change will be synced to Core before Beta 1.
• It was added to the Pattern block in ​https://github.com/WordPress/gutenberg/pull/53423.
  • ​Per https://github.com/WordPress/wordpress-develop/pull/5261, it is no longer needed for WP >= 6.4.
  • Per ​https://github.com/WordPress/gutenberg/pull/54651, it is only called from inside the Pattern block for WP < 6.4.
  • However, ​https://github.com/WordPress/gutenberg/pull/54651 is not scheduled for inclusion in WP 6.4, so we'd end up with a deprecation warning. To remove that warning, we'll need to include ​https://github.com/WordPress/gutenberg/pull/54651 in WP 6.4. cc/ @mikachan

Trac ticket: https://core.trac.wordpress.org/ticket/59452

[Bernhard Reiter]

In 56719:

Templates: Deprecate _inject_theme_attribute_in_block_template_content.

It can be replaced by passing _inject_theme_attribute_in_template_part_block as second argument to traverse_and_serialize_blocks().

Per WordPress 6.4 Beta 1, there aren't going to be any more calls in Core to _inject_theme_attribute_in_block_template_content().

Note that _inject_theme_attribute_in_block_template_content has always had @access private set in its PHPDoc.

Props gziolo.
Fixes #59452.

Committed to Core in https://core.trac.wordpress.org/changeset/56719.

Move the now-deprecated function _inject_theme_attribute_in_block_template_content from wp-includes/block-template-utils.php to wp-includes/deprecated.php.

Trac ticket: https://core.trac.wordpress.org/ticket/59452

[Bernhard Reiter]

In 56722:

Templates: Move old theme attr injection function to deprecated.php.

Move the now-deprecated function _inject_theme_attribute_in_block_template_content from wp-includes/block-template-utils.php to wp-includes/deprecated.php.

Follow-up [56719].
Props spacedmonkey, davidbaumwald, mukesh27.
See #59452.

Committed to Core in https://core.trac.wordpress.org/changeset/56722/.