Coppermine Photo Gallery v1.5.x: Dokumentation och Manual

Innehållsförteckning
Endast delvis översatt

Uppgradering

Notera: eftersom det skett förändringar både i Coppermines filer och i databasen jämfört med versioner före cpg1.5.x, så måste användare av versioner äldre än cpg1.5.0 utföra alla steg som nämns nedan: både filerna måste ersättas och scriptet update.php script måste köras.

Varför uppgradera?

Det finns större och mindre uppdateringar (releaser) av Coppermine. Större releaser har hittills varit cpg1.0, cpg1.1, cpg1.2.x, cpg1.3.x, cpg1.4.x och cpg1.5.x. Nästa större release kommer att bli cpg1.6.x (som för närvarande är under utveckling - ingen release-datum är bestämt ännu) - du läser för närvarande dokumentationen för cpg1.5.x. Mindre releaser (den tredje siffran i versionsnumreringen) representerar uppdateringar, även kallat "underhålls-releaser". Större releaser innehåller nya funktioner (jämfört med tidigare större releaser), mindre releaser innehåller inte nya funktioner, utan bara felrättningar och mindre förbättringar (som tillagda språkfiler).

För att förstå den release-policy som utvecklingsteamet av Coppermine har så måste du förstå hur fel rättas: vi underhåller ett repositorium (lagringsplats på nätet) där källkoden för varje större release ständigt förbättras. Större och mindre fel som rapporteras på Coppermines supportforum rättas i repositoriet. När ett nytt paket sätts ihop, kommer alla rättningar som gjorts i repositoriet att ingå i den nya underhålls-releasen.

Det finns en god anledning för varje ny underhållsrelease: de paketeras vanligtvis när ett nytt fel eller en ny sårbarhet upptäcks som är relevant säkerhetsmässigt. Som ovan sagt finns det åtskilliga mindre felrättningar som inkluderas i varje ny release också, inte bara den stora som föranledde underhållsreleasen. Därför är det inte tillräckligt att bara rätta den enskilda sårbarheten som var anledningen till att det nya paketet släpptes. Uppgradera istället till den senaste stabila releasen så snart denna släppts.

Anledningar för paket-releaser

Här är en lista på mindre releaser av cpg1.5.x och anledningen till att de släpptes. Listan är menad att förklara varför du bör uppgradera så snart det är möjligt till senast stabila release om du kör en föråldrad version.

Detaljer
Paket Anledning för release Release Datum
cpg1.5.26
  • Security release (stable)
  • Announcement thread
  • Fixed custom menu link icon (thread)
  • Fixed error message when removing favorite pictures (thread)
  • Fixed possible issue when searching for image titles (thread)
  • Optimized admin tools "Update thumbs and/or resized photos" and "Delete original image backup for watermarked images" (thread)
  • Optimized code if 'Show first level album thumbnails in categories' is disabled (thread)
  • Added possibility to choose category thumbnail for user galleries category (thread)
  • Fixed display of quota on profile page if user belongs to more than one group
  • Fixed display of additional groups on profile page if user doesn't belong to more than one group
  • Fixed strict standards warning messages (thread)
  • Added PHP4-replacement of function htmlspecialchars_decode to fix email issues (thread)
  • Extended captcha_plugin_enabled function to distinguish various forms
  • Optimized album thumbnails code to reduce database query count (thread)
  • Fixed typo in plugin writing docs (thread)
  • Updated template plugin to match fixed typo in the docs (thread)
  • Fixed regex check for "The content of the main page" in config (thread)
  • Shuffled thumbnails for meta album "random" instead of sorting them by pid (thread)
  • Fixed docs regarding user quota (thread)
  • Added CSS class "thumbnail" to thumbnail images on thumbnails.php pages (thread)
  • Added CSS class "thumbnail" to album thumbnails (thread)
  • Fixed clickable keyword list content (thread)
  • Removed references to constants THEME_HAS_VANITY_GRAPHICS and THEME_IS_XHTML10_TRANSITIONAL, as they didn't worked as intended
  • Fixed XSS issue (thread)
  • Added CSS classes "thumb_title_title", "thumb_title_views", "thumb_title_owner", "thumb_caption_caption", "thumb_caption_msg_date", "thumb_caption_author", "thumb_caption_ctime", "thumb_caption_rating", "thumb_caption_mtime" to thumbnail meta data on thumbnails.php pages (thread)
  • Fixed smiley detection in theme directory (thread)
  • Added constant THEME_HAS_COMMENT_GRAPHICS to use theme-depended images for approve/disapprove/delete/edit/report comments (thread)
  • Fixed XSS issue (thread)
  • Updated SWFUpload to fix several XSS issues (thread)
  • Updated Czech language file (user contribution)
  • Updated header information to reflect new year
  • Fixed permission check if users aren't allowed to upload to public albums (thread)
