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

Tabla de contenidos

Actualizar

Ten en cuenta: como se han producido cambios tanto en los archivos de Coppermine como en la base de datos en la versión cpg1.5.x, los usuarios de versiones anteriores a cpg1.5.0 tendrán que aplicar todos los pasos mencionados a continuación: tienes que sustituir los archivos y has de ejecutar el script update.php una vez.

¿Por qué actualizar?

Hay versiones 'mayores' y 'menores' de Coppermine. Las versiones principales han sido hasta ahora cpg1.0, cpg1.1, cpg1.2.x, cpg1.3.x, cpg1.4.x y cpg1.5.x. La próxima versión 'mayor' o actualización será cpg1.6.x (actualmente se encuentra en fase de desarrollo y no hay fecha prevista de salida). Los lanzamientos de menor importancia (el tercer número, según el esquema de la versión), también llamados "revisiones" o "versiones de mantenimiento", representan actualizaciones. Una nueva versión tiene nuevas características (en comparación con la versión anterior), y las versiones de mantenimiento llevan correcciones de errores y pequeñas mejoras (como archivos de idioma nuevos).

Para entender la política de difusión del equipo de desarrollo Coppermine tienes que entender cómo se solucionan los problemas: mantenemos un repositorio en el que el núcleo de código de cada versión importante se perfecciona continuamente. Los errores que se reportan en el foro de soporte de Coppermine, grandes y pequeños, se arreglan y guardan en dicho repositorio. Una vez que se manda hacer un paquete todas las correcciones que se han hecho entran en la nueva versión de mantenimiento.

Hay una buena razón para sacar una nueva versión de mantenimiento: por lo general arreglan un error crítico o una vulnerabilidad de seguridad. Como ya se ha dicho hay otros errores menores que entran en cada nueva versión, no sólo el error crítico o la vulnerabilidad que condujo a la liberación del paquete. Por lo tanto, no arreglará sólo la vulnerabilidad que ha sido el motivo inicial para liberar este paquete. Por eso siempre interesa actualizar a la versión estable más reciente tan pronto como se anuncia.

Motivos para sacar paquetes de actualización

Esta es la lista de lanzamientos de menor importancia de cpg1.5.x y la razón por la que han salido. Tiene el propósito de explicar por qué deberías actualizar lo antes posible la versión estable más reciente, si estás ejecutando una versión antigua.

Detalles
Paquete Razón de la liberación Fecha
cpg1.5.24
  • Maintenance release (stable)
  • Announcement thread
  • More precise database query times in debug output (thread)
  • Fixed album drop-down box options for guests (thread)
  • Display maximum allowed file size when using the Flash-driven uploader
  • Updated packaging docs
  • Fixed edit files button next to public albums if user isn't allowed to create albums, but can upload files (thread)
  • Fixed registration process if "personal_album_on_registration" is enabled (related to thread)
  • Added Persian language file (user contribution)
  • Fixed possible missing parameter error during registration process (thread)
  • Fixed PHP notices during install (thread)
  • Don't check unsupported/disallowed file types at the batch-add upload form (thread)
  • Merged missing code changes of error message support for the batch add process
  • Added Windows 8 support to statistic details page (thread)
  • Added support for Internet Explorer 9 & 10 to statistic details page (thread)
  • Fixed accent issues on keyword manager (thread)
  • Added IP address to security log (thread)
  • Added missing plugin hooks to theme 'curve' (thread)
