Czym sa WordPress custom fields i ACF?

WordPress custom fields, zwane tez post meta, to pary klucz wartosc dolaczone do wpisu, strony lub custom post type. Zyja w tabeli wp_postmeta z kolumnami meta_id, post_id, meta_key i meta_value (longtext). WordPress obsluguje custom fields od wersji 1.5 (luty 2005). Natywny interfejs siedzi w Opcjach ekranu po wlaczeniu skrzynki Custom Fields, ale w praktyce jest rzadko uzywany, bo Advanced Custom Fields (ACF) i podobne pluginy oferuja znacznie lepsze doswiadczenie edycji. ACF stworzyl Elliot Condon w 2011, w 2021 przejela go Delicious Brains a w maju 2022 WP Engine. W 2025 ACF ma ponad 2 miliony aktywnych instalacji. ACF dodaje field groups, ponad 30 typow pol (Text, Number, Email, Image, Gallery, File, Repeater, Flexible Content, Group, Relationship, Post Object, Taxonomy, User, Date Picker, Color Picker, Google Map, oEmbed, WYSIWYG), logike warunkowa, reguly lokalizacji i schludne API PHP: get_field( 'price' ), the_field( 'subtitle' ), have_rows( 'gallery' ). Darmowy ACF zawiera wiekszosc pol. ACF Pro (z advancedcustomfields.com, okolo 49 USD rocznie za jedna strone do 249 USD dozywotnio dla nielimitowanych) dodaje Repeater, Flexible Content, Gallery, Clone, Options Pages i rejestracje blokow. ACF Blocks (od ACF 5.8, sierpien 2019) pozwalaja rejestrowac bloki Gutenberga w PHP z polami ACF. 10.10.2024 WordPress.org usunal ACF z katalogu pluginow po sporze o znak towarowy z WP Engine i zastapil go forkiem spolecznosci o nazwie Secure Custom Fields (SCF). ACF Pro pozostalo dostepne w advancedcustomfields.com. W 2025 ACF (od WP Engine) i SCF wspolistnieja jako osobne pluginy.

Jak wyglada tabela wp_postmeta?

+-----------+---------+-----------------+----------------+
| meta_id   | post_id | meta_key        | meta_value     |
+-----------+---------+-----------------+----------------+
| 1         | 42      | _edit_lock      | 1736178921:1   |
| 2         | 42      | price           | 19.99          |
| 3         | 42      | subtitle        | Edycja limitow.|
| 4         | 42      | gallery_0_image | 1023           |
+-----------+---------+-----------------+----------------+

Natywne custom fields

1. Otworz wpis w edytorze.
2. Trzy kropki prawy gorny rog, Preferencje, Panele, wlacz Custom Fields.
3. Nazwa (meta_key) i wartosc (meta_value).
4. W motywie: get_post_meta( $post_id, 'price', true ).

Advanced Custom Fields (ACF)

• Repeater: zagniezdzone powtarzalne grupy.
• Flexible Content: predefiniowane sekcje w dowolnej kolejnosci.
• Gallery: wiele obrazow.
• Clone: ponowne uzycie field groups.
• Options Pages: ustawienia globalne.
• ACF Blocks: bloki Gutenberga w PHP z polami ACF.

Jak uzywac ACF

1. Zainstaluj ACF/SCF lub pobierz ACF Pro.
2. Custom Fields, Add New, nazwij field group.
3. Dodaj Text subtitle, Number price, Image hero_image, Repeater faqs.
4. Location: post type rowny product.
5. Opublikuj.

<?php
$subtitle = get_field( 'subtitle' );
$price    = get_field( 'price' );
$hero     = get_field( 'hero_image' );
?>

Fork ACF/SCF (pazdziernik 2024)

27.09.2024 doszlo do publicznego sporu miedzy WordPress.org a WP Engine. 10.10.2024 Matt Mullenweg usunal ACF z katalogu i zastapil go Secure Custom Fields (SCF). Strony z automatycznymi aktualizacjami otrzymaly SCF. ACF Pro nie zostalo dotkniete i nadal jest sprzedawane w advancedcustomfields.com.

Alternatywy dla ACF

Custom fields i REST API

• register_post_meta() z show_in_rest => true eksponuje pole pod meta w /wp-json/wp/v2/<post-type>/<id>.
• ACF Pro dodaje wsparcie REST automatycznie pod wlasciwoscia acf.
• WPGraphQL for ACF dodaje field groups do schematu GraphQL.

Wydajnosc

• get_post_meta() bez argumentow ladowuje WSZYSTKIE meta wpisu i cachuje je.
• Zapytania po meta_key sa wolne w skali (brak indeksu). Powyzej 50.000 wpisow: wlasna tabela lub ElasticPress.
• Wylacz natywny dropdown add_filter( 'postmeta_form_keys', '__return_false' ).
• ACF zapisuje klucz referencyjny dla kazdego pola (_subtitle z field_64ab123), co podwaja liczbe wierszy, ale zapewnia spojnosc.

Czeste wzorce

• Globalne opcje przez ACF Options Pages.
• Page builder bez buildera przez Flexible Content.
• Powiazane wpisy (Post Object, Relationship).
• Wielokrotne sekcje (Clone).
• Pola warunkowe.

Co sprawdza InspectWP

InspectWP wykrywa ACF, SCF i podobne pluginy custom fields skanujac zaladowane skrypty, klasy body i endpointy REST API. Raport identyfikuje headless setupy korzystajace z rozszerzenia REST ACF i sygnalizuje publicznie wystawione pola meta, ktore moga wyciekac wewnetrzne dane.