wp-includes/default-filters.php

   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 for which to use to remove the
   8  * hook.
   9  *
  10  * Not all of the default hooks are found in default-filters.php
  11  *
  12  * @package WordPress
  13  */
  14
  15 // Strip, trim, kses, special chars for string saves
  16 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 ) {
  17         add_filter( $filter, 'sanitize_text_field'  );
  18         add_filter( $filter, 'wp_filter_kses'       );
  19         add_filter( $filter, '_wp_specialchars', 30 );
  20 }
  21
  22 // Strip, kses, special chars for string display
  23 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 ) {
  24         add_filter( $filter, 'sanitize_text_field'  );
  25         add_filter( $filter, 'wp_kses_data'       );
  26         add_filter( $filter, '_wp_specialchars', 30 );
  27 }
  28
  29 // Kses only for textarea saves
  30 foreach ( array( 'pre_term_description', 'pre_link_description', 'pre_link_notes', 'pre_user_description' ) as $filter ) {
  31         add_filter( $filter, 'wp_filter_kses' );
  32 }
  33
  34 // Kses only for textarea saves displays
  35 foreach ( array( 'term_description', 'link_description', 'link_notes', 'user_description' ) as $filter ) {
  36         add_filter( $filter, 'wp_kses_data' );
  37 }
  38
  39 // Email saves
  40 foreach ( array( 'pre_comment_author_email', 'pre_user_email' ) as $filter ) {
  41         add_filter( $filter, 'trim'           );
  42         add_filter( $filter, 'sanitize_email' );
  43         add_filter( $filter, 'wp_filter_kses' );
  44 }
  45
  46 // Email display
  47 foreach ( array( 'comment_author_email', 'user_email' ) as $filter ) {
  48         add_filter( $filter, 'sanitize_email' );
  49         add_filter( $filter, 'wp_kses_data' );
  50 }
  51
  52 // Save URL
  53 foreach ( array( 'pre_comment_author_url', 'pre_user_url', 'pre_link_url', 'pre_link_image',
  54         'pre_link_rss' ) as $filter ) {
  55         add_filter( $filter, 'wp_strip_all_tags' );
  56         add_filter( $filter, 'esc_url_raw'       );
  57         add_filter( $filter, 'wp_filter_kses'    );
  58 }
  59
  60 // Display URL
  61 foreach ( array( 'user_url', 'link_url', 'link_image', 'link_rss', 'comment_url' ) as $filter ) {
  62         add_filter( $filter, 'wp_strip_all_tags' );
  63         add_filter( $filter, 'esc_url'           );
  64         add_filter( $filter, 'wp_kses_data'    );
  65 }
  66
  67 // Slugs
  68 foreach ( array( 'pre_term_slug' ) as $filter ) {
  69         add_filter( $filter, 'sanitize_title' );
  70 }
  71
  72 // Keys
  73 foreach ( array( 'pre_post_type' ) as $filter ) {
  74         add_filter( $filter, 'sanitize_user' );
  75 }
  76
  77 // Places to balance tags on input
  78 foreach ( array( 'content_save_pre', 'excerpt_save_pre', 'comment_save_pre', 'pre_comment_content' ) as $filter ) {
  79         add_filter( $filter, 'balanceTags', 50 );
  80 }
  81
  82 // Format strings for display.
  83 foreach ( array( 'comment_author', 'term_name', 'link_name', 'link_description', 'link_notes', 'bloginfo', 'wp_title', 'widget_title' ) as $filter ) {
  84         add_filter( $filter, 'wptexturize'   );
  85         add_filter( $filter, 'convert_chars' );
  86         add_filter( $filter, 'esc_html'      );
  87 }
  88
  89 // Format text area for display.
  90 foreach ( array( 'term_description' ) as $filter ) {
  91         add_filter( $filter, 'wptexturize'      );
  92         add_filter( $filter, 'convert_chars'    );
  93         add_filter( $filter, 'wpautop'          );
  94         add_filter( $filter, 'shortcode_unautop');
  95 }
  96
  97 // Format for RSS
  98 foreach ( array( 'term_name_rss' ) as $filter ) {
  99         add_filter( $filter, 'convert_chars' );
 100 }
 101
 102 // Display filters
 103 add_filter( 'the_title', 'wptexturize'   );
 104 add_filter( 'the_title', 'convert_chars' );
 105 add_filter( 'the_title', 'trim'          );
 106
 107 add_filter( 'the_content', 'wptexturize'        );
 108 add_filter( 'the_content', 'convert_smilies'    );
 109 add_filter( 'the_content', 'convert_chars'      );
 110 add_filter( 'the_content', 'wpautop'            );
 111 add_filter( 'the_content', 'shortcode_unautop'  );
 112 add_filter( 'the_content', 'prepend_attachment' );
 113
 114 add_filter( 'the_excerpt',     'wptexturize'      );
 115 add_filter( 'the_excerpt',     'convert_smilies'  );
 116 add_filter( 'the_excerpt',     'convert_chars'    );
 117 add_filter( 'the_excerpt',     'wpautop'          );
 118 add_filter( 'the_excerpt',     'shortcode_unautop');
 119 add_filter( 'get_the_excerpt', 'wp_trim_excerpt'  );
 120
 121 add_filter( 'comment_text', 'wptexturize'            );
 122 add_filter( 'comment_text', 'convert_chars'          );
 123 add_filter( 'comment_text', 'make_clickable',      9 );
 124 add_filter( 'comment_text', 'force_balance_tags', 25 );
 125 add_filter( 'comment_text', 'convert_smilies',    20 );
 126 add_filter( 'comment_text', 'wpautop',            30 );
 127
 128 add_filter( 'comment_excerpt', 'convert_chars' );
 129
 130 add_filter( 'list_cats',         'wptexturize' );
 131 add_filter( 'single_post_title', 'wptexturize' );
 132
 133 add_filter( 'wp_sprintf', 'wp_sprintf_l', 10, 2 );
 134
 135 // RSS filters
 136 add_filter( 'the_title_rss',      'strip_tags'      );
 137 add_filter( 'the_title_rss',      'ent2ncr',      8 );
 138 add_filter( 'the_title_rss',      'esc_html'        );
 139 add_filter( 'the_content_rss',    'ent2ncr',      8 );
 140 add_filter( 'the_excerpt_rss',    'convert_chars'   );
 141 add_filter( 'the_excerpt_rss',    'ent2ncr',      8 );
 142 add_filter( 'comment_author_rss', 'ent2ncr',      8 );
 143 add_filter( 'comment_text_rss',   'ent2ncr',      8 );
 144 add_filter( 'comment_text_rss',   'esc_html'        );
 145 add_filter( 'bloginfo_rss',       'ent2ncr',      8 );
 146 add_filter( 'the_author',         'ent2ncr',      8 );
 147
 148 // Misc filters
 149 add_filter( 'option_ping_sites',    'privacy_ping_filter'                 );
 150 add_filter( 'option_blog_charset',  '_wp_specialchars'                    ); // IMPORTANT: This must not be wp_specialchars() or esc_html() or it'll cause an infinite loop
 151 add_filter( 'option_home',          '_config_wp_home'                     );
 152 add_filter( 'option_siteurl',       '_config_wp_siteurl'                  );
 153 add_filter( 'tiny_mce_before_init', '_mce_set_direction'                  );
 154 add_filter( 'pre_kses',             'wp_pre_kses_less_than'               );
 155 add_filter( 'sanitize_title',       'sanitize_title_with_dashes'          );
 156 add_action( 'check_comment_flood',  'check_comment_flood_db',       10, 3 );
 157 add_filter( 'comment_flood_filter', 'wp_throttle_comment_flood',    10, 3 );
 158 add_filter( 'pre_comment_content',  'wp_rel_nofollow',              15    );
 159 add_filter( 'comment_email',        'antispambot'                         );
 160 add_filter( 'option_tag_base',      '_wp_filter_taxonomy_base'            );
 161 add_filter( 'option_category_base', '_wp_filter_taxonomy_base'            );
 162 add_filter( 'the_posts',            '_close_comments_for_old_posts'       );
 163 add_filter( 'comments_open',        '_close_comments_for_old_post', 10, 2 );
 164 add_filter( 'pings_open',           '_close_comments_for_old_post', 10, 2 );
 165 add_filter( 'editable_slug',        'urldecode'                           );
 166
 167 // Atom SSL support
 168 add_filter( 'atom_service_url','atom_service_url_filter' );
 169
 170 // Actions
 171 add_action( 'wp_head',             'wp_enqueue_scripts',             1    );
 172 add_action( 'wp_head',             'feed_links_extra',               3    );
 173 add_action( 'wp_head',             'rsd_link'                             );
 174 add_action( 'wp_head',             'wlwmanifest_link'                     );
 175 add_action( 'wp_head',             'index_rel_link'                       );
 176 add_action( 'wp_head',             'parent_post_rel_link',          10, 0 );
 177 add_action( 'wp_head',             'start_post_rel_link',           10, 0 );
 178 add_action( 'wp_head',             'adjacent_posts_rel_link',       10, 0 );
 179 add_action( 'wp_head',             'locale_stylesheet'                    );
 180 add_action( 'publish_future_post', 'check_and_publish_future_post', 10, 1 );
 181 add_action( 'wp_head',             'noindex',                        1    );
 182 add_action( 'wp_head',             'wp_print_styles',                8    );
 183 add_action( 'wp_head',             'wp_print_head_scripts',          9    );
 184 add_action( 'wp_head',             'wp_generator'                         );
 185 add_action( 'wp_head',             'rel_canonical'                        );
 186 add_action( 'wp_footer',           'wp_print_footer_scripts'              );
 187
 188 // WP Cron
 189 if ( !defined( 'DOING_CRON' ) )
 190         add_action( 'sanitize_comment_cookies', 'wp_cron' );
 191
 192 // 2 Actions 2 Furious
 193 add_action( 'do_feed_rdf',                'do_feed_rdf',             10, 1 );
 194 add_action( 'do_feed_rss',                'do_feed_rss',             10, 1 );
 195 add_action( 'do_feed_rss2',               'do_feed_rss2',            10, 1 );
 196 add_action( 'do_feed_atom',               'do_feed_atom',            10, 1 );
 197 add_action( 'do_pings',                   'do_all_pings',            10, 1 );
 198 add_action( 'do_robots',                  'do_robots'                      );
 199 add_action( 'sanitize_comment_cookies',   'sanitize_comment_cookies'       );
 200 add_action( 'admin_print_scripts',        'print_head_scripts',      20    );
 201 add_action( 'admin_print_footer_scripts', 'print_footer_scripts',    20    );
 202 add_action( 'admin_print_styles',         'print_admin_styles',      20    );
 203 add_action( 'init',                       'smilies_init',             5    );
 204 add_action( 'plugins_loaded',             'wp_maybe_load_widgets',    0    );
 205 add_action( 'plugins_loaded',             'wp_maybe_load_embeds',     0    );
 206 add_action( 'shutdown',                   'wp_ob_end_flush_all',      1    );
 207 add_action( 'pre_post_update',            'wp_save_post_revision'          );
 208 add_action( 'publish_post',               '_publish_post_hook',       5, 1 );
 209 add_action( 'future_post',                '_future_post_hook',        5, 2 );
 210 add_action( 'future_page',                '_future_post_hook',        5, 2 );
 211 add_action( 'save_post',                  '_save_post_hook',          5, 2 );
 212 add_action( 'transition_post_status',     '_transition_post_status',  5, 3 );
 213 add_action( 'comment_form', 'wp_comment_form_unfiltered_html_nonce'        );
 214 add_action( 'wp_scheduled_delete',        'wp_scheduled_delete' );
 215
 216 // Post Thumbnail CSS class filtering
 217 add_action( 'begin_fetch_post_thumbnail_html', '_wp_post_thumbnail_class_filter_add'    );
 218 add_action( 'end_fetch_post_thumbnail_html',   '_wp_post_thumbnail_class_filter_remove' );
 219
 220 // Redirect Old Slugs
 221 add_action( 'template_redirect',  'wp_old_slug_redirect'       );
 222 add_action( 'edit_post',          'wp_check_for_changed_slugs' );
 223 add_action( 'edit_form_advanced', 'wp_remember_old_slug'       );
 224 add_action( 'init',               '_show_post_preview'         );
 225
 226 // Timezone
 227 add_filter( 'pre_option_gmt_offset','wp_timezone_override_offset' );