2013-05-22
cpg1.5.22
  • Maintenance release (stable)
  • Announcement thread
  • Re-arranged packaging steps in English docs
  • Select newly created database during Coppermine installation
  • Changed icon for 'retry' button on installer
  • Fixed 'album has been locked for editing' message for secondary group memberships (thread)
  • Updated Italian language file (user contribution)
  • Updated Brazilian language file (user contribution)
  • Moved comparison from several places to function 'cpg_picture_dimension_exceeds_intermediate_limit'
  • Fixed "newer/older than" search feature
  • Fixed handling of intermediate-sized files in admin tools and during upload (thread)
  • Fixed named anchors in plugin manager
  • Fixed several table width layout issues
  • Fixed several possible MySQL permission issues for bridged galleries
  • Fixed error message 'undefined function gettext()' when using EXIF library (thread)
  • Added plugin hook 'upload_file_name' to batch-add interface
  • Prepared code for user cookie consent (thread)
  • Also reset album views when "Reset view counters" is chosen at the admin tools (thread)
  • Strip unneeded EXIF data before storing it in the database (thread)
  • Updated Danish language file (user contribution)
  • Fixed predefined album name when editing albums at the album manager
  • Added hidden feature to set sort order of albums (thread)
  • Replaced special HTML entities with characters on email subject (thread)
  • Fixed "My gallery" view for user admin mode
  • Made debug output W3C conform (thread)
  • Optimized function 'get_pic_pos'
  • Added hidden feature to toggle the display of the sort buttons on the thumbnail page
  • Use correct language flag for Luxembourgish language file (thread)
  • Order pictures by 'ctime' instead of by 'pid' (thread)
  • Optical improvement of dropdown box at batch-add interface (thread)
  • Fixed typo in French language file (thread)
  • Don't list administrator and guest groups in category manager's "allowed to create albums" dropdown box
  • Hide upload button for guests with upload permission if there's no album with uploads enabled
  • Hide "My gallery" button for guests (thread)
  • Fixed typo in Swedish language file
  • Added form token check to flash uploader (thread)
  • Fixed upload for guests (thread)
  • Fixed formatting of some help pages (thread)
  • Fixed performance issue on intermediate-sized view for large files (thread)
  • Added hidden config option to display all files after flash upload (thread)
  • Fixed album properties "Choose album" drop-down list for regular users
  • Updated docs to reflect changes of Subversion repository
  • Removed category hierarchy string from album drop-down box at several places
  • Removed possible category dupes from album drop-down box at several places (only occur in user mode)
  • Don't use pictures from password protected albums as user gallery icon (thread)
  • Unified album drop-down boxes (thread)
  • Fixed check if user is allowed to edit files in public albums
  • Added button if user is allowed to edit files in public albums (thread)
  • Fixed album ownership of automatically created user albums during user registration (thread)
  • Updated header information to reflect new year
2013-01-11
cpg1.5.20
  • Security release (stable)
  • Announcement thread
  • Disabled possibility to move albums to root level of user category (thread)
  • Fixed broken IP address lookup (thread)
  • Fixed email validation for registration process (thread)
  • Updated Serbian language file (user contribution)
  • Changed status in credits section to 'retired'
  • Updated Italian language file (user contribution)
  • Re-added 'search by owner name' checkbox to search form (thread, thread)
  • New feature: display only the uploaded files from the last queue after flash upload (thread)
  • Fixed behavior of "Show first level album thumbnails in categories" setting (thread)
  • Added plugin hook 'theme_album_params'
  • Fixed quota bar in user manager for secondary group memberships (thread)
  • Display default groups "Administrators" and "Registered" on modify user page (thread)
  • Moved code from usermgr.php to function 'cpg_get_groups'
  • Added Opera compatibility for rounded corners to theme 'curve' (thread)
  • Fixed error message at "Edit file information" form (thread)
  • Updated EXIF library (thread)
  • Fixed clickable keywords in file information box at intermediate view (thread)
  • Fixed search results when searching for specific characters (thread)
  • Fixed error message when activating more than one user in the user manager (thread)
  • Fixed different gallery behavior for register_globals on/off setting (thread)
