WordPress插件开发:Plugin API/Filter中文版文档

本文包含可用于 WordPress 2.1 及更高版本插件开发的广泛(但不是 100% 全面)过滤器钩子列表。

一、帖子、页面和附件(上传)过滤器

1、数据库读取

在页面或编辑屏幕上显示之前,此部分中的过滤器应用于从数据库读取的信息。

  • attach_fields_to_edit:应用于编辑附件时要显示的表单域。在get_attachment_fields_to_edit函数中调用。过滤器函数参数:表单字段数组,post 对象。
  • attachment_icon:应用于get_attachment_icon函数中的附件图标。过滤器函数参数:作为 HTML IMG 标签的图标文件、附件 ID。
  • attachment_innerHTML:如果没有图标,则在get_attachment_innerHTML函数中应用于要用于附件的标题。过滤器函数参数:内部 HTML(默认为标题)、附件 ID。
  • author_edit_pre:在显示以供编辑之前应用于帖子作者。
  • body_class:应用于 HTML元素的类。在get_body_class函数中调用。过滤器函数参数:类名数组和添加到第一个数组中的其他类名数组。
  • content_edit_pre:应用于在显示以进行编辑之前发布内容。
  • content_filtered_edit_pre:应用于在显示以供编辑之前过滤的帖子内容。
  • excerpt_edit_pre:在显示以供编辑之前应用于帖子摘录。
  • date_edit_pre:应用于显示之前的发布日期以进行编辑。
  • date_gmt_edit_pre:应用于显示之前的发布日期以进行编辑。
  • get_attached_file:应用于由get_attached_file函数检索的附加文件信息。过滤函数参数:文件信息、附件 ID。
  • get_enclosed:通过get_enclosed函数应用于帖子的附件列表。
  • get_pages:应用于get_pages函数返回的页面列表。过滤函数参数:页面列表(每一项包含一个页面数据数组),get_pages函数参数列表(告诉哪些页面被请求)。
  • get_pung:由get_pung函数应用于帖子的 ping URL 列表。
  • get_the_archive_title:应用于get_the_archive_title函数中的档案标题。
  • get_the_excerpt:应用于get_the_excerpt函数中的帖子摘录。
  • get_the_guid:在get_the_guid函数中应用于帖子的 GUID 。
  • get_to_ping:应用于通过get_to_ping函数对帖子进行 ping 的 URL 列表。
  • icon_dir:在几个函数中应用于模板的图像目录。基本上允许插件指定 MIME 类型的图标应该来自不同的位置。
  • icon_dir_uri:在几个函数中应用于模板的图像目录 URI。基本上允许插件指定 MIME 类型的图标应该来自不同的位置。
  • image_size_names_choose:应用于媒体库中可选择的图像尺寸列表。通常用于使自定义图像尺寸可选。
  • mime_type_edit_pre:在显示以供编辑之前应用于 post mime 类型。
  • modified_edit_pre:应用于显示编辑之前的后期修改日期。
  • modified_gmt_edit_pre:应用于显示以供编辑之前的修改后 GMT 日期。
  • no_texturize_shortcodes:适用于注册的短代码。可用于从自动纹理化功能中排除短代码。
  • parent_edit_pre:在显示以进行编辑之前应用于发布父 ID。
  • password_edit_pre:在显示以供编辑之前应用于发布密码。
  • post_class:应用于帖子的最外层 HTML 元素的类。在get_post_class函数中调用。过滤器函数参数:类名数组、添加到第一个数组的附加类名数组和帖子 ID。
  • pre_kses:在 KSES 处理之前应用于各种内容。这个钩子允许开发人员自定义哪些类型的脚本/标签应该被允许在内容中或被剥离。
  • prepend_attachment:应用于要由prepend_attachment函数添加的 HTML 。
  • protected_title_format:用于在帖子受密码保护时更改或操纵帖子标题。
  • private_title_format:用于在状态为私有时更改或操作帖子标题。
  • sanitize_title:在去除 HTML 标签后,由sanitize_title函数应用于帖子标题。
  • single_post_title:当wp_title和single_post_title函数用于创建博客页面标题时,应用于帖子标题。
  • status_edit_pre:在显示以供编辑之前应用于帖子状态。
  • the_content:在屏幕上打印之前应用于从数据库检索的帖子内容(也用于其他一些操作,例如引用)。
  • the_content_rss:在包含在 RSS 提要中之前应用于帖子内容。(已弃用)
  • the_content_feed:在包含在 RSS 提要中之前应用于帖子内容。
  • the_editor_content:在将内容放入丰富的编辑器窗口之前应用于发布内容。
  • the_excerpt:应用于在屏幕上打印之前从数据库中检索的帖子摘录(或帖子内容,如果没有摘录)(也用于其他一些操作,例如引用)。
  • the_excerpt_rss:在包含在 RSS 提要中之前应用于帖子摘录。
  • the_password_form:应用于受保护帖子的密码表单。
  • the_tags:在屏幕上打印之前应用于从数据库中检索到的标签。
  • the_title:在屏幕上打印之前应用于从数据库检索的帖子标题(也用于其他一些操作,例如引用)。
  • the_title_rss:在包含在 RSS 提要中之前应用于帖子标题(在第一次使用the_title过滤之后。
  • title_edit_pre:在显示以供编辑之前应用于帖子标题。
  • type_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函数中发送到浏览器之前应用于博客页面标题。

2、数据库写入

此部分中的过滤器适用于保存到数据库之前的信息。

  • add_ping:在将新信息保存在数据库中之前,在添加 ping 时应用于帖子上 ping 字段的新值。
  • attach_fields_to_save:在将附件保存到数据库之前应用于与附件关联的字段。在media_upload_form_handler函数中调用。过滤器函数参数:一个帖子属性数组,一个附件字段数组,包括从表单提交的更改。
  • attach_max_dims:在缩小图像尺寸之前应用于最大图像尺寸。过滤器函数输入(和返回值)要么是假(如果没有指定最大尺寸)要么是两个项目的列表(宽度、高度)。
  • category_save_pre:在将其保存在数据库中之前应用于发布类别以逗号分隔的列表(也用于附件)。
  • comment_status_pre:在将其保存在数据库中之前应用于发布评论状态(也用于附件)。
  • content_filtered_save_pre:在将其保存在数据库中之前应用于过滤的帖子内容(也用于附件)。
  • content_save_pre:应用于在将内容保存到数据库之前发布内容(也用于附件)。
  • excerpt_save_pre:在将其保存在数据库中之前应用于发布摘录(也用于附件)。
  • image_save_pre(已弃用):使用image_editor_save_pre代替。
  • jpeg_quality(已弃用):改用wp_editor_set_quality或WP_Image_Editor::set_quality()。
  • name_save_pre(已弃用):在将其保存在数据库中之前应用于帖子名称(也用于附件)。
  • phone_content:在保存之前应用于通过电子邮件提交的帖子的内容。
  • ping_status_pre:在将 ping 状态保存到数据库之前应用于发布 ping 状态(也用于附件)。
  • post_mime_type_pre:在将附件保存到数据库之前应用于附件的 MIME 类型。
  • status_save_pre:在将其保存在数据库中之前应用于发布状态。
  • 缩thumbnail_filename:上传图像时应用于缩略图的文件名。
  • title_save_pre:在将其保存在数据库中之前应用于发布标题(也用于附件)。
  • update_attached_file:在update_attached_file函数中保存帖子元数据之前应用于附件信息。过滤函数参数:附件信息、附件 ID。
  • wp_create_thumbnail(已弃用)
  • wp_delete_file:在删除之前应用于附件文件名。
  • wp_generate_attachment_metadata:在保存到数据库之前应用于附件元数据数组。
  • wp_save_image_file(已弃用):改用wp_save_image_editor_file。
  • wp_thumbnail_creation_size_limit:上传图像时应用于缩略图的大小。过滤器函数参数:最大文件大小、附件 ID、附件文件名。
  • wp_thumbnail_max_side_length:上传图像时应用于缩略图的大小。过滤器函数参数:图像侧最大尺寸、附件 ID、附件文件名。
  • wp_update_attachment_metadata:在wp_update_attachment_metadata函数中保存之前应用于附件元数据。过滤函数参数:元数据、附件 ID。

二、评论、引用和 Ping 过滤器

1、数据库读取

在页面或编辑屏幕上显示之前,此部分中的过滤器应用于从数据库读取的信息。

  • comment_excerpt:由comment_excerpt函数应用于评论摘录。另见get_comment_excerpt。
  • comment_flood_filter:当有人似乎用评论淹没您的博客时应用。过滤器函数参数:已屏蔽(true/false,是否之前的过滤插件已经屏蔽了它;设置为true并返回true以在插件中屏蔽此评论),前一条评论的时间,当前评论的时间。
  • comment_post_redirect:在有人添加评论后应用于重定向位置。过滤函数参数:重定向位置、评论信息数组。
  • comment_text:在通过comment_text函数和管理菜单显示在屏幕上之前应用于评论文本。
  • 评论_文本_rss: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_type调用)应用于评论类型(“comment”、“trackback”或“pingback” )。
  • get_comments_number:应用于由get_comments_number函数(也由comments_number函数调用;另见comments_number过滤器)从$post全局变量读取的评论计数。
  • post_comments_feed_link:应用于由comments_rss函数为评论提要生成的提要 URL 。

