
FANTACALCIOBAZAR versione 0.4.1
http://web.tiscalinet.it/mdesantis/fantacalciobazar/
Fantacalciobazar non ha ALCUNA GARANZIA; vedere il 
file COPYING per i dettagli.

Programma per gestire un torneo di fantacalcio via 
internet. Potrete avere un mercato calciatori sempre 
aperto, con la possibilita di comprare calciatori 
liberi, vendere quelli in vostro possesso o rivenderli 
agli altri concorrenti. Vengono gestite anche le 
formazioni ed il calcolo dei punteggi (una volta in 
possesso di un file di testo che contenga i punteggi dei
singoli calciatori).


REQUISITI SOFTWARE
Web server con modulo PHP (>=4.0). Non sono necessari
database, ma solo l'accesso in scrittura sulla directory
dati di fantacalciobazar da parte del webserver. Vanno 
quindi bene la maggior parte dei server gratuiti su 
internet con supporto PHP.


INSTALLAZIONE
Configurare (vedi sotto) con un editor di testo il file 
dati.php nella cartella dati e copiare tutto il contenuto 
della cartella fantacalciobazar sotto una directory 
raggiungibile dal web (via ftp o altro). Puntarvi poi il 
browser. Il web server deve avere permessi di scrittura sulla 
cartella dati che si trova all'interno di fantacalciobazar, 
altrimenti non si riuscir a comprare calciatori o inserire 
messaggi, su alcuni servizi di hosting sar quindi 
necessario cambiarli via ftp. Per esempio con cuteftp (win) 
o gftp (linux) cliccare col tasto destro sulla cartella 
dati sul server (colonna di destra), scegliere l'opzione 
CHMOD e aggiungere i permessi di scrittura. Potrebbe essere 
necessario cambiare anche i permessi del file dati.php per 
poter cambiare le password e editarlo dal web.


