【译】WordPress 中的50个过滤器(5)：第31-40个过滤器

2014/11/26 WordPress, WP开发原创暂无 4,256

本文为系列第三篇，原文：50 Filters of WordPress: Filters 31-40 原文地址

在过去的两篇文章中，我们总共介绍了30个WordPress 的过滤器。在本文中，我们将接触其他类型的过滤器，一如既往，有例子予以加深理解。

本系列文章翻译自tutsplus，原作者为Barış Ünver，翻译人：Jeff，转载请注明原始来源及翻译人，谢谢！

本文若有修正，不会更新于本页，只会更新到Github项目地址上。

过滤默认的相册样式

WordPress 中会使用[ gallery]这个短代码来加载预定义的CSS。这些默认设置你通过use_default_gallery_style函数自定义。

禁止默认样式

&lt;?php
 
add_filter( 'use_default_gallery_style', '__return_false' );
 
?&gt;

上面的代码起作用后，<style>标签不会主动添加到[ gallery]这个短代码中。

过滤附件url

相关过滤器名称为wp_get_attachment_url()。

避免“混合内容”的警示

（这个涉及到https的相关知识）如果你的网站是使用ssl的，那么wp_get_attachment_url()函数默认会返还http的url而非https，也因此会有访客警示。下面的代码会解决这个问题：

&lt;?php
 
add_filter( 'wp_get_attachment_url', 'wp_get_attachment_url_example' );
 
function wp_get_attachment_url_example( $url ) {
$http  = site_url( false, 'http'  );
$https = site_url( false, 'https' );
 
if ( $_SERVER['HTTPS'] == 'on' )
    return str_replace( $http, $https, $url );
else
    return $url;
}
 
// Example source: http://codex.wordpress.org/Plugin_API/Filter_Reference/wp_get_attachment_url
 
?&gt;

设置电子邮件的默认文本类型

wp_mail()函数默认会使用text/plain作为文本类型，通过这个wp_mail_content_type过滤器，你可以自定义之。

例子：WordPress 中使用HTML文本类型方式电子邮件

&lt;?php
 
add_filter( 'wp_mail_content_type', 'wp_mail_content_type_example' );
 
function wp_mail_content_type_example( $content_type ) {
return 'text/html';
}
 
?&gt;

保存评论者的ip地址

WordPress 在数据库中会保留每一个评论员的ip地址，如果你想修改之，可以使用这个pre_comment_user_ip过滤器。

例子：保存评论员的真实ip地址

如果你的评论员是使用代理进行评论的，WordPress会记录的是代理的ip而非真实ip。真实ip可以在HTTP头部的X-Forwarded-For找到。下面的代码就能实现在数据库中记录的是真实的ip地址。

&lt;?php
 
add_filter( 'pre_comment_user_ip', 'pre_comment_user_ip_example' );
 
function pre_comment_user_ip_example() {
$REMOTE_ADDR = $_SERVER['REMOTE_ADDR'];
if ( !empty( $_SERVER['X_FORWARDED_FOR'] ) ) {
    $X_FORWARDED_FOR = explode( ',', $_SERVER['X_FORWARDED_FOR'] );
    if ( !empty( $X_FORWARDED_FOR ) )
        $REMOTE_ADDR = trim( $X_FORWARDED_FOR[0] );
} elseif( !empty( $_SERVER['HTTP_X_FORWARDED_FOR'] ) ) {
    $HTTP_X_FORWARDED_FOR = explode( ',', $_SERVER['HTTP_X_FORWARDED_FOR'] );
    if ( !empty( $HTTP_X_FORWARDED_FOR ) )
        $REMOTE_ADDR = trim( $HTTP_X_FORWARDED_FOR[0] );
}
return preg_replace( '/[^0-9a-f:\., ]/si', '', $REMOTE_ADDR );
}
 
// Example source: https://codex.wordpress.org/Plugin_API/Filter_Reference/pre_comment_user_ip
 
?&gt;

想知道有关HTTP头部X-Forwarded-For 的更多知识？请点击喂鸡百科。

修改文章的保存版本控制数量

你可能找到WordPress 有个“修订版本”的功能，要设置的话你需要通过控制wp-config.php中的WP_POST_REVISIONS常量。

但是你如果想这个自定义功能也能在其他文章类型中起作用呢？该如何操作？使用这个wp_revisions_to_keep过滤器试下。

禁止某些特定文章类型使用“修订版本”功能

下面的代码需要修改$post变量为你的，代码中为“even”。

&lt;?php
 
add_filter( 'wp_revisions_to_keep', 'wp_revisions_to_keep_example', 10, 2 );
 
function wp_revisions_to_keep_example( $num, $post ) {
if ( 'event' == $post-&gt;post_type ) {
    return 0;
}
return $num;
}
 
// Example source: http://codex.wordpress.org/Plugin_API/Filter_Reference/wp_revisions_to_keep
 
?&gt;

重写`[ caption]` 短代码

[ caption] 短代码可以让你很简单地通过字幕包裹某张图片，如果你想修改下，往下看。