2012-03-29
cpg1.5.18
  • Security release (stable)
  • Announcement thread
  • Added plugin hook 'upload_file_name'
  • Add default values on 'onlinestats' installation to avoid weird dates right after plugin installation (thread)
  • Updated Arabic language file (user contribution)
  • Fixed simple upload process when users can just upload to their personal gallery (thread)
  • Added upload button after each album name in album manager
  • Added anchors on plugin manager
  • Fixed infinite loop for delayed cookie issue workaround (thread)
  • Disallow dots in cookie name (thread)
  • Fixed issue with very big 'Max size for uploaded files' values (thread)
  • Fixed album thumbnails for public albums in 'My gallery' view for regular users
  • Fixed clickable keywords with spaces (thread)
  • Fixed critical error for 'lasthits' meta album (thread)
  • Fixed misleading error message when uploading files that exceed the file size limit with the simple upload form (thread)
  • Added hidden feature "Create sub-directory named according to the album ID in users' upload directories during HTTP upload"
  • Use selected album thumbnail for 'lastup' meta album (thread)
  • Create user album in personal gallery when user is created via the user manager (thread)
  • Added captcha for ecards feature (thread)
  • Fixed a potential path disclosure vulnerability in core plugin configuration files
  • Updated date/time formats in English (British) language file (thread)
  • Updated header information to reflect new year
2012-01-10
cpg1.5.16
  • Security release (stable)
  • Announcement thread
  • Fixed 'delete all comments' function in album properties
  • Fixed issue with registration process if both email verification and admin activation are enabled
  • Added plugin hook 'register_form_validate'
  • Fixed display of non-image files when 'Go directly from thumbnail to full-sized image' is enabled in config (thread)
  • Also send activation confirmation email if the user has been activated via the user manager (thread)
2011-09-01
cpg1.5.14
  • Maintenance release (stable)
  • Announcement thread
  • Fixed username in activation mail (thread)
  • Fixed version number displayed on the index page in the doc
  • Added Norwegian language file (user contribution)
  • Fixed album thumbnail for keyword albums without physical files when link_pic_count is disabled (thread)
  • Use the intermediate picture 'use dimension' setting when resizing full-sized pictures during the upload process
  • Fixed spelling of 'email' in German language files
  • Fixed validation of ImageMagick path in config
  • Added missing jump label 'top_display_media' to theme 'eyeball' (thread)
  • Fixed PHP notices 'Undefined variable' and 'Use of undefined constant' during install step 2 (thread)
  • Fixed some missing icons in help pages (thread)
  • Fixed detection of intermediate-sized pictures when renaming files (thread)
  • Added Serbian language file (user contribution)
  • Fixed embedding of SWF files (thread)
  • Fixed safe_mode check when sending emails
  • Fixed selection of gallery icon for user categories (thread)
  • Fixed display of random album thumbnail in sub-category if album keyword is set (thread)
  • Updated Turkish language file (user contribution)
  • Fixed user manager issue (thread)
  • Fixed several keywords issues (issues with ampersands and spaces, leftover keyword separators) (thread)
  • Fixed valid token issue during logout (thread)
  • Display exact character encoding in config (thread)
  • Fixed permission issue if admin tries to create a personal album (thread)
  • Fixed batch-add issue if no file is selected (thread)
  • Fixed visibility issue when setting an album password with IE (thread)
  • Fixed admin tools format in eyeball theme (thread)
  • Fixed thumbnail pages dropdown list on album list (thread)
  • Adjusted part of documentation to reflect cpg1.5.x code change (thread)
  • Fixed critical error message for meta album 'lastalb' if thumbnail image doesn't exist (thread)
  • Fixed first level album thumbnails if thumbnail image doesn't exist
  • Moved memberlist button to home menu drop-down for theme 'curve' (thread)
  • Added workaround for delayed cookie issue during login (thread)
2011-08-01
cpg1.5.12
  • Security release (stable)
  • Announcement thread
  • Fixed film strip issue (thread)
  • Fixed indent for subcategories (thread)
  • Fixed function 'utf_replace' (thread)
  • Updated Portuguese language file (user contribution)
  • Fixed custom thumbnail for files with uppercase extension (thread)
  • Fixed memberlist issue when database name contains a dash (thread)
  • Fixed colspan for guest comments when captcha is enabled (thread)
  • Fixed PHP session name for captcha (thread)
  • Fixed playback of Windows Media Player videos (thread)
  • Fixed XSS issues (thread)
