wordpress里的bloginfo()与get_bloginfo()

一、先说说get_bloginfo()

描述

返回你博客的信息，这些信息可以用在任何地方的 PHP 代码中。这个函数，和 bloginfo() 一样，可以用来在模板文件的任何地方显示你博客的信息。

原型

get_bloginfo（string $ show = ''， string $ filter = 'raw' ）

用法

1 <?php $bloginfo = get_bloginfo( $show, $filter ); ?>

参数

$show: (字符串 string) (可选) 关键字命名你想要的信息。; 默认: '' name

‘name’ – 返回在设置 > 常规中设置的“博客标题”。此数据可以从 wp_options 这个表中的 “blogname”中检索到。

‘description’ – 返回在设置 > 常规中设置的“副标题”。此数据可以从 wp_options 这个表中的 “blogdescription”中检索到。

‘wpurl’ – 返回在设置 > 常规中设置的“WordPress 地址（URL）”。此数据可以从 wp_options 这个表中的 “siteurl”中检索到。可以考虑使用 site_url() 替代，尤其是在使用子目录路径方式，而不是使用子域名来配置多站点时（bloginfo将返回根网站的URL，而不是子站点的URL）。

‘url‘ – 显示在设置 > 常规中设置的 “站点地址（URL）”)”。该数据是从 wp_options 这个数据表中检索到的 "home"记录。可以考虑使用 home_url() 代替。

‘admin_email’ – 显示在设置 > 常规中设置的 “电子邮件地址”。该数据是从 wp_options 这个数据表中检索到的 "admin_email"记录。

‘charset’ – 显示在设置 > 常规中设置的“页面和feed的编码”。该数据是从 wp_options 这个数据表中检索到的"blog_charset" 记录。（注：3.5.1+好像已经没有这个选项了）

‘version’ – 显示你当前使用的 WordPress 版本。该数据是在 wp-includes/version.php 检索到的 $wp_version 这个字段的值。

‘html_type’ – 显示WordPress HTML 页面中的内容类型（默认： "text/html"）。该数据可以从 wp_options 这个数据表中检索到的 "html_type" 记录。主题和插件可以通过使用 pre_option_html_type 过滤器覆盖默认值。

‘text_direction’ – 显示 WordPress HTML 页面的文本方向。可以考虑使用 is_rtl() 代替。

‘language’ – 显示WordPress的语言。

‘stylesheet_url’ – 显示当前使用的主题的 CSS文件（通常为 style.css）路径。可以考虑使用 get_stylesheet_uri() 代替。

‘stylesheet_directory’ – 显示当前使用的主题的样式表路径。可以考虑使用 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’ – 显示通告文件 XML-RPC 的URL (xmlrpc.php)

‘atom_url’ – 显示 Atom feed URL (/feed/atom)

‘rdf_url’ – 显示 RDF/RSS 1.0 feed URL (/feed/rfd).

‘rss_url’ – 显示 RSS 0.92 feed URL (/feed/rss).

‘rss2_url’ – 显示 RSS 2.0 feed URL (/feed).

‘comments_atom_url’ – 显示评论的 Atom feed URL (/comments/feed).

‘comments_rss2_url’ – 显示评论的 RSS 2.0 feed URL (/comments/feed).

$filter: (字符串 string) (可选)关键字指定如何过滤检索到的数据。; 默认: 'raw'

‘display’ – 通过 wptexturize() 函数过滤 $show 的值，然后返回输出给请求者。

‘raw’ – 直接返回 $show 的值。

某些$show值已弃用，将在以后的版本中删除。这些选项将触发_deprecated_argument（）函数。

不推荐使用的参数包括：

'siteurl' - 使用'url'代替
'home' - 使用'url'代替

例子

默认用法

默认情况下，将你的博客标题定义给 $blog_title 变量。

1	<?php $blog_title = get_bloginfo(); ?>

博客标题

下面的例子将你的博客标题定义给 $blog_title 变量，输出结果和上面的默认用法一样。

1	<?php $blog_title = get_bloginfo('name'); ?>

博客副标题

使用下面的例子：

1	<?php echo '你博客的副标题是: ' . get_bloginfo ( 'description' ); ?><br />

返回现实的内容是：

1	你博客的副标题是: All things WordPress

网络副标题(多站点)