2、数据库写入

此部分中的过滤器适用于保存到数据库之前的信息。

  • 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() 中已修改和未修改的帖子数据。函数参数:修改和扩展的帖子数组和清理过的帖子数组。

三、类别和术语过滤器

1、数据库读取

在页面或编辑屏幕上显示之前,此部分中的过滤器应用于从数据库读取的信息。

  • 类别描述:category_description:通过category_description和wp_list_categories函数应用于“描述”字段类别。过滤函数参数:描述,从category_description调用时的类别 ID ;从wp_list_categories调用时的描述、类别信息数组(该特定类别的类别表中的所有字段)。
  • category_feed_link:应用于由get_category_feed_link函数为类别提要生成的提要 URL 。
  • 类别链接:category_link:应用于由get_category_link函数为类别创建的 URL 。过滤器函数参数:链接 URL、类别 ID。
  • 获取祖先:get_ancestors:应用于get_ancestors函数返回的祖先 ID 列表(该函数又被许多其他函数使用)。过滤器函数参数:祖先 ID 数组、给定的对象 ID、给定的对象类型。
  • get_categories:应用于由get_categories函数生成的类别列表(它又被许多其他函数使用)。过滤函数参数:类别列表、get_categories选项列表。
  • 获取类别:get_category:应用于get_category函数查找的类别信息,它基本上是 WordPress 类别表中特定类别 ID 的所有字段的数组。
  • list_cats:调用有两个不同的目的:
    • 在wp_dropdown_categories函数使用它来过滤show_option_all和show_option_none参数(这是用来把选择“全部”和“无”类别下拉列表)。没有额外的过滤器函数参数。
    • 该wp_list_categories功能,它适用于类别名称。过滤函数参数:类别名称、类别信息列表(该特定类别的类别表中的所有字段)。
  • list_cats_exclusions:应用于 SQL WHERE 语句,给出要被get_categories函数排除的类别。通常,插件会添加到此列表中,以便从类别列表中排除某些类别或类别组。过滤函数参数:排除类别 WHERE 子句,get_categories选项列表。
  • single_cat_title:当wp_title和single_cat_title函数用于创建博客页面标题时,应用于类别名称。
  • the_category:应用于由get_the_category_list函数创建的类别列表(带有链接的 HTML 列表)。过滤器函数参数:生成的 HTML 文本、使用的列表分隔符(空字符串表示它是默认的 LI 列表)、get_the_category_list 的parent参数。
  • 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 列表)。
  • wp_get_object_terms:应用于wp_get_object_terms函数生成的术语列表(对象数组),该函数由许多类别/术语相关函数调用,例如get_the_terms和get_the_category。

