# Coppermine Photo Gallery v1.5.x: Documentación y Manuales

# Sobre Coppermine

Coppermine Photo Gallery es una galería de fotos avanzada, de fácil uso y con soporte para otros tipos de archivos (media/datos). La galería puede ser privada, accesible solo a usuarios registrados o disponible para todos los visitantes de su sitio web. Si el administrador lo permite, los usuarios pueden subir imágenes a través de su navegador (se crean en el momento de la subida miniaturas e imágenes de tamaño intermedio), valorarlas, agregar comentarios e incluso enviar postales. El administrador de la galería Coppermine (en adelante lo dejaremos en "el administrador") 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 almacenados en álbumes y los álbumes pueden estar agrupados en categorías, las cuales, a su vez, pueden agruparse bajo categorías padre. El script soporta múltiples usuarios y provee al administrador de las herramientas necesarias para determinar qué grupo de usuarios puede o no puede realizar distintas acciones, como por ejemplo: crear álbumes personales y cargar imágenes en ellos (o borrarlas), enviar postales, escribir comentarios, valorar las imágenes, etc. Los usuarios también pueden subir imágenes a los álbumes públicos si el administrador lo admite.

Coppermine posee un sistema de selección de temas (aspecto visual) por parte del usuario y varios temas pre-instalados. También admite el uso de múltiples idiomas y contiene su propia biblioteca idiomática. Esto permite que sus usuarios usen 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 su galería necesitaría utilizando HTML estándar. El script instalador (install.php) instala y permite comenzar a utilizar la galería de una manera rápida y sencilla.

Coppermine usa la biblioteca JavaScript/Ajax jquery para enriquecer la experiencia del usuario y ser más flexible en su personalización.

Coppermine es una aplicación software de código abierto y libre, que se puede usar tanto en sitios Web personales como comerciales. Se usa bajo los términos de licencia GNU GPL license, versión 3, aprobada por el OSI.

## Acerca de la documentación

Utiliza el menú en la parte superior izquierda de esta pantalla para navegar por la documentación Coppermine. Está disponible en todas las páginas de la documentación. El menú usa JavaScript - si JavaScript está desactivado o no lo puedes utilizar por cualquier razón, utiliza el enlace situado en la parte superior que te llevará a la tabla de contenido y de allí a la sección de la documentación que deseas leer.

El equipo de desarrollo de Coppermine recomienda habilitar JavaScript y el uso de un navegador moderno (con CSS y JavaScript de acuerdo a los estándares DOM) para leer la documentación con una experiencia de usuario mejor.

### Convenciones de la documentación

#### Los cuadros de texto

Hay cuadros de texto en esta documentación que tienen un significado especial:

Los ejemplos que pretenden ilustrar las instrucciones se muestran de esta manera

Así sale la información adicional que no debe pasarse por alto.

Las pistas que llevan a una visión mayor en los mecanismos de Coppermine o que te ayudarán a aplicar mejor las características se encuentran detalladas en cuadros como éste.

Los avisos sobre de lo que puede ir mal si se produce un error se muestran de esta manera. Es recomendable prestar mucha atención a la explicación de estas cajas.

Así se muestra lo que puede salir mal en función de la interacción o los datos introducidos por el usuario.

Los errores o cuestiones que pueden tener un enorme impacto se enseñan así. Este es el tipo más grave y es muy importante leer su contenido.

Los trozos de ejemplos de código (puede ser PHP, HTML, CSS o JavaScript) salen con el icono de la máquina de escribir delante de ellos.

#### Enlaces

Todos los enlaces "normales" (que no tienen un icono especial situado al lado) son internos, es decir, se refieren a una parte de esta documentación, por lo que te permiten navegar por ella. La excepción a esta regla son:

- ##### Secciones plegables / desplegables

  Hay algunas secciones que se pueden expandir y contraer (si está activado JavaScript en el navegador) para facilitar la lectura. Por lo general, las secciones ampliables contienen detalles sobre el párrafo anterior. secciones ampliables se marcan con un pequeño cuadrado con un "+" ( ) cuando están plegadas y un cuadrado con un "-" ( ) si están desplegadas. Si está desactivado JavaScript todos los textos estarán desplegados - pulsar en los iconos no hace nada.

- ##### Enlaces externos

  Los enlaces externos que llevan a una página fuera de esta documentación están seguidos por un pequeño icono de una ventana con una flecha: .

- ##### Documentación PHP

  Como Coppermine es una aplicación PHP, dentro de la documentación hay una serie de referencias que relacionadas con los términos técnicos de este lenguaje de programación. Los vínculos con un pequeño icono de PHP ( ) conducen a las secciones dentro de la documentación oficial de PHP en php.net que contienen más información o definiciones del término que se trate.

