PmWiki può essere configurato in modo da permettere agli autori di caricare file e immagini. Questi file sono anche detti “allegati”. Ciascun allegato può essere collegato o mostrato in qualunque pagina.

Il comando Attach:

Per aggiungere o inserire un allegato, è sufficiente modificare una pagina ed inserire il marcatore “Attach:” seguito dal nome dell’allegato (ad es. Attach:file_name.ext, Attach:Group.NomePagina/file_name.ext o, nel caso avessimo un’ulteriore sottopagina, Attach:Group.NomePagina1,NomePagina2/file_name.ext).
Quando la pagina è visualizzata, Attach: diventerà:

• un collegamento all’allegato, se il file è già presente sul sito;
• un link ad una pagina speciale, in cui l’autore può selezionare il file da caricare ed usare come allegato;
• un’immagine (se l’allegato è un file grafico quali .gif o .jpeg).

Di default il caricamento dei file con le seguenti estensioni è abilitato:

'gif','jpg','jpeg','png','bmp','ico','wbmp',          # immagini
'mp3', 'au','wav',                                    # audio
'mpg','mpeg','wmf','mov','qt','avi',                  # video
'zip', 'gz','tgz','tar','rpm','hqx',                  # archivi
'odt','ods','odp',                                    # OpenOffice.org
'doc','ppt','xls','exe','mdb',                        # MSOffice
'pdf','psd', 'ps','ai','eps',                         # Adobe
'htm','html','fla','swf',                             # roba per il web
'txt','rtf','exe','tex','dvi',''                      # varie

Il comportamento dei link può essere modificato:

• per far sì che di un’immagine allegata venga mostrato il nome anziché il contenuto, inserirla tra doppie parentesi quadre (ad es. [[Attach:immagine.jpg]]);
• per evitare che il link appaia senza “Attach:” all’nizio, inserirlo così: [[(Attach:)file.ext]]

Nomi con spazi

Per inserire un collegamento a un file il cui nome contiene spazi, bisogna usare le doppie parentesi quadre; per esempio:

Per allegare un’immagine che abbia spazi nel proprio nome, facendo sì che venga visualizzata, bisogna usare una di queste due scappatoie:

Elencare i file allegati a una pagina

Per elencare i file allegati a una pagina, bisogna usare il markup: (:attachlist:)

Questo genera una lista dei file allegati al gruppo o alla pagina corrente, a seconda di come è configurato PmWiki. Ogni elemento della lista contiene un link al file allegato, per visualizzarlo o scaricarlo. Una lista degli allegati si trova anche nella pagina per caricare file.

Form per il caricamento / Sostituzione di allegati

È possibile andare direttamente alla pagina di caricamento cliccando su ‘Attach’ in cima alla pagina. Per sovrascrivere un file è sufficiente ri-caricare un file con lo stesso nome. È importante cancellare la cache del browser dopo aver rimpiazzato un allegato. Altrimenti, potrebbe sembrare che il file vecchio si trova ancora al suo posto.