<?php

/**

* General template tags that can go anywhere in a template.

*

* @package WordPress

* @subpackage Template

*/

/**

* Loads header template.

*

* Includes the header template for a theme or if a name is specified then a

* specialized header will be included.

*

* For the parameter, if the file is called "header-special.php" then specify

* "special".

*

* @since 1.5.0

* @since 5.5.0 A return value was added.

* @since 5.5.0 The `$args` parameter was added.

*

* @param string|null $name The name of the specialized header. Default null.

* @param array $args Optional. Additional arguments passed to the header template.

* Default empty array.

* @return void|false Void on success, false if the template does not exist.

*/

function get_header( $name = null, $args = array() ) {

/**

* Fires before the header template file is loaded.

*

* @since 2.1.0

* @since 2.8.0 The `$name` parameter was added.

* @since 5.5.0 The `$args` parameter was added.

*

* @param string|null $name Name of the specific header file to use. Null for the default header.

* @param array $args Additional arguments passed to the header template.

*/

do_action( 'get_header', $name, $args );

$templates = array();

$name = (string) $name;

if ( '' !== $name ) {

$templates[] = "header-{$name}.php";

}

$templates[] = 'header.php';

if ( ! locate_template( $templates, true, true, $args ) ) {

return false;

}

}

/**

* Loads footer template.

*

* Includes the footer template for a theme or if a name is specified then a

* specialized footer will be included.

*

* For the parameter, if the file is called "footer-special.php" then specify

* "special".

*

* @since 1.5.0

* @since 5.5.0 A return value was added.

* @since 5.5.0 The `$args` parameter was added.

*

* @param string|null $name The name of the specialized footer. Default null.

* @param array $args Optional. Additional arguments passed to the footer template.

* Default empty array.

* @return void|false Void on success, false if the template does not exist.

*/

function get_footer( $name = null, $args = array() ) {

/**

* Fires before the footer template file is loaded.

*

* @since 2.1.0

* @since 2.8.0 The `$name` parameter was added.

* @since 5.5.0 The `$args` parameter was added.

*

* @param string|null $name Name of the specific footer file to use. Null for the default footer.

* @param array $args Additional arguments passed to the footer template.

*/

do_action( 'get_footer', $name, $args );

$templates = array();

$name = (string) $name;

if ( '' !== $name ) {

$templates[] = "footer-{$name}.php";

}

$templates[] = 'footer.php';

if ( ! locate_template( $templates, true, true, $args ) ) {

return false;

}

}

/**

* Loads sidebar template.

*

* Includes the sidebar template for a theme or if a name is specified then a

* specialized sidebar will be included.

*

* For the parameter, if the file is called "sidebar-special.php" then specify

* "special".

*

* @since 1.5.0

* @since 5.5.0 A return value was added.

* @since 5.5.0 The `$args` parameter was added.

*

* @param string|null $name The name of the specialized sidebar. Default null.

* @param array $args Optional. Additional arguments passed to the sidebar template.

* Default empty array.

* @return void|false Void on success, false if the template does not exist.

*/

function get_sidebar( $name = null, $args = array() ) {

/**

* Fires before the sidebar template file is loaded.

*

* @since 2.2.0

* @since 2.8.0 The `$name` parameter was added.

* @since 5.5.0 The `$args` parameter was added.

*

* @param string|null $name Name of the specific sidebar file to use. Null for the default sidebar.

* @param array $args Additional arguments passed to the sidebar template.

*/

do_action( 'get_sidebar', $name, $args );

$templates = array();

$name = (string) $name;

if ( '' !== $name ) {

$templates[] = "sidebar-{$name}.php";

}

$templates[] = 'sidebar.php';

if ( ! locate_template( $templates, true, true, $args ) ) {

return false;

}

}

/**

* Loads a template part into a template.

*

* Provides a simple mechanism for child themes to overload reusable sections of code

* in the theme.

*

* Includes the named template part for a theme or if a name is specified then a

* specialized part will be included. If the theme contains no {slug}.php file

* then no template will be included.

*

* The template is included using require, not require_once, so you may include the

* same template part multiple times.

*

* For the $name parameter, if the file is called "{slug}-special.php" then specify

* "special".

*

* @since 3.0.0

* @since 5.5.0 A return value was added.

* @since 5.5.0 The `$args` parameter was added.

*

* @param string $slug The slug name for the generic template.

* @param string|null $name Optional. The name of the specialized template. Default null.

* @param array $args Optional. Additional arguments passed to the template.

* Default empty array.

* @return void|false Void on success, false if the template does not exist.

*/

