Tutorial Avanzati V1

Cloniamo Soapbox!

Categoria: Tutorial Xoops 2.0.x
Autore: dantom
Data: 16/3/2006
Parole chiave: soapbox

Sommario: Clonazione: operazione semplice ma insidiosa. Vediamo come seguire una procedura passo-passo che ci permette di evitare piccoli errori che fanno GRANDI danni

OBBIETTIVO

Voglio clonare il modulo soapbox rinominandolo in diario. Un volta clonato, verra copiato nella directory /modules e installato per verificarne il funzionamento. Infine avremo una nuova directory del tipo: http://www.tuosito.com/modules/diario/

COME FARE

Tre fasi fondamentali:
1 - Operazioni sui file (rinominarne alcuni)
2 - Operazioni sul codice interno (Sostituzione di parole chiave e di tutte le loro occorrenze con le nuove)
3 - Operazione sul file /sql/sql.txt per la creazione delle tabelle del database per il modulo nuovo

Per l'operazione di ricerca e sostituzione un qualsiasi editor di testi fa al caso nostro
purchè abbia la funzionalità di "cerca e Sostituisci" del testo.

TOOL DA ME USATO: Dreamweaver MX
Notoriamente ha un "Cerca e Sostituisci" molto potente.

1 - OPERAZIONE SUI FILE E CARTELLE

-->Rinominare la cartella del modulo soapbox in diario

Nella cartella templates rinominare:

---> sb_index.html in diario_index.html
---> sb_column.html in diario_column.html
---> sb_article.html in diario_article.html

Nella cartella blocks rinominare:

---> arts_new.html in diario_new.html
---> arts_rated.html in diario_rated.html
---> arts_top.html in diario_top.html

2 - OPERAZIONI SUL CODICE INTERNO

Usare il "cerca e sostituisci" e modificare le seguenti parole:
Nota: usare l'opzione Maiuscole/minuscole per rendere la ricerca case/sensitive.

// Tutti i riferimenti al modulo soapbox
--> "soapbox" da sostituire con "diario" (59 occorrenze)

//Tutti i riferimenti al modulo soapbox che usano prefisso sb_
--> "sb_" da sostituire con "diario_" (8 occorrenze)

//le tabelle del modulo con relative query
--> "sb" da sostituire con "diario_" (133 occorrenze)(diario CON underscore comunque)

3 - OPERAZIONE SUL FILE /sql/sql.txt

Sostituire sb con diario_
NOTA:
Con Dreamweaver che non legge i file txt, ho dovuto aprire il file con blocco note, perchè
non mi sostituiva le occorrenze. Chi non usa Dreamweavr non credo avrà questo problema.

4 - TRADUZIONE MODULO

//Le costanti per le traduzioni nella varie lingue
"_SB_" da sostituire con "_DIARIO_" (827 occorrenze)

//Cartella /language/italian, cercare il file modinfo.php e cambiare le seguenti frasi per la descrizione e il titolo del modulo clonato:

da:
define("_MI_SB_MD_NAME", "Soapbox: articoli e rubriche");

a
define("_MI_DIARIO_MD_NAME", "Diario: i vostri racconti");

e poi:
define("_MI_SB_MD_DESC", "Soapbox: modulo per la gestione di articoli e rubriche sul tuo sito");

a
define("_MI_DIARIO_MD_DESC", "Diario: Una sezione dedicata alla pubblicazione delle vostre storie");

NOTA:

La sostituzione delle frasi nei vari files della cartella italian.php è strettamente personale. Ciascuno puo'
modificarla a piacimento sostituendo parole specifiche e personalizzate, in base alle proprie esigenze.

Ultima ritocco: l'immagine del logo del modulo da modificare
Rinominare nella root del modulo il file sb_slogo.png in diario_slogo.png

Credo che sia tutto. Segnalatemi eventuali stafalcioni se potete. GRAZIE

Dantom


Tutorial Avanzati V1
URL: http://www.xoopsitalia.org/modules/article/view.article.php/c4/27