Installation Guide

Here are the instructions for a trouble-free installation of JTrans Pro.

A. BEFORE DOWNLOADING NEW VERSION

1. If you had an earlier version, uninstall it.
2. If your previous installation was a pre 1.0.+ version, please open a support ticket for us to reissue it.
3. Then download the new version available in your client area.
   
4. Make sure you have the free ioncube loaders on your site. Our commercial components are compiled with ioncube and you need to have the loaders to run them. MOST web hosts have it installed by default and you need to go through this step only of your server does not have ioncube. Installation instructions for that are here. Run time loading is very simple. Other reputed Joomla! extension developers like iJoomla also use ioncube for their popular products.
   

1. Enable SEF URLs on your site, from the 'global configurations'. While the current versions of JTrans Pro can work even without SEF URs, we strongly recommend using SEF URLs to reduce URL related errors.
   
2. Using FTP or from the File Manager of your hosting cPanel, edit the .htaccess file to add the following code, just under the line RewriteBase /
   RewriteRule ^([^/]{2}_[^/]{2})/(.*)$ /components/com_jtranspro/index2.php?option=com_jtranspro&no_html=1 [L]
   If RewriteBase / had a "#" before it, delete it. The code in bold above is in a single line, please do not break the string
3. Now, it should look like this:
   RewriteBase /
   RewriteRule ^([^/]{2}_[^/]{2})/(.*)$ /components/com_jtranspro/index2.php?option=com_jtranspro&no_html=1 [L]
4. However, if your Joomla installation is in a subfolder of the domain, you will need to modify the code like this (change 'subfoldername' to your actual subfolder name):
   RewriteBase /subfoldername
   RewriteRule ^([^/]{2}_[^/]{2})/(.*)$ /subfoldername/ components/com_jtranspro/index2.php?option=com_jtranspro&no_html=1 [L]
   This particular change is NOT necessary if Joomla! is in a subdomain.
5. Remember, if you have not done this step properly, you will get "404 not found" error on clicking any flag for translation.
   

A sample htaccess file content is included in the next page. Please include the entire content in the .htaccess. Backup your current htaccess file too.

1. Go to Top Menu > Installers > Components and install like any other component. Bingo! With that one click, you install the component and the module! In addition, the module is automatically published in the 'left' module position.

1. Browse to JTrans Pro Configuration: Administration Top Menu >> Components >> .JTrans Pro >> Configuration.
2. [If you cannot see this page, it is likely that your server does not have ioncube. Please refer to A-4 above]
   
3. Insert the License Code (an alphanumerical string like JoomlaTrans-Full-534e4a7da09e, available in your Store client area) and save the component config. If after saving, you get a "license invalid" error, just click on the "Save" button again. If you still encounter any problems, please write to us through the Contact form above.
4. Configure the "Cache time", "URL exclusion" and "URL-string exclusion" in the component configuration. Specific details are posted there in the component configuration itself, and are self-explanatory.

1. Browse to JTrans Pro module Administration Top Menu >> Modules >> Site Modules >> JTrans Pro. Click on it and then you are presented with the parameters with instructions and documentation too.
2. Select the primary language of your site. This is important. For most sites, it is English. If your site is in, for example, Dutch, please select 'Dutch' there.
3. Choose which translation options to make available on the frontend of your site.
4. There are other configurations that you may play around with.

Please contact us if you have any questions or need help at any step. We will be glad to help you. You can also use the forum.

If you haven't yet, you can purchase it at the Joomlaspan Store.