function get_template_part( $slug, $name = null, $args = array() ) {

/**

* Fires before the specified template part file is loaded.

*

* The dynamic portion of the hook name, `$slug`, refers to the slug name

* for the generic template part.

*

* @since 3.0.0

* @since 5.5.0 The `$args` parameter was added.

*

* @param string $slug The slug name for the generic template.

* @param string|null $name The name of the specialized template

* or null if there is none.

* @param array $args Additional arguments passed to the template.

*/

do_action( "get_template_part_{$slug}", $slug, $name, $args );

$templates = array();

$name = (string) $name;

if ( '' !== $name ) {

$templates[] = "{$slug}-{$name}.php";

}

$templates[] = "{$slug}.php";

/**

* Fires before an attempt is made to locate and load a template part.

*

* @since 5.2.0

* @since 5.5.0 The `$args` parameter was added.

*

* @param string $slug The slug name for the generic template.

* @param string $name The name of the specialized template

* or an empty string if there is none.

* @param string[] $templates Array of template files to search for, in order.

* @param array $args Additional arguments passed to the template.

*/

do_action( 'get_template_part', $slug, $name, $templates, $args );

if ( ! locate_template( $templates, true, false, $args ) ) {

return false;

}

}

/**

* Displays search form.

*

* Will first attempt to locate the searchform.php file in either the child or

* the parent, then load it. If it doesn't exist, then the default search form

* will be displayed. The default search form is HTML, which will be displayed.

* There is a filter applied to the search form HTML in order to edit or replace

* it. The filter is {@see 'get_search_form'}.

*

* This function is primarily used by themes which want to hardcode the search

* form into the sidebar and also by the search widget in WordPress.

*

* There is also an action that is called whenever the function is run called,

* {@see 'pre_get_search_form'}. This can be useful for outputting JavaScript that the

* search relies on or various formatting that applies to the beginning of the

* search. To give a few examples of what it can be used for.

*

* @since 2.7.0

* @since 5.2.0 The `$args` array parameter was added in place of an `$echo` boolean flag.

*

* @param array $args {

* Optional. Array of display arguments.

*

* @type bool $echo Whether to echo or return the form. Default true.

* @type string $aria_label ARIA label for the search form. Useful to distinguish

* multiple search forms on the same page and improve

* accessibility. Default empty.

* }

* @return void|string Void if 'echo' argument is true, search form HTML if 'echo' is false.

*/

