Jak wyświetlić wartości pól niestandardowych w WordPress

Pola niestandardowe (custom fields) to jedna z najbardziej obciążonych pracą funkcji WordPressa w projektach agencyjnych. Pozwalają dołączyć do wpisu, strony albo CPT dodatkowe dane: lokalizację wydarzenia, identyfikator ERP, podpis eksperta, status oferty - wszystko jako wiersze w wp_postmeta.

Ten przewodnik idzie od get_post_meta() przez escapowanie, metaboxy, ACF, cache i rejestrację meta pod REST/Gutenberg. Bez frameworka „na zapas”: najpierw natywne API, potem warstwa wygody.

Więcej o profesjonalnym rozwoju WordPress na WPPoland.

#Jak działa get_post_meta() w WordPress

Funkcja get_post_meta() to fundament odczytu:

// Pojedyncza wartość
$value = get_post_meta( $post_id, 'meta_key', true );

// Tablica wartości pod tym samym kluczem
$values = get_post_meta( $post_id, 'meta_key', false );

// Wszystkie metadane wpisu
$all_meta = get_post_meta( $post_id );

#Parametry funkcji get_post_meta()

Trzeci argument jest źródłem klasycznych bugów. Przy $single = true pusta meta zwraca pusty string. Przy false dostajesz tablicę - nawet z jednym elementem. Kod, który robi if ( $value ) na tablicy, zachowuje się inaczej niż na stringu.

Prefiksuj klucze nazwą projektu (wppoland_event_city), żeby nie kolidować z wtyczkami. Unikaj generycznych price, date, city bez namespace - wcześniej czy później WooCommerce albo SEO plugin zajmie tę samą nazwę.

#Co get_post_meta() zwraca dla liczb, wartości logicznych i brakujących kluczy

Wszystko, co leży w wp_postmeta, wraca jako tekst, chyba że zostało zserializowane. Docblock funkcji get_post_meta() w rdzeniu WordPressa wymienia konwersje: false wraca jako pusty string, true jako '1', a liczby całkowite i zmiennoprzecinkowe jako stringi. Tablice i obiekty zachowują typ, bo WordPress serializuje je przy zapisie i odserializowuje przy odczycie.

Przypadki brzegowe z tego samego docblocka: nieprawidłowe ID wpisu (nienumeryczne, zero albo ujemne) zwraca false. Prawidłowe ID bez klucza zwraca '' przy $single = true i pustą tablicę przy $single = false. Wartość default zarejestrowana przez register_meta() (dostępna od WordPressa 5.5) nigdy nie trafia do bazy, więc wraca w zarejestrowanym typie.

update_post_meta( $post_id, 'wppoland_stan', 0 );

$stan = get_post_meta( $post_id, 'wppoland_stan', true );
var_dump( $stan );        // string(1) "0"
var_dump( 0 === $stan );  // bool(false)

$stan = (int) $stan;      // rzutuj przed obliczeniami i ścisłym porównaniem

Ścisłe porównanie z liczbą całkowitą nigdy nie trafi w zapisaną wartość. Rzutuj przez (int), (float) albo absint() przed obliczeniami i porównuj z '0' === $value, gdy zero ma znaczenie.

#Jak sprawdzić, czy pole niestandardowe istnieje

Pusty string z get_post_meta() nie mówi, czy klucz zapisano jako pusty, czy nie zapisano go wcale. metadata_exists() (od WordPressa 3.3) odpowiada właśnie na to pytanie i czyta ten sam cache meta, więc nie dokłada zapytania, gdy meta wpisu jest już załadowana:

if ( metadata_exists( 'post', $post_id, 'wppoland_sku' ) ) {
    $sku = get_post_meta( $post_id, 'wppoland_sku', true );
    // Klucz istnieje, nawet jeśli wartość to pusty string.
}

Funkcja najpierw przepuszcza wynik przez filtr get_post_metadata, co widać w kodzie meta.php, więc wtyczka przechwytująca odczyty meta może zmienić odpowiedź. Używaj jej, gdy „puste” i „nieustawione” wymagają innej obsługi, na przykład gdy redakcja celowo czyści pole i szablon nie powinien wtedy sięgać po wartość domyślną.

#get_post_meta() a the_meta()

