3 * Sets up the default filters and actions for most
4 * of the WordPress hooks.
6 * If you need to remove a default hook, this file will
7 * give you the priority for which to use to remove the
10 * Not all of the default hooks are found in default-filters.php
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 );
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 ) {
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' );
29 add_filter( $filter, '_wp_specialchars', 30 );
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' );
37 // Kses only for textarea admin displays
39 foreach ( array( 'term_description', 'link_description', 'link_notes', 'user_description' ) as $filter ) {
40 add_filter( $filter, 'wp_kses_data' );
42 add_filter( 'comment_text', 'wp_kses_post' );
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' );
52 // Email admin display
53 foreach ( array( 'comment_author_email', 'user_email' ) as $filter ) {
54 add_filter( $filter, 'sanitize_email' );
56 add_filter( $filter, 'wp_kses_data' );
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' );
68 foreach ( array( 'user_url', 'link_url', 'link_image', 'link_rss', 'comment_url', 'post_guid' ) as $filter ) {
70 add_filter( $filter, 'wp_strip_all_tags' );
71 add_filter( $filter, 'esc_url' );
73 add_filter( $filter, 'wp_kses_data' );
77 add_filter( 'pre_term_slug', 'sanitize_title' );
80 foreach ( array( 'pre_post_type', 'pre_post_status', 'pre_post_comment_status', 'pre_post_ping_status' ) as $filter ) {
81 add_filter( $filter, 'sanitize_key' );
85 add_filter( 'pre_post_mime_type', 'sanitize_mime_type' );
86 add_filter( 'post_mime_type', 'sanitize_mime_type' );
88 // Places to balance tags on input
89 foreach ( array( 'content_save_pre', 'excerpt_save_pre', 'comment_save_pre', 'pre_comment_content' ) as $filter ) {
90 add_filter( $filter, 'convert_invalid_entities' );
91 add_filter( $filter, 'balanceTags', 50 );
94 // Format strings for display.
95 foreach ( array( 'comment_author', 'term_name', 'link_name', 'link_description', 'link_notes', 'bloginfo', 'wp_title', 'widget_title' ) as $filter ) {
96 add_filter( $filter, 'wptexturize' );
97 add_filter( $filter, 'convert_chars' );
98 add_filter( $filter, 'esc_html' );
102 foreach ( array( 'the_content', 'the_title', 'wp_title' ) as $filter )
103 add_filter( $filter, 'capital_P_dangit', 11 );
104 add_filter( 'comment_text', 'capital_P_dangit', 31 );
107 foreach ( array( 'single_post_title', 'single_cat_title', 'single_tag_title', 'single_month_title', 'nav_menu_attr_title', 'nav_menu_description' ) as $filter ) {
108 add_filter( $filter, 'wptexturize' );
109 add_filter( $filter, 'strip_tags' );
112 // Format text area for display.
113 foreach ( array( 'term_description' ) as $filter ) {
114 add_filter( $filter, 'wptexturize' );
115 add_filter( $filter, 'convert_chars' );
116 add_filter( $filter, 'wpautop' );
117 add_filter( $filter, 'shortcode_unautop');
121 add_filter( 'term_name_rss', 'convert_chars' );
123 // Pre save hierarchy
124 add_filter( 'wp_insert_post_parent', 'wp_check_post_hierarchy_for_loops', 10, 2 );
125 add_filter( 'wp_update_term_parent', 'wp_check_term_hierarchy_for_loops', 10, 3 );
128 add_filter( 'the_title', 'wptexturize' );
129 add_filter( 'the_title', 'convert_chars' );
130 add_filter( 'the_title', 'trim' );
132 add_filter( 'the_content', 'wptexturize' );
133 add_filter( 'the_content', 'convert_smilies' );
134 add_filter( 'the_content', 'wpautop' );
135 add_filter( 'the_content', 'shortcode_unautop' );
136 add_filter( 'the_content', 'prepend_attachment' );
137 add_filter( 'the_content', 'wp_make_content_images_responsive' );
139 add_filter( 'the_excerpt', 'wptexturize' );
140 add_filter( 'the_excerpt', 'convert_smilies' );
141 add_filter( 'the_excerpt', 'convert_chars' );
142 add_filter( 'the_excerpt', 'wpautop' );
143 add_filter( 'the_excerpt', 'shortcode_unautop');
144 add_filter( 'get_the_excerpt', 'wp_trim_excerpt' );
146 add_filter( 'comment_text', 'wptexturize' );
147 add_filter( 'comment_text', 'convert_chars' );
148 add_filter( 'comment_text', 'make_clickable', 9 );
149 add_filter( 'comment_text', 'force_balance_tags', 25 );
150 add_filter( 'comment_text', 'convert_smilies', 20 );
151 add_filter( 'comment_text', 'wpautop', 30 );
153 add_filter( 'comment_excerpt', 'convert_chars' );
155 add_filter( 'list_cats', 'wptexturize' );
157 add_filter( 'wp_sprintf', 'wp_sprintf_l', 10, 2 );
159 add_filter( 'widget_text', 'balanceTags' );
161 add_filter( 'date_i18n', 'wp_maybe_decline_date' );
164 add_filter( 'the_title_rss', 'strip_tags' );
165 add_filter( 'the_title_rss', 'ent2ncr', 8 );
166 add_filter( 'the_title_rss', 'esc_html' );
167 add_filter( 'the_content_rss', 'ent2ncr', 8 );
168 add_filter( 'the_content_feed', 'wp_staticize_emoji' );
169 add_filter( 'the_content_feed', '_oembed_filter_feed_content' );
170 add_filter( 'the_excerpt_rss', 'convert_chars' );
171 add_filter( 'the_excerpt_rss', 'ent2ncr', 8 );
172 add_filter( 'comment_author_rss', 'ent2ncr', 8 );
173 add_filter( 'comment_text_rss', 'ent2ncr', 8 );
174 add_filter( 'comment_text_rss', 'esc_html' );
175 add_filter( 'comment_text_rss', 'wp_staticize_emoji' );
176 add_filter( 'bloginfo_rss', 'ent2ncr', 8 );
177 add_filter( 'the_author', 'ent2ncr', 8 );
178 add_filter( 'the_guid', 'esc_url' );
181 add_filter( 'wp_mail', 'wp_staticize_emoji_for_email' );
184 add_filter( 'option_ping_sites', 'privacy_ping_filter' );
185 add_filter( 'option_blog_charset', '_wp_specialchars' ); // IMPORTANT: This must not be wp_specialchars() or esc_html() or it'll cause an infinite loop
186 add_filter( 'option_blog_charset', '_canonical_charset' );
187 add_filter( 'option_home', '_config_wp_home' );
188 add_filter( 'option_siteurl', '_config_wp_siteurl' );
189 add_filter( 'tiny_mce_before_init', '_mce_set_direction' );
190 add_filter( 'teeny_mce_before_init', '_mce_set_direction' );
191 add_filter( 'pre_kses', 'wp_pre_kses_less_than' );
192 add_filter( 'sanitize_title', 'sanitize_title_with_dashes', 10, 3 );
193 add_action( 'check_comment_flood', 'check_comment_flood_db', 10, 3 );
194 add_filter( 'comment_flood_filter', 'wp_throttle_comment_flood', 10, 3 );
195 add_filter( 'pre_comment_content', 'wp_rel_nofollow', 15 );
196 add_filter( 'comment_email', 'antispambot' );
197 add_filter( 'option_tag_base', '_wp_filter_taxonomy_base' );
198 add_filter( 'option_category_base', '_wp_filter_taxonomy_base' );
199 add_filter( 'the_posts', '_close_comments_for_old_posts', 10, 2);
200 add_filter( 'comments_open', '_close_comments_for_old_post', 10, 2 );
201 add_filter( 'pings_open', '_close_comments_for_old_post', 10, 2 );
202 add_filter( 'editable_slug', 'urldecode' );
203 add_filter( 'editable_slug', 'esc_textarea' );
204 add_filter( 'nav_menu_meta_box_object', '_wp_nav_menu_meta_box_object' );
205 add_filter( 'pingback_ping_source_uri', 'pingback_ping_source_uri' );
206 add_filter( 'xmlrpc_pingback_error', 'xmlrpc_pingback_error' );
207 add_filter( 'title_save_pre', 'trim' );
209 add_filter( 'http_request_host_is_external', 'allowed_http_request_hosts', 10, 2 );
212 add_action( 'xmlrpc_rsd_apis', 'rest_output_rsd' );
213 add_action( 'wp_head', 'rest_output_link_wp_head', 10, 0 );
214 add_action( 'template_redirect', 'rest_output_link_header', 11, 0 );
215 add_action( 'auth_cookie_malformed', 'rest_cookie_collect_status' );
216 add_action( 'auth_cookie_expired', 'rest_cookie_collect_status' );
217 add_action( 'auth_cookie_bad_username', 'rest_cookie_collect_status' );
218 add_action( 'auth_cookie_bad_hash', 'rest_cookie_collect_status' );
219 add_action( 'auth_cookie_valid', 'rest_cookie_collect_status' );
220 add_filter( 'rest_authentication_errors', 'rest_cookie_check_errors', 100 );
223 add_action( 'wp_head', '_wp_render_title_tag', 1 );
224 add_action( 'wp_head', 'wp_enqueue_scripts', 1 );
225 add_action( 'wp_head', 'feed_links', 2 );
226 add_action( 'wp_head', 'feed_links_extra', 3 );
227 add_action( 'wp_head', 'rsd_link' );
228 add_action( 'wp_head', 'wlwmanifest_link' );
229 add_action( 'wp_head', 'adjacent_posts_rel_link_wp_head', 10, 0 );
230 add_action( 'wp_head', 'locale_stylesheet' );
231 add_action( 'publish_future_post', 'check_and_publish_future_post', 10, 1 );
232 add_action( 'wp_head', 'noindex', 1 );
233 add_action( 'wp_head', 'print_emoji_detection_script', 7 );
234 add_action( 'wp_head', 'wp_print_styles', 8 );
235 add_action( 'wp_head', 'wp_print_head_scripts', 9 );
236 add_action( 'wp_head', 'wp_generator' );
237 add_action( 'wp_head', 'rel_canonical' );
238 add_action( 'wp_head', 'wp_shortlink_wp_head', 10, 0 );
239 add_action( 'wp_head', 'wp_site_icon', 99 );
240 add_action( 'wp_footer', 'wp_print_footer_scripts', 20 );
241 add_action( 'template_redirect', 'wp_shortlink_header', 11, 0 );
242 add_action( 'wp_print_footer_scripts', '_wp_footer_scripts' );
243 add_action( 'init', 'check_theme_switched', 99 );
244 add_action( 'after_switch_theme', '_wp_sidebars_changed' );
245 add_action( 'wp_print_styles', 'print_emoji_styles' );
247 if ( isset( $_GET['replytocom'] ) )
248 add_action( 'wp_head', 'wp_no_robots' );
251 add_action( 'login_head', 'wp_print_head_scripts', 9 );
252 add_action( 'login_head', 'wp_site_icon', 99 );
253 add_action( 'login_footer', 'wp_print_footer_scripts', 20 );
254 add_action( 'login_init', 'send_frame_options_header', 10, 0 );
256 // Feed Generator Tags
257 foreach ( array( 'rss2_head', 'commentsrss2_head', 'rss_head', 'rdf_header', 'atom_head', 'comments_atom_head', 'opml_head', 'app_head' ) as $action ) {
258 add_action( $action, 'the_generator' );
262 add_action( 'atom_head', 'atom_site_icon' );
263 add_action( 'rss2_head', 'rss2_site_icon' );
267 if ( !defined( 'DOING_CRON' ) )
268 add_action( 'init', 'wp_cron' );
270 // 2 Actions 2 Furious
271 add_action( 'do_feed_rdf', 'do_feed_rdf', 10, 1 );
272 add_action( 'do_feed_rss', 'do_feed_rss', 10, 1 );
273 add_action( 'do_feed_rss2', 'do_feed_rss2', 10, 1 );
274 add_action( 'do_feed_atom', 'do_feed_atom', 10, 1 );
275 add_action( 'do_pings', 'do_all_pings', 10, 1 );
276 add_action( 'do_robots', 'do_robots' );
277 add_action( 'set_comment_cookies', 'wp_set_comment_cookies', 10, 2 );
278 add_action( 'sanitize_comment_cookies', 'sanitize_comment_cookies' );
279 add_action( 'admin_print_scripts', 'print_emoji_detection_script' );
280 add_action( 'admin_print_scripts', 'print_head_scripts', 20 );
281 add_action( 'admin_print_footer_scripts', '_wp_footer_scripts' );
282 add_action( 'admin_print_styles', 'print_emoji_styles' );
283 add_action( 'admin_print_styles', 'print_admin_styles', 20 );
284 add_action( 'init', 'smilies_init', 5 );
285 add_action( 'plugins_loaded', 'wp_maybe_load_widgets', 0 );
286 add_action( 'plugins_loaded', 'wp_maybe_load_embeds', 0 );
287 add_action( 'shutdown', 'wp_ob_end_flush_all', 1 );
288 // Create a revision whenever a post is updated.
289 add_action( 'post_updated', 'wp_save_post_revision', 10, 1 );
290 add_action( 'publish_post', '_publish_post_hook', 5, 1 );
291 add_action( 'transition_post_status', '_transition_post_status', 5, 3 );
292 add_action( 'transition_post_status', '_update_term_count_on_transition_post_status', 10, 3 );
293 add_action( 'comment_form', 'wp_comment_form_unfiltered_html_nonce' );
294 add_action( 'wp_scheduled_delete', 'wp_scheduled_delete' );
295 add_action( 'wp_scheduled_auto_draft_delete', 'wp_delete_auto_drafts' );
296 add_action( 'admin_init', 'send_frame_options_header', 10, 0 );
297 add_action( 'importer_scheduled_cleanup', 'wp_delete_attachment' );
298 add_action( 'upgrader_scheduled_cleanup', 'wp_delete_attachment' );
299 add_action( 'welcome_panel', 'wp_welcome_panel' );
301 // Navigation menu actions
302 add_action( 'delete_post', '_wp_delete_post_menu_item' );
303 add_action( 'delete_term', '_wp_delete_tax_menu_item', 10, 3 );
304 add_action( 'transition_post_status', '_wp_auto_add_pages_to_menu', 10, 3 );
306 // Post Thumbnail CSS class filtering
307 add_action( 'begin_fetch_post_thumbnail_html', '_wp_post_thumbnail_class_filter_add' );
308 add_action( 'end_fetch_post_thumbnail_html', '_wp_post_thumbnail_class_filter_remove' );
310 // Redirect Old Slugs
311 add_action( 'template_redirect', 'wp_old_slug_redirect' );
312 add_action( 'post_updated', 'wp_check_for_changed_slugs', 12, 3 );
313 add_action( 'attachment_updated', 'wp_check_for_changed_slugs', 12, 3 );
315 // Nonce check for Post Previews
316 add_action( 'init', '_show_post_preview' );
318 // Output JS to reset window.name for previews
319 add_action( 'wp_head', 'wp_post_preview_js', 1 );
322 add_filter( 'pre_option_gmt_offset','wp_timezone_override_offset' );
324 // Admin Color Schemes
325 add_action( 'admin_init', 'register_admin_color_schemes', 1);
326 add_action( 'admin_color_scheme_picker', 'admin_color_scheme_picker' );
328 // If the upgrade hasn't run yet, assume link manager is used.
329 add_filter( 'default_option_link_manager_enabled', '__return_true' );
331 // This option no longer exists; tell plugins we always support auto-embedding.
332 add_filter( 'default_option_embed_autourls', '__return_true' );
334 // Default settings for heartbeat
335 add_filter( 'heartbeat_settings', 'wp_heartbeat_settings' );
337 // Check if the user is logged out
338 add_action( 'admin_enqueue_scripts', 'wp_auth_check_load' );
339 add_filter( 'heartbeat_send', 'wp_auth_check' );
340 add_filter( 'heartbeat_nopriv_send', 'wp_auth_check' );
342 // Default authentication filters
343 add_filter( 'authenticate', 'wp_authenticate_username_password', 20, 3 );
344 add_filter( 'authenticate', 'wp_authenticate_spam_check', 99 );
345 add_filter( 'determine_current_user', 'wp_validate_auth_cookie' );
346 add_filter( 'determine_current_user', 'wp_validate_logged_in_cookie', 20 );
348 // Split term updates.
349 add_action( 'admin_init', '_wp_check_for_scheduled_split_terms' );
350 add_action( 'split_shared_term', '_wp_check_split_default_terms', 10, 4 );
351 add_action( 'split_shared_term', '_wp_check_split_terms_in_menus', 10, 4 );
352 add_action( 'split_shared_term', '_wp_check_split_nav_menu_terms', 10, 4 );
353 add_action( 'wp_split_shared_term_batch', '_wp_batch_split_terms' );
355 // Email notifications.
356 add_action( 'comment_post', 'wp_new_comment_notify_moderator' );
357 add_action( 'comment_post', 'wp_new_comment_notify_postauthor' );
358 add_action( 'after_password_reset', 'wp_password_change_notification' );
359 add_action( 'register_new_user', 'wp_send_new_user_notifications' );
360 add_action( 'edit_user_created_user', 'wp_send_new_user_notifications', 10, 2 );
363 add_action( 'init', 'rest_api_init' );
364 add_action( 'rest_api_init', 'rest_api_default_filters', 10, 1 );
365 add_action( 'parse_request', 'rest_api_loaded' );
368 * Filters formerly mixed into wp-includes
371 add_action( 'wp_loaded', '_custom_header_background_just_in_time' );
372 add_action( 'plugins_loaded', '_wp_customize_include' );
373 add_action( 'admin_enqueue_scripts', '_wp_customize_loader_settings' );
374 add_action( 'delete_attachment', '_delete_attachment_theme_mod' );
376 // Calendar widget cache
377 add_action( 'save_post', 'delete_get_calendar_cache' );
378 add_action( 'delete_post', 'delete_get_calendar_cache' );
379 add_action( 'update_option_start_of_week', 'delete_get_calendar_cache' );
380 add_action( 'update_option_gmt_offset', 'delete_get_calendar_cache' );
383 add_action( 'transition_post_status', '__clear_multi_author_cache' );
386 add_action( 'init', 'create_initial_post_types', 0 ); // highest priority
387 add_action( 'admin_menu', '_add_post_type_submenus' );
388 add_action( 'before_delete_post', '_reset_front_page_settings_for_post' );
389 add_action( 'wp_trash_post', '_reset_front_page_settings_for_post' );
392 add_filter( 'request', '_post_format_request' );
393 add_filter( 'term_link', '_post_format_link', 10, 3 );
394 add_filter( 'get_post_format', '_post_format_get_term' );
395 add_filter( 'get_terms', '_post_format_get_terms', 10, 3 );
396 add_filter( 'wp_get_object_terms', '_post_format_wp_get_object_terms' );
399 add_action( 'init', 'kses_init' );
400 add_action( 'set_current_user', 'kses_init' );
403 add_action( 'wp_default_scripts', 'wp_default_scripts' );
404 add_filter( 'wp_print_scripts', 'wp_just_in_time_script_localization' );
405 add_filter( 'print_scripts_array', 'wp_prototype_before_jquery' );
407 add_action( 'wp_default_styles', 'wp_default_styles' );
408 add_filter( 'style_loader_src', 'wp_style_loader_src', 10, 2 );
411 add_action( 'init', 'create_initial_taxonomies', 0 ); // highest priority
414 add_action( 'template_redirect', 'redirect_canonical' );
415 add_action( 'template_redirect', 'wp_redirect_admin_locations', 1000 );
418 add_filter( 'the_content', 'do_shortcode', 11 ); // AFTER wpautop()
421 add_action( 'wp_playlist_scripts', 'wp_playlist_scripts' );
422 add_action( 'customize_controls_enqueue_scripts', 'wp_plupload_default_settings' );
425 add_filter( 'nav_menu_item_id', '_nav_menu_item_id_use_once', 10, 2 );
428 add_action( 'init', 'wp_widgets_init', 1 );
431 // Don't remove. Wrong way to disable.
432 add_action( 'template_redirect', '_wp_admin_bar_init', 0 );
433 add_action( 'admin_init', '_wp_admin_bar_init' );
434 add_action( 'before_signup_header', '_wp_admin_bar_init' );
435 add_action( 'activate_header', '_wp_admin_bar_init' );
436 add_action( 'wp_footer', 'wp_admin_bar_render', 1000 );
437 add_action( 'in_admin_header', 'wp_admin_bar_render', 0 );
439 // Former admin filters that can also be hooked on the front end
440 add_action( 'media_buttons', 'media_buttons' );
441 add_filter( 'image_send_to_editor', 'image_add_caption', 20, 8 );
442 add_filter( 'media_send_to_editor', 'image_media_send_to_editor', 10, 3 );
445 add_action( 'rest_api_init', 'wp_oembed_register_route' );
446 add_filter( 'rest_pre_serve_request', '_oembed_rest_pre_serve_request', 10, 4 );
448 add_action( 'wp_head', 'wp_oembed_add_discovery_links' );
449 add_action( 'wp_head', 'wp_oembed_add_host_js' );
451 add_action( 'embed_head', 'enqueue_embed_scripts', 1 );
452 add_action( 'embed_head', 'print_emoji_detection_script' );
453 add_action( 'embed_head', 'print_embed_styles' );
454 add_action( 'embed_head', 'wp_print_head_scripts', 20 );
455 add_action( 'embed_head', 'wp_print_styles', 20 );
456 add_action( 'embed_head', 'wp_no_robots' );
457 add_action( 'embed_head', 'rel_canonical' );
458 add_action( 'embed_head', 'locale_stylesheet' );
460 add_action( 'embed_content_meta', 'print_embed_comments_button' );
461 add_action( 'embed_content_meta', 'print_embed_sharing_button' );
463 add_action( 'embed_footer', 'print_embed_sharing_dialog' );
464 add_action( 'embed_footer', 'print_embed_scripts' );
465 add_action( 'embed_footer', 'wp_print_footer_scripts', 20 );
467 add_filter( 'excerpt_more', 'wp_embed_excerpt_more', 20 );
468 add_filter( 'the_excerpt_embed', 'wptexturize' );
469 add_filter( 'the_excerpt_embed', 'convert_chars' );
470 add_filter( 'the_excerpt_embed', 'wpautop' );
471 add_filter( 'the_excerpt_embed', 'shortcode_unautop' );
472 add_filter( 'the_excerpt_embed', 'wp_embed_excerpt_attachment' );
474 add_filter( 'oembed_dataparse', 'wp_filter_oembed_result', 10, 3 );
475 add_filter( 'oembed_response_data', 'get_oembed_response_data_rich', 10, 4 );
477 unset( $filter, $action );