<?php

/**

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

 *

 * @package WordPress

 * @subpackage Template

 */

/**

 * Load header template.

 *

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

 * specialised header will be included.

 *

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

 * "special".

 *

 * @since 1.5.0

 *

 * @param string $name The name of the specialised header.

 */

function get_header( $name = null ) {

	/**

	 * Fires before the header template file is loaded.

	 *

	 * @since 2.1.0

	 * @since 2.8.0 $name parameter added.

	 *

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

	 */

	do_action( 'get_header', $name );

	$templates = array();

	if ( '' !== $name ) {

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

	}

	$templates[] = 'header.php';

	locate_template( $templates, true );

}

/**

 * Load footer template.

 *

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

 * specialised footer will be included.

 *

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

 * "special".

 *

 * @since 1.5.0

 *

 * @param string $name The name of the specialised footer.

 */

function get_footer( $name = null ) {

	/**

	 * Fires before the footer template file is loaded.

	 *

	 * @since 2.1.0

	 * @since 2.8.0 $name parameter added.

	 *

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

	 */

	do_action( 'get_footer', $name );

	$templates = array();

	if ( '' !== $name ) {

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

	}

	locate_template( $templates, true );

}

/**

 * Load sidebar template.

 *

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

 * specialised sidebar will be included.

 *

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

 * "special".

 *

 * @since 1.5.0

 *

 * @param string $name The name of the specialised sidebar.

 */

function get_sidebar( $name = null ) {

	/**

	 * Fires before the sidebar template file is loaded.

	 *

	 * @since 2.2.0

	 * @since 2.8.0 $name parameter added.

	 *

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

	 */

	do_action( 'get_sidebar', $name );

	$templates = array();

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

	$templates[] = 'sidebar.php';

	locate_template( $templates, true );

}

/**

 * 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

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

 *

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

 * @param string $name The name of the specialised template.

 */

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

	/**

	 * 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

	 *

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

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

	 */

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

	$templates = array();

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

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

}

/**

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

 */

	/**

	 * 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

	 *

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

	 */

	do_action( 'pre_get_search_form' );

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

	/**

	 * Filters the HTML format of the search form.

	 *

	 * @since 3.6.0

	 *

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

	 *                       Accepts 'html5', 'xhtml'.

	 */

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

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

	if ( '' != $search_form_template ) {

		ob_start();

		require( $search_form_template );

		$form = ob_get_clean();

	} else {

		if ( 'html5' == $format ) {

				<label>

					<span class="screen-reader-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>

			</form>';

		} else {

				<div>

					<label class="screen-reader-text" for="s">' . _x( 'Search for:', 'label' ) . '</label>

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

				</div>

			</form>';

		}

	}

	/**

	 * Filters the HTML output of the search form.

	 *

	 * @since 2.7.0

	 *

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

	 */

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

		$result = $form;

		echo $result;

		return $result;

}

/**

 * Display 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   $echo     Default to echo and not return the link.

 * @return string|void String when retrieving.

 */

	if ( $echo ) {

		/**

		 * 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().

 */

	$args = array( 'action' => 'logout' );

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

	}

	$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.

 */

	/**

	 * 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 format HTML is echoed by default. Pass a false value for `$echo` to return it instead.

 *

 * @since 3.0.0

 *

 * @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).

 *

 * }

 * @return string|void String when retrieving.

 */

function wp_login_form( $args = array() ) {

	$defaults = array(

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

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

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

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

		'value_username' => '',

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

		'value_remember' => 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 );