English Version

eForms è un plug-in / bot realizzato da Ioannis Sannos per Elxis. Questo bot  consente di inserire un form (modulo di invio dati) in HTML direttamente nelle pagine dinamiche e pagine autonome di Elxis. Il bot genera il layout del vostro modulo, prelevando gli elementi che lo compongono, da un file XML (data.xml) e processando la sua azione.
Con questo plug-in per Elxis potete creare un numero illimitato di forms (moduli) e inserire più form in una unica pagina.
eForms è validato CSS/XHMTL, RTL compatibile, multi-lingua e validato javascript/PHP per l’invio dei dati.
Il bot/plug-in eForms oer Elxis CMS è fornito con un form di esempio salvato nel file data.xml, e contiene tutti i tipi di elementi che eForms supporta, in maniera da avere una traccia su come deve essere formattato ogni singolo elemento.

Stringa di comando

Per integrare un modulo eforms all’interno del vostra pagina dovete digitare:
{eforms}form_name_here{/eforms}

Come creare il vostro form (modulo invio dati)

Aprire il file mambots/content/eforms/data.xml con un editor di testo come psPas. Il modulo deve essere creato usando il formato XML all'interno dei tag <eforms>...</eforms>.
Ogni modulo deve essere piazzato all'interno dei tags <form>...</form>.

Informazioni generali

All'inizio di ogni tag form, inserire le informazioni generali del vostro modulo:
<form name="nome_vs_modulo" method="POST" action="email">

name
è molto importante e deve essere unico. Inserite il nome del vostro modulo (es: nome_vs_modulo). Questo sarà il nome che dovrà essere utilizzato per richiamare il form nel vostro contenuto testuale.
{eforms}nome_vs_modulo{/eforms}

method
Metodo di invio del modulo.
Le opzioni da utilizzare sono: POST, GET.
Utilizzare method="POST" se l'azione desiderata è l'invio di una e-mail.

action
email se desiderate che sia eForms ad occuparsi dell'invio dei risultati tramite email.
url se desiderate utilizzare un'altro script per l'invio dei dati inseriti nel modulo.
Se l'azione (action) scelta è email, il metodo (method) deve essere POST.

Titolo del form (modulo)
<title>Titolo del form</title>
Se non desiderate visualizzare nessun titolo, lasciatelo vuoto.

Testo descrizione
<description>inserite il vs testo</description>
Descrizione del modulo che viene mostrata sotto il Titolo.
Per inserire testo formattato in HTML, includere il vostro testo all'interno dell'area CDATA
<description><![CDATA[ vostro testo formattato in html ]]</description>

Testo avvenuto invio
<onsuccess>inserite il vs testo</onsuccess>
Messaggio da visualizzare dopo l'avvenuto invio dei dati se action=email.
Per inserire il messaggio in formato HTML, includere il vostro testo all'interno dell'area CDATA
Se questo tag viene omesso o lasciato vuoto, sarà visualizzato un testo di default.

Indirizzi email
<email> ; </email>
Scrivete uno o più indirizzi email separati da ; (punto e virgola) ai quali desiderate far ricevere i dati inviati dal modulo.
Se lasciate vuoto, questo tag, la email sarà inviata all'indirizzo email settato nella configurazione del sito elxis.

Submit button
<submit>Invia Modulo!</submit>
Inserite il testo che sarà visualizzato nel tasto di invio.
Se lasciato vuoto, sarà visualizzata la versione in multilingua della parola "Submit".

Campi del form

Un tag items, identifica l'area dove i campi del form sono positionati.
Ogni campo e descritto da un tag item..

Qui sotto sono riportati tutti i campi che il plug-in eForm supporta.

text.
Genera un input text box,
Se il campo è richiesto settare required="1"
Potete usare anche l'attributo accesskey per visualizzare le chiavi di accesso per i non vedendi (es: accesskey="K")

date
Per inserire la data del giorno utlizzando il calendario di Elxis.

email
sendcopy è opzionale.
Se sendcopy="1", una notifica tramite email sarà inviata all'indirizzo email inserito in questo campo.

number
È come un campo text ma con una validazione differente. Il valore richiesto deve essere una stringa numerica.

url
È come il campo text ma con validazione differente. Il valore inserito deve essere un indirizzo internet (url) valido

textarea
Visualizza un campo textarea per scrivere un testo lungo.
cols e rows sono gli attibuti per settare l'ampiezza di questo campo textarea

select
Visualizza un campo con selezione drop-down.

separator
Visualizza una riga orizzontale. Da usare se volete dividere il modulo in più blocchi.

h3
Visualizza un titolo (h3 tag). Dovrete solo settare l'attributo dell'etichetta (label).
Se volete applicare una classe CSS personalizzata, settate l'attributo class. (version 1.1+).

p
Visualizza un paragrafo di testo (p tag). Dovrete riempire solo l'attributo description. Se volete inserire un testo formattato HTML e/o un testo anzichè scrivere il testo all'interno dell'attributo description, aggiungetelo all'interno del tag item.
Potete applicare una classe CSS personalizzata riempiendo l'attributo class (version 1.1+).

country
Visualizza in automatico un campo con selezione drop-down con i nomi delle nazioni (voci delle nazioni in multilingua).

range
Visualizza un campo con selezione drop-down di un intervallo di numeri  (integers). Nell'attributo options settate il numero minimo e massimo separati da ;  (punto e virgola)
Es.: 10;15 genera questa serie di numeri: 10,11,12,13,14,15.

price
Visualizza un text box the viene validato come prezzo (price);
Usare l'attributo currency per visualizzre le informazioni della valuta.

radio
Genera un gruppo di radio box (tasti radio a pallino).

checkbox
Genara un gruppo check boxex (caselle da barrare).

captcha
Genera campo per l'inserimento di un codice di sicurezza. Questo è un campo obbligatorio. Aggiunto in eForms 1.1.

hidden
Genera un campo testo (input box) nascosto.

Il bot eForms ha i seguenti parametri..

Label width
Settaggio larghezza delle'elemto label. il valore di default è 140.

Description position
Settaggio della posizione di visualizzazione della descrizione di ogni elemento del form (modulo). Le opzioni sono:
Below: sotto l'elemento.
next: accanto all'elemento.

Con questo è tutto.
A voi la fantasia e buon divertimento!