vB Enterprise Translator

Just Smile · 08-22-2009, 09:11 PM

2.0.1 RELEASED - TRANSLATIONS NEVER WERE SO FAST!!!

This mod translates your forum to 43 languages!
See screen shots for full list of supported translations

- It is highly optimized and works very fast for translation service (used cache, batch queries to Google and DB)
- Can track translation in URL's
- EASY INSTALLATION by product file. No manual template or database modifications.
- Links appropriate for SEO consensus

LIVE DEMO - translations flags are at the bottom of page.
See also screen shots below, for configuration options

Detailed features:
- Translation to 43 languages
- You can select which translations are active - simply check/uncheck each of 42 languages in options panel
- Translation URL's tracking - if page is translated then links are changed to keep translation (it is smart – it will not change links going outside your forum, or links to images)
- Links appropriate for SEO consensus (configurable)
- Long texts are translated no matter how big those are
- Not translated save areas - if you need something to be not translated simply edit appropriate template and put it between
 and  (note: you cannot use any mod which removes comments to use this functionality)
- Translation cache (after first Google translation results are cached and next page generation is much faster)
- Doesn't translate BB codes for code, php and html (must refresh post cache to see effect on existing posts Admin CP -> Maintenance -> Update Counters -> Rebuild Post Cache)
- Takes data from cache by series - this mod remembers which translations often comes together and it can take whole bunch of translations in one DB query
- Easy installation - just upload files and import product file
- Easy configuration - by Admin CP
- Version support
- Configurable cache - you can easy turn off cache
- Option enable/disable taking data from cache by series
- Option to select native forum language (language parem will not be added for this flag)
- Supports native vB links and vBSEO - and it is easy to support other SEO engines
- Configurable place for flags - simply select in options where you want to have translation flags. NO MANUAL TEMPLATE MODIFICATION. Supported: Footer-Bottom, Footer-Top, Navbar-Bottom, Navbar-Top, Custom
- Possible custom place for flags - in such case just edit template which you want and add $vbenterprisetranslatorflags
- Configurable header for flags
- Flags generation base on templates - so if you need to customize for several styles simply edit hose templates: vbenterprisetranslator_flags_begin, vbenterprisetranslator_flag, vbenterprisetranslator_flags_end. This is optional - if you don't want to mess with templates jus use default configuration
- Option to enable/disable URL tracking for translation
- Translates also archive pages
- Cache is working for chosen languages (you simply select for each language does translations should be cached)
- Option to add Google Translate API key for translation requests
- Configurable cache time to live and scheduled task which automatically remove old cache.
- Option to show flags only for guests
- Option to easily remove flags border (without any style changing)
- Option to not translate usernames
- During translation changes param lang in html tag
- Option to translate messages changed by vBSEO to JavaScript (it has such functionality for SEO purposes)
- Re-encode not translated parts, so there is no strange signs in scripts, images title etc.
- Respecting Google conditions, default flags title have link to Google (configurable)
- Reverse page direction for Arabic, Hebrew and Persian languages
- Option to set forum directory if not linked to domain

Installation:
1. Download zip package (last release - see index at the end of file name)
2. Upload to your forum directory on server everything inside upload directory
3. Import in vB Admin CP -> Plugins & Products -> Manage Products -> Add/Import Product -> Choose product file, set Allow Overwrite to yes and click Import
4. Click : "Mark as Installed"

Thanks!
5. Configure in AdminCP -> vBulletin Options -> vBulletin Options -> vB Enterprise Translator
You MUST configure at least Forum language option. NOTE that there are some other important options - especially if your forum is in subdirectory or if you use vbSEO.

For MORE INFO and trouble shooting please read first post There is FAQ. So save your time for writing questions which are already answered and get your solution faster

Known issues:
- vbSEO redirects tracked URL's with translation for new posts in forum. Links are correct, but after clicking vbSEO makes redirect and language param is lost. In all other places tracking translation works fine.
- link for page on which you are doesn't track translation

When new features will come:
When you motivate me Good words, clicking "Mark as Installed", voting, nominating to MOM and donations are good for my motivation

ENJOY!

And thanks for nominations

Already donated (great thanks):
- jaconi
- andie215
- yahoooh
- bollie
- chick

