DocMan

DocMan es un componente para manejar y distribuir archivos hecho por JoomlaTools.org. Yo lo uso en VenExpats, en la sección de Desgargas, para distribuir los fondos de pantalla (wallpapers) y logos.

1. Traducción al Español

Para lograr su completa integración con VenExpats, participé en la traducción al español de la última versión (1.4.0 stable). Por favor descarguen el siguiente archivo:

spanish_docman_v1.4.0_STABLE (actualizado: 02/28/2009)

2. Hack para visualizar thumbnails en vez de íconos.

Normalmente los íconos de los documentos de Docman se usan para describir el tipo de archivo (PNG, GIF, ZIP, etc), pero DocMan te dá la opción de usar tu propia imagen, por lo que se me ocurrió utilizar la imagen del “ícono” como el “thumbnail” del wallpaper.

Ejemplo del default theme:

Listado de Categorías:

Listado de Archivos:

Lo primero que hice fué instalar el theme de MjazTools, llamado “Blog Theme” que es como un camaleón, ya que se adapta al tema central de mi instalación de Joomla.

Luego, busqué el código que inserta la imagen en el listado de las categorías, que se encuentra en el archivo list_item.tpl.php en el directorio components\com_docman\themes\mjaztools_blogtheme\templates\categories\ (cuando no se usa el set de íconos), en este caso fué esta sección:

<td valign="top" width="<?php echo $this->theme->conf->doc_image_width;?>" >
<a href="<?php echo $item->links->view;?>">
<img src="<?php echo $myImage;?>" alt="<?php echo $item->data->name;?>" align="right" width="<?php echo $this->theme->conf->doc_image_width;?>" height="<?php echo $this->theme->conf->doc_image_width;?>" />
</a>
</td>


Como ven, usa la variable doc_image_width (que se encuentra en el tema) como valor para el width y el lenght. Lo que hice fué agregar un poco de código de manera que si el usuario deja en blanco el ancho de la imagen, entonces utiliza el valor que el usuario entra en la configuración del módulo. O sea, en vez de forzar la imagen a 150×150 (el valor predeterminado del tema), coloca la imagen con el tamaño que yo necesito. Para lograr esto, hay que agregar el siguiente código (en la misma sección):

<td valign="top" width="<?php echo $this->theme->conf->doc_image_width;?>" >
<a href="<?php echo $item->links->view;?>">
<img src="<?php echo $myImage;?>" alt="<?php echo $item->data->name;?>" align="right"
<?php if ($this->theme->conf->doc_image_width OR $this->theme->conf->doc_image_width != "") { ?>
width="<?php echo $this->theme->conf->doc_image_width;?>" height="<?php echo $this->theme->conf->doc_image_width;?>"
<?php } ?>
/></a>
</td>

De igual manera, tuve que cambiar el código del archivo que maneja el listado de los archivos de la siguiente manera:

archivo: list_item.tpl.php, en el directorio components\com_docman\themes\mjaztools_blogtheme\templates\documents\

ubicar la siguiente sección de código:

<td valign="top" width="<?php echo $this->theme->conf->doc_image_width;?>" >
<a href="<?php echo $download_url; ?>">
<span <?php echo $myPubApp?>>
<img src="<?php echo $myImage?>" alt="<?php echo $this->doc->data->dmname;?>" class="mosimage" style="border:none" align="right" />
</span>
</a>
</td>

y cambiar por el siguiente código:

<td valign="top" width="<?php echo $this->theme->conf->doc_image_width;?>" >
<a href="<?php echo $download_url; ?>">
<span <?php echo $myPubApp?>>
<img src="<?php echo $myImage?>" alt="<?php echo $this->doc->data->dmname;?>" class="mosimage" style="border:none" align="right"
<?php if ($this->theme->conf->doc_image_width OR $this->theme->conf->doc_image_width != "") { ?>width="<?php echo $this->theme->conf->doc_image_width;?>" height="<?php echo $this->theme->conf->doc_image_width;?>"
<?php } ?>
/>
</span>
</a>
</td>

El resultado? Thumbnails no distorsionados de las fotos en el listado de los archivos!

Listado de Categorias:

Listado de Archivos:

3. Módulo Popular Thumbs

Ya que mis archivos son imágenes, me pareció que usar los módulos de “lister” y “latest downloads” que vienen con el componente no era lo mejor, ya que lo único que hacen son listados de los nombres de los archivos, y yo quería algo más gráfico. Al final hice un módulo que mantiene el formato gráfico usado en el directorio, de manera de mantener la coherencia en el site. Al final de cuentas, aunque es un módulo que lo hice específicamente para VenExpats, lo hago disponible por si acaso a otras personas le interesan.

Por ejemplo, usando el mod_docman_lister:

y usando el mod_docman_popular_thumbs, puedes tener un listado vertical:

u horizonal:

estas son todas las opciones de configuración del módulo:

y finalmente, aquí pueden bajarse el archivo según la versión que tengan:

Docman_Popular_Thumbs_v1.zip (for Docman 1.3)

Docman_Popular_Thumbs_V1.4.0.zip (for Docman 1.4.0rc2)