2011-01-02
cpg1.5.10
  • Maintenance release (stable)
  • Announcement thread
  • Fixed default page when comments are sorted in descending order (thread)
  • Fixed issue with plugin usergal_alphatabs when bridged (thread)
  • Added charsetmgr.php to the delete files array (thread)
  • Fixed admin email address validation (thread)
  • Corrected French lang file to fix the non showing dropdown in the user manager (thread)
  • Fixed search feature in the keyword manager (thread)
  • Added partial Swedish language file (user contribution)
  • Added Italian language file (user contribution)
  • Added Icelandic language file (user contribution)
  • Added language fallback to function cpg_get_default_lang_var (thread)
  • Updated Finnish language file (user contribution)
  • Updated default value of transparent_overlay in configuration.htm (thread)
  • Added code that makes sure mb_strlen actually exists when called (thread)
  • Fixed album manager issue when users aren't allowed to create private albums (thread)
  • Fixed lower case user name issue with plugin usergal_alphatabs (thread)
  • Fixed issue where users can edit public albums (thread)
  • HTML validation (thread)
  • Added partial Portuguese language file (user contribution)
  • Added partial Catalan language file (user contribution)
  • Fixed template error if guests are allowed to create public albums
  • Allow admin to change email address (thread)
  • Fixed issue when regular users try to upload to self-created public albums with simple upload form (thread)
  • Fixed missing classid attribute causing videos not to play (thread, thread)
  • Updated regex to fix error message for blank 'allowed file types' values (thread)
  • Fixed setting email sender address
  • Show 'upload needs admin approval' message for flash uploader (thread)
  • Fixed exif issue when auto resizing is enabled and watermarking is disabled (thread, thread)
  • Optimized picture resizing and watermarking procedure
  • Fixed display of unprocessed bbcode markup in ecard display
  • Fixed registration process if both email verification and admin activation enabled (thread)
  • Fixed error message if uploaded file exceeds dimension limit (thread)
  • Fixed session table name in SMF bridge files (thread)
  • Fixed deprecated message on pluginmgr.php (thread)
  • Fixed critical error on memberlist when bridged (thread)
  • Fixed use of mysql_insert_id (thread)
  • Fixed template placeholder bug that caused cut off tags
  • Updated Swedish language file (previous version was mainly a Danish language file)
  • Added partial Swedish documentation
  • Fixed last visit display in user manager when bridged with SMF2 (thread, thread)
  • Fixed implementation of plugin hook 'ip_information' (thread)
  • Use IPTC headline instead of IPTC title as picture title according to docs (thread)
  • Added additional submit button on top of 'Edit files' form (thread)
  • Added plugin hooks 'after_edit_file', 'upload_html_pre_move' and 'upload_swf_pre_move' (thread)
  • If error occurs during batch-add, show error message and don't redirect automatically (thread)
  • Fixed default selection of check boxes for batch-add (thread)
  • Fixed issue with 'User Gallery Alphabetic Tabbing' plugin when bridged (thread)
  • Skip unknown file types during batch-add process (thread)
  • Added label for 'remember me' checkbox (thread)
  • Removed value 'SERVER_PROTOCOL' from client ID generator (thread)
  • Fixed picture resizing via admin tools (thread)
  • Removed declaration of function 'cpg_folder_file_delete' from update.php (thread)
  • Fixed spelling of ImageMagick (thread)
  • Fixed error message when entering invalid email address in profile manager (thread)
  • Fixed renaming of already added files during batch-add (thread)
  • Fixed picture manager - show user created albums in public categories (thread)
  • No longer specify a MySQL engine - use the server default.
  • Fixed comment approval when editing comments (thread)
  • Add anonymous group if it doesn't exist (thread)
  • Fixed ownership of albums created with xp publisher
  • Consistent use of plugin hook types 'action' and 'filter' (thread)
  • Adjusted/added maxlength parameter for album title/keyword according to database types (thread)
  • Display more batch add error messages
  • Fixed use of intermediate-sized image (thread)
  • Theme 'curve': remove drop-down menu leftover if empty (thread)
  • Added plugin hook 'replace_forbidden_conditions' (thread)
  • No error message for admin during upload if image dimension exceeds configuration value (thread)
  • Always use PHP time when querying the database (thread)
  • Added missing/new plugin hooks to visiblehookpoints plugin
  • Fixed potential security issue during installation (thread)
  • Fixed issue with language manager (thread)
