Leggimi - versione estesa Benvenuti nel programma delle cartoline virtuali. Questo programma è stato ideato da Mike - la grafica e le immagini sono di Loretta B. Note di utilizzo: L'unica cosa che vi chiediamo è di lasciare i crediti degli autori inseriti nel file footer.php. Mike: http://mikevba.altervista.org/nuovo/index.php Loretta B.: http://www.lorettabweb.net/index.html La grafica è modificabile secondo i Vostri gusti anche se si è cercato di farla in modo che si possa adattare ai vari siti. Le card in dotazione possono tranquillamente essere usate e/o implementate con le Vostre. Se non si è degli esperti, i vari file sarebbe opportuno non toccarli, se non nei files specificati. Nelle pagine successive: l'elenco dei files e delle cartelle, la loro funzione e i files modificabili; una ulteriore spiegazione è sul funzionamento dei vari file e pensiamo possa essere un valido aiuto per capire bene come funziona il "pacchetto", particolarmente indicata per gli svillupatori.
1 - Contenuto "cartoline" : cartella principale che va inserita nella root del sito 1.1 - elenco dei file e delle cartelle (*)cartelle da NON modificare per nessun motivo compile.php footer.php index.php invia_mail.php invia_mail_post.php invia_mail_thanks.php previev.php previev_post.php thanks.php view_card.php card css eventi leggimi images (*)inc (*)js musica res smile thumb upload
1.2 - descrizione dei contenuti delle cartelle card - le immagini di questa cartella hanno un prefisso - x_ - collegato al tipo di evento - immagini cartoline devono avere lo stesso nome delle immagini contenute in "thumb" css - - fogli di style - images - immagini del layout del sito eventi - le immagini di questa cartella hanno un prefisso - x_ - collegato al tipo di evento - immagini rappresentative degli eventi leggimi - leggimi.html - icone - le icone presenti in questa pagina images - immagini varie per il sito inc - i files di servizio inclusi nelle pagine principali della root js - file di javasript per alcune funzioni musica - files.mp3-3 files.txt (che vedremo in seguito) - 2 files.swf per i player multiplo e singolo - 1 immagine per il player multiplo (radio.jpg). res - config.php - db.txt - rif_assoluti.php smile(a corredo altre cartelle per diverse festività: Natale, Halloween e San Valentino- per l uso rinominare la cartella interessata in smile ) - le emoticon (faccine) per i messaggi - devono essere esclusivamente in formato.gif thumb - le immagini di questa cartella hanno un prefisso - x_ - collegato al tipo di evento - le miniature delle card devono avere lo stesso nome delle immagini contenute in "card" upload - le immagini caricate dagli utenti
2 - Cartelle con contenuti modificabili Prima di procedere con i vari cambiamenti, leggere come e dove apportare modifiche, in tutti i casi NON cambiare i nomi dei file o spostarli in altre cartelle. In questa cartella ci sono le cartoline rappresentative dei vari eventi (il tipo e il numero di eventi lo decidete voi): da notare che ogni immagine ha un prefisso che identificherà l'evento stesso, gli stessi prefissi, associati alle stesse immagini, verranno usati anche nella cartella "thumb". Il prefisso di identificazione è composto da una lettera - a, b, c, ecc. - e dalla underscore_ ESEMPIO: card thumb c_06.gif => compleanno d_04.jpg => carnevale f_10.gif => fiori g_01.gif => sentimentali ogni prefisso che userete raggrupperà l'evento associato e nella pagina dedicata si vedranno solo quelle cartoline. E' possibile aggiungere le coppie di immagini in card (immagini grandi) ed in thumb (immagini piccole) con lo stesso nome e la stessa estensione (attenzione al prefisso!). Se si desidera aggiungere altri eventi o gruppi di immagini, si interviene anche nel file config.php seguendo lo schema già esistente. in questa cartella ci sono i due file di di stile: css images eventi card.css - layout delle card style.css - layout del sito images - immagini di base del layout in questa cartella andrà UNA sola immagine (della cartella "thumb") per evento, servirà a creare un'indice nella prima pagina delle cartoline dove l'utente avrà la possibilità di scegliere quale evento visionare con le relative cartoline. musica 1) files.mp3 2) brani.txt 3) playlist_brani.txt 4) singolo.txt 5) player_brani.swf 6) player_singolo.swf 7) radio.jpg 1) files.mp3 - MODIFICABILE - diversi file musicali in formato mp3, si possono sostituire e/o aggiungere, e verranno letti dal menù a tendina 2) brani.txt - NON TOCCARE se non si è esperti - questo è un file di configuarzione del player_brani.swf 3) playlist_brani.txt - MODIFICABILE - file dove il player in.swf legge i brani per l'ascolto, è ininfluente sul menù a tendina, si può modificare per l'aggiunta e/o modifica dei file.mp3 4) singolo.txt - NON TOCCARE - legge il brano scelto nel menù a tendina - visibile nella card ricevuta dal destinatario 5) player_brani.swf - NON TOCCARE - file.swf inserito nel finto jukebox, serve per ascoltare il brano prima di inserirlo nella card 6) player_singolo.swf - NON TOCCARE - se si invia la musica assieme alla card, comparirà un piccolo player per l'ascolto della musica scelta 7) radio.jpg - NON TOCCARE - immagine associata al player_brani.swf - è inserita nel file di configurazione playlist_brani.txt res 1) config.php 2) rif_assoluti.php 3) db.txt 1) - MODIFICABILE SOLO NELLE PARTI SPECIFICATE NEL FILE E MODIFICABILE SOLO SE NECESSARIO - diviso in due settori: Le variabili, sufficientemente commentate, che servono per alcune impostazioni e per reperire la posizione degli elementi necessari alle card e se si è sicuri delle modifiche 2) - MODIFICABILE con i dati del vostro sito - contiene i riferimenti assoluti da assegnare ai link da mandare via E-Mail 3) - NON MODIFICABILE - contiene l'archivio delle cards inviate. E' un file creato ed alimentato mediante l'invio delle cards Nota: è presente anche rif_assoluti_sito.php spiegato al paragrafo 4.4
smile Cartella dedicata alle faccine. Unica regola per questa cartella è che le immagini siano solo GIF (animate e non animate). upload Cartella dove vanno immagazzinate le immagini usate per l'upload. 2.1 - Cartelle con contenuti NON modificabili inc NON MODIFICARE E NON SPOSTARE O CANCELLARE I FILE - In questa cartella ci sono tutti i files di servizio inclusi nelle pagine principali della root js NON MODIFICARE E NON SPOSTARE O CANCELLARE I FILE - In questa cartella c'è il file js per l'ingrandimento della miniatura della card. 2.2 - Files importanti Files molto importanti sono nella cartella res rif_assoluti.php e rif_assoluti_sito.php sono due files che contengono i riferimenti assoluti che vengono usati nelle mail. Infatti quando si manda una mail non si può usare un riferimento relativo come si usa per le pagine del sito. Se si cambia il nome della cartella che contiene tutto l'applicativo delle cards occorre aggiornare anche la variabile $card di questi due files. Per lavorare sia in locale che nel sito occorre che: - in locale ci sia il rif_assoluti.php coi riferimenti assoluti alla posizione nel localhost - nel sito ci sia il rif_assoluti_sito.php coi riferimenti assoluti alla posizione nel sito. Ovviamente questo file, una volta caricato nello spazio WEB sarà rinominato come rif_assoluti.php per ovvie ragioni. config.php: questo file è di vitale importanza per il funzionamento dell'applicativo. In questo file, oltre alle funzioni che vengono richiamate dagli script, sono indicate tutte le cartelle di servizio, il numero di colonne per le tabelle che vengono create in maniera dinamica, le dimensioni ed i tipi di files immagini da uploadare, i prefissi delle immagini usate negli eventi. Se si cambia il nome di una cartella di servizio occorre aggiornare anche la relativa variabile. ESEMPIO: se rinominiamo la cartella "musica" in "my_music" occorre cambiare la variabile $folder_music = "musica" in $folder_music = "my_nusic"; Se si aggiunge un nuovo evento occorre creare un nuovo prefisso ESEMPIO: per aggiungere l'evento "matrimonio" occorre aggiungere un nuovo record alla matrice $pref(): "matrimonio" => "m_",
3. Funzionamento La parte seguente, spiega come funzionano i vari files, particolarmente indicato per gli svillupatori o per chi ama capire il funzionamento del programma. 3.1 - L'invio delle cards L'azione avviene in quattro tempi: scelta dell'evento o dell'upload compilazione della cartolina anteprima della cartolina invio della cartolina 3.2 - Scelta dell'evento index.php in questa pagina ci sono due include che possono essere invertiti eventi.php: elenco degli eventi disponibili o upload di una propria immagine. Se non si desidera offrire all'utente la possibilità di inviare una propria immagine, è possibile eliminare l'intera <tr> che contiene il link per l'upload. top_photos.php: le immagini più usate 3.3 - Compilazione della cartolina compile.php viene iniziato e finito il form; i vari elementi del form vengono inclusi usando i seguenti files: upload.php - viene incluso se si è scelti di uploadare una propria immagine table_multi.php - viene incluso se si è scelto uno degli eventi disponibili che mostra le immagini per quel determinato evento select_musica.php - viene incluso per disegnare un menù a tendina con tutti i files.mp3 disponibili player.php - viene incluso per consentire di avere un'anteprima del brano scelto o da scegliere altri_controlli.php - contiene gli altri controlli per continuare a scrivere il messaggio da inviare faccine.php - consente di inserire delle faccine nel messaggio faccine.php e player.php possono anche essere omessi. 3.4 - Anteprima della cartolina previev.php anche in questa pagina ci sono dei files inclusi: validate_data.php - per controllare se i dati inviati sono corretti mostra_card.php - per avere un'anteprima della cartolina appena compilata form_hidden.php - form completamente nascosto dove vengono memorizzati tutti i valori da inviare alla pagina finale 3.5 - Invio della cartolina previev_post.php è una pagina fantasma che serve e compiere alcuni compiti: - raccoglie tutti i dati inviati dal form nascosto - cerca un ID da assegnare al nuovo record - db.txt - scrive tutti i dati nel file di testo - prepara il link alla pagina da mostrare al destinatario della card - prepara il testo da inviare tramite E-Mail al destinatario della card - thanks.php - infine invia la E-Mail e va alla pagina 3.6 - La pagina finale thanks.php - questa è la pagina finale che ha un solo file incluso che serve per prelevare solo alcuni dati da mostrare: read_db.php - letto questo file viene scelto il record che corrisponde all'id che correda la pagina come querystring.
3.7 - Visualizzare la card ricevuta view_card.php nella E-Mail che l'utente riceve c'è un link assoluto a questa pagina correlato da una querystring che indica l'id a cui riferirsi per la visualizzazione della card. In questa pagina ci sono delle inclusioni: read_db.php - restituisce il record puntato dall'id che questa pagina ha ricevuto mostra_card.php - questo file è già stato usato nella pagina previev.php - serve per visualizzare l'immagine, l'eventuale brano musicale, ed il messaggio ricevuti. A fondo pagina abbiamo due link: uno che rimanda alla creazione di una nuova card e che ricomincia il ciclo appena descritto per l'invio di una nuova card un'altro che permette una risposta rapida per eventuali ringraziamenti 3.8 - Risposta rapida invia_mail.php le inclusioni usate in questa pagina sono: read_db.php - già visto più sopra form_mail_pre.php - serve a leggere i campi del record corrente form_mail.php - presenta il form con i primi quattro campi già valorizzati di cui: i primi tre NON SONO MODIFICABILI, il quarto è modificabile per permettere di cambiare l'indirizzo E-Mail del mittente. faccine.php - consente di inserire delle faccine nel corpo del messaggio invia_mail_post.php pagina deputata a creare la mail in formato html e ad inviarla e ad andare alla pagina invia_mail_thanks.php
cartolin 4 - riepilogo di seguito un riepilogo delle operazioni da fare. Per prima cosa scegliere le immagini che volete utilizzare per le card, consiglio una grandezza 650px x 450px che è anche la misura della cartolina del messaggio finale, solo per motivi estetici consiglio questa misura, ma potete mettere card più grandi o più piccole a vostro gusto.. Definire i gruppi/eventi che volete e assegnare una lettera (prefisso) con l'underscore_, poi aggiungere il prefisso a tutte le immagini (come spiegato al punto 2. e punto 2.2 - card e thumb). Una volta sistemata la cartella card, copiare tutte le card nella cartella thumb e ridurle (con qualsiasi programma di grafica) per le miniature a 100px x 75px, in questo modo sarete sicuri che i nomi in card e thumb sono uguali. Per creare l'indice degli eventi nella index, prelevare una immagine per evento dalla cartella thumb e copiarla nella cartella eventi. Adesso dovete definire i vostri prefissi nel file che andrà a leggerli per poi poterli far vedere nelle pagine dedicate. 4.1 - res/config.php in queste righe potrete definire quante immagini per colonna fa vedere sia nella index che nelle pagine degli eventi, la grandezza massima dell'immagine dell'upload, la grandezza massima del messaggio da inviare e quali eventi far vedere. NOTA: Le lettera dei vari eventi devono corrispondere alle lettere (prefissi) delle immagini presenti in: card thumb Eventi riga 16 - il numero massimo delle immagini che si vogliono far vedere nella top delle card più inviate riga 17 - colonne per il numero di card nella pagina index; in pratica si possono mettere tante colonne quante sono le immagini che identificano eventi, oppure decidere di farle vedere su più righe; esempio: eventi 8 immagini che corrispondono a 8 eventi si scrive 8 e le immagini saranno tutte su una riga (8 colonne);
se si scrive 4 (4 colonne), le immagini saranno su 2 righe riga 18 - colonne per il numero di card nella pagina evento; vale lo stesso discorso della riga 17 esempio - 12 immagini: se si scrive 12 le immagini saranno tutte su una riga (12 colonne); se si scrive 6 (6 colonne), le immagini saranno su 2 righe se si scrive 4 (4 colonne), le immagini saranno su 3 righe. se si scrive 5 (5 colonne), le immagini saranno su 2 righe e le rimanenti 2 immagini sulla terza riga. riga 19 - colonne per il numero di faccine - stesso discorso delle righe 17 e 18. riga 21 - "peso dell'immagine" - consiglio di non toccare questo valore! riga 22 - larghezza massima dell'immagine espressa in pixel. riga 23 - altezza massima dell'immagine espressa in pixel. riga 24 - carratteri massimi per il messaggio da inviare. righe 28-34 - eventi associati al prefisso dell'immagine che stabiliranno quanti e quali eventi si vedranno. Da come potete vedere, a sinistra c'è il nome dell'evento che comparirà nella pagina e a sinistra il prefisso_ che identifica il gruppo di immagini con quello stesso prefisso. noterete che alcune parti sono commentate: // = commenta una riga /* contenuto */ = commenta più righe 4.2 - inc/eventi.php e.pub Parte che riguarda l'upload - è possibile scegliere di non farlo utilizzare agli utenti del vostro sito. Per oscurarlo basta commentare queste righe: dalla 51 alla 55.
4.3 - res/rif_assoluti_sito.php 4.4 - res/rif_assoluti.php 4.3-4.4 - Questi due files sono molto importanti. Servono per far andare sul vostro sito una volta inviata la card al destinatario e per indirizzare se eventualmente si vuol rimandare una card o per la risposta veloce. Quello che andrà on-line è il rif_assoluti_sito.php che però dovrà essere rinominato in rif_assoluti.php. una piccola spiegazione: il file riconosciuto da programma è la rif_assoluti.php, in locale per poter vedere le pagine, deve poter leggere il percorso del vostro sito locale, ma è logico che on-line non può certo andare a leggere il vostro localhost; i dati del sito on-line sono riportati sull'altro file: rif_assoluti_sito.php che NON viene letto dal programma. Per farlo leggere, una volta che il pacchetto è on-line, basta rinominare questo ultimo file nel nome che è riconosciuto, cioè rif_assoluti.php. 4.5 - footer.php In questo file ci sono i crediti degli autori, potete aggiungere i vostri dati lasciando inalterati i dati degli autori presenti. Spero che le note siano state esaustive e chiare, per ogni chiarimento e/o aiuto scrivete una mail a: info@lorettabweb.net