ModelForm Class Reference

Classe per la creazione ed il salvataggio dati di un form. More...

Inheritance diagram for ModelForm:

Collaboration diagram for ModelForm:

Public Member Functions
	__construct ($model, $options=array())
	Costruttore. More...
	getModel ()
	view ($options_form=array(), $options_field=array())
	Interfaccia per il metodo di renderizzazione del form. More...
	get ($fields=array())
	Recupera la struttura dei campi Nel caso in cui non vengano indicati dei campi vengono presi tutti i campi del modello. More...
	save ($options=array(), $options_field=array())
	Salvataggio dei dati a seguito del submit di un form di inserimento/modifica Per attivare l'importazione dei file utilizzare l'opzione import_file e sovrascrivere il metodo readFile(). More...
Public Member Functions inherited from Form
	__construct ($options=array())
	Costruttore. More...
	getFormId ()
	Getter della proprietà $_form_id. More...
	setMethod ($method)
	Setter della proprietà $_method Imposta le proprietà $_method, $_requestVar. More...
	setValidation ($validation)
	Setter della proprietà $_validation. More...
	permission ($options, $fname)
	Permessi di modifica dei campo. More...
	setHidden ($hidden=array())
	Setta la proprietà $_hidden (campi hidden del form) More...
	load ($session_value, $clear=TRUE)
	Recupera i valori inseriti negli input form e salvati nella sessione del form. More...
	saveSession ($session_value=null)
	Salva i valori dei campi del form in una variabile di sessione. More...
	retvar ($name, $default= '')
	Recupera il valore di un campo del form precedentemente salvato. More...
	open ($action, $upload, $list_required, $options=array())
	Parte inziale del form, FORM TAG, TOKEN, REQUIRED Imposta le proprietà $_form_id, $_validation. More...
	close ()
	Chiusura form, FORM TAG. More...
	checkRequired ()
	Controlla la compilazione dei campi obbligatori. More...
	captcha ($options=null)
	Widget Captcha. More...
	checkCaptcha ()
	Verifica del captcha. More...
	render ($model_obj, $opt=array())
	Wrapper per la stampa del form Imposta le proprietà $_form_id, $_validation, $_method, $_requestVar, $_session_value. More...

Static Public Member Functions
static	translationValue ($table, $field, $ref_value, $ref_id)
	Valore della traduzione di un campo. More...
Static Public Member Functions inherited from Form
static	formFieldTranslation ($type, $table, $field, $id_value, $width, $toolbar='')
	Interfaccia che apre o chiude il form per l'inserimento e la modifica delle traduzioni. More...

Protected Member Functions
	readFile ($model, $path_to_file, $options=array())
	Legge il file e ne importa il contenuto. More...
	restore ($table, $filename, $options=array())
	Restore di un file. More...
	dump ($table, $filename, $options=array())
	Dump di una tabella. More...
Protected Member Functions inherited from Form
	makeInputForm ($model, $fields, $options=array(), $inputs=array())
	Generazione automatica del form di inserimento/modifica di un Gino.Model Cicla sulla struttura del modello e per ogni campo costruisce l'elemento del form. More...

Protected Attributes
	$_model
	$_fields
Protected Attributes inherited from Form
	$_registry
	$_request
	$_session

Private Member Functions
	m2mThroughAction ($m2m_name, $m2m_object, $model, $options=array())
	Salvataggio dei campi Gino.ManyToManyThroughField. More...

Detailed Description

Classe per la creazione ed il salvataggio dati di un form.

Fornisce gli strumenti per generare gli elementi del form e per gestire l'upload di file

Copyright

