Headless WordPress: kako postaviti razdvojenu arhitekturu sa Next.js-om

Headless WordPress: kako postaviti razdvojenu arhitekturu sa Next.js-om

Tradicionalni WordPress u jednom monolitu obavlja i upravljanje sadržajem i prikaz frontenda. U headless arhitekturi WordPress služi samo kao backend CMS, a frontend preuzima Next.js.

C

Can Kaya

Specijalista za bezbednost

21. mart 2026.13 min čitanja0

Tradicionalni WordPress u jednom monolitu obavlja i upravljanje sadržajem i prikaz frontenda. U headless arhitekturi WordPress služi samo kao backend CMS, dok frontend preuzima moderan framework poput Next.js-a. Rezultat: brže učitavanje stranica, bolje iskustvo za programere i neograničena fleksibilnost frontenda. Ovaj vodič vas vodi kroz podešavanje WordPressa kao headless CMS-a, preuzimanje podataka pomoću WPGraphQL-a i izradu Next.js frontenda spremnog za produkciju.

Šta je headless WordPress?

Headless WordPress isključuje sloj teme (frontend) i sadržaj isporučuje isključivo preko REST API-ja ili GraphQL-a. Urednici sadržaja i dalje koriste poznati WordPress administratorski panel, ali stranice koje posetioci vide renderuje zasebna frontend aplikacija, a ne sam WordPress.

Karakteristika Tradicionalni WordPress Headless WordPress
Frontend PHP tema (Blade/Twig) Next.js / Nuxt / Astro
Učitavanje stranice PHP renderovanje pri svakom zahtevu SSG/ISR uz statički sadržaj + CDN
Performanse Zavise od keša Brzo po podrazumevanim podešavanjima
Bezbednost Površina napada kroz teme/dodatke Samo API, minimalna površina napada
Iskustvo za programere PHP + jQuery React/Vue + TypeScript

💡 Savet: Headless WordPress nije pogodan za svaki projekat. Jednostavni blogovi ili korporativni sajtovi odlično rade sa tradicionalnim WordPressom. Headless arhitektura idealna je za projekte sa prilagođenim zahtevima za korisnički interfejs, potrebom za podrškom više platformi (web + mobilne) ili visokim ciljevima performansi.

Sloj podataka pomoću WPGraphQL-a

WordPress dolazi sa ugrađenim REST API-jem, ali je GraphQL efikasniji za razvoj frontenda. Dodatak WPGraphQL izlaže vaše WordPress podatke preko GraphQL endpointa. Jedan upit može da preuzme objave, autore, kategorije i istaknute slike zajedno - za šta su preko REST API-ja potrebna 3-4 odvojena zahteva.

GraphQL upit
query GetPosts {
  posts(first: 10, where: { status: PUBLISH }) {
    nodes {
      id
      title
      slug
      excerpt
      date
      featuredImage {
        node {
          sourceUrl
          altText
        }
      }
      author {
        node {
          name
          avatar { url }
        }
      }
      categories {
        nodes { name slug }
      }
    }
  }
}

Instalacija i konfiguracija WPGraphQL-a

WPGraphQL instalirajte iz WordPress administratorskog panela preko Plugins > Add New. Alternativno, koristite Composer:

terminal
# Install WPGraphQL via Composer
composer require wp-graphql/wp-graphql

# Test the GraphQL endpoint
curl -X POST https://cms.example.com/graphql \
  -H "Content-Type: application/json" \
  -d '{"query": "{ generalSettings { title } }"}'

Nakon instalacije endpoint https://yoursite.com/graphql postaje aktivan. Uključite GraphiQL IDE u WordPress administraciji pod GraphQL > Settings da biste testirali upite u pregledaču. Iz bezbednosnih razloga isključite introspekciju u produkcionim okruženjima.

Podešavanje Next.js frontenda

Next.js je najpopularniji frontend framework za headless WordPress. Uz podršku za SSG (Static Site Generation), ISR (Incremental Static Regeneration) i SSR (Server-Side Rendering) pruža moćnu kombinaciju performansi i SEO-a. Hajde da kreiramo projekat i povežemo ga sa WordPressom.

terminal
# Create a Next.js project
npx create-next-app@latest headless-wp --typescript --app

# Install GraphQL client
npm install graphql-request graphql

