معرفی تابع های وردپرس-قسمت دوم
- توسط : علی حسین شهابی
- 0 نظر
ا سلام خدمت دوستان عزیز
دومین جلسه معرفی تابع های وردپرس رو شروع می کنیم.
توابع وردپرسی امروز بیشتر در حیطه ی ورود و خروج کاربران می باشد.
اگه تابع های دیگری هم هستند که از نظر شما مفید اند حتما در نظرات بهش اشاره کنید تا در قسمت های بعدی آموزش , به معرفی اون ها بپردازم.
این تابع لینکی جهت خارج شدن کاربر (log out) را چاپ می نماید.
<?php echo wp_logout_url( $redirect ); ?>
می توانیم از این لینک در تگ a استفاده نماییم
<a href="<?php echo wp_logout_url(); ?>" title="Logout">Logout</a>
مثال : می توانیم تعیین کنیم کاربر وقتی لاگین کرد به کدام صفحه هدایت شود. در این مثال به استفاده از تابع home_url تعیین کردیم که بعد از خروج به صفحه ی اصلی سایت برو .
<a href="<?php echo wp_logout_url( home_url() ); ?>" title="Logout">Logout</a>
۸- تابع is_user_logged_in
از این تابع مواقعی میشه استفاده کرد که مثلا میخواهیم چک کنیم آیا کاربر لاگین کرده است یا نه ؟
<?php
if ( is_user_logged_in() ) {
echo 'Welcome, registered user!';
} else {
echo 'Welcome, visitor!';
}
?>
این تابع هر جایی از صفحه ی سایت شما فراخوانی شود , یک فرم ورود به پنل مدیریت در آنجا می سازد تا کاربران بتوانند از طریق آن لاگین کنند.
همچنین دارای پارامترهای ساده است که در ادامه قرار خواهم داد :
<?php $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
); ?>
<?php wp_login_form( $args ); ?>
این تابع , url ای را برمیگرداند که به وسیله آن کاربر می تواند لاگین نماید.
<?php echo wp_login_url( $redirect ); ?>
با استفاده از پارامتر
$redirect
می توانیم تعیین کنیم که پس از لاگین کاربر به کدام صفحه هدایت شود.
مثال : کاربر پس از لاگین به صفحه اصلی سایت هدایت شود :
<a href="<?php echo wp_login_url( home_url() ); ?>" title="Login">Login</a>
۱۱- تابع
wp_loginout
این تابع زمانی که کاربر لاگین است , لینک خروج و موقعی که کاربر وارد نشده است , لینک لاگین را نشان می دهد.
<?php wp_loginout( $redirect, $echo ); ?>
پارامتر $redirect مشخص می کند پس از لاگین یا خروج , به کدام صفحه کاربر را هدایت کند.
پارامتر $echo اگر برابر true باشد آدرس را چاپ می کند و اگر برابر false باشد مقدار را فقط برمیگرداند تا آن را داخل متغیری بریزیم.
مثال :
<p><?php wp_loginout(); ?></p>
مثال : اضافه کردن دکمه ورود و خروج به منو سایت :
add_filter( 'wp_nav_menu_secondary_items','wpsites_loginout_menu_link' );
function wpsites_loginout_menu_link( $menu ) {
$loginout = wp_loginout($_SERVER['REQUEST_URI'], false );
$menu .= $loginout;
return $menu;
}
این تابع کاربر را خارج می کند و session های او را پاک می کن.
<p><?php wp_logout(); ?></p>
۱۳- تابع wp_lostpassword_url
این تابع لینک صفحه ای که کاربر می تواند در صورت فراموشی رمز عبور , رمز عبور خود را بازیابی کند را برمیگرداند.
<?php echo wp_lostpassword_url( $redirect ); ?>
با استفاده از پارامتر $redirect می توانیم تعیین کنیم کاربر پس از بازیابی رمز عبور به کدام صفحه هدایت شود.
<a href="<?php echo wp_lostpassword_url(); ?>" title="Lost Password">Lost Password</a>
مثال : بعد از بازیابی رمز عبور به صفحه ی اصلی سایت هدایت می شود.
<a href="<?php echo wp_lostpassword_url( get_bloginfo('url') ); ?>" title="Lost Password">Lost Password</a>
این تابع اگر کاربر لاگین کرده باشد , آدرش صفحه ورود به پنل ادمین رو برمیگرداند ولی اگر لاگین نکرده باشد , آدرس ورود به صفحه ثبت نام را برمیگرداند.
یادتان باشد برای اینکه ادرس صفحه ثبت نام را برگرداند باید در تنظیمات پنل وردپرس , تیک گزینه عضویت را زده باشین.
<?php wp_register( $before, $after, $echo); ?>
پارامتر $before : متن یا تگ html ای که باید قبل از لینک قرار داده شود.
پارامتر $after : متن یا تگ html ای که باید بعد از لینک قرار داده شود.
پارامتر $echo : اگر true باشد لینک را چاپ می کند ولی اگر false باشد ان را برمیگرداند تا در داخل متغیر بتوانیم بریزیم.
مثال :
<?php wp_register(); ?>
مثال :
<?php wp_register('', ''); ?>
زمانی که کاربر لاگین نباشد ادرس زیر چاپ می شود :
<a href="http://www.example.com/wp-login.php?action=register">Register</a>
و زمانی که کاربر لاگین باشد ادرس زیر چاپ می شود.
<a href="http://www.example.com/wp-admin/">Site Admin</a>
خب این جلسه آموزش تابع های وردپرس هم به پایان رسید
امیدوارم خوشتون اومده باشه.
نظر یادتون نره که خیلی نامردین