Un breadcrumb es una ayuda de navegación que nos indica el camino que hemos seguido para llegar hasta donde nos encontramos actualmente. Usalmente aparecen horizontalmente en la página debajo de la cabecera. Un ejemplo, es el que puedes ver cuando lees este contenido, en la parte superior izquierda dice:
Inicio->Libros->Custom Breadcrumbs
Cada elemento del Breadcrumb, representa un paso o sección, siendo de mayor nivel los que están más a la izquierda (esto es al revés para aquellos países que utilizan escritura de derecha a izquierda, como los chinos). A su vez, cada elemento suele ser un enlace, y por tanto una forma de desplazarnos hacia arriba, al nivel superior, que necesitemos. Prueba presionando los elementos en el breadcrumb de esta página.
En algunas ocasiones se muestra también un elemento que representa a la página actual y que no necesita ser un enlace. Este elemento lo puedes encontrar al extremo derecho. En la página actual es aquel con el texto Custom breadcrums.
El término breadcrumb no tiene una traducción al idioma español que sea aceptada sin discusión. Se ha usado expresiones como migas de pan o rastros de miga. El origen del término parece estar relacionado con aquel cuento donde el personaje va dejando migajas de pan por el camino como una forma de señales para luego poder regresar por el mismo lugar.
El módulo Custom breadcrumbs nos permite crear breadcrumbs personalizados de acuerdo al tipo de contenido, el título del nodo y mucho más.
INSTALACIÓN
La instalación de Custom breadcrumbs sigue la forma estándar de instalación de módulos.
Para agregar la posibilidad de poner marcas (token) que serán reemplazados por valores, es necesario instalar el módulo Token. Para mayor información sobre le módulo Token consulte el capítulo sobre el mismo.
USO DEL MÓDULO
Una vez que tenemos instalado el módulo Custom breadcrumbs, tendremos una nueva opción en el menú Costrucción del Sitio
Construcción del Sitio->Custom Breadcrumbs
Ingresando a esta opción del menú nos mostrará una pantalla que nos permitirá agregar Breadcrumbs personalizados. Tendremos para ello un enlace que dice
Add a new custom breadcrumb
presionamos en el mismo y nos mostrará una página como la siguiente:
(TODO: Agregar imagen)
Podemos observar los siguientes elementos:
- Tipo de nodo
- Breadcrumb visibility
- Titles
- Paths
- Comodines receptáculos (esto solo aparece si es que tenemos también instalado el módulo Token)
- Override menu path
Un breadcrumb personalizado (custom breadcrumb) se aplica a un tipo de nodo. Por tanto en la lista desplegable Tipo de nodo, seleccionaremos el tipo de nodo para el cual estamos creando el Breadcrumb personalizado.
La caja de texto Breadcrumb visibility es una opción avanzada. Mediante esta opción nosotros podemos determinar en que casos aparecerá el breadcrumb, poniendo para ello una función en lenguaje PHP que devolverá TRUE o FALSE. Si la condición se cumple y se devuelve TRUE se mostrará el breadcrumb caso contrario no se mostrará. No es necesario llenar este campo.
En Titles pondremos cada uno de los títulos de cada uno de los enlaces de los elementos del breadcrumb. Si es que queremos poner varios, pondremos cada uno en una línea distinta. Titles y Paths actúan juntos, es decir a cada elemento de Titles le corresponde un elemento de Paths; Titles provee del título al elemento y path de la ruta hacia donde apunta el enlace.
En Paths colocaremos la ruta de cada uno enlaces de los elementos del breadcrumb. Por cada línea de Titles debe haber una línea en Paths. Igualmente van separados en líneas diferentes.
Comodines Receptáculos es una lista de tokens, que podemos usar tanto en Titles como en Paths, para que se reemplacen por los textos correspondientes.
La opción Override menu path, permite que la url se adapte al breadcrumb, sobreescribiendo la url que tuviera el nodo. Por ejemplo existe una opción que viene por defecto is es <none>. Si utilizamos esta opción, no le colocará enlace al Breadcrumb.