2014-01-07
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 Detta paket släpptes aldrig, det har faktiskt aldrig funnits. -
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.5 Detta paket släpptes aldrig, det har faktiskt aldrig funnits. -
cpg1.5.4 2010-06-02
cpg1.5.3 2010-03-05
cpg1.5.2
  • Beta release. First public release for testing and evaluation. Do not use for production! No support available yet.
  • Announcement thread
2009-11-16
cpg1.5.1
  • Alpha release for testers and translators. This version is not a public release - it has only been released to a closed group of users for testing and translation purposes.
2009-07-24
cpg1.5.0
  • This version was never released as a package - the version number 1.5.0 was just reserved for the initial development stage of the cpg1.5.x series before the feature freeze stage started. There is no package available, nor has there ever been one - only Subversion checkouts have been possible.
Never

Som du ser rättar och förbättrar Coppermines utvecklingsteam ständigt programvaran. Varje mer komplicerad programvara innehåller fel, så det finns ingen garanti att den version a cpg1.5.x serien som är den nuvarande också kommer att bli den sista, slutgiltiga och felfria versionen. Det är mycket viktigt att du gör uppdateringar så snart som nya paket släpps.

Ändrings-logg

Detaljer om de förändringar som ingår i release kan hittas i ändringsloggen som kommer med i varje paket. Ändringsloggfilen kan hittas i rot-katalogen i Copperminepaketet. Ändringsloggen innehåller mer information om ytterligare språk och datum och tid när rättningen gjordes.

Ändringsloggen är en ren textfil som kan läsas med ett enkelt redigeringsprogram - på Windows-baserade maskiner duger notepad.exe bra.

Nödvändiga steg att utföra vid uppgradering av Coppermine (från någon version)

Instruktionerna här gäller för alla uppdateringar/uppgraderingar av Coppermine, så läs dem noga.

För att göra detta fullständigt klart:

det finns ingenting sådant som ett separat uppgraderingspaket - Coppermine kommer alltid som ett komplett paket som kan användas för såväl nyinstallation som uppgradering.

Ytterligare steg för att uppdatera från vissa versioner

Beroende på den version som du uppdaterar ifrån, så finns det en del ytterligare saker som du måste göra:

Uppgradera från version cpg1.0, cpg1.1, cpg1.2.x eller cpg1.3.x till cpg1.5.x

Support för en direkt uppgradering från cpg1.0, cpg1.1, cpg1.2.x eller cpg1.3.x till cpg1.5.x har tagits bort - om du fortfarande kör en sådan stenåldersversion, måste du uppgradera i två steg (från din version till cpg1.4.x och sedan till cpg1.5.x)

Uppgradera från version cpg1.4.x till cpg1.5.x

Uppgradera från äldre versioner av cpg1.5.x till den senaste versionen av cpg1.5.x

Det finns ingenting ytterligare att göra för att uppgradera från en äldre version av cpg1.5.x till den senaste versionen av samma familj. Att utföra de grundläggande instruktionerna som beskrivits ovan i Steg nödvändiga för att uppgradera Coppermine (från någon version) räcker.