2、数据库写入

此部分中的过滤器适用于保存到数据库之前的信息。

  • pre_category_description:在保存到数据库之前应用于类别描述。
  • wp_update_term_parent:在应用更新到 term 之前过滤 term parent,挂钩到此过滤器以查看它是否会导致层次结构循环。
  • edit_terms:(实际上是一个动作,但通常用作过滤器)在数据库中保存分类法/类别更改之前挂钩
  • pre_category_name:在保存到数据库之前应用于类别名称。
  • pre_category_nicename:在保存到数据库之前应用于类别好名称。

四、链接过滤器

注意:此部分包含与帖子、页面、档案、提要等链接相关的过滤器。有关blogroll链接,请参阅下面的#Blogroll 过滤器部分。

  • 附件链接: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函数生成的用于回复特定评论的链接,该函数在函数comments_template 中调用。过滤函数参数:链接(字符串)、自定义选项(数组)、当前评论(对象)、当前帖子(对象)。
  • day_link:get_day_link函数应用于每日存档的链接 URL 。过滤函数参数:URL、年、月数、日数。
  • feed_link:由get_feed_link函数应用于提要的链接 URL 。过滤器函数参数:URL、提要类型(例如“rss2”、“atom”等)。
  • get_comment_author_link:应用于为作者在评论上的链接生成的 HTML,在get_comment_author_link函数中(也由comment_author_link调用。动作函数参数:用户名
  • get_comment_author_url_link:在get_comment_author_url_link函数(也由comment_author_link调用)中应用于为作者的评论链接生成的 HTML 。
  • 月链接:month_link:由get_month_link函数应用于每月存档的链接 URL 。过滤函数参数:URL、年、月数。
  • 页面链接:page_link:由get_page_link函数应用于计算出的页面 URL 。过滤器函数参数:URL、页面 ID。请注意,还有一个名为_get_page_link的内部过滤器,可用于过滤未指定为博客主页的页面的 URL(相同参数)。请注意,这仅适用于 WordPress 页面,不适用于帖子、自定义帖子类型或附件。
  • post_link:由get_permalink函数应用于计算的帖子永久链接,该函数也由the_permalink、post_permalink、previous_post_link和next_post_link函数调用。过滤器函数参数:永久链接 URL、发布数据列表。请注意,这仅适用于 WordPress 默认帖子,不适用于自定义帖子类型(也不适用于页面或附件)。
  • post_type_link:通过get_post_permalink函数应用于计算的自定义帖子类型永久链接。
  • the_permalink:在通过函数the_permalink打印之前应用于帖子的永久链接 URL 。
  • 年链接:year_link:由get_year_link函数应用于年度存档的链接 URL 。过滤函数参数:URL、年份。
  • 标签链接:tag_link:应用于由 get_tag_link 函数为标签创建的 URL。过滤器函数参数:链接 URL、标签 ID。
  • term_link:应用于由 get_term_link 函数为术语创建的 URL。过滤器函数参数:术语链接 URL、术语对象和分类 slug。

五、日期和时间过滤器

  • 获取评论日期: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函数生成的发布日期工作日名称。函数参数是工作日名称、文本前和文本后(如果当前帖子的工作日与前一个帖子的工作日不同,则将文本前和文本后添加到工作日名称中)。

六、作者和用户过滤器

  • login_body_class:允许在login_header() 中过滤应用于登录屏幕的主体类。
  • 登录重定向:login_redirect:在用户登录过程中应用于redirect_to post/get 变量。
  • user_contactmethods:应用于用户个人资料页面上的联系方式字段。(旧页面在这里:contactmethods)
  • update_(meta_type)_metadata:在(用户)元数据更新之前应用。

1、数据库读取

在页面或编辑屏幕上显示之前,此部分中的过滤器应用于从数据库读取的信息。

  • author_email:应用于通过comment_author_email函数从数据库中检索到的评论作者的电子邮件地址。另见get_comment_author_email。
  • 评论作者:comment_author:应用于通过comment_author函数从数据库中检索到的评论作者姓名。另见get_comment_author。
  • 评论作者_rss: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调用。
  • get_comment_author_url:应用于通过get_comment_author_url函数从数据库中检索到的评论作者的 URL,该函数也由comment_author_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函数应用于用户名。过滤器函数参数:用户名(经过一些清理)、原始用户名、严格(真或假以使用严格的 ASCII 或不使用)。
  • the_author:由get_the_author函数应用于帖子作者的显示名称,该函数也由the_author函数调用。
  • the_author_email:由the_author_email函数应用于帖子作者的电子邮件地址。
  • user_search_columns:应用于 wp_users 表中的列列表,以包含在WP_User_Query内的WHERE子句中。

2、数据库写入

此部分中的过滤器适用于保存到数据库之前的信息。

  • 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_nickname:在保存到数据库之前应用于用户的昵称。
  • pre_user_url:在保存到数据库之前应用于用户的 URL。
  • 注册错误:registration_errors:应用于为新帐户注册用户时生成的注册错误列表。
  • user_registration_email:在尝试将该人注册为新用户之前,应用于从注册页面读取的用户电子邮件地址。
  • 验证用户名:validate_username:应用于新用户名的验证结果。过滤器函数参数:有效(真/假),正在验证的用户名。

七、博客过滤器

注意:此部分包含与 blogroll 链接相关的过滤器。有关与帖子、页面、类别等链接相关的过滤器,请参阅上面的#Link 过滤器部分。

  • 获取书签:get_bookmarks:通过get_bookmarks函数应用于链接/ blogroll数据库查询结果。过滤函数参数:数据库查询结果列表,get_bookmarks参数列表。
  • 链接类别:link_category:由get_links_list和wp_list_bookmarks函数应用于链接类别(从 WordPress 2.2 开始)。
  • 链接描述:link_description:由get_links和wp_list_bookmarks函数应用于链接描述(从 WordPress 2.2 开始)。
  • 链接评级: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函数从数据库中检索的选项列表。
  • all_plugins:应用于检索到的插件列表以显示在插件列表中。
  • 博客信息:bloginfo:在首先使用get_bloginfo函数检索信息后,应用于由bloginfo函数从数据库检索的博客选项信息。第二个参数$show给出请求的 bloginfo 选项的名称。需要注意的是代码bloginfo( “URL”) ,代码bloginfo( “目录”)和代码bloginfo( “家”)都没有使用此过滤功能(参见bloginfo_url)。
  • 博客信息rss:bloginfo_rss:通过函数get_bloginfo_rss(也从bloginfo_rss调用)应用于博客选项信息,首先使用get_bloginfo函数检索信息,剥离 HTML 标签,并适当地转换字符。第二个参数$show给出请求的 bloginfo 选项的名称。
  • 博客信息网址:bloginfo_url:在返回信息之前应用于bloginfo(“url”)、bloginfo(“directory”)和bloginfo(“home”)的输出。
  • 登出:loginout:应用于wp_loginout函数生成的用于登录和退出的 HTML 链接(一般放置在侧边栏中)。
  • 丢失密码_url:lostpassword_url:应用于允许用户重置密码的 URL。
  • option(选项名称):option_(option name):在反序列化(对基于数组的选项进行解码)之后,应用于由get_option函数从数据库中检索到的选项值。要使用此过滤器,您需要为特定选项名称添加过滤器,例如“option_foo”来过滤get_option(“foo”)的输出。
  • pre_get_space_used:应用于get_space_used()函数以提供显示已使用存储空间的替代方法。从此过滤器返回 false 将恢复为默认显示行为(使用 wp_upload_dir() 目录空间,以兆字节为单位)。
  • pre_option_(option name):在反序列化(解码基于数组的选项)后,应用于由get_alloptions函数从数据库中检索到的选项值。要使用此过滤器,您需要为特定选项名称添加过滤器,例如“pre_option_foo”来过滤选项“foo”。
  • pre_update_option_(option name):在保存到数据库之前应用选项值以允许覆盖要存储的值。要使用此过滤器,您需要为特定选项名称添加过滤器,例如“pre_update_option_foo”以过滤选项“foo”。
  • 注册:register:应用于为用户创建的侧边栏链接,以通过wp_register函数注册(如果允许)或访问管理面板(如果已经登录)。
  • 上传目录:upload_dir:应用于由wp_upload_dir函数计算的用于上传的目录。过滤器函数参数是一个数组,其中包含“dir”(上传目录路径)、“url”(上传目录的 URL)和“error”(如果要生成错误,可以将其设置为 true)。
  • 上传_mimes:upload_mimes:如果wp_check_filetype函数没有 MIME 列表输入,则允许过滤器函数返回用于上传的 MIME 类型列表。过滤函数参数是一个关联的 MIME 类型列表,其组件名称是文件扩展名(用竖线分隔),值是相应的 MIME 类型。

九、通用文本过滤器

  • 属性转义:attribute_escape:通过attribute_escape函数应用于发布文本和其他内容,在 WordPress 中的许多地方都会调用该函数,以在发送到浏览器之前将某些字符转换为 HTML 属性。
  • js_escape:在js_escape函数中发送到浏览器之前应用于 JavaScript 代码。
  • sanitize_key:在将 key 用于您的设置、字段或其他需求之前应用于 key,由sanitize_key函数生成

十、管理过滤器

本节中的过滤器与 WordPress 的管理屏幕相关,包括内容编辑屏幕。

  • admin_user_info_links:应用于 WordPress 管理快速菜单中的用户个人资料和信息链接。
  • autosave_interval:应用于自动保存帖子的间隔。
  • 批量操作bulk_actions: 应用于管理批量操作下拉列表中的批量项目数组。
  • bulk_post_updated_messages:应用于批量操作更新消息的数组。
  • cat_rows:应用于为管理管理菜单中的类别而生成的类别行 HTML。
  • comment_edit_pre:应用于在编辑屏幕中显示之前的评论内容。
  • comment_edit_redirect:有人在管理菜单中编辑评论后应用于重定向位置。过滤器函数参数:重定向位置、评论 ID。
  • comment_moderation_subject:在发送电子邮件通知管理员需要审核新评论之前应用于邮件主题。过滤函数参数:邮件主题、评论 ID。请注意,这发生在默认的wp_notify_moderator函数中,这是一个“可插入”函数,这意味着插件可以覆盖它;请参阅插件 API)。
  • comment_moderation_text:在发送电子邮件通知管理员需要审核新评论之前应用于邮件消息的正文。过滤器函数参数:邮件正文、评论 ID。请注意,这发生在默认的wp_notify_moderator函数中,这是一个“可插入”函数,这意味着插件可以覆盖它;请参阅插件 API)。
  • comment_notification_headers:在发送电子邮件通知帖子作者新评论之前应用于邮件标题。过滤器函数参数:邮件标题文本、评论 ID。请注意,这发生在默认的wp_notify_postauthor函数中,这是一个“可插入”函数,这意味着插件可以覆盖它;请参阅插件 API)。
  • comment_notification_subject:在发送电子邮件通知帖子作者新评论之前应用于邮件主题。过滤函数参数:邮件主题、评论 ID。请注意,这发生在默认的wp_notify_postauthor函数中,这是一个“可插入”函数,这意味着插件可以覆盖它;请参阅插件 API)。
  • comment_notification_text:在发送电子邮件通知帖子作者新评论之前应用于邮件消息的正文。过滤器函数参数:邮件正文、评论 ID。请注意,这发生在默认的wp_notify_postauthor函数中,这是一个“可插入”函数,这意味着插件可以覆盖它;请参阅插件 API)。
  • comment_row_actions:应用于每个评论行下的操作链接列表(如回复、快速编辑、编辑)。
  • cron_request:允许过滤传递给spawn_cron()中的wp_remote_post()的 URL、键和参数。
  • cron_schedules:应用于空数组以允许插件在wp_get_schedules函数中生成 cron 计划。
  • custom_menu_order:用于激活“menu_order”过滤器。
  • 默认内容default_content在为新帖子打开编辑器之前应用于默认帖子内容。
  • 默认_摘录default_excerpt在为新帖子打开编辑器之前应用于默认帖子摘录。
  • 默认标题default_title在为新帖子打开编辑器之前应用于默认帖子标题。
  • editable_slug:通过get_sample_permalink函数应用于帖子、页面、标签或类别标签。
  • format_to_edit:format_to_edit函数应用于帖子内容、摘录、标题和密码,该函数由管理菜单调用以设置帖子进行编辑。也适用于在管理菜单中编辑评论时。
  • format_to_post:format_to_post函数应用于发布内容,默认情况下在 WordPress 中不使用。
  • manage_edit-${post_type}_columns:应用于要在管理帖子屏幕上打印的自定义帖子类型的列列表。过滤函数参数/返回值是一个关联数组,其中元素键是列的名称,值是该列的标题文本。另请参阅操作manage_${post_type}_posts_custom_column,它将列信息放入编辑屏幕。
  • manage_link-manager_columns:在wordpress 2.7 之前是manage_link_columns。应用于要在 blogroll 管理屏幕上打印的列列表。过滤函数参数/返回值是一个关联列表,其中元素键是列的名称,值是该列的标题文本。另请参阅操作manage_link_custom_column,它将列信息放入编辑屏幕。
  • manage_posts_columns:应用于要在管理帖子屏幕上打印的列列表。过滤函数参数/返回值是一个关联数组,其中元素键是列的名称,值是该列的标题文本。另请参阅操作manage_posts_custom_column,它将列信息放入编辑屏幕。
  • manage_pages_columns:应用于要在管理页面屏幕上打印的列列表。过滤函数参数/返回值是一个关联数组,其中元素键是列的名称,值是该列的标题文本。另请参阅操作manage_pages_custom_column,它将列信息放入编辑屏幕。
  • manage_users_columns
  • manage_users_custom_column
  • manage_users_sortable_columns
  • media_row_actions:应用于媒体库中每个文件下的操作链接列表(如查看、编辑)。
  • 菜单顺序menu_order应用于管理菜单顺序的数组。之前必须使用“custom_menu_order”过滤器激活。
  • nonce_life:应用于随机数的生命周期以生成或验证随机数。可用于生成更早到期的随机数。过滤器返回的值应以秒为单位。
  • nonce_user_logged_out:应用于当前用户 ID,用于在用户注销时生成或验证随机数。
  • plugin_row_meta:在插件页面上的每个插件下方添加其他链接。
  • postmeta_form_limit:应用于帖子编辑屏幕上显示的帖子元信息项的数量。
  • post_row_actions:应用于“帖子”>“所有帖子”部分中每个帖子下的操作链接列表(如快速编辑、编辑、查看、预览)。
  • post_updated_messages:应用于在处理帖子、页面和自定义帖子类型时存储用户可见管理消息的数组。此过滤器用于更改所述消息的文本,而不是触发它们。请参阅register_post_type文档中的“自定义消息” 。
  • 上传前错误pre_upload_error用于允许插件为上传文件创建 XMLRPC 错误。
  • preview_page_link:应用于页面编辑屏幕上的链接,在屏幕底部显示页面预览。
  • preview_post_link:应用于帖子编辑屏幕上的链接,在屏幕底部显示帖子预览。
  • richedit_pre:在富文本编辑器中显示之前,由wp_richedit_pre函数应用于发布内容。
  • schedule_event:应用于每个重复发生的单个事件,因为它被添加到 cron 计划中。
  • 设置屏幕选项set-screen-option在设置之前过滤屏幕选项值。
  • show_password_fields:应用于控制用户是否有机会在用户配置文件屏幕上更改密码的 true/false 变量(true 表示显示密码更改字段;false 表示不显示)。
  • term_to_edit:应用于术语的 CSV(对于每个分类法),用于显示哪些术语附加到帖子。
  • the_editor:在将其打印到屏幕上之前,应用于为容纳富文本编辑器而创建的 HTML DIV。过滤函数参数/返回值是一个字符串。
  • user_can_richedit:应用于user_can_richedit函数中计算用户的浏览器是否具有富编辑能力,用户是否想使用富编辑器。如果当前用户可以/不能使用富编辑器,则过滤函数参数和返回值为真/假。
  • user_has_cap:应用于WP_User->has_cap函数(由current_user_can函数调用)中的用户功能列表。过滤函数参数是要过滤的能力列表,被质疑的能力,以及参数列表(如果能力是编辑帖子,则包含帖子ID等内容)
  • wp_handle_upload_prefilter:应用于上传文件时的上传信息。过滤函数参数:表示$_FILES 单个元素的数组。
  • wp_handle_upload:应用于上传文件时的上传信息。过滤器函数参数:包含元素“file”(文件名)、“url”、“type”的数组。
  • wp_revisions_to_keep:更改给定帖子保留的修订数量。过滤器函数参数:表示保存的所需修订的数字(默认为无限修订),发布对象。
  • wp_terms_checklist_args:应用于 wp_terms_checklist() 函数的参数。过滤器函数参数:清单参数数组,帖子 ID。
  • wp_upload_tabs:应用于要在上传管理管理屏幕上显示的自定义选项卡列表。使用操作upload_files_(tab)为您的自定义选项卡显示一个页面(请参阅插件 API/操作参考)。
  • media_upload_tabs:应用于要在上传管理管理屏幕上显示的自定义选项卡列表。使用操作upload_files_(tab)为您的自定义选项卡显示一个页面(请参阅插件 API/操作参考)。
  • plugin_action_links_(插件文件名):应用于显示在插件页面上的链接列表(在激活/停用链接旁边)。
  • views_edit-post:应用于列表帖子,例如全部 (30) | 已发表 (22) | 草稿 (5) | 待定 (2) | 垃圾 (1)

