do_blocks(): Document transient-memory-leak optimization. #9052

dmsnell · 2025-06-23T17:54:42Z

Adds explanatory comment indicating why the optimization was added and guarding against accidental removal.

This is a documentation-only change and should include no functional or visual changes.

github-actions · 2025-06-23T17:54:51Z

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Core Committers: Use this line as a base for the props when committing in SVN:

Props dmsnell, westonruter, audrasjb.

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

…9052) Trac ticket: Core-63616 See WordPress#8999 Adds explanatory comment indicating why the optimization was added and guarding against accidental removal. This is a documentation-only change and should include no functional or visual changes.

…9052) Trac ticket: Core-63588 See WordPress#8999 Adds explanatory comment indicating why the optimization was added and guarding against accidental removal. This is a documentation-only change and should include no functional or visual changes.

github-actions · 2025-06-23T18:22:13Z

Test using WordPress Playground

The changes in this pull request can previewed and tested using a WordPress Playground instance.

WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

Some things to be aware of

The Plugin and Theme Directories cannot be accessed within Playground.
All changes will be lost when closing a tab with a Playground instance.
All changes will be lost when refreshing the page.
A fresh instance is created each time the link below is clicked.
Every time this pull request is updated, a new ZIP file containing all changes is created. If changes are not reflected in the Playground instance,
it's possible that the most recent build failed, or has not completed. Check the list of workflow runs to be sure.

For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation.

Test this pull request with WordPress Playground.

westonruter · 2025-06-24T05:04:42Z

src/wp-includes/blocks.php

+	 *
+	 * Ideally, therefore, the parser would only need to parse one complete
+	 * top-level block at a time, render it, and move on. Unfortunately, this
+	 * is not possible with {@see parse_blocks} because it must parse the


Typically the function parens are included in such docs:

Suggested change

* is not possible with {@see parse_blocks} because it must parse the

* is not possible with {@see parse_blocks()} because it must parse the

updated. I never know on these how to feel because it seems misleading to have empty parentheses when the function takes arguments.

westonruter · 2025-06-24T05:05:19Z

src/wp-includes/blocks.php

