gino CMS  2.5.0
gino è un CMS scritto in PHP che offre tutti gli strumenti necessari per poter creare un sito web e gestire i contenuti al suo interno in maniera semplice ed efficace, svincolando l'amministratore da conoscenze tecniche di programmazione
page Class Reference

Classe di tipo Gino.Controller per la gestione delle pagine. More...

Inheritance diagram for page:
Collaboration diagram for page:

Public Member Functions

 __construct ()
 Costruttore. More...
 
 commentNotification ()
 Getter dell'opzione comment_notification. More...
 
 getBasePath ($path='abs')
 Percorso base alla directory dei contenuti. More...
 
 getAddPath ($id)
 Percorso della directory di una pagina a partire dal percorso base. More...
 
 accessPage ($options=array())
 Accesso alla visualizzazione delle pagine. More...
 
 showcase ()
 Front end vetrina pagine più lette. More...
 
 box ($id=null)
 Front end pagina inserita nel template del layout. More...
 
 view (\Gino\Http\Request $request)
 Front end pagina. More...
 
 actionComment (\Gino\Http\Request $request)
 Processa il form di inserimento commento. More...
 
 relatedContentsList ($page_entry)
 Lista di contenuti correlati per tag. More...
 
 managePage (\Gino\Http\Request $request)
 Interfaccia di amministrazione del modulo. More...
 
 checkSlug (\Gino\Http\Request $request)
 Controlla l'unicità del valore dello slug. More...
 
 searchSite ()
 Metodo per la definizione di parametri da utilizzare per il modulo "Ricerca nel sito". More...
 
 searchSiteResult ($results)
 Definisce la presentazione del singolo item trovato a seguito di ricerca (modulo "Ricerca nel sito") More...
 
 systemNewsletterList ()
 Adattatore per la classe newsletter. More...
 
 systemNewsletterRender ($id)
 Contenuto di una pagina quanto inserita in una newsletter. More...
 
 feedRSS (\Gino\Http\Request $request)
 Genera un feed RSS standard che presenta gli ultimi 50 post pubblicati. More...
 
- Public Member Functions inherited from Controller
 __construct ($instance_id=0)
 Inizializza il controller. More...
 
 __call ($name, $arguments)
 Funzione chiamata quando si cerca di chiamare un metodo inaccessibile. More...
 
 getInstance ()
 Espone l'id valore dell'istanza. More...
 
 getInstanceName ()
 Espone il nome dell'istanza. More...
 
 getClassName ()
 Espone il nome della classe. More...
 
 getBaseAbsPath ()
 Percorso assoluto alla cartella dei contenuti. More...
 
 getBasePath ()
 Percorso relativo alla cartella dei contenuti. More...
 
 requirePerm ($perm)
 Richiama il metodo ononimo di Access passando in automatico classe e istanza. More...
 
 userHasPerm ($perm)
 Richiama il metodo ononimo di User passando in automatico classe e istanza. More...
 
 link ($instance_name, $method, array $params=array(), $query_string= '', array $kwargs=array())
 Shortcut link per classi di tipo Gino.Controller. More...
 
 linkAdmin (array $params=array(), $query_string= '', array $kwargs=array())
 Shortcut link area amministrativa per classi di tipo Gino.Controller. More...
 
 manageOptions ()
 Interfaccia per la gestione delle opzioni dei moduli. More...
 
 manageFrontend ()
 Interfaccia per la gestione delle viste e css (frontend) More...
 
 manageLocale ()
 Interfaccia per la gestione dei file delle traduzioni. More...
 
 deleteInstance ()
 Eliminazione istanza del modulo Questo metodo deve essere sovrascritto dalle classi istanziabili per permettere l'eliminazione delle istanze. More...
 

Static Public Member Functions

static getClassElements ()
 Restituisce alcune proprietà della classe. More...
 
static outputFunctions ()
 Definizione dei metodi pubblici che forniscono un output per il front-end. More...
 
static explanationTemplate ()
 Linee guida sulla costruzione di un template. More...
 
static getUrlPage ($id, $box=FALSE)
 Indirizzo pagina. More...
 
- Static Public Member Functions inherited from Controller
static getClassElements ()
 Restituisce alcune proprietà della classe. More...
 

Private Member Functions

 formComment ($entry)
 Form di inserimento commento. More...
 
 parseTemplate ($entry, $tpl, $matches)
 Parserizzazione dei template inseriti da opzioni. More...
 
 replaceTplVar ($property, $filter, $obj)
 Replace delle variabili del template. More...
 
 manageEntry ($request)
 Interfaccia di amministrazione delle pagine. More...
 
 manageCtg ()
 Interfaccia di amministrazione delle categorie. More...
 
 manageComment ()
 Interfaccia di amministrazione dei commenti. More...
 

