آموزش تابع the_content در وردپرس
مقالات وردپرساستفاده از تابع the_content در طراحی قالب وردپرس شامل چه نکاتی است ! تابع the_content با get_the_content چه تفاوتی دارد ؟
در مقاله قبلی به آموزش کامل و دقیق تابع the_title پرداختیم و اگر خواننده مقاله مربوطه بودید دریافتید که سیر تا پیاز این تابع کاربردی وردپرس را خدمتتان تشریح کردیم . اکنون در این مقاله قصد داریم تابع کاربردی بعدی که عضو جدایی ناپذیر تمامی قالب‌های وردپرس است را خدمتتان تشریح کنیم که تابع the_content است .
همانطور که در مقاله قبلی اشاره کردیم ، اکثر توابع وردپرس به شکلی تعریف شده‌اند که از اسم آنها می‌توان دریافت که این تابع برای چه کاری در قالب استفاده خواهد شد . تابع the_content برای نمایش محتوا است اما دقیقا چه محتوایی و کجای سایت ؟!
تابع the_content درکل برای نمایش محتوایی است که از طرف مدیر سایت برای انواع پست تایپ‌ها اعم از نوشته ، برگه ، محصول ، نمونه‌کار و… داخل سایت قرار داده می‌شود .
اگر تاکنون با وردپرس در بخش تولید محتوا ، مثلا قسمت نوشته‌ها کار کرده باشید ، حتما قسمت نوشتن محتوا یا اصطلاحا ادیتور وردپرس را مشاهده کرده‌اید که همانند نرم افزار word اما در حدی ضعیف‌تر می‌توانید داخل آن تایپ کنید ، عکس درج کنید و … همانند تصویر زیر :
محتوایی که در این قسمت توسط شما نوشته شده است باید در داخل قالب نیز نمایش داده شود . برای اینکه محتوای ارسال شده از این بخش ، داخل سایت به درستی نمایش داده شود باید دست به دامان تابع the_content شویم . اما استفاده از این تابع چندین حالت دارد .
استفاده از the_content داخل حلقه !
شما از تابع the_content می‌توانید داخل حلقه while یا همان loop استفاده کنید . به عبارتی زمانی که حلقه while را تشکیل دادید می‌توانید بصورت زیر تابع the_content را فراخوانی کنید :
<?php
while(have_posts()) { the_post(); ?>
<div><?php the_content(); ?></div>
<?php } ?>در این حالت شما تمام محتوایی که داخل ادیتور وردپرس نوشته باشید را دریافت خواهید کرد . اگر این کار را برای مثال داخل صفحه آرشیو نوشته‌ها انجام دهید ، ظاهری بسیار بد خواهید داشت چراکه ممکن است محتوای نوشته شما هزاران کلمه باشد و این هزاران کلمه در آن قسمت نمایش داده خواهد شد . برای اینکه قسمتی از اوایل متن یا چکیده متن را نمایش دهید باید از تابع the_excerpt استفاده کنید که در مقاله بعدی خدمتتان آموزش خواهیم داد .
پس از تابع the_content می‌توان داخل حلقه while استفاده کرد اما عملا استفاده از آن معقولانه نیست . پس محل اصلی استفاده از تابع the_content کجاست ؟
استفاده از the_content در صفحات single
محل اصلی استفاده از این تابع داخل صفحات single یا اصطلاحا singular است . برای مثال صفحه جزئیات نوشته ، جزئیات محصول ، جزئیات نمونه کار و همچنین جزئیات برگه‌ها ! زمانی که کاربر وارد صفحه جزئیات یک برگه یا نوشته جهت مطالعه کامل‌تر می‌شود ، برای اینکه تمام محتوای نوشته شده داخل قسمت مدیریت را به او نشان دهیم باید از تابع the_content به شکل زیر استفاده کنیم :
<div><?php the_content(); ?></div>در این حالت هر آن چیزی که شما داخل ادیتور وردپرس قرار داده باشید ازجمله عکس و جدول و ویدیو و … همگی توسط همین تابع داخل سایت نمایش داده می‌شوند . درحقیقت این تابع هر چیزی که داخل ادیتور باشد را عینا داخل سایت بدون کم و کاست به نمایش خواهد گذاشت . دقت کنید که داخل صفحات single برای نمایش محتوای اصلی ، شما نیازی به استفاده از حلقه while ندارید .
تابع get_the_content چه کاری انجام خواهد داد ؟
اگر مقاله تابع the_title را بخوبی مطالعه کرده باشید ، اشاره کردیم که برای این تابع حالتی بصورت get نیز داریم که لازم است با دستور echo استفاده شود . اکنون برای تابع the_content نیز همین تابع را بصورت get_the_content داریم که اگر بدین صورت استفاده شود نیز باید حتما قبل از آن دستور echo قرار داده شود . اما این حالت یک اشکال بزرگ دارد !
مشکل صفحه سازها با تابع get_the_content
اگر شما از صفحه سازهایی همچون المنتور و ویژوال کامپوزر و … استفاده می‌کنید ، ممکن است داخل قسمت ادیتور توسط این صفحه سازها ، طراحی‌هایی را انجام دهید و سپس متوجه شوید که داخل برگه خودتان خروجی دریافت نمی‌کنید ! در این شرایط شک نداشته باشید که یکی از اشکالات ممکن است از قالب شما و قسمت تابع the_content باشد که بصورت get_the_content نوشته شده است و حتما باید اصلاح شده و بصورت the_content باشد .
دلیل این امر اینجاست که تابع get_the_content شورتکدهای صفحه سازها را اجرا نمی‌کند و به همین دلیل شما خروجی مدنظر را مشاهده نمی‌کنید .
البته خطای دیگری که گاها صفحه سازها با قالب‌ها دارند اینجاست که خطای نبود تابع the_content را اعلام می‌کنند در این شرایط شما حتما باید تابع the_content را داخل فایل page.php خودتان قرار دهید تا بتوانید خروجی صفحه سازها را در قالب برگه خودتان مشاهده کنید .
این تابع نکته خاصی بجز مواردی که خدمتتان آموزش داده شد ندارد و هنگام طراحی قالب وردپرس به این دلیل که سروکار ما با این تابع داخل صفحات جزئیات است ، بهتر است همیشه از حالت the_content استفاده کنید تا مشکلی نداشته باشید . امیدواریم این محتوا برای شما مفید واقع شده باشد .
