Hygraph y Astro
Hygraph es una plataforma federada de gestión de contenido. Expone un endpoint de GraphQL para obtener contenido.
Integración con Astro
Sección titulada «Integración con Astro»En esta sección, crearás un endpoint de GraphQL de Hygraph para obtener contenido con Astro.
Prerrequisitos
Sección titulada «Prerrequisitos»Para comenzar, necesitarás tener lo siguiente:
-
Una cuenta y proyecto de Hygraph. Si no tienes una cuenta, puedes registrarte gratis y crear un proyecto nuevo.
-
Permisos de acceso de Hygraph - en
Project Settings > API Access, configura los permisos de Public Content API para permitir solicitudes de lectura sin autenticación. Si no has configurado ningún permiso, puedes hacer clic en Yes, initialize defaults para añadir los permisos requeridos para usar la “High Performance Content API”.
Configurar el endpoint
Sección titulada «Configurar el endpoint»Para añadir tu endpoint de Hygraph a Astro, crea un archivo .env en la raíz de tu proyecto con la siguiente variable:
HYGRAPH_ENDPOINT=YOUR_HIGH_PERFORMANCE_APIAhora deberías poder utilizar esta variable de entorno en tu proyecto.
Si quieres tener IntelliSense para tus variables de entorno, puedes crear un archivo env.d.ts en tu directorio src/ y configurar ImportMetaEnv de la siguiente manera:
interface ImportMetaEnv { readonly HYGRAPH_ENDPOINT: string;}Lee más sobre el uso de las variables de entorno y archivos .env en Astro.
Tu directorio raíz deberá incluir ahora los siguientes archivos:
Directoriosrc/
- env.d.ts
- .env
- astro.config.mjs
- package.json
Obteniendo contenido
Sección titulada «Obteniendo contenido»Obtén datos de tu proyecto de Hygraph utilizando HYGRAPH_ENDPOINT.
Por ejemplo, para obtener entradas de un tipo de contenido blogPosts que contenga un campo de tipo string title, crea una consulta de GraphQL para obtener ese contenido. Después, define el tipo del contenido y establécelo como el tipo de la respuesta.
---interface Post { title: string;}
const query = { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ query: ` { blogPosts { title } }`, }),};
const response = await fetch(import.meta.env.HYGRAPH_ENDPOINT, query);const json = await response.json();const posts: Post[] = json.data.blogPosts;---
<html lang="en"> <head> <meta charset="utf-8" /> <link rel="icon" type="image/svg+xml" href="/favicon.svg" /> <meta name="viewport" content="width=device-width" /> <meta name="generator" content={Astro.generator} /> <title>Astro</title> </head> <body> <h1>Astro</h1> { posts.map((post) => ( <div> <h2>{post.title}</h2> </div> )) } </body></html>Despliegue
Sección titulada «Despliegue»Configuración de un Webhook en Netlify
Sección titulada «Configuración de un Webhook en Netlify»Para configurar un webhook en Netlify:
-
Despliega tu sitio en Netlify con esta guía. Recuerda agregar tu
HYGRAPH_ENDPOINTa las variables de entorno. -
A continuación, ve al panel de tu proyecto de Hygraph y haz clic en Apps.
-
Ve al marketplace, busca Netlify y sigue las instrucciones proporcionadas.
-
Si todo ha salido bien, ahora podrás desplegar tu sitio web con un solo clic desde la interfaz de Hygraph.
Recursos de la Comunidad
Sección titulada «Recursos de la Comunidad»Más guías de CMS
Socios de CMS destacados
-
CloudCannon
Git-based CMS built for speed, security, and zero headaches.