Ghostweb - Professional Hosting

Qui di seguito un esempio di un semplice guestbook che può essere utilizzato sia sui piani hosting Windows che Linux. Lo script utilizza un file di testo per memorizzare tutte le firme apposte nel libro degli ospiti. Questo consente una rapidissima istallazione, anche sui piani che non prevedono l'utilizzo di un database.

• Come funziona
  
  
  • Richiamando lo script viene visualizzata la lista delle firme con i pulsanti per scorrerla avanti e indietro. Sotto alla lista viene sempre presentato il form per firmare il guestbook.
    
    
    
    
  • Cliccando sul pulsante dettagli posto nella tabella di ogni visitatore, potrete vedere i dettagli di chi ha firmato, compreso il suo indirizzo e-mail, non visibile dalla lista. Questa opzione può essere disabilitata in maniera da evitare che l'indirizzo di posta possa essere reso pubblico.
    
    
• Installazione
  
  
  • scaricate il file da questo link: guestbook.zip
    
    
  • scompattate il file e caricatelo in una cartella del vostro sito
    
    
  • configurate i permessi di scrittura sulla cartella. Se avete un piano Windows potete farlo attraverso il pannello di controllo alla voce permessi cartelle e files. Se avete un piano Linux, potete impostare i permessi tramite un client FTP, configurando la cartella tramite chmod 777.
    Non cambiate nome al file, lasciate il nome guestbook.php
    
    
  • nella stessa cartella create il file di testo guests.txt, vuoto.
    
    
  • aprite il browser e richiamate la pagina guestbook.php
• Configurazione
  
  Il guestbook.php è costruito a partire da una classe, che consente di personalizzare alcuni parametri attraverso le caratteristiche della classe stessa.
  
  

    // parametri
      // numero di record mostrato per pagina: 
  	// è possibile modificare questo valore a vostro piacimento
    var $record_per_pagina = 3;
      // informazioni sulla locazione e sul nome del file di testo
    var $percorso_fisico_guest = "";
    var $guesttxt = "guests.txt";
    var $nomefile;
      // larghezza in pixel della tabella esterna
    var $larghezza_tabella = "500";
      // settando questa opzione a vero,
  	// il visitatore potrà visualizzare i dettagli di un singolo record
    var $mostra_dettagli = true;
  

  
  
  
  • $mostra_dettagli
    Questa caratteristica è di tipo boolean. Se impostata a true, allora per ogni visitatore sarà possibile visualizzare i dettagli, altrimenti il pulsante dettagli non comparirà nella lista dei visitatori.
    
    
  • $larghezza_tabella
    stabilisce la larghezza in pixel della tabella, in maniera che possiate facilmente adattarla al vostro sito.
    
    
  • $record_per_pagina
    stabilisce il numero di visitatori da mostrare per ogni pagina del guestbook.
    
    
  • $percorso_fisico_guest
    $guesttxt
    qualora desideraste conservare, e/o rinominare, il file di testo del guestbook in una cartella differente da quella dello script, potete configurare opportunamente il percorso fisico e reimpostare il nome del file.
  
  
  Poichè tutto il guestbook è contenuto in una classe, potete personalizzare lo script come desiderate utilizzando i metodi dell'interfaccia pubblica, i cui nomi sono "autoesplicativi":
  
  
  • mostra_record($indice)
    Crea l'html che mostra le informazioni complete di un singolo visitatore, esattamente quello indicato dal parametro $indice
    
    
  • mostra_lista()
    crea l'html per mostrare la lista completa dei visitatori. Si preoccupa anche di gestire la paginazione dei record.
    
    
  • leggi_dati()
    crea l'html con il form per l'immissione dati di un nuovo visitatore.
    
    
  • aggiungi_record()
    aggiunge fisicamente una riga al file di testo contenente le firme.
  
  
  Potete utilizzare questo script così com'è anche includendo il guestbook in un iframe:
  
  

  <iframe width="500" height="1000" marginwidth="0"
  marginheight="0" src="/guestbook.php">
  </iframe>