زمینه دلخواه متن - ACF Text Field

زمینه دلخواه متن – ACF Text Field

پر استفاده ترین فیلدها معمولا فیلدهای متنی هستند یکی از قابلیت های افزونه Advanced Custom Fields ایجاد زمینه دلخواه متن ( Input Text ) بدون نیاز به کدنویسی است.

زمینه های متنی بیشتر برای وارد کردن رشته های متنی کوتاه مورد استفاده قرار می گیرند. این زمینه قبلا دارای فرمت بازگشت بود که در نسخه 5.0.0 افزونه حذف شد.

قبل از ادامه این مبحث پیشنهاد می کنیم حتما مقاله آشنایی با افزونه Advanced Custom Fields را مطالعه کنید. استفاده از این آموزش نیازمند آشنایی با افزونه ACF است.

تنظیمات زمینه دلخواه متن ( Settings )

مقدار پیشفرض ( Default Value )

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

نگهدارنده مکان متن ( Placeholder Text )

این قسمت برای اضافه توضیحات و یا متن راهنمای کوتاهی درون فیلد استفاده می شود. متن راهنما به صورت کمرنگ درون فیلد قرار می گیرد و با وارد کردن اولین کاراکتر مخفی می شود.

نکته : این متن فقط جنبه راهنما در صفحه ویرایش مطلب را دارد

پیشوند ( Prepend )

محتوای وارد شده قبل از زمینه نمایش داده می شود، اضافه کردن Html در این بخش مجاز است.

پسوند ( Append )

محتوای وارد شده بعد از زمینه نمایش داده می شود، اضافه کردن Html در این بخش مجاز است.

محدودیت کاراکتر ( Character Limit )

این بخش حداکثر طول کاراکتر مجاز را تعیین می کند. برای نامحدود بودن این قسمت را خالی بگذارید.

تنظیمات زمینه دلخواه متن - ACF Text Field
تنظیمات زمینه دلخواه متن – ACF Text Field
زمینه دلخواه متن - ACF Text Field
زمینه دلخواه متن – ACF Text Field

نمایش زمینه دلخواه متن ( Template usage )

نمایش مقدار ( Display Value )

مثال زیر مقدار زمینه را درون تگ هدینگ h2 نمایش می دهد.

<h2><?php the_field('heading'); ?></h2>

دستورات شرطی ( Conditional )

در مثال زیر در صورتی که مقدار زمینه name برابر academy باشد کاری را انجام می دهد.

$confirm = get_field('name');
if( $confirm === 'academy' ) {
    // Do something.
}
?>

نکته : زمینه های عدد، پست الکترونیکی، رمزعبور و URL از نظر تنظیمات و نمایش مقدار عملکردی مشابه زمینه دلخواه متن دارند و تفاوت این زمینه ها فقط در نوع مصرف زمینه ها است.

زمینه های افزونه Advanced Custom Fields