# Modyo Platform
Modyo Platform es la base tecnológica sobre la cual operan las aplicaciones de Modyo como Channels, Content y Customers. En ella, encontramos todo lo necesario para poder realizar las configuraciones más relevantes.
A continuación, exploraremos las secciones y temas transversales más relevantes de la plataforma.
# ¡Empieza! 🚀
Para usuarios nuevos en Modyo Platform, te sugerimos seguir este flujo de trabajo inicial:
- Configuración inicial: Revisa las configuraciones generales de la cuenta
- Gestión de usuarios: Configura roles y permisos para tu equipo
- Seguridad: Implementa las políticas de seguridad recomendadas
- Integraciones: Conecta tus sistemas externos si es necesario
Modyo ofrece a todos sus usuarios administradores una sección de aprendizaje llamada ¡Empieza!, a la que accedes desde el ícono de cohete de la barra lateral principal. La página tiene dos bloques:
- Rutas de aprendizaje: Tarjetas con los cursos de formación de Modyo. Cada tarjeta abre su curso en una pestaña nueva.
- Sigue aprendiendo sobre Modyo: Accesos a Explora la comunidad, Revisa la documentación y Webinars más recientes.
En la cabecera, el enlace ¿Qué hay de nuevo? abre el roadmap de Modyo con las funcionalidades lanzadas.
La sección ¡Empieza! es un excelente punto de partida para nuevos usuarios que se están sumando a la organización.
Activación opcional
Puedes ocultar la sección ¡Empieza! con la opción No mostrar la página de "Primeros Pasos" de Visualización, en la configuración general de la cuenta. Al activarla, el ícono desaparece de la barra lateral para todos los usuarios y la pantalla que se abre por defecto al iniciar sesión pasa a ser Inicio.
# Sobre la Interfaz
La interfaz de administración de Modyo proporciona un entorno unificado de gestión que centraliza todas las funcionalidades de la plataforma a través de una arquitectura modular y cohesionada. El diseño de la interfaz sigue principios de usabilidad empresarial, implementando patrones de navegación consistentes, jerarquías visuales claras y elementos de UI estandarizados que facilitan la adopción por parte de equipos multidisciplinarios. La arquitectura responsive garantiza accesibilidad completa desde diferentes dispositivos, mientras que la organización modular permite a los usuarios acceder de forma eficiente a las funcionalidades de Content Management, Site Builder, Widgets, Customer Insights y configuraciones del sistema desde una consola central.
El sistema de gestión de accesos y permisos implementa un modelo de seguridad basado en roles (RBAC) que permite un control granular sobre recursos y funcionalidades. Los administradores pueden configurar permisos a nivel de organización, espacios de trabajo, sitios y contenidos específicos, estableciendo workflows de aprobación personalizables y políticas de governance centralizadas. Esta arquitectura de seguridad integrada elimina la necesidad de gestionar múltiples sistemas de autenticación y autorización, proporcionando trazabilidad completa de accesos y acciones realizadas en la plataforma.
La experiencia de usuario está optimizada para la productividad operativa, incorporando funcionalidades como dashboards configurables con métricas en tiempo real, herramientas de búsqueda contextual con filtros avanzados, operaciones batch para gestión masiva de contenidos, y navegación adaptativa que presenta opciones relevantes según el contexto y permisos del usuario. La interfaz abstrae la complejidad técnica de la plataforma mientras expone capacidades avanzadas de configuración, permitiendo que tanto usuarios de negocio como desarrolladores puedan aprovechar completamente las capacidades de la plataforma digital.
# Marcadores
Los marcadores te permiten crear accesos directos a las secciones de la plataforma que más utilizas. Son personales: cada administrador gestiona sus propios marcadores.
Para crear un marcador, haz clic en el ícono de marcador con el tooltip Añadir Marcador que aparece junto a los ítems de los menús laterales del panel: las secciones de configuración de la cuenta, los módulos y las secciones internas de un sitio, un espacio de contenido o un reino. El ícono se rellena para indicar que la sección quedó marcada; haz clic nuevamente para quitar el marcador.
Los ítems que solo despliegan un submenú y no llevan a una sección propia no muestran el ícono, por lo que no se pueden marcar.
Para usar tus marcadores, haz clic en el ícono Marcadores en la parte superior de la barra lateral principal. Se abre la ventana Mis Marcadores con tus accesos guardados, ordenados con los más utilizados primero. Haz clic en un marcador para navegar a esa sección, o usa el ícono de papelera para eliminarlo.
Si todavía no tienes marcadores guardados, la ventana muestra un estado vacío que te indica cómo agregar el primero. Si la sección de un marcador ya no está disponible, Modyo muestra un aviso y no te lleva a ella; puedes eliminar el marcador desde la misma ventana.
Tip
Marcar dos veces la misma sección no crea duplicados: si el marcador ya existe, se conserva el original.
# Versionado
Como mecanismo de respaldo, al momento de publicar un elemento, Modyo genera y mantiene automáticamente un número de versiones que posteriormente pueden ser recuperadas en caso de ser necesario. Este sistema está disponible para Widgets, Pages, Navigation, Plantillas y Espacios.
# Tipos de versión
| Versión | Descripción |
|---|---|
| Editable | La versión Editable conserva los cambios realizados en el elemento desde su última publicación o desde su creación si nunca ha sido publicado. Esta versión es la que pasa por el proceso de revisión en equipo cuando está activado. En el momento de la publicación, las versiones "Editable" y "Publicada" contienen el mismo contenido. |
| Publicado | Esta versión guarda el contenido visible en el sitio y está disponible para todos los usuarios. En este estado, los recursos internos como Widgets y Plantillas ya pueden utilizarse en la creación de cualquier sitio o página. La versión publicada no necesariamente tiene el mismo contenido que la versión editable, excepto en el momento exacto de la publicación, ya que puede contener cambios que aún estén en proceso de prueba o revisión. |
| Respaldos | Los respaldos son versiones previamente publicadas de los elementos. Cada vez que se publica un elemento, Modyo guarda la versión previamente publicada como un respaldo. |
| Programado | Cuando programas una publicación, la versión editable pasa a un estado programado. Cuando llega el momento de la publicación, esa versión programada toma el lugar de la versión que está publicada en ese momento. De esta forma, puedes programar un cambio en el futuro en los elementos, y seguir trabajando en la versión editable. Modyo solo permite tener una versión programada de cada elemento. Si programas una segunda modificación al elemento, sobreescribes la programación anterior. Además de la programación de la publicación, también puedes programar la despublicación. Llegado el momento, la versión que está publicada pasará a ser un respaldo, dejando el elemento en cuestión sin una versión publicada. Cuando se ejecutan las acciones programadas, Modyo puede tardar unos minutos en completarlas. Modyo te enviará una notificación por correo electrónico cuando la acción se haya completado. La página home y las plantillas que no se pueden eliminar no pueden ser despublicadas. Si se programa una despublicación en conjunto con otros elementos, no tendrá efecto sobre la página home. |
| Aprobado | Este estado aparece cuando se habilita la revisión en equipo y significa que un elemento en este estado está listo para ser publicado. Cualquier cambio que se le haga a un elemento en este estado, llevará al elemento a un estado editable y deberá pasar nuevamente por el proceso de revisión para poder ser publicado. |
Si deseas revisar una versión específica de un elemento, puedes acceder a las "Diferencias entre versiones" para ver los cambios realizados y revertirlos si es necesario.
Versiones
Por defecto, Modyo conserva hasta 20 respaldos de cada elemento, además de la versión publicada. Cuando un elemento ya tiene 20 respaldos, cada nueva publicación borra el más antiguo: por ejemplo, al hacer la publicación número 22 se borra el respaldo de la primera publicación del elemento.
Este límite se define para toda la instalación de Modyo y aplica a todas sus cuentas.
# Revertir un Cambio
Dentro del versionado hay dos acciones que te permiten interactuar con los respaldos: resetear y rollback. Por defecto, el modal de diferencias muestra la versión publicada a la izquierda, y la versión editable a la derecha. Puedes cambiar qué versiones comparar, cambiando los valores en los selectores de versiones en la parte superior del modal.
Sigue estos pasos para revertir a una versión publicada en una Entrada:
- Desde Modyo Platform, expande Content y selecciona Espacios.
- Selecciona tu Espacio y después haz click en la Entrada que quieres versionar.
- Haz click en Diferencias.
- En el modal que aparece, selecciona la versión que quieras hacer rollback y después haz click en Rollback a esta versión.
Cuando se aplica alguna de las acciones, siempre se toma la versión seleccionada a la izquierda, de tal forma que si se resetea, se llevará la versión de la izquierda a la versión editable, y si se hace rollback, se llevará la versión de la izquierda a la versión publicada.
Módulos con soporte
El versionado se puede realizar en los siguientes módulos:
- En Content: las Entradas.
- En Channels: las Páginas, Navigation, Plantillas, y Widgets.
# Resetear
El reset es una forma para restaurar el área de trabajo. La acción de Reset toma la versión seleccionada en el panel izquierdo y la copia sobre la Versión Editable. Resultado: Se descartan todos los cambios actuales en los que estés trabajando y tu área de trabajo se sincroniza con la versión de referencia. Uso: Ideal cuando deseas "limpiar" tu borrador y comenzar de nuevo basándote en un estado anterior.
# Rollback
El rollback sirve para restaurar la versión publicada. La acción de Rollback toma la versión seleccionada en el panel izquierdo y la envía directamente a la Versión Publicada, sin modificar tu área de trabajo actual. Resultado: El contenido que ven los usuarios finales cambia instantáneamente. Tu versión editable permanece intacta, permitiéndote seguir trabajando en ella sin interrupciones. Uso: Ideal para correcciones de emergencia en el sitio en vivo sin perder el progreso de tus ediciones actuales.
| Acción | ¿Qué se sobreescribe? | Impacto en el sitio publicado | Caso de uso |
|---|---|---|---|
| Reset | La Versión Editable | Ninguno | Solo afecta tu área de trabajo |
| Rollback | La Versión Publicada | Inmediato | El sitio web se actualiza |
Permisos
- Para resetear, basta con el permiso de edición del elemento, por ejemplo Editar Páginas o Editar Entradas.
- Para hacer rollback, en Channels necesitas el permiso de edición o de revisión del tipo de elemento (Editar Páginas o Revisar Páginas, Editar Menús o Revisar Menús, Editar Widgets o Revisar Widgets, Editar Plantillas o Revisar Plantillas). En Content necesitas Revisar Entradas.
- En la pantalla de Revisión y publicación conjunta de una aplicación web, el rollback solo está disponible con Administrar Sincronizaciones o Gestionar Canales.
- En los snippets globales, resetear y hacer rollback requieren Administrar Snippets Globales o Gestionar Canales.
# Locks
Locks es una funcionalidad de Modyo que permite modificar un recurso de manera segura, evitando problemas de concurrencia que puedan ocurrir cuando otro usuario esté trabajando en él simultáneamente. De esta forma Modyo evita la pérdida de trabajo o la sobreescritura de documentos.
Locks se usa principalmente en Content y en Channels, pero también puede ser usado en otras secciones donde se editan elementos como Configuraciones y Customers. La implementación varía según la sección: en Content y Channels, múltiples usuarios pueden entrar a un recurso, siendo sólo uno el que podrá editar y guardar esos cambios, mientras que los demás sólo verán la última versión guardada en la plataforma. Si una segunda persona intenta hacer un cambio, le aparecerá un mensaje indicando que el elemento ya tiene cambios y que lo que está intentando modificar está obsoleto.
En otras secciones como Customers y Configuración, Locks no permitirá la visión simultánea del recurso, por lo que si éste se encuentra en edición, otro usuario no podrá ingresar a la vista de trabajo. En este caso, sólo un Administrador podrá tomar el control, activando para sí mismo la edición y descartándose los avances no guardados del usuario que se encuentra trabajando en él.
Tomar el control
Si un Administrador quiere tomar el control de una vista, deberá hacer click en el elemento en uso y en la pantalla siguiente, hacer click en el botón Tomar Control.
Cuando el Administrador toma el control, el usuario que esté usando el recurso recibe un mensaje en el que se le impide seguir haciendo cambios, por lo que cualquier cambio que el usuario esté realizando, debe ser guardado y respaldado offline.
Tras tomar el control, el Administrador solo tendrá dos horas para hacer cambios sin guardar. Pasado ese tiempo, el recurso vuelve a liberarse y puede ser tomado por cualquier otro usuario.
# Modos de Vista Previa
Los modos de vista previa te permiten previsualizar los cambios realizados a elementos publicables como entradas, páginas, navegación, widgets o plantillas. El acceso a este modo está en la parte superior derecha del sitio. Puedes reconocer que estás en modo vista previa, cuando veas la barra en la parte superior del sitio.
La barra de vista previa contiene los siguientes elementos interactivos:
- Selector de plantillas: Permite cambiar entre la versión publicada y editable de los elementos pertenecientes al template builder.
- Snippets globales: Permite cambiar entre la versión publicada y editable de los snippets globales de la cuenta.
- Selector de contenido: Permite alternar entre la versión publicada y editable de los elementos pertenecientes a la aplicación de contenidos y que se estén usando en el sitio mediante el SDK de Liquid de contenido.
- Selector de navegación: Permite cambiar entre la versión publicada y editable de los elementos pertenecientes al navigation builder.
- Selector de páginas: Permite alternar entre la versión publicada y editable de los elementos pertenecientes al page builder.
- Mostrar: Si en la ruta que previsualizas hay una página de widgets y una página de contenido, permite elegir cuál mostrar (Página de Widget o Página de contenido). Si la página de contenido coincidente tiene el index deshabilitado, en su lugar aparece un ícono de advertencia con el mensaje "Existe una página de contenido coincidente, pero el index está deshabilitado".
- Selector de widgets: Si se están previsualizando páginas que contienen widgets personalizados, se mostrará una lista de los widgets presentes en la página, permitiendo seleccionar si se desea visualizar la versión editable o publicada de cada uno de ellos. Una vez realizada la selección, debes hacer click en el botón "refrescar" para que la configuración de los widgets surta efecto.
- Originación: En páginas de originación, permite cambiar entre la versión publicada y editable de la originación.
- Layout: Al previsualizar un widget, permite elegir el layout del sitio con el que se muestra.
- Ingresa y Cerrar sesión: Al previsualizar un widget en un sitio con reino, permiten iniciar o cerrar sesión como usuario final para probar el widget con o sin sesión.
- Pestaña para minimizar: Permite ocultar la barra de previsualización para evitar interferencias con los elementos ubicados en la parte superior del sitio. Una vez minimizada, la pestaña seguirá visible para restaurar la barra en el modo vista previa.
- Editar elemento: Al hacer click, se accedes a la vista de edición del elemento que se está visualizando, ya sea una entrada, una página, un widget o una plantilla predeterminada del sitio.
- Editar respuesta: Si la página de originación que previsualizas corresponde a una respuesta, abre esa respuesta en el administrador.
- Compartir link: Permite copiar un enlace que se puede compartir con otros usuarios. Al abrir el enlace, se accede directamente al modo vista previa con la configuración que se tenía al momento de copiar el enlace. Para acceder al modo vista previa, es necesario tener una sesión iniciada en la cuenta de administradora.
- Salir del modo vista previa: Cierra el modo vista previa, eliminando la barra y manteniendo la pestaña en la URL actual del sitio.
SDK de contenido
El selector SDK de contenido afecta al contenido que se usa a través del SDK de Liquid y también a la API pública de contenido: con el selector en Editable, las llamadas que la página abierta en vista previa hace a la API de contenido reciben las versiones editables de las entradas.
Esto sólo ocurre en las peticiones que hace esa misma página. Una petición hecha directamente a la API desde otra pestaña, un usuario final anónimo o cualquier consumo desde un servidor siempre recibe contenido publicado. Revisa Vista previa para el detalle.
# Revisión en Equipo
La Revisión en Equipo (o Team Review) es una herramienta que permite controlar el proceso de publicación de contenidos en Modyo. Al activarla, cada elemento debe pasar por etapas de revisión antes de su publicación, añadiendo un nivel de supervisión y colaboración entre el editor de contenidos y un equipo de revisores. Esta herramienta se configura de forma individual para cada Sitio y Espacio.
Cuando un editor o desarrollador considera que el elemento en el que está trabajando está listo, puede enviarlo a revisión. Esta tarea puede ser realizada por usuarios habilitados por defecto o por un equipo seleccionado por el editor. Estos revisores son los responsables de aprobar o rechazar el elemento, determinando si está listo para su publicación. Cada paso de este proceso lleva al elemento a través de distintos estados, que quedan registrados en un historial para su posterior auditoría.
# Configuración
Para activar la revisión de equipo, sigue estos pasos:
- Desde el menú lateral en Modyo Platform, selecciona un espacio o sitio.
- Expande Configuración del espacio/sitio y selecciona Revisión en Equipo.
- Haz click en Habilita la revisión en equipo.
Las opciones disponibles son:
- Habilitar revisión en equipo: Activa o desactiva por completo la revisión en equipo en este contexto (sitio o espacio).
- Número de aprobaciones: Determina la cantidad de usuarios que deben aprobar el elemento para que esté listo para su publicación. Cuando se alcanza el número requerido de aprobaciones, el estado del elemento cambiará de En revisión a Aprobado.
- Restringir la selección de revisores: Por defecto, cualquier usuario con los permisos necesarios puede aprobar elementos en espera de revisión. Sin embargo, al habilitar esta opción, solo los revisores seleccionados por el editor podrán llevar a cabo la aprobación.
- Forzar revisión: Esta opción te permite seleccionar una lista de usuarios, de los cuales se requiere al menos una aprobación para que el elemento pueda cambiar a estado Aprobado. Esto es independiente del número de aprobaciones configurado anteriormente. Incluso si un elemento tiene la cantidad de aprobaciones necesarias, permanecerá en estado En revisión si ningún usuario de la lista lo ha aprobado.
- Requerir todos: Esta opción extiende la restricción anterior a todos los usuarios seleccionados. En este caso, se requerirá la aprobación de todos los usuarios de la lista para que el elemento pueda cambiar a estado Aprobado.
Atención
- Si bien la aprobación se podría encontrar limitada, cualquier usuario con permisos puede hacer comentarios sobre el elemento.
- Al activar o desactivar la revisión en equipo, los elementos que estaban En revisión o Aprobado vuelven a Borrador.
- Los cambios en Número de aprobaciones, Restringir la selección de revisores y Requerir todos se aplican también a los elementos que ya están En revisión.
- Los usuarios de Forzar revisión se asignan al elemento cuando se envía a revisión. Para que un elemento que ya está En revisión tome los cambios en esa opción, es necesario rechazarlo y enviarlo a revisión nuevamente.
# Proceso de Revisión
Cuando se activa la opción de revisión en equipo y se guardan los cambios, se muestra el botón verde principal Enviar a revisión. Al enviar a revisión, la barra cambia de estado para indicar si faltan condiciones o si no se tiene permiso suficiente. Al hacer click, en la sección lateral derecha se indicarán los requerimientos para publicar el elemento.
Si se requiere la revisión de algún revisor, aparecerá (requerido) junto a su nombre en el listado de revisores. A la derecha de cada revisor está el estado de su revisión: se muestra un círculo amarillo si no ha hecho su revisión, y un check verde en caso de haber aprobado el elemento. Todos los usuarios que tienen acceso a la vista de edición del elemento verán un botón Aprobar debajo del listado de revisores, aunque solo aquellos con los permisos necesarios podrán hacer click para aprobar el elemento.
Al aprobar el elemento, la aprobación del usuario queda registrada y se muestra un check verde junto a su nombre en el listado de revisores. En la barra de acciones del elemento, a la izquierda del botón principal de color verde y a la derecha del botón de diferencias, puedes encontrar la opción para abrir la pestaña de actividad del elemento, donde se muestra una lista cronológica de las acciones realizadas con la opción de ver los detalles de cada acción y dejar comentarios. Cuando se deja un comentario o se ejecuta alguna acción sobre el elemento, se envía una notificación tanto a quien envió a revisión como a los usuarios que están en la lista de revisores.