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 imported_silkroad

Yes, they should be ashamed of themselves. I think you will see a blog post on this topic soon, and you can point people to that blog article. When I see that article, I will let you know ...

Thanks :up:

[NLP-er]

Originally Posted by isatice

wow ur the best , works amazing
actually it's because in my forum main language is not English and it's against Google adsense rules to put ads
but now i can put ads in my English pages with ur great addon

Can you please tell me more about this AdSense rule? I'm surprised to hear something like that and would like to check it.

[isatice]

Originally Posted by NLP-er

Can you please tell me more about this AdSense rule? I'm surprised to hear something like that and would like to check it.

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

[imported_silkroad]

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

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

Please also be aware that placing the AdSense code on pages with content primarily in an unsupported language is not permitted

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

Arabic French Polish Bulgarian German Portuguese Chinese (simplified) Greek Romanian Chinese (traditional) Hebrew Russian Croatian Hungarian Serbian Czech Italian Slovak Danish Japanese Spanish Dutch Korean Swedish English Latvian Thai Finnish Lithuanian Turkish Norwegian Ukranian

[KrisP]

Response from Google:

You were sending a high volume of traffic to the Language API which looks like it may be abuse or the result of a programming error. Because you failed to identify yourself with an (optional) API key or by correctly setting your HTTP referer (as required by the Terms of Use), we were unable to contact you about this traffic.

I urge you to take a look at our Terms of Use:
http://code.google.com/apis/ajaxlanguage/terms.html

Please pay particular attention to the sections which require that every query be at the direct request of an end user and that the results must be shown to the user (unmodified). Also notice the requirements around identification.

I appreciate the fact that you are only caching results for <15 days. However, please note that it is in violation of the terms to refresh your cache automatically. Instead, you should wait until a specific translation is requested by an end user. When this happens, you can perform the request to the API, then temporarily cache the results (as you're currently doing) in addition to displaying them to the user who requested the translation.

Once you make that change to your system - as well as add the required identification - please provide me with the IP address of your server, and I'll be able to unblock your access to the API.

Seems from the response:

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

[jaryx]

Originally Posted by NLP-er

Yes - simply edit your templates and add:

<if condition="!$_GET[language]">THIS WILL BE SHOWN ONLY ON NOT TRANSLATED PAGE</if>

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:

    Arabic French Polish Bulgarian German Portuguese Chinese (simplified) Greek Romanian Chinese (traditional) Hebrew Russian Croatian Hungarian Serbian Czech Italian Slovak Danish Japanese Spanish Dutch Korean Swedish English Latvian Thai Finnish Lithuanian Turkish Norwegian Ukranian

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

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

[imported_silkroad]

Originally Posted by KrisP

Response from Google .....

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:

[imported_silkroad]

Originally Posted by jaryx

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

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

In NLP-er's code, all languages are configurable in the UserCP for this mod.

In addition, some people use 301 redirection if they have an issue with any language and want to redirect the traffic to that language.

[imported_silkroad]

Here are a few examples of Geotargeting by country and some examples with $_GET[language]. Requires Apache2, this plugin and Apache mod_geoip.

<if condition="in_array($_SERVER['GEOIP_COUNTRY_CODE'], array('US','UK','CA','GB','IN','AU','MY','SG','HK' ))">
<!-- Your CPM Ad Code Here -->
<else />
<!-- Your Adsense Ad Code Here -->
</if>

Here is another example (for postbit)

<if condition="(($post[postcount] % $vboptions[maxposts] == 1)) AND is_member_of($vbulletin->userinfo, 1,3,4,11,21)">
<if condition="in_array($_SERVER['GEOIP_COUNTRY_CODE'], array('UK','GB'))">
<div class="postbit_adcode">
<span style="float:right; margin: 0 0 30px 30px; width: 310px; height: 260px;">
<!-- Your CPM Ad Code for the UK Here) -->
</span>
</div>
</if>
<if condition="in_array($_SERVER['GEOIP_COUNTRY_CODE'], array('US','CA','IN','AU','MY','SG','HK'))">
<div class="postbit_adcode">
<span style="float:right; margin: 0 0 30px 30px; width: 310px; height: 260px;">
<!-- Your CPM Ad Code for the US, Canada, etc Here) -->
</span>
</div>
</if>
<if condition="!in_array($_SERVER['GEOIP_COUNTRY_CODE'], array('US','UK','CA','GB','IN','AU','MY','SG','HK' )) AND !$_GET[language]">
<div class="postbit_adcode">
<span style="float:right; margin: 0 0 30px 30px; width: 310px; height: 260px;">
<!-- Your Rest-of-the-World CPM Code in Your Standard Forum Language Here) -->
</span>
</div>
</if>
<if condition="!in_array($_SERVER['GEOIP_COUNTRY_CODE'], array('US','UK','CA','GB','IN','AU','MY','SG','HK' )) and $_GET[language] ">
<!-- Your World Adsense Ad Code for all your Translated Languages Here) -->
</if>
</if>

Enjoy.

[jaryx]

Originally Posted by imported_silkroad

In NLP-er's code, all languages are configurable in the UserCP for this mod.

In addition, some people use 301 redirection if they have an issue with any language and want to redirect the traffic to that language.

I took a little bad.
I just want traffic from these countries and their languages, but do not want to display ads on pages in their languages.

Originally Posted by imported_silkroad

Here are a few examples of Geotargeting by country and some examples with $_GET[language]. Requires Apache2, this plugin and Apache mod_geoip.

Here is another example (for postbit)
Enjoy.

Thank you. Dziękuję
I'll check it.