
FANTACALCIOBAZAR versione 0.5.1
http://www.digitaldruid.net/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
Decomprimere fantacalciobazar ed eventualmente configurare 
(vedi sotto) con un editor di testo il file dati.php nella 
cartella dati, altrimenti si potr configurare poi via web. 
Copiare tutto il contenuto della cartella fantacalciobazar 
(anche quello delle sottocartelle dati e scontri) 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) connettersi 
e 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. Attenzione che l'ordine delle linee 
che influisce sul calendario dei campionati a scontri diretti. 
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 7) si impostano le sostituzioni. Se sono per 
ruolo ogni sostituzione deve avvenire con un calciatore dello
stesso ruolo, nell'ordine in cui sono stati inseriti in 
formazione. Nelle sostituzioni per schema invece i calciatori 
entrano, sempre per ordine di inserimento, se entrando la 
formazione che si viene a formare ha una schema consentito 
(sez. 6). Se entrambi i tipi di sostituzioni sono possibili 
verranno effettuate prima quelle per ruolo. Se si usano le 
sostituzioni per ruolo si pu scegliere di considerare i 
fantasisti come centrocampisti ai fini delle sostituzioni, per
ci potr essere al massimo un solo fantasista in formazione a 
meno che lo schema originario non ne prevedesse di pi.
-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). Se nel file sono presenti anche fantasisti ma li si
vuole considerare tutti come centrocampisti, impostare 
$considera_fantasisti_come = "C" (= "A" per considerarli tutti
attaccanti).
-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 si inserisce un immagine in formato JPEG col nome di un 
giocatore (con estensione .jpg , le maiuscole contano!) nella 
cartella dati essa verra usata come logo per la squadra. Ce n'
una di esempio per giocatore1.
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 (in questo caso per le 
statistiche non terranno conto delle giornate cancellate). 


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.
-Nei messaggi si pu usare l'html, tranne che i tag <BR> o <P>
 assiene a <FONT> per evitare messaggi falsi.
-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 (o che entrando dia luogo ad uno schema 
consentito, sez. 7). Nel caso ci siano pi riserve 
nello stesso ruolo, tali riserve verranno scelte in base al 
numero, in ordine crescente. Si potranno schierare X (sez. 7) 
riserve. Potranno entrare al massimo 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.
Nella cartella include/pclzip/  inclusa la classe pclzip 
rilasciata con licenza GNU/LGPL, l'ultima versione della 
quale si pu trovare su http://www.phpconcept.net .


AUTORE
Marco M. F. De Santis
Email: marco@digitaldruid.net