Archivi tag: chronoform

JOOMLA

CHRONOFORM – TUTORIAL 5 – CREARE FORM DI REGISTRAZIONE PER JOOMLA

Una funzione molto interessante di Chronoform è quella che permette di estendere il modulo di registrazione utente di Joomla.

Si tratta di definire un nuovo form che contenga i campi del form di registrazione di Joomla più i campi fondamentali per il nostro dominio applicativo.In questo form definiamo i campi necessari per Joomla :

  • nome
  • username
  • password
  • retype password
  • email
e aggiungiamo tutti i campi tipici del nostro dominio.
Una volta creato il form e connesso alla tabella del database, colleghiamo il form al processo di registrazione di Joomla.
Il collegamento viene fatto in due fasi:
  • Nella sezione modifica del form accediamo alla scheda plugin e abilitiamo il plugin Joomla Registration
  • Nella sezione Form Management selezioniamo il singolo form tramite la checkbox e accediamo alla funzione Joomla Registration. Il sistema mostrerà un form in cui inserire la corrispondenza tra i campi della tabella utenti di Joomla e quelli del nostro form.
A questo punto possiamo verificare il corretto funzionamento del form. Se abbiamo configurato tutto bene al submit del form vedremo popolarsi sia la tabella utenti di joomla che quella del nostro form.
Ultima cosa che resta da fare è modificare il link del modulo di registrazione affinchè carichi il nostro form e non quello tipico di Joomla.
Per fare questo dobbiamo modificare il file
components/com_user/views/register/tmpl/default.php
e introdurre la redirect verso la nostra pagina agendo sui sorgenti in questo modo
defined(‘_JEXEC’) or die(‘Restricted access’);
$mainframe->redirect(‘register.html’);
Buon lavoro
JOOMLA

CHRONOFORM – TUTORIAL 4 – UPLOAD FILE

Nell’articolo di oggi vedremo come gestire l’upload di file con Chronoform. Con questa funzione potremmo aggiungere al nostro form dei campi input di tipo file e con facilità configurare tutti i controlli tipici di un capo di tipo file.

Come primo step carichiamo il form manager di Chronoform, selezioniamo il nostro form e accediamo in modalità modifica tramite il Wizard.

Nel wizard selezionamo un componente di tipo FileUpload e con la funzione di drag and drop la aggiungiamo al nostro form. A questo punto configuriamo le properties dell’oggetto e in particolare configuriamo:

  • Allowed Extensions
  • Maximum File Size in KB
E’ necessario configurare queste variabili, in assenza di valori Chronoform impedirà il caricamento del file.
Modificate le variabili e salvato il form, torniamo al form manager, selezioniamo nuovamente il form tramite il pulsante modifica.
Compare il sistema a scheda e selezionamo la scheda File Uploads.
In questa scheda completiamo la configurazione del form. Possiamo stabilire:
  • il path dove i file verranno salvati (Full upload Path)
  • il formato del nome con cui verranno salvati (FileName format)
  • il messaggio di errore per limite dimensione superiore non rispettato (Size Exceeded error)
  • il messaggio di errore per estensione non supportata (Type not allowed error)
  • il messaggio di errore per limite dimensione inferiore non rispettato (Size less error)
A questo punto potete testare il vostro form e verificare il corretto salvataggio nel file system del file caricato secondo le vostre regole.
JOOMLA

CHRONOFORM – TUTORIAL 3 – NOTIFICA VIA EMAIL

Può essere utile integrare nel nostro form un sistema di notifica via email, notifica via email che può essere inviata al gestore del sito qualora sia necessario una sua approvazione o all’utente stesso come riepilogo di quanto inserito.

Per fare questo Chronoform ci mette a disposizione una comodo sezione in cui poter definire le caratteristiche della email che vogliamo spedire.

Come primo step carichiamo il form manager di Chronoform, selezioniamo il nostro form e accediamo in modalità modifica.

Il sistema carica il sistema a schede a noi noto e in particolare ci soffermiamo sulle schede General, Setup Email e Emails Template:

  • Nella scheda General ci limitiamo ad abilitare la combo Email the results ?
  • Nella scheda Setup Email creiamo le email da inviare al submit dell’utente
  • Nella scheda Emails Template definiamo il body di ciascuna email definita
E’ possibile definire più email da inoltrare tramite i pulsanti disponibili e per ogni email dobbiamo inserire i parametri essenziali altrimenti la notifica resta disabilitata. I parametri obbligatori sono:
  • To
  • Subject
  • From Name
  • From Email
I campi possono essere recuperati dal form stesso e per far ciò occorre usare nel form i campi definiti come Dynamic.
Se sono aggiunti tutti i campi necessari e se sono popolati correttamente nella sezione email properties viene abilitato il campo Enabled.
A questo punto possiamo salvare e ritornare al form manager. Vedremo nella colonna email il numero di email abilitate e quelle disabilitate.
Se avete operato correttamente troverete enabled:1 e disabled:0.
Andiamo al nostro form, proviamo il submit e riceveremo subito la mail con le caratteristiche scelte.

