Installare MOD per forum phpBB

[SyGy]

In questo tutorial vedremo come Moddare un forum phpBB

Le MOD per il forum sono migliaia, tutte che hanno un differente scopo es. "visualizzare i compleanni, il segno zodiacale di un'utente" ecc..

La prima cosa che dobbiamo fare è scaricare la MOD che vogliamo installare sul nostro forum. Fino ad ora il miglior sito per trovare MOD per phpBB è PhpBBhacks.com che è in lingua inglese, in questi giorni sto notando che è in fase di sviluppo anche la versione italiana PhpBBhacks.it.
Una volta scaricata la nostra MOD dobbiamo estrarre i file dall'archivio. Per fare questo possiamo adoperare il programma WinRar, scaricabile dalla sezione "Download | Indispensabili" del nostro sito.
Estratti tutti i file avremmo davanti un file di testo "install.txt". Se lo apriremo vedremo un file del genere

Codice: Seleziona tutto

###############################################
##   Hack Title:          MOD TITLE
##   Hack Version:     MOD VERSIONE
##   Author:              AUTORE MOD
##   Description:        DESCRIZIONE MOD
##
##   Compatibility:      COMPATIBILITA' CON LA VERSIONE DI PHPBB
##
##   Installation Level: LIVELLO DI INSTALLAZIONE DELLA MOD
##   Installation Time: TEMPO DI INSTALLAZIONE DELLA MOD
##   Files To Edit:        N° DEI FILE DA MODIFICARE
##   Included Files:      N° DEI FILE DA INCLUDERE NELLA CARTELLA DEL FORUM
###############################################

INIZIO ISTRUZIONI PER INSTALLARE LA MOD

Nella parte sotto del file ci sono descritte le azioni da fare sui vari file, es:

Se nel file c'è scritto questo:

Codice: Seleziona tutto

# 
#-----[ OPEN ]------------------------------------------ 
# 
FILE DA APRIRE.php

noi dobbiamo aprire il seguente file descritto sotto, subito dopo questo codice c'è sempre scritto le azioni di da fare sul file indicato es:

Codice: Seleziona tutto

# 
#-----[ FIND ]------------------------------------------ 
#
RIGHE DA CERCARE 

Ricerca questa riga

Codice: Seleziona tutto

# 
#-----[ AFTER, ADD ]------------------------------------
#
CODICE DA AGGIUNGERE DOPO LA RIGA CERCATA

Aggiungi dopo il seguente codice

Codice: Seleziona tutto

# 
#-----[ BEFORE, ADD ]------------------------------------
#
CODICE DA AGGIUNGERE PRIMA DELLA RIGA CERCATA

Aggiungi prima il seguente codice

Codice: Seleziona tutto

# 
#-----[ IN-LINE FIND ]------------------------------------
#
RICERCA IL SEGUENTE CODICE NELLA STRINGA PRECEDENTEMENTE CERCATA.

Questa azione si trova quando abbiamo una riga molto lunga e dobbiamo ricercare una piccola parte di codice all'interno di questa lunga stringa.

Codice: Seleziona tutto

# 
#-----[ IN-LINE AFTER, ADD ]------------------------------------
#
AGGIUNGI IL SEGUENTE CODICE SUBITO DOPO IL CODICE CERCATO NELLA LUNGA STRINGA DI TESTO PRECEDENTEMENTE CERCATA

Praticamente noi dobbiamo aggiungere il codice descritto dopo il pezzo di codice indicato prima con l'instruzione "IN-LINE FIND"

Codice: Seleziona tutto

# 
#-----[ IN-LINE BEFORE, ADD ]------------------------------------
#
AGGIUNGI IL SEGUENTE CODICE SUBITO PRIMA IL CODICE CERCATO NELLA LUNGA STRINGA DI TESTO PRECEDENTEMENTE CERCATA

Praticamente noi dobbiamo aggiungere il codice descritto prima il pezzo di codice indicato prima con l'instruzione "IN-LINE FIND"

Codice: Seleziona tutto

# 
#-----[ REPLACE WITH ]------------------------------------------ 
# 
SOVRASCRIVERE IL SEGUENTE CODICE CON LA STRINGA DI CODICE PRECEDENTEMENTE CERCATA

Dobbiamo sovrascivere il codice cercato precedentememte con quello descritto dopo l'instruzione "REPLACE WITH"

Codice: Seleziona tutto

#
#-----[ SAVE & CLOSE ALL FILES ]--------------------------
#
#End 

Salva e chiudi ogni file e uppalo nella propria cartella.


Tutte queste sono opzionali per ogni MOD, perciò non troveremo mai tutte queste istruzioni. Ad eccezzione naturalmente delle istruzioni "OPEN" "FIND" "SAVE & CLOSE ALL FILES" perchè queste sono le basi di ogni MOD che richiede la modifica di file.

Ci sono altre 2 istruzioni che non è obbligatorio avere in una MOD. queste sono:

Codice: Seleziona tutto

#
#-----[ SQL ]------------------------------------------
#
DUMP FILE PER DATABASE SQL

Questa istruzione ci dice di manipolare il database, inserendo il dump descritto sotto. Per questa istruzione è in costruzione un'apposito post, che spiegherà passo per passo ogni azione da fare se ci troviamo davanti ad un'istruzione del genere.

La seconda istruzione è:

Codice: Seleziona tutto

# 
#-----[ COPY ]------------------------------------------ 
# 
FILE DA COPIARE.PHP   ->  DESTINAZIONE DEL FILE DA COPIARE

Questa istruzione la troveremo nel caso la MOD si appoggi su file esterni a phpBB. noi non dobbiamo far altro che copiare il file descritto nella cartella descritta. es. se noi abbiamo un'istruzione del genere:

Codice: Seleziona tutto

# 
#-----[ COPY ]------------------------------------------ 
# 
MOD.php  ->  includes/MOD.php

noi non dobbiamo far altro che copiare il file MOD.php nella cartella "includes" e cosi via.

In una MOD potremmo trovare molte istruzioni, noi dovremmo seguirle con molta attenzione, ne vale la riuscita della MOD e il completo funzionamento del forum.
In questi ultmi tempi si trovano in giro anche moltissimi Template per phpBB. Ogni MOD che deve modificare anche un file del template, descriverà la cartella del template di default es.

Codice: Seleziona tutto

# 
#-----[ OPEN ]------------------------------------------ 
# 
/templates/subSilver/index_body.tpl

In questo caso dovremmo aprire il file "index_body.tpl" che si trova nella cartella "/templates/subSilver/", quest'ultima cartella dovrà essere cambiata con quella del tema del forum es.

Codice: Seleziona tutto

#
#-----[ OPEN ]------------------------------------------ 
# 
/templates/MIOTEMPLATE/index_body.tpl

SPERO DI ESSERE STATO SEMPLIFICATIVO E CHE MI SIA FATTO CAPIRE. PER QUALUNQUE COSA POSTATE QUI