jdPI4FCM/jdFantaBlu2 1.1.0

johndoe 2005-2006

jdPI4FCM/jdFantaBlu2 è una coppia di plug-in/skin che consente l'invio della formazione online e l'upload automatico sul sito dei file di backup e di esportazione generati da Fantacalcio Manager.

Invio formazione online

Il modulo di invio formazione di jdPI4FCM/jdFantaBlu2 è, dal punto di vista funzionale, molto simile al più noto TIDRAL improved by Sw3ntraX, ma è stato completamente riscritto per essere compatibile anche con browser diversi da Internet Explorer e per essere più facilmente mantenibile (TIDRAL improved by Sw3ntraX presentava alcuni bug ed il suo codice era piuttosto "criptico"). jdPI4FCM/jdFantaBlu2 è sicuramente compatibile con Mozilla Firefox, Opera e Microsoft Internet Explorer.

Inoltre il modulo di invio formazione di jdPI4FCM/jdFantaBlu2 è più sicuro perché le password sono esportate in modo cifrato.

Dalla versione 0.9.5, disponendo di un servizio di hosting che supporta il PHP, jdPI4FCM/jdFantaBlu2 è in grado di salvare direttamente sul sito le formazioni inserite, in modo che possano essere visualizzate nella pagina Formazioni. Il sistema è molto simile a SalvaFormazione.php di Giuseppe "mR`gImO", ma consente di salvare anche l'ordine dei rigoristi e i giocatori in tribuna ed inoltre funziona anche con leghe a più divisioni.

Upload dei file di backup e di esportazione

jdPI4FCM/jdFantaBlu2 permette in modo semplice e funzionale di caricare sul sito della lega i file di (auto)backup e i file di esportazione della lega; questo permette di avere una copia sicura dei "preziosissimi" dati di Fantacalcio Manager e di poter condividere facilmente con tutti gli altri presidenti di lega il file di esportazione.

Installazione

Il pacchetto è composto da due archivi .zip; il primo contiene il plug-in jdPI4FCM, mentre il secondo contiene la skin jdFantaBlu2.

Scaricate il file jdPI4FCM_010100.zip e decomprimetelo nella sottodirectory plugin di Fantacalcio Manager; alla fine della procedura dovranno essere presenti i file jdPI4FCM.exe e jdPIintf.dll.

Scaricate il file jdFantaBlu2_010100.zip e decomprimetelo nella sottodirectory skin di Fantacalcio Manager. Dovranno essere presenti il file jdFantaBlu2.ini e la directory jdFantaBlu2 con tutto il suo contenuto.

Se disponete già di una versione precedente di jdPI4FCM/jdFantaBlu2, potete aggiornarla semplicemente sovrascrivendo tutti i file.

Nel caso abbiate utilizzato la versione 0.9.5 con la funzionalità di salvataggio automatico delle formazioni in combinazione con Internet Explorer, è necessario procedere alla rigenerazione del sito, in modo tale che eventuali file di formazioni corrotti vengano ripristinati.

Uso

Generate con FCM il sito avendo cura di scegliere la skin jdFantaBlu2, al termine della procedura verra' automaticamente avviato il plug-in jdPI4FCM.

L'interfaccia grafica del plug-in consente di impostare i dati necessari al funzionamento della skin. Dopo averli impostati premete il pulsante Ok per lanciare il processo di generazione. Se la procedura termina correttamente il plug-in sarà chiuso automaticamente, altrimenti nella barra di stato (quella che si trova nella parte inferiore della finestra) verranno visulizzate informazioni sul modulo di esportazione che ha generato errore.

Per uscire senza salvare i dati modificati e senza generare i file per il sito, premere il tasto Annulla.

Tutti i dati inseriti vengano salvati in un apposito file, quindi non è necessario doverli reinserire ogni volta.

Dati per invio formazione