Version history:
2.0.1 Small bug fixed and added direction changing suport also for Hebrew
2.0.0 Some small or medium changes and one big - for vbSEO users now SEO consensus links available.
GREAT THANKS TO T2x WHO SUPPORTED WITH HIS CODE INTEGRATION WITH vbSEO!!! - without you people have to wait a long time for this step You can all see his work in vbenterprisetranslator_seo.php file - who knows will recognize how tricky and painful had to be writing this code. Once again - great thanks T2x
Important update note - if you made before any changes in vbseo.php described by T2x - undo it.
What's new:
- Links appropriate for SEO consensus (configurable)
- Persian support added
- Doesn't translate BB codes for code, php and html (must refresh post cache to see effect on existing posts Admin CP -> Maintenance -> Update Counters -> Rebuild Post Cache)
- Reverse page direction for Arabic and Persian languages
- Option to set forum directory if not linked to domain
- Few bugs fixed
1.1.1 Some little changes and bugs fixed
- Re-encode not translated parts, so there is no strange signs in scripts, images title etc.
- Corrected flag for Sweden
- Few harmless bug fixed in translation tracking and cache disabling
- Respecting Google conditions default flags title have link to Google (configurable)
1.1.0 Lot of new features and no longer in beta stage
- Long texts are translated no matter how big those are
- Cache is working for chosen languages (you simply select for each language does translations should be cached)
- Option to add Google Translate API key for translation requests
- Configurable cache time to live and scheduled task which automatically remove old cache.
- Option to show flags only for guests
- Option to easily remove flags border (without any style changing)
- Option to not translate usernames
- During translation changes param lang in html tag
- Option to translate messages changed by vBSEO to JavaScript (it has such functionality for SEO purposes)
1.0.5 Flags showing correctly for forums in subdirectory + corrected returning to base language
1.0.4 Bug fixed with translation of '0' string. Also added little feature - if some parts of your forum uses vbSEO and some are not then now flags will have appropriate URL's everywhere
1.0.3 Big bug fixed

Mod doesn't mess in template anymore (it did in some specific cases)
1.0.2 Small bug fixed - error with array merge solved
1.0.1 Small bug fixed - now choosing supported languages in options works fine
1.0.0 Great mod released

Just Smile · 08-22-2009, 09:15 PM

Questions:
What is required for this mod to work?
What to do, to have translations links good for SEO consensus?
I have indexed pages from old translator (with hl=) - what to do?
I have indexed pages from old links type (with language=) and want switch to SEO links- what to do?
How do you get back to default language after you click a flag?
I have warnings in safe mode - what to do?
Can I add translated pages to sitemap?

Answers:
What is required for this mod to work?
- You must install it

and configure it appropriatelly (please read parameters descriptions carefully)

- You must have installed CURL in your php. Most servers already have it. Just install this mod and if it is not working then ask your server stuff to install CURL. In meantime you can disable mod or remove flags so users will not be affected. If you get blank page for translation pages (it will not affect your normal pages) it means that you don't have CURL installed - just install it

What to do, to have translations links good for SEO consensus?
You must have vbSEO, you must set in options of this mod to use SEO links, you must edit .htaccess file.
About editing .htaccess file:
1st above all rules to vbseo.php put this rule

        
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^/?((zh-CN|zh-TW|..))/?$ vbenterprisetranslator_seo.php?vbseourl=$1/index.php [L,QSA]

*=== Select Code ===*

