2023-09-03

重写后的标题为:WP_Query参数:作者、搜索、密码和权限


到目前为止,在本系列中,您已经了解了可以与 WP_Query 类一起使用的参数选择,以按帖子类型、类别、标签、元数据、日期、状态等选择帖子更多。

在关于 WP_Query 参数的最后一个教程中,我将介绍一些不常用的参数,这些参数可以为您的查询提供更大的灵活性。

我们将在此处介绍的参数用于:

  • 作者
  • 搜索
  • 密码
  • 权限
  • caching
  • 返回字段

在开始之前,让我们快速回顾一下如何使用 WP_Query 编写参数。

回顾 WP_Query 中的参数如何工作

当您在主题或插件中编写 WP_Query 时,您需要包含四个主要元素:

  • 查询的参数,使用本教程将介绍的参数
  • 查询本身
  • 循环
  • 结束:关闭 if 和 while 标签并重置发布数据

实际上,这将类似于以下内容:

<?php

$args = array(
    // Arguments for your query.
);

// Custom query.
$query = new WP_Query( $args );

// Check that we have query results.
if ( $query->have_posts() ) {

    // Start looping over the query results.
    while ( $query->have_posts() ) {

        $query->the_post();

        // Contents of the queried post results go here.

    }

}

// Restore original post data.
wp_reset_postdata();

?>
登录后复制

这些参数告诉 WordPress 从数据库中获取哪些数据,我将在此处介绍这些数据。所以我们在这里关注的是代码的第一部分:

$args = array(
    // Arguments for your query.
);
登录后复制

如您所见,参数包含在一个数组中。在学习本教程时,您将学习如何对它们进行编码。

编写你的参数

数组中的参数有一种具体的编码方式,如下:

$args = array(
    'parameter1' => 'value',
    'parameter2' => 'value',
    'parameter3' => 'value'
);
登录后复制

必须将参数及其值括在单引号中,在它们之间使用 =>,并用逗号分隔它们。如果您犯了这个错误,WordPress 可能不会将所有参数添加到查询中,否则您可能会看到白屏。

作者参数

有四个参数可以用于按作者查询:

  • author (int):使用作者 ID
  • author_name (字符串):使用“user_nicename”(不是名称)
  • author__in (数组):使用作者 ID
  • author__not_in (数组)

第一个 author 允许您通过提供作者 ID 来查询一个或多个作者的帖子:

$args = array(
    'author' => '2'
);
登录后复制

上面的代码查询ID为2的作者的所有帖子。

您还可以使用字符串来查询多个作者的帖子:

$args = array(
    'author' => '1, 2'
);
登录后复制

如果要按名称查询,可以使用 author_name 参数:

$args = array(
    'author_name' => 'rachelmccollin'
);
登录后复制

此参数采用数据库中 user_nicename 字段的值作为其参数,该值在用户管理屏幕中显示为昵称:

重写后的标题为:WP_Query参数:作者、搜索、密码和权限

请注意,由于用户可以编辑此内容,因此使用 author 会更安全参数(如果您认为您的用户可能会更改它)。

您还可以查询一系列作者的帖子:

$args = array(
    'author__in' => array(
        '1',
        '2'
    )
);
登录后复制

上面将查询两位作者的帖子: ID 为 12 的作者,给出的结果与我在 author 参数上面。

最后,您可以使用 author__not_in 参数排除一位或多位作者的帖子。下面的参数查询除作者 1 之外的所有帖子:

$args = array(
    'author__not_in' => array( '1' )
);
登录后复制

或者您可以排除多个作者:

$args = array(
    'author__not_in' => array(
        '1',
        '2'
    )
);
登录后复制

或者,您可以使用 author 参数,并在作者 ID 前面使用减号来排除作者:

$args = array(
    'author' => '-2'
);
登录后复制

搜索参数

搜索的参数只有一个,就是s。使用它来查询与搜索词匹配的帖子。例如,要查询包含关键字“我最喜欢的食物”的帖子,您可以使用:

$args = array(
    's' => 'my favorite food'
);
登录后复制

例如,您可能会发现这对于搜索具有相似关键字的相关帖子很有用。

密码参数

您可以使用两个密码参数来查询有或没有密码保护的帖子:

  • has_password (bool)
  • post_password (字符串)

第一个参数 has_password 允许您查询有或没有密码保护的帖子。因此,要查询受密码保护的帖子:

$args = array(
    'has_password' => true
);
登录后复制

对于没有密码的帖子:

$args = array(
    'has_password' => false
);
登录后复制

您还可以通过密码本身进行查询,使用 post_password 参数:

$args = array(
    'post_password' => 'mypassword'
);
登录后复制

权限参数

权限只有一个参数,perm,用于查询当前用户有权限阅读的帖子。它采用 'readable' 值,旨在与其他参数结合使用。

因此,要查询受密码保护的帖子并仅在用户具有适当权限时才显示它们,您可以使用以下命令:

$args = array(
    'has_password' => true,
    'perm' => 'readable'
);
登录后复制

或者,如果当前用户有权查看草稿帖子,则可以使用以下命令:

$args = array(
    'post_status' => 'draft',
    'perm' => 'readable'
);
登录后复制

缓存参数

共有三个缓存参数,它们会阻止查询检索到的数据添加到缓存中:

  • cache_results (boolean):帖子信息缓存
  • update_post_meta_cache (boolean):发布元信息缓存
  • update_post_term_cache (boolean):帖子术语信息缓存

这三个选项的默认值都是 true:如果您希望将数据添加到缓存中,则不需要使用它们。

因此,要显示 product 帖子类型的所有帖子,但不将帖子信息添加到缓存中,您可以使用以下命令:

$args = array(
    'post_type' => 'product',
    'cache_results' => false
);
登录后复制

通常您不应该使用这些参数,因为将发布数据添加到缓存是一个很好的做法。但是,您有时可能希望检索帖子,以便只使用一些帖子数据,在这种情况下,您不需要缓存中的其余帖子数据。例如,当您只想输出带有链接的帖子标题列表时,在这种情况下,您不需要将帖子术语数据或元数据添加到缓存中:

$args = array(
    'post_type' => 'product',
    'update_post_meta_cache' => false,
    'update_post_term_cache' => false
);
登录后复制

返回字段参数

您可以使用 fields 参数来指定从查询中返回哪些字段。这可以节省从数据库中的字段返回的数据,而在循环中输出数据时不需要这些数据。

默认情况下是返回所有字段,但是您有两个选项可以使用 fields 参数来限制这一点。首先,'ids' 参数:

$args = array(
    'fields' => 'ids'
);
登录后复制

这只会返回帖子 ID 数组,不会返回其他字段。如果您想在循环中输出任何内容(例如帖子标题),则必须使用 get_the_title ($post->ID); 等函数来输出标题,这将处理事情的方式很冗长。

您可以使用的另一个参数获取帖子 ID 与子帖子 ID 的关联数组:

$args = array(
    'fields' => 'id=>parent'
);
登录后复制

您可以使用它根据您的其他参数及其子参数查询帖子。

摘要

WP_Query 系列的这一部分介绍了 WP_Query 类的最终参数集。您可以使用它们按作者、密码保护状态或密码本身和搜索词查询帖子,并设置是否将查询结果添加到缓存以及查询返回哪些字段。

在本系列的下一部分中,您将看到一些在主题或插件中使用 WP_Query 的有效示例。

以上就是重写后的标题为:WP_Query参数:作者、搜索、密码和权限的详细内容,更多请关注php中文网其它相关文章!

https://www.php.cn/faq/601320.html

发表回复

Your email address will not be published. Required fields are marked *