GTranslate Pro Documentation

Choose The Installation

For Joomla 1.5.x version install Joomla plugin using plg_gtranslate.zip .

For Joomla 1.6.x , 1.7.x and higher versions install Joomla plugin using plg_gtranslate-1.7.zip.

For other websites including Joomla 1.0.x, WordPress, Drupal, Magento and all Joomla versions in the subdirectory you need to install GTranslate Pro General version.

NOTE: Please DO NOT install both the Joomla plugin version and the General version at the same time.

GTranslate Pro Joomla Plugin installation

Check The System Requirements

Please check the system requirements before installing and activating the plugin.

To see the PHP information log in to the Joomla Administrator panel, click Help > System Info > PHP Information

Server requirements:
  • PHP ionCube Loader - can be found at http://www.ioncube.com/loaders.php, if you don't have it ask your hosting provider to enable it for you
  • PHP Curl library - default for the most hosts
  • PHP JSON library - default for PHP 5 >= 5.2.0
  • PHP SOAP client if you are going to use Bing Translator - default for the most hosts
  • Apache mod_rewrite or equivalent (IIRF or ISAPI_rewrite for IIS servers)

NOTE: Please do not activate the GTranslate Pro plugin if PHP ionCube Loader is not installed on your server.

Download the latest version of the GTranslate package gtranslate_yourdomain.com.zip which was sent by e-mail and unzip it locally.

Navigate to the Joomla admin area.

alt

Click Extension > Extension Manager (or Install/Uninstall) in the top menu.

alt

Click Browse in the upload package section.

alt

Upload the extension in zip format and click the Upload File & Install button. If the installation is successful, a confirmation message will be displayed.

alt

After you install the extension please go to Extensions > Plugin Manager. From the system plugins list locate the GTranslate plugin and click "enable" icon next to it. This will activate the plugin.

alt

In the Plugin Manager page click on the GTranslate plugin in the table to open the configuration page to change settings.

Select Site Language.

alt

If you have an API key you can place it. This is an optional feature. GTranslate Pro works without API Key.

Set the cache time in days (365 days by default).

SSL verify Pear – you can disable this option if you get CA certificate error and cannot reconfigure your server to solve the issue.

Detect Main Language -set to yes if you have mixed language content

Detect User Language - set to yes if you want to auto detect user predefined language

Debug Mode – enable the debug mode if you have any problems

Save settings and close .

Go to the Joomla Global Configuration page

alt

Enable Search Engine Friendly URLs and set Use URL rewriting to Yes (please rename htaccess.txt to .htaccess before activating) .

alt

Connect to your hosting server using an FTP client.

alt

Go to plugins/system/gtranslate/gtranslate (or /plugins/system/gtranslate for joomla 1.5.x versions) directory and set /gtranslate/cache and /gtranslate/cache/XX folders permissions to 777. DON'T change other files/folders permissions.

alt

Go to the root directory

Make sure that you have .htaccess file in the root directory. If you don’t have this file rename “htaccess.txt” to “.htaccess” .

Create robots.txt and upload it to the root directory.

Create sitemap.txt and upload it to the root directory.

Download and install GTranslate Free module and use Redirect translation method with 'Operate with GTranslate Pro' option On. This will enable the language

Gtranslate Pro General Installation

Download the latest version of the GTranslate package gtranslate_yourdomain.com.zip which was sent by e-mail and unzip it locally.

Connecting to your hosting server using an FTP client.

Upload gtranslate folder to your www root (public_html or httpdocs) directory. If you are using FTP set transfer type to BINARY it's IMPORTANT!

Check The System Requirements

Please check the system requirements before installing the plugin.

To see the PHP information upload info.php to the /gtranslate directory and access it by http://domain.com/gtranslate/info.php

