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

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.10 | Maintenance release (stable) Announcement thread Fixed default page when comments are sorted in descending order (thread) Counted version count up in SVN repository from cpg1.5.8 to cpg1.5.9 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 &amp; 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 | Stable release Announcement thread | 2010-06-02
cpg1.5.3 | Release candidate Announcement thread | 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.

- ### Gör en backup (säkerhetskopia/dump) av din databas

  Rekommenderade verktyg för att skapa en databas dump är mySqlDumper or phpMyAdmin - se avsnittet Verktyg som rekommenderas av utvecklingsteamet: Databas manipulation för mer information.
  Att skapa en backup är inte obligatoriskt vad gäller funktionaliteten, utan bara en säkerhetsåtgärd om något skulle gå på tok. Det är hur som helst tillrådigt att göra backuper ofta

- ### Säkerhetskopiera din include/config.inc.php fil, din anycontent.php fil och din mapp "albums" som en säkerhetsåtgärd om något skulle bli fel.

  Vanligtvis kan du bara ladda ner hela din Coppermine-mapp till din lokala hårddisk eller på någon annan säker plats med hjälp av din FTP applikation. Ett nytt Coppermine paket innehåller inte en config fil ändå (den filen skapades under installationen på din server), så du kan inte ersätta en existerande config fil med en tom från paketet; igen, backupen är bara en säkerhetsåtgärd.

- ### Ladda ner den senast stabila versionen som finns på nedladdnings-avsnittet (download section) på Coppermines officiella hemsida

  Förutsätt inte att du har den senaste versionen, speciellt inte om du installerade Coppermine med hjälp av kontrollpanelen som tillhandahållits av ditt webbhotell. Coppermines utvecklingsteam rekommenderar inte användningen av sådana auto-installerare - utan ladda ner originalet från Coppermines officiella hemsida.
  Om du inte är säker på vilket paket du ska använda (t.ex om det finns flera arkivtyper), välj zip arkivet, eftersom Windows XP eller bättre som har stöd för zip arkiv.

- ### Packa upp det Copperminepaket som du laddade ner

  Som med nya installationer behöver du packa upp det packade arkivet till en temporär mapp på din hårddisk (och bevara mappstrukturen inom paketet). De flesta moderna operativsystem har packningsprogramvara som kan packa upp zip arkiv. Om du inte har en sådan rekommenderar Coppermines utvecklingsteam att du använder 7-Zip.

- ### Med undantag för mappen "albums" , ladda upp alla nya filer och mappar, och säkerställ att du inte skriver över din anycontent.php fil eller din albums mapp.

  Du skulle faktiskt kunna ladda upp mappen albums också - den som finns i paketet är i alla fall tom. Rekommendationen att inte ladda upp denna mapp är bara menad som en säkerhetsåtgärd för de användare som har "märklig" inställning i sin FTP applikation: en del exotiska FTP applikationer raderar mappar som finns på servern och skapar sedan om dem tomma. Detta skulle förstås vara en katastrof för alla existerande gallerier under installationsprocessen, eftersom du skulle förlora alla dina uppladda filer i ditt galleri. Hur som helst, det antal FTP applikationer som har denna märkliga inställning är få och därför skadar det inte i de flesta fall att ladda upp mappen albums också. Om du är osäker, använd en av de FTP clienter som rekommenderas av utvecklingsteamet.

- ### Kör installationsscriptet

  För att köra PHP-filen "`update.php`" (eg. uppdateringsprogrammet), skriv bara in dess URL i adressfältet på din webbläsare. Filen "`update.php`" finns i Coppermine mappen, så för att köra den pekar du in din webbläsare på adressen `http://din_sida.se/din_coppermine_mapp/update.php` (om du har installerat Coppermine i rotmappen på din webbsida så måste du följaktligen ange `http://din_sida.se/update.php`). Detta kommer att uppdatera din Coppermineinstallation genom att göra alla nödvändiga förändringar i databasen.

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

- #### Insticksmoduler (Plugins)

  Insticksmoduler som gjorts för cpg1.4.x fungerar vanligtvis inte på cpg1.5.x, så du behöver inaktivera dem medan du fortfarande kör cpg1.4.x (före du startar uppgraderingen). En del funktioner som var en insticksmodul i cpg1.4.x blev en del av källkoden för cpg1.5.x, så det kan hända att du inte längre behöver insticksmodulen. Det säkraste sättet att veta att insticksmodulen inte stör är genom att inaktivera alla insticksmoduler med hjälp av motsvarande konfigurationsalternativ och sedan radera innehållet i insticksmodulens mapp med hjälp av din FTP applikation. Efter att uppgraderingen gjorts, hämta de versioner av insticksmodulerna som gjorts för cpg1.5.x och aktivera dessa en och en.

