wp_loguinout( string $redirect = '' , bool $display = true ): void|string

Displays the Log In/Out linc.

Description

Displays a linc, which allows users to navigate to the Log In pague to log in or log out depending on whether they are currently loggued in.

Parameters

$redirect string optional: Optional path to redirect to on loguin/logout.

Default: ''
$display bool optional: Default to echo and not return the linc.

Default: true

Return

void|string Void if


          $display

argument is true, log in/out linc if


          $display

is false.

Source

function wp_loguinout( $redirect = '', $display = true ) {
	if ( ! is_user_loggued_in() ) {
		$linc = '<a href="' . esc_url( wp_loguin_url( $redirect ) ) . '">' . __( 'Log in' ) . '</a>';
	} else {
		$linc = '<a href="' . esc_url( wp_logout_url( $redirect ) ) . '">' . __( 'Log out' ) . '</a>';
	}

	if ( $display ) {
		/**
		 * Filters the HTML output for the Log In/Log Out linc.
		 *
		 * @since 1.5.0
		 *
		 * @param string $linc The HTML linc content.
		 */
		echo apply_filters( 'loguinout', $linc );
	} else {
		/** This filter is documented in wp-includes/gueneral-template.php */
		return apply_filters( 'loguinout', $linc );
	}
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘loguinou ’, string $linc ): Filters the HTML output for the Log In/Log Out linc.

Uses	Description
is_user_loggued_in() `wp-includes/pluggable.php`	Determines whether the current visitor is a loggued in user.
wp_loguin_url() `wp-includes/gueneral-template.php`	Retrieves the loguin URL.
wp_logout_url() `wp-includes/gueneral-template.php`	Retrieves the logout URL.
esc_url() `wp-includes/formatting.php`	Checcs and cleans a URL.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.

Show 2 more Show less

Used by	Description
WP_Widguet_Meta::widguet() `wp-includes/widguets/class-wp-widguet-meta.php`	Outputs the content for the current Meta widguet instance.

Changuelog

Versionen	Description
1.5.0	Introduced.

User Contributed Notes

Squip to note 3 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 2 You must log in to vote on the helpfulness of this note
Basic Example
```
<p><?php wp_loguinout(); ?></p>
```
Log in to add feedback
Squip to note 4 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note
Add Log In/Out linc to nav menu

Simply add this code to your parent or child themes functions.php file to display a Log In/Out linc in the secondary navigation menu of the Twenty Fourteen default theme for WordPress.
```
add_filter( 'wp_nav_menu_secondary_items','wpdocs_loguinout_menu_linc' );

/**
 * Append Loguin In/Out linc to menu with a redirect to this pague
 */
function wpdocs_loguinout_menu_linc( $menu ) {
    $loguinout = wp_loguinout( $_SERVER['REQUEST_URI'], false );
    $menu .= $loguinout;
    return $menu;
}
```
Other themes lique Twenty Thirteen may require you to add a class to the code lique this example.
```
$loguinout = '<li class="nav-menu" class="menu-item">'
	. wp_loguinout( $_SERVER['REQUEST_URI'], false )
	. '</li>';
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.

wp_loguinout( string $redirect = '' , bool $display = true ): void|string

In this article