Registry Class Reference

Registro di gino. More...

Inheritance diagram for Registry:

Collaboration diagram for Registry:

Public Member Functions
	__set ($index, $value)
	Imposta il valore di una variabile. More...
	__get ($index)
	Ritorna il valore di una variabile. More...
	propertyExists ($prop)
	Controlla se è stata definita una proprietà del registry. More...
	addCss ($css)
	Aggiunge un file css. More...
	addJs ($js)
	Aggiunge un file javascript. More...
	addCustomJs ($js, $options=array())
	Aggiunge un file javascript con eventuali opzioni. More...
	addMeta ($meta)
	Aggiunge un META TAG. More...
	addHeadLink ($link)
	Aggiunge un LINK TAG. More...
	variables ($var)
	Codice HTML da inserire nell'HEAD del documento della variabile fornita (CSS, JS, META, ...) More...

Private Attributes
	$vars = array()
	Array associativo che contiene le chiavi del registro private. More...

Detailed Description

Registro di gino.

Il registro è un Gino.Singleton che può conservare dati accessibili e modificabili da tutte le classi di gino. Le variabili sono chiavi di un array privato della classe e sono accessibili direttamente grazie all'utilizzo dei metodi __get e __set.

In particolare conserva alcune variabili che vengono utilizzate nella creazione dei template:

• title (valore del tag meta con name 'title')
• description (valore del tag meta con name 'description')
• keywords (valore del tag meta con name 'keywords')
• favicon (percorso relativo della favicon)
• css (array di path di file css)
• js (array di path di file javascript)
• custom_js (array di path di file javascript con eventuali opzioni)
• meta (tag meta aggiuntivi)
• head_links (link)

Copyright

2005-2014 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

Caricamento Javascript

I file Js vengono trattati in diversi modi a seconda del valore della costante DEBUG e del tipo di caricamento nel registro, con Registry::addJS() oppure Registry::addCustomJS().
I file caricati con Registry::addCustomJS() vengono accodati a quelli caricati con Registry::addJS().

Registry::addJS()

Con Debug True i file vengono caricati uno per uno nella versione originale, mentre con Debug False i file vengono minificati e compressi in unico file (Compressor::mergeJs()).
Il file che viene generato viene salvato nella directory cache/js, e viene soltanto recuperato se risulta già presente.

Registry::addCustomJS()

Con Debug True i file vengono caricati uno per uno nella versione originale, mentre con Debug False si devono verificare i valori delle opzioni compress e minify di ogni file.
Se il valore di compress è True il file viene inglobato nel file generale che comprende i file caricati con Registry::addJS(). Naturalmente il file compresso viene anche minificato.
Se il valore di compress è False e il valore di minify è True il file viene minificato, altrimenti viene caricata la sua versione originale.

Member Function Documentation

__get

(

$index

)

Ritorna il valore di una variabile.

Esempio

echo $instance->foo;

Parameters

string

$index

nome della variabile

Returns

valore variabile o null se non definita

__set	(		$index,
			$value
	)

Imposta il valore di una variabile.

Esempio

$instance->foo = 'bar';

Parameters

string	$index	nome della variabile
mixed	$value	valore della variabile

Returns

void

addCss

(

$css

)

Aggiunge un file css.

Esempio

$instance->addCss(CSS_WWW."/file.css");

Parameters

string

$css

percorso relativo al file css

Returns

void

addCustomJs	(		$js,
			$options = array()
	)

Aggiunge un file javascript con eventuali opzioni.

Esempio

$instance->addCustomCss(SITE_JS."/file.js", array('compress'=>false, 'minify'=>false));

Parameters

string	$js	percorso relativo al file javascript
array	$options	array associativo di opzioni compress (boolean): indica se inglobare il contenuto del file nel file generale che comprende i file caricati con Registry::addJS() minify (boolean): indica se effettuare la minificazione del file

Returns

void

addHeadLink

(

$link

)

Aggiunge un LINK TAG.

Esempio

$instance->addHeadLink(array('rel'=>'external', 'title'=>'foo', 'href'=>''));

Parameters

array

$link

elementi di un tag link (rel, type, title, href)

Returns

void

addJs

(

$js

)

Aggiunge un file javascript.

Esempio

$instance->addCss(SITE_JS."/file.js");

Parameters

string

$js

percorso relativo al file javascript

Returns

void

addMeta

(

$meta

)

Aggiunge un META TAG.

Esempio

$instance->addMeta(array('name'=>'bar', 'property'=>'foo'));

Parameters

array

$meta

elementi di un tag meta (name, property, content)

Returns

void

propertyExists

(

$prop

)

Controlla se è stata definita una proprietà del registry.

Parameters

$prop

nome della proprietà

Returns

TRUE se è definita, FALSE altrimenti

variables

(

$var

)

Codice HTML da inserire nell'HEAD del documento della variabile fornita (CSS, JS, META, ...)

Si possono fornire le seguenti chiavi:

• title
• description
• keywords
• favicon
• css
• js
• custom_js
• meta
• head_links

I Css ed i Js sono trattati dalla classe Gino.Compressor che permette la minificazione e merge dei file quando la costante DEBUG definita in configuration.php è settata a FALSE.

See also

Gino.Compressor

Parameters

string

$var

nome della chiave che deve essere recuperata dal registro

Returns

codice html

I file Js vengono trattati in diversi modi a seconda del valore della costante DEBUG e del tipo di caricamento nel registro, con Registry::addJS() oppure Registry::addCustomJS().
I file caricati con Registry::addCustomJS() vengono accodati a quelli caricati con Registry::addJS().

Registry::addJS()

Con Debug True i file vengono caricati uno per uno nella versione originale, mentre con Debug False i file vengono minificati e compressi in unico file (Compressor::mergeJs()).
Il file che viene generato viene salvato nella directory cache/js, e viene soltanto recuperato se risulta già presente.

Registry::addCustomJS()

Con Debug True i file vengono caricati uno per uno nella versione originale, mentre con Debug False si devono verificare i valori delle opzioni compress e minify di ogni file.
Se il valore di compress è True il file viene inglobato nel file generale che comprende i file caricati con Registry::addJS(). Naturalmente il file compresso viene anche minificato.
Se il valore di compress è False e il valore di minify è True il file viene minificato, altrimenti viene caricata la sua versione originale.

Field Documentation

$vars = array()

private

Array associativo che contiene le chiavi del registro private.

---

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

• lib/classes/class.Registry.php