the_meta() jest przestarzała od WordPressa 6.0.2. Jej wywołanie odpala _deprecated_function() z get_post_meta() jako zamiennikiem, co przy włączonym WP_DEBUG daje komunikat. Funkcja wypisuje w pętli listę <ul class='post-meta'> ze wszystkimi polami niestandardowymi bieżącego wpisu. Escapuje klucze i wartości przez esc_html() i pomija klucze chronione (zaczynające się od podkreślnika), ale nie przyjmuje konkretnego klucza i nie daje kontroli nad markupem ani nad tym, które klucze się pojawią.

// Przestarzałe: wypisuje wszystkie niechronione klucze bieżącego wpisu
the_meta();

// Zalecane: czytasz jeden klucz, decydujesz o HTML, escapujesz w kontekście
$nip = get_post_meta( get_the_ID(), 'wppoland_nip', true );
if ( $nip ) {
    echo '<p class="nip">' . esc_html( $nip ) . '</p>';
}

Zostaw the_meta() starym motywom, które jej jeszcze używają, albo widokowi debugowania na stagingu. Na produkcji szablony archiwów, pojedynczych CPT i partiale kart produktu powinny czytać jawne klucze. Dzięki temu meta wewnętrzna (ID z ERP, tokeny integracji, notatki redakcji) zapisana bez podkreślnika nie wyląduje na publicznej stronie. Kod funkcji jest w post-template.php.

#Jak wyświetlić pole niestandardowe w motywie

#W pętli WordPressa

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
    <h2><?php the_title(); ?></h2>

    <?php
    $sku = get_post_meta( get_the_ID(), 'wppoland_sku', true );
    if ( $sku ) :
        ?>
        <p class="sku"><?php echo esc_html( $sku ); ?></p>
    <?php endif; ?>

<?php endwhile; endif; ?>

#Jak pobrać pole niestandardowe poza pętlą

$post_id     = 42;
$author_name = get_post_meta( $post_id, 'custom_author', true );
echo esc_html( $author_name );

Na archiwach CPT nie odwołuj się do globalnego $post „na ślepo” poza pętlą - bierz ID z get_queried_object_id() albo z argumentu szablonu. To częsty powód „leci meta z poprzedniego wpisu”.

Partialom wielokrotnego użytku (karta wydarzenia, karta nieruchomości) przekazuj ID jako argument funkcji. Klasyczne szablony i wzorce motywu blokowego łatwo się mieszają, a jawne ID oszczędza niespodzianek, gdy ten sam partial działa wewnątrz Query Loop.

#Jak bezpiecznie escapować pola niestandardowe

Nigdy nie wypuszczaj surowych metadanych do HTML:

// Źle - podatne na XSS
echo get_post_meta( $post_id, 'user_input', true );

// Dobrze
echo esc_html( get_post_meta( $post_id, 'user_input', true ) );

// URL
echo esc_url( get_post_meta( $post_id, 'website_url', true ) );

// Atrybut HTML
echo esc_attr( get_post_meta( $post_id, 'css_class', true ) );

Reguła kciuka: kontekst decyduje o funkcji. Tekst widoczny - esc_html. Atrybut - esc_attr. URL - esc_url. HTML z zaufanego źródła redakcyjnego - wp_kses_post. Meta wypełniane przez front-end formularz traktuj jak nieufne zawsze, nawet jeśli „to tylko intranet”.

Po stronie zapisu: sanitize_text_field, absint, sanitize_email, ewentualnie własny callback w register_post_meta. Nie polegaj na tym, że metabox „jest tylko w adminie” - REST i bulk edit też zapisują.

#Jak zapisać pola niestandardowe w WordPress

#Funkcje update_post_meta(), add_post_meta() i delete_post_meta()

update_post_meta( $post_id, 'meta_key', 'meta_value' );
add_post_meta( $post_id, 'meta_key', 'meta_value' );
delete_post_meta( $post_id, 'meta_key' );

update_post_meta tworzy wiersz, jeśli nie istnieje. add_post_meta z domyślnym $unique = false pozwala na wiele wartości pod jednym kluczem - świadoma decyzja, nie wypadek.

#Jak dodać własny metabox funkcją add_meta_box()

function add_sku_metabox() {
    add_meta_box(
        'product_sku_box',
        'Kod katalogowy',
        'render_sku_metabox',
        'post',
        'side'
    );
}
add_action( 'add_meta_boxes', 'add_sku_metabox' );

function render_sku_metabox( $post ) {
    wp_nonce_field( 'save_sku', 'sku_nonce' );
    $sku = get_post_meta( $post->ID, 'wppoland_sku', true );
    ?>
    <label for="wppoland_sku">SKU:</label>
    <input type="text" id="wppoland_sku" name="wppoland_sku"
           value="<?php echo esc_attr( $sku ); ?>">
    <?php
}

