1.1.4 Desarrollar un bloque personalizado básico
1.1.4.1 Configure su entorno de desarrollo local
Vaya a https://desktop.github.com/download/, descargue e instale Github Desktop.
Una vez instalado Github Desktop, vaya al repositorio de GitHub que creó en el ejercicio anterior. Haga clic en <> código y, a continuación, haga clic en Abrir con GitHub Desktop.
El repositorio de GitHub se abrirá en GitHub Desktop. No dude en cambiar la Ruta local. Haga clic en Clonar.
A continuación, se creará una carpeta local.
Abra Código de Visual Studio. Vaya a Archivo > Abrir carpeta.
Seleccione la carpeta que usa la configuración de GitHub para citisignal.
Ahora verá esa carpeta abierta en Visual Studio Code y ya estará listo para crear un nuevo bloque.
1.1.4.2 Crear un bloque personalizado básico
Adobe recomienda desarrollar bloques en un enfoque de tres fases:
- Cree la definición y el modelo para el bloque, revíselo y llevelo a producción.
- Cree contenido con el nuevo bloque.
- Implemente la decoración y los estilos para el nuevo bloque.
component-definition.json
En Visual Studio Code, abra el archivo component-definition.json.
Desplácese hacia abajo hasta que vea el componente Cita. Coloque el cursor junto al corchete de cierre del último componente.
Pegue este código e introduzca una coma , después del bloque de código:
{
"title": "FiberOffer",
"id": "fiberoffer",
"plugins": {
"xwalk": {
"page": {
"resourceType": "core/franklin/components/block/v1/block",
"template": {
"name": "FiberOffer",
"model": "fiberoffer",
"offerText": "<p>Fiber will soon be available in your region!</p>",
"offerCallToAction": "Get your offer now!",
"offerImage": ""
}
}
}
}
}
Guarde los cambios.
component-models.json
En Visual Studio Code, abra el archivo component-models.json.
Desplácese hacia abajo hasta que vea el último elemento. Coloque el cursor junto al corchete de cierre del último componente.
Escriba una coma , y, a continuación, presione Intro y, en la línea siguiente, pegue este código:
{
"id": "fiberoffer",
"fields": [
{
"component": "richtext",
"name": "offerText",
"value": "",
"label": "Offer Text",
"valueType": "string"
},
{
"component": "richtext",
"valueType": "string",
"name": "offerCallToAction",
"label": "Offer CTA",
"value": ""
},
{
"component": "reference",
"valueType": "string",
"name": "offerImage",
"label": "Offer Image",
"multi": false
}
]
}
Guarde los cambios.
component-filters.json
En Visual Studio Code, abra el archivo component-filters.json.
En la sección, escriba una coma , y el identificador de su componente fiberoffer después de la última línea actual.
Guarde los cambios.
1.1.4.3: confirmar los cambios
Ahora ha realizado varios cambios en el proyecto que deben volver a enviarse al repositorio de GitHub. Para ello, abra GitHub Desktop.
Entonces debería ver los 3 archivos que acaba de editar en Cambios. Revise los cambios.
Escriba un nombre para su PR, Fiber Offer custom block. Haga clic en Compromiso con main.
Entonces debería ver esto. Haga clic en Origen push.
Después de un par de segundos, los cambios se han insertado en el repositorio de GitHub.
En el navegador, vaya a su cuenta de GitHub y al repositorio que ha creado para CitiSignal. Debería ver algo similar a esto, que muestre que se han recibido los cambios.
1.1.4.4 Agregar el bloque a una página
Ahora que el bloque de presupuesto básico está definido y comprometido con el proyecto CitiSignal, puede agregar un bloque fiberoffer a una página existente.
Vaya a https://my.cloudmanager.adobe.com. Haga clic en Programa para abrirlo.
A continuación, haga clic en los 3 puntos … en la ficha Entornos y haga clic en Ver detalles.
A continuación, verá los detalles del entorno. Haga clic en la dirección URL del entorno Author.
Luego debería ver el entorno de AEM Author. Ir a Sitios.
Vaya a CitiSignal > us > en.
Haga clic en Crear y seleccione Página.
Seleccione Página y haga clic en Siguiente.
Introduzca los siguientes valores:
- Título: CitiSignal Fiber
- Nombre: citisignal-fiber
- Título de página: CitiSignal Fiber
Haga clic en Crear.
Entonces debería ver esto.
Haga clic en el área en blanco para seleccionar el componente section. A continuación, haga clic en el icono más + en el menú derecho.
Debería ver el bloque personalizado en la lista de bloques disponibles. Haga clic en para seleccionarlo.
Verá campos como Texto de oferta, CTA de oferta e Imagen de oferta que se agregan al editor. Haga clic en + Agregar en el campo Imagen de la oferta para seleccionar una imagen.
Entonces debería ver esto. Haga clic para abrir la carpeta citisignal.
Seleccione la imagen product-enrichment-1.png. Haga clic en Seleccionar.
Entonces deberías tener esto. Haga clic en Publicar.
Vuelva a hacer clic en Publicar.
Se ha publicado su nueva página.
1.1.4.5 Agregar su nueva página al menú de navegación
En la descripción general de AEM Sites, ve a CitiSignal > Fragmentos y marca la casilla de verificación de Encabezado. Haga clic en Edit.
Agregue una opción de menú al menú de navegación con el texto Fiber. Seleccione el texto Fibra y haga clic en el icono vínculo.
Escriba esto para la URL /us/en/citisignal-fiber y haga clic en el icono V para confirmar.
Entonces deberías tener esto. Haga clic en Publicar.
Vuelva a hacer clic en Publicar.
Ahora podrá ver los cambios en su sitio web yendo a main--citisignal--XXX.aem.page/us/en/ y/o main--citisignal--XXX.aem.live/us/en/, después de reemplazar XXX por su cuenta de usuario de GitHub, que en este ejemplo es woutervangeluwe.
En este ejemplo, la dirección URL completa se convierte en lo siguiente:https://main--citisignal--woutervangeluwe.aem.page/us/en/ o https://main--citisignal--woutervangeluwe.aem.live/us/en/.
Entonces debería ver esto. Haga clic en Fibra.
Este es el bloque personalizado básico, pero que ahora se representa en el sitio web.
Paso siguiente: 1.1.5 Bloque personalizado avanzado
Volver a Adobe Experience Manager Cloud Service & Edge Delivery Services