十一、富文本编辑器过滤器

这些过滤器修改富文本编辑器 TinyMCE 的配置。

  • 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:应用于编辑器的整个 init 数组。

十二、模板过滤器

此部分包含与主题、模板和样式文件相关的链接。

  • 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。

您还可以使用以下过滤器挂钩替换主题中的单个模板文件。另请参阅template_redirect操作挂钩。这些过滤器中的每一个都将当前主题中相应模板文件的路径作为输入。插件可以通过返回模板文件的新路径来修改要使用的文件。

  • 404_模板:404_template
  • 归档模板:archive_template:例如,您可以使用它来为自定义帖子类型存档强制执行特定模板。通过这种方式,您可以将所有代码保存在插件中。
  • 附件模板:attachment_template
  • 作者模板:author_template
  • 类别模板:category_template
  • comment_popup_template
  • 评论模板:comments_template:“comments_template”过滤器可用于从插件加载自定义模板,该插件替换主题默认评论模板。
  • 日期模板:date_template
  • 主页模板:home_template
  • 页面模板:page_template
  • 分页模板:paged_template
  • 搜索模板:search_template
  • 文章模板:single_template:例如,您可以使用它来强制自定义帖子类型的特定模板。通过这种方式,您可以将所有代码保存在插件中。
  • 快捷方式链接:shortcut_link:应用于“按此”书签链接。
  • 模板包含:template_include
  • wp_nav_menu_args:应用于wp_nav_menu函数的参数。
  • wp_nav_menu_items:过滤导航菜单的 HTML 列表内容。

