本文目录
[隐藏]
- 1过滤脚本文件资源
- 1.1样例:从脚本文件中移除版本参数
- 2增加HTML到特色图像Metabox
- 2.1样例:帮助用户正确设置特色图像
- 3使用钩子函数comment_flood_filter防范灌水评论攻击
- 3.1样例:加大允许访客评论的时间间隔
- 3.2样例:移除连续评论间隔时间审核机制
- 4修改“概览”部分的栏目
- 4.1样例:在“概览”栏目显示Events文章类型
- 5修改默认登录表单信息
- 5.1样例:修改默认的忘记密码提示信息
- 6修改批量更新信息
- 6.1样例:编辑自定义文章类型的提示信息
- 7过滤默认的分类小工具
- 7.1样例:从小工具中排除某些分类
- 8当用户注册成功后页面重定向
- 8.1样例:让新用户下载电子书
- 9更改评论表单字段
- 9.1移除表单的url 字段
- 10改变允许的上传文件类型
- 10.1样例:禁止上传gif 格式图片
- 11第五部分结语
本文是《50个 WordPress 过滤钩子》系列教程的第 6 部分,该系列共包含以下 7 个部分:
- 50个WordPress过滤钩子(介绍过滤钩子)
- 50个WordPress过滤钩子(1-10)
- 50个WordPress过滤钩子(11-20)
- 50个WordPress过滤钩子(21-30)
- 50个WordPress过滤钩子(31-40)
- 50个WordPress过滤钩子(41-50)
- 50个WordPress过滤钩子(总结)
在本系列的前面几个部分,我们已经学习了 40 个WordPress过滤钩子,下来我们继续学习所选的50个钩子的最后10个。
过滤脚本文件资源
WordPress 有自己的脚本文件加载方式,函数wp_enqueue_script()可以加载js文件而非硬编码方式引入,过滤钩子script_loader_src则处理脚本文件加载及输出的方式。
样例:从脚本文件中移除版本参数
Google Page Speed 或Yahoo YSlow 等网站性能检测工具都很讨厌JavaScript 文件中的url版本参数。当然,版本参数的存在是有一定道理的:URLs中的脚本文件版本参数不会保存在代理服务器缓存中 (详见:more info on this topic here),WordPress默认是允许使用版本参数的。但我们也可以使用下面的代码移除之。
1 2 3 4 5 6 7 8 9 10 11 12 13 |
<?php function script_loader_src_example( $src ) { return remove_query_arg( 'ver', $src ); } add_filter( 'script_loader_src', 'script_loader_src_example' ); // Tiny bonus: You can do it with styles, too! add_filter( 'style_loader_src', 'script_loader_src_example' ); // Example source: http://www.wpmayor.com/15-practical-ways-boost-wordpress-speed/ ?> |
就这样,脚本和CSS文件就不会再有任何的版本参数信息了。
如果你想学习更多的WordPress中的脚本知识,可参考http://code.tutsplus.com/articles/the-complete-guide-to-proper-javascript-usage-with-wordpres
增加HTML到特色图像Metabox
admin_post_thumbnail_html过滤钩子正如其名所示,允许在特色图像区域插入HTML 内容。插入的HTML 将显示在“设置特色图像”文字链接下面。
样例:帮助用户正确设置特色图像
例如你正在帮你的客户建立一个个人博客,他想自己维护博客而非雇佣助手,但却经常会忘记该如何添加特色图像,此时你便可以在撰写新文章页面设置帮助提示信息,代码如下:
1 2 3 4 5 6 7 8 9 10 |
<?php add_filter( 'admin_post_thumbnail_html', 'admin_post_thumbnail_html_example' ); function admin_post_thumbnail_html_example( $html ) { return $html .= '<p>Hi Mr. Smith! Click above to add an image to be displayed at the top of your post. Remember: <strong>The width of the image should be at least 900px</strong>!</p>'; } ?> |
有了这些帮助提示信息,他就再也不会忘记该如何设置最小宽度为900 pixels的特色图像了
使用钩子函数comment_flood_filter防范灌水评论攻击
WordPress一般会禁止访客的灌水式评论。例如:默认设置下,访客发表两篇评论的间隔时间必须超过15秒。下面的过滤钩子允许你改变这个时间间隔或者直接移除WordPress 评论审核机制。
样例:加大允许访客评论的时间间隔
如上文所述,WordPress禁止访客在15秒内连续评论,但是某些情况下,我们需要修改此时间间隔,比如60秒
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
<?php add_filter( 'comment_flood_filter', 'comment_flood_filter_example', 10, 3 ); function comment_flood_filter_example( $flood_control, $time_last, $time_new ) { $seconds = 60; if ( ( $time_new - $time_last ) < $seconds ) return true; return false; } // Example source: http://codex.wordpress.org/FAQ_Working_with_WordPress#How_do_I_prevent_comment_flooding.3F ?> |
可以将代码中的60秒改为你需要的时间。
样例:移除连续评论间隔时间审核机制
如果你不介意访客的灌水评论,可以直接使用下面两行代码将评论审核机制移除。
1 2 3 4 5 6 |
<?php remove_all_filters( 'comment_flood_filter' ); add_filter( 'comment_flood_filter', '__return_false', 10, 3 ); ?> |
注意到remove_all_filters()函数了吧,顾名思义,它可以移除评论审核机制。
修改“概览”部分的栏目
WordPress 的“概览”栏目可以让我们知道网站数据库中文章、页面和评论总体数量。过滤钩子dashboard_glance_items可以让其显示更多信息,比如指定分类的文章数。
样例:在“概览”栏目显示Events文章类型
例如有个“event blog”博客站点,有个名为“event ”的自定义文章类型,访客可据此了解当地发生的事件消息,为了统计博客中事件信息总数概况,便可以使用下面的函数并hook到dashboard_glance_items filter过滤钩子。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 |
<?php add_filter( 'dashboard_glance_items', 'dashboard_glance_items_example' ); function dashboard_glance_items_example( $items = array() ) { $post_types = array( 'event' ); foreach( $post_types as $type ) { if( ! post_type_exists( $type ) ) continue; $num_posts = wp_count_posts( $type ); if( $num_posts ) { $published = intval( $num_posts->publish ); $post_type = get_post_type_object( $type ); $text = _n( '%s ' . $post_type->labels->singular_name, '%s ' . $post_type->labels->name, $published, 'your_textdomain' ); $text = sprintf( $text, number_format_i18n( $published ) ); if ( current_user_can( $post_type->cap->edit_posts ) ) { $output = '<a href="edit.php?post_type='%20. $post_type->name . '">' . $text . '</a>'; echo '<li class="post-count ' . $post_type->name . '-count">' . $output . '</li>'; } else { $output = '<span>' . $text . '</span>'; echo '<li class="post-count ' . $post_type->name . '-count">' . $output . '</li>'; } } } return $items; } // Example source: http://www.trickspanda.com/2014/03/add-custom-post-types-glance-dashboard-widget-wordpress/ ?> |
很容易吧?对于其他自定义文章类型只需修改$post_types变量值即可满足需求。
修改默认登录表单信息
过滤钩子login_message允许自定义默认的输出信息(非系统错误信息)
样例:修改默认的忘记密码提示信息
如果想将忘记密码时的系统提示信息简化如下:请输入您的账号和邮箱地址,系统将发送一封重置密码的链接邮件。代码如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
<?php add_filter( 'login_message', 'login_message_example' ); function login_message_example( $message ) { $action = $_REQUEST['action']; if( $action == 'lostpassword' ) { $message = '<p class="message">Enter your email address, then check your inbox for the "reset password" link!</p>'; return $message; } return; } // Example source: http://www.pypelineweb.com/blog/change-wordpress-login-message-filter-it-out/ ?> |
在文件wp-login.php中有以下的action信息:
logout
lostpassword
andretreivepassword
(alias)resetpass
andrp
(alias)register
login
就像上面的样例,我们也可以为其他的action自定义不同的提示信息。
修改批量更新信息
当你更新、移动文章到回收站或者删除文章时有很多提示信息,若想批量修改这些信息,可以使用bulk_post_updated_messages过滤钩子。
样例:编辑自定义文章类型的提示信息
仍然以上述event 这个自定义文章类型为例,如果你不喜欢默认的提示信息,就可以这么做:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
<?php add_filter( 'bulk_post_updated_messages', 'bulk_post_updated_messages_example', 10, 2 ); function bulk_post_updated_messages_example( $bulk_messages, $bulk_counts ) { $bulk_messages['event'] = array( 'updated' => _n( '%s event updated.', '%s events updated.', $bulk_counts['updated'] ), 'locked' => _n( '%s event not updated, somebody is editing it.', '%s events not updated, somebody is editing them.', $bulk_counts['locked'] ), 'deleted' => _n( '%s event permanently deleted.', '%s events permanently deleted.', $bulk_counts['deleted'] ), 'trashed' => _n( '%s event moved to the Trash.', '%s events moved to the Trash.', $bulk_counts['trashed'] ), 'untrashed' => _n( '%s event restored from the Trash.', '%s events restored from the Trash.', $bulk_counts['untrashed'] ), ); return $bulk_messages; } // Example source: http://codex.wordpress.org/Plugin_API/Filter_Reference/bulk_post_updated_messages ?> |
很简单吧,如果你想分享该插件或者主题,切记要让这些字符串可通过函数方便语言本地化。
过滤默认的分类小工具
在某些情况下可能需要修改分类小工具,有了widget_categories_args过滤钩子,便可实现。
样例:从小工具中排除某些分类
若想在分类小工具中隐藏某些分类名,可以使用下列代码块:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
<?php add_filter( 'widget_categories_args', 'widget_categories_args_example' ); function widget_categories_args_example( $cat_args ) { $exclude_arr = array( 4, 10 ); if( isset( $cat_args['exclude'] ) && !empty( $cat_args['exclude'] ) ) $exclude_arr = array_unique( array_merge( explode( ',', $cat_args['exclude'] ), $exclude_arr ) ); $cat_args['exclude'] = implode( ',', $exclude_arr ); return $cat_args; } // Example source: http://codex.wordpress.org/Plugin_API/Filter_Reference/widget_categories_args ?> |
将$exclude_arr参数修改为需要排除的分类id即可。
当用户注册成功后页面重定向
一般情况下,注册成功后WordPress只提醒用户核对邮箱信息,并不会重定向到需要的页面,然而借助于registration_redirect过滤钩子,可重定向到自定义的安全页面地址。
样例:让新用户下载电子书
如果在用户注册后,需要提供电子书给他们,就可以在注册成功后直接跳转到电子书的链接下载页面,代码如下:
1 2 3 4 5 6 7 8 9 10 11 |
<?php add_filter( 'registration_redirect', 'registration_redirect_example' ); function registration_redirect_example() { return home_url( '/your-free-ebook/' ); } // Example source: http://wpsnipp.com/index.php/functions-php/redirect-a-successful-registration-page/ ?> |
wp_safe_redirect()函数中的重定向页面不能为外链,除非使用allowed_redirect_hosts过滤钩子指定了外域安全主机白名单,在前几个章节中和样例中,我们已经学习过了,如果忘记了可自行阅读相关教程。
更改评论表单字段
WordPress 中用comment_form()函数来显示评论表单,设置该函数的参数后便可更改表单域,若你正在开发插件,可以使用下面代码自定义表单字段:
移除表单的url 字段
例如你是一个自由撰稿网站的设计者,正在开发一款插件,为客户个人信息安全考虑,需要将网站所有评论表单中的url字段删除。此时便可使用下列代码来实现。
1 2 3 4 5 6 7 8 9 10 11 12 |
<?php add_filter( 'comment_form_default_fields', 'comment_form_default_fields_example' ); function comment_form_default_fields_example( $fields ) { unset( $fields['url'] ); return $fields; } // Example source: http://wpsnipp.com/index.php/comment/remove-unset-url-field-from-comment-form/ ?> |
将以上代码直接复制到你的插件中就全部搞定了。
改变允许的上传文件类型
WordPress媒体库默认允许上传多种文件类型,通过upload_mime过滤钩子,你也可对允许上传的文件类型进行自定义。
样例:禁止上传gif 格式图片
从1999年到2014年,gif图片格式一直都很受欢迎,记得当时出现的第一张gif图片是个跳舞的小人,在创建Yahuoo首页的纯真年代,地球村的人们似乎都很享受当在ICQ上有朋友给我们发即时信息的恼人的提示声….
有时候不想要这些喧闹时,我们就可以禁止用户上传gif图片文件到网站媒体库,此时便可使用如下代码:
1 2 3 4 5 6 7 8 9 10 11 12 |
<?php add_filter( 'upload_mimes', 'upload_mimes_example' ); function upload_mimes_example( $existing_mimes = array() ) { unset( $existing_mimes['gif'] ); return $existing_mimes; } |
第五部分结语
在本文中我们学习了50个过滤钩子的最后10个,希望你喜欢并能从中学到新知识,下一个章节我们将重新快速浏览学过的过滤钩子,到时再见。
请在下方的留言区写下您的建议意见,如果喜欢本文,别忘了分享给你的好友。
阅读该系列的其他文章: 上一篇:50个WordPress过滤钩子(31-40) 下一篇:50个WordPress过滤钩子(总结)