function get_search_form( $args = array() ) {

/**

* Fires before the search form is retrieved, at the start of get_search_form().

*

* @since 2.7.0 as 'get_search_form' action.

* @since 3.6.0

* @since 5.5.0 The `$args` parameter was added.

*

* @link https://core.trac.wordpress.org/ticket/19321

*

* @param array $args The array of arguments for building the search form.

* See get_search_form() for information on accepted arguments.

*/

do_action( 'pre_get_search_form', $args );

$echo = true;

if ( ! is_array( $args ) ) {

/*

* Back compat: to ensure previous uses of get_search_form() continue to

* function as expected, we handle a value for the boolean $echo param removed

* in 5.2.0. Then we deal with the $args array and cast its defaults.

*/

$echo = (bool) $args;

// Set an empty array and allow default arguments to take over.

$args = array();

}

// Defaults are to echo and to output no custom label on the form.

$defaults = array(

'echo' => $echo,

'aria_label' => '',

);

$args = wp_parse_args( $args, $defaults );

/**

* Filters the array of arguments used when generating the search form.

*

* @since 5.2.0

*

* @param array $args The array of arguments for building the search form.

* See get_search_form() for information on accepted arguments.

*/

$args = apply_filters( 'search_form_args', $args );

// Ensure that the filtered arguments contain all required default values.

$args = array_merge( $defaults, $args );

$format = current_theme_supports( 'html5', 'search-form' ) ? 'html5' : 'xhtml';

/**

* Filters the HTML format of the search form.

*

* @since 3.6.0

* @since 5.5.0 The `$args` parameter was added.

*

* @param string $format The type of markup to use in the search form.

* Accepts 'html5', 'xhtml'.

* @param array $args The array of arguments for building the search form.

* See get_search_form() for information on accepted arguments.

*/

$format = apply_filters( 'search_form_format', $format, $args );

$search_form_template = locate_template( 'searchform.php' );

if ( '' !== $search_form_template ) {

ob_start();

require $search_form_template;

$form = ob_get_clean();

} else {

// Build a string containing an aria-label to use for the search form.

if ( $args['aria_label'] ) {

$aria_label = 'aria-label="' . esc_attr( $args['aria_label'] ) . '" ';

} else {

/*

* If there's no custom aria-label, we can set a default here. At the

* moment it's empty as there's uncertainty about what the default should be.

*/

$aria_label = '';

}

if ( 'html5' === $format ) {

$form = '<form role="search" ' . $aria_label . 'method="get" class="search-form" action="' . esc_url( home_url( '/' ) ) . '">

<label>

<span class="screen-reader-text">' .

/* translators: Hidden accessibility text. */

_x( 'Search for:', 'label' ) .

'</span>

<input type="search" class="search-field" placeholder="' . esc_attr_x( 'Search &hellip;', 'placeholder' ) . '" value="' . get_search_query() . '" name="s" />

</label>

<input type="submit" class="search-submit" value="' . esc_attr_x( 'Search', 'submit button' ) . '" />

</form>';

} else {

$form = '<form role="search" ' . $aria_label . 'method="get" id="searchform" class="searchform" action="' . esc_url( home_url( '/' ) ) . '">

<div>

<label class="screen-reader-text" for="s">' .

/* translators: Hidden accessibility text. */

_x( 'Search for:', 'label' ) .

'</label>

<input type="text" value="' . get_search_query() . '" name="s" id="s" />

<input type="submit" id="searchsubmit" value="' . esc_attr_x( 'Search', 'submit button' ) . '" />

</div>

</form>';

}

}

/**

* Filters the HTML output of the search form.

*

* @since 2.7.0

* @since 5.5.0 The `$args` parameter was added.

*

* @param string $form The search form HTML output.

* @param array $args The array of arguments for building the search form.

* See get_search_form() for information on accepted arguments.

*/

$result = apply_filters( 'get_search_form', $form, $args );

if ( null === $result ) {

$result = $form;

}

if ( $args['echo'] ) {

echo $result;

} else {

return $result;

}

}

/**

* Displays the Log In/Out link.

*

* Displays a link, which allows users to navigate to the Log In page to log in

* or log out depending on whether they are currently logged in.

*

* @since 1.5.0

*

* @param string $redirect Optional path to redirect to on login/logout.

* @param bool $display Default to echo and not return the link.

* @return void|string Void if `$display` argument is true, log in/out link if `$display` is false.

*/

function wp_loginout( $redirect = '', $display = true ) {

if ( ! is_user_logged_in() ) {

$link = '<a href="' . esc_url( wp_login_url( $redirect ) ) . '">' . __( 'Log in' ) . '</a>';

} else {

$link = '<a href="' . esc_url( wp_logout_url( $redirect ) ) . '">' . __( 'Log out' ) . '</a>';

}

if ( $display ) {

/**

* Filters the HTML output for the Log In/Log Out link.

*

* @since 1.5.0

*

* @param string $link The HTML link content.

*/

echo apply_filters( 'loginout', $link );

} else {

/** This filter is documented in wp-includes/general-template.php */

return apply_filters( 'loginout', $link );

}

}

/**

* Retrieves the logout URL.

*

* Returns the URL that allows the user to log out of the site.

*

* @since 2.7.0

*

* @param string $redirect Path to redirect to on logout.

* @return string The logout URL. Note: HTML-encoded via esc_html() in wp_nonce_url().

*/

