Displays information about the current site.
Description
See also
- get_bloginfo(): For possible
$show
values
Parameters
$show
stringoptional- Site information to display.
Default:
''
More Information
Displays information about your site, mostly gathered from the information you supply in your User Profile and General Settings WordPress Administration Screens. It can be used anywhere within a template file. This always prints a result to the browser. If you need the values for use in PHP, use get_bloginfo().
Possible values for $show
- ‘name‘ – Displays the “Site Title” set in Settings > General. This data is retrieved from the “blogname” record in the wp_options table.
- ‘description‘ – Displays the “Tagline” set in Settings > General. This data is retrieved from the “blogdescription” record in the wp_options table.
- ‘wpurl‘ – Displays the “WordPress address (URL)” set in Settings > General. This data is retrieved from the “siteurl” record in the wp_options table. Consider echoing site_url() instead, especially for multi-site configurations using paths instead of subdomains (it will return the root site not the current sub-site).
- ‘url‘ – Displays the “Site address (URL)” set in Settings > General. This data is retrieved from the “home” record in the wp_options table. Consider echoing home_url() instead.
- ‘admin_email‘ – Displays the “E-mail address” set in Settings > General. This data is retrieved from the “admin_email” record in the wp_options table.
- ‘charset‘ – Displays the “Encoding for pages and feeds” set in Settings > Reading. This data is retrieved from the “blog_charset” record in the wp_options table. Note: this parameter always echoes “UTF-8”, which is the default encoding of WordPress.
- ‘version‘ – Displays the WordPress Version you use. This data is retrieved from the $wp_version variable set in
wp-includes/version.php
. - ‘html_type‘ – Displays the Content-Type of WordPress HTML pages (default: “text/html”). This data is retrieved from the “html_type” record in the wp_options table. Themes and plugins can override the default value using the pre_option_html_type filter.
- ‘text_direction‘ – Displays the Text Direction of WordPress HTML pages. Consider using is_rtl() instead.
- ‘language‘ – Displays the language of WordPress.
- ‘stylesheet_url‘ – Displays the primary CSS (usually style.css) file URL of the active theme. Consider echoing get_stylesheet_uri() instead.
- ‘stylesheet_directory‘ – Displays the stylesheet directory URL of the active theme. (Was a local path in earlier WordPress versions.) Consider echoing get_stylesheet_directory_uri() instead.
- ‘template_url‘ / ‘template_directory‘ – URL of the active theme’s directory. Within child themes, both get_bloginfo(‘template_url’) and get_template() will return the parent theme directory. Consider echoing get_template_directory_uri() instead (for the parent template directory) or get_stylesheet_directory_uri() (for the child template directory).
- ‘pingback_url‘ – Displays the Pingback XML-RPC file URL (xmlrpc.php).
- ‘atom_url‘ – Displays the Atom feed URL (/feed/atom).
- ‘rdf_url‘ – Displays the RDF/RSS 1.0 feed URL (/feed/rfd).
- ‘rss_url‘ – Displays the RSS 0.92 feed URL (/feed/rss).
- ‘rss2_url‘ – Displays the RSS 2.0 feed URL (/feed).
- ‘comments_atom_url‘ – Displays the comments Atom feed URL (/comments/feed).
- ‘comments_rss2_url‘ – Displays the comments RSS 2.0 feed URL (/comments/feed).
- ‘siteurl‘ – Deprecated since version 2.2. Echo home_url() , or use bloginfo(‘url’).
- ‘home‘ – Deprecated since version 2.2. Echo home_url() , or use bloginfo(‘url’).
Source
function bloginfo( $show = '' ) {
echo get_bloginfo( $show, 'display' );
}
Related
Uses | Description |
---|---|
get_bloginfo()wp-includes/general-template.php | Retrieves information about the current site. |
Used by | Description |
---|---|
WP_REST_Widget_Types_Controller::render_legacy_widget_preview_iframe()wp-includes/rest-api/endpoints/class-wp-rest-widget-types-controller.php | Renders a page containing a preview of the requested Legacy Widget block. |
login_header()wp-login.php | Outputs the login page header. |
_wp_admin_html_begin()wp-admin/includes/template.php | Prints out the beginning of the admin HTML header. |
iframe_header()wp-admin/includes/template.php | Generic Iframe header for use with Thickbox. |
wp_iframe()wp-admin/includes/media.php | Outputs the iframe to display the media upload page. |
Custom_Image_Header::step_1()wp-admin/includes/class-custom-image-header.php | Displays first step of custom header image page. |
Changelog
Version | Description |
---|---|
0.71 | Introduced. |
If using bloginfo as a variable, for example:
$url = bloginfo('url');
it will return null. This is becausebloginfo()
echos the result immediately. So if you want to use any of thebloginfo()
parameters as variables use get_bloginfo(). This function returns the result as a string.Show Blog Title
Display your blog's title in a tag.
Show Blog Description
Displays the tagline of your blog as set in Settings > General.
Show Blog Title in Link
Displays your blog’s title in a link.
Practical example that could be used as it is in themes. Hides description if empty.
Example output
In this example case, the Site Address (URL) is shown as http://www.example.com/home, and the WordPress address (URL) is displayed as http://www.example.com/home/wp.
Please note that directory URLs are missing trailing slashes.
Show Character Set
Displays the character set your blog is using (e.g. “utf-8”).
NOTE: In version 3.5 and later, default character encoding is set to UTF-8 and is not configurable from the Administration Screen.
show website blog name in header