eduardweb.
WooCommerce & WordPressIntermediar#wordpress#graphql#headless#acf#rest-api

Cum expui CPT-uri și ACF curat în WordPress Headless fără să sufoci frontend-ul

De Corina Dobre, 10 nov. 2026 · 13 vizualizări · 2 like-uri

Postat 10 nov. 2026
php
add_action('init', function () {
    register_post_type('specificatie_tehnica', [
        'labels' => ['name' => 'Specificații'],
        'public' => true,
        'show_in_rest' => true,
        'rest_base' => 'specificatii',
        'show_in_graphql' => true,
        'graphql_single_name' => 'specificatie',
        'graphql_plural_name' => 'specificatii',
        'supports' => ['title', 'slug']
    ]);
});

// Whitelist strict pe REST: eliminăm balastul ACF default
add_filter('rest_prepare_specificatie_tehnica', function ($response, $post) {
    $data = $response->get_data();
    
    // Păstrăm strict ce randează frontend-ul
    return [
        'id'        => $post->ID,
        'slug'      => $post->post_name,
        'title'     => get_the_title($post),
        'cod_piesa' => get_field('cod_piesa', $post->ID),
        'pdf_manual'=> get_field('fisier_pdf', $post->ID)['url'] ?? null,
    ];
}, 10, 2);

Dacă lași WordPress să expună CPT-urile și câmpurile de ACF așa cum vin ele din fabrică, o să plângi când vezi waterfall-ul în frontend. Am avut un proiect de e-commerce cu un catalog mixt de WooCommerce și vreo 12.000 de articole de tip CPT pentru documentații tehnice. La primele teste, un simplu fetch pe un endpoint REST trăgea un JSON de 1.8MB pentru 10 postări, plin de chei inutile pe care React nici nu le atingea.

Problema clasică e că bifa aia de „Show in REST” din ACF aruncă un obiect gigant sub cheia acf, inclusiv metadate interne, formate de date duplicate și ID-uri de upload pe care nu le ceri niciodată.

WPGraphQL vs REST API: trade-off-ul din producție

Mulți zic să treci direct pe WPGraphQL și WPGraphQL for ACF. Sună bine în teorie: ceri strict ce vrei, primești exact schema aia.

Dar există un revers al medaliei. WPGraphQL funcționează genial cât timp ai interogări standard, dar când ai relații bidirecționale complexe sau field-uri de tip Flexible Content imbricate pe 3 nivele, rezolvarea pe noduri începe să facă N+1 queries în baza de date. Fără un Redis bine reglat și WPGraphQL Smart Cache, la un vârf de 150 req/secundă serverul de PHP intră în comă.

REST API, pe de altă parte, e nativ și cache-ul la nivel de Nginx/FastCGI sau Cloudflare se configurează în 10 minute. Dar ca să fie utilizabil în producție, trebuie să cureți schema cu register_rest_field sau filtre specifice pe response, în loc să trimiți tot blob-ul ACF.

Cum înregistrezi CPT-ul ca să fie gata pentru ambele lumi

Când declari CPT-ul în PHP, nu trânti doar 'show_in_rest' => true. Dacă vrei flexibilitate și opțiunea de a trece oricând pe un frontend Next.js sau Astro cu GraphQL, definește din start câmpurile de graphql, chiar dacă începi pe REST.

La nivel de ACF, evită capcana de a lăsa pluginul să injecteze tot automat. Cel mai sănătos compromis pe care l-am găsit pe proiectele mari e să înregistrezi un controller custom de REST sau să folosești filtrul rest_prepare_{post_type} ca să faci un whitelist strict pe câmpurile din frontend. Trimiți doar title, slug, și cele 4-5 proprietăți custom de care are nevoie componenta ta.

La migrarea aia de 12k SKU-uri, doar scoțând câmpurile nefolosite din payload am coborât timpul de TTFB de la 620ms la 110ms pe nodul de backend.

Voi ce folosiți când legați WP headless la un frontend modern: vă bazați pe WPGraphQL și trageți tare de caching, sau rămâneți pe REST API cu endpoint-uri curățate manual?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.