Uploads

PmWiki kan indstilles til at tillade forfatere at uploade og gemme filer og billeder (kendt som at vedhæfte dem). Disse vedhæftninger kan derefter refereres fra enhver side.

Attach:-syntaks

For at tilføje eller linke til en vedhæftning, redigerer en forfatter en side for at inkludere opmærningen "Attach:" efterfulgt af et navn på en vedhæftning (fx, "Attach:resume.pdf"). Når siden vises, bliver Attach:-opmærkningen til en af følgende:

• Et link til den navngivne vedhæftning (hvis den er uploadet, dvs. den allerede ligger i et uploadkatalog)
• Et link til en formular hvor forfatteren kan angive en fil der skal uploades og bruges som den nye vedhæftning (hvis den endnu ikke er uploadet, dvs. den ikke ligger i uploadkataloget)
• Hvis vedhæftningen er en billed-fil med en endelse så som .gif, .jpeg, eller .png, vises den som et billede.

Links' opførsel kan ændres:

• For at forhindre en billedvedhæftning i at blive vist som et billede, omgiv den med dobbelte firkantede paranteser (fx, [[Attach:billede.jpg]]).
• For at få et link til en vedhæftning til at blive vist uden "Attach:" i begyndelsen af linket, brug [[(Attach:)fil.end]].

Vedhæftninger på andre sider og grupper

For at linke til en uploadet vedhæftning (billede eller fil) fra en anden gruppe, refererer du simpelthen til gruppen selv (sørg for at "Gruppenavn" har et punktum i sig).

Hvis PmWiki er indstillet med et individuelt katalog per side, brug

Navne med mellemrum

For at linke til et filnavn med mellemrum i sig, brug linknotationen med firkantede paranteser, fx

"Indlejring i siden" af et billede med mellemrum er ikke undertøttet: bare upload billederne med navne uden mellemrum, og brug opmærkningen Attach:billede.jpg.

Følgende udenomsløsning er mulig, men er ikke understøttet og ikke anbefalet:

Internationale tegn i filnavne

Se UploadsAdmin og $UploadNameChars.

Listning af uploadede filer på en side

For at liste filer som er blevet uploadet, brug opmærkningen: (:attachlist:)

Det vil liste vedhæftninger til den nuværende gruppe eller side, afhængig af om vedhæftninger er organiseret per gruppe eller per side; hver instans indeholder et link til at se eller hente vedhæftningen. En liste af vedhæftninger vises også som en del af uploadsideformularen.

Uploadformular / Uploaderstatning

Man kan gå direkte til uploadformularen ved at tilføje "?action=upload" til URI'en for enhver side som har filuploads aktiveret af Wikiadministratoren. Erstat en fil ved at uploade en ny version af filen med samme navn.

• Sørg for at slette din browsers mellemlager efter en upload er blevet erstattet. Ellers kan det se ud som om at den originale upload stadig er på serveren.

Hvis du putter $EnableUploadVersions=1; i din local/config.php, bliver gamle versioner af de samme filer omdøbt og ikke slettet.

Type- og størrelsesbegrænsninger

Af sikkerhedsmæssige årsager er uploadfunktionen slået fra til at starte med når PmWiki er installeret. Når den er aktiveret er det begrænset hvilke filtyper og filstørrelser som kan uploades til serveren (se Uploads Admin). PmWikis standardindstilling begrænser filstørrelsen til 50 kilobytes og filendelserne til almindelige typer som ".gif", ".jpeg", ".doc", ".txt", og ".pdf".

Derudover kan administratoren indstille systemet til at kræve en uploadadgangskode -- se Passwords og Passwords Admin.

Som standard er upload af følgende endelser tilladt. Bemærk at som standard er en filendelse ikke nødvendig.

'gif','jpg','jpeg','png','bmp','ico','wbmp','svg','xcf'        # billeder

'mp3','au','wav','ogg','flac',                                 # lyd
'ogv','mp4','webm','mpg','mpeg','wmf','mov','qt','avi',        # video
'zip','7z','gz','tgz','rpm','hqx','sit',                       # arkiver
'doc','ppt','xls','mdb',                                       # MSOffice
'exe',                                                         # programfiler
'pdf','psd', 'ps','ai','eps',                                  # Adobe
'htm','html','css','fla','swf',                                # webting
'txt','rtf','tex','dvi',                                       # tekstfiler
'odt','ods','odp','odg',                                       # OpenOffice.org 
'epub','kml','kmz',''                                          # forskelligt

Fjernelse

I øjeblikket kan uploadede filer kun slettes fra serveren af wikiadministratoren. Alle brugere der er autoriseret til at uploade, kan overskrive en eksisterende fil ved at uploade en anden med samme navn og endelse, til samme sted.

Administratoren kan fjerne en uploadet fil ved at tilgå serveren via ftp (eller via et kontrolpanel, hvis værten tilbyder sådan en funktion). Opskriften Cookbook:Attachtable tillader sletning af filer fra wikien.