Private Attributes

 $_showcase_title
 Titolo vista vetrina. More...
 
 $_showcase_number
 Numero post in vetrina. More...
 
 $_showcase_tpl_code
 Template elemento in vista vetrina. More...
 
 $_showcase_auto_start
 Avvio automatico animazione vetrina. More...
 
 $_showcase_auto_interval
 Intervallo animazione automatica vetrina. More...
 
 $_entry_tpl_code
 Template pagina. More...
 
 $_box_tpl_code
 Template pagina inserita nel template. More...
 
 $_comment_moderation
 Moderazione dei commenti. More...
 
 $_comment_notification
 Notifica commenti. More...
 
 $_newsletter_entries_number
 Numero di post proposti per la newsletter. More...
 
 $_newsletter_tpl_code
 Template elemento quando inserito in newsletter. More...
 
 $_tbl_opt
 Tabella di opzioni. More...
 

Additional Inherited Members

- Data Fields inherited from Controller
 $_db
 
 $_access
 
 $_session
 
 $_plink
 
 $_trd
 
 $_locale
 
 $_permissions
 
 $_class_name
 
 $_instance
 
 $_instance_name
 
 $_instance_label
 
 $_class_www
 
 $_class_img
 
 $_data_dir
 
 $_data_www
 
 $_view_dir
 
 $_home
 
- Protected Member Functions inherited from Controller
 setPaths ()
 Setta i percorsi di base dell'app. More...
 
 setOption ($option, $options=FALSE)
 Opzioni di classe. More...
 
- Protected Attributes inherited from Controller
 $_registry
 

Detailed Description

Classe di tipo Gino.Controller per la gestione delle pagine.

CARATTERISTICHE

Modulo di gestione pagine, con feed RSS e predisposizione contenuti per ricerca nel sito e newsletter.
Per ogni singola pagina è possibile abilitare l'inserimento dei commenti (il form include un controllo captcha).

PERMESSI

  • visualizzazione pagine private (can_view_private)
  • redazione (can_edit)
  • pubblicazione (can_publish)
  • amministrazione modulo (can_admin)

Il metodo utilizzato per verificare le condizioni di accesso alle pagine è accessPage(). Questo metodo è pubblico e può essere utilizzato anche dalle altre classi e applicazioni, come ad esempio la classe Gino.App.Menu.menu.

POLITICHE DI VISUALIZZAZIONE

Alla visualizzazione di una pagina concorrono i seguenti elementi:

  • pubblicazione della pagina (campo published)
  • visualizzazione a utenti con permesso 'visualizza pagine private' (campo private)
  • visualizzazione a utenti specifici (campo users)

Per un utente non autenticato una pagina è quindi visibile nel caso in cui:

  • è pubblicata (published=1)
  • non è associata a specifici utenti (users='')
  • non è privata (private=0)

OPZIONI CONFIGURABILI

  • titolo vetrina pagine più lette + numero + template singolo elemento
  • template pagina
  • moderazione commenti
  • notifica commenti
  • template per newsletter

OUTPUT

  • vetrina pagine (più lette)
  • pagina
  • feed RSS

##DIRECTORY DEI CONTENUTI

I contenuti non testuali delle pagine sono strutturati in directory secondo lo schema:

  • contents/
  • page/
  • page/
  • [page_id]/

TEMPLATE

Quando una pagina viene richiamata da URL viene chiamato il metodo view().
In questo caso il template di default è quello che corrisponde al campo entry_tpl_code della tabella delle opzioni ('Template vista dettaglio pagina' nelle opzioni vista pagina).
Questo template può essere sovrascritto compilando il campo "Template pagina intera" () nel form della pagina.

Quando una pagina viene richiamata nel template del layout viene chiamato il metodo box().
In questo caso il template di default è quello che corrisponde al campo box_tpl_code della tabella delle opzioni ('Template vista dettaglio pagina' nelle opzioni vista pagina inserita nel template).
Questo template può essere sovrascritto compilando il campo "Template box" () nel form della pagina.

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 ( )

Costruttore.

Returns
istanza di Gino.App.Page.page

Member Function Documentation

accessPage (   $options = array())

Accesso alla visualizzazione delle pagine.

Parameters
arrayoptions array associativo di opzioni
  • page_obj (object): oggetto della pagina
  • page_id (integer): valore ID della pagina
Returns
accesso, bool
actionComment ( \Gino\Http\Request  $request)

Processa il form di inserimento commento.

Parameters
box (   $id = null)

Front end pagina inserita nel template del layout.

Il template di default impostato nelle opzioni della libreria può essere sovrascritto da un template personalizzato (campo box_tpl_code).

Parametri GET:

  • id (integer), valore ID della pagina
See also
self::accessPage()
self::parseTemplate()
Parameters
int$idvalore ID della pagina
Returns
html
checkSlug ( \Gino\Http\Request  $request)

Controlla l'unicità del valore dello slug.

Parameters
\Gino\Http\Request$requestistanza di Gino.Http.Request
Returns
Gino.Http.Response (disponibile / non disponibile)
commentNotification ( )

Getter dell'opzione comment_notification.

Returns
proprietà comment_notification
static explanationTemplate ( )
static

Linee guida sulla costruzione di un template.

Returns
html
feedRSS ( \Gino\Http\Request  $request)

Genera un feed RSS standard che presenta gli ultimi 50 post pubblicati.

Parameters
formComment (   $entry)
private

Form di inserimento commento.

