[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-includes/ -> default-filters.php (source)

   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 );


Generated : Sat Dec 21 08:20:01 2024 Cross-referenced by PHPXref