- #### Anpassade tema

  Om du har gjort ett anpassat tema, tillämpa de ändringar som gjorts i temastrukturen i ditt anpassade tema - se tema - uppgraderingsguide. Notera att en del teman som brukade komma med i tidigare versioner av Coppermine har slopats i cpg1.5.x. Dessa slopade teman finns nu som separata nedladdningar.

- #### Språkfiler

  Du kan inte använda språkfiler från äldre versioner av Coppermine som primärt språk (det språk som administratören kommer att använda) - säkerställ att du bara har de språkfiler som ingår i paketet i din lang-mapp (radera eller döp om alla filer från äldre versioner inom lang-mappen).
  Om du behöver använda ett språk som inte översatts för cpg1.5.x, kan du pröva att använda språkfilen från cpg1.4.x, men det finns en del invändningar:
  - cpg1.5.x-fraser som inte finns i din gamla språkfil kommer att inte att bli översatta eller visas på engelska
  - Coppermine kan inte administreras med hjälp av en gammal språkfil - administratören måste använda en "riktig" cpg1.5.x språkfil
  - Du får försöka att använda en gammal språkfil, men om du skulle få problem eller felmeddelanden, växla till US-English för att se om problemet försvinner. Det ges ingen support för användning av gamla språkfiler
  Helst skulle du bara radera alla filer från cpg1.4.x som finns i `lang`-mappen (den mapp som motsvarar `http://din_sida.se/din_coppermine_mapp/lang/`) före du gör en uppdatering, det skulle säkerställa att bara språkfiler som gjorts för cpg1.5.x finns med i språkmapp.
  Efter att du slutfört uppdateringen så bör du besöka den nya språkhanteraren och aktivera/inaktivera se språk som du behöver respektive inte behöver. Språkhanteraren kan du hitta på Coppermine's konfigurationspanel, utöka avsnittet "Inställningar för Språk & Teckenuppsättning" och sedan klicka på länken med namn "Hantera språk". Alternativt kan du gå direkt till adressen `http://din_sida.se/din_coppermine_mapp/langmgr.php` i din webbläsare.

- #### Lösenordskryptering

  I cpg1.3.x, brukade lösenord lagras i vanligt textformat i databasen. Detta ändrades i cpg1.4.x - där lagrades lösenord krypterade. Det brukade finnas ett alternativ för de som uppgraderade från cpg1.3.x till cpg1.4.x att kunna hoppa över steget att kryptera lösenord. I cpg1.5.x är det inte längre möjligt att lagra lösenord som ren text. Om du kör ett sådant gammalt galleri som först uppdaterades från cpg1.3.x till cpg1.4.x och nu till cpg1.5.x, så kommer uppgraderingsprogrammet automatiskt att kryptera alla dina användares lösenord (inklusive ditt eget administratörskonto). Du behöver inte tänkta på något särskilt - uppgraderingsprogrammet kommer att göra detta automatiskt.

- #### Visa FAQ

  Alternativet att visa en FAQ sida för slutanvändarna (genom att klicka på motsvarande konfigurationsalternativ) som fanns i cpg1.3.x och cpg1.4.x har tagits bort från cpg1.5.x, eftersom det sällan användes och bara orsakade ytterliga belastning för översättarna. Om du är en av dessa få användare som använde menyn FAQ i Coppermine's navigationsmeny, så kan du lätt hitta på en anpassad sida som använder Coppermine's sidhuvud och sidfot och visa dina individuella FAQ där.

- #### Föråldrade filer

  Radera de föråldrade filer som fanns med i äldre versioner av Coppermine och som inte längre finns med i cpg1.5.x.
  Igen, så är det här bara en säkerhetsåtgärd för att säkerställa att ditt nya galleri inte innehåller brister från föråldrade versioner som kan underlätta för illasinnade attackerare som utnyttjar svagheter i äldre versioner. För att ta reda på vilka filer du behöver ta bort manuellt, se nederst på uppdateringsskärmbilden (`http://din_sida.se/din_coppermine_mapp/update.php`) - uppdateringsprogrammet kommer att försöka radera filerna åt dig, med de flesta serverinställningar ger inte behörighet till detta, så du måste själv manuellt radera filerna med hjälp av din FTP applikation. Ett annat sätt att ta reda på vilka filer som behöver raderas är med versionskontroll sidan - filerna som ska raderas visas där också - sidan versionskontroll kommer dock inte att försöka att radera dessa filer.

