Forum Display Enhancements - vB Enterprise Translator

2.3.15 RELEASED - TRANSLATIONS NEVER WERE SO FAST!!!

Great thanks to all who nominate vBET and allow us to win MOTM :up:

This mod translates your forum using FREE translations for over 30 languages from Yandex API. It is 100% FREE in version described here (2.x).
Note: using this mod (vBET 2.x) is free and bound by license agreement (see below)

Yandex translation gives you 1 000 000 FREE characters per DAY to translate. Please note that Yandex do not supports all language pairs, but vBET detects automatically which are supported for your forum language.

Version for vBulletin 4.0 is here: vBET 2.4.x for vBulletin 4.0

vBET 3.x released!
Please note that vBET 3.x is developed as separate product line and it is available here: vBET 3.x. Full version is paid, it supports 53 languages each to each translation, using: Google, Microsoft, Apertium, Yandex, SDL BeGlobal and DetectLanguage. It has lot of optimizations for booth performance and translations costs.

LIVE DEMO - note that demo shows functionality of full version (3.x/4.x), which has more features than 2.x
See also screen shots below, for configuration options

Features:
- Translation by Yandex (in PRO version supports 53 languages using several translation providers)
- Optimized cache, algorhitms and more performance options - PRO version only
- Translates URLs and RSS - PRO version only
- Supports multi language communities (allows to write in different languages) - PRO version only
- Links appropriate for SEO consensus (configurable) - even without any SEO mod
- Long texts are translated no matter how big those are
- Translation cache (after first 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)
- Easy installation - just upload files and import product file
- Highly configurable and easy configuration - by Admin CP (see screenschots)
- 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
- Translates also archive pages
- Reverse page direction for Arabic, Hebrew and Persian languages
- Not translated save areas - if you need something to be not translated simply edit appropriate template and put it between
<!--START vBET NOT TRANSLATED AREA--> and <!--END vBET NOT TRANSLATED AREA--> (note: you cannot use any mod which removes comments to use this functionality)

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 here: "Mark as Installed" Thanks!
5. Configure in AdminCP -> vBulletin Options -> vBulletin Options -> vB Enterprise Translator
You MUST configure at least Forum language and Yandex Translation API key. NOTE that there are some other important options - especially if your forum is in subdirectory or if you use vbSEO.

For MORE INFO and troubleshooting 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:
- link for page on which you are doesn't track translation, cause it has same URL as flag for forum default language

ENJOY! :up:

And thanks for nominations

