Re: [Splatt-Projects] Splatt fuoriuso

[bigmark <bi...@mc...>]

PHP-Nuke Addons e Sistema Moduli
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D


Da PHP-Nuke 5.0 si possono aggiungere nuovi moduli, addons o plugins, =
semplicemente
copiando i file degli addons in una cartella (directory). Con questa =
caratteristica, PHP-Nuke
guadagna la modularit=E0 e il webmaster webmaster la possibilit=E0 di =
installare o disinstallare
i moduli preferiti con una semplice operazione.

Questo documento ha due parti, una per gli utenti/webmaster e l'altra =
per gli sviluppatori di Addons.

Per favore leggilo attentamente e ricorda che questo sistema, come =
l'intero
PHP-Nuke =E8 distribuito senza garanzie e ci=F2 che farai da adesso =E8 =
sotto la
tua responsabilit=E0 e a tuo rischio. Ricorda sempre di salvare in =
backup il tuo
database e tutti i tuoi files prima di fare qualsiasi cosa.


=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
1.- Informazione per gli Utenti/Webmaster
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

Incominciamo dalla cartella "modules"  nella quale puoi aggiungere o =
cancellare tutti
i moduli, gli addons o i plugins che vuoi.

I nomi delle cartelle nella directory /modules/ hanno una regola per =
funzionare:

a) Tutti gli spazi sono sostituiti con la sottolineatura "_", cos=EC se =
per esempio hai un modulo=20
   chiamato Web Links, la tua cartella deve chiamarsi Web_Links
  =20
Lniks ai Moduli saranno automaticamente aggiunti al menu principale in =
fondo alle varie opzioni.=20
Il metodo di selezione, in luogo del tag html LI,
=E8:

<strong>&middot;&nbsp;</strong>Nome Modulo<br>

Ci=F2 per garantire una compatibilit=E0 con HTML 4.0 Transitional, ma se =
vuoi modificare,=20
basta editare il file mainfile.php file alla funzione mainblock(), =
tuttavia
cerca di restare nello standard HTML e elimina ogni tag <LI> da tutti i =
blocchi,=20
perch=E9? Perch=E9 nel nuovo standard devi usare <UL> e </UL> prima e =
dopo gli oggetti
della lista, se non ti atterrai a questo il box non si vedr=E0 bene sul =
sito.

Se vuoi mantenere o provare nuovi Addons ma non vuoi mostrare un suo =
linka link ai tuoi utenti,
fai login come amministratore e clicca sul tuo addon nel blocco Modules. =
Quando copi un nuovo
addon nella cartella /modules/, esso verr=E0 aggiunto automaticamente =
nel tuo database
con lo stato "Inattivo". I Moduli Inattivi possono essere visti e usati =
solo dagli Amministratori.
Se hai Inattivo il blocco Moduli ma vuoi offrire un servizio Moduli, =
basta rendere
Attivo l'addon/modulo (non il blocco) dalla pagina di amministrazione e =
fornire un link del tipo:

http://www.yoursite.com/modules.php?mop=3Dmodload&name=3DAddon_Name&file=3D=
index

dove &name=3DAddon_Name =E8 il nome della cartella nella directory =
Modules
e &file=3Dindex =E8 il nome del file principale in formato .php  (senza =
l'estensione)del tuo modulo.=20
La parte restante dell' URL =E8 richiesta.

Per semplificare la procedura, puoi fornire un link con la variabile =
"name", del tipo:

http://www.yoursite.com/modules.php?name=3DAddon_Name

puoi farlo "solo" se il tuo file =E8 "index.php" e se nessuna funzione =
all'interno viene richiamata.

Quando installi un nuovo modulo per favore assicurati che gli spazi =
vuoti dei nomi delle cartelle
siano sostituiti con "_", per esempio: Web_Links. Il nome della cartella =
=E8 sensibile alle maiuscole e minuscole,=20
ci=F2 significa che non sono la stessa cosa web_links e Web_Links. Il =
carattere "_"
viene automaticamente sostituito con uno spazio vuoto quando il suo link =
appare nel blocco Moduli.=20
Perci=F2 il nome della cartella "Web_Links" verr=E0 cambiato in "Web =
Links".

Inoltre, per favore leggi le istruzioni per gli addon che verranno =
fornite dall'autore dell' addon=20
ai fini dell' installazione.


=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
2.- Informazione per gli Sviluppatori di Addons
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D


Creare un nuovo addon =E8 alquanto facile. Lo sviluppatore deve =
conoscere poche regole:

a) In tutti i file addon ricorda per favore di aggiungere come prime =
linee del codice:
  =20
    if (!eregi("modules.php", $PHP_SELF)) {
	die ("You can't access this file directly...");
    }

    Ci=F2 per evitare un accesso diretto ai files dell' addon, cos=EC =
gli utenti dovranno
    cliccare sul vostro linkso users need to click, e assicuriamo che il =
layout del tema=20
    venga incluso in ogni pagina.

b) La migliore soluzione =E8 seguire il sistema delle traduzioni =
attraverso defines. Per farlo
   occorre creare una cartella "language" all'interno della directory =
