Namespace principale di gino. More...

Namespaces
	App

	Exception
	Namespace che comprende tutte le classi di tipo Exception

	Http
	Namespace che comprende tutte le classi per la gestione di rischieste e risposte http

	Plugin
	Namespace che comprende classi di tipo plugin

	Test
	Namespace che comprende gli UNIT TEST di classi e funzioni di gino

Data Structures
class	Access
	Classe per la gestione dell'autenticazione ed accesso alla funzionalità More...

class	AdminTable
	Gestisce l'interfaccia di amministrazione di un modello con inserimento, modifica ed eliminazione. More...

class	BooleanBuild
	Gestisce i campi di tipo BOOLEAN. More...

class	BooleanField
	Rappresenta campi di tipo BOOLEAN. More...

class	Build
	Gestisce i campi del modello. More...

class	Cache
	Classe che viene estesa da Gino.OutputCache() e Gino.DataCache() More...

class	Captcha
	Classe per la generazione di immagini captcha. More...

class	CharBuild
	Gestisce i campi di tipo stringa (CHAR, VARCHAR) More...

class	CharField
	Campi di tipo stringa (CHAR, VARCHAR) More...

class	CheckboxWidget
	Campi checkbox nei form. More...

class	Compressor
	Classe per la compressione di css e js (merge e minify) More...

class	ConstantWidget
	Campi di tipo costante nei form. More...

class	Controller
	Classe astratta primitiva di tipo Controller (MVC), dalla quale tutti i controller delle singole app discendono. More...

class	Core
	Gestisce una Gino.Http.Request ed invia una Gino.Http.Response adeguata. More...

class	Css
	Libreria per la gestione dei file css dei singoli moduli e dei file css del layout (da associare alle skin) More...

class	DataCache
	Memorizza le strutture dati scrivendo su file. More...

class	DateBuild
	Gestisce i campi di tipo data. More...

class	DateField
	Campo di tipo data. More...

class	DatetimeBuild
	Gestisce i campi di tipo DATETIME. More...

class	DatetimeField
	Campo di tipo DATETIME. More...

class	DatetimeWidget
	Campi di tipo datetime nei form. More...

class	DateWidget
	Campi di tipo date nei form. More...

class	Db
	Classe Factory e Singleton usata per creare oggetti che si interfacciano al database. More...

interface	DbManager
	Interfaccia per le librerie di connessione al database. More...

class	DirectoryBuild
	Gestisce i campi di tipo DIRECTORY. More...

class	DirectoryField
	Campo di tipo DIRECTORY. More...

class	Document
	Crea il documento html da inviare come corpo della risposta HTTP. More...

class	EditorWidget
	Campi di tipo editor nei form. More...

class	EmailBuild
	Campo di tipo EMAIL. More...

class	EmailField
	Campo di tipo EMAIL. More...

class	EmailWidget
	Campi di tipo email nei form. More...

class	EnumBuild
	Gestisce i campi di tipo ENUM. More...

class	EnumField
	Campo di tipo ENUM. More...

class	Error
	Classe per la gestione di errori da mostrare all'utente E' possibile anche mostrare dei warning per facilitare il debug. More...

class	EventDispatcher
	Classe di tipo Mediator e Singleton per la gestione di segnali (eventi) tra oggetti. More...

class	Export
	Libreria per l'esportazione di tabelle o dati. More...

class	Field
	Gestisce le caratteristiche del tipo di campo (colonne) More...

class	FileBuild
	Campo di tipo FILE. More...

class	FileField
	Campo di tipo FILE. More...

class	FileWidget
	Campi di tipo file nei form. More...

class	FloatBuild
	Gestisce campi di tipo decimale (FLOAT, DOUBLE, DECIMAL) More...

class	FloatField
	Campo di tipo decimale (FLOAT, DOUBLE, DECIMAL) More...

class	FloatWidget
	Campi di tipo float nei form. More...

class	ForeignKeyBuild
	Campo di tipo chiave esterna. More...

class	ForeignKeyField
	Campo di tipo chiave esterna. More...

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

class	Frontend
	Libreria per la gestione dei file di front-end dei singoli moduli (css e viste) More...

class	GImage
	Classe per il trattamento di immagini. More...

class	GTag
	Classe per il trattamento di campi di tipo tag. More...

class	HiddenWidget
	Campi di tipo hidden nei form. More...

class	ImageBuild
	Gestisce campi di tipo IMMAGINE. More...

class	ImageField
	Campo di tipo IMMAGINE. More...

class	ImageWidget
	Campi di tipo immagine nei form. More...

class	Input
	Input form. More...

class	IntegerBuild
	Campo di tipo INTERO. More...

class	IntegerField
	Campo di tipo INTERO. More...

class	Javascript
	Contiene i metodi per includere alcuni javascript. More...

class	JSMin
	PHP implementation of Douglas Crockford's JSMin. More...

class	JSMinException
	JSMinException. More...

class	Loader
	Loader di classi di tipo Gino.Model e classi di sistema. More...

class	Locale
	Libreria per la gestione delle traduzioni che non utilizzano le librerie gettext. More...

class	Logger
	Classe per la notifica di log di sistema. More...

class	ManyToManyBuild
	Gestisce i campi di tipo many to many. More...

class	ManyToManyField
	Campo di tipo many to many. More...

class	ManyToManyThroughBuild
	Gestisce i campi di tipo many to many con associazione attraverso un modello che porta informazioni aggiuntive. More...

class	ManyToManyThroughField
	Campo di tipo many to many con associazione attraverso un modello che porta informazioni aggiuntive. More...

class	MobileDetect
	Verifica se una richiesta HTTP è stata effettuata da un dispositivo mobile. More...

class	Model
	Classe astratta che definisce un modello, cioè un oggetto che rappresenta una tabella su database. More...

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

class	MulticheckBuild
	Gestisce i campi di tipo multicheck. More...

class	MulticheckField
	Campo di tipo multicheck. More...

class	MulticheckWidget
	Campi di tipo multicheck nei form. More...

class	Options
	Gestisce le opzioni di classe, costruendo il form ed effettuando l'action. More...

class	OutputCache
	Memorizza gli output (text, html, xml) scrivendo su file. More...

