Umbraco y Astro
Umbraco CMS es un CMS de código abierto basado en ASP.NET Core. Por defecto, Umbraco utiliza páginas Razor para su front-end, pero puede usarse como un CMS headless.
Integración con Astro
Sección titulada «Integración con Astro»En esta sección usarás la API de Entrega de Contenido nativa de Umbraco para proporcionar contenido a tu proyecto Astro.
Prerrequisitos
Sección titulada «Prerrequisitos»Para empezar, necesitarás tener lo siguiente:
- Un proyecto Astro - Si aún no tienes un proyecto Astro, nuestra guía de instalación te ayudará a comenzar en poco tiempo.
- Un proyecto Umbraco (v12+) - Si aún no tienes un proyecto Umbraco, consulta esta guía de instalación.
Configuración de la API de Entrega de Contenido
Sección titulada «Configuración de la API de Entrega de Contenido»Para habilitar la API de Entrega de Contenido, actualiza el archivo appsettings.json de tu proyecto Umbraco:
{ "Umbraco": { "CMS": { "DeliveryApi": { "Enabled": true, "PublicAccess": true } } }}Puedes configurar opciones adicionales según sea necesario, como acceso público, claves API, tipos de contenido permitidos, autorización de membresía y más. Consulta la documentación de la API de Entrega de Contenido de Umbraco para más información.
Obtención de Datos
Sección titulada «Obtención de Datos»Usa una llamada fetch() a la API de Entrega de Contenido para acceder a tu contenido y hacerlo disponible para tus componentes Astro.
El siguiente ejemplo muestra una lista de artículos obtenidos, incluyendo propiedades como la fecha del artículo y el contenido.
---const res = await fetch('http://localhost/umbraco/delivery/api/v2/content?filter=contentType:article');const articles = await res.json();---<h1>Astro + Umbraco 🚀</h1>{ articles.items.map((article: any) => ( <h1>{article.name}</h1> <p>{article.properties.articleDate}</p> <div set:html={article.properties.content?.markup}></div> ))}Creación de un blog con Umbraco y Astro
Sección titulada «Creación de un blog con Umbraco y Astro»Prerrequisitos
Sección titulada «Prerrequisitos»-
Un proyecto Astro - Si aún no tienes un proyecto Astro, nuestra guía de instalación te ayudará a comenzar en poco tiempo.
-
Un proyecto Umbraco (v12+) con la API de Entrega de Contenido habilitada - Sigue esta guía de instalación para crear un nuevo proyecto.
Creación de entradas de blog en Umbraco
Sección titulada «Creación de entradas de blog en Umbraco»Desde el backoffice de Umbraco, crea un Tipo de Documento para un artículo de blog simple llamado ‘Article’.
-
Configura tu Tipo de Documento ‘Article’ con las siguientes propiedades:
- Title (Tipo de Datos: Textstring)
- Article Date (Tipo de Datos: Date Picker)
- Content (Tipo de Datos: Richtext Editor)
-
Activa “Allow as root” a
trueen el tipo de documento ‘Article’. -
Desde la sección “Content” en el backoffice de Umbraco, crea y publica tu primera entrada de blog. Repite el proceso tantas veces como quieras.
Para más información, mira una guía en video sobre cómo crear Tipos de Documento.
Mostrar una lista de entradas de blog en Astro
Sección titulada «Mostrar una lista de entradas de blog en Astro»Crea una carpeta src/layouts/, luego añade un nuevo archivo Layout.astro con el siguiente código:
------<!DOCTYPE html><html lang="es"><head> <meta charset="utf-8"> <title>Mi Blog con Astro y Umbraco</title></head><body> <main> <slot /> </main></body></html>