Prijevod neke Joomla komponente ili modula nije teško uraditi - potrebno je samo poznavati jezik na koji prevodite i onaj sa koga prevodite i u nekom tekstualnom editoru (preporučujem Notepad ++) otvoriti originalni dokument i prevesti sav tekst.
Međutim, da bi bili u stanju distribuirati takav prijevod, odnosno podijeliti ga sa ostatkom svijeta, potrebno je kreirati Joomla instalacioni paket koji će korisnici jednostavno instalirati kao i sve druge Joomla komponente bez razmišljanja gdje šta kopirati i 'čačkanja' po web serveru.
Kako kreirati Joomla 2.5.x. jezički instalacioni dokument?
Joomla jezički dokument predstavlja .zip dokument koji sadrži odgovarajuće direktorije i dokumente postavljene u određenoj hijerarhiji.
Na slikama iznad su screenshot-ovi koji prikazuju hijerarhiju direktorija i dokumenata u jezičkom paketu.
Na prvoj slici iznad je prikaz direktorija koje treba kreirati u Joomla jezičkom paketu. Ime root direktorija, u ovom slučaju bs-BA.com_jcomments_by_Amicus_V2.3 (uzeo sam primjer svog prijevoda na Bosanski za JComments), nije ni bitno jer on NE ulazi u ZIP arhivu.
Bitno je da je unutar tog direktorija direktorij lang. Unutar root direktorija treba smjestiti i bs-BA.com_jcomments.xml koji predstavlja instalacijski konfiguracijski dokument. Ovaj XML dokument ima sljedeću strukturu:
<?xml version="1.0" encoding="utf-8"?>
<extension type="file" version="2.3.0." method="upgrade">
<!-- Molimo koristite jedinstveno ime da bi deinstalacija bila moguća. Treba biti identično imenu vašeg manifest dokumenta. -->
<name>bs-BA.com_jcomments</name>
<author>Samir Gutić</author>
<creationDate>5/06/2012</creationDate>
<copyright>2008-2013 http://amicus.ba</copyright>
<license>http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL</license>
<authorEmail>
<authorUrl>http://amicus.ba</authorUrl>
<version>1.0.0</version>
<description>Bosanski prijevod za JComments by Amicus, http://amicus.ba</description>
<!-- Definicija dokumenata -->
<fileset>
<!-- administratorsko sučelje -->
<files folder="lang/admin" target="administrator/language/bs-BA">
<filename>bs-BA.plg_search_jcomments.sys.ini</filename>
<filename>bs-BA.plg_system_jcomments.sys.ini</filename>
<filename>bs-BA.plg_system_jcomments.sys.ini</filename>
<filename>bs-BA.plg_user_jcomments.ini</filename>
<filename>bs-BA.plg_user_jcomments.sys.ini</filename>
<filename>bs-BA.plg_editors-xtd_jcommentson.sys.ini</filename>
<filename>bs-BA.plg_editors-xtd_jcommentsoff.sys.ini</filename>
<filename>bs-BA.plg_content_jcomments.sys.ini</filename>
<filename>bs-BA.plg_editors-xtd_jcommentson.ini</filename>
<filename>bs-BA.plg_editors-xtd_jcommentsoff.ini</filename>
<filename>bs-BA.plg_search_jcomments.ini</filename>
<filename>bs-BA.plg_jcomments_jcomments.avatar.ini</filename>
<filename>bs-BA.com_jcomments.menu.ini</filename>
<filename>bs-BA.plg_system_jcomments.ini</filename>
<filename>bs-BA.plg_content_jcomments.ini</filename>
<filename>bs-BA.com_jcomments.ini</filename>
<filename>index.html</filename>
</files>
<!-- za web stranicu -->
<files folder="lang/site" target="language/bs-BA">
<filename>bs-BA.plg_search_jcomments.ini</filename>
<filename>bs-BA.com_jcomments.ini</filename>
<filename>bs-BA.mod_jcomments_latest.ini</filename>
<filename>index.html</filename>
</files>
</fileset>
</extension>
U tagu <extension type="file" version="2.3.0." method="upgrade"> je bitno za methodnavesti "upgrade" da bi, u slučaju instalacije novije verzije jezika, novi ini dokumenti bili dodani bez brisanja starih (osim u slučaju istog imena, normalno).
Tag <name>bs-BA.com_jcomments</name> sadrži ime Joomla komponente ili modula za koji radite prijevod uz dodatak jezičke oznake. Za Bosanski jezik je to bs-BA.
U tagu <files folder="lang/admin" target="administrator/language/bs-BA"> treba tačno navesti putanju na kojima se nalaze INI dokumenti sa prijevodom (u jezičkom paketu) i putanju na koju će biti iskopirani na web serveru. U ovom primjeru je to lang/admin za putanju u jezičkom paketu (za prijevod administratorskog sučelja) i administrator/language/bs-BA za putanju na web serveru.
Za svaki dokument u lang/admin direktoriju u jezičkom paketu treba navesti sljedeći tag <filename>bs-BA.plg_search_jcomments.sys.ini</filename> gdje bs-BA.plg_search_jcomments.sys.ini predstavlja tačno ime tog INI dokumenta. U primjeru iznad je navedeno 17 dokumenata koji će biti kopirani na web server.
Slično tome, tag <files folder="lang/site" target="language/bs-BA"> sadrži putanje do dokumenata koji sadrže prijevode za korisničko sučelje, odnosno samu web stranicu.
Za kreiranje svog vlastitog XML-a možete kopirati kompletan XML iznad u Notepad ++ dokument, ispraviti ga da odgovara vašem prijevodu, čuvajući pri tome strukturu XML dokumenta i snimiti ga sa extenzijom .xml.
Kreirani XML treba sačuvati sa imenom istim kao što je ime dato u name tagu, u ovom primjeru je to bs-BA.com_jcomments.xml i to pored direktorija lang kao na drugoj slici iznad.
Sada, unutar lang direktorija treba kreirati direktorije admin i site u koje treba iskopirati sve prevedene dokumente za administratorsko i korisničko sučelje respektivno.
Napomena: Na trećoj slici iznad možete vidjeti INI dokumente koji sadrže prijevode i jedan index.html file. Taj index.html služi da spriječi posjetioce web stranice da pregledaju sadržaj /bs-BA direktorija. Kako? Ako posjetilac upiše adresu na vašoj web strancii koja ne postoji a niste dobro podesili prava pristupa direktorijima na web serveru, web preglednik će pokušati prikazati sadržaj direktorija u kome je trebao biti traženi članak. Međutim, ako u tom direktoriju postoji index.html on će automatski biti prikazan umjesto sadržaja direktorija. Zbog toga, ja kreiram praznu html stranicu i dodajem je u svije Joomla instalacije jezičkih paketa. :)
Na kraju treba kreirati Joomla! 2.5 jezički instalacioni paket. Kako to uraditi?
Joomla jezički instalacioni paket kreiramo tako što selektujemo sve što je unutar root direktorija, druga slika iznad i to zip-ujemo (pomoću winzip-a ili winrar-a) sa željenim imenom ali extenzija mora biti .ZIP.
To je sve što treba uraditi. Sada je Joomla 2.5. jezički instalacioni paket spreman za distribuciju i instalaciju.
Inače, punu instalaciju Joomla! 2.5.x CMS-a možete preuzeti sa linka ispod:
P.S.
Postupak kreiranja jezičkog instalacionog paketa za Joomla 1.5. je isti ali je XML dokument malo drugačiji. Ako nekoga zanima i kreiranje jezičkog instalacionog paketa za Joomla 1.5. neka napiše to u komentaru ispod ovog članka pa ću objasniti i taj postupak.