Progetto a più mani...

[deathwish]

buondì a tutti i volenterosi (e i curiosi) giunti fin qui.

come avrete forse letto in questa discussione, il nostro buon Asterix ha chiesto un aiuto motivo dall'esigenza personale di poter svolgere un'attività per la quale non è stato in grado di trovare un prodotto adeguato.

dopo qualche riflessione, si è pensato che potrebbe essere interessante fare un esperimento collaborativo e tentare di realizzare tutti insieme quanto richiesto facendo uso degli strumenti che oggi come oggi l'open-source mette a nostra disposizione.

i volenterosi che desiderano collaborare, si facciano vivi da queste parti scrivendo in poche righe che tipo di contributo desiderano apportare.

da parte mia, ho iniziato realizzando una "bozza" (moooolto abbozzata) che sto continuando a modificare.

di seguito, alcuni dettagli sulle modalità di hosting e gestione del progetto.

----------

GESTIONE DEL PROGETTO

Per la gestione del progetto, si è scelto di utilizzare Mercurial (cfr. http://mercurial.selenic.com). Il repository di riferimento per il progetto è raggiungibile all'indirizzo

http://ezoffer.codeplex.com

Per una interessante introduzione allo strumento (anche se si consiglia di fare un po' di pratica con il suddetto DVCS prima ancora di avventurarsi nella collaborazione) si veda

http://www.tekpub.com/codeplex

Per collaborare con il progetto è richiesto, prima di tutto, di creare un'utenza in CodePlex. Nella scelta del nome utente si suggerisce di utilizzare lo stesso
usato in CollectionTricks. Se questo non è disponibile, si suggerisce di aggiungere il suffisso "_ct" (oppure un suo surrogato se ancora una volta non
disponibile). Ad esempio, se il nickname in CollectionTricks è "utente01" si proveranno, in seguenza, i seguenti nomi utente

• "utente01"
• "utente01_ct"
• "utente01_collectiontricks"
• "utente01_ctrick"
• ...

Una volta creato l'utente CodePlex, deve essere fatta richiesta (in questa discussione o tramite messaggio privato) di essere aggiunti come collaboratori.

COME COLLABORARE

Le attività di modifica/miglioramento del progetto sono, di volta in volta, molteplici. Punto di riferimento costante per l'accentramento di queste è rappresentato dall'Issue-Tracker (in seguito, IT) di CodePlex.

Per evitare di perdere la bussola, non si accettano modifiche che non sia correlate ad un elemento tracciato nell'IT.

Nota: nel messaggio di commit del changeset deve essere ben chiaro il l'elemento dell'IT correlato.

In ogni momento, chiunque ha la possibilità di creare un elemento nel'IT. Nel caso si tratti di un argomento di rilievo, è preferibile discuterne anche
collettivamente in questo thread.

PROPORRE UN CONTRIBUTO

Il modo preferito per proporre un contributo al progetto è per mezzo di una "patch" di Mercurial. Questa deve essere inviata come allegato nella discussione
(non si accettano patch nei messaggi privati).

Nota: il nome utente usato in CodePlex deve essere utilizzato come nome utente per i changeset di Mercurial.

Il coordinatore provvederà, quindi, a verificarla e ad inserirla nella linea di sviluppo principale.

Per modifiche molto estese, esiste la possibiltà di realizzare un "fork" del progetto ed effettuare una "pull request". Tuttavia, vista la natura del progetto è auspicabile questo avvenga solamente in un ridotto numero di casi.

LINEE GUIDA

In ordine sparso, alcune indicazioni di carattere generico

• quando si apporta una modifica al codice sorgente del prodotto, assicurarsi che l'editor usato sia configurato in modo da usare tabulazioni di quattro (4) caratteri automaticamente "esplose" in spazi.
• sono accettati file con terminatori di riga sia DOS che UN*X (con preferenza per i primi).
• le modifiche deve essere ben commentate.
• i commenti, così come i messaggi di commit dei changeset, devono essere in lingua inglese (alla stregua, si utilizzi un traduttore automatico).

[pierino_89]

Purtroppo sono molto preso in questo momento, ma dato che si parlava di php direi che può rientrare nel mio campo d'azione. Non sono riuscito ad afferrare perfettamente lo scopo finale dell'applicativo, ma probabilmente sono solo troppo stanco per connettere. In ogni caso, la mia lettura selettiva ha determinato che vi possono servire due cose che io posso riciclarvi:
- codice per elaborare file xls e caricarne i dati su database (usa una libreria che ho trovato online): mi sembra di capire che il "database" attualmente sia un file xls, quindi potrebbe fare comodo poter effettuare una importazione.
- codice per convertire una pagina html in pdf decentemente (usando wkhtml o come si chiama): per stampare l'ordine finale mi sembra utile.

Insomma, se servono idee e atrocità in php, jquery o xhtml potete contare su di me. Ma con la dovuta calma

[deathwish]

Purtroppo sono molto preso in questo momento, ma dato che si parlava di php direi che può rientrare nel mio campo d'azione.

bene, ti ringrazio per la risposta.

- codice per elaborare file xls e caricarne i dati su database (usa una libreria che ho trovato online): mi sembra di capire che il "database" attualmente sia un file xls, quindi potrebbe fare comodo poter effettuare una importazione.

attualmente, almeno in questa fase iniziale, si è preferito utilizzare un tracciato testuale su file con delimitatore di campi.

per esperienza, più semplice e generico è il formato utilizzato più si limitano i problemi... tanto più che passare da un documento excel ad un file di testo come quello descritto è banale.

- codice per convertire una pagina html in pdf decentemente (usando wkhtml o come si chiama): per stampare l'ordine finale mi sembra utile.

wkhtmltopdf è, comunque, un applicativo client... ma potrebbe essere utile, eventualmente.

Insomma, se servono idee e atrocità in php, jquery o xhtml potete contare su di me. Ma con la dovuta calma

bene.

tieni presente che, al momento, AJAX non è stato volutamente preso in considerazione perchè nelle intenzioni iniziali si vorrebbe rendere il codice facilmente comprensibile anche ai meno smaliziati.

[pierino_89]

attualmente, almeno in questa fase iniziale, si è preferito utilizzare un tracciato testuale su file con delimitatore di campi.

per esperienza, più semplice e generico è il formato utilizzato più si limitano i problemi... tanto più che passare da un documento excel ad un file di testo come quello descritto è banale.

Sapevo che l'avreste pensato . Ma excel ha dei bug nella creazione di csv, e ogni programma fa i csv a modo suo. Quindi tanto per provare va bene, ma in produzione no... Inoltre anche con la codifica ogni tanto succedono cose strane.

wkhtmltopdf è, comunque, un applicativo client... ma potrebbe essere utile, eventualmente.

Lo so, ma è l'unico strumento che data una pagina html sputi esattamente quel che vedi...

[Asterix]

Bene bene

ragazzi io non metterei un vincolo sull'import in quanto, questo progetto implica un inserimento a mano dei dati in quanto essi necessitano di essere formattati cosa che excel non puo' fare, quindi sul form di inserimento articoli necessita prevedere una sorta di Editor WYSIWYG

lo so le cose sono sempre più complicate ma necessitano

[deathwish]

Lo so, ma è l'unico strumento che data una pagina html sputi esattamente quel che vedi...

beh... si potrebbe produrre direttamente un report PDF e la pagina HTML potrebbe essere unicamente un'anteprima...

ragazzi io non metterei un vincolo sull'import in quanto, questo progetto implica un inserimento a mano dei dati in quanto essi necessitano di essere formattati cosa che excel non puo' fare, quindi sul form di inserimento articoli necessita prevedere una sorta di Editor WYSIWYG

avevo pensato anche io a questa funzionalità.

infatti, l'import "batch" dei dati è solamente una modalità alternativa che può essere utile in prima battuta per popolare la base di dati.

nell'uso concreto gli articoli verranno inseriti/modicati uno ad uno e un editor visuale (con tanto di formattazione) è fondamentale.

lo aggiungo nell'issue-tracker come feature, intanto.

--- EDIT ---

Per gli interessati, il progetto ora è stato pubblicato su CodePlex.

Se qualcuno con un po' di sensibilità artistica ha voglia e tempo per cimentarsi nella creazione di un logo, ben venga. :)

[pierino_89]

beh... si potrebbe produrre direttamente un report PDF e la pagina HTML potrebbe essere unicamente un'anteprima...

Era per scrivere la pagina una volta sola, tutte le librerie php che ho trovato per generare i pdf usano latex o linguaggi inventati.


Per quanto riguarda xls, pensavo che effettivamente ci fosse già un file di excel contenente tutti i dati di uso comune (mi era già successo con un sito per la regione).
Se non esiste niente del genere, allora è inutile pensarci

Per gli interessati, il progetto ora è stato pubblicato su CodePlex.

Come l'hai chiamato?

[deathwish]

Era per scrivere la pagina una volta sola, tutte le librerie php che ho trovato per generare i pdf usano latex o linguaggi inventati.

mah... a dire il vero, volendo generare direttamente i dati binari di un PDF non ci si mette poi molto (l'ho fatto qualche tempo fa, anche se in C/C++)...

Come l'hai chiamato?

presumo tu non abbia letto il primo post di questa discussione, che ho modificato ancora ieri, vero? :)

[pierino_89]

presumo tu non abbia letto il primo post di questa discussione, che ho modificato ancora ieri, vero? :)

Esatto

Ho clonato, sono registrato come pierinz.

Commenti:
- perché usi le short tags di php? In genere sono sconsigliate, anche perché poi rischia di fare casino con xml...
- in che codifica sono i file? Eclipse non mi carica le lettere accentate
- i tag html vanno scritti minuscoli (poi va beh, ci sono molte altre cose perché la pagina sia valida)

Idee:
- dato che bisognerà effettuare l'autenticazione (indi la connessione al db) si potrebbe iniziare a creare una classe che alla creazione apra la connessione e salvi la risorsa, ottenibile tramite opportuna funzione, e la chiuda al destroy. In questo modo non c'è pericolo di lasciare connessioni appese.
- visto che hai creato delle funzioni di wrapper per mysql_query, ne approfitterei per passare la query a mysql_real_escape().
- in linea di massima, io inizierei a lavorare sulla classe succitata lasciando perdere per il momento l'autenticazione ma creando qualche funzione per creare le pagine tutte con la stessa struttura, ad esempio io ho scritto una funzione genPage(titolo pagina, aggiunte head, contenuto pagina, acl)

Per il resto boh, domani provo a tirare su apache e vedere cosa appare, così faccio anche critiche serie, adesso non ce la posso fare.
Notte!

[deathwish]

Ho clonato, sono registrato come pierinz.

abbi pazienza... perché non come "pierino_89" come richiesto?

- perché usi le short tags di php? In genere sono sconsigliate, anche perché poi rischia di fare casino con xml...

più che altro per abitudine... tieni presente che PHP non è il mio pane quotidiano. l'ho uso per un po' di tempo, ma non ci lavoro tutti i giorni...

- in che codifica sono i file? Eclipse non mi carica le lettere accentate

classica codepage Windows-1252...

- i tag html vanno scritti minuscoli (poi va beh, ci sono molte altre cose perché la pagina sia valida)

sì, è vero che si consiglia di scriverli minuscoli effettivamente... ma anche qui, per abitudine "dal passato"...

- dato che bisognerà effettuare l'autenticazione (indi la connessione al db) si potrebbe iniziare a creare una classe che alla creazione apra la connessione e salvi la risorsa, ottenibile tramite opportuna funzione, e la chiuda al destroy. In questo modo non c'è pericolo di lasciare connessioni appese.

l'avevo pensato anche io... ed effettivamente ce l'avrei anche pronta la suddetta classe (tempo fa ne avevo realizzare alcune con medesima interfaccia in modo da poter usare tipologie di memorizzazione diverse in modo interfambiabile)...

... a questo punto, considerato che non l'ho introdotta per mantenere il progetto "comprensibile il più possibile", bisognerà fare chiarezza su questo punto.

considerata che la richiesta iniziale di Asterix era di avere un ESEMPIO di come realizzare uno strumento di generazione offerte di questo tipo, ho pensato di mantenere il profilo del progetto MOLTO BASSO... niente sofisticazioni, niente voli pindarici... anche a costo di fare le cose in modo "non proprio consono" (è evidente a tutti il concetto di riuso modulare del software, così come la necessità di applicare almeno il pattern MVC)...

... tuttavia, se si vuole essere un po' ambiziosi, bisogna anche alzare un po' il tiro e complicare almeno un po' l'essenza del progetto.

- visto che hai creato delle funzioni di wrapper per mysql_query, ne approfitterei per passare la query a mysql_real_escape().

ribadisco, le funzioni wrapper sono state realizzate come compromesso fra chiarezza e (minima) modaluarizzazione... comunque, buona idea.

lasciando perdere per il momento l'autenticazione

sono d'accordo, anche perché aggiungerla in un secondo tempo tutto sommato non è una lavoro oneroso e al momento complicherebbe la verifica rapida...

ma creando qualche funzione per creare le pagine tutte con la stessa struttura, ad esempio io ho scritto una funzione genPage(titolo pagina, aggiunte head, contenuto pagina, acl)

anche qui... sono assolutamente d'accordo (vedi il mio discorso sul MVC), ma deve essere stabilito il livello di compromesso...

... per dire, a me non dispiacerebbe nemmeno usare strumenti come Smarty... ma, poi, mi domando quanto sarebbe semplice per i meno smaliziati personalizzare le pagine?

Per il resto boh, domani provo a tirare su apache e vedere cosa appare, così faccio anche critiche serie, adesso non ce la posso fare.

ottimo.

e, mi raccomando, domani è richiesta una buona giustificazione sul perché non hai creato l'utente "pierino_89". :)

intanto, io apporto alcune delle modifiche che hai suggerito.