Recentemente mi hanno proposto di realizzare un sito multilingua in Italiano, Inglese e Arabo.
Come ben saprete alcune lingue mediorientali, hanno la particolarità di essere scritte in modo speculare rispetto alla nostra ovvero da Destra a Sinistra (Right To Left).


Si evince da ciò la necessità di dover fare in modo che al cambiare della lingua, il nostro sito cambi la propria conformazione.


Ed ecco che insorgono i primi problemi, facendo però una ricerca con google ho trovato un ottimo tutorial in inglese da cui ho preso spunto per la realizzazione di questa piccola guida, traducendola ed aggiungendo alcune considerazioni personali.

Il tutorial originale lo potete trovare qui:

http://dev.xoops.org/modules/xfmod/pr ... up_id=1164&release_id=320

mentre i file necessari al raggiungimento del nostro scopo sono scaricabili da qui:

http://dev.xoops.org/modules/xfmod/pr ... 64&release_id=320&dl=1740

NOTA: Per la realizzazione di questo tutorial occorre installare il modulo XLANGUAGE


Via alle operazioni:


Applicabile a:
------------------------------
Tutte le versioni di Xoops 2.0.x e 2.2+ e tutti i temi.


Facile da realizzare
------------------------------

1- Copia tutti i file presenti nella cartella "themepersianRTL" all'interno della cartella del tuo tema ( es.: "default") in modo da ottenere una struttura come questa:
/css/styleRTL.css /language/persian /js/adminmenuRTL.js

2- Per tutte le versioni di Xoops:
2-1- Apri il file "theme.html" con un editor qualsiasi (Notepad/Dreamweaver...) e aggiungi le seguenti righe di codice :

<link rel="stylesheet" type="text/css" media="screen" href="<{$xoops_themecss}>" />
<!-- BEGIN ADD TO YOUR THEME -->
<{if $xoops_langcode == "ar"}>
<link rel="stylesheet" type="text/css" media="screen" href="<{$xoops_imageurl}>css/styleRTL.css" />
<{/if}>
<!-- END ADD TO YOUR THEME -->

A questo punto il vostro tema è già utilizzabile come tema normale e RTL, se hai un menù in Javascript o se il tuo Xoops è alla versione 2.2+ continua a leggere la guida.

2-2- Se il vostro tema incorpora un menu Javascript, editate nuovamente il file Theme.html e aggiungete a quanto detto sopra, le seguenti righe:

<script type="text/javascript" src="<{$xoops_imageurl}>js/adminmenu.js"></script>
<!-- BEGIN ADD TO YOUR THEME - ONLY FOR JAVASCRIPT THEME -->
<{if $xoops_langcode == "ar"}>
<script type="text/javascript" src="<{$xoops_imageurl}>js/adminmenuRTL.js"></script>
<{/if}>
<!-- END ADD TO YOUR THEME - ONLY FOR JAVASCRIPT THEME-->

3- Solo per Xoops 2.2+ :

3-1- Apri il file "themeadmin.html" con un editor qualsiasi (Notepad/Dreamweaver...) e aggiungi le seguenti righe di codice :

<link rel="stylesheet" type="text/css" media="screen" href="<{$xoops_themecss}>" />
<!-- BEGIN ADD TO YOUR THEME -->
<{if $xoops_langcode == "fa"}>
<link rel="stylesheet" type="text/css" media="screen" href="<{$xoops_imageurl}>css/styleRTL.css" />
<{/if}>
<!-- END ADD TO YOUR THEME -->

3-2- Se il vostro tema incorpora un menu Javascript, editate nuovamente il file Themeadmin.html e aggiungete a quanto detto sopra, le seguenti righe:

<script type="text/javascript" src="<{$xoops_imageurl}>js/adminmenu.js"></script>
<!-- BEGIN ADD TO YOUR THEME - ONLY FOR JAVASCRIPT THEME -->
<{if $xoops_langcode == "fa"}>
<script type="text/javascript" src="<{$xoops_imageurl}>js/adminmenuRTL.js"></script>
<{/if}>
<!-- END ADD TO YOUR THEME - ONLY FOR JAVASCRIPT THEME-->

NOTE di Urban

Nota1. Installazione di xlanguage

Inizialmente questo tutorial per quanto semplice, non ha funzionato subito, uno degli errori era nell'installazione di Xlanguage per l'installazione del quale dovete prestare molta attenzione nella modifica del file common.php che richiede l'inserimento di questa riga

include_once XOOPS_ROOT_PATH.'/modules/xlanguage/api.php';

prima di questo blocco

// #################### Include site-wide lang file ##################
    if ( file_exists(XOOPS_ROOT_PATH."/language/".$xoopsConfig['language']."/global.php") ) {
        include_once XOOPS_ROOT_PATH."/language/".$xoopsConfig['language']."/global.php";
    } else {
        include_once XOOPS_ROOT_PATH."/language/english/global.php";
    }

Per l'installazione vera e propria vi rimando all'ottimo readme presente nella cartella del modulo xlanguage.

Nota2. Database

Dopo aver realizzato la modifica al tema, ho provato ad inserire alcune voci nel modulo mxdirectory (modulo principale del sito in sviluppo) accorgendomi subito di una limitazione.
Dovendo inserire tre lingue nei vari campi, i valori di default presenti nel file mysql del modulo non erano sufficienti. Ad esempio per il titolo della categoria, la dimensione del campo era di 50 caratteri, capite da soli che inserendo ad esempio [it]categotia numero 1 in italiano[/it][en]categoria numero 1 in inglese[/en][ar]categoria numero 1 in arabo [/ar] non erano sufficienti.

Per ovviare a questo inconveniente ci sono due possibili soluzioni: a. se il modulo non è ancora stato installato basta modificare il file sql andando ad incrementare il valore ai campi di nostro interesse. b. se il modulo è già operativo potete modificare la tabella con phpmyadmin.

questo vale per tutti i moduli.

Spero che questa guida possa tornare utile a tutti.

Urban (http://www.xoopsitalia.org/userinfo.php?uid=1560)