Uppdateringsprogrammet

Uppdateringsprogrammet är ett script som kommer att uppdatera din databas och radera överblivna filer från föråldrade versioner som inte längre används i den nya versionen. Du kan komma åt den genom att klicka på motsvarande länk i administratörsmenyn eller genom att ange sökvägen (URL) i adressfältet på din webbläsare.

Du kan köra uppdateringsprogrammet genom att ange http://din_sida.se/din_coppermine_mapp/update.php i din webbläsares adressfält.

Vad det gör

Uppdateringsprogrammet utför tre saker:

Syfte

Uppdateringsprogrammet kommer att utför uppdateringen av databasen åt dig efter det att du manuellt ersatt den sql fil som det använder. Uppdateringsprogrammet kommer inte att upptäcka åt dig om det finns en nyare version av Coppermine tillgänglig och inte heller kommer det att ladda ner någonting från Coppermines hemsida. Automatiseringsnivån i Coppermine är inte avancerad (ännu).

För att se om det finns nya versioner eller underhållsreleaser, se nyheter från coppermine-gallery.net.

Behörighetskontroll

I Coppermine versioner före cpg1.5.x, brukade uppdateringsprogrammet vara offentligt åtkomligt, d.v.s. alla kunde köra det. Medan detta var bra för supportändamål (supportrar kunde köra uppdateringsprogrammet för användare som behövde hjälp om det var uppenbart att de inte gjort detta), så fanns det en liten risk att denna åtkomlighet för alla i något steg kunde innebära en säkerhetsrisk. Därför beslutade utvecklingsteamet att skydda uppdateringsprogrammet från att kunna köras av vem som än hade åtkomst till det - från och med cpg1.5x måste du ange administratörsuppgifter. Det kan du göra på fyra olika sätt:

När måste uppdateringsprogrammet köras?

Du måste köra uppdateringsprogrammet varje gång du uppdaterar/uppgraderar, eg. varje gång som filen sql/update.sql ersätts med en ny version.

Det skadar inte att köra uppdateringsprogrammet flera gånger, så om du är tveksam kan du köra det igen.

Versionskontrollverktyget