2010-11-30
cpg1.5.8
  • Maintenance release (stable)
  • Announcement thread
  • Fixed setting default language with language manager (thread)
  • Changed form token generation - removed trouble maker parameters (thread)
  • Fixed language manager issue for language files with underscore (thread)
  • Set moderator group to '0' for all albums to avoid problems for people who used that feature before it was dropped (thread)
  • Fixed ecard if no intermediate picture is present (thread)
  • Added Estonian language file (user contribution)
  • Update 'last visit' time if it's a 'remember me' session (thread)
  • Added Slovak language file (user contribution)
  • While deleting non-images, delete the corresponding custom thumbnail if exists
  • While renaming non-images, rename the corresponding custom thumbnail if exists
  • While renaming files, check if there will be no conflicts before doing anything
  • Added plugin hook 'token_criteria'
  • Fixed missing CSS class cpg_summary and icon replacement leading to broken output of help boxes on config screen (thread & thread)
  • Fixed possibility for users to edit their files in public galleries if disabled in config (thread)
  • Disable the possibility for guests to enter file details by default (thread)
  • Fixed error message when regular users try to delete their albums in public categories
  • Re-organizing zip archives inside docs folder
  • Adding documentation about plugin config options
  • Fixed issue when reset file ratings (thread)
  • Fixed empty values for 'reason' in 'report to administrator' email (thread)
  • Fixed category view when albums with keywords are present (thread)
  • Changed type of plugin hooks 'theme_thumbnails_wrapper_start/end' from 'filter' to 'action' and adjusted English documentation accordingly (thread)
  • Added search terms to the title of the thumbnails page (thread)
  • Added Japanese language file (user contribution)
  • Adding boxes to config documentation for defaults, max, min, recomended and record name
  • Display Coppermine news always in an iframe (thread)
  • Fixed error message for non existing categories (thread)
  • Replaced wrong link in update.php (thread)
  • Added language table population section to update script to stop cpg1.4.x upgrades seing only Luxemburgish and Mexican as available langauges
  • Updated Turkish language file (user contribution)
  • Show password prompt if user tries to access file in password protected album directly
  • Added Brazilian language file (user contribution)
  • Fixed uploading to password protected albums in public categories (thread)
  • Changed default values for user galleries category (thread)
  • Fixed album visibility issue with user galleries (thread)
  • Changed fix for category alpha sorting
  • Fixed a critical error with the most viewed meta album
  • Updated French language file (improvement and corrections)
  • Allow higher port numbers for the site url config setting
  • Fixed display of swf files in Firefox (thread)
  • Fixed resizing of watermark backup images (thread)
  • Fixed category permissions for secondary user groups (thread)
  • Fixed issue when editing user albums (thread)
  • Fixed issues with usergal_alphatabs plugin (thread & thread)
  • Fixed line breaks in contact form emails
  • Removed outdated FAQ items
  • Updated Hungarian language file (user contribution)
  • Fixed pre-population of user name on comments form (thread)
  • Fixed timeout issue when fetching remote files (thread)
  • Fixed thumb sharpening (thread)
  • Place new comments form accordingly to sort order of comments (thread)
  • Added Danish language file (user contribution)
  • Added default value for 'user_profile6' during user creation (thread)
  • Fixed HTML validation issue for german lang files - replaced & by &
  • Updated plugin manager documentation (thread)
  • Added Hungarian language file (user contribution)
  • Fixed pagination for user manager (thread)
  • Updated Finnish language file (user contribution)
