1. INTRODUCCIÓN

Coppermine es una Galería de Imágenes en contorno Web.

En ella se pueden crear Categorías y Albumes para clasificar distintas fotografías, imágenes o animaciones y vídeos.

Los contenidos subidos a la galería serán transformados por la propia herramienta para poder ser visualizados en tres tamaños: miniaturas, intermedio y tamaño real.

La visualización puede ser manual o paso de diapositivas automático con transiciones.

No se precisa de ningún programa FTP para subir las imágenes ya que se pueden subir directamente en línea.

Cada uno de los contenidos puede tener comentarios, valoraciones y hacer de esta sencilla pero potente galería un espacio colaborativo.

También admite espacios de fotos más vistos o mas valorados, así como vistas de imágenes al azar.

La administración es sencilla, con distintos niveles de usuarios pudiendo personalizarse el aspecto mediante distintos temas que incorpora.

Está desenvuelta en PHP y trabaja sobre una base de datos MySQL.

La galería puede ser privada, accesible solo a usuarios registrados o disponible para todos los visitantes de nuestro sitio web. Los usuarios, si les está permitido, pueden subir imágenes a través de su navegador (las miniaturas y las imágenes de tamaño intermedio son creadas automáticamente), valorarlas, agregar comentarios e incluso enviar postales.

El administrador del sitio web decide cuáles de las características mencionadas son accesibles para los usuarios registrados y no registrados. El administrador puede también manejar galerías y procesar en lote gran cantidad de imágenes que hayan sido subidas el servidor por FTP.

Los archivos de imagen son almacenadas en álbumes y los álbumes pueden ser agrupados en categorías, las cuales, a su vez, pueden ser reagrupadas bajo categorías padre.

El script soporta múltiples usuarios y le provee al administrador las herramientas necesarias para determinar qué grupo de usuarios puede o no puede realizar distintas acciones, como por ejemplo: crear álbumes personales, subir imágenes a los álbumes públicos, enviar postales, agregar comentarios, valorar las imágenes, etc.

Coppermine posee un sistema de selección de temas (aspecto visual) por parte del usuario y varios temas preinstalados. También admite el uso de múltiples idiomas y contiene su propia librería idiomática. Esto permite que sus usuarios utilicen la galería en su idioma preferido. Coppermine utiliza PHP, una base de datos MySQL y la librería GD (versión 1.x o 2.x) o ImageMagik para generar y guardar la información de todas las imágenes (miniaturas, tamaño intermedio y tamaño completo).

Coppermine genera dinámicamente el código html necesario para mostrar las categorías, sub-categorías, álbumes e imágenes. Esto reduce drásticamente la cantidad de archivos y espacio que nuestra galería necesitaría utilizando HTML común. El script instalador (install.php) permite comenzar a utilizar la galería de una manera rápida y sencilla.

2. REQUERIMIENTOS

a) Un servidor web que soporte PHP.

b) Una base de datos MySQL.

c) Necesitaremos MySQL versión 3.23.23 o posterior. MySQL 4.1 es la recomendada, MySQL 5 es soportada. El usuario MySQL necesita tener permisos para CREAR, MODIFICAR, SELECCIONAR, ACTUALIZAR, BORRAR e INSERTAR información en la base de datos. La mayoría de los usuarios adquieren estos permisos cuando se alojan en un hosting. Si no poseemos estos permisos no podremos utilizar esta galería u otro script similar. Si tiene dudas sobre el estado de sus permisos confírmelos contactándose con su proveedor de hosting. La mayoría de estos proveedores podrán decirnos si Coppermine puede o no funcionar en sus servidores.
La base de datos debe estar creada para que Coppermine pueda usarla, el script instalador no la crea, pero sí creará las tablas y la estructura de datos por nosotros. La mayoría de los servicios de alojamiento web brindan, al menos, una base de datos ya configurada. De no ser así, necesitaremos crearla.  Hemos de tener a mano el nombre de la base de datos, el nombre de usuario y la contraseña ya que Coppermine necesitará estos datos para instalarse exitosamente.

d) PHP (versión 4.2.0 o posterior), compilado con soporte para la librería GD o permiso de utilizar la función exec() para la utilidad “convert” de ImageMagick, para poder crear las miniaturas y reducir las imágenes.

e) Una librería de imágen: GD versión 1.x o 2.x (PHP debe estar compilado para soportarla) o ImageMagick.

3. INSTALACIÓN Y CONFIGURACIÓN