Server requirements:
  • PHP ionCube Loader - can be found at http://www.ioncube.com/loaders.php, if you don't have it ask your hosting provider to enable it for you
  • PHP Curl library - default for the most hosts
  • PHP JSON library - default for PHP 5 >= 5.2.0
  • PHP SOAP client if you are going to use Bing Translator - default for the most hosts
  • Apache mod_rewrite or equivalent (IIRF or ISAPI_rewrite for IIS servers)

ftp

Set /gtranslate/cache and /gtranslate/cache/XX folders permissions to 777. DON'T change other files/folders permissions.

permission

Add this lines AFTER (next to) RewriteEngine On line in the .htaccess file. Make sure the file name is .htaccess not htaccess or htaccess.txt. If you don't have .htaccess create one manually or rename htaccess.txt to .htaccess.

# gtranslate config RewriteRule ^([a-z]{2}|zh-CN|zh-TW)/([a-z]{2}|zh-CN|zh-TW)/(.*)$ /$1/$3 [R=301,L] RewriteRule ^([a-z]{2}|zh-CN|zh-TW)/([a-z]{2}|zh-CN|zh-TW)$ /$1/ [R=301,L] RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^([a-z]{2}|zh-CN|zh-TW)/(.*)$ /gtranslate/translate.php?lang=$1&url=$2 [L,QSA] RewriteRule ^([a-z]{2}|zh-CN|zh-TW)$ /gtranslate/translate.php?lang=$1 [L,QSA]

Open /gtranslate/config.php file to configure your site's main language and username/password need for editing translations, you will find instructions there.

Modify robots.txt or create it if you don’t have. Add this line on the end of the file (replace yourdomain.com with your domain name). You can have more than one sitemap.

Create robots.txt and upload it to the root directory.

Create sitemap.txt and upload it to the root directory.

Download and install GTranslate Free for your CMS/HTML website and use Redirect translation method with 'Operate with GTranslate Pro' option On. This will enable the language selector.

Create robots.txt File

Modify robots.txt or create it if you don’t have. Add this line on the end of the file (replace yourdomain.com with your domain name). You can have more than one sitemap.

Sitemap: http://yourdomain.com/sitemap.txt

Create Sitemap

Create sitemap.txt in the root directory with the following contents (replace yourdomain.com with your domain name). You can remove the languages you don't want to be indexed to save translation traffic. You can provide here more deep sitemap, one link per line. If you already have sitemap.txt you can append it.

http://yourdomain.com/en/ http://yourdomain.com/af/ http://yourdomain.com/sq/ http://yourdomain.com/ar/ http://yourdomain.com/hy/ http://yourdomain.com/az/ http://yourdomain.com/eu/ http://yourdomain.com/be/ http://yourdomain.com/bg/ http://yourdomain.com/ca/ http://yourdomain.com/zh-CN/ http://yourdomain.com/zh-TW/ http://yourdomain.com/hr/ http://yourdomain.com/cs/ http://yourdomain.com/da/ http://yourdomain.com/nl/ http://yourdomain.com/et/ http://yourdomain.com/tl/ http://yourdomain.com/fi/ http://yourdomain.com/fr/ http://yourdomain.com/gl/ http://yourdomain.com/ka/ http://yourdomain.com/de/ http://yourdomain.com/el/ http://yourdomain.com/ht/ http://yourdomain.com/iw/ http://yourdomain.com/hi/ http://yourdomain.com/hu/ http://yourdomain.com/is/ http://yourdomain.com/id/ http://yourdomain.com/ga/ http://yourdomain.com/it/ http://yourdomain.com/ja/ http://yourdomain.com/ko/ http://yourdomain.com/lv/ http://yourdomain.com/lt/ http://yourdomain.com/mk/ http://yourdomain.com/ms/ http://yourdomain.com/mt/ http://yourdomain.com/no/ http://yourdomain.com/fa/ http://yourdomain.com/pl/ http://yourdomain.com/pt/ http://yourdomain.com/ro/ http://yourdomain.com/ru/ http://yourdomain.com/sr/ http://yourdomain.com/sk/ http://yourdomain.com/sl/ http://yourdomain.com/es/ http://yourdomain.com/sw/ http://yourdomain.com/sv/ http://yourdomain.com/th/ http://yourdomain.com/tr/ http://yourdomain.com/uk/ http://yourdomain.com/ur/ http://yourdomain.com/vi/ http://yourdomain.com/cy/ http://yourdomain.com/yi/

