Riqmi CMS

Čo je Riqmi CMS

Riqmi CMS je zabudovaný headless systém na správu obsahu. Články píšete a spravujete v Riqmi a publikované články sa sprístupnia cez jednoduché API, z ktorého ich číta váš web. Nič nemusíte hostovať — obsah ukladá Riqmi a poskytuje ho pripravený na použitie.

Riqmi CMS je jedna z viacerých integrácií, ktoré pripojíte na stránke Integrácie. Zvoľte Riqmi CMS, ak chcete, aby Riqmi hostovalo a poskytovalo váš blog; zvoľte inú integráciu (WordPress, Webflow, Wix, Notion alebo vlastný webhook), ak chcete publikovať do CMS, ktorý už prevádzkujete.

• Zvoľte Riqmi CMS, ak chcete, aby Riqmi hostovalo a poskytovalo obsah vášho blogu a vy ho len načítate na svoj web.
• Pripojte inú integráciu, ak už máte vlastné CMS alebo nástroj na tvorbu webu a chcete, aby doň Riqmi len publikovalo.

Zapnutie

Riqmi CMS pripojíte na stránke Integrácie, rovnako ako ktorúkoľvek inú integráciu. Po pripojení sa zobrazí karta Riqmi CMS, kde ho nastavíte a spravujete.

• Otvorte stránku Integrácie.
• Vyberte kartu Riqmi CMS v mriežke na pripojenie.
• Zobrazí sa karta Riqmi CMS — použite ju na nastavenie blogu a na otvorenie živého CMS. Ak ho neskôr chcete vymeniť, kliknite na karte na Odpojiť.

Nastavenie blogu

Karta Riqmi CMS má dve polia. Povinné je len prvé.

• Predpona URL blogu — základná adresa, kde sa na vašom webe nachádzajú články, napr. https://example.com/blog/. Riqmi k nej pridá slug článku a vytvorí verejnú URL článku.
• URL revalidačného webhooku (voliteľné) — pri publikovaní alebo zrušení publikovania pošle Riqmi požiadavku na túto adresu, aby váš web obnovil stránky uložené v cache. Ponechajte prázdne na vypnutie; pridať môžete aj neskôr.

Publikovanie článkov

Článok sa v CMS objaví až po publikovaní. Ovládate to pri každom článku samostatne:

• Publikovať — prvýkrát sprístupniť článok cez CMS.
• Znovu publikovať — po úprave publikovaného článku odoslať najnovšie zmeny do živého CMS.
• Zrušiť publikovanie — odstrániť článok z CMS, no ponechať ho v Riqmi.

Publikovať môžete z viacerých miest: z ponuky akcií v zozname článkov, z panela nástrojov pri úprave článku a z bočného panela článku.

Stav Publikované v CMS je oddelený od vlastného stavu článku v pracovnom postupe. Článok môže byť v redakčnom postupe označený ako hotový, no v CMS stále zostáva konceptom, kým ho nepublikujete — a naopak. CMS poskytuje len články, ktoré ste výslovne publikovali.

Čo je naživo

Všetko, čo publikujete, je okamžite dostupné. Z karty Riqmi CMS si môžete overiť presne to, čo dostanú vaši návštevníci a váš web.

• Zobraziť živé CMS — otvorí surový zdroj článkov, ktorý číta váš web, takže si overíte, že sa článok poskytuje.
• sitemap.xml — vždy aktuálna mapa stránok s vašimi publikovanými článkami pre vyhľadávače.
• feed.xml — RSS kanál vašich publikovaných článkov.

Prepojenie webu

Táto posledná časť je technické prepojenie, ktoré načíta vaše publikované články na váš web. Ak web nestaviate sami, odovzdajte ju vývojárovi — zvyšok návodu vyššie vám stačí.

Váš web potrebuje jednu hodnotu, ktorú nastavíte ako premennú prostredia: site ID, jedinečný identifikátor vášho webu, zobrazený na karte integrácie Riqmi CMS.

• RIQMI_CMS_SITE_ID — jedinečné ID vášho webu, skopírované z karty integrácie Riqmi CMS.

RIQMI_CMS_SITE_ID="<your-site-id>"   # copy it from the Riqmi CMS integration card

Nainštalujte oficiálneho klienta. Je nezávislý od frameworku a nemá žiadne runtime závislosti.

pnpm add @riqmi/cms-client
# or: npm i @riqmi/cms-client / yarn add @riqmi/cms-client

Klienta vytvorte raz a opakovane používajte. createRiqmiCmsClient vám poskytne listArticles, getArticle a listTags, plus URL pre sitemap a feed.

// lib/cms.ts
import { createRiqmiCmsClient } from '@riqmi/cms-client'

export const cms = createRiqmiCmsClient({
  siteId: process.env.RIQMI_CMS_SITE_ID ?? '',
  // applied to every request; per-call options override it
  defaultRequestInit: { next: { revalidate: 300 } }
})

Vykreslite blog z klienta. Táto stránka pre Next.js App Router vypíše všetky publikované články; pre celé HTML jedného článku použite getArticle(slug).

// app/blog/page.tsx
import Link from 'next/link'
import { cms } from '@/lib/cms'

export default async function BlogPage() {
  const { items: articles } = await cms.listArticles()

  return (
    <main>
      {articles.map((article) => (
        <article key={article.id}>
          <Link href={`/blog/${article.slug}`}>{article.title}</Link>
          {article.excerpt ? <p>{article.excerpt}</p> : null}
        </article>
      ))}
    </main>
  )
}

Aby sa publikovanie prejavilo okamžite, pridajte route handler pre revalidačný webhook a jeho URL vložte do poľa URL revalidačného webhooku. Každé načítanie má cache tag, takže jeden webhook obnoví presne to, čo sa zmenilo. Endpoint nepotrebuje žiadne tajomstvo — iba spustí obnovu cache.

// app/api/riqmi/revalidate/route.ts
import { revalidateTag } from 'next/cache'
import { parseRiqmiWebhook, riqmiTagsForPayload } from '@riqmi/cms-client'

export async function POST(request: Request) {
  const payload = await parseRiqmiWebhook(request)
  if (!payload) return new Response('Invalid payload', { status: 400 })

  for (const tag of riqmiTagsForPayload(payload)) revalidateTag(tag)
  return Response.json({ revalidated: true })
}

Základný klient funguje všade, kde beží moderný fetch — Remix, čistý Node či edge prostredia. Možnosti cachovania pre Next.js sa inde jednoducho ignorujú, takže rovnaký kód je prenositeľný.