- ##### Anclas

  En todas las páginas dentro de la documentación Coppermine encontrarás iconos de anclaje ( ) junto a muchos de los títulos del párrafo. Se pueden pulsar y apuntan exactamente al párrafo que sigue. Su finalidad principal es facilitar el soporte: si en una respuesta de soporte del foro alguien quiere hacer referencia a una sección particular de la documentación desde su respuesta, fácilmente pulsa el botón derecho derecho y "Copiar enlace directo" dentro de la documentación oficial de Coppermine y pega ese enlace en su respuesta. Para tí como usuario final las anclas puede ser útiles si deseas añadir a favoritos en el navegador una sección particular de la documentación.

## Características

Coppermine viene con muchas características. A continuación hay una lista incompleta. Las características que son nuevas en cpg1.5.x (comparado con cpg1.4.x) llevan la marca correspondiente.

Detalles

- Instalador
  - instalador sencillo (página de instalación)
  - Asistente de instalación mejorado (cpg1.5.x)
- Registro y validación de usuarios
  - opción para mostrar los términos y condiciones de uso (cpg1.5.x)
  - opción de configuración para usar contraseña global para la función de registro (cpg1.5.x)
  - confirmación visual (captcha) for registration (cpg1.5.x)
  - verificación de la dirección de correo electrónico (enlace de activación de cuenta)
  - Reenviar enlace de activación (cpg1.5.x)
  - aprobación del registro de usuario por el administrador
  - notificación del registro de usuario al administrador
  - creación de álbumes personales al registrarse opcional (cpg1.5.x)
  - el usuario puede borrar su cuenta (cpg1.5.x)
  - entrada con nombre de usuario o dirección de correo (cpg1.5.x)
- Gestión de usuarios
  - administración de usuarios (galerías privadas, grupos)
    (NdelT: Quizá falta un li) Los visitantes pueden registrarse (si el administrador lo permite). Como alternativa, el administrador puede crear cuentas de usuario.
  - La gestión de usuarios basada en grupos
  - Los permisos se gestionan/asignan por grupos
  - Enlace con otras aplicaciones: la gestión de usuarios se integra con diferentes BBS (como phpBB, YaBB SE, SMF, InvisionBoard, vbulletin)
  - configurable con bbs mediante un asistente (gestor de integración)
  - pertenencia a varios grupos
  - más campos del perfil del usuario configurables por el administrador
- Gestión de categorías y álbumes
  - disposición de las imágenes en categorías, sub-categorías (opcionales) y álbumes
  - los usuarios pueden crear álbumes en las categorías permitidas por el administrador (cpg1.5.x)
  - Nueva jerarquía de categorías (cpg1.5.x)
- Subida (carga) de ficheros
  - los usuarios pueden subir fotos y archivos con interfaz web (y el administrador además puede subir mediante FTP y agregar por lotes a la base de datos)
  - creation of thumbnails and intermediate size pics
  - Descripciones breves, título, descripción larga y campos definidos por el administrador NdelT por el usuario? para cada imagen (se usan en las búsquedas)
  - notificación al administrador de carga de ficheros pendientes de aprobación
  - rotación de imágenes
  - Subida de varios archivos
  - opción para elegir el alto o el ancho máximo para las miniaturas hace más agradable la página de miniaturas
  - Reescalado de imágenes en la carga
  - vista previa de miniaturas durante la carga por lotes opcional (cpg1.5.x)
  - mensaje de tipos de archivos permitidos en la pantalla de carga (cpg1.5.x)
  - gráfico animado en la pantalla de carga para indicar el progreso (cpg1.5.x)
  - Los caracteres no latinos en los nombres de archivo se reemplazan con la transliteración si es posible (si no lo es, con guión bajo) para crear nombres de archivo compatibles con la Web, independientemente de las habilidades de usuario (cpg1.5.x)
- Visualización de imágenes
  - Meta albums:
    (NdelT: quizá falta un punto) el administrador puede especificar qué álbumes virtuales se pueden utilizar para proporcionar otros métodos para navegar por la galería o "puntos de vista":
    - Últimos comentarios
    - Últimos archivos añadidos
    - Imagen al azar
    - por fecha de carga (cpg1.5.x)
    - Los más visitados/vistos
    - Los más valorados
    - Favoritos
  - presentación de diapositivas
  - opción para mostrar una tira de película de las miniaturas (navegable) debajo de la imagen
  - opción para poner marcas de agua en la imagen (cpg1.5.x)
  - Recorte y mejora de nitidez de las miniaturas (cpg1.5.x)