function wp_logout_url( $redirect = '' ) {

$args = array();

if ( ! empty( $redirect ) ) {

$args['redirect_to'] = urlencode( $redirect );

}

$logout_url = add_query_arg( $args, site_url( 'wp-login.php?action=logout', 'login' ) );

$logout_url = wp_nonce_url( $logout_url, 'log-out' );

/**

* Filters the logout URL.

*

* @since 2.8.0

*

* @param string $logout_url The HTML-encoded logout URL.

* @param string $redirect Path to redirect to on logout.

*/

return apply_filters( 'logout_url', $logout_url, $redirect );

}

/**

* Retrieves the login URL.

*

* @since 2.7.0

*

* @param string $redirect Path to redirect to on log in.

* @param bool $force_reauth Whether to force reauthorization, even if a cookie is present.

* Default false.

* @return string The login URL. Not HTML-encoded.

*/

function wp_login_url( $redirect = '', $force_reauth = false ) {

$login_url = site_url( 'wp-login.php', 'login' );

if ( ! empty( $redirect ) ) {

$login_url = add_query_arg( 'redirect_to', urlencode( $redirect ), $login_url );

}

if ( $force_reauth ) {

$login_url = add_query_arg( 'reauth', '1', $login_url );

}

/**

* Filters the login URL.

*

* @since 2.8.0

* @since 4.2.0 The `$force_reauth` parameter was added.

*

* @param string $login_url The login URL. Not HTML-encoded.

* @param string $redirect The path to redirect to on login, if supplied.

* @param bool $force_reauth Whether to force reauthorization, even if a cookie is present.

*/

return apply_filters( 'login_url', $login_url, $redirect, $force_reauth );

}

/**

* Returns the URL that allows the user to register on the site.

*

* @since 3.6.0

*

* @return string User registration URL.

*/

function wp_registration_url() {

/**

* Filters the user registration URL.

*

* @since 3.6.0

*

* @param string $register The user registration URL.

*/

return apply_filters( 'register_url', site_url( 'wp-login.php?action=register', 'login' ) );

}

/**

* Provides a simple login form for use anywhere within WordPress.

*

* The login form HTML is echoed by default. Pass a false value for `$echo` to return it instead.

*

* @since 3.0.0

* @since 6.6.0 Added `required_username` and `required_password` arguments.

*

* @param array $args {

* Optional. Array of options to control the form output. Default empty array.

*

* @type bool $echo Whether to display the login form or return the form HTML code.

* Default true (echo).

* @type string $redirect URL to redirect to. Must be absolute, as in "https://example.com/mypage/".

* Default is to redirect back to the request URI.

* @type string $form_id ID attribute value for the form. Default 'loginform'.

* @type string $label_username Label for the username or email address field. Default 'Username or Email Address'.

* @type string $label_password Label for the password field. Default 'Password'.

* @type string $label_remember Label for the remember field. Default 'Remember Me'.

* @type string $label_log_in Label for the submit button. Default 'Log In'.

* @type string $id_username ID attribute value for the username field. Default 'user_login'.

* @type string $id_password ID attribute value for the password field. Default 'user_pass'.

* @type string $id_remember ID attribute value for the remember field. Default 'rememberme'.

* @type string $id_submit ID attribute value for the submit button. Default 'wp-submit'.

* @type bool $remember Whether to display the "rememberme" checkbox in the form.

* @type string $value_username Default value for the username field. Default empty.

* @type bool $value_remember Whether the "Remember Me" checkbox should be checked by default.

* Default false (unchecked).

* @type bool $required_username Whether the username field has the 'required' attribute.

* Default false.

* @type bool $required_password Whether the password field has the 'required' attribute.

* Default false.

*

* }

* @return void|string Void if 'echo' argument is true, login form HTML if 'echo' is false.

*/

