قسمت ۵ – تابع get_terms در تکسانومی / Taxonomy

در این بخش قصد داریم تا یکی از کاربردی ترین توابع تکسانومی / Taxonomy به نام get_terms را آموزش دهیم. تابع get_terms مجموعه ای از ترم ها را به صورت آبجکت برمیگرداند و به عنوان ورودی آرایه از تنظیمات یا مقادیر دریافت میکند. در کد زیر ما تابع get_terms را مقدار دهی و فراخوانی کردیم و در ادامه مقادیری که میتواند دریافت کند را توضیح داده ایم پس با ما همراه باشید.

$args = array(
    'taxonomy' 				=> 'category',
    'orderby' 				=> 'name',
    'order' 				=> 'ASC',
    'hide_empty' 			=> true,
    'include' 				=> '',
    'exclude' 				=> '',
    'exclude_tree' 			=> '',
    'number' 				=> '',
    'offset' 				=> '',
    'fields' 				=> 'all', //all,ids,id=>parent,names,count,id=>name,id=>slug
    'name' 					=> '',
    'slug' 					=> '',
    'hierarchical' 			=> true,
    'description__like' 	=> '',
    'child_of' 				=> false,
    'childless' 			=> false,
);
$terms = get_terms($args);
echo '<pre>';
print_r($terms);
echo '<pre>';

taxonomy

اگر بخواهیم تکسانومی های پیش فرض وردپرس را نمایش دهیم از عبارت category استفاده میکنیم و اگر بخواهیم تکسانومی های سفارشی که خودمان ایجاد کردیم را نمایش دهیم کافی است نام تکسانومی خود را در این بخش وارد کنیم.

orderby

میتواند لیست یا دراپ دان ما را بر اساس مواردی مثل id, name, slug, count مرتب کند. مثلا اگر orderby را برابر با count قرار دهیم لیست یا دراپ دان ما را بر اساس تعداد نوشته مرتب مبکند.

order

توسط orderby میتوانستیم مدل مرتب سازی لیست خود را مشخص کنیم و توسط order میتوانیم صعودی بودن یا نزولی بودن آن را مشخص کنیم. و دو مقدار ASC و یا DESC میتواند دریافت کند.

hide_empty

مشخص میکند که اگر در دسته ای پستی وجود نداشت آن را چاپ کند یا خیر و مقدار true یا false میگیرد.

include

دقیقا برعکس exclude میباشد و تنها مواردی را نمایش میدهد که ID آن برای include تعریف کرده باشیم و هم میتواند یک ID بگیرد هم آرایه ای از ID ها.

exclude

هم میتواند یک ID بگیرد هم آرایه ای از ID ها و کار آن این است که ID های مشخص شده را نمایش ندهد.

exclude_tree

فقط در لیست ها کاربرد دارد، یک دسته را همراه با فرزندان آن حذف میکند و میتواند یک ID دسته و یا آرایه ای از ID های دسته ها را برای حذف بگیرد.

number

توسط فیلد number میتوانیم تعداد ترمی که قرار است برای ما برگرداند را مشخص مثلا اگر آن را برابر با ۳ قرار دهیم فقط ۳ ترم برای ما بر میگرداند و اگر آن را خالی بزاریم ‘ ‘ همه را بر میگرداند.

offset

ارتباط مستقیم با فیلد number دارد و مثلا اگر به فیلد number عدد ۳ بدیم که ۳ ترم برای ما برگرداند توسط offset میتوانیم مشخص کنیم آن ۳ تای چندم را نشان دهد مثلا اگر عدد ۲ بدهیم ۳ ترم دوم را برای ما برمیگرداند. برای صفحه بندی خیلی میتواند مناسب و کاربردی باشد.

fields

توسط فیلد fields میتوانیم مشخص کنیم چه آبجکت هایی از یک ترم را برای ما برگرداند. مثلا اگر مقدار all را به آن نسبت دهیم همه آبجکت ها را بر میگرداند و یا اگر مقدار ids را نسبت دهیم فقط id های آن را بر میگرداند. مقادیری که میتواند دریافت کند به شرح ذیل است :

• مقدار all : همه آبجکت های ترم را بر میگرداند.
• مقدار ids : فقط id های ترم را بر میگرداند.
• مقدار id=>parent : فقط id های والد یک ترم را بر میگرداند.
• مقدار names :  فقط نام های ترم را بر میگرداند.
• مقدار count : فقط تعداد ترم را بر میگرداند.
• مقدار id=>name : فقط نام و id ترم را برمیگرداند.
• مقدار id=>slug : فقط اسلاگ یا همان نامک های ترم را بر میگرداند.

name

این فیلد نام یک ترم را دریافت میکند و فقط آن ترم را برای ما بر میگرداند.

slug

این فیلد اسلاگ یا همان نامک یک ترم را دریافت میکند و فقط آن ترم را برای ما بر میگرداند.

hierarchical

مقدار true یا false میگیرد و مشخص میکند که سلسله مراتب رعایت شود یا خیر. مثلا فرزندان را مقداری جلو تر از والد ها نمایش میدهد.

description__like

زمانی که میخواهیم یک دسته ایجاد کنیم علاوه بر نام و نامک و … فیلدی به نام توضیحات دارد در صورتی که description__like را برابر با رشته ای قرار دهیم، این رشته اگر در توضیحات ترمی وجود داشت، آن ترم را برای ما بر میگرداند. مانند دستور like در sql یا my-sql میباشد.

child_of

فقط ترم هایی را برمیگرداند که فرزند دسته ای باشد که ما ID آن را به child_of نسبت داده ایم.

childless

مقدار true یا false میگیرد و اگر true باشد فقط ترم هایی را برمیگرداند که فرزند باشد و هیچ پرنتی را بر نمیگرداند.