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

Cum expui CPT-uri și ACF în WordPress headless fără să umfli payload-ul

De Mihai Popescu, 21 oct. 2026 · 22 vizualizări · 2 like-uri

Postat 21 oct. 2026
php
add_action('rest_api_init', function () {
    register_rest_field('brand_partner', 'date_curate', [
        'get_callback' => function ($post) {
            $brand_id = $post['id'];
            $logo_id = get_field('brand_logo', $brand_id);
            
            return [
                'website'   => esc_url(get_field('official_site', $brand_id)),
                'is_active' => (bool) get_field('status_parteneriat', $brand_id),
                'logo_url'  => $logo_id ? wp_get_attachment_image_url($logo_id, 'medium') : null,
            ];
        },
        'schema' => [
            'description' => 'Date ACF optimizate pentru frontend',
            'type'        => 'object',
        ],
    ]);
});

Dacă ai legat vreodată un Next.js sau Nuxt la un WordPress headless, știi groaza primului fetch pe un Custom Post Type cu vreo 25 de câmpuri ACF. Primești un JSON de 400KB plin de metadate inutile, chei interne cu underscore și structuri recursive care îți îngroapă lighthouse score-ul.

La un magazin cu vreo 12k de produse și un CPT dedicat pentru „Branduri Partenere” cu landing-uri complexe, payload-ul inițial pe pagina de listare bloca efectiv thread-ul principal pe mobile. Am redus răspunsul de la 1.8MB la sub 90KB doar curățând ce expunem.

REST API nativ: Nu folosi plugin-uri oarbe

Tentanta cea mai mare e să instalezi plugin-ul clasic ACF to REST API și să-ți vezi de treabă. Nu face asta în producție. Plugin-ul aruncă tot ce găsește în baza de date în nodul acf, fără filtrare, fără tipizare și fără să-i pese dacă ai imagini de 4MB sau doar un ID.

Abordarea sănătoasă pe REST implică două decizii:

  1. Înregistrezi CPT-ul cu 'show_in_rest' => true și setezi un rest_base curat.
  2. Folosești register_rest_field() ca să expui doar câmpurile de care are nevoie frontend-ul, mapate manual.

În codul de mai jos mapez doar două proprietăți pentru un brand: un banner formatat direct cu WebP și un boolean simplu, ignorând restul gunoiului din meta-ul postării.

WPGraphQL: Calea elegantă, dar cu costuri

Dacă folosești WPGraphQL împreună cu WPGraphQL for ACF, experiența de dev e mult mai faină. Ai tipizare strictă din start, query-urile cer exact nodurile necesare și scapi de over-fetching fără să scrii controllere custom în PHP.

Trade-off-ul sincer? Performanța pe server. La interogări adânci (de exemplu CPT Brand -> relație cu 50 de produse -> fiecare produs cu variante și recenzii), rezolvarea nodurilor în GraphQL rupe procesorul pe un VPS modest. Cu REST API clasic poți trânti un micro-cache la nivel de Nginx/FastCGI sau Redis mult mai ușor pe rute statice. Cu GraphQL, caching-ul la nivel de query pe POST necesită setup de Persisted Queries sau proxy dedicat (cum e Stellate).

Cum alegi între ele?

Mergi pe REST API dacă:

  • Ai un frontend simplu sau pagini de conținut relativ plate (catalog, articole de blog, landing pages).
  • Vrei să pui Cloudflare în față și să faci edge caching agresiv pe URL-uri.
  • Nu vrei să depinzi de plugin-uri masive în WP care adaugă overhead la fiecare request.

Alege WPGraphQL dacă:

  • Ai relații complexe de tip many-to-many între posturi și taxonomii.
  • Echipa de frontend vrea contracte TypeScript generate automat direct din schemă.
  • Ai timp și infrastructură să configurezi un cache serios pentru query-uri.

Voi cum ați rezolvat caching-ul pe headless când aveți date din CPT-uri care se schimbă des, dar nu vreți să invalidați tot site-ul?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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