Editing Translations

In order to edit the translations you need to go to the language you want to edit and then add ?language_edit=1 to the URL. If you already have ? in the URL you need to add &language_edit=1 to the URL.

If you are using Joomla plugin version you will need to login to the frontend first with your Joomla administrator username and password.The login link should be http://yourdomain.com/index.php?option=com_users&view=login

You will then see the editing tools:

alt

To edit the translations you need to click the edit button (a small pencil).

The edit translation window will appear:

alt

Make and save your corrections.

alt

Uninstalling GTranslate Pro

For GTranslate Pro Joomla plugin version

1. Login to Joomla backend.

2. Click Extension > Extension Manager (or Install/Uninstall for Joomla 1.5.x) in the top menu.

3. Click Manage (or Plugins for Joomla 1.5.x) then Select System-Gtranslate and click the Uninstall button at the top right menu.

4. Open robots.txt file and remove the following line

Sitemap: http://yourdomain.com/sitemap.txt

5. Delete sitemap.txt file from the root directory.

For Gtranslate Pro General version

(WordPress, Drupal, Magento and all Joomla versions in the subdirectory)

1. Login to server with FTP or Cpanel.

2. In the root directory find gtranslate folder and delete it.

3. Open .htaccess file and remove # gtranslate config lines.

4. Open robots.txt file and remove the following line

Sitemap: http://yourdomain.com/sitemap.txt

5. Delete sitemap.txt file from the root directory.

FAQ

What are the server requirements?

  • PHP ionCube Loader - if you don't have it ask your hosting provider to enable it for you
  • PHP Curl library - default for the most hosts
  • PHP JSON library - default for PHP 5 >= 5.2.0
  • PHP SOAP client if you are going to use Bing Translator - default for the most hosts
  • Apache mod_rewrite or equivalent (IIRF or ISAPI_rewrite for IIS servers)

If your server doesn't meet this requirements, please consider using our Enterprise service.

 

Can I use it on other servers instead of Apache?

Yes! If you have Apache mod_rewrite alternative on your server it will work. We have clients using it on IIS, lighttpd and nginx.
 

Can I use it without ionCube Loader library on my server?

No, it is not possible. If your server doesn't meet this requirements, please consider using our Enterprise service.
 

How can I be sure that search engines will index my website?

You can check that this website is indexed in Google by searching for site:gtranslate.net.
 

Can I test before making a payment?

You can test the free version.
 

Will it work with JoomFish, sh404sef or other SEF extensions?

Yes, there are no known extensions which have conflicts with Pro version.
 

Can I exclude some parts from being translated?

Yes, you need to wrap the text you don't want to be translated with <span class="notranslate"></span>. You can add class="nturl" to the "a" tag if you don't want the destination URL to contain the language code.
 

How I can edit the translations or order professional human translations?

You need to go to the language you want to edit, for instance, French: http://domain.com/fr/ and add ?language_edit=1 to the end of the URL: http://domain.com/fr/?language_edit=1 and you will see the Edit and Add to Cart buttons near each text.
 

Is GTranslate Pro for one domain name only?

Yes, for an additional domain you need to make a new purchase.
 

Can I change the license I have moved to a new domain name?

Yes, you need to permanently redirect your old domain name to the new one and let us know.
 

Can I upgrade my Pro to Enterprise?

Yes, it is possible! Please contact us for more details.
 

What about updates?

We'll send updates by email with no charge during the first year.
 

Do I need to uninstall the Free version?

No, GTranslate Pro is addition to the Free version.
 
 
2GLux