Abilita invio formazione: consente di abilitare la funzione di invio formazione dal sito.
Modalità invio e-mail: specifica la modalità con cui verranno inviate le e-mail di formazione. Selezionando client-side le e-mail verranno inviate richiamando il client di posta elettronica del computer dell'utente. Selezionando server-side le e-mail verranno inviate direttamente dal server che ospita il sito della lega. In questo secondo caso occorre un servizio di hosting che supporta scripting server-side; in jdPI4FCM/jdFantaBlu2 è già incluso uno script PHP. Non ho previsto altri tipi di script (ASP, Python, ...) perchè non sono in grado né di scriverli, né di testarli; se qualcuno di voi lo fosse, mi può contattare.
URL script server-side: URL dello script server-side che invia le e-mail (è necessario solo se avete scelto la modalità di invio server-side).
E-mail presidente di lega: indirizzo di posta elettronica del presidente di lega. Serve se decidete di inviare le e-mail di formazione al presidente di lega e costui non è un fantallenatore. L'impostazione è eventualmente sovrascritta dal plug-in se viene rilevato che per uno dei fantallenatori è spuntata l'opzione Presidente di lega nella finestra Dati fantasquadra di FCM.
Mittente e-mail: indirizzo di posta elettronica utilizzato come mittente delle e-mail inviate in modalità server-side. Se non specificato verrà utilizzato l'indirizzo e-mail del fantallenatore (non è necessario se avete scelto la modalità di invio client-side).
Destinatari e-mail: per ogni destinatario elencato avete due opzioni. Spuntando il primo check-box potete dare ai fantallenatori la possibilità di inviare o no la formazione al destinatario specificato. Spuntando il secondo check-box impostate di default l'invio al destinatario specificato.
Salva formazioni: se abilitata, la formazione inserita verrà automaticamente salvata sul sito in modo da essere visualizzata nella pagina Formazioni (la funzione è disponibile solo se avete scelto la modalità di invio server-side).
Applica regola portieri rigoristi: se abilitata, il modulo di invio formazioni non consente di inviare formazioni il cui ordine dei rigoristi non è compatibile con quello previsto dal regolamento ufficiale (ossia i portieri devono avere ordine di tiro non inferiore a 11).
Panchina ordinata per ruolo: se abilitata, i calciatori inseriti in panchina verranno ordinati per ruolo (la versione 0.9.0 ordinava erroneamente di default la panchina, ora è necessario abilitarne la funzione).
Disabilita modifica giornata: se abilitata, non consente all'utente di selezionare la giornata per cui è valida la formazione; la formazione sarà valida per la prossima giornata (calcolata automaticamente dal sito).
Disabilita scelta incontri: se abilitata, non consente all'utente di selezionare gli incontri per cui è valida la formazione; la formazione sarà valida per tutti gli incontri che la fantasquadra dovrà disputare nella giornata selezionata.

Le password per l'invio formazione vengono prelevate dal campo Tel. lavoro accessibile dalla finestra Dati fantasquadra di FCM. Dalla versione 1.1.0, per motivi di sicurezza, non è più possibile utilizzare password nulle o esportate in chiaro (quindi senza la direttiva [noex]).

Non servono altri dati, il plug-in automaticamente preleverà dalla vostra lega i moduli ammessi e il numero di riserve ammesse.

Dati per upload backup/esportazione

Abilita upload del backup: consente di abilitare la funzione di upload sul sito dei file di backup.
Ultimo: specifica al plug-in di uploadare sempre il backup (o l'autobackup) più recente, nel caso non vogliate che sia così usando il pulsante Sfoglia... selezionate la directory contenente il backup che volete caricare sul sito. In entrambi i casi il plug-in provvederà a generare un archivio nominato FcmBackup.zip nella sottodirectory backup del vostro sito.
Abilita upload dell'esportazione: consente di abilitare la funzione di upload sul sito del file di esportazione.
Usate il pulsante Sfoglia... per selezionare il file di esportazione che volete uploadare; il plug-in provvederà a generare un archivio nominato FcmExport.zip nella sottodirectory backup del vostro sito.

Limitazioni

jdPI4FCM/jdFantaBlu2 accetta come moduli quelli della competizione predefinita^*. Se avete competizioni che ammettono insiemi di moduli diversi, jdPI4FCM/jdFantaBlu2 non fa per voi.

jdPI4FCM ricalcola le statistiche di ogni giocatore, non usa quelle calcolate da FCM, quindi potrebbero essere errate. In questo caso fatemelo sapere, provvederò. Le statistiche calcolate da jdPI4FCM tengono conto delle impostazioni della competizione predefinita^*.

jdPI4FCM/jdFantaBlu2 è stato testato esclusivamente sulla lega dell'autore che ha le seguenti caratteristiche:

no divisioni
8 squadre
4 competizioni (di cui alcune contemporanee e che prevedono rigoristi)
1 solo Q.U.

* La competizione predefinita e' la competizione che anche FCM utilizza per calcolare le statistiche dei giocatori. Per selezionare in FCM la competizione predefinita spuntare l'apposita opzione nella cartella Generale della finestra Impostazioni competizione.

Supporto

Causa tempo limitatissimo, l'autore non crede di poter offrire un supporto consono. In casi disperati lo potrete rintracciare sul forum ufficiale di FCM.

L'autore non risponderà a domande riguardanti JavaScript, HTML, PHP, ASP, ... Esistono a tal proposito migliaia di forum sulla rete.

L'autore non risponderà, se non con un laconico RTFM (Read The Fucking Manual), a domande la cui risposta si può ottenere facilmente leggendo questa pagina.

L'autore non risponderà, a richieste di supporto pervenute via Private message.

Se volete modificare jdFantaBlu2, ma non conoscete HTML o JavaScript lasciate perdere, o per lo meno non disturbate l'autore!

Changes log

Versione 1.1.0

corretto il bug che generava file fcmInvioFormazioneDati.js non valido in caso di nessuna giornata di A giocata [p/-]
inserito il controllo su password nulle o esportate in chiaro [p/-]
corretto bug che visualizzava squadre partecipanti agli incontri di giornata anche per incontri gran premio [-/s]
modificato controllo sulla correttezza dell'ID squadra dei giocatori in rosa (il metodo precedente poteva non funzionare per campionati di A non organizzati completamente con gironi all'italiana) [-/s]