3.1 Como instalar el script.

  • Descomprima el archivo manteniendo la estructura de los directorios.
    Puede renombrar el directorio Coppermine pero no los archivos ni los directorios dentro de éste.
  • Suba todos los archivos a su servidor web (asegúrese de utilizar el modo ftp correcto).
  • Utilizando el comando CHMOD establecemos los permisos a 755 (o 777, dependiendo de la configuración de nuestro servidor) a los directorios «albums» e «include» dentro de su directorio Coppermine. Este paso es muy importante y no debe ser pasado por alto!
  • Posea la información necesaria y correcta sobre su base de datos: Tenemos que saber la ruta (path) hacia el servidor de la base de datos (generalmente es ‘localhost’), el nombre de la base de datos como así también los detalles del usuario MySQL y contraseña con los que Coppermine debería conectarse con la misma. La base de datos y el nombre de usuario deben ya existir, y el usuario debe tener acceso a ella. Coppermine no creará la base de datos, pero creará las tablas necesarias durante la instalación; no hay necesidad que usted agregue ninguna tabla.
  • Ejecute el script instalador en su servidor: en la barra de dirección de nuestro navegador de internet escriba http://su_servidor/directorio_Coppermine/install.php y siga las instrucciones que aparecerán en la pantalla, escribiendo la información necesaria cuando sea solicitada. (su_servidor = su sitio web – directorio_Coppermine = el directorio en donde ha subido los archivos de Coppermine).

3.2 Estableciendo permisos

Coppermine necesita acceso de escritura a ciertos archivos y directorios en el servidor para poder realizar lo siguiente:

  • Durante la instalación, Coppermine necesita crear y escribir el archivo «config.inc.php» en el directorio «include» con el fin de almacenar la información necesaria de acceso a mySQL para ejecutar Coppermine y para crear y escribir el archivo «install.lock», también en el mismo directorio, para impedir que el instalador intente ejecutarse una segunda vez después de una instalación exitosa.
  • Al subir los archivos por HTTP, Coppermine necesita ir escribiéndolos en los subdirectorios que nosotros o nuestros usuarios hayan creado en el directorio albums de Coppermine.
  • Indistintamente del método utilizado para subir los archivos al servidor, Coppermine creará un archivo de miniatura y un archivo intermedio y los almacenará en un subdirectorio dentro del directorio albums.

Por defecto, los archivos y directorios en un servidor están protegidos contra escritura, así es que probablemente se deberán cambiar los permisos antes de la instalación, por los motivos antes mencionados. Es totalmente obligatorio que nosotros modifiquemos (CHMOD) estos permisos – o se presentarán problemas tarde o temprano.

Para ser capaz de establecer los permisos correctamente debemos comprender cómo funcionan: existen los permisos de read (lectura), write (escritura) y execute (ejecución) -abreviados como rwx– para cada archivo y directorio. Los permisos en un directorio padre se pueden propagar a un directorio hijo o a los archivos dentro de él, aunque también es posible evitar que los permisos no deseados se propaguen.

4. CONFIGURANDO COPPERMINE

Explicaremos en este apartado como se configura básicamente la Galería Coppermine en opciones visuales, formatos de imágenes, idiomas, y la creación de roles y usuarios.

Configuración general.

Pulsando en el Botón Configuración accederemos a un conjunto de posibilidades de configuración. Señalamos las que consideramos más importantes:

  • Configuración general.
    • Nombre de la Galería: 
    • Descripción de la Galería:
    • Correo-e del Administrador de la Galería=
    • URL de la carpeta de nuestra galería coppermine (sin ‘index.php’ o similar al final) =
    • URL de nuestra página de inicio= index.php
  • Visualización de lista de álbums.
    • El contenido de la página principal=breadcrumb/catlist/alblist/.
    • Aquí podemos elegir el número de columnas de álbums que se pueden ver. Por defecto son 2. Tres también puede ser un buen número pero cuatro columnas ya nos crea barras de desplazamiento horizontales.
      as categorías podar ordenarse e vos albums tamén. Cada un non seu menú.
  • Configuración de archivos y miniaturas:
    • Tamaño máximo de envío.
    • Ancho o alto máximo de miniaturas.
    • Auto-redimensionar imágenes que sean mayores del ancho o alto máximos. De esta forma nos aseguramos unos tamaños aceptables de imágenes ya que la aplicación redimensiona las imágenes enormes a un tamaño máximo de 800×800.
    • Configuración de archivos y miniaturas:
      • Método para el redimensionado o reescalado de imágenes: GD versión 2.x

4. INICIAR SESIÓN

Nos identificamos (log in) con el nombre de usuario y contraseña especificados durante la instalación (nombreweb/login.php)

Nos dirigimos al menú Configurar y comenzamos a configurar nuestra galería. 

5. FUNCIONAMIENTO.

La Foto Galería Coppermine (CPG) funciona de la siguiente manera:

a)  Los archivos son almacenados en álbumes.

