آموزش وردپرس ، توابع مهم – بخش دوم

%d8%a2%d9%85%d9%88%d8%b2%d8%b4-%d9%88%d8%b1%d8%af%d9%be%d8%b1%d8%b3-%d8%8c%e2%80%8c-%d8%aa%d9%88%d8%a7%d8%a8%d8%b9-%d9%85%d9%87%d9%85-%d8%a8%d8%ae%d8%b4-%d8%af%d9%88%d9%85-wpmen

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


بخش اول – معرفی

ده تابع پرکاربرد برای کار با Category در این قسمت توضیح داده خواهد شد، لیست این توابع در زیر آورده شده است:

  1. get_categories
  2. get_category
  3. get_cat_ID
  4. get_cat_name
  5. get_category_link
  6. get_the_category
  7. single_cat_title
  8. is_category
  9. the_category
  10. wp_list_categories

بخش دوم – نحوه استفاده

۱، get_categories

برگردان این تابع لیستی از دسته بندی ها می باشد، این تابع دارای پارامتر های متفاوتی است که می توانید با آن ها خروجی های متفاوتی تولید کنید در زیر لیست این پارامتر ها را آورده ایم:

'taxonomy' 'orderby' 'order' 'hide_empty' 'include' 'exclude' 'exclude_tree' 'number' 'offset' 'fields' 'name' 'slug' 'hierarchical' 'search' 'name__like' 'description__like' 'pad_counts' 'get' 'child_of' 'parent' 'childless' 'cache_domain' 'update_term_meta_cache' 'meta_query' 'meta_key' 'meta_value'

برای درک بهتر استفاده از این تابع به وسیله پارامتر های مختلف به مثال زیر توجه کنید:

<select name="event-dropdown"> 
    <option value=""><?php echo esc_attr_e( 'Select Event', 'textdomain' ); ?></option> 
    <?php 
    $categories = get_categories( array( 'child_of' => 10 ); 
    foreach ( $categories as $category ) {
        printf( '<option value="%1$s">%2$s (%3$s)</option>',
            esc_attr( '/category/archives/' . $category->category_nicename ),
            esc_html( $category->cat_name ),
            esc_html( $category->category_count )
        );
    }
    ?>
</select>

در مثال بالا لیستی از دسته بندی های که زیر مجموعه دسته بندی با آی دی ۱۰ می باشد را ساختیم و درون متغییر categories ریختیم سپس با استفاده از حلقه محتوای آن ها را نمایش دادیم.

 

۲، get_category

با استفاده از این تابع می توانید دسته بندی مورد نظر خود را تنها با دادن آی دی آن برگردانید یا می توانید لیستی از دسته بندی ها را برگردانید، مثال:

<?php $thisCat = get_category(15); ?>

در مثال بالا دسته بندی با شماره آی دی ۱۵ را گرفتیم و درون متغییر thisCat ریختیم.

 

۳، get_cat_ID

برای دریافت آی دی یک دسته بندی کافیست از این تابع استفاده کنید، مثال:

<?php get_cat_ID( $cat_name ) ?>

با دادن نام دسته بندی به این تابع می توانید آی دی دسته بندی مذکور را برگردانید.

 

۴، get_cat_name

دریافت نام دسته بندی، با دادن آی دی دسته بندی مورد نظر را بدست بیاورید. مثال:

<?php get_cat_name( $cat_id ) ?>

 

۵، get_category_link

برای دریافت لینک دسته بندی می توانید این تابع را مورد استفاده قرار دهید، مثال:

<?php get_category_link( $category_id ); ?> 

 

۶، get_the_category

دریافت دسته بندی های مربوط به پست جاری، یا پست مورد نظر با دادن آی دی پستی که در نظر دارید دسته بندی آن را بگیرید از این تابع استفاده کنید، مثال:

$categories = get_the_category();
$separator = ' ';
$output = '';
if ( ! empty( $categories ) ) {
    foreach( $categories as $category ) {
        $output .= '<a href="' . esc_url( get_category_link( $category->term_id ) ) . '" alt="' . esc_attr( sprintf( __( 'View all posts in %s', 'textdomain' ), $category->name ) ) . '">' . esc_html( $category->name ) . '</a>' . $separator;
    }
    echo trim( $output, $separator );
}

 

۷، single_cat_title

برای دریافت عنوان دسته بندی از این تابع استفاده کنید، مثال:

<p><?php single_cat_title('Currently browsing '); ?>.</p>

 

۸، is_category

این تابع می تواند تشخیص دهد صفحه جاری، صفحه دسته بندی می باشد یا خیر ، یا می توانید تعیین کنید اگر صفحه جاری صفحه دسته بندی خاصی بود موردی را نمایش دهید، مثال:

is_category();
بررسی صفحه جاری

is_category('9');
زمانی که صفحه جاری دسته بندی ۹ را نمایش دهد

 

۹، the_category

این تابع باید درون حلقه اجرا شود و برگردان آن نمایش دسته بندی ها با لینک می باشد، همچنین می توانید تعیین کنید که مابین دسته بندی ها چه چیزی قرار گیرد، مثال:

<?php the_category( ' ' ); ?>

<?php the_category( ', ' ); ?>


۱۰، wp_list_categories

برگردان این تابع لیستی از دسته بندی ها می باشد که درون ساختار HTML قرار گرفته اند، این تابع دارای پارامتر هایی می باشد که در زیر آورده ایم:

'show_option_all' 'show_option_none' 'orderby' 'order' 'show_count' 'hide_empty' 'use_desc_for_title' 'feed' 'feed_type' 'feed_image' 'child_of' 'exclude' 'exclude_tree' 'echo' 'current_category' 'hierarchical' 'title_li' 'hide_title_if_empty' 'depth' 'taxonomy' 'separator'

از این تابع با پارامتر ها می توانید به صورت زیر استفاده کنید:

<ul>
    <?php wp_list_categories( array(
        'orderby' => 'name', مرتب سازی براساس نام
        'include' => array( 3, 5, 9, 16 )  نمایش دسته بندی ها با این آی دی 
    ) ); ?> 
</ul>

 

منبع :‌ مردان وردپرس

تاریخ آخرین بروزرسانی : ۹ مهر ۱۳۹۵
صادق مهدی لو

زمانی که تنها دوازده سال داشتم ، پدرم برای کادوی تولدم کامپیوتری را خرید. او هرگز نمی دانست که این وسیله زندگی من را تغییر خواهد داد ، و اکنون من یک برنامه نویس هستم...

ارسال نظر

آدرس الکترونیکی شما نمایش داده نمی شود *

Time limit is exhausted. Please reload CAPTCHA.