class	Paginator
	Gestisce la paginazione di elementi dati il numero di elementi totali ed il numero di elementi per pagina, ricava i limiti per creare il sottoinsieme di elementi da mostrare e gestisce la navigazione tra le pagine. More...

class	PasswordWidget
	Campi di tipo password nei form. More...

class	RadioWidget
	Campi di tipo radio button nei form. More...

class	Registry
	Registro di gino. More...

class	Router
	Gestisce il routing di una request HTTP, chiamando la classe e metodo che devono fornire risposta. More...

class	Search
	Libreria per ricerche full text pesate sulle tabelle. More...

class	SelectWidget
	Campi di tipo select nei form. More...

class	Session
	Classe per la gestione delle variabili di sessione. More...

class	Singleton
	Classe astratta per implementazione del Singleton pattern. More...

class	Skin
	Libreria per la gestione delle Skin. More...

class	SlugBuild
	Getisce i campi di tipo SLUG (CHAR, VARCHAR) More...

class	SlugField
	Campo di tipo SLUG (CHAR, VARCHAR) More...

class	sqlcode
	Contiene query e codice sql personalizzato. More...

class	SqlParse
	Classe per gestire il parser dei file sql (Code freely adapted from phpBB Group) More...

class	TagBuild
	Gestisce i campi per inserimento tag. More...

class	TagField
	Classe per la gestione di campi per inserimento tag. More...

class	Template
	Libreria per la gestione dei template del documento html da associare alle Gino. More...

class	TextareaWidget
	Campi di tipo textarea nei form. More...

class	TextBuild
	Campo di tipo TEXT. More...

class	TextField
	Campo di tipo TEXT. More...

class	TextWidget
	Campi di tipo testo nei form. More...

class	TimeBuild
	Gestisce i campi di tipo TIME. More...

class	TimeField
	Campo di tipo TIME. More...

class	TimeWidget
	Campi di tipo orario nei form. More...

class	Translation
	Classe per la gestione delle traduzioni. More...

class	UnitWidget
	Insieme di campi di un modello. More...

class	View
	Gestisce le viste, impostando il template e ritornando l'output. More...

class	Widget
	Definisce quale tipo di input associare a ciascun widget. More...

class	YearBuild
	Gestisce i campi di tipo ANNO. More...

class	YearField
	Campo di tipo ANNO. More...