2nd change all vbseo.php to vbenterprisetranslator_seo.php
So after those changes yours SEO rules should look like that (can vary according to vbSEO version):

        
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^/?((zh-CN|zh-TW|..))/?$ vbenterprisetranslator_seo.php?vbseourl=$1/index.php [L,QSA]
RewriteCond %{REQUEST_URI} !(admincp/|modcp/|vbseo_sitemap/|cron)
RewriteRule ^((archive/)?(.*\.php(/.*)?))$ vbenterprisetranslator_seo.php [L,QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !^(admincp|modcp|clientscript|cpstyles|images)/
RewriteRule $ vbenterprisetranslator_seo.php [L,QSA]

*=== Select Code ===*

I have indexed pages from old translator (with hl=) - what to do?
Thanks for solution to T2x

Just set rewrite rule in .htaccess - Google will know that page have new place and will reindex it without any loss

        
RewriteCond %{QUERY_STRING} (hl=)(zh-TW|zh-CN|..)$
RewriteRule ^(.*)$ http://%{HTTP_HOST}/$1\?language=%2 [L,R=301]

*=== Select Code ===*

I have indexed pages from old links type (with language=) and want switch to SEO links- what to do?
First make SEO links available. After that add this rule to .htaccess (before SEO rules):

        
RewriteCond %{QUERY_STRING} (hl=|language=)(zh-TW|zh-CN|..)
RewriteRule ^(.*)$ http://%{HTTP_HOST}/%2/$1? [L,R=301]

*=== Select Code ===*

Note that this rule will also handle redirections for links from old translator (with hl=)
How do you get back to default language after you click a flag?
If you have set tracking option on, then to go back to your default language you must just click flag for your default language

I have warnings in safe mode - what to do?
Just turn off save mode - it is DEPRECATED in php and not supported in future versions. See here for details:
http://us2.php.net/manual/en/ini.sec...#ini.safe-mode
Can I add translated pages to sitemap?
Yes - very easy

install vbSEO Sitemap Generator (it is free) and edit one file: vbseo_sitemap_functions.php in vbseo_sitemap directory.
Find:

        
$vbseo_stat[$archived?'at':'t'] += vbseo_add_2urls(

*=== Select Code ===*

And place above it with
For links with language=

        
//additional code
$alanguages = array ('sq', 'ar','bg', 'ca', 'zh-CN', 'hr', 'cs', 'da', 'nl', 'en', 'et', 'tl', 'fi', 'fr', 'gl', 'de', 'el', 'iw', 'hi', 'hu', 'id', 'it', 'ja', 'ko', 'lv', 'lt', 'mt', 'no', 'fa', 'pl', 'pt', 'ro', 'ru', 'sr', 'sk', 'sl', 'es', 'sv', 'zh-TW', 'th', 'tr', 'uk', 'vi', 'sq', 'ca', 'et', 'tl', 'gl', 'hi', 'id', 'lv', 'lt', 'mt', 'sl', 'uk', 'vi');
if(!$archived)
 foreach($alanguages as $language) {
   $vbseo_stat['t']++; 
   vbseo_add_url(vbseo_url_thread($threadrow, $p, $archived).'?language='.$language, $prior, $threadrow['lastpost'], $freq);
 } 
//end additional code

*=== Select Code ===*

NOTE: REMOVE YOUR DEFAULT LANGUAGE CODE from $alanguages
Also if you disabled some languages in option panel you have to delete it codes.

For SEO links

        
//additional code
$alanguages = array ('sq', 'ar','bg', 'ca', 'zh-CN', 'hr', 'cs', 'da', 'nl', 'en', 'et', 'tl', 'fi', 'fr', 'gl', 'de', 'el', 'iw', 'hi', 'hu', 'id', 'it', 'ja', 'ko', 'lv', 'lt', 'mt', 'no', 'fa', 'pl', 'pt', 'ro', 'ru', 'sr', 'sk', 'sl', 'es', 'sv', 'zh-TW', 'th', 'tr', 'uk', 'vi', 'sq', 'ca', 'et', 'tl', 'gl', 'hi', 'id', 'lv', 'lt', 'mt', 'sl', 'uk', 'vi');
if(!$archived)
 foreach($alanguages as $language) {
   $vbseo_stat['t']++; 
   $currentthreadurl = vbseo_url_thread($threadrow, $p, $archived);
   $strlenhost = strlen($vbseo_vars['bburl']."/");
   vbseo_add_url(substr($currentthreadurl,0,$strlenhost). $language."/".substr($currentthreadurl,$strlenhost), 0.3, $threadrow['lastpost'], $freq);
 }
//end additional code

*=== Select Code ===*

NOTE: REMOVE YOUR DEFAULT LANGUAGE CODE from $alanguages
Also if you disabled some languages in option panel you have to delete it codes.

Thread Tools
Show Printable Version Email this Page
Display Modes
Linear Mode Switch to Hybrid Mode Switch to Threaded Mode

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Ace Translator 8.2.0.398 القاموس الأسطورى لترجمة أكثر من 40 لغة	tedata	[ صالة ] البرامج العامة والمشروحة	0	10-24-2010 11:08 PM

Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)