Documentación de Archivos adjuntos


Versión 2.2-RC1 - 3 de diciembre de 2010

Contenido

Introducción

La extensión 'Archivos adjuntos' para Joomla! permite cargar archivos y adjuntarlos a artículos y otros tipos de contenidos. 'Archivos adjuntos' incluye un complemento para mostrar los adjuntos y un componente para cargarlos y gestionarlos. Dispone de opciones para controlar quién puede ver los adjuntos y quién puede cargarlos junto con otras muchas para aumentar su flexibilidad y utilidad. Observación: todas las opciones se controlan mediante el gestor del componente. Esta extensión sólo funciona con Joomla! 1.5. No se ha probado con la versión 1.6.

La extensión 'Archivos adjuntos' se ha traducido a múltiples idiomas distintos. Consulte el listado de traducciones disponibles en la sección Traducciones. Muchos de esos paquetes de idiomas están actualizándose a la versión 2.0.

Si quisiera suscribirse a una lista de correo de anuncios sobre esta extensión, hágalo mediante esta página web:

Nuevas características de la versión 2.0

Restricciones de carga

No todos los tipos de archivos adjuntos se pueden cargar. La extensión 'Archivos adjuntos' no permitirá cargar archivos que no estén permitidos por el Gestor de medios de joomla!. Para ver (o cambiar) los tipos de archivos permitidos, vea la página de Configuración global y pulse la pestaña Sistema. En el área Parámetros de medios hay opciones para controlar qué tipos de extensiones de archivos y tipos mime se permite cargar. 'Archivos adjuntos' respeta esas limitaciones. No obstante la restricción de 'Extensiones de tipo de imagen permitidas (Tipos de archivos)' se ignora.

Ajustes

Todas las opciones de 'Archivos adjuntos' se controlan mediante el gestor del componente. Para acceder a ellas, inicie sesión en el área administrativa y seleccione "Archivos adjuntos" en el menú "Componentes". Pulse sobre el botón "Parámetros" del extremo derecho de la barra de herramientas y verá un conjunto de parámetros de esta extensión. Estos parámetros incluyen los siguientes:

Nombre o URL mostrado

Normalmente, cuando se cargan archivos (o se definen URLs) y se ven en la lista de adjuntos, se muestra el nombre de archivo (o la URL) completo como vínculo para descargar el adjunto. En algunos casos los nombres de archivo (o URLs) pueden resultar excesivamente largos para que ésto funcione con un aspecto adecuado. En el formulario de carga hay otro campo llamado "Nombre o URL mostrado" en el que quien cargue el archivo puede añadir un nombre (o URL) o etiqueta alternativos que se visualizarán en vez del nombre de archivo (o URL) completo. Por ejemplo en este campo se puede añadir una versión abreviada del nombre del archivo. El campo se puede modificar en el entorno administrativo al modificar los adjuntos. Observación: Existe en los parámetros de la extensión una opción llamada "Longitud máxima de nombre de archivo o URL". Se puede definir para que los nombres visualizados de los adjuntos cargados se recorten de forma automática; el nombre recortado resultante se incluirá en el campo "Nombre o URL mostrado".

Adjuntado de URLs

Una nueva característica de la versión 2.0 de Archivos adjuntos es la capacidad de "adjuntar" URLs a los elementos de contenido. Cuando se despliega uno de los cuadros de diálogo "Añadir adjunto" verá un botón etiquetado "Introduzca en su lugar una URL". Si lo pulsa obtendrá un campo de introducción para la URL y verá dos opciones:

Las URLs se muestran con el icono del tipo de archivo y con una flecha superpuesta (indicando que se trata de un vínculo correcto) o una línea roja en diagonal (indicando que no se ha podido comprobar). Cuando modifica una URL puede cambiar si el vínculo es válido o no para obtener el icono superpuesto que desee. Observe también que los iconos superpuestos se pueden desactivar completamente mediante el parámetro general Superponer iconos de URL vinculada. Hay varios comandos de utilidad relacionados con las URLs (y los archivos) en la opción "Utilidades" en el área administrativa.

¿A qué se puede adjuntar los archivos?