@@ -2398,6 +2398,7 @@ function parse_blocks( $content ) {
 * Parses dynamic blocks out of `post_content` and re-renders them.
 *
 * @since 5.0.0
+ * @since 6.9.0 Reduces peak memory use by unsetting blocks after they render.


I don't think this is needed because there is no external interface change. A @since tag is particularly useful when a new argument is added or the possible value for an argument changes.

Suggested change

* @since 6.9.0 Reduces peak memory use by unsetting blocks after they render.

okay, thanks for the note. I tend to prefer personally a note of when notable behavior changes, and this change hopefully introduces just that.

do you think there is valid reason to leave another note in the docblock indicating as much? I think it would be nice to see when looking up do_blocks() in the codex (and the @since seemed like a good way to do that).

From a developer looking to use the function, the fact that there was a performance improvement doesn't really matter so much, does it? Here's all PHP @since tags in wp-includes, and generally it is used for changes that impact the interface.

ack '@since \d+\.\d+\.\d+ [A-Z]' --php --group wp-includes

functions.php 71: * @since 5.3.0 Now returns an integer if `$type` is 'U'. Previously a string was returned. 170: * @since 5.3.0 Converted into a wrapper for wp_date(). 330: * @since 5.4.0 The `$format` parameter was added. 437: * @since 4.9.0 The `$number` and `$decimals` parameters were added. 461: * @since 6.0.0 Support for PB, EB, ZB, and YB was added. 668: * @since 6.1.0 Added Enum support. 829: * @since 6.0.0 Fixes support for HTML entities (Trac 30580). 875: * @since 5.3.0 The `$content` parameter was made optional, and the `$post` parameter was 877: * @since 5.6.0 The `$content` parameter is no longer optional, but passing `null` to skip it 1129: * @since 5.3.0 Formalized the existing and already documented parameters 1281: * @since 5.5.0 Non-string values are left untouched. 1352: * @since 3.9.0 Added status codes 418, 428, 429, 431, and 511. 1353: * @since 4.5.0 Added status codes 308, 421, and 451. 1354: * @since 5.1.0 Added status code 103. 1355: * @since 6.6.0 Added status code 425. 1448: * @since 4.4.0 Added the `$description` parameter. 1494: * @since 6.3.0 The `Cache-Control` header for logged in users now includes the 1496: * @since 6.8.0 The `Cache-Control` header now includes the `no-store` and `private` 1634: * @since 4.4.0 The `$feed` parameter was added. 1702: * @since 5.3.0 Remove the "Disallow: /" output if search engine visibility is 2177: * @since 4.4.0 Ensures upper-case drive letters on Windows systems. 2178: * @since 4.5.0 Allows for Windows network shares. 2179: * @since 4.9.7 Allows for PHP file wrappers. 2786: * @since 5.8.1 The `$alt_filenames` and `$number` parameters were added. 3297: * @since 5.1.0 The $real_mime parameter was added. 3322: * @since 5.8.0 Added support for WebP images. 3323: * @since 6.5.0 Added support for AVIF images. 3324: * @since 6.7.0 Added support for HEIC images. 3422: * @since 4.2.0 Support was added for GIMP (.xcf) files. 3423: * @since 4.9.2 Support was added for Flac (.flac) files. 3424: * @since 4.9.6 Support was added for AAC (.aac) files. 3425: * @since 6.8.0 Support was added for `audio/x-wav`. 3725: * @since 4.1.0 The `$title` and `$args` parameters were changed to optionally accept 3727: * @since 5.1.0 The `$link_url`, `$link_text`, and `$exit` arguments were added. 3728: * @since 5.3.0 The `$charset` argument was added. 3729: * @since 5.5.0 The `$text_direction` argument has a priority over get_language_attributes() 4248: * @since 5.1.0 Added the $title and $args parameters. 4366: * @since 5.3.0 No longer handles support for PHP < 5.6. 4367: * @since 6.5.0 The `$data` parameter has been renamed to `$value` and 4511: * @since 4.7.0 The `$status_code` parameter was added. 4512: * @since 5.6.0 The `$flags` parameter was added. 4559: * @since 4.7.0 The `$status_code` parameter was added. 4560: * @since 5.6.0 The `$flags` parameter was added. 4585: * @since 4.1.0 The `$value` parameter is now processed if a WP_Error object is passed in. 4586: * @since 4.7.0 The `$status_code` parameter was added. 4587: * @since 5.6.0 The `$flags` parameter was added. 4980: * @since 5.1.0 Refactored to use wp_parse_list(). 4995: * @since 5.1.0 Refactored to use wp_parse_list(). 5295: * @since 4.7.0 Uses `WP_List_Util` class. 5338: * @since 4.7.0 Uses `WP_List_Util` class. 5339: * @since 5.9.0 Converted into a wrapper for `wp_filter_object_list()`. 5362: * @since 4.7.0 Uses `WP_List_Util` class. 5439: * @since 5.9.3 Don't specify menu order when the active theme is a block theme. 5523: * @since 5.4.0 This function is no longer marked as "private". 5524: * @since 5.4.0 The error type is now classified as E_USER_DEPRECATED (used to default to E_USER_NOTICE). 5600: * @since 4.5.0 Added the `$parent_class` parameter. 5601: * @since 5.4.0 This function is no longer marked as "private". 5602: * @since 5.4.0 The error type is now classified as E_USER_DEPRECATED (used to default to E_USER_NOTICE). 5615: * @since 4.5.0 Added the `$parent_class` parameter. 5763: * @since 5.4.0 This function is no longer marked as "private". 5764: * @since 5.4.0 The error type is now classified as E_USER_DEPRECATED (used to default to E_USER_NOTICE). 5852: * @since 5.4.0 This function is no longer marked as "private". 5853: * @since 5.4.0 The error type is now classified as E_USER_DEPRECATED (used to default to E_USER_NOTICE). 5930: * @since 5.4.0 The error type is now classified as E_USER_DEPRECATED (used to default to E_USER_NOTICE). 5992: * @since 5.4.0 This function is no longer marked as "private". 6015: * @since 5.1.0 Added the $function_name, $message and $version parameters. 6391: * @since 4.9.0 The `$network_id` parameter was added. 6613: * @since 4.7.0 Added the `$locale` parameter. 7150: * @since 6.8.0 This function was moved from `wp-admin/includes/misc.php` to `wp-includes/functions.php`. 7159: * @since 4.9.5 The default value was changed to 'strict-origin-when-cross-origin'. 7174: * @since 4.3.0 Added 'webcal' to the protocols array. 7175: * @since 4.7.0 Added 'urn' to the protocols array. 7176: * @since 5.3.0 Added 'sms' to the protocols array. 7177: * @since 5.6.0 Added 'irc6' and 'ircs' to the protocols array. 7272: * @since 6.1.0 This function is no longer marked as "private". 7558: * @since 6.6.1 A wrapper for _is_utf8_charset 7697: * @since 6.7.0 A return value was added. 7853: * @since 4.6.0 The default now takes the original `memory_limit` into account. 7866: * @since 4.6.0 The default now takes the original `memory_limit` into account. 8213: * @since 4.9.6 Abstracted from `WP_Community_Events::get_unsafe_client_ip()`. 8350: * @since 5.5.0 Exports now use relative paths, so changes to the directory 8375: * @since 5.5.0 Exports now use relative paths, so changes to the directory URL 8501: * @since 5.2.0 Added the `$before` and `$after` parameters. 8502: * @since 6.4.0 Added the `$display` parameter. 8726: * @since 4.3.0 The `$exclude` parameter was added. 8727: * @since 5.2.0 The `$max_execution_time` parameter was added. 8728: * @since 5.6.0 The `$directory_cache` parameter was added. 8849: * @since 5.9.0 Added input validation with a notice for invalid input. blocks/comment-template.php 11: * @since 6.3.0 Changed render_block_context priority to `1`. blocks/post-title.php 11: * @since 6.3.0 Omitting the $post argument from the `get_the_title`. blocks/post-template.php 39: * @since 6.3.0 Changed render_block_context priority to `1`. blocks/pattern.php 25: * @since 6.3.0 Backwards compatibility: blocks with no `syncStatus` attribute do not receive block wrapper. blocks/search.php 11: * @since 6.3.0 Using block.json `viewScript` to register script, and update `view_script_handles()` only when needed. blocks/categories.php 12: * @since 6.7.0 Enable client-side rendering if enhancedPagination context is true. shortcodes.php 317: * @since 4.4.0 Added the `$tagnames` parameter. 420: * @since 6.5.0 The `$attr` parameter is always an array. 440: * @since 6.5.0 The `$attr` parameter is always an array. 605: * @since 6.5.0 The function now always returns an array, 683: * @since 4.4.0 Added the `$shortcode` parameter. class-wp-customize-setting.php 320: * @since 4.4.0 Added boolean return value. 768: * @since 4.6.0 Added the `$this` setting instance as the second parameter. blocks.php 38: * @since 6.1.0 Added `$index` parameter. 39: * @since 6.5.0 Added support for `viewScriptModule` field. 205: * @since 6.1.0 Added `$index` parameter. 206: * @since 6.5.0 The asset file is optional. Added script handle support in the asset file. 283: * @since 6.1.0 Added `$index` parameter. 435: * @since 5.7.0 Added support for `textdomain` field and i18n handling for all translatable fields. 436: * @since 5.9.0 Added support for `variations` and `viewScript` fields. 437: * @since 6.1.0 Added support for `render` field. 438: * @since 6.3.0 Added `selectors` field. 439: * @since 6.4.0 Added support for `blockHooks` field. 440: * @since 6.5.0 Added support for `allowedBlocks`, `viewScriptModule`, and `viewStyle` fields. 441: * @since 6.7.0 Allow PHP filename as `variations` argument. 760: * @since 5.8.0 First parameter now accepts a path to the `block.json` file. 1080: * @since 6.7.0 Injects the `theme` attribute into Template Part blocks, even if no hooked blocks are registered. 1081: * @since 6.8.0 Have the `$context` parameter default to `null`, in which case `get_post()` will be called to use the current post as context. 1336: * @since 6.8.0 Support non-`wp_navigation` post types. 1445: * @since 6.8.0 Support non-`wp_navigation` post types. 1497: * @since 6.5.0 Added $callback argument. 1554: * @since 6.5.0 Added $callback argument. 2052: * @since 6.5.5 Added the `$block_context` parameter. 2275: * @since 5.9.0 The `$parent_block` parameter was added. 2302: * @since 5.9.0 The `$parent_block` parameter was added. 2349: * @since 5.9.0 The `$parent_block` parameter was added. 2473: * @since 6.6.0 Added support for registering styles for multiple block types. 2506: * @since 6.4.0 The `$feature` parameter now supports a string. 2589: * @since 6.1.0 Added `query_loop_block_query_vars` filter and `parents` support in query. 2590: * @since 6.7.0 Added support for the `format` property in query. class-wpdb.php 206: * @since 2.5.0 The third element in each query log was added to record the calling functions. 207: * @since 5.1.0 The fourth element in each query log was added to record the start time. 208: * @since 5.3.0 The fifth element in each query log was added to record custom data. 700: * @since 6.4.0 This property was removed. 701: * @since 6.4.1 This property was reinstated and its default value was changed to true. 1439: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 1442: * @since 6.2.0 Added `%i` for identifiers, e.g. table or field names. 4057: * @since 4.1.0 Added support for the 'utf8mb4' feature. 4058: * @since 4.6.0 Added support for the 'utf8mb4_520' feature. 4059: * @since 6.2.0 Added support for the 'identifier_placeholders' feature. 4060: * @since 6.6.0 The `utf8mb4` feature now always returns true. global-styles-and-settings.php 141: * @since 6.1.0 Added 'base-layout-styles' support. 142: * @since 6.6.0 Resolves relative paths in theme.json styles to theme absolute paths. 250: * @since 6.7.0 Resolve relative paths in block styles. widgets.php 111: * @since 4.6.0 Updated the `$widget` parameter to also accept a WP_Widget instance object 133: * @since 4.6.0 Updated the `$widget` parameter to also accept a WP_Widget instance object 232: * @since 5.6.0 Added the `before_sidebar` and `after_sidebar` arguments. 233: * @since 5.9.0 Added the `show_in_rest` argument. 372: * @since 5.3.0 Formalized the existing and already documented `...$params` parameter 374: * @since 5.8.0 Added show_instance_in_rest option. 514: * @since 5.3.0 Formalized the existing and already documented `...$params` parameter 591: * @since 5.3.0 Formalized the existing and already documented `...$params` parameter 625: * @since 5.3.0 Formalized the existing and already documented `...$params` parameter 1379: * @since 4.9.2 Always tries to restore widget assignments from previous data, not just if sidebars needed mapping. comment-template.php 18: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 50: * @since 4.1.0 The `$comment_id` and `$comment` parameters were added. 63: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 77: * @since 4.1.0 The `$comment_id` parameter was added. 89: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 102: * @since 4.1.0 The `$comment_id` and `$comment` parameters were added. 121: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 135: * @since 4.1.0 The `$comment_id` parameter was added. 153: * @since 4.6.0 Added the `$comment` parameter. 178: * @since 4.6.0 Added the `$comment` parameter. 198: * @since 4.1.0 The `$comment` parameter was added. 227: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 286: * @since 4.1.0 The `$comment_author` and `$comment_id` parameters were added. 300: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 313: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 326: * @since 4.1.0 The `$comment_id` and `$comment` parameters were added. 339: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 352: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 375: * @since 4.1.0 The `$comment_id` and `$comment` parameters were added. 388: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 402: * @since 4.1.0 The `$comment_id` parameter was added. 421: * @since 4.6.0 Added the `$comment` parameter. 464: * @since 4.6.0 Added the `$comment` parameter. 483: * @since 4.4.0 Added the ability for `$comment` to also accept a WP_Comment object. 508: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 606: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 636: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 652: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 685: * @since 4.1.0 The `$comment_id` and `$comment` parameters were added. 698: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 712: * @since 4.1.0 The `$comment_id` parameter was added. 736: * @since 4.1.0 The `$comment` parameter was added. 757: * @since 4.4.0 Added the ability for `$comment` to also accept a WP_Comment object. Added `$cpage` argument. 857: * @since 4.4.0 Added the `$cpage` parameter. 940: * @since 5.4.0 The `$deprecated` parameter was changed to `$post`. 955: * @since 5.4.0 Added the `$post` parameter to allow using the function outside of the loop. 1023: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 1024: * @since 5.4.0 Added 'In reply to %s.' prefix to child comments in comments feed. 1070: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 1101: * @since 6.2.0 Added the `$comment_id` parameter. 1142: * @since 6.2.0 Added the `$comment_id` parameter. 1156: * @since 4.4.0 Added the ability for `$comment_id` to also accept a WP_Comment object. 1173: * @since 4.1.0 The `$comment_id` and `$comment` parameters were added. 1731: * @since 4.4.0 Added the ability for `$comment` to also accept a WP_Comment object. 1990: * @since 6.2.0 Added the `$post` parameter. 2043: * @since 6.2.0 Renamed `$post_id` to `$post` and added WP_Post support. 2082: * @since 6.2.0 Renamed `$post_id` to `$post` and added WP_Post support. 2102: * @since 6.2.0 Added the `$post` parameter. 2440: * @since 4.1.0 Introduced the 'class_submit' argument. 2441: * @since 4.2.0 Introduced the 'submit_button' and 'submit_fields' arguments. 2442: * @since 4.4.0 Introduced the 'class_form', 'title_reply_before', 'title_reply_after', 2444: * @since 4.5.0 The 'author', 'email', and 'url' form fields are limited to 245, 100, 2446: * @since 4.6.0 Introduced the 'action' argument. 2447: * @since 4.9.6 Introduced the 'cookies' default comment field. 2448: * @since 5.5.0 Introduced the 'class_container' argument. 2449: * @since 6.8.2 Introduced the 'novalidate' argument. style-engine.php 116: * @since 6.6.0 Added support for `$rules_group` in the `$css_rules` array. revision.php 13: * @since 4.5.0 A `WP_Post` object can now be passed to the `$post` parameter. 14: * @since 4.5.0 The optional `$autosave` parameter was deprecated and renamed to `$deprecated`. 48: * @since 4.5.0 The `$post` parameter was added. 382: * @since 6.4.0 The post_id parameter was added. taxonomy.php 21: * @since 5.9.0 Added `'wp_template_part_area'` taxonomy. 419: * @since 4.2.0 Introduced `show_in_quick_edit` argument. 420: * @since 4.4.0 The `show_ui` argument is now enforced on the term editing screen. 421: * @since 4.4.0 The `public` argument now controls whether the taxonomy can be queried on the front end. 422: * @since 4.5.0 Introduced `publicly_queryable` argument. 423: * @since 4.7.0 Introduced `show_in_rest`, 'rest_base' and 'rest_controller_class' 425: * @since 5.1.0 Introduced `meta_box_sanitize_cb` argument. 426: * @since 5.4.0 Added the registered taxonomy object as a return value. 427: * @since 5.5.0 Introduced `default_term` argument. 428: * @since 5.9.0 Introduced `rest_namespace` argument. 641: * @since 4.3.0 Added the `no_terms` label. 642: * @since 4.4.0 Added the `items_list_navigation` and `items_list` labels. 643: * @since 4.9.0 Added the `most_used` and `back_to_items` labels. 644: * @since 5.7.0 Added the `filter_by_item` label. 645: * @since 5.8.0 Added the `item_link` and `item_link_description` labels. 646: * @since 5.9.0 Added the `name_field_description`, `slug_field_description`, 648: * @since 6.6.0 Added the `template_name` label. 959: * @since 4.4.0 Converted to return a WP_Term object if `$output` is `OBJECT`. 1085: * @since 5.5.0 Added 'ID' as an alias of 'id' for the `$field` parameter. 1210: * @since 4.4.0 The `$taxonomy` parameter was made optional. `$term` can also now accept a WP_Term object. 1298: * @since 4.2.0 Introduced 'name' and 'childless' parameters. 1299: * @since 4.4.0 Introduced the ability to pass 'term_id' as an alias of 'id' for the `orderby` parameter. 1302: * @since 4.5.0 Changed the function signature so that the `$args` array can be provided as the first parameter. 1304: * @since 4.8.0 Introduced 'suppress_filter' parameter. 1372: * @since 4.6.0 Added the `$term_query` parameter. 1580: * @since 6.0.0 Converted to use `get_terms()`. 1939: * @since 5.6.0 Changed the function signature so that the `$args` array can be provided as the first parameter. 2204: * @since 4.5.0 Introduced the `$object_ids` argument. 2226: * @since 4.5.0 Introduced the `$object_ids` argument. 2256: * @since 4.2.0 Added support for 'taxonomy', 'parent', and 'term_taxonomy_id' values of `$orderby`. 2258: * @since 4.4.0 Introduced `$meta_query` and `$update_term_meta_cache` arguments. When `$fields` is 'all' or 2260: * @since 4.7.0 Refactored to use WP_Term_Query, and to support any WP_Term_Query arguments. 2261: * @since 6.3.0 Passing `update_term_meta_cache` argument value false by default resulting in get_terms() to not 2435: * @since 6.1.0 The `$args` parameter was added. 2670: * @since 6.1.0 The `$args` parameter was added. 2691: * @since 6.1.0 The `$args` parameter was added. 2703: * @since 6.1.0 The `$args` parameter was added. 2720: * @since 6.1.0 The `$args` parameter was added. 2741: * @since 6.1.0 The `$args` parameter was added. 2756: * @since 6.1.0 The `$args` parameter was added. 2778: * @since 6.1.0 The `$args` parameter was added. 2879: * @since 4.7.0 Added the `$taxonomy` parameter. 2899: * @since 4.7.0 Added the `$taxonomy` parameter. 3045: * @since 4.7.0 Added the `$taxonomy` parameter. 3062: * @since 4.7.0 Added the `$taxonomy` parameter. 3346: * @since 6.1.0 The `$args` parameter was added. 3380: * @since 6.1.0 The `$args` parameter was added. 3392: * @since 6.1.0 The `$args` parameter was added. 3406: * @since 6.1.0 The `$args` parameter was added. 3421: * @since 6.1.0 The `$args` parameter was added. 3442: * @since 6.1.0 The `$args` parameter was added. 3462: * @since 6.1.0 The `$args` parameter was added. 3483: * @since 6.1.0 The `$args` parameter was added. 3710: * @since 4.5.0 Added the `$clean_taxonomy` parameter. 3756: * @since 4.7.0 Returns a `WP_Error` object if there's an error with 4104: * @since 6.1.0 This function is no longer marked as "private". 4105: * @since 6.3.0 Use wp_lazyload_term_meta() for lazy-loading of term meta. 4234: * @since 4.3.0 Introduced `$record` parameter. Also, `$term_id` and 4719: * @since 2.5.0 Deprecated in favor of {@see 'term_link'} filter. 4720: * @since 5.4.1 Restored (un-deprecated). 4732: * @since 2.5.0 Deprecated in favor of {@see 'term_link'} filter. 4733: * @since 5.4.1 Restored (un-deprecated). 4965: * @since 4.1.0 Introduced the `$resource_type` argument. 5007: * @since 4.1.1 Introduced the `$resource_type` parameter. category.php 373: * @since 4.4.0 The `$category` parameter now also accepts a WP_Term object. class-wp-comment-query.php 140: * @since 4.4.0 Order by `comment__in` was added. `$update_comment_meta_cache`, `$no_found_rows`, 142: * @since 4.5.0 Introduced the `$author_url` argument. 143: * @since 4.6.0 Introduced the `$cache_domain` argument. 144: * @since 4.9.0 Introduced the `$paged` argument. 145: * @since 5.1.0 Introduced the `$meta_compare_key` argument. 146: * @since 5.3.0 Introduced the `$meta_type_key` argument. 330: * @since 4.2.0 Extracted from WP_Comment_Query::query(). 355: * @since 4.1.0 Introduced 'comment__in', 'comment__not_in', 'post_author__in', 359: * @since 4.2.0 Moved parsing to WP_Comment_Query::parse_query(). 426: * @since 5.6.0 The returned array of comment data is assigned to the `comments` property feed.php 98: * @since 4.4.0 The optional `$sep` parameter was deprecated and renamed to `$deprecated`. 113: * @since 4.4.0 The `$sep` parameter was deprecated and renamed to `$deprecated`. 125: * @since 4.4.0 The optional `$sep` parameter was deprecated and renamed to `$deprecated`. 139: * @since 4.4.0 The `$sep` parameter was deprecated and renamed to `$deprecated`. 153: * @since 6.6.0 Added the `$post` parameter. 305: * @since 4.4.0 Introduced the `$comment` argument. class-walker-category.php 89: * @since 5.9.0 Renamed `$category` to `$data_object` and `$id` to `$current_object_id` 261: * @since 5.9.0 Renamed `$page` to `$data_object` to match parent class for PHP 8 named parameter support. class-wp-date-query.php 70: * @since 4.0.0 The $inclusive logic was updated to include all times within the date range. 71: * @since 4.1.0 Introduced 'dayofweek_iso' time type parameter. 502: * @since 4.1.0 Added 'user_registered' to the default recognized columns. 503: * @since 4.6.0 Added 'registered' and 'last_updated' to the default recognized columns. update.php 157: * @since 6.1.0 Added `$extensions`, `$platform_flags`, and `$image_support` to the `$query` parameter. 404: * @since 4.5.0 The default value of the `$locales` parameter changed to include all locales. 693: * @since 4.5.0 The default value of the `$locales` parameter changed to include all locales. load.php 242: * @since 5.5.1 Added the 'local' type. 243: * @since 5.5.1 Removed the ability to alter the list of types. 1651: * @since 4.6.0 Moved from functions.php to load.php. 1675: * @since 4.6.0 Moved from media.php to load.php. class-wp-styles.php 142: * @since 5.5.0 Added the `$group` parameter. 243: * @since 4.3.0 Introduced the `$href` parameter. 244: * @since 4.5.0 Introduced the `$media` parameter. class-wp-editor.php 381: * @since 3.3.0 The `$editor_id` parameter was added. 415: * @since 5.3.0 The `$editor_id` parameter was added. 455: * @since 5.3.0 The `$editor_id` parameter was added. 484: * @since 5.3.0 The `$editor_id` parameter was added. 633: * @since 3.3.0 The `$editor_id` parameter was added. 674: * @since 3.3.0 The `$editor_id` parameter was added. 703: * @since 3.3.0 The `$editor_id` parameter was added. 715: * @since 3.3.0 The `$editor_id` parameter was added. 727: * @since 3.3.0 The `$editor_id` parameter was added. 799: * @since 3.3.0 The `$editor_id` parameter was added. 811: * @since 3.3.0 The `$editor_id` parameter was added. class-wp-theme-json-schema.php 38: * @since 6.6.0 Migrate up to v3 and add $origin parameter. formatting.php 1139: * @since 5.8.3 Added the `encode_ascii_characters` parameter. 1582: * @since 4.6.0 Added locale support for `de_CH`, `de_CH_informal`, and `ca`. 1583: * @since 4.7.0 Added locale support for `sr_RS`. 1584: * @since 4.8.0 Added locale support for `bs_BA`. 1585: * @since 5.7.0 Added locale support for `de_AT`. 1586: * @since 6.0.0 Added the `$locale` parameter. 1587: * @since 6.1.0 Added Unicode NFC encoding normalization support. 2560: * @since 5.3.0 Improve accuracy and add support for custom element tags. 2731: * @since 4.4.0 The `$richedit` parameter was renamed to `$rich_text` for clarity. 3302: * @since 5.6.0 Removed 'noreferrer' relationship. 3343: * @since 5.6.0 Removed 'noreferrer' relationship. 3857: * @since 5.3.0 Added support for showing a difference in seconds. 3943: * @since 5.2.0 Added the `$post` parameter. 3944: * @since 6.3.0 Removes footnotes markup from the excerpt content. 4575: * @since 6.1.0 Turned into an alias for sanitize_url(). 4592: * @since 2.8.0 Deprecated in favor of esc_url_raw(). 4593: * @since 5.9.0 Restored (un-deprecated). 4788: * @since 6.5.5 Allow hyphens in tag names (i.e. custom elements). 4813: * @since 4.1.0 Support was added for relative URLs. 5104: * @since 4.3.0 Added the `$original_value` parameter. 5220: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 5760: * @since 5.5.0 Non-string values are left untouched. 6177: * @since 4.4.0 Moved to wp-includes/formatting.php from wp-admin/includes/misc.php and added $length param. class-wp-roles.php 80: * @since 4.9.0 The `$site_id` argument was added. class-wp-scripts.php 175: * @since 2.8.0 Added the `$group` parameter. 192: * @since 2.8.0 Added the `$display` parameter. 257: * @since 2.8.0 Added the `$group` parameter. 648: * @since 5.1.0 The `$domain` parameter was made optional. ms-functions.php 118: * @since 3.7.0 The `$network_id` parameter has been deprecated. 119: * @since 4.8.0 The `$network_id` parameter is now being used. 251: * @since 5.4.0 Added the `$reassign` parameter. 1505: * @since 5.4.0 The `$blog_id` parameter was added. 2083: * @since 5.1.0 Parameters now support input from the {@see 'wp_initialize_site'} action. 2479: * @since 4.8.0 The `$network_id` parameter has been added. 2495: * @since 4.8.0 The `$network_id` parameter has been added. 2526: * @since 4.8.0 The `$network_id` parameter has been added. 2545: * @since 4.8.0 The `$network_id` parameter has been added. 2573: * @since 4.8.0 The `$network_id` parameter has been added. 2574: * @since 6.0.0 This function is now a wrapper for wp_update_user_counts(). 2701: * @since 4.8.0 The `$network_id` parameter has been added. 2722: * @since 4.8.0 The `$network_id` parameter has been added. class-wp-walker.php 87: * @since 5.9.0 Renamed `$object` (a PHP reserved keyword) to `$data_object` for PHP 8 named parameter support. 104: * @since 5.9.0 Renamed `$object` (a PHP reserved keyword) to `$data_object` for PHP 8 named parameter support. 186: * @since 5.3.0 Formalized the existing `...$args` parameter by adding it 282: * @since 5.3.0 Formalized the existing `...$args` parameter by adding it class-wp.php 129: * @since 6.0.0 A return value was added. 431: * @since 6.1.0 Runs after posts have been queried. class-walker-category-dropdown.php 47: * @since 5.9.0 Renamed `$category` to `$data_object` and `$id` to `$current_object_id` class-wp-site-query.php 111: * @since 4.8.0 Introduced the 'lang_id', 'lang__in', and 'lang__not_in' parameters. 112: * @since 5.1.0 Introduced the 'update_site_meta_cache', 'meta_query', 'meta_key', 114: * @since 5.3.0 Introduced the 'meta_type_key' parameter. 333: * @since 5.6.0 The returned array of site data is assigned to the `sites` property class-wp-customize-panel.php 241: * @since 5.9.0 Method was marked non-final. class-wp-duotone.php 812: * @since 6.6.0 Replaced body selector with `WP_Theme_JSON::ROOT_CSS_PROPERTIES_SELECTOR`. class-wp-textdomain-registry.php 54: * @since 6.5.0 This property is no longer used. kses.php 968: * @since 6.6.0 Recognize additional forms of invalid HTML which convert into comments. 1089: * @since 6.6.0 Recognize additional forms of invalid HTML which convert into comments. 1215: * @since 5.9.0 Added support for an array of allowed values for attributes. 1298: * @since 5.0.0 Added support for `data-*` wildcard attributes. 1950: * @since 5.5.0 Added `$context` parameter. 2349: * @since 4.4.0 Added support for `min-height`, `max-height`, `min-width`, and `max-width`. 2350: * @since 4.6.0 Added support for `list-style-type`. 2351: * @since 5.0.0 Added support for `background-image`. 2352: * @since 5.1.0 Added support for `text-transform`. 2353: * @since 5.2.0 Added support for `background-position` and `grid-template-columns`. 2354: * @since 5.3.0 Added support for `grid`, `flex` and `column` layout properties. 2356: * @since 5.3.1 Added support for gradient backgrounds. 2357: * @since 5.7.1 Added support for `object-position`. 2358: * @since 5.8.0 Added support for `calc()` and `var()` values. 2359: * @since 6.1.0 Added support for `min()`, `max()`, `minmax()`, `clamp()`, 2363: * @since 6.2.0 Added support for `aspect-ratio`, `position`, `top`, `right`, `bottom`, `left`, 2365: * @since 6.3.0 Extended support for `filter` to accept a URL and added support for repeat(). 2367: * @since 6.4.0 Added support for `writing-mode`. 2368: * @since 6.5.0 Added support for `background-repeat`. 2369: * @since 6.6.0 Added support for `grid-column`, `grid-row`, and `container-type`. 2703: * @since 5.0.0 Added support for `data-*` wildcard attributes. 2704: * @since 6.0.0 Added `dir`, `lang`, and `xml:lang` to global attributes. 2705: * @since 6.3.0 Added `aria-controls`, `aria-current`, and `aria-expanded` attributes. 2706: * @since 6.4.0 Added `aria-live` and `hidden` attributes. post.php 1175: * @since 4.5.0 The `$post` parameter was made optional. 1283: * @since 5.7.0 The attachment post type is now passed through this filter. 1588: * @since 4.6.0 Object returned is now an instance of `WP_Post_Type`. 1648: * @since 3.0.0 The `show_ui` argument is now enforced on the new post screen. 1649: * @since 4.4.0 The `show_ui` argument is now enforced on the post type listing 1651: * @since 4.6.0 Post type object returned is now an instance of `WP_Post_Type`. 1652: * @since 4.7.0 Introduced `show_in_rest`, `rest_base` and `rest_controller_class` 1654: * @since 5.0.0 The `template` and `template_lock` arguments were added. 1655: * @since 5.3.0 The `supports` argument will now accept an array of arguments for a feature. 1656: * @since 5.9.0 The `rest_namespace` argument was added. 1824: * @since 4.6.0 Converted the `$post_type` parameter to accept a `WP_Post_Type` object. 2097: * @since 4.3.0 Added the `featured_image`, `set_featured_image`, `remove_featured_image`, 2099: * @since 4.4.0 Added the `archives`, `insert_into_item`, `uploaded_to_this_item`, `filter_items_list`, 2101: * @since 4.6.0 Converted the `$post_type` parameter to accept a `WP_Post_Type` object. 2102: * @since 4.7.0 Added the `view_items` and `attributes` labels. 2103: * @since 5.0.0 Added the `item_published`, `item_published_privately`, `item_reverted_to_draft`, 2105: * @since 5.7.0 Added the `filter_by_date` label. 2106: * @since 5.8.0 Added the `item_link` and `item_link_description` labels. 2107: * @since 6.3.0 Added the `item_trashed` label. 2108: * @since 6.4.0 Changed default values for the `add_new` label to include the type of content. 2110: * @since 6.6.0 Added the `template_name` label. 2111: * @since 6.7.0 Restored pre-6.4.0 defaults for the `add_new` label and updated documentation. 2257: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 2387: * @since 4.5.0 Added the ability to pass a post type name in addition to object. 2388: * @since 4.6.0 Converted the `$post_type` parameter to accept a `WP_Post_Type` object. 2389: * @since 5.9.0 Added `is_post_type_viewable` hook to filter the result. 2433: * @since 5.9.0 Added `is_post_status_viewable` hook to filter the result. 2935: * @since 4.4.0 Like `sanitize_post()`, `$context` defaults to 'display'. 3496: * @since 5.3.0 Added the 'Documents', 'Spreadsheets', and 'Archives' mime type groups. 3772: * @since 5.5.0 Added the `$post` parameter. 3854: * @since 5.5.0 Added the `$post` parameter. 3883: * @since 5.5.0 Added the `$post` parameter. 3904: * @since 5.5.0 Added the `$post` parameter. 3981: * @since 6.3.0 Added the `$previous_status` parameter. 3997: * @since 6.3.0 Added the `$previous_status` parameter. 4024: * @since 6.3.0 Added the `$previous_status` parameter. 4038: * @since 5.6.0 An untrashed post is now returned to 'draft' status by default, except for 4063: * @since 5.6.0 Added the `$previous_status` parameter. 4078: * @since 5.6.0 Added the `$previous_status` parameter. 4124: * @since 5.6.0 Added the `$previous_status` parameter. 4399: * @since 2.6.0 Added the `$wp_error` parameter to allow a WP_Error to be returned on failure. 4400: * @since 4.2.0 Support was added for encoding emoji in the post title, content, and excerpt. 4401: * @since 4.4.0 A 'meta_input' array can now be passed to `$postarr` to add post meta data. 4402: * @since 5.6.0 Added the `$fire_after_hooks` parameter. 4813: * @since 5.4.1 The `$unsanitized_postarr` parameter was added. 4814: * @since 6.0.0 The `$update` parameter was added. 4828: * @since 5.4.1 The `$unsanitized_postarr` parameter was added. 4829: * @since 6.0.0 The `$update` parameter was added. 5172: * @since 3.5.0 Added the `$wp_error` parameter to allow a WP_Error to be returned on failure. 5173: * @since 5.6.0 Added the `$fire_after_hooks` parameter. 5827: * @since 5.9.0 Added `$old_status` parameter. 6285: * @since 4.6.0 The `$page` parameter was made optional. 6323: * @since 6.3.0 Use WP_Query internally. 6589: * @since 4.7.0 Added the `$wp_error` parameter to allow a WP_Error to be returned on failure. 6590: * @since 5.6.0 Added the `$fire_after_hooks` parameter. 6685: * @since 5.5.0 Added the `$post` parameter. 6823: * @since 6.0.0 The `$filesize` value was added to the returned array. 7022: * @since 6.1.0 Changed to use wp_get_attachment_image_url(). 7113: * @since 4.2.0 Modified into wrapper for wp_attachment_is() and 7127: * @since 6.5.0 Added the `$preferred_ext` parameter. 7378: * @since 4.3.0 Added the ability to pass an array to `$post_type`. 7391: * @since 4.3.0 Introduced the ability to pass an array of post types to `$post_type`. 7482: * @since 4.4.0 The `$post_type` argument was added. 7499: * @since 5.5.0 Added the `$post_type` parameter. 7518: * @since 4.4.0 The `$post_type` argument was added. 7556: * @since 5.5.0 Added the `$post_type` parameter. 7571: * @since 4.4.0 The `$post_type` argument was added. 7982: * @since 5.9.0 The `$post` parameter was made optional. 8184: * @since 6.1.0 This function is no longer marked as "private". 8379: * @since 5.4.0 Added the `$unfiltered` parameter. 8472: * @since 6.1.0 Moved to wp-includes from wp-admin. 8510: * @since 6.1.0 Moved to wp-includes from wp-admin. 8543: * @since 6.3.0 Adds `wp_pattern_sync_status` meta field to the wp_block post type so an unsynced option can be added. class-wp-term-query.php 89: * @since 4.6.0 Introduced 'term_taxonomy_id' parameter. 90: * @since 4.7.0 Introduced 'object_ids' parameter. 91: * @since 4.9.0 Added 'slug__in' support for 'orderby'. 92: * @since 5.1.0 Introduced the 'meta_compare_key' parameter. 93: * @since 5.3.0 Introduced the 'meta_type_key' parameter. 94: * @since 6.4.0 Introduced the 'cache_results' parameter. class-wp-locale-switcher.php 93: * @since 6.2.0 The `$user_id` parameter was added. class-walker-comment.php 159: * @since 5.9.0 Renamed `$comment` to `$data_object` and `$id` to `$current_object_id` 215: * @since 5.9.0 Renamed `$comment` to `$data_object` to match parent class for PHP 8 named parameter support. rest-api.php 23: * @since 5.1.0 Added a `_doing_it_wrong()` notice when not called on or after the `rest_api_init` hook. 24: * @since 5.5.0 Added a `_doing_it_wrong()` notice when the required `permission_callback` argument is not set. 638: * @since 5.3.0 Accept string argument for the request path. 1173: * @since 5.7.0 Added the `$app_password` parameter. 2147: * @since 4.9.0 Support the "object" type. 2148: * @since 5.2.0 Support validating "additionalProperties" against a schema. 2149: * @since 5.3.0 Support multiple types. 2150: * @since 5.4.0 Convert an empty string to an empty object. 2151: * @since 5.5.0 Add the "uuid" and "hex-color" formats. 2155: * @since 5.6.0 Support the "minProperties" and "maxProperties" keywords for objects. 2754: * @since 5.5.0 Added the `$param` parameter. 2755: * @since 5.6.0 Support the "anyOf" and "oneOf" keywords. 2756: * @since 5.9.0 Added `text-field` and `textarea-field` formats. 3023: * @since 5.6.0 Support the "patternProperties" keyword for objects. 3131: * @since 5.6.0 Support the "patternProperties" keyword. class-wp-http-cookie.php 94: * @since 5.2.0 Added `host_only` to the `$data` parameter. class-wp-rewrite.php 1677: * @since 4.4.0 Array support was added to the `$query` parameter. 1724: * @since 4.3.0 Added support for skipping query var registration by passing `false` to `$query_var`. class-wp-simplepie-file.php 32: * @since 3.2.0 Updated to use a PHP5 constructor. 33: * @since 5.6.1 Multiple headers are concatenated into a comma-separated string, class-wp-object-cache.php 293: * @since 6.1.0 Returns false if cache key is invalid. post-template.php 265: * @since 5.2.0 Added the `$post` parameter. 408: * @since 4.5.0 Introduced the `$post` parameter. 431: * @since 4.5.0 Introduced the `$post` parameter. 487: * @since 4.2.0 Custom taxonomy class names were added. 925: * @since 5.1.0 Added the `aria_current` argument. 1172: * @since 4.2.0 The `$value_field` argument was added. 1173: * @since 4.3.0 The `$class` argument was added. 1263: * @since 4.7.0 Added the `item_spacing` argument. 1397: * @since 4.4.0 Added `menu_id`, `container`, `before`, `after`, and `walker` arguments. 1398: * @since 4.7.0 Added the `item_spacing` argument. 1585: * @since 5.3.0 Formalized the existing `...$args` parameter by adding it 1637: * @since 4.4.0 The `$post` parameter can now accept either a post ID or `WP_Post` object. 1701: * @since 5.1.0 Added the `$attr` parameter. 1823: * @since 5.8.0 Added the `$post` parameter. 1824: * @since 6.8.0 Added the `$invalid_password` parameter. 1845: * @since 4.2.0 The `$template` parameter was changed to also accept an array of page templates. 1846: * @since 4.7.0 Now works with any post type, not just pages. 1881: * @since 4.7.0 Now works with any post type, not just pages. class-wp-customize-manager.php 244: * @since 4.7.0 Added `$args` parameter. 421: * @since 4.2.0 Added `$action` param. 1152: * @since 4.9.0 This will return the changeset's data with a user's autosave revision merged on top, if one exists and $autosaved is true. 1749: * @since 4.7.0 Added `$args` parameter and merging with changeset values and stashed theme mods. 1823: * @since 4.1.1 Introduced the `$default_value` parameter. 2428: * @since 4.7.0 The semantics of this method have changed to update a changeset, optionally to also change the status and other attributes. 3770: * @since 4.5.0 Return added WP_Customize_Setting instance. 3892: * @since 4.5.0 Return added WP_Customize_Panel instance. 3988: * @since 4.5.0 Return added WP_Customize_Section instance. 4067: * @since 4.5.0 Return added WP_Customize_Control instance. rewrite.php 131: * @since 4.4.0 Array support was added to the `$query` parameter. 309: * @since 4.3.0 Added support for skipping query var registration by passing `false` to `$query_var`. option.php 121: * @since 4.4.0 The `$option` parameter was added. 122: * @since 4.9.0 The `$default_value` parameter was added. 191: * @since 4.4.0 The `$option` parameter was added. 192: * @since 4.7.0 The `$passed_default` parameter was added to distinguish between a `false` value and the default parameter value. 248: * @since 1.5.0 As 'option_' . $setting 250: * @since 4.4.0 The `$option` parameter was added. 387: * @since 6.7.0 The autoload values 'yes' and 'no' are deprecated. 514: * @since 6.7.0 The autoload values 'yes' and 'no' are deprecated. 538: * @since 6.7.0 The autoload values 'yes' and 'no' are deprecated. 593: * @since 5.3.1 The `$force_cache` parameter was added. 797: * @since 6.3.0 Also prime caches for network options when persistent object cache is enabled. 798: * @since 6.6.0 Uses wp_prime_network_option_caches(). 824: * @since 4.2.0 The `$autoload` parameter was added. 825: * @since 6.7.0 The autoload values 'yes' and 'no' are deprecated. 896: * @since 4.4.0 The `$option` parameter was added. 1014: * @since 4.4.0 The `$option` parameter was added. 1049: * @since 6.6.0 The $autoload parameter's default value was changed to null. 1050: * @since 6.7.0 The autoload values 'yes' and 'no' are deprecated. 1171: * @since 2.5.0 As `add_option_{$name}` 1442: * @since 4.4.0 The `$transient` parameter was added 1486: * @since 4.4.0 The `$transient` parameter was added 1519: * @since 4.2.0 The `$expiration` parameter was added. 1520: * @since 4.4.0 The `$transient` parameter was added. 1587: * @since 3.6.0 The `$value` and `$expiration` parameters were added. 1588: * @since 4.4.0 The `$transient` parameter was added. 1611: * @since 3.6.0 The `$value` and `$expiration` parameters were added. 1924: * @since 4.4.0 The `$use_cache` parameter was deprecated. 1925: * @since 4.4.0 Modified into wrapper for get_network_option() 1944: * @since 4.4.0 Modified into wrapper for add_network_option() 1960: * @since 4.4.0 Modified into wrapper for delete_network_option() 1975: * @since 4.4.0 Modified into wrapper for update_network_option() 2023: * @since 2.9.0 As 'pre_site_option_' . $key 2025: * @since 4.4.0 The `$option` parameter was added. 2026: * @since 4.7.0 The `$network_id` parameter was added. 2027: * @since 4.9.0 The `$default_value` parameter was added. 2056: * @since 4.4.0 The `$option` parameter was added. 2057: * @since 4.7.0 The `$network_id` parameter was added. 2107: * @since 2.9.0 As 'site_option_' . $key 2109: * @since 4.4.0 The `$option` parameter was added. 2110: * @since 4.7.0 The `$network_id` parameter was added. 2156: * @since 2.9.0 As 'pre_add_site_option_' . $key 2158: * @since 4.4.0 The `$option` parameter was added. 2159: * @since 4.7.0 The `$network_id` parameter was added. 2220: * @since 2.9.0 As "add_site_option_{$key}" 2222: * @since 4.7.0 The `$network_id` parameter was added. 2234: * @since 4.7.0 The `$network_id` parameter was added. 2281: * @since 4.4.0 The `$option` parameter was added. 2282: * @since 4.7.0 The `$network_id` parameter was added. 2326: * @since 2.9.0 As "delete_site_option_{$key}" 2328: * @since 4.7.0 The `$network_id` parameter was added. 2339: * @since 4.7.0 The `$network_id` parameter was added. 2389: * @since 2.9.0 As 'pre_update_site_option_' . $key 2391: * @since 4.4.0 The `$option` parameter was added. 2392: * @since 4.7.0 The `$network_id` parameter was added. 2454: * @since 2.9.0 As "update_site_option_{$key}" 2456: * @since 4.7.0 The `$network_id` parameter was added. 2469: * @since 4.7.0 The `$network_id` parameter was added. 2556: * @since 4.4.0 The `$transient` parameter was added. 2598: * @since 4.4.0 The `$transient` parameter was added. 2630: * @since 4.4.0 The `$transient` parameter was added. 2680: * @since 4.4.0 The `$transient` parameter was added 2722: * @since 6.0.1 The `show_on_front`, `page_on_front`, and `page_for_posts` options were added. 2949: * @since 3.0.0 The `misc` option group was deprecated. 2950: * @since 3.5.0 The `privacy` option group was deprecated. 2954: * @since 6.6.0 Added the `label` argument. plugin.php 161: * @since 6.0.0 Formalized the existing and already documented `...$args` parameter 471: * @since 5.3.0 Formalized the existing and already documented `...$arg` parameter 976: * @since 5.3.0 Removed workarounds for spl_object_hash(). category-template.php 38: * @since 4.8.0 The `$visited` parameter was deprecated and renamed to `$deprecated`. 93: * @since 4.4.0 Added the `$post_id` parameter. 250: * @since 2.7.0 The `$post` parameter was added. 301: * @since 4.2.0 Introduced the `value_field` argument. 302: * @since 4.6.0 Introduced the `required` argument. 303: * @since 6.1.0 Introduced the `aria_describedby` argument. 492: * @since 4.4.0 Introduced the `hide_title_if_empty` and `separator` arguments. 493: * @since 4.4.0 The `current_category` argument was modified to optionally accept an array of values. 494: * @since 6.1.0 Default value of the 'use_desc_for_title' argument was changed from 1 to 0. 697: * @since 2.8.0 Added the `taxonomy` argument. 698: * @since 4.8.0 Added the `show_count` argument. 804: * @since 4.8.0 Added the `show_count` argument. 1102: * @since 5.3.0 Formalized the existing `...$args` parameter by adding it 1128: * @since 5.3.0 Formalized the existing `...$args` parameter by adding it 1259: * @since 4.9.2 The `$taxonomy` parameter was deprecated. 1511: * @since 2.7.0 Tags given as integers are only checked against 1513: * @since 2.7.0 Can be used outside of the WordPress Loop if `$post` is provided. class-wp-text-diff-renderer-table.php 41: * @since 6.4.0 Declared a previously dynamic property. 49: * @since 6.4.0 Declared a previously dynamic property. 57: * @since 6.4.0 Declared a previously dynamic property. 542: * @since 6.4.0 Getting a dynamic property is deprecated. 565: * @since 6.4.0 Setting a dynamic property is deprecated. 588: * @since 6.4.0 Checking a dynamic property is deprecated. 611: * @since 6.4.0 Unsetting a dynamic property is deprecated. post-thumbnail-template.php 46: * @since 5.5.0 The return value for a non-existing post 178: * @since 4.9.0 Added the `$post_id` parameter. class-wp-xmlrpc-server.php 738: * @since 5.7.0 Added the `$args` and `$server` parameters. 1014: * @since 4.6.0 Converted the `$post_type` parameter to accept a WP_Post_Type object. 1055: * @since 4.6.0 Converted the `$post_type` parameter to accept a WP_Post_Type object. theme.php 156: * @since 6.5.0 Makes use of global template variables. 196: * @since 6.4.0 Memoizes filter execution so that it only runs once for the current theme. 197: * @since 6.4.2 Memoization removed. 332: * @since 6.4.0 Memoizes filter execution so that it only runs once for the current theme. 333: * @since 6.4.1 Memoization removed. 872: * @since 4.5.0 Introduced the `$old_theme` parameter. 895: * @since 6.0.0 Removed the requirement for block themes to have an `index.php` template. 960: * @since 5.8.0 Removed support for using `readme.txt` as a fallback. 1012: * @since 5.9.0 The return value is always an array. 1089: * @since 5.6.0 A return value was added. 2617: * @since 3.4.0 The `custom-header-uploads` feature was deprecated. 2618: * @since 3.6.0 The `html5` feature was added. 2619: * @since 3.6.1 The `html5` feature requires an array of types to be passed. Defaults to 2621: * @since 3.9.0 The `html5` feature now also accepts 'gallery' and 'caption'. 2622: * @since 4.1.0 The `title-tag` feature was added. 2623: * @since 4.5.0 The `customize-selective-refresh-widgets` feature was added. 2624: * @since 4.7.0 The `starter-content` feature was added. 2625: * @since 5.0.0 The `responsive-embeds`, `align-wide`, `dark-editor-style`, `disable-custom-colors`, 2628: * @since 5.3.0 The `html5` feature now also accepts 'script' and 'style'. 2629: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 2631: * @since 5.4.0 The `disable-custom-gradients` feature limits to default gradients or gradients added 2633: * @since 5.5.0 The `core-block-patterns` feature was added and is enabled by default. 2634: * @since 5.5.0 The `custom-logo` feature now also accepts 'unlink-homepage-logo'. 2635: * @since 5.6.0 The `post-formats` feature warns if no array is passed as the second parameter. 2636: * @since 5.8.0 The `widgets-block-editor` feature enables the Widgets block editor. 2637: * @since 5.8.0 The `block-templates` feature indicates whether a theme uses block-based templates. 2638: * @since 6.0.0 The `html5` feature warns if no array is passed as the second parameter. 2639: * @since 6.1.0 The `block-template-parts` feature allows to edit any reusable template part from site editor. 2640: * @since 6.1.0 The `disable-layout-styles` feature disables the default layout styles. 2641: * @since 6.3.0 The `link-color` feature allows to enable the link color setting. 2642: * @since 6.3.0 The `border` feature allows themes without theme.json to add border styles to blocks. 2643: * @since 6.5.0 The `appearance-tools` feature enables a few design tools for blocks, 2645: * @since 6.6.0 The `editor-spacing-sizes` feature was added. 3020: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 3150: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 3437: * @since 4.3.0 Also removes `header_image_data`. 3438: * @since 4.5.0 Also removes custom logo theme mods. 3439: * @since 6.6.0 Also removes `site_logo` option set by the site logo block. 3793: * @since 4.7.0 Support for IE8 and below is explicitly removed via conditional comments. 3794: * @since 5.5.0 IE8 and older are no longer supported. 3935: * @since 6.0.1 The `block-templates` feature was added. class-wp-feed-cache-transient.php 14: * @since 6.7.0 Now properly implements the SimplePie\Cache\Base interface. 49: * @since 3.2.0 Updated to use a PHP5 constructor. 50: * @since 6.7.0 Parameter names have been updated to be in line with the `SimplePie\Cache\Base` interface. class-wp-theme.php 26: * @since 5.4.0 Added `Requires at least` and `Requires PHP` headers. 27: * @since 6.1.0 Added `Update URI` header. 51: * @since 3.5.0 Added the Twenty Twelve theme. 52: * @since 3.6.0 Added the Twenty Thirteen theme. 53: * @since 3.8.0 Added the Twenty Fourteen theme. 54: * @since 4.1.0 Added the Twenty Fifteen theme. 55: * @since 4.4.0 Added the Twenty Sixteen theme. 56: * @since 4.7.0 Added the Twenty Seventeen theme. 57: * @since 5.0.0 Added the Twenty Nineteen theme. 58: * @since 5.3.0 Added the Twenty Twenty theme. 59: * @since 5.6.0 Added the Twenty Twenty-One theme. 60: * @since 5.9.0 Added the Twenty Twenty-Two theme. 61: * @since 6.1.0 Added the Twenty Twenty-Three theme. 62: * @since 6.4.0 Added the Twenty Twenty-Four theme. 63: * @since 6.7.0 Added the Twenty Twenty-Five theme. 935: * @since 5.4.0 Added support for `Requires at least` and `Requires PHP` headers. 936: * @since 6.1.0 Added support for `Update URI` header. 1314: * @since 5.8.0 Include block templates. 1387: * @since 4.7.0 Added the `$post_type` parameter. 1426: * @since 4.4.0 Converted to allow complete control over the `$page_templates` array. 1427: * @since 4.7.0 Added the `$post_type` parameter. 1991: * @since 6.6.0 Uses transients to cache regardless of site environment. 2012: * @since 6.6.0 Uses transients to cache regardless of site environment. 2054: * @since 6.6.0 Uses transients to cache regardless of site environment. user.php 605: * @since 4.1.0 Added `$post_type` argument. 606: * @since 4.3.0 Added `$public_only` argument. Added the ability to pass an array 637: * @since 4.1.0 Added `$post_type` argument. 638: * @since 4.3.1 Added `$public_only` argument. 1007: * @since 4.7.0 Converted to use `get_sites()`. 1315: * @since 4.4.0 The number of users with no role is now included in the `none` element. 1316: * @since 4.9.0 The `$site_id` parameter was added to support multisite. 1448: * @since 4.8.0 The `$network_id` parameter has been added. 1449: * @since 6.0.0 Moved to wp-includes/user.php. 1644: * @since 4.5.0 Added the 'display_name_with_login' value for 'show'. 1645: * @since 4.7.0 Added the 'role', 'role__in', and 'role__not_in' parameters. 1646: * @since 5.9.0 Added the 'capability', 'capability__in', and 'capability__not_in' parameters. 2008: * @since 6.2.0 User metadata caches are now cleared. 2111: * @since 4.4.0 Empty sanitized usernames are now considered invalid. 2141: * @since 3.6.0 The `aim`, `jabber`, and `yim` fields were removed as default user contact 2143: * @since 4.7.0 The `locale` field can be passed to `$userdata`. 2144: * @since 5.3.0 The `user_activation_key` field can be passed to `$userdata`. 2145: * @since 5.3.0 The `spam` field can be passed to `$userdata` (Multisite only). 2146: * @since 5.9.0 The `meta_input` field can be passed to `$userdata` to allow addition of user meta data. 2467: * @since 5.8.0 The `$userdata` parameter was added. 2468: * @since 6.8.0 The user's password is now hashed using bcrypt by default instead of phpass. 2513: * @since 5.8.0 The `$userdata` parameter was added. 2591: * @since 5.8.0 The `$userdata` parameter was added. 2625: * @since 5.8.0 The `$userdata` parameter was added. 3154: * @since 3.7.0 Previously plain-text keys were stored in the database. 3155: * @since 4.3.0 Previously key hashes were stored without an expiration time. 3171: * @since 5.7.0 Added `$user_login` parameter. 3223: * @since 4.4.0 Added the `$errors` parameter. 3224: * @since 5.4.0 Added the `$user_data` parameter. 3332: * @since 4.4.0 Added the `$user_login` and `$user_data` parameters. 3346: * @since 4.1.0 Added `$user_login` and `$user_data` parameters. 3588: * @since 4.6.0 Converted the `$notify` parameter to accept 'user' for sending 3664: * @since 4.9.0 The `$site_id` parameter was added to support multisite. 3777: * @since 4.9.0 This function was moved from wp-admin/includes/ms.php so it's no longer Multisite specific. 3859: * @since 4.9.0 This filter is no longer Multisite specific. 3889: * @since 4.9.0 This function was moved from wp-admin/includes/ms.php so it's no longer Multisite specific. 3945: * @since 5.4.0 Added 'Community Events Location' group to the export data. 3946: * @since 5.4.0 Added 'Session Tokens' group to the export data. 4701: * @since 5.7.0 Added the `$status` parameter. http.php 222: * @since 4.6.0 Return value changed from an array to an WpOrg\Requests\Utility\CaseInsensitiveDictionary instance. 699: * @since 4.7.0 The `$component` parameter was added for parity with PHP's `parse_url()`. meta.php 654: * @since 5.5.0 Added the `$meta_type` parameter. 1337: * @since 4.9.8 The `$object_subtype` parameter was added. 1398: * @since 4.9.8 The `$object_subtype` argument was added to the arguments array. 1399: * @since 5.3.0 Valid meta types expanded to include "array" and "object". 1400: * @since 5.5.0 The `$default` argument was added to the arguments array. 1401: * @since 6.4.0 The `$revisions_enabled` argument was added to the arguments array. 1402: * @since 6.7.0 The `label` argument was added to the arguments array. 1632: * @since 4.9.8 The `$object_subtype` parameter was added. 1651: * @since 4.9.8 The `$object_subtype` parameter was added. 1701: * @since 4.9.8 The `$object_subtype` parameter was added. ms-site.php 343: * @since 5.1.0 Introduced the `$update_meta_cache` parameter. 344: * @since 6.1.0 This function is no longer marked as "private". 345: * @since 6.3.0 Use wp_lazyload_site_meta() for lazy-loading of site meta. 387: * @since 5.1.0 Introduced the `$update_meta_cache` parameter. 436: * @since 4.8.0 Introduced the 'lang_id', 'lang__in', and 'lang__not_in' parameters. ms-blogs.php 86: * @since 4.7.0 Converted to use `get_sites()`. 520: * @since 5.4.0 The `$context` parameter was added. 754: * @since 5.1.0 Use wp_update_site() internally. 888: * @since 6.2.0 Added the `$post` parameter. 905: * @since 4.9.0 Added the `$post` parameter. class-wp-fatal-error-handler.php 139: * @since 5.3.0 The `$handled` parameter was added. 169: * @since 5.3.0 The `$handled` parameter was added. block-supports/border.php 14: * @since 6.1.0 Improved conditional blocks optimization. 43: * @since 6.1.0 Implemented the style engine to generate CSS and classnames. block-supports/colors.php 13: * @since 6.1.0 Improved $color_support assignment optimization. 75: * @since 6.1.0 Implemented the style engine to generate CSS and classnames. block-supports/settings.php 69: * @since 6.3.0 Updated preset styles to use Selectors API. block-supports/dimensions.php 46: * @since 6.2.0 Added `minHeight` support. block-supports/typography.php 13: * @since 6.3.0 Added support for text-columns. 81: * @since 6.1.0 Used the style engine to generate CSS and classnames. 82: * @since 6.3.0 Added support for text-columns. 419: * @since 6.3.0 Checks for unsupported min/max viewport values that cause invalid clamp values. 420: * @since 6.5.0 Returns early when min and max viewport subtraction is zero to avoid division by zero. 516: * @since 6.1.1 Adjusted rules for min and max font sizes. 517: * @since 6.2.0 Added 'settings.typography.fluid.minFontSize' support. 518: * @since 6.3.0 Using layout.wideSize as max viewport width, and logarithmic scale factor to calculate minimum font scale. 519: * @since 6.4.0 Added configurable min and max viewport width values to the typography.fluid theme.json schema. 520: * @since 6.6.0 Deprecated bool argument $should_use_fluid_typography. 521: * @since 6.7.0 Font size presets can enable fluid typography individually, even if it’s disabled globally. block-supports/spacing.php 40: * @since 6.1.0 Implemented the style engine to generate CSS and classnames. block-supports/background.php 43: * @since 6.5.0 Added support for `backgroundPosition` and `backgroundRepeat` output. 44: * @since 6.6.0 Removed requirement for `backgroundImage.source`. A file/url is the default. 45: * @since 6.7.0 Added support for `backgroundAttachment` output. block-supports/layout.php 17: * @since 6.6.0 Updated specificity for compatibility with 0-1-0 global styles specificity. 200: * @since 6.3.0 Check for layout support via the `layout` key with fallback to `__experimentalLayout`. 224: * @since 6.1.0 Added `$block_spacing` param, use style engine to enqueue styles. 225: * @since 6.3.0 Added grid layout type. 226: * @since 6.6.0 Removed duplicated selector from layout styles. 561: * @since 6.3.0 Adds compound class to layout wrapper for global spacing styles. 562: * @since 6.3.0 Check for layout support via the `layout` key with fallback to `__experimentalLayout`. 563: * @since 6.6.0 Removed duplicate container class from layout styles. 997: * @since 6.6.1 Removed inner container from Grid variations. block-supports/shadow.php 46: * @since 6.6.0 Return early if __experimentalSkipSerialization is true. block-supports/elements.php 106: * @since 6.1.0 Implemented the style engine to generate CSS and classnames. 107: * @since 6.6.0 Element block support class and styles are generated via the `render_block_data` filter instead of `pre_render_block`. theme-compat/embed-content.php 54: * @since 4.5.0 Added `$thumbnail_id` parameter. 70: * @since 4.5.0 Added `$thumbnail_id` parameter. ms-deprecated.php 740: * @since 6.1.0 This function no longer does anything. functions.wp-scripts.php 35: * @since 5.5.0 Added the `$handle` parameter. 159: * @since 4.3.0 A return value was added. 160: * @since 6.3.0 The $in_footer parameter of type boolean was overloaded to be an $args parameter of type array. 243: * @since 5.1.0 The `$domain` parameter was made optional. 346: * @since 6.3.0 The $in_footer parameter of type boolean was overloaded to be an $args parameter of type array. ms-network.php 125: * @since 6.1.0 This function is no longer marked as "private". capabilities.php 27: * @since 4.9.6 Added the `export_others_personal_data`, `erase_others_personal_data`, 29: * @since 5.1.0 Added the `update_php` capability. 30: * @since 5.2.0 Added the `resume_plugin` and `resume_theme` capabilities. 31: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 33: * @since 5.7.0 Added the `create_app_password`, `list_app_passwords`, `read_app_password`, 36: * @since 6.7.0 Added the `edit_block_binding` capability. 502: * @since 3.3.0 As `auth_post_meta_{$meta_key}`. 524: * @since 4.6.0 As `auth_post_{$post_type}_meta_{$meta_key}`. 525: * @since 4.7.0 Renamed from `auth_post_{$post_type}_meta_{$meta_key}` to 895: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 897: * @since 5.8.0 Converted to wrapper for the user_can() function. 959: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 996: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter link-template.php 13: * @since 4.4.0 Added the `$post` parameter. 22: * @since 4.4.0 Added the `$post` parameter. 315: * @since 6.1.0 Returns false if the post does not exist. 528: * @since 5.6.0 Providing an empty string will now disable 1072: * @since 4.5.0 The `$taxonomy` parameter was made optional. 1294: * @since 4.5.0 Support for posts was added. 1430: * @since 4.0.0 Added the `$post` parameter. 1445: * @since 6.3.0 Adds custom link for wp_navigation post types. 1506: * @since 4.4.0 The `$css_class` argument was added. 1598: * @since 6.7.0 The $context parameter was added. 1628: * @since 6.7.0 The $comment_id and $context parameters are now being passed to the filter. 1953: * @since 4.4.0 Added the `$taxonomy` and `$post` parameters. 1975: * @since 4.4.0 Added the `$taxonomy` and `$post` parameters. 1997: * @since 4.4.0 Added the `$post` parameter. 1998: * @since 4.9.0 Added the `$order` parameter. 2129: * @since 5.6.0 No longer used in core. 2380: * @since 4.2.0 Added the `$adjacent` parameter. 2485: * @since 5.2.0 Added the `$pagenum` argument. 2765: * @since 4.4.0 Introduced the `in_same_term`, `excluded_terms`, and `taxonomy` arguments. 2766: * @since 5.3.0 Added the `aria_label` parameter. 2767: * @since 5.5.0 Added the `class` parameter. 2850: * @since 5.3.0 Added the `aria_label` parameter. 2851: * @since 5.5.0 Added the `class` parameter. 2925: * @since 5.3.0 Added the `aria_label` parameter. 2926: * @since 5.5.0 Added the `class` parameter. 3012: * @since 5.3.0 Added the `aria_label` parameter. 3111: * @since 6.7.0 Added the `page` parameter. 3186: * @since 6.7.0 Added the `page` parameter. 3292: * @since 5.3.0 Added the `aria_label` parameter. 3293: * @since 5.5.0 Added the `class` parameter. 3361: * @since 5.3.0 Added the `aria_label` parameter. 3362: * @since 5.5.0 Added the `class` parameter. 3591: * @since 5.8.0 The `$scheme` parameter was added. 3623: * @since 5.8.0 The `$scheme` parameter was added. 3836: * @since 5.8.0 The `$scheme` parameter was added. 3868: * @since 5.8.0 The `$scheme` parameter was added. 3914: * @since 4.4.0 The 'rest' scheme was added. 4104: * @since 4.6.0 Adjusted to use `wp_get_canonical_url()`. 4249: * @since 6.8.0 Removed title attribute. 4353: * @since 6.7.0 Gravatar URLs always use HTTPS. 4354: * @since 6.8.0 Gravatar URLs use the SHA-256 hashing algorithm. 4786: * @since 6.2.0 Added 'privacy-policy' rel attribute. class-wp-block-styles-registry.php 45: * @since 6.6.0 Added ability to register style across multiple block types along with theme.json-like style data. html-api/class-wp-html-open-elements.php 295: * @since 6.7.0 Full support. 342: * @since 6.5.0 Implemented: no longer throws on every invocation. 343: * @since 6.7.0 Supports all required HTML elements. 392: * @since 6.7.0 Supports all required HTML elements. 440: * @since 6.7.0 Full implementation. 470: * @since 6.4.0 Stub implementation (throws). 471: * @since 6.7.0 Full implementation. 643: * @since 6.5.0 Accepts $above_this_node to start traversal above a given node, if it exists. html-api/class-wp-html-processor.php 288: * @since 6.6.0 Returns `static` instead of `self` so it can create subclass instances. 646: * @since 6.6.0 Visits all tokens, including virtual ones. 751: * @since 6.5.0 Added for internal support; do not use. 752: * @since 6.7.2 Refactored so subclasses may extend. 773: * @since 6.7.2 Added for internal support. 849: * @since 6.6.0 Subclassed for HTML Processor. 1596: * @since 6.7.0 Stub implementation. 1911: * @since 6.7.0 Stub implementation. 2014: * @since 6.7.0 Stub implementation. 3439: * @since 6.7.0 Stub implementation. 4205: * @since 6.7.0 Stub implementation. 4334: * @since 6.7.0 Stub implementation. 4423: * @since 6.7.0 Stub implementation. 4542: * @since 6.7.0 Stub implementation. 4627: * @since 6.7.0 Stub implementation. 4690: * @since 6.7.0 Stub implementation. 4758: * @since 6.7.0 Stub implementation. 5079: * @since 6.5.0 Renamed from bookmark_tag() to bookmark_token(). 5165: * @since 6.6.0 Subclassed for the HTML Processor. 5189: * @since 6.6.0 Subclassed for the HTML Processor. 5217: * @since 6.6.0 Subclassed for the HTML Processor. 5259: * @since 6.6.0 Subclassed for HTML Processor. 5277: * @since 6.6.0 Subclassed for the HTML Processor. 5290: * @since 6.6.0 Subclassed for HTML Processor. 5318: * @since 6.6.0 Subclassed for the HTML Processor. 5332: * @since 6.6.0 Subclassed for the HTML Processor. 5344: * @since 6.6.0 Subclassed for the HTML Processor. 5356: * @since 6.6.0 Subclassed for the HTML Processor. 5383: * @since 6.6.0 Subclassed for the HTML Processor. 5405: * @since 6.6.0 Subclassed for the HTML Processor. 5428: * @since 6.6.0 Subclassed for the HTML Processor. 5730: * @since 6.7.0 Full spec support. 5767: * @since 6.7.0 Full spec support. html-api/class-wp-html-span.php 21: * @since 6.5.0 Replaced `end` with `length` to more closely align with `substr()`. html-api/class-wp-html-unsupported-exception.php 24: * @since 6.7.0 Gained contextual information for use in debugging parse failures. html-api/class-wp-html-attribute-token.php 18: * @since 6.5.0 Replaced `end` with `length` to more closely match `substr()`. 80: * @since 6.5.0 Replaced `end` with `length` to more closely match `substr()`. 99: * @since 6.5.0 Replaced `end` with `length` to more closely match `substr()`. html-api/class-wp-html-tag-processor.php 405: * @since 6.2.1 Fix: Support for various invalid comments; attribute updates are case-insensitive. 406: * @since 6.3.2 Fix: Skip HTML-like content inside rawtext elements such as STYLE. 407: * @since 6.5.0 Pauses processor when input ends in an incomplete syntax token. 863: * @since 6.5.0 No longer processes incomplete tokens at end of document; pauses the processor at start of token. 922: * @since 6.7.0 Recognizes CDATA sections within foreign content. 1640: * @since 6.2.1 Support abruptly-closed comments, invalid-tag-closer-comments, and empty elements. 2426: * @since 6.2.1 Accumulates shift for internal cursor and passed pointer. 2427: * @since 6.3.0 Invalidate any bookmarks whose targets are overwritten. 3271: * @since 6.7.0 Reports all BR tags as opening tags. 3562: * @since 6.7.0 Replaces NULL bytes (U+0000) and newlines appropriately. 3807: * @since 6.2.1 Fix: Only create a single update for multiple calls with case-variant attribute names. 4133: * @since 6.2.1 Shifts the internal cursor corresponding to the applied updates. 4134: * @since 6.4.0 No longer calls subclass method `next_tag()` after updating HTML. html-api/class-wp-html-text-replacement.php 18: * @since 6.5.0 Replace `end` with `length` to more closely match `substr()`. ms-load.php 156: * @since 4.7.0 Updated to always return a `WP_Site` object. 459: * @since 4.4.0 The `$domain` and `$path` parameters were added. class-wp-meta-query.php 102: * @since 4.2.0 Introduced support for naming query clauses by associative array keys. 103: * @since 5.1.0 Introduced `$compare_key` clause parameter, which enables LIKE key matches. 104: * @since 5.3.0 Increased the number of operators available to `$compare_key`. Introduced `$type_key`, class-wp-block.php 275: * @since 6.6.0 Handle the `__default` attribute for pattern overrides. 276: * @since 6.7.0 Return any updated bindings metadata in the computed attributes. 476: * @since 6.5.0 Added block bindings processing. 630: * @since 5.9.0 The `$instance` parameter was added. 645: * @since 5.9.0 The `$instance` parameter was added. class-wp-application-passwords.php 62: * @since 5.7.0 Returns WP_Error if application name already exists. 63: * @since 6.8.0 The hashed password value now uses wp_fast_hash() instead of phpass. 128: * @since 6.8.0 The hashed password value now uses wp_fast_hash() instead of phpass. 254: * @since 6.8.0 The actual password should now be hashed using wp_fast_hash(). 302: * @since 6.8.0 The password is now hashed using wp_fast_hash() instead of phpass. class-wp-locale.php 14: * @since 4.6.0 Moved to its own file from wp-includes/locale.php. 22: * @since 6.2.0 Initialized to an empty array. 36: * @since 6.2.0 Initialized to an empty array. 45: * @since 6.2.0 Initialized to an empty array. 54: * @since 6.2.0 Initialized to an empty array. 63: * @since 6.2.0 Initialized to an empty array. 72: * @since 6.2.0 Initialized to an empty array. 83: * @since 6.2.0 Initialized to an empty array. 102: * @since 6.2.0 Initialized to an empty array. class-wp-admin-bar.php 109: * @since 4.5.0 Added the ability to pass 'lang' and 'dir' meta data. 110: * @since 6.5.0 Added the ability to pass 'menu_title' for an ARIA menu name. 506: * @since 6.5.0 Added `$menu_title` parameter to allow an ARIA menu name. vars.php 159: * @since 6.4.0 Added checking for the Sec-CH-UA-Mobile request header. class-wp-recovery-mode-key-service.php 40: * @since 6.8.0 The stored key is now hashed using wp_fast_hash() instead of phpass. 152: * @since 6.8.0 Each key is now hashed using wp_fast_hash() instead of phpass. 175: * @since 6.8.0 Each key should now be hashed using wp_fast_hash() instead of phpass. embed.php 334: * @since 6.8.0 Output was adjusted to only embed if the post supports it. 542: * @since 6.8.0 Output was adjusted to only embed if the post type supports it. cron.php 24: * @since 5.1.0 Return value modified to boolean indicating success or failure, 26: * @since 5.7.0 The `$wp_error` parameter was added. 77: * @since 5.7.0 The `$wp_error` parameter was added, and a `WP_Error` object can now be returned. 217: * @since 5.1.0 Return value modified to boolean indicating success or failure, 219: * @since 5.7.0 The `$wp_error` parameter was added. 325: * @since 5.1.0 Return value modified to boolean indicating success or failure, 327: * @since 5.7.0 The `$wp_error` parameter was added. 388: * @since 5.7.0 The `$wp_error` parameter was added, and a `WP_Error` object can now be returned. 449: * @since 5.1.0 Return value modified to boolean indicating success or failure, 451: * @since 5.7.0 The `$wp_error` parameter was added. 485: * @since 5.7.0 The `$wp_error` parameter was added, and a `WP_Error` object can now be returned. 535: * @since 5.1.0 Return value modified to indicate success or failure, 537: * @since 5.7.0 The `$wp_error` parameter was added. 576: * @since 5.7.0 The `$wp_error` parameter was added, and a `WP_Error` object can now be returned. 646: * @since 5.1.0 Return value added to indicate success or failure. 647: * @since 5.7.0 The `$wp_error` parameter was added. 667: * @since 5.7.0 The `$wp_error` parameter was added, and a `WP_Error` object can now be returned. 866: * @since 5.1.0 Return values added. 937: * @since 4.5.0 The `$doing_wp_cron` parameter was added. 986: * @since 5.1.0 Return value added to indicate success or failure. 987: * @since 5.7.0 Functionality moved to _wp_cron() to which this becomes a wrapper. 1087: * @since 5.4.0 The 'weekly' schedule was added. 1223: * @since 6.1.0 Return type modified to consistently return an array. 1247: * @since 5.1.0 Return value modified to outcome of update_option(). 1248: * @since 5.7.0 The `$wp_error` parameter was added. class-wp-embed.php 299: * @since 4.4.0 The default value changed to true. class-wp-theme-json-resolver.php 80: * @since 5.8.0 As `$theme_json_i18n`. 81: * @since 5.9.0 Renamed from `$theme_json_i18n` to `$i18n_schema`. 99: * @since 6.1.0 Added caching. 231: * @since 5.9.0 Theme supports have been inlined and the `$theme_support_data` argument removed. 232: * @since 6.0.0 Added an `$options` parameter to allow the theme data to be returned without theme supports. 233: * @since 6.6.0 Add support for 'default-font-sizes' and 'default-spacing-sizes' theme supports. 546: * @since 6.6.0 The 'isGlobalStylesUserThemeJSON' flag is left on the user data. 643: * @since 5.9.0 Added user data, removed the `$settings` parameter, 645: * @since 6.1.0 Added block data and generation of spacingSizes array. 646: * @since 6.2.0 Changed ' $origin' parameter values to 'default', 'blocks', 'theme' or 'custom'. 704: * @since 5.9.0 Added a check in the parent theme. 721: * @since 5.9.0 Adapted to work with child themes, added the `$template` argument. 738: * @since 5.9.0 Added the `$user`, `$user_custom_post_type_id`, 740: * @since 6.1.0 Added the `$blocks` and `$blocks_cache` variables 801: * @since 6.2.0 Returns parent theme variations if theme is a child. 802: * @since 6.6.0 Added configurable scope parameter to allow filtering 851: * @since 6.7.0 Resolve relative paths in block styles. class-wp-error.php 216: * @since 5.6.0 Errors can now contain more than one item of error data. {@see WP_Error::$additional_data}. block-template.php 52: * @since 6.3.0 Added `$_wp_current_template_id` global for editing of current template directly from the admin bar. 146: * @since 5.9.0 Added the `$fallback_template` parameter. sitemaps/providers/class-wp-sitemaps-posts.php 56: * @since 5.9.0 Renamed `$post_type` to `$object_subtype` to match parent class 175: * @since 5.9.0 Renamed `$post_type` to `$object_subtype` to match parent class 220: * @since 6.1.0 Added `ignore_sticky_posts` default parameter. 232: * @since 6.1.0 Added `ignore_sticky_posts` default parameter. sitemaps/providers/class-wp-sitemaps-taxonomies.php 54: * @since 5.9.0 Renamed `$taxonomy` to `$object_subtype` to match parent class 122: * @since 6.0.0 Added `$term` argument containing the term object. 141: * @since 5.9.0 Renamed `$taxonomy` to `$object_subtype` to match parent class robots-template.php 18: * @since 5.7.1 No longer prevents specific directives to occur together. admin-bar.php 69: * @since 5.4.0 Called on 'wp_body_open' action first, with 'wp_footer' as a fallback. 459: * @since 6.3.0 Added `$_wp_current_template_id` global for editing of current template directly from the admin bar. 460: * @since 6.6.0 Added the `canvas` query arg to the Site Editor link. 801: * @since 5.5.0 Added a "View Post" link on Comments screen for a single post. 945: * @since 6.5.0 Added a New Site link for network installations. class-wp-customize-control.php 443: * @since 4.9.0 Return a `data-customize-setting-key-link` attribute if a setting is not registered for the supplied setting key. class-wp-user-request.php 95: * @since 6.8.0 The key is now hashed using wp_fast_hash() instead of phpass. class-walker-page.php 96: * @since 5.9.0 Renamed `$page` to `$data_object` and `$current_page` to `$current_object_id` 226: * @since 5.9.0 Renamed `$page` to `$data_object` to match parent class for PHP 8 named parameter support. class-wp-theme-json.php 36: * @since 6.1.0 Initialize as an empty array. 61: * @since 6.1.0 Added 'blocks'. 120: * @since 5.9.0 Added the `color.duotone` and `typography.fontFamilies` presets, 122: * @since 6.0.0 Replaced `override` with `prevent_override` and updated the 124: * @since 6.2.0 Added 'shadow' presets. 125: * @since 6.3.0 Replaced value_func for duotone with `null`. Custom properties are handled by class-wp-duotone.php. 126: * @since 6.6.0 Added the `dimensions.aspectRatios` and `dimensions.defaultAspectRatios` presets. 217: * @since 5.9.0 Added the `border-*`, `font-family`, `font-style`, `font-weight`, 221: * @since 6.1.0 Added the `border-*-color`, `border-*-width`, `border-*-style`, 224: * @since 6.2.0 Added `outline-*`, and `min-height` properties. 225: * @since 6.3.0 Added `column-count` property. 226: * @since 6.4.0 Added `writing-mode` property. 227: * @since 6.5.0 Added `aspect-ratio` property. 228: * @since 6.6.0 Added `background-[image|position|repeat|size]` properties. 229: * @since 6.7.0 Added `background-attachment` property. 308: * @since 6.6.0 Added background-image properties. 349: * @since 5.8.0 As `ALLOWED_TOP_LEVEL_KEYS`. 350: * @since 5.9.0 Renamed from `ALLOWED_TOP_LEVEL_KEYS` to `VALID_TOP_LEVEL_KEYS`, 352: * @since 6.3.0 Added the `description` value. 353: * @since 6.6.0 Added `blockTypes` to support block style variation theme.json partials. 372: * @since 5.8.0 As `ALLOWED_SETTINGS`. 373: * @since 5.9.0 Renamed from `ALLOWED_SETTINGS` to `VALID_SETTINGS`, 376: * @since 6.0.0 Added `color.defaultDuotone`. 377: * @since 6.1.0 Added `layout.definitions` and `useRootPaddingAwareAlignments`. 378: * @since 6.2.0 Added `dimensions.minHeight`, 'shadow.presets', 'shadow.defaultPresets', 380: * @since 6.3.0 Added support for `typography.textColumns`, removed `layout.definitions`. 381: * @since 6.4.0 Added support for `layout.allowEditing`, `background.backgroundImage`, 383: * @since 6.5.0 Added support for `layout.allowCustomContentAndWideSize`, 385: * @since 6.6.0 Added support for 'dimensions.aspectRatios', 'dimensions.defaultAspectRatios', 507: * @since 5.8.0 As `ALLOWED_STYLES`. 508: * @since 5.9.0 Renamed from `ALLOWED_STYLES` to `VALID_STYLES`, 511: * @since 6.1.0 Added new side properties for `border`, 514: * @since 6.2.0 Added `outline`, and `minHeight` properties. 515: * @since 6.3.0 Added support for `typography.textColumns`. 516: * @since 6.5.0 Added support for `dimensions.aspectRatio`. 517: * @since 6.6.0 Added `background` sub properties to top-level only. 590: * @since 6.2.0 Added support for ':link' and ':any-link'. 591: * @since 6.8.0 Added support for ':focus-visible'. 603: * @since 6.1.0 Added `heading`, `button`, and `caption` elements. 709: * @since 6.2.0 Added `dimensions.minHeight` and `position.sticky`. 710: * @since 6.4.0 Added `background.backgroundImage`. 711: * @since 6.5.0 Added `background.backgroundSize` and `dimensions.aspectRatio`. 738: * @since 5.9.0 Changed value from 1 to 2. 739: * @since 6.6.0 Changed value from 2 to 3. 748: * @since 6.6.0 Key spacingScale by origin, and Pre-generate the spacingSizes from spacingScale. 930: * @since 5.9.0 Added the `$valid_block_names` and `$valid_element_name` parameters. 931: * @since 6.3.0 Added the `$valid_variations` parameter. 932: * @since 6.6.0 Updated schema to allow extended block style variations. 1071: * @since 6.1.0 Added append position. 1072: * @since 6.3.0 Removed append position parameter. 1140: * @since 5.9.0 Added `duotone` key with CSS selector. 1141: * @since 6.1.0 Added `features` key with block support feature level selectors. 1142: * @since 6.3.0 Refactored and stabilized selectors API. 1143: * @since 6.6.0 Updated to include block style variations from the block styles registry. 1312: * @since 5.9.0 Removed the `$type` parameter, added the `$types` and `$origins` parameters. 1313: * @since 6.3.0 Add fallback layout styles for Post Template when block gap support isn't available. 1314: * @since 6.6.0 Added boolean `skip_root_layout_styles` and `include_block_style_variations` options 1443: * @since 6.6.0 Enforced 0-1-0 specificity for block custom CSS selectors. 1586: * @since 5.8.0 As `get_block_styles()`. 1587: * @since 5.9.0 Renamed from `get_block_styles()` to `get_block_classes()` 1590: * @since 6.1.0 Moved most internal logic to `get_styles_for_block()`. 1612: * @since 6.3.0 Reduced specificity for layout margin rules. 1613: * @since 6.5.1 Only output rules referencing content and wide sizes when values exist. 1614: * @since 6.5.3 Add types parameter to check if only base layout styles are needed. 1615: * @since 6.6.0 Updated layout style specificity to be compatible with overall 0-1-0 specificity in global styles. 1874: * @since 5.9.0 Added the `$origins` parameter. 1932: * @since 5.9.0 Added the `$origins` parameter. 1933: * @since 6.6.0 Added check for root CSS properties selector. 1990: * @since 6.6.0 Added early return if missing scope or selector. 2086: * @since 6.6.0 Passing $settings to the callbacks defined in static::PRESETS_METADATA. 2181: * @since 5.9.0 Added the `$origins` parameter. 2303: * @since 5.9.0 Added the `$settings` and `$properties` parameters. 2304: * @since 6.1.0 Added `$theme_json`, `$selector`, and `$use_root_padding` parameters. 2305: * @since 6.5.0 Output a `min-height: unset` rule when `aspect-ratio` is set. 2306: * @since 6.6.0 Pass current theme JSON settings to wp_get_typography_font_size_value(), and process background properties. 2441: * @since 5.9.0 Added support for values of array type, which are returned as is. 2442: * @since 6.1.0 Added the `$theme_json` parameter. 2443: * @since 6.3.0 It no longer converts the internal format "var:preset|color|secondary" 2447: * @since 6.7.0 Added support for background image refs. 2573: * @since 6.6.0 Added options array for modifying generated nodes. 2696: * @since 6.3.0 Refactored and stabilized selectors API. 2697: * @since 6.6.0 Added optional selectors and options for generating block nodes. 2698: * @since 6.7.0 Added $include_node_paths_only option. 2826: * @since 6.6.0 Setting a min-height of HTML when root styles have a background gradient or image. 3052: * @since 6.6.0 Use `ROOT_CSS_PROPERTIES_SELECTOR` for CSS custom properties and improved consistency of root padding rules. 3161: * @since 5.9.0 Duotone preset also has origins. 3162: * @since 6.7.0 Replace background image objects during merge. 3494: * @since 6.3.2 Preserves global styles block variations when securing styles. 3495: * @since 6.6.0 Updated to allow variation element styles and $origin parameter. 4487: * @since 6.5.0 Check for empty style before processing its value. 4600: * @since 6.8.0 Added the `$blocks_metadata` parameter. class-wp-dependencies.php 113: * @since 2.8.0 Added the `$group` parameter. 152: * @since 5.5.0 Added the `$group` parameter. 170: * @since 2.6.0 Moved from `WP_Scripts`. 171: * @since 2.8.0 Added the `$group` parameter. 239: * @since 2.6.0 Moved from `WP_Scripts`. 323: * @since 2.6.0 Moved from `WP_Scripts`. 342: * @since 2.6.0 Moved from `WP_Scripts`. 376: * @since 2.6.0 Moved from `WP_Scripts`. 438: * @since 2.6.0 Moved from `WP_Scripts`. block-editor.php 14: * @since 6.3.0 Reusable Blocks renamed to Patterns. 62: * @since 5.8.0 It is possible to pass the block editor context as param. 422: * @since 6.4.0 Return null if there is no post content block. 821: * @since 6.6.0 Add support for 'editor-spacing-sizes' theme support. nav-menu-template.php 22: * @since 4.7.0 Added the `item_spacing` argument. 23: * @since 5.5.0 Added the `container_aria_label` argument. comment.php 59: * @since 4.7.0 Added the `$comment` parameter. 175: * @since 4.1.0 Refactored to leverage WP_Comment_Query over a direct query. 342: * @since 4.7.0 Replaced caching the modified date in a local static variable 572: * @since 4.9.6 The `$cookies_consent` parameter was added. 598: * @since 6.6.0 The default $seconds value changed from 30000000 to YEAR_IN_SECONDS. 678: * @since 4.7.0 The `$avoid_die` parameter was added, allowing the function 680: * @since 5.5.0 The `$avoid_die` parameter was renamed to `$wp_error`. 765: * @since 4.7.0 The `$avoid_die` parameter was added. 766: * @since 5.5.0 The `$avoid_die` parameter was renamed to `$wp_error`. 788: * @since 5.5.0 The `$avoid_die` parameter was renamed to `$wp_error`. 824: * @since 4.7.0 Converted to be an add_filter() wrapper. 1168: * @since 4.7.0 Introduced the `$comment_id` parameter. 1339: * @since 4.9.0 Returning a WP_Error value from the filter will short-circuit comment insertion 1521: * @since 4.9.0 Added the `$comment` parameter. 1549: * @since 4.9.0 Added the `$comment` parameter. 1595: * @since 4.9.0 Added the `$comment` parameter. 1612: * @since 4.9.0 Added the `$comment` parameter. 1643: * @since 4.9.0 Added the `$comment` parameter. 1663: * @since 4.9.0 Added the `$comment` parameter. 1694: * @since 4.9.0 Added the `$comment` parameter. 1711: * @since 4.9.0 Added the `$comment` parameter. 1742: * @since 4.9.0 Added the `$comment` parameter. 1762: * @since 4.9.0 Added the `$comment` parameter. 1985: * @since 5.7.0 The window within which the author email for an unapproved comment 2019: * @since 4.4.0 Introduced the `$comment_meta` argument. 2020: * @since 5.5.0 Default value for `$comment_type` argument changed to `comment`. 2234: * @since 4.3.0 Introduced the `comment_agent` and `comment_author_IP` arguments. 2235: * @since 4.7.0 The `$avoid_die` parameter was added, allowing the function 2237: * @since 5.5.0 The `$avoid_die` parameter was renamed to `$wp_error`. 2238: * @since 5.5.0 Introduced the `comment_type` argument. 2296: * @since 5.6.0 Comment data includes the `comment_agent` and `comment_author_IP` values. 2380: * @since 4.5.0 The `$commentdata` parameter was added. 2535: * @since 4.9.0 Add updating comment meta during comment update. 2536: * @since 5.5.0 The `$wp_error` parameter was added. 2537: * @since 5.5.0 The return values for an invalid comment or post ID 2624: * @since 5.5.0 Returning a WP_Error value from the filter will short-circuit comment update 2687: * @since 4.6.0 Added the `$data` parameter. 2943: * @since 5.6.0 Introduced `do_all_pings` action hook for individual services. 3110: * @since 6.8.0 Returns an array of pingback statuses indexed by link. 3379: * @since 4.4.0 Introduced the `$update_meta_cache` parameter. 3405: * @since 6.1.0 This function is no longer marked as "private". 3406: * @since 6.3.0 Use wp_lazyload_comment_meta() for lazy-loading of comment meta. nav-menu.php 413: * @since 5.9.0 Added the `$fire_after_hooks` parameter. 640: * @since 4.1.0 Default value of the 'orderby' argument was changed from 'none' class-walker-nav-menu.php 143: * @since 4.4.0 The {@see 'nav_menu_item_args'} filter was added. 144: * @since 5.9.0 Renamed `$item` to `$data_object` and `$id` to `$current_object_id` 146: * @since 6.7.0 Removed redundant title attributes. 187: * @since 4.1.0 The `$depth` parameter was added. 200: * @since 4.1.0 The `$depth` parameter was added. 282: * @since 4.1.0 The `$depth` parameter was added. 327: * @since 5.9.0 Renamed `$item` to `$data_object` to match parent class for PHP 8 named parameter support. class-wp-recovery-mode-email-service.php 210: * @since 5.6.0 The `$email` argument includes the `attachments` key. class-wp-comment.php 124: * @since 5.5.0 Default value changed to `comment`. class-wp-network-query.php 225: * @since 5.6.0 The returned array of network data is assigned to the `networks` property class-wp-oembed.php 546: * @since 4.9.0 The `dnt` (Do Not Track) query parameter was added to all oEmbed provider URLs. class-wp-image-editor.php 78: * @since 6.0.0 The `$filesize` value was added to the returned array. 235: * @since 6.8.0 The `$dims` parameter was added. 258: * @since 6.8.0 Added the size parameter. 428: * @since 6.8.0 Passing an empty string as $suffix will now omit the suffix from the generated filename. class-wp-widget.php 18: * @since 4.4.0 Moved to its own file from wp-includes/widgets.php 211: * @since 4.4.0 Array format field names are now accepted. 236: * @since 4.4.0 Array format field IDs are now accepted. block-template-utils.php 359: * @since 6.3.0 Added the `$query` parameter. 585: * @since 6.3.0 Added `modified` property to template objects. 878: * @since 6.3.0 Added `modified` property to template objects. 879: * @since 6.4.0 Added support for a revision post to be passed to this function. 1445: * @since 6.0.0 Adds the whole theme to the export archive. pluggable.php 93: * @since 4.4.0 Added 'ID' as an alias of 'id' for the `$field` parameter. 642: * @since 4.5.0 The value of `$username` can now be an email address. 643: * @since 5.4.0 The `$error` parameter was added. 672: * @since 5.5.0 Added the `$user_id` parameter. 859: * @since 4.0.0 The `$token` parameter was added. 897: * @since 4.0.0 The `$token` parameter was added. 914: * @since 4.0.0 The `$token` element was added to the return value. 978: * @since 4.3.0 Added the `$token` parameter. 1058: * @since 4.9.0 The `$token` parameter was added. 1075: * @since 4.9.0 The `$token` parameter was added. 1092: * @since 6.2.0 The `$expire`, `$expiration`, `$user_id`, `$scheme`, and `$token` parameters were added. 1279: * @since 2.5.0 The `$query_arg` parameter was added. 1390: * @since 5.1.0 The `$x_redirect_by` parameter was added. 1391: * @since 5.4.0 On invalid status codes, wp_die() is called. 1536: * @since 5.1.0 The return value from wp_redirect() is now passed on, and the `$x_redirect_by` parameter was added. 2158: * @since 4.3.0 The `$plaintext_pass` parameter was changed to `$notify`. 2159: * @since 4.3.1 The `$plaintext_pass` parameter was deprecated. `$notify` added as a third parameter. 2160: * @since 4.6.0 The `$notify` parameter accepts 'user' for sending notification only to the user created. 2334: * @since 6.1.0 Added `$action` argument. 2344: * @since 6.1.0 Added `$action` argument to allow for more targeted filters. 2427: * @since 4.0.0 Session tokens were integrated with nonce creation. 2605: * @since 6.8.0 The `$algo` parameter was added. 2641: * @since 6.8.0 The password is now hashed using bcrypt by default instead of phpass. 2729: * @since 6.8.0 Passwords in WordPress are now hashed with bcrypt by default. A 2774: * @since 6.8.0 Passwords are now hashed with bcrypt by default. 2879: * @since 5.3.0 Added the `$length`, `$special_chars`, and `$extra_special_chars` parameters. 2895: * @since 4.4.0 Uses PHP7 random_int() or the random_compat library if available. 2896: * @since 6.1.0 Returns zero instead of a random number if both `$min` and `$max` are zero. 2993: * @since 6.8.0 The password is now hashed using bcrypt by default instead of phpass. 3025: * @since 6.7.0 The `$old_user_data` parameter was added. 3040: * @since 4.2.0 Added the optional `$args` parameter. 3041: * @since 5.5.0 Added the `loading` argument. 3042: * @since 6.1.0 Added the `decoding` argument. 3043: * @since 6.3.0 Added the `fetchpriority` argument. 3235: * @since 4.2.0 Added the `$args` parameter. class-wp-network.php 31: * @since 4.6.0 Converted from public to private to explicitly enable more intuitive default-constants.php 156: * @since 4.4.0 Introduced `MONTH_IN_SECONDS`. 330: * @since 6.6.0 The value has changed from false to an empty string. query.php 18: * @since 3.9.0 The `$default_value` argument was introduced. 1222: * @since 4.4.0 Added the ability to pass a post ID to `$post`. class-wp-tax-query.php 93: * @since 4.1.0 Added support for `$operator` 'NOT EXISTS' and 'EXISTS' values. class-wp-query.php 16: * @since 4.5.0 Removed the `$comments_popup` property. 567: * @since 4.5.0 Removed the `comments_popup` public query variable. 650: * @since 4.2.0 Introduced the ability to order by specific clauses of a `$meta_query`, by passing the clause's 652: * @since 4.4.0 Introduced `$post_name__in` and `$title` parameters. `$s` was updated to support excluded 654: * @since 4.5.0 Removed the `$comments_popup` parameter. 657: * @since 4.6.0 Added 'post_name__in' support for `$orderby`. Introduced the `$lazy_load_term_meta` argument. 658: * @since 4.9.0 Introduced the `$comment_count` parameter. 659: * @since 5.1.0 Introduced the `$meta_compare_key` parameter. 660: * @since 5.3.0 Introduced the `$meta_type_key` parameter. 661: * @since 6.1.0 Introduced the `$update_menu_item_cache` parameter. 662: * @since 6.2.0 Introduced the `$search_columns` parameter. 1855: * @since 3.9.0 The `$default_value` argument was introduced. 3378: * @since 6.6.0 Added the `$old_request` and `$clauses` parameters. 4806: * @since 4.4.0 Added the ability to pass a post ID to `$post`. 4851: * @since 4.1.0 Introduced `$query` parameter. l10n.php 187: * @since 5.5.0 Introduced `gettext-{$domain}` filter. 253: * @since 5.5.0 Introduced `gettext_with_context-{$domain}` filter. 474: * @since 5.5.0 Introduced `ngettext-{$domain}` filter. 532: * @since 5.5.0 Introduced `ngettext_with_context-{$domain}` filter. 715: * @since 6.1.0 Added the `$locale` parameter. 762: * @since 6.2.0 Added the `$locale` parameter. 837: * @since 6.6.0 Added the `$locale` parameter. 870: * @since 6.1.0 Added the `$reloadable` parameter. 888: * @since 6.1.0 Added the `$reloadable` parameter. 908: * @since 6.1.0 Added the `$reloadable` parameter. 986: * @since 4.6.0 The function now tries to load the .mo file from the languages directory first. 987: * @since 6.7.0 Translations are no longer immediately loaded, but handed off to the just-in-time loading mechanism. 1031: * @since 4.6.0 The function now tries to load the .mo file from the languages directory first. 1032: * @since 6.7.0 Translations are no longer immediately loaded, but handed off to the just-in-time loading mechanism. 1072: * @since 4.6.0 The function now tries to load the .mo file from the languages directory first. 1073: * @since 6.7.0 Translations are no longer immediately loaded, but handed off to the just-in-time loading mechanism. 1132: * @since 5.0.2 Uses load_script_translations() to load translation data. 1133: * @since 5.1.0 The `$domain` parameter was made optional. 1451: * @since 5.2.0 Added the `$domain` parameter. 1468: * @since 4.7.0 The results are now filterable with the {@see 'get_available_languages'} filter. 1469: * @since 6.5.0 The initial file list is now cached and also takes into account *.l10n.php files. 1638: * @since 4.3.0 Introduced the `echo` argument. 1639: * @since 4.7.0 Introduced the `show_option_site_default` argument. 1640: * @since 5.1.0 Introduced the `show_option_en_us` argument. 1641: * @since 5.9.0 Introduced the `explicit_option_en_us` argument. template.php 97: * @since 4.8.0 The `$type` and `$templates` parameters were added. 247: * @since 4.7.0 The decoded form of `category-{slug}.php` was added to the top of the 293: * @since 4.7.0 The decoded form of `tag-{slug}.php` was added to the top of the 339: * @since 4.7.0 The decoded form of `taxonomy-{taxonomy_slug}-{term_slug}.php` was added to the top of the 460: * @since 4.7.0 The decoded form of `page-{page_name}.php` was added to the top of the 541: * @since 4.7.0 The decoded form of `single-{post_type}-{post_name}.php` was added to the top of the 653: * @since 4.3.0 The order of the mime type logic was reversed so the hierarchy is more logical. 705: * @since 5.5.0 The `$args` parameter was added. 759: * @since 5.5.0 The `$args` parameter was added. IXR/class-IXR-clientmulticall.php 30: * @since 5.5.0 Formalized the existing `...$args` parameter by adding it 45: * @since 5.5.0 Formalized the existing `...$args` parameter by adding it IXR/class-IXR-client.php 63: * @since 5.5.0 Formalized the existing `...$args` parameter by adding it class-wp-widget-factory.php 14: * @since 4.4.0 Moved to its own file from wp-includes/widgets.php 53: * @since 4.6.0 Updated the `$widget` parameter to also accept a WP_Widget instance object 70: * @since 4.6.0 Updated the `$widget` parameter to also accept a WP_Widget instance object media.php 1036: * @since 4.4.0 The `$srcset` and `$sizes` attributes were added. 1037: * @since 5.5.0 The `$loading` attribute was added. 1038: * @since 6.1.0 The `$decoding` attribute was added. 1816: * @since 5.7.0 Now returns `true` by default for `iframe` tags. 1854: * @since 5.7.0 Now supports adding `loading` attributes to `iframe` tags. 2477: * @since 3.9.0 The `class` attribute was added. 2478: * @since 5.1.0 The `caption_id` attribute was added. 2479: * @since 5.9.0 The `$content` parameter default value changed from `null` to `''`. 2635: * @since 2.8.0 Added the `$attr` parameter to set the shortcode output. New attributes included 2639: * @since 2.9.0 Added support for `include` and `exclude` to shortcode. 2640: * @since 3.5.0 Use get_post() instead of global `$post`. Handle mapping of `ids` to `include` 2642: * @since 3.6.0 Added validation for tags used in gallery shortcode. Add orientation information to items. 2643: * @since 3.7.0 Introduced the `link` attribute. 2645: * @since 4.0.0 Removed use of `extract()`. 2646: * @since 4.1.0 Added attribute to `wp_get_attachment_link()` to output `aria-describedby`. 2647: * @since 4.2.0 Passed the shortcode instance ID to `post_gallery` and `post_playlist` filters. 2648: * @since 4.6.0 Standardized filter docs to match documentation standards for PHP. 2649: * @since 5.1.0 Code cleanup for WPCS 1.0.0 coding standards. 2650: * @since 5.3.0 Saved progress of intermediate image creation after upload. 2651: * @since 5.5.0 Ensured that galleries can be output as a list of links in feeds. 2652: * @since 5.6.0 Replaced order-style PHP type conversion functions with typecasts. Fix logic for 2700: * @since 4.2.0 The `$instance` parameter was added. 3057: * @since 4.2.0 The `$instance` parameter was added. 3345: * @since 6.8.0 Added the 'muted' attribute. 3460: * @since 4.9.0 The `$atts` parameter was added. 3737: * @since 4.9.0 The `$atts` parameter was added. 3983: * @since 4.7.0 Introduced the `$output` parameter. 4790: * @since 4.8.0 The filter's default value is `true` rather than `null`. 4818: * @since 4.8.0 The filter's default value is `true` rather than `null`. 5668: * @since 6.7.0 The default behavior is to enable heic uploads as long as the server 5686: * @since 5.8.0 Added support for WebP images. 5687: * @since 6.5.0 Added support for AVIF images. 6186: * @since 6.3.0 The default threshold was changed from 1 to 3. 6317: * @since 6.7.0 The default was changed from an empty array to an array class-wp-http-streams.php 14: * @since 3.7.0 Combined with the fsockopen transport and switched to `stream_socket_client()`. 26: * @since 3.7.0 Combined with the fsockopen transport and switched to stream_socket_client(). 107: * @since 5.1.0 The `$url` parameter was added. 490: * @since 3.7.0 Combined with the fsockopen transport and switched to stream_socket_client(). class-wp-customize-widgets.php 1450: * @since 5.8.0 Added the `$id_base` parameter. 1509: * @since 5.8.0 Added the `$id_base` parameter. class-wp-http.php 176: * @since 5.1.0 The `$url` parameter was added. 186: * @since 5.1.0 The `$url` parameter was added. 196: * @since 5.1.0 The `$url` parameter was added. 206: * @since 5.1.0 The `$url` parameter was added. 216: * @since 5.1.0 The `$url` parameter was added. 391: * @since 5.1.0 The `$url` parameter was added. class-wp-post-type.php 516: * @since 6.4.0 Added `late_route_registration`, `autosave_rest_controller_class` and `revisions_rest_controller_class` arguments. class-wp-user.php 14: * @since 6.8.0 The `user_pass` property is now hashed using bcrypt by default instead of phpass. 192: * @since 4.4.0 Added 'ID' as an alias of 'id' for the `$field` parameter. 651: * @since 3.6.0 Added $old_roles to include an array of the user's previous roles. 768: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 801: * @since 3.7.0 Added the `$user` parameter. class-wp-dependency.php 93: * @since 5.3.0 Formalized the existing `...$args` parameter by adding it class-walker-page-dropdown.php 47: * @since 5.9.0 Renamed `$page` to `$data_object` and `$id` to `$current_object_id` block-patterns.php 15: * @since 6.3.0 Added source to core block patterns. 209: * @since 5.9.0 The $current_screen argument was removed. 210: * @since 6.2.0 Normalize the pattern from the API (snake_case) to the 212: * @since 6.3.0 Add 'pattern-directory/core' to the pattern's 'source'. 259: * @since 6.2.0 Normalized the pattern from the API (snake_case) to the 261: * @since 6.3.0 Add 'pattern-directory/featured' to the pattern's 'source'. 299: * @since 6.2.0 Normalized the pattern from the API (snake_case) to the 301: * @since 6.3.0 Add 'pattern-directory/theme' to the pattern's 'source'. 344: * @since 6.1.0 The `postTypes` property was added. 345: * @since 6.2.0 The `templateTypes` property was added. 346: * @since 6.4.0 Uses the `WP_Theme::get_block_patterns` method. class-wp-block-type.php 124: * @since 6.5.0 Only accessible through magic getter. null by default. 278: * @since 6.0.0 Added `lock`. 279: * @since 6.5.0 Added `metadata`. 293: * @since 5.5.0 Added the `title`, `category`, `parent`, `icon`, `description`, 296: * @since 5.6.0 Added the `api_version` property. 297: * @since 5.8.0 Added the `variations` property. 298: * @since 5.9.0 Added the `view_script` property. 299: * @since 6.0.0 Added the `ancestor` property. 300: * @since 6.1.0 Added the `editor_script_handles`, `script_handles`, `view_script_handles`, 303: * @since 6.3.0 Added the `selectors` property. 304: * @since 6.4.0 Added the `block_hooks` property. 305: * @since 6.5.0 Added the `allowed_blocks`, `variation_callback`, and `view_style_handles` properties. class-wp-image-editor-imagick.php 193: * @since 6.8.0 The `$dims` parameter was added. 794: * @since 6.0.0 The `$filesize` value was added to the returned array. 846: * @since 6.0.0 The `$filesize` value was added to the returned array. class-wp-block-patterns-registry.php 45: * @since 5.8.0 Added support for the `blockTypes` property. 46: * @since 6.1.0 Added support for the `postTypes` property. 47: * @since 6.2.0 Added support for the `templateTypes` property. 48: * @since 6.5.0 Added support for the `filePath` property. functions.wp-styles.php 114: * @since 4.3.0 A return value was added. 234: * @since 5.8.0 Added 'path' as an official value for $key. widgets/class-wp-widget-tag-cloud.php 65: * @since 3.0.0 Added taxonomy drop-down. 66: * @since 4.9.0 Added the `$instance` parameter. widgets/class-wp-widget-archives.php 69: * @since 4.9.0 Added the `$instance` parameter. 145: * @since 4.9.0 Added the `$instance` parameter. widgets/class-wp-widget-meta.php 82: * @since 4.9.0 Added the `$instance` parameter. widgets/class-wp-widget-media.php 266: * @since 5.9.0 Renamed `$instance` to `$old_instance` to match parent class widgets/class-wp-widget-recent-posts.php 66: * @since 4.9.0 Added the `$instance` parameter. widgets/class-wp-widget-links.php 73: * @since 4.4.0 Added the `$instance` parameter. widgets/class-wp-widget-pages.php 70: * @since 4.9.0 Added the `$instance` parameter. widgets/class-wp-widget-custom-html.php 243: * @since 4.9.0 The form contains only hidden sync inputs. For the control UI, see `WP_Widget_Custom_HTML::render_control_template_scripts()`. widgets/class-wp-widget-categories.php 38: * @since 4.2.0 Creates a unique HTML ID for the `<select>` element 84: * @since 4.9.0 Added the `$instance` parameter. 134: * @since 4.9.0 Added the `$instance` parameter. widgets/class-wp-widget-recent-comments.php 70: * @since 5.4.0 Creates a unique HTML ID for the `<ul>` element 102: * @since 4.9.0 Added the `$instance` parameter. widgets/class-wp-nav-menu-widget.php 97: * @since 4.4.0 Added the `$instance` parameter. widgets/class-wp-widget-text.php 276: * @since 4.4.0 Added the `$widget` parameter. 277: * @since 4.8.1 The `$widget` param may now be a `WP_Widget_Custom_HTML` object in addition to a `WP_Widget_Text` object. 446: * @since 4.8.0 Form only contains hidden inputs which are synced with JS template. 447: * @since 4.8.1 Restored original form to be displayed when in legacy mode. 525: * @since 4.9.0 The method is now static. rest-api/endpoints/class-wp-rest-posts-controller.php 437: * @since 5.7.0 Moved after the `tax_query` query arg is generated. 1632: * @since 4.9.0 Added the `$validate` parameter. 1831: * @since 5.9.0 Renamed `$post` to `$item` to match parent class for PHP 8 named parameter support. 2899: * @since 5.4.0 The `tax_relation` query parameter was added. 2900: * @since 5.7.0 The `modified_after` and `modified_before` query parameters were added. rest-api/endpoints/class-wp-rest-block-patterns-controller.php 99: * @since 6.2.0 Added migration for old core pattern categories to the new ones. 158: * @since 6.3.0 Added `source` property. 203: * @since 6.3.0 Added `source` property. rest-api/endpoints/class-wp-rest-post-types-controller.php 176: * @since 5.9.0 Renamed `$post_type` to `$item` to match parent class for PHP 8 named parameter support. 316: * @since 4.8.0 The `supports` property was added. 317: * @since 5.9.0 The `visibility` and `rest_namespace` properties were added. 318: * @since 6.1.0 The `icon` property was added. rest-api/endpoints/class-wp-rest-widget-types-controller.php 296: * @since 5.9.0 Renamed `$widget_type` to `$item` to match parent class for PHP 8 named parameter support. rest-api/endpoints/class-wp-rest-site-health-controller.php 46: * @since 6.1.0 Adds page-cache async test. rest-api/endpoints/class-wp-rest-post-statuses-controller.php 216: * @since 5.9.0 Renamed `$status` to `$item` to match parent class for PHP 8 named parameter support. rest-api/endpoints/class-wp-rest-global-styles-controller.php 233: * @since 6.2.0 Added validation of styles.css property. 234: * @since 6.6.0 Added registration of block style variations from theme.json sources (theme.json, user theme.json, partials). 298: * @since 6.6.0 Added custom relative theme file URIs to `_links`. 381: * @since 6.3.0 Adds revisions count and rest URL href to version-history. 415: * @since 6.2.0 Added 'edit-css' action. 416: * @since 6.6.0 Added $post and $request parameters. 512: * @since 6.7.0 Allow users with edit post capabilities to view theme global styles. 552: * @since 6.6.0 Added custom relative theme file URIs to `_links`. 606: * @since 6.7.0 Allow users with edit post capabilities to view theme global styles. 619: * @since 6.2.0 Returns parent theme variations, if they exist. 620: * @since 6.6.0 Added custom relative theme file URIs to `_links` for each item. 666: * @since 6.4.0 Changed method visibility to protected. rest-api/endpoints/class-wp-rest-themes-controller.php 226: * @since 5.9.0 Renamed `$theme` to `$item` to match parent class for PHP 8 named parameter support. 227: * @since 6.6.0 Added `stylesheet_uri` and `template_uri` fields. rest-api/endpoints/class-wp-rest-blocks-controller.php 43: * @since 6.3.0 Adds the `wp_pattern_sync_status` postmeta property to the top level of response. rest-api/endpoints/class-wp-rest-templates-controller.php 45: * @since 6.1.0 Endpoint for fallback template content. 155: * @since 6.3.0 Ignore empty templates. 239: * @since 6.6.0 Allow users with edit_posts capability to read templates. 301: * @since 6.6.0 Allow users with edit_posts capability to read individual templates. 668: * @since 5.9.0 Renamed `$template` to `$item` to match parent class for PHP 8 named parameter support. 669: * @since 6.3.0 Added `modified` property to the response. 1007: * @since 5.9.0 Added `'area'` and `'post_type'`. 1033: * @since 5.9.0 Added `'area'`. rest-api/endpoints/class-wp-rest-attachments-controller.php 844: * @since 5.9.0 Renamed `$post` to `$item` to match parent class for PHP 8 named parameter support. 1097: * @since 6.6.0 Added the `$time` parameter. 1310: * @since 6.6.0 Added the `$time` parameter. rest-api/endpoints/class-wp-rest-taxonomies-controller.php 207: * @since 5.9.0 Renamed `$taxonomy` to `$item` to match parent class for PHP 8 named parameter support. 327: * @since 5.0.0 The `visibility` property was added. 328: * @since 5.9.0 The `rest_namespace` property was added. rest-api/endpoints/class-wp-rest-pattern-directory-controller.php 83: * @since 6.0.0 Added 'slug' to request. 84: * @since 6.2.0 Added 'per_page', 'page', 'offset', 'order', and 'orderby' to request. 186: * @since 5.9.0 Renamed `$raw_pattern` to `$item` to match parent class for PHP 8 named parameter support. 227: * @since 6.2.0 Added `'block_types'` to schema. 308: * @since 6.2.0 Added 'per_page', 'page', 'offset', 'order', and 'orderby' to request. rest-api/endpoints/class-wp-rest-revisions-controller.php 404: * @since 6.5.0 Added a condition to check that parent id matches revision parent id. 575: * @since 5.9.0 Renamed `$post` to `$item` to match parent class for PHP 8 named parameter support. rest-api/endpoints/class-wp-rest-sidebars-controller.php 314: * @since 5.9.0 Renamed `$raw_sidebar` to `$item` to match parent class for PHP 8 named parameter support. rest-api/endpoints/class-wp-rest-search-controller.php 191: * @since 5.6.0 The `$id` parameter can accept a string. 192: * @since 5.9.0 Renamed `$id` to `$item` to match parent class for PHP 8 named parameter support. rest-api/endpoints/class-wp-rest-block-types-controller.php 246: * @since 5.9.0 Renamed `$block_type` to `$item` to match parent class for PHP 8 named parameter support. 247: * @since 6.3.0 Added `selectors` field. 248: * @since 6.5.0 Added `view_script_module_ids` field. 403: * @since 6.3.0 Added `selectors` field. rest-api/endpoints/class-wp-rest-block-directory-controller.php 112: * @since 5.9.0 Renamed `$plugin` to `$item` to match parent class for PHP 8 named parameter support. rest-api/endpoints/class-wp-rest-global-styles-revisions-controller.php 46: * @since 6.6.0 Extends class from WP_REST_Revisions_Controller. 69: * @since 6.6.0 Added route to fetch individual global styles revisions. 285: * @since 6.6.0 Added resolved URI links to the response. 368: * @since 6.6.0 Merged parent and parent controller schema data. rest-api/endpoints/class-wp-rest-users-controller.php 260: * @since 6.8.0 Added support for the search_columns query param. 1022: * @since 5.9.0 Renamed `$user` to `$item` to match parent class for PHP 8 named parameter support. rest-api/endpoints/class-wp-rest-terms-controller.php 230: * @since 6.8.0 Respect default query arguments set for the taxonomy upon registration. rest-api/endpoints/class-wp-rest-comments-controller.php 1044: * @since 5.9.0 Renamed `$comment` to `$item` to match parent class for PHP 8 named parameter support. rest-api/endpoints/class-wp-rest-autosaves-controller.php 360: * @since 6.4.0 The `$meta` parameter was added. 445: * @since 5.9.0 Renamed `$post` to `$item` to match parent class for PHP 8 named parameter support. rest-api/class-wp-rest-server.php 208: * @since 5.7.0 Converted to a wrapper of {@see rest_convert_error_to_response()}. 401: * @since 6.3.0 The `$request` parameter was added. 427: * @since 6.3.0 The `$request` parameter was added. 456: * @since 4.5.0 Applied to embedded responses. 481: * @since 6.3.2 Moved the block to catch the filter added on rest_cookie_check_errors() from wp-includes/rest-api.php. 577: * @since 5.4.0 The `$embed` parameter can now contain a list of link relations to include. 763: * @since 5.4.0 The `$embed` parameter can now contain a list of link relations to include. 854: * @since 6.0.0 The `$embed` parameter can now contain a list of link relations to include. 950: * @since 5.4.0 Added `$route_namespace` parameter. 1279: * @since 4.5.0 Added `$route` and `$handler` parameters. 1410: * @since 6.0.0 Added `$request` parameter. rest-api/class-wp-rest-request.php 682: * @since 4.7.0 Returns error instance if value cannot be decoded. rest-api/search/class-wp-rest-search-handler.php 82: * @since 5.6.0 The `$id` parameter can accept a string. 94: * @since 5.6.0 The `$id` parameter can accept a string. rest-api/fields/class-wp-rest-meta-fields.php 271: * @since 6.7.0 Stores values into DB even if provided registered default value. 371: * @since 6.7.0 Stores values into DB even if provided registered default value. style-engine/class-wp-style-engine-css-rule.php 51: * @since 6.6.0 Added the `$rules_group` parameter. 156: * @since 6.6.0 Added support for nested CSS with rules groups. style-engine/class-wp-style-engine-processor.php 61: * @since 6.6.0 Added support for rules_group. 106: * @since 6.4.0 The Optimization is no longer the default. style-engine/class-wp-style-engine.php 24: * @since 6.3.0 Added support for text-columns. 25: * @since 6.4.0 Added support for background.backgroundImage. 26: * @since 6.5.0 Added support for background.backgroundPosition, 28: * @since 6.7.0 Added support for typography.writingMode. 380: * @since 6.6.0 Added the `$rules_group` parameter. style-engine/class-wp-style-engine-css-rules-store.php 124: * @since 6.6.0 Added the $rules_group parameter. class-wp-user-query.php 133: * @since 4.1.0 Added the ability to order by the `include` value. 134: * @since 4.2.0 Added 'meta_value_num' support for `$orderby` parameter. Added multi-dimensional array syntax 136: * @since 4.3.0 Added 'has_published_posts' parameter. 137: * @since 4.4.0 Added 'paged', 'role__in', and 'role__not_in' parameters. The 'role' parameter was updated to 140: * @since 4.7.0 Added 'nicename', 'nicename__in', 'nicename__not_in', 'login', 'login__in', 142: * @since 5.1.0 Introduced the 'meta_compare_key' parameter. 143: * @since 5.3.0 Introduced the 'meta_type_key' parameter. 144: * @since 5.9.0 Added 'capability', 'capability__in', and 'capability__not_in' parameters. 146: * @since 6.3.0 Added 'cache_results' parameter. 852: * @since 5.1.0 Added the `$this` parameter. 1117: * @since 6.4.0 Getting a dynamic property is deprecated. 1140: * @since 6.4.0 Setting a dynamic property is deprecated. 1163: * @since 6.4.0 Checking a dynamic property is deprecated. 1186: * @since 6.4.0 Unsetting a dynamic property is deprecated. script-loader.php 333: * @since 6.4.0 Added relative time strings for the `wp-date` inline script output. 3160: * @since 6.1.0 Added the `$priority` parameter. 3374: * @since 6.2.0 Added File block styles. 3375: * @since 6.8.0 Moved stylesheet registration outside of this function. interactivity-api/interactivity-api.php 54: * @since 6.6.0 The namespace can be omitted when called inside derived state getters. interactivity-api/class-wp-interactivity-api.php 119: * @since 6.6.0 The `$store_namespace` param is optional. 570: * @since 6.6.0 The function now adds a warning when the namespace is null, falsy, or the directive value is empty. 571: * @since 6.6.0 Removed `default_namespace` and `context` arguments. 572: * @since 6.6.0 Add support for derived state. class-wp-image-editor-gd.php 455: * @since 5.9.0 Renamed `$filename` to `$destfilename` to match parent class 457: * @since 6.0.0 The `$filesize` value was added to the returned array. 485: * @since 6.0.0 The `$filesize` value was added to the returned array. 579: * @since 6.8.0 The `$dims` parameter was added. general-template.php 19: * @since 5.5.0 A return value was added. 20: * @since 5.5.0 The `$args` parameter was added. 32: * @since 2.8.0 The `$name` parameter was added. 33: * @since 5.5.0 The `$args` parameter was added. 63: * @since 5.5.0 A return value was added. 64: * @since 5.5.0 The `$args` parameter was added. 76: * @since 2.8.0 The `$name` parameter was added. 77: * @since 5.5.0 The `$args` parameter was added. 107: * @since 5.5.0 A return value was added. 108: * @since 5.5.0 The `$args` parameter was added. 120: * @since 2.8.0 The `$name` parameter was added. 121: * @since 5.5.0 The `$args` parameter was added. 158: * @since 5.5.0 A return value was added. 159: * @since 5.5.0 The `$args` parameter was added. 175: * @since 5.5.0 The `$args` parameter was added. 196: * @since 5.5.0 The `$args` parameter was added. 229: * @since 5.2.0 The `$args` array parameter was added in place of an `$echo` boolean flag. 247: * @since 5.5.0 The `$args` parameter was added. 297: * @since 5.5.0 The `$args` parameter was added. 353: * @since 5.5.0 The `$args` parameter was added. 461: * @since 4.2.0 The `$force_reauth` parameter was added. 494: * @since 6.6.0 Added `required_username` and `required_password` arguments. 1051: * @since 5.5.0 Added option to remove the link on the home page with `unlink-homepage-logo` theme support 1053: * @since 5.5.1 Disabled lazy-loading by default. 1147: * @since 4.6.0 Added the `$blog_id` parameter. 1303: * @since 4.4.0 Improved title output replaced `wp_title()`. 1709: * @since 5.5.0 The title part is wrapped in a `<span>` element. 1797: * @since 5.5.0 Added the `$prefix` and `$original_title` parameters. 1827: * @since 4.7.0 Added support for author archives. 1828: * @since 4.9.0 Added support for post type archives. 1912: * @since 5.2.0 Added the `$selected` parameter. 1942: * @since 4.5.0 Added the `$url`, `$text`, `$format`, `$before`, and `$after` parameters. 1943: * @since 5.2.0 Added the `$selected` parameter. 1960: * @since 4.4.0 The `$post_type` argument was added. 1961: * @since 5.2.0 The `$year`, `$monthnum`, `$day`, and `$w` arguments were added. 2236: * @since 6.8.0 Added the `$args` parameter, with backward compatibility 2576: * @since 6.8.0 Added the `$args` parameter. 2614: * @since 4.4.0 No longer used in core. 2770: * @since 4.6.0 Added the `$post` parameter. 2792: * @since 4.6.0 Added the `$post` parameter. 3014: * @since 4.6.0 Added the `$post` parameter. 3038: * @since 4.6.0 Added the `$post` parameter. 3628: * @since 4.7.0 The `$urls` parameter accepts arrays of specific HTML attributes 3741: * @since 6.6.0 Added the `$fetchpriority` attribute. 4525: * @since 4.3.0 Added the `$doctype` parameter. 4540: * @since 4.3.0 Converted into a wrapper for get_language_attributes(). 4595: * @since 4.9.0 Added the `aria_current` argument. customize/class-wp-customize-media-control.php 46: * @since 4.2.0 Moved from WP_Customize_Upload_Control. 66: * @since 4.2.0 Moved from WP_Customize_Upload_Control. 76: * @since 4.2.0 Moved from WP_Customize_Upload_Control. 128: * @since 4.2.0 Moved from WP_Customize_Upload_Control. 138: * @since 4.2.0 Moved from WP_Customize_Upload_Control. customize/class-wp-customize-nav-menu-item-setting.php 68: * @since 4.5.0 Default changed to 'refresh' 430: * @since 4.4.0 Added boolean return value. 655: * @since 5.9.0 Renamed `$menu_item_value` to `$value` for PHP 8 named parameter support. customize/class-wp-customize-nav-menu-setting.php 199: * @since 4.4.0 Added boolean return value customize/class-wp-customize-custom-css-setting.php 154: * @since 4.9.0 Checking for balanced characters has been moved client-side via linting in code editor. 155: * @since 5.9.0 Renamed `$css` to `$value` for PHP 8 named parameter support. 180: * @since 5.9.0 Renamed `$css` to `$value` for PHP 8 named parameter support. customize/class-wp-customize-nav-menu-location-control.php 53: * @since 4.9.0 Added a button to create menus. deprecated.php 4174: * @since 5.3.0 Echo `noindex,nofollow` if search engine visibility is discouraged. 4523: * @since 6.1.0 This function now always returns false. 4562: * @since 3.0.0 The `$post_type` parameter was added. 4997: * @since 5.9.0 Added alpha processing. 5176: * @since 6.1.0 Allow unset for preset colors. 5224: * @since 6.1.0 Allow unset for preset colors. 5730: * @since 6.2.0 Removed local() CSS. 6282: * @since 6.4.0 Added support for button and heading element styling. 6412: * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 6414: * @since 5.8.0 Wraps current_user_can() after switching to blog. 6432: * @since 6.2.0 Added File block styles. author-template.php 17: * @since 6.3.0 Returns an empty string if the author's display name is unknown. 184: * @since 4.3.0 The `$original_user_id` parameter was added. 342: * @since 4.4.0 Converted into a wrapper for get_the_author_posts_link() class-wp-http-ixr-client.php 51: * @since 5.5.0 Formalized the existing `...$args` parameter by adding it

I don't feel strongly, however. If you want to include it, that's fine with me.

I took it out.

From a developer looking to use the function

maybe more from a developer wanting to understand why the system changed 🤷‍♂️

…9052) Trac ticket: Core-63588 See WordPress#8999 Adds explanatory comment indicating why the optimization was added and guarding against accidental removal. This is a documentation-only change and should include no functional or visual changes.