Efter release cpg1.3.2 har Coppermine ett versionskontrollverktyg som hjälper dig att lättare lösa frågor om uppgraderingar och uppdateringar. För att köra versionskontrollen, lägg bara till versioncheck.php till adressen i din webbläsare efter att du loggat in som administratör (exempel: http://din_sida.se/din_coppermine_mapp/versioncheck.php). I om med 1.5.x, kan du köra versionskontrollfunktionen från administratörsmenyn.

Versionskontrollverktyget utför inte någon faktisk uppdatering: det laddar inte ner nyare versioner av Coppermine åt dig och inte heller installerar det några programrättningar - det är bara till för att göra dig uppmärksam på om det finns nyare versioner och på om du redan uppgraderat korrekt.

Vad det gör

Programmet "versionskontroll" är tänkt för två ändamål:

Programmet går igenom filerna på din webbserver och försöker att bestämma om dessa är identiska med de som finns i repositoriet på http://coppermine-gallery.net. Filer som inte matchar visas och dessa är de filer du också borde uppdatera.

Jämfört med tidigare versioner har versionskontrollsidan gjorts om för cpg1.5.x både visuellt och funktionsmässigt.

Första körningen

Vid första körningen kommer du att se alternativ skärmen först. Från början borde standardalternativen vara OK, så skicka bara formuläret. Programmet kommer då att bestämma vilken Coppermine version du för närvarande använder, och kommer att söka om den XML fil på Coppermines repositorium som motsvarar din version. Om det lyckas kommer den att jämför alla filer som finns på din server med de senaste som det rekommenderas att använda (försöker att få dessa data från repositoriet). Följaktligen bör du se en lista med mappar och filer som borde finnas på din server och en förklaring om de filversioner som du har är de senaste. För detaljer om hur du ska tolka informationen, läs vidare.

Alternativ

Det finns ett litet antal alternativ på versionskontrollsidan, som borde vara ganska självförklarande:

Alternativskärmen låter dig konfigurera versionskontrollen, eller snarare det som visas. Alternativen sparas ingenstans, så du måste justera dem varje gång du kör versionskontrollen. Standardalternativen borde vara OK för de flesta användare - ändra dem bara om du har en bra anledning att göra det.

Versionsjämförelse

Det finns mycket information som visas på liten yta. Här är en del exempel på möjlig utdata och vad det betyder:

Saker som kan bli fel när man kör versionskontroll

Eftersom de åtgärder som görs när versionskontrollen körs är komplicerade, finns det ett antal saker som kan gå fel beroende på hur din webbserver är uppsatt:

Verktyget versionskontroll tillhandahålls för att tillmötesgå slutanvändaren. Eftersom det finns ett antal faktorer som kan påverka den, kan det hända att det inte fungerar på din webbserver. Om versionskontrollen inte gör någonting alls gäller det förmodligen dig - det är inget du behöver oroa dig över: var bara noga med att hålla din Coppermine installation aktuell, företrädelsevis med att aktivera konfigurationsalternativet "Visa nyheter från coppermine-gallery.net". Bara om enskilda problem rapporteras av versionskontrollverktyget (eg. bara om några rader innehåller en anmärkning i kommentarskolumnen), behöver du orolig och ta dig en närmare titt.

Fel förväntningar

För en del kan det här verka trivialt, medan det för andra är viktig information: naturligtvis är det så att filer som du inte har ersatt under uppgraderingsprocessen (t.ex. anycontent.php) kommer att se föråldrade ut i utdatat från versionskontrollen. Det är förstås vad som kan förväntas. Det skadar inte om du gjorde uppgraderingen exakt som beskrivits, eftersom de filer du skulle behålla under processen inte innehåller någon kod som behöver uppdateras. Som exempel, anycontent.php innehåller ingen kod alls (åtminstone inte den som kommer med i Coppermine). Den kan innehålla anpassad kod om du bestämmer dig för att använda den. För mer information om användningen av anycontent.php, se avsnittet "Använda anycontent.php".

Versionskontrollverktyget gör ingen nedladdning av nyare filversioner från internet - det bara kontrollerar filerna du har på din server jämfört med en lista på senaste filer. Versionskontrollverktyget kontrollerar inte eller rensar din sida från hackers.

Uppgradering FAQ

Nedgradera från cpg1.5.x till en äldre version

CPG1.5.x innehåller många nya funktioner (jämfört med äldre versioner), så vi uppmuntrar våra användare att uppgradera. Det kan finnas de som vill testa cpg1.5.x och senare bestämmer sig för att de vill gå tillbaka till en äldre version. Du måste tänkta på att en full uppgradering ändrar det övergripande utseendet på Coppermines databas som även inkluderar en konvertering av kodningen till unicode. Denna process kan inte ångras: när du en gång gjort konverteringen, är den enda vägen tillbaka att återställa en komplett mySQL databas dump (du måste förstås skapa denna backup före du uppgraderar överhuvudtaget). Att skapa mySQL dumps (backuper) rekommenderas ändå, så du bör göra det nu.

För att göra detta absolut klart: du kan bara nedgradera om du brukade ha cpg1.4.x förut och uppgraderade till denna version av cpg1.5.x. Om du har en ny installation av cpg1.5.x, kan du inte nedgradera alls!

För att faktiskt utföra nedgraderingen, ersätt alla cpg1.5.x filer på din server med filer från en äldre version (som om du gjorde en uppgradering, se ovan). Läs sedan tillbaka den säkerhetskopia som du måste ha gjort av databasen före uppgraderingen. Om du inte har någon databas dump kan du inte backa!