[ Index ] |
PHP Cross Reference of WordPress Trunk (Updated Daily) |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Sets up the default filters and actions for most 4 * of the WordPress hooks. 5 * 6 * This file is loaded very early in the bootstrap which 7 * means many functions are not yet available and site 8 * information such as if this is multisite is unknown. 9 * Before using functions besides `add_filter` and 10 * `add_action`, verify things will work as expected. 11 * 12 * If you need to remove a default hook, this file will 13 * give you the priority to use for removing the hook. 14 * 15 * Not all of the default hooks are found in this file. 16 * For instance, administration-related hooks are located in 17 * wp-admin/includes/admin-filters.php. 18 * 19 * If a hook should only be called from a specific context 20 * (admin area, multisite environment…), please move it 21 * to a more appropriate file instead. 22 * 23 * @package WordPress 24 */ 25 26 // Strip, trim, kses, special chars for string saves. 27 foreach ( array( 'pre_term_name', 'pre_comment_author_name', 'pre_link_name', 'pre_link_target', 'pre_link_rel', 'pre_user_display_name', 'pre_user_first_name', 'pre_user_last_name', 'pre_user_nickname' ) as $filter ) { 28 add_filter( $filter, 'sanitize_text_field' ); 29 add_filter( $filter, 'wp_filter_kses' ); 30 add_filter( $filter, '_wp_specialchars', 30 ); 31 } 32 33 // Strip, kses, special chars for string display. 34 foreach ( array( 'term_name', 'comment_author_name', 'link_name', 'link_target', 'link_rel', 'user_display_name', 'user_first_name', 'user_last_name', 'user_nickname' ) as $filter ) { 35 if ( is_admin() ) { 36 // These are expensive. Run only on admin pages for defense in depth. 37 add_filter( $filter, 'sanitize_text_field' ); 38 add_filter( $filter, 'wp_kses_data' ); 39 } 40 add_filter( $filter, '_wp_specialchars', 30 ); 41 } 42 43 // Kses only for textarea saves. 44 foreach ( array( 'pre_term_description', 'pre_link_description', 'pre_link_notes', 'pre_user_description' ) as $filter ) { 45 add_filter( $filter, 'wp_filter_kses' ); 46 } 47 48 // Kses only for textarea admin displays. 49 if ( is_admin() ) { 50 foreach ( array( 'term_description', 'link_description', 'link_notes', 'user_description' ) as $filter ) { 51 add_filter( $filter, 'wp_kses_data' ); 52 } 53 add_filter( 'comment_text', 'wp_kses_post' ); 54 } 55 56 // Email saves. 57 foreach ( array( 'pre_comment_author_email', 'pre_user_email' ) as $filter ) { 58 add_filter( $filter, 'trim' ); 59 add_filter( $filter, 'sanitize_email' ); 60 add_filter( $filter, 'wp_filter_kses' ); 61 } 62 63 // Email admin display. 64 foreach ( array( 'comment_author_email', 'user_email' ) as $filter ) { 65 add_filter( $filter, 'sanitize_email' ); 66 if ( is_admin() ) { 67 add_filter( $filter, 'wp_kses_data' ); 68 } 69 } 70 71 // Save URL. 72 foreach ( array( 73 'pre_comment_author_url', 74 'pre_user_url', 75 'pre_link_url', 76 'pre_link_image', 77 'pre_link_rss', 78 'pre_post_guid', 79 ) as $filter ) { 80 add_filter( $filter, 'wp_strip_all_tags' ); 81 add_filter( $filter, 'sanitize_url' ); 82 add_filter( $filter, 'wp_filter_kses' ); 83 } 84 85 // Display URL. 86 foreach ( array( 'user_url', 'link_url', 'link_image', 'link_rss', 'comment_url', 'post_guid' ) as $filter ) { 87 if ( is_admin() ) { 88 add_filter( $filter, 'wp_strip_all_tags' ); 89 } 90 add_filter( $filter, 'esc_url' ); 91 if ( is_admin() ) { 92 add_filter( $filter, 'wp_kses_data' ); 93 } 94 } 95 96 // Slugs. 97 add_filter( 'pre_term_slug', 'sanitize_title' ); 98 add_filter( 'wp_insert_post_data', '_wp_customize_changeset_filter_insert_post_data', 10, 2 ); 99 100 // Keys. 101 foreach ( array( 'pre_post_type', 'pre_post_status', 'pre_post_comment_status', 'pre_post_ping_status' ) as $filter ) { 102 add_filter( $filter, 'sanitize_key' ); 103 } 104 105 // Mime types. 106 add_filter( 'pre_post_mime_type', 'sanitize_mime_type' ); 107 add_filter( 'post_mime_type', 'sanitize_mime_type' ); 108 109 // Meta. 110 add_filter( 'register_meta_args', '_wp_register_meta_args_allowed_list', 10, 2 ); 111 112 // Counts. 113 add_action( 'admin_init', 'wp_schedule_update_user_counts' ); 114 add_action( 'wp_update_user_counts', 'wp_schedule_update_user_counts', 10, 0 ); 115 foreach ( array( 'user_register', 'deleted_user' ) as $action ) { 116 add_action( $action, 'wp_maybe_update_user_counts', 10, 0 ); 117 } 118 119 // Post meta. 120 add_action( 'added_post_meta', 'wp_cache_set_posts_last_changed' ); 121 add_action( 'updated_post_meta', 'wp_cache_set_posts_last_changed' ); 122 add_action( 'deleted_post_meta', 'wp_cache_set_posts_last_changed' ); 123 124 // User meta. 125 add_action( 'added_user_meta', 'wp_cache_set_users_last_changed' ); 126 add_action( 'updated_user_meta', 'wp_cache_set_users_last_changed' ); 127 add_action( 'deleted_user_meta', 'wp_cache_set_users_last_changed' ); 128 add_action( 'add_user_role', 'wp_cache_set_users_last_changed' ); 129 add_action( 'set_user_role', 'wp_cache_set_users_last_changed' ); 130 add_action( 'remove_user_role', 'wp_cache_set_users_last_changed' ); 131 132 // Term meta. 133 add_action( 'added_term_meta', 'wp_cache_set_terms_last_changed' ); 134 add_action( 'updated_term_meta', 'wp_cache_set_terms_last_changed' ); 135 add_action( 'deleted_term_meta', 'wp_cache_set_terms_last_changed' ); 136 add_filter( 'get_term_metadata', 'wp_check_term_meta_support_prefilter' ); 137 add_filter( 'add_term_metadata', 'wp_check_term_meta_support_prefilter' ); 138 add_filter( 'update_term_metadata', 'wp_check_term_meta_support_prefilter' ); 139 add_filter( 'delete_term_metadata', 'wp_check_term_meta_support_prefilter' ); 140 add_filter( 'get_term_metadata_by_mid', 'wp_check_term_meta_support_prefilter' ); 141 add_filter( 'update_term_metadata_by_mid', 'wp_check_term_meta_support_prefilter' ); 142 add_filter( 'delete_term_metadata_by_mid', 'wp_check_term_meta_support_prefilter' ); 143 add_filter( 'update_term_metadata_cache', 'wp_check_term_meta_support_prefilter' ); 144 145 // Comment meta. 146 add_action( 'added_comment_meta', 'wp_cache_set_comments_last_changed' ); 147 add_action( 'updated_comment_meta', 'wp_cache_set_comments_last_changed' ); 148 add_action( 'deleted_comment_meta', 'wp_cache_set_comments_last_changed' ); 149 150 // Places to balance tags on input. 151 foreach ( array( 'content_save_pre', 'excerpt_save_pre', 'comment_save_pre', 'pre_comment_content' ) as $filter ) { 152 add_filter( $filter, 'convert_invalid_entities' ); 153 add_filter( $filter, 'balanceTags', 50 ); 154 } 155 156 // Format strings for display. 157 foreach ( array( 'comment_author', 'term_name', 'link_name', 'link_description', 'link_notes', 'bloginfo', 'wp_title', 'document_title', 'widget_title' ) as $filter ) { 158 add_filter( $filter, 'wptexturize' ); 159 add_filter( $filter, 'convert_chars' ); 160 add_filter( $filter, 'esc_html' ); 161 } 162 163 // Format WordPress. 164 foreach ( array( 'the_content', 'the_title', 'wp_title', 'document_title' ) as $filter ) { 165 add_filter( $filter, 'capital_P_dangit', 11 ); 166 } 167 add_filter( 'comment_text', 'capital_P_dangit', 31 ); 168 169 // Format titles. 170 foreach ( array( 'single_post_title', 'single_cat_title', 'single_tag_title', 'single_month_title', 'nav_menu_attr_title', 'nav_menu_description' ) as $filter ) { 171 add_filter( $filter, 'wptexturize' ); 172 add_filter( $filter, 'strip_tags' ); 173 } 174 175 // Format text area for display. 176 foreach ( array( 'term_description', 'get_the_post_type_description' ) as $filter ) { 177 add_filter( $filter, 'wptexturize' ); 178 add_filter( $filter, 'convert_chars' ); 179 add_filter( $filter, 'wpautop' ); 180 add_filter( $filter, 'shortcode_unautop' ); 181 } 182 183 // Format for RSS. 184 add_filter( 'term_name_rss', 'convert_chars' ); 185 186 // Pre save hierarchy. 187 add_filter( 'wp_insert_post_parent', 'wp_check_post_hierarchy_for_loops', 10, 2 ); 188 add_filter( 'wp_update_term_parent', 'wp_check_term_hierarchy_for_loops', 10, 3 ); 189 190 // Display filters. 191 add_filter( 'the_title', 'wptexturize' ); 192 add_filter( 'the_title', 'convert_chars' ); 193 add_filter( 'the_title', 'trim' ); 194 195 add_filter( 'the_content', 'apply_block_hooks_to_content', 8 ); // BEFORE do_blocks(). 196 add_filter( 'the_content', 'do_blocks', 9 ); 197 add_filter( 'the_content', 'wptexturize' ); 198 add_filter( 'the_content', 'convert_smilies', 20 ); 199 add_filter( 'the_content', 'wpautop' ); 200 add_filter( 'the_content', 'shortcode_unautop' ); 201 add_filter( 'the_content', 'prepend_attachment' ); 202 add_filter( 'the_content', 'wp_replace_insecure_home_url' ); 203 add_filter( 'the_content', 'do_shortcode', 11 ); // AFTER wpautop(). 204 add_filter( 'the_content', 'wp_filter_content_tags', 12 ); // Runs after do_shortcode(). 205 206 add_filter( 'the_excerpt', 'wptexturize' ); 207 add_filter( 'the_excerpt', 'convert_smilies' ); 208 add_filter( 'the_excerpt', 'convert_chars' ); 209 add_filter( 'the_excerpt', 'wpautop' ); 210 add_filter( 'the_excerpt', 'shortcode_unautop' ); 211 add_filter( 'the_excerpt', 'wp_replace_insecure_home_url' ); 212 add_filter( 'the_excerpt', 'wp_filter_content_tags', 12 ); 213 add_filter( 'get_the_excerpt', 'wp_trim_excerpt', 10, 2 ); 214 215 add_filter( 'the_post_thumbnail_caption', 'wptexturize' ); 216 add_filter( 'the_post_thumbnail_caption', 'convert_smilies' ); 217 add_filter( 'the_post_thumbnail_caption', 'convert_chars' ); 218 219 add_filter( 'comment_text', 'wptexturize' ); 220 add_filter( 'comment_text', 'convert_chars' ); 221 add_filter( 'comment_text', 'make_clickable', 9 ); 222 add_filter( 'comment_text', 'force_balance_tags', 25 ); 223 add_filter( 'comment_text', 'convert_smilies', 20 ); 224 add_filter( 'comment_text', 'wpautop', 30 ); 225 226 add_filter( 'comment_excerpt', 'convert_chars' ); 227 228 add_filter( 'list_cats', 'wptexturize' ); 229 230 add_filter( 'wp_sprintf', 'wp_sprintf_l', 10, 2 ); 231 232 add_filter( 'widget_text', 'balanceTags' ); 233 add_filter( 'widget_text_content', 'capital_P_dangit', 11 ); 234 add_filter( 'widget_text_content', 'wptexturize' ); 235 add_filter( 'widget_text_content', 'convert_smilies', 20 ); 236 add_filter( 'widget_text_content', 'wpautop' ); 237 add_filter( 'widget_text_content', 'shortcode_unautop' ); 238 add_filter( 'widget_text_content', 'wp_replace_insecure_home_url' ); 239 add_filter( 'widget_text_content', 'do_shortcode', 11 ); // Runs after wpautop(); note that $post global will be null when shortcodes run. 240 add_filter( 'widget_text_content', 'wp_filter_content_tags', 12 ); // Runs after do_shortcode(). 241 242 add_filter( 'widget_block_content', 'do_blocks', 9 ); 243 add_filter( 'widget_block_content', 'do_shortcode', 11 ); 244 add_filter( 'widget_block_content', 'wp_filter_content_tags', 12 ); // Runs after do_shortcode(). 245 246 add_filter( 'block_type_metadata', 'wp_migrate_old_typography_shape' ); 247 248 add_filter( 'wp_get_custom_css', 'wp_replace_insecure_home_url' ); 249 250 // RSS filters. 251 add_filter( 'the_title_rss', 'strip_tags' ); 252 add_filter( 'the_title_rss', 'ent2ncr', 8 ); 253 add_filter( 'the_title_rss', 'esc_html' ); 254 add_filter( 'the_content_rss', 'ent2ncr', 8 ); 255 add_filter( 'the_content_feed', 'wp_staticize_emoji' ); 256 add_filter( 'the_content_feed', '_oembed_filter_feed_content' ); 257 add_filter( 'the_excerpt_rss', 'convert_chars' ); 258 add_filter( 'the_excerpt_rss', 'ent2ncr', 8 ); 259 add_filter( 'comment_author_rss', 'ent2ncr', 8 ); 260 add_filter( 'comment_text_rss', 'ent2ncr', 8 ); 261 add_filter( 'comment_text_rss', 'esc_html' ); 262 add_filter( 'comment_text_rss', 'wp_staticize_emoji' ); 263 add_filter( 'bloginfo_rss', 'ent2ncr', 8 ); 264 add_filter( 'the_author', 'ent2ncr', 8 ); 265 add_filter( 'the_guid', 'esc_url' ); 266 267 // Email filters. 268 add_filter( 'wp_mail', 'wp_staticize_emoji_for_email' ); 269 270 // Robots filters. 271 add_filter( 'wp_robots', 'wp_robots_noindex' ); 272 add_filter( 'wp_robots', 'wp_robots_noindex_embeds' ); 273 add_filter( 'wp_robots', 'wp_robots_noindex_search' ); 274 add_filter( 'wp_robots', 'wp_robots_max_image_preview_large' ); 275 276 // Mark site as no longer fresh. 277 foreach ( 278 array( 279 'publish_post', 280 'publish_page', 281 'wp_ajax_save-widget', 282 'wp_ajax_widgets-order', 283 'customize_save_after', 284 'rest_after_save_widget', 285 'rest_delete_widget', 286 'rest_save_sidebar', 287 ) as $action 288 ) { 289 add_action( $action, '_delete_option_fresh_site', 0 ); 290 } 291 292 // Misc filters. 293 add_filter( 'wp_default_autoload_value', 'wp_filter_default_autoload_value_via_option_size', 5, 4 ); // Allow the value to be overridden at the default priority. 294 add_filter( 'option_ping_sites', 'privacy_ping_filter' ); 295 add_filter( 'option_blog_charset', '_wp_specialchars' ); // IMPORTANT: This must not be wp_specialchars() or esc_html() or it'll cause an infinite loop. 296 add_filter( 'option_blog_charset', '_canonical_charset' ); 297 add_filter( 'option_home', '_config_wp_home' ); 298 add_filter( 'option_siteurl', '_config_wp_siteurl' ); 299 add_filter( 'tiny_mce_before_init', '_mce_set_direction' ); 300 add_filter( 'teeny_mce_before_init', '_mce_set_direction' ); 301 add_filter( 'pre_kses', 'wp_pre_kses_less_than' ); 302 add_filter( 'pre_kses', 'wp_pre_kses_block_attributes', 10, 3 ); 303 add_filter( 'sanitize_title', 'sanitize_title_with_dashes', 10, 3 ); 304 add_action( 'check_comment_flood', 'check_comment_flood_db', 10, 4 ); 305 add_filter( 'comment_flood_filter', 'wp_throttle_comment_flood', 10, 3 ); 306 add_filter( 'pre_comment_content', 'wp_rel_ugc', 15 ); 307 add_filter( 'comment_email', 'antispambot' ); 308 add_filter( 'option_tag_base', '_wp_filter_taxonomy_base' ); 309 add_filter( 'option_category_base', '_wp_filter_taxonomy_base' ); 310 add_filter( 'the_posts', '_close_comments_for_old_posts', 10, 2 ); 311 add_filter( 'comments_open', '_close_comments_for_old_post', 10, 2 ); 312 add_filter( 'pings_open', '_close_comments_for_old_post', 10, 2 ); 313 add_filter( 'editable_slug', 'urldecode' ); 314 add_filter( 'editable_slug', 'esc_textarea' ); 315 add_filter( 'pingback_ping_source_uri', 'pingback_ping_source_uri' ); 316 add_filter( 'xmlrpc_pingback_error', 'xmlrpc_pingback_error' ); 317 add_filter( 'title_save_pre', 'trim' ); 318 319 add_action( 'transition_comment_status', '_clear_modified_cache_on_transition_comment_status', 10, 2 ); 320 321 add_filter( 'http_request_host_is_external', 'allowed_http_request_hosts', 10, 2 ); 322 323 // REST API filters. 324 add_action( 'xmlrpc_rsd_apis', 'rest_output_rsd' ); 325 add_action( 'wp_head', 'rest_output_link_wp_head', 10, 0 ); 326 add_action( 'template_redirect', 'rest_output_link_header', 11, 0 ); 327 add_action( 'auth_cookie_malformed', 'rest_cookie_collect_status' ); 328 add_action( 'auth_cookie_expired', 'rest_cookie_collect_status' ); 329 add_action( 'auth_cookie_bad_username', 'rest_cookie_collect_status' ); 330 add_action( 'auth_cookie_bad_hash', 'rest_cookie_collect_status' ); 331 add_action( 'auth_cookie_valid', 'rest_cookie_collect_status' ); 332 add_action( 'application_password_failed_authentication', 'rest_application_password_collect_status' ); 333 add_action( 'application_password_did_authenticate', 'rest_application_password_collect_status', 10, 2 ); 334 add_filter( 'rest_authentication_errors', 'rest_application_password_check_errors', 90 ); 335 add_filter( 'rest_authentication_errors', 'rest_cookie_check_errors', 100 ); 336 337 // Actions. 338 add_action( 'wp_head', '_wp_render_title_tag', 1 ); 339 add_action( 'wp_head', 'wp_enqueue_scripts', 1 ); 340 add_action( 'wp_head', 'wp_resource_hints', 2 ); 341 add_action( 'wp_head', 'wp_preload_resources', 1 ); 342 add_action( 'wp_head', 'feed_links', 2 ); 343 add_action( 'wp_head', 'feed_links_extra', 3 ); 344 add_action( 'wp_head', 'rsd_link' ); 345 add_action( 'wp_head', 'locale_stylesheet' ); 346 add_action( 'publish_future_post', 'check_and_publish_future_post', 10, 1 ); 347 add_action( 'wp_head', 'wp_robots', 1 ); 348 add_action( 'wp_head', 'print_emoji_detection_script', 7 ); 349 add_action( 'wp_head', 'wp_print_styles', 8 ); 350 add_action( 'wp_head', 'wp_print_head_scripts', 9 ); 351 add_action( 'wp_head', 'wp_generator' ); 352 add_action( 'wp_head', 'rel_canonical' ); 353 add_action( 'wp_head', 'wp_shortlink_wp_head', 10, 0 ); 354 add_action( 'wp_head', 'wp_custom_css_cb', 101 ); 355 add_action( 'wp_head', 'wp_site_icon', 99 ); 356 add_action( 'wp_footer', 'wp_print_footer_scripts', 20 ); 357 add_action( 'template_redirect', 'wp_shortlink_header', 11, 0 ); 358 add_action( 'wp_print_footer_scripts', '_wp_footer_scripts' ); 359 add_action( 'init', '_register_core_block_patterns_and_categories' ); 360 add_action( 'init', 'check_theme_switched', 99 ); 361 add_action( 'init', array( 'WP_Block_Supports', 'init' ), 22 ); 362 add_action( 'switch_theme', 'wp_clean_theme_json_cache' ); 363 add_action( 'start_previewing_theme', 'wp_clean_theme_json_cache' ); 364 add_action( 'after_switch_theme', '_wp_menus_changed' ); 365 add_action( 'after_switch_theme', '_wp_sidebars_changed' ); 366 add_action( 'wp_enqueue_scripts', 'wp_enqueue_emoji_styles' ); 367 add_action( 'wp_print_styles', 'print_emoji_styles' ); // Retained for backwards-compatibility. Unhooked by wp_enqueue_emoji_styles(). 368 369 if ( isset( $_GET['replytocom'] ) ) { 370 add_filter( 'wp_robots', 'wp_robots_no_robots' ); 371 } 372 373 // Login actions. 374 add_action( 'login_head', 'wp_robots', 1 ); 375 add_filter( 'login_head', 'wp_resource_hints', 8 ); 376 add_action( 'login_head', 'wp_print_head_scripts', 9 ); 377 add_action( 'login_head', 'print_admin_styles', 9 ); 378 add_action( 'login_head', 'wp_site_icon', 99 ); 379 add_action( 'login_footer', 'wp_print_footer_scripts', 20 ); 380 add_action( 'login_init', 'send_frame_options_header', 10, 0 ); 381 382 // Feed generator tags. 383 foreach ( array( 'rss2_head', 'commentsrss2_head', 'rss_head', 'rdf_header', 'atom_head', 'comments_atom_head', 'opml_head', 'app_head' ) as $action ) { 384 add_action( $action, 'the_generator' ); 385 } 386 387 // Feed Site Icon. 388 add_action( 'atom_head', 'atom_site_icon' ); 389 add_action( 'rss2_head', 'rss2_site_icon' ); 390 391 392 // WP Cron. 393 if ( ! defined( 'DOING_CRON' ) ) { 394 add_action( 'init', 'wp_cron' ); 395 } 396 397 // HTTPS migration. 398 add_action( 'update_option_home', 'wp_update_https_migration_required', 10, 2 ); 399 400 // 2 Actions 2 Furious. 401 add_action( 'do_feed_rdf', 'do_feed_rdf', 10, 0 ); 402 add_action( 'do_feed_rss', 'do_feed_rss', 10, 0 ); 403 add_action( 'do_feed_rss2', 'do_feed_rss2', 10, 1 ); 404 add_action( 'do_feed_atom', 'do_feed_atom', 10, 1 ); 405 add_action( 'do_pings', 'do_all_pings', 10, 0 ); 406 add_action( 'do_all_pings', 'do_all_pingbacks', 10, 0 ); 407 add_action( 'do_all_pings', 'do_all_enclosures', 10, 0 ); 408 add_action( 'do_all_pings', 'do_all_trackbacks', 10, 0 ); 409 add_action( 'do_all_pings', 'generic_ping', 10, 0 ); 410 add_action( 'do_robots', 'do_robots' ); 411 add_action( 'do_favicon', 'do_favicon' ); 412 add_action( 'set_comment_cookies', 'wp_set_comment_cookies', 10, 3 ); 413 add_action( 'sanitize_comment_cookies', 'sanitize_comment_cookies' ); 414 add_action( 'init', 'smilies_init', 5 ); 415 add_action( 'plugins_loaded', 'wp_maybe_load_widgets', 0 ); 416 add_action( 'plugins_loaded', 'wp_maybe_load_embeds', 0 ); 417 add_action( 'shutdown', 'wp_ob_end_flush_all', 1 ); 418 // Create a revision whenever a post is updated. 419 add_action( 'wp_after_insert_post', 'wp_save_post_revision_on_insert', 9, 3 ); 420 add_action( 'post_updated', 'wp_save_post_revision', 10, 1 ); 421 add_action( 'publish_post', '_publish_post_hook', 5, 1 ); 422 add_action( 'transition_post_status', '_transition_post_status', 5, 3 ); 423 add_action( 'transition_post_status', '_update_term_count_on_transition_post_status', 10, 3 ); 424 add_action( 'comment_form', 'wp_comment_form_unfiltered_html_nonce' ); 425 426 // Privacy. 427 add_action( 'user_request_action_confirmed', '_wp_privacy_account_request_confirmed' ); 428 add_action( 'user_request_action_confirmed', '_wp_privacy_send_request_confirmation_notification', 12 ); // After request marked as completed. 429 add_filter( 'wp_privacy_personal_data_exporters', 'wp_register_comment_personal_data_exporter' ); 430 add_filter( 'wp_privacy_personal_data_exporters', 'wp_register_media_personal_data_exporter' ); 431 add_filter( 'wp_privacy_personal_data_exporters', 'wp_register_user_personal_data_exporter', 1 ); 432 add_filter( 'wp_privacy_personal_data_erasers', 'wp_register_comment_personal_data_eraser' ); 433 add_action( 'init', 'wp_schedule_delete_old_privacy_export_files' ); 434 add_action( 'wp_privacy_delete_old_export_files', 'wp_privacy_delete_old_export_files' ); 435 436 // Cron tasks. 437 add_action( 'wp_scheduled_delete', 'wp_scheduled_delete' ); 438 add_action( 'wp_scheduled_auto_draft_delete', 'wp_delete_auto_drafts' ); 439 add_action( 'importer_scheduled_cleanup', 'wp_delete_attachment' ); 440 add_action( 'upgrader_scheduled_cleanup', 'wp_delete_attachment' ); 441 add_action( 'delete_expired_transients', 'delete_expired_transients' ); 442 443 // Navigation menu actions. 444 add_action( 'delete_post', '_wp_delete_post_menu_item' ); 445 add_action( 'delete_term', '_wp_delete_tax_menu_item', 10, 3 ); 446 add_action( 'transition_post_status', '_wp_auto_add_pages_to_menu', 10, 3 ); 447 add_action( 'delete_post', '_wp_delete_customize_changeset_dependent_auto_drafts' ); 448 449 // Post Thumbnail specific image filtering. 450 add_action( 'begin_fetch_post_thumbnail_html', '_wp_post_thumbnail_class_filter_add' ); 451 add_action( 'end_fetch_post_thumbnail_html', '_wp_post_thumbnail_class_filter_remove' ); 452 add_action( 'begin_fetch_post_thumbnail_html', '_wp_post_thumbnail_context_filter_add' ); 453 add_action( 'end_fetch_post_thumbnail_html', '_wp_post_thumbnail_context_filter_remove' ); 454 455 // Redirect old slugs. 456 add_action( 'template_redirect', 'wp_old_slug_redirect' ); 457 add_action( 'post_updated', 'wp_check_for_changed_slugs', 12, 3 ); 458 add_action( 'attachment_updated', 'wp_check_for_changed_slugs', 12, 3 ); 459 460 // Redirect old dates. 461 add_action( 'post_updated', 'wp_check_for_changed_dates', 12, 3 ); 462 add_action( 'attachment_updated', 'wp_check_for_changed_dates', 12, 3 ); 463 464 // Nonce check for post previews. 465 add_action( 'init', '_show_post_preview' ); 466 467 // Output JS to reset window.name for previews. 468 add_action( 'wp_head', 'wp_post_preview_js', 1 ); 469 470 // Timezone. 471 add_filter( 'pre_option_gmt_offset', 'wp_timezone_override_offset' ); 472 473 // If the upgrade hasn't run yet, assume link manager is used. 474 add_filter( 'default_option_link_manager_enabled', '__return_true' ); 475 476 // This option no longer exists; tell plugins we always support auto-embedding. 477 add_filter( 'pre_option_embed_autourls', '__return_true' ); 478 479 // Default settings for heartbeat. 480 add_filter( 'heartbeat_settings', 'wp_heartbeat_settings' ); 481 482 // Check if the user is logged out. 483 add_action( 'admin_enqueue_scripts', 'wp_auth_check_load' ); 484 add_filter( 'heartbeat_send', 'wp_auth_check' ); 485 add_filter( 'heartbeat_nopriv_send', 'wp_auth_check' ); 486 487 // Default authentication filters. 488 add_filter( 'authenticate', 'wp_authenticate_username_password', 20, 3 ); 489 add_filter( 'authenticate', 'wp_authenticate_email_password', 20, 3 ); 490 add_filter( 'authenticate', 'wp_authenticate_application_password', 20, 3 ); 491 add_filter( 'authenticate', 'wp_authenticate_spam_check', 99 ); 492 add_filter( 'determine_current_user', 'wp_validate_auth_cookie' ); 493 add_filter( 'determine_current_user', 'wp_validate_logged_in_cookie', 20 ); 494 add_filter( 'determine_current_user', 'wp_validate_application_password', 20 ); 495 496 // Split term updates. 497 add_action( 'admin_init', '_wp_check_for_scheduled_split_terms' ); 498 add_action( 'split_shared_term', '_wp_check_split_default_terms', 10, 4 ); 499 add_action( 'split_shared_term', '_wp_check_split_terms_in_menus', 10, 4 ); 500 add_action( 'split_shared_term', '_wp_check_split_nav_menu_terms', 10, 4 ); 501 add_action( 'wp_split_shared_term_batch', '_wp_batch_split_terms' ); 502 503 // Comment type updates. 504 add_action( 'admin_init', '_wp_check_for_scheduled_update_comment_type' ); 505 add_action( 'wp_update_comment_type_batch', '_wp_batch_update_comment_type' ); 506 507 // Email notifications. 508 add_action( 'comment_post', 'wp_new_comment_notify_moderator' ); 509 add_action( 'comment_post', 'wp_new_comment_notify_postauthor' ); 510 add_action( 'after_password_reset', 'wp_password_change_notification' ); 511 add_action( 'register_new_user', 'wp_send_new_user_notifications' ); 512 add_action( 'edit_user_created_user', 'wp_send_new_user_notifications', 10, 2 ); 513 514 // REST API actions. 515 add_action( 'init', 'rest_api_init' ); 516 add_action( 'rest_api_init', 'rest_api_default_filters', 10, 1 ); 517 add_action( 'rest_api_init', 'register_initial_settings', 10 ); 518 add_action( 'rest_api_init', 'create_initial_rest_routes', 99 ); 519 add_action( 'parse_request', 'rest_api_loaded' ); 520 521 // Sitemaps actions. 522 add_action( 'init', 'wp_sitemaps_get_server' ); 523 524 /** 525 * Filters formerly mixed into wp-includes. 526 */ 527 // Theme. 528 add_action( 'setup_theme', 'create_initial_theme_features', 0 ); 529 add_action( 'after_setup_theme', '_add_default_theme_supports', 1 ); 530 add_action( 'wp_loaded', '_custom_header_background_just_in_time' ); 531 add_action( 'wp_head', '_custom_logo_header_styles' ); 532 add_action( 'plugins_loaded', '_wp_customize_include' ); 533 add_action( 'transition_post_status', '_wp_customize_publish_changeset', 10, 3 ); 534 add_action( 'admin_enqueue_scripts', '_wp_customize_loader_settings' ); 535 add_action( 'delete_attachment', '_delete_attachment_theme_mod' ); 536 add_action( 'transition_post_status', '_wp_keep_alive_customize_changeset_dependent_auto_drafts', 20, 3 ); 537 538 // Block Theme Previews. 539 add_action( 'plugins_loaded', 'wp_initialize_theme_preview_hooks', 1 ); 540 541 // Calendar widget cache. 542 add_action( 'save_post', 'delete_get_calendar_cache' ); 543 add_action( 'delete_post', 'delete_get_calendar_cache' ); 544 add_action( 'update_option_start_of_week', 'delete_get_calendar_cache' ); 545 add_action( 'update_option_gmt_offset', 'delete_get_calendar_cache' ); 546 547 // Author. 548 add_action( 'transition_post_status', '__clear_multi_author_cache' ); 549 550 // Post. 551 add_action( 'init', 'create_initial_post_types', 0 ); // Highest priority. 552 add_action( 'admin_menu', '_add_post_type_submenus' ); 553 add_action( 'before_delete_post', '_reset_front_page_settings_for_post' ); 554 add_action( 'wp_trash_post', '_reset_front_page_settings_for_post' ); 555 add_action( 'change_locale', 'create_initial_post_types' ); 556 557 // Post Formats. 558 add_filter( 'request', '_post_format_request' ); 559 add_filter( 'term_link', '_post_format_link', 10, 3 ); 560 add_filter( 'get_post_format', '_post_format_get_term' ); 561 add_filter( 'get_terms', '_post_format_get_terms', 10, 3 ); 562 add_filter( 'wp_get_object_terms', '_post_format_wp_get_object_terms' ); 563 564 // KSES. 565 add_action( 'init', 'kses_init' ); 566 add_action( 'set_current_user', 'kses_init' ); 567 568 // Script Loader. 569 add_action( 'wp_default_scripts', 'wp_default_scripts' ); 570 add_action( 'wp_default_scripts', 'wp_default_packages' ); 571 add_action( 'wp_default_scripts', 'wp_default_script_modules' ); 572 573 add_action( 'wp_enqueue_scripts', 'wp_localize_jquery_ui_datepicker', 1000 ); 574 add_action( 'wp_enqueue_scripts', 'wp_common_block_scripts_and_styles' ); 575 add_action( 'wp_enqueue_scripts', 'wp_enqueue_classic_theme_styles' ); 576 add_action( 'admin_enqueue_scripts', 'wp_localize_jquery_ui_datepicker', 1000 ); 577 add_action( 'admin_enqueue_scripts', 'wp_common_block_scripts_and_styles' ); 578 add_action( 'enqueue_block_assets', 'wp_enqueue_registered_block_scripts_and_styles' ); 579 add_action( 'enqueue_block_assets', 'enqueue_block_styles_assets', 30 ); 580 /* 581 * `wp_enqueue_registered_block_scripts_and_styles` is bound to both 582 * `enqueue_block_editor_assets` and `enqueue_block_assets` hooks 583 * since the introduction of the block editor in WordPress 5.0. 584 * 585 * The way this works is that the block assets are loaded before any other assets. 586 * For example, this is the order of styles for the editor: 587 * 588 * - front styles registered for blocks, via `styles` handle (block.json) 589 * - editor styles registered for blocks, via `editorStyles` handle (block.json) 590 * - editor styles enqueued via `enqueue_block_editor_assets` hook 591 * - front styles enqueued via `enqueue_block_assets` hook 592 */ 593 add_action( 'enqueue_block_editor_assets', 'wp_enqueue_registered_block_scripts_and_styles' ); 594 add_action( 'enqueue_block_editor_assets', 'enqueue_editor_block_styles_assets' ); 595 add_action( 'enqueue_block_editor_assets', 'wp_enqueue_editor_block_directory_assets' ); 596 add_action( 'enqueue_block_editor_assets', 'wp_enqueue_editor_format_library_assets' ); 597 add_action( 'enqueue_block_editor_assets', 'wp_enqueue_global_styles_css_custom_properties' ); 598 add_action( 'wp_print_scripts', 'wp_just_in_time_script_localization' ); 599 add_filter( 'print_scripts_array', 'wp_prototype_before_jquery' ); 600 add_action( 'customize_controls_print_styles', 'wp_resource_hints', 1 ); 601 add_action( 'admin_head', 'wp_check_widget_editor_deps' ); 602 add_filter( 'block_editor_settings_all', 'wp_add_editor_classic_theme_styles' ); 603 604 // Global styles can be enqueued in both the header and the footer. See https://core.trac.wordpress.org/ticket/53494. 605 add_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' ); 606 add_action( 'wp_footer', 'wp_enqueue_global_styles', 1 ); 607 608 // Block supports, and other styles parsed and stored in the Style Engine. 609 add_action( 'wp_enqueue_scripts', 'wp_enqueue_stored_styles' ); 610 add_action( 'wp_footer', 'wp_enqueue_stored_styles', 1 ); 611 612 add_action( 'wp_default_styles', 'wp_default_styles' ); 613 add_filter( 'style_loader_src', 'wp_style_loader_src', 10, 2 ); 614 615 add_action( 'wp_head', 'wp_print_auto_sizes_contain_css_fix', 1 ); 616 add_action( 'wp_head', 'wp_maybe_inline_styles', 1 ); // Run for styles enqueued in <head>. 617 add_action( 'wp_footer', 'wp_maybe_inline_styles', 1 ); // Run for late-loaded styles in the footer. 618 619 /* 620 * Block specific actions and filters. 621 */ 622 623 // Footnotes Block. 624 add_action( 'init', '_wp_footnotes_kses_init' ); 625 add_action( 'set_current_user', '_wp_footnotes_kses_init' ); 626 add_filter( 'force_filtered_html_on_import', '_wp_footnotes_force_filtered_html_on_import_filter', 999 ); 627 628 /* 629 * Disable "Post Attributes" for wp_navigation post type. The attributes are 630 * also conditionally enabled when a site has custom templates. Block Theme 631 * templates can be available for every post type. 632 */ 633 add_filter( 'theme_wp_navigation_templates', '__return_empty_array' ); 634 635 // Taxonomy. 636 add_action( 'init', 'create_initial_taxonomies', 0 ); // Highest priority. 637 add_action( 'change_locale', 'create_initial_taxonomies' ); 638 639 // Canonical. 640 add_action( 'template_redirect', 'redirect_canonical' ); 641 add_action( 'template_redirect', 'wp_redirect_admin_locations', 1000 ); 642 643 // Media. 644 add_action( 'wp_playlist_scripts', 'wp_playlist_scripts' ); 645 add_action( 'customize_controls_enqueue_scripts', 'wp_plupload_default_settings' ); 646 add_action( 'plugins_loaded', '_wp_add_additional_image_sizes', 0 ); 647 add_filter( 'plupload_default_settings', 'wp_show_heic_upload_error' ); 648 649 // Nav menu. 650 add_filter( 'nav_menu_item_id', '_nav_menu_item_id_use_once', 10, 2 ); 651 add_filter( 'nav_menu_css_class', 'wp_nav_menu_remove_menu_item_has_children_class', 10, 4 ); 652 653 // Widgets. 654 add_action( 'after_setup_theme', 'wp_setup_widgets_block_editor', 1 ); 655 add_action( 'init', 'wp_widgets_init', 1 ); 656 add_action( 'change_locale', array( 'WP_Widget_Media', 'reset_default_labels' ) ); 657 add_action( 'widgets_init', '_wp_block_theme_register_classic_sidebars', 1 ); 658 659 // Admin Bar. 660 // Don't remove. Wrong way to disable. 661 add_action( 'template_redirect', '_wp_admin_bar_init', 0 ); 662 add_action( 'admin_init', '_wp_admin_bar_init' ); 663 add_action( 'wp_enqueue_scripts', 'wp_enqueue_admin_bar_bump_styles' ); 664 add_action( 'wp_enqueue_scripts', 'wp_enqueue_admin_bar_header_styles' ); 665 add_action( 'admin_enqueue_scripts', 'wp_enqueue_admin_bar_header_styles' ); 666 add_action( 'before_signup_header', '_wp_admin_bar_init' ); 667 add_action( 'activate_header', '_wp_admin_bar_init' ); 668 add_action( 'wp_body_open', 'wp_admin_bar_render', 0 ); 669 add_action( 'wp_footer', 'wp_admin_bar_render', 1000 ); // Back-compat for themes not using `wp_body_open`. 670 add_action( 'in_admin_header', 'wp_admin_bar_render', 0 ); 671 672 // Former admin filters that can also be hooked on the front end. 673 add_action( 'media_buttons', 'media_buttons' ); 674 add_filter( 'image_send_to_editor', 'image_add_caption', 20, 8 ); 675 add_filter( 'media_send_to_editor', 'image_media_send_to_editor', 10, 3 ); 676 677 // Embeds. 678 add_action( 'rest_api_init', 'wp_oembed_register_route' ); 679 add_filter( 'rest_pre_serve_request', '_oembed_rest_pre_serve_request', 10, 4 ); 680 681 add_action( 'wp_head', 'wp_oembed_add_discovery_links' ); 682 add_action( 'wp_head', 'wp_oembed_add_host_js' ); // Back-compat for sites disabling oEmbed host JS by removing action. 683 add_filter( 'embed_oembed_html', 'wp_maybe_enqueue_oembed_host_js' ); 684 685 add_action( 'embed_head', 'enqueue_embed_scripts', 1 ); 686 add_action( 'embed_head', 'print_emoji_detection_script' ); 687 add_action( 'embed_head', 'wp_enqueue_embed_styles', 9 ); 688 add_action( 'embed_head', 'print_embed_styles' ); // Retained for backwards-compatibility. Unhooked by wp_enqueue_embed_styles(). 689 add_action( 'embed_head', 'wp_print_head_scripts', 20 ); 690 add_action( 'embed_head', 'wp_print_styles', 20 ); 691 add_action( 'embed_head', 'wp_robots' ); 692 add_action( 'embed_head', 'rel_canonical' ); 693 add_action( 'embed_head', 'locale_stylesheet', 30 ); 694 add_action( 'enqueue_embed_scripts', 'wp_enqueue_emoji_styles' ); 695 696 add_action( 'embed_content_meta', 'print_embed_comments_button' ); 697 add_action( 'embed_content_meta', 'print_embed_sharing_button' ); 698 699 add_action( 'embed_footer', 'print_embed_sharing_dialog' ); 700 add_action( 'embed_footer', 'print_embed_scripts' ); 701 add_action( 'embed_footer', 'wp_print_footer_scripts', 20 ); 702 703 add_filter( 'excerpt_more', 'wp_embed_excerpt_more', 20 ); 704 add_filter( 'the_excerpt_embed', 'wptexturize' ); 705 add_filter( 'the_excerpt_embed', 'convert_chars' ); 706 add_filter( 'the_excerpt_embed', 'wpautop' ); 707 add_filter( 'the_excerpt_embed', 'shortcode_unautop' ); 708 add_filter( 'the_excerpt_embed', 'wp_embed_excerpt_attachment' ); 709 710 add_filter( 'oembed_dataparse', 'wp_filter_oembed_iframe_title_attribute', 5, 3 ); 711 add_filter( 'oembed_dataparse', 'wp_filter_oembed_result', 10, 3 ); 712 add_filter( 'oembed_response_data', 'get_oembed_response_data_rich', 10, 4 ); 713 add_filter( 'pre_oembed_result', 'wp_filter_pre_oembed_result', 10, 3 ); 714 715 // Capabilities. 716 add_filter( 'user_has_cap', 'wp_maybe_grant_install_languages_cap', 1 ); 717 add_filter( 'user_has_cap', 'wp_maybe_grant_resume_extensions_caps', 1 ); 718 add_filter( 'user_has_cap', 'wp_maybe_grant_site_health_caps', 1, 4 ); 719 720 // Block templates post type and rendering. 721 add_filter( 'render_block_context', '_block_template_render_without_post_block_context' ); 722 add_filter( 'pre_wp_unique_post_slug', 'wp_filter_wp_template_unique_post_slug', 10, 5 ); 723 add_action( 'save_post_wp_template_part', 'wp_set_unique_slug_on_create_template_part' ); 724 add_action( 'wp_enqueue_scripts', 'wp_enqueue_block_template_skip_link' ); 725 add_action( 'wp_footer', 'the_block_template_skip_link' ); // Retained for backwards-compatibility. Unhooked by wp_enqueue_block_template_skip_link(). 726 add_action( 'after_setup_theme', 'wp_enable_block_templates', 1 ); 727 add_action( 'wp_loaded', '_add_template_loader_filters' ); 728 729 // wp_navigation post type. 730 add_filter( 'rest_wp_navigation_item_schema', array( 'WP_Navigation_Fallback', 'update_wp_navigation_post_schema' ) ); 731 732 // Fluid typography. 733 add_filter( 'render_block', 'wp_render_typography_support', 10, 2 ); 734 735 // User preferences. 736 add_action( 'init', 'wp_register_persisted_preferences_meta' ); 737 738 // CPT wp_block custom postmeta field. 739 add_action( 'init', 'wp_create_initial_post_meta' ); 740 741 // Include revisioned meta when considering whether a post revision has changed. 742 add_filter( 'wp_save_post_revision_post_has_changed', 'wp_check_revisioned_meta_fields_have_changed', 10, 3 ); 743 744 // Save revisioned post meta immediately after a revision is saved 745 add_action( '_wp_put_post_revision', 'wp_save_revisioned_meta_fields', 10, 2 ); 746 747 // Include revisioned meta when creating or updating an autosave revision. 748 add_action( 'wp_creating_autosave', 'wp_autosave_post_revisioned_meta_fields' ); 749 750 // When restoring revisions, also restore revisioned meta. 751 add_action( 'wp_restore_post_revision', 'wp_restore_post_revision_meta', 10, 2 ); 752 753 // Font management. 754 add_action( 'wp_head', 'wp_print_font_faces', 50 ); 755 add_action( 'deleted_post', '_wp_after_delete_font_family', 10, 2 ); 756 add_action( 'before_delete_post', '_wp_before_delete_font_face', 10, 2 ); 757 add_action( 'init', '_wp_register_default_font_collections' ); 758 759 // Add ignoredHookedBlocks metadata attribute to the template and template part post types. 760 add_filter( 'rest_pre_insert_wp_template', 'inject_ignored_hooked_blocks_metadata_attributes' ); 761 add_filter( 'rest_pre_insert_wp_template_part', 'inject_ignored_hooked_blocks_metadata_attributes' ); 762 763 // Update ignoredHookedBlocks postmeta for some post types. 764 add_filter( 'rest_pre_insert_page', 'update_ignored_hooked_blocks_postmeta' ); 765 add_filter( 'rest_pre_insert_post', 'update_ignored_hooked_blocks_postmeta' ); 766 add_filter( 'rest_pre_insert_wp_block', 'update_ignored_hooked_blocks_postmeta' ); 767 add_filter( 'rest_pre_insert_wp_navigation', 'update_ignored_hooked_blocks_postmeta' ); 768 769 // Inject hooked blocks into the Posts endpoint REST response for some given post types. 770 add_filter( 'rest_prepare_page', 'insert_hooked_blocks_into_rest_response', 10, 2 ); 771 add_filter( 'rest_prepare_post', 'insert_hooked_blocks_into_rest_response', 10, 2 ); 772 add_filter( 'rest_prepare_wp_block', 'insert_hooked_blocks_into_rest_response', 10, 2 ); 773 add_filter( 'rest_prepare_wp_navigation', 'insert_hooked_blocks_into_rest_response', 10, 2 ); 774 775 unset( $filter, $action );
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
Generated : Sat Dec 21 08:20:01 2024 | Cross-referenced by PHPXref |