《Wordpress 50个过滤钩子》 1-10
过滤钩子是一类函数，wordpress执行传递和处理数据的过程中，在针对这些数据做出某些动作之前的特定点执行。本质上，就是在wordpress输出之前，将对浏览数据做出反应。
添加过滤钩子： add_filter($tag, $function_to_add, $piority, $accepted_tags);
参数解释： $tag(必须)：过滤钩子的名称
$funciton_to_add(必须): 要挂载的函数名。
$piority: 整数，判断函数什么时候执行，默认是10，数值越低，优先级越高。
$accepted_tages: 整数，默认是1，设置接收参数的个数。
移除过滤钩子：remove_filter($tag, $function_to_remove, $piority)
应用钩子： apply_filter($tag, $value, $var1, $var2,....)
参数解释： $tag(必须):钩子的名称
$value(必须): 通过add_filter()挂载的过滤函数要修改的值
1. log_errors: 改变默认登录错误信息
默认的错误信息显得比较啰嗦，如果需要简单的错误信息，可以使用该过滤钩子对错误信息进行修改然后返回。
<?php
add_filter( 'login_errors', 'login_errors_example' );
function login_errors_example( $error ) {
$error = 'this is the modified error';
return $error;
}
?>
这样，当登录失败的时候，就会显示 this is the modified error
2. comment_post_redirect: 更改提交评论后的显示页面
当用户提交完评论后，默认是留在同一页面的，当你有需求在评论后跳转到另外一个页面时，可以用这个钩子进行页面指定。
<?php
add_filter( 'comment_post_redirect', 'comment_post_redirect_example' );
function comment_post_redirect_example( $location ) {
return '/thanks-for-your-comment/';
}
?>
$location是默认的页面地址。
3. allowed_redirect_hosts：增加wp_safe_redirect()允许访问的地址。
默认情况下，wp_safe_redirect()函数仅仅允许站内访问，如果想要实现其他的地址访问，可以用这个钩子来添加地址。
<?php
add_filter( 'allowed_redirect_hosts', 'allowed_redirect_hosts_example' );
function allowed_redirect_hosts_example( $content ) {
$content[] = 'forum.mywebsite.com';
$content[] = 'welcome.mywebsite.com';
$content[] = 'help.mywebsite.com';
return $content;
}
// Example source: http://codex.wordpress.org/Plugin_API/Filter_Reference/allowed_redirect_hosts
?>
$content是数组，存储着允许访问站点的地址。
4.body_class: 给<body>标签加css类。
如果需要给特定的页面指定css的时候，可以通过该钩子给body标签加上css类。
<?php
add_filter( 'body_class', 'body_class_example' );
function body_class_example( $classes ) {
if( is_single() ) {
foreach( get_the_category( get_the_ID() ) as $category )
$classes[] = 'cat-' . $category->category_nicename;
}
return $classes;
}
// Example source: https://codex.wordpress.org/Function_Reference/body_class#Add_Classes_By_Filters
?>
5.locale:改变地区(针对翻译功能).
通过该钩子，可以改变地区从而让系统改变读取的翻译文件。
<?php
add_filter( 'locale', 'locale_example' );
function locale_example( $lang ) {
if ( 'tr' == $_GET['language'] ) {
return 'tr_TR';
} else {
return $lang;
}
}
// Example source: http://codex.wordpress.org/Plugin_API/Filter_Reference/locale
?>
6.sanitize_user:过滤username
通过该钩子，可以对用户登录时输入的username进行操作，如转换为小写，字符检查等。
<?php add_filter( 'sanitize_user', 'strtolower' ); // Example source: http://codex.wordpress.org/Plugin_API/Filter_Reference/sanitize_user ?>
7.the_content:过滤post的内容
对于post的内容，如果需要进行操作，如字符串替换，给文章插入标记等等。可以使用该过滤钩子
<?php
add_filter( 'the_content', 'the_content_example' );
function the_content_example( $content ) {
return preg_replace('/<p>\s*(<a .*>)?\s*(<img .* \/>)\s*(<\/a>)?\s*<\/p>/iU', '\1\2\3', $content);
}
// Example source: http://wpsnipp.com/index.php/functions-php/remove-p-tag-from-around-images-in-the_content/
?>
8.the_password_form:过滤password form
对于带有密码保护的post, wordpress会自定将其替换为password form， 使用该钩子你可以访问和自定义这个form.
<?php
add_filter( 'the_password_form', 'the_password_form_example' );
function the_password_form_example() {
$output = '<form action="' . esc_url( site_url( 'wp-login.php?action=postpass', 'login_post' ) ) . '" method="post">';
$output .= '<span>' . __( "Enter the password:" ) . ' </span>';
$output .= '<input name="post_password" type="password" size="20" />';
$output .= '<input type="submit" name="Submit" value="' . esc_attr__( "Go" ) . '" />';
$output .= '</form>';
return $output;
}
// Example source: http://codex.wordpress.org/Using_Password_Protection#Password_Form_Text
?>
9.the_terms: 过滤the_trems() 函数。
使用该钩子可以过滤函数the_terms()的输出，例如去除其中的标签：
<?php add_filter( 'the_terms', 'strip_tags' ); ?>
10. wp_mail_from: 改变邮箱发件人的地址。
如果你想使用wordpress 发送邮件功能时改变发件人的地址，用该钩子就可以实现。
<?php
add_filter( 'wp_mail_from', 'wp_mail_from_example' );
function wp_mail_from_example( $email ) {
return 'my.email.address@mywebsite.com';
}
?>
英文原文：http://code.tutsplus.com/tutorials/50-filters-of-wordpress-the-first-10-filters--cms-21295