(Cómo funciona y por qué está planteado así)

El sistema de ruteo de SliderBuild está desarrollado en Vanilla PHP y parte de un principio deliberadamente simple: interpretar la URL para determinar con precisión qué datos deben consultarse y cómo deben devolverse.

Su responsabilidad es actuar como puente entre el CMS (Joomla / VirtueMart) y la cartelería digital, transformando consultas internas del sistema en respuestas JSON optimizadas para su consumo en pantalla.

En lugar de replicar lógica del CMS o crear múltiples endpoints especializados, el enfoque es más directo: la URL contiene toda la información necesaria. El sistema la analiza, identifica el tipo de consulta, aplica los modificadores indicados y construye la respuesta.

La URL no es solo una dirección: es la definición completa del comportamiento del slide.

1. Estructura de la URI

Formato base:

index.php?titulo={Personalizado}/{tipo}/{seccion}/{filtros}

Cada bloque tiene una responsabilidad clara dentro del flujo de ejecución. No hay ambigüedad: cada segmento activa una parte concreta del sistema.

1️⃣ Tipo

Es el primer nivel de decisión. Define qué estrategia de consulta se activa internamente:

• home
• categoria
• busqueda

Desde un punto de vista técnico, este segmento equivale a seleccionar el controlador o el modo operativo. A partir de aquí, el sistema sabe qué tipo de datos debe solicitar al CMS.

Ejemplo:

index.php/home/ultimos-productos

El sistema interpreta que debe ejecutar una consulta global asociada al bloque “home”, no una navegación por categorías.

2️⃣ Sección

Define el recurso concreto sobre el que se va a trabajar. Puede representar:

• Una categoría principal
• Una subcategoría
• Una subcategoría de varios niveles
• Un término de búsqueda

Este bloque determina el alcance real de la consulta. El sistema no infiere nada adicional: ejecuta exactamente lo que se especifica.

Ejemplo conceptual:

index.php/categoria/bebidas

Devuelve únicamente los productos asociados a la categoría bebidas, sin incluir otras secciones.

3️⃣ Filtros

Son modificadores opcionales que ajustan el resultado, pero no cambian la fuente de datos. Permiten definir:

• Criterio de ordenación
• Dirección del orden
• Rango de resultados

En términos prácticos: primero se define qué se consulta (tipo y sección) y después cómo se quiere presentar.

4️⃣ Parámetros GET de personalización

Además de los segmentos que definen la lógica de consulta, el sistema admite parámetros GET destinados exclusivamente a personalizar la presentación del slider.

Estos parámetros no modifican la fuente de datos ni la consulta al CMS. Su función es alterar cómo se muestra la información en pantalla, manteniendo una separación clara entre:

• Lógica de datos (qué productos se obtienen)
• Lógica de presentación (cómo se visualizan)

Actualmente, los principales parámetros de personalización son:

• ?titulo=
• ?cl=

?titulo=

Permite definir una rotulación personalizada para el slide, independientemente de la categoría o búsqueda utilizada.

Ejemplo:

index.php?titulo=OFERTAS SEMANA/categoria/lacteos

Aunque la consulta esté cargando la categoría lacteos, el encabezado visible en pantalla será “OFERTAS SEMANA”.

Este parámetro es especialmente útil cuando:

• Se quiere contextualizar visualmente una categoría existente.
• Se reutiliza una búsqueda técnica con una etiqueta comercial distinta.
• El término real de la consulta es demasiado largo para mostrarse como título.

?cl=

Permite definir el esquema de color del slider dentro de un conjunto de colores previamente configurados en el sistema.

No acepta valores arbitrarios, sino identificadores pertenecientes a una paleta predefinida en el archivo configuración. Esto garantiza coherencia visual y evita combinaciones fuera de estándar.

Ejemplo conceptual:

index.php?titulo=PACK AHORRO&cl=2/categoria/bebidas

En este caso:

