Bonsai
Bonsai 6.0

Bonsai

¿Qué es Bonsai?

Bonsai es una aplicación complemento del programa de gestión de bibliotecas escolares Abies. Está pensado para crear y mantener en la web del centro un sistema de consultas del catálogo de libros de la biblioteca. Bonsai utiliza una base de datos propia que importa automáticamente los registros bibliográficos introducidos en el programa Abies.

Este script surgió como una solución sencilla y efímera a la espera de la versión Abies Web. Ante la demora en esta publicación, Bonsai se ha convertido en un sistema popular para exportar a la web el catálogo de libros de la biblioteca llegando a traducirse a otras lenguas: catalán, euskera, gallego, asturiano, etc.

Bonsai no gestiona los préstamos/devoluciones ni contempla otras opciones de procesamiento más complejas.

Requisitos

La versión 6.0 incorpora como novedad que es una aplicación web en línea. Esto significa que no es necesario instalar ningún programa en el ordenador sino que todo se gestiona en línea a través del navegador web. Eso sí: resulta imprescindible administrar la biblioteca del centro usando el programa Abies 2. ya que Bonsai importa los registros bibliográficos de este programa.

Bonsai requiere disponer de una cuenta en un servidor web con los siguientes servicios:

  1. FTP que permita subir los archivos de la aplicación al servido remoto.
  2. PHP 5 o superior para interpretar el código de las páginas activas que utiliza Bonsai.
  3. MySQL 5 o superior que proporciona la base de datos donde guardará la información de los libros del catálogo.

Desde Abies 2 se exportan los datos del catálogo a un archivo de texto *.TXT que contiene toda la información de los registros bibliográficos. A continuación desde Bonsai es posible subir e importar el contenido de este archivo de texto.

Antes de continuar conviene asegurarse de que se dispone de una cuenta de alojamiento de páginas web con las correspondientes credenciales FTP y MySQL.

Instalación

  1. Descarga y decomprime el archivo bonsai_v60.zip. Como resultado obtendrás en tu equipo la carpeta bonsai. En su interior se encuentran todos los archivos necesarios para que la aplicación funcione.
  2. Utiliza Filezilla como cliente FTP para subir esta carpeta a tu cuenta en el servicio de hosting. Es posible modificar su nombre de carpeta bonsai por otro más acorde con nuestra instalación: biblio, biblioteca, libros, etc.
  3. Abre esta carpeta en tu servidor desde Filezilla y sobre la subcarpeta include haz clic derecho para seleccionar la opción Cambiar atributos de archivo y asignarle permisos de escritura 777.
  4. Inicia el navegador web y navega hasta el interior de la carpeta subida. Si no se ha realizado todavía ninguna instalación, se iniciará automáticamente el asistente de instalación. Clic en el botón Iniciar.
  5. Introduce los parámetros de tu instalación. En esta página es necesario escribir los valores de los distintos parámetros que necesita Bonsai para funcionar:
  6. Clic en el botón Continuar.
  7. Si la conexión ha tenido éxito se mostrará el mensaje de confirmación. Si la tabla indicada en la configuración ya está creada anteriormente no la modificará ni añadirá registros bibliográficos de prueba. Para que cree la tabla de nuevo será necesarsio acceder con phpMyAdmin y eliminarla de forma manual.
  8. Una vez concluida la instalación, por motivos de seguridad, se aconseja acceder con Filezilla y eliminar o modificar el nombre de la subcarpeta install.
  9. Clic en el enlace Acceder a la aplicación.
  10. Para reiniciar la instalación basta con eliminar el archivo conn.php creado en la subcarpeta include.

Subir catálogo de ejemplares

Obtener el catálogo desde Abies 2

  1. Abre el programa Abies 2.0
  2. Clic en el enlace Consultar el catálogo de la biblioteca.
  3. Cierra el cuadro de diálogo Consulta.
  4. En la columna lateral izquierda haz clic en el enlace Informe.
  5. Se inicia el Asistente para informes. Clic en el botón Siguiente.
  6. Selección de campos. Incluye todos los campos pulsando una sola vez en el botón >>
  7. Clic en el botón Siguiente.
  8. Formato del informe. Elige la opción Archivo de texto (campos delimitados).
  9. Asegúrate de que el delimitador es Punto y coma y que como Cualificador de texto se utilizan las comillas dobles.
  10. Clic en el botón Siguiente.
  11. Opciones del informe. Comprueba que están marcados por defecto los cuatro checkboxes.
  12. Clic en el botón Siguiente.
  13. Clic en el botón Finalizar.
  14. Una vez concluida la exportación se abrirá el Bloc de Notas mostrando su contenido.
  15. Desde el Bloc de notas selecciona Archivo > Guardar como ...
  16. En el combo Guardar en: define la carpeta destino, introduce el nombre del archivo (p.e. catalogo.txt) y despliega el combo de Codificación para elegir UTF-8.
  17. Clic en el botón Guardar.

