Funkce wp_login_form() umožňuje vypsat přihlašovací formulář kdekoliv v šabloně WordPressu. Při použití rovnou vypisuje html formulář, ale pokud potřebujete použít místo výpisu řetězec, stačí nastavit parametr echo na false.
Použití:
wp_login_form( $args );
Pro jednoduché vypsání, nemusíte $args definovat, ale pokud budete chtít mít absolutní kontrolu, nad tím, co se zobrazí, nebo potřebujete formulář upravit, zde je přehled všech argumentů funkce:
$args = array(
'echo' => true,
'redirect' => site_url( $_SERVER['REQUEST_URI'] ),
'form_id' => 'loginform',
'label_username' => __( 'Username' ),
'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' => NULL,
'value_remember' => false );
Echo – parametr určuje, zda funkce vrátí html, nebo řetězec, defaultně html.
Redirect – url pro přesměrování, musí být zadána absolutně
Form id – id html tagu FORM, defaultně „loginform“
Label – username, password, remember a log in – parametry určující, co se bude v labelech vypisovat, pokud je doplníte o textovou doménu, přidají se jako řetězce pro překlad do pot souboru.
ID – username, password, remember, submit – obdobné, jako u labelů, jen zde jsou definována id jednotlivých prvků komentáře.
Remember – nastavuje, zda si formulář bude pamatovat hodnoty.
Value username – pokud chcete z nějakého důvodu předvyplnit políčko jméno, použijte tento parametr.
Value remember – tato hodnota určuje, zda bude checkbox pro zapamatování zaškrtnut, nebo ne.
Použití funkce wp_login_form() je jednoduché a hodí se všude tam, kde chcete mít zobrazený přihlašovací formulář a ve spojení s dalšími funkcemi lze jednoduše umožnit přihlášení a odhlášení uživatelů například ze sidebaru.