Functions
	browsers ()
	Lista di browser popolari. More...

	robots ()
	Lista di web robots popolari. More...

	platforms ()
	Lista di piattaforme popolari. More...

	get_browser_info ($arg='', $agent='')
	Informazioni browser. More...

	is_browser ($name)
	Verifica se il borwser è quello dato come argomento. More...

	is_browser_version ($version)
	Verifica la versione del browser. More...

	is_browser_platform ($platform)
	Verifica la piattaforma del browser. More...

	is_robot ()
	Verifica se il client è un robot. More...

	searchNameFile ($dir)
	Lista files contenuti in una directory. More...

	download ($full_path)
	Forza il download di un file. More...

	extension ($filename, $extensions)
	Controlla le estensioni dei file. More...

	baseFileName ($filename)
	Ricava il nome del file senza l'estensione. More...

	deleteFileDir ($dir, $delete_dir=TRUE)
	Elimina ricorsivamente i file e le directory. More...

	extensionFile ($filename)
	Estensione di un file. More...

	verifyExtension ($filename, $extensions)
	Controlla se l'estensione di un file è valida. More...

	relativePath ($abspath)
	Ricava il percorso relativo a partire da un percorso assoluto. More...

	absolutePath ($relpath)
	Ricava il percorso assoluto a partire da un percorso relativo. More...

	gOpt ($opt_name, $opt_array, $default)
	Restituisce l'elemento di un array corrispondente alla chiave data oppure un valore di default. More...

	arrayToObject (array $array)
	Trasforma un array in un oggetto. More...

	checkEmail ($value, $regexp=null)
	Verifica la validità dell'indirizzo email. More...

	dateToDbDate ($date, $s='/')
	Formatta la data per il database (YYYY-MM-DD) More...

	dbDateToDate ($db_date, $s='/', $num_year=4)
	Converte il formato della data da database (campo DATE) in un formato di facile visualizzazione (DD/MM[/YYYY]) More...

	dbDatetimeToDate ($datetime, $s='/', $num_year=4)
	Converte il formato della data da database (campo DATETIME) in un formato di facile visualizzazione (DD/MM[/YYYY]) More...

	dbDatetimeToTime ($datetime)
	Riporta l'orario di un campo DATETIME (HH:MM:SS) More...

	dbTimeToTime ($db_time, $seconds=false)
	Mostra l'orario (HH:MM[:SS]) More...

	timeToDbTime ($time)
	Formatta l'orario per il database (HH:MM:SS) More...

	dbNumberToNumber ($number, $decimals=2)
	Formatta un numero con il raggruppamento delle centinaia. More...

	numberToDB ($number)
	Formatta un numero per il database (il separatore decimale è il punto) More...

	isNumeric ($variable)
	Controlla se una variabile è un numero o una stringa numerica. More...

	timeDiff ($firstTime, $lastTime)
	Calcola l'intervallo di tempo in secondi tra due valori datetime. More...

	dateDiff ($interval, $datefrom, $dateto, $using_timestamps=false)
	Calcola la differenza di tempo tra due datetime in più formati. More...

	getDateDiff ($start_date, $end_date=null, $options=array())
	Calcola la differenza di tempo tra due datetime in più formati. More...

	isValid ($type, $var)
	Verifica se il valore della variabile è conforme al tipo di controllo indicato. More...

	cutHtmlText ($html, $length, $ending, $strip_tags, $cut_words, $cut_images, $options=null)
	Accorcia un testo HTML alla lunghezza desiderata (length) More...

	cutString ($string, $max_char, $word_complete=true, $file=false)
	Limita i caratteri di una stringa. More...

	listProv ()
	Elenco delle province. More...

	share ($site, $url, $title=null, $description=null)
	Codice html di condivisione social network. More...

	shareAll ($social, $url, $title=null, $description=null)
	Codice condivisione social network con integrazione sharethis. More...

	traslitterazione ($numero, $decimale=false)
	Converte un numero in cifre. More...

	convertSize ($size)
	Converte la dimensione di un file in un formato leggibile (KB,GB,...) More...

	enabledPng ()
	Verifica la validità del supporto PNG. More...

	enabledZip ()
	Verifica la validità della classe ZipArchive. More...

	cryptMethod ($string, $crypt)
	Cripta la password dell'utente. More...

	emailPolicy ()
	Testo della policy di una email. More...

	obj_serialize ($instanceName, $object)
	Operazione di serializzazione. More...

	obj_unserialize ($instanceName)
	Operazione di deserializzazione. More...

	icon ($name, $options=array())
	Icone. More...

	convertToHtml ($value)
	Converte l'encoding di un valore preso da un campo di un database (non UTF-8) nella codifica UTF-8. More...

	convertToDatabase ($value, $character_set=null)
	Converte l'encoding di un valore da html (es UTF-8) a un encoding valido per il database. More...

	strip_tags_attributes ($text, $strip_js=true, $strip_attributes=true)
	Rimuove gli attributi javascript insicuri nei tag html. More...

	strip_selected_tags ($text, $tags='', $stripContent=false)
	Rimuove i tag indicati Funziona in modo opposto alla funzione strip_tags() con la quale è possibile indicare i tag da preservare. More...

	strip_embedded_tags ($text)
	Rimuove i tag di tipo embedded (unitamente al testo incluso) More...

	clean_text ($value, $options=array())
	Clean plain text Rimuove tutti i tag html. More...

	clean_html ($value, $options=array())
	Clean html Se viene impostata l'opzione strip_tags, vengono rimossi tutti i tag html dal testo a parte quelli presenti nell'opzione. More...

	clean_bool ($value)
	Clean boolean. More...

	clean_int ($value)
	Clean integer. More...

	clean_float ($value)
	Clean float. More...

	clean_date ($value, $options=array())
	Clean date. More...

	clean_time ($value, $options=array())
	Clean time. More...

	clean_email ($value, $options=array())
	Clean email. More...

	clean_array ($value, $options=array())
	Clean array. More...

	cleanVar ($method, $name, $type, $strip_tags= '', $options=array())
	Modifica il valore presente in un campo del form per inserirlo nel database È stato mantenuto per mantenere la compatibilità con le versioni precedenti. More...

	utf8_urldecode ($value)
	Conversione dei dati Unicode $_GET/$_POST (generati dalla funzione javascript escape()) in UTF8 per il processo server-side. More...

	codeToDB ($method, $name, $options=array())
	Modifica il valore presente in un campo testo del form per inserirlo nel database Testo di tipo "codice", nel quale non viene rimosso il codice html. More...

	htmlChars ($string, $id='', $options=array())
	Modifica il valore di un campo di tipo testo per visualizzarlo in HTML. More...

	preCodeParser ($string)
	Modifica il valore di un campo testuale di tipo "codice" per visualizzarlo in HTML Testo di tipo "codice", ovvero inserito con la funzione codeToDB(). More...

	codeParser ($string, $id='')
	Modifica il valore di un campo testuale di tipo "codice" per visualizzarlo in HTML Testo di tipo "codice", ovvero inserito con la funzione codeToDB(). More...

	slimboxReplace ($string, $id)
	Modifica il valore di un campo di tipo testo per attivare le librerie slimbox. More...

	htmlCharsText ($string)
	Mostra il valore di un campo di tipo testo formattato come "solo testo" Inserisce dei tag BR prima di ogni nuova linea in una stringa (sostituisce i caratteri di fine riga \r\n) More...

	htmlInput ($string)
	Modifica il valore di un campo di tipo testo per visualizzarlo in un input form. More...

	codeInput ($string)
	Modifica il valore di un campo di tipo testo per visualizzarlo in un input form di tipo "solo testo". More...

	enclosedField ($string)
	Racchiude il testo tra virgolette singole. More...

	jsVar ($string, $newline=false)
	Escape testo che deve essere passato come variabile javascript. More...

	attributeVar ($string)
	Escape testo che deve essere racchiuso in attributi html. More...

	htmlToEntities ($string)
	Converte le entities HTML, ma non i tag. More...

	encode_params ($params)
	Codifica i parametri url. More...

	decode_params ($params)
	Decodifica i parametri url. More...

Variables
const	SITE_ROOT dirname(realpath(__FILE__))
	SITE_ROOT Percorso assoluto alla root directory More...

const	SITE_WWW $site_www
	SITE_WWW Percorso relativo dell'applicazione a partire dalla root directory More...

const	GIMAGE_DIR CONTENT_DIR.OS.'gimage'

const	TBL_MODULE 'sys_module'
	Nome della tabella che contiene le istanze di moduli. More...

const	TBL_MODULE_APP 'sys_module_app'
	Nome della tabella che contiene i moduli installati. More...

const	TBL_SYS_CONF 'sys_conf'
	Nome della tabella che contiene la configurazione del sistema. More...

const	TBL_LOG_ACCESS 'sys_log_access'
	Nome della tabella che contiene il log degli accessi. More...

const	TBL_USER 'auth_user'
	Nome della tabella utenti. More...

const	TBL_USER_ADD 'auth_user_add'
	Nome della tabella informazioni aggiuntive utenti. More...

const	TBL_USER_GROUP 'auth_user_group'
	Nome della tabella di join utenti - gruppi. More...

const	TBL_GROUP 'auth_group'
	Nome della tabella dei gruppi di utenti. More...

const	TBL_GROUP_PERMISSION 'auth_group_perm'
	Nome della tabella di join gruppi - permessi. More...

const	TBL_PERMISSION 'auth_permission'
	Nome della tabella dei permessi. More...

const	TBL_USER_PERMISSION 'auth_user_perm'
	Nome della tabella di join utenti - permessi. More...

const	TBL_REGISTRATION_PROFILE 'auth_registration_profile'
	Nome della tabella dei profili di registrazione utenti. More...

const	TBL_REGISTRATION_PROFILE_GROUP 'auth_registration_profile_group'
	Nome della tabella di associazione profili di registrazione utenti - gruppi. More...

