enmi-conf.org: comparison wp/wp-includes/deprecated.php

equal deleted inserted replaced

-:be944660c56a
+:3d72ae0968f4
 *
 * @since 0.71
 * @deprecated 0.71 Use get_the_category()
 * @see get_the_category()
 *
-* @param bool $echo Optional. Whether to echo the output. Default true.
+* @param bool $display Optional. Whether to display the output. Default true.
 * @return int Category ID.
 */
-function the_category_ID($echo = true) {
+function the_category_ID($display = true) {
 	_deprecated_function( __FUNCTION__, '0.71', 'get_the_category()' );
 	// Grab the first cat in the list.
 	$categories = get_the_category();
 	$cat = $categories[0]->term_id;
-	if ( $echo )
+	if ( $display )
 		echo $cat;
 	return $cat;
 }
 *
 * @since 1.2.0
 * @deprecated 2.1.0 Use get_author_posts_url()
 * @see get_author_posts_url()
 *
-* @param bool $echo
+* @param bool $display
 * @param int $author_id
 * @param string $author_nicename Optional.
 * @return string|null
 */
-function get_author_link($echo, $author_id, $author_nicename = '') {
+function get_author_link($display, $author_id, $author_nicename = '') {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'get_author_posts_url()' );
 	$link = get_author_posts_url($author_id, $author_nicename);
-	if ( $echo )
+	if ( $display )
 		echo $link;
 	return $link;
 }
 /**
 *                                 Default true.
 * @param bool   $show_rating      Optional. Show rating stars/chars. Default false.
 * @param int    $limit            Optional. Limit to X entries. If not specified, all entries are shown.
 *                                 Default -1.
 * @param int    $show_updated     Optional. Whether to show last updated timestamp. Default 1.
-* @param bool   $echo             Whether to echo the results, or return them instead.
+* @param bool   $display          Whether to display the results, or return them instead.
 * @return null|string
 */
 function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
-			$show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $echo = true) {
+			$show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $display = true) {
 	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );
 	$order = 'ASC';
 	if ( substr($orderby, 0, 1) == '_' ) {
 		$order = 'DESC';
 		}
 		$output .= "$after\n";
 	} // End while.
-	if ( !$echo )
+	if ( !$display )
 		return $output;
 	echo $output;
 }
 /**
 *
 * @since 1.2.0
 * @deprecated 2.5.0 Use get_category_feed_link()
 * @see get_category_feed_link()
 *
-* @param bool $echo
+* @param bool $display
 * @param int $cat_ID
 * @return string
 */
