L'homepage di PHP Nuke è un contenitore che serve ad includere e richiamare i vari blocchi ed i moduli che la compongono. Questa linea è generale ed è applicabile ad ogni pagina di un sito realizzato con questo sistema
Quando accediamo alla pagina inizale del nostro sito, index.php, PHP Nuke effettua le seguenti operazioni:
- Include il file main.php
- Verifica sul database quale modulo è impostato per essere quello iniziale
- Verifica la provenienza dell'utente
Tutti i contenuti vengono richiamati attraverso stringhe (indirizzi o querystring) che contengono le informazioni sui files da includere al file modules.php. Ad esempio con la stringa:
http://www.nostrosito.com/modules.php?name=Downloads
comandiamo che nella pagina modules.php deve essere incluso il file index.php che si trova nella cartella "modules/Downloads".
Nella root (ovvero la cartella principale) sono presenti anche i seguenti files:
- admin.php: Rimanda all'amministrazione del sito
- backend.php: gestisce l'output delle news che possono essere prelevate da altri siti
- config.php: È il file di configurazione di PHP Nuke che contiene le istruzioni per dialogare con il database
- footer.php: Contiene un insieme di variabili relative al footer.
- header.php: Gestisce le variabili relative all'header
- mainfile.php e ultramode.txt: Contengono tutte le funzioni necessarie alla gestione di PHPNuke
- robots.txt: Una serie di istruzioni per i motori di ricerca per indicare quali sono le cartelle da non indicizzare
...e le cartelle:
- "Blocks" contiene tutti i blocchi che vengono inclusi in PHP Nuke
- "Images" in cui sono contenute tutte le immagini relative a PHP Nuke. Ad esempio nella cartella "banners" ci sono tutte le immagini dei banner in rotazione sul sito, etc.
- "include" contiene frammenti di codice scritti su file che sono inclusi, quando occorre, nelle pagine del sito, principalmente in mainfile.php e header.php.
- "language" immagazzina i files di traduzione del modulo base di PHPnuke. Il file di linguaggio deve essere nominato con sintassi lang-nomelingua.php.
- "Modules" serve per contenere le cartelle dei nuovi moduli.
- "themes" vengono aggiunte qui le interfacce grafiche dette "temi", ogni cartella ha il nome del tema in questione che contiene un file principale che si chiama theme.php e gli altri file del tema.
La cartella "admin", dell'amministrazione di PHP Nuke, presenta 4 sotto-cartelle, case, language, links e modules.
Il codice che gestisce l'amministrazione dal punto di vista operativo è contenuto in file nella cartella "modules", mentre la cartella "links" contiene piccoli file che servono per determinare il percorso di uno specifico modulo di amministrazione. Ad esempio per il modulo di amministrazione per le FAQ ecco il contenuto di links.faq.php:
if (($radminsuper==1) OR ($radminfaq==1)) {
adminmenu("admin.php?op=FaqAdmin", ""._FAQ."", "faq.jpg");
}
Questo modulo verifica i diritti di amministrazione, passa un case (op=FaqAdmin) che dice al file admin.php (che include tutti i moduli di admin) quale modulo andare a richiamare, associa un valore per tradurre il termine faq e associa una immagine per l'amministrazione visuale (faq.gif).
La cartella "languages" contiene i file delle lingue e permette di modificare
tutte le voci in lingua che vengono visualizzate sul sito. Infine la cartella "case" contiene quei file che determinano casi per i quali usare moduli particolari. Questo è importante quando, usando lo stesso file di admin si vogliono fare operazioni diverse al verficarsi di certe condizioni.
Case1 = comando 1
Case2 = comando 2
Per esempio nel modulo "faq" i case sono molti, vediamo solo gli ultimi due:
case "FaqAdmin":
case "FaqCatGo": include("admin/modules/adminfaq.php");
break;
Entrambi i case richiamano il file "adminfaq.php" ma gli fanno compiere operazioni diverse. Il primo richiama il file nella schermata di default, il secondo invece concede il permesso di inserire una nuova categoria.
Questo avviene attraverso la stringa (querystring) admin.php?op=FaqAdmin nel primo caso e admin.php?op=FaqCatGo nel secondo.
