Payload CMS: CMS koji živi u vašem kodu
Većina CMS proizvoda traži da se tim prilagodi njihovom modelu podataka. Payload traži da ga napišete. Ta jedna odluka objašnjava i zašto ga developeri vole i zašto nije pravi odgovor za svakog klijenta.
Ukratko
- Payload je CMS pisan za TypeScript, pod MIT licencom, koji konfigurišete u kodu i hostujete sami.
- Šema je fajl — kolekcije, polja, pravila pristupa i hook‑ovi su deo vašeg repozitorijuma.
- REST i GraphQL se generišu automatski, plus Local API koji preskače HTTP.
- Sa Astro‑om je podela čista: Payload servira sadržaj, Astro pre‑renderuje stranice u vreme build‑a.
- Plaćate operacijama: Node servis, baza i neko ko brine o oboma.
Šta je Payload u praksi
Payload je headless CMS napisan u TypeScript‑u. Instalirate ga kao zavisnost, opišete sadržaj u payload.config.ts i dobijete tri stvari odjednom: admin panel, REST/GraphQL API i generisane TypeScript tipove.
// payload.config.ts
import { buildConfig } from 'payload'
import { postgresAdapter } from '@payloadcms/db-postgres'
export default buildConfig({
collections: [
{
slug: 'posts',
fields: [
{ name: 'title', type: 'text', required: true },
{ name: 'slug', type: 'text', required: true, unique: true },
{ name: 'body', type: 'richText' },
],
},
],
db: postgresAdapter({ pool: { connectionString: process.env.DATABASE_URL } }),
})
Taj fajl je proizvod. Polja se mogu ugnježđivati, grupisati u blokove, prevoditi, validirati i štititi funkcijama pristupa koje dobijaju trenutnog korisnika. Ništa u modelu sadržaja nije skriveno u interfejsu koji zna da vozi samo jedna osoba.
Kome leži
- Produktnim timovima koji već rade u TypeScript‑u i žele sadržaj i kod u istom repozitorijumu, pregledane u istom pull request‑u.
- Projektima sa stvarnim pravilima pristupa — urednici koji vide samo svoj jezik, klijenti koji vide samo svoje zapise.
- Timovima kojima trebaju custom endpoint‑i pored API‑ja sadržaja, jer CMS radi u istom procesu kao i njihov backend kod.
- Agencijama koje predaju kod, a ne SaaS pretplatu.
Manje leži kada niko u timu ne želi da održava server ili kada sadržajni tim mora da objavi za dva dana, a šema se još projektuje.
Kako se povezuje sa Astro‑om
Integracija je namerno dosadna, i to je poenta. Payload izlaže /api/<kolekcija>; Astro ga dohvata u vreme build‑a.
// src/lib/payload.ts
const CMS = import.meta.env.PAYLOAD_URL
export async function getPosts() {
const res = await fetch(`${CMS}/api/posts?limit=100&depth=1`)
if (!res.ok) throw new Error(`Payload: ${res.status}`)
return (await res.json()).docs
}
Zatim običan Astro route od toga pravi stranice:
export async function getStaticPaths() {
const posts = await getPosts()
return posts.map((post) => ({ params: { slug: post.slug }, props: { post } }))
}
Dva detalja čine ovo prijatnim u praksi:
- Tipovi dolaze iz CMS‑a. Pokrenite
payload generate:typesi importujtePostizpayload-types.ts. Polje preimenovano u konfiguraciji oborićeastro checkpre nego što obori sajt. - Nacrti idu drugim putem. Za pregled dodajte route na zahtev koji traži verziju nacrta sa autentifikovanim tokenom; sve javno ostaje statično.
Rich text se čuva kao strukturisan dokument, a ne kao sirov HTML, pa ga mapirate na svoje komponente umesto da verujete markup‑u koji je editor proizveo. Više posla na početku i znatno bolji rezultat posle redizajna.
Šta urednici dobijaju
Admin je običan React, ne page builder: lista kolekcija levo, polja desno, panel pregleda ako ga povežete. Urednik koji je radio u WordPress‑u prepoznaće ritam za deset minuta. Ono što neće dobiti je sloboda drag‑and‑drop rasporeda — šema odlučuje šta stranica može da bude, i upravo zato front‑end ostaje predvidiv.
Prednosti
- Vlasništvo. MIT licenca, vaša baza, vaš server, vaš repozitorijum.
- Jedan jezik. Konfiguracija, hook‑ovi, kontrola pristupa i front‑end su TypeScript.
- Tipovi koji prežive refaktorisanje. Generisani tipovi prate šemu.
- Local API. Server‑side kod može direktno u bazu — bez HTTP skoka.
- Prave uredničke funkcije. Nacrti, verzije, live preview, lokalizacija, upload sa promenom veličine slika.
Nedostaci
- Vi ga vozite. Deploy, backup, nadogradnje baze i monitoring su vaši.
- Payload 3 dovlači Next.js. Admin je Next.js aplikacija, pa statični Astro sajt sada ima Node servis pored sebe.
- Manji ekosistem plugin‑ova od WordPress‑a ili Strapi‑ja; integracije koje trebaju, pisaćete sami.
- Promena šeme je promena koda. Odlično za pregled, sporije za marketara kome polje treba sada.
Napomena na tu poslednju stavku: to je osobina, ne greška, ali menja ko može brzo. Ako sadržajni tim isporučuje dnevne eksperimente, možda mu bolje služi model vođen interfejsom.
Kada izabrati Payload
Izaberite ga kada je CMS deo proizvoda, a ne odvojen alat: kada su vam potrebna custom pravila pristupa, poslovna logika blizu sadržaja ili model koji nijedan gotov šablon ne pokriva. Izaberite ga kada tim mirno održava Node servis i radije debaguje svoj kod nego tuđu crnu kutiju.
Preskočite kada je sajt brošura sa tri urednika i bez backend potreba — Keystatic će vas odvesti tamo za jedno popodne, a Sanity će vas poštedeti servera u potpunosti.
Zaključak
Payload je opcija koju biramo kada klijent želi CMS koji poseduje, na jeziku koji njegovi developeri već govore. Nije najjeftiniji za održavanje ni najbrži za početak; jeste onaj koji ostaje razumljiv i posle tri godine.
Dalje: pogledajte kako stoji prema ostalima u poređenju headless CMS‑ova za Astro, pročitajte Sanity vodič kao hostovanu alternativu ili počnite od headless CMS hub‑a. Ako želite da ovo bude napravljeno i uredno predato, to radimo u okviru izrade sajtova.
Snimci ekrana u ovoj seriji su plan; zamenićemo ih sopstvenim, snimljenim na stvarnim projektima.
Jurij Osipov
Osnivač, SEO i analitika
Vodi Take the Space. Specijalizovan za tehnički SEO, merljivu analitiku i vidljivost u AI pretraživanju.