b) Los álbumes están organizados en categorías.

c) Las categorías pueden ser jerarquizadas (en subcategorías).

Si no planeamos tener demasiados álbumes, no hay necesidad de utilizar las categorías. En ese caso no creamos categorías y todos nuestros álbumes aparecerán automáticamente en la página principal del script.

Existe, sin embargo, una categoría especial llamada «Mi Galería». Esta categoría no puede ser borrada. Si un usuario pertenece al grupo «puede tener una galería personal» y éste está establecido en SI, ese usuario tendrá la posibilidad de crear sus propios álbumes y su galería será una sub-categoría de «Galerías de usuario». De todos modos, este enlace no estará visible para los visitantes de nuestro sitio si no les permitimos a los usuarios subir imágenes y tener sus propios álbumes. El administrador puede crear álbumes en cualquier categoría. Los usuarios no-administrativos solo pueden crear álbumes en «Galerías de usuario/su_nombre_de_usuario». Además pueden renombrar la «Galerías de usuario» y su descripción. 

6. CATEGORÍAS
Las categorías van a ser contenedores de Álbumes. Es decir una Categoría no contiene imágenes, contiene álbumes que a su vez tendrán imágenes.

Para crear una categoría presionamos en el botón del mismo nombre, le ponemos un título y una descripción (si se quiere). Actualizamos. 

Podríamos hacer Categorías dentro de categorías pero no es aconsejable ya que estaríamos dificultando la navegación.

Se queremos hacerlo, simplemente tendríamos que seleccionar la Categoría madre y luego crear o colgar de ella la categoría hija.

Las categorías pueden eliminarse, editarse o cambiar el orden de aparición en la página de navegación.

7. CREACIÓN DE ALBUMES

Los álbumes serán los espacios para albergar las imágenes.

Pulsar en Archivos/Álbumes. Escoger una categoría y pulsar en nuevo álbum. Escribir su nombre. 

Aplicamos modificación y el nuevo álbum ya estará creado en la categoría correspondiente

Configuración y permisos

Ahora una vez creado el álbum, presionamos en la opción Álbum pero no en la de administración, sino en la de usuario. Ahora veremos todos los álbumes creados y en el botón propiedades vamos a configurarlos de manera que le podemos:

  • Cambiar categoría se fuera necesario.
  • Adjudicar una imagen de miniatura.
  • Dar permisos a los usuarios para subir imágenes.
  • Sin permisos de comentario.
  • Sin votación o valoración de imágenes

(VER GRUPOS/ROLES)

8. AÑADIR ARCHIVOS 

Pulsar en el menú Subir Archivo. Seleccionar el álbum adecuado y pulsar en el botón Explorar para localizar las imágenes en el disco duro o lápiz usb que se desean subir a nuestro Álbum.

En Configuración, método de reescalado de imágenes, seleccionar GD versión 2.x

Clic en “Añadir Fichero” para subir Imagenes desde el Disco Duro (PC) o enlazarlas desde la Web. Si se quiere subir imágenes desde la Web (Google Images, Flickr, etc.), basta con incluir las direcciones URL de las mismas. Una vez seleccionadas las imágenes a subir al servidor, clic en “Continuar”. 

6. EDICIÓN DE DATOS DE LAS FOTOS Y ÁLBUM AL QUE PERTENECE

Una vez subidas las imágenes, dentro de la carpeta pulsamos en editar archivos y podremos configurar las propiedades de cada foto. 

7. VISTA DEL ÁLBUM

Cuando estamos visualizando una foto de un álbum si pulsamos en la parte superior izquierda en «Presentación de diapositivas» podremos ver todas las fotografías. También podremos editar los datos de la fotografía o borrar los archivos. Dependiendo de la configuración del Coppermine, los usuarios podrán Valorar y/o Comentar las Fotografías.

8. COMENZANDO

 

Utilizamos las propiedades de un álbum para modificar su descripción y permisos.

Para que un usuario pueda subir archivos a un álbum, se deben presentar dos condiciones:

  • El usuario debe pertenecer a un grupo que pueda subir archivos.
  • Debe existir al menos un álbum donde la opción «Visitantes pueden subir archivos» haya sido fijada en «Si«, o que el usuario haya creado un álbum en las ‘galerías de usuarios’, si le fue permitido.

Lo mismo se aplica para valorar imágenes y para publicar comentarios.

Si hemos instalado el script exitosamente pero está teniendo problemas para hacerlo funcionar correctamente, podemos habilitar el modo depuración (debug mode) en la página Configuración. En este modo, el script muestra la mayoría de los mensajes de error producidos por PHP. Esto proporciona valiosa información para poder comprender qué es lo que está mal.