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

# Ladda upp filer med FTP / Batch-uppladda filer

FTP-uppladdningar och batch-uppladdningar är en för administratören av galleriet rekommenderad metod för att ladda upp filer. Av säkerhetsskäl kan bara administratören göra detta; icke-administratör kan inte använda den här funktionen och behöver använda en av de andra metoderna för att ladda upp filer.

## Vad batch-uppladdning gör

Coppermine är en databasdriven applikation. Det betyder att filer som blir uppladdade fysiskt befinner sig någonstans i webbutrymmet. Det kan vara var som helst - mapp och filnamn för filerna som laddas upp behöver inte nödvändigtvis vara sorterade på något särskilt sätt. Sorteringen och grupperingen är logisk dock: Coppermine använder kategorier, underkategorier och album för att organisera visningen av filerna som laddades upp. För att kunna göra det lagrar Coppermine filernas fysiska plats (den sökväg som leder till filerna) i databasen och även en del annan logisk information (till exempel i vilket album filen finns).

När en fil blir uppladdad med hjälp av en FTP applikation "vet" inte Coppermine var den är, så du måste tala om platsen för scriptet så att det kan minnas den genom att lagra den i databasen. Det är batch-uppladdningsprocessen kommer in. Vad batch-uppladdningen faktiskt är: skapar skalade (storleksförändrade) kopior (miniatyr- och medelstora bilder) av originalfilerna du laddade upp och skriver sedan poster i databasen (en post för varje fil du laddar upp) för att kunna spåra var på serverns hårddisk filen faktiskt finns. Med det sagt borde det vara ganska självklart: Coppermine flyttar inte runt filer - de stannar på den plats dit du laddade upp dem.

Därför bör du i förväg bestämma den struktur för mappar och filer som du tänker använda för uppladdning av filer. De behöver hamna i mappen "albums", och det är tillrådigt att skapa en smart struktur av mappar och undermappar där.

Det rekommenderas att administratören använder FTP för att ladda upp flera bilder/filer åt gången. Använd din FTP programvara för att ska undermappar inom mappen your_coppermine_directory/albums/, dit dina FTP-uppladdningar kan sparas. Även om det inte är obligatoriskt, så är det en bra idé att ha en mappstruktur inom mappen albums som efterliknar eller speglar de album och kategorier du har i Coppermine.

Viktigt: skapa inte mappar i eller ftp-uppladdningar till mapparna userpics- eller edit via ftp: dessa mappar används internt av Coppermine och får inte användas för några andra ändamål! Mappnamn får inte innehålla punkter. Vi rekommenderar också bestämd att du avhåller dig ifrån att använda några andra specialtecken - använd bara a-z, siffror och `-` (streck) eller `_` (understrykningstecken) för att fylla ut blanka utrymmen. Kontrollera att du laddar upp i binary eller auto-mode.

## Hur batch-uppladdning fungerar

Efter det att du laddat upp dina filer med FTP, klick på "Batch-uppladda filer " knappen. Batchuppladdningen sker i tre steg:

- hitta den katalog dit du laddade upp dina filer. Välj denna katalog genom att klicka på den.
- markera de filer du vill ladda upp (genom att bocka för dem). Nya filer är automatiskt förbockade, de som redan finns i din databas är inte förbockade. Markera sedan det album dit du vill lägga dina filer. Klicka på "Lägg till markerade filer" för att starta uppladdningsprocessen.
- CPG kommer sedan att visa resultatet av uppladdningen (vänta tills alla resultat hunnit visas).
  Om tecknen OK, DP, or PB 'signs' inte syns, klicka på bilden för bruten fil för att se om några felmeddelanden producerades av PHP.
  Om din webbläsare skulle få time-out, klicka på knappen för att ladda om.
  - : betyder att filen lagts till framgångsrikt
  - : betyder att filen är en dubblett och att den redan finns i databasen
  - : betyder att filen inte kunde läggas till, kontrollera din konfiguration och de behörigheter som satts på den katalog där filerna finns
  - : betyder att du inte valt ett album att lägga till filerna i, klicka på 'backa' och välj ett album. skapa ett album om du inte redan har ett
  - : filen är skadad eller går inte att komma åt
  - : okänd filtyp
  - : filen är faktiskt en GIF bild och har bara döpts om (t.ex. från jpg till png)

