Tests: Correct a number of malformed `@covers` tags.

As per the documentation of the `@covers` tag, global functions being covered should be prefixed with `::`. Also, the `()` after the function name is redundant.

Follow-up to [39918].

Props jrf.
See #50267.

Build/Test Tools: Update code coverage setup in the `phpunit.xml.dist` file to point to the `build` directory.

This makes the configuration consistent with the `WP_RUN_CORE_TESTS` constant being set to `1` in the same config file.

Additionally, update the list to be in line with the current codebase, excluding the plugins and themes bundled with WordPress core from being considered for code coverage.

Note: If you have a local `phpunit.xml` file that changes the `WP_RUN_CORE_TESTS` constant to `0`, you should also - in the same file - change the code coverage setup to use the `src` directory.

Follow-up to [42665], [43311].

Props jrf, mmarco9.
See #50267.

Tests: Update `wp-api-generated.js` to reflect the new "Reusable Blocks" post type label.

Follow-up to [48829].

See #50755.

General: Ensure `svn:eol-style` is consistently set for all recently added files.

Fixes #51113.

Tests: Clear any previous term IDs from the metadata lazyloader queue in term meta lazy-loading test.

This fixes random test failures when one of the term IDs from previous tests coincides with the orphan term ID from this test that should not be lazy-loaded.

Follow-up to [34529], [36566].

Fixes #51109.

Docs: Update the description for the `$legacy` parameter of `wp_count_terms()` for consistency with `get_terms()`.

Follow-up to [48840].

See #36399.

REST API: In `WP_REST_Block_Directory_Controller::get_items()`, make sure the blocks data for a plugin is not empty before proceeding.

This avoids a PHP notice if the API returns a plugin with empty data for `blocks` key.

Props khag7, TwentyZeroTwo, justinahinon, TimothyBlynJacobs, dd32, SergeyBiryukov.
Fixes #51018.

Editor: Use `wp_add_inline_script()` instead of `wp_localize_script()` to pass the `_wpMetaBoxUrl` value to the `wp-editor` script.

This fixes a PHP 8 "Only the first byte will be assigned to the string offset" warning on Edit Post screen.

The correct usage of `wp_localize_script()` is to pass an array of data, not a string.

Fixes #51108.

Taxonomy: Allow for `wp_count_terms( $args )` signature, making passing a taxonomy optional.

This brings `wp_count_terms()` in line with other taxonomy functions such as `get_terms()` which technically no longer require a taxonomy. Similar to the previously modified functions, no deprecation warning is triggered when using the legacy signature.

Fixes #36399.

Code Modernization: Fix PHP 8 "ArgumentCountError: array_merge() does not accept unknown named parameters" fatal error in `retrieve_widgets()`.

As per the documentation of `call_user_func_array()`, the `$param_arr` should be a (numerically) indexed array, not a string-keyed array.

As we can use the spread operator in PHP 5.6+, there isn't really any need to use `call_user_func_array()` anyhow, we can call the `array_merge()` function directly.

The caveat to this is that the spread operator only works on numerically indexed arrays, so we need to wrap the `$sidebars_widgets` variable in a call to `array_values()` when using the spread operator.

Using `array_values()` in the existing `call_user_func_array()` call would also have solved this, but the solution now proposed, has the added benefit of getting rid of the overhead of `call_user_func_array()`.

Props jrf.
See #50913.

Code Modernization: Fix PHP 8 "argument must be passed by reference, value given" error in `WP_Comment_Query::get_comments()`.

The WP native `get_comment()` function expects the first argument `$comment` to be passed by reference.

The PHP `array_map()` function, however, passes by value, not by reference, resulting in an "arguments must be passed by reference, value given" error.

The PHP native `array_walk()` function does pass by reference. Using this prevents the error on PHP 8 and maintains the existing behaviour on PHP < 8.

Props jrf.
See #50913.

Twenty Nineteen: Remove trailing commas after selectors in `style-editor.scss`.

Remove one empty CSS block.

Props justinahinon.
Fixes #51095.

Privacy: Avoid a PHP 7.4 notice in `WP_Privacy_Policy_Content::text_change_check()`.

When iterating over the items stored in '_wp_suggested_privacy_policy_content` meta value for the Privacy Policy page, make sure the item is an array before accessing its properties.

Props treibstoff.
Fixes #51084.

Docs: Correct references to `WP_Filesystem_Base` methods in various DocBlocks.

Props pbiron.
Fixes #51087.

Customize: Add `/` character to `<img>` tag in `WP_Customize_Manager` and `WP_Customize_Header_Image_Control` JS templates.

While this has no effect on void elements in HTML5, it fixes a minor inconsistency with the rest of core.

Props laxman-prajapati.
Fixes #51077.

Docs: Update documentation for `get_custom_logo()` and `the_custom_logo()` to mention the `unlink-homepage-logo` theme feature.

Follow-up to [48039], [48283], [48749], [48757], [48758].

Props sabernhardt.
Fixes #51075.

Coding Standards: Fix WPCS issue in [48830].

See #51044.

Tests: Update unit tests to account for `comment_agent` and `comment_author_IP` values being passed to the `preprocess_comment` filter.

See #51044.

Editor: Update the post type labels for the reusable blocks post type.

Previously, the labels for the reusable block post type were just “block”. The document settings tab in the block editor has been changed to use the post type label specified instead to be more specific. Changing the reusable block post type labels to “reusable block” prevents two “Block” tabs from showing in the editor.

Props desaiuditd, peterwilsoncc.
Fixes #50755.

Docs: Add a `@since` note to `register_rest_route()` about the `_doing_it_wrong()` notice when the required `permission_callback` argument is not set.

Follow-up to [48526].

Props psykro.
Fixes #51060.

Docs: Improve description for `WP_Admin_Bar::add_group()`.

Props stevenlinx.
Fixes #50779.

Bundled Themes: Correct punctuation in "Your comment is awaiting moderation" string.

Props llizard, mayankmajeji.
Fixes #49867.

Comments: Correct punctuation in "Your comment is awaiting moderation" string in `Walker_Comment`.

Props llizard.
See #49867.

Comments: Revert unintended changes from [48822].

See #51044.

Comments: Make sure the comment data passed to the `preprocess_comment` filter includes the `comment_agent` and `comment_author_IP` values.

Props zodiac1978, SergeyBiryukov.
Fixes #51044.

Plugins: Avoid a PHP notice if the `update-supported` key in plugin data is not set.

Props sanzeeb3.
Fixes #51052.

Build/Test Tools: Update several NPM dependencies.

These updates were applied by running `npm audit fix`.

See #50769.

Formatting: Make the check for empty text in `wp_trim_excerpt()` more resilient.

This addresses a regression in [47808], which caused excerpts to be generated from post content if an empty string is passed, but not for other values considered empty, e.g. `null` or `false`.

Props riaanlom, laxman-prajapati, SergeyBiryukov.
Fixes #51042.

Docs: Correct alignment for some DocBlocks in `WP_Query::get_posts()`.

See #50768.

Docs: Add a `@since` note to `get_the_archive_title()` about the title part being wrapped in a `<span>` element.

Follow-up to [48294].

Props justinahinon, audrasjb.
Fixes #51050.

Accessibility: Toolbar: Don't output the "Skip to toolbar" link in modern themes that support the `wp_body_open` action.

The links is unnecessary there, as the toolbar is the first thing in the DOM within the `<body>` element.

For themes that don't implement the `wp_body_open` action yet and render the admin bar in the footer, the "Skip to toolbar" link with `tabindex="1"` is still necessary, to ensure it's the first focusable element in the page.

Props sarahricker, afercia, erikjandelange, audrasjb.
Fixes #50702.

Help/About: Fix typo and remove trailing spaces from some strings.

Props mukesh27, casiepa, davidbaumwald.
Fixes #51028.

Site Health: Ensure that the tests returned by `WP_Site_Health::get_tests()` always have the required array keys: `direct` and `async`.

This avoids PHP notices if these keys were accidentally removed using the `site_status_tests` filter.

Props khag7, Ov3rfly, desrosj, Clorith.
Fixes #50858.

Site Health: Add site environment type to the debug information.

Follow-up to [47919], [48188], [48372].

Props joostdevalk, Clorith.
Fixes #50887.

Site Health: Rename the `$upload_max_size` variable to `$upload_max_filesize`, for consistency with the PHP setting name.

Follow-up to [48535], [48538], [48539], [48544], [48800].

See #50945.

Site Health: Only display the warning about the `post_max_size` PHP value when it's lower than `upload_max_filesize`.

Previously, the warning was displayed even if the value was higher than `upload_max_filesize`, which made the report inaccurate, as these values don't necessarily have to match.

Props oakesjosh, jeroenrotty, desrosj, Clorith.
Fixes #50945.

Docs: Fix typo in the `$image` parameter description in `is_gd_image()`.

Follow-up to [48798].

See #50833.

Code Modernization: Introduce `is_gd_image()` to check for PHP 8 `GdImage` object instances.

In PHP 8, the GD extension uses `GdImage` objects instead of resources for its underlying data structures.

This updates the existing `is_resource()` calls for image resources in core to accomodate for `GdImage` instances as well.

Props ayeshrajans, jrf.
Fixes #50833.

