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

CPT și ACF în WordPress headless: cum expui date curate în REST sau GraphQL

De Radu Grigore, 8 nov. 2026 · 14 vizualizări · 2 like-uri

Postat 8 nov. 2026
php
add_action('init', function () {
    register_post_type('specificatie_tehnica', [
        'labels' => [
            'name' => 'Specificații',
            'singular_name' => 'Specificație',
        ],
        'public' => true,
        'has_archive' => false,
        'show_in_rest' => true,
        'show_in_graphql' => true,
        'graphql_single_name' => 'technicalSpec',
        'graphql_plural_name' => 'technicalSpecs',
        'supports' => ['title', 'editor'],
    ]);
});

Când muți WordPress în headless, cel mai rapid mod de a-ți bate joc de performanță e să trântești ACF pe un Custom Post Type și să lași REST API-ul implicit să scuipe datele. Te trezești în Next.js sau Remix cu payload-uri de 350-500KB pe un singur nod, pline de guid, ping_status și metadate inutile. Dacă adaugi și un catalog WooCommerce sau piese de tip CPT legate de produse, frontend-ul începe să gâfâie rapid.

Am pățit treaba asta anul trecut la un catalog tehnic cu vreo 12.000 de fișe de produs. Frontend-ul făcea parsing la zeci de mega de JSON doar ca să randeze trei tabele de specificații și o galerie foto. Soluția nu a fost să adăugăm servere mai puternice, ci să curățăm schema la sursă.

Capcana ACF to REST API

Plugin-ul clasic ACF to REST API este util în prototipuri rapide de două zile, dar e toxic în producție. Îți aruncă absolut tot obiectul de ACF într-un câmp generic acf, serializat cum îi vine la îndemână.

Dacă ai un câmp de tip Post Object sau Relationship, primești fie doar ID-urile (ceea ce te forțează la waterfall request-uri din frontend), fie obiectele complete WordPress cu toate proprietățile interne de care n-ai nevoie niciodată în browser.

Aici ai două opțiuni reale: customizezi endpoint-urile native de REST cu register_rest_field sau treci complet pe WPGraphQL.

WPGraphQL: salvarea relațiilor complexe

Dacă proiectul are structuri adânci de date — repeaters în repeaters, relații între CPT de branduri și produse WooCommerce — WPGraphQL e mult superior. Împreună cu extensia WPGraphQL for ACF, obții types puternice și ceri strict cele 4 câmpuri care te interesează pe pagina de listing.

Secretul este să nu lași CPT-ul înregistrat pe modul leneș din UI. Definește-l curat în cod, cu argumentele explicite de show_in_graphql, graphql_single_name și graphql_plural_name. Așa eviți coliziunile de denumiri și menții schema GraphQL coerentă.

La proiectul menționat, după trecerea la GraphQL cu queries specifice pe componente, am scăzut greutatea răspunsului de la 420KB la sub 15KB per nod. Diferența de viteză pe conexiuni mobile a fost noapte și zi.

Trade-off-ul cinstit: REST vs WPGraphQL la caching

WPGraphQL este o plăcere pentru dev experience pe frontend, dar aduce o problemă mare: caching-ul la nivel de edge.

REST API folosește GET nativ cu URL-uri unice pe care Cloudflare sau Varnish le pun în cache fără niciun efort. La GraphQL, majoritatea clienților trimit POST request-uri. Dacă vrei caching edge pentru GraphQL, trebuie să implementezi persisted queries sau să instalezi WPGraphQL Smart Cache, care mai adaugă un strat de complexitate și potențiale bug-uri de invalidare când un editor schimbă un preț în admin.

Dacă ai un site simplu de prezentare, REST API extins manual prin register_rest_route sau câmpuri reduse chirurgical câștigă detașat prin simplitatea infrastructurii. Dacă ai relații dense între CPT-uri și WooCommerce, GraphQL merită bătaia de cap cu persisted queries.

Voi ce abordare folosiți în headless: ați mers pe WPGraphQL sau preferați să cosmetizați endpoint-urile REST native?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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