function wp_login_form( $args = array() ) {

$defaults = array(

'echo' => true,

// Default 'redirect' value takes the user back to the request URI.

'redirect' => ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'],

'form_id' => 'loginform',

'label_username' => __( 'Username or Email Address' ),

'label_password' => __( 'Password' ),

'label_remember' => __( 'Remember Me' ),

'label_log_in' => __( 'Log In' ),

'id_username' => 'user_login',

'id_password' => 'user_pass',

'id_remember' => 'rememberme',

'id_submit' => 'wp-submit',

'remember' => true,

'value_username' => '',

// Set 'value_remember' to true to default the "Remember me" checkbox to checked.

'value_remember' => false,

// Set 'required_username' to true to add the required attribute to username field.

'required_username' => false,

// Set 'required_password' to true to add the required attribute to password field.

'required_password' => false,

);

/**

* Filters the default login form output arguments.

*

* @since 3.0.0

*

* @see wp_login_form()

*

* @param array $defaults An array of default login form arguments.

*/

$args = wp_parse_args( $args, apply_filters( 'login_form_defaults', $defaults ) );

/**

* Filters content to display at the top of the login form.

*

* The filter evaluates just following the opening form tag element.

*

* @since 3.0.0

*

* @param string $content Content to display. Default empty.

* @param array $args Array of login form arguments.

*/

$login_form_top = apply_filters( 'login_form_top', '', $args );

/**

* Filters content to display in the middle of the login form.

*

* The filter evaluates just following the location where the 'login-password'

* field is displayed.

*

* @since 3.0.0

*

* @param string $content Content to display. Default empty.

* @param array $args Array of login form arguments.

*/

$login_form_middle = apply_filters( 'login_form_middle', '', $args );

/**

* Filters content to display at the bottom of the login form.

*

* The filter evaluates just preceding the closing form tag element.

*

* @since 3.0.0

*

* @param string $content Content to display. Default empty.

* @param array $args Array of login form arguments.

*/

$login_form_bottom = apply_filters( 'login_form_bottom', '', $args );

$form =

sprintf(

'<form name="%1$s" id="%1$s" action="%2$s" method="post">',

esc_attr( $args['form_id'] ),

esc_url( site_url( 'wp-login.php', 'login_post' ) )

) .

$login_form_top .

sprintf(

'<p class="login-username">

<label for="%1$s">%2$s</label>

<input type="text" name="log" id="%1$s" autocomplete="username" class="input" value="%3$s" size="20"%4$s />

</p>',

esc_attr( $args['id_username'] ),

esc_html( $args['label_username'] ),

esc_attr( $args['value_username'] ),

( $args['required_username'] ? ' required="required"' : '' )

) .

sprintf(

'<p class="login-password">

<label for="%1$s">%2$s</label>

<input type="password" name="pwd" id="%1$s" autocomplete="current-password" spellcheck="false" class="input" value="" size="20"%3$s />

</p>',

esc_attr( $args['id_password'] ),

esc_html( $args['label_password'] ),

( $args['required_password'] ? ' required="required"' : '' )

) .

$login_form_middle .

( $args['remember'] ?

sprintf(

'<p class="login-remember"><label><input name="rememberme" type="checkbox" id="%1$s" value="forever"%2$s /> %3$s</label></p>',

esc_attr( $args['id_remember'] ),

( $args['value_remember'] ? ' checked="checked"' : '' ),

esc_html( $args['label_remember'] )

) : ''

) .

sprintf(

'<p class="login-submit">

<input type="submit" name="wp-submit" id="%1$s" class="button button-primary" value="%2$s" />

<input type="hidden" name="redirect_to" value="%3$s" />

</p>',

esc_attr( $args['id_submit'] ),

esc_attr( $args['label_log_in'] ),

esc_url( $args['redirect'] )

) .

$login_form_bottom .

'</form>';

if ( $args['echo'] ) {

echo $form;

} else {

return $form;

}

}

/**

* Returns the URL that allows the user to reset the lost password.

*

* @since 2.8.0

*

* @param string $redirect Path to redirect to on login.

* @return string Lost password URL.

*/

function wp_lostpassword_url( $redirect = '' ) {

$args = array(

'action' => 'lostpassword',

);

if ( ! empty( $redirect ) ) {

$args['redirect_to'] = urlencode( $redirect );

}

if ( is_multisite() ) {

$blog_details = get_site();

$wp_login_path = $blog_details->path . 'wp-login.php';

} else {

$wp_login_path = 'wp-login.php';

}

$lostpassword_url = add_query_arg( $args, network_site_url( $wp_login_path, 'login' ) );

/**

* Filters the Lost Password URL.

*

* @since 2.8.0

*

* @param string $lostpassword_url The lost password page URL.

* @param string $redirect The path to redirect to on login.

*/

return apply_filters( 'lostpassword_url', $lostpassword_url, $redirect );

}