audrasjb

The explanation in this docblock sounds clear to me 👍

I'm only wondering whether we should use {@see parse_blocks()} or add the full documentation link. This docblock won't be fetched by the docblock, parser as it is not a function or a hook, then providing the link is probably better than using a relative reference. What do you think @dmsnell?

…9052) Trac ticket: Core-63588 See WordPress#8999 Adds explanatory comment indicating why the optimization was added and guarding against accidental removal. This is a documentation-only change and should include no functional or visual changes.

dmsnell · 2025-06-26T17:03:57Z

@audrasjb I’m open to that, though I would need help with knowing what link you’re referring to. do you mean removing this inline link entirely and adding another PHPDoc token below on a line of its own, * @see parse_blocks()?

This docblock won't be fetched by the docblock, parser as it is not a function or a hook

Right, so I think this only affects an in-IDE experience, for which I was trying to optimize.

providing the link is probably better than using a relative reference

I don’t think I know what you are referring to with “relative reference”. I did some testing an indeed, were this docblock inside a class it would resolve to the class method of the same name. With namespaces it follows the module namespace.

I’ll wait for clarification, but in the meantime I’ve added a leading \ which should resolve all ambiguity in referencing the name.

dmsnell force-pushed the blocks/add-comment-about-do-blocks-optimization branch from 67c907e to 9b5c0c7 Compare June 23, 2025 17:54

