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

Description

Compatibility

Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.

Parameters

$showstringoptional

Site info to retrieve. Default empty (site name).Default: ''

$filterstringoptional

How to filter what is retrieved. Default 'raw'.Default: 'raw'

Return value

string

Mostly string values, might be empty.

Code examples

Every example is editable and runs in a real WordPress booted in your browser by WordPress Playground. Press Run, then edit the code: clicking away re-runs it. Nothing is sent anywhere until you do.

$site_name = get_bloginfo( 'name', 'display' );
$tagline   = get_bloginfo( 'description', 'display' );

printf(
	'<a class="site-brand" href="%s">%s</a> <span class="tagline">%s</span>',
	esc_url( home_url( '/' ) ),
	esc_html( $site_name ),
	esc_html( $tagline )
);

Performance profile

How much work a call to get_bloginfo() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.

Cost class

Moderate

Reads stored settings via get_option(), cached per request but not free on a cold cache.

Scaling

Constant

No loop in the body: the same number of instructions runs whatever you pass in.

Instructions

9–89

Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 217.

Plugin surface

2 hooks

Third-party callbacks on 'bloginfo_url', 'bloginfo' run inside this call, and their cost is not bounded by anything here.

Called by

50

50 places in core call this, so the cost is paid more often than your own code shows.

What it touches

• optionoption read or writeget_option()called directly
• hookthird-party callbacksapply_filters()called directly
• cacheobject cachewp_cache_get()one call below get_bloginfo()
• serializeserialisationmaybe_unserialize()one call below get_bloginfo()

Further down the call graph this can also reach query and transient. Those are the worst case, several calls deep and usually down an error path, not what a normal call pays.

What one call costs · 26 distinct outcomes

One number would be a lie: the work depends on which branch runs. These are every distinct cost get_bloginfo() can have, taken from its control-flow graph on PHP 8.5.

Hooks and filters fired · 2

2 hooks fire while get_bloginfo() runs, in this order:

1. 1
   apply_filters( bloginfo_url )filterline 1140 (+122 into the body)

   Filters the URL returned by get_bloginfo().

2. 2
   apply_filters( bloginfo )filterline 1150 (+132 into the body)

   Filters the site information returned by get_bloginfo().

Uses · 13

• _deprecated_argument()Marks a function argument as deprecated and inform when it has been used.
• __()Retrieves the translation of $text.
• home_url()Retrieves the URL for the current site where the front end is accessible.
• site_url()Retrieves the URL for the current site where WordPress application files (e.g. wp-blog-header.php or the wp-admin/ folder) are accessible.
• get_option()Retrieves an option value based on an option name.
• get_feed_link()Retrieves the permalink for the feed type.
• get_stylesheet_uri()Retrieves stylesheet URI for the active theme.
• get_stylesheet_directory_uri()Retrieves stylesheet directory URI for the active theme.
• get_template_directory_uri()Retrieves template directory URI for the active theme.
• determine_locale()Determines the current locale desired for the request.
• is_rtl()Determines whether the current locale is right-to-left (RTL).
• str_contains()Polyfill for `str_contains()` function added in PHP 8.0.

Used by · 50

• TwentyTwenty_Non_Latin_Languages::get_non_latin_css()Gets custom CSS.
• WP::send_headers()Sends additional HTTP headers for caching, content type, etc.
• WP_Automatic_Updater::send_debug_email()Prepares and sends an email of a full log of background update results, useful for debugging and geekery.
• WP_Automatic_Updater::send_email()Sends an email upon the completion or failure of a background core update.
• WP_Customize_Media_Control::to_json()Refresh the parameters passed to the JavaScript via JSON.
• WP_Customize_Nav_Menu_Item_Setting::js_value()Prepares the value for editing on the client.
• WP_Customize_Nav_Menus::customize_register()Adds the customizer settings and controls.
• WP_Customize_Nav_Menus::load_available_items_query()Performs the post_type and taxonomy queries for loading available menu items.
• WP_Customize_Nav_Menus::search_available_items_query()Performs post queries for available-item searching.
• WP_Customize_Panel::json()Gather the parameters passed to client JavaScript via JSON.
• WP_Customize_Section::json()Gather the parameters passed to client JavaScript via JSON.
• WP_Customize_Site_Icon_Control::content_template()Renders a JS template for the content of the site icon control.

Source code

View on Trac ↗View on GitHub ↗

1018function get_bloginfo( $show = '', $filter = 'raw' ) {1019	switch ( $show ) {1020		case 'home':    // Deprecated.1021		case 'siteurl': // Deprecated.1022			_deprecated_argument(1023				__FUNCTION__,1024				'2.2.0',1025				sprintf(1026					/* translators: 1: 'siteurl'/'home' argument, 2: bloginfo() function name, 3: 'url' argument. */1027					__( 'The %1$s option is deprecated for the family of %2$s functions. Use the %3$s option instead.' ),1028					'<code>' . $show . '</code>',1029					'<code>bloginfo()</code>',1030					'<code>url</code>'1031				)1032			);1033			// Intentional fall-through to be handled by the 'url' case.1034		case 'url':1035			$output = home_url();1036			break;1037		case 'wpurl':1038			$output = site_url();1039			break;1040		case 'description':1041			$output = get_option( 'blogdescription' );1042			break;1043		case 'rdf_url':1044			$output = get_feed_link( 'rdf' );1045			break;1046		case 'rss_url':1047			$output = get_feed_link( 'rss' );1048			break;1049		case 'rss2_url':1050			$output = get_feed_link( 'rss2' );1051			break;1052		case 'atom_url':1053			$output = get_feed_link( 'atom' );1054			break;1055		case 'comments_atom_url':1056			$output = get_feed_link( 'comments_atom' );1057			break;1058		case 'comments_rss2_url':1059			$output = get_feed_link( 'comments_rss2' );1060			break;1061		case 'pingback_url':1062			$output = site_url( 'xmlrpc.php' );1063			break;1064		case 'stylesheet_url':1065			$output = get_stylesheet_uri();1066			break;1067		case 'stylesheet_directory':1068			$output = get_stylesheet_directory_uri();1069			break;1070		case 'template_directory':1071		case 'template_url':1072			$output = get_template_directory_uri();1073			break;1074		case 'admin_email':1075			$output = get_option( 'admin_email' );1076			break;1077		case 'charset':1078			$output = get_option( 'blog_charset' );1079			if ( '' === $output ) {1080				$output = 'UTF-8';1081			}1082			break;1083		case 'html_type':1084			$output = get_option( 'html_type' );1085			break;1086		case 'version':1087			global $wp_version;1088			$output = $wp_version;1089			break;1090		case 'language':1091			/*1092			 * translators: Translate this to the correct language tag for your locale,1093			 * see https://www.w3.org/International/articles/language-tags/ for reference.1094			 * Do not translate into your own language.1095			 */1096			$output = __( 'html_lang_attribute' );1097			if ( 'html_lang_attribute' === $output || preg_match( '/[^a-zA-Z0-9-]/', $output ) ) {

Changelog

Introduced in 0.71. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/general-template.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.