Att ge FTP-behörighet till andra användare kan bli ett allvarligt hot mot säkerheten, det är därför som batch-uppladdning bara finns tillgängligt för galleriets administratör.

Efter det att filer har lagts till i Coppermine's databas, säkerställ att du aldrig ska döpa om eller radera dem via FTP - använd istället alternativen i Coppermine's administrationsmeny för att radera eller döpa om filer. Bara på så sätt blir filerna raderade både från filsystemet och från databasen.

## Vanliga misstag

Det finns en del som kan bli fel med batch-uppladdning, så här är en lista på vad du bör kontrollera först:

- ### Batch-uppladdning fungerar inte som förväntat:

  - #### Behörigheter

    Säkerställ att du har beviljat behörigheter på filsystemsnivå

  - #### Växla gränssnitt

    Batch-uppladdning kommer med två olika gränssnitt: ett klassiskt gränssnitt och ett bläddringsbart gränssnitt. Om du har problem med det ena, prova det andra

  - #### Versaler

    Undvik versaler i namn för mappar och filer: Coppermine kan hantera versaler, men det blir mindre troligt att allt fungerar när dessa används. Därför bör du inte använda versaler, alla mappar och alla filer bör namnges med små bokstäver, gemener

  - #### Mellanslag

    Undvik mellanslag i namn för mappar och filer. Mellanslag hör inte hemma i listan på webb-säkra tecken. Använd dem inte! vill du ha en avgränsare, använd understrykningstecken istället!

  - #### Specialtecken

    Filsystem i datorvärlden uppfanns med tanke bara på latinska tecken. Internet och det namnsystem det använder uppfanns med tanke bara på latinska tecken. Mycket senare upptäckte utvecklarna sitt misstag och försökte att tillåta andra tecken också, men då var det för sent: den teknologi och den standard som används på webben är ganska gammal och fungerar bäst om du bara använder latinska tecken (a till z) och siffror. Specialtecken (tecken med accent eller tecken från icke-latinska alfabet) är inte med på listan över webbsäkra tecken Använd dem inte!

  - #### Förbjudna tecken

    Det finns ett fält i Coppermines konfiguration som låter dig fylla i en lista med tecken som är förbjudna i filnamn. Ändra inte på dessa (eller ta åtminstone inte bort de som finns i rutan), eftersom dessa tecken har en speciell betydelse. Naturligtvis bör du inte använda dessa förbjudna tecken i mapp- eller filnamn.

  - #### Reserverade namn

    Använd inte reserverade filnamn: det finns ett antal prefix som coppermine använder internt, så du bör försäkra dig om att du inte använder dessa reserverade filnamn eller prefix. Använd inte "thumb_", "normal_", "original_" i filnamn, eftersom dessa är standard filprefix

  - #### Punkter

    Använd inte punkter i mappnamn: filer med inledande punkt är dolda filer på de flesta webbservrars operativsystem, därför kan det vara knepigt att använda punkter. För att vara på den säkra sidan, använd inte punkter i mappnamn. Använd inte inledande punkter i filnamn heller - filnamn ska faktiskt bara innehålla en enda punkt: den som avgränsar mellan filnamnet och filändelsen.

  #### Be om support om batch-uppladdningsfrågor

  Om du har problem med batch-uppladdning, kontrollera först att http uppladdningar fungerar som förväntat. Om du vill be om hjälp med batch-uppladdning på Coppermine support board, se guiden "Be om support angående uppladdningsfrågor" - det gäller både batch-uppladdningsfrågor såväl som andra uppladdningsmetoder. Utöver de förslag som finns på den sidan, lägg till en länk till den fil som du har problem med till ditt inlägg på forumet.

- ### Filer förfaller vara skadade:

  Kontrollera att du använt rätt FTP läge (mode) när du laddade upp dem

