
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.
Can Kaya
Specijalista za bezbednost
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.
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:
# 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.
# 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:
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:
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:
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:
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 →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