PDA

View Full Version : vBET integration instructions



vBET
14-03-10, 16:21
Installation of vBET is easy :) Still integration with other plugins can be tricky. It is because each mod is working in different way and using other hooks. But first of all:
You do NOT have to integrate vBET with all your other mods. Most mods are working fine with vBET without any additional steps.

Below you will find general integration instructions and after that instructions for specific mods (if you do not find your mod name there - please fallow general instructions).

Which mods possibly will require additional vBET integration:

Generating page content by Ajax (http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/489-vbet-integration-instructions.html#post1791)
SEO engines (http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/489-vbet-integration-instructions.html#post1792)
Creating new ways of adding user messages (http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/489-vbet-integration-instructions.html#post1793)
Using its own subdirectory in URL (excluding SEO engines, where such subdirectory is virtual) (http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/489-vbet-integration-instructions.html#post1794)
Generating content without usage of global_complete hook (http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/489-vbet-integration-instructions.html#post1795)


How to integrate vBET exactly with this mod:

PhotoPost - see instructions for case 4 and 5
Sitemap generator (from vBSEO) (http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/98-sitemap-generator-integration.html)
vBAdvanved Dynamics (for vBET3.x) (http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/99-vbadvanced-dynamics-integration.html)
vBAdvanced Links Directory - see instructions for case 4
vBSEO (http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/97-vbseo-integration.html)
Vault Wiki (http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/1923-vaultwiki-integration.html)


Also if you want to translate pages supported by vBulletin, but outside forum directory, then see here for instructions : http://www.vbenterprisetranslator.com/forum/troubleshooting/6-faq-2.html#post54

vBET
14-03-10, 16:27
Requires basic PHP knowledge.
Integration of first group is easy as long as xml_print_output is used. If you are not sure does specific mod is using it ask mod author or just try to integrate and check results.
So to integrate it all what you have to do is find place (in some plugin or php file) where mod generates URL for Ajax request and add at the end of this request:


.'&language='.$_REQUEST['language']

or if there is no any parameter in URL:


.'?language='.$_REQUEST['language']

vBET
14-03-10, 16:28
vBET4.x officially supports vBulletin4 Frinedly URLs and vBSEO. Friendly URLs are working without any additional integration. For vBSEO integration instructions please see here:
http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/97-vbseo-integration.html

vBET
14-03-10, 16:29
In such case there is needed special integration mod designed for specific plugin. For example vBET3.x supports adding content by vB Advanced Dynamics (here is integration plugin (http://www.vbenterprisetranslator.com/forum/vbet-integration-other-plugins/99-vbadvanced-dynamics-integration.html)).

vBET
14-03-10, 16:31
First go to Admin CP -> vBET -> Main and set your additional directories in Keep Directories parameter.

For next step we have 2 cases here:
a) Your forum is using subdirectory in URL so you need to support content outside forum directory.
In such case just fallow instructions in this article: http://www.vbenterprisetranslator.com/forum/troubleshooting/6-faq-2.html#post54

b) Your forum is not using subdirectory in URL, so all directories added by mods are subdirectories of forum URL
In such case check does it is working right now. If not then add to .htaccess file in your forum main directory this rule (BEFORE other vBET rules):


RewriteRule ^/?(af|sq|ar|be|bg|ca|zh-CN|hr|cs|da|nl|en|et|tl|fi|fr|gl|de|el|iw|hi|hu|is|id|ga|it|ja|ko|lv|lt|mk|ms|mt|no|fa|pl|pt|ro|ru|sr|sk|sl|es|sw|sv|zh-TW|th|tr|uk|vi|cy|yi)/ADDITIONAL_DIRECTORY/(.*)?$ /ADDITIONAL_DIRECTORY/$2?language=$1 [L,QSA]

Please note that you have to change there ADDITIONAL_DIRECTORY to your directory name and you need such rule for each additional directory which you want to support and which is not working. Also please note that it is mostly needed when vBSEO is used.

vBET
14-03-10, 16:35
Supported since: vBET 3.3.2

Some mods like PhotoPost uses its own directories in URL and generate results straight to the output without usage of global_complete, which is necessary for vBET to make translation. In such case please follow instructions below.

NOTE: use it ONLY for mods which generates output using vBulletin but without global_complete hook. If you are not sure does particular mod is using it or not then please check mods list in first post. If you will not find it there then please first fallow steps from previous post and check does it working. If not then fallow this one. Please backup your .htaccess file before changes. Please note that it was tested on PhotoPost and we cannot guarantee that it will work for other mods without additional .htaccess changes which are not listed in instructions below.

Integration instructions:

In vBET package /do-not-upload/tools/vbenterprisetranslator_front_controller.php change 'SET_HERE_FULL_FORUM_DIRECTORY_PATH' to your full forum directory path.
Do not use '/' at the end. If you do not know what is your path, please see below for instructions.
Copy vbenterprisetranslator_front_controller.php file to directory used by mod in URL
Edit/create .htaccess file in directory used by mod in URL - for each existing rule make sure that it ends by [QSA] (it cannot end by [L] or even have L inside of ending [])
For directory used by mod in URL fallow instructions from previous post.
At the end of .htaccess file in directory used by mod in URL add this rule:


RewriteCond %{QUERY_STRING} !redirected=
RewriteCond %{QUERY_STRING} language=
RewriteRule ^(.*)$ vbenterprisetranslator_front_controller.php?redirected=$1&vbet_outside=true [L,QSA]

If rule bellow exists in edited .htacess file then make sure that it is at the end of file, if not then add it there:


RewriteCond %{QUERY_STRING} !vbet_outside=true
RewriteRule ^(.*)$ $1?vbet_outside=true [L,QSA]



How to check my full forum directory path:

Upload file vBET_package/do-not-upload/tools/actualdirectory.php to your forum directory.
Put URL to actualdirectory.php file in web browser and see the results.

AfrikaansAlbanianArabicBelarusianBulgarianCatalanChineseCroatianCzechDanishDutchEnglishEstonianFilipinoFinnishFrenchGalicianGermanGreekHaitian CreoleHebrewHindiHungarianIcelandicIndonesianIrishItalianJapaneseKoreanLatvianLithuanianMacedonianMalayMalteseNorwegianPersianPolishPortugueseRomanianRussianSerbianSlovakSlovenianSpanishSwahiliSwedishTaiwaneseThaiTurkishUkrainianVietnameseWelshYiddish
Translations supported by vBET Translator 4.9.2