Returns
html, form
getAddPath (   $id)

Percorso della directory di una pagina a partire dal percorso base.

Parameters
integer$idvalore id della pagina
Returns
percorso
getBasePath (   $path = 'abs')

Percorso base alla directory dei contenuti.

Parameters
string$pathtipo di percorso (default abs)
  • abs, assoluto
  • rel, relativo
Returns
percorso
static getClassElements ( )
static

Restituisce alcune proprietà della classe.

Returns
lista delle proprietà utilizzate per la creazione di istanze di tipo pagina
static getUrlPage (   $id,
  $box = FALSE 
)
static

Indirizzo pagina.

Viene utilizzato per le operazione interne a gino (ad es. menu e layout)

Parameters
integer$idvalore ID della pagina
boolean$boxse TRUE restituisce l'indirizzo per una pagina inserita nel template del layout
Returns
url
manageComment ( )
private

Interfaccia di amministrazione dei commenti.

Returns
Gino.Http.Redirect oppure html, interfaccia di back office dei commenti,
manageCtg ( )
private

Interfaccia di amministrazione delle categorie.

Returns
Gino.Http.Redirect oppure html, interfaccia di back office delle categorie,
manageEntry (   $request)
private

Interfaccia di amministrazione delle pagine.

Parameters
\Gino\Http\Request$requestistanza di Gino.Http.Request
Returns
Gino.Http.Redirect oppure html, interfaccia di back office delle pagine,
managePage ( \Gino\Http\Request  $request)

Interfaccia di amministrazione del modulo.

Parameters
\Gino\Http\Request$requestistanza di Gino.Http.Request
Returns
Gino.Http.Response interfaccia di back office
static outputFunctions ( )
static

Definizione dei metodi pubblici che forniscono un output per il front-end.

Questo metodo viene letto dal motore di generazione dei layout (prende i metodi non presenti nel file ini) e dal motore di generazione di voci di menu (presenti nel file ini) per presentare una lista di output associati all'istanza di classe.

Returns
array, METHOD_NAME => array('label' => (string) [label], 'permissions' => (array) [permissions list in the format classname.code_perm])
parseTemplate (   $entry,
  $tpl,
  $matches 
)
private

Parserizzazione dei template inseriti da opzioni.

Parameters
\Gino\App\Page\PageEntry$entryistanza di Gino.App.Page.PageEntry
string$tplcodice del template
array$matchesmatches delle variabili da sostituire
Returns
template parserizzato
relatedContentsList (   $page_entry)

Lista di contenuti correlati per tag.

Parameters
\Gino\App\Page\PageEntry$page_entryistanza di Gino.App.Page.PageEntry
Returns
lista contenuti correlati
replaceTplVar (   $property,
  $filter,
  $obj 
)
private

Replace delle variabili del template.

Parameters
string$propertyproprietà da sostituire
string$filterfiltro applicato
\Gino\App\Page\PageEntry$objistanza di Gino.App.Page.PageEntry
Returns
replace del parametro proprietà
searchSite ( )

Metodo per la definizione di parametri da utilizzare per il modulo "Ricerca nel sito".

Il modulo "Ricerca nel sito" di Gino base chiama questo metodo per ottenere informazioni riguardo alla tabella, campi, pesi etc... per effettuare la ricerca dei contenuti.

Returns
array[string]mixed array associativo contenente i parametri per la ricerca
searchSiteResult (   $results)

Definisce la presentazione del singolo item trovato a seguito di ricerca (modulo "Ricerca nel sito")

See also
Gino.App.SearchSite
Gino.Search
Parameters
array$resultsarray associativo contenente i risultati della ricerca
Returns
html, presentazione item tra i risultati della ricerca
showcase ( )

Front end vetrina pagine più lette.

Returns
html
systemNewsletterList ( )

Adattatore per la classe newsletter.

Returns
array di elementi esportabili nella newsletter
systemNewsletterRender (   $id)

Contenuto di una pagina quanto inserita in una newsletter.

Parameters
int$ididentificativo della pagina
Returns
contenuto pagina
view ( \Gino\Http\Request  $request)

Front end pagina.

Il template di default impostato nelle opzioni della libreria può essere sovrascritto da un template personalizzato (campo tpl_code).

See also
self::accessPage()
self::parseTemplate()
self::formComment()
Gino.App.Page.PageComment::getTree()
Parameters

Field Documentation

$_box_tpl_code
private

Template pagina inserita nel template.

$_comment_moderation
private

Moderazione dei commenti.

$_comment_notification
private

Notifica commenti.

$_entry_tpl_code
private

Template pagina.

$_newsletter_entries_number
private

Numero di post proposti per la newsletter.

$_newsletter_tpl_code
private

Template elemento quando inserito in newsletter.

$_showcase_auto_interval
private

Intervallo animazione automatica vetrina.

$_showcase_auto_start
private

Avvio automatico animazione vetrina.

$_showcase_number
private

Numero post in vetrina.

$_showcase_title
private

Titolo vista vetrina.

$_showcase_tpl_code
private

Template elemento in vista vetrina.

$_tbl_opt
private

Tabella di opzioni.


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