summaryrefslogtreecommitdiffstats
path: root/wp-includes/functions.php
diff options
context:
space:
mode:
Diffstat (limited to 'wp-includes/functions.php')
-rw-r--r--wp-includes/functions.php186
1 files changed, 121 insertions, 65 deletions
diff --git a/wp-includes/functions.php b/wp-includes/functions.php
index cb490ee..fd305be 100644
--- a/wp-includes/functions.php
+++ b/wp-includes/functions.php
@@ -1548,11 +1548,11 @@ function nocache_headers() {
* @since 2.1.0
*/
function cache_javascript_headers() {
- $expiresOffset = 10 * DAY_IN_SECONDS;
+ $expires_offset = 10 * DAY_IN_SECONDS;
header( 'Content-Type: text/javascript; charset=' . get_bloginfo( 'charset' ) );
header( 'Vary: Accept-Encoding' ); // Handle proxies.
- header( 'Expires: ' . gmdate( 'D, d M Y H:i:s', time() + $expiresOffset ) . ' GMT' );
+ header( 'Expires: ' . gmdate( 'D, d M Y H:i:s', time() + $expires_offset ) . ' GMT' );
}
/**
@@ -1692,7 +1692,7 @@ function do_feed_atom( $for_comments ) {
* Displays the default robots.txt file content.
*
* @since 2.1.0
- * @since 5.3.0 Remove the "Disallow: /" output if search engine visiblity is
+ * @since 5.3.0 Remove the "Disallow: /" output if search engine visibility is
* discouraged in favor of robots meta HTML tag via wp_robots_no_robots()
* filter callback.
*/
@@ -3117,6 +3117,7 @@ function wp_check_filetype_and_ext( $file, $filename, $mimes = null ) {
'image/bmp' => 'bmp',
'image/tiff' => 'tif',
'image/webp' => 'webp',
+ 'image/avif' => 'avif',
)
);
@@ -3295,6 +3296,7 @@ function wp_check_filetype_and_ext( $file, $filename, $mimes = null ) {
*
* @since 4.7.1
* @since 5.8.0 Added support for WebP images.
+ * @since 6.5.0 Added support for AVIF images.
*
* @param string $file Full path to the file.
* @return string|false The actual mime type or false if the type cannot be determined.
@@ -3349,6 +3351,25 @@ function wp_get_image_mime( $file ) {
) {
$mime = 'image/webp';
}
+
+ /**
+ * Add AVIF fallback detection when image library doesn't support AVIF.
+ *
+ * Detection based on section 4.3.1 File-type box definition of the ISO/IEC 14496-12
+ * specification and the AV1-AVIF spec, see https://aomediacodec.github.io/av1-avif/v1.1.0.html#brands.
+ */
+
+ // Divide the header string into 4 byte groups.
+ $magic = str_split( $magic, 8 );
+
+ if (
+ isset( $magic[1] ) &&
+ isset( $magic[2] ) &&
+ 'ftyp' === hex2bin( $magic[1] ) &&
+ ( 'avif' === hex2bin( $magic[2] ) || 'avis' === hex2bin( $magic[2] ) )
+ ) {
+ $mime = 'image/avif';
+ }
} catch ( Exception $e ) {
$mime = false;
}
@@ -3388,6 +3409,7 @@ function wp_get_mime_types() {
'bmp' => 'image/bmp',
'tiff|tif' => 'image/tiff',
'webp' => 'image/webp',
+ 'avif' => 'image/avif',
'ico' => 'image/x-icon',
'heic' => 'image/heic',
// Video formats.
@@ -3509,7 +3531,7 @@ function wp_get_ext_types() {
return apply_filters(
'ext2type',
array(
- 'image' => array( 'jpg', 'jpeg', 'jpe', 'gif', 'png', 'bmp', 'tif', 'tiff', 'ico', 'heic', 'webp' ),
+ 'image' => array( 'jpg', 'jpeg', 'jpe', 'gif', 'png', 'bmp', 'tif', 'tiff', 'ico', 'heic', 'webp', 'avif' ),
'audio' => array( 'aac', 'ac3', 'aif', 'aiff', 'flac', 'm3a', 'm4a', 'm4b', 'mka', 'mp1', 'mp2', 'mp3', 'ogg', 'oga', 'ram', 'wav', 'wma' ),
'video' => array( '3g2', '3gp', '3gpp', 'asf', 'avi', 'divx', 'dv', 'flv', 'm4v', 'mkv', 'mov', 'mp4', 'mpeg', 'mpg', 'mpv', 'ogm', 'ogv', 'qt', 'rm', 'vob', 'wmv' ),
'document' => array( 'doc', 'docx', 'docm', 'dotm', 'odt', 'pages', 'pdf', 'xps', 'oxps', 'rtf', 'wp', 'wpd', 'psd', 'xcf' ),
@@ -3718,7 +3740,7 @@ function wp_die( $message = '', $title = '', $args = array() ) {
* @param callable $callback Callback function name.
*/
$callback = apply_filters( 'wp_die_json_handler', '_json_wp_die_handler' );
- } elseif ( defined( 'REST_REQUEST' ) && REST_REQUEST && wp_is_jsonp_request() ) {
+ } elseif ( wp_is_serving_rest_request() && wp_is_jsonp_request() ) {
/**
* Filters the callback for killing WordPress execution for JSONP REST requests.
*
@@ -3883,21 +3905,16 @@ function _default_wp_die_handler( $message, $title = '', $args = array() ) {
font-size: 14px ;
}
a {
- color: #0073aa;
+ color: #2271b1;
}
a:hover,
a:active {
- color: #006799;
+ color: #135e96;
}
a:focus {
- color: #124964;
- -webkit-box-shadow:
- 0 0 0 1px #5b9dd9,
- 0 0 2px 1px rgba(30, 140, 190, 0.8);
- box-shadow:
- 0 0 0 1px #5b9dd9,
- 0 0 2px 1px rgba(30, 140, 190, 0.8);
- outline: none;
+ color: #043959;
+ box-shadow: 0 0 0 2px #2271b1;
+ outline: 2px solid transparent;
}
.button {
background: #f3f5f6;
@@ -4034,6 +4051,10 @@ function _json_wp_die_handler( $message, $title = '', $args = array() ) {
'additional_errors' => $parsed_args['additional_errors'],
);
+ if ( isset( $parsed_args['error_data'] ) ) {
+ $data['data']['error'] = $parsed_args['error_data'];
+ }
+
if ( ! headers_sent() ) {
header( "Content-Type: application/json; charset={$parsed_args['charset']}" );
if ( null !== $parsed_args['response'] ) {
@@ -4072,6 +4093,10 @@ function _jsonp_wp_die_handler( $message, $title = '', $args = array() ) {
'additional_errors' => $parsed_args['additional_errors'],
);
+ if ( isset( $parsed_args['error_data'] ) ) {
+ $data['data']['error'] = $parsed_args['error_data'];
+ }
+
if ( ! headers_sent() ) {
header( "Content-Type: application/javascript; charset={$parsed_args['charset']}" );
header( 'X-Content-Type-Options: nosniff' );
@@ -4249,6 +4274,9 @@ function _wp_die_process_input( $message, $title = '', $args = array() ) {
if ( empty( $title ) && is_array( $errors[0]['data'] ) && ! empty( $errors[0]['data']['title'] ) ) {
$title = $errors[0]['data']['title'];
}
+ if ( WP_DEBUG_DISPLAY && is_array( $errors[0]['data'] ) && ! empty( $errors[0]['data']['error'] ) ) {
+ $args['error_data'] = $errors[0]['data']['error'];
+ }
unset( $errors[0] );
$args['additional_errors'] = array_values( $errors );
@@ -4284,36 +4312,38 @@ function _wp_die_process_input( $message, $title = '', $args = array() ) {
}
/**
- * Encodes a variable into JSON, with some sanity checks.
+ * Encodes a variable into JSON, with some confidence checks.
*
* @since 4.1.0
* @since 5.3.0 No longer handles support for PHP < 5.6.
+ * @since 6.5.0 The `$data` parameter has been renamed to `$value` and
+ * the `$options` parameter to `$flags` for parity with PHP.
*
- * @param mixed $data Variable (usually an array or object) to encode as JSON.
- * @param int $options Optional. Options to be passed to json_encode(). Default 0.
- * @param int $depth Optional. Maximum depth to walk through $data. Must be
- * greater than 0. Default 512.
+ * @param mixed $value Variable (usually an array or object) to encode as JSON.
+ * @param int $flags Optional. Options to be passed to json_encode(). Default 0.
+ * @param int $depth Optional. Maximum depth to walk through $value. Must be
+ * greater than 0. Default 512.
* @return string|false The JSON encoded string, or false if it cannot be encoded.
*/
-function wp_json_encode( $data, $options = 0, $depth = 512 ) {
- $json = json_encode( $data, $options, $depth );
+function wp_json_encode( $value, $flags = 0, $depth = 512 ) {
+ $json = json_encode( $value, $flags, $depth );
- // If json_encode() was successful, no need to do more sanity checking.
+ // If json_encode() was successful, no need to do more confidence checking.
if ( false !== $json ) {
return $json;
}
try {
- $data = _wp_json_sanity_check( $data, $depth );
+ $value = _wp_json_sanity_check( $value, $depth );
} catch ( Exception $e ) {
return false;
}
- return json_encode( $data, $options, $depth );
+ return json_encode( $value, $flags, $depth );
}
/**
- * Performs sanity checks on data that shall be encoded to JSON.
+ * Performs confidence checks on data that shall be encoded to JSON.
*
* @ignore
* @since 4.1.0
@@ -4323,18 +4353,18 @@ function wp_json_encode( $data, $options = 0, $depth = 512 ) {
*
* @throws Exception If depth limit is reached.
*
- * @param mixed $data Variable (usually an array or object) to encode as JSON.
- * @param int $depth Maximum depth to walk through $data. Must be greater than 0.
+ * @param mixed $value Variable (usually an array or object) to encode as JSON.
+ * @param int $depth Maximum depth to walk through $value. Must be greater than 0.
* @return mixed The sanitized data that shall be encoded to JSON.
*/
-function _wp_json_sanity_check( $data, $depth ) {
+function _wp_json_sanity_check( $value, $depth ) {
if ( $depth < 0 ) {
throw new Exception( 'Reached depth limit' );
}
- if ( is_array( $data ) ) {
+ if ( is_array( $value ) ) {
$output = array();
- foreach ( $data as $id => $el ) {
+ foreach ( $value as $id => $el ) {
// Don't forget to sanitize the ID!
if ( is_string( $id ) ) {
$clean_id = _wp_json_convert_string( $id );
@@ -4351,9 +4381,9 @@ function _wp_json_sanity_check( $data, $depth ) {
$output[ $clean_id ] = $el;
}
}
- } elseif ( is_object( $data ) ) {
+ } elseif ( is_object( $value ) ) {
$output = new stdClass();
- foreach ( $data as $id => $el ) {
+ foreach ( $value as $id => $el ) {
if ( is_string( $id ) ) {
$clean_id = _wp_json_convert_string( $id );
} else {
@@ -4368,10 +4398,10 @@ function _wp_json_sanity_check( $data, $depth ) {
$output->$clean_id = $el;
}
}
- } elseif ( is_string( $data ) ) {
- return _wp_json_convert_string( $data );
+ } elseif ( is_string( $value ) ) {
+ return _wp_json_convert_string( $value );
} else {
- return $data;
+ return $value;
}
return $output;
@@ -4418,12 +4448,12 @@ function _wp_json_convert_string( $input_string ) {
* has been dropped.
* @access private
*
- * @param mixed $data Native representation.
+ * @param mixed $value Native representation.
* @return bool|int|float|null|string|array Data ready for `json_encode()`.
*/
-function _wp_json_prepare_data( $data ) {
+function _wp_json_prepare_data( $value ) {
_deprecated_function( __FUNCTION__, '5.3.0' );
- return $data;
+ return $value;
}
/**
@@ -4431,15 +4461,15 @@ function _wp_json_prepare_data( $data ) {
*
* @since 3.5.0
* @since 4.7.0 The `$status_code` parameter was added.
- * @since 5.6.0 The `$options` parameter was added.
+ * @since 5.6.0 The `$flags` parameter was added.
*
* @param mixed $response Variable (usually an array or object) to encode as JSON,
* then print and die.
* @param int $status_code Optional. The HTTP status code to output. Default null.
- * @param int $options Optional. Options to be passed to json_encode(). Default 0.
+ * @param int $flags Optional. Options to be passed to json_encode(). Default 0.
*/
-function wp_send_json( $response, $status_code = null, $options = 0 ) {
- if ( defined( 'REST_REQUEST' ) && REST_REQUEST ) {
+function wp_send_json( $response, $status_code = null, $flags = 0 ) {
+ if ( wp_is_serving_rest_request() ) {
_doing_it_wrong(
__FUNCTION__,
sprintf(
@@ -4459,7 +4489,7 @@ function wp_send_json( $response, $status_code = null, $options = 0 ) {
}
}
- echo wp_json_encode( $response, $options );
+ echo wp_json_encode( $response, $flags );
if ( wp_doing_ajax() ) {
wp_die(
@@ -4479,46 +4509,46 @@ function wp_send_json( $response, $status_code = null, $options = 0 ) {
*
* @since 3.5.0
* @since 4.7.0 The `$status_code` parameter was added.
- * @since 5.6.0 The `$options` parameter was added.
+ * @since 5.6.0 The `$flags` parameter was added.
*
- * @param mixed $data Optional. Data to encode as JSON, then print and die. Default null.
+ * @param mixed $value Optional. Data to encode as JSON, then print and die. Default null.
* @param int $status_code Optional. The HTTP status code to output. Default null.
- * @param int $options Optional. Options to be passed to json_encode(). Default 0.
+ * @param int $flags Optional. Options to be passed to json_encode(). Default 0.
*/
-function wp_send_json_success( $data = null, $status_code = null, $options = 0 ) {
+function wp_send_json_success( $value = null, $status_code = null, $flags = 0 ) {
$response = array( 'success' => true );
- if ( isset( $data ) ) {
- $response['data'] = $data;
+ if ( isset( $value ) ) {
+ $response['data'] = $value;
}
- wp_send_json( $response, $status_code, $options );
+ wp_send_json( $response, $status_code, $flags );
}
/**
* Sends a JSON response back to an Ajax request, indicating failure.
*
- * If the `$data` parameter is a WP_Error object, the errors
+ * If the `$value` parameter is a WP_Error object, the errors
* within the object are processed and output as an array of error
* codes and corresponding messages. All other types are output
* without further processing.
*
* @since 3.5.0
- * @since 4.1.0 The `$data` parameter is now processed if a WP_Error object is passed in.
+ * @since 4.1.0 The `$value` parameter is now processed if a WP_Error object is passed in.
* @since 4.7.0 The `$status_code` parameter was added.
- * @since 5.6.0 The `$options` parameter was added.
+ * @since 5.6.0 The `$flags` parameter was added.
*
- * @param mixed $data Optional. Data to encode as JSON, then print and die. Default null.
+ * @param mixed $value Optional. Data to encode as JSON, then print and die. Default null.
* @param int $status_code Optional. The HTTP status code to output. Default null.
- * @param int $options Optional. Options to be passed to json_encode(). Default 0.
+ * @param int $flags Optional. Options to be passed to json_encode(). Default 0.
*/
-function wp_send_json_error( $data = null, $status_code = null, $options = 0 ) {
+function wp_send_json_error( $value = null, $status_code = null, $flags = 0 ) {
$response = array( 'success' => false );
- if ( isset( $data ) ) {
- if ( is_wp_error( $data ) ) {
+ if ( isset( $value ) ) {
+ if ( is_wp_error( $value ) ) {
$result = array();
- foreach ( $data->errors as $code => $messages ) {
+ foreach ( $value->errors as $code => $messages ) {
foreach ( $messages as $message ) {
$result[] = array(
'code' => $code,
@@ -4529,11 +4559,11 @@ function wp_send_json_error( $data = null, $status_code = null, $options = 0 ) {
$response['data'] = $result;
} else {
- $response['data'] = $data;
+ $response['data'] = $value;
}
}
- wp_send_json( $response, $status_code, $options );
+ wp_send_json( $response, $status_code, $flags );
}
/**
@@ -4695,6 +4725,23 @@ function _mce_set_direction( $mce_init ) {
return $mce_init;
}
+/**
+ * Determines whether WordPress is currently serving a REST API request.
+ *
+ * The function relies on the 'REST_REQUEST' global. As such, it only returns true when an actual REST _request_ is
+ * being made. It does not return true when a REST endpoint is hit as part of another request, e.g. for preloading a
+ * REST response. See {@see wp_is_rest_endpoint()} for that purpose.
+ *
+ * This function should not be called until the {@see 'parse_request'} action, as the constant is only defined then,
+ * even for an actual REST request.
+ *
+ * @since 6.5.0
+ *
+ * @return bool True if it's a WordPress REST API request, false otherwise.
+ */
+function wp_is_serving_rest_request() {
+ return defined( 'REST_REQUEST' ) && REST_REQUEST;
+}
/**
* Converts smiley code to the icon graphic file equivalent.
@@ -5354,7 +5401,7 @@ function wp_widgets_add_menu() {
if ( wp_is_block_theme() || current_theme_supports( 'block-template-parts' ) ) {
$submenu['themes.php'][] = array( $menu_name, 'edit_theme_options', 'widgets.php' );
} else {
- $submenu['themes.php'][7] = array( $menu_name, 'edit_theme_options', 'widgets.php' );
+ $submenu['themes.php'][8] = array( $menu_name, 'edit_theme_options', 'widgets.php' );
}
ksort( $submenu['themes.php'], SORT_NUMERIC );
@@ -6107,7 +6154,7 @@ function iis7_supports_permalinks() {
* easily update the xml configuration file, hence we just bail out and tell user that
* pretty permalinks cannot be used.
*
- * Next we check if the URL Rewrite Module 1.1 is loaded and enabled for the web site. When
+ * Next we check if the URL Rewrite Module 1.1 is loaded and enabled for the website. When
* URL Rewrite 1.1 is loaded it always sets a server variable called 'IIS_UrlRewriteModule'.
* Lastly we make sure that PHP is running via FastCGI. This is important because if it runs
* via ISAPI then pretty permalinks will not work.
@@ -6531,7 +6578,7 @@ function wp_timezone_choice( $selected_zone, $locale = null ) {
if ( ! $mo_loaded || $locale !== $locale_loaded ) {
$locale_loaded = $locale ? $locale : get_locale();
$mofile = WP_LANG_DIR . '/continents-cities-' . $locale_loaded . '.mo';
- unload_textdomain( 'continents-cities' );
+ unload_textdomain( 'continents-cities', true );
load_textdomain( 'continents-cities', $mofile, $locale_loaded );
$mo_loaded = true;
}
@@ -8716,6 +8763,14 @@ function is_wp_version_compatible( $required ) {
// Strip off any -alpha, -RC, -beta, -src suffixes.
list( $version ) = explode( '-', $wp_version );
+ if ( is_string( $required ) ) {
+ $trimmed = trim( $required );
+
+ if ( substr_count( $trimmed, '.' ) > 1 && str_ends_with( $trimmed, '.0' ) ) {
+ $required = substr( $trimmed, 0, -2 );
+ }
+ }
+
return empty( $required ) || version_compare( $version, $required, '>=' );
}
@@ -8874,6 +8929,7 @@ function wp_get_admin_notice( $message, $args = array() ) {
* @type bool $dismissible Optional. Whether the admin notice is dismissible. Default false.
* @type string $id Optional. The value of the admin notice's ID attribute. Default empty string.
* @type string[] $additional_classes Optional. A string array of class names. Default empty array.
+ * @type string[] $attributes Optional. Additional attributes for the notice div. Default empty array.
* @type bool $paragraph_wrap Optional. Whether to wrap the message in paragraph tags. Default true.
* }
*/
generated by cgit v1.2.3 (git 2.39.1) at 2024-11-24 02:08:51 +0000