Riqmi CMS

Čo je Riqmi CMS

Riqmi CMS es un sistema de contenido headless integrado. Escribes y gestionas los artículos en Riqmi, y los publicados se sirven a través de una API sencilla que tu sitio web lee. No hay nada que alojar: Riqmi almacena el contenido y lo expone listo para consumir.

Riqmi CMS es una de varias integraciones que conectas en la página Integraciones. Elige Riqmi CMS para que Riqmi aloje y sirva tu blog; elige otra integración (WordPress, Webflow, Wix, Notion o un webhook personalizado) si quieres publicar en un CMS que ya gestionas.

• Elige Riqmi CMS si quieres que Riqmi aloje y sirva el contenido de tu blog y solo necesitas traerlo a tu sitio.
• Conecta otra integración si ya tienes tu propio CMS o creador de sitios y solo quieres que Riqmi publique en él.

Zapnutie

Riqmi CMS se conecta en la página Integraciones, igual que cualquier otra integración. Una vez conectado, aparece una tarjeta de Riqmi CMS donde lo configuras y lo gestionas.

• Abre la página Integraciones.
• Selecciona la tarjeta de Riqmi CMS en la cuadrícula de conexión.
• Aparece la tarjeta de Riqmi CMS: úsala para configurar tu blog y para abrir tu CMS en vivo. Para cambiar más adelante, haz clic en Desconectar en esa tarjeta.

Nastavenie blogu

La tarjeta de Riqmi CMS tiene dos campos. Solo el primero es obligatorio.

• Prefijo de URL del blog: la dirección base donde viven tus artículos en tu sitio, p. ej. https://example.com/blog/. Riqmi le añade el slug de cada artículo para formar la URL pública del artículo.
• URL del webhook de revalidación (opcional): al publicar o despublicar, Riqmi envía una solicitud a esta dirección para que tu sitio actualice sus páginas en caché. Déjalo vacío para desactivarlo; puedes añadirlo más tarde.

Publikovanie článkov

Un artículo solo aparece en tu CMS una vez que lo publicas. Lo controlas en cada artículo:

• Publicar: hacer que el artículo esté disponible a través del CMS por primera vez.
• Volver a publicar: enviar tus últimos cambios al CMS en vivo tras editar un artículo publicado.
• Despublicar: quitar el artículo del CMS pero conservarlo en Riqmi.

Puedes publicar desde varios lugares: el menú de acciones de la lista de artículos, la barra de herramientas al editar un artículo y la barra lateral del artículo.

Estar Publicado en el CMS es independiente del propio estado de flujo de trabajo del artículo. Un artículo puede estar marcado como terminado en tu flujo editorial y seguir siendo un borrador en el CMS hasta que lo publiques, y viceversa. El CMS solo sirve los artículos que has publicado explícitamente.

Čo je naživo

Todo lo que publicas es accesible de inmediato. Desde la tarjeta de Riqmi CMS puedes comprobar exactamente lo que recibirán tus visitantes y tu sitio web.

• Ver CMS en vivo: abre el feed de artículos en bruto que lee tu sitio, para que confirmes que un artículo se está sirviendo.
• sitemap.xml: un mapa del sitio siempre actualizado de tus artículos publicados para los buscadores.
• feed.xml: un feed RSS de tus artículos publicados.

Prepojenie webu

Esta última sección es la integración técnica que trae tus artículos publicados a tu propio sitio web. Si no construyes el sitio tú mismo, pásala a tu desarrollador: el resto de la guía anterior es todo lo que necesitas.

Tu sitio necesita dos valores, que estableces como variables de entorno. La URL base es la dirección de tu despliegue de Riqmi; la clave del sitio es el dominio de tu empresa, en minúsculas y sin www.

• RIQMI_CMS_BASE_URL: la URL de tu despliegue de Riqmi (termina en .convex.site).
• RIQMI_CMS_SITE_KEY: el dominio de tu empresa, p. ej. example.com (en minúsculas, sin www.).

RIQMI_CMS_BASE_URL="https://<your-deployment>.convex.site"
RIQMI_CMS_SITE_KEY="example.com"   # your business domain: lowercase, no www.

Instala el cliente oficial. Es independiente del framework y no tiene dependencias en tiempo de ejecución.

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

Crea el cliente una vez y reutilízalo. createRiqmiCmsClient te ofrece listArticles, getArticle y listTags, además de las URL de sitemap y feed.

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

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

Renderiza tu blog desde el cliente. Esta página de Next.js App Router lista todos los artículos publicados; usa getArticle(slug) para el HTML completo de un solo artículo.

// 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>
  )
}

Para que las publicaciones aparezcan al instante, añade un route handler para el webhook de revalidación y pega su URL en el campo URL del webhook de revalidación. Cada petición lleva una etiqueta de caché, así que un webhook actualiza exactamente lo que cambió. El endpoint no necesita ningún secreto: solo dispara una actualización de caché.

// 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 })
}

El cliente base funciona en cualquier lugar donde se ejecute fetch moderno: Remix, Node puro o entornos edge. Las opciones de caché de Next.js simplemente se ignoran en otros entornos, así que el mismo código es portable.