[How-To] Deal with Hack-Translations (vBulletin 3.5 RC1 and up)

[Andreas]

Keeping the new Product Management in mind, I think more and more Hacks will start using Phrases, as it becomes relatively easy to distribute Hacks with Phrases for both the Developers and the Users.

Most Hacks are being written in English, but as they are being used in many Countries, there might be needs for Translations.

Although it's possible to just provide different Product XMLs for different Languages, it seems to be better to take advantage of vBulletins Language System.
This way, Hack authors can provide additional Language XMLs for their works, while maintaining just one Product XML, and still the User can select which language to use.
It also makes it easy for 3rd Parties to provide Translations.

Developers/Translators
The following instructions require Debug Mode being turned on.
To do so, place


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


in config.php

To create a Translation, create a new Language (if it's not already present) and translate your Hacks phrases from the MASTER Language.
When you're done, go to Languages & Phrases, Download / Upload Languages.

Select the Language that contains the translated Phrases, select your Product and make sure that Just fetch Phrases is set to Yes - then download the Language.

End Users
To install a Translation for your Hack, import the provided Language XML and overwrite your existing Language (eg. if the Translation is for French overwrite your French langauge, if it is for Italian overwrite your Italian language, etc.).
This will of course not harm any Language Options or other Phrases.

This How-To is (C) 2005 by KirbyDE and you are not allowed to redistribute it in any way without my explicit consent.

[Allan]

yep thanks KirbyDE :)

[cclaerhout]

Thanks a lot KirbyDE. That's going to help me.

[D.Ilyin]

Nice HOW-TO! Thank's Andreas!
Can i add something for advanced users? :)

HOW-TO for advanced users:
1. Open new hack what you like to install & find


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------

2. If you didn't find it that mean that hack don't have any new phrases to translate :).
3. If you find some code between those TAG's then, create new file in any text editor with name somehack-language.xml.
4. Paste this code in it:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------

and save.
NOTE: where
"Russian (RU)" - your language
"3.5.3" - your translate for version of vB
5. Copy all code in your hack between TAG's

Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------

exlude them (see 1 for details :)), and paste it before

Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


6. Traslate all foring languages phrases ONLY between those TAG's:

Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------

where XXXXXXXXXXXXXXXXXXX - YOURS translated text.
7. After transleting SAVE your somehack-language.xml.
8. For installing your translated hack go to: AdminCP - Languages & Phrases - Languages & Phrases. Chose location for Import Language XML File where from you like to install translated hack. In Overwrite Language chose language what have been translated and click import.

That's all folk's :).
Tha last point (i mean 8) also needed for install translat for hack to another forum's :).

Thank's for attantion.