Documentación de 'Attachments'

Versión 1.2 - Febrero 20, 2008

  1. Introducción
  2. Restricciones de subida
  3. Ajustes
  4. Desplegar nombre de archivo
  5. Estilizando la lista de archivos adjuntos
  6. Iconos por tipo de archivo
  7. Advertencias
  8. Actualizando
  9. Reconocimientos

Introducción

La extensión de 'Attachments' para Joomla! le permite subir archivos y adjuntarlos a artículos. 'Attachments' incluye un plugin para desplegar la lista de archivos adjuntos y un componente para subir y administrar estos archivos. Existen varias opciones para controlar quien puede ver y quien puede subir archivos, además de muchas más opciones para incrementar la flexibilidad y usabilidad del mismo. Nota: todas las opciones son controladas a través  del administrador de componentes. Esta extensión solo funciona con Joomla! 1.5 o mas nuevo.

Esta extensión provee capacidades de traducción y soporta los siguientes lenguajes (además de inglés):

Muchas gracias a los traductores! Si deseas ayudar a traducir esta extensión a cualquier otro lenguaje, por favor contacta al autor.(ver al final). [Regresar]

Restricciones de subida

No todos los tipos de archivos pueden ser subidos. El componente de 'Attachments' no permitirá subir archivos que no estén previamente autorizados por el administrador de medios de Joomla!

Para ver (o cambiar) que tipo de archivo están permitidos, vaya a la página de Configuración Global y oprima en la pestaña de Sistema. En el área de Ajustes de Medios, existen opciones para controlar que extensiones y tipos mime están permitidos para subir. 'Attachments' respeta estas limitaciones, la restricción en 'Extensión de Imagen Legal' es ignorada. [Regresar]

Ajustes

Todos los ajustes para 'Attachments' son controlados vía el administrador de componentes. Para accesar estos ajustes, vaya al área de administrador y seleccione "Archivos Adjuntos" bajo el menú de "Componentes". Presione en el botón de "Parámetros" el cual se encuentra en el lado derecho de la barra de herramientas y usted verá una serie de parámetros para esta extensión. Entre los parámetros podemos encontrar los siguientes:


Si el archivo no puede ser desplegado por el navegador, será descargado como archivo [Regresar]

Desplegar nombre de archivo

Normalmente, cuando los archivos son subidos y listados en la lista de archivos adjuntos, el nombre completo del archivo es mostrado como un vínculo para descargar el archivo. En algunos casos, el nombre puede ser muy largo para que funcione correctamente. En la forma para subir archivos, existe otro campo llamado "Desplegar nombre de archivo" en el cual la persona que está grabando el archivo puede insertar un nombre alternativo o etiqueta para desplegar en lugar del nombre de archivo completo. Por ejemplo, alguna abreviación del nombre de archivo puede ser utilizada en este campo. Este campo puede ser editado en el área de administración de Joomla!  Nota: Existe una opción en las opciones del plugin llamada "Longitud máxima de nombre de archivo". Esta puede ser establecida a truncar automáticamente; el nombre de archivo resultante será insertado en el campo de "Desplegar nombre de archivo". [Regresar]

Estilizando la lista de archivos adjuntos

La lista de archivos adjuntos mostrada en el "Front End" usa un 'div' especial el cual contiene una tabla para los archivos. La tabla tiene diferentes clases CSS asociadas, las cuales permiten al desarrollador del sitio la flexibilidad de personalizar la apariencia de la tabla. Para ejemplos vea el archivo CSS en el directorio del plugin  (localizado en plugins/content/attachments.css) . Si desea cambiar el estilo, considere copiar el estilo original al final del archivo y renombre 'attachmentsList' al nombre de su elección. Edite el parámetro de Archivos adjuntos (en el administrador de componentes) y cambie el parámetro  Estilo CSS para las tablas de archivos adjuntos por el nuevo nombre de la clase. Después modifique la definición de la clase, de acuerdo a sus requerimientos. Esto le permitirá fácilmente regresar al estilo original cambiando el parámetro Estilo CSS para las tablas de archivos adjuntos a su valor por defecto, 'attachmentList'. Esto también nos da la opción de copiar los estilos modificados a un archivo y así fácilmente restaurarla cuando la versión del plugin sea actualizada. Esto también puede ser realizado usando el comando de CSS @import. [Regresar]

Iconos por tipo de archivo

La extensión de 'Attachments' agrega un icono al inicio de cada archivo en la lista de archivos adjuntos. Si desea agregar un nuevo tipo de icono, siga los siguientes pasos: (1) Agregar el icono apropiado en el directorio 'media/attachments/icons', si no existe un icono apropiado; (2) Edite el archivo 'components/com_attachments/file_types.php' y agregue una línea a el arreglo estático $attachments_icon_from_file_extension el cual mapea una extensión de archivos a un nombre de archivo (los cuales están en el directorio media/attachments/icons). Si esto no funciona, usted necesitara una line al arreglo $attachments_icon_from_mime_type. (3) No olvide hacer copias de los iconos y el archivo file_types.php a algún directorio fuera del sitio, esto lo debe de hacer antes de realizar alguna actualización al módulo. [Regresar]

Advertencias

[Regresar]

Actualizando

Si usted ha agregado archivos adjuntos y desea preservarlos después de una actualización, use los siguientes pasos:

  1. Use phpMyAdmin (u otro administrador de SQL) para grabar el contenido de la tabla jos_attachments table (use la opción 'Exportar', intente usar la opción inserciones 'Completas' pero no del tipo 'Extendido').
  2. Desinstale el componente 'Attachments'.
  3. Desinstale ambos plugins de 'Attachments'.
  4. Instale la nueva versión del el plugin y ambos componentes.
  5. Re habilite el plugin de 'Attachments'.
  6. Finalmente use phpMyAdmin para re alimentar los attachments grabados previamente, estos deberán de alimentarse en la tabla jos_attachments.
  7. Si usted está actualizando una versión anterior a la 1.0 a una más reciente que la 1.0, y cuenta con attachments antiguos, usted necesitara agregar los valores apropiados al campo 'icon_filename', esto lo podrá hacer autentificándose como administrador en él y dirigiéndose al siguiente URL en su navegador:  /administrator/index.php?option=com_attachments&task=add_icon_filenames

Note que al desinstalar la extensión de 'Attachments' esta no borra los archivos que usted grabo, solamente elimina los registros de la base de datos. Así que después de instalar la nueva versión, solamente es necesario restaurar la tabla anterior para poder ver los archivos adjuntos.

Si desea no restaurar la base de datos, no olvide borrar los archivos obsoletos, esto con el propósito de evitar futuros problemas con nombres de archivos duplicados. [Regresar]

Agradecimientos

Muchas gracias a los siguientes contribuyentes o recursos:


Note que la mayoría de los iconos de 'Attachments' fueron modificados de las versiones originales de los sitios. Si usted desea las versiones originales, por favor descárguelos de los sitios originales. [Regresar]

Por favor reporte cualquier errora o sugerencia a jmcameron@jmcameron.net.