十三、库布里克过滤器

这些过滤器出现在 3.0 之前的默认主题库布里克中。

  • kubrick_header_color:应用于库布里克主题标题的颜色。
  • kubrick_header_display:应用于库布里克主题标题的显示选项。
  • kubrick_header_image:应用于 kubrick 主题的标题图像文件。

十四、注册和登录过滤器

  • 认证:authenticate:允许基于用户名和密码在登录时执行基本身份验证。
  • 注册错误:registration_errors:应用于为新帐户注册用户时生成的注册错误列表。
  • user_registration_email:在尝试将该人注册为新用户之前,应用于从注册页面读取的用户电子邮件地址。
  • 验证用户名:validate_username:应用于新用户名的验证结果。过滤器函数参数:有效(真/假),正在验证的用户名。
  • wp_authenticate_user:当用户尝试登录时应用,在 WordPress 验证用户名和密码之后,但在检查验证错误之前。

十五、重定向/重写过滤器

这些高级过滤器与 WordPress 对重写规则的处理有关。

  • allowed_redirect_hosts:应用于被认为可以安全重定向的主机名列表。wp-login.php 使用它来防御危险的“redirect_to”请求参数
  • author_rewrite_rules:生成后应用于作者相关的重写规则。
  • category_rewrite_rules:生成后应用于类别相关的重写规则。
  • comment_rewrite_rules:生成后应用于评论相关的重写规则。
  • date_rewrite_rules:日期相关的重写规则生成后应用。
  • mod_rewrite_rules:应用于用户更改永久链接结构时要放入其 .htaccess 文件的重写规则列表。(注意:替换已弃用的过滤器rewrite_rules。)
  • page_rewrite_rules:生成后应用于页面相关的重写规则。
  • post_rewrite_rules:生成后应用于后期相关的重写规则。
  • redirect_canonical:可用于取消“规范”URL 重定向。接受 2 个参数:$redirect_url,$requested_url。取消重定向返回FALSE,允许重定向返回$redirect_url
  • rewrite_rules_array:生成后应用于整个重写规则数组。
  • root_rewrite_rules:生成后应用于根级重写规则。
  • search_rewrite_rules:生成后应用于搜索相关的重写规则。
  • wp_redirect:默认wp_redirect函数应用于重定向 URL 。过滤函数参数:URL、HTTP 状态代码。注意wp_redirect也是一个“pluggable”函数,意味着插件可以覆盖它;请参阅插件 API)。
  • wp_redirect_status:通过默认wp_redirect函数重定向时应用于 HTTP 状态代码。过滤器函数参数:HTTP 状态代码、URL。注意wp_redirect也是一个“pluggable”函数,意味着插件可以覆盖它;请参阅插件 API)。