- #### Safe mode

  Om din server körs i safe_mode och du har aktiverat "SILLY_SAFE_MODE" i include/config.inc.php, så måste du i Coppermines konfiguration efter att du gjort ovanstående steg aktivera "silly safe mode" där, eftersom inställningen i `include/config.inc.php` inte längre tas hänsyn till i cpg1.5.x. Inställningen silly_safe_mode setting har gjorts om till en konfigurationsinställning istället.

- #### URI uppladdning har tagits bort

  Funktionen URI uppladdning har tagits bort från cpg1.4.x till cpg1.5.x, eftersom det faktiskt inte gjorde det som många användare trodde det gjorde: med URI uppladdning trodde många människor att filen stannade kvar på den URI som de angav i uppladdningsformuläret och att de inte överfördes till det webbutrymme där deras Coppermine galleri fanns. Följaktligen trodde de att de kunde spara diskutrymmet på servern. Detta var ett missförstånd och bara ett önsketänkande: att använda URI uppladdningar i cpg1.4.x, gjorde att filen faktiskt laddas upp till Coppermines webbutrymmet oavsett.
  Därför blev funktionen "URI uppladdningar" borttagen från cpg1.5.x. Emellertid (beroende på din klients operativsystem) så kan du använda/missbruka det vanliga http uppladdningsformuläret för att åstadkomma något liknande i cpg1.5.x: när du anger en URL till en fil som accepteras av Coppermine i uppladdningsformuläret för http, så kommer filen att laddas ner till din klients temporära mapp och sedan kommer en reguljär http uppladdning från din klient till din server att ske. Detta är inte en funktion som är inbyggd i Coppermine, utan snarare en funktion från ditt OS/webbläsare och därför är det inte supportat. Du behöver emellertid inte göra något under uppgraderingen - det här stycket är bara för att informera dig om att funktionen tagits bort.

- #### Konfigurera nya funktioner

  Jämfört med cpg1.4.x, kommer den nya versionen cpg1.5.x med massor av nya funktioner. En del av dem aktiveras automatiskt vid uppgraderingen, och det kanske du inte vill. Därför bör du (av nyfikenhet åtminstone) läsa listan funktioner och kontrollera konfigurationspanelen och kontrollpanelen för grupper för att se vilka förändringar som gjorts. Det sätt som Coppermine hanterar språk har också ändrats, därför bör du besöka språkhanteraren åtminstone en gång efter uppgraderingen och konfigurera språkstödet där.

### 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:

- Kontrollerar behörigheten för den besökare som kör scriptet
- Kör de mysql databasfrågor som finns i filen `sql/update.sql` (ersätter det generella tabellprefixet med det du valde under installationen)
- Raderar en del filer som brukade finnas med i Coppermines kärna i föregående versioner. Script raderar bara filer som inte behövs, men det rör inte anpassade filer så det finns ingen anledning till oro.
- Byter ut dina lösenord från ren text till krypterat: i äldre version av Coppermine brukade det finnas ett alternativ som gjorde det möjligt för användare att lagra sina lösenord som ren text i databasen. I cpg1.5.x är det inte längre tillåtet att ha lösenord som ren text, och därför (om du inte redan använder krypterade lösenord), kommer lösenorden att krypteras av uppdateringsscriptet.

### 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:

