Come migrare su SPIP 1.9

La versione SPIP 1.9 introduce una nuova organizzazione dei file di SPIP. Pertanto, l’aggiornamento di un sito già esistente e che gira sulla versione 1.8 o inferiore può causare una moltiplicazione di file inutili.

Per coloro che hanno fretta, il metodo consiste nel seguire la normale procedura di aggiornamento (e cioè: sovrascrivere i file della versione 1.9 su quelli già presenti), e poi spostare altrove tutti i file xxx.php3 e vedere se il sito funziona ancora: in genere sì.

Metodo per la migrazione

1. Come sempre, prima di effettuare qualsiasi operazione importante sul sito, fare un backup del database per precauzione.
2. Spostare tutti i file e le cartelle della vecchia installazione in una sotto-cartella. Ma soprattutto, in questa fase non cancellare nulla!
3. Installare i file di SPIP 1.9 alla radice del sito (ricordarsi di verificare i diritti di accesso delle cartelle CACHE/ e ecrire/data/)
4. Copiare la propria cartella dei modelli alla radice (e rinominarla “squelettes” nel caso non lo fosse già).
5. Spostare la vecchia cartella IMG/ (e tutte le sue sotto-cartelle) alla radice (essa contiene tutti i logo, le immagini e i documenti utilizzati dal sito). Dopo lo spostamento è possibile cancellare:
   • la cartella icones_barre/;
   • la cartella icones/ se essa contiene solamente file -dist (in altre parole, rimettere solo le icone senza il suffisso -dist).
   • le cartelle cache..×../ che contengono le immagini elaborate dal server (versioni miniaturizzate dei logo, formule matematiche, ecc.) ; esse verranno ricreate da SPIP al bisogno.
6. Spostare, se esistono, i file personalizzati mes_fonctions.php3 (nella cartella squelettes/) e mes_options.php3 (nella cartella ecrire/); rinominarli eliminando il 3 alla fine: mes_fonctions.php e mes_options.php.
7. Entrare nell’area riservata per eseguire la procedura di aggionamento (se si sono dimenticati i dati di accesso al database MySQL del sito è sufficiente aprire il file ecrire/inc_connect.php3 della vecchia versione di SPIP per ritrovarli).
8. È sempre utile ricordarlo: non bisogna ripristinare il database salvato precedentemente!
9. Fare delle prove

Aggiornamento dei modelli di layout

• I modelli non funzionano più con coppia di file .php3/.html: è possibile eliminare i file PHP di chiamata. Per esempio: eliminate il file article.php3, ma non il modello article.html.
• Se questo file .php3 contiene funzioni o altri elementi specifici al modello, spostare tali funzioni ed elementi dentro squelettes/xxx_fonctions.php, per esempio per gli articoli (article), squelettes/article_fonctions.php
• I file lingua possono essere messi in una sotto-cartella lang/ della cartella squelettes/
• I form personalizzati devono essere messi nella cartella squelettes/ e non nella sotto-cartella formulaires/ alla radice del sito.
• Le icone personalizzate vanno dentro la cartella IMG/icones/.

Anche il codice dei modelli merita una pulizia. Si noti che essa non è indispensabile per un corretto funzionamento del sito; vi garantirà semplicemente un codice più «pulito»:

• Sostituire tutti i segnaposti #DOSSIER_SQUELETTE con #CHEMIN, facendo attenzione a rispettare la sintassi: #CHEMIN{file}
• La gestione della cache, prima descritta mediante $delais = 24 * 3600; nel file PHP corrispondente al modello, è ora affidata al segnaposto #CACHE{24*3600}, da inserire direttamente all’interno di ogni modello.

• Gli header HTTP possono essere definiti con un segnaposto: #HTTP_HEADER{Content-Type: text/css}. Attenzione se si utilizza il trucchetto $flag_preserver=true;: ritroverete la funzionalità corrispondente (mancanza di visualizzazione dei pulsanti di amministrazione) indicando nel modello: #HTTP_HEADER{Content-Type: text/html}
• La sintassi delle inclusioni può essere semplificata: il testo «page.php3» non è più necessario; basta indicare solamente il nome del modello da includere, come segue <INCLUDE{fond=nome_modello}{criterio1}{criterio2}{...}>.

Gestione degli URL

Gli URL del sito sono cambiati con SPIP 1.9, tuttavia si desidera conservare i vecchi URL, almeno per poter continuare ad essere trovati dai navigatori (o dai motori di ricerca) che già vi conoscono.

Il file [.htaccess] distribuito nella versione standard permette di garantire una migrazione completa verso i nuovi indirizzi del sito. Per attivarlo, è necessario rinominare il file htaccess.txt in .htaccess. Su alcuni siti sarà necessario anche modificare la prima riga per fare apparire RewriteBase /; va notato che il client FTP potrebbe non mostrare questo file al termine dell’operazione poiché il punto all’inizio del nome significa spesso « file invisibile ».

Passaggio in UTF-8

È possibile completare la migrazione convertendo il proprio sito nel set di caratteri universale UTF-8, utilizzando l’opzione « gestione delle lingue » della configurazione. Tale operazione deve essere accompagnata da un backup completo del database nel set di caratteri di origine.

* * *

In ultimo non ci si dimentichi di « pulire » la sotto-cartella che contiene il sito originario. Se questa procedura è stata eseguita in maniera corretta essa dovrebbe contenere solo ed esclusivamente i file della vecchia versione di SPIP. Tuttavia, prima di cancellarla è bene downloadarla sul disco rigido del proprio computer e zipparla — nel caso in cui si sia dimenticato qualcosa.