Кодування для розширених спеціальних полів: вступ
Advanced Custom Fields (ACF) – це плагін WordPress, який є чудовим інструментом для налаштування користувацьких мета публікацій. Це дозволяє вам легко створювати та налаштовувати складні та зручні метабокси з усіма видами полів і налаштувань для типів публікацій, таксономії, екранів користувачів і сторінок параметрів. І це надзвичайно зручно для розробників.
Тепер ви можете налаштувати власні мета-поля або параметри вручну, але для більш складних налаштувань вам знадобиться досить багато коду, включаючи стилі, Javascript, перевірку та збереження обробки. Уявіть собі, наприклад, ручне написання повторювача з групою налаштувань, мультивибір постів за певним запитом. Або обробка налаштувань відображення, які залежать від певних змінних, наприклад від того, який термін або шаблон сторінки призначено (для чого потрібен Javascript). Advanced Custom Fields обробляє все це, і робить це чудово.
Майте на увазі, що розширені користувацькі поля фактично не виведуть жодної вашої власної мета-мети у ваших шаблонах. Виводити або робити щось на основі полів і параметрів, налаштованих за допомогою ACF, залежить від вас як розробника. Але це легко зробити будь-яким із методів ACF. Також приємно знати, що ACF використовує метафункціональність ядра WordPress (пост, термін, користувач). Це означає, що він фактично зберігає, наприклад, налаштування для публікацій як мета публікації, якою ви можете керувати за допомогою основних функцій, таких як get_post_meta().
Advanced Custom Fields є у безкоштовній версії та платній версії Pro. Безкоштовної версії більш ніж достатньо для більшості випадків, але у версії Pro ви отримуєте деякі додаткові функції, такі як поле повторювача, поле галереї, блоки Гутенберга (див. пізніше) і можливість використовувати ACF для налаштування власного адміністратора. сторінки опцій. ACF також настільки популярний, що ви можете легко знайти високоякісні розширення для всього, що не охоплює основний ACF.
Розширені настроювані поля: частина адміністратора
Коли ви встановите плагін Advanced Custom Fields, ви отримаєте нове меню адміністратора для «Custom Fields». Тут ви можете налаштувати та налаштувати свої «метаблоки» або групи параметрів.
У групі ви можете налаштувати скільки завгодно полів різних типів. Найпоширенішими з них є введення тексту, текстове поле, редактор форматованого тексту, файл, зображення, істина/неправда (перемикач), прапорці, перемикачі та поле вибору. Інші поширені — це кілька способів вибору дописів, вибір таксономії, вибір користувачів, інструмент вибору дати, вибір кольору, Карти Google і багато, багато іншого. Залежно від того, який тип поля ви виберете, ви отримаєте ряд додаткових параметрів для налаштування поля. Ви також можете додати умовну логіку до будь-якого поля. Умовна логіка призначена для приховування або показу полів залежно від інших параметрів у групі.
Для кожної групи параметрів ви можете визначити, у яких випадках ці параметри мають з’являтися. Прикладом є редагування дописів, терміна таксономії або редагування користувача. Ви можете додатково налаштувати видимість своїх налаштувань, наприклад, типу публікації. Або якщо публікація має певний термін або шаблон сторінки, якщо публікація належить певному автору, якщо роль користувача така чи така, роль поточного користувача, який увійшов у систему, або якщо сторінка є батьківською сторінкою чи ні. Ви також можете налаштувати, де має з’являтися метаполе. Однак тепер ця функціональність дещо зменшена з новим редактором Gutenberg.
Створення групи
Налаштування для одного поля
Розширені спеціальні поля: частина коду
Давайте розглянемо більш цікаву частину: як ви можете використовувати розширені настроювані поля за допомогою коду. Як згадувалося раніше, ACF надзвичайно зручний для розробників і пропонує широкий спектр можливостей налаштування.
Отримати значення та вивести їх у ваші шаблони легко зробити за допомогою методів ACF. Наприклад the_field('your_meta_key'), для прямого відтворення або get_field('your_meta_key')для збереження у змінній PHP. Надайте ідентифікатор публікації як другий аргумент, якщо вам потрібно отримати дані поза циклом. Простенька. Ви можете використовувати get_post_meta(), але рекомендується використовувати методи ACF, оскільки ACF може перетворити значення на щось більш значуще, перш ніж повернути його вам.
Інша річ, про яку вам слід знати, це інструмент експорту в ACF. Ви можете експортувати створені групи в два формати; або файл JSON, який можна завантажити, або чистий код PHP. Файл JSON корисний, якщо вам потрібно експортувати налаштування між тестовим і живим серверами або іншим WordPress. Експорт у чистому PHP дає вам можливість безпосередньо вставити його у ваші PHP-файли теми чи плагіна.
Як ви можете зробити висновок з цього; ви можете використовувати PHP-код, написавши його вручну або експортувавши після налаштування в адміністраторі, щоб додати свої групи та поля. Це дає більше можливостей контролю та створення власних варіантів.
Але зачекайте, є ще щось! ACF також пропонує широкий спектр дій і фільтрів для подальшого налаштування полів або їх значень. Є хуки для збереження або рендерингу поля, а також хуки для реєстрації груп за кодом (згадані вище), а також фільтри для налаштування значень полів, налаштувань або вибору перед збереженням або рендерингом. Ви можете додатково вказати, чи має фільтр впливати на всі поля, поля певного типу чи поля певного мета-ключа. Усі хуки та фільтри мають префікс acf/.
Перегляньте сторінку документації ACF ; натисніть «Функції», «Дії» або «Фільтри», щоб переглянути огляд. На цьому сайті ви також знайдете чудові підручники та посібники.
Примітка про розширені спеціальні поля та Gutenberg
Створення нестандартних блоків Гутенберга на даний момент є досить важким завданням. Документація не зовсім на місці, в ній часто відбуваються зміни, і для кодування потрібно досить добре знати Javascript. Бажано вам знадобиться знання React і того, як налаштувати компілятор з JSX/ES6 з webpack і Babel.
Однак у версії 5.8 ACF Pro представлена функція налаштування групи полів як блоку Гутенберга, що дозволяє додавати власні блоки виключно за допомогою коду ACF і PHP. Знання Javascript не потрібне!
Все, що вам потрібно зробити, це налаштувати групи в admin або за допомогою коду, як зазвичай. Але потім визначивши їх розташування як блок Гутенберга. Залишається лише додати PHP-код, щоб зареєструвати їх як спеціальний блок Гутенберга за допомогою acf_register_block(). Для цієї функції ви визначаєте зворотний виклик функції PHP або файлу шаблону, який відповідає за рендеринг виведення блоку. Ви пишете цю функцію або частину шаблону повністю на PHP і використовуєте знайомі методи, наприклад get_field()для отримання значень налаштувань.
Як виглядає блок ACF у редакторі Gutenberg
Слідкуйте за новинами в категорії Advanced Custom Fields, щоб дізнатися, як використовувати цей плагін!