在上一篇文章中,我们介绍了WordPress 世界的过滤器;本篇文章的话我们将要探索50个笔者精选的过滤器,并一一通过例子解释其如何工作的。
事不宜迟,让我们开始吧!
本文为系列第二篇,原文:50 Filters of WordPress: The First 10 Filters 原文地址
本系列文章翻译自tutsplus,原作者为baris-unver,翻译人:Jeff,转载请注明原始来源及翻译人,谢谢!
本文若有修正,不会更新于本页,只会更新到Github项目地址上。
修改默认的登录报错信息
默认的话,WordPress 对于登录报错上的提示提供了太多的信息了,比如说如果用户名对但密码不对的话会如下提示:“用户名xxx所对应输入的密码不正确”——无疑,如果你的网站被黑客盯上了的话这是很危险的,因为这意味着黑客可以通过多次尝试获取到用户名甚至是密码。因此非常有必要禁止这类报错信息。
例子:移除登录报错提示信息
我们需要做的就是删除报错的那段文字对应的字符串即可:
<?php
add_filter( 'login_errors', 'login_errors_example' );
function login_errors_example( $error ) {
$error = '';
return $error;
}
?>
重定向评论者的url到作者页面
在WordPress 中发表评论后,你将停留在当前页面上——当然,本身这是个符合逻辑的方式,但如果你想在成功发表评论后将评论者的url 重定向到作者页面该怎么做?
在comment_post_redirect
函数下刀:
<?php
add_filter( 'comment_post_redirect', 'comment_post_redirect_example' );
function comment_post_redirect_example( $location ) {
return '/thanks-for-your-comment/';
}
?>
为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
?>
为<body>
标签添加自定义CSS类
WordPress 的body_class()
函数是一个非常不错的函数。它在不同的页面情况下提供了不同的相应语义化的CSS 标签,使得你的CSS 能更有效率。同样的,通过“过滤”body_class()
函数,你可以添加后删除相关的类。
例子:为<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
?>
上面的代码实现的效果是:当你有一个分类名称为“world”,那么在该分类的页面下你会在<body>
标签中发现 .cat-world
这个类。
修改本地化语言设置
作为一个在全球响当当的CMS,支持多语言当然早就成为标配了。locale
这个过滤器可以让我们在某些情况下设置语言。
例子:依据url 传递的参数自动设置网站语言
如果你有一个多语言网站,通过下面的代码,你就能轻易通过url参数来自动切换网站语言:
<?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
?>
这样,当访客访问类似mywebsite.com/?language=tr
的网址的时候,你的网站语言将改为土耳其语。当然,你写的文章是不会自动翻译的,你应该清楚吧?
过滤用户名的不安全字符
sanitize_user()
是WordPress 中一个用来清理用户名,去掉所有不安全的字符的函数,作为一个安全相关的函数,你可以进一步增强其安全规则。
例子:只接受小写形式的用户名
如果你不想接受有大写字母的用户名(比如说"SHOUTINGBOY88" 或者 "CrazyGirl92"),你可以使用PHP的strtolower
函数来hook 这个sanitize_user
函数:
<?php
add_filter( 'sanitize_user', 'strtolower' );
// Example source: http://codex.wordpress.org/Plugin_API/Filter_Reference/sanitize_user
?>
过滤文章的文本内容
这个就不用多介绍了,用到的是the_content
的函数,直接上例子:
例子:移除包裹在<img>
标签上的<p>
标签
WordPress 默认并不允许我们单独在一个段落中展示图片——它会自动添加一个<p>
到图片中,如果你想移除之可以用下面的代码:
<?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/
?>
过滤密码保护文章的表单提示
对于设置了密码保护的文章,在前端页面WordPress 会显示为一个密码填写的表单。如果你需要,可以自定义这个表单的显示情况,过滤的是the_password_form
函数。
例子:简化密码输入表单
默认的话,WordPress输出的提示文字是“This content is password protected. To view it please enter your password below:”,下面给出一个简化整个表单的例子:
<?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
?>
经过上面的代码作用,整个输入表单仅仅剩下三个单词,一个密码输入框跟提交按钮。怎样,够简洁吧?
过滤 the_terms()
函数
如果你不满意默认输出的the_terms()
函数,或者说你想将这个函数用于另外的目的(待修改),那么你可以做一样的工作,且看下面的例子:
例子:从the_terms()
函数移除HTML标签
下面找个函数可以让the_terms()
函数在输出时候不包括HTML标签(纯文本),顺带一提,strip_tags
是PHP 中剥去 HTML、XML 以及 PHP 的标签的函数。
<?php
add_filter( 'the_terms', 'strip_tags' );
?>
修改发送端的默认的Email 地址
当WordPress 程序发送邮件的时候,它会使用类似的邮箱地址作为发送人。借助下面找个过滤器,你可以修改它。
自定义发送人的Email 地址
<?php
add_filter( 'wp_mail_from', 'wp_mail_from_example' );
function wp_mail_from_example( $email ) {
return 'my.email.address@mywebsite.com';
}
?>
同样的逻辑,你只要自定义返回的参数的值,你就可以自定义为你需要的用户名了。
总结
当你看完这篇文章,希望你能学到不少东西!下一篇文章再见!