xoops forums

Cesagonchu

Moderator
Posted on: 2013/4/29 23:05
Cesagonchu
Cesagonchu (Show more)
Moderator
Posts: 864
Since: 2010/2/1 2
#1

Tutorial for Xoops 2.5.6 translation

Here is a tutorial to help you translate XOOPS 2.5.6 entirely in your language.

First of all, you can help you with files already present on transifex, or just help with the translation on this website. Simply register, send me an email (see my profile) with your nickname, specify your language, and I will add you as a translator.

Explanation for the following lines:
yourlang = english or french
yourshortlang = en or fr

File list to translate (with explanations when it needs):

htdocs\class\xoopseditor\dhtmltextarea\language
yourlang.php

---------------------------

htdocs\class\xoopseditor\textarea\language
yourlang.php

---------------------------

htdocs\class\xoopseditor\tinymce\language
yourlang.php

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\themes\simple\langs
yourshortlang.js (0)

(0) shortlang example: en for english, fr for french

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\langs
yourshortlang.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xoopsimagemanager\langs
yourshortlang.js
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\themes\advanced\langs
yourshortlang.js
yourshortlang_dlg.js

----------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\paste\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\template\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xhtmlxtras\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xoopsmlcontent\langs
yourshortlang.js
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\advlink\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\fullpage\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\searchreplace\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\style\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\table\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\example\langs
yourshortlang.js
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xoopscode\langs
yourshortlang.js
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xoopsemotions\langs
yourshortlang.js
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xoopsquote\langs
yourshortlang.js
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\advhr\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\advimage\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\emotions\langs
yourshortlang_dlg.js

---------------------------

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\media\langs
yourshortlang_dlg.js

---------------------------

htdocs\Frameworks\moduleclasses\moduleadmin\language\
-> add folder
yourlang\
insert into this folder, the file main.php (translated in yourlang)

-> copy file index.html
htdocs\Frameworks\moduleclasses\moduleadmin\language\english\index.html
into
htdocs\Frameworks\moduleclasses\moduleadmin\language\yourlang\

---------------------------

htdocs\install\language
-> copy the english folder entirely
htdocs\install\language\english
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\install\language\yourlang
-> replace into it these files, with your own, translated into your language:
install.php
install2.php
welcome.php
support.php
-> in support.php file, add extra support sites, use corresponding language folder name as key, for instance:


$supports["french"] = array(
    
"url"   => "http://www.frxoops.org/",
    
"title" => "Support francophone"
);


---------------------------

htdocs\language
-> copy the english folder entirely
htdocs\language\english
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\language\yourlang
-> replace into it these files, with your own, translated into your language:
admin.php
auth.php
banners.php
calendar.php
captcha.php
comment.php
countries.php
errors.php
findusers.php
formdhtmltextarea.php
global.php
locale.php
logger.php
mail.php
misc.php
notification.php
pmsg.php
search.php
timezone.php
uploader.php
user.php
xoopsmailerlocal.php (0a)
\mail_template\activated.tpl
\mail_template\adminactivate.tpl
\mail_template\comment_notify.tpl
\mail_template\commentsubmit_notify.tpl
\mail_template\default_notify.tpl
\mail_template\lostpass1.tpl
\mail_template\lostpass2.tpl
\mail_template\register.tpl
\mail_template\tellfriend.tpl
\mail_template\welcome.tpl

(0a) Only put your lang code line 43, example for french:
$this->multimailer->SetLanguage("fr");

(1) Important: if you take the translated files from the website Transifex, you must rename the file .html into .tpl

---------------------------

htdocs\modules\pm\language
-> copy the english folder entirely
htdocs\modules\pm\language\english
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\modules\pm\language\yourlang
-> replace into it these files, with your own, translated into your language:
admin.php
main.php
modinfo.php
\help\help.html

(2) Important: if you take the translated file help.html from the website Transifex, I suggest you to take the English original file and edit from it, because the beginning of the code is truncated. Transifex not recognizing the code of XOOPS (i.e $xoops_url ; xoAdminIcons home.png), and it modifies or deletes it.

---------------------------

htdocs\modules\profile\language\
-> copy the english folder entirely
htdocs\modules\profile\language\english\
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\modules\profile\language\yourlang\
-> replace into it these files, with your own, translated into your language:
admin.php
main.php
modinfo.php
\help\help.html
\mail_template\emailchanged.tpl

Important: See warnings (1) and (2) above

---------------------------

htdocs\modules\protector\language\
-> copy the english folder entirely
htdocs\modules\protector\language\english
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\modules\protector\language\yourlang
-> replace into it this file, with your own, translated into your language:
\help\help.html

Important: See warning (2) above

---------------------------

