[Guida] Installare le mod a mano

LO-FI Version

[Darknico]

Le mod solitamente sono progettate per lavorare con il tema di default,ovvero il tema “base”.
E’ difficile per chi crea le Mod,tanto quanto è difficile per chi crea i temi,far si che le mod lavorino con ogni tema.
Comunque è possibile installare una Mod manualmente,adattandola così ad ogni tema.

Mi Raccomando!Leggete tutto prima di incominciare a fare le modifiche a mano,risparmieremo così molte domande dopo...

Scompattiamo la mod,e andiamo subito a cercare il file package-info.xml
Questo file contiene tutte le informazioni per far eseguire la mod:quali file aggiungere,quale file fa le modifiche,quale file esegue query al database,e altre informazioni....

<install for="..."> indica per quale versione è la mod(se nn ce scritto niente nn controlla la versione)
<require-file name="..." destination="..." /> nome del file da inserire in una determinata posizione
<require-dir name="..." destination="..." /> nome della cartella da inserire in una determinata posizione
<code >...< /code> file che esegue le query al database
<modification>...</modification> il file più importante;
ora andremo ad analizzare questo file che eseguirà tutte le modifiche al nostro smf

• file con estensione .mod
  (ormai dal 2005 non viene piu usata l'estensione .mod ma l'estensione .xml,ma vediamo più avanti....)
• apri il .mod file con un qualsiasi editor di testo (WordPad oppure Dreamweaver) e cerca:
  <edit file>…</edit file>
  E troverete il nome di un file all’interno di questo tag.
  Quello che  dobbiamo fare è cercare il file segnalato nel tag ad esempio index.template.php, BoardIndex.template.php ..etc.
• Sotto al tag <edit file>, ci sarà il tag <search for> …</search for>   . Contiene un blocco di codice da copiare nel file segnalato dal tag “edit file”
• Dopo il tag <search for> potremmo trovare una di queste ozioni:
  <add after>…</add after> , in questo caso il “Blocco di codice” va aggiunto dopo quanto segnalato dal tag search for.
  <add before>…</add before> , in questo caso il “Blocco di codice” va aggiunto prima quanto segnalato dal tag search for.
  <replace>…</replace> , in questo caso il “Blocco di codice” va aggiunto al posto di quanto segnalato dal tag search for.
  

Ecco un esempio:

Codice:

<edit file>
Themes/default/Display.template.php
</edit file>

<search>
// Show the anchor for the top and for the first message.  If the first message is new, say so.
</search>

<replace>
global $bar_exps, $bar_posts;

// Show the anchor for the top and for the first message.  If the first message is new, say so.
</replace>

Questo significa che dobbiamo aprire il file Display.template.php e cercare:

Codice:

// Show the anchor for the top and for the first message.  If the first message is new, say so.

E sostituirlo con:

Codice:

global $bar_exps, $bar_posts;

// Show the anchor for the top and for the first message.  If the first message is new, say so.

Prima ho detto che l'estensione .mod non viene piu usata(anche se alcune le potete trovare ancora così) ma si usa .xml
Il procedimento è uguale,cambia solo per alcune cose:

• <edit file>…</edit file> diventa <file name="...">
• <search for> diventa <search position="...">
• [CDATA[ ...codice... ]] dove all'interno c'è il codice da cercare o inserire

Ecco quindi come si presenterebbe la mod di prima con il metodo .xml

Codice:

