Partea 6 - fișiere lingvistice

În Joomla! 2.5 fișiere lingvistice sunt utilizate în patru situații diferite:

Afișarea unei componente în secțiunea publică a site-ului
gestionarea componentei din interfața de administrator
controlați elementele meniului din interfața de administrare
instalarea componentelor

Joomla! 2.5 utilizează două moduri diferite de localizare a fișierelor de limbă:

unul în administrator / limbă sau limbă
secunde în dosarul extensie. Dacă este o componentă, calea va fi: administrator / components / * component * / language sau components / * component * / language

Totul depinde de modul în care este instalată extensia.

Adăugați o traducere pentru partea publică a site-ului

Creați un fișier site / language / en-GB / en-GB.com_helloworld.ini:

COM_HELLOWORLD_DEFAULT_PAGE_TITLE = "Componenta Hello World!"
COM_HELLOWORLD_ERROR_OCCURRED = "A apărut o eroare"

și fișierul site / language / en-ru / en-RU.com_helloworld.ini:

COM_HELLOWORLD_DEFAULT_PAGE_TITLE = "Componenta Hello World!"
COM_HELLOWORLD_ERROR_OCCURRED = "A apărut o eroare"

Adăugați traducere pentru interfața de administrare

Creați fișierul admin / language / en-GB / en-GB.com_helloworld.ini:

COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC = „Acest mesaj va fi afișat“
COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL = "Mesaj"
COM_HELLOWORLD_HELLOWORLD_HEADING_GREETING = "Salut"
COM_HELLOWORLD_HELLOWORLD_HEADING_ID = "Id"

și fișierul admin / language / en-RU / en-RU.com_helloworld.ini:

COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC = "Mesaj de afișat"
COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL = "Mesaj"
COM_HELLOWORLD_HELLOWORLD_HEADING_GREETING = "Salut"
COM_HELLOWORLD_HELLOWORLD_HEADING_ID = "Id"

Adăugați o traducere pentru a gestiona elementele de meniu din interfața de administrare

Creați fișierul admin / language / en-GB / en-GB.com_helloworld.sys.ini:

COM_HELLOWORLD = "Buna ziua!"
COM_HELLOWORLD_DESCRIPTION = "Aceasta este descrierea Hello World!"
COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE = "Mesaj"
COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC = "Această vizualizare afișează un mesaj selectat"

COM_HELLOWORLD_MENU = "Bună ziua!"

și fișierul admin / language / en-RU / en-RU.com_helloworld.sys.ini:

COM_HELLOWORLD = "Buna ziua!"
COM_HELLOWORLD_DESCRIPTION = "Aceasta este descrierea lumii noastre Hello World!"
COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE = "Mesaj"
COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC = „Această vizualizare afișează mesajul selectat“
COM_HELLOWORLD_MENU = "Bună ziua!"

Opțiuni pentru localizarea fișierelor de limbă

De la versiunea 1.6, există două opțiuni pentru instalarea fișierelor lingvistice pentru extensie. Puteți să le utilizați într-o varietate de combinații. În versiunea 1.5, fișierele au fost instalate în directorul principal al limbii (ROOT / administrator / language / și ROOT / language /). Noua versiune include fișierele din folderul "language", care se află la nivelul extensiei. Astfel, extensia poate include un dosar de limbă cu un fișier .sys.ini. care diferă de cea instalată în directorul principal al limbajului Joomla.

sys.ini este, de asemenea, folosit pentru a traduce numele extensiei în anumite locuri din zona de administrare și pentru a traduce meniul de componente.

Astfel, un fișier xml poate include:

și / sau versiunea 1.5:

sau pur și simplu la rădăcină

În timpul instalării / actualizării extensiei, fișierul .sys.ini din dosarul situat în rădăcina extensiei va afișa rezultatul instalării din descriere. Apoi (dacă există) .sys.ini și .ini. instalat în folderul principal de limbă, va avea prioritate față de fișierele care se găsesc în directorul care se află în rădăcina extensiei.

Unul dintre avantajele instalării fișierelor în dosarul lingvistic. care se află la baza extensiei, este că aceste fișiere nu sunt afectate atunci când se actualizează pachetele de limbi. Un alt avantaj poate fi considerat că acest dosar poate conține mai multe limbi (întotdeauna en-GB, ru-RU, FR-FR, etc.) și, prin urmare, nu este necesar ca utilizatorul să instaleze pachetul lingvistic corespunzător.

Adăugarea unei traduceri pentru procesul de instalare al componentei

Creați o limbă de fișier / en-GB / en-GB.com_helloworld.sys.ini:

COM_HELLOWORLD = "Buna ziua!"
COM_HELLOWORLD_DESCRIPTION = "Aceasta este descrierea Hello World"

și fișierul / en-RU / en-RU.com_helloworld.sys.ini

COM_HELLOWORLD = "Buna ziua!"
COM_HELLOWORLD_DESCRIPTION = "Aceasta este descrierea Hello World!"

Colectăm pachetul de instalare al componentei

Nu uitați să schimbați numărul versiunii în fișierul helloworld.xml:

De asemenea, putem folosi pentru traducere numele componentei, descrierea componentei și elementul de meniu:

În secțiune add:

Și în secțiune add:

În acest fișier helloworld.xml, limbile sunt setate la:

Conținutul directorului cu codul:

Reîmpachetați directorul într-un fișier arhivă (zip, tar, tar.gz, bz2), sau descărcați-l direct c GitHub. Apoi, instalați-l utilizând managerul de extensii Joomla. Acum puteți să vă asigurați că traducerea funcționează:

În partea următoare, adăugăm panoul de control al componentei în panoul de administrare.