Filesystem API: Use correct variable when closing the file handle in `WP_Filesystem_FTPext::get_contents()`.

Props [email protected]
Fixes #51029.

REST API: Add uniqueItems as a permitted endpoint argument JSON Schema keyword.

Support for the `uniqueItems` keyword was added in [48357], but wasn't included in the list of permitted keywords for `WP_REST_Controller::get_endpoint_args_for_item_schema()`. This prevented the keyword from being automatically supported if specified in a controller's item schema.

Fixes #51021.

Menus: Make the `$object_id` parameter of `_wp_delete_post_menu_item()` required, for consistency with `_wp_delete_tax_menu_item()`.

The function is private (only intended for core usage) and is hooked to the `delete_post` action, which always passes a non-zero post ID.

Follow-up to [14295], [48794].

See #50343.

Code Modernization: Fix PHP 8 deprecation notices for optional function parameters declared before required parameters.

As it already was not possible to pass the required parameters without also passing the optional one anyway, removing the default value for the (not so) optional parameters should not affect backward compatibility.

This change affects three functions in core:

* `get_comment_delimited_block_content()`
* `do_enclose()`
* `_wp_delete_tax_menu_item()`

Props jrf, ayeshrajans, desrosj.
Fixes #50343.

Docs: Document the parameters of `wp_get_associated_nav_menu_items()` as optional.

See #50768.

Site Health: Recognize `define( 'WP_AUTO_UPDATE_CORE', 'minor' )` as an acceptable value.

Previously, it was only incidentally recognized as valid due to a loose comparison with `true`.

With the strict comparison added to `WP_Site_Health_Auto_Updates::test_constants()`, this was no longer the case.

Follow-up to [47841].

Props sterndata, mukesh27, avixansa, desrosj, SergeyBiryukov.
Fixes #50912.

Tests: Consistently unregister custom settings after performing assertions in `WP_Test_REST_Settings_Controller`.

This ensures that those settings don't leak to other tests.

Props david.binda, TimothyBlynJacobs, SergeyBiryukov.
Fixes #50986.

Code Modernization: Change `create_function()` in `phpunit/includes/plural-form-function.php` to closure.

`create_function()` has been deprecated in PHP >= 7.2 and removed in PHP 8.

The only instance left in core was used in a test that was being skipped on PHP >= 7.2. This allows the test to run again.

Follow-up to [41722], [41730].

Props jrf.
Fixes #50899.

Code Modernization: Only call `libxml_disable_entity_loader()` in PHP < 8.

This function has been deprecated in PHP 8.0 because in libxml 2.9.0, external entity loading is disabled by default, so this function is no longer needed to protect against XXE attacks.

Props jrf.
Fixes #50898.

Code Modernization: Remove `final` keyword from private methods.

Declaring a `private` method as `final` is an oxymoron, as `private` methods cannot be overloaded anyway.

Using `final private function...` will generate a warning in PHP 8.

Props jrf.
Fixes #50897.

Help/About: Final adjustments to the 5.5 About page.

- Final CDN asset URLs.
- Some minor color adjustments.

Props ryelle, marybaum, davidbaumwald, audrasjb, estelaris, afercia, cbringmann, andreamiddleton, desrosj, SergeyBiryukov, ocean90, nrqsnchz, spacedmonkey, whyisjake, man4toman.
Fixes #50416.

Docs: Consistently use third-person singular verbs for various filter descriptions, per the documentation standards.

See #50768.

Docs: Update documentation for `get_{$meta_type}_metadata` filter for consistency with `default_{$meta_type}_metadata`.

Follow-up to [48777].

See #50891.

Options, Meta APIs: Update the docs around default metadata values.

Add a missing @since value for 5.5 and potential default filter names.

Fixes #50891.
Props johnbillion.

Bundled Themes: Bump theme versions ahead of WordPress 5.5.

The following theme versions will be released in coordination with WordPress 5.5:
- Twenty Ten: 3.1
- Twenty Eleven: 3.5
- Twenty Twelve: 3.2
- Twenty Thirteen: 3.1
- Twenty Fourteen: 2.9
- Twenty Fifteen: 2.7
- Twenty Sixteen: 2.2
- Twenty Seventeen: 2.4
- Twenty Nineteen: 1.7
- Twenty Twenty: 1.5

Props whyisjake, desrosj.
Fixes #50769.

Build/Test Tools: Update `elliptic` in Twenty Twenty.

See #50769.

Editor: update packages

Fixes #50888

I18N: Fix typo in a screen reader text string on the About page.

Follow-up to [48729].

Props pedromendonca.
Fixes #50884.

I18N: Add a `class_exists()` check to `Plural_Forms` class for consistency with other POMO library classes.

Follow-up to [41722].

Fixes #50881.

I18N: Fix typo in a string in `rest_validate_value_from_schema()`.

Props pedromendonca.
Fixes #50879.

Coding Standards: Remove a few more extra brackets from some conditions in `wp-admin/includes/plugin.php`.

Follow-up to [48764].

See #50767.

Coding Standards: Use consistent formatting for translator comments in `wp-includes/rest-api.php`.

See #50767.

Coding Standards: Fix WPCS issues in `wp-admin/includes/plugin.php`.

Includes minor code layout fixes for better readability.

Props rnaby for initial patch.
See #50767, #43848.

Coding Standards: Simplify some parts of `user_can_access_admin_page()` for better readability.

Props rnaby, valentinbora, khag7.
Fixes #43848.

Help/About: Update videos and their descriptions on the About page.

Follow-up to [48675], [48686], [48721], [48729], [48730], [48736].

Props ryelle, marybaum, estelaris, desrosj, joen, afercia.
See #50416.

Docs: Document the return value of `get_settings_errors()` using hash notation.

Props stevenlinx, webdevmattcrom, atachibana.
Fixes #42786.

Themes: Update the `test_theme_supports_custom_logo` to check for the `unlink-homepage-logo` property.

See #37011, [48757].
Props TimothyBlynJacobs, whyisjake.

Themes: Add `unlink-homepage-logo` to the `create_initial_theme_features()` registration for the `custom-logo` theme feature.

Follow-up to [48039], [48283], [48749].

Props TimothyBlynJacobs.
Fixes #37011.

Script Loader: Remove the `jquery-migrate-compat-5.5` temporary script handle for now. Can be re-added later if there is a compelling use case. For now it doesn't seem necessary.

See #37110.

Script Loader: Add a temporary `jquery-migrate-compat-5.5` script handle.

This is intended as an easy way for plugins and themes to still be able to load jQuery with jQuery Migrate in WordPress 5.5.

Once jQuery is updated to 3.x, this temporary script handle will be removed. This means plugins and themes still using it at that point will fail to load their scripts (as a dependency will be missing), but will not cause "fatal errors" breaking the rest of JS.

Follow-up to [48323], [48324].

Props azaozz, desrosj, apedog, Clorith, jorbin.
Fixes #37110.

Comments: Update DB version number used to trigger the upgrade routine for changing the `comment_type` DB field value in comments table.

Follow-up to [47597], [47626], [48225], [48227], [48748].

Props desrosj.
See #49236.

Docs: Correct usage of the dynamic `auto_update_{$type}` filter.

This ensures that the canonical name of the filter is used in Site Health debug data, as well as on plugin and theme screens, so the developer reference site remains correct.

Props johnbillion.
Fixes #50868.

Accessibility: Themes: Only unlink custom logo on the home page if the theme declares support for that.

To accommodate for the change, the `custom-logo` theme feature now accepts the `unlink-homepage-logo` parameter.

If and when the logo is linked on the home page, the link has the `aria-current` attribute for better accessibility.

Follow-up to [48039], [48283].

Props sabernhardt, audrasjb, johnstonphilip, demetris.
Fixes #37011.

Comments: Update comment cache in the upgrade routine for changing the `comment_type` DB field value in comments table.

This ensures that comment object cache is cleared after changing the comment type to `comment` instead of an empty string.

Add a unit test for `_wp_batch_update_comment_type()`.

Follow-up to [47597], [47626], [48225], [48227].

Props imath, westonruter.
Fixes #49236.

Site Health: Consistently pass an object to the `auto_update_{$type}` filter in Site Health debug data.

Previously, some instances of the filter received an array from a plugin or theme update response, potentially triggering PHP notices.

Props bpayton, pbiron.
Fixes #50852.

Tests: Correct duplicate array keys in `Tests_Kses::test_wp_filter_post_kses_address()`.

Previously, only the last `style` value was actually tested.

Props ediamin.
Fixes #50860.

Posts, Post Types: Use a consistent wording in messages about a locked post.

Props ramiy.
Fixes #50859.

Site Health: Check if `session_status()` exists before calling it.

Props bgermann.
Fixes #50862.

Comments: Remove a few more unnecessary instances of `esc_html()` in `WP_Comments_List_Table::comment_status_dropdown()`.

Core translations are considered safe, and these labels are not escaped in any other instances.

Follow-up to [48521], [48722], [48724].

See #40188, #50815.

Help/About: Correct header spacing on shorter screens after removing the musician name.

Remove some unnecessary CSS.

Follow-up to [48730].

Props ryelle.
See #50416.

Plugins: Move the "Successfully installed the plugin" string to the correct `Plugin_Upgrader` method.

