Menu API

ID menu

• getIdMenu()

In base al parametro $menu è possibile sapere l'id_menu tra quelli che sono impostati nel proprio progetto.

/**
* @param $menu
* @param string $id_struttura
* @return int
**/
public function getIdMenu($menu, $id_struttura="") {
  ...
}

Esempio:

echo $cube->getIdMenu('Menu Top');
// '123123' -> esempio di id_menu

Info menu

• getInfoMenu()

Questa funzione permette di conoscere alcune informazione del menu in base all'$id_menu. La funzione restituisce un valore alla volta che è possibile impostare tramite il paramentro $campo.

/**
* @param int $id_menu
* @param string $campo
* @return array
**/
public function getInfoMenu($id_menu, $campo="menu") {
  ...
}

Menu

• getMenu()

Restituisce la struttura completa di un menu in formato array multidimensionale. La funzione recupera tutte le voci del menu con i relativi sotto-menu (figli) in modo ricorsivo, permettendo di costruire menu di navigazione con più livelli di profondità.

/**
* @param int $id_menu
* @param int $parent_id
* @param string $opz
* @param string $filtro
* @param int $visibile
* @return array
**/
public function getMenu($id_menu, $parent_id=0, $opz="", $filtro="", $visibile=1) {
  ...
}

Parametro	Tipo	Default	Valori ammessi o breve descrizione
$id_menu	int | string	null	ID del menu da recuperare.
$parent_id	int	0	ID della voce padre per recuperare solo i figli (0 per il primo livello).
$opz	string	null	Opzioni aggiuntive per la query.
$filtro	string	null	Condizioni WHERE personalizzate per filtrare le voci.
$visibile	int	1	Se 1 mostra solo voci visibili, se 0 mostra tutte le voci.

Ogni voce del menu restituita contiene:

• id_menu_voci: ID della voce di menu
• testo_link: Testo del link da visualizzare
• icona: Icona associata alla voce (se presente)
• link: URL della pagina
• id_pagina: ID della pagina collegata
• tipo: Tipo di voce (0=pagina, 1=link esterno, 2=pagina con testo personalizzato)
• active: Indica se la voce è attiva nella navigazione corrente
• parent_id: ID della voce padre
• depth: Livello di profondità della voce
• target: Target del link (_self, _blank, etc.)
• id_struttura: ID della struttura associata
• figli: Array contenente le voci figlie

Esempio:

// Recupera il menu principale
$menu_principale = $cube->getMenu($cube->getIdMenu('Menu Top'));

// Recupera solo le voci figlie di una voce specifica
$sottomenu = $cube->getMenu('Menu Top', 12345);

// Recupera solo voci visibili con filtro personalizzato
$menu_filtrato = $cube->getMenu($id_menu, 0, "", "tipo = 0", 1);

Menu secondario

• getMenuSecondario()

Restituisce il menu secondario relativo alla pagina corrente. La funzione identifica automaticamente le voci di menu figlie della voce attiva e le restituisce come menu di secondo livello. Utile per creare menu di navigazione contestuali o sidebar di sezione.

/**
* @param int $id_menu
* @param int $opz
* @param int $visibile
* @return array
**/
public function getMenuSecondario($id_menu="", $opz=1, $visibile=1) {
  ...
}

Parametro	Tipo	Default	Valori ammessi o breve descrizione
$id_menu	int | string	menu_top	ID o nome del menu da utilizzare. Se vuoto usa il menu principale.
$opz	int	1	1 per menu figli della voce corrente, altro valore per voce corrente.
$visibile	int	1	Se 1 mostra solo voci visibili, se 0 mostra tutte le voci.

La funzione analizza la posizione corrente nella navigazione e:

• se la voce corrente ha figli, restituisce i menu figli
• se la voce corrente non ha figli ma si trova in un sotto-livello, restituisce i menu della stessa sezione
• restituisce null se non ci sono menu secondari disponibili

Esempio:

// Recupera il menu secondario della sezione corrente
$menu_secondario = $cube->getMenuSecondario();

// Recupera il menu secondario da un menu specifico
$menu_sidebar = $cube->getMenuSecondario('Menu Sidebar');

// Recupera tutte le voci (anche non visibili) con opzione personalizzata
$menu_completo = $cube->getMenuSecondario($id_menu, 2, 0);

Menu secondario terzo livello

• getMenuSecondarioTerzoLivello()

Restituisce il menu di terzo livello relativo a una specifica voce di menu. La funzione recupera le voci figlie di una voce di menu specifica, permettendo di creare menu di navigazione con maggiore profondità. Utile per gestire strutture di menu complesse con più livelli gerarchici.

/**
* @param int $id_menu
* @param int $id_menu_voci
* @return array
**/
public function getMenuSecondarioTerzoLivello($id_menu="", $id_menu_voci="") {
  ...
}

Parametro	Tipo	Default	Valori ammessi o breve descrizione
$id_menu	int | string	menu_top	ID o nome del menu da utilizzare. Se vuoto usa il menu principale.
$id_menu_voci	int	id_menu_voci	ID della voce di menu per cui recuperare i figli. Se vuoto usa quella corrente.

La funzione analizza la struttura del menu e:

• se la voce specificata ha figli, restituisce i menu figli di terzo livello
• se la voce specificata non ha figli ma si trova in un sotto-livello, restituisce i menu della stessa sezione
• restituisce null se non ci sono menu di terzo livello disponibili

// Recupera il menu di terzo livello della voce corrente
$menu_terzo_livello = $cube->getMenuSecondarioTerzoLivello();

// Recupera il menu di terzo livello di una voce specifica
$menu_specifico = $cube->getMenuSecondarioTerzoLivello('Menu Top', 12345);

// Recupera il menu di terzo livello da un menu personalizzato
$menu_custom = $cube->getMenuSecondarioTerzoLivello('Menu Sidebar', $id_voce);

Menu landing

• getMenuLanding()

Restituisce le pagine di tipo "landing" associate a una struttura specifica. La funzione ha comportamenti diversi a seconda del modello della pagina corrente: per la Home Page recupera le landing page impostate come home, mentre per le altre pagine recupera tutte le landing page della stessa categoria o struttura, escludendo la pagina corrente.

/**
* @param int $id_struttura
* @return array
**/
public function getMenuLanding($id_struttura = "") {
  ...
}

Parametro	Tipo	Default	Valori ammessi o breve descrizione
$id_struttura	string	$this->id_struttura	ID della struttura. Se vuoto utilizza l'ID della struttura corrente.

Il comportamento della funzione varia in base al modello della pagina.

Per modelli "Home Page" o "Home Page Strutture":

• Recupera solo le landing page con home=1
• Filtra per struttura e stato "pubblica"
• Ordina per ID pagina

Per altri modelli:

• Recupera tutte le landing page della struttura
• Esclude la pagina corrente dal risultato
• Filtra per categoria (se presente) o per pagine senza categoria
• Considera solo pagine con stato "pubblica"

Ogni voce restituita contiene:

• id_pagina: ID della pagina landing
• testo_link: Titolo della pagina da utilizzare come testo del link
• link: URL completo della pagina generato tramite getLinkPagina()

// Recupera le landing page della struttura corrente
$landing_pages = $cube->getMenuLanding();

// Recupera le landing page di una struttura specifica
$landing_struttura = $cube->getMenuLanding('12345');

// Esempio di utilizzo per creare un menu di landing page
foreach($landing_pages as $landing) {
    echo '<a href="' . $landing['link'] . '">' . $landing['testo_link'] . '</a>';
}