十六、WP_Query过滤器

这些是WP_Query 对象在构建和执行查询以检索帖子的过程中运行的过滤器。另请参阅#Advanced WordPress 过滤器,了解与用户、元值和更通用查询相关的查询。

  • found_posts:在从数据库查询后应用于帖子列表。
  • found_posts_query:从数据库查询要显示的帖子列表后,WordPress 会在查询结果中选择行。此过滤器允许您在该步骤中执行除SELECT FOUND_ROWS()以外的其他操作。
  • post_limits:应用于返回 post 数组的查询的LIMIT子句。
  • post_clauses:应用于整个 SQL 查询,分为每个子句类型的键控数组,返回 post 数组。可以比posts_request更容易使用。
  • post_distinct:允许插件向返回 post 数组的查询添加DISTINCTROW子句。
  • 帖子字段:posts_fields:应用于返回 post 数组的查询的字段列表。
  • post_groupby:应用于返回 post 数组(通常为空)的查询的GROUP BY子句。
  • post_join:应用于返回 post 数组的查询的JOIN子句。这通常用于将表添加到 JOIN,与posts_where过滤器结合使用。
  • post_join_paged:应用于返回 post 数组的查询的JOIN子句,在计算分页后(虽然分页不影响 JOIN,所以这实际上等同于posts_join)。
  • post_orderby:应用于返回 post 数组的查询的ORDER BY子句。
  • 帖子请求:posts_request:在运行查询之前应用于返回 post 数组的整个 SQL 查询。
  • 帖子结果:posts_results:允许您操作从查询返回的结果数组。
  • 帖子搜索:posts_search:应用于WP_Query的WHERE子句中使用的搜索 SQL 。
  • 帖子哪里:posts_where:应用于返回 post 数组的查询的WHERE子句。
  • post_where_paged:应用于返回 post 数组的查询的WHERE子句,在计算分页后(虽然分页不影响 WHERE,所以这实际上等同于posts_where)。
  • the_posts:在对单个帖子页面上的权限和草稿状态进行最少处理后,应用于从数据库查询的帖子列表。

