WordPress-C
/
WordPress
mirror of https://github.com/WordPress/WordPress.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

HTML API: Rename `WP_HTML_Processor::createFragment()` to follow WPCS. 

`WP_HTML_Processor::create_fragment()` is the correct method name as per the WordPress PHP coding standards.

Follow-up to [56274].

Props dmsnell, jrf, hellofromTonya, SergeyBiryukov.
Fixes #59547.
Built from https://develop.svn.wordpress.org/trunk@56790


git-svn-id: http://core.svn.wordpress.org/trunk@56302 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2023-10-05 22:42:26 +00:00
parent bef632d0cc
commit 4fd39c6620
2 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
wp-includes/html-api/class-wp-html-processor.php
View File

@ -39,7 +39,7 @@
* *
* Example: * Example:
* *
* $processor = WP_HTML_Processor::createFragment( $html ); * $processor = WP_HTML_Processor::create_fragment( $html );
* if ( $processor->next_tag( array( 'breadcrumbs' => array( 'DIV', 'FIGURE', 'IMG' ) ) ) ) { * if ( $processor->next_tag( array( 'breadcrumbs' => array( 'DIV', 'FIGURE', 'IMG' ) ) ) ) {
* $processor->add_class( 'responsive-image' ); * $processor->add_class( 'responsive-image' );
* } * }
@ -58,7 +58,7 @@
* Since all elements find themselves inside a full HTML document * Since all elements find themselves inside a full HTML document
* when parsed, the return value from `get_breadcrumbs()` will always * when parsed, the return value from `get_breadcrumbs()` will always
* contain any implicit outermost elements. For example, when parsing * contain any implicit outermost elements. For example, when parsing
* with `createFragment()` in the `BODY` context (the default), any * with `create_fragment()` in the `BODY` context (the default), any
* tag in the given HTML document will contain `array( 'HTML', 'BODY', … )` * tag in the given HTML document will contain `array( 'HTML', 'BODY', … )`
* in its breadcrumbs. * in its breadcrumbs.
* *
@ -239,7 +239,7 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
* @param string $encoding Text encoding of the document; must be default of 'UTF-8'. * @param string $encoding Text encoding of the document; must be default of 'UTF-8'.
* @return WP_HTML_Processor|null The created processor if successful, otherwise null. * @return WP_HTML_Processor|null The created processor if successful, otherwise null.
*/ */
public static function createFragment( $html, $context = '<body>', $encoding = 'UTF-8' ) { public static function create_fragment( $html, $context = '<body>', $encoding = 'UTF-8' ) {
if ( '<body>' !== $context || 'UTF-8' !== $encoding ) { if ( '<body>' !== $context || 'UTF-8' !== $encoding ) {
return null; return null;
} }
@ -280,7 +280,7 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
* *
* @since 6.4.0 * @since 6.4.0
* *
* @see WP_HTML_Processor::createFragment() * @see WP_HTML_Processor::create_fragment()
* *
* @param string $html HTML to process. * @param string $html HTML to process.
* @param string|null $use_the_static_create_methods_instead This constructor should not be called manually. * @param string|null $use_the_static_create_methods_instead This constructor should not be called manually.
@ -292,9 +292,9 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
_doing_it_wrong( _doing_it_wrong(
__METHOD__, __METHOD__,
sprintf( sprintf(
/* translators: %s: WP_HTML_Processor::createFragment. */ /* translators: %s: WP_HTML_Processor::create_fragment(). */
__( 'Call %s to create an HTML Processor instead of calling the constructor directly.' ), __( 'Call %s to create an HTML Processor instead of calling the constructor directly.' ),
'<code>WP_HTML_Processor::createFragment</code>' '<code>WP_HTML_Processor::create_fragment()</code>'
), ),
'6.4.0' '6.4.0'
); );
@ -324,7 +324,7 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
* *
* Example * Example
* *
* $processor = WP_HTML_Processor::createFragment( '<template><strong><button><em><p><em>' ); * $processor = WP_HTML_Processor::create_fragment( '<template><strong><button><em><p><em>' );
* false === $processor->next_tag(); * false === $processor->next_tag();
* WP_HTML_Processor::ERROR_UNSUPPORTED === $processor->get_last_error(); * WP_HTML_Processor::ERROR_UNSUPPORTED === $processor->get_last_error();
* *
@ -428,7 +428,7 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
* *
* Example: * Example:
* *
* $processor = WP_HTML_Processor::createFragment( '<div><span><figure><img></figure></span></div>' ); * $processor = WP_HTML_Processor::create_fragment( '<div><span><figure><img></figure></span></div>' );
* $processor->next_tag( 'img' ); * $processor->next_tag( 'img' );
* true === $processor->matches_breadcrumbs( array( 'figure', 'img' ) ); * true === $processor->matches_breadcrumbs( array( 'figure', 'img' ) );
* true === $processor->matches_breadcrumbs( array( 'span', 'figure', 'img' ) ); * true === $processor->matches_breadcrumbs( array( 'span', 'figure', 'img' ) );
@ -557,7 +557,7 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
* *
* Example * Example
* *
* $processor = WP_HTML_Processor::createFragment( '<p><strong><em><img></em></strong></p>' ); * $processor = WP_HTML_Processor::create_fragment( '<p><strong><em><img></em></strong></p>' );
* $processor->next_tag( 'IMG' ); * $processor->next_tag( 'IMG' );
* $processor->get_breadcrumbs() === array( 'HTML', 'BODY', 'P', 'STRONG', 'EM', 'IMG' ); * $processor->get_breadcrumbs() === array( 'HTML', 'BODY', 'P', 'STRONG', 'EM', 'IMG' );
* *
@ -1439,5 +1439,5 @@ class WP_HTML_Processor extends WP_HTML_Tag_Processor {
* *
* @access private * @access private
*/ */
const CONSTRUCTOR_UNLOCK_CODE = 'Use WP_HTML_Processor::createFragment instead of calling the class constructor directly.'; const CONSTRUCTOR_UNLOCK_CODE = 'Use WP_HTML_Processor::create_fragment() instead of calling the class constructor directly.';
} }

2
wp-includes/version.php
View File

@ -16,7 +16,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '6.4-beta2-56788'; $wp_version = '6.4-beta2-56790';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.