Flotiq y Astro
Flotiq es un CMS headless diseñado para varios frontends, como sitios estáticos, aplicaciones móviles y web. Desarrolladores y creadores de contenido gestionan y entregan contenido a través de APIs basadas en REST y GraphQL.
Integración con Astro
Sección titulada «Integración con Astro»Esta guía utilizará la API del CMS headless Flotiq con un proyecto Astro para mostrar contenido en tu sitio web.
Prerrequisitos
Sección titulada «Prerrequisitos»Para comenzar, necesitarás:
- Un proyecto Astro - Puedes crear un nuevo proyecto usando el comando
npm create astro@latest. - Una cuenta de Flotiq - Si no tienes una cuenta, regístrate gratis.
- Clave API de solo lectura de Flotiq - Averigua cómo obtener tu clave.
Configuración de las variables de entorno
Sección titulada «Configuración de las variables de entorno»Agrega la clave API de solo lectura de tu cuenta de Flotiq al archivo .env en la raíz de tu proyecto Astro:
FLOTIQ_API_KEY=__TU_CLAVE_API_DE_FLOTIQ__Definición de un Tipo de Contenido en Flotiq
Sección titulada «Definición de un Tipo de Contenido en Flotiq»Primero, necesitas definir un ejemplo de Definición de Tipo de Contenido en Flotiq para almacenar datos.
Inicia sesión en tu cuenta de Flotiq y crea una Definición de Tipo de Contenido personalizada con la siguiente configuración de ejemplo de Publicación de Blog:
- Etiqueta: Publicación de Blog
- Nombre de API: blogpost
- Campos:
- Título: texto, requerido
- Slug: texto, requerido
- Contenido: texto enriquecido, requerido
Luego, crea uno o más ejemplos de Objetos de Contenido utilizando este tipo Publicación de Blog.
Instalación del SDK de TypeScript de Flotiq
Sección titulada «Instalación del SDK de TypeScript de Flotiq»Para conectar tu proyecto con Flotiq, instala el SDK de Flotiq utilizando el administrador de paquetes de tu elección:
npm install flotiq-api-tspnpm add flotiq-api-tsyarn add flotiq-api-tsA continuación, configura el SDK utilizando tus credenciales. Crea un nuevo archivo llamado flotiq.ts dentro del directorio src/lib de tu proyecto:
import { FlotiqApi } from "flotiq-api-ts";
export const flotiq = new FlotiqApi(import.meta.env.FLOTIQ_API_KEY);Esta configuración ahora se puede utilizar en todo tu proyecto.
Obtención y visualización de datos de Flotiq
Sección titulada «Obtención y visualización de datos de Flotiq»-
Obtén los datos de
Publicación de Blogen una página Astro usando la API personalizada de tu contenidoBlogpostAPI:src/pages/index.astro ---import { flotiq } from "../lib/flotiq";const posts = await flotiq.BlogpostAPI.list();--- -
Muestra el contenido en tu plantilla Astro. Tendrás acceso al
title,slugycontentde tus publicaciones, así como a otros datos de publicacióninternal:src/pages/index.astro ---import { flotiq } from "../lib/flotiq";const posts = await flotiq.BlogpostAPI.list();---<html lang="en"><head><title>Astro</title></head><body>{posts.data?.map((post) => (<section><a href={`/posts/${post.slug}`}><h2>{post.title}</h2></a><div>{post.internal?.createdAt}</div><div set:html={post.content} /></section>))}</body></html>