understrap/header.php

<?php
/**
 * The header for our theme
 *
 * Displays all of the <head> section and everything up till <div id="content">
 *
 * @package understrap
 */

// Exit if accessed directly.
defined( 'ABSPATH' ) || exit;

$container = get_theme_mod( 'understrap_container_type' );
?>
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
	<meta charset="<?php bloginfo( 'charset' ); ?>">
	<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
	<link rel="profile" href="http://gmpg.org/xfn/11">
	<?php wp_head(); ?>
</head>

<body <?php body_class(); ?> <?php understrap_body_attributes(); ?>>
<?php do_action( 'wp_body_open' ); ?>
<div class="site" id="page">

	<!-- ******************* The Navbar Area ******************* -->
	<div id="wrapper-navbar">

		<a class="skip-link sr-only sr-only-focusable" href="#content"><?php esc_html_e( 'Skip to content', 'understrap' ); ?></a>

		<nav id="main-nav" class="navbar fixed-top navbar-expand-md navbar-light bg-light" aria-labelledby="main-nav-label">

			<h2 id="main-nav-label" class="sr-only">
				<?php esc_html_e( 'Main Navigation', 'understrap' ); ?>
			</h2>

		<?php if ( 'container' === $container ) : ?>
			<div class="container">
		<?php endif; ?>

					<!-- Your site title as branding in the menu -->
					<?php if ( ! has_custom_logo() ) { ?>

						<?php if ( is_front_page() && is_home() ) : ?>

							<h1 class="navbar-brand mb-0"><a rel="home" href="<?php echo esc_url( home_url( '/' ) ); ?>" title="<?php echo esc_attr( get_bloginfo( 'name', 'display' ) ); ?>" itemprop="url"><?php bloginfo( 'name' ); ?></a></h1>

						<?php else : ?>

							<a class="navbar-brand" rel="home" href="<?php echo esc_url( home_url( '/' ) ); ?>" title="<?php echo esc_attr( get_bloginfo( 'name', 'display' ) ); ?>" itemprop="url"><?php bloginfo( 'name' ); ?></a>

						<?php endif; ?>

						<?php
					} else {
						the_custom_logo();
					}
					?>
					<!-- end custom logo -->

				<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNavDropdown" aria-controls="navbarNavDropdown" aria-expanded="false" aria-label="<?php esc_attr_e( 'Toggle navigation', 'understrap' ); ?>">
					<span class="navbar-toggler-icon"></span>
				</button>

				<!-- The WordPress Menu goes here -->
				<?php
				wp_nav_menu(
					array(
						'theme_location'  => 'primary',
						'container_class' => 'collapse navbar-collapse',
						'container_id'    => 'navbarNavDropdown',
						'menu_class'      => 'navbar-nav ml-auto',
						'fallback_cb'     => '',
						'menu_id'         => 'main-menu',
						'depth'           => 2,
						'walker'          => new Understrap_WP_Bootstrap_Navwalker(),
					)
				);
				?>
			<?php if ( 'container' === $container ) : ?>
			</div><!-- .container -->
			<?php endif; ?>

		</nav><!-- .site-navigation -->

	</div><!-- #wrapper-navbar end -->
initial comit 2014-12-10 11:36:38 +00:00			`<?php`
			`/**`
No period for summary in file headers According to WP's PHP documentation standards on file headers. See https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#6-file-headers. 2019-11-14 17:16:31 +00:00			`* The header for our theme`
initial comit 2014-12-10 11:36:38 +00:00			`*`
			`* Displays all of the <head> section and everything up till <div id="content">`
			`*`
			`* @package understrap`
			`*/`
fix undefined variable issue in header and footer 2016-11-15 11:09:46 +00:00
Use shorter ABSPATH check 2019-06-20 08:57:12 +00:00			`// Exit if accessed directly.`
			`defined( 'ABSPATH' ) \|\| exit;`
Prevent direct access 2018-09-10 21:59:04 +00:00
root files code format 2016-11-21 18:47:05 +00:00			`$container = get_theme_mod( 'understrap_container_type' );`
			`?>`
Update HTML indents to soft tabs (2 spaces) 2016-11-01 15:25:21 +00:00			`<!DOCTYPE html>`
initial comit 2014-12-10 11:36:38 +00:00			`<html <?php language_attributes(); ?>>`
			`<head>`
