Introduzione
PhpAuction è un prodotto molto completo che può essere utilizzato sul proprio sito per creare un portale di aste online in stile "Ebay". La sua semplicità d'uso e la sua struttura sono veramente i suoi punti di forza, che ne fanno un prodotto molto intuitivo e professionale.Il tipo di Licenza utilizzata è la GNU GPL versione 2.
Configurazione dello script
Una volta decompresso il file ".zip" dobbiamo andare nella cartella "include" e modificare il file config.inc.php:
$SITE_NAME = "YOUR SITE NAME";
Il nome del sito web. Apparirà sulla barra del browser ed in altre parti del sito.
$SITE_URL = "http://172.26.0.4/phpauction/";
Indirizzo del sito. Generalmente è l'indirizzo che contiene tutti i file di phpauction.
$COOKIE_PREFIX = "PHPAUCTION";
Prefisso usato dal cookie per registrare le informazioni.
Non modificare questa variabile
$LOGGED_IN_COOKIE = $COOKIE_PREFIX."_LOGGED_IN";
Cookie usato per la verificare se l'utente è nel sito.
Non modificare questa variabile
$LOGGED_IN_NICK = $COOKIE_PREFIX."NICK_LOGGED_IN";
Cookie usato per verificare se l'utente ha avuto accesso alla sua area utente.
Non modificare questa variabile
$LOGIN_BOX = 1;
Attiva (1) o disattiva (0) la visualizzazione del box per il login dell'utente.
$NEWS_BOX = 1;
Attiva (1) o disattiva (0) la visualizzazione del box per le news.
$NEWS_TO_SHOW = 5;
Numero di news massimo che vuoi visualizzare nella colonna delle news.
$MONEY_FORMAT = 1;
Formato di visualizzazione della moneta. [1] rappresenta il metodo all'americana (1,500.00), mentre [2] rappresenta il metodo europeo (1.500,00).
$MONEY_DECIMALS = 2;
Numero di cifre decimali che si vogliono visualizzare.
$MONEY_SYMBOL_POS = "R";
Se impostato su [R] visualizza il simbolo della moneta usata, dopo la cifra; se impostato su [L] visualizza il simbolo della moneta usata, prima della cifra.
$include_path = "./includes/";
Percorso della cartella di includes che contiene il file passwd.inc.php.
richiede lo slash finale
$image_upload_path = "/var/www/phpauction/uploaded/";
$uploaded_path = "uploaded/";
Percorso delle cartelle dove verranno caricate le foto degli utenti.
richiede lo slash finale
$MAX_UPLOAD_SIZE = 100000;
Dimensione massima (in byte) che un file può avere per essere caricato da un utente.
$MD5_PREFIX = "put_here_along_and_unpredictable_string";
Stringa che serve come prefisso alla password prima che venga codificata.
$SHOW_ACCEPTANCE_TEXT = 1;
Abilita (1) o disabilita (0) la visualizzazione del testo da accettare nella pagina di registrazione. Tale testo è contenuto nel file acceptance.inc.php contenuto nella directory includes.
#$logFileName = "/var/www/auctions/logs/cron.log";
Questo è il nome del file di log (ed il suo percorso) generato dal file cron.php situato nella directory principale.
$cronScriptHTMLOutput = FALSE;
Permette di abilitare (TRUE) o disabilitare (FALSE) la creazione di codice HTML per l'output di cron.
$expireAuction = 60*60*24*30
Tempo dopo il quale scade un'asta, il tempo è espresso in secondi. L'ultima cifra corrisponde in pratica ai giorni di durata.
$sessionLifeTime = 60*60*24*2; // time of a user session lifetime
Tempo dopo il quale scade la sessione di un utente. L'ultima cifra corrisponde in pratica ai giorni di durata.
$err_font = "<FONT FACE="Verdana,Arial,Helvetica" SIZE="2" COLOR=red>";
$std_font = "<FONT FACE="Verdana,Arial,Helvetica" SIZE="2">";
$sml_font = "<FONT FACE="Verdana,Arial,Helvetica" SIZE="1">";
$smlnav_font = "<FONT FACE="Verdana,Arial,Helvetica" SIZE="1" COLOR=white>";
$tlt_font = "<FONT FACE="Verdana,Arial,Helvetica" SIZE="4">";
$tlt2_font = "<FONT FACE="Verdana,Arial,Helvetica" SIZE="3">";
$usr_font = "<FONT FACE="Verdana,Arial,Helvetica" SIZE="4" COLOR="#F6AF17">";
$nav_font = "<FONT FACE="Verdana,Arial,Helvetica" SIZE="2" COLOR="#FFFFFF">";
Alcune costanti relative ai caratteri ed i colori usati per formattare il testo all'interno di phpauction.
A questo punto modificare il file passwd.inc.php presente nella cartella "includes" secondo queste specifiche:
$DbHost = "localhost";
Inserire qui l'indirizzo del server MySQL al quale dobbiamo connetterci. L'indirizzo può essere in forma letterale ("localhost") o numerica (127.x.x.x). In tutti e due i casi fare riferimento al nostro fornitore d'accesso per sapere esattamente i dati di connessione.
$DbDatabase = "phpauction";
Nome del database MySQL che verrà usato per utilizzare tale script. Fare riferimento alla prossima pagina per sapere come caricare i dati predefiniti nel database.
$DbUser = "root";
Nome utente di accesso al server MySQL. Tale nome viene dato dal fornitore di accesso al servizio e generalmente corrisponde al nome utente di accesso al nostro account.
$DbPassword = "";
Password di accesso al server MySQL. Anche la password deve essere data dal fornitore di accesso insieme al nome utente.
$AdminPasswd = "admin";
Inserire qui la password che si desidera utilizzare per l'accesso al pannello di controllo amministrativo di phpauction. Fare riferimento alle prossime pagine per sapere come utilizzare l'area di amministrazione.
Installazione sul server
Prima di continuare dobbiamo caricare il file dump.sql, contenuto nella directory sql, nel nostro account MySQL, possiamo farlo sia con PhpMyAdmin che tramite la riga di comando di mysql, inserendo questi comandi:
shell> mysqladmin create yourdatabasename
Questo comando crea il database
shell> mysql -h hostname -u username -p yourdatabasename
Questo comando verifica che si possa accedere al database
shell > mysql -h hostname -u username -p databasename < dump.sql
Questo comando esegue le query contenuto nel file dump.sql
A questo punto caricare i file sul server e settare come scrivibili, tramite il comando chmod, questi file contenuti nella directory includes:
adminmail.inc.php
categories_select_box.inc.php
countries.inc.php
currency.inc.php
Detto questo Phpauction è installato e possiamo passare alla fase successiva.
Pannello di Controllo
Ora che la procedura di installazione è finita, bisogna accedere al pannello di controllo che si trova ad un URL del tipo http://www.tuosito.it/phpauction/admin; a questo punto bisogna solamente inserire la password (vi ricordate quella configurata nel file passwd.inc.php?) e configurare (o modificare) le opzioni di amministrazione seguendo lo schema sottostante:
Edit admin e-mail address
Qui dovremo inserire il nostro indirizzo email, in questa maniera ogni operazione da e verso l'amministrazione conterrà questo indirizzo email.
Edit currency symbol
Qui dovremo inserire il simbolo di riferimento della nostra valuta. Posso inserire USD (American Dollar), £ (Lire), ? (Euro) o qualsiasi altro simbolo di riferimento della valuta usata.
Edit categories table
Qui possiamo aggiungere, modificare, ordinare, personalizzare o eliminare una categoria del sito.
Edit countries table
Qui possiamo aggiungere, modificare o eliminare un paese. Questa funzione è utile se vogliamo limitare la zona geografica di azione del nostro sito di aste.
Edit payment methods
Qui possiamo aggiungere, modificare o eliminare un metodo di pagamento. Quelli predefiniti sono "Checks", "Money Order" e "Visa".
Edit auctions duration
In questa sezione possiamo modificare i possibili valori tra i quali gli utenti possono scegliere per la validità temporale di un asta.
Edit bid increments
Questa sezione permette di modificare il tipo di incremento a seconda della "grandezza" della somma.
Edit help topics
Qui possiamo modificare i contenuti dell'help di phpauction, rendendo così più chiari i procedimenti.
Users management
Da questa sezione possiamo modificare o eliminare i dati di un utente, ad esempio una password se questa è stata persa. Naturalmente possiamo anche eliminare un utente che non ha rispettato le regole del sito.
Auctions management
Qui possiamo modificare i dati relativi ad un asta, naturalmente possiamo anche effettuare l'operazione di eliminazione di tale asta.
News management
In questa area possiamo aggiungere/modificare/eliminare le news che appariranno nel sito.
Considerazioni Finali
Abituati a portali difficilmente installabili e a forum egocentrici, installare PhpAuction ci sembrerà molto semplice. Naturalmente bisogna avere un livello medio di competenze, ma vista la potenza del prodotto lo sviluppatore ha dosato bene la facilità d'uso e la complessita dello script. Per chi volesse un sito di aste online questo prodotto rappresenta una scelta seria da prendere in considerazione. Da far notare che sul sito ufficiale c'è una comunità molto attiva che può aiutarci nel risolvere i nostri problemi e che permette "a noi" l'utilizzo di un prodotto tanto pregevole.
