Skriptēšana veidņu veidotājā

Jūsu skripts                    Dzinējs                         Rezultāts
    |                              |                              |
    v                              v                              v
documents.get("article", "intro") --> Iegūst no datubāzes --> { headline: "Welcome", body: "..." }
         .headline                --> Izgūst lauku         --> "Welcome"

// Piekļuve pašreizējā dokumenta cenas laukam
doc.price

// Kopējās summas aprēķins no pašreizējā dokumenta laukiem
doc.price * doc.quantity

// Nosacījums, kas balstīts uz pašreizējā dokumenta statusu
doc.status == "published" ? doc.title : "Draft: " + doc.title

// Saglabāts CMS kā: article / welcome-post
{
  "headline": "Welcome to Our Platform",
  "author": "Sarah Chen",
  "body": "We're excited to announce...",
  "tags": ["announcement", "news"]
}

documents.get("article", "welcome-post")

documents.get("article", "welcome-post").headline

documents.get("article", "welcome-post").author

documents.get("article", meta.params.slug).headline

// Iegūt visas valstis
documents.find("country")

// Iegūt valstis ar filtru
documents.find("country", { "where": { "code": "us" } })

// Ja meta.locale ir "fr", tiek atgriezts franču tulkojums, apvienots ar pamata dokumentu
documents.get("greeting", "welcome").headline

// Vienmēr iegūt tulkojumu spāņu valodā
documents.translated("greeting", "welcome", "es").headline

// Iegūt tulkojumu, balstoties uz URL parametru
documents.translated("product", meta.params.id, meta.params.lang).description

// Salīdzināt tulkojumus
documents.translated("article", "intro", "en").title + " / " + documents.translated("article", "intro", "fr").title

// Pamata dokuments: greeting / welcome
{ "headline": "Welcome", "subheadline": "Welcome to our platform" }

// Tulkojums (valoda: "fr")
{ "headline": "Bienvenue", "subheadline": "Bienvenue sur notre plateforme" }

// Tulkojums (valoda: "es")
{ "headline": "Bienvenido", "subheadline": "Bienvenido a nuestra plataforma" }

// Ar meta.locale = "fr"
documents.get("greeting", "welcome").headline
// Atgriež: "Bienvenue"

// Skaidri norādīts tulkojums spāņu valodā
documents.translated("greeting", "welcome", "es").headline
// Atgriež: "Bienvenido"

// Rezerves variants, ja tulkojuma nav
documents.translated("greeting", "welcome", meta.params.lang) != null
  ? documents.translated("greeting", "welcome", meta.params.lang).headline
  : documents.get("greeting", "welcome").headline

documents.get("article", "homepage-hero").headline

documents.get("country", meta.params.code).name

meta.locale == "ar-SA" ? "Welcome, everyone" : "Welcome"

documents.get("country", documents.get("article", "us-news").countryCode).name

documents.get("article", meta.params.slug) != null
  ? documents.get("article", meta.params.slug).headline
  : "Article Not Found"

documents.get("article", "intro").author != null
  ? documents.get("article", "intro").author
  : "Unknown Author"

"featured" in documents.get("article", "welcome-post").tags

documents.get("article", "welcome-post").tags[0]

size(documents.get("article", "welcome-post").tags)

{
  "pattern": "/{lang}/landingPage",
  "param_bindings": {
    "lang": "language"
  }
}

documents.get("greeting", meta.params.lang).headline

// Iegūt valsts nosaukumu
documents.get("country", meta.params.country).name

// Iegūt valstij atbilstošu produktu sarakstu
documents.find("product", { "where": { "country": meta.params.country } })

// Parādīt valstij atbilstošu sveicienu lietotāja valodā
documents.get("greeting", meta.params.lang).headline + " from " + documents.get("country", meta.params.country).name

// Iegūt pirmo segmentu (bieži valodas kodu)
meta.segments[0]

// Pārbaudīt ceļa dziļumu
size(meta.segments) > 2 ? "deep" : "shallow"

