当前浏览:首页 / WordPress函数 / bloginfo()

bloginfo( string $show = '' )

显示当前站点的信息

bloginfo


描述

另见


参数

$show

(string) (可选) 要显示的站点信息。

默认值: ''


说明

显示有关您网站的信息,这些信息主要来自您在用户配置文件和后台常规设置中提供的信息。它可以在模板文件中的任何位置使用。它将直接打印结果到浏览器,如果需要在PHP中使用返回值,请使用get_bloginfo()

$show的可能值

  • name – 显示“设置>常规”:站点标题,数据获取自wp_options表的blogname记录
  • description – 显示“设置>常规”:副标题,数据获取自wp_options表的blogdescription记录
  • wpurl – 显示“设置>常规”:WordPress地址(URL),数据获取自wp_options表的siteurl记录,可用site_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页面的Content-Type (默认: “text/html”),数据获取自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 – 显示已启用主题的样式表(stylesheet)目录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 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)
  • siteurl – 自2.2版以来已弃用,使用 home_url()bloginfo('url')
  • home – 自2.2版以来已弃用,使用 home_url()bloginfo('url')


源码

查看源码 官方文档


更新日志

版本描述
0.71开始引入

使用示例

  • 示例1

    显示博客标题

    在标签中显示你的博客标题。

    <h1><?php bloginfo( 'name' ); ?></h1>
    
  • 示例2

    如果使用bloginfo作为变量,例如:$url = bloginfo('url');,它将返回null。这是因为bloginfo()会立即响应结果。因此,如果您想使用bloginfo()参数中的任何一个作为变量,请使用get_bloginfo()。此函数以字符串形式返回结果。

  • 示例3

    显示博客描述

    按照 设置 > 常规 中的设置显示博客的标语

    <p><?php bloginfo('description'); ?> </p>
  • 示例4

    示例输出

    在本例中,站点地址(URL)显示为http://www.example.com/home,WordPress地址(URL)显示为http://www.example.com/home/wp

  • 示例5

    这是一个实用的例子,如果描述为空,则隐藏描述。

    <?php if ( get_bloginfo( 'description' )  !== '' ) { ?>
    	<a class="site-description"><?php bloginfo( 'description' ); ?></a>
    <?php } ?>
  • 示例6

    在链接中显示博客标题

    在链接中显示博客标题。

    <a href="<?php bloginfo('url'); ?>" title="<?php bloginfo('name'); ?>"><?php bloginfo('name'); ?></a>
  • 示例7

    显示字符集

    显示博客使用的字符集(例如“utf-8”)
    注意:在3.5及更高版本中,默认字符编码设置为UTF-8,并且无法从管理屏幕进行配置。

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