Subir el catálogo a Bonsai

  1. Clic en el botón Subir que se ofrece en la esquina superior derecha de la página principal.
  2. Introduce el Usuario y Contraseña de subidas y pulsa en el botón Iniciar sesión
  3. Clic en el botón Seleccionar archivo para localizar el archivo *.TXT con el catálogo exportado desde Abies 2.
  4. Clic en el botón Subir. Transcurridos unos segundos se habrá completado la subida.
  5. Pulsa en el botón Cerrar. Para refrescar la página principal haz clic en su imagen de cabecera.

La web de consulta

Paginación

En la esquina superior derecha, bajo la barra de búsqueda, encontrarás la botonera para moverte entre las páginas del listado.

  1. Pulsa sobre sus distintos botones: Primera, Anterior x 10, Anterior, Siguiente, Siguiente x 10 y Última.
  2. Si deseas ampliar o reducir el número de ejemplares a visualizar en cada página, haz clic sobre el número deseado: 10, 20, 50, 100 ó 200.

Búsqueda

  1. Introduce en las casillas Titulo, Autor y/o Editorial la información a buscar.
  2. Clic en el botón Buscar o pulsa la tecla <enter>
  3. Se muestra el mensaje Filtro aplicado a ... para indicar el campo o campos en los que se han establecido los criterios de búsqueda.
  4. En el listado de ejemplares se muestra en video resaltado el campo coincidente con el criterio de búsqueda.
  5. Para regresar a los fondos completos borra la información contenida en los criterios de búsqueda y vuelve a pulsar el botón Buscar.

Ordenación

  1. Clic sobre un campo (Título, Autor o Editorial) en el encabezado del listado para realizar una ordenación en sentido ascendente o descendente por ese campo.
  2. Sobre el encabezado se muestra el tipo de ordenación que hemos configurado para el listado.

Detalles del ejemplar

  1. Pulsa sobre el Título de un ejemplar.
  2. Se desplegará una ventana emergente mostrando la principal información del mismo.

Otros:

Se indica la fecha de la Última actualización realizada en la Base de datos que contiene el catálogo de libros de la biblioteca.

Personalizar idioma y cabecera

Idioma

  1. Bonsai incluye por defecto los idiomas español (es_ES) e inglés (en_GB). Los archivos de estos idiomas se guardan en la carpeta languages.
  2. Para crear otro archivo de idioma copia el archivo es_ES.php para guardarlo con otro nombre de archivo *.php correspondiente al idioma elegido. Ejemplo: catalán (ca_CA.php), gallego (gl_GL.php), euskera (eu_EU.php), francés (fr_FR.php), alemán (de_DE.php), portugúes (pt_PT.php), etc
  3. Edita su contenido para modificar todas las cadenas de texto que utiliza Bonsai.
  4. Guarda y sube el nuevo archivo de idioma a la carpeta languages.
  5. Edita el contenido del archivo de configuración conn.php creado en la subcarpeta include para modificar el valor del parámetro $language para que apunte al nuevo idioma: ca_CA, gl_GL, eu_EU, etc
  6. Guarda y sube de nuevo este archivo conn.php a la subcarpeta include.

Cabecera

  1. En la subcarpeta images se puede situar una imagen JPG personalizada de tamaño 750x80 pixeles. Para el idioma español (es_ES) habría que editar o sustituir la imagen header_es_ES.jpg.
  2. En la página principal de Bonsai se mostrará como encabezado la imagen alojada en la subcarpeta images con el nombre header_<idioma>.jpg. Ejemplo: header_ca_CA.jpg, header_gl_GL.jpg, etc.

Licencia de uso

Licencia de Creative Commons
Este obra está bajo una licencia de Creative Commons Reconocimiento-NoComercial-CompartirIgual 4.0 Internacional.