// Pārbaudīt, vai atrodamies administrēšanas sadaļā
"admin" in meta.segments ? "admin mode" : "public mode"

// Rezerves variants, ja parametrs nav piesaistīts
has(meta.params.lang) ? meta.params.lang : meta.segments[0]

// Pārbaudīt lokāli virziena no labās uz kreiso valodām
meta.locale == "ar-SA" || meta.locale == "he-IL" ? "rtl" : "ltr"

// Iegūt tikai valodas daļu
meta.locale.split("-")[0]  // Nav atbalstīts — tā vietā izmantojiet meta.params.lang

// Piekļūt nosauktam parametram
meta.params.lang           // "ko"
meta.params.country        // "us"
meta.params.slug           // "welcome-post"

// Pārbaudīt, vai parametrs pastāv
has(meta.params.category)  // true/false

// Izmantot dokumenta iegūšanai
documents.get("greeting", meta.params.lang)
documents.ref("airports").get(meta.params.code)

meta.segments[0]           // Pirmais segments
meta.segments[1]           // Otrais segments
size(meta.segments)        // Segmentu skaits
"products" in meta.segments  // Vai ceļā ir "products"?

meta.docId != null ? "editing" : "creating new"
meta.docId != null ? documents.get("article", meta.docId).status : "draft"

"Editing: " + meta.title
meta.title.contains("Draft") ? "work in progress" : "published"

// Tradicionālā pieeja
documents.get("airports", meta.params.code).name

// Izmantojot ref()
documents.ref("airports").get(meta.params.code).name

documents.get("schema", "identifier")       // Iegūt vienu dokumentu
documents.get("schema", "id").fieldName     // Iegūt konkrētu lauku
documents.find("schema")                    // Iegūt visus dokumentus
documents.find("schema", { "where": {...}}) // Filtrēts vaicājums
documents.ref("schema").get(identifier)     // Ķēdē savienota meklēšana
documents.translated("schema", "id", "fr")  // Iegūt ar konkrētu lokāli

meta.locale          // "en-US", "ar-SA" u. c.
meta.params.xyz      // URL parametrs ar nosaukumu "xyz"
meta.segments        // URL ceļš kā masīvs
meta.segments[0]     // Pirmais ceļa segments
meta.docId           // Pašreizējā dokumenta ID (vai null)
meta.title           // Pašreizējā dokumenta virsraksts
doc.fieldName        // Pašreizējā dokumenta lauka vērtība

// Salīdzināšana
==  !=  <  <=  >  >=

// Loģika
&&  ||  !

// Trīskāršais operators
condition ? valueIfTrue : valueIfFalse

// Piederība
"value" in listOrMap

size(list)                    // Elementu skaits
size(string)                  // Virknes garums
"text".startsWith("te")       // true
"text".endsWith("xt")         // true
"text".contains("ex")         // true
has(object.property)          // Pārbaudīt, vai īpašība pastāv
hasProperty(obj, "key")       // Alternatīva objekta atslēgas pārbaudes sintakse

// Nākotnē: ārējo pakalpojumu izsaukšana, izmantojot MCP
mcp.translate(meta.params.text, "en", meta.params.lang)
mcp.analyze(documents.get("article", meta.params.id).body)

// Nākotnē: satura ģenerēšana ar MI
aı.summarize(documents.get("article", meta.params.id).body, 100)
ai.translate(meta.params.text, meta.params.targetLang)
ai.classify(meta.params.input, ["positive", "negative", "neutral"])

// Raksts glabā autora ID; iegūt autora vārdu
documents.get("author", documents.get("article", "intro").authorId).name

// Tradicionālā pieeja
documents.get("country", documents.get("airport", meta.params.code).countryCode).name

// Izmantojot ref()
documents.ref("country").get(documents.get("airport", meta.params.code).countryCode).name

// Lidosta → Valsts → Reģions → Kontinents
documents.get("continent",
  documents.get("region",
    documents.get("country",
      documents.get("airport", meta.params.code).countryCode
    ).regionCode
  ).continentCode
).name