dmsnell force-pushed the blocks/add-comment-about-do-blocks-optimization branch from 9b5c0c7 to 3547259 Compare June 23, 2025 18:08

westonruter reviewed Jun 24, 2025

View reviewed changes

dmsnell force-pushed the blocks/add-comment-about-do-blocks-optimization branch from 3547259 to a8a8fd1 Compare June 25, 2025 21:44

dmsnell force-pushed the blocks/add-comment-about-do-blocks-optimization branch from a8a8fd1 to 20546a0 Compare June 25, 2025 21:46

westonruter approved these changes Jun 25, 2025

View reviewed changes

dmsnell force-pushed the blocks/add-comment-about-do-blocks-optimization branch from 20546a0 to f36b8ee Compare June 25, 2025 21:57

audrasjb approved these changes Jun 26, 2025

View reviewed changes

dmsnell force-pushed the blocks/add-comment-about-do-blocks-optimization branch from f36b8ee to 9a32c1c Compare June 26, 2025 17:03

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

do_blocks(): Document transient-memory-leak optimization. #9052

do_blocks(): Document transient-memory-leak optimization. #9052

dmsnell commented Jun 23, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Jun 23, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Jun 23, 2025

Uh oh!

westonruter Jun 24, 2025

Uh oh!

dmsnell Jun 25, 2025