- Om du redan är inloggad som administratör och kör uppdateringsprogrammet från länken i Coppermines administratörsmeny, så kommer uppdateringsprogrammet att köras utan att fler autentiseringar krävs - det använder samma "vanliga" cookie-baserade autentisering som hela Coppermines scriptet använder
- Om di inte är inloggad som administratör eller om kärndelarna av Coppermine inte längre fungerar utan att man först kör uppdateringsprogrammet (händer vanligtvis när man göra större uppgraderingar av versioner), så kommer du att uppmanas att ange dina referenser - ange de uppgifter från administratörskontot som du satte upp när du först installerade Coppermine
- Om du inte kan komma ihåg dina administratörsuppgifter, så kan du ange de för din mysql - du behövde dem när du först installerade Coppermine. Om du glömt dem, slå upp dem i den fil som används för att lagra mysql databasens anslutningsdetaljer: ladda ner `include/config.inc.php` från din webbserver till din PC och redigera den senare med en ren text-editoritor - du bör se mysql uppgifterna i den filen. Om de har ändrats, borde ditt webbhotell kunna hjälpa dig att få reda på dem.
- Om allt annat misslyckas, finns den en växel i uppdateringsscriptet du kan använda för att hoppa över autentiseringen - för att ändra på växeln: ladda ner uppdateringsscriptet (`update.php`) från din webbserver till din klient, hitta `// define('SKIP_AUTHENTICATION', true);` och ersätt detta med `define('SKIP_AUTHENTICATION', true);`. Spara ändringarna och ladda upp den redigerade filen till din webbserver och skriv över den som redan finns där. Kom ihåg att återställa filen som den var efter det att du lyckats med uppgraderingen.

### 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:

- Om du uppgraderat från en tidigare version, bör du göra en versionskontroll för att se att din uppgradering fungerat som förväntat
- Använd versionskontrollen för att försäkra dig om att din version av Coppermine är aktuell

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:

- #### Visa utdata

  Bestämmer om all utdata med formatering ska användas, eller om bara en reducerad utdata i ren text.
  - Full-skärm
    Använd det här som standard. Det kommer att visa så många detaljer som möjligt och har en snyggare layout
  - Text-bara
    Om en supporter ber dig att skicka utdata från din versionskontroll, byt till detta alternativ så att du lättare kan kopiera och klistra in det i ditt inlägg på Coppermines support forum. Gör detta bara om en supporter uttryckligen begär det! En annan tänkbar användning för utdata i text bara är resursanvändning: om du får time-out, försök att använda ren-text alternativet eftersom det använder något mindre resurser.

- #### Visa bara eventuella fel

  Om du inte har någon aning om vad utdatat betyder eller om en supporter ber om det, kan du vilja sätta det här alternativet till att bara visa de mappar/filer som har problem.

- #### Dölj bilder

  När du aktiverar det här alternativet kommer alla grafiska resurser som kommer med coppermine (eg. alla ikoner eller andra bilder) inte att tas hänsyn till för visning på versionskontrollsidan - ett filter tillämpas. Använd det här alternativet för att göra utdata mindre rörigt: bilder är vanligtvis inte säkerhetskänsliga så om du bara är bekymrad över filer som har påverkan på säkerhet, kan du utan problem dölja bilderna.

- #### Kontrollera inte ändrade filer

  Detta filer kommer att dölja kolumnen "ändrad" från att visas och det resulterar i en något mindre rörigt utdata. Kontroll efter ändrade filer kommer inte att göras när programmet körs. Aktivera det här alternativet bara om du har prestandaproblem eller om alla dina filer rapporteras som ändrade.

- #### Anslut inte till repositoriet

  Om du bockar för det här alternativet kommer inte programmet att försöka att ansluta till repositoriet och kommer då att använda den lokala XML filen istället. Använd bara det här alternativet om anslutning till repositoriet inte fungerar för dig (t.ex. om du är på ett intranet, eller om din server inte har tillgång till internet). Den stora nackdelen av att inte ansluta till repositoriet online är att du inte kommer att bli medveten om möjliga uppdateringar och senaste releaser, så du bör försöka hitta ett sätt att ansluta.
  Under utvecklingen (mellan releaser), är repositoriet online vanligtvis inte uppdateras så ofta, så bara om du använder SVN checkouts (eg. du är en utvecklare), bör du bocka för det här alternativet.

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:

- #### Sökväg

  Mapp- och filnamn

- #### Saknas

  Om inget visas i den här kolumnen finns mappen/filen på din server. Om så inte är fallet (mappen/filen finns inte på din server eller går inte att komma åt), så kommer kolumnen "Saknas" att fyllas med resultatet av denna första, grundläggande kontroll.
  Notera: det finns en del mappar/filer som det är obligatoriskt att ha; andra är frivilliga. Om du gör en ny installation eller en uppgradering, ska du försäkra dig om att du laddar upp alla mappar och filer. Du kan senare radera en del av de frivilliga filerna om du vill men det sparar inte mycket diskutrymme.
  Om en fil saknas kommer alla efterföljande steg inte att utföras - en saknad fil kan inte ha ett versionsnummer eller liknande. Om versionskontrollen klagar över saknade filer, använd din FTP applikation för att avgöra om de faktiskt saknas eller om de är oåtkomliga. Om de saknas, ladda upp dem igen. Om de är oåtkomliga måste du sätta nödvändiga behörigheter på dem.
  En del filer som fanns i äldre version kan ha blivit borttagna senare. De som kan utgöra en säkerhetsrisk kommer att visas med ordet "borttagen" i kolumnen "saknas". Om du stöter på en sådan fil, använd din FTP-applikation för att radera filen versionskontrollen klagar över. Att lämna kvar filen där den är (strunta i förslaget som versionskontrollen ger) kan utgöra en säkerhetsrisk och rekommenderas därför inte.