CONFIGURAZIONE
La maggior parte delle opzioni sono configurabili nel 
file dati.php nella cartella dati, ampiamente commentato. 
Il file pu essere editato anche direttamente da 
fantacalciobazar entrando come admin al login (password in 
bianco di default) e premendo il tasto "Configura 
Fantacalciobazar".
-Nella sezione 1) si possono inserire i nomi dei 
partecipanti (il nome della squadra si potr scegliere in 
seguito) sostituendoli a giocatore1, giocatore2, ..., 
eventualmente aggiungere o togliere delle linee per cambiare
il numero di partecipanti. Lasciando le password come sono si 
potr accedere con password in bianco, successivamente ogni 
partecipante potr cambiarla. Si consiglia invece di cambiare 
la pass dell' amministratore (sez. 2). 
-E' molto importante la sezione 5), impostando un tempo troppo 
alto per la scadenza delle offerte si rischia di non 
completare mai la squadra, mentre impostandolo troppo 
basso si dovr controllare spesso il sito per non perdere 
nessuna offerta. Il valore pu comunque essere cambiato 
durante il campionato.
-Nella sezione 11) si imposta come leggere il file 
calciatori.txt nella cartella dati che deve contenere la 
lista di tutti i calciatori comperabili; si pu facilmente 
intuire come impostare le variabili di questa sezione 
confrontandole con il file calciatori.txt (di esempio) 
fornito con fantacalciobazar nella cartella dati. Si consiglia 
comunque di aggiornare tale file, anche perch i numeri dei 
calciatori dovranno coincidere con quelli presenti nei file 
votiXX.txt di giornata per il calcolo dei punteggi (vedi 
sotto).
-La sezione 12) per leggere i file votiXX.txt funziona allo 
stesso modo, il voto che verr utilizzato deve stare nella 
colonna "$num_colonna_vototot_file_voti", mentre la colonna
"$num_colonna_votogiornale_file_voti" serve solo a 
controllare se il calciatore ha giocato (se il valore 
diverso da 0) e pu puntare alla stessa colonna col voto 
totale. Duplicando il file calciatori.txt di default e 
rinominandolo voti01.txt si potranno calcolare i risultati di 
una ipotetica prima giornata lasciando i dati di default in 
questa sezione.
-Nella sezione 13) si pu impostare fantacalciobazar per 
prelevare il file con i voti da una directory locale o 
direttamente da un sito internet, l' indirizzo impostato si 
potr comunque cambiare anche a mano prima di prelevare il 
file; se si lascia tutto in bianco si dovr copiare a mano 
(via ftp o alto) il file votiXX.txt nella cartella dati.
-Nella sezione 15) si impostano i campionati che verranno
disputati. Le giornate di inizio e fine campionato da 
indicare sono quelle totali, contando anche i campionati 
precedenti. Si hanno 4 scelte: capionato a scontri diretti
(coi dati della sez. 16), campionato a somma di punti 
assegnati a seconda della posizione di giornata (coi dati 
della sez. 17), campionato a somma dei voti di ogni giornata o 
infine nessun campionato ma solo calcolo dei voti giornalieri. 
Si possono giocare campionati a scontri diretti solo se i 
partecipanti sono 4,6,8,10 o 12; il calendario viene stilato 
in base alla posizione dei partecipanti nella sez. 1). Se le
giornate del campionato superano quelle di andata e ritorno il
calendario ricomincia dalla prima giornata.
-Nella sezione 16), per gli scontri diretti, impostando per
esempio "$soglia_voti_primo_gol = 66;" e 
"$incremento_voti_gol_successivi = 4;" i gol assegnati 
saranno: 66-69.9 1 gol, 70-73.9 2 gol, 74-77.9 3 gol e cos 
via. "$voti_bonus_in_casa" sono i punti che vengono aggiunti 
al voto della squadra che gioca in casa.
-Nella sezione 18) si pu chiudere o sospendere il mercato. A 
mercato sospeso si potr solo rilanciare su calciatori gi 
presenti sul mercato, vendere subito (ma non rimettere sul 
mercato) i propri e accettare scambi gi offerti, senza farne 
di nuovi. A mercato chiuso non si potr fare nessuna 
operazione di mercato.

Per personalizzare l'aspetto del sito si pu modificare il 
codice html tra le virgolette nei file head.php (inizio di 
ogni pagina) e foot.php (fine di ogni pagina), ricordandosi 
di mettere il simbolo \ prima di ogni virgoltetta ".
Se per qualsiasi ragione si devono spostare le cartelle dati 
e/o scontri si pu indicare la loro nuova collocazione nelle
variabili all'inizio del file controlla_pass.php .


BLOCCO FORMAZIONI E CALCOLO DEI PUNTEGGI
L' amministratore sar incaricato di congelare le formazioni 
prima dell'inizio delle partite e di far calcolare i punteggi 
una volta disponibili i voti. Una volta entrati come admin 
(nome utente "admin" e password come impostata in dati.php , 
in bianco di default) si avr la possibilit di creare
la prima giornata, nel momento in cui verr creata si 
registreranno anche le fomazioni schierate in quel momento dai 
partecipanti, quindi non createla prima del dovuto! 
Dopo essere stata creata vi sar un tasto per accedere a 
quella giornata. Per il calcolo dei punteggi si dovr avere 
un file di testo contenente per ogni linea almeno il numero 
del calciatore (lo STESSO contenuto in dati/calciatori.txt) 
ed il voto, coerentemente a quanto impostato nella sezione 
12) di dati.php. I file calciatori.txt e votiXX.txt devono 
essere di testo, se si hanno i dati in formato foglio di 
calcolo si pu fare un copia incolla e usare come separatore 
delle colonne il TAB (tasto con due frecce sulla sinistra 
della tastiera). Il voto pu avere come separatore dei 
decimali un punto o una virgola, attenzione per che se si 
usa la virgola per separare le colonne si dovr usare il 
punto per i decimali e viceversa. Una volta copiato tale file 
nella directory dati e rinominato "votiXX.txt" (a mano o 
automaticamente come visto sopra, con XX numero della 
giornata: 01 02 ...), accedendo alla giornata si potranno 
calcolare i punteggi. Una volta calcolati i punteggi, per 
esempio della giornata 1, si potr cancellare il file 
voti01.txt se si  a corto di spazio. 