1. La consulta carga la categoría bebidas.
2. El título visible será “PACK AHORRO”.
3. El slider utilizará el esquema de color asociado al segundo color dentro del array definido en el archivo de configuración.

En conjunto, los parámetros GET permiten ajustar la identidad visual del slide sin alterar su comportamiento técnico. La URL sigue definiendo completamente el contenido, pero estos parámetros refinan la forma en la que dicho contenido se presenta.

2. Tipos de Consulta

2.1 Home

index.php/home/ultimos-productos

Este modo recupera productos definidos dentro del bloque “home” del CMS, como:

• Últimos productos añadidos
• Productos destacados
• Selecciones configuradas manualmente

No navega por categorías. Es una vista agregada pensada para bloques globales como “Novedades” o “Destacados”.

En este modo, los filtros avanzados pueden no tener efecto si el CMS no los admite para esa vista específica.

2.2 Categoría (Soporte multinivel)

index.php/categoria/{alias}

Permite recorrer la jerarquía completa de categorías definida en VirtueMart.

Para representar subniveles se utiliza el carácter:

~

Este símbolo sustituye a la barra / dentro de la jerarquía.

Ejemplo:

index.php/categoria/alimentacion~arroz-y-legumbres

Internamente equivale a:

alimentacion/arroz-y-legumbres

Si existe un nivel adicional:

index.php/categoria/alimentacion~arroz-y-legumbres~arroces

También puede accederse directamente si el CMS lo permite:

index.php/categoria/arroces

Ambas rutas terminan resolviendo en la categoría final arroces.

Importante:

• Las categorías son case sensitive.
• Deben escribirse en minúsculas.
• Los espacios se sustituyen por -.
• La jerarquía se representa con ~.

Ejemplo correcto:

index.php/categoria/cuidado-personal~higiene-bucal

2.3 Búsqueda

index.php/busqueda/{termino}

Replica el comportamiento del buscador del sitio.

Los espacios deben representarse con +, siguiendo el formato estándar de URLs.

Ejemplo básico:

index.php/busqueda/yogur+fresa

Este modo es especialmente útil cuando:

• No existe una categoría específica.
• Se quiere crear una colección puntual.
• Se trata de campañas temporales.

La consulta es case insensitive, lo que facilita la construcción de la URL. Puede copiarse directamente el valor de ?keyword= generado por el buscador del CMS.

Ejemplo de producto específico:

index.php/busqueda/Refresco+Pack+2+COCA+COLA+Original+2L

Esto permite generar un slide con un único producto sin necesidad de crear una categoría dedicada.

En búsquedas largas, se recomienda usar ?titulo= para evitar que el encabezado supere el límite visual (36 caracteres, normalmente distribuidos en 2 líneas).

index.php?titulo=PACK AHORRO/busqueda/Refresco+Pack+2+COCA+COLA+Original+2L

3. Filtrado y Ordenación

El sistema funciona como un proxy controlado: no reimplementa la lógica de VirtueMart, sino que traslada sus parámetros nativos dentro de la URL.

Ordenación

Ejemplo:

index.php/categoria/bebidas/by,product_price/dirAsc

Devuelve los productos de la categoría bebidas ordenados de menor a mayor precio.

Paginación

/results,n-m

Define el rango exacto de productos que se devolverán.

Ejemplos:

/results,1-4

Muestra los productos del 1 al 4.

/results,5-8

Muestra los productos del 5 al 8.

Esto permite dividir un catálogo grande en varios slides sin añadir lógica adicional en el frontend.

Restricción importante: los rangos deben respetar bloques coherentes (normalmente múltiplos de 4, según configuración de VirtueMart).

Ejemplos correctos:

/results,1-4
/results,5-8
/results,1-20
/results,37-40

Ejemplos ajustados automáticamente:

/results,1-11   → se aproxima a /results,1-8
/results,3-8    → se ajusta al bloque válido más cercano
/results,1-21   → se aproxima a /results,1-20