principale del proprio addon,=20
   e in ogni file del modulo includere questo codice:
  =20
   require_once("mainfile.php");
   $module_name =3D basename(dirname(__FILE__));
   get_lang($module_name); =20

   Questo includer=E0 (se esiste) il file language scelto nel cookie =
dell'utente.
   Potete visionare ogni modulo gi=E0 incluso per vedere un esempio di =
questa caratteristica.
   =20
c) Quando si dichiara uno switch() non usare la variabile $mop per =
farlo.=20
   Usa un altro nome di variabile come $op, per esempio.
  =20
d) Nel nome dell' Addon non usare spazi vuoti, al suo posto usa "_".=20
   Per esempio se vuoi creare un addon con il nome "The Web Ring", il =
nome della directory
   sar=E0 "The_Web_Ring".
  =20
e) Ogni link nei files dell' addon ha bisogno della seguente sintassi:

   =
http://www.yoursite.com/modules.php?mop=3Dmodload&name=3DThe_Web_Ring&fil=
e=3Dindex
  =20
   dove "modules.php?mop=3Dmodload" =E8 richiesto tale e quale, =
"&name=3DThe_Web_Ring" =E8 il nome
   della directory dell'addon e "&file=3Dindex" dichiara il nome del =
file al quale si intende accedere,
   senza l'estensione .php . L'estensione verr=E0 aggiunta =
automaticamente.
  =20
Facile, no? Ok, se devi collegarti ad una specifica funzione da =
qualunque file del tuo addon
alla URL sopra descritta aggiungi semplicemente:

    &switchname=3Dname
   =20
Cos=EC, se hai dichiarato uno switch del tipo:
   =20
    switch($func) {
	case "func-one":
	funct-one();
	break;   =20
    }
   =20
lo chiamerai:
   =20
    =
http://www.yoursite.com/modules.php?mop=3Dmodload&name=3DThe_Web_Ring&fil=
e=3Dindex&func=3Dfunc-one
   =20
se la tua funzione necessita di ricevere valori variabili, il tuo switch =
somiglier=E0 a:
   =20
    switch($func) {
	case "func-one":
	funct-one($xid, $xname);
	break;   =20
    }
   =20
il tuo link dovr=E0 essere:
   =20
    =
http://www.yoursite.com/modules.php?mop=3Dmodload&name=3DThe_Web_Ring&fil=
e=3Dindex&func=3Dfunc-one&xid=3D$xid&xname=3D$xname

    Se hai bisogno di usare forms nel tuo addon, segui questo metodo:
   =20
    <form =
action=3D"modules.php?mop=3Dmodload&name=3DAddon_Sample&file=3Dindex&func=
=3Dfunction" method=3D"post">
    ...
    </form>
   =20
ma ricorda di non usare nomi di variabili riservate come "name" e/o =
"file" e usa una variabile switch
diversa da "$mop".
   =20
Spero che queste regole siano chiare.
Un' altra importante nota =E8 che devi sapere che il sistema Moduli ha =
variabili riservate,
esse sono:

$name:  Usata per dichiarare il nome dell'addon
$file:  Usata per dichiarare il nome del file in uso
$mop:   Usata per lo switch del modules.php=20
$index: Usata per aggiungere o rimuovere i blocchi di destra
$modload: La chiamata (The call)
$mod_active: Usata per verificare lo stato dei moduli

Come nota aggiuntiva e interessante, puoi fare in modo che il tuo addon =
mostri i blocchi
di sinistra e di destra usando la variabile $index. All'inizio del tuo =
file
dichiara la variabile:

$index =3D 1;

Se il valore =E8 "1" il tuo addon mostrer=E0 i blocchi di destra, se il =
valore =E8 "0"
saranno mostrati i soli blocchi di sinistra, ovviamente con il tema =
grafico di default o scelto dall'utente.

Ricorda che puoi usare il tuo file language di traduzione, chiamato
per esempio lang-english.php, cos=EC possiamo creare una compatibilit=E0 =
linguistica con
la parte restante del sito usando la variabile $language presa dal file =
config.php

Bene, questa non =E8 stata una approfondita documentazione ma =
fondamentale per farti iniziare
ad usare o a produrre i tuoi addons/modules/plugins. Spero che =
apprezzerai=20
questa nuova caratteristica di PHP-Nuke.

=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D

NOTA: Per restare nello standard HTML 4.01 Transitional =E8 molto =
importante che
si sostituiscano tutti i caratteri "&" nelle URL con il tag "&amp;". =
Perci=F2, per esempio, la URL:

    <a href=3D"modules.php?mop=3Dmodload&name=3DFAQ&file=3Dindex">

deve essere scritta:

    <a =
href=3D"modules.php?mop=3Dmodload&amp;name=3DFAQ&amp;file=3Dindex">

senza questo, le tue pagine non saranno convalidate come compatibili =
HTML.

=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D

AVVISO sul COPYRIGHT!!!

    Poich=E9 PHP-Nuke =E8 sotto licenza GNU/GPL, qualsiasi modulo,
    addon, plugin, theme, block, etc. che necessita di parte del codice =
PHP-Nuke
    per funzionare correttamente deve essere rilasciato con una licenza =
GPL compatibile.
    Per favore, leggere attentamente la licenza GPL, =E8 inclusa nel =
file COPYING

=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D

E ora divertitevi!