Di default Chronoform definisce per ogni email un body identifico al form creato. E’ possibile cambiare il testo delle mail agendo sulla scheda Email Template, dove troveremo tante sezioni quante sono le email definite. Per ciascuna mail sarà possibile definire il body della mail tramite un comodo Editor WYSIWYG. I campi dinamici, recuperati dal form, vengono passati nel formato {nomeCampo}.

Buona sperimentazione.

JOOMLA

CHRONOFORM – TUTORIAL 2 – CONNETTERE IL FORM AL DATABASE

In questo articolo vedremo come agganciare il form creato nell’articolo precedente ad una tabella del database. Una volta creato il form abbiamo due possibilità:

  • creare una tabella e agganciarla al form creato
  • agganciare il form ad una tabella preesistente.

Vediamo il primo caso. Accediamo alla sezione Forms Management, selezioniamo il nostro form e usiamo la funzione disponibile in alto Create Table. Chronoform aprirà un form per la creazione di una tabella con alcuni campi di audit consigliati. In questo form sarà possibile scegliere il nome della tabella e quali campi del form creato mappare sulla tabella.

Creata la tabella torniamo al nostro form e accediamo alla sezione DB Connection. In questa sezione abilitiamo il data storage e scegliamo dall’elenco la tabella appena creta. A questo punto, una volta pubblicato il form, ogni evento di submit si tradurrà in una insert nella nostra tabella.

Vediamo il secondo caso. Stavolta la tabella è già disponibile e quindi non utilizzeremo la procedura di creazione guidata e relativo mapping. Selezioniamo nuovamente il nostro form e accediamo alla sezione DB Connection. In questa sezione abilitiamo il data storage e scegliamo una tabella preesistente con una sua struttura dati precisa. In questo cosa dobbiamo avere l’accortezza che le property del form abbiamo lo stesso nome dei campi della tabella, altrimenti il rischio è quello di generare tanti record vuoti.

JOOMLA

CHRONOFORM – TUTORIAL 1 – CREARE UN FORM

Inizia una serie di articoli dedicati a Joomla, il celebre CMS scritto in php, utile per chiunque voglia realizzare un sito web senza avere nozioni di HTML e linguaggi server side. L’uso di Joomla è abbastanza intuitivo, e la documentazione a disposizione è precisa ed esauriente, pertanto non penso di scrivere articoli specifici su questa tecnologia. Mi dedicherò ai vari plugin sviluppati per Joomla che permettono di estendere le funzionalità base di Joomla.

Nel momento in cui scrivo sono presenti le versioni:

  • 1.5
  • 1.6 (versione di transizione, non più supportata)
  • 1.7
La più grande differenza tra le versioni è quella relativa la gestione delle utente, con la 1.7 si sono superati i limiti della 1.5 e l’utente può gestire al meglio le ACL, senza alcuna limitazione.
Il componente analizzato in questo articolo è Chronoform, prodotto dalla ChronoEngine, che consente la creazione di form da inserire nel nostro sito.
Il comportamento base di Joomla prevede il sito come una serie di articoli organizzati in sezioni e categorie, articoli che vengono realizzato tramite il comodo editor messo a disposizione. La realizzazione di un form per l’invio di dati richiede l’uso di un componente esterno e la scelta è caduta su Chronoform, altre valide alternative sono analizzabile sul sito ufficiale delle estensioni.
Attualmente sono disponibili due versioni di Chronoform, la 3 e la 4. La versione 4 è una versione riscritta della 3, che aggiunge nuove funzionalità e la gestione degli eventi al potente wizard messo a disposizione. La versione 4 ha una dipendenza da mootools 1.2, quindi se per qualche motivo non potete soddisfare tale dipendenza ripiegate sulla versione 3.
In questo articolo vediamo la creazione di un form con la versione 3.
Una volta installato, seleziona il Wizard del menù, seguendo il percorso Componente/Chronoform/Form Wizard.
Il sistema carica il form e abbiamo la possibilità di costrutire il form aggiungendo tramite drag&drop i componenti messi a disposizione nel menù laterale.
Aggiungiamo i componenti desiderati e concludiamo inserente il pulsante di Submit che ogni form deve avere.
A questo punto salviamo, specificando il nome del form, e il modulo caricherà l’elenco dei form disponibili.
Il form non è ancora pubblicato, ma è possibile pubblicarlo tramite il pulsante messo a disposizione e verificare con il link messo ben in evidenza la sua visualizzazione.
Una volta pubblicato è possibile richiamare la pagina da menù,specificando l’opzione Chronoform e specificando il nome del form stabilito all’atto del salvataggio.