Documentación sobre los componentes del horario

MX Timetable gestiona eventos semanales recurrentes y los muestra en un horario interactivo. Los administradores pueden organizar los eventos en horarios, configurar el aspecto de cada uno de ellos y crear elementos de menú de Joomla para el horario, un evento concreto o un formulario de evento.

Instalar o actualizar

1. En el panel de administración de Joomla, abre Sistema → Instalar → Extensiones.
2. Sube el paquete de instalación del componente (com_mxtimetable.zip) y completa el proceso de instalación.
3. Al actualizar, instala el nuevo paquete sobre el componente existente. Haz una copia de seguridad del sitio antes de las actualizaciones como medida de precaución general de mantenimiento de Joomla.
4. Abre Componentes → Calendario para gestionar los calendarios y los eventos.

Configurar un horario

1. Ve a Componentes → Timetable → Horarios y crea un horario. Asígnale un nombre y publícalo.
2. Configura las opciones de visualización específicas del horario que se describen a continuación, o déjalas en Usar la configuración del componente para heredar los valores predeterminados globales.
3. Ve a Componentes → Timetable → Eventos del horario y crea un evento.
4. Introduce un título, elige el horario, selecciona un día de la semana y establece las horas de inicio y fin. Utiliza el formato de 24 horas (por ejemplo, 08:30). La hora de finalización debe ser posterior a la hora de inicio.
5. Añade cualquier información opcional sobre el evento, publícalo y guárdalo.
6. Repite el proceso para los demás eventos del horario semanal.

Los eventos sin horario asignado solo aparecen en la vista «Todos los horarios». Una opción del menú correspondiente a un horario muestra los eventos asignados a ese horario.

Campos del evento

• Título: Nombre del evento. Los eventos con el mismo título se agrupan mediante el filtro de título del horario; los eventos publicados con el mismo título también se muestran como eventos relacionados en las páginas de cada uno de ellos.
• Horario: el horario al que pertenece este evento.
• Día y hora: Día de la semana y horas de inicio y fin en formato de 24 horas. Los eventos se repiten semanalmente; este componente no asigna fechas del calendario.
• Color del evento: Elige «Automático» (basado en el día), uno de los colores predefinidos o un «Color personalizado». El color personalizado también te permite elegir el color del texto del evento.
• Ubicación: Nombre de la ubicación (opcional).
• Latitud y longitud: coordenadas decimales opcionales. Introduce ambas coordenadas válidas para colocar un marcador en el mapa de OpenStreetMap integrado en el elemento cuando el mapa esté habilitado.
• Foto de la ubicación: Imagen opcional de la ubicación.
• Formador y foto del formador: Nombre e imagen opcionales del formador. La configuración de visibilidad de la foto es independiente de si se muestra o no el nombre del formador.
• Precio: Importe opcional no negativo. El símbolo de la moneda se configura en los ajustes de visualización.
• Descripción: Detalles en formato de texto enriquecido opcionales que se muestran al abrir los detalles de un evento.
• Publicado: Solo los eventos publicados aparecen en el horario público y en los eventos relacionados.

Crear páginas de interfaz

En Menús, crea una entrada de menú y selecciona el tipo de componente MX Timetable:

• El Horario semanal muestra los eventos de todos los horarios o de un horario seleccionado.
• Elemento único muestra un solo evento. Selecciona el evento en la configuración requerida del elemento de menú.
• ItemForm proporciona un formulario de la interfaz de usuario para añadir o editar un evento. Establece su ID de elemento tal y como se indica en la configuración del elemento de menú; utiliza 0 para acceder al formulario de alta.

El formulario de la interfaz de usuario incluye los mismos detalles del evento que el formulario de administrador. Los permisos de los componentes de Joomla controlan quién puede crear, editar, publicar o eliminar eventos. Concede únicamente los permisos adecuados para tu sitio y prueba la entrada de menú mientras estás conectado como el usuario previsto.

Los títulos de los eventos en el calendario pueden enlazar con sus páginas de elemento cuando está activada la opción Enlazar títulos de eventos con páginas de elemento. Las páginas de elemento también ofrecen navegación «Anterior/Siguiente» cuando existen eventos publicados adyacentes en el calendario semanal. Los usuarios con permisos suficientes pueden ver controles de edición, registro o eliminación en las páginas de elemento.

Configuración de visualización

Los valores predeterminados globales se encuentran en Componentes → Calendario → Opciones. Los registros del calendario y las entradas de menú pueden anular los ajustes aplicables; elige Usar configuración del componente (o deja el valor en blanco) para heredarlos. Para las opciones del calendario que indican Usar configuración del calendario o del componente, se utiliza el valor predeterminado del componente si el propio calendario no tiene ningún valor.

Horario semanal

• Mostrar título del horario: Mostrar u ocultar el encabezado.
• Mostrar categoría del horario: Mostrar u ocultar el nombre del horario seleccionado.
• Activador de detalles: abre los detalles del evento al hacer clic o muestra una información sobre el elemento al pasar el ratón por encima, cuando esta función esté disponible.
• Mostrar hora del evento, ubicación, foto de la ubicación, instructor, foto del instructor, descripción y precio: controla de forma independiente qué detalles se muestran.
• Número máximo de caracteres en la descripción: Limita la longitud de la descripción en los detalles del evento. 0 significa mostrar la descripción completa.
• Símbolo de moneda del precio: texto que se muestra tras los precios de los eventos (el valor predeterminado global es €).
• Sustituciones de etiquetas en la interfaz: sustituye etiquetas como «Título», «Día», «Hora», «Lugar», «Profesor», «Precio» y «Descripción». Deja una etiqueta en blanco para utilizar el texto predeterminado del idioma.

Cuando los eventos se solapan, comparten el ancho disponible de la columna del día. Los eventos que no se solapan pueden expandirse a través del espacio libre adyacente, hasta ocupar toda la columna del día. En pantallas estrechas, el horario semanal se convierte en una lista de días y eventos apilados verticalmente. Un menú desplegable de títulos filtra los eventos por título.

Página de detalle del evento

• Mostrar categoría del horario: muestra u oculta el nombre del horario en los detalles del evento.
• Mostrar hora, ubicación, foto de la ubicación, profesor, foto del profesor, descripción y precio: controla los campos correspondientes del evento en la página del evento.
• Mostrar eventos relacionados: muestra otros eventos publicados con el mismo título, ordenados por día de la semana y hora de inicio. Sus títulos enlazan con sus propias páginas de evento.
• Mostrar OpenStreetMap en las páginas de evento: muestra un mapa cuando el evento tiene coordenadas de latitud y longitud válidas.
• Número máximo de caracteres en la descripción, símbolo de la moneda del precio y modificaciones de las etiquetas en la interfaz: configura la página del evento tal y como se ha descrito anteriormente.

Permisos y acceso

El componente utiliza acciones ACL de Joomla para la administración, gestión, creación, eliminación, edición, cambios de estado y edición de los propios eventos. Configúralas en Usuarios → Gestionar → Grupos (o en la configuración de permisos del sitio). Los formularios de creación/edición de la interfaz de usuario requieren los permisos pertinentes; no se debe conceder acceso de escritura a los visitantes públicos a menos que sea intencionado.