آموزش تابع comments_number در وردپرس
مقالات وردپرسچگونه از تابع comments_number بصورت صحیح در طراحی قالب وردپرس استفاده کنیم ؟ نمایش تعداد نظرات به شکل حرفه‌ای در پوسته وردپرس .
در سری آموزش‌های توابع کاربردی در وردپرس ، اکنون به تابع comments_number رسیدیم . در تمامی مقالات وردپرس اشاره کردیم که می‌توان از نام توابع وردپرس ، عملکرد آنها را حدس زد .
اگر با توابع وردپرس کمی آشنا باشید و البته مقالات قبلی را بصورت دقیق مطالعه کرده باشید ، توابعی که فاقد عبارت get در ابتدای اسم خودشان هستند ، عمل echo را انجام می‌دهند اما توابعی که داخل آنها get وجود دارد و به همراه echo استفاده می‌شوند و صرفا مقداری را بازگشت می‌دهند ( return ) که می‌توان توسط echo آنها را چاپ کرد .
پس تابع comments_number قرار است تا بصورت خودکار ، مقادیری را برای ما چاپ کند . اما اکنون باید از این تابع چگونه استفاده کنیم ؟
استفاده از comments_number در صفحه single.php
می‌توان گفت اصلی‌ترین قسمت برای استفاده از تابع comments_number در صفحه جزئیات محتوا است . منظور از صفحه جزئیات ، صفحه جزئیات هر پست تایپ است یعنی جزئیات نوشته ، محصول ، نمونه کار و هر پست تایپ دیگری !
در محل مدنظر که قصد دارید تا تعداد کامنت‌های هر پست را نمایش دهید ، می‌توانید این تابع را به کار بگیرید . ساختار کلی این تابع بصورت زیر است :
comments_number( string|false $zero = false, string|false $one = false, string|false $more = false, int|WP_Post $post )این تابع شامل سه پارامتر ورودی است . پارامتر اول که با zero مشخص شده است بصورت پیشفرض مقدار false دارد . این پارامتر برای زمانی استفاده خواهد شد که پست شما کامنتی ندارد و از متنی که داخل این متغیر قرار خواهید داد استفاده می‌شود .
برای مثال می‌توانید در این قسمت متن ” بدون دیدگاه ” و یا ” بدون بازخورد ” و … را بنویسید . پس این از پارامتر اول !!
پارامتر دوم این تابع که با نام one مسخص شده است ، برای زمانی است که پست شما صرفا یک کامنت و دیدگاه دارد . مقدار پیشفرض این پارامتر نیز false است . برای این پارامتر می‌توانید متنی مثل ” یک دیدگاه ” یا هرچیزی که دوست داشتید را بنویسید .
پارامتر سوم این تابع با نام more مشخص شده است و مقدار پیشفرص آن نیز false است . این پارامتر برای زمانی است که کامنت‌ها بیش از یک عدد هستند . برای این بخش می‌توانید متنی مثل ” دیدگاه ” را استفاده کنید چراکه اگر عدد 5 چاپ شود ، به همراه متن شما ، خروجی بصورت ” 5 دیدگاه ” نمایش داده خواهد شد .
این تابع دارای یک پارامتر چهارم بنام post نیز است که مقدار پیشفرض آن برابر با متغیر سراسری $post است . اکنون اگر قصد داریم از این تابع استفاده کنیم ، یک حالت ممکن است بصورت زیر باشد :
<p>
This post currently has
<?php comments_number( 'no responses', 'one response', '% responses' ); ?>.
</p>بجای عبارات انگلیسی ، متون فارسی خودتان را قرار دهید تا یک تابع کامل داشته باشید . اما اکنون یک نکته مهم درمورد این تابع وجود دارد که لازم است از آن نیز اطلاع داشته باشید .
تفاوت تابع comments_number با get_comments_number
تابع comments_number حالت دیگری بصورت get_comments_number دارد که این تابع صرفا وظیفه چاپ تعداد کامنت‌ها را دارد . زمانی که شما قصد دارید تا صرفا تعداد کامنت‌ها را بصورت عدد و بدون متنی در قبل یا بعد آنها چاپ کنید ، می‌توانید از این تابع استفاده کنید .
زمانی‌که قصد دارید تا از این تابع استفاد کنید لازم است تا خودتان متن مدنظر خودتان را نیز چاپ کنید . مثلا بصورت زیر :
<p> This post has <?php echo get_comments_number(); ?> comments </p>تابع get_comments_number فاقد هرگونه پارامتر ورودی است و تنها روش استفاده از آن را مشاهده کردید . اکنون بسته به پروژه و قالبی که مشغول طراحی آن هستید می‌توانید از این 2 تابع جهت نمایش تعداد نظرات استفاده کنید . امیدواریم این محتوا نیز برای شما مفید واقع شده باشد . پاینده باشید .