const	TBL_REGISTRATION_REQUEST 'auth_registration_request'
	Nome della tabella delle richieste di registrazione. More...

const	TBL_LANGUAGE 'language'
	Nome della tabella lingue. More...

const	TBL_TRANSLATION 'language_translation'
	Nome della tabella traduzioni. More...

const	TBL_NATION 'nation'
	Nome della tabella nazioni. More...

const	OS DIRECTORY_SEPARATOR
	Separatore di directory definito dal sistema operativo. More...

const	CACHE_DIR SITE_ROOT.OS.'cache'
	Percorso assoluto alla directory cache. More...

const	LIB_DIR SITE_ROOT.OS.'lib'
	Percorso assoluto alla directory lib. More...

const	CLASSES_DIR LIB_DIR.OS.'classes'
	Percorso assoluto alla directory che contiene le classi che non fanno parte di moduli. More...

const	FIELDS_DIR CLASSES_DIR.OS.'fields'
	Percorso assoluto alla directory che contiene le classi che descrivono campi di db. More...

const	APP_DIR SITE_ROOT.OS.'app'
	Percorso assoluto alla directory che contiene le directory dei moduli. More...

const	PLUGIN_DIR LIB_DIR.OS.'plugin'
	Percorso assoluto alla directory che contiene plugins. More...

const	CSS_DIR SITE_ROOT.OS.'css'
	Percorso assoluto alla directory che contiene css. More...

const	TPL_DIR SITE_ROOT.OS.'templates'
	Percorso assoluto alla directory che contiene templates. More...

const	VIEWS_DIR SITE_ROOT.OS.'views'
	Percorso assoluto alla directory che contiene viste generiche di sistema. More...

const	GRAPHICS_DIR SITE_ROOT.OS.'graphics'
	Percorso assoluto alla directory che contiene file di grafica. More...

const	CONTENT_DIR SITE_ROOT.OS.'contents'
	Percorso assoluto alla directory che contiene upload degli utenti. More...

const	FONTS_DIR SITE_ROOT.OS.'fonts'
	Percorso assoluto alla directory che contiene fonts files. More...

const	TMP_DIR '/tmp'
	Percorso assoluto alla directory per la creazione di file temporanei. More...

const	HOME_FILE SITE_WWW.'/'.$home_file
	Percorso relativo dello SCRIPT_FILE. More...

const	CSS_WWW SITE_WWW.'/css'
	Percorso relativo alla directory dei css. More...

const	SITE_APP SITE_WWW.'/app'
	Percorso relativo alla directory che contiene i moduli. More...

const	SITE_IMG SITE_WWW.'/img'
	Percorso relativo alla directory che contiene immagini si sistema. More...

const	SITE_GRAPHICS SITE_WWW.'/graphics'
	Percorso relativo alla directory che contiene file di grafica. More...

const	SITE_LIB SITE_WWW.'/lib'
	Percorso relativo alla directory lib. More...

const	SITE_JS SITE_LIB.'/js'
	Percorso relativo alla directory che contiene librerie javascript. More...

const	SITE_CUSTOM_CKEDITOR SITE_LIB.'/custom_ckeditor'
	Percorso relativo alla directory che contiene file di customizzazione ckeditor. More...

const	CONTENT_WWW SITE_WWW.'/contents'
	Percorso relativo alla directory che contiene file uploadati dall'utente. More...

const	CONTROLLER_CLASS_PREFIX 'class_'
	Prefisso classi di tipo Gino.Controller. More...

const	MODEL_CLASS_PREFIX 'class.'
	Prefisso classi di tipo Gino.Model. More...

const	CORE_CLASS_PREFIX 'class.'
	Prefisso classi non interne a moduli. More...

Detailed Description

Namespace principale di gino.

Contiene tutte le funzioni e classi proprie di gino al suo interno o in uno dei suoi sotto namespaces.

Function Documentation

Gino\absolutePath ( $relpath )

Ricava il percorso assoluto a partire da un percorso relativo.

Parameters

string $relpath percorso relativo

Returns: percorso assoluto

Gino\arrayToObject ( array $array )

Trasforma un array in un oggetto.

Parameters

array $array

Returns: object

Gino\attributeVar ( $string )

Escape testo che deve essere racchiuso in attributi html.

Parameters

string $string

Returns: testo escaped

Gino\baseFileName ( $filename )

Ricava il nome del file senza l'estensione.

Parameters

string $filename nome del file

Returns: nome file senza estensione

Gino\browsers ( )

Lista di browser popolari.

Returns: array

Gino\checkEmail	(	$value,
		$regexp = `null`
	)

Verifica la validità dell'indirizzo email.

Di default verifica la corrispondenza dell'indirizzo email alle specifiche dello standard RFC-2822.

Parameters

string	$value	indirizzo email
mixed	$regexp	se presente verifica la corrispondenza di un indirizzo con una espressione regolare tipo boolean, se vero attiva una espressione regolare restrittiva tipo string, espressione regolare personalizzata

Returns: boolean

Gino\clean_array	(	$value,
		$options = `array()`
	)

Clean array.

Parameters

array	$value	value taken from the request ($_POST[input_name])
array	$options	array associativo di opzioni opzioni del metodo clean_text() datatype (string): tipo di dato degli elementi dell'array; valori validi: int (default), string, float, bool asforminput (boolean): indica se ritornare gli elementi in un array (default true) o separati da virgola in formato stringa

Returns: array, string or null

Gino\clean_bool ( $value )

Clean boolean.

Parameters

int	(0\|1) $value value taken from the request ($_POST[input_name])

Returns: NULL or bool

Gino\clean_date	(	$value,
		$options = `array()`
	)

Clean date.

See also: clean_text()

Parameters

string	$value	value taken from the request ($_POST[input_name])
array	$options	array associativo di opzioni opzioni del metodo Gino.clean_text() typeofdate (string): tipo di data; valori validi: date (default), datetime separator (string): separatore utilizzato nella data (default /)

Returns: NULL or string

Gino\clean_email	(	$value,
		$options = `array()`
	)

Clean email.

See also: clean_text()

Parameters

string	$value	value taken from the request ($_POST[input_name])
array	$options	array associativo di opzioni opzioni del metodo Gino.clean_text()

