|
Here are the instructions for a trouble-free installation of JTrans Pro.
A. BEFORE DOWNLOADING NEW VERSION
- If you had an earlier version, uninstall it.
- If your previous installation was a pre 1.0.+ version, please open a support ticket for us to reissue it.
- Then download the new version available in your client area.
- 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.
B. BEFORE INSTALLATION
- 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.
- 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 
- Now, it should look like this:
RewriteBase /
RewriteRule ^([^/]{2}_[^/]{2})/(.*)$ /components/com_jtranspro/index2.php?option=com_jtranspro&no_html=1 [L]
- 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.
- 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.
C. INSTALLATION
- 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.
D. COMPONENT CONFIGURATION
- Browse to JTrans Pro Configuration: Administration Top Menu >> Components >> .JTrans Pro >> Configuration.
- [If you cannot see this page, it is likely that your server does not have ioncube. Please refer to A-4 above]
- 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.
- 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.
E. MODULE CONFIGURATION
- 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.
- 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.
- Choose which translation options to make available on the frontend of your site.
- 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
# @version $Id: htaccess.txt 4085 2006-06-21 16:03:54Z stingrey $
# @package Joomla
# @copyright Copyright (C) 2005 Open Source Matters. All rights reserved.
# @license 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 <script> tag in URL
RewriteCond %{QUERY_STRING} (\<|%3C).*script.*(\>|%3E) [NC,OR]
# Block out any script trying to set a PHP GLOBALS variable via URL
RewriteCond %{QUERY_STRING} GLOBALS(=|\[|\%[0-9A-Z]{0,2}) [OR]
# Block out any script trying to modify a _REQUEST variable via URL
RewriteCond %{QUERY_STRING} _REQUEST(=|\[|\%[0-9A-Z]{0,2})
# Send all blocked request to homepage with 403 Forbidden error!
RewriteRule ^(.*)$ index.php [F,L]
#
########## End - Rewrite rules to block out some common exploits
##
## 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 Joomlaspan Store.
Trackback(0)
|
Our Products 
TrackBack URI for this entry
Show/Hide comments
Show/Hide Comment Form