۱۶
مرداد

جلسه ۰۹ : حلقه های وردپرس

دسته‌بندی‌ها :

با عرض سلام خدمت کاربران محترم سایت پی وی لرن.
با جلسه ای دیگر از سری جلسات دوره جامع آموزش ساخت قالب وردپرس در خدمت شما هستیم.
در این جلسه حلقه های وردپرس (the Loop) و کاربرد آن ها را آموزش خواهیم داد.

فهرست

مقدمه

حلقه، مکانیزم پیش‌فرض وردپرس برای استخراج پست ها از طریق فایل های قالب است.
تعداد پست های بازیابی شده توسط تعداد پست هایی که در هر صفحه نمایش داده می‌شوند، مشخص می‌شود.
در داخل حلقه، وردپرس هر پست را برای نمایش در صفحه جاری بازیابی کرده و ان را بر اساس دستورالعمل های قالب، قالب بندی می‌کند.

حلقه، داده های هر پست را از دیتابیس وردپرس استخراج کرده و اطلاعات مناسب را به جای هر تگ قالبی، قرار می‌دهد.
هرگونه کد HTML یا PHP در داخل حلقه، برای تک تک پست ها اعمال می‌شوند.

از حلقه برای استفاده های مختلفی مانند موارد زیر استفاده می‌شود:

نمایش عناوین پست ها و پست های برگزیده در صفحه اصلی بلاگ
نمایش نظرات در صفحه پست
نمایش داده ها از Custom Post Types و Custom Fields

استفاده از حلقه های وردپرس

حلقه ها باید در فایل های قالبی که می‌خواهند اطلاعات پست ها را نمایش دهند، استفاده شود.
همچنین برای جلوگیری از نمایش هدر در هر بار اجرای حلقه، تگ ()get_header باید خارج از حلقه استفاده شود.

مثال:

مثال :

<?php 
get_header();
if ( have_posts() ) : 
    while ( have_posts() ) : the_post(); 
        // Display post content
    endwhile; 
endif; 
?>

<?php

get_header();

if ( have_posts() ) :

while ( have_posts() ) : the_post();

// Display post content

endwhile;

endif;

در مثال بالا پایان حلقه با دستورات endwhile و endif مشخص شده است.
حلقه ها همیشه باید با دستورات if و while شروع شوند.

هر تگ قالبی که می‌خواهید به تمام پست ها اعمال شود، باید بین دستورات شروع کننده و تمام کننده حلقه قرار گیرد.

در مثال پایین کد های یک فایل index.php بسیار ساده آورده شده است:

مثال :

<?php
get_header();
 
if ( have_posts() ) : 
    while ( have_posts() ) : the_post();
        the_content();
    endwhile;
else :
    _e( 'Sorry, no posts matched your criteria.', 'textdomain' );
endif;
 
get_sidebar();
get_footer();
?>

<?php

get_header();

if ( have_posts() ) :

while ( have_posts() ) : the_post();

the_content();

endwhile;

else :

_e( 'Sorry, no posts matched your criteria.', 'textdomain' );

endif;

get_sidebar();

get_footer();

حلقه ها چه چیز هایی را می‌توانند نمایش دهند؟

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

()next_post_link : یک لینک به پست منتشر شده بعد از پست فعلی (بر اساس ترتیب زمانی)
()previous_post_link : یک لینک به پست منتشر شده قبل از پست فعلی (بر اساس ترتیب زمانی)
()the_category : نمایش دسته بندی های مرتبط با پست
()the_author : صفحه نویسنده پست یا صفحه
()the_content : محتوای اصلی پست یا صفحه
()the_ID : نمایش ID پست یا صفحه
()the_tags : نمایش برچسب های پست
()the_title : نمایش عنوان پست
و …

همچنین می‌توانیم از تگ های قالب شرطی نیز استفاده کنیم:

()is_home : اگر صفحه جاری، صفحه home باشد، true برمی‌گرداند
()is_single : اگر صفحه جاری یک پست تنها باشد، true برمی‌گرداند
()is_category : اگر صفحه جاری جزء دسته بندی خاصی باشد، true برمی‌گرداند. مثال : (‘news’)is_category
()is_search : اگر صفحه جاری شامل نتایج یک جستجو باشد، true برمی‌گرداند
()is_404 : اگر صفحه درخواست شده وجود نداشته باشد، true برمی‌گرداند

مثال