Returns: NULL or string

Gino\clean_float ( $value )

Clean float.

Parameters

float $value value taken from the request ($_POST[input_name])

Returns: NULL or float

Gino\clean_html	(	$value,
		$options = `array()`
	)

Clean html Se viene impostata l'opzione strip_tags, vengono rimossi tutti i tag html dal testo a parte quelli presenti nell'opzione.

Parameters

string	$value	value taken from the request ($_POST[input_name])
array	$options	array associativo di opzioni escape (boolean): aggiunge le sequenze di escape ai caratteri speciali in una stringa per l'uso in una istruzione SQL (

See also

Gino.Db::escapeString()); default true

strip_tags (string): elenco dei tag da rimuovere (ad esempio '

<quote>')

strip_embedded (boolean): rimuove tutti i tag html di tipo embedded (default false)
allowable_tags (string): elenco dei tag da non rimuovere (ad esempio '

')

Returns: string or null

Gino\clean_int ( $value )

Clean integer.

Parameters

int $value value taken from the request ($_POST[input_name])

Returns: NULL or integer

Gino\clean_text	(	$value,
		$options = `array()`
	)

Clean plain text Rimuove tutti i tag html.

Parameters

string	$value	value taken from the request ($_POST[input_name])
array	$options	array associativo di opzioni escape (boolean): aggiunge le sequenze di escape ai caratteri speciali in una stringa per l'uso in una istruzione SQL (

See also: Gino.Db::escapeString())

Returns: string or null

Gino\clean_time	(	$value,
		$options = `array()`
	)

Clean time.

See also: clean_text()

Parameters

string	$value	value taken from the request ($_POST[input_name])
array	$options	array associativo di opzioni opzioni del metodo Gino.clean_text()

Returns: NULL or string

Gino\cleanVar	(	$method,
		$name,
		$type,
		$strip_tags = `''`,
		$options = `array()`
	)

Modifica il valore presente in un campo del form per inserirlo nel database È stato mantenuto per mantenere la compatibilità con le versioni precedenti.

Parameters

array	$method	parametri della request ($_GET, $_POST, $_REQUEST)
string	$name	nome della variabile
string	$type	tipo di variabile (bool,int,float,string,array)
string	$strip_tags	stringa con i tag da rimuovere, ad esempio "<a><p><quote>"
array	$options	array associativo di opzioni

Returns: testo ripulito

Gino\codeInput ( $string )

Modifica il valore di un campo di tipo testo per visualizzarlo in un input form di tipo "solo testo".

Parameters

string $string

Returns: testo modificato

Gino\codeParser	(	$string,
		$id = `''`
	)

Modifica il valore di un campo testuale di tipo "codice" per visualizzarlo in HTML Testo di tipo "codice", ovvero inserito con la funzione codeToDB().

Crea un blocco che racchiude il codice e ne evidenzia le righe.

See also: codeToDB(); preCodeParser()

Parameters

string	$string
string	$id	codice che raggruppa un insieme di immagini da visualizzare con le librerie slimbox

Returns: testo modificato

Gino\codeToDB	(	$method,
		$name,
		$options = `array()`
	)

Modifica il valore presente in un campo testo del form per inserirlo nel database Testo di tipo "codice", nel quale non viene rimosso il codice html.

Parameters

string	$method	metodo utilizzato (GET, POST, REQUEST)
string	$name	nome della variabile
array	$options	array associativo di opzioni width (string): sovrascrive la larghezza di visualizzazione di una immagine height (string): sovrascrive l'altezza di visualizzazione di una immagine

Returns: testo modificato

Gino\convertSize ( $size )

Converte la dimensione di un file in un formato leggibile (KB,GB,...)

Parameters

integer $size

Returns: string

Gino\convertToDatabase	(	$value,
		$character_set = `null`
	)

Converte l'encoding di un valore da html (es UTF-8) a un encoding valido per il database.

Parameters

string	$value	valore da convertire
string	$character_set	set di caratteri del database CP1252, per SQL Server

Returns: valore convertito

Gino\convertToHtml ( $value )

Converte l'encoding di un valore preso da un campo di un database (non UTF-8) nella codifica UTF-8.

Parameters

string $value valore da convertire

Returns: valore convertito

Gino\cryptMethod	(	$string,
		$crypt
	)

Cripta la password dell'utente.

Parameters

string	$string
string	$crypt	metodo di criptazione; default: proprietà _crypt (impostazioni di sistema)

Returns: password criptata

Gino\cutHtmlText	(	$html,
		$length,
		$ending,
		$strip_tags,
		$cut_words,
		$cut_images,
		$options = `null`
	)

Accorcia un testo HTML alla lunghezza desiderata (length)

Sostituisce l'ultimo carattere con il valore ending se il testo è più lungo di length. Può strippare i TAG.

Parameters

string	$html	stringa HTML da accorciare
integer	$length	lunghezza della stringa da riportare, incluse le ellissi
string	$ending	finale da aggiungere alla stringa accorciata
boolean	$strip_tags	se vero, i TAG HTML saranno sostituiti da niente
boolean	$cut_words	se falso, l'ultima parola della stringa non sarà tagliata
boolean	$cut_images	se vero, la stringa non conterrà immagini
array	$options	array associativo di opzioni endingPosition (string) [in\|out]: posizionamento dei caratteri dell'ending nella struttura html o al di fuori della struttura html (dopo che sono stati chiusi tutti i TAG)

Returns: stringa accorciata

Gino\cutString	(	$string,
		$max_char,
		$word_complete = `true`,
		$file = `false`
	)

Limita i caratteri di una stringa.

Parameters

string	$string	testo da accorciare
integer	$max_char	numero massimo di caratteri
boolean	$word_complete	se vero, mantiene l'ultima parola completa (utile nei select)
boolean	$file	se vero, mostra l'estensione finale del file

Returns: stringa ridotta

Gino\dateDiff	(	$interval,
		$datefrom,
		$dateto,
		$using_timestamps = `false`
	)

Calcola la differenza di tempo tra due datetime in più formati.

Parameters

string	$interval	indica il tipo di numero da ricavare, accetta i valori: yyyy - numero totale di anni q - numero totale di quarti m - numero totale di mesi y - differenza tra numero di giorni (ad es. 1st Jan 2004 è "1", il primo giorno. 2nd Feb 2003 è "33". La differenza è "-32".) d - numero totale di giorni w - numero totale di giorni della settimana ww - numero totale di settimane h - numero totale di ore n - numero totale di minuti s - numero totale di secondi (default)
string	$datefrom	datetime iniziale
string	$dateto	datetime finale
boolean	$using_timestamps	indica se i valori di $datefrom e $dateto sono in formato timestamp (default false)

Returns: differenza di tempo

Gino\dateToDbDate	(	$date,
		$s = `'/'`
	)

Formatta la data per il database (YYYY-MM-DD)

Parameters

string	$date	valore della data (DD/MM/YYYY), generalmente da input form
string	$s	separatore utilizzato nella data

Returns: string

Gino\dbDatetimeToDate	(	$datetime,
		$s = `'/'`,
		$num_year = `4`
	)

Converte il formato della data da database (campo DATETIME) in un formato di facile visualizzazione (DD/MM[/YYYY])

Parameters

mixed	$datetime	valore del campo datetime; string (YYYY-MM-DD HH:MM:SS) or object(DateTime)
string	$s	separatore utilizzato nella data
integer	$num_year	numero di cifre dell'anno da mostrare

Returns: string

Gino\dbDatetimeToTime ( $datetime )

Riporta l'orario di un campo DATETIME (HH:MM:SS)

Parameters

mixed $datetime valore del campo datetime; string (YYYY-MM-DD HH:MM:SS) or object(DateTime)

Returns: string

Gino\dbDateToDate	(	$db_date,
		$s = `'/'`,
		$num_year = `4`
	)

Converte il formato della data da database (campo DATE) in un formato di facile visualizzazione (DD/MM[/YYYY])

Parameters

mixed	$db_date	valore del campo date; string (YYYY-MM-DD) or object(DateTime)
string	$s	separatore utilizzato nella data
integer	$num_year	numero di cifre dell'anno da mostrare

Returns: string

Gino\dbNumberToNumber	(	$number,
		$decimals = `2`
	)

Formatta un numero con il raggruppamento delle centinaia.

1 number_format(float $number, int $decimals = 0, string $dec_point = ',', string $thousands_sep = '.')

Parameters

float	$number	numero
int	$decimals	numero di decimali

Returns: numero formattato

Gino\dbTimeToTime	(	$db_time,
		$seconds = `false`
	)

Mostra l'orario (HH:MM[:SS])

Parameters

mixed	$db_time	valore del campo time o dell'output della funzione dbDatetimeToTime; string (HH:MM:SS) or object(DateTime)
boolean	$seconds	visualizzazione dei secondi

Returns: string

Gino\decode_params ( $params )

Decodifica i parametri url.

Parameters

string $params parametri url

Returns: stringa decodificata

Gino\deleteFileDir	(	$dir,
		$delete_dir = `TRUE`
	)

Elimina ricorsivamente i file e le directory.

Parameters

string	$dir	percorso assoluto alla directory
boolean	$delete_dir	per eliminare anche le directory (default true)

Returns: true

Gino\download ( $full_path )

Forza il download di un file.

Parameters

string $full_path percorso del file

Returns: stream del file o FALSE se il file non si apre in lettura

Gino\emailPolicy ( )

Testo della policy di una email.

Returns: policy

Gino\enabledPng ( )

Verifica la validità del supporto PNG.

Returns: TRUE se supportato, FALSE atrimenti

Gino\enabledZip ( )

Verifica la validità della classe ZipArchive.

Returns: TRUE se abilitato, FALSE altrimenti

Gino\enclosedField ( $string )

Racchiude il testo tra virgolette singole.

La funzione viene utilizzata ad esempio per racchiudere i campi nelle email e nelle esportazioni di file

Parameters

string $string

Returns: testo racchiuso tra virgolette

Gino\encode_params ( $params )

Codifica i parametri url.

Parameters

string $params parametri url

Returns: stringa codificata

Gino\extension	(	$filename,
		$extensions
	)

Controlla le estensioni dei file.

Verifica se il file ha una estensione valida, ovvero presente nell'elenco delle estensioni.

Parameters

string	$filename	nome del file
array	$extensions	elenco delle estensioni valide

Returns: TRUE se $extension è vuoto o se il file ha un'estensione valida

Gino\extensionFile ( $filename )

Estensione di un file.

Parameters

string $filename nome del file

Returns: estensione

Gino\get_browser_info	(	$arg = `''`,
		$agent = `''`
	)

Informazioni browser.

Parameters

string	$arg	proprietà da ritornare (invece di un array completo)
string	$agent	HTTP AGENT, default $_SERVER['HTTP_USER_AGENT']

Returns: informazioni browser, una sola proprietà o un array (agent, name, version, is_bot, platform)

Gino\getDateDiff	(	$start_date,
		$end_date = `null`,
		$options = `array()`
	)

Calcola la differenza di tempo tra due datetime in più formati.

Parameters

string	$start_date	datetime iniziale
string	$end_date	datetime finale (default now)
array	$options	array associativo di opzioni diff (string): tipo di output s, differenza in secondi (default) i, differenza in minuti h. differenza in ore

Returns: differenza di tempo

Utilizza la classe .

Gino\gOpt	(	$opt_name,
		$opt_array,
		$default
	)

Restituisce l'elemento di un array corrispondente alla chiave data oppure un valore di default.

Parameters

string	$opt_name	nome della chiave
array	$opt_array	array associativo
mixed	$default	valore di default

Returns: l'elemento corrispondente alla chiave data oppure il default

Gino\htmlChars	(	$string,
		$id = `''`,
		$options = `array()`
	)

Modifica il valore di un campo di tipo testo per visualizzarlo in HTML.

Parameters

string	$string	testo
string	$id	codice che raggruppa un insieme di immagini da visualizzare con le librerie slimbox
array	$options	array associativo di opzioni newline (boolean): inserisce dei tag BR prima di ogni nuova linea in una stringa (sostituisce i caratteri newline)

Returns: stringa modificata

Gino\htmlCharsText ( $string )

Mostra il valore di un campo di tipo testo formattato come "solo testo" Inserisce dei tag BR prima di ogni nuova linea in una stringa (sostituisce i caratteri di fine riga \r\n)

Parameters

string $string

Returns: testo modificato

Gino\htmlInput ( $string )

Modifica il valore di un campo di tipo testo per visualizzarlo in un input form.

Parameters

string $string

Returns: testo modificato

Gino\htmlToEntities ( $string )

Converte le entities HTML, ma non i tag.

Parameters

string $string

Returns: testo convertito

Gino\icon	(	$name,
		$options = `array()`
	)

Icone.

Parameters

string	$name	codice dell'icona admin attach back cart check close config content duplicate css delete detail download email export feed group help home input insert language layout link list minimize modify new newpdf palette password pdf permission print return revision search sort view
string	$text	testo della proprietà title del tag IMG (sostituisce il testo di default)
string	$tiptype	col valore full si attiva il selettore icon_tooltipfull che richiama il javascript associato

Returns: codice html icona

Gino\is_browser ( $name )

Verifica se il borwser è quello dato come argomento.

Parameters

string $name nome browser

Returns: bool

Gino\is_browser_platform ( $platform )

Verifica la piattaforma del browser.

Parameters

string $platform

Returns: bool

Gino\is_browser_version ( $version )

Verifica la versione del browser.

Parameters

string $version

Returns: bool

Gino\is_robot ( )

Verifica se il client è un robot.

Returns: bool

Gino\isNumeric ( $variable )

Controlla se una variabile è un numero o una stringa numerica.

Parameters

mixed $variable valore della variabile (string|integer|float)

Returns: boolean

Gino\isValid	(	$type,
		$var
	)

Verifica se il valore della variabile è conforme al tipo di controllo indicato.

Parameters

string	$type	tipo di controllo da eseguire IP: indirizzo IP URL: indirizzo URL Email: indirizzo email ISBN: codice ISBN Date: data Time: orario HexColor: codice colore esadecimale
string	$var	valore della variabile

Returns: boolean

Gino\jsVar	(	$string,
		$newline = `false`
	)

Escape testo che deve essere passato come variabile javascript.

Parameters

string	$string
boolean	$newline	mantiene gli 'a capo' (default false)

Returns: testo escaped

Gino\listProv ( )

Elenco delle province.

Returns: array (sigla=>capoluogo)

Gino\numberToDB ( $number )

Formatta un numero per il database (il separatore decimale è il punto)

Parameters

string $number numero

Returns: numero formattato

Gino\obj_serialize	(	$instanceName,
		$object
	)

Operazione di serializzazione.

Viene creato nella directory dei contenuti dell'istanza il file ser_nomeistanza.txt

Parameters

string	$instanceName	nome dell'istanza
object	$object	oggetto da serializzare

Returns: void

Gino\obj_unserialize ( $instanceName )

Operazione di deserializzazione.

Parameters

string $instanceName nome dell'istanza

Returns: object

Gino\platforms ( )

Lista di piattaforme popolari.

Returns: array

Gino\preCodeParser ( $string )

Modifica il valore di un campo testuale di tipo "codice" per visualizzarlo in HTML Testo di tipo "codice", ovvero inserito con la funzione codeToDB().

Crea un blocco che racchiude il codice.

See also: codeToDB()

Parameters

string $string

Returns: testo modificato

Gino\relativePath ( $abspath )

Ricava il percorso relativo a partire da un percorso assoluto.

Parameters

string $abspath percorso assoluto

Returns: percorso relativo

Gino\robots ( )

Lista di web robots popolari.

Returns: array

Gino\searchNameFile ( $dir )

Lista files contenuti in una directory.

Parameters

string $dir percorso della directory (se dir è un percorso relativo, verrà aperta la directory relativa alla directory corrente)

Returns: array di nomi di file

Gino\share	(	$site,
		$url,
		$title = `null`,
		$description = `null`
	)

Codice html di condivisione social network.

Parameters

string	$site	tipo di condivisione (facebook, twitter, linkedin, googleplus)
string	$url	indirizzo da condividere
string	$title	titolo della condivisione
string	$description	descrizione

Returns: codice

Gino\shareAll	(	$social,
		$url,
		$title = `null`,
		$description = `null`
	)

Codice condivisione social network con integrazione sharethis.

Parameters

array	$social	elenco delle tipologie di condivisione (facebook, twitter, linkedin, googleplus, digg); col valore all vengono mostrate tutte le condivisioni
string	$url	indirizzo da condividere
string	$title	titolo della condivisione
string	$description	descrizione

Returns: codice

Gino\slimboxReplace	(	$string,
		$id
	)

Modifica il valore di un campo di tipo testo per attivare le librerie slimbox.

Parameters

string	$string	testo
string	$id	codice che raggruppa un insieme di immagini da visualizzare con le librerie slimbox

Returns: testo modificato

Gino\strip_embedded_tags ( $text )

Rimuove i tag di tipo embedded (unitamente al testo incluso)

Parameters

string $text testo

Returns: string

Gino\strip_selected_tags	(	$text,
		$tags = `''`,
		$stripContent = `false`
	)

Rimuove i tag indicati Funziona in modo opposto alla funzione strip_tags() con la quale è possibile indicare i tag da preservare.

Parameters

string	$text	testo
string	$tags	stringa con i tag da rimuovere, ad esempio "<a><p><quote>"
boolean	$stripContent	rimuove anche il testo contenuto tra l'apertura e la chiusura del tag (default false)

Returns: stringa ripulita

Gino\strip_tags_attributes	(	$text,
		$strip_js = `true`,
		$strip_attributes = `true`
	)

Rimuove gli attributi javascript insicuri nei tag html.

See also: remove_attributes()

Parameters

string	$text	testo
boolean	$strip_js	rimuove gli attributi javascript (default true)
boolean	$strip_attributes	rimuove alcune proprietà quando risultano vuote (default true)

Returns: testo ripulito

Gino\timeDiff	(	$firstTime,
		$lastTime
	)

Calcola l'intervallo di tempo in secondi tra due valori datetime.

Parameters

string	$firstTime	datetime iniziale
string	$lastTime	datetime finale

Returns: intervallo di tempo

Gino\timeToDbTime ( $time )

Formatta l'orario per il database (HH:MM:SS)

Parameters

string $time orario ([00][{,|:}00][{,|:}00])

Returns: string

Gino\traslitterazione	(	$numero,
		$decimale = `false`
	)

Converte un numero in cifre.

Parameters

mixed	$numero	valore da convertire (float\|integer)
boolean	$decimale	se vero, mostra il decimale ([/00])

Returns: numero in cifre

Gino\utf8_urldecode ( $value )

Conversione dei dati Unicode $_GET/$_POST (generati dalla funzione javascript escape()) in UTF8 per il processo server-side.

Parameters

string $value

Returns: stringa decodificata

Gino\verifyExtension	(	$filename,
		$extensions
	)

Controlla se l'estensione di un file è valida.

Parameters

string	$filename	nome del file
array	$extensions	elenco dei formati di file permessi

Returns: TRUE se l'estensione è compresa in quelle date, FALSE altrimenti

Variable Documentation

const APP_DIR SITE_ROOT.OS.'app'

Percorso assoluto alla directory che contiene le directory dei moduli.

const CACHE_DIR SITE_ROOT.OS.'cache'

Percorso assoluto alla directory cache.

const CLASSES_DIR LIB_DIR.OS.'classes'

Percorso assoluto alla directory che contiene le classi che non fanno parte di moduli.

const CONTENT_DIR SITE_ROOT.OS.'contents'

Percorso assoluto alla directory che contiene upload degli utenti.

const CONTENT_WWW SITE_WWW.'/contents'

Percorso relativo alla directory che contiene file uploadati dall'utente.

const CONTROLLER_CLASS_PREFIX 'class_'

Prefisso classi di tipo Gino.Controller.

const CORE_CLASS_PREFIX 'class.'

Prefisso classi non interne a moduli.

const CSS_DIR SITE_ROOT.OS.'css'

Percorso assoluto alla directory che contiene css.

const CSS_WWW SITE_WWW.'/css'

Percorso relativo alla directory dei css.

const FIELDS_DIR CLASSES_DIR.OS.'fields'

Percorso assoluto alla directory che contiene le classi che descrivono campi di db.

const FONTS_DIR SITE_ROOT.OS.'fonts'

Percorso assoluto alla directory che contiene fonts files.

const GIMAGE_DIR CONTENT_DIR.OS.'gimage'

const GRAPHICS_DIR SITE_ROOT.OS.'graphics'

Percorso assoluto alla directory che contiene file di grafica.

const HOME_FILE SITE_WWW.'/'.$home_file

Percorso relativo dello SCRIPT_FILE.

const LIB_DIR SITE_ROOT.OS.'lib'

Percorso assoluto alla directory lib.

const MODEL_CLASS_PREFIX 'class.'

Prefisso classi di tipo Gino.Model.

const OS DIRECTORY_SEPARATOR

Separatore di directory definito dal sistema operativo.

const PLUGIN_DIR LIB_DIR.OS.'plugin'

Percorso assoluto alla directory che contiene plugins.

const SITE_APP SITE_WWW.'/app'

Percorso relativo alla directory che contiene i moduli.

const SITE_CUSTOM_CKEDITOR SITE_LIB.'/custom_ckeditor'

Percorso relativo alla directory che contiene file di customizzazione ckeditor.

const SITE_GRAPHICS SITE_WWW.'/graphics'

Percorso relativo alla directory che contiene file di grafica.

const SITE_IMG SITE_WWW.'/img'

Percorso relativo alla directory che contiene immagini si sistema.

const SITE_JS SITE_LIB.'/js'

Percorso relativo alla directory che contiene librerie javascript.

const SITE_LIB SITE_WWW.'/lib'

Percorso relativo alla directory lib.

const SITE_ROOT dirname(realpath(__FILE__))

SITE_ROOT Percorso assoluto alla root directory

const SITE_WWW $site_www

SITE_WWW Percorso relativo dell'applicazione a partire dalla root directory

const TBL_GROUP 'auth_group'

Nome della tabella dei gruppi di utenti.

const TBL_GROUP_PERMISSION 'auth_group_perm'

Nome della tabella di join gruppi - permessi.

const TBL_LANGUAGE 'language'

Nome della tabella lingue.

const TBL_LOG_ACCESS 'sys_log_access'

Nome della tabella che contiene il log degli accessi.

const TBL_MODULE 'sys_module'

Nome della tabella che contiene le istanze di moduli.

const TBL_MODULE_APP 'sys_module_app'

Nome della tabella che contiene i moduli installati.

const TBL_NATION 'nation'

Nome della tabella nazioni.

const TBL_PERMISSION 'auth_permission'

Nome della tabella dei permessi.

const TBL_REGISTRATION_PROFILE 'auth_registration_profile'

Nome della tabella dei profili di registrazione utenti.

const TBL_REGISTRATION_PROFILE_GROUP 'auth_registration_profile_group'

Nome della tabella di associazione profili di registrazione utenti - gruppi.

const TBL_REGISTRATION_REQUEST 'auth_registration_request'

Nome della tabella delle richieste di registrazione.

const TBL_SYS_CONF 'sys_conf'

Nome della tabella che contiene la configurazione del sistema.

const TBL_TRANSLATION 'language_translation'

Nome della tabella traduzioni.

const TBL_USER 'auth_user'

Nome della tabella utenti.

const TBL_USER_ADD 'auth_user_add'

Nome della tabella informazioni aggiuntive utenti.

const TBL_USER_GROUP 'auth_user_group'

Nome della tabella di join utenti - gruppi.

const TBL_USER_PERMISSION 'auth_user_perm'

Nome della tabella di join utenti - permessi.

const TMP_DIR '/tmp'

Percorso assoluto alla directory per la creazione di file temporanei.

const TPL_DIR SITE_ROOT.OS.'templates'

Percorso assoluto alla directory che contiene templates.

const VIEWS_DIR SITE_ROOT.OS.'views'

Percorso assoluto alla directory che contiene viste generiche di sistema.

Namespaces

Data Structures

Functions

Variables

Detailed Description

Function Documentation

Variable Documentation