web/wp-includes/default-filters.php
changeset 136 bde1974c263b
child 194 32102edaa81b
equal deleted inserted replaced
135:53cff4b4a802 136:bde1974c263b
       
     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' );