: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
echo '<p class="button-container">';
'<a class="button button-primary" href="%1$s" target="_blank" rel="noopener">%2$s<span class="screen-reader-text"> %3$s</span><span aria-hidden="true" class="dashicons dashicons-external"></span></a>',
esc_url( $direct_update_url ),
/* translators: Hidden accessibility text. */
__( '(opens in a new tab)' )
* Gets the URL to learn more about updating the site to use HTTPS.
* This URL can be overridden by specifying an environment variable `WP_UPDATE_HTTPS_URL` or by using the
* {@see 'wp_update_https_url'} filter. Providing an empty string is not allowed and will result in the
* default URL being used. Furthermore the page the URL links to should preferably be localized in the
* @return string URL to learn more about updating to HTTPS.
function wp_get_update_https_url() {
$default_url = wp_get_default_update_https_url();
$update_url = $default_url;
if ( false !== getenv( 'WP_UPDATE_HTTPS_URL' ) ) {
$update_url = getenv( 'WP_UPDATE_HTTPS_URL' );
* Filters the URL to learn more about updating the HTTPS version the site is running on.
* Providing an empty string is not allowed and will result in the default URL being used. Furthermore
* the page the URL links to should preferably be localized in the site language.
* @param string $update_url URL to learn more about updating HTTPS.
$update_url = apply_filters( 'wp_update_https_url', $update_url );
if ( empty( $update_url ) ) {
$update_url = $default_url;
* Gets the default URL to learn more about updating the site to use HTTPS.
* Do not use this function to retrieve this URL. Instead, use {@see wp_get_update_https_url()} when relying on the URL.
* This function does not allow modifying the returned URL, and is only used to compare the actually used URL with the
* @return string Default URL to learn more about updating to HTTPS.
function wp_get_default_update_https_url() {
/* translators: Documentation explaining HTTPS and why it should be used. */
return __( 'https://developer.wordpress.org/advanced-administration/security/https/' );
* Gets the URL for directly updating the site to use HTTPS.
* A URL will only be returned if the `WP_DIRECT_UPDATE_HTTPS_URL` environment variable is specified or
* by using the {@see 'wp_direct_update_https_url'} filter. This allows hosts to send users directly to
* the page where they can update their site to use HTTPS.
* @return string URL for directly updating to HTTPS or empty string.
function wp_get_direct_update_https_url() {
if ( false !== getenv( 'WP_DIRECT_UPDATE_HTTPS_URL' ) ) {
$direct_update_url = getenv( 'WP_DIRECT_UPDATE_HTTPS_URL' );
* Filters the URL for directly updating the PHP version the site is running on from the host.
* @param string $direct_update_url URL for directly updating PHP.
$direct_update_url = apply_filters( 'wp_direct_update_https_url', $direct_update_url );
return $direct_update_url;
* Gets the size of a directory.
* A helper function that is used primarily to check whether
* a blog has exceeded its allowed upload space.
* @since 5.2.0 $max_execution_time parameter added.
* @param string $directory Full path of a directory.
* @param int $max_execution_time Maximum time to run before giving up. In seconds.
* The timeout is global and is measured from the moment WordPress started to load.
* @return int|false|null Size in bytes if a valid directory. False if not. Null if timeout.
function get_dirsize( $directory, $max_execution_time = null ) {
* Exclude individual site directories from the total when checking the main site of a network,
* as they are subdirectories and should not be counted.
if ( is_multisite() && is_main_site() ) {
$size = recurse_dirsize( $directory, $directory . '/sites', $max_execution_time );
$size = recurse_dirsize( $directory, null, $max_execution_time );
* Gets the size of a directory recursively.
* Used by get_dirsize() to get a directory size when it contains other directories.
* @since 4.3.0 The `$exclude` parameter was added.
* @since 5.2.0 The `$max_execution_time` parameter was added.
* @since 5.6.0 The `$directory_cache` parameter was added.
* @param string $directory Full path of a directory.
* @param string|string[] $exclude Optional. Full path of a subdirectory to exclude from the total,
* or array of paths. Expected without trailing slash(es).
* @param int $max_execution_time Optional. Maximum time to run before giving up. In seconds.
* The timeout is global and is measured from the moment
* WordPress started to load. Defaults to the value of
* `max_execution_time` PHP setting.
* @param array $directory_cache Optional. Array of cached directory paths.
* Defaults to the value of `dirsize_cache` transient.
* @return int|false|null Size in bytes if a valid directory. False if not. Null if timeout.
function recurse_dirsize( $directory, $exclude = null, $max_execution_time = null, &$directory_cache = null ) {
$directory = untrailingslashit( $directory );
if ( ! isset( $directory_cache ) ) {
$directory_cache = get_transient( 'dirsize_cache' );
if ( isset( $directory_cache[ $directory ] ) && is_int( $directory_cache[ $directory ] ) ) {
return $directory_cache[ $directory ];
if ( ! file_exists( $directory ) || ! is_dir( $directory ) || ! is_readable( $directory ) ) {
( is_string( $exclude ) && $directory === $exclude ) ||
( is_array( $exclude ) && in_array( $directory, $exclude, true ) )
if ( null === $max_execution_time ) {
// Keep the previous behavior but attempt to prevent fatal errors from timeout if possible.
if ( function_exists( 'ini_get' ) ) {
$max_execution_time = ini_get( 'max_execution_time' );
// Leave 1 second "buffer" for other operations if $max_execution_time has reasonable value.
if ( $max_execution_time > 10 ) {
$max_execution_time -= 1;
* Filters the amount of storage space used by one directory and all its children, in megabytes.
* Return the actual used space to short-circuit the recursive PHP file size calculation
* and use something else, like a CDN API or native operating system tools for better performance.
* @param int|false $space_used The amount of used space, in bytes. Default false.
* @param string $directory Full path of a directory.
* @param string|string[]|null $exclude Full path of a subdirectory to exclude from the total,
* @param int $max_execution_time Maximum time to run before giving up. In seconds.
* @param array $directory_cache Array of cached directory paths.
$size = apply_filters( 'pre_recurse_dirsize', false, $directory, $exclude, $max_execution_time, $directory_cache );
$handle = opendir( $directory );
while ( ( $file = readdir( $handle ) ) !== false ) {
$path = $directory . '/' . $file;
if ( '.' !== $file && '..' !== $file ) {
if ( is_file( $path ) ) {
$size += filesize( $path );
} elseif ( is_dir( $path ) ) {
$handlesize = recurse_dirsize( $path, $exclude, $max_execution_time, $directory_cache );
if ( $max_execution_time > 0 &&
( microtime( true ) - WP_START_TIMESTAMP ) > $max_execution_time
// Time exceeded. Give up instead of risking a fatal timeout.
if ( ! is_array( $directory_cache ) ) {
$directory_cache = array();
$directory_cache[ $directory ] = $size;
// Only write the transient on the top level call and not on recursive calls.
$expiration = ( wp_using_ext_object_cache() ) ? 0 : 10 * YEAR_IN_SECONDS;
set_transient( 'dirsize_cache', $directory_cache, $expiration );
* Cleans directory size cache used by recurse_dirsize().
* Removes the current directory and all parent directories from the `dirsize_cache` transient.
* @since 5.9.0 Added input validation with a notice for invalid input.
* @param string $path Full path of a directory or file.
function clean_dirsize_cache( $path ) {
if ( ! is_string( $path ) || empty( $path ) ) {
/* translators: 1: Function name, 2: A variable type, like "boolean" or "integer". */
__( '%1$s only accepts a non-empty path string, received %2$s.' ),
'<code>clean_dirsize_cache()</code>',
'<code>' . gettype( $path ) . '</code>'
$directory_cache = get_transient( 'dirsize_cache' );
if ( empty( $directory_cache ) ) {
$expiration = ( wp_using_ext_object_cache() ) ? 0 : 10 * YEAR_IN_SECONDS;
! str_contains( $path, '/' ) &&
! str_contains( $path, '\\' )
unset( $directory_cache[ $path ] );
set_transient( 'dirsize_cache', $directory_cache, $expiration );
$path = untrailingslashit( $path );
unset( $directory_cache[ $path ] );
DIRECTORY_SEPARATOR !== $path &&
$path = dirname( $path );
unset( $directory_cache[ $path ] );
set_transient( 'dirsize_cache', $directory_cache, $expiration );
* Checks compatibility with the current WordPress version.
* @global string $wp_version The WordPress version string.
* @param string $required Minimum required WordPress version.
* @return bool True if required version is compatible or empty, false if not.
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, '>=' );
* Checks compatibility with the current PHP version.
* @param string $required Minimum required PHP version.
* @return bool True if required version is compatible or empty, false if not.
function is_php_version_compatible( $required ) {
return empty( $required ) || version_compare( PHP_VERSION, $required, '>=' );
* Checks if two numbers are nearly the same.
* This is similar to using `round()` but the precision is more fine-grained.
* @param int|float $expected The expected value.
* @param int|float $actual The actual number.
* @param int|float $precision Optional. The allowed variation. Default 1.
* @return bool Whether the numbers match within the specified precision.
function wp_fuzzy_number_match( $expected, $actual, $precision = 1 ) {
return abs( (float) $expected - (float) $actual ) <= $precision;
* Creates and returns the markup for an admin notice.
* @param string $message The message.
* Optional. An array of arguments for the admin notice. Default empty array.
* @type string $type Optional. The type of admin notice.
* For example, 'error', 'success', 'warning', 'info'.
* @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.
* @return string The markup for an admin notice.
function wp_get_admin_notice( $message, $args = array() ) {
'additional_classes' => array(),
'paragraph_wrap' => true,
$args = wp_parse_args( $args, $defaults );
* Filters the arguments for an admin notice.
* @param array $args The arguments for the admin notice.
* @param string $message The message for the admin notice.
$args = apply_filters( 'wp_admin_notice_args', $args, $message );
if ( is_string( $args['id'] ) ) {
$trimmed_id = trim( $args['id'] );
if ( '' !== $trimmed_id ) {
$id = 'id="' . $trimmed_id . '" ';
if ( is_string( $args['type'] ) ) {
$type = trim( $args['type'] );
if ( str_contains( $type, ' ' ) ) {
/* translators: %s: The "type" key. */
__( 'The %s key must be a string without spaces.' ),
$classes .= ' notice-' . $type;
if ( true === $args['dismissible'] ) {
$classes .= ' is-dismissible';
if ( is_array( $args['additional_classes'] ) && ! empty( $args['additional_classes'] ) ) {
$classes .= ' ' . implode( ' ', $args['additional_classes'] );
if ( is_array( $args['attributes'] ) && ! empty( $args['attributes'] ) ) {
foreach ( $args['attributes'] as $attr => $val ) {
$attributes .= $val ? ' ' . $attr : '';
} elseif ( is_int( $attr ) ) {
$attributes .= ' ' . esc_attr( trim( $val ) );
$attributes .= ' ' . $attr . '="' . esc_attr( trim( $val ) ) . '"';
if ( false !== $args['paragraph_wrap'] ) {
$message = "<p>$message</p>";
$markup = sprintf( '<div %1$sclass="%2$s"%3$s>%4$s</div>', $id, $classes, $attributes, $message );
* Filters the markup for an admin notice.
* @param string $markup The HTML markup for the admin notice.
* @param string $message The message for the admin notice.
* @param array $args The arguments for the admin notice.
return apply_filters( 'wp_admin_notice_markup', $markup, $message, $args );
* Outputs an admin notice.
* @param string $message The message to output.
* Optional. An array of arguments for the admin notice. Default empty array.
* @type string $type Optional. The type of admin notice.
* For example, 'error', 'success', 'warning', 'info'.
* @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.
function wp_admin_notice( $message, $args = array() ) {
* Fires before an admin notice is output.
* @param string $message The message for the admin notice.
* @param array $args The arguments for the admin notice.
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
