Construyendo un blog con Gastby y Strapi, parte 1 - Configurando Strapi
Este artÃculo es la parte 1 de la guÃa "Construyendo un blog con Gatsby y Strapi" en esta parte nos enfocaremos en configurar Strapi par que podamos consumir la data tal cual como una API, si quieres mirar los artÃculos anteriores o siguientes:
- Construyendo un blog con Gastby y Strapi, parte 0
- Construyendo un blog con Gastby y Strapi, parte 2 - Configurando Gatsby
- Construyendo un blog con Gastby y Strapi, parte 3 - Desplegando Strapi en Heroku
- Construyendo un blog con Gastby y Strapi, parte 4 - Desplegando Gatsby en Netlify
- Construyendo un blog con Gastby y Strapi, parte 5 - Integrando Gatsby, Strapi y Cloudinary en producción
Crear un nuevo proyecto con Strapi
yarn create strapi-app my-project --quickstart
Con este simple comando podremos crear un proyecto, puedes cambiar el parámetro my-project para personalizar el nombre de tu proyecto. Demorará un par de minutos y luego se levantará una ventana en la que podrás acceder al panel de administración.
Crear un usuario administrador
Ve a la url del panel http://localhost:1337/admin
- Completa el formulario
- El nombre será el usuario que usarás para ingresar al panel de administración
- Listo!
Al ingresar puedes cambiar el idioma del panel en la esquina superior derecha, click -> ES. Aunque la interfaz es bastante intuitiva como lo descubrirás.
Crear el primer tipo de contenido, en nuestro caso son artÃculos
En la sección de PLUGINS navegamos hasta el "Constructor de Tipos de Contenido"
- Click en "Agregar tipo de contenido"
- Escribir "artÃculo", si en singular, y luego "listo"
- Se abrirá otra modal con opciones de campos
- Elegimos un campo de tipo String o Cadena de texto
- Le damos el nombre de "tÃtulo"
- En esa misma modal en la pestaña de Opciones Avanzadas
- Marcar las casilla de Campo requerido y Campo único, listo
- Luego click en la opción de "Agregar un nuevo campo"
- Tipo Rich text o Texto enriquecido
- En el nombre "descripción"
- De nuevo en la pestaña de Opciones Avanzadas, marcalo como requerido
- Y listo, guardar tipo de contenido
Si analizas los que acabamos de hacer es crear una tabla en la base de datos que almacene los artÃculos, y cada articulo tiene un tÃtulo y una descripción.
Configurar roles y permisos
En la sección de PLUGINS navegamos hasta "Roles y Permisos"
- Click en el rol Público
- Buscar los permisos para el tipo de contenido "artÃculos"
- Marcar find y findone
Ahora le damos permisos públicos para que los usuarios puedan buscar todos los artÃculos o uno en especÃfico
Listo ahora tienes una API
Si visitamos la URL http://localhost:1337/articulos podrás ver un JSON vació porque aún no agregamos ningún artÃculo
Agregando el primer artÃculo
En la sección TIPOS DE CONTENIDOS o CONTENT TYPE:
- Click en ArtÃculos
- Click en "Agregar nuevo artÃculo"
- Llenamos los campos, tÃtulo y descripción
- Guardar y listo
Si vuelves a consultar la url http://localhost:1337/articulos podrás ver el articulo que acabas de escribir.
Si quieres indagar un poco más en configuraciones y opciones que tienes disponibles para contolar con Strapi no te pierdas su documentación.
Ahora ya tenemos listo el gestor de contenidos y la api para nuestro blog, ahora nos falta poder leer esos endpoint y allà es donde entra en juego Gatsby
Continua con: Construyendo un blog con Gastby y Strapi, parte 2 - Configurando Gatsby