Truedoc

[[TracNav(TOC)]]

= Installazione e Configurazione di Slashorg Downloader =

Prerequisiti: installare apache, php, mysql.

Scaricare l'applicazione dal sito http://www.slashorg.net. 

Estrarre l'applicazione in una directory nella quale apache abbia accesso.

{{{

ex: /var/www/sorg-dir/

}}}

Assegnare correttamente i permessi alla directory dell'applicativo 

{{{

ex: chown -R www-data:www-data /var/www/sorg-dir

}}}

Creare un database per l'applicazione, con un utente ed una password di connessione come nel seguente esempio:

{{{

mysqladmin create dbname

mysql> grant all privileges on dbname.* to 'username'@'localhost' identified by 'password';

mysql> flush privileges;

}}}

Procedere con l'installazione accedendo alla pagina http://localhost/sorg/setup e seguire i passi dell'installazione.

== Configurazione upload file size ==

Per poter uploadare file di grandi dimensioni impostare le seguenti variabili nel file php.ini ad un valore appropriato:

{{{

post_max_size = 100M

upload_max_filesize = 100M

}}}

== Customizzazione ==

Il programma permette di condividere file nella rete, e accesso ai files è reso possibile grazie ad una access key.

La accesse key è un URL che ha come prefisso il contenuto della variabile $_SERVER['PHP_SELF'], ovvero l'indirizzo con il quale si accede al server. Per poter generare url customizzati basta inserire nel file di configurazione conf.php (sorg.dir/conf.php) la variabile

{{{

$extern_url = 'prefisso access key'

}}}

Questo è il codice che genera l'access key con l'url customizzato (sorg-dir/index.php, line 140):

{{{

$url = 'http://' . $_SERVER['HTTP_HOST'];

if (dirname($_SERVER['PHP_SELF']) != '/')

	$url .= dirname($_SERVER['PHP_SELF']);

	$url .= "/?key=$hash";

	$new_url = $extern_url."/?key=$hash";

	$html = $lang['hash_key_success']."<a href=\"$url\">$url</a><br><br>Extern url:<br><a href=\"$new_url\">$new_url</a>";

}}}

== Customizzazione Logo ==

Per inserire un logo nell'applicazione si deve aggiungere il seguente codice prima della riga 20 del file include/inc_header.php 

{{{

<div><img src="logo.jpg"/></div>

}}}

e inserire nella directory radice dell'applicazione il l'immagine logo.jpg

== Modifica Lingua Default ==

La lingua di default può essere selezionata all'interno del file conf.php editando il valore della seguente variabile:

{{{

$SetDisplayLang = 'it_IT';

// Supported charsets: 'fr_FR', 'en_GB', 'en_US', 'de_DE', 'it_IT', 'pt_PT', 'nl_NL'.

}}}

= Guida utilizzo  Slashorg Downloader =

=== Introduzione ===

Il programma Slashorg Downloader permette di condividere files tra utenti. L'installazione crea l'utente amministratore che inizialmente è l'unico in grado di condividere file e creare nuovi utenti.

Dopo essersi loggati nell'applicazione con credenziali di amministratore è possibile accedere al “pannello di controllo” che permette di:

 * Gestire gli utenti

 * Modificare le cartelle (folders) condivise

 * Creare nuovi account

=== Creazione nuovo utente ===

L'utente amministratore può creare nuovi utenti in grado di accedere all'applicazione inserendo un “username” univoco, un indirizzo email ed una password.

Dopo avere creato un nuovo utente l'amministratore può editare il suo profilo aggiungendo ad esempio una directory “base” per l'utente, o assegnare maggiori permessi come “accesso con scrittura e/o cancellazione” o “condivisione file”.

Se non si assegna una directory base ad un utente come default questo avrà  la directory radice degli upload dell'applicazione, riuscendo a leggere i file al suo interno. Se invece l'utente amministratore crea una cartella e la assegna al nuovo utente le operazioni rimangono vincolate alla nuova directory.

=== Condivisione Files ===

La condivisione dei file può avvenire in due modalità differenti:

 * Tramite upload ed utente in grado di leggere

 Un utente in grado di scrivere su una cartella può fare l'upload di file che verranno visti da tutti coloro in grado di leggere sulla cartella sulla quale è stato fatto l'upload.

 * Tramite link di condivisione

 Un utente con i permessi di amministratore può rendere condivisibile un file anche per coloro che non sono utenti dell'applicazione. Cliccando su “condividi” file viene generato un link che permette di accedere in maniera diretta al file; infatti il link contiene un chiave di accesso (stringa alfanumerica) che identifica il file all'interno  dell'applicazione.