Primeros pasos

Abra /webadmin e inicie sesión con una cuenta de administrador activa.

• super_admin puede acceder a las áreas de nivel de instalación y de nivel de sitio
• site_admin y editor solo pueden acceder a las áreas de administración limitadas a los sitios que tienen asignados

Si su instalación utiliza más de un sitio, empiece por confirmar en qué sitio está trabajando.

• Los usuarios super_admin pueden gestionar los sitios en la sección System
• Los usuarios site_admin y editor trabajan únicamente dentro de los sitios que tienen asignados

Antes de publicar una página de contacto pública, configure la identidad del sitio, el dominio y el destinatario de Contact. El destinatario de Contact a nivel de sitio en Site -> Edit -> Contact es preferible a depender únicamente de .env, porque viaja con la configuración del sitio.

Las notificaciones del Contact Form utilizan la entrega de correo de Laravel. Los ajustes típicos de .env son:

MAIL_* controla el transporte SMTP. MAIL_FROM_ADDRESS es la dirección de remitente segura y el destinatario de reserva final. CONTACT_RECIPIENT_EMAIL es opcional; úselo como reserva a nivel de entorno, no como sustituto del destinatario de Contact del sitio cuando el ajuste del sitio esté disponible.

Si los ajustes de correo de .env se modifican después de que la configuración se haya almacenado en caché, ejecute:

El orden de resolución del destinatario es:

1. recipient_email del bloque Contact Form
2. Destinatario de contacto predeterminado del sitio en Site -> Edit -> Contact
3. CONTACT_RECIPIENT_EMAIL de .env
4. Reserva segura MAIL_FROM_ADDRESS

Ejecute una comprobación de diagnóstico segura para los secretos antes de confiar en las notificaciones:

Utilice php artisan contact:mail-diagnose --block=ID cuando necesite inspeccionar la cadena de reserva de un bloque Contact Form concreto.

Abra Pages en la barra lateral de administración y cree una página.

Las páginas nuevas empiezan como draft, lo que significa:

• la página todavía no es pública
• los editores pueden seguir editándola libremente
• la página puede enviarse a revisión cuando esté lista

Utilice el constructor de páginas para añadir o editar bloques en el layout de la página.

A grandes rasgos, puede:

• elegir la estructura de la página mediante layouts y slots
• añadir bloques de contenido a la página
• adjuntar medios donde esté admitido
• construir o editar la navegación del sitio desde el área Navigation

Los medios y la navegación se gestionan de forma separada del editor de páginas, pero funcionan de forma conjunta con el contenido de la página.

Cuando utilice Gallery, trátelo como un bloque de colección de medios y no como un bloque de introducción de sección.

• utilice Content Header más Plain Text o Rich Text antes de Gallery cuando necesite un encabezado o un texto explicativo
• Gallery ya no renderiza su propio encabezado ni párrafo de introducción públicos
• los antiguos campos Gallery Title y Description ya no son campos normales del editor de Gallery
• los elementos de la galería se gestionan como filas de lista compactas con controles de reordenación y de edición por elemento, en lugar de la antigua cuadrícula de recursos seleccionados
• la selección de medios, el orden y la presentación de la galería se mantienen compartidos entre idiomas (locales)
• el texto alternativo, el pie de foto, el título de superposición y el texto de superposición de cada elemento pertenecen a cada idioma (locale)

Para encabezados públicos reutilizables, el patrón recomendado es:

• construya el menú en Admin -> Navigation
• cree o edite un Shared Slot Header para el sitio
• añada Navbar a ese Shared Slot
• añada bloques hijos dentro de él, como Container, Cluster, Navbar Brand, Navbar Navigation y Header Actions
• elija el menú de navegación en el bloque hijo Navbar Navigation en lugar de introducir los enlaces manualmente

Navbar renderiza únicamente nav.wb-navbar y sus bloques hijos. No añade automáticamente un Container, un contenedor de marca, un contenedor de menú ni un área de acciones generada. Cuando se necesite un ancho restringido, coloque un bloque Container dentro del Navbar.

Container es ante todo una primitiva de ancho. Los contenedores heredados siguen renderizando un flujo apilado de forma predeterminada, pero para la composición del navbar establezca Flow de Container en None para que renderice únicamente div.wb-container, y coloque después Cluster dentro de él para la composición horizontal.

Cluster es la primitiva de layout horizontal o agrupado. Utilice sus ajustes para controlar Width, Justify, Align, Wrap y Gap sin CSS personalizado.