CONSIGLI
-Si pu fare un primo periodo con tempo di scadenza delle
 offerte pi breve, per permettere a tutti di completare
 la propria formazione, per poi allungarlo quando inizia il
 campionato.
-Per aggiungere soldi a tutti durante il campionato 
 cambiare i soldi iniziali in dati.php.
-Per aggiungere soldi ad un singolo partecipante
 aggiungerli alla cifra della prima riga del file
 squadra_partecipante nella cartella dati.
-se volete cambiare l'ordine delle partite o delle giornate 
 per i campionati a scontri diretti oltre a poter cambiare
 l'ordine in cui sono inseriti i partecipanti nella sez. 1)
 si pu  agire direttamente sul file corrispondente al vostro 
 numero di partecipanti nella cartella scontri (a vostro 
 rischio e pericolo).


REGOLAMENTO BASE
-Acquisto dei calciatori liberi: Si potranno fare offerte 
arbitrarie per calciatori ancora liberi. L'offerta diverr 
definitiva quando non verr rilanciata per X giorni (tempo 
definito nella sez. 5 di dati.php) da nessuno degli altri 
partecipanti.
-vendita dei calciatori: un calciatore pu essere venduto 
subito al XX%(vedi sez. 9 di dati.php) del prezzo a cui lo
si  acquistato oppure pu essere rimesso sul mercato. I 
calciatori potranno essere rimessi sul mercato per un 
valore minimo arbitrario. Nel caso che il calciatore venga 
rimesso sul mercato, gli altri partecipanti potranno fare 
le loro offerte e il valore dell'offerta verr incassato 
dal venditore.Attenzione che i soldi arrivano a chi vende 
appena qualcun altro fa un'offerta (non quando il 
calciatore viene effettivamente comprato), poi se un 3 
partecipante fa un rilancio anche la differenza con 
l'offerta precedente verr aggiunta ai soldi del primo 
venditore. Per i calciatori rimessi sul mercato l'offerta 
diverr definitiva quando non verr rilanciata per X giorni
(sez. 5). Se per un calciatore rimesso sul mercato non 
verr fatta nessuna offerta dagli altri partecipanti, chi lo
ha rimesso sul mercato riavr indietro il calciatore al 
prezzo a cui lo aveva acquistato.
-Scambi: se vi  la possibilit di fare scambi con i soldi 
(sez. 10), i soldi offerti non dovranno superare quelli 
posseduti, mentre quelli richiesti non dovranno superare i 
soldi iniziali. Non  possibile offrire o richiede solo 
soldi nello scambio, e neppure fare una offerta per cui chi 
la fa verrebbe a superare il limite di calciatori nel caso 
che l'offerta venisse accettata. Il massimo numero di 
scambi proponibili contemporaneamente per giocatore  12.
Dopo lo scambio i calciatori manterranno il loro valore.
La proposta di scambio avr la stessa durata delle altre 
offerte (sez. 5).
-Sostituzioni: se uno degli 11 calciatori schierati in campo 
verr giudicato senza voto, gli subentrer la prima riserva 
che abbia ricevuto un voto e che gioca nello stesso ruolo  
del titolare. Nel caso ci siamo pi riserve nello stesso 
ruolo, tali riserve verranno scelte in base al numero, in 
ordine crescente. Si potranno schierare X (sez. 7) riserve.


LICENZA D'USO
Questo  software libero, e ognuno  libero di 
ridistribuirlo secondo certe condizioni; vedere il file 
COPYING per i dettagli.


AUTORE
Marco M. F. De Santis
Email: marcods@gmx.net