Comprender esta lógica evita resultados inesperados en pantalla.

Limitaciones de los filtros

En aquellas situaciones en las que una consulta devuelve la totalidad de los resultados disponibles (por ejemplo, una categoría muy amplia sin límite de paginación), pueden producirse comportamientos no completamente predecibles en la ordenación.

Esto ocurre porque:

• El CMS puede aplicar la ordenación antes o después de ciertos procesos internos (joins, agrupaciones, disponibilidad, etc.).
• Algunas ordenaciones (como ventas o stock) pueden depender de datos agregados que no siempre se resuelven de forma óptima en consultas masivas.
• El volumen total de registros puede afectar a la consistencia del orden final cuando no se acota el rango.

Por este motivo, se recomienda aplicar ordenación únicamente cuando la consulta esté limitada mediante paginación en categorías o búsquedas.

Recomendación práctica

En lugar de:

index.php/categoria/bebidas/by,product_sales

Es preferible:

index.php/categoria/bebidas/by,product_sales/results,1-8

O en búsquedas:

index.php/busqueda/yogur+natural/by,product_price/dirAsc/results,1-4

De esta forma:

1. La consulta se acota a un rango concreto.
2. La ordenación se aplica sobre un conjunto controlado.
3. El resultado es más consistente y predecible en pantalla.

En resumen, cuando se necesita ordenar, es buena práctica combinar siempre ordenación + paginación, especialmente en categorías amplias o búsquedas con muchos resultados. Esto evita efectos colaterales derivados de consultas demasiado extensas y mantiene el comportamiento del slide bajo control.

4. Ejemplo Completo

index.php?titulo=Nuestras Ofertas/categoria/lacteos~yogures-y-postres/by,product_price/dirAsc/results,1-4

Esta URL define completamente el comportamiento del slide:

1. Personaliza el título como “Nuestras Ofertas”.
2. Accede a la categoría principal lacteos.
3. Entra en la subcategoría yogures-y-postres.
4. Ordena los productos por precio.
5. Aplica orden ascendente.
6. Devuelve únicamente los cuatro primeros resultados.

No hay configuración adicional fuera de esta línea.

Conclusión

SliderBuild es actualmente un proyecto interno, en fase activa de desarrollo y evolución. No es una herramienta pública ni cerrada, sino una base técnica que se está consolidando progresivamente a partir de necesidades reales de operación.

En su estado actual, el sistema actúa como capa de integración entre CMS basados en Joomla + VirtueMart y entornos de cartelería digital, permitiendo transformar estructuras de catálogo en respuestas JSON controladas y predecibles.

El enfoque sigue siendo el mismo: que la URL defina completamente el comportamiento del slide, manteniendo el sistema ligero, desacoplado y fácil de mantener.

A medio plazo, la hoja de ruta contempla varias líneas de mejora:

• Ampliación de compatibilidad con otros sistemas, extendiendo el modelo actual más allá de Joomla + VirtueMart.
• Soporte de directorios y carpetas, para estructurar mejor configuraciones y recursos asociados a los slides.
• Incorporación de un scheduler, que permita programar activaciones, rotaciones o cambios automáticos sin intervención manual constante.
• Mayor diversidad de plantillas de slider, tanto en variedad visual como en flexibilidad estructural.
• Mejora progresiva de la calidad gráfica y de renderizado, optimizando legibilidad, jerarquía visual y adaptación a distintos formatos de pantalla.

El objetivo no es únicamente ampliar funcionalidades, sino consolidar una arquitectura sólida que permita crecer sin comprometer claridad ni mantenibilidad.

En definitiva, SliderBuild no es un producto terminado, sino una infraestructura en construcción: una base técnica pensada para escalar con orden, incorporando nuevas capacidades sin perder el principio que lo define — que el comportamiento esté explícitamente descrito y sea completamente controlable.