htdocs\modules\system\language
-> copy the english folder entirely
htdocs\modules\system\language\english
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\modules\system\language\yourlang
-> replace into it these files, with your own, translated into your language:
admin.php
blocks.php
cpanel.php
modinfo.php
\admin\avatars.php
\admin\banners.php
\admin\blocksadmin.php
\admin\comments.php
\admin\groups.php
\admin\images.php
\admin\mailusers.php
\admin\maintenance.php
\admin\modulesadmin.php
\admin\preferences.php
\admin\smilies.php
\admin\tplsets.php
\admin\userrank.php
\admin\users.php
\help\avatars.html
\help\banners.html
\help\blocksadmin.html
\help\comments.html
\help\groups.html
\help\help_center.html
\help\images.html
\help\mailusers.html
\help\maintenance.html
\help\module_index.html
\help\modulesadmin.html
\help\preferences.html
\help\smilies.html
\help\tplsets.html
\help\userrank.html
\help\users.html

---------------------------

htdocs\modules\system\themes\default\language
-> copy the english folder entirely
htdocs\modules\system\themes\default\language\english
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\modules\system\themes\default\language\yourlang
-> replace into it these files, with your own, translated into your language:
admin.php
localsupport.php (3)(4)

(3) this file is the same in:
htdocs\modules\system\themes\zetadigme\language\yourlang

(4) for example in french file localsupport.php, we have this code:


define("_AD_XOOPS_LOCAL_NAME","Accueil");

define("_AD_XOOPS_LOCAL_FORUMS","Forums");

define("_AD_XOOPS_LOCAL_THEMES","Galerie de thèmes");

define("_AD_XOOPS_LOCAL_MODULES","Référentiel de modules");

define("_AD_XOOPS_LOCAL_XDONATIONS","Faire un don");

define("_AD_XOOPS_LOCAL_SFXF","Sourceforge Xoops France");


$menu = array();


// French support


$menu[] = array(
    
"link"      => "http://www.frxoops.org",
    
"title"     => _AD_XOOPS_LOCAL_NAME,
    
"absolute"  => 1,
    
"icon"      => XOOPS_ADMINTHEME_URL "/default/images/xoops.png"
);

$menu[] = array(
    
"link"      => "http://www.frxoops.org/modules/newbb/",
    
"title"     => _AD_XOOPS_LOCAL_FORUMS,
    
"absolute"  => 1,
    
"icon"      => XOOPS_ADMINTHEME_URL "/default/images/xoops.png"
);


$menu[] = array(
    
"link"      => "http://sourceforge.net/projects/xoopsfrance/",
    
"title"     => _AD_XOOPS_LOCAL_SFXF,
    
"absolute"  => 1
);


$menu[] = array(
    
"link"      => "https://xoops.org/modules/xdonations/",
    
"title"     => _AD_XOOPS_LOCAL_XDONATIONS,
    
"absolute"  => 1
);
return 
$menu;


---------------------------

htdocs\modules\system\themes\zetadigme\language\
-> copy the english folder entirely
htdocs\modules\system\themes\zetadigme\language\english
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\modules\system\themes\zetadigme\language\yourlang
-> replace into it these files, with your own, translated into your language:
admin.php
localsupport.php (3)(4)

See (3) and (4) notifications above

---------------------------

htdocs\themes\suico\language\
-> copy the english folder entirely
htdocs\themes\suico\language\english
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\themes\suico\language\yourlang
-> replace into it this file, with your own, translated into your language:
main.php

---------------------------

htdocs\themes\zetagenesis\language\
-> copy the english folder entirely
htdocs\themes\zetagenesis\language\english
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\themes\zetagenesis\language\yourlang
-> replace into it this file, with your own, translated into your language:
main.php

---------------------------

htdocs\xoops_lib\modules\protector\language
-> copy the english folder entirely
htdocs\xoops_lib\modules\protector\language\english
and past it
-> rename new folder (the copy) into "yourlang"
htdocs\xoops_lib\modules\protector\language\yourlang
-> replace into it these files, with your own, translated into your language:
admin.php
main.php
modinfo.php

--------------------------

htdocs\class\mail\phpmailer\language\
phpmailer.lang-yourshortlang.php

Work with this file: xoopsmailerlocal.php, see (0a) above.
--------------------------

=======
Optional?
=======

htdocs\xoops_lib\modules\protector\library\HTMLPurifier\Language
-> I don't know if we have to translate any file into this folder.


======================
Files not included on Transifex
======================

Files that are not accepted by Transifex (code or extension that are not compatible):

htdocs\install\language\yourlang\mysql.lang.data.sql

htdocs\install\language\yourlang\support.php

htdocs\install\language\yourlang\welcome.php

htdocs\xoops_lib\modules\protector\language\yourlang\modinfo.php

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\themes\simple\langs\yourshortlang.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\langs\yourshortlang.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\paste\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\template\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xhtmlxtras\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\advlink\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\fullpage\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\searchreplace\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\style\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\table\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\example\langs
yourshortlang.js
yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xoopscode\langs
yourshortlang.js
yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xoopsemotions\langs
yourshortlang.js
yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xoopsquote\langs
yourshortlang.js
yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xoopsimagemanager\langs
yourshortlang.js
yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\xoopsmlcontent\langs
yourshortlang.js
yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\themes\advanced\langs
yourshortlang.js
yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\advhr\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\advimage\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\emotions\langs\yourshortlang_dlg.js