function save_sku_metabox( $post_id ) {
    if ( ! isset( $_POST['sku_nonce'] ) ||
        ! wp_verify_nonce( $_POST['sku_nonce'], 'save_sku' ) ) {
        return;
    }

    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return;
    }

    if ( ! current_user_can( 'edit_post', $post_id ) ) {
        return;
    }

    if ( isset( $_POST['wppoland_sku'] ) ) {
        update_post_meta(
            $post_id,
            'wppoland_sku',
            sanitize_text_field( wp_unslash( $_POST['wppoland_sku'] ) )
        );
    }
}
add_action( 'save_post', 'save_sku_metabox' );

Nonce, capability, autosave - trzy rzeczy, które w tutorialach giną, a na audycie bezpieczeństwa wychodzą jako pierwsze. Dopisz też wp_unslash przed sanitizacją POST.

#Jak pobrać pole ACF funkcją get_field()

ACF upraszcza UI i typy pól (repeater, flexible, relationship):

$sku   = get_field( 'wppoland_sku' );
$image = get_field( 'hero_image' );
the_field( 'product_description' );
$value = get_field( 'field_name', $post_id );

Pamiętaj, że dla wpisów ACF i tak zapisuje wartości w postmeta. Do zapytań meta_query często i tak odwołujesz się do kluczy jak w natywnym API. Przy dużych listingach sprawdzaj, czy nie wołasz get_field w pętli bez wcześniejszego update_meta_cache / bez Query, które prefetchuje meta.

Jeśli motyw ma działać po wyłączeniu ACF, trzymaj warstwę fallback:

$sku = function_exists( 'get_field' )
    ? get_field( 'wppoland_sku', $post_id )
    : get_post_meta( $post_id, 'wppoland_sku', true );

Dla pól obrazka ACF get_field zwraca ID, URL albo tablicę, zależnie od ustawionego formatu zwracanej wartości. Zgraj ten format z tym, czego oczekuje szablon, zanim przekażesz wartość do wp_get_attachment_image albo esc_url.

#Czy the_field() w ACF escapuje wynik

Dokumentacja get_field() mówi, że zwrócone wartości trzeba przed wypisaniem przepuścić przez odpowiednią funkcję escapującą, bo ACF nie wie, gdzie ich użyjesz. Przy echo get_field() escapowanie jest po twojej stronie.

the_field() działa inaczej od ACF 6.2.7. Przewodnik ACF o escapowaniu HTML podaje, że od 6.2.5 wynik shortcode’u ACF przechodzi przez wp_kses(), a od 6.2.7 dotyczy to także the_field() i the_sub_field(). Notatka do wydania bezpieczeństwa 6.2.5 ostrzega, że usuwa to niebezpieczny HTML, na przykład skrypty i iframe’y, z pól textarea i WYSIWYG. Od ACF 6.2.6 get_field() przyjmuje też czwarty argument, $escape_html, który zwraca wartość po escapowaniu i wymaga $format_value ustawionego na true.

// Escapowane przez ACF (wp_kses) od 6.2.7
the_field( 'event_summary' );

// Bez escapowania: sam wybierasz funkcję do kontekstu
echo esc_html( get_field( 'event_summary' ) );

// Od 6.2.6: prosisz typ pola o wartość po escapowaniu
echo get_field( 'event_summary', false, true, true );

Jeśli po aktualizacji ACF zniknął embed w polu WYSIWYG, to zwykle jest przyczyna. Zdecyduj dla każdego pola, czy HTML jest zaufany, i wypisuj go przez wp_kses_post() albo własną listę dozwolonych tagów, zamiast globalnie wyłączać escapowanie.

#Jak pokazać panel własnych pól w edytorze blokowym

Natywne pole „Własne pola” istnieje także w edytorze blokowym, ale jest domyślnie ukryte, jeśli wcześniej z niego nie korzystano. Dokumentacja WordPress.org o polach niestandardowych opisuje ścieżkę. Przy polskim interfejsie nazwy pochodzą z oficjalnej paczki językowej: najpierw zapisz wpis, otwórz menu Opcje (trzy kropki na górnym pasku), wybierz Preferencje, przejdź do zakładki Ogólne, w sekcji Zaawansowane włącz Własne pola i kliknij Pokaż i przeładuj stronę. Panel pojawi się pod treścią; przyciski Wpisz nowy i Dodaj własne pole tworzą klucz i jego wartość.

