آموزش توابع شرطی وردپرس

توابع شرطی وردپرس می توانند در فایل های قالب شما مورد استفاده قراربگیرند.به عنوان مثال اگر شما بخواهید تکه ای متن را فقط در صفحه اصلی سایت نمایش دهید٬ می بایست از تابع شرطی is_home() استفاده نمایید٬ به همین ترتیب توابع شرطی وردپرس دیگری وجود دارند که هر کدام به ترتیب در این مطلب آموزشی توضیح داده میشود.

لیست کامل توابع شرطی وردپرس

توابع شرطی در نهایت به شما خروجی True یا False برمیگرداند که با استفاده از آن میتوانید انواع و اقسام شرط ها را در وب سایت خود پیاده سازی نمایید‌.

تابع شرطی برای صفحه اصلی سایت

is_home()

با استفاده از این تابع میتوانید شرطی را قرار دهید که آن شرط فقط در صفحه اصلی سایت اجرا گردد.

تابع شرطی برای برگه اصلی

is_front_page()

با استفاده از این تابع میتوانید شرطی را قرار دهید که آن شرط فقط در برگه اصلی سایت اجرا گردد ٬ برگه اصلی سایت یک برگه استاتیک میباشد که از منوی تنظیمات >‌ خواندن در پیشخوان وردپرس تعیین میگردد.

تابع شرطی برای برگه وبلاگ

is_front_page() and is_home()

برگه وبلاگ هم یک برگه استاتیک میباشد که از منوی تنظیمات >‌ خواندن در پیشخوان وردپرس تعیین میگردد اما تابع شرطی برای برگه وبلاگ وجود ندارد و شما میبایست از توابع is_home() و is_front_page() در کنار یکدیگر استفاده نمایید.

تا اینجا برای درک بهتر توابع شرطی صفحه اصلی سایت و برگه اصلی و برگه وبلاگ به مثال زیر توجه نمایید :

if ( is_front_page() && is_home() ) {
  // Default homepage
} elseif ( is_front_page() ) {
  // static homepage
} elseif ( is_home() ) {
  // blog page
} else {
  //everything else
}

توابع مربوط به پنل مدیریت وردپرس

is_admin()

با استفاده از این تابع میتوانید تعیین نمایید که اگر پنل مدیریت یا یوزر مدیریت بود آن تکه کد اجرا گردد.

is_network_admin()

با استفاده از این تابع میتوانید تعیین نمایید که اگر پنل مدیریت شبکه یا یوزر مدیریت شبکه بود آن تکه کد اجرا گردد.

نوار بار منوی ادمین

is_admin_bar_showing()

این تابع شرطی مربوط به نوار بار منوی ادمین یا مدیریت می باشد.

صفحه داخلی یک مطلب

is_single()

اگر شما بخواهید شرطی را برای صفحه داخلی یک مطلب در نظر بگیرید میتوانید از این تابع استفاده نمایید ٬ برای درک بهتر به مثال های زیر توجه نمایید :

is_single( '17' )

در اینجا عدد ۱۷ اشاره به شماره ID مطلب میباشد.

is_single( 'wordpress and iwordpress' ) 

وقتی که عنوان مطلب مساوی باشد با wordpress and iwordpress

is_single( 'wordpress-learn' ) 

زمانی که نامک نوشته برابر باشد با wordpress-learn

is_single( array( 17, 'beef-stew', 'Irish Stew' ) ) 

در کد بالا به صورت یک آرایه هر ۳ حالت ID ٬ نامک ٬ عنوان نوشته تست شده است.

is_single( array( 17, 19, 1, 11 ) )

زمانی که بخواهید چند نوشته را بر اساس ID آن به صورت یک آرایه داخل این تابع قراردهید.

is_single( array( 'beef-stew', 'pea-soup', 'chili' ) ) 

زمانی که بخواهید چند نوشته را بر اساس نامک آن به صورت یک آرایه داخل این تابع قراردهید.

is_single( array( 'Beef Stew', 'Pea Soup', 'Chili' ) ) 

زمانی که بخواهید چند نوشته را بر اساس عنوان آن به صورت یک آرایه داخل این تابع قراردهید.

نوشته سنجاق شده یا Sticky Post

is_sticky()

با استفاده از این تابع ٬ تعیین مینمایید که اگر نوشته ای سنجاق شده بود آن شرط اجرا گردد.

is_sticky( '17' )

نمونه کد برای نوشته سنجاق شده با ID شماره ۱۷

توابع شرطی برای برگه ها

is_page()

با استفاده از این تابع میتوانید برای برگه های سایت شرطی را قرار دهید٬ به عنوان مثال میتوانید متنی را فقط در برگه تماس با ما چاپ نمایید٬ برای درک بهتر به مثال های زیر توجه نمایید :

is_page( 42 ) 

اگر ID برگه 42 بود.

is_page( 'About Me And Joe' ) 

اگر عنوان برگه “About Me And Joe” بود.

is_page( 'about-me' ) 

اگر نامک برگه “about-me” بود.

is_page( array( 42, 'about-me', 'About Me And Joe' ) ) 

استفاده از موارد فوق به صورت یک آرایه داخل تابع.

is_page( array( 42, 54, 6 ) ) 

استفاده از ID مطالب به صورت یک آرایه داخل تابع .

صفحه ۴۰۴

is_404()

از این تابع شرطی میتوانید زمانی استفاده نمایید که اگر یک صفحه در سایت وجود نداشته باشد این شرط و تابع اجرا گردد.

خواندن از راست به چپ (RTL)

is_rtl() 

برخی از زبان ها مثل زبان فارسی و عربی از راست به چپ خوانده میشود ٬ حال ممکن است شما بخواهید یک فایل CSS یا JS در صورتی اجرا گردد که سایت به صورت راست به چپ خوانده شود .

مثال :

 if ( is_rtl() ) {
   wp_enqueue_style(  'style-rtl',  plugins_url( '/css/style-rtl.css', __FILE__ ) );
   wp_enqueue_script( 'script-rtl', plugins_url( '/js/script-rtl.js',  __FILE__ ) );
 }

کاربر وارد سایت شده باشد

is_user_logged_in() 

با استفاده از این تابع میتوانید شرطی را قرار دهید که کاربر حتما وارد سایت شده باشد.

ایمیل وجود داشته باشد

email_exists( $email ) 

با استفاده از این تابع میتوانید صحت وجود ایمیل یک کاربر را بررسی نمود.

نام کاربری وجود داشته باشد

username_exists( $username ) 

با استفاده از این تابع میتوانید صحت وجود نام کاربری یک کاربر را بررسی نمود.

تابع شرطی برای قالب برگه

is_page_template() 

زمانی که شما از یک قالب برای برگه استفاده مینمایید شاید جایی نیاز به این داشته باشید که از تابعی شرطی استفاده نمایید.

به عنوان مثال :

is_page_template( 'about.php' ) 

نکته : توجه داشته باشید که اگر فایل about.php داخل یک پوشه به نام page-templates باشد باید آدرس را به صورت page-templates/about.php وارد نمایید.

این لیست ادامه دارد …