// Iegūt lidostai atbilstošu lokalizētu valsts nosaukumu
documents.translated("country",
  documents.get("airport", meta.params.code).countryCode,
  meta.params.lang
).name

// article / tech-news
{ "title": "Tech Update", "authorId": "author-123", "categoryId": "cat-tech" }

// Atrisināt autora vārdu
documents.get("author", documents.get("article", meta.params.slug).authorId).name

// Atrisināt kategoriju ar rezerves vērtību
documents.get("article", meta.params.slug).categoryId != null
  ? documents.get("category", documents.get("article", meta.params.slug).categoryId).name
  : "Uncategorized"

// Lidosta → Valsts → Valūta
documents.get("currency",
  documents.get("country",
    documents.get("airport", meta.params.code).countryCode
  ).currencyCode
).symbol

// Produkta dokumentā iegūt saistītās kategorijas informāciju
documents.get("category", doc.categoryId).description

// Aprēķināt piegādes izmaksas pēc produkta izcelsmes valsts
documents.get("shipping-rates", doc.originCountry).baseRate * doc.weight

documents.find("article", { "where": { "authorId": documents.get("article", meta.params.slug).authorId } })

documents.get("content-block", "hero-1").sourceType == "article"
  ? documents.get("article", documents.get("content-block", "hero-1").sourceId).headline
  : documents.get("product", documents.get("content-block", "hero-1").sourceId).name

{
  "name": "greeting",
  "fields": [
    { "name": "code", "type": "string", "required": true },
    { "name": "headline", "type": "string", "required": true },
    { "name": "subheadline", "type": "string" },
    { "name": "ctaText", "type": "string" },
    { "name": "ctaUrl", "type": "string" }
  ]
}

{
  "lang": "language"
}

// Virsraksts
documents.get("greeting", meta.params.lang).headline

// Apakšvirsraksts
documents.get("greeting", meta.params.lang).subheadline

// CTA teksts
documents.get("greeting", meta.params.lang).ctaText

// CTA URL
documents.get("greeting", meta.params.lang).ctaUrl

// app/[...slug]/page.tsx
import ParametricRoutePage from 'cms-renderer/lib/renderer';
import { registry } from '@/lib/registry';
import { cmsConfig } from '@/lib/cms-config';

export const dynamic = 'force-static';

interface PageProps {
  params: Promise<{ slug: string[] }>;
}

export default async function Page({ params }: PageProps) {
  const { slug } = await params;

  return (
    <ParametricRoutePage
      registry={registry}
      apiKey={cmsConfig.apiKey}
      websiteId={cmsConfig.websiteId}
      cmsUrl={cmsConfig.cmsUrl}
      params={Promise.resolve({ slug })}
    />
  );
}

interface CelMeta {
  /** Pašreizējais lokāles kods (piemēram, 'en-US') */
  locale: string;
  /** No URL izvilktie maršruta parametri */
  params: Record<string, string>;
  /** URL ceļa segmenti */
  segments: string[];
  /** Pašreizējā dokumenta ID (ja tiek rediģēts esošs dokuments) */
  docId: string | null;
  /** Pašreizējā dokumenta virsraksts */
  title: string;
}

Shēma: /{country}/{lang}/products
Ceļš:  /us/en/products

Algoritms:
1. Normalizēt abus ceļus (noņemt beigu slīpsvītras)
2. Sadalīt segmentos: ["us", "en", "products"] un ["{country}", "{lang}", "products"]
3. Salīdzināt segmentu skaitu (tam jābūt vienādam)
4. Katram segmentu pārim:
   - Ja shēma sākas ar : vai {}, izvilkt parametru
   - Pretējā gadījumā segmentiem precīzi jāsakrīt
5. Atgriezt: { country: "us", lang: "en" }

// Vienkārša piesaiste (meklēšanai izmanto lauku "code")
{ "lang": "language" }

// Detalizēta piesaiste (pielāgots slug lauks)
{
  "lang": {
    "schemaName": "language",
    "slugField": "code"
  },
  "slug": {
    "schemaName": "article",
    "slugField": "slug"
  }
}