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


Generated : Fri Apr 19 08:20:01 2024 Cross-referenced by PHPXref