The string refers to the installation, and belongs in the `::install_strings()` method, not in `::upgrade_strings()`.

Props sswebster, nateinaction, SergeyBiryukov.
Fixes #50837.

Site Health: Display auto-update properly for plugins that don't support auto-updates.

Properly filter `auto_update_plugin` when displaying the table.

Fixes #50822.
Props Gwendydd, pbiron, audrasjb, SergeyBiryukov, whyisjake.

Help/About: Remove “Musician Name” placeholder.

The musician name is traditionally not included on the About page due to i18n concerns regarding last minute changes.

Props audrasjb, SergeyBiryukov.
See #50416.

Help/About: String updates and accessibility improvements to the 5.5 About page.

Props ryelle, nrqsnchz, desrosj, audrasjb, marybaum, spacedmonkey, SergeyBiryukov, estelaris, afercia, ocean90.
See #50416.

Editor: Make some hardcoded strings in block patterns translatable.

Props ocean90, youknowriad.
Fixes #50842.

Editor: update JS packages

Fixes #50844.

Comments: Restore the `::has_items()` call in `WP_Comments_List_Table::extra_tablenav()` for now, until unit tests are updated accordingly.

Follow-up to [48722].

Fixes #40188. See #50815.

Comments: Use the existing static variable instead of calling `::has_items()` again in `WP_Comments_List_Table::extra_tablenav()`.

Additionally, removed unnecessary `esc_html()` on the Filter button label. Core translations are considered safe, and this label is not escaped in any other instance.

Props whyisjake, SergeyBiryukov.
Fixes #40188.

Help/About: String update for 5.5 release.

We don't use hyphens for the [block editor](https://make.wordpress.org/core/handbook/best-practices/spelling/).

See #50416.
Props davidbaumwald, marybaum, desrosj.

Editor: update JS packages

Fixes #50841.

Accessibility: Administration: Address backward compatibility concerns for the sortable postboxes areas after [48340].

Fixes #49288.

Media: Remove extra space from the `width` attribute in `wp_playlist_shortcode()` output.

Props hvar.
Fixes #50840.

Administration: Allow `wp_credits()` to accept `$version` and `$locale` parameters.

This can be helpful for plugin developers to get credits information for older versions or different locales.

Props ramiy.
Fixes #35910.

Docs: Correct placement for `wp_editor_expand` filter DocBlock.

See #50768.

Permalinks: Don't show "You should update your `.htaccess` file now" message when saving permalink settings on Multisite.

Multisite routing is taken care of by WordPress, not by the web server.

Follow-up to [13706], [37747], [38066].

Props boonebgorges.
Fixes #39547.

Permalinks: Simplify the logic for displaying "You should update your `.htaccess` file now" message.

See #39547, #50834.

Docs: Correct formatting for a comment in `wp-admin/options-permalink.php`.

Previously committed in [48694], accidentally reverted in [48710].

See #50768.

Permalinks: Correct the check whether `.htaccess` update is required when saving permalink settings.

The check should be performed after the permalink structure update, not before.

Fixes #50834.

Upgrade/Install: Show the installed WordPress version number on WordPress Updates screen if there is a newer version available.

This makes it easier for a user to know how significant of an update the change might be, and helps them make an informed decision about how to proceed.

Props tmdesigned, dd32, circlecube, dkarfa, hakre, scribu, MadtownLems, markshep, nbachiyski, dmchale, miqrogroove, ovann86, danieltj, sterndata, seanpaulrasmussen, mrgrt, Commeuneimage, dpacks, puneetsahalot, jonoaldersonwp, SergeyBiryukov.
Fixes #15101. See #35554, #47848.

HTTP: Update the Root Certificate bundle.

Keep 1024-bit legacy root certificates re-added in [35919], except for those already expired, for compatibility with older OpenSSL versions.

Props barry, ayeshrajans, desrosj, whyisjake.
See #50828.

Build/Test Tools: Update grunt-patch-wordpress

See: #50769

Upgrade/Install: Ensure the proper count of plugins that have auto-update enabled.

As certain plugins may not support updates, this count needs to accurately reflect that in the navbar.

Fixes 50808.
Props knutsp, audrasjb, pbiron, dd32, apedog, afragen, chriscct7, garyc40, whyisjake, SergeyBiryukov.

Upgrade/Install: Allow for WordPress.org to remotely disable auto-updates for plugins/themes

As auto-updates are rolled out across WordPress.org, the API response can modulate the response, ensuring that a rolled out could be stalled or staggered if needed for security or performance reasons.

Fixes #50824.
Props dd32, whyisjake, SergeyBiryukov.

Editor: Correctly back up the global `$post` in `wp-admin/edit-form-blocks.php`.

To create a copy of the object, instead of a reference to the same object, the `clone` keyword should be used.

Props scarolan.
Fixes #50775.

Widgets: Use correct escaping function in `WP_Widget_Archives::widget()`.

Props chintan1896, afercia.
See #50826.

Upgrade/Install: Pass the plugin file path into the `plugin_auto_update_debug_string` filter.

Adds better tooling for when user specific plugins can be updated, but platform specific ones cannot.

Fixes #50821.
Props bpayton, pbiron, audrasjb, SergeyBiryukov, whyisjake.

Docs: Various fixes and improvements to inline documentation.

See #49572

Docs: Correct formatting for a comment in `wp-admin/options-permalink.php`.

See #50768.

Comments: Pass the `$which` parameter to the `manage_comments_nav` action.

This brings some consistency with the  `manage_users_extra_tablenav` and `manage_users_extra_tablenav` actions.

Props Tkama, wpgurudev.
Fixes #50736.

