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

get_bloginfo( string $show = '', string $filter = 'raw' )

获取当前站点的信息

bloginfo


描述

$show参数的可用值:

  • name – 站点标题(在设置 > 常规)
  • description – 副标题(在设置 > 常规)
  • wpurl – WordPress地址(URL)(在设置 > 常规)
  • url – 站点地址(URL)(在设置 > 常规)
  • admin_email – 管理员电子邮箱地址(在设置 > 常规)
  • charset – 页面编码(在设置 > 阅读)
  • version – 当前WordPress版本
  • html_type – Content-type (默认: "text/html"). 主题和插件可以使用pre_option_html_type钩子覆盖默认值
  • text_direction – 由站点语言确定的文本方向,应该改用is_rtl()
  • language – 当前站点语言
  • stylesheet_url – 已启用主题的样式表(stylesheet)URL,启用的子主题将优先于此值
  • stylesheet_directory – 已启用主题的目录路径,启用的子主题将优先于此值
  • template_url / template_directory – 已启用主题的目录URL,启用的子主题不会优先于此值
  • pingback_url – Pingback XML-RPC 文件URL (xmlrpc.php)
  • atom_url – Atom feed URL (/feed/atom)
  • rdf_url – RDF/RSS 1.0 feed URL (/feed/rdf)
  • 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)

有些$show值已被弃用,将在以后的版本中删除。这些选项将触发_deprecated_argument()函数。

不推荐的参数包括:

  • ‘siteurl’ – 用 ‘url’ 替代
  • ‘home’ – 用 ‘url’ 替代

参数

$show

(string) (可选) 要检索的站点信息。默认为空(站点名称)。

默认值: ''

$filter

(string) (可选) 如何过滤检索到的内容。

默认值: 'raw'


返回

(string) 主要是字符串值,可能为空。


说明

用法

$bloginfo = get_bloginfo( $show, $filter );


源码

查看源码 官方文档


更新日志

版本描述
0.71开始引入

使用示例

  • 示例1

    网络标语
    使用此示例,您可以获取网络主页的名称和描述:

    <?php
    switch_to_blog(1);
    $site_title = get_bloginfo( 'name' );
    $site_url = network_site_url( '/' );
    $site_description = get_bloginfo( 'description' );
    restore_current_blog();
    echo 'The Network Home URL is: ' . $site_url;
    echo 'The Network Home Name is: ' . $site_title;
    echo 'The Network Home Tagline is: ' . $site_description;  
    ?>
    

    显示结果:

    网络主页URL是:http://example.com/
    网络主页名称是:示例
    网络主页标语是:示例站点

  • 示例2

    应该有可能返回所有可用信息的数组。虽然这在性能方面可能不是一个好的做法,但这应该可以帮助需要获取网站所有信息的人。请注意,我省略了一些可能不那么重要的字段:

    function bloginfo_array() {
        $fields = array('name', 'description', 'wpurl', 'url', 'admin_email', 'charset', 'version', 'html_type', 'text_direction', 'language');
        $data = array();
        foreach($fields as $field) {
            $data[$field] = get_bloginfo($field);
        }
        return $data;
    }
  • 示例3

    默认用法
    默认用法将博客标题分配给变量$blog_title

    <?php $blog_title = get_bloginfo(); ?>
    
  • 示例4

    博客标语
    使用以下示例:

    <?php printf( esc_html__( 'Your Blog Tagline is: %s', 'textdomain' ), get_bloginfo ( 'description' ) ); ?><br />
    

    显示结果:

    你的博客标语是:关于WordPress的一切

  • 示例5

    博客标题
    本例将博客标题分配给变量$blog_title。这将返回与默认用法相同的结果。

    <?php $blog_title = get_bloginfo( 'name' ); ?>
    
  • 示例6

    关于“get_bloginfo('url')”的评论具有误导性。它*不*一定返回(设置 > 常规)中设置的内容,所有协议("http "或 "https")将由`is_ssl()`的值决定,该值检测当前请求是否通过SSL。