Kreirajte klijentski modul za povezivanje sa WordPress GraphQL endpointom:

lib/wordpress.ts
import { GraphQLClient, gql } from 'graphql-request';

const client = new GraphQLClient(
  process.env.WORDPRESS_GRAPHQL_ENDPOINT!
);

export async function getAllPosts() {
  const query = gql`
    query AllPosts {
      posts(first: 20, where: { status: PUBLISH }) {
        nodes {
          slug
          title
          excerpt
          date
          featuredImage {
            node { sourceUrl altText }
          }
        }
      }
    }
  `;
  const data = await client.request(query);
  return data.posts.nodes;
}

export async function getPostBySlug(slug: string) {
  const query = gql`
    query PostBySlug($slug: ID!) {
      post(id: $slug, idType: SLUG) {
        title
        content
        date
        author { node { name } }
        categories { nodes { name slug } }
        seo { title metaDesc }
      }
    }
  `;
  const data = await client.request(query, { slug });
  return data.post;
}

Stranice sa listom i detaljima bloga

Kreirajte stranicu sa listom blogova pomoću Next.js App Routera. Funkcija generateStaticParams tokom build-a preuzima sve slugove objava i generiše statičke stranice:

app/blog/[slug]/page.tsx
import { getAllPosts, getPostBySlug } from '@/lib/wordpress';

export async function generateStaticParams() {
  const posts = await getAllPosts();
  return posts.map((post) => ({ slug: post.slug }));
}

export default async function BlogPost({ params }) {
  const post = await getPostBySlug(params.slug);

  return (
    <article>
      <h1>{post.title}</h1>
      <div dangerouslySetInnerHTML={{ __html: post.content }} />
    </article>
  );
}

Strategija performansi pomoću ISR-a i SSG-a

Najveća prednost headless WordPressa je mogućnost generisanja stranica kao statičkog HTML-a tokom build-a. Međutim, ponovno build-ovanje pri svakoj izmeni sadržaja nije praktično za sajtove koji se često ažuriraju. ISR (Incremental Static Regeneration) rešava taj problem: stranice se isporučuju statički, a u pozadini se regenerišu u zadatim intervalima.

Strategija Kada koristiti Interval osvežavanja
SSG (statički) Stranice koje se retko menjaju (O nama, FAQ) Samo tokom build-a
ISR Objave na blogu, stranice proizvoda revalidate: 60-3600 s
SSR Dinamički sadržaj specifičan za korisnika Pri svakom zahtevu
On-Demand ISR Kada se sadržaj ažurira u WordPressu Trenutno putem webhook okidača

Trenutna ažuriranja pomoću on-demand revalidacije

Kada se objava ažurira u WordPressu, možete poslati webhook Next.js-u da odmah regeneriše odgovarajuću stranicu. Time se uklanja period čekanja kod ISR-a:

app/api/revalidate/route.ts
import { revalidatePath } from 'next/cache';
import { NextRequest, NextResponse } from 'next/server';

export async function POST(request: NextRequest) {
  const secret = request.headers.get('x-revalidate-secret');

  if (secret !== process.env.REVALIDATE_SECRET) {
    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
  }

  const { slug } = await request.json();
  revalidatePath(`/blog/${slug}`);
  revalidatePath('/blog');

  return NextResponse.json({ revalidated: true });
}

💡 Savet: Na strani WordPressa možete koristiti save_post hook da automatski pošaljete POST zahtev na Next.js endpoint za revalidaciju kada se objava sačuva. Dodatak WPGraphQL Smart Cache automatizuje ovaj proces.

Deployment i arhitektura servera

Headless WordPress arhitektura uključuje dve zasebne serverske komponente: WordPress backend (CMS) i Next.js frontend. Možete ih hostovati na istom ili na odvojenim serverima. Pristup sa odvojenim serverima omogućava nezavisno skaliranje i bezbednosnu izolaciju.

WordPress backend

PHP 8.2+, MySQL 8.0, Nginx. WPGraphQL dodatak je aktivan. Odgovara samo na API zahteve, bez renderovanja teme. Dovoljno je 2 vCPU / 4 GB RAM.

Next.js frontend

Node.js 18+, PM2 menadžer procesa. Isporučuje statičke stranice uz ISR. Preporučuje se pokretanje iza CDN-a. Dovoljno je 2 vCPU / 2 GB RAM.

