get_bloginfo() – Retrieves information about the current site.

You appear to be a bot. Output may be restricted

Description

Retrieves information about the current site.

Possible values for $show include:

  • 'name' – Site title (set in Settings > General)
  • 'description' – Site tagline (set in Settings > General)
  • 'wpurl' – The WordPress address (URL) (set in Settings > General)
  • 'url' – The Site address (URL) (set in Settings > General)
  • 'admin_email' – Admin email (set in Settings > General)
  • 'charset' – The "Encoding for pages and feeds" (set in Settings > Reading)
  • 'version' – The current WordPress version
  • 'html_type' – The content-type (default: "text/html"). Themes and plugins
  • can override the default value using the pre_option_html_type filter
  • 'text_direction' – The text direction determined by the site's language. is_rtl()
  • should be used instead
  • 'language' – Language code for the current site
  • 'stylesheet_url' – URL to the stylesheet for the active theme. An active child theme
  • will take precedence over this value
  • 'stylesheet_directory' – Directory path for the active theme. An active child theme
  • will take precedence over this value
  • 'template_url' / 'template_directory' – URL of the active theme's directory. An active
  • child theme will NOT take precedence over this value
  • 'pingback_url' – The pingback XML-RPC file URL (xmlrpc.php)
  • 'atom_url' – The Atom feed URL (/feed/atom)
  • 'rdf_url' – The RDF/RSS 1.0 feed URL (/feed/rdf)
  • 'rss_url' – The RSS 0.92 feed URL (/feed/rss)
  • 'rss2_url' – The RSS 2.0 feed URL (/feed)
  • 'comments_atom_url' – The comments Atom feed URL (/comments/feed)
  • 'comments_rss2_url' – The comments RSS 2.0 feed URL (/comments/feed)

Some $show values are deprecated and will be removed in future versions. These options will trigger the _deprecated_argument() function. Deprecated arguments include:

  • 'siteurl' – Use 'url' instead
  • 'home' – Use 'url' instead

Usage

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

Parameters

$show
( string ) optional – Optional. Site info to retrieve. Default empty (site name).
$filter
( string ) optional default: raw – Optional. How to filter what is retrieved. Default 'raw'.

Returns

string Mostly string values, might be empty.

Source

File name: wordpress/wp-includes/general-template.php
Lines:

1 to 100 of 141
function get_bloginfo( $show = '', $filter = 'raw' ) {
  switch ( $show ) {
    case 'home':    // Deprecated.
    case 'siteurl': // Deprecated.
      _deprecated_argument(
        get_bloginfo,
        '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(
        get_bloginfo,
        '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';
 

 View on GitHub View on Trac