کد زیر یک صفحه archive بسیار ساده را نمایش می‌دهد.
معمولا در صفحه های آرشیو لیست از پست ها که حاوی عناون، تصویر پست و خلاصه ای از محتوای پست است، نمایش داده می‌شود.

مثال :

<?php 
if ( have_posts() ) : 
    while ( have_posts() ) : the_post(); 
        the_title( '<h2>', '</h2>' ); 
        the_post_thumbnail(); 
        the_excerpt();
    endwhile; 
else: 
    _e( 'Sorry, no posts matched your criteria.', 'textdomain' ); 
endif; 
?>

<?php

if ( have_posts() ) :

while ( have_posts() ) : the_post();

the_title( '<h2>', '</h2>' );

the_post_thumbnail();

the_excerpt();

endwhile;

else:

_e( 'Sorry, no posts matched your criteria.', 'textdomain' );

endif;

استایل دهی پست ها

در مثال زیر دو کار انجام می‌شود:

ابتدا برای هر پست عنوان، تاریخ، نویسنده، محتوا و دسته بندی آن نمایش داده می‌شود.
اگر ID دسته بندی پست برابر با ۳ باشد، استایل دهی آن متفاوت با سایر پست ها خواهد بود.

مثال :

<?php
// Start the Loop.
if ( have_posts() ) : 
    while ( have_posts() ) : the_post();
        /* * See if the current post is in category 3.
          * If it is, the div is given the CSS class "post-category-three".
          * Otherwise, the div is given the CSS class "post".
        */
        if ( in_category( 3 ) ) : ?>
        <div class="post-category-three">
        <?php else : ?>
        <div class="post">
        <?php endif; 
 
            // Display the post's title.
            the_title( '<h2>', ';</h2>' ); 
 
            // Display a link to other posts by this posts author.
            printf( __( 'Posted by %s', 'textdomain' ), get_the_author_posts_link() );
 
            // Display the post's content in a div.
            ?>
            <div class="entry">
                <?php the_content() ?>
             </div>
     
            <?php
            // Display a comma separated list of the post's categories.
            _e( 'Posted in ', 'textdomain' ); the_category( ', ' ); 
 
        // closes the first div box with the class of "post" or "post-cat-three"
       ?>
       </div>
 
    <?php 
    // Stop the Loop, but allow for a "if not posts" situation
    endwhile; 
 
else :
    /*
      * The very first "if" tested to see if there were any posts to
      * display. This "else" part tells what do if there weren't any.
     */
     _e( 'Sorry, no posts matched your criteria.', 'textdomain' );
  
// Completely stop the Loop.
 endif;
?>

<?php

// Start the Loop.

if ( have_posts() ) :

while ( have_posts() ) : the_post();

/* * See if the current post is in category 3.

* If it is, the div is given the CSS class "post-category-three".

* Otherwise, the div is given the CSS class "post".

if ( in_category( 3 ) ) : ?>

<?php else : ?>

<?php endif;

// Display the post's title.

the_title( '<h2>', ';</h2>' );

// Display a link to other posts by this posts author.

printf( __( 'Posted by %s', 'textdomain' ), get_the_author_posts_link() );

// Display the post's content in a div.

<?php the_content() ?>

</div>

<?php

// Display a comma separated list of the post's categories.

_e( 'Posted in ', 'textdomain' ); the_category( ', ' );

// closes the first div box with the class of "post" or "post-cat-three"

</div>

<?php

// Stop the Loop, but allow for a "if not posts" situation

endwhile;

else :

* The very first "if" tested to see if there were any posts to

* display. This "else" part tells what do if there weren't any.

_e( 'Sorry, no posts matched your criteria.', 'textdomain' );

// Completely stop the Loop.

endif;

جلسه آموزش حلقه های وردپرس نیز به پایان رسید.

در جلسه بعد توابع قالب را آموزش خواهیم داد.

به اشتراک بگذارید

دیدگاه کاربران

تعداد دیدگاه : 0

پی وی لرن – آموزش برنامه نویسی و طراحی وب سایت

دوره های آموزشی آکادمی پی وی لرن (پروژه محور و ویژه بازار کار)

جلسه ۰۹ : حلقه های وردپرس

مقدمه

استفاده از حلقه های وردپرس

حلقه ها چه چیز هایی را می‌توانند نمایش دهند؟

مثال

استایل دهی پست ها

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

مفاهیم پایه

عملکرد قالب

Customizer وردپرس

امنیت

حریم خصوصی

انتشار قالب در سایت Wordpress

مطالب ویژه

دسته های اصلی

برگه ها

بلاگ