U produkciji preporučujemo pokretanje Next.js aplikacije pomoću PM2. Komande za build i pokretanje:

ecosystem.config.js
module.exports = {
  apps: [{
    name: 'headless-wp',
    script: 'node_modules/.bin/next',
    args: 'start',
    instances: 'max',
    exec_mode: 'cluster',
    env: {
      NODE_ENV: 'production',
      PORT: 3000
    }
  }]
};

Vodič za dimenzionisanje servera

Zahtevi za servere kod headless WordPress projekata zavise od obima saobraćaja i količine sadržaja. Sledeća tabela prikazuje preporučene konfiguracije za različite razmere:

Razmera WordPress backend Next.js frontend Mesečni saobraćaj
Mala 2 vCPU / 2 GB RAM 1 vCPU / 1 GB RAM 50 hiljada prikaza stranica
Srednja 2 vCPU / 4 GB RAM 2 vCPU / 4 GB RAM 500 hiljada prikaza stranica
Velika 4 vCPU / 8 GB RAM 4 vCPU / 8 GB RAM + CDN 2+ miliona prikaza stranica

Hosted Cloud serveri idealni su za headless arhitekturu. NVMe SSD diskovi i trenutno skaliranje resursa obezbeđuju visoke performanse i za WordPress backend i za Next.js frontend. Za podešavanje WordPress staging okruženja pogledajte naš vodič za WordPress staging.

⚠️ Važno: Ako koristite ISR, Next.js server mora imati dozvolu za pisanje na disk. ISR neće raditi na fajl sistemima samo za čitanje (neke kontejnerske platforme). U takvim slučajevima dajte prednost on-demand revalidaciji ili SSR-u.

Često postavljana pitanja

Da li headless WordPress negativno utiče na SEO?

Ne, naprotiv. Uz Next.js SSG/ISR stranice se isporučuju kao statički HTML, što pretraživačima olakšava indeksiranje sadržaja. Core Web Vitals rezultati se znatno poboljšavaju u poređenju sa tradicionalnim WordPressom.

Da li WordPress dodaci rade u headless režimu?

Backend dodaci (SEO, obrasci, e-trgovina) rade, ali dodaci zavisni od frontenda (slajderi, page builderi, dodaci za teme) ne rade. Dodaci poput Yoast SEO integrišu se sa WPGraphQL-om i isporučuju meta podatke preko API-ja.

Da li da koristim REST API ili GraphQL?

GraphQL omogućava preuzimanje više resursa jednim zahtevom i uklanja preuzimanje suvišnih podataka (over-fetching). REST API je ugrađen i dovoljan za jednostavne projekte. Za projekte sa složenim odnosima među podacima dajte prednost WPGraphQL-u.

Može li se WooCommerce koristiti sa headless WordPressom?

Da, prikaz proizvoda, korpa i plaćanje mogu se upravljati sa frontenda pomoću WooCommerce REST API-ja i dodatka WPGraphQL WooCommerce. Međutim, tok naplate (checkout) je složen i zahteva dodatan razvoj.

Koji hosting je potreban za headless WordPress?

Za WordPress backend potreban vam je server sa podrškom za PHP i MySQL, a za Next.js frontend server sa podrškom za Node.js. Obe komponente mogu raditi na istom VPS-u. Preporučuje se najmanje 4 GB RAM-a.

Zaključak

Headless WordPress spaja snagu upravljanja sadržajem sa modernim frontend tehnologijama. WPGraphQL obezbeđuje efikasno preuzimanje podataka, Next.js ISR donosi performanse statičkog sadržaja, a on-demand revalidacija omogućava trenutna ažuriranja. Ova arhitektura je moćno rešenje za projekte koji ciljaju visoke performanse, zahtevaju podršku za više platformi i prilagođen dizajn korisničkog interfejsa.

Moćna infrastruktura za vaš headless WordPress projekat

Pokrenite WordPress backend i Next.js frontend sa visokim performansama na Hosted Cloud NVMe SSD cloud serverima.

Pogledajte pakete cloud servera →

Podelite

C

Can Kaya

Specijalista za bezbednost

Stručnjak za bezbednost sa CISSP sertifikatom, autor sadržaja o sajber bezbednosti, DDoS zaštiti i ojačavanju servera.

Komentari uskoro