-function get_category_rss_link($echo = false, $cat_ID = 1) {
+function get_category_rss_link($display = false, $cat_ID = 1) {
 	_deprecated_function( __FUNCTION__, '2.5.0', 'get_category_feed_link()' );
 	$link = get_category_feed_link($cat_ID, 'rss2');
-	if ( $echo )
+	if ( $display )
 		echo $link;
 	return $link;
 }
 /**
 *
 * @since 1.2.0
 * @deprecated 2.5.0 Use get_author_feed_link()
 * @see get_author_feed_link()
 *
-* @param bool $echo
+* @param bool $display
 * @param int $author_id
 * @return string
 */
-function get_author_rss_link($echo = false, $author_id = 1) {
+function get_author_rss_link($display = false, $author_id = 1) {
 	_deprecated_function( __FUNCTION__, '2.5.0', 'get_author_feed_link()' );
 	$link = get_author_feed_link($author_id);
-	if ( $echo )
+	if ( $display )
 		echo $link;
 	return $link;
 }
 /**
 	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmark()' );
 	return get_bookmark($bookmark_id, $output, $filter);
 }
 /**
-* Performs esc_url() for database or redirect usage.
-*
-* @since 2.3.1
-* @deprecated 2.8.0 Use esc_url_raw()
-* @see esc_url_raw()
-*
-* @param string $url The URL to be cleaned.
-* @param array $protocols An array of acceptable protocols.
-* @return string The cleaned URL.
-*/
-function sanitize_url( $url, $protocols = null ) {
-	_deprecated_function( __FUNCTION__, '2.8.0', 'esc_url_raw()' );
-	return esc_url_raw( $url, $protocols );
-}
-/**
 * Checks and cleans a URL.
 *
 * A number of characters are removed from the URL. If the URL is for displaying
 * (the default behaviour) ampersands are also replaced. The 'clean_url' filter
 * is applied to the returned cleaned URL.
 * Legacy escaping for HTML blocks.
 *
 * @deprecated 2.8.0 Use esc_html()
 * @see esc_html()
 *
-* @param string       $string        String to escape.
+* @param string       $text          Text to escape.
 * @param string       $quote_style   Unused.
 * @param false|string $charset       Unused.
 * @param false        $double_encode Whether to double encode. Unused.
-* @return string Escaped `$string`.
+* @return string Escaped `$text`.
 */
-function wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
+function wp_specialchars( $text, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
 	_deprecated_function( __FUNCTION__, '2.8.0', 'esc_html()' );
 	if ( func_num_args() > 1 ) { // Maintain back-compat for people passing additional arguments.
-		return _wp_specialchars( $string, $quote_style, $charset, $double_encode );
+		return _wp_specialchars( $text, $quote_style, $charset, $double_encode );
 	} else {
-		return esc_html( $string );
+		return esc_html( $text );
 	}
 }
 /**
 * Escaping for HTML attributes.
 * @deprecated 3.4.0 Use error_log()
 * @see error_log()
 *
 * @link https://www.php.net/manual/en/function.error-log.php
 *
-* @param mixed  $fp     Unused.
+* @param mixed  $fp      Unused.
-* @param string $string Message to log.
+* @param string $message Message to log.
 */
-function debug_fwrite( $fp, $string ) {
+function debug_fwrite( $fp, $message ) {
 	_deprecated_function( __FUNCTION__, '3.4.0', 'error_log()' );
 	if ( ! empty( $GLOBALS['debug'] ) )
-		error_log( $string );
+		error_log( $message );
 }
 /**
 * Close the debugging file handle.
 *
 	if ( is_numeric( $file ) )
 		$file = get_attached_file( $file );
 	if ( ! is_file( $file ) ) {
 		/* translators: %s: File name. */
-		return sprintf( __( 'File &#8220;%s&#8221; doesn&#8217;t exist?' ), $file );
+		return sprintf( __( 'File &#8220;%s&#8221; does not exist?' ), $file );
 	}
 	if ( ! function_exists('imagecreatefromstring') )
 		return __('The GD image library is not installed.');
 			case 'image/png':
 				return (imagetypes() & IMG_PNG) != 0;
 			case 'image/gif':
 				return (imagetypes() & IMG_GIF) != 0;
 			case 'image/webp':
-				return (imagetypes() & IMG_WEBP) != 0; // phpcs:ignore PHPCompatibility.Constants.NewConstants.img_webpFound
+				return (imagetypes() & IMG_WEBP) != 0;
 		}
 	} else {
 		switch( $mime_type ) {
 			case 'image/jpeg':
 				return function_exists('imagecreatefromjpeg');
 * input to the return.
 *
 * @since 1.0.0
 * @deprecated 4.7.0 Officially dropped security support for Netscape 4.
 *
-* @param string $string
+* @param string $content
 * @return string
 */
-function wp_kses_js_entities( $string ) {
+function wp_kses_js_entities( $content ) {
 	_deprecated_function( __FUNCTION__, '4.7.0' );
-	return preg_replace( '%&\s*\{[^}]*(\}\s*;?|$)%', '', $string );
+	return preg_replace( '%&\s*\{[^}]*(\}\s*;?|$)%', '', $content );
 }
 /**
 * Sort categories by ID.
 *
 function addslashes_strings_only( $value ) {
 	return is_string( $value ) ? addslashes( $value ) : $value;
 }
 /**
-* Displays a noindex meta tag if required by the blog configuration.
+* Displays a `noindex` meta tag if required by the blog configuration.
 *
-* If a blog is marked as not being public then the noindex meta tag will be
+* If a blog is marked as not being public then the `noindex` meta tag will be
-* output to tell web robots not to index the page content. Add this to the
+* output to tell web robots not to index the page content.
-* {@see 'wp_head'} action.
 *
 * Typical usage is as a {@see 'wp_head'} callback:
 *
 *     add_action( 'wp_head', 'noindex' );
 *
 		wp_no_robots();
 	}
 }
 /**
-* Display a noindex meta tag.
+* Display a `noindex` meta tag.
 *
-* Outputs a noindex meta tag that tells web robots not to index the page content.
+* Outputs a `noindex` meta tag that tells web robots not to index the page content.
-* Typical usage is as a {@see 'wp_head'} callback. add_action( 'wp_head', 'wp_no_robots' );
+*
+* Typical usage is as a {@see 'wp_head'} callback:
+*
+*     add_action( 'wp_head', 'wp_no_robots' );
 *
 * @since 3.3.0
-* @since 5.3.0 Echo "noindex,nofollow" if search engine visibility is discouraged.
+* @since 5.3.0 Echo `noindex,nofollow` if search engine visibility is discouraged.
 * @deprecated 5.7.0 Use wp_robots_no_robots() instead on 'wp_robots' filter.
 */
 function wp_no_robots() {
 	_deprecated_function( __FUNCTION__, '5.7.0', 'wp_robots_no_robots()' );
 	echo "<meta name='robots' content='noindex,nofollow' />\n";
 }
 /**
-* Display a noindex,noarchive meta tag and referrer origin-when-cross-origin meta tag.
+* Display a `noindex,noarchive` meta tag and referrer `strict-origin-when-cross-origin` meta tag.
 *
-* Outputs a noindex,noarchive meta tag that tells web robots not to index or cache the page content.
+* Outputs a `noindex,noarchive` meta tag that tells web robots not to index or cache the page content.
-* Outputs a referrer origin-when-cross-origin meta tag that tells the browser not to send the full
+* Outputs a referrer `strict-origin-when-cross-origin` meta tag that tells the browser not to send
-* url as a referrer to other sites when cross-origin assets are loaded.
+* the full URL as a referrer to other sites when cross-origin assets are loaded.
 *
-* Typical usage is as a wp_head callback. add_action( 'wp_head', 'wp_sensitive_page_meta' );
+* Typical usage is as a {@see 'wp_head'} callback:
+*
+*     add_action( 'wp_head', 'wp_sensitive_page_meta' );
 *
 * @since 5.0.1
 * @deprecated 5.7.0 Use wp_robots_sensitive_page() instead on 'wp_robots' filter
 *                   and wp_strict_cross_origin_referrer() on 'wp_head' action.
+*
+* @see wp_robots_sensitive_page()
 */
 function wp_sensitive_page_meta() {
 	_deprecated_function( __FUNCTION__, '5.7.0', 'wp_robots_sensitive_page()' );
 	?>
 /**
 * Render inner blocks from the `core/columns` block for generating an excerpt.
 *
 * @since 5.2.0
-* @deprecated 5.8.0
-*
 * @access private
+* @deprecated 5.8.0 Use _excerpt_render_inner_blocks() introduced in 5.8.0.
+*
+* @see _excerpt_render_inner_blocks()
 *
 * @param array $columns        The parsed columns block.
 * @param array $allowed_blocks The list of allowed inner blocks.
 * @return string The rendered inner blocks.
 */
 function _excerpt_render_inner_columns_blocks( $columns, $allowed_blocks ) {
 	_deprecated_function( __FUNCTION__, '5.8.0', '_excerpt_render_inner_blocks()' );
 	return _excerpt_render_inner_blocks( $columns, $allowed_blocks );
 }
+/**
+* Renders the duotone filter SVG and returns the CSS filter property to
+* reference the rendered SVG.
+*
+* @since 5.9.0
+* @deprecated 5.9.1 Use wp_get_duotone_filter_property() introduced in 5.9.1.
+*
+* @see wp_get_duotone_filter_property()
+*
+* @param array $preset Duotone preset value as seen in theme.json.
+* @return string Duotone CSS filter property.
+*/
+function wp_render_duotone_filter_preset( $preset ) {
+	_deprecated_function( __FUNCTION__, '5.9.1', 'wp_get_duotone_filter_property()' );
+	return wp_get_duotone_filter_property( $preset );
+}
+/**
+* Checks whether serialization of the current block's border properties should occur.
+*
+* @since 5.8.0
+* @access private
+* @deprecated 6.0.0 Use wp_should_skip_block_supports_serialization() introduced in 6.0.0.
+*
+* @see wp_should_skip_block_supports_serialization()
+*
+* @param WP_Block_Type $block_type Block type.
+* @return bool Whether serialization of the current block's border properties
+*              should occur.
+*/
+function wp_skip_border_serialization( $block_type ) {
+	_deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' );
+	$border_support = _wp_array_get( $block_type->supports, array( '__experimentalBorder' ), false );
+	return is_array( $border_support ) &&
+		array_key_exists( '__experimentalSkipSerialization', $border_support ) &&
+		$border_support['__experimentalSkipSerialization'];
+}
+/**
+* Checks whether serialization of the current block's dimensions properties should occur.
+*
+* @since 5.9.0
+* @access private
+* @deprecated 6.0.0 Use wp_should_skip_block_supports_serialization() introduced in 6.0.0.
+*
+* @see wp_should_skip_block_supports_serialization()
+*
+* @param WP_Block_type $block_type Block type.
+* @return bool Whether to serialize spacing support styles & classes.
+*/
+function wp_skip_dimensions_serialization( $block_type ) {
+	_deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' );
+	$dimensions_support = _wp_array_get( $block_type->supports, array( '__experimentalDimensions' ), false );
+	return is_array( $dimensions_support ) &&
+		array_key_exists( '__experimentalSkipSerialization', $dimensions_support ) &&
+		$dimensions_support['__experimentalSkipSerialization'];
+}
+/**
+* Checks whether serialization of the current block's spacing properties should occur.
+*
+* @since 5.9.0
+* @access private
+* @deprecated 6.0.0 Use wp_should_skip_block_supports_serialization() introduced in 6.0.0.
+*
+* @see wp_should_skip_block_supports_serialization()
+*
+* @param WP_Block_Type $block_type Block type.
+* @return bool Whether to serialize spacing support styles & classes.
+*/
+function wp_skip_spacing_serialization( $block_type ) {
+	_deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' );
+	$spacing_support = _wp_array_get( $block_type->supports, array( 'spacing' ), false );
+	return is_array( $spacing_support ) &&
+		array_key_exists( '__experimentalSkipSerialization', $spacing_support ) &&
+		$spacing_support['__experimentalSkipSerialization'];
+}
+/**
+* Inject the block editor assets that need to be loaded into the editor's iframe as an inline script.
+*
+* @since 5.8.0
+* @deprecated 6.0.0
+*/
+function wp_add_iframed_editor_assets_html() {
+	_deprecated_function( __FUNCTION__, '6.0.0' );
+}

changeset 19	3d72ae0968f4
parent 18	be944660c56a
child 21	48c4eec2b7e6