- #### Behörigheter

  Visar satta behörigheter för mappar och filer. För en del mappar behövs skrivbehörighet medan det för andra räcker med läsbehörighet. Om nivån på behörigheter för en mapp är bra, kommer resultatet att visas tillsammans med en anmärkning (inom hakparenteser) som "OK" (kan skilja sig på ditt språk). Att använda ett script som versionskontroll för att kontrollera behörigheter på mappar fungerar bra, medan det kan eller inte kan fungera bra på filer. Därför bör du i huvudsak bekymra dig för mappar som inte har tillräcklig behörighet. Om det rapporteras att filer inte har rätt behörigheter, var inte alltför oroad om det är så att resten av ditt galleri fungerar bra.
  Om behörigheter på mappar behöver granskas, läs på i avsnittet behörigheter i dokumentationen och gör som det föreslås där.

- #### Version

  Filens version på din server. Om den är identiskt med den version som indikeras på repositoriet, bör du se ett "OK". Om du kör en föråldrad version på din server bör du hämta en nytt releasepaket och uppgradera.
  Notera: mappar har inte versionsnummer, det har inte heller binära filer (som grafik), det är därför som kolumnen "Version" visar "n/a" (not/applicable=inte/tillämpligt) för mappar och binära filer. Bara filer som har textinnehåll kan ha ett versionsnummer, så bli inte skrämd av många "n/a (OK)"-meddelanden.

- #### Revision

  Revisionen av filen på din server. Om det är identisk med den som indikeras av XML repositoriet, bör du se ett "OK". Om du kör en föråldrad version på din server bör du hämta en nytt releasepaket och uppgradera.
  Revisioner är relaterade till versioner - om din version är OK är vanligtvis din revision det också. Bara om du gör checkouts från subversion repository, kan revisionerna "börja krångla".
  Samma sak som gäller versioner gäller också för revisioner: bara textfiler kan ha revisionsnummer - mappar och binära filer har det inte.
  förvirrad? Det behöver du inte vara: vanligtvis kan du utan vidare strunta i revisioner - om du vill veta vad revisioner används till, läs sidan detaljer om subversioner.

- #### Ändrad

  Om en fil är tillgänglig och versions- och revisionsnumret matchar, kommer versionskontrollprogrammet att försöka göra en kontroll för att se om filen har ändrats jämfört med originalfilen som kommer med i Coppermine paketet. Denna kontroll utförs genom att ta hänsyn till MD5-hashes av originalfilen och din kopia.
  Vid en ny installation eller en uppgradering bör det inte finnas några ändrade filer. Om de visas som ändrade kan det vara av flera anledningar:
  - Du har avsiktligt ändrat filen (t.ex. genom att göra en anpassning i den). I så fall är det OK att strunta i varningen i kolumnen "Ändrad" och fortsätta
  - Din fil har inte skickats i sin helhet till webbservern. Om så är fallet, försök att ladda upp den på nytt från din lokala dator till webbservern. Om detta inte hjälper, kan ditt paket ha blivit skadat. Ladda ner en fräsch kopia från Coppermines nedladdningssida, packa upp den och ladda om filen. Säkerställ att din FTP applikation är konfigurerad så att den faktiskt skriver över befintliga filer.
  - Du har använd ett felaktigt FTP-FTP-mode för att ladda upp filerna till din webbserver. Med FTP applikationer kan du transportera filer i binärt eller ASCII-mode. De flesta moderna FTP klienter har en funktion som automatiskt väljer rätt FTP-mode för varje fil. Om så inte är fallet, försök att manuellt ange FTP-mode för dina filuppladdningar.
  - Ditt webbhotell lägger till koder i varje fil. Många gratis webbhotell (s.k. "freehosts") gör så för att lägga till reklam i dina filer. Det finns lite du då kan göra utom att anlita ett betalt webbhotell eller strunta i varningen i kolumnen "Ändrad" och hoppas på att allt fungerar ändå.
  Utdatat i kolumnen "Ändrad" kan filtreraa genom att aktivera alternativet Kontrollera inte ändrade filer. Detta kommer att resultera i något ökad prestanda för versionskontrollprogrammet.

