دریافت term های دلخواه در وردپرس با استفاده از تابع get_terms

در موارد زیادی نیاز می شود که term ها با اطلاعات مشخصی را دریافت نماییم. مثلا در صفحه اصلی سایت، ما تصمیم گرفتیم چند term مهم را در بالای مطالب به نمایش بگذاریم تا کاربران به راحتی به مطالب دلخواه خود دست یابند. تابع get_terms بهترین تابع برای انجام این کار می باشد. این تابع فیلترینگ قدرتمندی دارد و می تواند term های کاملا شخصی سازی شده ای را به ما تحویل دهد.

مقدار برگردانده شده آرایه ای از آبجکت های حاوی اطلاعات term ها می باشد.

get_terms( array|string $args = array(), array|string $deprecated = '' )

1- پارامتر args

این پارامتر شامل کلیه فیلترهای ممکن برای شخصی سازی term های مدنظر ما می باشد. پارامترهای مهم این آرایه در زیر وارد شده اند:

[
   'taxonomy' => null,
   'orderby' => 'name',
   'order' => 'ASC',
   'hide_empty' => true,
   'include' => array(),
   'exclude' => array(),
   'exclude_tree' => array(),
   'number' => '',
   'fields' => 'all',
   'name' => '',
   'slug' => '',
   'term_taxonomy_id' => '',
   'name__like' => '',
   'description__like' => '',
   'child_of' => 0,
   'parent' => '',
   'childless' => false,
]

اگر هیچ پارامتری وارد نشود، تمام term های موجود برگردانده می شود.

اگر هیچ تکزانامی ای وجود نداشته باشد، شی wp_error برگردانده می شود.