2010-08-06
cpg1.5.7 This package was never released. In fact it never existed. -
cpg1.5.6
  • Maintenance release (stable)
  • Announcement thread
  • Fixed broken link (thread)
  • Extended lang_byte_units array for some language files (thread)
  • Fixed ip address duplicates in stat_details.php (thread)
  • Updated Czech language file (user contribution)
  • Fixed typo that caused the display of the 'not supported version' message box (thread)
  • Fixed issue when uploading plugins to Windows-driven galleries
  • Removed cpg1.3.x theme upgrade guide, as a direct upgrade from cpg1.3.x to cpg1.5.x no longer is supported
  • Create different log entries for user registrations and admin user creations in access log file (thread)
  • Fixed config value for path to ImageMagick when selecting GD during intallation (thread)
  • Fixed query for album moderation group (thread)
  • Fixed display of upload approval button (thread)
2010-06-04
cpg1.5.4 2010-06-02
cpg1.5.3 2010-03-05
cpg1.5.2
  • Versión beta. Primera versión pública de evaluación y pruebas. !No la uses en un entorno de producción! ¡No hay soporte!
  • Anuncio en el foro
2009-11-16
cpg1.5.1
  • Versión alfa para probadores y traductores. Esta versión no se sacó al público - sólo se puso a disposición de un grupo cerrado de usuarios para pruebas y traducción.
2009-07-24
cpg1.5.0
  • Esta versión nunca fue lanzada como tal - el número 1.5.0 era una necesidad inicial del desarrollo de la serie 1.5.x antes de que se establecieran las características. No hay paquete disponible, ni tampoco ha habido nunca - sólo se sacaban 'checkouts' de sub-versiones desde el repositorio.
Never

Como puedes ver, el equipo de desarrollo está constantemente arreglando los errores y mejorando Coppermine. Todo software no trivial contiene errores, por lo que no hay garantía de que la versión que actualmente es la más reciente sea la versión final que se publicará en la serie cpg1.5.x. Es absolutamente vital que actualizaces tan pronto como sean liberados los nuevos paquetes.

Log de cambios (Changelog)

Los detalles sobre los cambios que entraron en un paquete se puede encontrar en el fichero de cambios (changelog) que viene en él. Puedes encontrarlo en el directorio raíz del paquete de Coppermine. Tiene la información sobre idiomas adicionales y la fecha y hora de la solución de problemas.

Es un archivo de texto sin formato que se puede leer con cualquier editor - en Windows es suficiente el Bloc de notas.

Pasos necesarios para subir la versión de Coppermine (para cualquier versión)

Las siguientes instrucciones se aplican a todas las versiones y revisiones de Coppermine, así que por favor léelas atentamente.

Para dejarlo absolutamente claro:

no hay un paquete de actualización independiente - Coppermine siempre es un paquete completo que se puede utilizar tanto para una nueva instalación como para una actualización.

Acciones adicionales para algunas versiones

Dependiendo de la versión que estés actualizando hay otras acciones que debes realizar:

Actualizar desde las versiones cpg1.0,1.1,1.2.x or 1.3.x a cpg1.5.x

No se sporta la actualización directa de cpg1.0, cpg1.1, cpg1.2.x o cpg1.3.x a cpg1.5.x - si todavía tienes una versión tan antigua, tendrás que actualizar en dos fases (desde su versión a cpg1.4.x y luego a cpg1.5.x)

Actualizar desde cpg1.4.x a cpg1.5.x

Actualizar desde versiones cpg1.5.x to a la más reciente

No hay ningún paso extra que debas seguir cuando actualizas de una versión anterior de cpg1.5.x a la versión más reciente de esa familia. Basta seguir las instrucciones descritas anteriormente en pasos necesarios para realizar al actualizar Coppermine (de cualquier versión).

El script de actualización

Es un archivo que contiene un conjunto de instrucciones (script) que actualizarán la base de datos y eliminará los archivos sobrantes de versiones obsoletas que ya no se utilizan en esta versión. Se puede acceder desde el enlace correspondiente dentro del menú de administración o escribiendo la URL en el navegador.

Se puede ejecutar escribiendo http:////tudominio.tld/tu_carpeta_coppermine/update.php. en la barra de direcciones del navegador.

Qué hace

La actualización lleva a cabo tres acciones:

Propósito

