Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 44 additions & 5 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,42 @@

This document is automatically generated from the hooks extracted from WordPress and lists new actions, new filters, and parameter changes by version.

## WordPress 7.1

### New Actions

- [`wp_ability_invoked`](https://developer.wordpress.org/reference/hooks/wp_ability_invoked/) - Fires when an ability is invoked, before any processing takes place.

### New Filters

- [`is_user_member_of_blog`](https://developer.wordpress.org/reference/hooks/is_user_member_of_blog/) - Filters whether the user is a member of a given blog.
- [`login_remember_me_help_text`](https://developer.wordpress.org/reference/hooks/login_remember_me_help_text/) - Filters the help text shown in the "Remember Me" tooltip on the login form.
- [`rest_abilities_collection_params`](https://developer.wordpress.org/reference/hooks/rest_abilities_collection_params/) - Filters REST API collection parameters for the abilities controller.
- [`wp_ability_execute_result`](https://developer.wordpress.org/reference/hooks/wp_ability_execute_result/) - Filters the result returned by an ability's execute callback.
- [`wp_ability_normalize_input`](https://developer.wordpress.org/reference/hooks/wp_ability_normalize_input/) - Filters the normalized input for an ability.
- [`wp_ability_permission_result`](https://developer.wordpress.org/reference/hooks/wp_ability_permission_result/) - Filters the result of an ability's permission check.
- [`wp_ability_validate_input`](https://developer.wordpress.org/reference/hooks/wp_ability_validate_input/) - Filters the input validation result for an ability.
- [`wp_ability_validate_output`](https://developer.wordpress.org/reference/hooks/wp_ability_validate_output/) - Filters the output validation result for an ability.
- [`wp_ai_client_cache_group`](https://developer.wordpress.org/reference/hooks/wp_ai_client_cache_group/) - Filters the cache group used by the WP AI Client cache adapter.
- [`wp_auto_approve_ping`](https://developer.wordpress.org/reference/hooks/wp_auto_approve_ping/) - Filters whether a pingback is approved without being held for moderation.
- [`wp_client_side_media_processing_enabled`](https://developer.wordpress.org/reference/hooks/wp_client_side_media_processing_enabled/) - Filters whether client-side media processing is enabled.
- [`wp_get_abilities_item_include`](https://developer.wordpress.org/reference/hooks/wp_get_abilities_item_include/) - Filters whether an individual ability should be included in the result set.
- [`wp_get_abilities_result`](https://developer.wordpress.org/reference/hooks/wp_get_abilities_result/) - Filters the full list of matched abilities after all per-item filtering is complete.
- [`wp_get_entity_view_config_hook_name($kind, $name)`](https://developer.wordpress.org/reference/hooks/wp_get_entity_view_config_hook_name(kind, name)/) - Filters the view configuration for a given entity.
- [`wp_json_schema_allowed_keywords`](https://developer.wordpress.org/reference/hooks/wp_json_schema_allowed_keywords/) - Filters the JSON Schema keywords allowed for a given schema profile.
- [`wp_pre_execute_ability`](https://developer.wordpress.org/reference/hooks/wp_pre_execute_ability/) - Filters whether to short-circuit ability execution.
- [`wp_should_disable_pings_for_environment`](https://developer.wordpress.org/reference/hooks/wp_should_disable_pings_for_environment/) - Filters whether pings should be disabled for the current environment.

### Changes

- [`media_library_infinite_scrolling`](https://developer.wordpress.org/reference/hooks/media_library_infinite_scrolling/) - Changed default to <code>true</code> and introduced per-user opt-out of infinite scrolling.
- [`notify_post_author`](https://developer.wordpress.org/reference/hooks/notify_post_author/) - Comment approval status is checked before this filter, and the filter no longer fires for invalid comment IDs.
- [`pre_wp_filesize`](https://developer.wordpress.org/reference/hooks/pre_wp_filesize/) - Negative values are now ignored, being treated the same as null. Numeric values are cast to integers.
- [`safe_style_css`](https://developer.wordpress.org/reference/hooks/safe_style_css/) - Added support for SVG presentation attributes.
- [`wp_after_execute_ability`](https://developer.wordpress.org/reference/hooks/wp_after_execute_ability/) - Added the <code>$ability</code> parameter.
- [`wp_before_execute_ability`](https://developer.wordpress.org/reference/hooks/wp_before_execute_ability/) - Added the <code>$ability</code> parameter.
- [`wp_filesize`](https://developer.wordpress.org/reference/hooks/wp_filesize/) - The return value is now always zero or greater. Numeric values are cast to integers.

## WordPress 7.0

### New Actions
Expand All @@ -27,6 +63,7 @@ This document is automatically generated from the hooks extracted from WordPress

### Changes

- [`gallery_style`](https://developer.wordpress.org/reference/hooks/gallery_style/) - Removed the <code>type</code> attribute for any theme.
- [`load_script_textdomain_relative_path`](https://developer.wordpress.org/reference/hooks/load_script_textdomain_relative_path/) - The <code>$is_module</code> parameter was added.
- [`option_page_capability_{$option_page}`](https://developer.wordpress.org/reference/hooks/option_page_capability_option_page/) - Applied when <code>wp-admin/options.php</code> is accessed directly.
- [`the_author_posts_link`](https://developer.wordpress.org/reference/hooks/the_author_posts_link/) - Added <code>$author</code> and <code>$title</code> parameters.
Expand Down Expand Up @@ -477,7 +514,7 @@ _No new actions in this version._
- [`enable_loading_object_cache_dropin`](https://developer.wordpress.org/reference/hooks/enable_loading_object_cache_dropin/) - Filters whether to enable loading of the object-cache.php drop-in.
- [`excerpt_allowed_wrapper_blocks`](https://developer.wordpress.org/reference/hooks/excerpt_allowed_wrapper_blocks/) - Filters the list of blocks that can be used as wrapper blocks, allowing excerpts to be generated from the `innerBlocks` of these wrappers.
- [`image_editor_output_format`](https://developer.wordpress.org/reference/hooks/image_editor_output_format/) - Filters the image editor output format mapping.
- [`media_library_infinite_scrolling`](https://developer.wordpress.org/reference/hooks/media_library_infinite_scrolling/) - Filters whether the Media Library grid has infinite scrolling. Default `false`.
- [`media_library_infinite_scrolling`](https://developer.wordpress.org/reference/hooks/media_library_infinite_scrolling/) - Filters whether the Media Library grid has infinite scrolling. Default `true`.
- [`rest_pattern_directory_collection_params`](https://developer.wordpress.org/reference/hooks/rest_pattern_directory_collection_params/) - Filter collection parameters for the block pattern directory controller.
- [`rest_prepare_block_pattern`](https://developer.wordpress.org/reference/hooks/rest_prepare_block_pattern/) - Filters the REST API response for a block pattern.
- [`rest_prepare_sidebar`](https://developer.wordpress.org/reference/hooks/rest_prepare_sidebar/) - Filters the REST API response for a sidebar.
Expand Down Expand Up @@ -824,6 +861,7 @@ _No new actions in this version._

### Changes

- [`gallery_style`](https://developer.wordpress.org/reference/hooks/gallery_style/) - Removed the <code>type</code> attribute for <code>style</code> tags when the theme supports HTML5 style, and changed the quotes from single to double for other themes.
- [`intermediate_image_sizes_advanced`](https://developer.wordpress.org/reference/hooks/intermediate_image_sizes_advanced/) - Added the <code>$attachment_id</code> argument.
- [`mce_external_languages`](https://developer.wordpress.org/reference/hooks/mce_external_languages/) - The <code>$editor_id</code> parameter was added.
- [`mce_external_plugins`](https://developer.wordpress.org/reference/hooks/mce_external_plugins/) - The <code>$editor_id</code> parameter was added.
Expand Down Expand Up @@ -856,7 +894,7 @@ _No new actions in this version._
- [`oembed_iframe_title_attribute`](https://developer.wordpress.org/reference/hooks/oembed_iframe_title_attribute/) - Filters the title attribute of the given oEmbed HTML iframe.
- [`populate_site_meta`](https://developer.wordpress.org/reference/hooks/populate_site_meta/) - Filters meta for a site on creation.
- [`post_column_taxonomy_links`](https://developer.wordpress.org/reference/hooks/post_column_taxonomy_links/) - Filters the links in `$taxonomy` column of edit.php.
- [`recovery_email_support_info`](https://developer.wordpress.org/reference/hooks/recovery_email_support_info/) - Filters the support message sent with the the fatal error protection email.
- [`recovery_email_support_info`](https://developer.wordpress.org/reference/hooks/recovery_email_support_info/) - Filters the support message sent with the fatal error protection email.
- [`recovery_mode_begin_url`](https://developer.wordpress.org/reference/hooks/recovery_mode_begin_url/) - Filters the URL to begin recovery mode.
- [`recovery_mode_cookie_length`](https://developer.wordpress.org/reference/hooks/recovery_mode_cookie_length/) - Filters the length of time a Recovery Mode cookie is valid for.
- [`recovery_mode_email`](https://developer.wordpress.org/reference/hooks/recovery_mode_email/) - Filters the contents of the Recovery Mode email.
Expand Down Expand Up @@ -1484,7 +1522,7 @@ _No new actions in this version._
- [`nav_menu_item_title`](https://developer.wordpress.org/reference/hooks/nav_menu_item_title/) - Filters a menu item's title.
- [`navigation_markup_template`](https://developer.wordpress.org/reference/hooks/navigation_markup_template/) - Filters the navigation markup template.
- [`notify_moderator`](https://developer.wordpress.org/reference/hooks/notify_moderator/) - Filters whether to send the site moderator email notifications, overriding the site setting.
- [`notify_post_author`](https://developer.wordpress.org/reference/hooks/notify_post_author/) - Filters whether to send the post author new comment notification emails, overriding the site setting.
- [`notify_post_author`](https://developer.wordpress.org/reference/hooks/notify_post_author/) - Filters whether to send the post author new comment and note notification emails, overriding the site settings and defaults. By default, notifications are sent for all notes and for approved comments.
- [`oembed_default_width`](https://developer.wordpress.org/reference/hooks/oembed_default_width/) - Filters the maxwidth oEmbed parameter.
- [`oembed_discovery_links`](https://developer.wordpress.org/reference/hooks/oembed_discovery_links/) - Filters the oEmbed discovery links HTML.
- [`oembed_endpoint_url`](https://developer.wordpress.org/reference/hooks/oembed_endpoint_url/) - Filters the oEmbed endpoint URL.
Expand Down Expand Up @@ -1823,7 +1861,7 @@ _No new actions in this version._

### Changes

_No changes in this version._
- [`use_default_gallery_style`](https://developer.wordpress.org/reference/hooks/use_default_gallery_style/) - Set the default to false when the theme supports HTML5 galleries.

## WordPress 3.8

Expand Down Expand Up @@ -2314,6 +2352,7 @@ _No changes in this version._

### Changes

- [`gallery_style`](https://developer.wordpress.org/reference/hooks/gallery_style/) - Added classes for number of columns and size to opening div.
- [`upload_post_params`](https://developer.wordpress.org/reference/hooks/upload_post_params/) - As 'swfupload_post_params'

## WordPress 3.0
Expand Down Expand Up @@ -2987,7 +3026,7 @@ _No changes in this version._
- [`editor_max_image_size`](https://developer.wordpress.org/reference/hooks/editor_max_image_size/) - Filters the maximum image size dimensions for the editor.
- [`ext2type`](https://developer.wordpress.org/reference/hooks/ext2type/) - Filters file type based on the extension name.
- [`file_is_displayable_image`](https://developer.wordpress.org/reference/hooks/file_is_displayable_image/) - Filters whether the current image is displayable in the browser.
- [`gallery_style`](https://developer.wordpress.org/reference/hooks/gallery_style/) - Filters the default gallery shortcode CSS styles.
- [`gallery_style`](https://developer.wordpress.org/reference/hooks/gallery_style/) - Filters the gallery shortcode's default CSS styles and opening HTML div container.
- [`get_avatar`](https://developer.wordpress.org/reference/hooks/get_avatar/) - Filters the HTML for a user's avatar.
- [`get_pagenum_link`](https://developer.wordpress.org/reference/hooks/get_pagenum_link/) - Filters the page number link for the current request.
- [`get_the_generator_{$type}`](https://developer.wordpress.org/reference/hooks/get_the_generator_type/) - Filters the HTML for the retrieved generator type.
Expand Down
2 changes: 1 addition & 1 deletion ISSUES.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ This document lists known data quality issues in the hooks JSON files.

## Duplicate Filters

- `rest_block_hooks_post_types`
_No duplicate filters._

## Missing @since Tags

Expand Down
2 changes: 1 addition & 1 deletion composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@
"wp-hooks/generator": "1.0.0",
"oomphinc/composer-installers-extender": "^2",
"roots/wordpress-core-installer": "^1.0.0",
"roots/wordpress-full": "7.0"
"roots/wordpress-full": "7.1"
},
"extra": {
"wordpress-install-dir": "vendor/wordpress/wordpress",
Expand Down
71 changes: 69 additions & 2 deletions hooks/actions.json
Original file line number Diff line number Diff line change
Expand Up @@ -18056,6 +18056,47 @@
},
"args": 1
},
{
"name": "wp_ability_invoked",
"file": "wp-includes/abilities-api/class-wp-ability.php",
"type": "action",
"doc": {
"description": "Fires when an ability is invoked, before any processing takes place.",
"long_description": "This action fires for every call regardless of outcome (validation failure, permission denial, short-circuit, or successful execution), and before input normalization so the raw input is captured as-is.",
"tags": [
{
"name": "since",
"content": "7.1.0"
},
{
"name": "param",
"content": "The name of the ability.",
"types": [
"string"
],
"variable": "$ability_name"
},
{
"name": "param",
"content": "The raw input data for the ability, before normalization.",
"types": [
"mixed"
],
"variable": "$input"
},
{
"name": "param",
"content": "The ability instance.",
"types": [
"\\WP_Ability"
],
"variable": "$ability"
}
],
"long_description_html": "<p>This action fires for every call regardless of outcome (validation failure, permission denial, short-circuit, or successful execution), and before input normalization so the raw input is captured as-is.</p>"
},
"args": 3
},
{
"name": "wp_add_nav_menu_item",
"file": "wp-includes/nav-menu.php",
Expand Down Expand Up @@ -18164,6 +18205,11 @@
"name": "since",
"content": "6.9.0"
},
{
"name": "since",
"content": "7.1.0",
"description": "Added the <code>$ability</code> parameter."
},
{
"name": "param",
"content": "The name of the ability.",
Expand All @@ -18187,11 +18233,19 @@
"mixed"
],
"variable": "$result"
},
{
"name": "param",
"content": "The ability instance.",
"types": [
"\\WP_Ability"
],
"variable": "$ability"
}
],
"long_description_html": ""
},
"args": 3
"args": 4
},
{
"name": "wp_after_insert_post",
Expand Down Expand Up @@ -18619,6 +18673,11 @@
"name": "since",
"content": "6.9.0"
},
{
"name": "since",
"content": "7.1.0",
"description": "Added the <code>$ability</code> parameter."
},
{
"name": "param",
"content": "The name of the ability.",
Expand All @@ -18634,11 +18693,19 @@
"mixed"
],
"variable": "$input"
},
{
"name": "param",
"content": "The ability instance.",
"types": [
"\\WP_Ability"
],
"variable": "$ability"
}
],
"long_description_html": ""
},
"args": 2
"args": 3
},
{
"name": "wp_before_include_template",
Expand Down
Loading
Loading