Navbar Brand y Navbar Navigation deben estar dentro del árbol del Navbar, pero no necesitan ser hijos directos de Navbar. Un patrón recomendado es Navbar -> Container (Flow: None) -> Cluster (Width: Full, Justify: Between, Align: Center, Wrap: Nowrap), y colocar después Navbar Brand más un Cluster (Justify: End, Align: Center, Wrap: Nowrap) interno que contenga Navbar Navigation y Header Actions.

Cuando un bloque Navbar Navigation tiene elementos visibles, el CMS renderiza ahora automáticamente un conmutador de menú hamburguesa para móvil. En móvil, los enlaces de escritorio en línea se pliegan tras ese conmutador, la marca permanece visible, las acciones de encabezado siguen disponibles y el menú abierto se renderiza debajo de la fila mediante el comportamiento de desplegable existente de WebBlocks UI.

Navbar Brand admite el uso solo con logotipo cuando hay una imagen de logotipo presente. En ese caso, el texto de título visible es opcional y la etiqueta accesible recurre a la etiqueta de marca configurada o al nombre del sitio resuelto.

Position es el único ajuste integrado del Navbar: static, sticky o fixed. Las variantes visuales y el estilo del navbar corresponden al uso de clases de WebBlocks UI, no a ajustes del CMS específicos del bloque Navbar.

En el editor de slots:

• el selector de bloques se abre de forma predeterminada en una pestaña Common curada, cada pestaña o resultado de búsqueda se mantiene en el orden Name A-Z, el encabezado del modal muestra cuántos tipos de bloque se están listando actualmente y los conjuntos de resultados largos se desplazan dentro del modal sin ocultar la barra de herramientas de búsqueda
• el asa de arrastre utiliza un marcador de agarre alternativo sencillo para que las filas ordenables sigan siendo utilizables aunque una entrada de la fuente de iconos no esté disponible
• Delete All Blocks aparece únicamente cuando el slot de página o el Shared Slot actual ya contiene bloques, y el modal de confirmación muestra cuántos bloques de nivel superior y anidados se eliminarán

Cuando llega a una página desde una lista Pages filtrada, la administración conserva ahora ese contexto de la lista Pages mientras usted recorre Edit Page, la edición de slots, la edición de traducciones y los flujos de guardado, de modo que al volver a Pages encuentra los mismos filtros y el mismo orden.

Las páginas pasan por estos estados:

• draft
• in_review
• published
• archived

Flujo típico:

1. cree la página en draft
2. edite la página y sus bloques
3. envíela a revisión
4. publíquela cuando esté aprobada

Los editores pueden preparar contenido y enviarlo a revisión. Para publicar se requiere un site_admin o un super_admin.

Solo las páginas published son públicas.

• las páginas draft, in_review y archived devuelven 404 en las rutas públicas
• una página publicada sigue respetando las reglas de visibilidad a nivel de bloque dentro de la página

Después de publicar, abra la página a través de su ruta pública o utilice el enlace de vista previa/apertura de la administración para esa página.

En instalaciones multisitio, las URL públicas siguen el contexto de sitio e idioma (locale) resuelto.

Utilice el bloque nativo contact_form para las páginas de contacto. No utilice Trusted HTML, marcado <form> en bruto ni enlaces mailto: como vía de envío habitual. El renderizador del CMS crea el campo oculto de comprobación antispam; los editores y las herramientas de IA/operador no deben crear ese campo manualmente, y el antiguo campo website ya no es el contrato público.

Prueba de humo antes de anunciar la página:

1. Previsualice o publique una página con contact_form.
2. Envíe un nombre, correo electrónico, asunto y mensaje de prueba.
3. Abra /webadmin/contact-messages.
4. Confirme que el mensaje se ha almacenado.
5. Compruebe el estado de la notificación y los detalles seguros del fallo si la entrega no se realizó.

Los envíos reales aceptados se almacenan antes de intentar la notificación. Un fallo de notificación no significa que el envío del visitante haya fallado, y los visitantes públicos no deben ver diagnósticos de correo.

• Usuarios y roles: docs/users-and-permissions.md
• Formularios de contacto y mensajes: docs/contact-forms-and-messages.md
• Flujo de trabajo y aprobaciones: docs/editorial-workflow.md
• Recuperación de revisiones: docs/revisions.md
• Copias de seguridad, actualizaciones, exportación/importación: docs/operations.md