آموزش تابع the_title در وردپرس
مقالات وردپرساستفاده از تابع the_title بصورتی متفاوت در کدنویسی وردپرس ! با سیر تا پیاز این تابع کاربردی در طراحی قالب وردپرس آشنا شوید .
اگر مقاله لیست توابع کاربردی در وردپرس را که داخل سایت منتشر کرده‌ایم مطالعه کرده باشید ، تقریبا تمامی توابع وردپرس برای برنامه نویسی پوسته وردپرس را خدمتتان معرفی کردیم اما در این بین درمورد هریک از توابع ، توضیح بسیار مختصری ارائه کردیم . در این سری مقالات قصد داریم تا درمورد هریک از توابع بصورت جامع صحبت کنیم .
در وردپرس برخی توابع مختص به حلقه loop هستند ، برخی مختص صفحات دسته بندی ، برخی مختص صفحه اصلی و … در وردپرس خوشبختانه نیاز آنچنانی به ارتباط با دیتابیس ندارید و توابعی که در اختیار شما قرار گرفته است ، با فراخوانی ساده ، می‌توانند دیتای مدنظر شما را ارائه کنند .
برای مثال همین تابع the_title . تقریبا از نام تمامی توابع وردپرس می‌توان دریافت که وظیفه این تابع چیست ! تابع the_title برای فراخوانی و نمایش عنوان‌ها در سایت وردپرسی است اما محل دقیق استفاده از این تابع ابتدا در داخل صفحات سایت است .
استفاده از the_title در داخل صفحات !
شما از تابع the_title در داخل هر فایلی که استفاده کنید ، عنوان صفحه را برای شما نمایش خواهد داد . اگر این تابع داخل فایل single.php حتی در بیرون حلقه loop استفاده شود ، عنوان صفحه را از قسمت تگ title استخراج کرده و نمایش خواهد داد . اگر از این تابع در داخل صفحات archive استفاده کنید ، عنوان آخرین محتوایی که داخل سایت آرشیو مربوطه ارسال شده است را نمایش خواهد داد و …
مسلما استفاده از این تابع داخل صفحات archive ( خارج از حلقه ) صحیح نیست چراکه در این صفحات لازم است تا عنوان دستی نمایش دهیم مثلا آخرین نوشته‌ها یا آخرین محصولات و … لذا کاربرد اصلی این تابع در قسمت عناوین مشخص است مثلا عنوان نوشته در حلقه loop !
استفاده از the_title در حلقه loop
اگر در مورد حلقه loop اطلاعی ندارید باید گفت زمانی که شما قصد دارید تا مطالب یا محصولات سایت را بصورت منظم و پشت سرهم از پایگاه داده دریافت کرده و در داخل سایت و محل مشخصی آنها را نمایش دهید ، باید از حلقه while استفاده کنید تا این حلقه هربار تکرار شده و تا زمانی که محتوا داشته باشیم ، این محصولات داخل سایت نمایش داده شود . به یک نمونه حلقه زیر توجه کنید :
<?php
while(have_posts()) { the_post(); ?>
<h3><?php the_title(); ?></h3>
<?php } ?>داخل این حلقه در محلی که نیاز داریم تا عنوان هر نوشته را چاپ کنیم ، کافیست تا از تابع the_title استفاده کنیم و هربار عناوین هر نوشته داخل صفحه سایت نمایش داده شود . پس محل اصلی استفاده از تابع the_title برای فراخوانی عناوین محتواها داخل حلقه while است .
تابع the_title نیازی به دستور echo ندارد و بصورت خودکار عنوان را برای شما چاپ می‌کند اما اگر قصد داشته باشید تا تابع the_title را با دستور echo استفاده کنید ، باید به شکل زیر این تابع را به کار بگیرید :
echo get_the_title();در این حالت شما یک get در ابتدای این تابع قرار داده و قبل از اسم تابع نیز دستور echo را خواهید داشت . البته استفاده از get و echo در داخل توابع وردپرس ، مسبب تغییراتی نیز می‌شود که در مقاله بعدی که در مورد تابع the_content صحبت خواهیم کرد دقیق خدمتتان خواهیم گفت که حالت the_content با حالت get_the_content دقیقا چه تفاوتی ایجاد می‌کند ؟
در مورد تابع the_title شما می‌توانید از هردو حالت استفاده کنید و تفاوتی در خروجی کار ایجاد نخواهد شد .
پارامتر های تابع the_title
اگر این تابع را جهت آموزش در سایت‌های مختلف همچون developer wordpress سرچ کنید ، دیتاهایی که خواهید دید بصورت زیر است :
the_title( string $before = ”, string $after = ”, bool $display = true )و احتمالا از این موارد چیزی دستگیر شما نشود ! اکنون این نمونه را برای شما تشریح خواهیم کرد . این تابع دارای 3 ورودی است . پارامتر before و after و display که دو پارامتر اول بصورت پیشفرض مقدار خالی یعنی ” ” دارند که پارامترهای string یا همان رشته‌ای هستند و شما می‌توانید یک عبارت متنی داخل آن استفاده کنید این دو پارامتر یکی برای نمایش قبل از عنوان و دیگری جهت نمایش در بعد از عنوان تنظیم می‌شوند .
اگر در قبل و بعد از عنوان خودتان آیکونی بصورت فونت آیکون داشته باشید می‌توانید آن را داخل پارامتر before یا after قرار دهید .
پارامتر سوم یعنی display یک ورودی بصورت bool است یعنی دو مقدار true یا false را می‌توانید داخل آن قرار دهید . بصورت پیشفرض display برابر با true است . اگر این مقدار برابر با true باشد ، عبارتی که داخل title قرار دارد را echo خواهد کرد به همین دلیل بالاتر گفتیم که اگر شما از the_title استفاده کنید ، خود تابع بصورت پیشفرض عمل echo را انجام می‌دهد و این از آنجاست که پارامتر display بصورت پیشفرض برابر true است .
اگر این مقدار را به false تغییر دهید ، این‌بار تابع the_title دیگر echo نخواهد داشت و درحقیقت عمل return را انجام خواهد داد و اگر اطلاع دارید حتما می‌دانید که در عمل return ، چیزی چاپ نخواهد شد و شما لازم است حتما از echo نیز استفاده کنید .
درمورد تابع the_title توضیحات لازم در همین حد است و شما از این تابع صرفا جهت نمایش عنوان استفاده خواهید کرد . تنها قسمت جالب این تابع شاید در قسمت پارامتر سوم تابع باشد که عملکرد جالبی را ایجاد می‌کند . امیدواریم این مقاله برای شما مفید باشد . پاینده باشید .