使用下面的代码，你可以得到网络首页的名称和副标题：

 <?php
 switch_to_blog(1);
 $site_title = get_bloginfo( 'name' );
 $site_url = network_site_url( '/' );
 $site_description = get_bloginfo( 'description' );
 restore_current_blog();
 echo '网络首页的 URL 是: ' . $site_url;
 echo '网络首页的 名称 是: ' . $site_title;
 echo '网络首页的 副标题 是: ' . $site_description;  
?>

返回的输出结果如下：

1
2
3

网络首页的 URL 是: http://example.com/
网络首页的 名称 是: Example
网络首页的 副标题 是: The example site

二、再说说bloginfo()

描述

显示你的博客信息，大部分都是显示WordPress管理界面的用户资料和常规设置中的信息。它可以在模板文件的任何地方使用。一般 bloginfo() 都是用来直接在浏览器中输出内容的。如果你需要在PHP中返回值的话，那么请用 get_bloginfo()。

用法

1	<?php bloginfo( $show ); ?>

参数

$show (字符串string) (可选)你需要输出的信息的关键词。

默认： name

‘name‘ – 显示在设置 > 常规中设置的“站点标题”。该数据是从 wp_options 这个数据表中检索到的 "blogname"记录。
‘description‘ – 显示在设置 > 常规中设置的“副标题”。该数据是从 wp_options 这个数据表中检索到的 "blogdescription" 记录。
‘wpurl‘ – 显示在设置 > 常规中设置的 “WordPress 地址 (URL)”。该数据是从 wp_options 这个数据表中检索到的 "siteurl" 记录。可以考虑使用 site_url() 来代替，尤其是在使用子目录路径方式，而不是使用子域名来配置多站点时（bloginfo将返回根网站的URL，而不是子站点的URL）。
‘siteurl‘ / ‘url‘ – 显示在设置 > 常规中设置的 “站点地址（URL）”)”。该数据是从 wp_options 这个数据表中检索到的 "home"记录。可以考虑使用 home_url() 代替。
‘admin_email’ – 显示在设置 > 常规中设置的 “电子邮件地址”。该数据是从 wp_options 这个数据表中检索到的 "admin_email"记录。
‘charset’ – 显示在设置 > 常规中设置的“页面和feed的编码”。该数据是从 wp_options 这个数据表中检索到的"blog_charset" 记录。（注：3.5.1+好像已经没有这个选项了）
‘version’ – 显示你当前使用的 WordPress 版本。该数据是在 wp-includes/version.php 检索到的 $wp_version 这个字段的值。
‘html_type’ – 显示WordPress HTML 页面中的内容类型（默认： "text/html"）。该数据可以从 wp_options 这个数据表中检索到的 "html_type" 记录。主题和插件可以通过使用 pre_option_html_type过滤器覆盖默认值。
‘text_direction’ – 显示 WordPress HTML 页面的文本方向。可以考虑使用 is_rtl() 代替。
‘language’ – 显示WordPress的语言。
‘stylesheet_url’ – 显示当前使用的主题的 CSS文件（通常为 style.css）路径。可以考虑使用 get_stylesheet_uri() 代替。
‘stylesheet_directory’ – 显示当前使用的主题的样式表路径。可以考虑使用 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’ – 显示通告文件 XML-RPC 的URL (xmlrpc.php)
‘atom_url’ – 显示 Atom feed URL (/feed/atom)
‘rdf_url’ – 显示 RDF/RSS 1.0 feed URL (/feed/rfd).
‘rss_url’ – 显示 RSS 0.92 feed URL (/feed/rss).
‘rss2_url’ – 显示 RSS 2.0 feed URL (/feed).
‘comments_atom_url’ – 显示评论的 Atom feed URL (/comments/feed).
‘comments_rss2_url’ – 显示评论的 RSS 2.0 feed URL (/comments/feed).

例子

显示博客标题

在 <h1> 标签中显示博客标题

1	<h1><?php bloginfo('name'); ?></h1>

显示带链接的博客标题

显示一个带站点链接的博客标题

1	<a href="<?php bloginfo('url'); ?>" title="<?php bloginfo('name'); ?>"><?php bloginfo('name'); ?></a>

显示字符集

显示你博客设置的字符集（例如“UTF-8”）

1	<p>Character set: <?php bloginfo('charset'); ?> </p>

显示博客描述

显示在设置 > 常规中设置的“副标题”

1	<p><?php bloginfo('description'); ?> </p>

总结：bloginfo()将直接把博客相关信息回显到浏览器中，而get_bloginfo()则是获取博客相关信息的值，可以在后面的php代码中使用。