|
Quanto detto finora vale per l'uso di moduli fatti da altri. Per sviluppare
i propri moduli, occorre saperne qualcosa di più, e di tipo tecnico.
Innanzitutto, vediamo come si richiamano i moduli. L'accesso è mediato
da un componente di PHPNuke che potremo chiamare "module manager", ed è
accessibile come modules.php. Il module manager gestisce varie operazioni,
la principale delle quali è (per quanto ci riguarda) modload,
selezionata impostando appropriatamente la variabile op. Per la precisione,
l'URL completo che in generale ci consente di accedere ad un modulo è:
http://www.sito.it/modules.php
?op=modload&name=Oroscopo_del_Giorno
&file=index&func=one
Esaminiamo in ordine l'intero URL. Innanzitutto occorre utilizzare il
nome del modulo, che è modules.php. Questo modulo prende una serie
di parametri: il parametro op è essenziale: infatti
seleziona la funzione di caricamento modulo. Il modulo da caricare
viene specificato con l'opzione name; poiché un modulo può
essere composto da più file, il parametro file
si occupa di selezionare quello che vogliamo.. Generalmente, è semplicemente
index. Inoltre nell'URL possiamo aggiungere altri parametri, specifici
del modulo: in particolare solitamente si specifica un parametro che viene
utilizzato per selezionare delle sotto-funzioni del modulo. Questo ultimo
parametro è analogo al parametro op, solo che viene sfruttato internamente
dal modulo, e per questo motivo deve chiamarsi in maniera diversa da op.
Questo fatto è scritto a chiare lettere nella documentazione.
Le variabili riservate sono le seguenti: $index, $name,
$file, $op. Le ultime tre le abbiamo già viste, sono appunto i parametri
standard che vengono passati a al modulo. La variabile $index
è una nostra vecchia conoscenza delle puntate precedenti: indica
se il modulo corrente deve essere visualizzato a tre colonne oppure due.
L'URL di richiamo del modulo deve essere generato anche quando si usano
nelle form. Per esempio se vogliamo richiamare il modulo da una form,
dovremo utilizzare un codice come il seguente:
<form action="modules.php">.
<input type="hidden" name="op" value="modload">
<input type="hidden" name="name" value="Oroscopo_del_Giorno">
<input type="hidden" name="file" value="index">
<input type="hidden" name="func" value="one">
...
</form>
In questo modo i parametri che servono a richiamare il modulo vengono
presi dai campi della form invece di essere espressi direttamente nell'URL.
|