Uh oh!

westonruter Jun 24, 2025

Uh oh!

dmsnell Jun 25, 2025

Uh oh!

westonruter Jun 25, 2025

Uh oh!

dmsnell Jun 25, 2025

Uh oh!

audrasjb left a comment

Uh oh!

dmsnell commented Jun 26, 2025

Uh oh!

Uh oh!

	* is not possible with {@see parse_blocks} because it must parse the
	* is not possible with {@see parse_blocks()} because it must parse the

do_blocks(): Document transient-memory-leak optimization. #9052

Are you sure you want to change the base?

do_blocks(): Document transient-memory-leak optimization. #9052

Conversation

dmsnell commented Jun 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jun 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jun 23, 2025

Test using WordPress Playground

Some things to be aware of

Uh oh!

westonruter Jun 24, 2025

Choose a reason for hiding this comment

Uh oh!

dmsnell Jun 25, 2025

Choose a reason for hiding this comment

Uh oh!

westonruter Jun 24, 2025

Choose a reason for hiding this comment

Uh oh!

dmsnell Jun 25, 2025

Choose a reason for hiding this comment

Uh oh!

westonruter Jun 25, 2025

Choose a reason for hiding this comment

Uh oh!

dmsnell Jun 25, 2025

Choose a reason for hiding this comment

Uh oh!

audrasjb left a comment

Choose a reason for hiding this comment

Uh oh!

dmsnell commented Jun 26, 2025

Uh oh!

Uh oh!

dmsnell commented Jun 23, 2025 •

edited

Loading

github-actions bot commented Jun 23, 2025 •

edited

Loading