Dwie rzeczy ukrywają pola w tym panelu. Klucze zaczynające się od podkreślnika są chronione i nigdy nie trafiają na listę, dlatego klucze Yoasta czy WooCommerce są niewidoczne. A ACF domyślnie usuwa ten panel: referencja ustawień ACF wymienia remove_wp_meta_box (od ACF 5.6.0, domyślnie true). Tak przywrócisz natywny panel przy aktywnym ACF:

add_filter( 'acf/settings/remove_wp_meta_box', '__return_false' );

Przydaje się to do debugowania importów na stagingu. Na produkcji redaktorzy, którzy widzą surowe klucze obok pól ACF, potrafią edytować tę samą wartość w dwóch miejscach, więc tam panel zostaje wyłączony.

#Jak wyświetlić meta w motywie blokowym przez render_block

W motywach blokowych (FSE) duża część prezentacji wychodzi z klasycznego single.php do szablonów HTML i filtra render_block. Meta nadal czytasz w PHP; zmienia się miejsce wstrzyknięcia.

add_filter( 'render_block', 'wppoland_inject_sku_after_title', 10, 2 );

function wppoland_inject_sku_after_title( $block_content, $block ) {
    if ( ( $block['blockName'] ?? '' ) !== 'core/post-title' ) {
        return $block_content;
    }

    if ( ! is_singular( 'product' ) ) {
        return $block_content;
    }

    $sku = get_post_meta( get_the_ID(), 'wppoland_sku', true );
    if ( ! $sku ) {
        return $block_content;
    }

    $extra = '<p class="sku">' . esc_html( $sku ) . '</p>';
    return $block_content . $extra;
}

We wzorcach motywu nie wpisuj na sztywno ID wpisów ze stagingu. Czytaj meta z bieżącego kontekstu (get_the_ID() wewnątrz Query Loop) albo przekazuj atrybuty bloku.

#Jak podpiąć pole niestandardowe do bloku przez Block Bindings

Od WordPressa 6.5 Block Bindings API łączy bloki rdzenia z wartościami pól niestandardowych bez budowania własnego bloku. Źródło core/post-meta czyta wartość przez get_post_meta() w chwili renderowania.

#Które bloki obsługują Block Bindings

Lista atrybutów, które można podpiąć, siedzi w rdzeniu i rosła z każdą wersją, co widać w gałęziach wydań wordpress-develop:

Źródła: class-wp-block.php w gałęzi 6.5 i block-bindings.php w gałęzi 7.1.

#Rejestracja meta i podpięcie do akapitu

add_action( 'init', function () {
    register_post_meta( 'post', 'wppoland_notka_autora', [
        'show_in_rest'  => true,
        'single'        => true,
        'type'          => 'string',
        'auth_callback' => function () {
            return current_user_can( 'edit_posts' );
        },
    ] );
} );

<!-- wp:paragraph {"metadata":{"bindings":{"content":{"source":"core/post-meta","args":{"key":"wppoland_notka_autora"}}}}} -->
<p>Tekst zastępczy, gdy meta jest pusta.</p>
<!-- /wp:paragraph -->

Źródło core/post-meta nie zwraca nic w czterech przypadkach: klucz nie jest zarejestrowany z show_in_rest, klucz jest chroniony (zaczyna się od podkreślnika), wpis nie jest publiczny i odwiedzający nie ma prawa go czytać, albo wpis jest chroniony hasłem. Klucz w rodzaju _wppoland_notka_autora nigdy więc nie wyświetli się przez binding, nawet zarejestrowany. Do wszystkiego, co chcesz podpinać, używaj kluczy bez podkreślnika. Bindingi nie zastępują escapowania po stronie serwera dla HTML, który piszesz ręcznie.

#Jak zarejestrować własne źródło Block Bindings

Gdy wartość wymaga obróbki (sformatowana cena, data w formacie serwisu), zarejestruj własne źródło w PHP przez register_block_bindings_source() na hooku init. Callback dostaje argumenty bindingu, instancję bloku i nazwę atrybutu, jak opisuje docblock w block-bindings.php:

