Come creare una versione localizzata di Joomla 3

[alexred]

A seguito dei recenti problemi nati con alcune versioni localizzate in italiano di Joomla e realizzate in modo errato e distribuite su siti esterni a Joomla.org voglio condividere qui la procedura corretta che io ho sempre seguito.
Faccio parte del team italiano di traduzione di Joomla dal 2005 e fino ad ottobre 2017 abbiamo localizzato puntualmente tutte le versioni di Joomla.
Il team di traduzione italiano continuerà a realizzare la versione localizzata di Joomla e metterla a disposizione qui sul forum ufficiale.
Ma se anche altri vogliono creare il proprio pacchetto localizzato questa è la procedura che io seguo:

Occorre il pacchetto di installazione dell'ultima versione di Joomla, il pacchetto lingua italiano della relativa versione (disponibile qui: http://joomlacode.org/gf/project/jtrans ... ge_id=6422), un buon editor di testo con il supporto alla modifica "Encoding o codifica (formato)" dei file per impostare UTF no BOM, un buon programma per creare archivi compressi.

- Estrarre il pacchetto di installazione dell'ultima versione di Joomla, modificare il file <root>/installation/localise.xml e inserire il tuo language code nel tag 'forceLang', esempio: <forceLang>it-IT</forceLang>
- Nello stesso file inserire il tuo helpsite url nel tag 'helpurl' <helpurl>http://www.xxxxxx.xx</helpurl> , se non possiedi il sito dove hai tradotto le pagine di help puoi evitare di compilare questo tag.
- Nello stesso file dentro il tag <sampledata></sampledata> inserire il nome del file del database creato per localizzare i dati di esempio, per esempio: <sampledata>sample_data_it.sql</sampledata>
- Inserire i file lingua prendendoli dal pacchetto lingua. Crea la cartella administrator/language/it-IT e copia al suo interno tutti i file della cartella "admin_it-IT" presente nel pacchetto lingua. Crea la cartella language/it-IT e copia al suo interno tutti i file della cartella "site_it-IT" presente nel pacchetto lingua. Questo l'esempio per la lingua italiana.
- Sostituire il file che genera il database: "joomla.sql" con la versione localizzata. Verificare se sono state effettuate modifiche a questo file rispetto alla versione precedente, il file si trova qui: installation/sql/mysql
Se il file originare inglese ha subito modifiche limitate è possibile con molta attenzione provare a replicare esattamente queste modifiche al file localizzato della versione precedente.
Se le modifiche sono state molte, come in caso di passaggio a versioni Minor allora consiglio di utilizzare il file joomla.sql originale dove apportare le personalizzazioni della lingua che è possibile individuare confrontando il file localizzato con quello originale della rispettiva versione.
Moficicare nel file del database i riferimenti alla lingua installata, quindi indicativamente alla linea 653 modificare la data di rilascio ed il numero di versione ecc... nel file xml presente nel pacchetto lingua sono presenti i valori da copiare.
In caso di modifiche al file joomla.sql controllare la codifica (formato) che sia sempre in: UTF-8 senza BOM prima di salvare le modifiche.
- Copiare il file pkg_it-IT.xml dal pacchetto lingua alla cartella administrator/manifests/packages
- Verificare se sono state fatte modifiche al file dei dati di esempio originali(quello standard: sample_data.sql), se non sono state fatte modifiche copiare il file dei dati di esempio italiani dal pacchetto precedente (quello creato in italiano) "sample_data_it.sql" e copiarlo nella cartella installation/sql/mysql/
Se il file originale sample_data.sql ha subito modifiche in questa versione allora valutare se devono essere replicate anche nel file dei dati di esempio localizzato.
In caso di modifiche al file sample_data.sql controllare la codifica (formato) che sia sempre in: UTF-8 senza BOM prima di salvare le modifiche.
- Modificare il file installation\language\it-IT\it-IT.ini ed inserire come ultime rige:
INSTL_SAMPLE_DATA_IT_SET="Dati di esempio Italiani (IT)"
INSTL_SAMPLE_DATA_IT_SET_DESC="Installa Joomla! con alcuni articoli e relativi moduli in stile blog e tradotti in italiano. (scelta consigliata)"
Modificare nello stesso file la stringa:
INSTL_COMPLETE_LANGUAGE_1="Joomla!® nella tua lingua e/o creazione automatica di un sito base in multilingua"
in
INSTL_COMPLETE_LANGUAGE_1="Joomla!® è già nella tua lingua, scegli se vuoi procedere con la creazione automatica di un sito base in multilingua"
- Eliminare i file lingua installazione delle altre lingue nella cartella installation\language\

Ora è possibile comprimere il contenuto della cartella della versione di Joomla, attenzione a non modificare i permessi e privilegi di file e cartelle.
Testare accuratamente l'installazione del nuovo pacchetto, verificare il pannello amministratore interamente tradotto in italiano ed il lato sito. Provare la pubblicazione di più articoli verificando l'editor in italiano ecc...


Attenzione anche ad effettuare tutte queste operazioni su un PC che non possa contenere virus o malware ecc... che possano inserirsi nel pacchetto creato.
Se distribuite sul web il vostro pacchetto localizzato di Joomla ricordatevi di specificare questa frase dove inserite il link per il download: "This is an unofficial localized distribution of Joomla. Support of this distribution is only available from the team that created it. It is not warranted by the Joomla Project or Open Source Matters."
Non è permesso inserire link a siti che non siano Joomla.org all'interno dei dati di esempio localizzati o del database localizzato ecc.


Ad oggi con la versione 3 di Joomla pare non essere più così necessario distribuire la versione localizzata di Joomla. Ora il solo pacchetto di installazione originale di Joomla già contiene i file di lingua italiani della procedura di installazione. Al termine della procedura di installazione viene anche indicato di scaricare ed installare i file della lingua desiderata, in modo semplice e veloce. Quindi si avrà una installazione di Joomla già praticamente tutta in italiano anche partendo dal pacchetto originale, evitando così eventuali problemi che possono occorrere durante la procedura di localizzazione.

Ovviamente se avete consigli o segnalazioni per migliorare questa procedura sono i benvenuti, certamente possiamo mantenerla aggiornata assieme.