Flotiq & Astro
Flotiq est un CMS headless conçu pour différents frontends, tels que les sites statiques, les applications mobiles et les applications web. Les développeurs et les créateurs de contenu gèrent et diffusent le contenu par le biais d’API REST et GraphQL.
Intégration avec Astro
Section intitulée « Intégration avec Astro »Ce guide permet d’utiliser l’API CMS headless de Flotiq avec un projet Astro pour afficher du contenu sur votre site web.
Pré-requis
Section intitulée « Pré-requis »Pour commencer, vous aurez besoin de :
- Un projet Astro - Vous pouvez créer un nouveau projet en utilisant la commande
npm create astro@latest. - Un compte Flotiq - Si vous n’avez pas de compte, inscrivez-vous gratuitement.
- Une clé API Flotiq en lecture seule - Découvrez comment obtenir votre clé.
Configuration des variables d’environnement
Section intitulée « Configuration des variables d’environnement »Ajoutez la clé API en lecture seule de votre compte Flotiq au fichier .env à la racine de votre projet Astro :
FLOTIQ_API_KEY=__VOTRE_CLE_API_FLOTIQ__Définir un type de contenu dans Flotiq
Section intitulée « Définir un type de contenu dans Flotiq »Tout d’abord, vous devez définir un exemple de définition de type de contenu dans Flotiq pour stocker des données.
Connectez-vous à votre compte Flotiq et créez une définition de type de contenu personnalisée avec l’exemple de configuration Blog Post suivant :
- Label : Blog Post
- API Name : blogpost
- Fields :
- Title : texte, obligatoire
- Slug : texte, obligatoire
- Content : texte enrichi, obligatoire
Ensuite, créez un ou plusieurs exemples d’objets de contenu en utilisant le type Blog Post.
Installation du SDK TypeScript de Flotiq
Section intitulée « Installation du SDK TypeScript de Flotiq »Pour connecter votre projet à Flotiq, installez le SDK de Flotiq en utilisant le gestionnaire de paquets de votre choix :
npm install flotiq-api-tspnpm add flotiq-api-tsyarn add flotiq-api-tsEnsuite, configurez le SDK en utilisant vos informations d’identification. Créez un nouveau fichier nommé flotiq.ts dans le répertoire src/lib de votre projet :
import { FlotiqApi } from "flotiq-api-ts";
export const flotiq = new FlotiqApi(import.meta.env.FLOTIQ_API_KEY);Cette configuration peut maintenant être utilisée dans l’ensemble de votre projet.
Récupérer et afficher les données de Flotiq
Section intitulée « Récupérer et afficher les données de Flotiq »-
Récupérez les données
Blog Postsur une page Astro en utilisant l’API personnalisée de votre contenuBlogpostAPI:src/pages/index.astro ---import { flotiq } from "../lib/flotiq";const posts = await flotiq.BlogpostAPI.list();--- -
Affichez le contenu dans votre modèle Astro. Vous aurez accès au titre (
title),slug, et contenu (content) de vos articles ainsi qu’à d’autres données internes de l’article :src/pages/index.astro ---import { flotiq } from "../lib/flotiq";const posts = await flotiq.BlogpostAPI.list();---<html lang="fr"><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>