- Interacción del usuario
  - comentarios de los usuarios
  - aprobación del comentario opcional (cpg1.5.x)
  - confirmación visual (captcha) en los comentarios (cpg1.5.x)
  - uso del filtro Akismet (cpg1.5.x)
  - promoción del registro en la sección de comentarios (cpg1.5.x)
  - postales
  - soprte de Flash en las postales (cpg1.5.x)
  - opción de selección de idioma en la plantilla
  - Álbumes protegidos con contraseña
  - Votar/Valorar
  - optional visualización opcional de la clasificación en la pantalla de miniaturas (cpg1.5.x)
  - opciones personalizables del voto, y basadas en Ajax (cpg1.5.x)
  - optional Formulario de contacto con captcha (cpg1.5.x)
  - los usuarios pueden informar de contenido inapropiado o fuera de lugar al administrador
  - favoritos: los visitantes pueden añadir imágenes a sus favoritos para futuras visitas
- Estadísticas
  - exhibición pública de número de imágenes, opiniones y últimos ficheros
  - Estadísticas del navegador y sistema operativo de los usuarios para el administración (cpg1.5.x)
  - Estadísticas totales (cpg1.5.x)
  - contador de visitas por álbum (cpg1.5.x)
  - Las estadísticas públicas se pueden desactivar (cpg1.5.x)
- Búsqueda
  - búsqueda avanzada (operadores booleanos)
  - expresiones regulares en las búsquedas (cpg1.5.x)
  - navegación mediante palabras clave
  - nube de etiquetas (cpg1.5.x)
- Administración
  - Herramientas de administración
  - autenticación básica para el script de actualización (cpg1.5.x)
  - reinicio individual al valor por defecto para distintas opciones de configuración (cpg1.5.x)
  - Los archivos subidos pueden ser desaprobados por el administrador para ocultarlos temporalmente (cpg1.5.x)
  - opción de expulsión directa en la pantalla de aprobación de comentario (cpg1.5.x)
  - pantalla de gestión de usuarios con criterios adicionales (interacción del usuario con la galería) (cpg1.5.x)
- Plugins
  - API de plugins para permitir la creación de mejoras aportadas por los usuarios
  - multitud de plugins disponibles
  - Gestor de plugins
- Documentación
  - función de ayuda en línea para las páginas de administración
  - icono de ayuda bbcode en los comentarios (cpg1.5.x)
  - documentación de administración completamente disponible
  - documentación en varios idiomas
  - documentación dividida en secciones para facilitar la lectura (cpg1.5.x)
- Misceláneo
  - información de la foto almacenada en base de datos
  - soporte multimedia
  - en varios idiomas
  - Inglés como idioma por defecto (fallback) si hay alguna opción no traducida en los archivos de idioma
  - todas las características personalizables con interfaz web (sección de administración)
  - soporta EXIF/IPTC
  - Las URL se refieren a las posiciones absolutas en lugar de las relativas para mejora de uso por los motores de búsqueda (cpg1.5.x)
  - API de Coppermine para ser utilizado con aplicaciones como Koppermine y otros (cpg1.5.x)
  - sección de noticias para el administrador para alertarlo acerca de las actualizaciones (cpg1.5.x)
  - uso de Inspekt para la desinfección de las superglobales, una herramienta para crear aplicaciones PHP seguras (cpg1.5.x)
  - control granular para el acceso de invitados: no tiene acceso, solamente a miniaturas, sólo miniaturas e intermedios, todos los tamaños (cpg1.5.x)
  - Evitar que los motores de búsqueda indexen meta-álbumes (cpg1.5.x)
- Apariencia visual
  - sistema de plantillas/temas
  - separación del 'breadcrumb block' para colocarlo independiente de la categoría en la plantilla
  - opción para mostrar el primer nivel de álbumes de una categoría en lugar de sólo estadísticas de la categoría
  - opción de mostrar u ocultar el icono de "privado" a los invitados y usuarios sin privilegios
  - opción para enviar a los usuarios directamente desde la miniatura a la imagen a tamaño completo en una ventana emergente (cpg1.5.x)
  - enlace de descarga de películas opcional (cpg1.5.x)
  - colores de filas alternos en tablas (cpg1.5.x)
  - nube de etiquetas/palabras clave opcional (cpg1.5.x)
  - barra lateralpara facilitar la navegación (cpg1.5.x)
  - tira de película ajax (cpg1.5.x)

## ¿Por dónde sigo?

Hay unas páginas en esta documentación con las que deberías empezar:

- Guía de Inicio Rápido
- Requisitos mínimos
- Pruebas (¡versiones alfa/beta!)
- Idiomas
- Créditos
- Licencia y derechos de autor
- Problemas conocidos