十七、媒体过滤器

本节包含用于集成不同类型媒体的媒体过滤器。

  • editor_max_image_size
  • image_downsize
  • get_image_tag_class
  • 获取图像标签:get_image_tag
  • image_resize_dimensions
  • middle_image_sizes
  • 图标目录:icon_dir
  • wp_get_attachment_image_attributes
  • img_caption_shortcode
  • 后画廊:post_gallery
  • use_default_gallery_style
  • 画廊风格:gallery_style
  • (相邻)_image_link:(adjacent)_image_link
  • embed_defaults
  • load_default_embeds
  • embed_oembed_html
  • embed_googlevideo
  • oembed_result
  • 上传大小限制:upload_size_limit
  • wp_image_editors
  • plupload_default_settings
  • plupload_default_params
  • image_size_names_choose
  • wp_prepare_attachment_for_js
  • media_upload_tabs
  • disable_captions
  • media_view_settings
  • media_view_strings
  • wp_handle_upload_prefilter

十八、高级WordPress过滤器

本节包含与国际化、杂项查询和其他基本 WordPress 功能相关的高级过滤器。

  • 创建用户查询:create_user_query:应用于用于将新用户的信息保存到数据库的查询,就在运行查询之前。
  • get_editable_authors:应用于当前用户有权在get_editable_authors函数中编辑的帖子作者列表。
  • get_next_post_join:在函数get_next_post 中(在当前显示的帖子之后查找帖子),应用于 SQL JOIN 子句(如果用户正在查看类别档案,它通常连接到类别表)。过滤函数参数:JOIN 子句、保持在同一类别(真/假)、排除类别列表。
  • get_next_post_sort:在函数get_next_post(在当前显示的帖子之后查找帖子)中,应用于 SQL ORDER BY 子句(通常按帖子日期以升序排序,限制为 1 个帖子)。过滤函数参数:ORDER BY 子句。
  • get_next_post_where:在函数get_next_post(查找当前显示的帖子之后的帖子)中,应用于 SQL WHERE 子句(通常查找下一个发布日期的帖子)。过滤函数参数:WHERE 子句、保持在同一类别(真/假)、排除类别列表。
  • get_previous_post_join:在函数get_previous_post(查找当前显示的帖子之前的帖子)中,应用于 SQL JOIN 子句(如果用户正在查看类别档案,通常连接到类别表)。过滤函数参数:join 子句、保持在同一类别(真/假)、排除类别列表。
  • get_previous_post_sort:在函数get_previous_post 中(查找当前显示的帖子之前的帖子),应用于 SQL ORDER BY 子句(通常按帖子日期降序排序,限制为 1 个帖子)。过滤函数参数:ORDER BY 子句。
  • get_previous_post_where:在函数get_previous_post(查找当前显示的帖子之前的帖子)中,应用于 SQL WHERE 子句(通常查找上一个发布日期的帖子)。过滤函数参数:WHERE 子句、保持在同一类别(真/假)、排除类别列表。
  • 获取文本:gettext:通过translation()函数(由_()和_e()国际化函数等函数调用)应用于翻译的文本。过滤函数参数:翻译文本、未翻译文本和文本域。即使国际化无效或尚未加载文本域,也会应用。
  • override_load_textdomain
  • get_meta_sql:在函数WP_Meta_Query::get_sql 中(它生成 SQL 子句以附加到高级元查询的主查询。),应用于高级元查询生成的 SQL JOIN 和 WHERE 子句。过滤函数参数: array( compact( ‘join’, ‘where’ ), $this->queries, $type, $primary_table, $primary_id_column, $context )
  • get_others_drafts:应用于选择其他用户草稿以显示在管理菜单中的查询。
  • get_users_drafts:应用于选择用户草稿以显示在管理菜单中的查询。
  • 语言环境:locale:通过get_locale函数应用于语言环境。
  • 查询:query:应用于所有查询(至少在加载插件后运行所有查询)。
  • 查询字符串:query_string:不推荐使用 – 使用query_vars或request代替。
  • 查询变量:query_vars:在形成 SQL 查询之前应用于公共 WordPress 查询变量列表。用于删除插件以其他方式处理的额外永久链接信息。
  • 请求:request:类似于query_vars,但在添加“额外”和私有查询变量后应用。
  • 摘录长度:excerpt_length:定义单个帖子摘录的长度。
  • 摘录更多:excerpt_more:定义摘录末尾的更多字符串。
  • post_edit_form_tag:允许您将代码附加到默认帖子/页面编辑器中的表单标签。
  • 更新用户查询:update_user_query:在运行查询之前应用于用于更新用户信息的更新查询。
  • uploading_iframe_src(自 WP 2.5 起删除):应用于在帖子和页面编辑屏幕上上传 iframe 的 HTML src 标签。
  • xmlrpc_methods:应用于为 XMLRPC 服务器定义的 XMLRPC 方法列表。
  • wp_mail_from:在 wp_mail 函数发送任何邮件之前应用。提供的值是根据当前主机名的 wordpress 地址计算得出的(由 $_SERVER[‘SERVER_NAME’] 设置)。过滤器应以“user@example.com”或“Name user@example.com”(不带引号!)的形式返回电子邮件地址或姓名/电子邮件组合。
  • wp_mail_from_name:在 wp_mail 函数发送任何邮件之前应用。过滤器应返回一个名称字符串,用作来自 name 的电子邮件。
  • update_(meta_type)_metadata:在元数据更新之前应用。例如,如果用户元数据被更新,钩子将是“update_user_metadata”。