Versione 1.0.0

inserita l'opzione per il controllo dell'ordine di tiro dei portieri rigoristi secondo la regola ufficiale [p/s]
introdotta sostituzione dei caratteri nel nome della lega durante l'invio delle e-mail. Le leghe che contenevano caratteri strani (*, ", ', \, /, :, |, ?) non erano in grado di utilizzare la funzione auto-ricevi formazioni [-/s]
corretto bug che richiamava il modulo server-side d'invio e salvataggio formazione per diverse competizioni nello stessa finestra pop-up [-/s]
corretto bug che salvava in modo errato l'ordine dei rigoristi (la e-mail era comunque corretta) [-/s]

Versione 0.9.6

modificata la modalità di passaggio parametri al modulo d'invio e salvataggio formazione per garantire la compatibilità anche con Internet Explorer [-/s]
la pagina HTML generata dal modulo d'invio e salvataggio formazione è completa anche in caso di errore [-/s]

Versione 0.9.5

aggiunto il modulo di salvataggio automatico delle formazioni [p/s]
corretto il calcolo delle statistiche per leghe che utilizzano due Q.U. [p/-]
ora il plug-in si chiude automaticamente se la procedura di generazione dati va a buon fine [p/-]
corretto il bug che non permetteva di gestire leghe con "panchina lunga" [-/s]
eliminato l'ordinamento per ruolo della panchina [-/s]
inserita l'opzione per l'ordinamento per ruolo della panchina [p/s]
inserite le opzioni per non consentire agli utenti la modifica della giornata e degli incontri per cui è valida la formazione [p/s]
nel caso di un singolo incontro, il relativo checkbox è disabilitato, non è quindi più possibile deselezionarlo [-/s]

Versioni precedenti

Licenza

jdPI4FCM è un software freeware.

jdFantaBlu2 è coperta, per la parte di codice originale, da licenza GPL.

PHPMailer (http://phpmailer.sourceforge.net/), incluso in jdFantaBlu2 è coperto da licenza Lesser GPL.

Il modulo di salvataggio sul sito delle formazioni è liberamente ispirato a SalvaFormazione.php di Giuseppe "mR`gImO" (http://www.legadeiforti.info/skindownload.htm).

Ringraziamenti

L'autore vorrebbe ringraziare:

gli autori di TIDRAL per essere stati i primi a fornire un sistema di invio formazione on-line compatibile con il sito esportato da FCM;
Sw3ntraX per aver adottato ed allevato TIDRAL fino a piena maturità;
Giuseppe "mR`gImO" per aver ideato il suo sistema di salvataggio sul sito delle formazioni.

Disclaimer

jdPI4FCM/jdFantaBlu2 sono forniti "as is", senza alcuna garanzia di qualsiasi tipo.
L'autore non potrà in alcun modo essere ritenuto responsabile per danni diretti o indiretti derivanti dall'uso di jdPI4FCM/jdFantaBlu2.

johndoe - 8 settembre 2006