Already donated (great thanks:up:
PossumX, adwade, roymogg, zipperty, CoZmicShReddeR, RedHacker, john devost, mandingo, chris, smnoel, Audax666, Damas, TurkeySub, nectons, Scalemotorcars, TheWite, Cybershaolin, burlesque, Ransy72560, chick, jaryx, linuxututs, cormee, dai-kun x2 :up:, imported_silkroad, Megatr0n, KrisP, CareyCrew, ghisirds, vitoreis, cyc, mosz, CThiessen, actolearn, jaconi, andie215, yahoooh, bollie

LICENSE AGREEMENT - using this mod you agree for those conditions:
- you are NOT allowed to remove credit link under any conditions
- removing credit link means BREAKING LICENSE AGREEMENT and you lose your rights to use this mod
- using it after that is illegal, it is software PIRACY and it will be notified in vBulletin community and other places, including appropriate government/police units in your country
- author of this mod reserves the right to change the terms of this license agreement at any time. Failure to receive notification of a change does not make those changes invalid. A current copy of this license is and will be available here.

Please note that in full vBET version there is possibility to buy branding free license. There is no such possibility in free version included here.

Version history:
2.3.15 Changes:
- Fixed canonical link
- Fixed issue with SSL verification
2.3.14 Changes:
- Added 48 new languages pairs
- Updated link to Yandex in configuration
- When translation limit is reached now we show original text instead of empty message
2.3.13 Updated link to Yandex API key
2.3.12 Google changed to Yandex translations
2.3.11 Added "Affiliate Program" parameter
2.3.10 Footer bug corrected
2.3.9 userip added to Google translation request + small bug fixed
2.3.8 Small bug fixed - now all supported languages can be chosen as forum default language
2.3.7 Bugs fixed:
- weird redirections with vbet_lang
- double language in URL
- changing text direction for specific languages
Added support for:
- usernames not translated in who is online
- supported URL replacements for canonical URL
2.3.6 Important fix! - there was issue with sending referrer header which is necessary by Google conditions. This one was fixed + issue with # in translation links
2.3.5 Important change - According to Google conditions referrer header must be added to each translation query - otherwise you can be banned by Google. Install this version to avoid any troubles.
Changes:
- Added referrer header for Google translation queries
- Corrected bug for returning to forum main page from translated page
Also according to actual Google conditions your "Powered by Google" information should have Google logo. So please change text for flags in your vBET configuration to something like this:

Automatic Translations (Powered by <span style="vertical-align:sub;"><img src="http://www.google.com/uds/css/small-logo.png" alt="Powered by Google" border="0"/></span>):

You can customize it but "Powered by Google" should stay.
2.3.4 Important bug fixed! Corrected translation of meta keywords and description
2.3.3 Important bug fixed! And also some other bugs fixed
- Fixed bug with shifted results caching
- Fixed bug for URLs to javascript functions
- Fixed bug for not translating usernames in postbit
- Little cosmetic changes
2.3.2 Really little changes.
- Changed default value of "Links title" attribute, to be more accurate for Google conditions
- Little template changed for flags, so "Link title" font will be smaller (just like vB info in footer)
- Small bug fixed
2.3.1 Some little bug fixes. Confirmed working with vbSEO 3.3.1 and confirmed working SEO links on forums with vbSEO and subdirectory in URL
2.3.0 Great news for those without vbSEO
- Supports translation SEO links even without vbSEO
- Translate Google Maps (configurable)
- Little optimizations (i.e. included only necessary things for not translated pages)
- Supports several cache cleaning strategies (optimization for really big forums) and automatically disables cache for cleaning time to avoid read/write conflicts
2.2.1 Small bug fixed with returning to default language for main page and SEO links (happens only for specific vbSEO configuration, so you don't need to update if 2.2.0 is working for you)
2.2.0 Translation tracking is working even when redirection by some mod occures (configurable reaction time)
2.1.0 9 new translation languages added! Also:
- Redirect to user language functionality - configurable (disabled, forced, after asking user does he want to be redirected).
- Fixed bug for SEO links with forums acting like directories by id.
- Corrected several flags
Update note: if you use SEO links you must change .htaccess file according to description in first post. If you changed any vbseo.php rules ? un-change those.
2.0.3 Quick bug fixing (issue with bitfields in options panel)
2.0.2 Added option to set your forum main domain for tracking URL's in subdomains
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.
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

[NLP-er]

Originally Posted by isatice

here it is : What languages does AdSense support?

there are only a few languages supported by google adsense , otherwise google will close the publisher's account

I see there that you can't use AdSense for not supported languages, but you can have site in many languages. So you can use AdSense for each language which is supported.

I'm going to TOS to learn more, but on this very page which you gave is written that AdSense will handle commercials language even if page is in many languages, so it means that it is allowed to have different languages.

[NLP-er]

Originally Posted by imported_silkroad

That is not (edit: completely) true. Google's policy states:

And there are certainly more than a few languages supported as both primary and secondary languages:

I'm not sure do I understood it well, because of word "primarily", which translated to my language can have 2 different meanings. So is it used here as "originally" of as "mostly"?...

[NLP-er]

Originally Posted by KrisP

Response from Google:



Seems from the response:

You cannot populate the cache beforehand - it must be the end user (or Googlebot) doing that.

vBET is NOT pre-populating cache. It is populated as the requests comes. Send this information go Google staff and tell that they can review the code of free version to be sure about that (paid too, but after contact with me).

Also - we had here big discussion about headers

All - referer header and API key are supported in newest versions of vBET (booth 2.x and 3.x). API key you can set in options and referer headers are send automatically each time when request is coming to Google (in vBET 3.x even for automatic language detection).

So just made vBET update, set your key and send them message that you fit all TOS. Google likes to give access back, when everything is OK

[NLP-er]

Originally Posted by jaryx

What would be code for a specific language(s)?

For example, I would just turn off the Belarusian and Catalan?

Here you will find all supported by vBET codes and languages for those. Just change condition in code I gave you before.

    return array ("af"=>"Afrikaans","sq"=>"Albanian","ar"=>"Arabic",
 "be"=>"Belarusian","bg"=>"Bulgarian","ca"=>"Catalan","zh-CN"=>"Chinese",
"hr"=>"Croatian","cs"=>"Czech","da"=>"Danish","nl"=>"Dutch",
"en"=>"English","et"=>"Estonian","tl"=>"Filipino","fi"=>"Finnish",
"fr"=>"French","gl"=>"Galician","de"=>"German","el"=>"Greek",
"iw"=>"Hebrew","hi"=>"Hindi","hu"=>"Hungarian","is"=>"Icelandic",
"id"=>"Indonesian","ga"=>"Irish","it"=>"Italian","ja"=>"Japanese",
"ko"=>"Korean","lv"=>"Latvian","lt"=>"Lithuanian","mk"=>"Macedonian",
"ms"=>"Malay","mt"=>"Maltese","no"=>"Norwegian", "fa" => "Persian", 
"pl"=>"Polish","pt"=>"Portuguese","ro"=>"Romanian","ru"=>"Russian",
"sr"=>"Serbian","sk"=>"Slovak","sl"=>"Slovenian","es"=>"Spanish",
"sw"=>"Swahili","sv"=>"Swedish","zh-TW"=>"Taiwanese","th"=>"Thai",
"tr"=>"Turkish","uk"=>"Ukrainian","vi"=>"Vietnamese","cy"=>"Welsh",
"yi"=>"Yiddish");

[imported_silkroad]

Originally Posted by NLP-er

I'm not sure do I understood it well, because of word "primarily", which translated to my language can have 2 different meanings. So is it used here as "originally" of as "mostly"?...

I think, in this case, "primarily" means "your original language", not translated.

But, only Google really know what they mean !

[imported_silkroad]

Originally Posted by NLP-er

AdSense will handle commercials language even if page is in many languages, so it means that it is allowed to have different languages.

Yes, that's right.

If you use Google Analytics and integrate it with Google Adsense, there is a section which breaks down Adsense revenue by language in GA.

So, it is easy to see that Google supports multiple language per site.

I strongly recommend every person who runs this mod run Google Analytics.

(This is the second time I have made this recommendation, BTW).

If you use GA, you will easily see what Google supports regarding languages

AND, you can see almost exactly the eCPM and CTR of each language on your site

Don't worry. Be happy

[NLP-er]

Originally Posted by imported_silkroad

Hi Kris,

Great job! Glad to see you back up again soon.

Google is fair.

OBTW, a long time ago (well, around 5 months ago), there was a member of these forums called T2x. He was the first person to insist that people need to add the referral header code and to use the Google API key. He also was the first person to crack the code on rewriting the URLs to get rid of the question mark in the query.

At the time, the guy who paid for the code for the first translation mod (whom NLP-er worked with to make the code actually and the database work properly) really ridiculed T2x for warning people to add the referral header to Google and to add the optional AJAX search API.

It turns out that T2x is the hero for all of us. He was the first to work out these issues. We have been running T2x's code for months and never had any problems because we have always had the referral headers, etc. We followed T2x completely because what he said corresponded directly with the Google TOS.

My public praise for T2x takes nothing away from NLP-er who has done a great job too, without a doubt.

However, I think it is important to remind everyone that it was fellow forum team member T2x that was the first person to work out all the Google TOS issues and provide the original code fixes.

Everyone here owes T2x and word of thanks, including me.

Thank you T2x!

You are 'da man! :up: :up: :up:

I do not remember T2x making automatic cache clearing

[Kolbi]

Originally Posted by imported_silkroad

Yes, that's right.

If you use Google Analytics and integrate it with Google Adsense, there is a section which breaks down Adsense revenue by language in GA.

So, it is easy to see that Google supports multiple language per site.

I strongly recommend every person who runs this mod run Google Analytics.

(This is the second time I have made this recommendation, BTW).

If you use GA, you will easily see what Google supports regarding languages

AND, you can see almost exactly the eCPM and CTR of each language on your site

Don't worry. Be happy

Can you tell me how to use analytics as good as possible?

[imported_silkroad]

Originally Posted by NLP-er

I do not remember T2x making automatic cache clearing

You are right. As I recalll, T2x uses manual cache clearing or automates cache clearing using a MySQL script.

However, T2x did work out the Header Referrals and the vBSEO Link Consensus code. In fact, one of the reasons I was arguing with you about a "new requirement" to add referral headers to the code is that I already have it since July from T2x and forgot about it. That was way I did not think it was important, because I forgot we installed T2x's AJAX API and Referral Header code in July for translations.

[KrisP]

How much new content is too much?

I am wondering if Googlebot might flag if a sites content (number of pages) after growing slowly for years suddenly grows 10 times over night.

If it might be an idea to add one language at a time over a longer time period instead of over night?