函数wp_get_sites用于获取站点列表。在WordPress MultiSite网络中,每个站点都是一个独立的网站,wp_get_sites可以用来获取多站点网络中的所有站点。
使用wp_get_sites函数的基本语法如下:
wp_get_sites( $args );
其中,$args是一个可选的参数数组,用于过滤站点列表。可用的参数包括:
- network_id:指定要获取站点的网络ID。默认值为当前网络的ID。
- public:是否只返回公共站点。默认为true,即只返回公共站点。
- archived:是否只返回已归档的站点。默认为false,即返回所有站点。
- mature:是否只返回成熟的站点。默认为false,即返回所有站点。
- spam:是否只返回垃圾站点。默认为false,即返回所有站点。
- deleted:是否只返回已删除的站点。默认为false,即返回所有站点。
- limit:返回的站点数量限制。默认为100。
- offset:返回站点列表的偏移量。默认为0。
返回的结果是一个数组,包含了满足条件的站点信息。每个站点信息是一个关联数组,包含了以下字段:
- blog_id:站点的ID。
- domain:站点的域名。
- path:站点的路径。
- site_id:站点所属的网络ID。
- registered:站点的注册时间。
- last_updated:站点的最后更新时间。
- public:站点是否为公共站点。
- archived:站点是否为已归档。
- mature:站点是否为成熟站点。
- spam:站点是否为垃圾站点。
- deleted:站点是否为已删除。
下面是一个示例:
$sites = wp_get_sites();
foreach ( $sites as $site ) {
echo $site['blog_id'] . ': ' . $site['domain'] . $site['path'] . '
';
}
该示例获取当前网络中的所有站点,并将站点的ID、域名和路径输出到页面上。
需要注意的是,wp_get_sites函数在WordPress 4.6版本中已被弃用,推荐使用get_sites函数代替。get_sites函数的用法与wp_get_sites函数类似,只是参数和返回值的格式略有不同。
0 个评论