十九、小工具

本节包含由 WordPress 核心中的小部件添加的过滤器。

  • dynamic_sidebar_params:应用于传递给 WordPress 小部件中的 widgets_init 函数的参数。
  • widget_archives_dropdown_args:应用于传递给WordPress Archives 小部件中wp_get_archives()函数的参数。
  • widget_categories_args:应用于传递给WordPress 类别小部件中wp_list_categories()函数的参数。
  • widget_links_args:应用于传递给WordPress 链接小部件中wp_list_bookmarks()函数的参数。
  • widget_nav_menu_args:应用于传递给WordPress 自定义菜单小部件中wp_nav_menu()函数的参数。
  • widget_pages_args:应用于传递给WordPress 页面小部件中wp_list_pages()函数的参数。
  • widget_tag_cloud_args:应用于传递给WordPress 页面小部件中wp_tag_cloud()函数的参数。
  • 小部件文本:widget_text:应用于 WordPress Text 小部件的小部件文本。也可能适用于某些第三方小部件。
  • 小部件标题:widget_title:应用于任何用户可编辑的 WordPress 小部件的小部件标题。也可能适用于某些第三方小部件。

二十、管理栏

此部分包含由 WordPress 3.1.0 中添加的管理栏添加的过滤器。

  • wp_admin_bar_class:允许更改_wp_admin_bar_init()函数中的默认“WP_Admin_Bar”类wp-includes/admin-bar.php。

发表评论