Coppermine Photo Gallery - Your Online Photo Gallery

Coppermine Photo Gallery v1.5.22: Dokumentation och Manual


Innehållsförteckning
Flytta musen hit för att utöka

Delvis översatt

Denna sida har ännu inte översatts i sin helhet och visas därför bara delvis på ditt språk och delvis på engelska.

Translators wanted: take a look at this page - doesn't look too complicated, does it? If you're convinced that you could translate this page, please check the official Coppermine site; we're looking forward to your contribution.

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

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!