本文旨在指导 WordPress 开发者如何修改默认的最新文章模块，使其显示待审（pending）状态的文章，而非已发布（publish）的文章。我们将通过 pre_get_posts 钩子，修改文章查询参数，实现只针对特定页面和具有特定权限的用户显示待审文章的目的。本文将提供详细的代码示例和注意事项，帮助开发者安全有效地完成修改。
修改 WordPress 最新文章模块显示待审文章
WordPress 默认的最新文章模块通常显示已发布的文章。然而，在某些情况下，例如网站管理员需要审核待发布的文章时，需要显示待审状态的文章。本文将介绍如何使用 WordPress 的 pre_get_posts 钩子来实现这一功能。
pre_get_posts 钩子允许我们在 WordPress 执行文章查询之前修改查询参数。这使得我们可以根据特定条件改变查询的行为，例如改变文章状态、文章类型、排序方式等。
代码实现
以下代码展示了如何使用 pre_get_posts 钩子来修改文章查询，使其显示待审文章：
function show_pending_posts( $query ) {
// 避免影响后台和主查询
if ( is_admin() || ! $query->is_main_query() ) {
return;
}
// 仅在特定页面且用户具有发布权限时修改查询
if( get_query_var('pagename') == 'name_of_the_page' && current_user_can('publish_posts') ) {
$query->set( 'post_status', 'pending' );
}
}
add_action( 'pre_get_posts', 'show_pending_posts' );代码解释：
- show_pending_posts( $query ): 定义一个函数，该函数接收 $query 对象作为参数。$query 对象包含了 WordPress 即将执行的查询的所有参数。
- is_admin() || ! $query->is_main_query(): 这是一个重要的检查。is_admin() 确保我们不会在 WordPress 后台修改查询，因为这可能会影响后台的功能。! $query->is_main_query() 确保我们只修改主查询，避免影响其他自定义查询。
- get_query_var('pagename') == 'name_of_the_page' && current_user_can('publish_posts'): 这是一个条件判断。get_query_var('pagename') 获取当前页面的名称，我们将其与 'name_of_the_page' 进行比较，以确保我们只在特定页面上修改查询。current_user_can('publish_posts') 检查当前用户是否具有发布文章的权限。这确保只有具有相应权限的用户才能看到待审文章。 注意：将 name_of_the_page 替换为你的实际页面名称。
- $query->set( 'post_status', 'pending' ): 这是修改查询的关键部分。$query->set() 方法允许我们修改查询参数。在这里，我们将 post_status 参数设置为 'pending'，这意味着查询将只返回待审状态的文章。
- add_action( 'pre_get_posts', 'show_pending_posts' ): 这行代码将 show_pending_posts 函数挂载到 pre_get_posts 钩子上。这意味着在 WordPress 执行任何文章查询之前，show_pending_posts 函数都会被调用。
如何使用
- 将上述代码添加到你的 WordPress 主题的 functions.php 文件中，或者添加到自定义插件中。
- 将代码中的 'name_of_the_page' 替换为你希望显示待审文章的页面的实际名称。
- 确保当前用户具有 publish_posts 权限，或者根据你的需求修改权限检查。
注意事项
- 缓存问题： 修改查询参数后，可能需要清除 WordPress 缓存或服务器缓存，以确保更改生效。
- 插件冲突： 某些插件可能会修改文章查询，导致你的代码无法正常工作。如果遇到问题，尝试禁用其他插件，看看是否解决了问题。
- 安全性： 确保只允许具有适当权限的用户查看待审文章，以避免安全问题。
- 代码位置: 建议将代码放置在子主题的 functions.php 文件中，避免主题更新导致代码丢失。
总结
通过使用 pre_get_posts 钩子，我们可以灵活地修改 WordPress 的文章查询，从而实现各种自定义需求。本文提供了一个具体的示例，展示了如何修改查询以显示待审文章。记住，在修改查询参数时，务必小心谨慎，避免影响网站的其他功能。始终进行充分的测试，以确保你的代码按预期工作。