El proceso realizará la actualización de base de datos por tí después de haber reemplazado manualmente el archivo sql. La actualización no detectará si hay disponible una nueva versión de Coppermine, ni descargará nada desde el sitio web de Coppermine. El nivel de automatización no es tan avanzado (aún).

Para conocer las nuevas versiones de Coppermine o saber si hay actualizaciones de mantenimiento, consulta las Novedades en coppermine-gallery.net.

Permisos de ejecución

El script de actualización solía estar accesible públicamente en las versiones de Coppermine anteriores a cpg1.5.x , esto es, todo el mundo era capaz de ejecutarlo. Si bien esto era bueno para dar soporte (cualquiera era capaz de ejecutar la actualización cuando un usuario pedía ayuda, si era obvio que no lo había hecho), cabía una pequeña posibilidad de que en algún momento pudiera ser un riesgo para la seguridad. Por eso los miembros del equipo de desarrollo decidieron proteger este script, y que no pudiera ser ejecutado por cualquier visitante - a partir de cpg1.5x hay que proporcionar credenciales de administrador. Hay cuatro maneras diferentes:

¿Cuándo hay que ejecutar la actualización?

Tienes que ejecutar el programa de actualización cada vez que cambies la versión o la sub-versión de mantenimiento, es decir, cada vez que se cambie el archivo sql/update.sql.

No importa ejecutar el script de actualización varias veces, así que si dudas vuelve a ejecutar.

Herramienta de comprobación de versiones (versioncheck)