/**

* Displays the Registration or Admin link.

*

* Display a link which allows the user to navigate to the registration page if

* not logged in and registration is enabled or to the dashboard if logged in.

*

* @since 1.5.0

*

* @param string $before Text to output before the link. Default `<li>`.

* @param string $after Text to output after the link. Default `</li>`.

* @param bool $display Default to echo and not return the link.

* @return void|string Void if `$display` argument is true, registration or admin link

* if `$display` is false.

*/

function wp_register( $before = '<li>', $after = '</li>', $display = true ) {

if ( ! is_user_logged_in() ) {

if ( get_option( 'users_can_register' ) ) {

$link = $before . '<a href="' . esc_url( wp_registration_url() ) . '">' . __( 'Register' ) . '</a>' . $after;

} else {

$link = '';

}

} elseif ( current_user_can( 'read' ) ) {

$link = $before . '<a href="' . admin_url() . '">' . __( 'Site Admin' ) . '</a>' . $after;

} else {

$link = '';

}

/**

* Filters the HTML link to the Registration or Admin page.

*

* Users are sent to the admin page if logged-in, or the registration page

* if enabled and logged-out.

*

* @since 1.5.0

*

* @param string $link The HTML code for the link to the Registration or Admin page.

*/

$link = apply_filters( 'register', $link );

if ( $display ) {

echo $link;

} else {

return $link;

}

}

/**

* Theme container function for the 'wp_meta' action.

*

* The {@see 'wp_meta'} action can have several purposes, depending on how you use it,

* but one purpose might have been to allow for theme switching.

*

* @since 1.5.0

*

* @link https://core.trac.wordpress.org/ticket/1458 Explanation of 'wp_meta' action.

*/

function wp_meta() {

/**

* Fires before displaying echoed content in the sidebar.

*

* @since 1.5.0

*/

do_action( 'wp_meta' );

}

/**

* Displays information about the current site.

*

* @since 0.71

*

* @see get_bloginfo() For possible `$show` values

*

* @param string $show Optional. Site information to display. Default empty.

*/

function bloginfo( $show = '' ) {

echo get_bloginfo( $show, 'display' );

}

/**

* 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 {@see '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

*

* @since 0.71

*

* @global string $wp_version The WordPress version string.

*

* @param string $show Optional. Site info to retrieve. Default empty (site name).

* @param string $filter Optional. How to filter what is retrieved. Default 'raw'.

* @return string Mostly string values, might be empty.

*/

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;

}

if ( 'display' === $filter ) {

if (

str_contains( $show, 'url' )

|| str_contains( $show, 'directory' )

|| str_contains( $show, 'home' )

) {

/**

* 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;

}

/**

* Returns the Site Icon URL.

*

* @since 4.3.0

*

* @param int $size Optional. Size of the site icon. Default 512 (pixels).

* @param string $url Optional. Fallback url if no site icon is found. Default empty.

* @param int $blog_id Optional. ID of the blog to get the site icon for. Default current blog.

* @return string Site Icon URL.

*/

function get_site_icon_url( $size = 512, $url = '', $blog_id = 0 ) {

$switched_blog = false;

if ( is_multisite() && ! empty( $blog_id ) && get_current_blog_id() !== (int) $blog_id ) {

switch_to_blog( $blog_id );

$switched_blog = true;

}

$site_icon_id = (int) get_option( 'site_icon' );

if ( $site_icon_id ) {

if ( $size >= 512 ) {

$size_data = 'full';

} else {

$size_data = array( $size, $size );

}

$url = wp_get_attachment_image_url( $site_icon_id, $size_data );

}

if ( $switched_blog ) {

restore_current_blog();

}

/**

* Filters the site icon URL.

*

* @since 4.4.0

*

* @param string $url Site icon URL.

* @param int $size Size of the site icon.

* @param int $blog_id ID of the blog to get the site icon for.

*/

return apply_filters( 'get_site_icon_url', $url, $size, $blog_id );

}

/**

* Displays the Site Icon URL.

*

* @since 4.3.0

*