گرفتن اطلاعات یک term در وردپرس با استفاده از تابع get_term

تاریخ: 23 نوامبر 2019

این تابع، یک تابع بسیار پرکاربرد در هسته وردپرس می باشد. اگر در خود فایل taxonomy.php نام تابع را جستجو کنید، خواهید دید از این تابع حدود 18 بار در توابع مختلف این فایل استفاده شده است و این خود نشان از اهمیت این تابع دارد.

 


get_term( int|WP_Term|object $term, string $taxonomy = '', string $output = OBJECT, string $filter = 'raw' )

 

این تابع، آیدی term را می گیرد و آبجکت آن که حاوی کلیه اطلاعات آن term در دیتابیس می باشد را بر می گرداند. در کل در وردپرس، آبجکت ها تمام اطلاعات موجود در دیتابیس را در خود دارند. مانند آبجکت term ، آبجکت post، آبجکت user، آبجکت taxonomy و …

پارامترهای تابع get_term

1- پارامتر term

در این پارامتر باید مشخص کنیم که اطلاعات مربوط به کدام term را نیاز داریم.

الف) آی دی term: فرض کنید آی دی آن term را داریم و می خواهیم اطلاعاتی مانند slug یا name آن term را داشته باشیم. اگر آی دی را در term وارد نماییم و تابع را چاپ کنیم، کل آبجکت term را مشاهده خواهیم کرد.

 

 
// insert term id in get_term
$term = get_term(30);
print_r($term);

// out
WP_Term Object
(
    [term_id] => 30
    [name] => sample
    [slug] => sample
    [term_group] => 0
    [term_taxonomy_id] => 30
    [taxonomy] => category
    [description] => 
    [parent] => 0
    [count] => 2
    [filter] => raw
)

//access to object parameters
$term_id = $term->term_id;
$name = $term->name;
$slug = $term->slug;
$term_group = $term->term_group;
$term_taxonomy_id = $term->term_taxonomy_id;
$taxonomy = $term->taxonomy;
$description = $term->description;
$parent = $term->parent;
$count = $term->count;

2- پارامتر taxonomy

در این پارامتر می توانیم taxonomy مربوط به این term را وارد نماییم. وارد کردن این پارامتر ضروری نیست ولی اگر قصد ایمپرت آن را داریم باید به صحت آن اطمینان داشته باشیم. چون اگر taxanomy صحیح نباشد، شی WP_error برگردانده می شود.

 

3- پارامتر output

در حالت پیشفرض، اطلاعات یک term به صورت آبجکت برگردانده می شود. اگر نیاز داشته باشیم خروجی ما به صورت یک آرایه عددی باشد، کافیست مقدار این پارامتر را ARRAY_N بگذاریم. اگر می خواهیم به صورت آرایه غیرعددی باشد، مقدار آن را ARRAY_A می گذاریم.

 

4- پارامتر filter

در این پارامتر مشخص می کنیم که آبجکت خروجی بر چه مبنایی فیلتر شود. این مقدار ضروری نمی باشد و پیشفرض آن، raw است.

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *


آموزش term در وردپرس

17 مقاله آموزشی

  • آشنایی با term ها در وردپرس
  • دریافت لینک term در وردپرس با استفاده از تابع get_term_link
  • دریافت term های دلخواه در وردپرس با استفاده از تابع get_terms
  • به روزرسانی term در وردپرس با استفاده از تابع wp_update_term
  • افزودن term در وردپرس با استفاده از تابع wp_insert_term
  • حذف term با تکزانامی category در وردپرس با استفاده از تابع wp_delete_category
  • حذف term در وردپرس با استفاده از تابع wp_delete_term
  • چک کردن وجود یا عدم وجود term در وردپرس با استفاده از تابع term_exists
  • عملیات crud متادیتای term ها در وردپرس
  • بررسی وجود taxonomy با داشتن نام آن taxonomy
  • دریافت اطلاعات taxanomy با استفاده از نام taxonomy در وردپرس
  • گرفتن فرزندان یک term در وردپرس با استفاده از تابع get_term_children
  • گرفتن مطالب با term های خاص در وردپرس با استفاده از تابع get_objects_in_term
  • گرفتن اطلاعات یک term در وردپرس با استفاده از تابع get_term
  • گرفتن اطلاعات یک term در وردپرس با استفاده از تابع get_term_by
  • چک کردن وجود یا عدم وجود term در یک پست
  • نمایش term های یک پست در وردپرس
  • طراحی افزونه وردپرس