زمینه دلخواه طبقه بندی ACF Taxonomy
یکی از قابلیت های جالب توجه افزونه Advanced Custom Fields ایجاد زمینه ای برای انتخاب و نمایش طبقه بندی ها « تاکسونومی های » مختلف در مطالب است. زمینه دلخواه طبقه بندی ACF Taxonomy زمینه ای است که امکان انتخاب و نمایش تاکسونومی ها را فراهم می کند.
- تنظیمات زمینه دلخواه طبقه بندی ( Settings )
- طبقه بندی ( Taxonomy )
- ظاهر ( Appearance )
- آیا Null مجاز است؟ ( Allow Null )
- ساخت آیتم یا ترم ( Create Terms )
- ذخیره ترم ها ( Save Terms )
- خواندن ترم ها ( Load Terms )
- مقدار بازگشت ( Return Value )
قبل از هر چیز این آموزش نیازمند آشنایی با زمینه های دلخواه پیشرفته Advanced Custom Fields است. پیشنهاد می کنیم قبل از استفاده از این آموزش حتما این مقاله را مطالعه کنید.
تنظیمات زمینه دلخواه طبقه بندی ( Settings )
↑طبقه بندی ( Taxonomy )
↑این بخش برای انتخاب نوع تاکسونومی است.
ظاهر ( Appearance )
↑این قسمت نوع چینش و قالب بندی زمینه را مشخص می کند، موارد زیر در دسترس است.
- Select
- Multi Select
- Checkbox
- Radio Button
آیا Null مجاز است؟ ( Allow Null )
↑این گزینه جهت پذیرش مقادی تهی است در زمینه دلخواه انتخاب است. این زمینه می تواند بدون مقدار باشد.
ساخت آیتم یا ترم ( Create Terms )
↑در صورت فعال سازی این گزینه در هنگام ویرایش امکان ایجاد ترم جدید فراهم می شود.
ذخیره ترم ها ( Save Terms )
↑با فعال سازی این گزینه موارد انتخاب شده به آبجکت پست متصل می شوند.
خواندن ترم ها ( Load Terms )
↑ای گزینه موارد انتخاب شده را از طریق آبجکت پست فراخوانی می کند.
مقدار بازگشت ( Return Value )
↑قدار برگشتی، مقداریست که در هنگام نمایش زمینه در قالب نمایش داده می شود. این مقدار می تواند آبجکت ترم یا شناسه «ایدی» ترم باشد.
نمایش زمینه دلخواه طبقه بندی در قالب ( Template usage )
↑نمایش زمینه بر اساس مقادیر بازگشت، در تنظیمات زمینه بوده ( آبجکت ترم یا شناسه ترم )
نمایش تکی ( Single Value )
↑نمایش تکی، برای مثال زمانی که در تظیمات ظاهر زمینه Select یا Radio Button انتخاب شده باشد.
<?php
$term = get_field('taxonomy_field_name');
if( $term ): ?>
<h2><?php echo esc_html( $term->name ); ?></h2>
<p><?php echo esc_html( $term->description ); ?></p>
<?php endif; ?>
نمایش چند تایی ( Multiple Value )
↑برای مثال زمانی که در تظیمات ظاهر زمینه Multi Select یا Checkbox انتخاب شده باشد.
<?php
$terms = get_field('taxonomy_field_name');
if( $terms ): ?>
<ul>
<?php foreach( $terms as $term ): ?>
<h2><?php echo esc_html( $term->name ); ?></h2>
<p><?php echo esc_html( $term->description ); ?></p>
<a href="<?php echo esc_url( get_term_link( $term ) ); ?>">View all '<?php echo esc_html( $term->name ); ?>' posts</a>
<?php endforeach; ?>
</ul>
<?php endif; ?>
نمایش مقدار انتخاب شده طبقه بندی ( values from a selected term )
↑<?php
$term = get_field('taxonomy_field_name');
if( $term ): ?>
<h2>Term name: <?php echo esc_html( $term->name ); ?></h2>
<p>Term color: <?php the_field('color', $term); ?></p>
<?php endif; ?>