站长百科 | 数字化技能提升教程 数字化时代生存宝典
首页
数字化百科
电子书
建站程序
开发
服务器
办公软件
开发教程
服务器教程
软件使用教程
运营教程
热门电子书
WordPress教程
宝塔面板教程
CSS教程
Shopify教程
导航
程序频道
推广频道
网赚频道
人物频道
网站程序
网页制作
云计算
服务器
CMS
论坛
网店
虚拟主机
cPanel
网址导航
WIKI使用导航
WIKI首页
最新资讯
网站程序
站长人物
页面分类
使用帮助
编辑测试
创建条目
网站地图
站长百科导航
站长百科
主机侦探
IDCtalk云说
跨境电商导航
WordPress啦
站长专题
网站推广
网站程序
网站赚钱
虚拟主机
cPanel
网址导航专题
云计算
微博营销
虚拟主机管理系统
开放平台
WIKI程序与应用
美国十大主机
编辑“
WordPress插件API/常用过滤器(filter)
”
人物百科
|
营销百科
|
网赚百科
|
站长工具
|
网站程序
|
域名主机
|
互联网公司
|
分类索引
跳转至:
导航
、
搜索
警告:
您没有登录。如果您做出任意编辑,您的IP地址将会公开可见。如果您
登录
或
创建
一个账户,您的编辑将归属于您的用户名,且将享受其他好处。
反垃圾检查。
不要
加入这个!
<span style="border:1px solid #000; text-align:center; float:right; padding:6px;"><strong>导航:</strong> [[WordPress插件及插件开发资源|上一页]] | {{Template:WordPress导航}}</span> <div style="clear:both;"></div> 本文列出了WordPress 2.1及以上版本中,可用于插件开发的过滤器钩子(hook)。 *想了解过滤器钩子和动作钩子的定义和作用?请看[http://www.wordpress.la/codex-%E6%8F%92%E4%BB%B6API.html 插件API]。 *想了解插件的基本编写过程?请看[http://www.wordpress.la/codex-%E6%8F%92%E4%BB%B6%E5%BC%80%E5%8F%91.html 插件开发]。 *想查看动作钩子函数列表?请看[http://www.wordpress.la/codex-%E6%8F%92%E4%BB%B6API%E4%B9%8B%E5%B8%B8%E7%94%A8%E5%8A%A8%E4%BD%9C%28action%29.html 插件API/常用动作(action)]。 *想查找WordPress 2.1之前版本的过滤器钩子和动作钩子?请看[http://codex.wordpress.org/Plugin_API/Hooks_2.0.x 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 应用于两种不同情况下: #wp_dropdown_categories函数用list_cats过滤器过滤show_option_all 与show_option_none参数(这两个参数可在类别下拉列表中添加“All”和“None”选项)。过滤器函数不接受其它参数。 #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 是一个“可插入式”函数,即插件能够改写该函数;参见[http://www.wordpress.la/codex-%E6%8F%92%E4%BB%B6API.html 插件API]。 comment_moderation_text 应用于通知网站管理人员审核新评论时发送的电子邮件的邮件正文。过滤器函数接收的参数:邮件正文内容,评论 ID。注意:该过程发生在 wp_notify_moderator 函数中。 wp_notify_moderator 是一个“可插入式”函数,即插件能够改写该函数;参见[http://www.wordpress.la/codex-%E6%8F%92%E4%BB%B6API.html 插件API]。 comment_notification_headers 应用于通知日志作者有新评论时所发送的[[电子邮件]]的邮件标头。过滤器函数接收的参数:邮件标头,评论 ID。注意:该过程发生在 wp_notify_postauthor函数中。 wp_notify_postauthor是一个“可插入式”函数,即插件能够改写该函数;参见[http://www.wordpress.la/codex-%E6%8F%92%E4%BB%B6API.html 插件API]。 comment_notification_subject 应用于通知日志作者有新评论时所发送的[[电子邮件]]的邮件主题。过滤器函数接收的参数:邮件主题,评论ID。注意:该过程发生在 wp_notify_postauthor函数中。 wp_notify_postauthor是一个“可插入式”函数,即插件能够改写该函数;参见[http://www.wordpress.la/codex-%E6%8F%92%E4%BB%B6API.html 插件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 上传文件时,允许插件生成[[XML]]RPC错误。 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是一个“可插入式”函数,插件能够改写该函数;参见[http://www.wordpress.la/codex-%E6%8F%92%E4%BB%B6API.html 插件API]。 xmlrpc_methods 应用于已经为XMLRPC服务器定义的[[XML]]RPC方法列表。 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返回一个名称字符串,该字符串将用作邮件发送人的名称。 ==相关条目== *[[Drupal]] *[[OBLOG]] *[[X-Space]] *[[SaBlog-X]] *[[Bo-Blog]] [[category:WordPress中文文档|C]] [[category:WordPress网站开发|C]] [[category:WordPress开发文档|C]]
摘要:
请注意,您对站长百科的所有贡献都可能被其他贡献者编辑,修改或删除。如果您不希望您的文字被任意修改和再散布,请不要提交。
您同时也要向我们保证您所提交的内容是您自己所作,或得自一个不受版权保护或相似自由的来源(参阅
Wordpress-mediawiki:版权
的细节)。
未经许可,请勿提交受版权保护的作品!
取消
编辑帮助
(在新窗口中打开)
本页使用的模板:
模板:WordPress导航
(
查看源代码
)(受保护)