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

Custom Post Types și ACF în WordPress Headless: Cum să nu-ți dinamitezi payload-ul

De Ioana Marinescu, 7 nov. 2026 · 10 vizualizări · 3 like-uri

Postat 7 nov. 2026
php
add_action('init', function () {
    register_post_type('tech_spec', [
        'labels' => ['name' => 'Specificații Tehnice'],
        'public' => true,
        'has_archive' => false,
        'show_in_rest' => true,
        'rest_base' => 'specs',
        'show_in_graphql' => true,
        'graphql_single_name' => 'techSpec',
        'graphql_plural_name' => 'techSpecs',
        'supports' => ['title', 'slug'],
    ]);

    register_rest_field('tech_spec', 'spec_data', [
        'get_callback' => function ($post) {
            return [
                'pdf_url' => get_field('document_pdf', $post['id']), 
                'weight'  => (float) get_field('weight_kg', $post['id'])
            ];
        },
        'schema' => null,
    ]);
});

Dacă ai încercat vreodată să transformi un WooCommerce sau un catalog custom de WordPress într-un backend headless, știi deja sentimentul. Instalezi ACF Pro, creezi câteva Custom Post Types, bifezi „Show in REST” și primul request către frontend îți întoarce un JSON de 2MB plin de metadata internă, chei de revizii și noduri imbricate aiurea.

Am pățit asta acum vreo doi ani la un catalog B2B cu 14.000 de piese tehnice. Frontend-ul pe Next.js pur și simplu gâfâia la fiecare build de SSG pentru că WP REST API arunca la grămadă zeci de câmpuri de care n-aveam nevoie. Soluția nu e să pui filtre de transformare pe client, ci să cureți contractul direct din WordPress.

WP REST API sau WPGraphQL?

Aici depinde masiv de echipă și de infrastructură. Trade-off-ul e simplu: REST API vine nativ, cache-ul HTTP la nivel de Nginx sau Cloudflare e extrem de ușor de configurat (un simplu stale-while-revalidate), dar plătești prin over-fetching sau endpoint-uri custom create manual.

De cealaltă parte, WPGraphQL (împreună cu WPGraphQL for ACF) e genial pentru dev experience. Cer frontend-iștii exact cele 4 câmpuri din CPT de care au nevoie, payload-ul scade instant de la sute de kilogbyte la câțiva kiloocteți. Dar pierzi cache-ul HTTP simplu out-of-the-box — trebuie să bagi Stellate, să folosești GET queries hash-uite sau să te bazezi pe caching intern de obiecte (Redis/Memcached).

Înregistrarea corectă a CPT-ului

Cea mai mare greșeală pe care o văd în cod este înregistrarea CPT-urilor prin pluginuri generice fără să controlezi namespace-ul GraphQL sau schema REST. Dacă vrei un CPT de genul technical_sheet, definește-l explicit în cod cu setările corecte de schema.

Când folosești register_post_type, pasează show_in_rest => true, dar ai grijă să specifici rest_base curat. Pentru GraphQL, ai nevoie obligatoriu de show_in_graphql => true, graphql_single_name și graphql_plural_name. Fără astea două din urmă, pluginul WPGraphQL pur și simplu îl ignoră.

Cum expui câmpurile ACF fără mizerie

Dacă mergi pe REST, nu lăsa ACF să arunce totul în obiectul acf. Folosește register_rest_field() pentru a expune doar datele sanitizate și pregătite pentru consum direct. Dacă ai un câmp de tip Image, nu trimite array-ul complet cu 15 dimensiuni generate de WP; trimite doar URL-ul WebP, lățimea, înălțimea și alt text-ul.

La proiectul menționat mai devreme, după ce am rescris controllerul REST și am trimis doar DTO-ul minim necesar pentru cardul de produs, timpul de build în Next.js a scăzut cu 45%, iar payload-ul pe listare a coborât de la 4.2MB la vreo 380KB.

Câteva capcane după ce ieși în producție

  1. Relațiile între postări: Evită câmpurile ACF de tip Post Object care returnează obiecte întregi dacă ai mai mult de 2 nivele de adâncime. O să generezi N+1 queries în baza de date până când PHP-ul dă fatal error de memory limit.
  2. Sincronizarea JSON: Ține ACF Local JSON activat în Git (acf-json/). Nu lăsa câmpurile doar în baza de date, altfel devine coșmar sincronizarea pe staging și producție.

Voi ce stack folosiți când decuplați WordPress? Ați rămas pe REST sau ați migrat complet pe WPGraphQL?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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