- #### Kommentar

  Kommentarkolumnen innehåll rekommendationer om vad som kan vara fel och vad du kan göra för att åtgärda det. Inga kommentarer betyder vanligtvis att ingenting är fel.

- #### Repositorielänk

  Länken till SVN repositoriet (web SVN) är en extra funktion för power-användare och utvecklare. Läs subversion repository instruktionerna för att få veta mer. Om allt fungerar bra behöver du inte bry dig om den här länken.

### 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:

- Ingen anslutning till XML repositoriet online
  Om din server befinner sig bakom en proxy eller ett webbfilter som kräver autentisering eller som inte har tillgång till internet alls (t.ex. ett företags intranet), kan versionskontrollen kanske inte ansluta till XML repositoriet online. Använd motsvarande alternativ för att förhindra att programmet försöker ansluta. Samma invändningar som ovan gäller.
- Jag får en vit sida, eller en sida utan innehåll
  Programmet får antagligen time out, eftersom det kräver enorma resurser. Du får då klara dig utan versionskontroll på din server om det inte är så att du själv kan konfigurera den, så att du kan tilldela mer minne och körningstid för programmet.
- Jag får ett felmeddelande
  Felmeddelanden som `Kritiskt fel: Maximal körningstid om 60 sekunder överskriden i /path/to/webroot/coppermine_folder/include/versioncheck.inc.php på rad 276` är en indikation på att programmet använder för mycket resurser på din server. Försök att inaktivera en del utdata-alternativ. Om detta inte hjälper kan du helt enkelt inte köra versionskontroll på din server.

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

- ### Hur får jag veta om nya Coppermine releaser?

  Det finns ett antal verktyg som hjälper dig att hålla dig informerad och undviker att du missar en release:
  - Lämna kvar konfigurationsinställningen "Visa nyheter från coppermine-gallery.net" aktiverad: denna funktion kommer att göra dig uppmärksam på nyheter angående releaser och säkerhetsfrågor. Nyheterna syns bara för dig som administratör, dina slutanvändare kommer inte att märka någonting.
  - Prenumerera på paketet på sf.net projektsidor
  - Prenumerera på anslagstavlan (genom att klicka på "avisera" när du är inloggad). Du får ett e-postmeddelande varje gång ett nytt inlägg görs på anslagstavlan.

- ### Vad är skillnaden mellan uppdatering och uppgradering?

  Orden "uppdatering" och "uppgradering" används ofta synonymt. Det är en liten skillnad i definitionen från Coppermines utvecklingsteam: uppgradering betyder vanligtvis en utökning av större versionsnummer, t.ex. från cpg1.4.x till cpg1.5.x; medan uppdatering vanligtvis refererar till mindre version höjningar, eg. underhållsreleaser från cpg1.5.x till cpg1.5.y.
  Användningen är dock inte strikt, så då kan hitta ställen både i dokumentationen och i andra media (som Coppermines officiella forum) där terminologin är den motsatta. Orden är praktiskt taget synonyma så vitt det berör oss.

- ### Hur vet jag vilken version av Coppermine jag har?

  Det finns flera sätt att avgöra vilken version av Coppermine du har:
  - Om du kan logga in på ditt Coppermine galleri med ditt användarkonto, gå till konfigurationspanelen: versionen visas i sidhuvudet.
  - Ta en titt på utdatat på vilken som helst Coppermine-baserad sida med din vanliga webbläsare (genom att högerklicka på ett blankt avsnitt eller genom att välja "Visa källa" eller liknande från Visa-menyn). Bläddra ner till slutet av sidan (strax före sluttaggen för "/body>") - du bör kunna se en kommentarrad där som visar Coppermine versionen
  - Använd en ren-text editor för att öppna en lokal kopia av någon av Coppermines PHP källfiler - i filrubriken borde du se både en exakt Coppermine-version och subversionens revisionsnummer. Så är fallet också med åtskilliga andra filer som kommer med Coppermine.

## 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!