zhe.ink过滤器是两种类型的钩子之一。
它们为函数提供了一种在执行WordPress Core，插件和主题期间修改数据的方法。它们是action的对应物。
与aciton不同，筛选器旨在以隔离方式工作，并且不应产生副作用，例如影响全局变量和输出。过滤器希望将某些内容返回给它们。
添加过滤器
添加筛选器的过程包括两个步骤。
首先，您需要创建一个 Callback 函数，该函数将在过滤器运行时调用。其次，您需要将 Callback 函数添加到将执行函数调用的钩子中。
您将使用 add_filter（） 函数，传递至少两个参数：
- string $hook_name这是您要挂钩的过滤器的名称，以及
- callable $callback回调函数的名称。
下面的示例将在执行筛选器时运行the_title。
function wporg_filter_title( $title ) {
return 'The ' . $title . ' was filtered';
}
add_filter( 'the_title', 'wporg_filter_title' );假设我们有一个帖子标题“学习WordPress”，上面的例子会将其修改为“学习WordPress被过滤”。
随着你获得更多的经验，浏览WordPress Core源代码将让你找到最合适的钩子。
其他参数
add_filter（） 可以接受两个附加参数int $priority，int $accepted_args，用于为回调函数指定的优先级，以及用于将传递给回调函数的参数数。
例
要在满足特定条件时向<body>添加 CSS 类，请执行以下操作：
function wporg_css_body_class( $classes ) {
if ( ! is_admin() ) {
$classes[] = 'wporg-is-awesome';
}
return $classes;
}
add_filter( 'body_class', 'wporg_css_body_class' );数据库读取
本节中的筛选器应用于在页面上显示或编辑屏幕上之前从数据库中读取的信息。
应用于编辑附件时要显示的表单域。在get_attachment_fields_to_edit函数中调用。过滤函数参数：表单字段数组，帖子对象。
应用于get_attachment_icon函数中附件的图标。过滤函数参数：图标文件作为HTML IMG标签，附件ID。
应用于要在get_attachment_innerHTML函数中用于附件的标题（如果没有图标）。筛选函数参数：内部 HTML（默认为标题）、附件 ID。
在显示以进行编辑之前应用于帖子作者。
应用于 HTML 元素的类。在函数中调用。Filter 函数参数：类名数组和添加到第一个数组的其他类名数组。<body>get_body_class
应用于在显示以进行编辑之前发布内容。
应用于在显示以进行编辑之前过滤的帖子内容。
应用于在显示进行编辑之前发布摘录。
应用于显示以进行编辑之前的发布日期。
应用于显示以进行编辑之前的发布日期。
应用于 get_attached_file 函数检索的附加文件信息。筛选函数参数：文件信息、附件 ID。
应用于get_enclosed函数的帖子的附件列表。
应用于 get_pages 函数返回的页面列表。过滤函数参数：页面列表（每个项目包含一个页面数据数组），get_pages函数参数列表（告诉请求了哪些页面）。
应用于 get_pung 函数发布的 ping 网址列表。
应用于get_the_archive_title函数中存档的标题。
应用于get_the_excerpt函数中的帖子摘录。
应用于get_the_guid函数中帖子的 GUID。
应用于 URL 列表，以通过 get_to_ping 函数 ping 帖子。
在多个函数中应用于模板的图像目录。基本上允许插件指定MIME类型的图标应来自不同的位置。
应用于模板的多个函数的图像目录 URI。基本上允许插件指定MIME类型的图标应来自不同的位置。
应用于媒体库中可选择的图像大小列表。通常用于使自定义图像大小可选。
在显示以进行编辑之前应用于发布 MIME 类型。
应用于显示编辑之前的发布修改日期。
在显示以进行编辑之前应用于修改后的 GMT 日期。
适用于已注册的短代码。可用于从自动纹理化功能中免除简码。
应用于在显示以进行编辑之前发布父级 ID。
应用于在显示以进行编辑之前发布密码。
应用于帖子最外层 HTML 元素的类。在函数中调用。Filter 函数参数：类名数组、添加到第一个数组的其他类名数组以及后 ID。get_post_class
在KSES处理/消毒之前应用于各种内容。此钩子允许开发人员自定义内容中应允许或剥离的脚本/标签类型。
应用于要以 prepend_attachment 函数为前缀的 HTML。
用于在帖子受密码保护时更改或操作帖子标题。
用于在帖子标题状态为私有时更改或操作帖子标题。
在去除 HTML 标记后，由 sanitize_title 函数应用于帖子标题。
当用于通过wp_title和single_post_title功能创建博客页面标题时应用于文章标题。
在显示以进行编辑之前应用于帖子状态。
应用于在屏幕上打印之前从数据库中检索的帖子内容（也用于其他一些操作，例如引用）。
在包含在 RSS 源中之前应用于帖子内容。（已弃用）
在包含在 RSS 源中之前应用于帖子内容。
应用于在将内容放入富编辑器窗口之前发布内容。
应用于在屏幕上打印之前从数据库中检索的帖子摘录（如果没有摘录，则应用于帖子内容）（也用于某些其他操作，例如引用）。
在包含在 RSS 源中之前应用于帖子摘录。
应用于受保护帖子的密码表单。
应用于在屏幕上打印之前从数据库中检索到的标记。
应用于在屏幕上打印之前从数据库中检索到的帖子标题（也用于其他一些操作，例如引用）。
在包含在 RSS 源之前应用于帖子标题（首次使用 the_title 过滤后。
在显示以进行编辑之前应用于帖子标题。
在显示以进行编辑之前应用于帖子类型。
应用于由wp_dropdown_pages函数生成的WordPress页面的HTML下拉列表。
应用于wp_list_pages函数生成的 HTML 列表。
应用于 wp_list_pages 函数中排除的页面列表（页面 ID 数组）。
应用于wp_get_attachment_metadata函数检索的附件元数据。过滤函数参数：元数据、附件 ID。
应用于wp_get_attachment_thumb_file函数检索的附件缩略图文件。筛选函数参数：缩略图文件、附件 ID。
应用于wp_get_attachment_thumb_URL函数检索的附件缩略图 URL。筛选函数参数：缩略图 URL、附件 ID。
应用于 wp_get_attachment_url 函数检索的附件 URL。筛选函数参数：URL、附件 ID。
应用于由wp_mime_type_icon函数计算的附件的 MIME 类型图标。过滤函数参数：计算的图标 URI、MIME 类型、帖子 ID。
在发送到wp_title功能中的浏览器之前应用于博客页面标题。
数据库写入
本节中的筛选器在保存到数据库之前应用于信息。
在将新信息保存在数据库中之前，在添加 ping 时应用于帖子上 ping 字段的新值。
在将附件保存到数据库中之前应用于与附件关联的字段。在media_upload_form_handler函数中调用。过滤函数参数：帖子属性数组，附件字段数组，包括从表单提交的更改。
在减小图像大小之前应用于最大图像尺寸。筛选器函数输入（和返回值）为 false（如果未指定最大尺寸）或双项目列表（宽度、高度）。
在将列表保存到数据库中之前应用于帖子类别逗号分隔列表（也用于附件）。
应用于将评论保存到数据库之前的状态（也用于附件）。
在将过滤的帖子内容保存到数据库中之前应用于过滤的内容（也用于附件）。
应用于在将内容保存到数据库之前发布内容（也用于附件）。
应用于将摘录保存到数据库中之前将其保存到数据库（也用于附件）。
image_save_pre（已弃用）
jpeg_quality（已弃用）
请改用 wp_editor_set_quality 或 WP_Image_Editor：：set_quality（）。
name_save_pre（已弃用）
在将帖子保存到数据库中之前应用于帖子名称（也用于附件）。
在保存之前应用于通过电子邮件提交的帖子的内容。
应用于在将 ping 状态保存到数据库中之前将其发布（也用于附件）。
在将附件保存到数据库中之前应用于附件的 MIME 类型。
在将帖子保存到数据库中之前应用于发布状态。
应用于上传图像时缩略图的文件名。
在将帖子标题保存到数据库中之前应用于帖子标题（也用于附件）。
在update_attached_file函数的帖子元数据中保存之前应用于附件信息。筛选函数参数：附件信息、附件 ID。
wp_create_thumbnail（已弃用）wp_delete_file
在删除之前应用于附件文件名。
wp_generate_attachment_metadata
在数据库中保存之前应用于附件元数据数组。
wp_save_image_file（已弃用）
wp_thumbnail_creation_size_limit
应用于上传图像时缩略图的大小。筛选函数参数：最大文件大小、附件 ID、附件文件名。
应用于上传图像时缩略图的大小。过滤函数参数：图像端最大大小、附件 ID、附件文件名。
在wp_update_attachment_metadata函数中保存之前应用于附件元数据。过滤函数参数：元数据、附件 ID。
评论、引用和 ping 过滤器
另请参阅下面的 #Author 和用户过滤器、#Link 过滤器、#Date 和时间过滤器以及 #Administrative 过滤器。
数据库读取
本节中的筛选器应用于在页面上显示或编辑屏幕上之前从数据库中读取的信息。
应用于 comment_excerpt 函数的注释摘录。另请参阅get_comment_excerpt。
当有人似乎用评论淹没您的博客时应用。过滤函数参数：已阻止（true/false，以前的过滤插件是否已阻止它;设置为 true 并返回 true 以阻止插件中的此注释）、上一个注释的时间、当前注释的时间。
应用于有人添加评论后的重定向位置。过滤函数参数：重定向位置、注释信息数组。
在通过comment_text功能显示在屏幕上之前应用于注释文本，并在管理菜单中应用。
在包含在 RSS 源中之前应用于注释文本。
应用于comments_template函数中帖子的评论数组。过滤函数参数：评论信息结构数组，帖子 ID。
应用于格式化文本，提供 comments_number 函数生成的注释数。另请参阅get_comments_number。
应用于由 get_comment_excerpt 函数（也由 comment_excerpt 调用）从数据库中读取的注释摘录。另请参阅comment_excerpt。
应用于 get_comment_ID 函数从全局$comments变量读取的注释 ID。
应用于 get_comment_text 函数中当前注释的注释文本，该函数也由 comment_text 函数调用。
应用于get_comment_type函数（也由comment_type调用）的注释类型（“注释”、“引用”或“pingback”）。
应用于 get_comments_number 函数（也由 comments_number 函数调用;另请参阅comments_number筛选器）从$post全局变量读取的注释计数。
应用于 comments_rss 函数为评论源生成的源 URL。
数据库写入
本节中的筛选器在保存到数据库之前应用于信息。
在更新/编辑评论数据之前应用于评论数据。函数参数：注释数据数组，索引为“comment_post_ID”、“comment_author”、“comment_author_email”、“comment_author_url”、“comment_content”、“comment_type”和“user_ID”。
应用于当前注释的批准状态（真/假）以允许插件覆盖。返回 true/false 并将第一个参数设置为 true/false 以批准/拒绝注释，并使用全局变量（如 $comment_ID）访问有关此注释的信息。
在将注释保存到数据库中之前应用于注释的内容。
在数据库中保存新注释时，在任何其他处理之前应用于注释数据。函数参数：注释数据数组，索引为“comment_post_ID”、“comment_author”、“comment_author_email”、“comment_author_url”、“comment_content”、“comment_type”和“user_ID”。
在更新或将帖子插入数据库之前应用于wp_insert_post（）中修改和未修改的帖子数据。函数参数：修改和扩展的帖子数组和经过净化的帖子数组。
类别和术语筛选器
另请参阅下面的 #Administrative 过滤器。
数据库读取
本节中的筛选器应用于在页面上显示或编辑屏幕上之前从数据库中读取的信息。
通过category_description和wp_list_categories功能应用于“描述”字段类别。过滤函数参数：描述、从category_description调用时的类别 ID;描述，从wp_list_categories调用时类别信息数组（该特定类别的类别表中的所有字段）。
应用于由 get_category_feed_link 函数为类别 Feed 生成的源 URL。
应用于由get_category_link函数为类别创建的 URL。筛选函数参数：链接 URL、类别 ID。
应用于 get_ancestors 函数返回的祖先 ID 列表（该函数又由许多其他函数使用）。过滤函数参数：祖先 ID 数组、给定对象 ID、给定对象类型。
应用于由 get_categories 函数生成的类别列表（该函数又由许多其他函数使用）。筛选函数参数：类别列表、get_categories选项列表。
应用于get_category函数查找的类别信息，该信息基本上是WordPress类别表中特定类别ID的所有字段的数组。
呼吁有两个不同的目的：
- wp_dropdown_categories 函数使用它来过滤show_option_all和show_option_none参数（用于在类别下拉列表中放置选项“全部”和“无”）。没有额外的筛选器函数参数。
- wp_list_categories函数将其应用于类别名称。筛选函数参数：类别名称、类别信息列表（该特定类别的类别表中的所有字段）。
应用于 SQL WHERE 语句，该语句提供 get_categories 函数要排除的类别。通常，插件会添加到此列表中，以便从类别列表中排除某些类别或类别组。筛选函数参数：排除类别 WHERE 子句，get_categories选项列表。
当用于通过wp_title和single_cat_title功能创建博客页面标题时应用于类别名称。
应用于由 get_the_category_list 函数创建的类别列表（带有链接的 HTML 列表）。过滤函数参数：生成的HTML文本，正在使用的列表分隔符（空字符串表示它是默认的LI列表），父参数get_the_category_list。
在包含在 RSS 源中之前，通过 get_the_category_rss 函数应用于帖子的类别列表（类别 XML 元素的列表）。过滤器函数参数是列表文本和类型（通常是“rdf”或“rss”）。
应用于由 wp_dropdown_categories 函数生成的下拉类别列表（包含 HTML 选项元素的文本字符串）。
应用于由wp_list_categories函数生成的类别列表（HTML 列表）。
应用于由 wp_get_object_terms 函数生成的术语列表（对象数组），该函数由许多与类别/术语相关的函数（如 get_the_terms 和 get_the_category）调用。
数据库写入
本节中的筛选器在保存到数据库之前应用于信息。
在保存在数据库中之前应用于类别描述。
在应用术语更新之前筛选术语父项，请挂钩到此筛选器以查看它是否会导致层次结构循环。
（实际上是一个动作，但通常像过滤器一样使用）在数据库中保存分类/类别更改之前挂钩
在保存在数据库中之前应用于类别名称。
在保存在数据库中之前应用于类别 nice 名称。
链接过滤器
注意：此部分包含与帖子、页面、档案、提要等链接相关的过滤器。有关博客链接，请参阅下面的 #Blogroll 过滤器部分。
通过get_attachment_link函数应用于计算的附件永久链接。过滤函数参数：链接 URL、附件 ID。
应用于由 get_author_rss_link 函数为作者源生成的源 URL。
应用于由get_author_posts_url函数创建的作者存档永久链接。过滤函数参数：链接 URL、作者 ID、作者的“漂亮”名称。请注意，get_author_posts_url是在函数wp_list_authors和the_author_posts_link中调用的。
应用于由函数 comments_template 中调用的 get_comment_reply_link 函数为回复特定注释而生成的链接。过滤函数参数：链接（字符串）、自定义选项（数组）、当前评论（对象）、当前帖子（对象）。
通过get_day_link函数应用于每日存档的链接 URL。过滤函数参数：URL、年、月、日数。
通过get_feed_link函数应用于源的链接 URL。过滤函数参数：URL、源类型（例如“rss2”、“atom”等）。
应用于在 get_comment_author_link 函数（也由 comment_author_link 调用）中为作者在评论上的链接生成的 HTML。操作函数参数：用户名
应用于在 get_comment_author_url_link 函数（也由 comment_author_link 调用）中为评论上的作者链接生成的 HTML。
通过get_month_link函数应用于每月存档的链接 URL。过滤函数参数：URL、年、月数。
通过 get_page_link 函数应用于计算的页面 URL。过滤函数参数：URL、页面 ID。 请注意，还有一个名为 _get_page_link 的内部过滤器，可用于过滤未指定为博客主页的页面的 URL（相同的参数）。请注意，这仅适用于WordPress页面，不适用于帖子，自定义帖子类型或附件。
由 get_permalink 函数应用于计算后的永久链接，该函数也由 the_permalink、post_permalink、previous_post_link 和 next_post_link 函数调用。过滤函数参数：永久链接URL，发布数据列表。请注意，这仅适用于WordPress默认帖子，不适用于自定义帖子类型（页面或附件）。
通过get_post_permalink函数应用于计算的自定义帖子类型永久链接。
应用于在按函数the_permalink打印之前帖子的永久链接 URL。
通过get_year_link函数应用于年度存档的链接 URL。筛选函数参数：URL、年份。
应用于 get_tag_link 函数为标记创建的 URL。过滤函数参数：链接网址、标签 ID。
应用于由get_term_link函数为术语创建的 URL。筛选函数参数：术语链接 URL、术语对象和分类 slug。
日期和时间筛选器
另请参阅上面的 #Link 过滤器。
应用于由 get_comment_date 函数（也称为comment_date）生成的格式化注释日期。
应用于 get_comment_time 函数（也由 comment_time 调用）中的格式化注释时间。
应用于由 get_the_modified_date 函数（也由 the_modified_date 函数调用）生成的格式化修改后日期。
应用于由get_the_modified_time和get_post_modified_time函数（也由the_modified_time函数调用）生成的格式化后修改时间。
应用于由get_the_time和get_post_time函数（也由the_time函数调用）生成的格式化开机自检时间。
应用于the_date函数生成的格式化发布日期。
应用于the_modified_date函数生成的格式化后修改日期。
应用于the_modified_time函数生成的格式化后修改时间。
应用于the_time功能生成的格式化开机自检时间。
应用于 the_weekday 函数生成的发布日期工作日名称。
应用于 the_weekday_date 函数生成的发布日期工作日名称。函数参数是工作日名称、文本之前和文本之后（如果当前帖子的工作日与上一篇文章的工作日不同，则文本之前和文本之后将添加到工作日名称中）。
作者和用户筛选器
另请参阅 #Link 筛选器和 #Administrative 筛选器部分。
允许过滤应用于 login_header（） 中登录屏幕的 body 类。
在用户登录过程中应用于 redirect_to POST/GET 变量。
应用于“用户配置文件”页上的“联系方式”字段。（旧页面在这里：联系方式)
在更新（用户）元数据之前应用。
数据库读取
本节中的筛选器应用于在页面上显示或编辑屏幕上之前从数据库中读取的信息。
应用于由comment_author_email函数从数据库中检索的评论作者的电子邮件地址。另请参阅get_comment_author_email。
应用于由 comment_author 函数从数据库中检索的注释作者姓名。另请参阅get_comment_author。
在包含在 RSS 源中之前应用于评论作者的姓名。
应用于通过 comment_author_email_link 函数从数据库中检索的评论作者的电子邮件地址。
应用于由 comment_author_url 函数从数据库中检索的注释作者的 URL（另请参阅get_comment_author_url）。
应用于由get_comment_author从数据库中检索到的注释作者姓名，comment_author也称为该名称。另请参阅comment_author。
应用于get_comment_author_email从数据库中检索到的评论作者的电子邮件地址，comment_author_email也调用该地址。另请参阅author_email。
应用于由 get_comment_author_IP 函数从数据库中检索的注释作者的 IP 地址，该函数也由 comment_author_IP 调用。
应用于由 get_comment_author_url 函数（也由 comment_author_url 调用）从数据库中检索的注释作者的 URL。另请参阅comment_url。
应用于登录屏幕上打印的登录错误消息。
应用于登录屏幕上打印的登录标头 URL（默认由 WordPress 提供支持）的标题。
应用于登录屏幕上打印的登录标头 URL（默认指向 wordpress.org）。
应用于登录屏幕上打印的登录消息。
应用于 WP_Role->has_cap 函数中角色的功能列表。筛选函数参数是要筛选的功能列表、被质疑的功能以及角色的名称。
通过 sanitize_user 函数应用于用户名。过滤函数参数：用户名（经过一些清理），原始用户名，严格（真或假使用严格的ASCII或不）。
由 get_the_author 函数应用于帖子作者的显示姓名，该函数也由 the_author 函数调用。
通过the_author_email功能应用于帖子作者的电子邮件地址。
应用于wp_users表中要包含在 WHERE 子句中的列列表WP_User_Query。
数据库写入
本节中的筛选器在保存到数据库之前应用于信息。
在将评论保存到数据库中之前应用于评论作者的电子邮件地址。
应用于注释作者在数据库中保存注释之前的用户名。
在将评论保存到数据库中之前应用于注释作者的 URL。
在将注释保存到数据库中之前应用于注释作者的用户代理。
在将评论保存到数据库中之前应用于评论作者的 IP 地址。
在将注释保存到数据库中之前应用于注释作者的用户 ID。
在数据库中保存之前应用于用户的说明。
在数据库中保存之前应用于用户的显示名称。
在保存在数据库中之前应用于用户的电子邮件地址。
在数据库中保存之前应用于用户的名字。
在数据库中保存之前应用于用户的姓氏。
在数据库中保存之前应用于用户的登录名。
在保存到数据库中之前应用于用户的“好名称”。
在数据库中保存之前应用于用户的昵称。
在保存在数据库中之前应用于用户的 URL。
应用于为新帐户注册用户时生成的注册错误列表。
应用于在尝试将用户注册为新用户之前从注册页面读取的用户电子邮件地址。
应用于新用户名的验证结果。筛选函数参数：有效（真/假），用户名正在验证。
博客过滤器
注意：此部分包含与博客链接相关的过滤器。有关与帖子、页面、类别等链接相关的过滤器，请参阅上面的 #Link 过滤器部分。
通过get_bookmarks函数应用于链接/博客数据库查询结果。筛选函数参数：数据库查询结果列表、get_bookmarks参数列表。
通过get_links_list和wp_list_bookmarks功能应用于链接类别（从WordPress 2.2开始）。
应用于get_links和wp_list_bookmarks函数的链接描述（从WordPress 2.2开始）。
通过get_linkrating函数应用于链路评级号。
通过get_links和wp_list_bookmarks功能应用于链接标题（从WordPress 2.2开始）
在保存在数据库中之前应用于链接说明。
在保存在数据库中之前应用于链接图像。
在保存在数据库中之前应用于链接名称。
在保存在数据库中之前应用于链接注释。
在保存在数据库中之前应用于链接关系信息。
在保存在数据库中之前应用于链接 RSS URL。
在保存在数据库中之前应用于链接目标信息。
在保存在数据库中之前应用于链接 URL。
博客信息和选项过滤器
应用于由 get_alloptions 函数从数据库中检索的选项列表。
应用于检索到以显示在插件列表表中的插件列表。
应用于博客选项，在首先使用 get_bloginfo 函数检索信息后，由 Bloginfo 函数从数据库中检索的信息。第二个参数$show给出所请求的 bloginfo 选项的名称。请注意，bloginfo（“url”）、bloginfo（“directory”）和bloginfo（“home”）不使用此过滤功能（请参阅bloginfo_url）。
首先使用 get_bloginfo 函数检索信息、去除 HTML 标记并适当转换字符后，按函数 get_bloginfo_rss（也称为从 bloginfo_rss 调用）应用于博客选项信息。第二个参数$show给出所请求的 bloginfo 选项的名称。
在返回信息之前应用于 bloginfo（“url”）、bloginfo（“directory”） 和 bloginfo（“home”） 的输出。
应用于wp_loginout功能生成的用于登录和注销的HTML链接（通常放置在侧边栏中）。
应用于允许用户重置其密码的 URL。
应用于反序列化后由 get_option 函数从数据库中检索的选项值（解码基于数组的选项）。要使用此过滤器，您需要为特定选项名称添加过滤器，例如“option_foo”以过滤 get_option（“foo”） 的输出。
应用于 get_space_used（） 函数，以提供显示已用存储空间的替代方法。从此筛选器返回 false 将恢复为默认显示行为（以兆字节为单位使用 wp_upload_dir（） 目录空间）。
应用于 get_alloptions 函数在反序列化后从数据库中检索的选项值（解码基于数组的选项）。要使用此过滤器，您需要为特定选项名称添加过滤器，例如“pre_option_foo”以过滤选项“foo”。
在保存到数据库之前应用了选项值，以允许覆盖要存储的值。要使用此过滤器，您需要为特定选项名称添加过滤器，例如“pre_update_option_foo”以过滤选项“foo”。
应用于为用户创建的侧边栏链接，以通过wp_register功能注册（如果允许）或访问管理面板（如果已登录）。
应用于用于wp_upload_dir函数计算的上载的目录。Filter 函数参数是一个包含组件“dir”（上传目录路径）、“url”（上传目录的 URL）和“error”（如果要生成错误，可以设置为 true）的数组。
允许过滤器函数返回上传的 MIME 类型列表列表（如果 wp_check_filetype 函数没有 MIME 列表输入）。筛选器函数参数是 MIME 类型的关联列表，其组件名称为文件扩展名（用竖线分隔），值为相应的 MIME 类型。
常规文本筛选器
通过attribute_escape函数应用于发布文本和其他内容，在WordPress的许多地方调用该函数，用于在发送到浏览器之前将某些字符更改为HTML属性。
在js_escape函数中发送到浏览器之前应用于 JavaScript 代码。
在将键用于您的设置、字段或其他需求之前应用于 sanitize_key 函数生成的键
管理筛选器
本节中的过滤器与WordPress的管理屏幕相关，包括内容编辑屏幕。
应用于WordPress管理快速菜单中的用户配置文件和信息链接。
应用于自动保存帖子的间隔。
应用于管理员批量操作下拉列表中的批量项目数组。
应用于批量操作更新消息的数组。
应用于为管理菜单中的类别而生成的类别行 HTML。
应用于在编辑屏幕中显示的评论内容。
应用于有人在管理菜单中编辑评论后的重定向位置。筛选函数参数：重定向位置、注释 ID。
在发送电子邮件通知管理员需要审核新评论之前应用于邮件主题。过滤函数参数：邮件主题、注释 ID。 请注意，这发生在默认的 wp_notify_moderator 函数中，这是一个“可插入”函数，这意味着插件可以覆盖它;请参阅插件 API）。
在发送电子邮件通知管理员需要审核新评论之前应用于邮件正文。过滤函数参数：邮件正文文本、注释 ID。 请注意，这发生在默认的 wp_notify_moderator 函数中，这是一个“可插入”函数，这意味着插件可以覆盖它;请参阅插件 API）。
在发送电子邮件通知帖子作者新评论之前应用于邮件标题。过滤函数参数：邮件标题文本、注释 ID。 请注意，这发生在默认的 wp_notify_postauthor 函数中，这是一个“可插入”函数，这意味着插件可以覆盖它;请参阅插件 API）。
在发送电子邮件通知帖子作者新评论之前应用于邮件主题。过滤函数参数：邮件主题、评论 ID。 请注意，这发生在默认的 wp_notify_postauthor 函数中，这是一个“可插入”函数，这意味着插件可以覆盖它;请参阅插件 API）。
在发送电子邮件通知帖子作者新评论之前应用于邮件的正文。过滤函数参数：邮件正文文本、注释 ID。 请注意，这发生在默认的 wp_notify_postauthor 函数中，这是一个“可插入”函数，这意味着插件可以覆盖它;请参阅插件 API）。
应用于每个注释行下的操作链接列表（如“答复”、“快速编辑”、“编辑”）。
允许过滤在 spawn_cron（） 中传递给 wp_remote_post（） 的 URL、键和参数。
应用于空数组以允许插件在wp_get_schedules函数中生成 cron 计划。
用于激活“menu_order”过滤器。
在为新帖子打开编辑器之前应用于默认帖子内容。
应用于在打开编辑器以获取新帖子之前的默认帖子摘录。
应用于在为新帖子打开编辑器之前的默认帖子标题。
通过get_sample_permalink功能应用于帖子、页面、标签或类别辅助信息域。
通过 format_to_edit 函数应用于帖子内容、摘录、标题和密码，该函数由管理菜单调用以设置帖子进行编辑。也适用于在管理菜单中编辑注释时。
通过format_to_post功能应用于发布内容，默认情况下在WordPress中不使用。
manage_edit-${post_type}_columns
应用于自定义帖子类型的[帖子管理]屏幕上要打印的列列表。筛选器函数参数/返回值是一个关联数组，其中元素键是列的名称，值是该列的标题文本。另请参阅操作 manage_${post_type}_posts_custom_column，它将列信息放入编辑屏幕。
一直manage_link_columns到WordPress 2.7。应用于要在博客滚动管理屏幕上打印的列列表。筛选器函数参数/返回值是一个关联列表，其中元素键是列的名称，值是该列的标题文本。另请参阅操作manage_link_custom_column，它将列信息放入编辑屏幕。
应用于要在帖子管理屏幕上打印的列列表。筛选器函数参数/返回值是一个关联数组，其中元素键是列的名称，值是该列的标题文本。另请参阅操作manage_posts_custom_column，它将列信息放入编辑屏幕。（有关示例和使用，请参阅 Scompt 的教程。
应用于要在“页面管理”屏幕上打印的列列表。筛选器函数参数/返回值是一个关联数组，其中元素键是列的名称，值是该列的标题文本。另请参阅操作manage_pages_custom_column，它将列信息放入编辑屏幕。
manage_users_columnsmanage_users_custom_columnmanage_users_sortable_columnsmedia_row_actions
应用于媒体库中每个文件（如“查看”、“编辑”）下的操作链接列表。
应用于管理菜单顺序的阵列。必须先使用“custom_menu_order”过滤器激活。
应用于随机数的寿命以生成或验证随机数。可用于生成较早过期的随机数。筛选器返回的值应以秒为单位。
应用于用于在用户注销时生成或验证随机数的当前用户 ID。
在插件页面上的每个插件下方添加其他链接。
应用于“编辑后”屏幕上显示的元后信息项目的数量。
应用于“帖子>所有帖子”部分中每个帖子下的操作链接列表（如快速编辑、编辑、查看、预览）。
应用于在处理帖子、页面和自定义帖子类型时存储用户可见的管理消息的数组。此过滤器用于更改所述消息的文本，而不是触发它们。请参阅register_post_type文档中的“自定义消息”。
应用于允许插件创建用于上传文件的 XMLRPC 错误。
应用于页面编辑屏幕上的链接，该链接在屏幕底部显示页面预览。
应用于在屏幕底部显示帖子预览的“后期编辑”屏幕上的链接。
在富文本编辑器中显示之前，通过wp_richedit_pre功能应用于发布内容。
应用于添加到 cron 计划中的每个重复事件和单个事件。
在设置屏幕选项值之前对其进行筛选。
应用于 true/false 变量，该变量控制用户是否有机会在用户配置文件屏幕上更改其密码（true 表示显示密码更改字段;false 表示不显示）。
应用于术语的CSV（针对每个分类法），用于显示哪些术语附加到帖子。
应用于为容纳富文本编辑器而创建的 HTML DIV，然后再将其打印到屏幕上。过滤器函数参数/返回值是一个字符串。
应用于计算用户的浏览器是否具有丰富的编辑功能，以及用户是否要使用丰富的编辑器，在user_can_richedit函数中。如果当前用户可以使用/无法使用富编辑器，则筛选器函数参数和返回值为 true/false。
应用于 WP_User->has_cap 函数（由 current_user_can 函数调用）中的用户功能列表。过滤器函数参数是要过滤的功能列表、被质疑的功能和参数列表（如果功能是编辑帖子等，则包含帖子 ID 等内容）
应用于上传文件时的上传信息。过滤器函数参数：表示 $_FILES 的单个元素的数组。
应用于上传文件时的上传信息。过滤器函数参数：带有元素“文件”（文件名）、“url”、“类型”的数组。
更改给定帖子保留的修订数。过滤函数参数：表示保存的所需修订（默认为无限修订）的数字，发布对象。
应用于 wp_terms_checklist（） 函数的参数。过滤器函数参数：清单参数数组，帖子 ID。
应用于要在上载管理管理屏幕上显示的自定义选项卡列表。使用操作upload_files_（选项卡）显示自定义选项卡的页面（请参阅插件 API/操作参考）。
应用于要在上载管理管理屏幕上显示的自定义选项卡列表。使用操作upload_files_（选项卡）显示自定义选项卡的页面（请参阅插件 API/操作参考）。
应用于要在插件页面上显示的链接列表（在激活/停用链接旁边）。
应用于列表帖子，例如 全部 （30） |出版 （22） |草稿 （5） |待定 （2） |垃圾桶 （1）
富文本编辑器筛选器
这些过滤器修改富文本编辑器 TinyMCE 的配置。
应用于拼写检查器中可用的语言选择。
mce_buttons、mce_buttons_2、mce_buttons_3 mce_buttons_4
应用于丰富编辑器工具栏的按钮行（每个按钮都是一个按钮名称数组）。
应用于富文本编辑器的 CSS 文件 URL。
应用于要由富文本编辑器加载的外部插件数组。
应用于外部插件加载的语言文件数组，允许它们使用标准翻译方法（参考参见 Tinymce/langs/WP-LANGS.php）。
应用于编辑器的整个 init 数组。
模板过滤器
本节包含与主题、模板和样式文件相关的链接。
应用于 get_locale_stylesheet_uri 函数返回的区域设置特定的样式表 URI。过滤函数参数：URI、样式表目录 URI。
应用于 get_stylesheet 函数返回的样式表。
应用于 get_stylesheet_directory 函数返回的样式表目录。过滤函数参数：样式表目录、样式表。
应用于 get_stylesheet_directory_uri 函数返回的样式表目录 URI。过滤函数参数：样式表目录 URI、样式表。
应用于 get_stylesheet_uri 函数返回的样式表 URI。过滤函数参数：样式表 URI、样式表。
应用于 get_template 函数返回的模板。
应用于 get_template_directory 函数返回的模板目录。过滤函数参数：模板目录、模板。
应用于 get_template_directory_uri 函数返回的模板目录 URI。筛选函数参数：模板目录URI，模板。
应用于get_theme_root函数返回的主题根目录（通常是WP-content/themes）。
应用于 get_theme_root_uri 函数返回的主题根目录 URI。筛选函数参数：URI、站点 URL。
您还可以使用以下筛选器挂钩替换主题中的单个模板文件。另请参阅template_redirect动作钩子。这些过滤器中的每一个都将当前主题中相应模板文件的路径作为输入。插件可以通过返回模板文件的新路径来修改要使用的文件。
例如，您可以使用它为自定义帖子类型存档强制执行特定模板。这样，您可以将所有代码保存在插件中。
attachment_template author_template category_template comments_popup_template comments_template
“comments_template”过滤器可用于从插件加载自定义模板，以替换主题默认评论模板。
date_template home_template page_template paged_template search_template single_template
例如，您可以使用它为自定义帖子类型强制执行特定模板。这样，您可以将所有代码保存在插件中。
应用于“按此”书签链接。
template_include wp_nav_menu_args
应用于wp_nav_menu函数的参数。
筛选导航菜单的 HTML 列表内容。
库布里克滤波器
这些过滤器存在于 3.0 之前的默认主题 kubrick 中。
应用于库布里克主题标题的颜色。
应用于库布里克主题标题的显示选项。
应用于库布里克主题的标题图像文件。
注册和登录过滤器
允许在登录时根据用户名和密码执行基本身份验证。
应用于为新帐户注册用户时生成的注册错误列表。
应用于在尝试将用户注册为新用户之前从注册页面读取的用户电子邮件地址。
应用于新用户名的验证结果。筛选函数参数：有效（真/假），用户名正在验证。
当用户尝试登录时应用，在 WordPress 验证用户名和密码之后，但在检查验证错误之前。
重定向/重写过滤器
这些高级过滤器与WordPress对重写规则的处理有关。
应用于被认为可以安全重定向的主机名列表。WP-login.php使用它来防御危险的“redirect_to”请求参数
在生成与作者相关的重写规则后应用于这些规则。
在生成与类别相关的重写规则后应用于这些规则。
在生成与注释相关的重写规则后应用于这些规则。
在生成与日期相关的重写规则后应用于这些规则。
应用于当用户更改其永久链接结构时提供给用户的重写规则列表，以放入其 .htaccess 文件中。（注意：替换已弃用的筛选器rewrite_rules。
在生成与页面相关的重写规则后应用于这些规则。
在生成后相关重写规则后应用于这些规则。
可用于取消“规范”网址重定向。接受 2 个参数：$redirect_url、$requested_url。取消重定向返回 FALSE，以允许重定向返回 $redirect_url
在生成后应用于整个重写规则数组。
在生成根级重写规则后应用于这些规则。
在生成与搜索相关的重写规则后应用于这些规则。
通过默认wp_redirect函数应用于重定向 URL。筛选函数参数：URL、HTTP 状态代码。请注意，wp_redirect也是一个“可插拔”函数，这意味着插件可以覆盖它;请参阅插件 API）。
在通过默认wp_redirect函数重定向时应用于 HTTP 状态代码。筛选函数参数：HTTP 状态代码、URL。请注意，wp_redirect也是一个“可插拔”函数，这意味着插件可以覆盖它;请参阅插件 API）。
WP_Query过滤器
这些是 WP_Query 对象在构建和执行查询以检索帖子的过程中运行的过滤器。另请参阅 #Advanced WordPress 过滤器，了解与用户、元值和更通用的查询相关的查询。
应用于帖子列表，就在从数据库查询之后。
从数据库中查询要显示的帖子列表后，WordPress 会在查询结果中选择行。此过滤器允许您在该步骤中执行 SELECT FOUND_ROWS（） 以外的操作。
应用于返回 post 数组的查询的 LIMIT 子句。
应用于整个 SQL 查询，分为每个子句类型的键控数组，返回 post 数组。可能比posts_request更容易使用。
允许插件将 DISTINCTROW 子句添加到返回 post 数组的查询中。
应用于返回 POST 数组的查询的字段列表。
应用于返回 post 数组（通常为空）的查询的 GROUP BY 子句。
应用于返回 post 数组的查询的 JOIN 子句。这通常用于将表与posts_where筛选器结合使用，添加到 JOIN。
在计算分页后应用于返回 post 数组的查询的 JOIN 子句（尽管分页不会影响 JOIN，因此这实际上等效于 posts_join）。
应用于返回 post 数组的查询的 ORDER BY 子句。
应用于在运行查询之前返回 post 数组的整个 SQL 查询。
允许您操作从查询返回的结果数组。
应用于 WP_Query 的 WHERE 子句中使用的搜索 SQL。
应用于返回 post 数组的查询的 WHERE 子句。
应用于在计算分页后返回 post 数组的查询的 WHERE 子句（尽管分页不会影响 WHERE，因此这实际上等同于 posts_where）。
应用于在对单帖子页面上的权限和草稿状态进行最小处理后从数据库中查询的帖子列表。
媒体过滤器
本节包含用于集成不同类型的媒体的媒体筛选器。
editor_max_image_size image_downsize get_image_tag_class get_image_tag image_resize_dimensions intermediate_image_sizes icon_dir wp_get_attachment_image_attributes img_caption_shortcode post_gallery use_default_gallery_style gallery_style （相邻）_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 功能相关的高级过滤器。
应用于用于在运行查询之前将新用户的信息保存到数据库的查询。
应用于当前用户有权在get_editable_authors功能中编辑的帖子作者列表。
在函数get_next_post（在当前显示的帖子之后查找帖子）中，应用于 SQL JOIN 子句（如果用户正在查看类别存档，该子句通常会连接到类别表）。过滤函数参数：JOIN 子句、保持在同一类别中（真/假）、排除的类别列表。
在函数 get_next_post（在当前显示的帖子之后查找帖子）中，应用于 SQL ORDER BY 子句（通常按发布日期升序排序，限制为 1 个帖子）。筛选函数参数：ORDER BY 子句。
在函数 get_next_post（在当前显示的帖子之后查找帖子）中，应用于 SQL WHERE 子句（通常查找下一个日期发布的帖子）。过滤函数参数：WHERE 子句、保持在同一类别中（真/假）、排除类别列表。
在函数 get_previous_post（在当前显示的帖子之前查找帖子）中，应用于 SQL JOIN 子句（如果用户正在查看类别存档，该子句通常会连接到类别表）。过滤函数参数：联接子句、保持在同一类别（真/假）、排除类别列表。
在函数 get_previous_post（查找当前显示的帖子之前的帖子）中，应用于 SQL ORDER BY 子句（通常按发布日期降序排序，限制为 1 个帖子）。筛选函数参数：ORDER BY 子句。
在函数 get_previous_post（查找当前显示的帖子之前的帖子）中，应用于 SQL WHERE 子句（通常查找上一个日期的已发布帖子）。过滤函数参数：WHERE 子句、保持在同一类别中（真/假）、排除类别列表。
由 translation（） 函数应用于翻译文本（由 __（） 和 _e（） 国际化函数等函数调用）。过滤函数参数：已翻译文本、未翻译文本和文本域。即使国际化无效或文本域尚未加载，也应用。
override_load_textdomainget_meta_sql
在函数 WP_Meta_Query：：get_sql（生成要附加到高级元查询的主查询的 SQL 子句）中，应用于高级元查询生成的 SQL JOIN 和 WHERE 子句。过滤器函数参数： array（ compact（ 'join'， 'where' ）， $this->query， $type， $primary_table， $primary_id_column， $context ）
应用于选择其他用户的草稿以显示在管理菜单中的查询。
应用于选择要在管理菜单中显示的用户草稿的查询。
由 get_locale 函数应用于区域设置。
应用于所有查询（至少所有查询在加载插件后运行）。
已弃用 - 改用query_vars或请求。
在形成 SQL 查询之前应用于公共 WordPress 查询变量列表。对于删除插件以其他方式处理的额外永久链接信息很有用。
与query_vars类似，但在添加“额外”和私有查询变量后应用。
定义单帖子摘录的长度。
定义摘录末尾的更多字符串。
允许您在默认帖子/页面编辑器中将代码附加到表单标记。
应用于用于在运行查询之前更新用户信息的更新查询。
uploading_iframe_src（自WP 2.5起删除）
应用于在帖子和页面编辑屏幕上上传 iframe 的 HTML src 标记。
应用于为 XMLRPC 服务器定义的 XMLRPC 方法列表。
在 wp_mail 函数发送任何邮件之前应用。提供的值是从当前主机名（由 $_SERVER['SERVER_NAME'] 设置）的 wordpress 地址计算得出的。过滤器应以“user@example.com”或“名称<user@example.com>”的形式返回电子邮件地址或名称/电子邮件组合（不带引号！
在 wp_mail 函数发送任何邮件之前应用。筛选器应返回要用作电子邮件发件人名称的名称字符串。
在元数据更新之前应用。例如，如果用户元数据得到更新，则钩子将为“update_user_metadata”
部件
本节包含WordPress核心中存在的小部件添加的过滤器。
应用于传递给 WordPress 小部件中 widgets_init 函数的参数。
应用于传递给 WordPress Archives 小部件中 wp_get_archives（） 函数的参数。
应用于传递给 WordPress 类别小部件中 wp_list_categories（） 函数的参数。
应用于传递给 WordPress 链接小部件中 wp_list_bookmarks（） 函数的参数。
应用于传递给 WordPress 自定义菜单小部件中 wp_nav_menu（） 函数的参数。
应用于传递给 WordPress 页面小部件中 wp_list_pages（） 函数的参数。
应用于传递给 WordPress 页面小部件中 wp_tag_cloud（） 函数的参数。
应用于WordPress文本小部件的小部件文本。也可能适用于某些第三方小部件。
应用于任何用户可编辑的WordPress小部件的小部件标题。也可能适用于某些第三方小部件。
管理员栏
本节包含由WordPress 3.1.0中添加的管理栏添加的过滤器。
允许更改 中 _wp_admin_bar_init（） 函数中的默认“WP_Admin_Bar”类。wp-includes/admin-bar.php
action和filter之间的主要区别可以总结如下：
- action获取它收到的信息，对其执行某些操作，并且不返回任何内容。换句话说：它作用于某物，然后退出，不返回任何内容返回调用钩子。
- filter获取它收到的信息，以某种方式修改它，然后返回它。换句话说：它过滤一些东西并将其传递回钩子以供进一步使用。
换一种说法：
- action中断代码流以执行某些操作，然后返回到正常流而不进行任何修改。
- filter用于以特定方式修改某些内容，以便代码稍后使用该修改。
苏公网安备
32050902101537号