راهنمای جامع افزونه Advanced Custom Fields در وردپرس

افزونه Advanced Custom Fields که به اختصار ACF شناخته می‌شود، یکی از قدرتمندترین ابزارهای وردپرس برای افزودن، مدیریت و نمایش فیلدهای سفارشی (Custom Fields) در پست‌ها، برگه‌ها، محصولات ووکامرس و حتی نوع پست‌های سفارشی (CPT) است. این افزونه راهکار بسیار حرفه‌ای برای توسعه‌دهندگان و مدیران سایت‌ها فراهم می‌کند تا داده‌های ساخت‌یافته و سفارشی را بدون دردسر وارد و نمایش دهند.

چرا باید از ACF استفاده کنیم؟

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

• ایجاد فیلدهای حرفه‌ای و UI کاربرپسند: بدون نیاز به برنامه‌نویسی پیچیده.

• سازگاری کامل با قالب‌های سفارشی و ووکامرس

• توسعه سریع‌تر قالب و پنل مدیریت

انواع فیلدهای قابل استفاده در ACF

افزونه ACF بیش از 30 نوع فیلد مختلف ارائه می‌دهد، از جمله:

آموزش قدم‌به‌قدم استفاده از ACF

۱. نصب و فعال‌سازی

از پیشخوان وردپرس به مسیر:

افزونه‌ها ← افزودن ← جستجو: Advanced Custom Fields

نصب و فعال‌سازی کنید.

۲. ساخت گروه فیلد (Field Group)

از منوی «Custom Fields»، یک Field Group جدید بسازید. مثلاً:

عنوان گروه: اطلاعات تماس نویسنده

۳. افزودن فیلد جدید

مثلاً:

• نام فیلد: phone_number

• برچسب: شماره تماس

• نوع فیلد: Text

۴. تعیین محل نمایش فیلد

مثلاً:

نمایش فقط در پست‌های معمولی (Post)

نمایش فیلد در قالب وردپرس

برای نمایش فیلد در قالب، از تابع get_field() یا the_field() استفاده می‌شود.

مثال:

php
CopyEdit
<?php
$phone = get_field('phone_number');
if ($phone) {
    echo '<p>شماره تماس نویسنده: ' . esc_html($phone) . '</p>';
}
?>

مثال پیشرفته: استفاده از Repeater

اگر بخواهیم چندین شماره تماس وارد کنیم:

تعریف فیلد تکرارشونده (Repeater)

• نام فیلد: phones

• داخل آن: فیلد متنی phone_item

نمایش در قالب:

php
CopyEdit
<?php if (have_rows('phones')): ?>
    <ul>
        <?php while (have_rows('phones')): the_row(); ?>
            <li><?php the_sub_field('phone_item'); ?></li>
        <?php endwhile; ?>
    </ul>
<?php endif; ?>

نسخه حرفه‌ای ACF (Pro)

در نسخه Pro ویژگی‌های بیشتری در دسترس است:

• Repeater Field

• Flexible Content Field

• Gallery Field

• Clone Field

• بلوک‌های Gutenberg سفارشی

ادغام با ووکامرس

برای افزودن فیلدهای خاص به محصولات:

• محل نمایش را روی محصول تنظیم کنید.

• سپس در قالب single-product.php از get_field() استفاده کنید.

نکات امنیتی

• از esc_html()، esc_url() و wp_kses() برای خروجی امن استفاده کنید.

• همیشه بررسی کنید که فیلد مقدار دارد (null نیست) قبل از نمایش.

نتیجه‌گیری

افزونه ACF یکی از ابزارهای ضروری برای هر توسعه‌دهنده وردپرس است. این افزونه نه‌تنها ساختاردهی به داده‌ها را ساده می‌کند بلکه امکان توسعه صفحات داینامیک، حرفه‌ای و سفارشی را با سرعت بالا فراهم می‌سازد.