htdocs\class\xoopseditor\tinymce\tinymce\jscripts\tiny_mce\plugins\media\langs\yourshortlang_dlg.js

htdocs\class\mail\phpmailer\language\phpmailer.lang-yourshortlang.php

htdocs\language\yourlang\xoopsmailerlocal.php

htdocs\install\language\yourlang\finish.php

htdocs\modules\system\themes\zetadigme\language\yourlang\localsupport.php

htdocs\modules\system\themes\default\language\yourlang\localsupport.php

Cesagonchu

Moderator
Posted on: 2013/4/30 2:25
Cesagonchu
Cesagonchu (Show more)
Moderator
Posts: 864
Since: 2010/2/1 2
#2

Re: Tutorial for Xoops 2.5.6 translation

I urge translators to follow my tutorial because I watched two translations of XOOPS 2.5.6 and a good portion of files are not translated.

There are files that are not in Transifex because we can not put them on. I gave you the list.

You do not have either heeded my warnings about help.html files (I specified it once more in my tutorial).

oswaldo

Not too shy to talk
Posted on: 2013/4/30 12:37
oswaldo
oswaldo (Show more)
Not too shy to talk
Posts: 184
Since: 2008/8/22
#3

Re: Tutorial for Xoops 2.5.6 translation

Thanks Cesag, I forgot to search the langs folders and to review the help files.

oswaldo

Not too shy to talk
Posted on: 2013/5/3 1:15
oswaldo
oswaldo (Show more)
Not too shy to talk
Posts: 184
Since: 2008/8/22
#4

Re: Tutorial for Xoops 2.5.6 translation

Thanks Cesag

All files are update now on spanish translations

Cesagonchu

Moderator
Posted on: 2013/5/3 13:37
Cesagonchu
Cesagonchu (Show more)
Moderator
Posts: 864
Since: 2010/2/1 2
#5

Re: Tutorial for Xoops 2.5.6 translation

Thanks especially to you for the translation

Cesagonchu

Moderator
Posted on: 2013/6/26 1:45
Cesagonchu
Cesagonchu (Show more)
Moderator
Posts: 864
Since: 2010/2/1 2
#6

Re: Tutorial for Xoops 2.5.6 translation

Please help us with Xoops 2.5.6 translations:
https://www.transifex.com/projects/p/xoops/r/256f/

EDIT: Transifex changed the links. Now we are working on Xoops 2.5.7 translation here:
https://www.transifex.com/projects/p/xoops-257/

anderssk

Quite a regular
Posted on: 2014/3/1 23:01
anderssk
anderssk (Show more)
Quite a regular
Posts: 335
Since: 2006/3/21
#7

Re: Tutorial for Xoops 2.5.6 translation

Hi Cesag,
I'm almost done with the danish translations, but the TX client is killing me

I translated online through transifex

got the TX utility
Run the following commands
tx set auto-remote https://www.transifex.com/projects/p/xoops
tx pull -l da_DK -s

Now i got the files on my local disk but in 171 folders each containing two files
da_DK.php
en_US.php

What am i doing wrong - I don't think that I have to rename all the files one-by-one?

Mamba

Moderator
Posted on: 2014/3/1 23:28
Mamba
Mamba (Show more)
Moderator
Posts: 10799
Since: 2004/4/23
#8

Re: Tutorial for Xoops 2.5.6 translation

I agree that the process is not the best, and Transifex could make it easier.

I was reading recently their blog about links to GitHub. Maybe this could help in the future.

Otherwise we might do the same way as we did on SVN - create files on GitHub, and let people to submit their versions, and then merge once approved by the Translatations team leaders.

Clearly, the process has to be very easy, otherwise the translators will lose interest very quickly.
Support XOOPS => DONATE
Use 2.5.10 | Docs | Modules | Bugs

Cesagonchu

Moderator
Posted on: 2014/3/1 23:48
Cesagonchu
Cesagonchu (Show more)
Moderator
Posts: 864
Since: 2010/2/1 2
#9

Re: Tutorial for Xoops 2.5.6 translation

Thank you for your help with translation anderssk!
I do not use the Transifex utility. I translate the files online and I download each manually.

Yes, each file must be renamed.

When I click on a file to use, its name includes the path for the position.

For example, the file:

for_use_xoops_language-renametoyourlanglocalephp_da_DK.php

will become:

locale.php

to place in:

language\danish\

anderssk

Quite a regular
Posted on: 2014/3/2 9:36
anderssk
anderssk (Show more)
Quite a regular
Posts: 335
Since: 2006/3/21
#10

Re: Tutorial for Xoops 2.5.6 translation

Now it takes longer time to fix and rename files that it does to translate them
I can't figure out how to download directly from the website - i think i missed something...

In the folder (and when i download files throug TX) i get
257[language-renametoyourlang]admin.php
admin.php
[language-renametoyourlang]admin.php

Why 3 files?


https://www.transifex.com/projects/p/xoops/translate/#da_DK