root files code format 2016-11-21 18:47:05 +00:00			`<meta charset="<?php bloginfo( 'charset' ); ?>">`
update Responsive meta tag for BS4 recc [BS4 Reference](https://getbootstrap.com/docs/4.0/getting-started/introduction/#responsive-meta-tag) 2017-08-14 03:49:16 +00:00			`<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">`
root files code format 2016-11-21 18:47:05 +00:00			`<link rel="profile" href="http://gmpg.org/xfn/11">`
			`<?php wp_head(); ?>`
initial comit 2014-12-10 11:36:38 +00:00			`</head>`

Add understrap_body_attributes() Function to display attributes for the body element. Attributes may be added via the filter `understrap_body_attributes` 2019-12-03 07:15:46 +00:00			`<body <?php body_class(); ?> <?php understrap_body_attributes(); ?>>`
Improve code simplicity It is sufficient to call the `do_action( 'wp_body_open' )` directly instead of the wrapper. See https://make.wordpress.org/themes/2019/03/29/addition-of-new-wp_body_open-hook/#comment-43714 2019-05-03 06:33:40 +00:00			`<?php do_action( 'wp_body_open' ); ?>`
Remove default class hfeed The class `hfeed` is correctly added to non-singular pages only via the `understrap_body_classes` filter and should not be present on each page regardless of whether it is a feed or not. 2018-10-12 14:32:32 +00:00			`<div class="site" id="page">`
Update HTML indents to soft tabs (2 spaces) 2016-11-01 15:25:21 +00:00
root files code format 2016-11-21 18:47:05 +00:00			`<!-- ***************** The Navbar Area ***************** -->`
Move schema markup to body element Removes schema markup from the div#wrapper-navbar element. Re-adds the schema markup on the body element via filter. 2019-12-03 07:19:45 +00:00			`<div id="wrapper-navbar">`
initial comit 2014-12-10 11:36:38 +00:00
Focusable 'Skip to content' * make 'Skip to content' focusable for sighted keyboard users * .sr-only makes .screen-reader-text obsolete 2018-09-02 17:30:14 +00:00			`<a class="skip-link sr-only sr-only-focusable" href="#content"><?php esc_html_e( 'Skip to content', 'understrap' ); ?></a>`
adding .row to header/footer 2015-08-12 15:21:46 +00:00
fixed header by default 2020-05-08 12:40:03 +00:00			`<nav id="main-nav" class="navbar fixed-top navbar-expand-md navbar-light bg-light" aria-labelledby="main-nav-label">`
Use heading instead of aria-label See #1063 for a discussion 2019-12-03 07:50:22 +00:00
Add aria-labelledby 2019-12-13 07:26:10 +00:00			`<h2 id="main-nav-label" class="sr-only">`
Use heading instead of aria-label See #1063 for a discussion 2019-12-03 07:50:22 +00:00			`<?php esc_html_e( 'Main Navigation', 'understrap' ); ?>`
			`</h2>`
initial comit 2014-12-10 11:36:38 +00:00
Use strict comparison 2019-11-12 07:56:12 +00:00			`<?php if ( 'container' === $container ) : ?>`
Remove superfluous space 2019-01-04 09:50:50 +00:00			`<div class="container">`
fixing .container-fluid in navbar bug 2017-01-19 10:29:07 +00:00			`<?php endif; ?>`
adding a container around the navbar 2017-01-06 19:30:34 +00:00
root files code format 2016-11-21 18:47:05 +00:00			`<!-- Your site title as branding in the menu -->`
			`<?php if ( ! has_custom_logo() ) { ?>`
Adding h1 markup to navbar-brand on front/homepage 2017-01-24 07:47:53 +00:00
			`<?php if ( is_front_page() && is_home() ) : ?>`

Fixes invalid code due to WP´s itemprop insertion See https://github.com/holger1411/understrap/issues/578 for explanation. 2018-03-02 16:27:12 +00:00			`<h1 class="navbar-brand mb-0"><a rel="home" href="<?php echo esc_url( home_url( '/' ) ); ?>" title="<?php echo esc_attr( get_bloginfo( 'name', 'display' ) ); ?>" itemprop="url"><?php bloginfo( 'name' ); ?></a></h1>`
Swap customized walker to latest upstream wp-bootstrap-navwalker class 2018-04-16 21:28:31 +00:00
Adding h1 markup to navbar-brand on front/homepage 2017-01-24 07:47:53 +00:00			`<?php else : ?>`

Fixes invalid code due to WP´s itemprop insertion See https://github.com/holger1411/understrap/issues/578 for explanation. 2018-03-02 16:27:12 +00:00			`<a class="navbar-brand" rel="home" href="<?php echo esc_url( home_url( '/' ) ); ?>" title="<?php echo esc_attr( get_bloginfo( 'name', 'display' ) ); ?>" itemprop="url"><?php bloginfo( 'name' ); ?></a>`
Swap customized walker to latest upstream wp-bootstrap-navwalker class 2018-04-16 21:28:31 +00:00
Adding h1 markup to navbar-brand on front/homepage 2017-01-24 07:47:53 +00:00			`<?php endif; ?>`
Swap customized walker to latest upstream wp-bootstrap-navwalker class 2018-04-16 21:28:31 +00:00
Fix WPCS errors and warnings + escaping Fixes many WPCS errors and warnings Also: * Partly removes excessive php opening/closing tags. * Uses printf for better readability in loop-templates/content-none.php. * Adds understrap_kses_title() to escape post titles. * Adds understrap_escape_the_archive_description() to escape the archive description. * Fixes missing '__' after esc_html in author.php. * Updates the phpcs.xml to reflect all the changes. * Updates composer dependencies and scripts. 2020-04-19 10:08:39 +00:00			`<?php`
			`} else {`
root files code format 2016-11-21 18:47:05 +00:00			`the_custom_logo();`
Fix WPCS errors and warnings + escaping Fixes many WPCS errors and warnings Also: * Partly removes excessive php opening/closing tags. * Uses printf for better readability in loop-templates/content-none.php. * Adds understrap_kses_title() to escape post titles. * Adds understrap_escape_the_archive_description() to escape the archive description. * Fixes missing '__' after esc_html in author.php. * Updates the phpcs.xml to reflect all the changes. * Updates composer dependencies and scripts. 2020-04-19 10:08:39 +00:00			`}`
			`?>`
			`<!-- end custom logo -->`
adding off canvas widget 2014-12-19 09:04:55 +00:00
Make aria-label translatable Content of aria-label may get read out loud and thus should be translatable. 2018-08-20 16:56:15 +00:00			`<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNavDropdown" aria-controls="navbarNavDropdown" aria-expanded="false" aria-label="<?php esc_attr_e( 'Toggle navigation', 'understrap' ); ?>">`
Moving hamburger toggle to the right 2017-08-18 07:52:07 +00:00			`<span class="navbar-toggler-icon"></span>`
			`</button>`

root files code format 2016-11-21 18:47:05 +00:00			`<!-- The WordPress Menu goes here -->`
Fix WPCS errors and warnings + escaping Fixes many WPCS errors and warnings Also: * Partly removes excessive php opening/closing tags. * Uses printf for better readability in loop-templates/content-none.php. * Adds understrap_kses_title() to escape post titles. * Adds understrap_escape_the_archive_description() to escape the archive description. * Fixes missing '__' after esc_html in author.php. * Updates the phpcs.xml to reflect all the changes. * Updates composer dependencies and scripts. 2020-04-19 10:08:39 +00:00			`<?php`
			`wp_nav_menu(`
root files code format 2016-11-21 18:47:05 +00:00			`array(`
			`'theme_location' => 'primary',`
Changing menu markup to alpha6 2017-01-06 18:51:53 +00:00			`'container_class' => 'collapse navbar-collapse',`
rechecking 2017-01-06 19:09:14 +00:00			`'container_id' => 'navbarNavDropdown',`
Moving nabber to the right by default 2018-07-03 06:44:04 +00:00			`'menu_class' => 'navbar-nav ml-auto',`
root files code format 2016-11-21 18:47:05 +00:00			`'fallback_cb' => '',`
			`'menu_id' => 'main-menu',`
Swap customized walker to latest upstream wp-bootstrap-navwalker class 2018-04-16 21:28:31 +00:00			`'depth' => 2,`
Modify walker with 'understarp' prefixed on class name and as textdomain 2018-04-17 16:10:40 +00:00			`'walker' => new Understrap_WP_Bootstrap_Navwalker(),`
root files code format 2016-11-21 18:47:05 +00:00			`)`
Fix WPCS errors and warnings + escaping Fixes many WPCS errors and warnings Also: * Partly removes excessive php opening/closing tags. * Uses printf for better readability in loop-templates/content-none.php. * Adds understrap_kses_title() to escape post titles. * Adds understrap_escape_the_archive_description() to escape the archive description. * Fixes missing '__' after esc_html in author.php. * Updates the phpcs.xml to reflect all the changes. * Updates composer dependencies and scripts. 2020-04-19 10:08:39 +00:00			`);`
			`?>`
Use strict comparison 2019-11-12 07:56:12 +00:00			`<?php if ( 'container' === $container ) : ?>`
adding a container around the navbar 2017-01-06 19:30:34 +00:00			`</div><!-- .container -->`
fixing .container-fluid in navbar bug 2017-01-19 10:29:07 +00:00			`<?php endif; ?>`
adding off canvas widget 2014-12-19 09:04:55 +00:00
root files code format 2016-11-21 18:47:05 +00:00			`</nav><!-- .site-navigation -->`
adding off canvas widget 2014-12-19 09:04:55 +00:00
Remove unnecessary wrapper classes from #wrapper-navbar 2018-03-21 04:24:05 +00:00			`</div><!-- #wrapper-navbar end -->`