I18N: Use a placeholder instead of the `\` character in a translatable string in `WP_REST_Users_Controller::check_user_password()`.

Props ramiy.
Fixes #50812.

Themes: Pass correct variable to `is_php_version_compatible()` in `wp_theme_update_row()`.

This applies to the Themes screen in Multisite network admin.

Follow-up to [48660].

Props pbiron, afragen.
Fixes #48507. See #48491.

Upgrade/Install: Only show auto-update for themes that support the feature.

Similar to the changes for plugins in [48669], let's only show the UI for themes when updates are supported for that theme.

See #50280.
Props dd32.

Help/About: Adjust two strings on the About page for better i18n.

Follow-up to [48675].

Props ocean90, audrasjb, kittmedia, nao.
See #50416.

Upgrade/Install: Pass correct argument to `clear_destination` in `Theme_Upgrader::install()`.

Follow-up to [48390].

Props afragen, sabernhardt.
Fixes #9757.

Media: Pass the `$rel` parameter to `image_send_to_editor` filter.

Props mihdan, pputzer.
Fixes #50765.

Trunk is now 5.6 alpha.

Post WordPress 5.5 RC 1 version bump.

WordPress 5.5 RC 1.

WordPress 5.5 RC 1.

Upgrade/Install: Swap `auto-update-supported` to `update-supported` in update checks.

Ensures backwards compatability with external updaters.

See #50280.
Props everyone-in-the-core-updates-channel.

Upgrade/Install: Clarify the descriptions for `install_(plugin|theme)_overwrite_actions`.

See #9757.

Upgrade/Install: Correct spelling of “overwrite” in new hooks and array indexes.

See #9757.

Help/About: WordPress 5.5 About Page.

Speed. Search. Security.

This is the start of the WordPress 5.5 about page. 

Fixes #50416. 
Props ryelle, marybaum, estelaris, yvettesonneveld, michelebutcher-jones, metalandcoffee, melchoyce, marktimemedia, abhanonstopnewsuk, elmastudio, davidbaumwald, audrasjb, afercia, cbringmann, andreamiddleton, desrosj, earnjam, SergeyBiryukov, whyisjake, elrae.

Login and Registration: Correct the logic for determining the path to `wp-login.php` in `wp_lostpassword_url()`.

Follow-up to [48672], [48673].

See #39311.

Login and Registration: Only call `get_blog_details()` in `wp_lostpassword_url()` on Multisite.

The function does not exist on single site.

Follow-up to [48672].

See #39311.

Login and Registration: Link to the correct site after activating a user on a Multisite install in subdirectory mode.

Props pkarjala, Mista-Flo, tmoore41, Ipstenu, ksoares, mukesh27, whyisjake.
Fixes #39311.

Administration: Correct alignment of the "PHP Update Required" dashboard box title.

Restore one instance of `!important` CSS rule for backward compatibility.

Follow-up to [48129], [48373].

Props whyisjake, sabernhardt, TimothyBlynJacobs, SergeyBiryukov.
Fixes #50788.

Administration: Don't override the `$mode` global in `WP_Screen::render_view_mode()` if it's already set.

Follow-up to [48398], [48423], [48424], [48450].

See #49715.

Upgrade/Install: Enhance auto-updates to be disabled for plugins that don't suport updates.

This removes the toggle UI when updates aren't available. When plugins use the filter, the UI is updated to show that they are being controlled via code. And then removed entirely when not available.

See #50798.
Fixes #50280.

Props elrae, pbiron, SergeyBiryukov, audrasjb, azaozz, StephenCronin, whyisjake, dd32, TimothyBlynJacobs, desrosj.

Administration: Pull the `table_view_mode` filter for now.

The extensibility of list table view modes will be explored in a future release.

Props audrasjb.
See #49715.

Upgrade/Install: Disable the plugin/theme auto-updates UI if `AUTOMATIC_UPDATER_DISABLED` is defined and set as `true`.

Props pbiron, dd32.
Fixes #50798. See #50280.

Upgrade/Install: Check WordPress and PHP version requirements when uploading a plugin or theme from ZIP file.

Props mariovalney, desrosj.
See #50593.

Taxonomy: Rename the `default_taxonomy_$taxonomy` option key to `default_term_$taxonomy`.

This better reflects the purpose of the option.

Follow-up to [48356], [48480].

See #43517.

Coding Standards: Reformat a condifion for default taxonomy terms in `map_meta_cap()` for better readability.

Follow-up to [48356], [48480].

See #43517.

Taxonomy: Ensure the `child_of` argument of `get_terms()` works as expected with `'fields' => 'id=>name'` or `'id=>slug'`.

Props Howdy_McGee, deepaklalwani, planvova.
Fixes #46768.

Bootstrap/Load: Remove the `wp_environment_type` and `wp_get_environment_type` filters.

Since `wp_get_environment_type()` runs too early for plugins to hook these filters, and the result is then cached in a static variable and cannot be changed later, the filters are not that useful.

The `WP_ENVIRONMENT_TYPES` and `WP_ENVIRONMENT_TYPE` constants and environment variables should be enough for now.

Follow-up to [47919], [48188], [48372].

Props Clorith, SergeyBiryukov.
Fixes #33161.

Docs: Add missing documentation for various upgrade/install class properties and methods.

Props ramiy.
Fixes #42923.

Themes: Display a message on Themes list table if a theme update requires a higher version of PHP or WordPress.

This applies to the Themes screen in Multisite network admin.

Props afragen, SergeyBiryukov.
Fixes #48507. See #48491.

Themes: Include theme name in available update messages, for better accessibility and consistency with other similar messages.

Follow-up to [48652-48654].

See #48491.

Docs: Document that various metadata functions return false for an invalid ID.

Props salcode.
See #40519.

Upgrade/Install: Improve `wp_opcache_invalidate()` performance.

Changes from using `preg_match()` based `.php` extension checking to using `substr()` in `wp_opcache_invalidate()`.

Props jnylen0, aaroncampbell, SergeyBiryukov, desrosj, mikeschroder.
Fixes #50784.

REST API: Remove assets field from block directory controller.

Gutenberg no longer uses the assets field to fetch the assets for the installed block so this field can be dropped from the endpoint. This allows us to reintroduce it at a later point without needing to worry about backward compatibility.

See #50732.

Site Health: Incorrect file path in `require_once`.

Ensure that background updater can be loaded for testing to see if auto-updates can enable automatic updates.

Fixes #50793.
Props dd32.

Themes: Display a message in theme updates list if an update requires a higher version of PHP or WordPress.

This applies to the WordPress Updates screen.

Props afragen, SergeyBiryukov.
Fixes #48491.

Themes: Correct the logic for displaying a message in theme grid if a theme update requires a higher version of PHP or WordPress.

This applies to the Themes screen fallback used when JS is turned off.

Follow-up to [48652].

See #48491.

Themes: Display a message in theme grid and Theme Details modal if a theme update requires a higher version of PHP or WordPress.

This applies to the Themes screen and the Customizer theme browser.

Props afragen, SergeyBiryukov.
See #48491.

Docs: Correct alignment for some parameters in JS documentation.

Follow-up to [48650].

See #43828.

Build/Test Tools: Enable JSDocs to be linted with ESLint.

As part of the [Javascript Inline Docs Initiative](https://make.wordpress.org/core/handbook/docs/inline/js/) this add some tooling to lint Javascript docblocks. Two new commands:

* `npm run lint:jsdoc`
* `npm run lint:jsdoc:fix`

The latter will run the linter and try to fix an possible issues automatically.

Fixes #43828.
Props netweb, atimmer, kamataryo, whyisjake.

Docs: Correct description for `wp_filter_content_tags()` per the documentation standards.

DocBlocks should start with a brief, one sentence explanation of the purpose of the function spanning a maximum of two lines.

Follow-up to [48648].

See #44427.

Media: Improve inline docs for `wp_filter_content_tags()`.

Props johnstonphilip.
See #44427.

Post WordPress 5.5 Beta 4 version bump.

WordPress 5.5 Beta 4.

Mail: PHPMailer swap to use is_email for the default validator.

Prior to the PHPMailer update in 5.5, old version of the PHPMailer was setting the validator to 'auto' resulting in a sophisticated logic for determining what email address validation should be used. But the new version defaults to 'php', possibly leading to rejection of email addresses which were fine prior to the upgrade. Let's use the WordPress core function `is_email()` so that it can be fully pluggable.

Fixes #50720.
Props david.binda, ayeshrajans, Synchro, SergeyBiryukov, whyisjake.

Block Editor: Updated WordPress Packages for 5.5 beta 4

Updated packages:

 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]3
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]
 - @wordpress/[email protected]

Fixes #50791.

Administration: Fix the red links on the Media Modal.

The custom link colors for admin scheme colors were overriding the danger color.

Props kebbet, dlh.
Fixes #50547.

REST API: Fix warning when using `set_param()` on a JSON request with no body.

In [47559] the `WP_REST_Request::set_param()` method was adjusted to try and overwrite an existing parameter definition before forcing the value in the first parameter slot. If `set_param()` was called on a request with an `application/json` content type and an empty body, a PHP warning would be issued. This was due to the JSON parameter type not being set to an array when the body is empty.

This commit avoids the warning by adding an `is_array()` check before calling `array_key_exists`. Ideally, `WP_REST_Reuest::parse_json_params()` would set the JSON parameter type to an empty array in this case, but that is too large of a change at this point in the cycle.

Props manooweb.
Fixes #50786.

REST API: Install plugin translations after the plugin install. This only installs for the plugin in question, not all plugins.

Support for retrieving the langauge pack alongside the install API request was added in https://meta.trac.wordpress.org/changeset/10091 to avoid having to make a plugin update check during the REST API check.

Fixes #50732.
Props dd32, ocean90, ryelle, swissspidy, tellyworth, whyisjake, TimothyBlynJacobs.

Themes: Display a message in theme grid if a theme requires a higher version of PHP or WordPress.

This applies to the Themes screen fallback used when JS is turned off.

Props afragen, desrosj, SergeyBiryukov.
See #48491.

Block Editor: Update the Core Block Patterns.

Backport the latest block patterns from the Gutenberg plugin.
The new patterns adapt properly to Core themes.

Props nrqsnchz.
Fixes #50550, #50594.

Themes: Display a message in theme grid if a theme requires a higher version of PHP or WordPress.

This applies to the Themes screen, Add Themes screen, and the Customizer theme browser.

Props afragen, desrosj, SergeyBiryukov.
See #48491.

Themes: Display a message in Details & Preview modal on Add Themes screen if a theme requires a higher version of PHP or WordPress.

Props afragen, desrosj, SergeyBiryukov.
See #48491.

Themes: Display a message in Theme Details modal if a theme requires a higher version of PHP or WordPress.

Props afragen, desrosj, SergeyBiryukov.
See #48491.

Posts, Post Types: Pass correct variable to the `get_lastpostdate` filter.

Follow-up to [48634].

See #49572.

Docs: Synchronize documentation for `get_lastpostdate()` and `get_lastpostmodified()`.

See #49572.

Tests: Add more fixtures to `get_lastpostdate()` and `get_lastpostmodified()` tests.

Follow-up to [48631].

Props munyagu.
See #47777.

Docs: Correct `wp_opcache_invalidate_file` filter docs.

Changes incorrectly named `$filename` variable to `$filepath` and adjusts wording to align with PHP docs.

See #36455.

Posts, Post Types: Pass the post type to `get_lastpostdate()` in `get_lastpostmodified()`.

This ensures that the correct values are being compared when retrieving the result for custom post types.

Additionally, pass the `$post_type` parameter to `get_lastpostdate` and `get_lastpostmodified` filters.

Props mikaumoto, munyagu, donmhico, johnbillion, SergeyBiryukov.
Fixes #47777.

Docs: Improve documentation for `WP_Http::processHeaders()`.

Document the `@return` value using hash notation.

Props marekdedic, valchovski, davidbaumwald, deepaklalwani, thimalw, SergeyBiryukov.
Fixes #48350.

Docs: Add a note that the `$args` parameter of `register_block_type()` accepts any public property of `WP_Block_Type`.

Follow-up to [47754].

Props ediamin.
See #48640.

REST API: Use a consistent description for the `textdomain` schema property between plugins and themes controllers.

Follow-up to [48242], [48627].

Props audrasjb.
Fixes #50776. See #50321.

REST API: Use a consistent name for the `textdomain` schema property between plugins, themes, and block directory controllers.

Follow-up to [48242].

See #50321, #50776.

Docs: Correct `@since` version for `WP_REST_Plugins_Controller::get_item_schema()`.

Follow-up to [48242].

See #50321.

Revisions: Ensure the global `$post` remains the same after revision is restored.

Because `wp_insert_post()` and `wp_transition_post_status()` are called during the process, plugins can unexpectedly modify `$post`.

Props markparnell, tofandel, archon810, SergeyBiryukov.
Fixes #46671.

Docs: Synchronize some comments in `wp-admin/revision.php`.

See #49572.

Docs: Improve documentation for various category functions.

Props atachibana.
Fixes #48394.

Coding Standards: Rename the `$id` parameter in various category functions for clarity.

See #49542.

Pings/Trackbacks: Avoid a PHP notice in `do_enclose()` when encountering a URL without a path in post content.

Props jbouganim, mukesh27, Otto42, SergeyBiryukov.
Fixes #49872.

Posts, Post Types: Move `get_post_states()` back to the admin for now, require the file in `WP_Customize_Nav_Menus::customize_register()` instead.

This provides a minor performance improvement by only running the function in contexts where it's needed.

Follow-up to [47211], [47213], [47763], [48619].

See #46829, #49374.

Posts, Post Types: Make `get_post_states()` available on frontend.

This allows special pages to be denoted as such when editing a menu in the Customizer.

This applies to the Front Page, Posts Page, and Privacy Policy Page.

Follow-up to [47211], [47213], [47763].

Props dlh, whyisjake, SergeyBiryukov.
Fixes #46829. See #49374.

I18N: Merge duplicate "List view" and "Grid view" strings.

Props ramiy.
Fixes #50757.

Docs: Add a reference to `WP_Customize_Partial::__construct()` for information on accepted arguments in `WP_Customize_Selective_Refresh::add_partial()`.

Synchronize the documentation between two places, use `WP_Customize_Partial::__construct()` as the canonical source.

Props marekdedic.
See #49572.

Docs: Correct `@see` references for privacy hooks:

* `wp_privacy_personal_data_export_page`
* `wp_privacy_personal_data_erasure_page`

Hooks should be single-quoted when referenced.

Props pbiron, coffee2code.
See #49572, #meta5318.

Docs: Correct `@since` tags for some `WP_List_Table` hooks:

* `views_{$this->screen->id}`
* `bulk_actions-{$this->screen->id}`
* `manage_{$this->screen->id}_sortable_columns`

Follow-up to [15491], [15578], [26401].

See #49572.

Docs: Remove outdated statement in `bulk_actions-{$this->screen->id}` filter description.

As of WordPress 4.7, developers can register their own bulk actions on list table screens.

Follow-up to [17297], [38647].

Props joyously, pbiron.
See #49572.

I18N: Remove `<code>` tags in an error message in `WP_REST_Posts_Controller::get_item_schema()` for consistency with other strings.

Follow-up to [48610].

See #50759.

I18N: Remove `<code>` tags in `invalid_rest_prepare_callback` error message in `register_theme_feature()` for consistency with other strings.

Follow-up to [48611].

See #50758.

I18N: Move code out of a translatable string in `register_theme_feature()`.

Props ramiy.
Fixes #50758.

I18N: Move code out of a translatable string in `WP_REST_Posts_Controller::get_item_schema()`.

Props ramiy.
Fixes #50759.

I18N: Move code out of a translatable string in `WP_Customize_Manager::customize_preview_init()`.

Props ramiy.
Fixes #50760.

Site Health: Escape the displayed result of the request in REST API availability test.

Props siliconforks, gisselfeldt.
Fixes #50588.

I18N: Respect the passed `text_direction` argument in `wp_die()`.

Previously, the passed value was only used as a fallback if `get_language_attributes()` is not yet available.

Props apedog.
Fixes #49060.

Docs: Improve description for `wp_unique_filename()`.

Props stevenlinx.
Fixes #50762.

Bundled Themes: Rebuild Twenty Nineteen’s RTL stylesheet.

This adds the changes from [48073] to the `style-rtl.css` file.

Previously committed in [48514], accidentally reverted in [48602].

See #45912, #49843.

Tests: Update `wp_unique_filename()` unit tests to account for `sanitize_file_name()` removing accents.

Follow-up to [48603].

See #22363.

Media: Remove accents in `sanitize_file_name()`.

This brings some consistency with `sanitize_title()` and `sanitize_user()`.

Props tar.gz, NumidWasNotAvailable, juliobox, p_enrique, cristovaov, zodiac1978, mikeschroder, markoheijnen, chriscct7, swissspidy, DrProtocols, pento, gitlost, joemcgill, dustinbolton, programmin, Vayu, MaximeCulea, lucasbustamante, nilovelez, RavanH, audrasjb, SergeyBiryukov.
See #22363.

Bundled Theme: Ensure parity between the block editor and the front-end in twentynineteen.

Alignments and blocks were not always appearing as they should in the admin.

- Wide alignments sometimes appear only as wide as the text column.
- Full and wide appear centered on the text column
- Full-width blocks sometimes do not take up the full width of the page, and other times they cause a horizontal scroll.
- Wide and full group block children take up the full width of the block by default.

Fixes #49843.
Props kjellr, Joen, poena.

Mail: Ensure that a server hostname can be set by using `network_home_url()`.

Due to the varying server setups, `$_SERVER['SERVER_NAME'];` can't reliably ensure that there will be a relevant host that could be used as the hostname in an email. Since the `network_home_url()` is set at this point, and is filterable, this should better enable emails to be sent from the server.

Fixes #25239.
Props layotte, SergeyBiryukov, nacin, sreedoap, szepe.viktor, jesin, kitchin, mensmaximus, mt8.biz, Grzegorz.Janoszka, cbutlerjr, dd32, BjornW, neodjandre, BjornW, Ipstenu, ocean90, danielbachhuber, desmith, joemcgill, jdgrimes, riasat, derekakelly, swissspidy, lilmike, tsimmons, robert.peake, DavidAnderson, cloudstek, pigdog234, BjornW, rawrly, pessoft, RedSand, seayou, dvershinin, bastho, chesio, Starbuck, afragen, ocean90, whyisjake.

Docs: Correct documentation for `wp_insert_term()`.

The function is used for adding a new term, not updating an existing one.

Props audrasjb, bmartinent.
Fixes #50753.

Docs: Correct some documentation for `wp_update_term()`.

See #49572.

Docs: Add a mention of `core-block-patterns` as a possible value for `add_theme_support()`.

Follow-up to [48492].

See #50669.

Docs: Improve documentation for `wp_list_comments()`.

Note that passing `div` to the `style` parameter will result in no additional list markup.

Props liuhaibin, jeremyfelt, functionalrhyme.
Fixes #49181.

Media: Filter out a few more special characters in `sanitize_file_name()`.

Props audrasjb.
Fixes #50231.

Administration: Use sentence case for "Mark as spam" bulk action links for sites and users, for consistency with comments.

Follow-up to [48352].

See #40244.

Administration: Capitalize `Trash` consistently in various messages.

When used as a noun referring to the "virtual" place, `Trash` should be capitalized.

Follow-up to [47233], [48352].

See #45317, #40244.

Formatting: Filter out the bullet character in `sanitize_title_with_dashes()`.

Props roytanck, deepaklalwani, veromary.
Fixes #49791.

Build/Test Tools: Check if all the required constants are defined before running the test suite.

Follow-up to [47904].

Props azaozz, TimothyBlynJacobs, SergeyBiryukov.
Fixes #50251.

Docs: Miscellaneous DocBlock corrections.

See #49572.

Docs: Another pass at some inline docs fixes mostly made by PHPCBF.

See #49572, #50744

I18N: Further adjust some update/install strings for consistency.

Follow-up to [48568], [48569].

See #50708, #50714.

I18N: Merge two "Return to top" strings.

Props ramiy, carike, whyisjake.
Fixes #50743.

Site Health: Correct the quotes for the `tested` value of mock plugin data in auto-updates test.

Follow-up to [48584].

See #50662.

Docs: First pass at some inline docs fixes mostly made by PHPCBF.

See #49572, #50744

Docs: Use more appropriate variable names in the inline docs for action and filter parameters.

See #49572

Site Health: Pass all expected parameters to `auto_update_{$type}`.

This prevents fatal errors when other hooked functions are expecting both parameters. 

Props dd32, desrosj, audrasjb, pbiron.
Fixes #50662.

I18N: Update "Default Template" string to match the sentence case used in the block editor.

Props ramiy.
Fixes #50742.

General: Ensure the database upgrades from [48575] are run.

This corrects the database version to match the commit number the upgrade changes were made.

See #50413.

Tests: Update the `es_ES` string used in `wp_send_user_request()` tests to match the current translation.

Props a2hosting.
Fixes #50741.

Docs: Add missing description for `wp_convert_widget_settings()` parameters.

Props stevenlinx.
Fixes #50738.

Coding Standards: Use a consistent naming pattern for variables in `wp-includes/comment-template.php`.

See #49542.

I18N: Add context to privacy request status strings.

These strings already have a context in `create_initial_post_types()`, and should use the same context in `_wp_privacy_statuses()`.

Props ramiy, audrasjb.
Fixes #50740.

Docs: Improve description for `comment_id_fields()`.

Rename the `$id` parameter to `$post_id` for clarity.

Props stevenlinx.
Fixes #50737.

Docs: Further corrections and improvements to various inline docblocks.

See #49572

General: Update code for readability and inclusion

There are two pieces in here:

1) The update to change blacklist to blocklist is moved to disallowed_list. "Block" has a meaning in our code, and there could be ambiguity between this code and code related to blocks.

2) This improves backwards compatibility for code that was accessing the now deprecated code.

Previously: [48477], [48405], [48400], [48121], [48122], [48124], [48142], [48566]

Props: desrosj, SergeyBiryukov, johnjamesjacoby
Fixes: #50413

Docs: Various formatting improvements to inline docblocks.

See #49572

Docs: Various corrections to inline docblocks.

See #49572

Media: Add "loading" as an allowed kses image attribute

With loading="lazy" being added to all images in [47554], let's ensure that it passes kses attributes too.

Fixes #50731.
Props TimothyBlynJacobs, peterwilsoncc, azaozz.

REST API: Remove textdomain from doing it wrong message.

See #50075.
Props dlh.

i18n: Merge similar translation strings in wp-admin/options.php

WARNING! is now Warning:

You have been warned.

Fixes #50715.
Props: ramiy, audrasjb, ocean90.

i18n: Merge similar translation strings to "Update failed".

Fixes #50714.
Props ramiy, ocean90.

I18N: Merge similar "Installation failed" strings

Fixes #50708.

Props ramiy, ocean90, audrasjb.

I18N: Update some strings to have periods.

Fixes #50707.
Props ramiy, afercia, audrasjb.

General: Rename `remove_option_allowed_list()` to `remove_allowed_options()`.

This was missed in [48142] which renamed `add_option_allowed_list()` to `add_allowed_options()` for better readability. The two functions should have consistent names.

See #50413.

Upgrade/Install: Don't trigger database upgrade on Ajax requests via `wp-admin/async-upload.php`.

Props schlessera, jgrodel, elrae, davidbaumwald, hareesh-pillai, adamsilverstein, SergeyBiryukov.
Fixes #39459.

Accessibility: Themes: Consistently use an underline for "Enable auto-updates" link and theme author link in theme overlay.

Props chetan200891, sabernhardt, afercia.
Fixes #50697.

Docs: Correct type and improve description for the `$fields` parameter of `WP_Query::parse_query()`.

Props ocean90, palmiak, johannadevos, noisysocks.
Fixes #44305.

Docs: Improve formatting of the `$fields` parameter description in `WP_Term_Query::__construct()`.

See #44305, #49572.

Docs: Correct type for the `$theme` parameter of `theme_auto_update_debug_string` filter.

Follow-up to [48546], [48549], [48552].

See #50663.

Site Health: Fix some typos in the test for plugin and theme auto-updates.

Follow-up to [48548], [48558], [48559].

See #50662.

Site Health: Correct inverted logic for themes in the test for plugin and theme auto-updates.

Follow-up to [48548], [48558].

See #50662.

Site Health: Add the test for plugin and theme auto-updates to `WP_Site_Health::get_tests()`.

This ensures that the test actually runs.

Follow-up to [48548].

See #50662.

Widgets: Make sure image widgets with custom image size render captions.

Props kasparsd, JavierCasares, audrasjb.
Fixes #50160.

REST API: Use consistent error messages when managing network plugins.

Props ramiy.
Fixes #50729.

REST API: Optimize rest_filter_response_by_context performance.

In [47758] a new function `rest_filter_response_by_context` was introduced to expand the JSON schema features supported by the context filtering mechanism.

This commit improves the performance of that function by eliminating repetitive comparisons and loops. Additionally, it improves multi-type support for object + array types.

Fixes #50700.
Props dlh.

Site Health: Use a consistent label for theme auto-updates in debug data.

Props audrasjb.
Fixes #50728.

Sitemaps: Rename `wp_register_sitemap()` to `wp_register_sitemap_provider()`.

Follow-up to [48536], [48540], [48541].

Props pbiron.
Fixes #50724.

Site Health: Simplify the logic for displaying whether auto-updates are enabled for plugins and themes.

Remove some extra variables.

Follow-up to [48546], [48549].

See #50663.

WordPress 5.5 Beta 3 version bump.

WordPress 5.5 Beta 3.

Site Health: Rename the filters added in [48546] for clarity.

See #50663.

Site Health: Add tests to check for potential issues with plugin and theme auto-updates.

Fixes #50662.
Props desrosj, audrasjb.

Media: Pass the attachment ID to the `wp_image_file_matches_image_meta` filter.

Props spacedmonkey.
Fixes #50722.

Site Health: Add auto-update information to for plugins and themes.

New filters:

* `plugin_auto_update_debug_str`
* `theme_auto_update_debug_str`

Fixes #50663.
Props pbiron, audrasjb, davidbaumwald.

I18N: Add context to some theme strings for consistency.

Props ramiy, ocean90.
Fixes #50709.

Site Health: Rename `upload_max` array key in file upload checks to `max_effective_size` for clarity.

Follow-up to [48535].

See #50038.

Sitemaps: Replace `wp_sitemaps_register_providers` filter with more suitable `wp_sitemaps_add_provider` filter.

The previous filter failed the goal of allowing developers to filter all providers before they are registered, since it only filtered the built-in ones.

The more specific `wp_sitemaps_add_provider` filter enables exactly that, as it filters every sitemap provider right before it is added to the sitemaps registry.

Props pbiron, pfefferle, Chouby, swissspidy.
Fixes #50660.

Administration: Ensure SVG icons in admin menus are correctly colored.

Props ryelle.
Fixes #50555.

Sitemaps: Rename `wp_get_sitemaps_providers()` to `wp_get_sitemap_providers()`.

Follow-up to [48536], [48540].

Props pbiron, swissspidy, SergeyBiryukov.
See #50724.

Sitemaps: Rename `wp_get_sitemaps()` to `wp_get_sitemaps_providers()`

Following [48536], rename the function to match the rest of the sitemaps logic.

Also eliminates some dead code after [48523].

Props pbiron.
See #50724. See #50643.

Site Health: Move `post_max_size` and `upload_max_filesize` out of a translatable string in file upload checks.

Simplify some other strings, use a consistent format for translator comments.

Follow-up to [48535].

See #50038.

Site Health: Remove `parse_ini_size()`, use the existing `wp_convert_hr_to_bytes()` function instead.

Follow-up to [48535].

See #50038.

Editor: Ensure the required assets for the block directory are enqueued.

This fixes an issue where the block directory appears unstyled due to the stylesheets not being enqueued.

Props ryelle, timothyblynjacobs, earnjam.
Fixes #50661.

Sitemaps: Rename 'sitemap' to 'provider' in `WP_Sitemaps_Registry` class.

This class is for registering sitemap providers, not individual sitemaps.

Props swissspidy.
Fixes #50724.

Site Health: Include new tests to check for the ability to upload files.

Several new checks:

* `max_file_uploads`
* `file_uploads`
* `post_max_size`
* `upload_max_filesize`
* `upload_max`
* `max_file_uploads`

In addition, new function `parse_ini_size()` that converts shorthand byte strings to bytes. Useful for size comparisons.

Fixes #50038.
Props dd32, donmhico, JavierCasares, SergeyBiryukov, ayeshrajans, Clorith, ipstenu, sabernhardt, whyisjake.

Site Health: Use consistent error messages when switching plugin or theme auto-updates on or off.

Props ramiy.
Fixes #50721.

Block Editor: Move the `add_action()` call for `_register_core_block_patterns_and_categories()` above `check_theme_switched()`.

Follow-up to [48492], [48531].

See #50669.

Sitemaps: Correctly enforce maximum number of sitemaps in index.

Before this change, the limit of 50k entries was enforced for the number of providers, not the amount of sitemaps all providers add to the index in total.

Props pbiron, swissspidy.
Fixes #50666.

Block Editor: Move the `add_action()` call for `_register_core_block_patterns_and_categories()` to `wp-includes/default-filters.php`.

Follow-up to [48492].

Props desrosj.
Fixes #50669.

Mail: Make sure the `PHPMailer` class is only required once if a plugin requires `wp-includes/class-phpmailer.php` directly.

Follow-up to [48033].

Props david.binda.
Fixes #50716. See #41750.

Docs: Improve description for `edit_post()`.

Props stevenlinx.
Fixes #50713.

Site Health: Correct the message for snoozed email verifications.

Follow-up to [48522].

Fixes #48333.

Editor: update packages for Beta 3

Fixes #50712.

REST API: Issue a _doing_it_wrong when registering a route without a permission callback.

The REST API treats routes without a permission_callback as public. Because this happens without any warning to the user, if the permission callback is unintentionally omitted or misspelled, the endpoint can end up being available to the public. Such a scenario has happened multiple times in the wild, and the results can be catostrophic when it occurs.

For REST API routes that are intended to be public, it is recommended to set the permission callback to the `__return_true` built in function.

Fixes #50075.
Props rmccue, sorenbronsted, whyisjake, SergeyBiryukov, TimothyBlynJacobs.

REST API, Media: Add `X-WP-Upload-Attachment-ID` HTTP header to enable retrying of post-processing of edited images if the server runs out of resources. This is the same as after uploading a new image, will do up to five additional requests to let the server create all image sub-sizes.

Fixes #50711.

REST API: Make plugin installation tests more robust on alternate test environments.

The REST API plugin installation tests use the `upgrader_pre_download` filter to avoid downloading the test plugin from WordPress.org. Previously, this would apply to any upgrader, which caused issues if the testing environment required a language update.

Now, the filter only overwrites the file if the `Plugin_Upgrader` is being used which should hopefully prevent the issue.

Props pfefferle, TimothyBlynJacobs.
Fixes #50671.

Sitemaps: Ensure correct HTTP status when sitemaps are disabled

If sitemaps are disabled, previously there would be a rewrite rule for the sitemap endpoint. This endpoint would display the homepage since there was a rewrite rule. Now, Sitemaps are loaded, and the proper HTTP headers are returned.

Fixes #50643.
Props swissspidy, kraftbj, donmhico.

Site Health: Ensure that there is a human readable time for snoozed email verifications.

This will be the time the was proposed, added to the reminder interval.

Fixes #48333.
Props SergeyBiryukov, desrosj.

Comments: Don't show the filter/pagination actions if there are no comments to list.

It doesn't make sense to be able to filter the comments list table when there are are no (trashed/spam) comments available.

Fixes #40188.
Props swissspidy, Jim_Panse, menakas, akbarhusen429, dinhtungdu, birgire, SergeyBiryukov, davidbaumwald, rebasaurus, whyisjake.

I18N: Add context to some plugin and theme strings for consistency.

Props ramiy, audrasjb.
Fixes #50710.

I18N: Mark the strings with plugin and theme names in email notifications for translation.

Follow-up to [48517].

See #50350.

REST API, Media: Fix/improve the inline docs and name of the new `wp_edited_image_metadata` filter.

Props desrosj, azaozz.

See #44405.

Administration: Include the new plugin and theme versions in email notifications.

This helps administrators keep track of which versions of plugins and themes are running on their site when auto-updates occur.

Props audrasjb, pbiron.
Fixes #50350.

Tests: Simplify some assertions in `phpunit/tests/media.php`.

Correct comments per the documentation standards.

Follow-up to [48496].

See #22101.

Build/Test Tools: Update NPM packages in Twenty Nineteen.

This updates three packages:
- `@wordpress/browserslist-config` from `2.5.0` to `2.7.0`
- `autoprefixer` from `9.6.0` to `9.8.5`.
- `chokidar-cli` from `2.0.0` to `2.1.0`

See #49768.

Bundled Themes: Rebuild Twenty Nineteen’s RTL stylesheet.

This adds the changes from [48073] to the `style-rtl.css` file.

See #45912.

Embeds: Correct the version number when Hulu was deprecated.

Follow up of [48512]
See #50676.

Embeds: Remove Hulu from the list of supported oEmbed providers.

The oEmbed service for Hulu no longer works and appears to have been silently disabled.

Props tacitonic, talldanwp, youknowriad, bph.
Fixes #50676.

Docs: Improve description for `add_user_to_blog()`.

Props stevenlinx.
Fixes #50701.

Media: Migrate the data from the attachment post of the parent image when saving an edited image. Copy:

- `post_title`,
- `post_content` (image description),
- `post_excerpt` (image caption as saved in the DB),
- `_wp_attachment_image_alt` meta (alt text for the img tag as saved in the DB).

Props spacedmonkey, joedolson, TimothyBlynJacobs, azaozz.
Fixes #50675.

Upgrade/install: Fix/clarify the "Upload in a zip format" string.

Props greenshady, mariovalney.
See #9757.

Docs: Miscellaneous docblock corrections.

See #49572

Coding Standards: Use strict comparison in `wp-includes/wp-db.php`.

Props jenilk.
Fixes #49453.

Administration: Reverse the arrow direction for database import/export icons.

In [48456], database import and export icons were introduced. However, the arrows were pointing in the wrong directions. This reverses the arrows to be pointing correctly based on the action described in the name.

Props johnbillion, joen, desrosj, empireoflight.
Fixes #49913.

Options, Meta APIs: Reorder the parameters of `default_{$meta_type}_metadata` filter.

This brings consistency with the `get_{$meta_type}_metadata` filter and more closely matches the `get_metadata_default()` function signature.

Follow-up to [48502].

Props spacedmonkey.
See #43941.

Docs: Correct documentation for the `$meta_key` parameter of `get_metadata_default()`.

The parameter is required, not optional.

Follow-up to [48502].

See #43941.

Plugins: Update the height of the Install Now button for new plugins.

Due to Thickbox shenanigans, the buttons height needed to be shrunk a little to center properly in the iframe.

Fixes #49828.

Props ibachal, Otto42, afercia.

Meta: Reorder the get_metadata_default() signature to match get_metadata().

The order of parameters in `get_metadata_default()` did not match the signature of `get_metadata()`. This could be confusing for developers who are familiar with the existing metadata API.

Fixes #43941.
Props SergeyBiryukov, spacedmonkey, johnjamesjacoby.

Build/Test Tools: Bump lodash in twentytwenty as part of a security audit.

lodash: 4.17.15 👉 4.17.19

See #49768.
Props: dependabot.

Administration: Fix an index inconsistency in `get_admin_page_title()` function.

Ensure that `get_admin_page_title()` returns a value from pages registered using `add_menu_page()`.

Fixes #46081.

Props grapestain, valentinbora, SergeyBiryukov, audrasjb.

Code Formatting: Fix some formatting around `WP_REST_Attachments_Controller` tests.

See #50565.

REST API: Prevent attachment ID/image source mismatch when editing an image.

Fixes #50565.

Posts, Post Types: Ensure that all post stati are countable in `wp_count_posts`.

When `wp_count_posts()` is cached, it does so with all statuses defaulted to 0. The problem is however, if this is called before all plugins have registered their desired statuses, they won't have that default.

Fixes #49685.

Props obliviousharmony, SergeyBiryukov.

Feeds: Ensure that galleries can be output as a list of links in feeds.

Adjusts the gallery shortcode handler to check for the `link` attribute when outputting to a feed.

Fixes #22101.

Props ifrins, mdgl, SergeyBiryukov, chriscct7, stevenkword, iworks, DrewAPicture, birgire, whyisjake.

Coding Standards: Update the docblock to remove superflous `since`.

The `@deprecated` DocBlock tag should start with the version followed by the description of what to use instead.

Fixes #44959.

Props keesiemeijer, sabernhardt.

Block Editor: Remove the gutenberg domain name from the block-patterns.php file

Props SergeyBiryukov.
Fixes #50669.

Upgrade/Install: Check if the theme installer skin's `overwrite` property exists in `Theme_Upgrader::install_strings()`.

This ensures consistency with `Plugin_Upgrader::install_strings()` and resolves an issue caused by the property not existing in other upgrader implementations.

Props schlessera, azaozz.
See #50670.

Block Editor: Add theme support flag to opt-out of Core Block Patterns.

WordPress Core comes by default with a number of block patterns and a frequent request was to be able to opt-out of the Core block patterns. 
You can now opt-out using remove_theme_support( 'core-block-patterns' )

Props desrosj, nosolosw.
Fixes #50669.

Docs: Add return value description for `register_theme_directory()`.

Props stevenlinx.
Fixes #50665.

Docs: Link to `add_theme_support()` for the list of supported theme features in `current_theme_supports()` and related functions.

Props stevenlinx.
Fixes #50657.

Post 5.5 Beta 2 version bump.

WordPress 5.5 Beta 2.

Taxonomy: Make some adjustments to handling default terms for custom taxonomies:

* Move default term assignment from `wp_set_object_terms()` to `wp_insert_post()`.
* Make sure the passed taxonomy list overwrites the existing list if not empty.
* Remove the default term option on `unregister_taxonomy()`.
* Prevent deletion of the default term in `wp_delete_term()`.

Props enrico.sorcinelli, TimothyBlynJacobs.
See #43517.

Accessibility: Security: Improves the accessible audible messages for Plugins & Themes Auto-Updates.

- changes the politeness level of the two error messages introduced in [47835] to `assertive`
- remove unnecessary `polite` parameters as that's the default value

See #50512, #50052.

Docs: Synchronize description for the `$allowed_html` parameter of various KSES functions.

Follow-up to [43016].

Props Christian1012, jdgrimes, markparnell.
Fixes #39542. See #33801.

General: Rename the `$new_whitelist_options` global variable.

This change renames `$new_whitelist_options` to `$new_allowed_options`. This makes the variable’s purpose more clear, and promotes using more inclusive language.

For backwards compatibility, the new variable is passed by reference to the old one.

Follow up to [48121].

Props ayeshrajans, desrosj, jorbin, SergeyBiryukov.
See #50413.
Fixes #50434.

Sitemaps: Ensure entry for ‘page’ post type sitemap in index.

If there are no pages and no static homepage, there will still be one sitemap including the homepage URL.

This change ensures that this sitemap is correctly listed in the sitemap index.

Props Chouby, pacifika, elrae.
Fixes #50571.

Docs: Improve docs for arguments that accept a numerically indexed array of associative arrays.

See #49572

Sitemaps: Exclude post types and taxonomies that are not publicly queryable.

Props Cybr.
Fixes #50607.

Docs: Correct and improve inline docs for parameters that accept a callback function.

See #49572

Sitemaps: Add missing slash when calling `home_url()` for consistency.

Props Chouby.
Fixes #50570.

Sitemaps: Add wrapping `<div>` around sitemap in stylesheet.

This makes it easier to style the sitemap and for example center the entire content area.

Props ramiy.
Fixes #50622.

Sitemaps: Pass full paths to `home_url()` calls.

This makes it easier for plugins using the `home_url` filter to detect sitemap URLs.

Props Chouby.
Fixes #50592.

Editor: update packages for beta 2

Fixes #50651.

Privacy: Set the direction for the "Username or email address" field on privacy screens to LTR.

This is consistent with other email inputs across the admin.

Follow-up to [27743], [42967].

Props man4toman, sushyant.
Fixes #50625.

Docs: Improve description for `get_blog_post()`.

Props stevenlinx.
Fixes #50655.

Tests: Ignore EOL differences in some tests using multiline string assertions.

Unix vs. Windows EOL style mismatches can cause misleading failures in tests using the heredoc syntax (`<<<`) or multiline strings as the expected result.

Follow-up to [46612], [48443].

See #31432.

Administration: Attempt to even-out the new Up/Down arrows in metabox headings and make them look a bit better. Also group them a little closer together in an attempt to reduce confusion of having two down arrows next to one another. Move the focus outline to the button instead of only the icon.

Fixes #39074.

Tests: Replace hardcoded `/tmp/` references with `get_temp_dir()`.

This allows more tests to pass on Windows.

Props danielhuesken, DJPaul, christophherr, joemcgill, netweb, davidbaumwald, SergeyBiryukov.
Fixes #40856, #39975.

Tests: Copy themes from `tests/phpunit/data` to `wp-content/themes`, instead of creating a symlink.

This allows the theme file tests in `phpunit/tests/link/themeFile.php` to run on Windows without requiring administrative privileges.

Follow-up to [42812], [42819].

Props danielhuesken, christophherr, davidbaumwald, SergeyBiryukov.
See #40856, #39975.

Docs: Miscellaneous docblock corrections and improvements.

See #49572

Customize: Ensure that widgets and nav-menus can be closed after entering content.

Previously, the ⌧ button would close the search panel, or remove the results. This restores that, in addition pressing escape will do the same.

Fixes #48198.

Props garrett-eclipse, tobifjellner, afercia, JavierCasares.

Accessibility: Improve reordering of the post boxes in the block editor meta boxes area.

Follow-up to [48373].
- ignores hidden "sortables" areas 
- hides the reorder buttons when there's only one post box 
- makes the reorder buttons slightly bigger to match the side of the toggle button

Fixes #39074.

Bundled Themes: Add custom color pallettes for block editor.

Gutenberg 7.9 added support for themes to bundle their own custom styles in to the editor. These changes have been added to 2010 - 2016.

See #50120. 

Props kjellr, sabernhardt, ianbelanger.

Tests: Download Chromium for e2e and JS tests only.

This reduces the chance of random failures due to network timeouts and avoids the overhead of unnecessarily downloading ~120 MB for PHP tests.

Follow-up to [47449], [47459], [47867], [48177].

Fixes #50649.

Docs: Improve description of the `$text` parameter in `cancel_comment_reply_link()`.

Props stevenlinx.
Fixes #50642.

Administration: Update Dashicons to the latest version.

This update introduces the following new icons:

- `.dashicons-align-pull-left (f10a)`
- `.dashicons-align-pull-right (f10b)`
- `.dashicons-block-default (f12b)`
- `.dashicons-cloud-saved (f137)`
- `.dashicons-cloud-upload (f13b)`
- `.dashicons-columns (f13c)`
- `.dashicons-cover-image (f13d)`
- `.dashicons-embed-audio (f13e)`
- `.dashicons-embed-generic (f13f)`
- `.dashicons-embed-photo (f144)`
- `.dashicons-embed-post (f146)`
- `.dashicons-embed-video (f149)`
- `.dashicons-exit (f14a)`
- `.dashicons-html (f14b)`
- `.dashicons-info-outline (f14c)`
- `.dashicons-insert-after (f14d)`
- `.dashicons-insert-before (f14e)`
- `.dashicons-remove (f14f)`
- `.dashicons-shortcode (f150)`
- `.dashicons-table-col-after (f151)`
- `.dashicons-table-col-before (f152)`
- `.dashicons-table-col-delete (f15a)`
- `.dashicons-table-row-after (f15b)`
- `.dashicons-table-row-before (f15c)`
- `.dashicons-table-row-delete (f15d)`
- `.dashicons-saved (f15e)`
- `.dashicons-airplane (f15f)`
- `.dashicons-amazon (f162)`
- `.dashicons-bank (f16a)`
- `.dashicons-beer (f16c)`
- `.dashicons-bell (f16d)`
- `.dashicons-calculator (f16e)`
- `.dashicons-coffee (f16f)`
- `.dashicons-database-add (f170)`
- `.dashicons-database-export (f17a)`
- `.dashicons-database-import (f17b)`
- `.dashicons-database-remove (f17c)`
- `.dashicons-database-view (f17d)`
- `.dashicons-database (f17e)`
- `.dashicons-drumstick (f17f)`
- `.dashicons-edit-page (f186)`
- `.dashicons-food (f187)`
- `.dashicons-fullscreen-alt (f188)`
- `.dashicons-fullscreen-exit-alt (f189)`
- `.dashicons-games (f18a)`
- `.dashicons-google (f18b)`
- `.dashicons-hourglass (f18c)`
- `.dashicons-linkedin (f18d)`
- `.dashicons-money-alt (f18e)`
- `.dashicons-open-folder (f18f)`
- `.dashicons-pdf (f190)`
- `.dashicons-pets (f191)`
- `.dashicons-pinterest (f192)`
- `.dashicons-printer (f193)`
- `.dashicons-privacy (f194)`
- `.dashicons-reddit (f195)`
- `.dashicons-spotify (f196)`
- `.dashicons-superhero-alt (f197)`
- `.dashicons-superhero (f198)`
- `.dashicons-twitch (f199)`
- `.dashicons-whatsapp (f19a)`
- `.dashicons-youtube (f19b)`
- `.dashicons-car (f16b)`
- `.dashicons-podio (f19c)`
- `.dashicons-xing (f19d)`


This update is the final planned update of the Dashicons font. Moving forward, the more modern approach of using SVG icons directly (as the block editor currently does) will be explored. More information on the future of Dashicons can be found on the Make Design blog: https://make.wordpress.org/design/2020/04/20/next-steps-for-dashicons/.

Props joen, johnjamesjacoby, empireoflight, youknowriad, netweb, zodiac1978, desrosj, automaton, chrisvanpatten.
Fixes #49913.

Upgrade/Install: Simplify compatibility checks for uploaded plugins and themes for better readability.

Use `$new_plugin_data` and `$new_theme_data` as a shorthand for the corresponding `$this->upgrader` properties.

Follow-up to [48390], [48448].

Props afragen.
See #9757.

Media: Fix `wp_image_file_matches_image_meta()` to also match when the original image URL is used.

Also refreshes and fixes some of the unit tests for media, and replaces test-image-large.png with test-image-large.jpg which is larger to allow testing of `original_image` in the image meta.

Fixes #50628.

Upgrade/Install: Use `wp_strip_all_tags()` for the fields in the compare table on the "Update theme/plugin from uploaded zip" screen. Some may contain HTML.

See #9757.

REST API: Add Content-Disposition, Content-MD5 and X-WP-Nonce as allowed cors headers.

The Content-Disposition and Content-MD5 headers allow for easier file uploading across domains by using a File/Blob object directly. The X-WP-Nonce header is allowed for making cross-origin and same-origin authenticated requests consistent.

Additionally a filter is introduced, "rest_allowed_cors_headers", to simplify the process of allowing additional request headers.

Props rmccue, TimothyBlynJacobs.
Fixes #41696.

Plugins: Make delete plugin message less scary.

This adds a check if the plugin actually has an uninstall routine before saying that its data will be deleted too.

Props samful, joostdevalk, joyously, Chouby, SergeyBiryukov.
Fixes #50346.

Administration: Restore the `excerpt` key for the Extended view mode for backward compatibility for now.

Props Offereins.
See #49715.

Docs: Add a `@since` entry for the `$hook_extra` parameter added to `WP_Upgrader::download_package()`.

Follow-up to [48399].

See #49686.

Upgrade/Install: Use `is_php_version_compatible()` and `is_wp_version_compatible()` in plugin and theme requirement checks.

Follow-up to [48390].

Props afragen.
See #9757.

I18N: Move the "WordPress Backups" support URL to its own translatable string.

Follow-up to [48390].

See #9757.

Docs: Miscellaneous DocBlock corrections for plugin and theme updates.

See #49572.

Administration: Handle the result of `Plugin_Upgrader::bulk_upgrade()` for a plugin that is already at the latest version in the same way it is handled for themes.

This corrects a fragile check of the result in `wp_ajax_update_plugin()` that depended on the internal array pointer, and brings some consistency with `wp_ajax_update_theme()`.

Follow-up to [37714], [48401].
See #50448.

Docs: Improve documentation for `sanitize_user()`, `sanitize_title()`, `sanitize_title_with_dashes()`.

See #49572.

Tests: Ignore EOL differences in email tests using multiline string assertions.

Unix vs. Windows EOL style mismatches can cause misleading failures in tests using the heredoc syntax (`<<<`) or multiline strings as the expected result.

Follow-up to [46612], [48033].

Props davidbaumwald.
See #31432, #41750.