当前浏览:首页 / WordPress函数 / wp_loginout()

wp_loginout( string $redirect = '', bool $echo = true )

显示登录/退出链接

checklist


描述

显示一个链接,允许用户导航到登录页面以根据当前是否登录进行登录或退出。


参数

$redirect

(string) (可选) 登录/退出时重定向到的路径。

默认值: ''

$echo

(bool) (可选) 默认为输出,不返回链接。

默认值: true


返回

(void|string) 如果$echo参数为true,则无返回,如果$echo为false,则返回登录/退出链接。



源码

查看源码 官方文档


更新日志

版本描述
1.5.0开始引入

使用示例

  • 示例1

    基本示例

    <p><?php wp_loginout(); ?></p>
    
    
  • 示例2

    将登录/注销链接添加到导航菜单

    只需将此代码添加到父或子主题 functions.php 文件,在WordPress的Twenty Fourteen默认主题的二级导航菜单中显示登录/退出链接。

    add_filter( 'wp_nav_menu_secondary_items','wpdocs_loginout_menu_link' );
    
    /**
     * Append Login In/Out link to menu with a redirect to this page
     */
    function wpdocs_loginout_menu_link( $menu ) {
        $loginout = wp_loginout( $_SERVER['REQUEST_URI'], false );
        $menu .= $loginout;
        return $menu;
    }
    

    其他主题(如Twenty Thirteen)可能需要向代码中添加一个类,如本例所示。

    $loginout = '<li class="nav-menu" class="menu-item">'
    	. wp_loginout( $_SERVER['REQUEST_URI'], false )
    	. '</li>';