Sari la conținut

Primii pași

De la un proiect gol la conținut publicat și analiză live pe site-ul tău.

DocumentațiePrimii pași

Meniul documentațieiPrimii pași

Manifolio ține într-un singur loc conținutul unui site și cifrele lui live. Pagina asta te duce de la un proiect gol la conținut publicat pe site, cu analiza pornită.

1. Modelezi conținutul

În admin, la app.manifolio.com, deschizi proiectul și mergi la Structure. Adaugi un tip și îi alegi câmpurile. O colecție ține mai multe intrări (articole, produse, evenimente); un singleton ține una singură (setările site-ului, pagina de start).

Marchezi câmpurile obligatorii și pe cele care se schimbă de la o limbă la alta. Pagina Modelul de conținut le descrie pe toate.

2. Scrii și publici

Deschizi tipul, adaugi o intrare și apeși Publish. Doar conținutul publicat ajunge în Delivery API. Ciornele rămân în admin și în Preview API, așa că editorii lucrează liniștiți, fără să atingă site-ul live.

3. Creezi o cheie

În Developers → API keys creezi o cheie secretă. Cheile de producție încep cu mf_live_, cele de dezvoltare cu mf_test_. Cheia întreagă se arată o singură dată: o copiezi în mediul serverului. Id-ul proiectului e la Connection, pe aceeași pagină.

Shell
# .env
MANIFOLIO_PROJECT=01a1b2c3-0000-7000-8000-000000000000
MANIFOLIO_KEY=mf_live_cheia_ta_secreta

Cheile secrete rămân pe server. Conținutul se citește la build, într-o componentă de server sau într-o rută API, niciodată în browser.

4. Citești conținutul

Shell
npm i @manifolio/sdk
TypeScript
import { createClient } from "@manifolio/sdk";

const cms = createClient({
  project: process.env.MANIFOLIO_PROJECT!,
  key: process.env.MANIFOLIO_KEY!,
  locale: "ro",
});

const articole = await cms.entries("article", { sort: "-published", limit: 10 });
const setari = await cms.singleton("site_settings");

Fără SDK, e o singură cerere HTTP:

Shell
curl -H "Authorization: Bearer $MANIFOLIO_KEY" \
  "https://api.manifolio.com/delivery/v1/$MANIFOLIO_PROJECT/entries/article?limit=10"

5. Pornești analiza

Creezi o cheie publicabilă (mf_pk_live_) și treci domeniile site-ului. Apoi adaugi un singur rând în fiecare pagină:

HTML
<script defer src="https://api.manifolio.com/t.js" data-key="mf_pk_live_cheia_site_ului"></script>

Vizitele, sursele și Web Vitals apar în panou în câteva minute. Scriptul nu pune cookie-uri, iar Manifolio nu păstrează adrese IP. Evenimentele proprii sunt descrise la Analiză.

Mai departe

  • Delivery API: toate căile, filtrele și parametrii
  • SDK: citiri tipizate, previzualizare și tipuri generate
  • Webhook-uri: reconstruiești sau reîmprospătezi site-ul la fiecare publicare