- 浏览: 1072333 次
- 性别:
- 来自: 广州
文章分类
- 全部博客 (290)
- php (65)
- javascript (36)
- html5 (31)
- thinkphp (9)
- mysql (16)
- jquery (13)
- node.js (9)
- css (9)
- android 开发 (8)
- flex (5)
- java (3)
- apache (8)
- linux (8)
- git (5)
- web (5)
- wordpress (9)
- mongodb (2)
- redis (5)
- yaf (6)
- python (4)
- big data (1)
- sphinx (1)
- html (1)
- bootstrap (1)
- vue (1)
- laravel (1)
- test (0)
最新评论
-
July01:
推荐用StratoIO打印控件,支持网页、URL、图片、PD、 ...
如何解决非IE浏览器的web打印 -
flashbehappy:
同一个视频,有mp4,ogg两种格式的。在chrome,fir ...
firefox chrom safari 对video标签的区别 -
xmdxzyf:
可以在网站(www.sosoapi.com)上试下在线表单方式 ...
用swagger-php/ui做API测试 -
flex_莫冲:
a2631500 写道"看了源码,设置Backbon ...
backbone与php交互 -
a2631500:
"看了源码,设置Backbone.emulateJS ...
backbone与php交互
参考来源:http://www.wordpress.la/codex-%E6%8F%92%E4%BB%B6API%E4%B9%8B%E5%B8%B8%E7%94%A8%E8%BF%87%E6%BB%A4%E5%99%A8(filter).html
http://www.ssdn2007.com/wordpress-filter-reference.html
本文列出了WordPress 2.1及以上版本中,可用于插件开发的过滤器钩子(hook)。
想了解过滤器钩子和动作钩子的定义和作用?请看插件API。
想了解插件的基本编写过程?请看插件开发。
想查看动作钩子函数列表?请看插件API/常用动作(action)。
想查找WordPress 2.1之前版本的过滤器钩子和动作钩子?请看Plugin API/Hooks 2.0.x。
注意:为本文添加词条或做其它改动时,请参照当前格式。添加时请说明过滤器函数适用的数据类型,如果过滤器函数接收多个参数,请在参数列表中说明。
日志、页面、附件(上传)过滤器函数
数据库读取
本部分中的过滤器函数适用于从数据库读出、尚未显示到页面或编辑界面的数据。
accachment_icon
在get_attachment_icon函数中,该过滤器函数应用于附件图标。过滤器函数可接收的参数:图标文件(作为HTML IMG标签),附件ID。
attachment_innerHTML
在get_attachment_innerHTML函数中,若附件没有图标,该过滤器函数应用于附件标题。过滤器函数可接收的参数:内部HTML (默认为附件标题),附件ID。
content_edit_pre
应用于编辑前的日志正文
excerpt_edit_pre
应用于编辑前的日志摘要
get_attached_file
应用于由get_attached_file 函数检索出的附件文件信息。过滤器函数接收的参数:文件信息,附件ID。
get_enclosed
应用于get_enclosed函数中的日志附件列表
get_pages
应用于get_pages函数返回的页面列表。过滤器函数接收的参数:页面列表(每个词条中都包含一个页面数据组),get_pages 函数页面列表(get_pages函数可接收的参数列表,该列表可识别用户所请求的页面)。
get_pung
在get_pung函数中,应用于日志的引用通知URL链接列表
get_the_excerpt
在get_the_excerpt函数中,应用于日志摘要
get_the_guid
在get_the_guid函数中,应用于日志的全局唯一标识符(GUID)。
get_to_ping
在get_to_ping函数中,应用于日志的引用通知URL链接列表
icon_dir
在多个函数中,应用于模板的图片目录。其中插件能够规定,MIME类型的图标可以来自其它存储位置。
icon_dir_uri
在多个函数中,应用于模板图片目录URL。其中插件能够规定,MIME类型的图标可以来自其它存储位置。
prepend_attachment
应用于prepend_attachment函数预先存储的HTML代码。
sanitize_title
在sanitize_title函数中,删除HTML标签后,用于日志标题
single_post_title
在wp_title 和 single_post_title函数中,用于用以创建博客页面标题的日志标题
the_content
应用于从数据库中检索到、尚未显示在屏幕上的日志正文(也可用在“引用通告”等其它操作中)。
the_content_rss
在包含RSS订阅前,用于日志正文
the_editor_content
在将日志内容输入富编辑器窗口前,用于日志正文
the_excerpt
应用于从数据库中检索到、尚未显示在屏幕上的日志摘要(若没有日志摘要,可以应用于日志正文)(也可用在“引用通告”等其它操作中)。
the_excerpt_rss
在包含RSS订阅前,用于日志摘要
the_tags
应用于从数据库中检索到的、尚未显示在屏幕上的标签
the_title
应用于从数据库中检索到、尚未显示在屏幕上的日志标题(也可用在“引用通告”等其它操作中)。
the_title_rss
在包含RSS订阅前,用于日志标题(用the_title进行首次过滤后)。
the_edit_pre
显示编辑页面前,应用于日志标题
wp_dropdown_pages
应用于由wp_dropdown_pages函数生成的WordPress页面的HTML下拉列表。
wp_list_pages
应用于由wp_list_pages函数生成的HTML列表。
wp_list_pages_excludes
在wp_list_pages函数中,应用于被排除在外的页面列表(页面ID数组)
wp_get_attachment_metadata
应用于wp_get_attachment_metadata 函数检索到的附件元数据。过滤器函数接收的参数:元数据,附件ID。
wp_get_attachment_thumb_file
应用于wp_get_attachment_thumb_file 函数检索到的附件缩略图文件。过滤器函数接收的参数:缩略图文件,附件ID。
wp_get_attachment_thumb_url
应用于wp_get_attachment_thumb_URL 函数检索到的附件缩略图URL。过滤器函数接收的参数:缩略图URL,附件 ID。
wp_get_attachment_url
应用于wp_get_attachment_url 函数检索到的附件URL。过滤器函数接收的参数:URL,附件 ID。
wp_mime_type_icon
应用于wp_mime_type_icon 函数为附件计算出的MIME类型图标。过滤器函数接收的参数:计算出的图标URI , MIME 类型,日志 ID。
wp_title
在wp_title函数中,应用于尚未发送到浏览器的博客页面标题
数据库写入
本部分中的过滤器函数适用于尚未保存到数据库中的数据。
add_ping
应用于添加ping引用后、保存入数据库前的日志引用域的新值。
attachment_max_dims
缩小图片前,应用于最大图片尺寸。过滤器函数输入值(以及返回的值)是false(若未规定最大尺寸)或一个两栏列表(宽度、高度)
category_save_pre
应用于尚未保存到数据库前的、由逗号隔开的日志类别列表(也可用于附件)。
comment_status_pre
应用于尚未保存到数据库前的日志评论状态(也可用于附件)。
content_filtered_save_pre
应用于尚未保存到数据库前、经过过滤的日志正文(也可用于附件)。
content_save_pre
应用于尚未保存到数据库前的日志正文(也可用于附件)。
excerpt_save_pre
应用于尚未保存到数据库前的日志摘要(也可用于附件)。
name_save_pre
应用于尚未保存到数据库前的日志名称(也可用于附件)。
phone_content
应用于尚未保存到数据库前、由电子邮件提交的日志正文。
ping_status_pre
应用于尚未保存到数据库前的日志引用状态(也可用于附件)。
post_mime_type_pre
应用于尚未保存到数据库中的插件的MIME类型
status_save_pre
应用于尚未保存到数据库中的日志状态。
thumbnail_filename
应用于上传图片时缩略图的文件名。
wp_thumbnail_creation_size_limit
应用于上传图片时缩略图的大小。过滤器函数接收的参数:文件最大尺寸,附件 ID,附件文件名。
wp_thumbnail_max_side_length
应用于上传图片时缩略图的大小。过滤器函数接收的参数:图片侧边最大尺寸, 附件ID,附件文件名。
title_save_pre
应用于尚未存储到数据库中的日志标题(也可用于附件)。
update_attached_file
在update_attached_file 函数中,应用于尚未保存到日志元数据中的附件信息。过滤器函数接收的参数:附件信息,附件ID。
wp_delete_file
应用于被删除前的附件文件名
wp_generate_attachment_metadata
应用于保存到数据库前的附件元数据数组。
wp_update_attachment_metadata
应用于尚未保存到wp_update_attachment_metadata 函数的附件元数据。过滤器函数接收的参数:元数据,附件ID。
评论、引用通告、Ping过滤器
数据库读取
本部分中的过滤器函数适用于从数据库读出的、尚未显示到页面或编辑界面的数据。
commet_excerpt
在comment_excerpt函数中,应用于评论摘要。参见get_comment_excerpt。
comment_flood_filter
若有人试图评论轰炸某个博客,博客主人可以使用comment_flood_filter。过滤器函数接收的参数:已锁定(true/false,是否已经有过了插件锁定了此人的评论;可以在插件中将此参数值设为true并返回true以锁定评论), 之前评论时间,当前评论时间。
comment_post_redirect
应用于有人发表评论后的重定向位置。过滤器函数接收的参数:重定向位置,评论信息数组。
comment_text
在comment_text函数和管理菜单中,应用于尚未显示在屏幕上的评论内容。
comment_text_rss
在包含RSS订阅前,应用于评论内容。
comments_array
在comments_template函数中,应用于日志的评论数组。过滤器函数可接收的参数:评论信息结构数组,日志 ID。
comments_number
应用于comments_number函数生成评论数量的格式化文本。参见get_comments_number。
get_comment_excerpt
应用于由get_comment_excerpt函数从数据库读出的评论摘要(comment_excerpt也会从数据库读出评论摘要)。参见comment_excerpt。
get_comment_ID
应用于get_comment_ID函数从全局变量$comments 中读出的评论ID。
get_comment_text
在get_comment_text函数中,应用于当前评论的评论内容,comment_text函数也会调用评论内容。
get_comment_type
在get_comment_type中,应用于评论类型("comment", "trackback", 或 "pingback"),comment_type也会调用评论类型。
get_comments_number
应用于get_comments_number函数从全局变量$post中读出的评论总数(comments_number函数也会调用评论总数;参见comments_number过滤器)。
post_comments_feed_link
应用于comments_rss函数为评论feed生成的feed URL。
数据库写入
本部分中的过滤器函数适用于尚未保存到数据库中的数据。
comment_save_pre
应用于更新/编辑前的评论信息。函数接收的参数:评论信息数据,包括"comment_post_ID", "comment_author", "comment_author_email", "comment_author_url", "comment_content", "comment_type", 以及 "user_ID"。
pre_comment_approved
应用于当前评论的审核状态(true/false),以便于插件进行重写。返回true(或false)并将第一个参数设为true(或false),表示批准(或不批准)该评论,使用$comment_ID等全局变量获取该评论的信息。
pre_comment_content
当评论尚未写入数据库时,应用于评论内容。
preprocess_comment
将评论保存到数据库中,尚未进行其它操作时,应用于评论信息。函数可接收的参数:评论信息数组,包括"comment_post_ID", "comment_author", "comment_author_email", "comment_author_url", "comment_content", "comment_type", 以及"user_ID"。
wp_insert_post_data
更新数据库中的日志前,应用于wp_insert_post()中经过修改以及未经修改的日志信息。函数接收的参数:经过修改的日志数组与经过过滤的日志数组。
类别过滤器
参见下文中的管理界面过滤器。
数据库读取
本部分中的过滤器函数适用于从数据库读出的、尚未显示到页面或编辑界面的数据。
category_description
应用于category_description 以及wp_list_categories函数中的“description”字段类别。过滤器函数接收的参数:说明,(从category_description中调用的)类别 ID;说明,(从wp_list_categories中调用的)类别信息数组(包括该类别的类别表中所有字段)。
category_feed_link
应用于get_category_rss_link函数为类别feed生成的feed URL。
category_link
应该用于get_category_link函数为类别生成的URL。过滤器函数接收的参数:链接 URL,类别 ID。
get_categories
应用于get_categories函数生成的类别列表(很多其它函数会使用get_categories函数所生成的类别列表)。过滤器函数接收的参数:类别列表,,get_categories选项列表。
get_category
应用于get_category函数查找到的类别信息。该信息是一个数组,数组包括WordPress类别表中某个指定类别ID的所有字段。
list_cats
应用于两种不同情况下:
1. wp_dropdown_categories函数用list_cats过滤器过滤show_option_all 与show_option_none参数(这两个参数可在类别下拉列表中添加“All”和“None”选项)。过滤器函数不接受其它参数。
2. wp_list_categories函数将list_cats过滤器用在类别名称中。过滤器函数接收的参数:类别名称,类别信息列表(类别表中该类别的所有字段)。
list_cats_exclusions
get_categories函数将排除一些类别,list_cats_exclusions应用于可给出这些类别的SQL WHERE语句。插件也可以排除类别列表中的类别或类别组。过滤器函数接收的参数:排除类别的WHERE语句,get_categories选项列表。
single_cat_title
生成博客页面标题时,wp_title函数 与single_cat_title函数将single_cat_title用于类别名称。
the_category
在et_the_category_list函数中,应用于类别列表(带有链接的HTML列表)。过滤器函数接收的参数:生成的HTML文本,当前使用的列表分隔符(空字符串表示默认LI列表),父参数为get_the_category_list。
the_category_rss
包含RSS 订阅前,在get_the_category_rss函数中应用于日志的类别列表(类别XML元素列表)。过滤器函数接收的参数包括列表内容和类型(一般是"rdf"或"rss")。
wp_dropdown_cats
应用于wp_dropdown_categories函数生成的下拉类别列表(含有HTML选项元素的文本字符串)。
wp_list_categories
应用于wp_list_categories函数生成的类别列表(HTML列表)。
数据库写入
本部分中的过滤器函数适用于尚未保存到数据库中的数据。
pre_category_description
应用于尚未保存到数据库中的类别说明
pre_category_name
应用于尚未保存到数据库中的类别名称。
pre_category_nicename
应用于尚未保存到数据库中的类别别名。
链接过滤器
注意:本部分是关于日志、页面、存档、订阅等链接的过滤器函数。博客反向链接过滤器函数见下文。
attachment_link
在get_attachment_link函数中,应用于总计出的附件永久链接。过滤器函数接收的参数:链接 URL,附件ID。
author_feed_link
应用于get_author_rss_link 函数为作者订阅生成的订阅URL。
author_link
应用于get_author_posts_url 函数生成的作者存档永久链接。过滤器函数接收的参数:链接URL,作者别名, 作者 ID。注意,get_author_posts_url在wp_list_authors与the_author_posts_link内被调用。
comment_reply_link
应用于get_comment_reply_link函数为回复某个特定评论而生成的链接。get_comment_reply_link函数在comments_template函数中被调用。过滤器函数接收的参数:链接(字符串),自定义选项(数组),当前评论(对象),当前日志(对象)。
day_link
在get_day_link函数中,应用于日存档文章的链接URL。过滤器函数接收的参数:URL,年,月,日。
feed_link
在get_feed_link函数中,应用于订阅的链接URL。过滤器函数接收的参数:URL,订阅类型(如"rss2","atom"等)。
get_comment_author_link
在get_comment_author_link函数中,应用于评论中为作者链接而生成的HTML(comment_author_link也会调用此HTML)。动作函数接收的参数:用户名。
get_comment_author_url_link
在get_comment_author_url_link函数中,应用于评论中为作者链接而生成的HTML(comment_author_link也会调用此HTML)。
month_link
在get_month_link函数中,应用于月存档日志的链接URL。过滤器函数接收的参数:URL,年,月。
page_link
在get_page_link函数中,应用于计算出的页面URL。过滤器函数接收的参数:URL,页面 ID。注意:有一个内部过滤器函数被称为_get_page_link,该过滤器也可过滤非博客主页上的页面URL(_get_page_link与page_link参数相同)。
post_link
在get_permalink函数中,应用于计算出的页面永久链接。the_permalink, post_permalink, previous_post_link以及next_post_link函数也会调用此类页面永久链接。过滤器函数接收的参数:永久链接,日志信息列表。
the_permalink
在the_permalink函数中,应用于尚未显示在浏览器上的日志永久链接。
year_link
在get_year_link函数中,应用于年存档日志的链接。过滤器函数接收的参数:URL,年。
日期和时间过滤器函数
get_comment_date
应用于get_comment_date函数生成的格式统一的评论日期(comment_date函数也会调用此类评论日期)。
get_comment_time
在get_comment_time函数中应用于格式统一的评论时间(comment_time函数也会调用此类评论时间)。
get_the_modified_date
应用于由get_the_modified_date函数生成的、格式统一的日志修改日期(the_modified_date函数也会调用此类日志日期)。
get_the_modified_time
应用于由get_the_modified_time和get_post_modified_time函数生成的、格式统一的日志修改时间(the_modified_time也会调用此类时间)。
get_the_time
应用于get_the_time和get_post_time函数生成的、格式统一的日志时间(the_time函数也会调用此类日志时间)。
the_date
应用于the_date函数所生成的、格式统一的日志发表日期。
the_modified_date
应用于由the_modified_date函数生成的、格式统一的日志修改日期。
the_modified_time
应用于由the_modified_time函数生成的、格式统一的日志修改时间。
the_time
应用于由the_time函数生成的、格式统一的日志发表时间。
the_weekday
应用于由the_weekday函数生成的日志发表日期当天的星期数。
the_weekday_date
应用于由the_weekday_date函数生成的日志发表日期当天的星期数。函数接收的参数包括:星期数(周一、周二、周三、周四、周五、周六、周日),before text与after text。
作者和用户过滤器函数
login_redirect
在用户登录过程中,应用于redirect_to post/get变量。
数据库读取
本部分中的过滤器函数适用于从数据库读出的、尚未显示到页面或编辑界面的数据。
author_email
应用于comment_author_email函数从数据库检索到的评论者的电子邮件地址。参见get_comment_author_email。
comment_author
应用于comment_author函数从数据库检索到的评论者的名称。参见get_comment_authorl。
comment_author_rss
包含RSS订阅前,应用于评论者的名称。
comment_email
应用于comment_author_email_link函数从数据库检索到的评论者的电子邮件地址。
comment_url
应用于comment_author_url函数从数据库检索到的评论者的URL地址(参见get_comment_author_url)。
get_comment_author
应用于get_comment_author函数从数据库检索到的评论者的名称,comment_author函数也会调用此类评论者名称。参见comment_author。
get_comment_author_email
应用于get_comment_author_email函数从数据库检索到的评论者的电子邮件地址。comment_author_email也会调用此类电子邮件地址。参见author_email。
get_comment_author_IP
应用于get_comment_author_IP函数从数据库检索到的评论者的IP地址。comment_author_IP函数也会调用此类IP地址。
get_comment_author_url
应用于get_comment_author_url函数从数据库检索到的评论者的URL。comment_author_url函数也会调用此类URL地址。参见comment_url。
login_errors
应用于显示在登录界面上的登录错误信息。
login_headertitle
应用于显示在登录界面上的登录信息头URL(WordPress默认显示)标题。
login_headerurl
应用于显示在登录界面上的登录信息头URL(默认指向WordPress.org)。
login_message
应用于显示在登录界面上的登录信息。
role_has_cap
在WP_Role->has_cap函数中应用于某位用户的权限列表。过滤器函数接收的参数包括:将要被过滤的权限列表,目前还无法使用的权限,以及用户名称。
sanitize_user
在sanitize_user函数中应用于用户名。过滤器函数接收的参数包括:用户名 (整理后),原始用户名,strict(true或者false,表示使用/不使用精确的ASCII码)。
the_author
在get_the_author函数中,应用于日志作者所显示的名称。the_author函数也会调用该名称。
the_author_email
在the_author_email函数中,应用于日志作者的点知邮件地址。
数据库写入
本部分中的过滤器函数适用于尚未保存到数据库中的数据。
pre_comment_author_email
应用于评论尚未保存到数据库时该评论作者的电子邮件地址。
pre_comment_author_name
应用于评论尚未保存到数据库时该评论作者的用户名。
pre_comment_author_url
应用于评论尚未保存到数据库时该评论作者的URL。
pre_comment_user_agent
应用于评论尚未保存到数据库时该评论作者的用户代理。
pre_comment_user_ip
应用于评论尚未保存到数据库时该评论作者的IP地址。
pre_user_id
应用于评论尚未保存到数据库时该评论作者的用户ID。
pre_user_description
应用于尚未保存到数据库中的用户说明。
pre_user_display_name
应用于尚未保存到数据库中的用户显示名。
pre_user_email
应用于尚未保存到数据库中的用电子邮箱地址。
pre_user_first_name
应用于尚未保存到数据库中的用户的名字。
pre_user_last_name
应用于尚未保存到数据库中的用户的姓。
pre_user_login
应用于尚未保存到数据库中的用户登录名。
pre_user_nicename
应用于尚未保存到数据库中的用户别名。
pre_user_display_name
应用于尚未保存到数据库中的用户昵称。
pre_user_url
应用于尚未保存到数据库中的用户URL。
registration_errors
应用于注册新用户所生成的注册错误列表。
user_registration_email
在用户首次登录时,应用于从注册页面读取到的该用户电子邮件地址。
validate_username
应用户新用户名的验证结果。过滤器函数接收的参数:valid (true/false), 被验证的用户名。
反向链接过滤器
注意:本部分是关于反向链接的过滤器函数。日志、页面、类别等连接过滤器函数见上文。
get_bookmarks
在get_bookmarks函数中,应用于反向链接数据库查询结果。过滤器函数接收的参数:数据库查询结果列表,get_bookmarks参数列表。
link_category
在get_links_list 和 wp_list_bookmarks函数中,应用于链接说明。
link_rating
在get_linkrating函数中,应用于链接评价值。
link_title
在get_links和wp_list_bookmarks函数中,应用于链接标题。(自WordPress 2.2起)
pre_link_description
应用于尚未保存到数据库中的链接说明。
pre_link_image
应用于尚未保存到数据库中的链接图片。
pre_link_name
应用于尚未保存到数据库中的链接名称。
pre_link_notes
应用于尚未保存到数据库中的链接注释。
pre_link_rel
应用于尚未保存到数据库中的链接联系信息。
pre_link_rss
应用于尚未保存到数据库中的链接RSS URL地址。
pre_link_target
应用于尚未保存到数据库中的链接目标信息。
pre_link_url
应用于尚未保存到数据库中的链接URL。
博客信息和选项过滤器函数
all_options
应用于get_alloptions函数从数据库中检索到的选项列表。
bloginfo
应用于get_bloginfo函数检索博客选项信息后,bloginfo函数再次从数据库中检索出的博客选项信息。第二个参数$show给出所请求的bloginfo选项名称。注意:bloginfo("url"),bloginfo("directory") 与bloginfo("home")不使用该过滤器函数(参见bloginfo_url)。
bloginfo_rss
在get_bloginfo_rss函数中, get_bloginfo函数首次检索过博客选项信息、过滤HTML标签、转换相应字符后,应用于博客选项信息(bloginfo_rss函数也调用此类信息)。参数$show给出所请求的bloginfo选项名称。
bloginfo_url
应用于bloginfo("url"), bloginfo("directory") 以及bloginfo("home")尚未返回的输出结果。
loginout
应用于wp_loginout函数为用户登录和退出生成的HTML链接。
option_(option name)
应用于反序列化(解码基于数组的选项)后,get_option函数从数据库检索到的选项值。使用该过滤器函数时需要为特定选项名称添加过滤器函数,例如为 "option_foo"添加过滤器以过滤get_option("foo")的输出结果。
pre_option_(option name)
应用于反序列化后get_alloption函数从数据库检索到的选项值(解码基于数组的选项)。使用该过滤器函数时需要为特定选项名称添加过滤器函数,例如为 "pre_option_foo"添加过滤器以过滤"foo"选项。
register
应用于wp_register函数为用户创建的、用以注册(在允许注册的情况下)或访问控制板(已登录用户)的侧边栏链接。
upload_dir
应用于wp_upload_dir函数用以上传文件的文件目录。过滤器函数接收的参数是一个带有"dir"(上传目录路径)、"url"(上传目录的URL)、"error"(如果需要生成错误信息,可将此项设为true)元素的数组。
upload_mimes
若没有MIME列表输入wp_check_filetype函数,upload_mimes允许过滤器函数返回MIME类型列表以供上传。
一般性文章过滤器函数
attribute_escape
在attribute_escape函数中,应用于日志正文和其它内容。WordPress在多处地方调用attribute_escape以在内容发送到浏览器前,将某些字符改为HTML属性。
js_escape
在js_escape函数中,内容发送到浏览器窗口前,应用于Javascript代码。
管理界面过滤器函数
本部分是关于包括内容编辑界面在内的WordPress管理界面的过滤器函数。
autosave_interval
应用于自动保存日志的时间间隔中。
cat_rows
在管理菜单中,应用于为管理类别而生成的类别行HTML。
comment_edit_pre
应用于尚未显示到编辑界面上的评论内容。
comment_edit_redirect
当有人在管理菜单中编辑评论后,应用于重定向。过滤器函数接收的参数:重定向地址,评论ID。
comment_moderation_subject
应用于通知网站管理人员审核新评论时发送的电子邮件的邮件主题。过滤器函数接收的参数:邮件主题,评论 ID。注意:该过程发生在 wp_notify_moderator 函数中。 wp_notify_moderator 是一个“可插入式”函数,即插件能够改写该函数;参见插件API。
comment_moderation_text
应用于通知网站管理人员审核新评论时发送的电子邮件的邮件正文。过滤器函数接收的参数:邮件正文内容,评论 ID。注意:该过程发生在 wp_notify_moderator 函数中。 wp_notify_moderator 是一个“可插入式”函数,即插件能够改写该函数;参见插件API。
comment_notification_headers
应用于通知日志作者有新评论时所发送的电子邮件的邮件标头。过滤器函数接收的参数:邮件标头,评论 ID。注意:该过程发生在 wp_notify_postauthor函数中。 wp_notify_postauthor是一个“可插入式”函数,即插件能够改写该函数;参见插件API。
comment_notification_subject
应用于通知日志作者有新评论时所发送的电子邮件的邮件主题。过滤器函数接收的参数:邮件主题,评论ID。注意:该过程发生在 wp_notify_postauthor函数中。 wp_notify_postauthor是一个“可插入式”函数,即插件能够改写该函数;参见插件API。
comment_notification_text
应用于通知日志作者有新评论时发送的电子邮件的邮件正文。过滤器函数接收的参数:邮件正文,评论 ID。注意:该过程发生在 wp_notify_postauthor函数中。 wp_notify_postauthor是一个“可插入式”函数,即插件能够改写该函数;参见插件API。
cron_schedules
在wp_get_schedules函数中,应用于一个空数组,让插件能够生成计划任务。
default_content
应用于尚未打开新日志的编辑框时默认的日志内容。
default_excerpt
应用于尚未打开新日志的编辑框时默认的日志摘要。
default_title
应用于尚未打开新日志的编辑框时默认的日志标题。
editable_slug
在get_sample_permalink函数中,应用于日志、页面、标签以及类别的别名。
explain_nonce_(verb)-(noun)
允许过滤器函数定义文本,用文本来解释WordPress核心代码没有解释的随机数。使用此参数前用户需要定义特别的动词/名词过滤器。例如,如果我们开发的插件为升级标签定义了一个随机数,我们就需要为“explain_nonce_update-tag”定义一个过滤器。过滤器函数接收的参数: 将要显示的文本(默认为常见的 "Are you sure you want to do this?")以及动作URL末尾部分的信息。
format_to_edit
在format_to_edit函数中,应用于正文、摘要、标题和密码,管理菜单会调用format_to_edit函数来设定需要编辑的日志。在管理菜单中编辑评论时也可用到该参数。
format_to_post
在format_to_post函数中,应用于日志内容。默认情况下WordPress不使用这个参数。
manage_link-manager_columns
在WordPress 2.7以前,这个参数被称为manage_link_columns。应用于栏列表,以在反向链接管理界面上输入内容。过滤器函数的参数值/返回的值是一个关联列表,其中的元素关键字是栏名称,元素值是该栏页眉处的文本。参见动作函数manage_link_custom_column,这个函数将栏信息放在编辑界面中。
manage_posts_columns
应用于栏列表,以在日志管理界面上输入内容。过滤器函数的参数值/返回的值是一个关联数组,其中的元素关键字是栏名称,元素值是该栏页眉处的文本。参见动作函数manage_posts_custom_column,这个函数将栏信息放入编辑界面。
manage_pages_columns
应用于栏列表,以在页面管理界面上输入内容。过滤器函数的参数值/返回的值是一个关联数组,其中的元素关键字是栏名称,元素值是该栏页眉处的文本。参见动作函数manage_pages_custom_column,这个函数将栏信息放入编辑界面。
postmeta_form_limit
应用于日志编辑界面上的日志meta信息项的个数。
pre_upload_error
上传文件时,允许插件生成XMLRPC错误。
preview_page_link
应用于页面编辑界面上的链接,页面预览效果显示在界面下方。
preview_post_link
应用于日志编辑界面上的链接,日志预览效果显示在界面下方。
richedit_pre
在wp_richedit_pre函数中,应用于尚未显示到富文本编辑器的日志内容。
show_password_fields
应用于true/false变量,该变量决定用户是否选择在用户资料界面上更改密码(若变量值为true,显示密码修改项;变量值为false,表示用户无需修改密码)。
the_editor
应用于尚未显示在屏幕上的HTML DIV,该DIV用以存放富文本编辑器。过滤器函数的参数/返回的值是一个字符串。
user_can_richedit
在user_can_richedit函数中,用于统计用户的浏览器是否具有富编辑功能,以及用户是否希望使用富文本编辑器。若当前用户能够/不能够使用富文本编辑器时,过滤器函数的参数(返回值)为true/false。
user_has_cap
在WP_User->has_cap函数中,应用于用户的权限列表(current_user_can 函数调用WP_User->has_cap函数)。该过滤器函数的参数是将要被过滤的权限列表,以及参数列表(若用户能够编辑日志,参数列表中将包括日志ID等内容)。
wp_handle_upload
应用于上传文件时的相关上传信息。该过滤器函数的参数:带有"file"(文件名)、"url"、"type"元素的数组。
wp_upload_tabs
应用于自定义表的列表,以显示在上传管理界面上。该参数用动作函数upload_files_(tab)显示自定义表的页面。
富文本编辑器相关过滤器函数
本部分中的过滤器函数修改了富文本编辑器的配置。
mce_spellchecker_languages
应用于拼写检查器中有效的语言选择。
mce_buttons, mce_buttons_2, mce_buttons_3, mce_buttons_4
应用于富文本编辑器中的按钮行(每一行都是按钮名称的数组)。
mce_css
应用于富文本编辑器的CSS文件URL。
mce_external_plugins
应用于富文本编辑器加载的外部插件列表。
mce_external_languages
应用于外部插件加载的语言文件列表(参见 tinymce/langs/wp-langs.php)。
tiny_mce_before_init
应用于编辑器的完整初始化数组。
模板过滤器函数
本部分是关于主题、模板和样式文件的链接过滤器函数。
kubrick_header_color
应用于默认主题页眉处的颜色。
kubrick_header_display
应用于默认主题页眉处的显示设置。
kubrick_header_image
应用于默认主题的页眉图片文件。
locale_stylesheet_uri
应用于get_locale_stylesheet_uri函数返回的、指定位置的样式表单URI。过滤器函数的参数:URI,样式表单目录URI。
stylesheet
应用于get_stylesheet函数返回的样式表单。
stylesheet_directory
应用于get_stylesheet_directory函数返回的样式表单目录。过滤器函数的参数:样式表单目录,样式表单。
stylesheet_directory_uri
应用于get_stylesheet_directory_uri函数返回的样式表单目录URI。过滤器函数的参数:样式表单目录URI,样式表单。
stylesheet_uri
应用于get_stylesheet_uri函数返回的样式表单URI。过滤器函数的参数:样式表单URI,样式表单。
template
应用于get_template函数返回的模板。
template_directory
应用于get_template_directory函数返回的模板目录。过滤器函数的参数:模板目录,模板。
template_directory_uri
应用于get_template_directory_uri函数返回的模板目录URI。过滤器函数的参数:模板目录URI,模板。
theme_root
应用于get_theme_root函数返回的主题根目录(正常情况下即wp-content/themes).
theme_root_uri
应用于get_theme_root_uri函数返回的主题根目录URI。过滤器函数的参数:URI,网站URL。
我们也可以用以下过滤器钩子来代替主题中的单个模板文件。每个过滤器函数都将当前主题中相应的模板文件路径作为输入内容。插件可以为模板文件返回新的路径,以此修改将要使用的文件。
404_template
archive_template
attachment_template
author_template
category_template
comments_popup_template
comments_template
date_template
home_template
page_template
paged_template
search_template
single_template
高等WordPress过滤器函数
本部分是与WordPress查询语句、重写规则、国际化以及其它WordPress核心功能相关的高等过滤器函数。
author_rewrite_rules
应用于已生成的、与作者相关的重写过则。
category_rewrite_rules
应用于已生成的、与类别相关的重写规则。
comments_rewrite_rules
应用于已生成的、与评论相关的重写规则。
creat_user_query
应用于尚未执行的、用以将新用户信息存入数据库的查询语句。
date_rewrite_rules
应用于已生成的、与日期相关的重写规则。
found_posts
应用于执行数据库查询后的日志列表。
found_posts_query
数据库查询过即将显示在页面上的日志列表后,WordPress会在查询结果中选择日志行。此时用户可用该过滤器函数来进行其它操作,而不是执行SELECT FOUND_ROWS()。
get_editable_authors
在get_editable_authors函数中,应用于当前用户有权管理的日志作者列表。
gettext
应用于 __ and _e国际化函数翻译的文本。过滤器函数的参数:翻译文本和未翻译文本。该过滤器函数只在国际化有效且已加载文本域后有效。
get_next_post_join
在get_next_post函数(该函数查找当前日志之后需要显示的日志)中,应用于SQL JOIN语句(当用户查看类别存档时,该语句通常与类别表相连接)。过滤器函数的参数:JOIN语句,stay in same category (true/false),被排除的类别列表。
get_next_post_sort
在get_next_post函数(该函数查找当前日志之后需要显示的日志)中,应用于SQL ORDER BY语句(该语句通常按日志发表时间升序排列日志;至少需要有一篇日志)。过滤器函数的参数:ORDER BY语句。
get_next_post_where
在get_next_post函数(该函数查找当前日志之后需要显示的日志)中,应用于SQL WHERE语句(该语句通常按时间顺序查找下一篇已发表日志)。过滤器函数的参数:WHERE语句,stay in same category (true/false),被排除的类别类表。
get_others_drafts
应用于查询语句,该查询语句能够选择其他用户的日志草稿并显示在管理菜单中。
get_previous_post_join
在get_previous_post函数(该函数查找当前日志之前所显示的日志)中,应用于SQL JOIN语句(当用户查看类别存档时,该语句通常与类别表相连接)。过滤器函数的参数:JOIN语句,stay in same category (true/false),被排除的类别列表。
get_previous_post_sort
在get_previous_post函数(该函数查找当前日志之前所显示的日志)中,应用于SQL ORDER BY语句(该语句通常按日志发表时间降序排列日志;至少需要有一篇日志)。过滤器函数的参数:ORDER BY语句。
get_previous_post_where
在get_previous_post函数(该函数查找当前日志之前所显示的日志)中,应用于SQL WHERE语句(该语句通常按时间顺序查找上一篇已发表日志)。过滤器函数的参数:WHERE语句,stay in same category (true/false),被排除的类别类表。
get_user_drafts
应用于查询语句,该查询语句能够选择其他用户的日志草稿并显示在管理菜单中。
locale
应用于get_locale函数的存储位置。
mod_rewrite_rules
应用于重写规则列表,用户更改永久链接结构时将该重写规则列表存入.htaccess文件。
post_limits
应用于查询的LIMIT语句,该查询可返回日志数组。
posts_distinct
允许插件将DISTINCTROW语句加入查询,该查询可返回日志数组。
posts_fields
应用于查询的字段列表,该查询可返回日志数组。
posts_groupby
应用于查询的GROUP BY语句,该查询返回日志数组(通常情况下该数组为空)。
posts_join_paged
应用于查询语句的JOIN语句。在计算出分页后,该查询返回日志列表(分页并不影响JOIN语句,因此该函数相当于posts_join)。
posts_orderby
应用于查询语句的ORDER BY语句。该查询返回日志数组。
posts_request
应用于尚未执行的、将返回日志数组的SQL查询语句整体。
post_rewrite_rules
应用于已生成的、与日志相关的重写规则。
root_rewrite_rules
应用于生成后的根目录级重写规则。
page_rewrite_rules
应用于已生成的、与页面相关的重写规则。
posts_where_paged
应用于查询的WHERE语句。在计算出分页后,该查询返回日志数组(分页并不影响WHERE语句,因此该函数相当于posts_where)。
posts_join
应用于查询的JOIN语句。该查询返回日志数组。这个过滤器函数与posts_where过滤器函数一并为JOIN语句添加了一个数据库表。
posts_where
应用于查询的WHERE语句。该查询返回日志数组。
query
应用于所有查询语句(至少加载插件后运行的所有查询语句)。
query_string
已停用——可用query_vars或request来代替该函数。
query_vars
在生成SQL查询语句前,应用于WordPress公共查询变量列表。适用于删除插件进行其它操作时多余的永久链接信息。
request
类似query_vars,但request用在添加了“额外”的私有查询变量后。
rewrite_rules_array
应用于已生成的所有重写规则。
search_rewrite_rules
应用于已生成的、与查找相关的重写规则。
the_posts
WordPress对只有一篇日志的网页进行许可权限和草稿状态的最简单处理后,将the_posts用在从数据库查询出的日志列表上。
excerpt_length
定义某一篇日志摘要的长度。
update_user_query
应用于更新查询语句。该查询语句可在执行查询前更新用户信息。
uploading_iframe_src(自WordPress 2.5后被删除)
为日志和页面编辑界面中所上传的内嵌框架使用HTML src标签。
wp_redirect
在wp_redirect函数中,应用于重定向的URL。过滤器函数的参数:URL,HTTP状态码。注意:wp_redirect是一个“可插入式”函数,插件能够改写该函数;参见插件API。
xmlrpc_methods
应用于已经为XMLRPC服务器定义的XMLRPC方法列表。
wp_mail_from
在wp_mail函数中,用于发出邮件前。该函数的输入值是邮件地址的计算结果,这里的邮件地址即当前主机名称下的WordPress(该值由$_SERVER['SERVER_NAME']规定)。过滤器函数wp_mail_from返回一个邮件地址,如“user@example.com”,或姓名和邮件地址的组合,如“Name <user@example.com>”(均无引号)。
wp_mail_from_name
在wp_mail函数中,用于发出邮件前。过滤器函数wp_mail_from_name返回一个名称字符串,该字符串将用作邮件发送人的名称。
http://www.ssdn2007.com/wordpress-filter-reference.html
本文列出了WordPress 2.1及以上版本中,可用于插件开发的过滤器钩子(hook)。
想了解过滤器钩子和动作钩子的定义和作用?请看插件API。
想了解插件的基本编写过程?请看插件开发。
想查看动作钩子函数列表?请看插件API/常用动作(action)。
想查找WordPress 2.1之前版本的过滤器钩子和动作钩子?请看Plugin API/Hooks 2.0.x。
注意:为本文添加词条或做其它改动时,请参照当前格式。添加时请说明过滤器函数适用的数据类型,如果过滤器函数接收多个参数,请在参数列表中说明。
日志、页面、附件(上传)过滤器函数
数据库读取
本部分中的过滤器函数适用于从数据库读出、尚未显示到页面或编辑界面的数据。
accachment_icon
在get_attachment_icon函数中,该过滤器函数应用于附件图标。过滤器函数可接收的参数:图标文件(作为HTML IMG标签),附件ID。
attachment_innerHTML
在get_attachment_innerHTML函数中,若附件没有图标,该过滤器函数应用于附件标题。过滤器函数可接收的参数:内部HTML (默认为附件标题),附件ID。
content_edit_pre
应用于编辑前的日志正文
excerpt_edit_pre
应用于编辑前的日志摘要
get_attached_file
应用于由get_attached_file 函数检索出的附件文件信息。过滤器函数接收的参数:文件信息,附件ID。
get_enclosed
应用于get_enclosed函数中的日志附件列表
get_pages
应用于get_pages函数返回的页面列表。过滤器函数接收的参数:页面列表(每个词条中都包含一个页面数据组),get_pages 函数页面列表(get_pages函数可接收的参数列表,该列表可识别用户所请求的页面)。
get_pung
在get_pung函数中,应用于日志的引用通知URL链接列表
get_the_excerpt
在get_the_excerpt函数中,应用于日志摘要
get_the_guid
在get_the_guid函数中,应用于日志的全局唯一标识符(GUID)。
get_to_ping
在get_to_ping函数中,应用于日志的引用通知URL链接列表
icon_dir
在多个函数中,应用于模板的图片目录。其中插件能够规定,MIME类型的图标可以来自其它存储位置。
icon_dir_uri
在多个函数中,应用于模板图片目录URL。其中插件能够规定,MIME类型的图标可以来自其它存储位置。
prepend_attachment
应用于prepend_attachment函数预先存储的HTML代码。
sanitize_title
在sanitize_title函数中,删除HTML标签后,用于日志标题
single_post_title
在wp_title 和 single_post_title函数中,用于用以创建博客页面标题的日志标题
the_content
应用于从数据库中检索到、尚未显示在屏幕上的日志正文(也可用在“引用通告”等其它操作中)。
the_content_rss
在包含RSS订阅前,用于日志正文
the_editor_content
在将日志内容输入富编辑器窗口前,用于日志正文
the_excerpt
应用于从数据库中检索到、尚未显示在屏幕上的日志摘要(若没有日志摘要,可以应用于日志正文)(也可用在“引用通告”等其它操作中)。
the_excerpt_rss
在包含RSS订阅前,用于日志摘要
the_tags
应用于从数据库中检索到的、尚未显示在屏幕上的标签
the_title
应用于从数据库中检索到、尚未显示在屏幕上的日志标题(也可用在“引用通告”等其它操作中)。
the_title_rss
在包含RSS订阅前,用于日志标题(用the_title进行首次过滤后)。
the_edit_pre
显示编辑页面前,应用于日志标题
wp_dropdown_pages
应用于由wp_dropdown_pages函数生成的WordPress页面的HTML下拉列表。
wp_list_pages
应用于由wp_list_pages函数生成的HTML列表。
wp_list_pages_excludes
在wp_list_pages函数中,应用于被排除在外的页面列表(页面ID数组)
wp_get_attachment_metadata
应用于wp_get_attachment_metadata 函数检索到的附件元数据。过滤器函数接收的参数:元数据,附件ID。
wp_get_attachment_thumb_file
应用于wp_get_attachment_thumb_file 函数检索到的附件缩略图文件。过滤器函数接收的参数:缩略图文件,附件ID。
wp_get_attachment_thumb_url
应用于wp_get_attachment_thumb_URL 函数检索到的附件缩略图URL。过滤器函数接收的参数:缩略图URL,附件 ID。
wp_get_attachment_url
应用于wp_get_attachment_url 函数检索到的附件URL。过滤器函数接收的参数:URL,附件 ID。
wp_mime_type_icon
应用于wp_mime_type_icon 函数为附件计算出的MIME类型图标。过滤器函数接收的参数:计算出的图标URI , MIME 类型,日志 ID。
wp_title
在wp_title函数中,应用于尚未发送到浏览器的博客页面标题
数据库写入
本部分中的过滤器函数适用于尚未保存到数据库中的数据。
add_ping
应用于添加ping引用后、保存入数据库前的日志引用域的新值。
attachment_max_dims
缩小图片前,应用于最大图片尺寸。过滤器函数输入值(以及返回的值)是false(若未规定最大尺寸)或一个两栏列表(宽度、高度)
category_save_pre
应用于尚未保存到数据库前的、由逗号隔开的日志类别列表(也可用于附件)。
comment_status_pre
应用于尚未保存到数据库前的日志评论状态(也可用于附件)。
content_filtered_save_pre
应用于尚未保存到数据库前、经过过滤的日志正文(也可用于附件)。
content_save_pre
应用于尚未保存到数据库前的日志正文(也可用于附件)。
excerpt_save_pre
应用于尚未保存到数据库前的日志摘要(也可用于附件)。
name_save_pre
应用于尚未保存到数据库前的日志名称(也可用于附件)。
phone_content
应用于尚未保存到数据库前、由电子邮件提交的日志正文。
ping_status_pre
应用于尚未保存到数据库前的日志引用状态(也可用于附件)。
post_mime_type_pre
应用于尚未保存到数据库中的插件的MIME类型
status_save_pre
应用于尚未保存到数据库中的日志状态。
thumbnail_filename
应用于上传图片时缩略图的文件名。
wp_thumbnail_creation_size_limit
应用于上传图片时缩略图的大小。过滤器函数接收的参数:文件最大尺寸,附件 ID,附件文件名。
wp_thumbnail_max_side_length
应用于上传图片时缩略图的大小。过滤器函数接收的参数:图片侧边最大尺寸, 附件ID,附件文件名。
title_save_pre
应用于尚未存储到数据库中的日志标题(也可用于附件)。
update_attached_file
在update_attached_file 函数中,应用于尚未保存到日志元数据中的附件信息。过滤器函数接收的参数:附件信息,附件ID。
wp_delete_file
应用于被删除前的附件文件名
wp_generate_attachment_metadata
应用于保存到数据库前的附件元数据数组。
wp_update_attachment_metadata
应用于尚未保存到wp_update_attachment_metadata 函数的附件元数据。过滤器函数接收的参数:元数据,附件ID。
评论、引用通告、Ping过滤器
数据库读取
本部分中的过滤器函数适用于从数据库读出的、尚未显示到页面或编辑界面的数据。
commet_excerpt
在comment_excerpt函数中,应用于评论摘要。参见get_comment_excerpt。
comment_flood_filter
若有人试图评论轰炸某个博客,博客主人可以使用comment_flood_filter。过滤器函数接收的参数:已锁定(true/false,是否已经有过了插件锁定了此人的评论;可以在插件中将此参数值设为true并返回true以锁定评论), 之前评论时间,当前评论时间。
comment_post_redirect
应用于有人发表评论后的重定向位置。过滤器函数接收的参数:重定向位置,评论信息数组。
comment_text
在comment_text函数和管理菜单中,应用于尚未显示在屏幕上的评论内容。
comment_text_rss
在包含RSS订阅前,应用于评论内容。
comments_array
在comments_template函数中,应用于日志的评论数组。过滤器函数可接收的参数:评论信息结构数组,日志 ID。
comments_number
应用于comments_number函数生成评论数量的格式化文本。参见get_comments_number。
get_comment_excerpt
应用于由get_comment_excerpt函数从数据库读出的评论摘要(comment_excerpt也会从数据库读出评论摘要)。参见comment_excerpt。
get_comment_ID
应用于get_comment_ID函数从全局变量$comments 中读出的评论ID。
get_comment_text
在get_comment_text函数中,应用于当前评论的评论内容,comment_text函数也会调用评论内容。
get_comment_type
在get_comment_type中,应用于评论类型("comment", "trackback", 或 "pingback"),comment_type也会调用评论类型。
get_comments_number
应用于get_comments_number函数从全局变量$post中读出的评论总数(comments_number函数也会调用评论总数;参见comments_number过滤器)。
post_comments_feed_link
应用于comments_rss函数为评论feed生成的feed URL。
数据库写入
本部分中的过滤器函数适用于尚未保存到数据库中的数据。
comment_save_pre
应用于更新/编辑前的评论信息。函数接收的参数:评论信息数据,包括"comment_post_ID", "comment_author", "comment_author_email", "comment_author_url", "comment_content", "comment_type", 以及 "user_ID"。
pre_comment_approved
应用于当前评论的审核状态(true/false),以便于插件进行重写。返回true(或false)并将第一个参数设为true(或false),表示批准(或不批准)该评论,使用$comment_ID等全局变量获取该评论的信息。
pre_comment_content
当评论尚未写入数据库时,应用于评论内容。
preprocess_comment
将评论保存到数据库中,尚未进行其它操作时,应用于评论信息。函数可接收的参数:评论信息数组,包括"comment_post_ID", "comment_author", "comment_author_email", "comment_author_url", "comment_content", "comment_type", 以及"user_ID"。
wp_insert_post_data
更新数据库中的日志前,应用于wp_insert_post()中经过修改以及未经修改的日志信息。函数接收的参数:经过修改的日志数组与经过过滤的日志数组。
类别过滤器
参见下文中的管理界面过滤器。
数据库读取
本部分中的过滤器函数适用于从数据库读出的、尚未显示到页面或编辑界面的数据。
category_description
应用于category_description 以及wp_list_categories函数中的“description”字段类别。过滤器函数接收的参数:说明,(从category_description中调用的)类别 ID;说明,(从wp_list_categories中调用的)类别信息数组(包括该类别的类别表中所有字段)。
category_feed_link
应用于get_category_rss_link函数为类别feed生成的feed URL。
category_link
应该用于get_category_link函数为类别生成的URL。过滤器函数接收的参数:链接 URL,类别 ID。
get_categories
应用于get_categories函数生成的类别列表(很多其它函数会使用get_categories函数所生成的类别列表)。过滤器函数接收的参数:类别列表,,get_categories选项列表。
get_category
应用于get_category函数查找到的类别信息。该信息是一个数组,数组包括WordPress类别表中某个指定类别ID的所有字段。
list_cats
应用于两种不同情况下:
1. wp_dropdown_categories函数用list_cats过滤器过滤show_option_all 与show_option_none参数(这两个参数可在类别下拉列表中添加“All”和“None”选项)。过滤器函数不接受其它参数。
2. wp_list_categories函数将list_cats过滤器用在类别名称中。过滤器函数接收的参数:类别名称,类别信息列表(类别表中该类别的所有字段)。
list_cats_exclusions
get_categories函数将排除一些类别,list_cats_exclusions应用于可给出这些类别的SQL WHERE语句。插件也可以排除类别列表中的类别或类别组。过滤器函数接收的参数:排除类别的WHERE语句,get_categories选项列表。
single_cat_title
生成博客页面标题时,wp_title函数 与single_cat_title函数将single_cat_title用于类别名称。
the_category
在et_the_category_list函数中,应用于类别列表(带有链接的HTML列表)。过滤器函数接收的参数:生成的HTML文本,当前使用的列表分隔符(空字符串表示默认LI列表),父参数为get_the_category_list。
the_category_rss
包含RSS 订阅前,在get_the_category_rss函数中应用于日志的类别列表(类别XML元素列表)。过滤器函数接收的参数包括列表内容和类型(一般是"rdf"或"rss")。
wp_dropdown_cats
应用于wp_dropdown_categories函数生成的下拉类别列表(含有HTML选项元素的文本字符串)。
wp_list_categories
应用于wp_list_categories函数生成的类别列表(HTML列表)。
数据库写入
本部分中的过滤器函数适用于尚未保存到数据库中的数据。
pre_category_description
应用于尚未保存到数据库中的类别说明
pre_category_name
应用于尚未保存到数据库中的类别名称。
pre_category_nicename
应用于尚未保存到数据库中的类别别名。
链接过滤器
注意:本部分是关于日志、页面、存档、订阅等链接的过滤器函数。博客反向链接过滤器函数见下文。
attachment_link
在get_attachment_link函数中,应用于总计出的附件永久链接。过滤器函数接收的参数:链接 URL,附件ID。
author_feed_link
应用于get_author_rss_link 函数为作者订阅生成的订阅URL。
author_link
应用于get_author_posts_url 函数生成的作者存档永久链接。过滤器函数接收的参数:链接URL,作者别名, 作者 ID。注意,get_author_posts_url在wp_list_authors与the_author_posts_link内被调用。
comment_reply_link
应用于get_comment_reply_link函数为回复某个特定评论而生成的链接。get_comment_reply_link函数在comments_template函数中被调用。过滤器函数接收的参数:链接(字符串),自定义选项(数组),当前评论(对象),当前日志(对象)。
day_link
在get_day_link函数中,应用于日存档文章的链接URL。过滤器函数接收的参数:URL,年,月,日。
feed_link
在get_feed_link函数中,应用于订阅的链接URL。过滤器函数接收的参数:URL,订阅类型(如"rss2","atom"等)。
get_comment_author_link
在get_comment_author_link函数中,应用于评论中为作者链接而生成的HTML(comment_author_link也会调用此HTML)。动作函数接收的参数:用户名。
get_comment_author_url_link
在get_comment_author_url_link函数中,应用于评论中为作者链接而生成的HTML(comment_author_link也会调用此HTML)。
month_link
在get_month_link函数中,应用于月存档日志的链接URL。过滤器函数接收的参数:URL,年,月。
page_link
在get_page_link函数中,应用于计算出的页面URL。过滤器函数接收的参数:URL,页面 ID。注意:有一个内部过滤器函数被称为_get_page_link,该过滤器也可过滤非博客主页上的页面URL(_get_page_link与page_link参数相同)。
post_link
在get_permalink函数中,应用于计算出的页面永久链接。the_permalink, post_permalink, previous_post_link以及next_post_link函数也会调用此类页面永久链接。过滤器函数接收的参数:永久链接,日志信息列表。
the_permalink
在the_permalink函数中,应用于尚未显示在浏览器上的日志永久链接。
year_link
在get_year_link函数中,应用于年存档日志的链接。过滤器函数接收的参数:URL,年。
日期和时间过滤器函数
get_comment_date
应用于get_comment_date函数生成的格式统一的评论日期(comment_date函数也会调用此类评论日期)。
get_comment_time
在get_comment_time函数中应用于格式统一的评论时间(comment_time函数也会调用此类评论时间)。
get_the_modified_date
应用于由get_the_modified_date函数生成的、格式统一的日志修改日期(the_modified_date函数也会调用此类日志日期)。
get_the_modified_time
应用于由get_the_modified_time和get_post_modified_time函数生成的、格式统一的日志修改时间(the_modified_time也会调用此类时间)。
get_the_time
应用于get_the_time和get_post_time函数生成的、格式统一的日志时间(the_time函数也会调用此类日志时间)。
the_date
应用于the_date函数所生成的、格式统一的日志发表日期。
the_modified_date
应用于由the_modified_date函数生成的、格式统一的日志修改日期。
the_modified_time
应用于由the_modified_time函数生成的、格式统一的日志修改时间。
the_time
应用于由the_time函数生成的、格式统一的日志发表时间。
the_weekday
应用于由the_weekday函数生成的日志发表日期当天的星期数。
the_weekday_date
应用于由the_weekday_date函数生成的日志发表日期当天的星期数。函数接收的参数包括:星期数(周一、周二、周三、周四、周五、周六、周日),before text与after text。
作者和用户过滤器函数
login_redirect
在用户登录过程中,应用于redirect_to post/get变量。
数据库读取
本部分中的过滤器函数适用于从数据库读出的、尚未显示到页面或编辑界面的数据。
author_email
应用于comment_author_email函数从数据库检索到的评论者的电子邮件地址。参见get_comment_author_email。
comment_author
应用于comment_author函数从数据库检索到的评论者的名称。参见get_comment_authorl。
comment_author_rss
包含RSS订阅前,应用于评论者的名称。
comment_email
应用于comment_author_email_link函数从数据库检索到的评论者的电子邮件地址。
comment_url
应用于comment_author_url函数从数据库检索到的评论者的URL地址(参见get_comment_author_url)。
get_comment_author
应用于get_comment_author函数从数据库检索到的评论者的名称,comment_author函数也会调用此类评论者名称。参见comment_author。
get_comment_author_email
应用于get_comment_author_email函数从数据库检索到的评论者的电子邮件地址。comment_author_email也会调用此类电子邮件地址。参见author_email。
get_comment_author_IP
应用于get_comment_author_IP函数从数据库检索到的评论者的IP地址。comment_author_IP函数也会调用此类IP地址。
get_comment_author_url
应用于get_comment_author_url函数从数据库检索到的评论者的URL。comment_author_url函数也会调用此类URL地址。参见comment_url。
login_errors
应用于显示在登录界面上的登录错误信息。
login_headertitle
应用于显示在登录界面上的登录信息头URL(WordPress默认显示)标题。
login_headerurl
应用于显示在登录界面上的登录信息头URL(默认指向WordPress.org)。
login_message
应用于显示在登录界面上的登录信息。
role_has_cap
在WP_Role->has_cap函数中应用于某位用户的权限列表。过滤器函数接收的参数包括:将要被过滤的权限列表,目前还无法使用的权限,以及用户名称。
sanitize_user
在sanitize_user函数中应用于用户名。过滤器函数接收的参数包括:用户名 (整理后),原始用户名,strict(true或者false,表示使用/不使用精确的ASCII码)。
the_author
在get_the_author函数中,应用于日志作者所显示的名称。the_author函数也会调用该名称。
the_author_email
在the_author_email函数中,应用于日志作者的点知邮件地址。
数据库写入
本部分中的过滤器函数适用于尚未保存到数据库中的数据。
pre_comment_author_email
应用于评论尚未保存到数据库时该评论作者的电子邮件地址。
pre_comment_author_name
应用于评论尚未保存到数据库时该评论作者的用户名。
pre_comment_author_url
应用于评论尚未保存到数据库时该评论作者的URL。
pre_comment_user_agent
应用于评论尚未保存到数据库时该评论作者的用户代理。
pre_comment_user_ip
应用于评论尚未保存到数据库时该评论作者的IP地址。
pre_user_id
应用于评论尚未保存到数据库时该评论作者的用户ID。
pre_user_description
应用于尚未保存到数据库中的用户说明。
pre_user_display_name
应用于尚未保存到数据库中的用户显示名。
pre_user_email
应用于尚未保存到数据库中的用电子邮箱地址。
pre_user_first_name
应用于尚未保存到数据库中的用户的名字。
pre_user_last_name
应用于尚未保存到数据库中的用户的姓。
pre_user_login
应用于尚未保存到数据库中的用户登录名。
pre_user_nicename
应用于尚未保存到数据库中的用户别名。
pre_user_display_name
应用于尚未保存到数据库中的用户昵称。
pre_user_url
应用于尚未保存到数据库中的用户URL。
registration_errors
应用于注册新用户所生成的注册错误列表。
user_registration_email
在用户首次登录时,应用于从注册页面读取到的该用户电子邮件地址。
validate_username
应用户新用户名的验证结果。过滤器函数接收的参数:valid (true/false), 被验证的用户名。
反向链接过滤器
注意:本部分是关于反向链接的过滤器函数。日志、页面、类别等连接过滤器函数见上文。
get_bookmarks
在get_bookmarks函数中,应用于反向链接数据库查询结果。过滤器函数接收的参数:数据库查询结果列表,get_bookmarks参数列表。
link_category
在get_links_list 和 wp_list_bookmarks函数中,应用于链接说明。
link_rating
在get_linkrating函数中,应用于链接评价值。
link_title
在get_links和wp_list_bookmarks函数中,应用于链接标题。(自WordPress 2.2起)
pre_link_description
应用于尚未保存到数据库中的链接说明。
pre_link_image
应用于尚未保存到数据库中的链接图片。
pre_link_name
应用于尚未保存到数据库中的链接名称。
pre_link_notes
应用于尚未保存到数据库中的链接注释。
pre_link_rel
应用于尚未保存到数据库中的链接联系信息。
pre_link_rss
应用于尚未保存到数据库中的链接RSS URL地址。
pre_link_target
应用于尚未保存到数据库中的链接目标信息。
pre_link_url
应用于尚未保存到数据库中的链接URL。
博客信息和选项过滤器函数
all_options
应用于get_alloptions函数从数据库中检索到的选项列表。
bloginfo
应用于get_bloginfo函数检索博客选项信息后,bloginfo函数再次从数据库中检索出的博客选项信息。第二个参数$show给出所请求的bloginfo选项名称。注意:bloginfo("url"),bloginfo("directory") 与bloginfo("home")不使用该过滤器函数(参见bloginfo_url)。
bloginfo_rss
在get_bloginfo_rss函数中, get_bloginfo函数首次检索过博客选项信息、过滤HTML标签、转换相应字符后,应用于博客选项信息(bloginfo_rss函数也调用此类信息)。参数$show给出所请求的bloginfo选项名称。
bloginfo_url
应用于bloginfo("url"), bloginfo("directory") 以及bloginfo("home")尚未返回的输出结果。
loginout
应用于wp_loginout函数为用户登录和退出生成的HTML链接。
option_(option name)
应用于反序列化(解码基于数组的选项)后,get_option函数从数据库检索到的选项值。使用该过滤器函数时需要为特定选项名称添加过滤器函数,例如为 "option_foo"添加过滤器以过滤get_option("foo")的输出结果。
pre_option_(option name)
应用于反序列化后get_alloption函数从数据库检索到的选项值(解码基于数组的选项)。使用该过滤器函数时需要为特定选项名称添加过滤器函数,例如为 "pre_option_foo"添加过滤器以过滤"foo"选项。
register
应用于wp_register函数为用户创建的、用以注册(在允许注册的情况下)或访问控制板(已登录用户)的侧边栏链接。
upload_dir
应用于wp_upload_dir函数用以上传文件的文件目录。过滤器函数接收的参数是一个带有"dir"(上传目录路径)、"url"(上传目录的URL)、"error"(如果需要生成错误信息,可将此项设为true)元素的数组。
upload_mimes
若没有MIME列表输入wp_check_filetype函数,upload_mimes允许过滤器函数返回MIME类型列表以供上传。
一般性文章过滤器函数
attribute_escape
在attribute_escape函数中,应用于日志正文和其它内容。WordPress在多处地方调用attribute_escape以在内容发送到浏览器前,将某些字符改为HTML属性。
js_escape
在js_escape函数中,内容发送到浏览器窗口前,应用于Javascript代码。
管理界面过滤器函数
本部分是关于包括内容编辑界面在内的WordPress管理界面的过滤器函数。
autosave_interval
应用于自动保存日志的时间间隔中。
cat_rows
在管理菜单中,应用于为管理类别而生成的类别行HTML。
comment_edit_pre
应用于尚未显示到编辑界面上的评论内容。
comment_edit_redirect
当有人在管理菜单中编辑评论后,应用于重定向。过滤器函数接收的参数:重定向地址,评论ID。
comment_moderation_subject
应用于通知网站管理人员审核新评论时发送的电子邮件的邮件主题。过滤器函数接收的参数:邮件主题,评论 ID。注意:该过程发生在 wp_notify_moderator 函数中。 wp_notify_moderator 是一个“可插入式”函数,即插件能够改写该函数;参见插件API。
comment_moderation_text
应用于通知网站管理人员审核新评论时发送的电子邮件的邮件正文。过滤器函数接收的参数:邮件正文内容,评论 ID。注意:该过程发生在 wp_notify_moderator 函数中。 wp_notify_moderator 是一个“可插入式”函数,即插件能够改写该函数;参见插件API。
comment_notification_headers
应用于通知日志作者有新评论时所发送的电子邮件的邮件标头。过滤器函数接收的参数:邮件标头,评论 ID。注意:该过程发生在 wp_notify_postauthor函数中。 wp_notify_postauthor是一个“可插入式”函数,即插件能够改写该函数;参见插件API。
comment_notification_subject
应用于通知日志作者有新评论时所发送的电子邮件的邮件主题。过滤器函数接收的参数:邮件主题,评论ID。注意:该过程发生在 wp_notify_postauthor函数中。 wp_notify_postauthor是一个“可插入式”函数,即插件能够改写该函数;参见插件API。
comment_notification_text
应用于通知日志作者有新评论时发送的电子邮件的邮件正文。过滤器函数接收的参数:邮件正文,评论 ID。注意:该过程发生在 wp_notify_postauthor函数中。 wp_notify_postauthor是一个“可插入式”函数,即插件能够改写该函数;参见插件API。
cron_schedules
在wp_get_schedules函数中,应用于一个空数组,让插件能够生成计划任务。
default_content
应用于尚未打开新日志的编辑框时默认的日志内容。
default_excerpt
应用于尚未打开新日志的编辑框时默认的日志摘要。
default_title
应用于尚未打开新日志的编辑框时默认的日志标题。
editable_slug
在get_sample_permalink函数中,应用于日志、页面、标签以及类别的别名。
explain_nonce_(verb)-(noun)
允许过滤器函数定义文本,用文本来解释WordPress核心代码没有解释的随机数。使用此参数前用户需要定义特别的动词/名词过滤器。例如,如果我们开发的插件为升级标签定义了一个随机数,我们就需要为“explain_nonce_update-tag”定义一个过滤器。过滤器函数接收的参数: 将要显示的文本(默认为常见的 "Are you sure you want to do this?")以及动作URL末尾部分的信息。
format_to_edit
在format_to_edit函数中,应用于正文、摘要、标题和密码,管理菜单会调用format_to_edit函数来设定需要编辑的日志。在管理菜单中编辑评论时也可用到该参数。
format_to_post
在format_to_post函数中,应用于日志内容。默认情况下WordPress不使用这个参数。
manage_link-manager_columns
在WordPress 2.7以前,这个参数被称为manage_link_columns。应用于栏列表,以在反向链接管理界面上输入内容。过滤器函数的参数值/返回的值是一个关联列表,其中的元素关键字是栏名称,元素值是该栏页眉处的文本。参见动作函数manage_link_custom_column,这个函数将栏信息放在编辑界面中。
manage_posts_columns
应用于栏列表,以在日志管理界面上输入内容。过滤器函数的参数值/返回的值是一个关联数组,其中的元素关键字是栏名称,元素值是该栏页眉处的文本。参见动作函数manage_posts_custom_column,这个函数将栏信息放入编辑界面。
manage_pages_columns
应用于栏列表,以在页面管理界面上输入内容。过滤器函数的参数值/返回的值是一个关联数组,其中的元素关键字是栏名称,元素值是该栏页眉处的文本。参见动作函数manage_pages_custom_column,这个函数将栏信息放入编辑界面。
postmeta_form_limit
应用于日志编辑界面上的日志meta信息项的个数。
pre_upload_error
上传文件时,允许插件生成XMLRPC错误。
preview_page_link
应用于页面编辑界面上的链接,页面预览效果显示在界面下方。
preview_post_link
应用于日志编辑界面上的链接,日志预览效果显示在界面下方。
richedit_pre
在wp_richedit_pre函数中,应用于尚未显示到富文本编辑器的日志内容。
show_password_fields
应用于true/false变量,该变量决定用户是否选择在用户资料界面上更改密码(若变量值为true,显示密码修改项;变量值为false,表示用户无需修改密码)。
the_editor
应用于尚未显示在屏幕上的HTML DIV,该DIV用以存放富文本编辑器。过滤器函数的参数/返回的值是一个字符串。
user_can_richedit
在user_can_richedit函数中,用于统计用户的浏览器是否具有富编辑功能,以及用户是否希望使用富文本编辑器。若当前用户能够/不能够使用富文本编辑器时,过滤器函数的参数(返回值)为true/false。
user_has_cap
在WP_User->has_cap函数中,应用于用户的权限列表(current_user_can 函数调用WP_User->has_cap函数)。该过滤器函数的参数是将要被过滤的权限列表,以及参数列表(若用户能够编辑日志,参数列表中将包括日志ID等内容)。
wp_handle_upload
应用于上传文件时的相关上传信息。该过滤器函数的参数:带有"file"(文件名)、"url"、"type"元素的数组。
wp_upload_tabs
应用于自定义表的列表,以显示在上传管理界面上。该参数用动作函数upload_files_(tab)显示自定义表的页面。
富文本编辑器相关过滤器函数
本部分中的过滤器函数修改了富文本编辑器的配置。
mce_spellchecker_languages
应用于拼写检查器中有效的语言选择。
mce_buttons, mce_buttons_2, mce_buttons_3, mce_buttons_4
应用于富文本编辑器中的按钮行(每一行都是按钮名称的数组)。
mce_css
应用于富文本编辑器的CSS文件URL。
mce_external_plugins
应用于富文本编辑器加载的外部插件列表。
mce_external_languages
应用于外部插件加载的语言文件列表(参见 tinymce/langs/wp-langs.php)。
tiny_mce_before_init
应用于编辑器的完整初始化数组。
模板过滤器函数
本部分是关于主题、模板和样式文件的链接过滤器函数。
kubrick_header_color
应用于默认主题页眉处的颜色。
kubrick_header_display
应用于默认主题页眉处的显示设置。
kubrick_header_image
应用于默认主题的页眉图片文件。
locale_stylesheet_uri
应用于get_locale_stylesheet_uri函数返回的、指定位置的样式表单URI。过滤器函数的参数:URI,样式表单目录URI。
stylesheet
应用于get_stylesheet函数返回的样式表单。
stylesheet_directory
应用于get_stylesheet_directory函数返回的样式表单目录。过滤器函数的参数:样式表单目录,样式表单。
stylesheet_directory_uri
应用于get_stylesheet_directory_uri函数返回的样式表单目录URI。过滤器函数的参数:样式表单目录URI,样式表单。
stylesheet_uri
应用于get_stylesheet_uri函数返回的样式表单URI。过滤器函数的参数:样式表单URI,样式表单。
template
应用于get_template函数返回的模板。
template_directory
应用于get_template_directory函数返回的模板目录。过滤器函数的参数:模板目录,模板。
template_directory_uri
应用于get_template_directory_uri函数返回的模板目录URI。过滤器函数的参数:模板目录URI,模板。
theme_root
应用于get_theme_root函数返回的主题根目录(正常情况下即wp-content/themes).
theme_root_uri
应用于get_theme_root_uri函数返回的主题根目录URI。过滤器函数的参数:URI,网站URL。
我们也可以用以下过滤器钩子来代替主题中的单个模板文件。每个过滤器函数都将当前主题中相应的模板文件路径作为输入内容。插件可以为模板文件返回新的路径,以此修改将要使用的文件。
404_template
archive_template
attachment_template
author_template
category_template
comments_popup_template
comments_template
date_template
home_template
page_template
paged_template
search_template
single_template
高等WordPress过滤器函数
本部分是与WordPress查询语句、重写规则、国际化以及其它WordPress核心功能相关的高等过滤器函数。
author_rewrite_rules
应用于已生成的、与作者相关的重写过则。
category_rewrite_rules
应用于已生成的、与类别相关的重写规则。
comments_rewrite_rules
应用于已生成的、与评论相关的重写规则。
creat_user_query
应用于尚未执行的、用以将新用户信息存入数据库的查询语句。
date_rewrite_rules
应用于已生成的、与日期相关的重写规则。
found_posts
应用于执行数据库查询后的日志列表。
found_posts_query
数据库查询过即将显示在页面上的日志列表后,WordPress会在查询结果中选择日志行。此时用户可用该过滤器函数来进行其它操作,而不是执行SELECT FOUND_ROWS()。
get_editable_authors
在get_editable_authors函数中,应用于当前用户有权管理的日志作者列表。
gettext
应用于 __ and _e国际化函数翻译的文本。过滤器函数的参数:翻译文本和未翻译文本。该过滤器函数只在国际化有效且已加载文本域后有效。
get_next_post_join
在get_next_post函数(该函数查找当前日志之后需要显示的日志)中,应用于SQL JOIN语句(当用户查看类别存档时,该语句通常与类别表相连接)。过滤器函数的参数:JOIN语句,stay in same category (true/false),被排除的类别列表。
get_next_post_sort
在get_next_post函数(该函数查找当前日志之后需要显示的日志)中,应用于SQL ORDER BY语句(该语句通常按日志发表时间升序排列日志;至少需要有一篇日志)。过滤器函数的参数:ORDER BY语句。
get_next_post_where
在get_next_post函数(该函数查找当前日志之后需要显示的日志)中,应用于SQL WHERE语句(该语句通常按时间顺序查找下一篇已发表日志)。过滤器函数的参数:WHERE语句,stay in same category (true/false),被排除的类别类表。
get_others_drafts
应用于查询语句,该查询语句能够选择其他用户的日志草稿并显示在管理菜单中。
get_previous_post_join
在get_previous_post函数(该函数查找当前日志之前所显示的日志)中,应用于SQL JOIN语句(当用户查看类别存档时,该语句通常与类别表相连接)。过滤器函数的参数:JOIN语句,stay in same category (true/false),被排除的类别列表。
get_previous_post_sort
在get_previous_post函数(该函数查找当前日志之前所显示的日志)中,应用于SQL ORDER BY语句(该语句通常按日志发表时间降序排列日志;至少需要有一篇日志)。过滤器函数的参数:ORDER BY语句。
get_previous_post_where
在get_previous_post函数(该函数查找当前日志之前所显示的日志)中,应用于SQL WHERE语句(该语句通常按时间顺序查找上一篇已发表日志)。过滤器函数的参数:WHERE语句,stay in same category (true/false),被排除的类别类表。
get_user_drafts
应用于查询语句,该查询语句能够选择其他用户的日志草稿并显示在管理菜单中。
locale
应用于get_locale函数的存储位置。
mod_rewrite_rules
应用于重写规则列表,用户更改永久链接结构时将该重写规则列表存入.htaccess文件。
post_limits
应用于查询的LIMIT语句,该查询可返回日志数组。
posts_distinct
允许插件将DISTINCTROW语句加入查询,该查询可返回日志数组。
posts_fields
应用于查询的字段列表,该查询可返回日志数组。
posts_groupby
应用于查询的GROUP BY语句,该查询返回日志数组(通常情况下该数组为空)。
posts_join_paged
应用于查询语句的JOIN语句。在计算出分页后,该查询返回日志列表(分页并不影响JOIN语句,因此该函数相当于posts_join)。
posts_orderby
应用于查询语句的ORDER BY语句。该查询返回日志数组。
posts_request
应用于尚未执行的、将返回日志数组的SQL查询语句整体。
post_rewrite_rules
应用于已生成的、与日志相关的重写规则。
root_rewrite_rules
应用于生成后的根目录级重写规则。
page_rewrite_rules
应用于已生成的、与页面相关的重写规则。
posts_where_paged
应用于查询的WHERE语句。在计算出分页后,该查询返回日志数组(分页并不影响WHERE语句,因此该函数相当于posts_where)。
posts_join
应用于查询的JOIN语句。该查询返回日志数组。这个过滤器函数与posts_where过滤器函数一并为JOIN语句添加了一个数据库表。
posts_where
应用于查询的WHERE语句。该查询返回日志数组。
query
应用于所有查询语句(至少加载插件后运行的所有查询语句)。
query_string
已停用——可用query_vars或request来代替该函数。
query_vars
在生成SQL查询语句前,应用于WordPress公共查询变量列表。适用于删除插件进行其它操作时多余的永久链接信息。
request
类似query_vars,但request用在添加了“额外”的私有查询变量后。
rewrite_rules_array
应用于已生成的所有重写规则。
search_rewrite_rules
应用于已生成的、与查找相关的重写规则。
the_posts
WordPress对只有一篇日志的网页进行许可权限和草稿状态的最简单处理后,将the_posts用在从数据库查询出的日志列表上。
excerpt_length
定义某一篇日志摘要的长度。
update_user_query
应用于更新查询语句。该查询语句可在执行查询前更新用户信息。
uploading_iframe_src(自WordPress 2.5后被删除)
为日志和页面编辑界面中所上传的内嵌框架使用HTML src标签。
wp_redirect
在wp_redirect函数中,应用于重定向的URL。过滤器函数的参数:URL,HTTP状态码。注意:wp_redirect是一个“可插入式”函数,插件能够改写该函数;参见插件API。
xmlrpc_methods
应用于已经为XMLRPC服务器定义的XMLRPC方法列表。
wp_mail_from
在wp_mail函数中,用于发出邮件前。该函数的输入值是邮件地址的计算结果,这里的邮件地址即当前主机名称下的WordPress(该值由$_SERVER['SERVER_NAME']规定)。过滤器函数wp_mail_from返回一个邮件地址,如“user@example.com”,或姓名和邮件地址的组合,如“Name <user@example.com>”(均无引号)。
wp_mail_from_name
在wp_mail函数中,用于发出邮件前。过滤器函数wp_mail_from_name返回一个名称字符串,该字符串将用作邮件发送人的名称。
发表评论
-
[WORDPRESS系列]WordPress翻译中 __()、_e()、_x、_ex 和 _n 的用法及区别
2015-04-20 17:24 0来源:http://www.wpdaxue.com/diffe ... -
WordPress过滤钩子函数add_filter()、apply_filters()源码解析
2015-04-20 17:06 0参考:http://www.ecdoer.com/ ... -
[WORDPRESS]is_home和is_front_page使用方法
2015-04-20 16:12 0http://www.111cn.net/wy/wordpre ... -
[WORDPRESS系列]WordPress官方文档:条件判断标签及用法大全
2015-04-20 16:11 0参考 http://yusi123.com/3041.htm ... -
[WORDPRESS系列]WordPress主查询函数query_posts用法汇总
2015-04-20 15:41 0参考:http://yusi123.com/3605.html ... -
[WORDPRESS系列]WordPress 函数 wp_enqueue_script 与 wp_print_scripts 的区别
2015-04-20 15:38 0wp_enqueue_script 是告诉 WordPress ... -
[WORDPRESS系列]在主题的 function.php 中给 WordPress 编辑器添加自定义按钮(Quicktags)
2015-04-20 15:09 1189参考资料: http://www.ssdn2007.com/w ... -
[WORDPRESS系列]子主题
2015-04-20 14:40 629参考来源: https://codex.wordpress.o ... -
[WORDPRESS系列]插件API之常用动作(action)
2015-04-20 14:07 1072参考来源: http://www.wordpress.la/c ... -
[WORDPRESS系列]WordPress 模板层次详细介绍
2015-04-20 10:51 732参考来源:http://blog.wpjam.com/arti ... -
[WORDPRESS系列]dashboard 外观添加小工具
2015-04-17 17:49 720参考 http://codex.wordpress.org/z ... -
[WORDPRESS系列] : endif;endwhile;流程控制的替代语法
2015-04-17 14:56 964参考:http://php.net/manual/zh/con ... -
[WORDPRESS系列]常用函数
2015-04-17 14:47 1572wpautop 简介 将文本中的两个换行符转换成 HTML ... -
[WORDPRESS系列]WordPress的have_posts()和the_post()用法解析
2015-04-17 14:28 1095在WordPress的index.php文章循环输出中,通常会 ...
相关推荐
wordpress官方百度分享插件!压缩包中包含使用方法
Chapter 2, Interacting with REST API in WordPress, is where you will learn the basics of the REST API in WordPress. General POST and GET commands shall be covered here. Chapter 3, Working with ...
wordpress 3.7.1 ueditor 1.3.6 ueditor的好就不说了,参考http://ueditor.baidu.com/website/index.html 要注意的是:不同版本,插件的集成方式可能不太一样,所以,下载需看自己使用的wp版本。
"【WordPress插件】2022年最新版完整功能demo+插件v34.2 S3MediaVault - Amazon S3 Video & Audio Player and File Security for WordPress S3MediaVault - 亚马逊S3视频和音频播放器和WordPress的文件安全性" ----...
go-wordpress, Golang API的客户端库( Wordpress REST API ) go-wp-apiGolang api的客户端库( Wordpress REST API )安装go get github.com/sogko/go-wordpress用法快速示例package main
wordpress 客服插件
WordPress分页导航插件WordPress分页WordPress分页导航插件导航插件
关键字描述:常用 插件 代码 以及 &mdash 文章 即可   然后 统计 这篇文章是我之前为一个香港人做兼职的时候为他写的,因为合作不愉快所以也没继续做下去。现在把这个文档贡献出来,相信对于新手朋友接触...
wordpress 加速插件
相信大家都见过诸多wordpress大牛的网站都有独立下载页面吧!可是他们怎么实现的呢?...今天给大家带来的是一款无需新建wordpress网站,也无需大量代码适配即可完成的一款wordpress插件:wordpress独立下载页面插件
"【WordPress插件】2022年最新版完整功能demo+插件v2.7.15 SportsPress Pro - The only WordPress plugin for serious teams and athletes 体育投票专业 - 严肃的团队和运动员的唯一WordPress插件" ---------- 泰森...
在WordPress后台,我们需要下载插件,而后通过上传的方式启用这款插件。插件安装完成后进入后台文章编辑文本模式下可以看到有一个“插入微信隐藏标签”的按钮,选中需要隐藏的图文内容,然后点击该按钮则会自动为你...
易支付马支付与wordpress对接插件,绝对可用,可以在wordpress直接上传安装插件,设置简单,免签收款。
"【WordPress插件】2022年最新版完整功能demo+插件v1.7.5.5 Cooked Pro – Recipes, Cooking & Community WordPress Plugin 煮熟的专业食谱,烹饪和社区WordPress插件" ---------- 泰森云每天更新发布最新WordPress...
"【WordPress插件】2022年最新版完整功能demo+插件v2.1.7 WP Mega Menu Pro - Responsive Mega Menu Plugin for WordPress WP Mega菜单Pro - WordPress的响应式Mega菜单插件" ---------- 泰森云每天更新发布最新...
wordpress摘要插件wp-utf8-excerpt wordpress,摘要,全文,插件,excerpt
WordPress插件
Ueditor编辑器1.4.3.1 for wordpress 4.0插件
E-Proform过滤器 - 元素的电子插件" ---------- 泰森云每天更新发布最新WordPress主题、HTML主题、WordPress插件、shopify主题、opencart主题、PHP项目源码、安卓项目源码、ios项目源码,更有超10000个资源可供选择...
wordpress独立页面下载插件是一款应用于wordpress的下载页插件。插件特色:1、全面兼容wordpress3.9以上系统2、支持各种主题,保证兼容性3、独立的下载页面方便自由化定制,插入广告4、独立的查看演示页面,方便插入...