add_action( 'init', function () {
    register_block_bindings_source( 'wppoland/formatted-price', [
        'label'              => __( 'Sformatowana cena', 'wppoland' ),
        'uses_context'       => [ 'postId' ],
        'get_value_callback' => function ( array $source_args, $block_instance ) {
            $post_id = $block_instance->context['postId'] ?? get_the_ID();
            $raw     = get_post_meta( $post_id, $source_args['key'] ?? '', true );

            return '' === $raw ? null : number_format_i18n( (float) $raw, 2 );
        },
    ] );
} );

Markup bloku używa wtedy "source": "wppoland/formatted-price" z kluczem meta w args. Nazwa źródła wymaga prefiksu przestrzeni nazw, np. wppoland/, i może zawierać tylko małe litery, cyfry, myślniki i ukośniki.

#Wydajność pól niestandardowych i cache meta

WordPress przy standardowym WP_Query woła update_meta_cache() i ładuje meta wpisów hurtowo. Wielokrotne get_post_meta() na tym samym ID w jednym requeście nie generuje kolejnych SELECT-ów - o ile object cache działa.

Antywzorzec: w pętli 50 kart odpalasz osobne WP_Query zależne od meta. Lepiej jeden query z meta_query albo dwa etapy (IDs, potem get_posts).

$args = [
    'post_type'  => 'product',
    'meta_query' => [
        [
            'key'     => 'wppoland_sku',
            'value'   => 'A',
            'compare' => 'LIKE',
        ],
    ],
];
$query = new WP_Query( $args );

Unikaj sortowania po meta na wielkich zbiorach bez indeksu - MySQL nie lubi ORDER BY po meta_value na setkach tysięcy wierszy. Czasem lepsza jest denormalizacja do taksonomii albo własnej tabeli.

Autoload nie dotyczy postmeta, ale jeśli kopiujesz wzorce z get_option, nie włączaj autoload na opcjach „bo wygodniej” - to osobna klasa problemów TTFB.

#Pola niestandardowe w Gutenbergu i REST API

Żeby meta była widoczna w edytorze bloków i REST API, zarejestruj ją:

register_post_meta( 'post', 'wppoland_sku', [
    'show_in_rest'      => true,
    'single'            => true,
    'type'              => 'string',
    'sanitize_callback' => 'sanitize_text_field',
    'auth_callback'     => function () {
        return current_user_can( 'edit_posts' );
    },
] );

Bez show_in_rest blok JS nie zobaczy pola. Bez auth_callback możesz przypadkiem otworzyć zapis meta szerszej grupie niż chciałeś. type musi zgadzać się z realnymi danymi - number vs string w JSON to źródło cichych bugów w sidebarze.

Dla pól złożonych (obiekty, listy) ustaw show_in_rest ze schematem; inaczej Gutenberg dostanie płaski string i „zgubi” strukturę.

#Dlaczego pola niestandardowe nie pojawiają się w REST API dla CPT

Dla własnego typu treści jest jeszcze jeden warunek, zapisany w docblocku register_meta(): typ treści musi deklarować obsługę pól niestandardowych, inaczej zarejestrowana meta nie trafi do odpowiedzi REST.

register_post_type( 'wydarzenie', [
    'public'       => true,
    'show_in_rest' => true,
    'supports'     => [ 'title', 'editor', 'custom-fields' ],
] );

register_post_meta( 'wydarzenie', 'wppoland_miejsce', [
    'show_in_rest'      => true,
    'single'            => true,
    'type'              => 'string',
    'sanitize_callback' => 'sanitize_text_field',
    'auth_callback'     => function () {
        return current_user_can( 'edit_posts' );
    },
] );

Ten sam docblock wymienia dwa nowsze argumenty. revisions_enabled (WordPress 6.4) zapisuje meta razem z rewizjami wpisu i działa tylko dla typu obiektu post. label (WordPress 6.7) nadaje kluczowi czytelną nazwę.

#Najczęstsze błędy z polami niestandardowymi w WordPress

1. Wyświetlanie meta bez esc_*.
2. Zapis z $_POST bez nonce i capability.
3. Ten sam klucz meta używany przez dwie wtyczki.
4. get_field w pętli archiwum bez cache / bez batch meta.
5. Założenie, że $single = true zawsze zwraca string (serializowane tablice po starych importach).
6. Brak register_post_meta przy budowie bloku - „działa w PHP, nie działa w edytorze”.
7. the_meta() na produkcji i wewnętrzne klucze na publicznej stronie.
8. Podpięcie chronionego _klucza przez Block Bindings i szukanie, czemu nic się nie wyświetla.

#Jak nazywać klucze meta i migrować z ACF

