[ Index ]

PHP Cross Reference of WordPress

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 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      if ( is_admin() ) {
  25          // These are expensive. Run only on admin pages for defense in depth.
  26          add_filter( $filter, 'sanitize_text_field'  );
  27          add_filter( $filter, 'wp_kses_data'       );
  28      }
  29      add_filter( $filter, '_wp_specialchars', 30 );
  30  }
  31  
  32  // Kses only for textarea saves
  33  foreach ( array( 'pre_term_description', 'pre_link_description', 'pre_link_notes', 'pre_user_description' ) as $filter ) {
  34      add_filter( $filter, 'wp_filter_kses' );
  35  }
  36  
  37  // Kses only for textarea admin displays
  38  if ( is_admin() ) {
  39      foreach ( array( 'term_description', 'link_description', 'link_notes', 'user_description' ) as $filter ) {
  40          add_filter( $filter, 'wp_kses_data' );
  41      }
  42      add_filter( 'comment_text', 'wp_kses_post' );
  43  }
  44  
  45  // Email saves
  46  foreach ( array( 'pre_comment_author_email', 'pre_user_email' ) as $filter ) {
  47      add_filter( $filter, 'trim'           );
  48      add_filter( $filter, 'sanitize_email' );
  49      add_filter( $filter, 'wp_filter_kses' );
  50  }
  51  
  52  // Email admin display
  53  foreach ( array( 'comment_author_email', 'user_email' ) as $filter ) {
  54      add_filter( $filter, 'sanitize_email' );
  55      if ( is_admin() )
  56          add_filter( $filter, 'wp_kses_data' );
  57  }
  58  
  59  // Save URL
  60  foreach ( array( 'pre_comment_author_url', 'pre_user_url', 'pre_link_url', 'pre_link_image',
  61      'pre_link_rss', 'pre_post_guid' ) as $filter ) {
  62      add_filter( $filter, 'wp_strip_all_tags' );
  63      add_filter( $filter, 'esc_url_raw'       );
  64      add_filter( $filter, 'wp_filter_kses'    );
  65  }
  66  
  67  // Display URL
  68  foreach ( array( 'user_url', 'link_url', 'link_image', 'link_rss', 'comment_url', 'post_guid' ) as $filter ) {
  69      if ( is_admin() )
  70          add_filter( $filter, 'wp_strip_all_tags' );
  71      add_filter( $filter, 'esc_url'           );
  72      if ( is_admin() )
  73          add_filter( $filter, 'wp_kses_data'    );
  74  }
  75  
  76  // Slugs
  77  foreach ( array( 'pre_term_slug' ) as $filter ) {
  78      add_filter( $filter, 'sanitize_title' );
  79  }
  80  
  81  // Keys
  82  foreach ( array( 'pre_post_type', 'pre_post_status', 'pre_post_comment_status', 'pre_post_ping_status' ) as $filter ) {
  83      add_filter( $filter, 'sanitize_key' );
  84  }
  85  
  86  // Mime types
  87  add_filter( 'pre_post_mime_type', 'sanitize_mime_type' );
  88  add_filter( 'post_mime_type', 'sanitize_mime_type' );
  89  
  90  // Places to balance tags on input
  91  foreach ( array( 'content_save_pre', 'excerpt_save_pre', 'comment_save_pre', 'pre_comment_content' ) as $filter ) {
  92      add_filter( $filter, 'balanceTags', 50 );
  93  }
  94  
  95  // Format strings for display.
  96  foreach ( array( 'comment_author', 'term_name', 'link_name', 'link_description', 'link_notes', 'bloginfo', 'wp_title', 'widget_title' ) as $filter ) {
  97      add_filter( $filter, 'wptexturize'   );
  98      add_filter( $filter, 'convert_chars' );
  99      add_filter( $filter, 'esc_html'      );
 100  }
 101  
 102  // Format WordPress
 103  foreach ( array( 'the_content', 'the_title' ) as $filter )
 104      add_filter( $filter, 'capital_P_dangit', 11 );
 105  add_filter( 'comment_text', 'capital_P_dangit', 31 );
 106  
 107  // Format titles
 108  foreach ( array( 'single_post_title', 'single_cat_title', 'single_tag_title', 'single_month_title', 'nav_menu_attr_title', 'nav_menu_description' ) as $filter ) {
 109      add_filter( $filter, 'wptexturize' );
 110      add_filter( $filter, 'strip_tags'  );
 111  }
 112  
 113  // Format text area for display.
 114  foreach ( array( 'term_description' ) as $filter ) {
 115      add_filter( $filter, 'wptexturize'      );
 116      add_filter( $filter, 'convert_chars'    );
 117      add_filter( $filter, 'wpautop'          );
 118      add_filter( $filter, 'shortcode_unautop');
 119  }
 120  
 121  // Format for RSS
 122  foreach ( array( 'term_name_rss' ) as $filter ) {
 123      add_filter( $filter, 'convert_chars' );
 124  }
 125  
 126  // Pre save hierarchy
 127  add_filter( 'wp_insert_post_parent', 'wp_check_post_hierarchy_for_loops', 10, 2 );
 128  add_filter( 'wp_update_term_parent', 'wp_check_term_hierarchy_for_loops', 10, 3 );
 129  
 130  // Display filters
 131  add_filter( 'the_title', 'wptexturize'   );
 132  add_filter( 'the_title', 'convert_chars' );
 133  add_filter( 'the_title', 'trim'          );
 134  
 135  add_filter( 'the_content', 'wptexturize'        );
 136  add_filter( 'the_content', 'convert_smilies'    );
 137  add_filter( 'the_content', 'convert_chars'      );
 138  add_filter( 'the_content', 'wpautop'            );
 139  add_filter( 'the_content', 'shortcode_unautop'  );
 140  add_filter( 'the_content', 'prepend_attachment' );
 141  
 142  add_filter( 'the_excerpt',     'wptexturize'      );
 143  add_filter( 'the_excerpt',     'convert_smilies'  );
 144  add_filter( 'the_excerpt',     'convert_chars'    );
 145  add_filter( 'the_excerpt',     'wpautop'          );
 146  add_filter( 'the_excerpt',     'shortcode_unautop');
 147  add_filter( 'get_the_excerpt', 'wp_trim_excerpt'  );
 148  
 149  add_filter( 'comment_text', 'wptexturize'            );
 150  add_filter( 'comment_text', 'convert_chars'          );
 151  add_filter( 'comment_text', 'make_clickable',      9 );
 152  add_filter( 'comment_text', 'force_balance_tags', 25 );
 153  add_filter( 'comment_text', 'convert_smilies',    20 );
 154  add_filter( 'comment_text', 'wpautop',            30 );
 155  
 156  add_filter( 'comment_excerpt', 'convert_chars' );
 157  
 158  add_filter( 'list_cats',         'wptexturize' );
 159  
 160  add_filter( 'wp_sprintf', 'wp_sprintf_l', 10, 2 );
 161  
 162  // RSS filters
 163  add_filter( 'the_title_rss',      'strip_tags'      );
 164  add_filter( 'the_title_rss',      'ent2ncr',      8 );
 165  add_filter( 'the_title_rss',      'esc_html'        );
 166  add_filter( 'the_content_rss',    'ent2ncr',      8 );
 167  add_filter( 'the_excerpt_rss',    'convert_chars'   );
 168  add_filter( 'the_excerpt_rss',    'ent2ncr',      8 );
 169  add_filter( 'comment_author_rss', 'ent2ncr',      8 );
 170  add_filter( 'comment_text_rss',   'ent2ncr',      8 );
 171  add_filter( 'comment_text_rss',   'esc_html'        );
 172  add_filter( 'bloginfo_rss',       'ent2ncr',      8 );
 173  add_filter( 'the_author',         'ent2ncr',      8 );
 174  
 175  // Misc filters
 176  add_filter( 'option_ping_sites',        'privacy_ping_filter'                 );
 177  add_filter( 'option_blog_charset',      '_wp_specialchars'                    ); // IMPORTANT: This must not be wp_specialchars() or esc_html() or it'll cause an infinite loop
 178  add_filter( 'option_home',              '_config_wp_home'                     );
 179  add_filter( 'option_siteurl',           '_config_wp_siteurl'                  );
 180  add_filter( 'tiny_mce_before_init',     '_mce_set_direction'                  );
 181  add_filter( 'pre_kses',                 'wp_pre_kses_less_than'               );
 182  add_filter( 'sanitize_title',           'sanitize_title_with_dashes',   10, 3 );
 183  add_action( 'check_comment_flood',      'check_comment_flood_db',       10, 3 );
 184  add_filter( 'comment_flood_filter',     'wp_throttle_comment_flood',    10, 3 );
 185  add_filter( 'pre_comment_content',      'wp_rel_nofollow',              15    );
 186  add_filter( 'comment_email',            'antispambot'                         );
 187  add_filter( 'option_tag_base',          '_wp_filter_taxonomy_base'            );
 188  add_filter( 'option_category_base',     '_wp_filter_taxonomy_base'            );
 189  add_filter( 'the_posts',                '_close_comments_for_old_posts', 10, 2);
 190  add_filter( 'comments_open',            '_close_comments_for_old_post', 10, 2 );
 191  add_filter( 'pings_open',               '_close_comments_for_old_post', 10, 2 );
 192  add_filter( 'editable_slug',            'urldecode'                           );
 193  add_filter( 'nav_menu_meta_box_object', '_wp_nav_menu_meta_box_object'        );
 194  
 195  // Actions
 196  add_action( 'wp_head',             'wp_enqueue_scripts',              1     );
 197  add_action( 'wp_head',             'feed_links',                      2     );
 198  add_action( 'wp_head',             'feed_links_extra',                3     );
 199  add_action( 'wp_head',             'rsd_link'                               );
 200  add_action( 'wp_head',             'wlwmanifest_link'                       );
 201  add_action( 'wp_head',             'adjacent_posts_rel_link_wp_head', 10, 0 );
 202  add_action( 'wp_head',             'locale_stylesheet'                      );
 203  add_action( 'publish_future_post', 'check_and_publish_future_post',   10, 1 );
 204  add_action( 'wp_head',             'noindex',                          1    );
 205  add_action( 'wp_head',             'wp_print_styles',                  8    );
 206  add_action( 'wp_head',             'wp_print_head_scripts',            9    );
 207  add_action( 'wp_head',             'wp_generator'                           );
 208  add_action( 'wp_head',             'rel_canonical'                          );
 209  add_action( 'wp_footer',           'wp_print_footer_scripts',         20    );
 210  add_action( 'wp_head',             'wp_shortlink_wp_head',            10, 0 );
 211  add_action( 'template_redirect',   'wp_shortlink_header',             11, 0 );
 212  add_action( 'wp_print_footer_scripts', '_wp_footer_scripts'                 );
 213  add_action( 'init',                'check_theme_switched',            99    );
 214  add_action( 'after_switch_theme',  '_wp_sidebars_changed'                   );
 215  
 216  if ( isset( $_GET['replytocom'] ) )
 217      add_action( 'wp_head', 'wp_no_robots' );
 218  
 219  // Login actions
 220  add_action( 'login_head',          'wp_print_head_scripts',         9     );
 221  add_action( 'login_footer',        'wp_print_footer_scripts',       20    );
 222  add_action( 'login_init',          'send_frame_options_header',     10, 0 );
 223  
 224  // Feed Generator Tags
 225  foreach ( array( 'rss2_head', 'commentsrss2_head', 'rss_head', 'rdf_header', 'atom_head', 'comments_atom_head', 'opml_head', 'app_head' ) as $action ) {
 226      add_action( $action, 'the_generator' );
 227  }
 228  
 229  // WP Cron
 230  if ( !defined( 'DOING_CRON' ) )
 231      add_action( 'init', 'wp_cron' );
 232  
 233  // 2 Actions 2 Furious
 234  add_action( 'do_feed_rdf',                'do_feed_rdf',                             10, 1 );
 235  add_action( 'do_feed_rss',                'do_feed_rss',                             10, 1 );
 236  add_action( 'do_feed_rss2',               'do_feed_rss2',                            10, 1 );
 237  add_action( 'do_feed_atom',               'do_feed_atom',                            10, 1 );
 238  add_action( 'do_pings',                   'do_all_pings',                            10, 1 );
 239  add_action( 'do_robots',                  'do_robots'                                      );
 240  add_action( 'set_comment_cookies',        'wp_set_comment_cookies',                  10, 2 );
 241  add_action( 'sanitize_comment_cookies',   'sanitize_comment_cookies'                       );
 242  add_action( 'admin_print_scripts',        'print_head_scripts',                      20    );
 243  add_action( 'admin_print_footer_scripts', '_wp_footer_scripts'                             );
 244  add_action( 'admin_print_styles',         'print_admin_styles',                      20    );
 245  add_action( 'init',                       'smilies_init',                             5    );
 246  add_action( 'plugins_loaded',             'wp_maybe_load_widgets',                    0    );
 247  add_action( 'plugins_loaded',             'wp_maybe_load_embeds',                     0    );
 248  add_action( 'shutdown',                   'wp_ob_end_flush_all',                      1    );
 249  add_action( 'pre_post_update',            'wp_save_post_revision'                          );
 250  add_action( 'publish_post',               '_publish_post_hook',                       5, 1 );
 251  add_action( 'save_post',                  '_save_post_hook',                          5, 2 );
 252  add_action( 'transition_post_status',     '_transition_post_status',                  5, 3 );
 253  add_action( 'transition_post_status',     '_update_term_count_on_transition_post_status', 10, 3 );
 254  add_action( 'comment_form',               'wp_comment_form_unfiltered_html_nonce'          );
 255  add_action( 'wp_scheduled_delete',        'wp_scheduled_delete'                            );
 256  add_action( 'wp_scheduled_auto_draft_delete', 'wp_delete_auto_drafts'                      );
 257  add_action( 'admin_init',                 'send_frame_options_header',               10, 0 );
 258  add_action( 'importer_scheduled_cleanup', 'wp_delete_attachment'                           );
 259  add_action( 'upgrader_scheduled_cleanup', 'wp_delete_attachment'                           );
 260  
 261  // Navigation menu actions
 262  add_action( 'delete_post',                '_wp_delete_post_menu_item'         );
 263  add_action( 'delete_term',                '_wp_delete_tax_menu_item'          );
 264  add_action( 'transition_post_status',     '_wp_auto_add_pages_to_menu', 10, 3 );
 265  
 266  // Post Thumbnail CSS class filtering
 267  add_action( 'begin_fetch_post_thumbnail_html', '_wp_post_thumbnail_class_filter_add'    );
 268  add_action( 'end_fetch_post_thumbnail_html',   '_wp_post_thumbnail_class_filter_remove' );
 269  
 270  // Redirect Old Slugs
 271  add_action( 'template_redirect', 'wp_old_slug_redirect'              );
 272  add_action( 'post_updated',      'wp_check_for_changed_slugs', 12, 3 );
 273  
 274  // Nonce check for Post Previews
 275  add_action( 'init', '_show_post_preview' );
 276  
 277  // Timezone
 278  add_filter( 'pre_option_gmt_offset','wp_timezone_override_offset' );
 279  
 280  // Admin Color Schemes
 281  add_action( 'admin_init', 'register_admin_color_schemes', 1);
 282  add_action( 'admin_color_scheme_picker', 'admin_color_scheme_picker' );
 283  
 284  unset($filter, $action);


Generated: Fri May 25 03:56:23 2012 Hosted by follow the white rabbit.