Desde el lanzamiento de cpg1.3.2 Coppermine viene con una herramienta adicional para comprobar los archivos y verificar que pertenecen a la versión de que se trate, para ayudar a resolver más fácilmente los problemas relacionados con las mejoras y actualizaciones. Para lanzarla tienes que añadir versioncheck.php a la dirección de la galería en el navegador después de entrar en Coppermine como administrador (por ejemplo: http://tudominio.tld/tu_carpeta_coppermine/versioncheck.php). Con la versión 1.5.x puedes ejecutar la utilidad versioncheck desde el menú de administración.

La herramienta versioncheck no actualiza, ni descarga las nuevas versiones de Coppermine por ti, ni instala ningún parche - sólo te informa acerca de las versiones más recientes y te ayuda a determinar si la actualización ha sido correcta.

Qué hace

La secuencia de comandos "versioncheck" tiene dos propósitos:

Este script comprueba los archivos de tu servidor web y trata de determinar si las versiones de archivos son idénticos a los que hay en el repositorio de http://coppermine-gallery.net. Resalta los archivos que no coinciden y que debes actualizar también.

La página versioncheck ha sido rediseñada para cpg1.5.x tanto en apariencia como en funcionalidad, en comparación con versiones anteriores.

Primera ejecución

When run for the first time, you will see the option screen first. For a start, default options should be OK, so just submit the form. The script will then determine the coppermine version you're currently running, an try to look up the XML file on the coppermine repository that corresponds to your version. If successfull, it will compare all files that exist on your server against the most recent files that are recommended to use (trying to obtain that data from the repository). Subsequently, you should see a list of folders and files that are supposed to exist on your server and an explanation if the file versions you have are the most recent. For details how to interpret the output, read on. Cuando se ejecuta por primera vez verás la primera pantalla de opciones. Para empezar, las opciones por defecto deberían bastar, así que pulsa el botón de enviar. La secuencia de comandos determinará la versión de Coppermine que esté actualmente en ejecución e intentará buscar el archivo XML en el repositorio de Coppermine que corresponde a su versión. Si tiene éxito comparará todos los archivos en tu servidor con los archivos en el repositorio más recientes y/o recomendados (tratará de conseguir esos datos del repositorio, claro). Posteriormente deberías ver una lista de carpetas y archivos que se supone que existen en tu servidor y una explicación sobre si las versiones de archivo que tienes son las más recientes. Sigue leyendo para conocer más detalle de cómo interpretar la salida.

Opciones

El pequeño número de opciones en la página versioncheck deberían ser bastante auto-explicativas:

La pantalla de opciones te permite configurar versioncheck, o mejor dicho lo que se muestra. Las opciones que escojas no se guardan, así que tendrás que elegir cada vez que se ejecuta versioncheck. Las opciones por defecto deberían valer para la mayoría de los usuarios - cámbialas solo cuando tengas buenas razones.

Salida de la comprobación

Hay una gran cantidad de información en un espacio muy pequeño. He aquí un ejemplo de una posible salida y lo que significa:

Qué podría salir mal usando versioncheck

Como las acciones realizadas por el script versioncheck son complejas, hay varias cosas que pueden salir mal, dependiendo de la configuración de tu servidor web:

Como hay varios factores que influyen en su comportamiento puede que trabaje correctamente en tu servidor, o puede que no. Si versioncheck no hace nada, es probablemente tu caso - pero no tienes por qué alarmarte: sólo asegúrete de mantener la instalación de Coppermine al día, preferiblemente activando la opción de configuración "Mostrar noticias de coppermine-gallery.net". Sólo si la herramienta te dice que hay problemas (es decir, sólo si algunas líneas contienen un comentario en la columna de comentarios), debes preocuparte y mirar más detenidamente.

Falsas expectativas

Para algunos esto puede sonar trivial, para otros puede ser un dato importante: naturalmente, los archivos que no has reemplazado durante el proceso de actualización (anycontent.php, por ejemplo) se marcarán como obsoletos en la salida de versioncheck. Por supuesto era de esperar. No pasa nada si has realizado la actualización tal y como se ha indicado, porque los archivos que se supone que se mantienen durante el proceso en realidad no contienen código que necesite ser actualizado. A modo de ejemplo, anycontent.php en realidad no contiene código en absoluto (al menos el archivo que viene con Coppermine). Puede tener código personalizado si decides usarlo. Para obtener más información sobre el uso de anycontent.php, consulta la sección "Uso de anycontent.php".

La herramienta versioncheck en realidad no descarga las versiones de archivos de Internet - sólo comprueba los que tienes en tu servidor contra una lista de los más recientes. La herramienta versioncheck no comprueba ni arregla tu sitio contra la piratería informática.

FAQ de la actualización

Volver desde cpg1.5.x a una versión anterior

CPG1.5.x incorporates many new features (compared to older versions), so we encourage all users to upgrade. However, there may be some who want to test cpg1.5.x and decide later that they want to go back to an older version. You have to keep in mind that a full upgrade changes the overall layout of coppermine's database that includes converting the encoding to unicode. This process can't be reverted: once you have done the conversion, the only way back is to restore a complete mySQL database dump (of course you have to create this backup before you upgraded in the first place). Creating mySQL dumps (backups) is recommended anyway, so you should do so now. CPG1.5.x incorpora muchas características nuevas (en comparación con versiones anteriores), así que animamos a todos los usuarios a actualizar. Sin embargo, puede haber alguien que quiera probar cpg1.5.x y más tarde decida que quiere volver a una versión anterior. Hay que tener en cuenta que una actualización completa modifica la base de datos de coppermine, incluyendo la conversión de la codificación a Unicode. Este proceso tiene vuelta atrás: una vez terminada la conversión, la única forma de volver atrás es restaurar un volcado completo de la base de datos mySQL (por supuesto tienes que crear esta copia de seguridad lo primero antes de actualizar). Se recomienda de todos modos hacer copias de seguridad de mySQL, por lo que deberías hacerlo ahora mismo.

Para dejarlo claro: sólo se puede volver a versiones anteriores si tenías cpg1.4.x y actualizaste a cpg1.5.x. ¡Si has realizado una instalación nueva de cpg1.5.x, no hay manera de rebajar la versión a 1.4.x!

Para hacer la vuelta atrás cambia todas los archivos de la versión 1.5.x con los archivos de la versión anterior (como si fueras a hacer una actualización, ver más arriba). A continuación, restaura el volcado de base de datos que debes haber hecho antes de actualizar. Si no tienes una copia de seguridad de la base de datos (un backup, un volcado, un dump), no se puede volver atrás!