Además de adjuntar archivos o URLs a los artículos, ahora se puede adjuntar archivos o URLs a otros tipos de elementos de contenido tales como las Secciones y las Categorías (consulte a continuación). Si se instalan complementos adecuados de 'Archivos adjuntos', se pueden adjuntar archivos o URLs a una amplia variedad de elementos de contenido tales como perfiles de usuario, descripciones de productos de fichas de venta, etc. Básicamente cualquier elemento de contenido que se muestre en el área pública y utilice el evento de contenido 'onPrepareContent' permite alojar adjuntos (si se ha instalado un complemento de 'Archivos adjuntos' adecuado). Los elementos de contenido que invoquen los eventos de contenido son habitualmente elementos que tienen contenido o descripciones visualizables (como los artículos).

Adjuntado de archivos o URLs a descripciones de Secciones o Categorías

Con esta versión de Archivos adjuntos los usuarios puede adjuntar archivos a las descripciones de Secciones y Categorías. Estas descripciones generalmente sólo son visibles en las páginas en formato blog de Secciones o Categorías, si el parámetro básico 'Descripción' está definido como Mostrar (en el editor de menús). Se pueden adjuntar archivos a las descripciones de Secciones o Categorías en los editores de Secciones o Categorías.

Si quisiera saber más sobre cómo desarrollar un complemento de 'Archivos adjuntos' dispone de un manual en esta instalación de 'Archivos adjuntos':

Estilo CSS de la lista de adjuntos

La lista de adjuntos del área pública se construye mediante un 'div' especial que contiene una tabla con los adjuntos. La tabla tiene asociadas varias clases CSS que permiten al desarrollador del sitio web la flexibilidad de personalización del aspecto de la tabla. Consulte los ejemplos en el archivo CSS del complemento de Archivos adjuntos (en plugins/content/attachments.css). Si quisiera cambiar el estilo copie los estilos originales al final del archivo y renombre 'attachmentsList' en la parte copiada a algo diferente de su elección. Modifique los parámetros de 'Archivos adjuntos' (en el Gestor del componente) y cambie el parámetro Estilo CSS de la lista de adjuntos al nuevo nombre de clase. Luego modifique a su gusto las definiciones de clases de la zona copiada. Este método le permitirá volver rápidamente al estilo original devolviendo al parámetro del complemento Estilo CSS de la lista de adjuntos el valor por omisión 'attachmentsList'. Ésto también tiene la ventaja de que la sección de estilos modificados se puede copiar a un archivo y restaurada fácilmente cuando se actualiza una nueva versión de 'Archivos adjuntos'. Ésto también se podría hacer mediante un comando CSS @import.

Iconos de tipos de archivos

La extensión 'Archivos adjuntos' añade un icono delante del cada adjunto en la lista de adjuntos. Si quisiera añadir un tipo de icono nuevo, siga estos pasos: (1) Añada un icono adecuado en el directorio 'media/attachments/icons', si todavía no lo hay; (2) Modifique el archivo 'components/com_attachments/file_types.php' y añada una línea adecuada a la matriz estática $attachments_icon_from_file_extension que vincula cada extensión de archivo con un nombre de icono (en el interior del directorio media/attachments/icons). Si ésto no funciona, tendrá que añadir una línea adecuada a la matriz $attachments_icon_from_mime_type. (3) No olvide guardar copias del archivo de icono y del archivo file_types.php actualizado en algún lugar fuera de los directorios del sitio web antes de actualizar la versión de 'Archivos adjuntos' en el futuro.

Traducciones

Esta extensión permite el uso de múltiples idiomas y soporta los siguientes (además del inglés). Observe que alguno de estos paquetes de idiomas están todavía siendo actualizados a la versión 2.0 de 'Archivos adjuntos' y aún no se encuentran disponibles. Cualquiera que precise los paquetes de idiomas de la versión 1.3.4 debería ponerse en contacto directamente con el autor.

Gracias a estos traductores (versiones disponibles mostradas entre paréntesis):

¡Muchísimas gracias a los traductores! Si quiere ayudar a traducir la extensión a otro idioma, póngase en contacto con el autor (vea la sección Contacto al final).

Advertencias

Actualización

La actualización ahora es mucho más sencilla. Simplemente instale la nueva versión de 'Archivos adjuntos'.

Agradecimientos

Muchas gracias a los siguientes contribuyentes o recursos:

Contacto

Envíe informes de fallos y sugerencias a jmcameron@jmcameron.net