Guida Migrazione da Joomla 1.0.x a 1.5.x

GUIDE VIRTUEMART www.vmitalia.net
Guida di Virtuemart
GUIDA MIGRAZIONE DA JOOMLA! 1.0X A JOOMLA 1.5.X
Guida passo passo per utenti Virtuemart
GUIDE VIRTUEMART www.vmitalia.net
Pagina 1
GUIDE VIRTUEMART www.vmitalia.net
INDICE
INDICE ..................................................................................................................................................................... 2
MIGRAZIONE DA JOOMLA! 1.0 A JOOMLA! 1.5 ................................................................................................... 3
Perchè si parla di “migrazione” invece di “aggiornamento”? ..................................................................................................3
Riepilogo della migrazione......................................................................................................................................................3
PROCEDURA DETTAGLIATA MIGRAZIONE JOOMLA 1.5 ................................................................................ 4
CONTINUIAMO CON LA MIGRAZIONE DI VIRTUEMART................................................................................ 8
Copia del database di VirtueMart............................................................................................................................. 8
COPIARE IL COMPONENTE VIRTUEMART 1.1 ................................................................................................................ 10
NOTE FINALI................................................................................................................................................................ 11
Pagina 2
GUIDE VIRTUEMART www.vmitalia.net
Migrazione da Joomla! 1.0 a Joomla! 1.5
Guida passo-passo per gli utenti di VirtueMart
Perchè si parla di “migrazione” invece di “aggiornamento”?
•
Joomla 1.5 usa la codifica UTF-8 per le tabelle del database, al contrario di Joomla
1.0, che per la versione italiana usa la codifica latin1, cioè ANSI
•
i collegamenti (in particolare se attivata la funzionalità SEF) sono cambiati, perciò è
necessario gestire i collegamenti precedenti
•
la struttura del database è cambiata in molti punti, perciò non è sufficiente una
semplice importazione tramite SQL
Riepilogo della migrazione
1. nel caso si usi VirtueMart versione 1.0.x, aggiornare alla serie 1.1 (VM 1.0 non è
compatibile con Joomla 1.5)
2. generare un'esportazione SQL delle tabelle dell'installazione attuale Joomla 1.0,
tramite l'apposito componente “Migrator”
3. installare normalmente Joomla 1.5 in una nuova cartella (usando nuove tabelle)
4. al momento della migrazione, caricare il pacchetto generato dal “migrator”, tramite
FTP o HTTP (upload via browser)
5. eseguire il “Migration Wizard” (migrazione guidata) e terminare l'installazione
6. copiare le tabelle di VirtueMart nel nuovo database di Joomla 1.5
7. copiare i file di VirtueMart nel nuovo sito di Joomla 1.5
Pagina 3
GUIDE VIRTUEMART www.vmitalia.net
Procedura dettagliata migrazione Joomla 1.5
1. Scaricare il pacchetto “Migrator” (migrator11_it.zip):
http://www.vmitalia.net/index.php?option=com_docman&task=doc_download&gid
=109&Itemid=58
http://joomlacode.org/gf/project/pasamioprojects/frs
2. Installare il componente Migrator in Joomla 1.0
Pagina 4
GUIDE VIRTUEMART www.vmitalia.net
3. la schermata del componente spiega tutti i passaggi, generalmente è sufficiente
cliccare “Create Migration SQL File” / “Crea File SQL Migrazione”
in questo caso lasceremo attivati tutti i plugin base, quindi proseguire cliccando su
"Avvia Migrazione"
Pagina 5
GUIDE VIRTUEMART www.vmitalia.net
il componente effettuerà la procedura di generazione del pacchetto SQL di
migraziome, dopo varie schermate; prendere nota del nome del file prima di
cliccare “Download”
la pagina successiva mostrerà tutti i file disponibili; in questo caso non ne servono
altri, quindi cliccare “Download” per scaricare il pacchetto SQL
4. installazione di Joomla 1.5: creare una nuova cartella, e caricare Joomla 1.5;
avviare l'installazione
Pagina 6
o
passo 1: selezione lingua
o
passo 2: controlli pre-installazione
o
passo 3: visualizzazione licenza GPL
o
passo 4: configurazione database; è possibile usare un nuovo database,
oppure lo stesso cambiando il prefisso (es. j15_ invece di jos_)
o
passo 5: configurazione FTP (opzionale, si può saltare)
o
passo 6: il più importante ai fini della migrazione; fare subito click su
“Carica script migrazione”.
o
Un messaggio avvisa la dimensione massima del caricamento (es. 8 MB), se
il proprio file SQL supera tale dimensione, il file va caricato tramite FTP, nella
GUIDE VIRTUEMART www.vmitalia.net
cartella “/installation/sql/migration/”, chiamandolo “migrate.sql”; altrimenti si
può procedere direttamente a caricare il file cliccando su “Sfoglia”
o
o
Impostazioni migrazione: inserire il prefisso tabelle del vecchio database (es.
jos_), lasciare la codifica iso-8859-1, attivare l'opzione “Questo è uno script
di migrazione Joomla! 1.0”; se il file è stato caricato tramite FTP, attivare
anche l'opzione relativa
Infine, avviare la migrazione con il pulsante “Carica ed Esegui” (vedi figura).
Se l'operazione si è svolta correttamente, apparirà il messaggio “Migrazione avvenuta
correttamente, clicca su Avanti per continuare”; in caso contrario, consigliamo di riprovare
dall'inizio, controllando tutti i passaggi.
•
Per concludere, inserisci il nome del sito, e opzionalmente la mail e la password
dell'utente amministratore (lasciando vuoti i campi, verranno riutilizzati i dati del
vecchio Joomla).
•
un nuovo modulo “menu principale” – “main menu” viene automaticamente creato
e pubblicato
•
tutti gli altri moduli vengono migrati ma non pubblicati
•
sarà necessario reinstallare ogni componente / modulo / plugin aggiuntivo (versione
1.0 in legacy mode o versione 1.5, se disponibile)
•
notare che qualche link nei menu potrebbe non funzionare, in caso va ricreato
•
Tutti i passaggi base per la migrazione di VirtueMart in Joomla 1.5 sono completati.
•
Potrebbe essere necessario verificare e correggere alcune cose nel nuovo sito di
Joomla 1.5, in quanto la compatibilità non è perfetta.
Pagina 7
GUIDE VIRTUEMART www.vmitalia.net
•
Altre estensioni in Joomla 1.0 andranno migrate in Joomla 1.5 (cercare indicazioni
specifiche per ogni componente)
•
Ne è valsa la pena? Sì! Joomla 1.5 è il futuro, e tutte le nuove estensioni e i
template verranno sviluppati quasi esclusivamente per 1.5, senza possibilità di
utilizzo in Joomla 1.0
•
Devo migrare subito? No. VirtueMart 1.1 supporta ancora Joomla 1.0, così come la
futura serie 1.2.
A questo punto, la migrazione principale a Joomla 1.5 è completa; se è tutto ok, eliminare
la cartella “installation” dal nuovo spazio web (NB: resta da eseguire la migrazione di
VirtueMart). Alcune annotazioni:
Continuiamo con la migrazione di VirtueMart.
Copia del database di VirtueMart
Se il nuovo database di Joomla 1.5 è nello stesso server del vecchio database, puoi
semplicemente copiare le tabelle; se è stato usato un differente prefisso (es. j15_* invece
di jos_), copiare le tabelle modificando di conseguenza il nome (es. jos_vm_category in
j15_vm_category).
E' possibile copiare le tabelle tramite PHPMyAdmin, scheda “Operazioni”. Copiare tutte le
tabelle di VirtueMart: *_vm_*). NB: attivare l'opzione “Aggiungi valore
AUTO_INCREMENT”.
Pagina 8
GUIDE VIRTUEMART www.vmitalia.net
Se il nuovo database è in un altro server, è necessario esportare le tabelle in un file SQL
(scheda “Esporta” di PHPMyAdmin), e reimportarle nel nuovo server (scheda “Importa”).
NB: importare le tabelle scegliendo il set di caratteri “latin1”. E' possibile usare questa
modalità di esportazione – reimportazione anche nel caso precedente (stesso server), se
risultasse più comodo; ricordare, nel caso sia stato usato un prefisso tabelle diverso, di
modificarlo manualmente nel file SQL, prima della reimportazione.
E' quindi necessario cambiare la codifica delle tabelle (table collation); in PHPMyAdmin, nel
nuovo database, aprire ognuna delle tabelle di VirtueMart (*_vm_*), cliccare sulla scheda
“Operazioni”, selezionare come “Collation” la voce “utf8_general_ci” e premere OK.
Ripetere l'operazione per ogni tabella di VM.
Pagina 9
GUIDE VIRTUEMART www.vmitalia.net
Copiare il componente VirtueMart 1.1
Se la nuova installazione di Joomla 1.5 è nello stesso spazio web del vecchio Joomla 1.0,
puoi effettuare la copia usando eXtplorer o JoomlaXplorer
(http://joomlacode.org/gf/project/joomlaxplorer/) oppure la gestione file del pannello di
controllo del provider. Copiare le cartelle:
/administrator/components/com_virtuemart/
/components/com_virtuemart/
Copiare queste cartelle, con tutto il loro contenuto, nella nuova cartella di Joomla 1.5.
Se la nuova installazione di Joomla 1.5 è in uno spazio web diverso dal precedente, sarà
necessario scaricare tramite FTP le cartelle, e ricaricarle nel nuovo spazio.
I moduli e i plugin (mambots) non vanno copiati!
I vecchi moduli e plugin non funzionano in Joomla 1.5, perciò sarà necessario reinstallarli
da zero, prendendoli dal pacchetto completo di VirtueMart 1.1 per Joomla 1.5.
Ultima operazione: ripristinare il collegamento al componente VirtueMart, dal menu del
pannello di amministrazione. E' possibile farlo eseguendo in PHPMyAdmin (scheda “SQL”),
questa query SQL (modificando se necessario il prefisso “jos_”):
Pagina 10
GUIDE VIRTUEMART www.vmitalia.net
INSERT INTO `jos_components` (`id`, `name`, `link`, `menuid`, `parent`,
`admin_menu_link`, `admin_menu_alt`, `option`, `ordering`, `admin_menu_img`,
`iscore`, `params`) VALUES (NULL, 'VirtueMart', 'option=com_virtuemart', 0, 0,
'option=com_virtuemart', 'VirtueMart', 'com_virtuemart', 0,
'../components/com_virtuemart/shop_image/ps_image/menu_icon.png', 0, '');
Note finali
•
Tutti i passaggi base per la migrazione di VirtueMart in Joomla 1.5 sono completati.
•
Potrebbe essere necessario verificare e correggere alcune cose nel nuovo sito di
Joomla 1.5, in quanto la compatibilità non è perfetta.
•
Altre estensioni in Joomla 1.0 andranno migrate in Joomla 1.5 (cercare indicazioni
specifiche per ogni componente)
•
Ne è valsa la pena? Sì! Joomla 1.5 è il futuro, e tutte le nuove estensioni e i
template verranno sviluppati quasi esclusivamente per 1.5, senza possibilità di
utilizzo in Joomla 1.0
•
Devo migrare subito? No. VirtueMart 1.1 supporta ancora Joomla 1.0, così come la
futura serie 1.2.
Pagina 11