Agregar un tipo de documentos

como agregar un tipo de documentos y su extensión a la lista que SPIP permite subir como documentos adjuntos

Desde la versión [SPIP 1.4], es posible instalar documentos adjuntos a los artículos (y, opcionalmente, a las secciones).

Por razones de seguridad, SPIP no autoriza la instalación de cualquier tipo de documentos. En efecto, permitir la instalación de documentos en un servidor distante a través de una interfaz web puede plantear serios problemas de seguridad. Es por eso que existe esa lista de autorizaciones, y por esa misma razón que SPIP no ofrece interfaz para modificar dicha lista.

El cuadro que permite adjuntar un documento
Este cuadro de la interfaz privada muestra sistemáticamente la lista completa de los tipos de documentos autorizados.

Como puedes constatar, la lista de tipos de archivos autorizados es de por sí relativamente amplia, y la enriquecemos regularmente cuando la necesidad se expresa en las listas.

Por ende, antes de proseguir, toma el tiempo de leer atentamente lo que sigue:


-  Esta manipulación es potencialmente peligrosa y puede introducir enormes huecos de seguridad en tu sitio. Sobretodo, nunca se deben aceptar ciertos formatos de archivos ejecutables en el servidor. En particular, nunca aceptes la instalación de archivos de tipo PHP (.php, .php3...) en tu sitio. Su seguridad estaría comprometida por completo. No dudes en informarte antes de agregar tipos de ficheros.

-  Voluntariamente, no hemos instalado en SPIP una interfaz para modificar la lista de ficheros autorizados. Esto es para reservar esta modificación a usuarios expertos. Para efectuar la manipulación, se debe utilizar un manejador de bases de datos (por ejemplo: phpMyAdmin). Pero modificar la base de datos de SPIP «a mano» (es decir sin utilizar la interfaz y los automatismos de SPIP) es potencialmente destructor del sitio. Si no sabes exactamente lo que haces, no lo hagas. Si no estás acostumbrado a phpMyAdmin, no lo uses con la base de SPIP. Sea como sea, haz primero un respaldo de tu sitio SPIP antes de proceder a intervenciones manuales en la base de datos.

-  Accesoriamente, el agregar un tipo de ficheros no se justifica más que si los visitantes de tu sitio pueden utilizar («leer») este tipo de ficheros. Utilizar en un sitio para el gran público un formato de ficheros que sólo se pueda leer con un software ultra-especializado no tiene mucho sentido. Antes de agregar un tipo de archivos, verifica que puede ser utilizado por los usuarios (en particular: ¿existe lector o plug-in gratuito y fácil de instalar? ¿se puede leer el formato en todos los ordenadores- Mac, PC, Linux?, ...).

-  Por todas estas razones, insistimos sobre el hecho que esta manipulación sólo debe hacerse con pleno conocimiento de causa. Si tienes dudas, informate con personas competentes o, mejor, convierte los ficheros a un formato que ya sea conocido y ampliamente utilizado (por ejemplo, el público en general no será capaz de leer un documento FrameMaker; si se trata simplemente de dar a conocer su contenido, es mejor hacer un fichero .pdf que se pueda bajar directamente desde el sitio que agregar el tipo «FrameMaker» en la lista de los archivos autorizados por SPIP).

* *

Para agregar un tipo de fichero autorizado a tu sitio SPIP, utiliza phpMyAdmin (o cualquier software equivalente) para acceder a la gestión de la base de datos.

Hay que agregar un nuevo registro a la tabla spip_types_documents.

Visualización en phpMyAdmin de algunos tipos de documentos

-  id_type. Deja este campo vacío. MySQL efectúa automáticamente la numeración de los identificadores id_type.

-  titre. Indica el nombre del tipo de archivos (a menudo se trata del nombre del programa que permite crear y leer este tipo de ficheros). Elige un nombre corto y lo más genérico posible. En un sitio multilingüe ten cuidado para no dar un nombre que sea específico de un idioma (por ejemplo un visitante anglófono no estará muy interesado en un fichero indicado como una «imagen vectorial para Illustrator»; mejor poner simplemente «Adobe Illustrator»).

-  descriptif. Dejalo vacío; ya no se utiliza este campo.

-  extension. Este campo es el más importante: aquí se indica el tipo de fichero identificándolo por su extensión. Por ejemplo, «rm» y «ram» para Real, «pdf» para un fichero Acrobat PDF, «gif» para una imagen en formato GIF...

-  mime_type. Dejalo vacío; este campo no se utiliza.

-  inclus. Se debe elegir entre: «embed», «non», «image». Ten cuidado de efectuar la elección correcta aquí. Es muy importante para un buen funcionamiento de tu sitio, pues determina de qué manera se «llama» un documento en tu sitio cuando se presenta a las visitantes :

  • «non»: este tipo de fichero no puede ser incluido directamente dentro de una página HTML; sólo se puede presentar mediante un enlace de hipertexto. Por ejemplo, un archivo PDF no puede ser mostrado dentro de una página HTML: la única manera de adjuntarlo, es creando un enlace hipertexto que permita abrir el fichero en una nueva ventana (o de descargarlo en el disco duro de la estación del visitante); por ende, un fichero de tipo «pdf» tendrá el atributo del campo inclus fijado a «non»;
  • «embed»: este tipo de fichero puede ser mostrado directamente dentro de una página HTML donde será leído mediante una extensión del navegador (plug-in...). Tal es el caso de la mayoría de los formatos multimedia utilizados en la web: Flash, Shockwave, películas de vídeo...
  • «image»: se trata de formatos de imágen que se muestran directamente dentro de la página HTML sin extensión particular (con el código HTML <img src=...>). A priori, no tendrás necesidad de agregar tales tipos de ficheros, dado que la lista que brinda SPIP ya es exhaustiva. (OjO: algunos formatos de imagen realizados con programas de «dibujo» no pueden ser colgados directamente en un navegador como «imágenes» y necesitan una extensión o un programa externo para ser leídos. Para tales formatos se debe escoger «embed», o incluso «non».)

-  upload. Indica que autorizas la instalación de este tipo de ficheros a través de la interface web de SPIP. Por eso se escoge «oui».

-  maj. SPIP maneja automáticamente este campo. Dejalo vacío.

* *

Una vez efectuada esta operación, puedes crear un nuevo icono (miniatura de previsualización) que corresponda a este nuevo tipo de ficheros. Para asegurar la coherencia gráfica con los iconos que se distribuyen con SPIP, el icono debería tener un tamaño de unos 48 pixeles de ancho y 52 pixels de alto.

Puedes utilizar cualquier tipo de formato de imagen (GIF, PNG, JPG); prefiriéndose un formato que maneje la transparencia para el fondo.

-  El nombre de tu fichero se debe formar así:

  • la extensión del tipo de fichero autorizado;
  • el formato gráfico de este icono («.gif», «.png»...);
  • por ejemplo, un icono (o miniatura) guardada en PNG, creada para el formato de ficheros PDF, será denominada: «pdf.png».
  • Nota: Los nombres que terminan por «-dist» están reservados para los ficheros distribuidos con SPIP. Por eso, no utilices el nombre «pdf-dist.png», que está reservado para el fichero creado por los autores de SPIP; si utilizas dicho nombre, tu fichero corre el riesgo de ser reemplazado durante la próxima actualización de SPIP.

-  Este icono se instala mediante FTP en la carpeta /IMG/icones.

Autor o autora dani Publicado el: Actualizado: 26/10/12

Traducciones: عربي, català, English, Español, français, italiano, Nederlands