افزونه کاربردی زمینه های سفارشی پیشرفته | پلاگین ACF Pro
معرفی افزونه زمینه های دلخواه پیشرفته
در وردپرس قبل از اينكه Advanced Custom Fields را داشته باشيد مي‌توانستيد يك پست ايجاد كنيد و براي آن پست عنوان انتخاب كنيد، تعدادي تگ بزنيد، دسته انتخاب كنيد و تصوير شاخص بگذاريد. ولي اگر به فيلدهاي بيشتري نياز داشته باشید باید چکار کنید؟
اگر در سايت خود كتاب معرفي مي كنيد و دلتان ميخواهد كه هنگام نوشتن یک پست معرفي كتاب، در فيلدهاي مختلفي نام نويسنده،مترجم، ناشر سال نشر، شابك و... را درج كنيد تا به صورت منظم در قالب نمایش داده شود، آن وقت چه ميكنيد؟
مشخص است! سراغ افزونه زمینه های دلخواه پیشرفته مي‌رويد.
- قابلیت اتصال به المنتور
- ایجاد داده های دلخواه و داینامیک در EDD و Woocommerce
Advanced Custom Fields Pro (ACF Pro) یک افزونه حرفه‌ای وردپرس است که به شما امکان می‌دهد تا به راحتی فیلدهای سفارشی را به وب‌سایت خود اضافه کنید. با استفاده از ACF Pro، شما میتوانید تجربه کاربری منحصر به فردی را برای بازدیدکنندگان وب‌سایت خود ایجاد کنید و به طور کامل از قدرت وردپرس بهره‌برداری کنید.
ویژگیهای افزونه ACF Pro
- ایجاد فیلدهای سفارشی پیشرفته: از متن و تصویر گرفته تا تاریخ، رنگ و انتخاب گر موقعیت جغرافیایی.
- قالب‌های قابل تکرار: امکان ایجاد قالب‌های قابل تکرار برای محتوای مشابه و تکراری.
- ابزار مدیریت صفحه: کنترل کامل بر روی نمایش و مخفی کردن فیلدهای سفارشی بر اساس شرایط مختلف.
- امکان استفاده از فیلدهای سفارشی در محتوای وب‌سایت: اضافه کردن فیلدهای سفارشی به محتوای وب‌سایت به راحتی با استفاده از شورتکد و توابع PHP.
- سازگاری با افزونه‌های محبوب وردپرس: امکان کار کردن به صورت همزمان با افزونه‌های محبوب مانند WooCommerce و افزونه WPML
با استفاده از ACF Pro، شما میتوانید وب‌سایت خود را به یک سطح جدید ارتقا دهید و تجربه کاربری منحصر به فردی را برای بازدیدکنندگان خود فراهم کنید. پس از خرید ACF Pro، شما به پشتیبانی حرفه‌ای و بروزرسانی‌های مداوم دسترسی خواهید داشت. اکنون ACF Pro را تهیه کنید و به جمع هزاران کاربر راضی ما بپیوندید!
- آیا می دانید آقای chrislema از بزرگترین فعالان وردپرس در سایت خود این افزونه را به جزء افزونه هایی که هر سایت باید داشته باشد نام برده است؟
- آیا می دانید گروه wpmudev به عنوان بزرگترین و حرفه ای ترین گروه های تولید کننده افزونه و قالب وردپرس و همچنین بزرگترین فروم وردپرسی این افزونه را جزء 25 افزونه ای که باید حتما داشته باشید نام برده؟
- آیا می دانید کمپانی فوق مشهور لیندا (lynda) یک دوره آموزش اختصاصی این افزونه را ارائه کرده است؟
- آیا می دانستید آقای Chris Coyier نویسنده سایت css-tricks این افزونه را جزء افزونه هایی که همیشه استفاده می کند معرفی کرده است؟
چه چیزی در این افزونه وجود دارد؟
این افزونه دارای بیش از 25 نوع فید مختلف مانند لیست باکس، متن، ایمیل, عدد، دکمه های رادیویی، انتخاب نوشته و برگه، انتخاب دسته و تاکسونومی، گوگل مپ، انتخاب رنگ و ... است. در نسخه Pro این افزونه، چهار فیلد بسیار پرطرفدار که قبلا جداگانه فروخته می شدند یکجا آورده شده اند که عبارتند از گالری، تکرار کننده (Repeater)، صفحه تنظیمات و محتوای انعطاف پذیر (Flexible Content) که در ادامه به آنها خواهیم پرداخت.
افزونه زمینه های دلخواه پیشرفته چگونه کار می کند؟
کار با این افزونه فوق راحت است. به سادگی فیلدهای دلخواه خود را می سازید، نوع آنرا انتخاب می کنید و مکان نمایش آنرا تعیین می کنید و در نهایت در قالب خود فراخوانی می کنید. مکان نمایش: می توانید مکان نمایش زمینه ها را نیز دلخواه سازی کنید. برای مثال مجموعه ای از فیلدها را در دسته "کتاب ها" نمایش دهید و مجموعه ی دیگری از فیلدها را بسازید و در دسته "همایش ها" نمایش بدهد. یا حتی بیشتر از این می توانید تعیین کنید مجموعه ای از زمینه های دلخواه را برای "کاربرانی" که "سطح دسترسی ادمین" دارند و در حال نوشتن در دسته "کتاب ها" هستند نمایش دهد! بی نهایت جای کار دارید ! فراخوانی در قالب: به کمک یک کد ساده PHP یعنی (the_field) می توانید مقادیر ذخیره شده در زمینه های دلخواه را در قالب نمایش دهید.
نسخه حرفه ای (Pro) با نسخه رایگان چه تفاوتی دارد؟
علاوه بر چهار زمینه پیشرفته اشاره شده یعنی "صفحه تنظیمات"، "گالری تصاویر"، "تکرار شونده" و "محتوای انعطاف پذیر" که فقط در نسخه حرفه ای وجود دارد، فارسی سازی این نسخه حرفه ای به صورت تخصصی و کاملا قابل فهم انجام شده. از طرفی سازگاری با فارسی و RTL نیز به صورت کامل در این نسخه دیده شده. ما همواره نسخه اورجینال و به روز را برای شما فراهم می کنیم که قیمت آن 100 دلار می باشد ! همچنین به عنوان هدیه یک فیلد تاریخ شمسی نیز برای شما آماده کردیم !!
معرفی افزونه زمینه های دلخواه پیشرفته
در نسخه جدید برای گوتنبرگ بلاک های دلخواه بسازید! قابلیتی منحصر به فرد و بسیار پر کاربرد
حتما در وردپرس از گوتنبرگ استفاده کردید . اما تا قبل از این ایجاد بلاک های دلخواه برای گوتنبرگ خیلی سخت بود. به کمک acf pro می توانید مثل قبل به آسانی با تمام امکانات شگفت انگیز آن برای گوتنبرگ، بلاک دلخواه تولید کنید و تم های خود را به حالت شگفت انگیزی تغییر دهید.
زمینه گالری تصاویر
به کمک زمینه گالری این افزونه، می توانید در صفحه ارسال یک پست جدید می توانید به صورت بسیار شیک و ساده و با قابلیت درگ ، مجموعه ای از تصاویر را از کاربر بگیرید:
زمینه صفحه تنظیمات در افزونه زمینه های دلخواه پیشرفته
به کمک زمینه "صفحه تنظیمات"، می توانید برای پوسته خود یک Option Page یا همان صفحه تنظیمات بسازید. فرض کتید که قرار است کاربر و یا مشتری شما در سایت به دلخواه شعار بالای سایت یا متن کپی رایت پایین سایت، یا تصویر هدر (Header) سایت را تغییر دهد. شما می توانید فیلدهای مورد نیاز این تغییرات را به سادگی ساخته و فقط با انتخاب محل نمایش این زمینه ها در "صفحه تنظیمات" این امکان را به کاربر بدهید! تمام داده های "صفحه تنظیمات" به صورت گلوبال ذخیره می شود و هرکجا که مایل باشید می توانید آنها را فراخوانی کنید.
زمینه تکرار شونده در افزونه زمینه های دلخواه پیشرفته
به کمک فیلد تکرار شونده می توانید مجموعه ای از داده ها را به تعداد نامحدود از کاربر بگیرید. برای مثال در زیر ساخت اسلایدر قالب را در صفحه تنظیمات از کاربر به کمک فیلد تکرار شونده دریافت می کنیم. برای هر اسلاید 3 فیلد "تصویر"، "نشانی" و "متن" از کاربر گرفته می شود و کاربر می تواند نا محدود اسلاید را دریافت کند:
امکانات افزونه ACF:
- رابط کاربری دوستانه: رابط کاربری آسان برای ایجاد و مدیریت فیلدهای سفارشی.
- انواع مختلف فیلد: پشتیبانی از انواع فیلدها از جمله متن، تصویر، فایل، تکرارکننده، چک باکس و ...
- منطق شرطی: تعیین شرایط نمایش یا مخفی کردن فیلدها بر اساس ویژگیهای دیگر.
- قوانین مکان: مکان‌یابی دقیق نمایش فیلدها بر اساس موقعیت در صفحات ویرایش وردپرس.
- فیلدهای تکرارکننده: ایجاد سری‌های تکرارکننده از فیلدها برای مدیریت مجموعه‌های داده.
- فیلد محتوای انعطاف‌پذیر: ایجاد طرح‌های پویا با ترکیب انواع مختلف فیلدها در یک گروه فیلد.
- صفحات گزینه: ایجاد صفحات گزینه برای تنظیمات و پیکربندی‌های مرتبط با قالب یا افزونه.
امکانات نسخه افزونه ACF Pro:
- تکمیل‌ترین نسخه: دسترسی به تمامی امکانات ACF با نسخه حرفه‌ای.
- تکمیل‌ترین انواع فیلد: اضافه شدن انواع فیلد پیشرفته‌تر از جمله فیلد Google Map و Date Picker.
- ادغام با دیگر افزونه‌ها: امکان ادغام با افزونه‌های معروف مانند افزونه ووکامرس و WordPress Multilingual.
- قابلیت به‌روزرسانی: دریافت به‌روزرسانی‌های مداوم و پشتیبانی از کاربران.
- ویژگیهای امنیتی: امکانات امنیتی بیشتر برای حفاظت از داده‌های شما.
- پشتیبانی اختصاصی: دسترسی به پشتیبانی اختصاصی و حرفه‌ای از تیم ACF.
- توسعه دهندگان: ابزارها و قابلیت‌های بیشتر برای توسعهدهندگان.
برخی از سایت های مرجعی که افزونه زمینه های دلخواه پیشرفته فوق قدرتمند را معرفی و آموزش داده اند:
- event espresso
- nvision solutions
- web ascender
- codeforest
- leadin
- untame
- depiction
- buckeyeinteractive
افزونه های دیگری که با این افزونه هماهنگ می باشند:
- WP All Import
- Codepress Admin Columns
- Duplicate Post
- WP Fake Image Replacer
- WordPress - Ajax Search Pro for WordPress
افزونه های دیگری که برای این افزونه نوشته شده است :
بله ! برای این افزونه ، افزونه نوشته اند ! گزینه های اضافی و امکانات بیشتر برای حرفه ای ها
- Flexible Content Fold
- PayPal Field
- Text Limiter
- WordPress Wysiwyg
- Gravity Forms Field
- Date & Time Picker
- Contact Form 7 Field
- Taxonomy Field
- NextGEN Gallery Field add-on
- Taxonomy Field add-on
- Address Field add-on
- ACF Table Editor Field
- و تاریخ شمسی که ما برای شما در بسته ی افزونه به صورت رایگان گذاشتیم...
برای دانلود آخرین نسخه اورجینال و گارانتی دار، اقدام کنید
گاهی با خودم فکر می کنم بدون این افزونه بعضی ها چطور با وردپرس کار می کنند؟! :)
توسعه یافته برای توسعه دهندگان:
<h1><?php the_title(); ?></h1>
<?php if( get_field('sub_heading') ): ?>
<h2><?php the_field('sub_heading'); ?></h2>
<?php endif; ?>
<div class="hero">
<?php $image = get_field('hero_image'); ?>
<img src="<?php echo $image['url']; ?>" alt="<?php echo $image['alt']; ?>" />
</div>
<?php if( have_rows('event') ): ?>
<ul>
<?php while( have_rows('event') ): the_row(); ?>
<li>
<a href="<?php the_sub_field('url'); ?>"><?php the_sub_field('title'); ?></a>تاریخچه به روزرسانی ها
13-05-1403 6.3.4 به روز رسانی نسخه
20-04-1403 6.3.3 به روز رسانی نسخه
23-03-1403 6.3.1.2 به روز رسانی نسخه
05-03-1403 6.3.0.1 به روز رسانی نسخه
29-02-1403 6.2.10 به روز رسانی نسخه و حذف پلاگین هدیه تقویم شمسی برای همیشه بعد از سالها
22-01-1403 6.2.9 به روز رسانی نسخه
22-12-1402 6.2.7 به روز رسانی نسخه
28-11-1402 6.2.6.1 به روز رسانی نسخه
27-10-1402 6.2.5 به روز رسانی نسخه
02-10-1402 رفع مشکل خطای لایسنس - اترجمه اساسی افزونه
رفع مشکل لایسنس
21-09-1402 6.2.4 به روز رسانی نسخه
07-08-1402 6.2.2 به روز رسانی نسخه
20-06-1402 6.2.1.1 به روز رسانی نسخه
28-05-1402 6.2.0 به روز رسانی نسخه
17-05-1402 6.1.7 به روز رسانی نسخه
17-04-1402 به روز رسانی نسخه 6.1.7
19-02-1402 به روز رسانی نسخه 6.1.6
04-02-1402 به روز رسانی نسخه 6.1.4
15-01-1402 به روز رسانی نسخه 6.1.1
08-11-1401 به روز رسانی نسخه 6.0.7
26-09-1401 به روز رسانی نسخه 6.0.6
02-09-1401 به روز رسانی نسخه 6.0.5
23-08-1401 به روز رسانی نسخه 6.0.4
01-08-1401 به روز رسانی نسخه 6.0.3
17-07-1401 به روز رسانی نسخه 6.0.2
05-05-1401 به روز رسانی نسخه 5.12.3
28-01-1401 به روز رسانی نسخه 5.12.2
08-01-1401 به روز رسانی نسخه 5.12.1
07-12-1400 به روز رسانی نسخه 5.12
20-09-1400 به روز رسانی نسخه 5.11.4
06-09-1400 به روز رسانی نسخه 5.11.3
29-08-1400 به روز رسانی نسخه 5.11.1
22-08-1400 به روز رسانی نسخه 5.11
02-07-1400 به روز رسانی نسخه 5.10.2
09-06-1400 به روز رسانی نسخه 5.10.1
02-05-1400 به روز رسانی نسخه 5.9.9
19-04-1400 به روز رسانی نسخه 5.9.8
11-04-1400 به روز رسانی نسخه 5.9.7
1-03-1400 به روز رسانی نسخه 5.9.6
27-10-99 به روز رسانی نسخه 5.9.5
27-10-99 به روز رسانی نسخه 5.9.4
15-8-99 به روز رسانی نسخه 5.9.3
23-7-99 به روز رسانی نسخه 5.9.1
28-5-99 به روز رسانی نسخه 5.9.0
26-3-99 به روز رسانی نسخه 5.8.12
25-2-99 به روز رسانی نسخه 5.8.11
9-1-99 به روز رسانی نسخه 5.8.9
13-12-98 به روز رسانی نسخه 5.8.8
16-09-98 به روز رسانی نسخه 5.8.7
17-08-98 به روز رسانی نسخه 5.8.6
20-07-98 به روز رسانی نسخه 5.8.5
20-06-98 به روز رسانی نسخه 5.8.4
20-05-98 به روز رسانی نسخه 5.8.3
08-05-98 اضافه شدن در سیستم به روزرسانی هوشمند ژاکت
26-04-98 به روز رسانی نسخه 5.8.2
20-03-98 به روز رسانی نسخه 5.8.1
31-02-98 به روز رسانی نسخه 5.8
26-01-98 به روز رسانی نسخه 5.7.13
29-11-97 به روز رسانی نسخه 5.7.12
6-11-97 به روز رسانی نسخه 5.7.10
2-10-97 به روز رسانی نسخه 5.7.9
18-09-97 به روز رسانی نسخه 5.7.8
8-07-97 به روز رسانی نسخه 5.7.7
20-05-97 به روز رسانی نسخه 5.7.2
08-05-97 به روز رسانی نسخه 5.7.1
24-04-97 به روز رسانی نسخه 5.7
18-01-97 به روز رسانی نسخه 5.6.10
13-10-96 به روز رسانی نسخه 5.6.7
02-9-96 به روز رسانی نسخه 5.6.5
04-8-96 به روز رسانی نسخه 5.6.4
25-7-96 به روز رسانی نسخه 5.6.3
23-6-96 به روز رسانی نسخه 5.6.2
19-5-96 به روز رسانی نسخه 5.6.1
3-5-96 به روز رسانی نسخه 5.6
27-4-96 به روز رسانی ترجمه نسخه 5.5.14
10-3-96 به روز رسانی به نسخه 5.5.14
05-02-96 به روز رسانی نسخه 5.5.12
31-01-96 به روز رسانی نسخه 5.5.11 - بازنویسی مجدد پلاگین تقویم شمسی
7-11-95 به روز رسانی نسخه 5.5.5
18-09-95 به روزرسانی نسخه 5.5.2 جدید
18-08-95 به روزرسانی نسخه 5.4.8 جدید
15-05-95 به روزرسانی نسخه 5.4 جدید به همراه بسیاری امکانات جدید
22-10-1394- به روزرسانی نسخه 5.3.2.2 انجام شد
2-06-1394 - افزونه به نسخه 5.3 به روز رسانی شد. پلاگین تاریخ شمسی کلا بازنویسی شد!
1-05-1394 - افزونه به نسخه 5.2.8 به روز رسانی شد
17-03-1394 افزونه به نسخه 5.2.6 به روز رسانی شد
10-02-1394 افزونه به نسخه 5.2.3 به روز رسانی شد
12-09-1393-افزوه به نسخه 5.0.4 به روز رسانی شد
29-09-1393-افزوه به نسخه 5.15 به روز رسانی شدتاریخچه تغییرات(چند نسخه آخر)
6.3.5
Fix - The ACF Shortcode now correctly outputs a comma separated list of values for arrays
Fix - ACF Blocks rendered in auto mode now correctly re-render their previews after editing fields
Fix - ACF Block validation no longer raises required validation messages if HTML will automatically select the first value when rendered
Fix - ACF Block validation no longer raises required validation messages if a default value will be rendered as the field value
Fix - ACF Block validation no longer raises required validation messages for fields hidden by conditional logic when adding a new block
6.3.3
* Enhancement - All dashicons are now available to the icon picker field type
* Fix - The True/False field now correctly shows it’s description message beside the switch when using the Stylized UI setting
* Fix - Conditional logic values now correctly load options when loaded over AJAX
* Fix - ACF PRO will no longer trigger license validation calls when loading a front-end page
* i18n - Fixed an untranslatable string on Option Page previews
6.3.1.2
Release Date 6th June 2024
PRO Only Release
Fix - ACF Blocks in widget areas no longer cause a fatal error when no context is available
Fix - ACF Blocks with no fields assigned no longer show a gap in the sidebar where the form would render
6.3.1.1
Release Date 6th June 2024
PRO Only Release
Fix - Repeater and Flexible Content fields no longer error when duplicating or removing rows containing Icon Picker subfields
Fix - ACF Blocks containing Flexible Content fields now correctly load their edit form
Fix - ACF Blocks no longer have a race condition where the data store is not initialized when read
Fix - ACF Blocks no longer trigger a JS error for blocks without fields and with an empty no-fields message
Fix - ACF Block preloading now works correctly for fields consuming custom block context
Fix - ACF Block JavaScript debug messages now correctly appear when SCRIPT_DEBUG is true
6.3.1
Release Date 4th June 2024
Enhancement - Options Pages registered in the UI can now be duplicated
Fix - ACF Block validation now correctly validates Repeater, Group, and Flexible Content fields
Fix - ACF Block validation now correctly validates when a field is using a non-default return type
Fix - Fields moved between field groups now correctly updates both JSON files
Fix - Icon Picker fields now render correctly when using left-aligned labels
Fix - Icon Picker fields no longer renders tabs if only one tab is selected for display
Fix - Icon Picker fields no longer crash the post editor if no icon picker tabs are selected for displayed
Fix - True/False field now better handles longer On/Off labels
Fix - Select2 results loaded by AJAX for multi-select Taxonomy fields no longer double encode HTML entities
6.3.0.1
Release Date 22nd May 2024
Fix - A possible fatal error no longer occurs in the new site health functionality for ACF PRO users
Fix - A possible undefined index error no longer occurs in ACF Blocks for ACF PRO users
6.3.0
Release Date 22nd May 2024
New - ACF now requires WordPress version 6.0 or newer, and PHP 7.4 or newer.
New - ACF Blocks now support validation rules for fields. View the release notes for more information
New - ACF Blocks now supports storing field data in the postmeta table rather than in the post content
New - Conditional logic rules for fields now support selecting specific values for post objects, page links, relationships and users rather than having to enter the ID
New - New Icon Picker field type for ACF and ACF PRO
New - Icon selection for a custom post type menu icon
New - Icon selection for an options page menu icon
New - ACF now surfaces debug and status information in the WordPress Site Health area
New - The escaped html notice can now be permanently dismissed
Enhancement - Tab field now supports a selected attribute to specify which should be selected by default, and support class attributes
Fix - Block Preloading now works reliably in WordPress 6.5 or newer
Fix - Select2 results loaded by AJAX for post object fields no longer double encode HTML entities
Fix - Custom post types registered with ACF will now have custom field support enabled by default to better support revisions
Fix - The first preview after publishing a post in the classic editor now displays ACF fields correctly
Fix - ACF fields and Flexible Content layouts are now correctly positioned while dragging
Fix - Copying the title of a field inside a Flexible Content layout no longer adds whitespace to the copied value
Fix - Flexible Content layout names are no longer converted to lowercase when edited
Fix - ACF Blocks with attributes without a default now correctly register
Fix - User fields no longer trigger a 404 when loading results if the nonce generated only contains numbers
Fix - Description fields for ACF items now support being solely numeric characters
Fix - The field group header no longer appears above the WordPress admin menu on small screens
Fix - The acf/json/save_file_name filter now correctly applies when deleting JSON files
i18n - All errors raised during ACF PRO license or update checks are now translatable
Other - The ACF Shortcode is now disabled by default for new installations of ACF as discussed in the ACF 6.2.7 release notes
6.2.10
Release Date 15th May 2024 - PRO Only Release
Security Fix - ACF Blocks no longer allow render templates, or render or asset callbacks to be overridden in the block's attributes.
6.2.9
Release Date 8th April 2024
Enhancement - The Select2 escapeMarkup function can now be overridden when initializing a custom Select2
Fix - “Hide on Screen” settings are now correctly applied when using conditionally loaded field groups
Fix - Field names are no longer converted to lowercase when editing the name
Fix - Field group titles will no longer convert HTML entities into their encoded form
6.2.8
Release Date 2nd April 2024
New - Support for the Block Bindings API in WordPress 6.5 with a new acf/field source. For more information on how to use this, please read the release blog post
New - Support for performance improvements for translations in WordPress 6.5
Enhancement - A new JS filter, select2_escape_markup now allows fields to customize select2's HTML escaping behavior
Fix - Options pages can no longer set to have a parent of themselves
Fix - ACF PRO license activations on multisite subsite installs will now use the correct site URL
Fix - ACF PRO installed on multisite installs will no longer try to check for updates resulting in 404 errors when the updates page is not visible
Fix - ACF JSON no longer produces warnings on Windows servers when no ACF JSON folder is found
Fix - Field and layout names can now contain valid non-ASCII characters
Other - ACF PRO now requires a valid license to be activated in order to use PRO features
6.2.7
Release Date 27th February 2024
Security Fix - the_field now escapes potentially unsafe HTML as notified since ACF 6.2.5. For full information, please read the release blog post
Security Fix - Field and Layout names are now enforced to alphanumeric characters, resolving a potential XSS issue
Security Fix - The default render template for select2 fields no longer allows HTML to be rendered resolving a potential XSS issue
Security Enhancement - A acf/shortcode/prevent_access filter is now available to limit what data the ACF shortcode is allowed to access
Security Enhancement - i18n translated strings are now escaped on output
Enhancement - ACF now universally uses WordPress file system functions rather than native PHP functions
= 6.2.6.1 =
*Release Date 7th February 2024*
* Fix - Fatal JS error no longer occurs when editing fields in the classic editor when Yoast or other plugins which load block editor components are installed
* Fix - Using `$escape_html` on get functions for array returning field types no longer produces an Array to string conversion error
6.2.5
Release Date 16th January 2024
Security Fix - The ACF shortcode will now run all output through wp_kses, escaping unsafe HTML. This may be a breaking change to your site but is required for security, a message will be shown in WordPress admin if you are affected. Please see the blog post for this release for more information. Thanks to Francesco Carlucci via Wordfence for the responsible disclosure
Security - ACF now warns via an admin message, when upcoming changes to the_field and the_sub_field may require theme changes to your site to avoid stripping unsafe HTML. Please see the blog post for this release for more information
Security - Users may opt in to automatically escaping unsafe HTML via a new filter acf/the_field/escape_html_optin when using the_field and the_sub_field before this becomes default in an upcoming ACF release.
= 6.2.4 =
*Release Date 28th November 2023*
* Fix - Custom Post Types labels now match the WordPress 6.4 behavior for "Add New" labels
* Fix - When exporting both post types and taxonomies as PHP, taxonomies will now appear before post types, matching the order ACF registers them. This resolves issues where taxonomy slugs will not work in post type permalinks
* Fix - Advanced Settings for Taxonomies, Post Types or Options Pages now display with the correct top padding when toggled on
* Fix - When a parent option page is set to "Redirect to Child Page", the child page will now correctly show it's parent setting
* Fix - When activated as a must-use plugin, the ACF PRO "Updates" page is now visible. Use the existing `show_updates` setting to hide
* Fix - When activated as a must-use plugin, ACF PRO licenses defined in code will now correctly activate sites
* Fix - When `show_updates` is set or filtered to false, ACF PRO will now automatically still activate defined licenses
* i18n - Maintenance and internal upstream messages from the ACF PRO activation server are now translatable
= 6.2.3 =
*Release Date 15th November 2023*
* [View Release Post](https://www.advancedcustomfields.com/blog/acf-6-2-3/)
* New - An ACF Blocks specific JSON schema for block.json is now available on [GitHub](https://github.com/AdvancedCustomFields/schemas)
* New - Flexible Content fields now show the layout name in the layout's header bar and supports click-to-copy
* New - Duplicating Flexible Content layouts now appends "Copy" to their name and label, matching the behavior of field group duplication
* Enhancement - ACF PRO will now automatically attempt license reactivation when the site URL changes, e.g. after a site migration. This resolves issues where updates may fail
* Enhancement - Presentation setting for "High" placement of the Field Group made clear that it's not supported in the block editor
* Fix - `acf_format_date` now ensures the date parameter is valid to prevent fatal errors if other data types are passed in
* Fix - CPTs with a custom icon URL now display the posts icon in the location column of the field groups screen
* Fix - The ACF JSON import form will now disable on first submit resolving an issue where you could submit the form twice
* Fix - The "Add Row" button in the Flexible Content field now displays correctly when using nested layouts
* Fix - Warning and Error notices no longer flicker on ACF admin pages load
* i18n - ACF PRO license activation success and error messages are now translatable
= 6.2.2 =
*Release Date 25th October 2023*
* Enhancement - ACF Blocks which have not been initialized by the editor will now render correctly
* Enhancement - Added a new `acf/filesize` filter to allow third party media plugins to bypass ACF calling `filesize()` on attachments with uncached file sizes, which may result in a remote download if offloaded
* Enhancement - ACF PRO license status and subscription expiry dates are now displayed on the “Updates” page
* Fix - Product pages for WooCommerce version 8.2 or newer now correctly support field group location rules
* Fix - Relationship field items can now be removed on mobile devices
* Fix - Color picker fields no longer autocomplete immediately after typing 3 valid hex characters
* Fix - Field settings no longer appear misaligned when the viewport is something other than 100%
* Fix - Select fields without an aria-label no longer throw a warning
* Fix - CPTs and Taxonomies with a custom text domain now export correctly when using PHP export
6.2.1
Release Date 7th September 2023
New - Options Pages created in the admin UI can now be assigned as child pages for any top-level menu item
New - Added a "Title Placeholder" setting to ACF Post Types which filters the "Add title" text when editing posts
Enhancement - ACF PRO will now warn when it can’t update due to PHP version incompatibilities
Enhancement - ACF PRO will now work correctly with WordPress automatic updates
Enhancement - The internal ACF Blocks template attribute parser function parseNodeAttr can now be shortcut with the new acf_blocks_parse_node_attr filter.
Enhancement - Removed legacy code for supporting WordPress versions under 5.8
Fix - The "Menu Position" setting is no longer hidden for child options pages
Fix - The tabs for the "Advanced" settings in Post Types and Taxonomies are now rendered inside a wrapper div
Fix - Options pages will no longer display as a child page in the list view when set to a top level page after previously being a child
Fix - Conflict with Elementor CSS breaking the ACF PRO banner
Fix - Errors generated during the block editor’s savePost function will no longer be caught and ignored by ACF
= 6.2.0 =
*Release Date 9th August 2023*
* [View Release Post](https://www.advancedcustomfields.com/blog/acf-6-2-0-released/)
* New - ACF now requires WordPress version 5.8 or newer, and PHP 7.0 or newer. View the [release post](https://www.advancedcustomfields.com/blog/acf-6-2-0-released/#version-requirements) for more information
* New - Bidirectional Relationships now supported for Relationship, Post Object, User and Taxonomy fields. View the [release post](https://www.advancedcustomfields.com/blog/acf-6-2-0-released/#bidirectional-relationships) for more information
* New - [Options Pages](https://www.advancedcustomfields.com/resources/options-page/) can now be registered and managed by the admin UI in ACF PRO
* New - Link to the [product feedback board](https://www.advancedcustomfields.com/feedback/) added to the plugin footer
* Enhancement - ACF JSON now supports multiple save locations (props Freddy Leitner)
* Enhancement - ACF Post Types and Taxonomies can now be duplicated
* Enhancement - The filename for JSON files can now be customized with the `acf/json/save_file_name` filter
* Fix - REST updates of fields with choices containing integer or mixed keys now behave correctly
* Fix - Using the `block_type_metadata_settings` PHP filter to add usesContext values no longer breaks ACF blocks
* Fix - Notice to import post types/taxonomies from CPTUI no longer flashes on page load
* Fix - Various buttons for fields in blocks now display correctly
* Fix - The settings for the DateTime field are no longer cut off when nested in several fields in the field group editor
* Fix - The newline added to the end of JSON files will now use `PHP_EOL` to detect the correct newline character with a filter `acf/json/eof_newline` to alter it.
* i18n - Updated French and Portuguese translations (Thanks to pedro-mendonca and maximebj)
= 6.1.8 =
*Release Date 3rd August 2023*
* Security Fix - This release resolves a stored XSS vulnerability in admin screens with ACF post type and taxonomy labels (Thanks to Satoo Nakano and Ryotaro Imamura)
= 6.1.7 =
*Release Date 27th June 2023*
* New - Added new capability settings for ACF taxonomies
* Enhancement - Added a new `acf/field_group/auto_add_first_field` filter which can be used to prevent new field groups from automatically adding a field
* Enhancement - Field setting labels now have standard capitalization in the field group editor
* Enhancement - Clone field now has a tutorial link
* Enhancement - "Exclude From Search" CPT setting now has an improved description
* Enhancement - The `acf_get_posts()` function now has `acf/acf_get_posts/args` and `acf/acf_get_posts/results` filters
* Enhancement - Added a new `acf/options_page/save` action hook that gets fired during save of ACF Options Pages
* Fix - Taxonomies are now initialized before post types, preventing some permalink issues
* Fix - Increased the taxonomy slug maximum length to 32 characters
* Fix - Extra tabs are no longer added to PHP exports with field settings containing multiple lines
* Fix - ACF admin assets now load when editing profile and users for a multisite network
* Fix - Blocks with recursive `render_callback` functions will no longer crash the editor
* Fix - JSON files now end in a new line for better compatibility with code editors
* i18n - `layout(s)` strings in Flexible Content fields are now translatable
* i18n - Updated Polish translations
6.1.6
Release Date 4th May 2023
Security Fix - This release resolves an XSS vulnerability in ACF’s admin pages (Thanks to Rafie Muhammad for the responsible disclosure)
Fix - Duplicating fields in a new field group with field setting tabs disabled now behaves correctly
6.1.5
Release Date 2nd May 2023
Enhancement - Creating a new field group from the post-save actions for a post type or taxonomy will automatically populate the field group title
Enhancement - Empty values in list tables now display as a dash, rather than blank
Enhancement - The Generate PHP export tool for field groups now displays the code wrapped in the acf/include_fields action hook to match the recommended way of using acf_add_local_field_group, and the code is formatted correctly
Enhancement - Post count and Term count values in list tables now link through to the matching posts or terms
Enhancement - Added post-save actions to post type and taxonomies to create another
Enhancement - Selecting existing taxonomies when registering a Custom Post Type is now available in the Basic settings section rather than Advanced
Fix - Exclude From Search setting for custom post types now behaves correctly
Fix - Duplicating fields with sub fields no longer results in JS errors
Fix - Select2 field settings now render correctly when duplicating fields
Fix - Checkbox fields allowing custom values which use integer keys can now be updated over the REST API
Fix - Using the No Permalink rewrite setting for post type will no longer generate PHP warnings
Fix - The minimum rows not met validation message for the Repeater field type now correctly states the minimum rows are not met
Fix - The Range field type no longer cuts off three digit values
Fix - Created on and Delete Field Group now correctly only appear on the Group Settings tab of a field group
Fix - Padding for field settings tabs is now correct
i18n - Updated all PRO translation files, removing legacy free strings which are now handled through translate.wordpress.org
i18n - Updated PRO translations with the latest contributions from GitHub (Thanks to @MilenDalchev, @Xilonz and @wiliamjk)
= 6.1.4 =
*Release Date 12th April 2023*
* Fix - ACF now detects when another plugin or theme is loading an incompatible version of Select2, and will fallback to a basic select field for the field type selection
* Fix - Post Object, Page Link and Relationship field types now use a default `post_status` filter of `any`, matching the behavior prior to ACF 6.1. This can be edited per field in the field group admin or via the `acf/fields/$field_type/query` filters
* Fix - Post Type and Taxonomy key generation now uses dashes rather than underscores
* Fix - The "add first" text no longer appears when no search results are found for ACF field groups, post types or taxonomies
= 6.1.3 =
*Release Date 5th April 2023*
* Fix - 'Create Terms' button for taxonomy fields now displays correctly
* Fix - ACF JSON field group files which have unsupported keys (not beginning with `group_`) will now load as field groups
* Fix - Renaming capabilities for post types will now set `map_meta_cap` to `true` solving an issue with assigning permissions to roles for that post type
= 6.1.2 =
*Release Date 4th April 2023*
* [View Release Post](https://www.advancedcustomfields.com/blog/acf-6-1-0-released/)
* Fix - Calls to `acf_add_options_page` after `acf_add_local_field_group` before `acf/init` will now behave correctly
* i18n - All new ACF 6.1 strings are now correctly English (United States) by default
6.1.1
Release Date 3rd April 2023
Fix - Calls to acf_add_local_field_group before acf/init now behave correctly
6.1.0
Release Date 3rd April 2023
View Release Post
New - Register Custom Post Types and Taxonomies using ACF. View the release post for full information
New - A new field type selection browser providing details on each type of field. View the release post for full information.
New - PHP 8.1 and 8.2 support
Security Fix - ACF's data serialization system will now prevent classes being unserialized. This prevents a potential security issue should an attacker know a vulnerable class is available, and can write malicious data to the database.
Enhancement - Post Object, Page Link and Relationship fields now support filtering by post status
Enhancement - Checkbox fields which allow custom entries can now be filtered to set custom text for the “Add New Choice” button using the custom_choice_button_text property
Fix - ACF Block field edit view buttons now work correctly inside reusable blocks
Fix - An empty callback function in now passed to scripts to prevent JS warnings when using Google Map fields
Fix - Checkbox field values now support keys indexed as 0
Fix - Automatic deactivation of the free or PRO plugin when activating the other now displays the correct message in the admin notice
Fix - Empty Flexible Content fields will no longer cause an error when used in the block editor on save.
Fix - Admin notices now behave correctly and are closable in RTL languages
= 6.0.7 =
*Release Date 18th January 2023*
* Improvement - Removed unnecessary “Layout” prefix for Flexible Content field layouts
* Fix - Dragging and dropping fields containing settings rendered as radio button groups no longer removes the selected value
* Fix - Using the WordPress `default_page_template_title` filter with two parameters no longer causes a fatal error
* Fix - Select2 inputs in the content editor are no longer receiving styles from the ACF 6 admin UI
* Fix - `acf_add_local_field_group()` now works with field group titles containing non-ASCII characters
* Fix - Flexible Content field no longer has a missing icon for the “Duplicate” button
* Fix - Clicking the “Add Field” button in a Flexible Content layout no longer adds an invalid field if there are other Flexible Content fields in the layout
* Fix - Edit buttons for ACF blocks now behave correctly inside reusable blocks
* Fix - Field settings rendered as a select2 field now correctly reinitialize when changing between field types
= 6.0.6 =
*Release Date 13th December 2022*
* [View Release Post](https://www.advancedcustomfields.com/blog/acf-6-0-6-release-flexible-content-field-layout-improvement/)
* New - Flexible Content field now has a new admin user experience when editing layouts
* New - Tabs for field settings in the field group editor can now be disabled via a new “Field Settings Tabs” screen option or with the new [`acf/field_group/disable_field_settings_tabs`](https://www.advancedcustomfields.com/resources/acf-field_group-disable_field_settings_tabs) filter
* Improvement - General field settings tab now selected by default when a field is opened
* Fix - Sub fields are no longer initialized by their parent, resolving performance issues when field groups contain many nested sub fields
* Fix - Frontend forms now disable the submit button after click to prevent multiple submissions
* Fix - Unknown field types no longer display broken HTML in the field group editor
* Fix - Returning an empty string via the `acf/blocks/no_fields_assigned_message` filter will no longer result in blocks without fields assigned having an extra wrapping div
* Fix - Sites with WPML enabled no longer experience failed ACF updates due to license errors
* Fix - Buttons featuring icons no longer have display issues when using RTL languages
= 6.0.5 =
*Release Date 18th November 2022*
* Fix - Uploading multiple files nested in a subfield no longer causes a fatal error when using basic uploader (props @JoKolov)
= 6.0.4 =
*Release Date 8th November 2022*
* Improvement - JavaScript initialization performance while editing large field groups has been improved, especially in Safari
* Improvement - Tooltips for field settings are now shown as inline instructions
* Improvement - Saving a field group is now disabled until a field group title has been entered
* Improvement - Additional sanitization across various internal parts of the plugin
* Fix - Dragging and dropping a field in no longer opens the field settings in Firefox
* Fix - Copying the field name or key to the clipboard now works as expected for new or reordered fields, and subfields
* Fix - Saving a field group will now temporarily disable the "Save Changes" button while saving
* Fix - Block templates that include html comments as the first DOM element no longer crash the block editor on edit
* Fix - Block templates that include InnerBlocks on the DOM’s first level no longer trigger JS warnings
* Fix - Block templates that render other blocks now correctly render their InnerBlocks
* Fix - Legacy block attribute values are no longer overwritten by blank defaults of new versions
* Fix - Paginated Repeater fields now work with non-paginated Repeaters as subfields
* Fix - Repeater pagination is now properly disabled while inside blocks
* Fix - REST API no longer causes a PHP warning if `$_SERVER['REQUEST_METHOD']` is not defined
* Fix - REST API now supports integer keys for the Select field
* Fix - REST API now supports passing `null` to Image and File fields
* Fix - Invalid ACF meta keys no longer cause a fatal error when retrieved with `get_fields()`
* a11y - The Relationship field is now fully accessible for keyboard navigation
* i18n - Select dropdown arrow is now aligned correctly in RTL languages
* i18n - Radio buttons are now aligned correctly in RTL languages
= 6.0.3 =
*Release Date 18th October 2022*
* Security Fix - ACF shortcode security fixes detailed [here](https://www.advancedcustomfields.com/blog/acf-6-0-3-release-security-changes-to-the-acf-shortcode-and-ui-improvements/#acf-shortcode)
* Improvement - Field names and keys now copy to clipboard on click, and do not open a field
* Fix - The field type input now has default focus when adding a new field
* Fix - ACF no longer publishes `h1`, `h2` or `h3` CSS classes outside of the ACF admin screens
* Fix - Conditional field settings now work correctly across different tabs
* Fix - The field list for sub fields are now full width
* Fix - ACF admin notices now display with correct margin
* Fix - Admin CSS improvements when using ACF in an RTL language
* Fix - Clone fields now have the presentation tab for setting wrapper properties when in group display mode
* Fix - Appended labels on field settings will now be displayed in the correct place
* Accessibility - The move field modal is now keyboard and screen reader accessible
6.0.2
Release Date 29th September 2022
Improvement - Field group and field rows no longer animate on hover to reveal the action links
Fix - Field order is now saved correctly when fields are reordered
Fix - WordPress notice styles outside of ACF's admin screens are no longer affected by the plugin's CSS
6.0.1
Release Date 28th September 2022
Improvement - ACF's header bar inside our admin pages is no longer sticky
Improvement - ACF's admin pages no longer use a custom font
Fix - Duplicating flexible content layouts now works correctly
Fix - ACF CSS classes no longer target translated class names for sub pages, resolving issues when using ACF in a language other than English
Fix - ACF no longer reactivates when using WPML with different domains per language
Fix - i18n - Labels for some field settings no longer break onto multiple lines in languages other than English
Fix - Radio field types no longer generate a warning in logs due to invalid parameter counts
Fix - True/False field focus states no longer apply outside ACF admin screens
Fix - Focus states for many field types no longer show when interacting with a mouse input
Fix - ACF 6’s new Tab background colors no longer apply outside ACF admin screens, increasing readability
Fix - User fields named “name” no longer have a different label presentation view
Fix - Changing field types with subfields no longer removes those fields when switching field type and back
Fix - Resolved a potential fatal error if a third party plugin sets the global $post_type something other than a string
Fix - Tooltip alignment is no longer incorrect inside subfields
Fix - Resolved a potential JS error when third party plugins modify the metabox sort order
6.0.0
Release Date 21st September 2022
New - ACF now has a new refreshed UI with improved UX for editing field groups, including a new tabbed settings layout for fields. Third party ACF extension plugin developers can read more about the optional changes they can make to support the new tabs in our release announcement post
New - Repeaters now have an optional "Pagination" setting which can be used to control the number of rows displayed at once. More details can be found on our Repeater field documentation
New - ACF Blocks now have a versioning system allowing developers to opt in to new features
New - ACF Blocks now support version 2, enabling block.json support, reduced wrapper markup and significant other new features. Full details and examples of this can be found in What's new with ACF Blocks in ACF 6
New - ACF Blocks no longer use Block IDs saved in the block comment. See What's new with ACF Blocks in ACF 6 for more information.
Enhancement - Bulk actions for field groups now include "Activate" and "Deactivate" options
Fix - ACF will no longer perform a multisite database upgrade check on every admin load once each upgrade has been performed
Fix - ACF Blocks preloading now works for blocks saved in edit mode
Fix - ACF Blocks edit forms now behave correctly if they are not visible when loaded
Fix - ACF Blocks now always fire render_block_preview events when a block preview is displayed or redisplayed
Fix - ACF Blocks with no fields now display advisory text and are selectable in the block editor. This message is filterable with the acf/blocks/no_fields_assigned_message filter, providing both the message to be displayed and the block name it's being displayed against
Fix - Accordions inside ACF Blocks now match the current native block styling
Fix - ACF Blocks which contain no fields now preload correctly
Fix - Changes to an ACF Block's context now trigger a re-render
Fix - A rare warning inside wp_post_revision_field will no longer be possible
Fix - The field “move” option now no longer displays for fields when only one field group exists
Fix - Language for field group activation state now standardized to "active" and "inactive"
Fix - SVGs containing foreignObject tags now correctly render in JSX rendered ACF Blocks
Fix - Server errors during ACF updates or version checks are now cached for 5 minutes rather than 24 hours
Accessibility - The new ACF UI has significantly improved accessibility for screen readers and alternative input options
i18n - All strings inside ACF are now translatable
i18n - Accented term names in taxonomy fields are no longer corrupted at output
i18n - ACF translations are now synced with contributions from translation.wordpress.org at each release, increasing ACF's supported languages and updating many other translations. PRO strings should still be submitted as pull requests on GitHub (Additional thanks to maximebj, emreerkan and Timothée Moulin for their contributions which are included here)
= 5.12.3 =
*Release Date 14th July 2022*
* Security Fix - Inputs for basic file uploads are now nonced to prevent an issue which could allow arbitrary file uploads to forms with ACF fields (Thanks to James Golovich from Pritect, Inc.)
= 5.12.2 =
* Fix - Cloned fields in custom named options pages now behave correctly
* Fix - Default values and the `acf/load_value` filter are now applied if a field value load [fails security validation](https://www.advancedcustomfields.com/resources/acf-field-functions/#non-acf-data)
* Fix - The ACF field is no longer present in REST responses if the ACF REST API setting is disabled
* Fix - Duplicating a flexible content layout or repeater row now also replaces the field ID in `for` attributes
= 5.12.1 =
*Release Date 23rd March 2022*
* New - REST API now supports the comment route for displaying ACF fields.
* Fix - ACF now validates access to option page field values when accessing via field keys the same way as field names. [View More](https://www.advancedcustomfields.com/resources/acf-field-functions/#non-acf-data)
* Fix - REST API now correctly validates fields for POST update requests
* Fix - Fixed an issue where invalid field types caused an error during REST API requests
* Fix - Fixed a PHP warning when duplicating an empty field group
* Fix - Fixed a bug preventing block duplication detection changing an ACF Block’s ID if it was nested deeper than one level inside another block
* Fix - Fixed a bug where the `acf-block-preview` wrapper might not appear around a block if it was saved in edit mode
* i18n - Updated several translations from user contributions (Thanks to Dariusz Zielonka, Mikko Kekki and Alberto!)
5.12
* [View Release Post](https://www.advancedcustomfields.com/blog/acf-5-12-released/)
* New - ACF blocks now support the new Full Site Editor included in WordPress 5.9
* New - ACF blocks now support the WordPress Query Loop block
* New - Added block caching system to reduce the number of AJAX calls in the block editor
* Enhancement - Block preloading can now be disabled by using "acf_update_setting( 'preload_blocks', false );" in the "acf/init" action hook
* Enhancement - ACF and ACF PRO will now detect if each other are active and deactivate the other plugin on plugin activation
* Fix - Fixed an issue with the media library not working correctly in ACF Blocks in WordPress 5.9.1
* Fix - Fixed an issue where anchors weren't working correctly in WordPress 5.9
* Fix - Fixed an issue where the "unfiltered_html" capability wasn't being used by ACF blocks
* Fix - Fixed an issue where it was impossible to update an ACF block inside the widget block editor
* Fix - Fixed an issue where ACF fields might not appear in REST API calls made via internal WordPress functions
* Fix - Warnings and PHP 8.1 deprecation notices in REST API
* Fix - Better support for double byte characters in "acf_get_truncated()" (props @cabradb)
* i18n - Broken link in the Croatian translation
* i18n - Automated building of acf.pot for translators in each release
5.11.4
* Fix - Fixed several Select2.js conflicts with other plugins
* Fix - Fixed an issue where block name sanitization could change valid block names containing double hyphens
* Fix - Fixed an issue where blocks with integer IDs could fail to load example field data
5.11.3
* Fix - Fixed a bug when accessing field values for options pages registered with a custom post_id
5.11.2
* Fix - Previously implemented data access changes for get_field() and the_field() are now limited to the ACF shortcode only. [Learn more](https://www.advancedcustomfields.com/resources/acf-field-functions/)
* Fix - get_field() and the_field() functions can once again access meta values regardless of being registered with ACF, restoring functionality that existed before 5.11
* Fix - get_field() and the_field() functions now are only able to access site options which are ACF fields
* Fix - UI issues for select boxes related to Yoast and WooCommerce’s select2 versions by upgrading our select2 version, and updating our CSS to support older versions
* Fix - User fields failed to load values when using the legacy select2 v3 option
* Fix - acf_slugify() now correctly supports special characters which solves issues with block names or field group names (during imports) containing those characters
* Fix - PHP Notice generated while processing a field group’s postbox classes
5.11.1
Enhancement - Added "acf/admin/license_key_constant_message" filter to allow changing of the "Your license key is defined in wp-config.php" message
Fix - Added warning for when get_field() or similar functions are called before ACF has initialized. Learn more
Fix - Fixed fields not appearing on user REST API endpoints if their field group location was set to a user form other than "all"
Fix - Fixed warning in REST API if a custom field type did not have the "show_in_rest" property
Fix - Fixed an error that could occur if value of WYSIWYG field was not a string
5.11
View Release Post
New - Fields can now be viewed and updated with the WordPress REST API (props @mishterk)
New - License key can now be defined in code with the "ACF_PRO_LICENSE" constant
Enhancement - Improved error handling for expired or deactivated licenses
Enhancement - Improved support for various block editor features, such as block styles and padding/spacing
Enhancement - Added support for using WordPress "Screen Options" to hide field groups in Classic Editor
Enhancement - Support filters adding custom classes on date and time field inputs
Enhancement - Support filtering ACF shortcode attributes (with the "shortcode_atts_acf" filter)
Fix - Removed usages of PHP "extract()" function
Fix - Fixed a security issue with user field
Fix - Fixed a security issue with "acf_get_value()"
Fix - Correctly set ".acf-block-preview" wrapper when previewing a block in auto mode
Fix - Resolved an issue with select2 rendering for nav menu fields
Fix - Fixed an issue with file validation that occurred when removing a file that failed validation
Fix - Fixed a notice in "acf_prepare_field()"
Fix - Prevented an issue where setting an empty string for the return format of date and time fields would cause JS errors
Fix - Fix issues with conditional logic for multi-select fields (props @bhujagendra-ishaya)
Fix - Added support for Google Maps schema change which prevented Google Maps fields from correctly saving the city for some areas
Fix - Fixed an issue where removing the collapsed property of a repeater prevents viewing previously collapsed rows
i18n - Updated Polish Translations (props @webnatural)
Dev - Formatted JavaScript to WordPress code standards
5.10.2
Fix - Fixed block duplication issues which created blocks with duplicate block IDs
Fix - Fixed an issue with ACF errors displaying in the media library outside of ACF fields
Fix - Changed label of "Enable Opacity?" to "Allow transparency" in the colour picker
Fix - Revert "style" attributes of ACF Blocks to 5.9.x behaviour for template compatibility
Fix - Allow safe HTML inside select2 field labels
Fix - Don't render the "acf-block-preview" div when preloading blocks in edit mode
5.10.1
Fix - Fixed conflict with WooCommerce loading SelectWoo which is not directly compatible with Select2.
5.10
View Release Post
Enhancement - Improved security by running all user-generated content through wp_kses() by default
Enhancement - New ACF Blocks features
Switched to v2 of the Blocks API for WordPress 5.6+
Block preloading now enabled by default
Block preloading now supports blocks set to "Edit" mode
Add support for full height alignment setting
Enhancement - Added setting to color picker field to enable an opacity slider
Enhancement - Allow deletion of first field group location rule if multiple rules have been added thanks to Arthur Shlain
Fix - Fixed vulnerability with acf_shortcode() where users with subscriber role could view arbitrary ACF data, thanks to Keitaro Yamazaki
Fix - Fixed vulnerability where users with subscriber role could move fields and view field groups, thanks to Keitaro Yamazaki
Fix - Fixed issue where fields in legacy widgets weren't saving in new widget block editor
Fix - Fixed issue with custom field validation in scheduled posts
Fix - Fixed warnings thrown by clone field if the cloned field group is empty
Fix - Fixed issue where Select2 search input wouldn't have focus in WordPress 5.8+
Fix - Fixed issue with Select2 value sorting when Yoast SEO is installed
Fix - Fixed deprecation warnings in block editor in WordPress 5.6+
i18n - Updated Swedish translation thanks to Erik Betshammar
5.9.9
Fix - Fixed warning when deleting fields which don't exist
Fix - Fixed issues with older browsers and the blocks JavaScript
Fix - Fixed file size & file type validation for front end forms using the basic uploader
5.9.8
Fix - Fixed bug causing multiple image fields to not validate files properly
Fix - Fixed bug preventing case-sensitive HTML tags from working in blocks
Fix - Fixed bug causing JSX-enabled blocks to improperly remove whitespace in preview
Fix - Fixed bug causing text fields to remove HTML entities when editing saved fields
Fix - Fixed deprecated jQuery notices on "Add Field Group" page
5.9.7
Fix - Fixed PHP warnings logged due to incorrect parameter type for add_menu_page()/add_submenu_page()
Fix - Fixed bug causing WYSIWYG field to not keep line breaks
Fix - Fixed bug causing Email field to incorrectly invalidate emails with unicode characters
Fix - Fixed bug causing file type validation to fail in some cases
Fix - Fixed bug where newly uploaded or selected images do not contain custom preview size data
5.9.6
Enhancement - Added 'position' setting compatibility for Options Page submenus.
Enhancement - Visually highlight "High" metabox area when dragging metaboxes.
Fix - Fixed compatibility issue between Block matrix alignment setting and the latest version of Gutenberg (10.6).
Fix - Fixed bug breaking WYSIWYG field after reordering a child block via the block's toolbar up/down buttons.
Fix - Added missing "readonly" and "disabled" attributes to DateTime and Time picker fields.
Fix - Fixed bug incorrectly validating Email field values containing special characters.
Fix - Fixed missing "dashicons" asset dependency from front-end forms.
Fix - Fixed bug causing Review JSON diff modal to appear with narrow column since WP 5.7.
Dev - Added label elements to Repeater, Flexible Content and Clone field's table header titles.
Dev - Added new ACF_EXPERIMENTAL_ESC_HTML constant. Read more
5.9.5
Fix - Fixed regression preventing blocks from loading correctly within the editor in WordPress 5.5.
Fix - Fixed bug causing incorrect post_status properties when restoring a Field Group from trash in WordPress 5.6.
Fix - Fixed edge case bug where a taxonomy named "options" could interfere with saving and loading option values.
Fix - Fixed additional PHP 8.0 warnings.
i18n - Updated Finnish translation thanks to Mikko Kekki
5.9.4
Enhancement - Added PHP validation for the Email field (previously relied solely on browser validation).
Fix - Added support for PHP 8.0 (fixed logged warnings).
Fix - Added support for jQuery 3.5 (fixed logged warnings).
Fix - Fixed bug causing WYSIWYG field to appear unresponsive within the Gutenberg editor.
Fix - Fixed regression preventing "blog%d" and "site%d" as valid $post_id values for custom Taxonomy terms.
Fix - Fixed bug causing Radio field label to select first choice.
Fix - Fixed bug preventing preloading blocks that contain multiple parent DOM elements.
i18n - Updated Japanese translation thanks to Ryo Takahashi.
i18n - Updated Portuguese translation thanks to Pedro Mendonça.
5.9.3
Fix - Fixed bug causing Revision meta to incorrectly update the parent Post meta.
Fix - Fixed bug breaking "Filter by Post Type" and "Filter by Taxonomy" Field settings.