Gdy przejmujesz stary motyw, zrób inwentaryzację kluczy: SELECT meta_key, COUNT(*) FROM wp_postmeta GROUP BY meta_key ORDER BY COUNT(*) DESC LIMIT 50. Od razu widać, które prefiksy są „twoje”, a które zostały po wtyczkach usuniętych lata temu. Prefiks projektu (wppoland_, client_) chroni przed kolizją z ACF albo WooCommerce.

Przy migracji z ACF na natywne register_post_meta nie kopiuj ślepo field_xxxxx. Zostaw czytelny klucz biznesowy i, jeśli trzeba, jednorazowy skrypt mapujący stare ID na nowe. Staging najpierw: porównaj liczbę wpisów z niepustym meta przed i po. Jeśli eksportujesz CSV dla redakcji, trzymaj osobną kolumnę na ID posta - tytuł nie jest unikalny.

W multisite pamiętaj, że get_post_meta jest zawsze w kontekście bieżącego bloga. Przełączanie switch_to_blog wokół odczytu meta bez restore_current_blog w finally to klasyczny sposób na „losowe” dane z innego sklepu w sieci.

#Checklista pól niestandardowych przed wdrożeniem

1. Każde wyjście ma esc_html, esc_attr albo wp_kses_post zgodnie z kontekstem.
2. Formularze zapisu mają nonce i current_user_can.
3. Meta używana w REST ma show_in_rest i auth_callback, a CPT deklarują obsługę custom-fields.
4. Brak ORDER BY meta_value na dużych archiwach bez uzasadnienia i indeksu.
5. Stare klucze po wtyczkach są albo udokumentowane, albo usunięte skryptem cleanup na staging.
6. Żaden szablon produkcyjny nie woła the_meta() dla publicznej treści.
7. Klucze podpinane przez Block Bindings nie mają podkreślnika na początku.

#Dlaczego get_post_meta zwraca tablicę zamiast stringa

get_post_meta( $id, $key, true ) potrafi zwrócić tablicę, jeśli w bazie leży zserializowany PHP array z migracji sprzed lat. Kod zakładający string wywali notice albo wypisze „Array”. Przed esc_html sprawdź typ albo normalizuj przy zapisie.

Unikaj ręcznego serialize() / unserialize() na danych z użytkownika. WordPress sam serializuje złożone wartości w meta; Ty podajesz tablicę do update_post_meta. Przy odczycie z zewnętrznych systemów mapuj pola na skalarne klucze zamiast pakować cały wiersz do jednego blobu - łatwiej potem filtrować meta_query.

Dla pól wrażliwych (tokeny integracji, wewnętrzne ID) trzymaj show_in_rest wyłączone albo ogranicz schema tak, by REST ich nie ekspozyował publicznie. Front motywu może czytać je w PHP przy renderze, bez wystawiania na /wp-json/.

Testuj zapis meta jako użytkownik z rolą edytora, nie tylko jako administrator. Metabox albo grupa ACF powinna mieć jednozdaniowy opis dla redakcji: skąd brać wartość, czy pole jest wymagane, co się stanie na froncie gdy puste. W szablonie obsługuj stan pusty świadomie - ukryj sekcję albo pokaż fallback - zamiast renderować puste znaczniki.

#Podsumowanie

Pola niestandardowe są fundamentem CPT i integracji. Natywne get_post_meta() wystarcza daleko; the_meta() jest przestarzała od 6.0.2. ACF dokłada UX, a od 6.2.7 the_field() przepuszcza wynik przez wp_kses(). W motywach blokowych wartości wstrzykujesz przez render_block albo Block Bindings. Trzy zasady zostają te same: escapuj wyjście, sanityzuj wejście, korzystaj z cache meta zamiast wymyślać własne SELECT-y w pętli. Dobrze nazwany klucz i świadomy register_post_meta oszczędzają tygodnie debugowania przy kolejnym redesignie albo migracji edytora. Jeśli redakcja nie wie, do czego służy pole, pole nie istnieje w praktyce - niezależnie od tego, jak poprawny jest kod szablonu. Krótka ściągawka w Confluence albo w stronie „Wsparcie” w wp-admin robi więcej niż kolejny tooltip w ACF.

Jeśli przejmujesz motyw z setkami luźnych kluczy meta albo migrujesz z ACF na natywne bloki, da się to uporządkować w ramach opieki developerskiej. Napisz przez formularz kontaktowy z krótkim opisem CPT i tego, czy meta ma być edytowalna w Gutenbergu.