[ 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', 'do_blocks', 9 ); 196 add_filter( 'the_content', 'wptexturize' ); 197 add_filter( 'the_content', 'convert_smilies', 20 ); 198 add_filter( 'the_content', 'wpautop' ); 199 add_filter( 'the_content', 'shortcode_unautop' ); 200 add_filter( 'the_content', 'prepend_attachment' ); 201 add_filter( 'the_content', 'wp_replace_insecure_home_url' ); 202 add_filter( 'the_content', 'do_shortcode', 11 ); // AFTER wpautop(). 203 add_filter( 'the_content', 'wp_filter_content_tags', 12 ); // Runs after do_shortcode(). 204 205 add_filter( 'the_excerpt', 'wptexturize' ); 206 add_filter( 'the_excerpt', 'convert_smilies' ); 207 add_filter( 'the_excerpt', 'convert_chars' ); 208 add_filter( 'the_excerpt', 'wpautop' ); 209 add_filter( 'the_excerpt', 'shortcode_unautop' ); 210 add_filter( 'the_excerpt', 'wp_replace_insecure_home_url' ); 211 add_filter( 'the_excerpt', 'wp_filter_content_tags', 12 ); 212 add_filter( 'get_the_excerpt', 'wp_trim_excerpt', 10, 2 ); 213 214 add_filter( 'the_post_thumbnail_caption', 'wptexturize' ); 215 add_filter( 'the_post_thumbnail_caption', 'convert_smilies' ); 216 add_filter( 'the_post_thumbnail_caption', 'convert_chars' ); 217 218 add_filter( 'comment_text', 'wptexturize' ); 219 add_filter( 'comment_text', 'convert_chars' ); 220 add_filter( 'comment_text', 'make_clickable', 9 ); 221 add_filter( 'comment_text', 'force_balance_tags', 25 ); 222 add_filter( 'comment_text', 'convert_smilies', 20 ); 223 add_filter( 'comment_text', 'wpautop', 30 ); 224 225 add_filter( 'comment_excerpt', 'convert_chars' ); 226 227 add_filter( 'list_cats', 'wptexturize' ); 228 229 add_filter( 'wp_sprintf', 'wp_sprintf_l', 10, 2 ); 230 231 add_filter( 'widget_text', 'balanceTags' ); 232 add_filter( 'widget_text_content', 'capital_P_dangit', 11 ); 233 add_filter( 'widget_text_content', 'wptexturize' ); 234 add_filter( 'widget_text_content', 'convert_smilies', 20 ); 235 add_filter( 'widget_text_content', 'wpautop' ); 236 add_filter( 'widget_text_content', 'shortcode_unautop' ); 237 add_filter( 'widget_text_content', 'wp_replace_insecure_home_url' ); 238 add_filter( 'widget_text_content', 'do_shortcode', 11 ); // Runs after wpautop(); note that $post global will be null when shortcodes run. 239 add_filter( 'widget_text_content', 'wp_filter_content_tags', 12 ); // Runs after do_shortcode(). 240 241 add_filter( 'widget_block_content', 'do_blocks', 9 ); 242 add_filter( 'widget_block_content', 'do_shortcode', 11 ); 243 add_filter( 'widget_block_content', 'wp_filter_content_tags', 12 ); // Runs after do_shortcode(). 244 245 add_filter( 'block_type_metadata', 'wp_migrate_old_typography_shape' ); 246 247 add_filter( 'wp_get_custom_css', 'wp_replace_insecure_home_url' ); 248 249 // RSS filters. 250 add_filter( 'the_title_rss', 'strip_tags' ); 251 add_filter( 'the_title_rss', 'ent2ncr', 8 ); 252 add_filter( 'the_title_rss', 'esc_html' ); 253 add_filter( 'the_content_rss', 'ent2ncr', 8 ); 254 add_filter( 'the_content_feed', 'wp_staticize_emoji' ); 255 add_filter( 'the_content_feed', '_oembed_filter_feed_content' ); 256 add_filter( 'the_excerpt_rss', 'convert_chars' ); 257 add_filter( 'the_excerpt_rss', 'ent2ncr', 8 ); 258 add_filter( 'comment_author_rss', 'ent2ncr', 8 ); 259 add_filter( 'comment_text_rss', 'ent2ncr', 8 ); 260 add_filter( 'comment_text_rss', 'esc_html' ); 261 add_filter( 'comment_text_rss', 'wp_staticize_emoji' ); 262 add_filter( 'bloginfo_rss', 'ent2ncr', 8 ); 263 add_filter( 'the_author', 'ent2ncr', 8 ); 264 add_filter( 'the_guid', 'esc_url' ); 265 266 // Email filters. 267 add_filter( 'wp_mail', 'wp_staticize_emoji_for_email' ); 268 269 // Robots filters. 270 add_filter( 'wp_robots', 'wp_robots_noindex' ); 271 add_filter( 'wp_robots', 'wp_robots_noindex_embeds' ); 272 add_filter( 'wp_robots', 'wp_robots_noindex_search' ); 273 add_filter( 'wp_robots', 'wp_robots_max_image_preview_large' ); 274 275 // Mark site as no longer fresh. 276 foreach ( 277 array( 278 'publish_post', 279 'publish_page', 280 'wp_ajax_save-widget', 281 'wp_ajax_widgets-order', 282 'customize_save_after', 283 'rest_after_save_widget', 284 'rest_delete_widget', 285 'rest_save_sidebar', 286 ) as $action 287 ) { 288 add_action( $action, '_delete_option_fresh_site', 0 ); 289 } 290 291 // Misc filters. 292 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. 293 add_filter( 'option_ping_sites', 'privacy_ping_filter' ); 294 add_filter( 'option_blog_charset', '_wp_specialchars' ); // IMPORTANT: This must not be wp_specialchars() or esc_html() or it'll cause an infinite loop. 295 add_filter( 'option_blog_charset', '_canonical_charset' ); 296 add_filter( 'option_home', '_config_wp_home' ); 297 add_filter( 'option_siteurl', '_config_wp_siteurl' ); 298 add_filter( 'tiny_mce_before_init', '_mce_set_direction' ); 299 add_filter( 'teeny_mce_before_init', '_mce_set_direction' ); 300 add_filter( 'pre_kses', 'wp_pre_kses_less_than' ); 301 add_filter( 'pre_kses', 'wp_pre_kses_block_attributes', 10, 3 ); 302 add_filter( 'sanitize_title', 'sanitize_title_with_dashes', 10, 3 ); 303 add_action( 'check_comment_flood', 'check_comment_flood_db', 10, 4 ); 304 add_filter( 'comment_flood_filter', 'wp_throttle_comment_flood', 10, 3 ); 305 add_filter( 'pre_comment_content', 'wp_rel_ugc', 15 ); 306 add_filter( 'comment_email', 'antispambot' ); 307 add_filter( 'option_tag_base', '_wp_filter_taxonomy_base' ); 308 add_filter( 'option_category_base', '_wp_filter_taxonomy_base' ); 309 add_filter( 'the_posts', '_close_comments_for_old_posts', 10, 2 ); 310 add_filter( 'comments_open', '_close_comments_for_old_post', 10, 2 ); 311 add_filter( 'pings_open', '_close_comments_for_old_post', 10, 2 ); 312 add_filter( 'editable_slug', 'urldecode' ); 313 add_filter( 'editable_slug', 'esc_textarea' ); 314 add_filter( 'pingback_ping_source_uri', 'pingback_ping_source_uri' ); 315 add_filter( 'xmlrpc_pingback_error', 'xmlrpc_pingback_error' ); 316 add_filter( 'title_save_pre', 'trim' ); 317 318 add_action( 'transition_comment_status', '_clear_modified_cache_on_transition_comment_status', 10, 2 ); 319 320 add_filter( 'http_request_host_is_external', 'allowed_http_request_hosts', 10, 2 ); 321 322 // REST API filters. 323 add_action( 'xmlrpc_rsd_apis', 'rest_output_rsd' ); 324 add_action( 'wp_head', 'rest_output_link_wp_head', 10, 0 ); 325 add_action( 'template_redirect', 'rest_output_link_header', 11, 0 ); 326 add_action( 'auth_cookie_malformed', 'rest_cookie_collect_status' ); 327 add_action( 'auth_cookie_expired', 'rest_cookie_collect_status' ); 328 add_action( 'auth_cookie_bad_username', 'rest_cookie_collect_status' ); 329 add_action( 'auth_cookie_bad_hash', 'rest_cookie_collect_status' ); 330 add_action( 'auth_cookie_valid', 'rest_cookie_collect_status' ); 331 add_action( 'application_password_failed_authentication', 'rest_application_password_collect_status' ); 332 add_action( 'application_password_did_authenticate', 'rest_application_password_collect_status', 10, 2 ); 333 add_filter( 'rest_authentication_errors', 'rest_application_password_check_errors', 90 ); 334 add_filter( 'rest_authentication_errors', 'rest_cookie_check_errors', 100 ); 335 336 // Actions. 337 add_action( 'wp_head', '_wp_render_title_tag', 1 ); 338 add_action( 'wp_head', 'wp_enqueue_scripts', 1 ); 339 add_action( 'wp_head', 'wp_resource_hints', 2 ); 340 add_action( 'wp_head', 'wp_preload_resources', 1 ); 341 add_action( 'wp_head', 'feed_links', 2 ); 342 add_action( 'wp_head', 'feed_links_extra', 3 ); 343 add_action( 'wp_head', 'rsd_link' ); 344 add_action( 'wp_head', 'locale_stylesheet' ); 345 add_action( 'publish_future_post', 'check_and_publish_future_post', 10, 1 ); 346 add_action( 'wp_head', 'wp_robots', 1 ); 347 add_action( 'wp_head', 'print_emoji_detection_script', 7 ); 348 add_action( 'wp_head', 'wp_print_styles', 8 ); 349 add_action( 'wp_head', 'wp_print_head_scripts', 9 ); 350 add_action( 'wp_head', 'wp_generator' ); 351 add_action( 'wp_head', 'rel_canonical' ); 352 add_action( 'wp_head', 'wp_shortlink_wp_head', 10, 0 ); 353 add_action( 'wp_head', 'wp_custom_css_cb', 101 ); 354 add_action( 'wp_head', 'wp_site_icon', 99 ); 355 add_action( 'wp_footer', 'wp_print_footer_scripts', 20 ); 356 add_action( 'template_redirect', 'wp_shortlink_header', 11, 0 ); 357 add_action( 'wp_print_footer_scripts', '_wp_footer_scripts' ); 358 add_action( 'init', '_register_core_block_patterns_and_categories' ); 359 add_action( 'init', 'check_theme_switched', 99 ); 360 add_action( 'init', array( 'WP_Block_Supports', 'init' ), 22 ); 361 add_action( 'switch_theme', 'wp_clean_theme_json_cache' ); 362 add_action( 'start_previewing_theme', 'wp_clean_theme_json_cache' ); 363 add_action( 'after_switch_theme', '_wp_menus_changed' ); 364 add_action( 'after_switch_theme', '_wp_sidebars_changed' ); 365 add_action( 'wp_enqueue_scripts', 'wp_enqueue_emoji_styles' ); 366 add_action( 'wp_print_styles', 'print_emoji_styles' ); // Retained for backwards-compatibility. Unhooked by wp_enqueue_emoji_styles(). 367 368 if ( isset( $_GET['replytocom'] ) ) { 369 add_filter( 'wp_robots', 'wp_robots_no_robots' ); 370 } 371 372 // Login actions. 373 add_action( 'login_head', 'wp_robots', 1 ); 374 add_filter( 'login_head', 'wp_resource_hints', 8 ); 375 add_action( 'login_head', 'wp_print_head_scripts', 9 ); 376 add_action( 'login_head', 'print_admin_styles', 9 ); 377 add_action( 'login_head', 'wp_site_icon', 99 ); 378 add_action( 'login_footer', 'wp_print_footer_scripts', 20 ); 379 add_action( 'login_init', 'send_frame_options_header', 10, 0 ); 380 381 // Feed generator tags. 382 foreach ( array( 'rss2_head', 'commentsrss2_head', 'rss_head', 'rdf_header', 'atom_head', 'comments_atom_head', 'opml_head', 'app_head' ) as $action ) { 383 add_action( $action, 'the_generator' ); 384 } 385 386 // Feed Site Icon. 387 add_action( 'atom_head', 'atom_site_icon' ); 388 add_action( 'rss2_head', 'rss2_site_icon' ); 389 390 391 // WP Cron. 392 if ( ! defined( 'DOING_CRON' ) ) { 393 add_action( 'init', 'wp_cron' ); 394 } 395 396 // HTTPS migration. 397 add_action( 'update_option_home', 'wp_update_https_migration_required', 10, 2 ); 398 399 // 2 Actions 2 Furious. 400 add_action( 'do_feed_rdf', 'do_feed_rdf', 10, 0 ); 401 add_action( 'do_feed_rss', 'do_feed_rss', 10, 0 ); 402 add_action( 'do_feed_rss2', 'do_feed_rss2', 10, 1 ); 403 add_action( 'do_feed_atom', 'do_feed_atom', 10, 1 ); 404 add_action( 'do_pings', 'do_all_pings', 10, 0 ); 405 add_action( 'do_all_pings', 'do_all_pingbacks', 10, 0 ); 406 add_action( 'do_all_pings', 'do_all_enclosures', 10, 0 ); 407 add_action( 'do_all_pings', 'do_all_trackbacks', 10, 0 ); 408 add_action( 'do_all_pings', 'generic_ping', 10, 0 ); 409 add_action( 'do_robots', 'do_robots' ); 410 add_action( 'do_favicon', 'do_favicon' ); 411 add_action( 'set_comment_cookies', 'wp_set_comment_cookies', 10, 3 ); 412 add_action( 'sanitize_comment_cookies', 'sanitize_comment_cookies' ); 413 add_action( 'init', 'smilies_init', 5 ); 414 add_action( 'plugins_loaded', 'wp_maybe_load_widgets', 0 ); 415 add_action( 'plugins_loaded', 'wp_maybe_load_embeds', 0 ); 416 add_action( 'shutdown', 'wp_ob_end_flush_all', 1 ); 417 // Create a revision whenever a post is updated. 418 add_action( 'wp_after_insert_post', 'wp_save_post_revision_on_insert', 9, 3 ); 419 add_action( 'post_updated', 'wp_save_post_revision', 10, 1 ); 420 add_action( 'publish_post', '_publish_post_hook', 5, 1 ); 421 add_action( 'transition_post_status', '_transition_post_status', 5, 3 ); 422 add_action( 'transition_post_status', '_update_term_count_on_transition_post_status', 10, 3 ); 423 add_action( 'comment_form', 'wp_comment_form_unfiltered_html_nonce' ); 424 425 // Privacy. 426 add_action( 'user_request_action_confirmed', '_wp_privacy_account_request_confirmed' ); 427 add_action( 'user_request_action_confirmed', '_wp_privacy_send_request_confirmation_notification', 12 ); // After request marked as completed. 428 add_filter( 'wp_privacy_personal_data_exporters', 'wp_register_comment_personal_data_exporter' ); 429 add_filter( 'wp_privacy_personal_data_exporters', 'wp_register_media_personal_data_exporter' ); 430 add_filter( 'wp_privacy_personal_data_exporters', 'wp_register_user_personal_data_exporter', 1 ); 431 add_filter( 'wp_privacy_personal_data_erasers', 'wp_register_comment_personal_data_eraser' ); 432 add_action( 'init', 'wp_schedule_delete_old_privacy_export_files' ); 433 add_action( 'wp_privacy_delete_old_export_files', 'wp_privacy_delete_old_export_files' ); 434 435 // Cron tasks. 436 add_action( 'wp_scheduled_delete', 'wp_scheduled_delete' ); 437 add_action( 'wp_scheduled_auto_draft_delete', 'wp_delete_auto_drafts' ); 438 add_action( 'importer_scheduled_cleanup', 'wp_delete_attachment' ); 439 add_action( 'upgrader_scheduled_cleanup', 'wp_delete_attachment' ); 440 add_action( 'delete_expired_transients', 'delete_expired_transients' ); 441 442 // Navigation menu actions. 443 add_action( 'delete_post', '_wp_delete_post_menu_item' ); 444 add_action( 'delete_term', '_wp_delete_tax_menu_item', 10, 3 ); 445 add_action( 'transition_post_status', '_wp_auto_add_pages_to_menu', 10, 3 ); 446 add_action( 'delete_post', '_wp_delete_customize_changeset_dependent_auto_drafts' ); 447 448 // Post Thumbnail specific image filtering. 449 add_action( 'begin_fetch_post_thumbnail_html', '_wp_post_thumbnail_class_filter_add' ); 450 add_action( 'end_fetch_post_thumbnail_html', '_wp_post_thumbnail_class_filter_remove' ); 451 add_action( 'begin_fetch_post_thumbnail_html', '_wp_post_thumbnail_context_filter_add' ); 452 add_action( 'end_fetch_post_thumbnail_html', '_wp_post_thumbnail_context_filter_remove' ); 453 454 // Redirect old slugs. 455 add_action( 'template_redirect', 'wp_old_slug_redirect' ); 456 add_action( 'post_updated', 'wp_check_for_changed_slugs', 12, 3 ); 457 add_action( 'attachment_updated', 'wp_check_for_changed_slugs', 12, 3 ); 458 459 // Redirect old dates. 460 add_action( 'post_updated', 'wp_check_for_changed_dates', 12, 3 ); 461 add_action( 'attachment_updated', 'wp_check_for_changed_dates', 12, 3 ); 462 463 // Nonce check for post previews. 464 add_action( 'init', '_show_post_preview' ); 465 466 // Output JS to reset window.name for previews. 467 add_action( 'wp_head', 'wp_post_preview_js', 1 ); 468 469 // Timezone. 470 add_filter( 'pre_option_gmt_offset', 'wp_timezone_override_offset' ); 471 472 // If the upgrade hasn't run yet, assume link manager is used. 473 add_filter( 'default_option_link_manager_enabled', '__return_true' ); 474 475 // This option no longer exists; tell plugins we always support auto-embedding. 476 add_filter( 'pre_option_embed_autourls', '__return_true' ); 477 478 // Default settings for heartbeat. 479 add_filter( 'heartbeat_settings', 'wp_heartbeat_settings' ); 480 481 // Check if the user is logged out. 482 add_action( 'admin_enqueue_scripts', 'wp_auth_check_load' ); 483 add_filter( 'heartbeat_send', 'wp_auth_check' ); 484 add_filter( 'heartbeat_nopriv_send', 'wp_auth_check' ); 485 486 // Default authentication filters. 487 add_filter( 'authenticate', 'wp_authenticate_username_password', 20, 3 ); 488 add_filter( 'authenticate', 'wp_authenticate_email_password', 20, 3 ); 489 add_filter( 'authenticate', 'wp_authenticate_application_password', 20, 3 ); 490 add_filter( 'authenticate', 'wp_authenticate_spam_check', 99 ); 491 add_filter( 'determine_current_user', 'wp_validate_auth_cookie' ); 492 add_filter( 'determine_current_user', 'wp_validate_logged_in_cookie', 20 ); 493 add_filter( 'determine_current_user', 'wp_validate_application_password', 20 ); 494 495 // Split term updates. 496 add_action( 'admin_init', '_wp_check_for_scheduled_split_terms' ); 497 add_action( 'split_shared_term', '_wp_check_split_default_terms', 10, 4 ); 498 add_action( 'split_shared_term', '_wp_check_split_terms_in_menus', 10, 4 ); 499 add_action( 'split_shared_term', '_wp_check_split_nav_menu_terms', 10, 4 ); 500 add_action( 'wp_split_shared_term_batch', '_wp_batch_split_terms' ); 501 502 // Comment type updates. 503 add_action( 'admin_init', '_wp_check_for_scheduled_update_comment_type' ); 504 add_action( 'wp_update_comment_type_batch', '_wp_batch_update_comment_type' ); 505 506 // Email notifications. 507 add_action( 'comment_post', 'wp_new_comment_notify_moderator' ); 508 add_action( 'comment_post', 'wp_new_comment_notify_postauthor' ); 509 add_action( 'after_password_reset', 'wp_password_change_notification' ); 510 add_action( 'register_new_user', 'wp_send_new_user_notifications' ); 511 add_action( 'edit_user_created_user', 'wp_send_new_user_notifications', 10, 2 ); 512 513 // REST API actions. 514 add_action( 'init', 'rest_api_init' ); 515 add_action( 'rest_api_init', 'rest_api_default_filters', 10, 1 ); 516 add_action( 'rest_api_init', 'register_initial_settings', 10 ); 517 add_action( 'rest_api_init', 'create_initial_rest_routes', 99 ); 518 add_action( 'parse_request', 'rest_api_loaded' ); 519 520 // Sitemaps actions. 521 add_action( 'init', 'wp_sitemaps_get_server' ); 522 523 /** 524 * Filters formerly mixed into wp-includes. 525 */ 526 // Theme. 527 add_action( 'setup_theme', 'create_initial_theme_features', 0 ); 528 add_action( 'after_setup_theme', '_add_default_theme_supports', 1 ); 529 add_action( 'wp_loaded', '_custom_header_background_just_in_time' ); 530 add_action( 'wp_head', '_custom_logo_header_styles' ); 531 add_action( 'plugins_loaded', '_wp_customize_include' ); 532 add_action( 'transition_post_status', '_wp_customize_publish_changeset', 10, 3 ); 533 add_action( 'admin_enqueue_scripts', '_wp_customize_loader_settings' ); 534 add_action( 'delete_attachment', '_delete_attachment_theme_mod' ); 535 add_action( 'transition_post_status', '_wp_keep_alive_customize_changeset_dependent_auto_drafts', 20, 3 ); 536 537 // Block Theme Previews. 538 add_action( 'plugins_loaded', 'wp_initialize_theme_preview_hooks', 1 ); 539 540 // Calendar widget cache. 541 add_action( 'save_post', 'delete_get_calendar_cache' ); 542 add_action( 'delete_post', 'delete_get_calendar_cache' ); 543 add_action( 'update_option_start_of_week', 'delete_get_calendar_cache' ); 544 add_action( 'update_option_gmt_offset', 'delete_get_calendar_cache' ); 545 546 // Author. 547 add_action( 'transition_post_status', '__clear_multi_author_cache' ); 548 549 // Post. 550 add_action( 'init', 'create_initial_post_types', 0 ); // Highest priority. 551 add_action( 'admin_menu', '_add_post_type_submenus' ); 552 add_action( 'before_delete_post', '_reset_front_page_settings_for_post' ); 553 add_action( 'wp_trash_post', '_reset_front_page_settings_for_post' ); 554 add_action( 'change_locale', 'create_initial_post_types' ); 555 556 // Post Formats. 557 add_filter( 'request', '_post_format_request' ); 558 add_filter( 'term_link', '_post_format_link', 10, 3 ); 559 add_filter( 'get_post_format', '_post_format_get_term' ); 560 add_filter( 'get_terms', '_post_format_get_terms', 10, 3 ); 561 add_filter( 'wp_get_object_terms', '_post_format_wp_get_object_terms' ); 562 563 // KSES. 564 add_action( 'init', 'kses_init' ); 565 add_action( 'set_current_user', 'kses_init' ); 566 567 // Script Loader. 568 add_action( 'wp_default_scripts', 'wp_default_scripts' ); 569 add_action( 'wp_default_scripts', 'wp_default_packages' ); 570 add_action( 'wp_default_scripts', 'wp_default_script_modules' ); 571 572 add_action( 'wp_enqueue_scripts', 'wp_localize_jquery_ui_datepicker', 1000 ); 573 add_action( 'wp_enqueue_scripts', 'wp_common_block_scripts_and_styles' ); 574 add_action( 'wp_enqueue_scripts', 'wp_enqueue_classic_theme_styles' ); 575 add_action( 'admin_enqueue_scripts', 'wp_localize_jquery_ui_datepicker', 1000 ); 576 add_action( 'admin_enqueue_scripts', 'wp_common_block_scripts_and_styles' ); 577 add_action( 'enqueue_block_assets', 'wp_enqueue_registered_block_scripts_and_styles' ); 578 add_action( 'enqueue_block_assets', 'enqueue_block_styles_assets', 30 ); 579 /* 580 * `wp_enqueue_registered_block_scripts_and_styles` is bound to both 581 * `enqueue_block_editor_assets` and `enqueue_block_assets` hooks 582 * since the introduction of the block editor in WordPress 5.0. 583 * 584 * The way this works is that the block assets are loaded before any other assets. 585 * For example, this is the order of styles for the editor: 586 * 587 * - front styles registered for blocks, via `styles` handle (block.json) 588 * - editor styles registered for blocks, via `editorStyles` handle (block.json) 589 * - editor styles enqueued via `enqueue_block_editor_assets` hook 590 * - front styles enqueued via `enqueue_block_assets` hook 591 */ 592 add_action( 'enqueue_block_editor_assets', 'wp_enqueue_registered_block_scripts_and_styles' ); 593 add_action( 'enqueue_block_editor_assets', 'enqueue_editor_block_styles_assets' ); 594 add_action( 'enqueue_block_editor_assets', 'wp_enqueue_editor_block_directory_assets' ); 595 add_action( 'enqueue_block_editor_assets', 'wp_enqueue_editor_format_library_assets' ); 596 add_action( 'enqueue_block_editor_assets', 'wp_enqueue_global_styles_css_custom_properties' ); 597 add_action( 'wp_print_scripts', 'wp_just_in_time_script_localization' ); 598 add_filter( 'print_scripts_array', 'wp_prototype_before_jquery' ); 599 add_action( 'customize_controls_print_styles', 'wp_resource_hints', 1 ); 600 add_action( 'admin_head', 'wp_check_widget_editor_deps' ); 601 add_filter( 'block_editor_settings_all', 'wp_add_editor_classic_theme_styles' ); 602 603 // Global styles can be enqueued in both the header and the footer. See https://core.trac.wordpress.org/ticket/53494. 604 add_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' ); 605 add_action( 'wp_footer', 'wp_enqueue_global_styles', 1 ); 606 607 // Block supports, and other styles parsed and stored in the Style Engine. 608 add_action( 'wp_enqueue_scripts', 'wp_enqueue_stored_styles' ); 609 add_action( 'wp_footer', 'wp_enqueue_stored_styles', 1 ); 610 611 add_action( 'wp_default_styles', 'wp_default_styles' ); 612 add_filter( 'style_loader_src', 'wp_style_loader_src', 10, 2 ); 613 614 add_action( 'wp_head', 'wp_print_auto_sizes_contain_css_fix', 1 ); 615 add_action( 'wp_head', 'wp_maybe_inline_styles', 1 ); // Run for styles enqueued in <head>. 616 add_action( 'wp_footer', 'wp_maybe_inline_styles', 1 ); // Run for late-loaded styles in the footer. 617 618 /* 619 * Block specific actions and filters. 620 */ 621 622 // Footnotes Block. 623 add_action( 'init', '_wp_footnotes_kses_init' ); 624 add_action( 'set_current_user', '_wp_footnotes_kses_init' ); 625 add_filter( 'force_filtered_html_on_import', '_wp_footnotes_force_filtered_html_on_import_filter', 999 ); 626 627 /* 628 * Disable "Post Attributes" for wp_navigation post type. The attributes are 629 * also conditionally enabled when a site has custom templates. Block Theme 630 * templates can be available for every post type. 631 */ 632 add_filter( 'theme_wp_navigation_templates', '__return_empty_array' ); 633 634 // Taxonomy. 635 add_action( 'init', 'create_initial_taxonomies', 0 ); // Highest priority. 636 add_action( 'change_locale', 'create_initial_taxonomies' ); 637 638 // Canonical. 639 add_action( 'template_redirect', 'redirect_canonical' ); 640 add_action( 'template_redirect', 'wp_redirect_admin_locations', 1000 ); 641 642 // Media. 643 add_action( 'wp_playlist_scripts', 'wp_playlist_scripts' ); 644 add_action( 'customize_controls_enqueue_scripts', 'wp_plupload_default_settings' ); 645 add_action( 'plugins_loaded', '_wp_add_additional_image_sizes', 0 ); 646 add_filter( 'plupload_default_settings', 'wp_show_heic_upload_error' ); 647 648 // Nav menu. 649 add_filter( 'nav_menu_item_id', '_nav_menu_item_id_use_once', 10, 2 ); 650 add_filter( 'nav_menu_css_class', 'wp_nav_menu_remove_menu_item_has_children_class', 10, 4 ); 651 652 // Widgets. 653 add_action( 'after_setup_theme', 'wp_setup_widgets_block_editor', 1 ); 654 add_action( 'init', 'wp_widgets_init', 1 ); 655 add_action( 'change_locale', array( 'WP_Widget_Media', 'reset_default_labels' ) ); 656 add_action( 'widgets_init', '_wp_block_theme_register_classic_sidebars', 1 ); 657 658 // Admin Bar. 659 // Don't remove. Wrong way to disable. 660 add_action( 'template_redirect', '_wp_admin_bar_init', 0 ); 661 add_action( 'admin_init', '_wp_admin_bar_init' ); 662 add_action( 'wp_enqueue_scripts', 'wp_enqueue_admin_bar_bump_styles' ); 663 add_action( 'wp_enqueue_scripts', 'wp_enqueue_admin_bar_header_styles' ); 664 add_action( 'admin_enqueue_scripts', 'wp_enqueue_admin_bar_header_styles' ); 665 add_action( 'before_signup_header', '_wp_admin_bar_init' ); 666 add_action( 'activate_header', '_wp_admin_bar_init' ); 667 add_action( 'wp_body_open', 'wp_admin_bar_render', 0 ); 668 add_action( 'wp_footer', 'wp_admin_bar_render', 1000 ); // Back-compat for themes not using `wp_body_open`. 669 add_action( 'in_admin_header', 'wp_admin_bar_render', 0 ); 670 671 // Former admin filters that can also be hooked on the front end. 672 add_action( 'media_buttons', 'media_buttons' ); 673 add_filter( 'image_send_to_editor', 'image_add_caption', 20, 8 ); 674 add_filter( 'media_send_to_editor', 'image_media_send_to_editor', 10, 3 ); 675 676 // Embeds. 677 add_action( 'rest_api_init', 'wp_oembed_register_route' ); 678 add_filter( 'rest_pre_serve_request', '_oembed_rest_pre_serve_request', 10, 4 ); 679 680 add_action( 'wp_head', 'wp_oembed_add_discovery_links' ); 681 add_action( 'wp_head', 'wp_oembed_add_host_js' ); // Back-compat for sites disabling oEmbed host JS by removing action. 682 add_filter( 'embed_oembed_html', 'wp_maybe_enqueue_oembed_host_js' ); 683 684 add_action( 'embed_head', 'enqueue_embed_scripts', 1 ); 685 add_action( 'embed_head', 'print_emoji_detection_script' ); 686 add_action( 'embed_head', 'wp_enqueue_embed_styles', 9 ); 687 add_action( 'embed_head', 'print_embed_styles' ); // Retained for backwards-compatibility. Unhooked by wp_enqueue_embed_styles(). 688 add_action( 'embed_head', 'wp_print_head_scripts', 20 ); 689 add_action( 'embed_head', 'wp_print_styles', 20 ); 690 add_action( 'embed_head', 'wp_robots' ); 691 add_action( 'embed_head', 'rel_canonical' ); 692 add_action( 'embed_head', 'locale_stylesheet', 30 ); 693 add_action( 'enqueue_embed_scripts', 'wp_enqueue_emoji_styles' ); 694 695 add_action( 'embed_content_meta', 'print_embed_comments_button' ); 696 add_action( 'embed_content_meta', 'print_embed_sharing_button' ); 697 698 add_action( 'embed_footer', 'print_embed_sharing_dialog' ); 699 add_action( 'embed_footer', 'print_embed_scripts' ); 700 add_action( 'embed_footer', 'wp_print_footer_scripts', 20 ); 701 702 add_filter( 'excerpt_more', 'wp_embed_excerpt_more', 20 ); 703 add_filter( 'the_excerpt_embed', 'wptexturize' ); 704 add_filter( 'the_excerpt_embed', 'convert_chars' ); 705 add_filter( 'the_excerpt_embed', 'wpautop' ); 706 add_filter( 'the_excerpt_embed', 'shortcode_unautop' ); 707 add_filter( 'the_excerpt_embed', 'wp_embed_excerpt_attachment' ); 708 709 add_filter( 'oembed_dataparse', 'wp_filter_oembed_iframe_title_attribute', 5, 3 ); 710 add_filter( 'oembed_dataparse', 'wp_filter_oembed_result', 10, 3 ); 711 add_filter( 'oembed_response_data', 'get_oembed_response_data_rich', 10, 4 ); 712 add_filter( 'pre_oembed_result', 'wp_filter_pre_oembed_result', 10, 3 ); 713 714 // Capabilities. 715 add_filter( 'user_has_cap', 'wp_maybe_grant_install_languages_cap', 1 ); 716 add_filter( 'user_has_cap', 'wp_maybe_grant_resume_extensions_caps', 1 ); 717 add_filter( 'user_has_cap', 'wp_maybe_grant_site_health_caps', 1, 4 ); 718 719 // Block templates post type and rendering. 720 add_filter( 'render_block_context', '_block_template_render_without_post_block_context' ); 721 add_filter( 'pre_wp_unique_post_slug', 'wp_filter_wp_template_unique_post_slug', 10, 5 ); 722 add_action( 'save_post_wp_template_part', 'wp_set_unique_slug_on_create_template_part' ); 723 add_action( 'wp_enqueue_scripts', 'wp_enqueue_block_template_skip_link' ); 724 add_action( 'wp_footer', 'the_block_template_skip_link' ); // Retained for backwards-compatibility. Unhooked by wp_enqueue_block_template_skip_link(). 725 add_action( 'after_setup_theme', 'wp_enable_block_templates', 1 ); 726 add_action( 'wp_loaded', '_add_template_loader_filters' ); 727 728 // wp_navigation post type. 729 add_filter( 'rest_wp_navigation_item_schema', array( 'WP_Navigation_Fallback', 'update_wp_navigation_post_schema' ) ); 730 731 // Fluid typography. 732 add_filter( 'render_block', 'wp_render_typography_support', 10, 2 ); 733 734 // User preferences. 735 add_action( 'init', 'wp_register_persisted_preferences_meta' ); 736 737 // CPT wp_block custom postmeta field. 738 add_action( 'init', 'wp_create_initial_post_meta' ); 739 740 // Include revisioned meta when considering whether a post revision has changed. 741 add_filter( 'wp_save_post_revision_post_has_changed', 'wp_check_revisioned_meta_fields_have_changed', 10, 3 ); 742 743 // Save revisioned post meta immediately after a revision is saved 744 add_action( '_wp_put_post_revision', 'wp_save_revisioned_meta_fields', 10, 2 ); 745 746 // Include revisioned meta when creating or updating an autosave revision. 747 add_action( 'wp_creating_autosave', 'wp_autosave_post_revisioned_meta_fields' ); 748 749 // When restoring revisions, also restore revisioned meta. 750 add_action( 'wp_restore_post_revision', 'wp_restore_post_revision_meta', 10, 2 ); 751 752 // Font management. 753 add_action( 'wp_head', 'wp_print_font_faces', 50 ); 754 add_action( 'deleted_post', '_wp_after_delete_font_family', 10, 2 ); 755 add_action( 'before_delete_post', '_wp_before_delete_font_face', 10, 2 ); 756 add_action( 'init', '_wp_register_default_font_collections' ); 757 758 // Add ignoredHookedBlocks metadata attribute to the template and template part post types. 759 add_filter( 'rest_pre_insert_wp_template', 'inject_ignored_hooked_blocks_metadata_attributes' ); 760 add_filter( 'rest_pre_insert_wp_template_part', 'inject_ignored_hooked_blocks_metadata_attributes' ); 761 762 // Update ignoredHookedBlocks postmeta for wp_navigation post type. 763 add_filter( 'rest_pre_insert_wp_navigation', 'update_ignored_hooked_blocks_postmeta' ); 764 765 // Inject hooked blocks into the wp_navigation post type REST response. 766 add_filter( 'rest_prepare_wp_navigation', 'insert_hooked_blocks_into_rest_response', 10, 2 ); 767 768 unset( $filter, $action );
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
Generated : Thu Nov 21 08:20:01 2024 | Cross-referenced by PHPXref |