首页>文档>WordPress模板标签>get_bloginfo () – 当前站点的信息

get_bloginfo () – 当前站点的信息

模板标签

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

说明

检索有关当前站点的信息。

参数

  • ‘name’ –  网站标题(设置 > 常规设置)。
  • ‘description’ – 网站标语(设置 > 常规设置)。
  • ‘wpurl’ – WordPress 地址 (URL) (设置 > 常规设置)。
  • ‘url’ – 网站地址 (URL) (设置 > 常规设置)。
  • ‘admin_email’ – 管理员电子邮件(设置 > 常规设置)。
  • ‘charset’ – “页面和源的编码”(设置 > 阅读中设置)。  /?最新版5.5中未找到此项/
  • ‘version’  – 当前 WordPress 版本。
  • ‘html_type’ – 内容类型(默认值:”文本/html”)。主题和插件可以使用”pre_option_html_type“筛选器覆盖默认值。
  • ‘text_direction’ –  由网站语言确定的文本方向。
  • ‘language’ – 当前站点的语言代码。
  • ‘stylesheet_url’ – 当前主题的样式表路径,子主题的样式表优先级高于父主题。
  • ‘stylesheet_directory’ – 当前主题的目录路径,子主题的优先级高于父主题。
  • ‘template_url’ / ‘template_directory’ – 当前主题的目录url,子主题的优先级高于父主题。
  • ‘pingback_url’ – pingback XML-RPC 文件 URL (xmlrpc.php)。
  • ‘atom_url’ – Atom源的url。
  • ‘rdf_url’ – RDF/RSS 1.0 源 URL。
  • ‘rss_url’ – RSS 0.92 源 URL 。
  • ‘rss2_url’ –  RSS 2.0 源 URL。
  • ‘comments_atom_url’ – 注释原子源 URL
  • ‘comments_rss2_url’ – 注释 RSS 2.0 源 URL

返回

(string) 大多数字符串值可能为空。

来源

wp-includes/general-template.php

function get_bloginfo( $show = '', $filter = 'raw' ) {
    switch ( $show ) {
        case 'home':    // Deprecated.
        case 'siteurl': // Deprecated.
            _deprecated_argument(
                __FUNCTION__,
                '2.2.0',
                sprintf(
                    /* translators: 1: 'siteurl'/'home' argument, 2: bloginfo() function name, 3: 'url' argument. */
                    __( 'The %1$s option is deprecated for the family of %2$s functions. Use the %3$s option instead.' ),
                    '<code>' . $show . '</code>',
                    '<code>bloginfo()</code>',
                    '<code>url</code>'
                )
            );
            // Intentional fall-through to be handled by the 'url' case.
        case 'url':
            $output = home_url();
            break;
        case 'wpurl':
            $output = site_url();
            break;
        case 'description':
            $output = get_option( 'blogdescription' );
            break;
        case 'rdf_url':
            $output = get_feed_link( 'rdf' );
            break;
        case 'rss_url':
            $output = get_feed_link( 'rss' );
            break;
        case 'rss2_url':
            $output = get_feed_link( 'rss2' );
            break;
        case 'atom_url':
            $output = get_feed_link( 'atom' );
            break;
        case 'comments_atom_url':
            $output = get_feed_link( 'comments_atom' );
            break;
        case 'comments_rss2_url':
            $output = get_feed_link( 'comments_rss2' );
            break;
        case 'pingback_url':
            $output = site_url( 'xmlrpc.php' );
            break;
        case 'stylesheet_url':
            $output = get_stylesheet_uri();
            break;
        case 'stylesheet_directory':
            $output = get_stylesheet_directory_uri();
            break;
        case 'template_directory':
        case 'template_url':
            $output = get_template_directory_uri();
            break;
        case 'admin_email':
            $output = get_option( 'admin_email' );
            break;
        case 'charset':
            $output = get_option( 'blog_charset' );
            if ( '' === $output ) {
                $output = 'UTF-8';
            }
            break;
        case 'html_type':
            $output = get_option( 'html_type' );
            break;
        case 'version':
            global $wp_version;
            $output = $wp_version;
            break;
        case 'language':
            /*
             * translators: Translate this to the correct language tag for your locale,
             * see https://www.w3.org/International/articles/language-tags/ for reference.
             * Do not translate into your own language.
             */
            $output = __( 'html_lang_attribute' );
            if ( 'html_lang_attribute' === $output || preg_match( '/[^a-zA-Z0-9-]/', $output ) ) {
                $output = determine_locale();
                $output = str_replace( '_', '-', $output );
            }
            break;
        case 'text_direction':
            _deprecated_argument(
                __FUNCTION__,
                '2.2.0',
                sprintf(
                    /* translators: 1: 'text_direction' argument, 2: bloginfo() function name, 3: is_rtl() function name. */
                    __( 'The %1$s option is deprecated for the family of %2$s functions. Use the %3$s function instead.' ),
                    '<code>' . $show . '</code>',
                    '<code>bloginfo()</code>',
                    '<code>is_rtl()</code>'
                )
            );
            if ( function_exists( 'is_rtl' ) ) {
                $output = is_rtl() ? 'rtl' : 'ltr';
            } else {
                $output = 'ltr';
            }
            break;
        case 'name':
        default:
            $output = get_option( 'blogname' );
            break;
    }
 
    $url = true;
    if ( strpos( $show, 'url' ) === false &&
        strpos( $show, 'directory' ) === false &&
        strpos( $show, 'home' ) === false ) {
        $url = false;
    }
 
    if ( 'display' === $filter ) {
        if ( $url ) {
            /**
             * Filters the URL returned by get_bloginfo().
             *
             * @since 2.0.5
             *
             * @param string $output The URL returned by bloginfo().
             * @param string $show   Type of information requested.
             */
            $output = apply_filters( 'bloginfo_url', $output, $show );
        } else {
            /**
             * Filters the site information returned by get_bloginfo().
             *
             * @since 0.71
             *
             * @param mixed  $output The requested non-URL site information.
             * @param string $show   Type of information requested.
             */
            $output = apply_filters( 'bloginfo', $output, $show );
        }
    }
 
    return $output;
}

更多

博客标签

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

网络标记

<?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/
主页名称是:例如
网络主页标签是:示例站点

官方原文档

https://developer.wordpress.org/reference/functions/get_bloginfo/

个人中心
今日签到
有新私信 私信列表
搜索