2015 Otto srl (http://www.opensource.org/licenses/mit-license.php) The MIT License

Author

marco guidotti guido.nosp@m.ttim.nosp@m.@gmai.nosp@m.l.co.nosp@m.m

abidibo abidi.nosp@m.bo@g.nosp@m.mail..nosp@m.com

Constructor & Destructor Documentation

__construct	(		$model,
			$options = array()
	)

Costruttore.

Parameters

object	$model
array	$options	array associativo di opzioni fields (array): elenco dei campi da mostrare come input

Member Function Documentation

dump (   $table,   $filename,   $options = array()  )

protected

Dump di una tabella.

See also

Gino.Db::dump()

Parameters

string	$table
string	$filename	nome del file completo di percorso
array	$options	array associativo di opzioni

Returns

string (nome del file di dump)

get

(

$fields = array()

)

Recupera la struttura dei campi Nel caso in cui non vengano indicati dei campi vengono presi tutti i campi del modello.

Parameters

array

$fields

elenco dei campi da mostrare come input

Returns

array(string field => object build)

getModel

(

)

m2mThroughAction (   $m2m_name,   $m2m_object,   $model,   $options = array()  )

private

Salvataggio dei campi Gino.ManyToManyThroughField.

Il salvataggio di questi tipi di campi avviene in automatico utilizzando la class Gino.AdminTable. Non è gestito dalla classe Gino.Model.

Parameters

string	$m2m_name	nome del campo ManytoManyThroughField
\Gino\ManyToManyThroughField	$m2m_object	istanza della classe di tipo Gino.Field che rappresenta il campo
\Gino\Model	$model	istanza del model cui appartiene il campo
	$options	array associativo di opzioni

Returns

risultato operazione, bool o errori

readFile (   $model,   $path_to_file,   $options = array()  )

protected

Legge il file e ne importa il contenuto.

Todo:

Implementare la funzionalità di importazione del file

Parameters

\Gino\Model	$model	oggetto del modello
string	$path_to_file
array	$options	array associativo di opzioni verify_items (array): valori da verificare nel processo di importazione, nel formato array(nome_campo=>valore[, ]) dump (boolean): effettua il dump della tabella prima dell'importazione dump_path (string): percorso del file di dump

Returns

string (log dell'importazione)

restore (   $table,   $filename,   $options = array()  )

protected

Restore di un file.

Todo:

Implementare la funzionalità di restore di un file

See also

Gino.Db::restore()

Parameters

string	$table	nome della tabella
string	$filename	nome del file da importare
array	$options	arra

Returns

boolean

save	(		$options = array(),
			$options_field = array()
	)

Salvataggio dei dati a seguito del submit di un form di inserimento/modifica Per attivare l'importazione dei file utilizzare l'opzione import_file e sovrascrivere il metodo readFile().

See also

Gino.Field::retrieveValue()

Gino.Build::clean()

Gino.Model::save()

Parameters

array	$options	array associativo di opzioni opzioni per il recupero dei dati dal form opzioni per selezionare gli elementi da recuperare dal form removeFields (array): elenco dei campi non presenti nel form viewFields (array): elenco dei campi presenti nel form opzioni per l'importazione di un file import_file (array): attivare l'importazione di un file field_import (string): nome del campo del file di importazione field_verify (array): valori da verificare nel processo di importazione, nel formato array(nome_campo=>valore[, ]) field_log (string): nome del campo del file di log dump (boolean): per eseguire il dump della tabella prima di importare il file dump_path (string): percorso del file di dump
array	$options_field	opzioni per formattare i valori dei campi da salvare nel database

Returns

risultato operazione, bool o errori

static translationValue (   $table,   $field,   $ref_value,   $ref_id  )

static

Valore della traduzione di un campo.

Parameters

string	$table	nome della tabella con il campo da tradurre
mixed	$field	nome o nomi dei campi da recuperare string: nome del campo con il testo da tradurre array: nomi dei campi da concatenare
mixed	$ref_value	valore del campo di riferimento
string	$ref_id	nome del campo di riferimento (generalmente id)

Returns

integer|string

view	(		$options_form = array(),
			$options_field = array()
	)

Interfaccia per il metodo di renderizzazione del form.

See also

Gino.Form::render()

Parameters

array	$options_form	opzioni del form e del layout
array	$options_field	opzioni dei campi

Returns

form html

Field Documentation

$_fields

protected

$_model

protected

---

The documentation for this class was generated from the following file:

• lib/classes/class.ModelForm.php