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