Codex

authors (intermediate) 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.

Nota
PmWiki è distribuito di default con i caricamenti disabilitati. Vedi UploadsAdmin per informazioni su come abilitare e configurare questa caratteristica.

La possibilità o meno di caricare file può essere configurata per l'intero sito, per ciascun gruppo o per ciascuna pagina; vedere UploadsAdmin? per ulteriori informazioni. Questo determina se tutti gli upload vanno a finire in una stessa directory per tutto il sito, oppure in una directory diversa per ciascun gruppo o ciascuna pagina. Il comportamento di default è di organizzare gli allegati per gruppo.

[Si noti che deve esistere una directory /uploads che possa contenire i file.

Eseguendo questi comandi sul server si crea una directory adatta:

mkdir /var/www/pmwiki/uploads

chmod 777 /var/www/pmwiki/uploads]

Il comando Attach:

Per aggiungere o inserire un allegato, è sufficiente modificare una pagina ed inserire il marcatore "Attach:" seguito dal nome dell'allegato (es. "Attach:riassunto.pdf"). 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).

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]]

Allegati in altre pagine o in altri gruppi

Per inserire un collegamento ad un file allegato a un'altra pagina nello stesso gruppo, scrivere:

Attach:/file.ext

Per inserire un file di un altro gruppo è sufficiente specificare anche il nome di tale gruppo:

Attach:Groupname/file_name.ext

Se PmWiki è configurato in modo da usare una directory per ciascuna pagina, allora bisogna scrivere:

Attach:Gruppo.NomePagina/file_name.ext

Nomi con spazi

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

[[Attach:un file con spazi.txt]]

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

[[#blank | Attach:immagine con spazi.jpeg]]
[[#1 | Attach:immagine con spazi.jpeg]]

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 aggiungendo "?action=upload" all'URL di ogni pagina per cui il WikiAdministrator ha abilitato l'upload. 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. Se nel file local/config.php è presente la riga $EnableUploadVersions=1;, allora i file allegati non vengono sovrascritti, ma la versione vecchia viene salvata con un altro nome.

Limitazioni sulla dimensione e il tipo di file

Per ragioni di sicurezza, l'upload è disabilitato quando PmWiki è installato per la prima volta. Quando l'upload viene abilitato, il caricamento viene in genere ristretto solo a file di tipi prestabiliti e di dimensioni entro un valore massimo (vedi UploadsAdmin). Di default PmWiki limita la dimensione dei file a 50 kilobytes e le estensioni dei file ai tipi più comuni quali ".gif", ".jpg", ".doc", ".txt", e ".pdf". In aggiunta l'amministratore può configurare il sistema in modo da richiedere una password per caricare i file--vedi Passwords e PasswordsAdmin.

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

'gif','jpg','jpeg','png','bmp','ico','wbmp', # immagini

Rimozione

Allo stato attuale i file caricati possono essere rimossi solo dal WikiAdministrator. Ogni utente autorizzato a caricare file può sovrascrivere qualunque file esistente, caricandone un altro con lo stesso nome nello stesso luogo.

L'amministratore può rimuovere un file entrando via ftp (o attraverso un pannello di controllo, se il servizio di hosting lo prevede). A seconda dell'installazione, la ricetta Cookbook:webAdmin può abilitare l'accesso ai file del server attraverso il wiki.

<< Indice principale markup | Indice documentazione | Tabelle >>


Traduzione di PmWiki.Uploads - Pagina originale: PmWikiIt.Uploads - Links de retorno
Ultime modifiche:
PmWikiIt.Uploads: 10 de setembro de 2011, às 12:52
PmWiki.Uploads: 19 de outubro de 2014, às 02:05