آموزش تابع get_the_date در وردپرس
مقالات وردپرستفاوت تابع get_the_date و the_date درطراحی قالب وردپرس چیست ؟ چرا باید در کدنویسی قالب وردپرس از تابع get_the_date بیشتر استفاده کنیم ؟
در سری مقالات آموزش سیر تا پیاز توابع وردپرس ، اکنون به تابع get_the_date رسیدیم . همانطور که قبلا نیز اشاره شده است ، اسامی توابع وردپرس در اکثر موارد ، بیانگر خروجی آنها در کدنویسی است پس اگر کمی به شکل و شمایل این تابع یعنی get_the_date دقت کنید خواهید فهمید که برای مواردی است که قصد داریم با تاریخ در طراحی قالب وردپرس کار کنیم . البته برای تاریخ توابع دیگری نیز در وردپرس وجود دارند که درمورد هرکدام می‌توان ساعت‌های زیادی صحبت کرد . برای مثال در مورد تاریخ ، وبسایت رسمی وردپرس توابع زیر را به ما معرفی می‌کند :
- the_date
- get_the_date
- the_modified_date
- get_the_modified_date
- wp_date
این توابع هرکدام برای امر مشخصی در طراحی قالب به کار خواهند رفت اما در سری مقالات آموزش وردپرس قصد داریم تا توابعی را خدمتتان معرفی کنیم که کم دردسر هستد و خروجی مطمئن و کاملی خدمت شما ارائه خواهند نمود . در بین توابع تاریخ برای وردپرس ، تابع get_the_date یکی از توابع بسیار پرکاربرد است که شاید بتوان گفت در 99 درصد مواقع می‌توان داخل قالب وردپرس ، این تابع را برای نمایش تاریخ فراخوانی کرد .
اگر به ساختار توابع وردپرس آشنایی داشته باشید و البته مقالات قبلی سایت در رابطه با آموزش توابع وردپرس را مطالعه کرده باشید ، حتما اطلاع دارید توابعی که با حرف the شروع می‌شوند ، توابعی هستند که مقداری را در خروجی برای شما چاپ خواهند کرد و نیازی به نوشتن دستور echo قبل از آنها نیست و توابعی که با get شروع می‌شوند ، توابعی هستند که مقداری را return می‌کنند و برای خروجی گرفتن از آنها لازم است تا از دستور echo قبل از نام تابع استفاده شود . درنتیجه برای استفاده از تابع get_the_date لازم است تا حتما از دستور echo استفاده شود یعنی بصورت زیر :
echo get_the_date();این تابع تاریخ را برای شما نمایش خواهد داد اما چه تاریخی و در کجا ؟
نمایش تاریخ انتشار پست با get_the_date
از آنجایی که وردپرس در هسته خود از قسمت Post Type استفاده کرده است ، لذا توابع مشخصی را نیز برای کار کردن با این قسمت‌ها در اختیار ما قرار داده است . زمانی که تصمیم دارید تا تاریخ انتشار یک نوشته ، محصول ، برگه ، نمونه‌کار و … را داخل صفحه جزئیات یا همان صفحه single مربوط به پست تایپ نمایش دهید و یا داخل حلقه loop تاریخ انتشار را چاپ کنید ، تایع get_the_date به کمک شما خواهد آمد .
<?php
while(have_posts()) { the_post(); ?>
<span><?php echo get_the_date(); ?></span>
<?php } ?>این تابع تاریخ انتشار پست شما را بصورت دقیق نمایش خواهد داد و همانطور که گفته شد هم در داخل صفحه جزئیات مربوط به هر پست تایپ و هم در داخل حلقه پست قابل استفاده است .
چرا بجای the_date از get_the_date استفاده کنیم ؟
اکنون سوالی پیش خواهد آمد که هم تابع the_date و هم تابع get_the_date هردو تاریخ را نمایش خواهند داد و تفاوت این دو تابع فقط در استفاده کردن یا نکردن از دستور echo است پس چرا باید از تابع get_the_date استفاده کنیم ؟؟؟؟ اینجاست که بحث کمی تخصصی خواهد شد .
لازم است تا از یک موضوع مهم در مورد تابع the_date اطلاع داشته باشید . تابع the_date تاریخ انتشار پست را نمایش خواهد داد اما اگر یک نویسنده مشخص در یک روز بیش از یک مطلب را ارسال کند ، تاریخ انتشار در تمامی مطالب نمایش داده نخواهد شد و تنها در آخرین مطلب ارسال شده توسط نویسنده ، تاریخ نمایش داده می‌شود . به عبارتی اگر شما 3 کارت نمایش محتوا در کنار هم داشته باشید و تمامی محتوای این 3 نوشته در یک روز و توسط یک نویسنده ارسال شده باشد ، تاریخ ارسال نوشته فقط در آخرین کارت نمایش داده خواهد شد . پس استفاده از این تابع برای زمانی که قصد دارید تاریخ در تمامی کارت محتوا نمایش داده شود ( درصورت استفاده از تابع the_date داخل حلقه ) درست نیست و بهتر است از تابع get_the_date استفاده کنید .
پارامترهای ورودی get_the_date
این تابع نیز همانند سایر اکثر توابع وردپرس ، امکان دریافت پارامتر ورودی دارند . البته در تمام توابعی که مربوط به زمان هستند می‌توانید از ورودی ، روز ماه سال بصورت‌های مختلف استفاده کنید . برای مثال یک نمونه از ورودی این تابع را بصورت زیر مشاهده می‌کنید :
get_the_date( 'D M j' );برای اینکه با سایر مقادیر ورودی برای تاریخ آشنا شوید ، می‌توانید به سایت php مراجعه نموده و روش‌های مختلف نمایش تاریخ بصورت روز ، سال میلادی ، مخفف سال و … را نیز مشاهده و استفاده کنید . استفاده از تابع get_the_date هیچ مشکلی در طراحی قالب وردپرس ندارد و می‌توانید با خیال راحت از آن برای نمایش تاریخ در تمامی نوع محتوا یا همان Post Type ها استفاده کنید . امیدواریم این مطلب کوتاه و کاربردی برای شما علاقمندان به آموزش طراحی قالب وردپرس مفید واقع شده باشد .
