JTrans Pro - Installation Guide

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

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 .
   
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 bottom of this 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 ) 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.

.htaccess configuration 

Please copy and paste the entire content from the top ## to the bottom ## into notepad and save on your desktop as htaccess.txt. After uploading to your site under the Joomla! base folder, where configuration.php is also located, rename it as ".htaccess", without quotes.

## Start of htaccess
# $Id: htaccess.txt 4085 2006-06-21 16:03:54Z stingrey $
# Joomla
# Copyright (C) 2005 Open Source Matters. All rights reserved.
# http://www.gnu.org/copyleft/gpl.html GNU/GPL
# Joomla! is Free Software
# This htaccess is from Joomlaspan.com
##

#####################################################
#  READ THIS COMPLETELY IF YOU CHOOSE TO USE THIS FILE
#
# The line just below this section: 'Options FollowSymLinks' may cause problems
# with some server configurations.  It is required for use of mod_rewrite, but may already
# be set by your server administrator in a way that dissallows changing it in
# your .htaccess file.  If using it causes your server to error out, comment it out (add # to
# beginning of line), reload your site in your browser and test your sef url's.  If they work,
# it has been set by your server administrator and you do not need it set here.
#
# Only use one of the two SEF sections that follow.  Lines that can be uncommented
# (and thus used) have only one #.  Lines with two #'s should not be uncommented
# In the section that you don't use, all lines should start with #
#
# For Standard SEF, use the standard SEF section.  You can comment out
# all of the RewriteCond lines and reduce your server's load if you
# don't have directories in your root named 'component' or 'content'
#
# If you are using a 3rd Party SEF or the Core SEF solution
# uncomment all of the lines in the '3rd Party or Core SEF' section
#
#####################################################

#####  SOLVING PROBLEMS WITH COMPONENT URL's that don't work #####
# SPECIAL NOTE FOR SMF USERS WHEN SMF IS INTEGRATED AND BRIDGED
# OR ANY SITUATION WHERE A COMPONENT's URL's AREN't WORKING
#
# In both the 'Standard SEF', and '3rd Party or Core SEF' sections the line:
# RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR] ##optional - see notes##
# May need to be uncommented.  If you are running your Joomla/Mambo from
# a subdirectory the name of the subdirectory will need to be inserted into this
# line.  For example, if your Joomla/Mambo is in a subdirectory called '/test/',
# change this:
# RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR] ##optional - see notes##
# to this:
# RewriteCond %{REQUEST_URI} ^(/test/component/option,com) [NC,OR] ##optional - see notes##
#
#####################################################


##  Can be commented out if causes errors, see notes above.
# Options FollowSymLinks

#
#  mod_rewrite in use

RewriteEngine On

### Use the next lines to make all domain.com traffic to be smoothly redirected to www.domain.com.
### This avoids duplication of pahes and likely to improve SERP. Change 'yoursite' to the name of your site
### Uncomment for use.
# RewriteCond %{HTTP_HOST} ^yoursite.com
# RewriteRule (.*) http://www.yoursite.com/$1 [R=301,L]

#  Uncomment following line if your webserver's URL
#  is not directly related to physical file paths.
#  Update Your Joomla (just / for root)

RewriteBase /

## This line is for the JTransPro functionality.
## If your Joomla! is in a subfolder, please follow instructions as in guide.

RewriteRule ^([^/]{2}_[^/]{2})/(.*)$ /components/com_jtranspro/index2.php?option=com_jtranspro&no_html=1 [L]

########## Begin - Joomla! core SEF Section
############# Use this section if using ONLY Joomla! core SEF
## ALL (RewriteCond) lines in this section are only required if you actually
## have directories named 'content' or 'component' on your server
## If you do not have directories with these names, comment them out.

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR]         ##optional - see notes##
RewriteCond %{REQUEST_URI} (/|\.htm|\.php|\.html|/[^.]*)$  [NC]
RewriteRule ^(content/|component/) index.php

########## End - Joomla! core SEF Section



########## Begin - 3rd Party SEF Section
############# Use this section if you are using a 3rd party (Non Joomla! core) SEF extension - e.g. OpenSEF, 404_SEF, 404SEFx, SEF Advance, etc

RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR]         ##optional - see notes##
RewriteCond %{REQUEST_URI} (/|\.htm|\.php|\.html|/[^.]*)$  [NC]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule (.*) index.php

########## End - 3rd Party SEF Section

########## Begin - Rewrite rules to block out some common exploits
#                             
# Block out any script trying to set a mosConfig value through the URL
RewriteCond %{QUERY_STRING} mosConfig_[a-zA-Z_]{1,21}(=|\%3D) [OR]
# Block out any script trying to base64_encode crap to send via URL
RewriteCond %{QUERY_STRING} base64_encode.*\(.*\) [OR]
# Block out any script that includes a

##

## End of htaccess 

Now, if you carefully notice, it is basically the default .htaccess of Joomla!, but with a few extra lines added. Please note just under the line "RewriteBase /" and you will notice the lines added for JTrans Pro. Please do not change it's location.

If your Joomla! installation is in a subdirectory, you will need to slightly modify these lines as described in the first page of the installation guide.

That's it. It looks very long, but when you start doing it, it's a breeze.

If you want us to do all this for you, please purchase the 'JTrans Pro Installation' support package from the client area and we will do it for you. Please contact us if you have any questions or need help at any step. We will be glad to help you.

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

Steven July 14, 2008	Thanks for the nice installation guide. I was able to install correctly.