- ### Döp inte om

  Döp inte om filer som har batch-uppladdats till Coppermines databas. Naturligtvis får du inte heller döpa om mappar som dessa filer ligger i!

- ### Radera inte

  Radera inte filer med hjälp av din FTP applikation efter det att du adderat dem till coppermine med hjälp av batch-uppladdning. Om du vill radera filer, använd Coppermines gränssnitt för att göra det.
  En del användare trodde av misstag att de kunde rader filer så snart batch-uppladdningen var klar: så är inte fallet - allt som batch-uppladdningen gör är att skapa skalade bilder (medelstora/miniatyrer/vattenstämplade) och addera poster till databasen som motsvarar filerna. Du kan inte radera filen efteråt för att spara diskutrymme. Om du raderar filen får du en bruten post, vilket är mycket illa.

## Sortera

Inställningen Standardsorteringsordning för filer kan ställas in i Coppermines konfiguration. Som standard är det inställt på "Namn stigande", vilket helt enkelt är det bästa alternativet för de flesta och det bör därför få vara kvar. Följaktligen, alla filer som du laddar upp med hjälp av Coppermine's inbyggda batch-uppladdningsfunktion kommer att sorteras i det album de hamnar i ordning efter filens namn. Det rekommenderas att du tänker ut en plan för hur filerna ska namnges (som du ger filerna innan du laddar upp dem från din dator till servern) som tar hänsyn till hur filerna kommer att sorteras på servern.

Tänk på att:

- ### Versal frågor

  De flesta webbservrar har ett Unix-/Linux-baserat operativsystem. Olikt Windows-baserade operativsystem, har versaler betydelse vad gäller sortering. Det är därför filer kan bli sorterade på ett "konstigt" sätt om du har en Windows-baserad bakgrund.

- ### Datorer ser siffror olika

  Datorer (och den webbserver som du kör ditt galleri på är en dator) uppfattar en lista på siffror på ett annat sätt än vad en människa skulle: inledande nollor kan utelämnas för en människa men inte för en dator. Låt oss säga att du har en lista på 12 filer som du just har döpt med användning av siffror, t.ex. så här:
  `1.jpg`, `2.jpg`, `3.jpg`, `4.jpg`, `5.jpg`, `6.jpg`, `7.jpg`, `8.jpg`, `9.jpg`, `10.jpg`, `11.jpg`, `12.jpg`
  En människa skulle sortera dem så här:
  - 1.jpg
  - 2.jpg
  - 3.jpg
  - 4.jpg
  - 5.jpg
  - 6.jpg
  - 7.jpg
  - 8.jpg
  - 9.jpg
  - 10.jpg
  - 11.jpg
  - 12.jpg
  , men det gör inte en dator: din webbserver kommer att sortera dem så här:
  - 1.jpg
  - 10.jpg
  - 11.jpg
  - 12.jpg
  - 2.jpg
  - 3.jpg
  - 4.jpg
  - 5.jpg
  - 6.jpg
  - 7.jpg
  - 8.jpg
  - 9.jpg
  Därför bör du i så fall fylla i en inledande nolla i namnet. Med anledning av det bör du uppskatta det maximala antalet filer som kan finnas i en mapp. Detta maximala tal bestämmer hur många tecken ditt filnamn behöver: om det maximala antalet filer blir 99 inom en mapp, kan du använda 01 till 99. Om det maximala antalet filer blir 200, kommer du att behöva tre tecken, din första fil kommer att döpas till 001.jpg, din andra 002.jpg och så vidare. Naturligtvis kan dina filnamn vara alfanumeriska, så du kan tänka ut en kombination av bokstäver och siffror, t.ex.
  - brussels001.jpg
  - brussels002.jpg
  - brussels003.jpg
  - brussels004.jpg
  - brussels005.jpg
  - brussels006.jpg
  - brussels007.jpg
  - brussels008.jpg
  - brussels009.jpg
  - brussels010.jpg
  - brussels011.jpg
  - brussels012.jpg