例子：用HTML5标记图像字幕

HTML5 标准中建议我们使用<figure> 或<figcaption> 这两个图片相关的新标签，在这里例子我们重写之：

&lt;?php
 
    add_filter( 'img_caption_shortcode', 'img_caption_shortcode_example', 10, 3 );
 
function img_caption_shortcode_example( $empty, $attr, $content ) {
$attr = shortcode_atts( array(
    'id'      =&gt; '',
    'align'   =&gt; 'alignnone',
    'width'   =&gt; '',
    'caption' =&gt; ''
), $attr );
 
if ( 1 &gt; (int) $attr['width'] || empty( $attr['caption'] ) ) {
    return '';
}
 
if ( $attr['id'] ) {
    $attr['id'] = 'id="' . esc_attr( $attr['id'] ) . '" ';
}
 
$figure_atts    = $attr['id']
                . ' class="caption ' . esc_attr( $attr['align'] )
                . '" ' . 'style="max-width: ' . ( 10 + (int) $attr['width'] ) . 'px;"';
 
$output  = '&lt;figure ' . $figure_atts . '&gt;';
$output .= do_shortcode( $content );
$output .= '&lt;figcaption&gt;' . $attr['caption'] . '&lt;/figcaption&gt;';
$output .= '&lt;/figure&gt;';
 
return $output;
 
}
 
// Example source: http://codex.wordpress.org/Plugin_API/Filter_Reference/img_caption_shortcode
 
?&gt;

添加文章CSS类名

body_class这个过滤器在WordPress 开发中常常用到，那么你知道有个post_class过滤器可以让你在文章内添加自定义的CSS 类吗？

例子：在循环中为第一篇文章添加特别标记的类

&lt;?php
 
add_filter( 'post_class', 'post_class_example' );
 
function post_class_example( $classes ) {
global $wp_query;
if ( 0 == $wp_query-&gt;current_post ) {
$classes[] = 'first-post';
    }
    return $classes;
    }
    // Example source: http://www.billerickson.net/code/first-post-class/
 
?&gt;

这样就为你的WordPress 网站的第一篇文章添加了.first-post 这个类，之后在开发中你就可通过CSS 自定义.first-post 的样式而不用担心因为使用:first这个伪类而产生的跨浏览器兼容问题了。

在附件中增加自定义的输入框

在WordPress 中，附件大体上相当于一种额外的文章类型——仅仅有小小区别。attachment_fields_to_edit这个过滤器可以让我们进行一些自定义操作——当你上传或编辑附件的时候。

例子：为上传的图片增加许可证信息

让我们假设你有有个摄影相关的博客，你需要为你博客上上传的每一张图片进行许可证声明。通过下面的代码即可为你增加个“license”的输入框。

&lt;?php
 
add_filter( 'attachment_fields_to_edit', 'attachment_fields_to_edit_example', 10, 2 );
 
function attachment_fields_to_edit_example( $form_fields, $post ) {
$field_value = get_post_meta( $post-&gt;ID, 'license', true );
$form_fields['license'] = array(
  'value' =&gt; $field_value ? $field_value : '',
  'label' =&gt; __( 'License' ),
  'helps' =&gt; __( 'Specify the license type used for this image' )
);
return $form_fields;
}
 
add_action( 'edit_attachment', 'save_new_attachment_field' );
 
function save_new_attachment_field( $attachment_id ) {
$license = $_REQUEST['attachments'][$attachment_id]['license'];
if ( isset( $license ) ) {
  update_post_meta( $attachment_id, 'license', $license );
}
}
 
// Example source: http://codex.wordpress.org/Plugin_API/Filter_Reference/attachment_fields_to_edit
 
?&gt;

修改自动摘要的文字数量

默认WordPress 的摘要会裁剪55个单词，如果你想修改之，可以通过这个excerpt_length过滤器修改下。

例子：修改自动摘要的文字数量

下面的代码可以使得摘要裁剪15个单词——如果你想做有个类似Pinterest 风格的布局，那么可能需要这个：

&lt;?php
 
add_filter( 'excerpt_length', 'excerpt_length_example' );
 
function excerpt_length_example( $words ) {
return 15;
}
 
?&gt;

很容易，不是吗？

处理后台仪表盘中的“批量操作”功能

在WordPress的仪表盘那里罗列着类似文章、页面、用户、多媒体等等的栏目，当你点击某个栏目可以进行批量操作。下面讲到的过滤器会让你处理下这小小的下拉菜单。

例子：禁止批量处理垃圾文章

如果你拥有个新闻网站，且对于编辑人员意外清空垃圾文章这种行为是很谨慎的，那么你需要下面的代码来禁止之：

&lt;?php
 
add_filter( 'bulk_actions-edit-post', 'bulk_actions_edit_post_example' );
 
function bulk_actions_edit_post_example( $actions ) {
unset( $actions['trash'] );
return $actions;
}
 
?&gt;

类似$screenid这种变量，如果你想了解更多，可以参考官方codex。

总结

终于还剩下最后一篇了！~~o(>_<)o~~