函数文档

privacy_ping_filter()

💡 云策文档标注

概述

privacy_ping_filter() 是一个 WordPress 函数,用于在返回站点列表前检查博客是否公开。它基于 blog_public 选项的值来决定是否返回传入的站点数据。

关键要点

  • 函数名:privacy_ping_filter()
  • 参数:$sites(混合类型,必需),表示要处理的站点数据
  • 返回值:如果博客公开,则返回 $sites;如果博客不公开,则返回空字符串
  • 核心逻辑:通过 get_option('blog_public') 检查博客公开状态,'0' 表示不公开,其他值表示公开
  • 引入版本:WordPress 2.1.0

代码示例

function privacy_ping_filter( $sites ) {
	if ( '0' !== get_option( 'blog_public' ) ) {
		return $sites;
	} else {
		return '';
	}
}

注意事项

  • 此函数常用于过滤 ping 或站点列表,确保隐私设置被遵守
  • 相关函数:get_option(),用于获取选项值

📄 原文内容

Checks whether blog is public before returning sites.

Parameters

$sitesmixedrequired
Will return if blog is public, will not return if not public.

Return

mixed Empty string if blog is not public, returns $sites, if site is public.

Source

function privacy_ping_filter( $sites ) {
	if ( '0' !== get_option( 'blog_public' ) ) {
		return $sites;
	} else {
		return '';
	}
}

Changelog

Version Description
2.1.0 Introduced.