Coppermine Photo Gallery v1.5.x: Documentación y Manuales
Tabla de contenidos
Selección de idioma para la documentación
Documentación de Coppermine
Sobre Coppermine
Acerca de la documentación
Convenciones de la documentación
Características
Guía rápida
Tabla de contenidos
Requisitos mínimos
Requisitos mínimos del servidor
Servidor Web
Soporte de PHP
Base de datos mySQL
Librería gráfica
Actuar de servidor Web & Servidor Web
Requisitos para el servidor personal
FAQ de los requisitos
Pruebas (versiones alfa/beta)
No hay soporte para versiones alfa o beta
Áreas que merecen atención
Funcionalidades
El formato del informe
Disponibilidad
Idiomas
Cómo funcionan los idiomas en Coppermine
Quitar un idioma en particular
El inglés como idioma por defecto (Language fallback)
Ámbito de la internacionalización
El gestor de idiomas
Controles
Columnas
Por defecto
Nombre del idioma
English
Native
Custom
Flag
Language file
Available
Complete
Enabled
Guía de traducción
¡Se necesitan traductores!
¿Por qué traducir?
De qué idiomas se necesitan traducciones?
¿Quién puede traducir?
Juegos de caracteres
Editores & herramientas
Sólo ficheros completos
Paso a paso
Aspectos especiales
Versiones de los idiomas
Trabajo continuado
Traducciones básicas para empezar
Uso de ficheros de idioma antiguos
Traducir la documentación
Pasoa para traducir los documentos a tu idioma
Asegúrate de que la traducción no existe ya
Crea la estructura
Copia los ficheros tal cual están
Empieza a traducir
Áreas en las que poner atención
Cuidado con la tabla de contenidos
Empaqueta y comprime tu traducción
Para saber más
Créditos
Equipo de Coppermine
Contribuciones
Traductores
Ficheros de idioma
Documentación
Uso de código libre
Reconocimientos
Many Thanks
Licencia & derechos de autor
Derechos de autor
Licencia
Versiones anteriores
Términos añadidos a la licencia
Conservación de las atribuciones de autoría
Diferenciación de versiones modificadas
Libertad
Problemas conocidos
Instalación y configuración
Cómo instalar Coppermine
Qué hace el instalador
Información relacionada
Configuración del servidor
register_globals
Permisos
Permisos en diferentes tipos de servidores Web
Apache sobre Unix/Linux (CHMOD)
Basicos
Grupos en Linux
El servicio del Webserver
Aritmética binaria
¿Para qué vale esto?
Aplicación FTP
Panel de control del sitio Web
Acceso por shell
Apache sobre Windows
IIS en Windows
Preguntar a soporte sobre problemas de permisos
Permisos de los directorios
La pantalla de instalación
La pantalla clásica de instalación
El asistente de instalación
Auto-Instaladores
FAQ de la installación
Desinstalar
Actualizar la versión
¿Por qué actualizar?
Motivos para sacar paquetes de actualización
Log de cambios (Changelog)
Pasos necesarios para subir la versión de Coppermine (para cualquier versión)
Acciones adicionales para algunas versiones
Actualizar desde las versiones cpg1.0,1.1,1.2.x or 1.3.x a cpg1.5.x
Actualizar desde cpg1.4.x a cpg1.5.x
Plugins
Tempas pessonalizados
Ficheros de idioma
Cifrado de la contraseña
Mostrar las preguntas frecuentes
Ficheros obsoletos
Modo seguro
Actualizar desde versiones cpg1.5.x to a la más reciente
El script de actualización
Qué hace
Propósito
Permisos de ejecución
¿Cuándo hay que ejecutar la actualización?
Herramienta de comprobación de versiones
Qué hace
Primera ejecución
Opciones
Salida
Mostrar sólo los posibles errores
Ocultar imágenes
No comprobar los ficheros modificados
No conectar al repositorio online
Salida de la comprobación
Ruta
Falta
Permisos
Versión
Revisión
Modificado
Comentario
Enlace al repositorio
Qué podría fallar al usar versioncheck
Falsas expectativas
FAQ del cambio de versión
Volver desde cpg1.5.x a una versión anterior
En marcha
Conceptos básicos
Configuración inicial
Estructura de categoría/álbum/archivo
Imágenes reescaladas
Miniaturas
Intermedias
Originales
Configuraciones de reescalado recomendadas
Sin ventanas emergentes con la imagen a tamaño completo
Con ventanas emergentes de tamaño completo con máximo ahorro de espacio
Configuración "normal" con uso de espacio moderado
Tu cuenta de administración
Comprobar las cargas
Considera enlazar (bridging)
¿Qué permites a los visitantes?
Cambia el diseño de tu galería
Configuraciones típicas
Un usuario carga, los demás no interaccionan (galería monolítica)
Un usuario carga, los demás actúan también
Varios/muchos cargan, pero no se permiten usuarios nuevos (grupo cerrado)
Preguntas frecuentes
Puesta en funcionamiento / Configuración
Añadidos / Modificaciones / Hacks
Foro de soporte de Coppermine (Coppermine Support board)
Temas
Temas incluidos en Coppermine
Actualizando tu tema personalizado
Conversión de temas de cpg1.4.x a cpg1.5.x
Edita style.css
Edita template.html
Edita theme.php
Metodología de validación
Contenido de un tema
Editar template.html
Tokens del modelo
Importante
Lista de tokens en template.html
Editar style.css
Herramientas
Uso de Web Developer Toolbar
Editor
Lista de las clases en style.css
Hojas de estilo adicional
Editar theme.php
Tipos de entradas
El tema sample - un modelo del que copiar
Método
Alcance
Lista de entradas in theme.php
Ejemplos de temas
Contenido adicional
Contenido adicional en la página de miniaturas
Fila extra entre dos filas de miniaturas
Celda extra en cada página de miniaturas
Contenido adicional en la página de imágenes intermedias
Directly next to the intermediate image
Directly next to the film strip
Contenido adicional en la ventana emergente de tamaño completo
Resumen
How the theme engine works
Temas creados por los usuarios (contribuciones)
Vista previa de temas creados por los usuarios
Descargar estos temas
Instalarlos
Derechos de autor
Pedir soporte de estos temas
Contribuir con tu tema
Crear el tema personalizado
Renombralo primero
Trucos, pistas y todo eso
Uso de editores WYSIWYG
Cambiar colores
Crear un tema Coppermine que combine con el diseño general de tu sitio
Introducción
Prerequisitos
Herramientas
Conocimientos
Ejamplo
Escoge un tema similar a lo que quieres
Empieza a editar tu tema
Reemplaza el contenido del ejemplo con etiquetas placeholder
Adapta el estilo
Primera prueba
Editar template.html
Tokens del modelo
Importante
Lista de tokens en template.html
Editar theme.php
Tipos de entradas
El tema sample - un modelo del que copiar
Método
Alcance
Lista de entradas en theme.php
Editar style.css
Herramientas
Lista de las clases en style.css
Hojas de estilo adicional
Ejemplos de temas
Resumen
Añadir contenido
Contenido extra en la página de miniaturas
Fila extra entre dos de miniaturas
Celda extra en cada página de miniaturas
Contenido extra en las vistas intermedias (displayimage.php)
"Siguiente" directo a la imagen intermedia
"Siguiente" directo a la tira de imágenes (film strip)
Contenido extra en la ventana emergente de tamaño completo
Descarga de responsabilidad de los derechos de autor (Copyright-disclaimer) en el pie de página
Uso correcto
Juego sucio
Contenido dinámico (PHP-driven)
Usando anycontent.php
Cabeceras y pies de páginas personalizados
Contenido dinámico dependiente del tema (theme.php)
Modificando los ficheros básicos (core files)
Recursos gráficos de los temas
Iconos de menú
Barra de navegación de imágenes
Valoración de imágenes
Gráficos para la tira de película
Imagen de progreso de la carga (loader)
Administración
Entradas del menú
Mostrar / ocultar controles de administración
Aprobación de cargas
Configuración
Categorías
Álbums
Ordenar mis imágenes
Grupos
Usuarios
Expulsar usuarios
Mi perfil
Revisar comentarios
Mostrar postales
Añadir ficheros por lotes (Batch)
Herramientas de administración (Reescalar imágenes)
Gestor de palabras clave
Gestor de plugins
Gestor de enlaces / integración (bridges)
Ficheros de registro (logs)
Estadísticas generales
Comprobación de versiones
Actualizar la base de datos
Exportar
phpinfo
Mostrar novedades
Documentación
Modo de administración para usuarios normales
Entradas de administración en el manú para usuarios regulares
Expulsiones
¿Qué hay de nuevo?
Alcance
¿Cómo funciona?
Por qué no se recomienda expulsar una IP
Controlses de página
No usar cuando esté integrado
Pendiente
Configuración
Configuración general
Idioma y conjunto de caracteres
Temas (aspecto)
Lista de álbumes
Vista de miniaturas
Vista de imágenes
Comentarios
Formulario de contacto
Miniaturas
Archivos
Marcas de agua
Registro
Usuarios
Campos personalizados para perfiles de usuarios
Campos extra para descripción de imágenes
Cookies
Correo
Registro de sucesos y estadísticas
Mantenimiento
Restaurar valores de fábrica
Grupos
El panel de control de grupos
Nombres
Tipos
Cuota de disco
Permisos del grupo (Valorar/Postales/Comentarios)
Subida en álbumes públicos
Galerías personales
Método de subida
Assigned albums
Crear de grupos personalizados
Borrar de grupos personalizados
Lanzar sincronización (sólo para galerías enlazadas, bridged)
Pertenecer a más de un grupo
Usuarios
Panel de control de usuarios
Controles de la página
Buscar usuarios
Crear usuarios nuevos
Editar usuarios
Pertenecer a grupos
Contraseña perdida
Contraseña del usuario en Coppermine
Coppermine autónomo
Coppermine enlazado con otra aplicación
Contraseña en mySQL
Categorías
Panel de control de categorías
Controles de la página
Apartado superior "Ordenar categorías alfabéticamente"
Middle box "Gestionar categoría"
Apartado inferior"Actualizar/crear categoría"
La categoría especial "Galerías de usuario"
Álbumes
El gestor de álbumes
Crear álbumes
Renombrar álbumes
Cambiar el orden del álbum
Borrar álbumes
Modificar álbumes/archivos
Propiedades del álbum
Volver a las opciones por defecto
Administradores vs. usuarios
FAQ del álbum
Archivo
Editar archivos
Editar videos
Miniaturas personalizadas
Orden de las miniaturas
Tipos de miniaturas
Cargar miniaturas personalizadas
Cómo funciona
Nomenclatura
¿Porqué Coppermine no puede crear miniaturas para mis vídeos?
Instrucciones: paso a paso
FAQ de miniaturas personalizadas
Palabras clave
Asignación de palabras clave
Separador o delimitador de palabras clave
Editar/añadir palabras clave
Gestor de palabras clave
Palabras clave del álbum
bbCode
Propósito
Etiquetas bbCode disponibles
Peligros
Más control
Datos Exif
Qué es EXIF
Different flavors
How it works
No exif support on the server
Limitaciones
Gestor de datos EXIF
Plugins
¿Qué es un plugin?
El API de los plugin
¿Dónde conseguir plugins?
Plugins incluidos en Coppermine
Link Target (link_target)
Who is online? (onlinestats)
OpenSearch (opensearch)
Sample Plugin (sample)
User Gallery Alphabetic Tabbing (usergal_alphatabs)
Visible HookPoints (visiblehookpoints)
SEF_URLS plugin
El gestor de plugins
Subir un plugin
Instalar un plugin
Configurar de un plugin
Desinstalar un plugin
Escribir plugins
Rendimiento
Ajustes de configuración
General
Spiking
Ajustes en el servidor
Ajustes en PHP
Ajustes en MySQL
Herramientas de terceros
YSlow
Herramientas administrativas
Herramientas disponibles
Actualizar miniaturas y/o reescalar imágenes
Nombre de fichero → título del fichero
Borrar los títulos
Borrar las imágeness de tamaño original
Borrar las imágenes intermedias
Borrar archivos más antiguos que un número de días
Borrar los comentarios huérfanos
Borrar originales de las imágeness con marca de agua
Recargar la información de dimensiones y tamaño
Poner a cero los contadores de visitas
Convertir el separador de palabras clave
Uso
Errores
Error types
Errores leves
Errores graves
Errores no controlados
Error fatal
Activar la depuración en la configuración
Activar la depuración manualmente
Desactivar la depuración
Mensajes habituales de error
Mensajes relativos a la base de datos
Errores PHP habituales
Mensajes de error relativos a las cargas (subidas)
Códigos de respuesta del servidor web
Copias de seguridad
Copia de seguridad de ficheros
Completa
Parcial
Incremental
Copia de seguridad de la base de datos
¿Qué hay que copiar?
Herramientas
phpMyAdmin
mySqlDumper
mysqldump
mysqlhotcopy
Después de hacer la copia de seguridad de la base de datos
Mover tu galería
Mover en tu servidor Web
Mover de un servidor Web a otro
Desventajas de renombrar
Cambiar la URL de Coppermine en la configuración
Marcas de agua
Alternativas
Quitar el menú contextual
Mostrar el contenido más valioso sólo a los usuarios registrados
Display on overlay
Marcas de agua desde la máquina cliente
Subir ficheros
Subir ficheros por FTP / Añadir ficheros por lotes
Qué hace el "Añadir ficheros por lotes"
How batch-add works
Errores habituales
"Añadir ficheros por lotes" no funciona como se espera
Los ficheros parecen estar rotos o corruptos
No renombres
No borres
Ordenación
Las mayúsculas importan
Las máquinas tratan a los números de forma diferente
Cargar (subir) por HTTP
Interfases de carga
Basado en Flash, múltiples ficheros
Uso
Basado en HTML, un solo fichero cada vez
Uso
Asistente de publicación de Windows XP
Requisitos
Configuración
Subir imágenes
Estructura de ficheros
Quitar/desinstalar
Solución de problemas en las cargas
Permisos
Activar las opciones para la resolución de problemas
Pedir ayuda en problemas de subidas
Guía paso a paso para pedir soporte
Ejemplo de solicitud de soporte
Mensajes de error
Imposible mover x a y
fallo al abrir directorio: no existe el fichero o el directorio
Variable no definida: HTTP_POST_VARS
Lo siento, pero no hay ningún álbum al que puedas subir ficheros
Se ha gastado toda la memoria permitida
Exec() está desactivado
No es una extensión GD válida
Error al ejecutar ImageMagick - valor devuelto 127
El PHP que se ejecuta en tu servidor no soporta la biblioteca gráfica GD
¡No se subió ningún fichero! Si has seleccionado uno para cargar verifica que el servidor permite subidas
El directorio destino x no permite escritura por este script
Restricciones del servidor
El ficerho de configuración php.ini
Puntos para verificar
Mecanismos y métodos de subida
Uso de memoria durante el reescalado
Comentarios
Permitir comentarios
Opciones
Problemas de spam
Asistente visual (Captcha)
Aprobación
Akismet
Resumen
Revisar comentarios
Comentarios individuales
Enlace/Integración con otras aplicaciones (Bridging)
Qué hace el enlace
Archivos disponibles para el enlace
Prerrequistos
Autenticación por cookie
Primero la versión autónoma
Usuarios, grupos y archivos cargados por los usuarios que se pierden al integrar
Copia de seguridad
Pasos de la integración
Uso del gestor de enlaces
Escoge la aplicación con la que integrar Coppermine
Ruta(s) usadas por la aplicación integrada
URL de la aplicación integrada
Ruta absoluta de la aplicación integrada
Ruta relativa al fichero de configuración de la aplicación integrada
Prefijo de la cookie
Configuración específica de la aplicación integrada
¿Usar los grupos personalizados en la aplicación integrada?
Activar/Desactivar la integración
Recuperar desde una integración fallida
Sincronizar los grupos de la aplicación integrada con los de Coppermine
Soporte de la integración
Algunas opciones de configuración están deshabilitadas
Archivos de la integración
Crear un archivo personalizado de la integración
Filosofía de la integración
A tener en cuenta:
phpBB3
PunBB1.1.5
PunBB1.2
XMB
Subdomain issues
File system
Cookies
www-subdomain
Documentación para los desarrolladores
Adding/renaming/removing files
Target audience
Scope
Naming conventions
Adding files
Language files
Renaming files
Deleting files
Coding guidelines
Target audience
Scope
Indentation
Encoding
General guidelines
PHP code
Formatting
Control Structures
Function Calls
Function Definitions
PHP Code Tags
Nesting of HTML in PHP
Line breaks
Naming Conventions
Database queries
Documentation
HTML output
Image-tags in HTML output
Links in HTML output
Form elements in HTML output
Deprecated tags
Prefered tags
Credits for coding guidelines
Usability
Forms
Config options
Target audience
History
New features
Step by Step
Basic.sql
Update.sql
Admin.inc.php
Language file
Documentation
To Do
Database schema
Configuration file
Database reference within coppermine code
cpg15x_albums
cpg15x_banned
cpg15x_bridge
cpg15x_categories
cpg15x_categorymap
cpg15x_comments
cpg15x_config
cpg15x_dict
cpg15x_ecards
cpg15x_exif
cpg15x_favpics
cpg15x_filetypes
cpg15x_hit_stats
cpg15x_languages
cpg15x_pictures
cpg15x_plugins
cpg15x_sessions
cpg15x_temp_messages
cpg15x_usergroups
cpg15x_users
cpg15x_votes
cpg15x_vote_stats
Editing the documentation
Target audience
Edit existing documents
Add new documents
Moving content from one document to the other
Hidden features
Database structure
Header & footer blocks
Documentation internationalization
Expandable/collapsible "detail"-blocks
Help
Start and end anchors needed
Adding anchors to headings
Code
CSS class "code"
HTML-tag "pre"
CSS class "cpg_code"
CSS class "smallcode"
HTML-tag "textarea"
Combining HTML tags and CSS classes
No syntax highlighting
Javascript in Coppermine
Target audience
Javascript files location and organization
TODO
How to include javascript files
How to include JavaScript files in plugins
How to pass PHP variables to included javascript
Autostart JavaScript
Packaging a new release
Target audience
Subversion repository
Steps
Check out
Replace version number in all files
Linux
Windows
Remove Byte Order Marks
Prepare an announcement thread
Edit the upgrade section of the docs
Edit the changelog
Edit the version number
Commit your changes
Update the versioncheck data
Completeness
Update revision numbers and hashes
Update cpg15x.files.xml on the Coppermine home page
Export from subversion
RapidSVN
Tortoise SVN
Create the archive
Upload the archive
Publish announcement thread
Create news items
News item on sf.net
News item on forum
News item on home page
News embedded into existing galleries
Update the demo
Plugin Writing for Coppermine
Quick Start Guide
Intended Audience
People who should read this documentation
People who do not need to read this documentation
Why write plugins?
Preparations
Choose a name
Consider translations
Consider a config screen
Database changes
Support issues
Plugin versions
Core files
Naming conventions
Folders
Files
Archives
Coding
Use of Superglobals
Database access
Direct queries
Accessing database tables
Creating database tables
Deleting database tables
Storing your plugin's config values
Plugin Types
Using includes
Plugin Writing: Tutorial, API
Intended Audience
Required Skills & Knowledge
Recommended Software & Support Forums
"Hello, world" Plugin Tutorial
My First Plugin
Installation, Configuration, and Clean-Up
Installation with Simple Configuration
Installation with Configuration Parameters
Configuration during Operation
Uninstallation & Clean-Up
Linking to Custom Plugin Scripts
Adding a Button to Coppermine
Adding a Button to the admin menu
Adding a Button to the overall menu
Adding JavaScript to plugins
Multi-language Support
Distributing Your Plugin
Plugin Hooks
Plugin Class Properties & Methods
Global Variables & Constants
Reference list of plugin hooks
Target audience
Choosing Plugin Hooks
Finding Plugin Hooks
Plugin Hooks by File Name
Script: index.php
Filter: 'anycontent'
Filter: 'user_caption_params'
Filter: 'plugin_block'
Script: displayimage.php
Filter: 'file_info'
Filter: 'post_breadcrumb'
Script: thumbnails.php
Filter: 'post_breadcrumb'
Script: functions.inc.php
Filters: 'gallery_header' and 'gallery_footer'
Filter: 'thumb_data'
Filter: 'template_html'
Filter: 'page_meta'
Filters: 'thumb_caption' and all derivatives
Script: themes.inc.php
Filter: 'file_data'
Script: usermgr.php
Filter: 'usermgr_header'
Filter: 'usermgr_footer'
Script: pluginmgr.php
Filter: 'plugin_configure'
Filter: 'plugin_cleanup'
Script: plugin_api.inc.php
Filter: 'page_html'
Filter: 'page_end'
Filter: 'plugin_install'
Filter: 'plugin_uninstall'
Filter: 'plugin_wakeup'
Filter: 'plugin_sleep'
Script: init.inc.php
Filter: 'page_start'
Script: picmgmt.inc.php
Filter: 'add_file_data'
Plugin Hooks Alphabetically
Plugin Hooks by Hook Type
Plugin Hook Examples
Adding an upload method
Add tags for thumbnails display
Sanitization of Superglobals using Inspekt
Target audience
What's new?
Reason
What Inspekt does
Inspekt accessor methods
How to use Inspekt with Coppermine Photo Gallery
Using Inspekt
Inspekt in Coppermine
Consider the methods to use
Examples
Regular Expressions
Links
Subversion
Target audience
Caveats
What is subversion?
Where is the subversion repository hosted?
Recommended software
Alternative access using Web SVN
Repository structure
Coppermine core files
Plugins
Checking out
Checking out the entire repository
Checking out a particular Package
Checking out a particular file
Refering to files downloaded from the subversion repository
Is there no single package that I could download instead?
Download Tarball archives
Developers-only
Check out before checking in
Committing your code
Changelog
Obtaining write access
Step by step
Download the client application
Initial checkout
Revisions
Subversion file headers
Tools recommended by the devs
Database manipulation
FTP clients
Web development
Text editors
Picture Editors
Updating
Target audience
Hidden feature
Variables & Constants
System Global Variables
Coppermine Constants
Versioncheck
Hidden features
XML structure
To do list