WordPress 函数：bloginfo()

2018/12/31 1 Comment 23 Views 0 Times

原型：

bloginfo( string $show = '' )

作用：

显示当前站点的信息。一般都是后台可以设置的选项，包括常规选项和用户设置里的信息。 bloginfo() 会直接输出获取到的值，如果要获取返回值的话，请看 get_bloginfo()。

参数：

默认参数：name

$show包含的可能值：

name - 显示 设置>常规中设置的“站点标题”。从 wp_options 表中的“blogname”记录中检索此数据。
description - 显示设置>常规中设置的“副标题”。此数据从 wp_options 的“blogdescription”记录中检索。
wpurl - 显示在设置>常规中设置的“WordPress地址（URL）”。此数据从 wp_options 表中的“siteurl”记录中检索。可以考虑使用 home_url() 代替，尤其是对于使用路径进行区分而不是使用子域名的多站点（它返回的是根站点而不是当前的子站点）。
url - 显示在设置>常规中设置的“站点地址（URL）”。此数据从wp_options表中的“home”记录中检索。应该使用 home_url（）代替。
admin_email - 显示在设置>常规中设置的“电子邮件地址”。此数据从wp_options表中的“admin_email”记录中检索。
charset - 显示设置>阅读中设置的“页面和源的编码”。此数据从wp_options表中的“blog_charset”记录中检索。注意：此参数始终返回“UTF-8”，这是WordPress的默认编码（而且现在后台已经看不到设置项了）。
version - 显示您使用的WordPress版本。该数据是在 wp-includes/version.php 定义的 $wp_version 这个变量的值。
html_type - 显示WordPress HTML页面的内容类型（默认值：text/tml）。此数据从wp_options表中的“html_type”记录中检索。主题和插件可以使用pre_option_html_type过滤器覆盖默认值。
text_direction - 显示WordPress HTML页面的文本方向。应该使用is_rtl()代替。
language - 显示WordPress的语言。
stylesheet_url - 显示当前使用主题的主CSS（通常是style.css）文件的 URL。应该使用get_stylesheet_uri()代替。
stylesheet_directory - 显示当前主题的样式表目录的 URL。（是早期WordPress版本中的本地路径。）请使用get_stylesheet_directory_uri 代替。
template_url/template_directory - 当前主题目录的URL。在子主题中，get_bloginfo('template_url')和get_template都将返回父主题的目录。应该使用 get_template_directory_uri()（对于父模板目录）或get_stylesheet_directory_uri()（对于子模板目录）。
pingback_url - 显示Pingback XML-RPC文件URL（xmlrpc.php）。
atom_url - 显示Atom供稿网址（/feed/atom）。
rdf_url - 显示RDF/RSS 1.0 feed URL（/feed/rfd）。
rss_url - 显示RSS 0.92feed URL（/feed/rss）。
rss2_url - 显示RSS 2.0feed URL（/feed）。
comments_atom_url - 显示评论Atom feed URL（/comments/feed）。
comments_rss2_url - 显示评论RSS 2.0feed URL（/comments/feed）。
siteurl - 自2.2版以来已弃用。用 home_url() 代替。
home - 自2.2版以来已弃用。用 home_url() 代替。

源文件：

wp-includes/general-template.php

<?php
...
function bloginfo( $show = '' ) {
    echo get_bloginfo( $show, 'display' );
}
...
?>

示例：

站点地址（URL）显示的是 http://www.example.com/home, WordPress 地址 (URL) 是安装在 http://www.example.com/home/wp

admin_email          = [email protected]
atom_url             = http://www.example.com/home/feed/atom
charset              = UTF-8
comments_atom_url    = http://www.example.com/home/comments/feed/atom
comments_rss2_url    = http://www.example.com/home/comments/feed
description          = Just another WordPress blog
home                 = http://www.example.com/home (DEPRECATED! use url option instead)
html_type            = text/html
language             = en-US
name                 = Testpilot
pingback_url         = http://www.example.com/home/wp/xmlrpc.php
rdf_url              = http://www.example.com/home/feed/rdf
rss2_url             = http://www.example.com/home/feed
rss_url              = http://www.example.com/home/feed/rss
siteurl              = http://www.example.com/home (DEPRECATED! use url option instead)
stylesheet_directory = http://www.example.com/home/wp/wp-content/themes/largo
stylesheet_url       = http://www.example.com/home/wp/wp-content/themes/largo/style.css
template_directory   = http://www.example.com/home/wp/wp-content/themes/largo
template_url         = http://www.example.com/home/wp/wp-content/themes/largo
text_direction       = ltr
url                  = http://www.example.com/home
version              = 3.5
wpurl                = http://www.example.com/home/wp