<file name="$themedir/Display.template.php">
<operation>
<search position="replace"><![CDATA[ // Show the anchor for the top and for the first message.  If the first message is new, say so.]]></search>
<add><![CDATA[ global $bar_exps, $bar_posts;

// Show the anchor for the top and for the first message.  If the first message is new, say so.
]]></add>
</operation>
</file>

Come potete vedere il funzionamento è lo stesso

Esistono poi variabili o azioni speciali  tipo queste:

• <search position="end"> che vuol dire che va messo in fondo prima della fine del codice php ovvero prima del ?>
• $themedir che sta per la cartella Themes/default/
• $sourcedir che sta per la cartella Sources
• $boarddir che sta per la cartella principale del forum
• error="skip" sono quelle modifiche nn essenziali(magari apposite per una lingua o tema diverso) quindi in caso non trova il file o la parte da modificare nn da errore e salta l'operazione

Questo è tutto,ora dovreste essere in grado di installare una mod manualmente,sia se lo vogliate fare,sia se volete adattare ad un vostro tema.

N.B. non dovete mai modificare la mod,ma direttamente i vostri file!!

Un piccolo consiglio
se dovete solo adattare ad un vostro tema agite in questo mod:

• Installate normalmente la mod
• modificate poi SOLO i file .template del vostro tema

vi rikordo infatti ke ogni tema che installate non contiene tutti i file ma solo quelli che servono,quindi in caso manchi qualche file automaticamente va ad usare quello del default che la mod ha gia ovviamente modificato precedentemente.

Detto questo,buona modifica!!!

[Darknico]

ATTENZIONE

Tutti quei post che andaranno a "Sporcare il topic" con domande inutili,fatti solo perche non leggete verranno cancellati.
La guida è molto chiara,basta solo sapere leggere...
verrano solo risposte le domande inerenti a punti di cui non ho parlato o che non è chiaro

[Emarap]

Ottima guida 

[Darknico]

Grazie

[giorgio]

Bel lavoro, utile e esaustivo anche per uno gnucco come me 

[m.a.r.c.o22]

Ciao, ho eseguito alla lettera la guida ma riesco a posizionare il banner solo nell'index della board cioè quì , mentre se voglio posizionarlo in altre zone non me lo permette. Oltre a questo mi crea due voci ad Annunci come mai ?Avrei anche un dubbio su questra stringa

Codice:

- <search position="before">
- <![CDATA[ </td>
  ]]>
  </search>
- <add>
- <![CDATA[ ';
//Welcome Ads
if (function_exists("show_welcomeAds"))
{
$ads = show_welcomeAds();
if(!empty($ads))
{
echo '<td class="windowbg2">';
if($ads['type']==0)
echo $ads['content'];
else
eval($ads['content']);
echo '</td>';
}
unset($ads);
}
echo '
  ]]>
  </add>

perchè vorrei capire quale

Codice:

</td>

devo prendere in considerazione dal file index.template.php del tema di default. Grazie

[Darknico]

il primo ke becchi dopo l'ultima modifica fatta

[m.a.r.c.o22]

Te lo chiedo per dopo l'ultima modifica fatta c'è questo

Codice:

'</td>' ;

e non

Codice:

</td>

.
E lo stesso ?
Poi potresti rispondere anche alle altre domande postate da me per piacere ? Grazie

[Darknico]

potrebbe,alla fine il tema nn è di default quindi diverso,va a tentativi no?

P.S. rispondo quando posso,non vivo nei forum,ho anche fatti miei da fare

[lcrimail]

Per problemi che non sto qui a discutere devo necessariamente installare manualmente la gallery 1.7.1.

Ho uppato tutto nell mio spazio web. Ho aperto il file galleryinstall e inviato manualmente al database le query.

Le tabelle sono state create, adesso come procedo? Nel forum risulta ancora non installata la gallery.

[Darknico]

oltre le tabelle devi fare le modifiche a mano...
cmq facendo a mano nn lo segnala su packages

[lcrimail]

E' possibile sapere che modifiche debbo fare?

Se non riesco manualmente ci devo rinunciare purtroppo.

[Darknico]

ma scusa,tu sto topic lo hai letto o hai solo scritto?..
nn so guarda anche solo il titolo:
"Installare le mod a mano"

leggiti il primo post....

[lcrimail]

Si scusami, non avevo letto.

Mi chiede di modificare il file modification.english.php ma io ho quello italiano, non fa nulla vero?
Inoltre mi dice di....

Codice:

- <search position="after" regexp="false" whitespace="exact">
- <![CDATA[ ?>
  ]]>
  </search>
- <add>
- <![CDATA[ //Begin SMF Gallery Text Strings.....

Significa che devo inserirlo all'inizio del codice...giusto?

[m.a.r.c.o22]

Devi cercare

Codice:

regexp="false" whitespace="exact"

e dopo devi mettere

Codice:

//Begin SMF Gallery Text Strings.....

.Praticamente avrai:

Codice:

regexp="false" whitespace="exact"
//Begin SMF Gallery Text Strings.....