Rosamora Caffè | Teatro Rossini Gioia del Colle (Ba)

{jsmallfib [repository]}

dove

• jsmallfib
  è il comando: deve essere scritto esattamente così (sono consentiti caratteri maiuscoli e minuscoli), e deve immediatamente seguire la parentesi graffa (non è consentito inserire uno spazio tra la graffa e il comando).



• [repository]
  è un parametro opzionale che indica la cartelle di più alto livello per quel repository (se indicato deve essere incluso tra parentesi quadre). Questa cartella deve essere localizzata all'interno del percorso (path) specificato nel relativo parametro del plugin (il parametro Path di Default). Il Path di Default di jsmallfib può essere indicato come relativo alla cartella principale di Joomla!, oppure essere espresso come percorso assoluto (utile se il percorso si trova al di fuori della web root).
  
  Occorre notare che solo nel caso di un percorso relativo jsmallfib cercherà di creare un nuovo repository automaticamente, se questo non esiste (se il percorso è assoluto la cartella di repository deve invece già esistere).

Per quanto riguarda i permessi, i settaggi di default sono configurabili con i parametri di backend del plugin, sia per utenti non registrati sia per quelli registrati. Per implementare diritti di accesso specifici per singolo utente, o per intere categorie di contatti Joomla!, i settaggi di default possono opzionalmente essere sovrascritti aggiungendo appropriati argomenti dopo il parametro repository nella riga di comando, utilizzando questo formato:

{jsmallfib [repository] [id1:permesso1] ... [idN:permessoN]}

dove

• [id:permesso]
  associa un ID utente con uno specifico livello di permessi. In particolare, i livelli dei permessi, in ordine crescente di funzionalità, sono:
  
  
  0 -> nessun accesso
  1 -> accesso in lettura (è possibile solamente navigare nel repository)
  2 -> si possono creare cartelle, caricare files e rinominare entrambi
  3 -> si possono cancellare i files, ma non le cartelle
  4 -> si possono cancellare le cartelle (devono essere vuote)
  5 -> si possono visionare i log delle azioni

Per id si intende l'ID utente; questi valori si trovano nell'area Gestione Utenti del menu Sito nel sito amministrativo di Joomla! (nota che usando l'ID 0 ci si riferisce a tutti gli utenti non registrati). Se all'ID utente si antepone la lettera G (oppure g) esso viene inteso come un ID della categoria di contatti Joomla! (i relativi valori si trovano nella lista Categorie Contatti del menu Componenti, sempre nel sito amministrativo)

Esempio d'uso del comando:

{jsmallfib [project] [63:2] [65:3] [g6:2] desc(Hello file browsing world!)}

in questo caso, assumendo che il permesso di default sia 0 (nessun accesso), gli utenti con ID 63 e 65, come anche tutti gli utenti appartenenti alla categoria di contatti con ID 6 potranno vedere i files a partire dalla cartella 'project' (all'interno del Path di Default specificato nei parametri del plugin). L'utente con ID 63 potrà caricare files e creare nuove cartelle, quello con ID 65 avrà anche la possibilità di cancellare files, mentre tutti gli utenti della categoria contatti con ID 6 avranno l'accesso di livello 2 (creare cartelle e caricare files).

E' anche possibile definire una descrizione per il repository, semplicemente inserendola nel formato

desc(questa è una descrizione)

all'interno delle parentesi graffe. La descrizione sarà indicata come titolo sopra la lista dei files e delle cartelle (nell'esempio sopra è la scritta Hello file browsing world!).

Come nota finale sulla sintassi del comando, occorre notare che, anche se le parentesi graffe e quelle quadre intorno al nome del repository sono obbligatorie, le associazioni id:permesso possono avere un formato meno rigido. Così, il comando sopra avrebbe potuto anche essere scritto:

{jsmallfib [project] 63:2, 65:3 g6:2 desc(Hello file browsing world!)}

Per quanto riguarda le icone delle estensioni dei files, esse si trovano nella cartella plugins/content/jsmallfib nella installazione principale di Joomla! Le icone sono immagini in formato PNG e sono denominate ext.png, dove ext è l'estensione del file cui si riferiscono. Per introdurre una nuova estensione di file è sufficiente creare una nuova icona col nome appropriato.

Se apprezzate questo software, è possibile fare una donazione al programmatore, per supportare l'ulteriore sviluppo:

jsmallfib è stato scritto da Enrico Sandoli sulla base del codice originale dell'enCode eXplorer di Marek Rei (anch'esso distribuito con licenza GPL). Poiché jsmallfib lavora all'interno dell'ambiente Joomla!, l'originale protezione via password è stata sostituita dal sistema di permessi sopra descritto, che risulta semplice ed efficace. E' stata inoltre aggiunta la funzionalità per la cancellazione di files e cartelle (queste ultime solo se vuote), ed anche la possibilità di definire l'area di documenti (il Path di Default) all'interno o all'esterno della web root. Sono poi stati inseriti alcuni controlli aggiuntivi di sicurezza per evitare l'accesso a cartelle al di fuori del path che si intende utilizzare come file repository.

Ulteriori informazioni su jsmallfib possono essere trovate su http://www.jsmallsoftware.com. Il codice originale di Marek Rei si trova su http://encode-explorer.siineiolekala.net.

Questo programma costituisce software libero: è consentita la sua redistribuzione e/o la sua modifica secondo i termini della licenza pubblica GNU General Public License, come pubblicata dalla Free Software Foundation, sia nella versione 3 della Licenza, sia (a propria discrezione) in qualunque versione successiva.

Questo programma è distribuito nella speranza che possa essere utile, ma SENZA ALCUNA GARANZIA; senza neppura la garanzia sottintesa della COMMERCIABILITA' o dell'essere ADATTO AD UNO SCOPO PARTICOLARE. Si veda la licenza GNU General Public License per ulteriori informazioni.

Copyright © 2009  Enrico Sandoli (jsmallsoftware)