AutoSiteTranslator User Manual

Version 1.0

 

1. INTRODUCTION

AutoSiteTranslator is a fully automated solution to translate your websites up to 9 different languages.

1.1 How does AutoSiteTranslator Work?
AutoSiteTranslator instantly translates your websites up to 9 different languages you have configured. It connects to your sites through FTP, gets the list of files in the source folder/sub-domain you have configured and creates directories like fr,de,ar, etc (Refer <Section 4.2>)for the languages you have selected. All the web-pages in your source directories can now be accessed from the language specific directories.

1.2 Language Translations Supported
 

German 

 

French 

 

 

Italian

 

Spanish

 

 

Portuguese

 

Korean

 

Japanese

 

Arabic

 

Chinese

 

 

1.3 Language Translations Supported


1. English to French, German, Italian, Japanese, Korean, Portugese, Spanish, Chinese(Simplified) and Arabic.
2. French to English and German.
3. German to English and French.
4. Arabic to English.
5. Italian to English.
6. Japanese to English.
7. Spanish to English.
8. Portugese to English.
9. Chinese(Simplified) to English
10. Korean to English.

1.4 AutoSiteTranslator Editions

There is right now only one edition of AutoSiteTranslator

  1. AutoSiteTranslator Business
    • There is no limit on the number of domains that can be translated!.
    • If you are an Internet Marketing expert looking to capture a major chunk of the Non-English speaking world, or a business owning thousands of domains, and looking to translate them all, this is the right one for you.

1.5 Any limitations on the software's capability to translate ?

AutoSiteTranslator will translate up to about 1800 words per page, which is far more than enough for 99% of content pages. If a page is longer than roughly 1800 words, the remaining words after the 1800 will not be translated.

[Back to Top]


 

2. INSTALLATION

2.1 What are the minimum server requirements ?

The minimum configuration required for AutoSiteTranslator is given below. Please note that although each of the mentioned softwares are required, the verions indicated by the side indicate a typical configuration in which AutoSiteTranslator performs optimally and is guaranteed to work.

Linux/Unix Server 2.4.21-27.0.2.EL
Apache 1.3.34 (Unix)
PHP version 4.3.10
MySQL version 4.1.21-standard
cPanel Build 10.9.0-STABLE 35

 

2.2 Can I use a different database other than MySQL ?

No. You have to use only a MySQL database. AutoSiteTranslator will not work with any other database.

2.3 How do I install Auto Site Translator ?

The Installation procedure for AutoSiteTranslator is really simple. Just follow the few steps below and you can start translating your sites.

1)Unzip the archive using standard zip software like WinZip. Upload the unzipped folder to the site where you want it installed.
2) Create a database by logging into your cPanel using the MySql databases section.
3) Run the Sql database file provided as part of the install using phpMyAdmin in the MySql databases section. You can find the Sql file inside the sql directory
4) Change the values in connect.php present inside the inc folder. You have to set the license value to the one given to you immediately after payment and also mailed to you to the email address provided. Set the MySql server name, username and password parameted also.
5) Change the permissions of tmp and projects dirs to 777. This can be done using your FTP software. To learn more about this, click here.

That's the end of it. You can now call the script using the url, depending upon where you have installed it.

 

[Back to Top]



 

3. MAIN SCREEN FUNCTIONALITIES

3.1 Introduction

The main screen is where you have access to all the functionalities of AutoSiteTranslator.

3.2 How do I login to the software?
The first time you call index.php from your browser, you are prompted to enter your username and password. The default username is admin and the default password is also admin, although you can change this, as explained in the section <>.

Once you are logged on, you can access all the features of your edition, translate your websites.
Your login would be valid until the HTTP session expires after sometime. The HTTP session would only expire if there is no activity.

Please note that AutoSiteTranslator requests for license everytime before you login. It will show a license error if you are not using a valid license. If you are and it shows an error, kindly log a support ticket at autositetranslator.com and we will get back to you immediately.
 

3.3 How do I translate my website ?

To translate your website, just follow the following steps.

Create a project by using Project->New Project. Fill in the required fields as explained in the next section and Click on Create Project.

Your project gets displayed just below the sample project, if that is the only project that exists or at the end, if many projects exist.

Click on the Execute link by the side of a project to start translating your websites.
 

3.4 What is a project ?

A project is a means to group together your sites that you want translated to other languages.
You need FTP access to your site, i.e the server name (eg: tkres.com) , username, password.
You set the common settings for all the sites like the languages to be translated to, and the default source and destination language folders, if any, if the source folder should be treated as a domain and translated, whether or not to create sub-domains for the languages and the notification email to be sent on completion of translating a particular website.

3.5 How do I edit an existing project ?

Editing a project is simple, just click on the Edit link to the right side of the project you want to edit and the software shows you a page similar to the new project creation page. Just edit the fields you want changes and click on Update Project to save the changes for the project.

You may typically need to edit a project to add more sites, in which case, after you have updated the project, the Complete/Total field in the main screen should show an increase in Total whilst the completed field remains the same.

Also, you might want to add or remove certain language translations for which case, you would need to edit a project.

3.6 How do I delete a project ?

To delete a project, click on the delete link by the side of the project name, ie under the Options column. Say yes, when asked for a confirmation if you are sure that you want to delete that project.

3.7 What is exporting of projects ?

You can make a copy of your projects by using the Export feature. All you have to do is, just click on the Export link in the Options to the right hand side of the project that you want exported. Then Right click and Save-As, give a filename and you can store it in your hard disk. Later on you can replicate the same project in AutoSiteTranslator by making use of the Import feature. The exported file, by default, has a .prj extension.

3.8 What is importing of projects ?

You can create a project by using the export file generated above.

3.9 What is the Completed/Total field I see on the Main Screen ?

'Completed' is the number of sites that have been translated.
'Total' is the total number of sites that you have configured the project for.


[Back to Top]

4. ADMIN SCREEN

4.1 How do I logout of the software ?

To logout of the software, click on Logout from the Admin menu.

4.2 How do I change the password ?

To change the password for the admin, click on Change Password from the Admin menu.


[Back to Top]

5. PROJECT SETTINGS

5.1 Introduction

This allows you to configure your project settings, like the sites you want to translate, the source language of your site, the languages that you want to translate to, the directories where the source files are present, the directories where you want the translated files to be present, the source sub-domain, whether you want to create separate sub-domains for each of the languages, etc.

5.2 Site Info Page

This is a very important setting for all your projects. This is the place where you specify the FTP access for your site(s), the source and destination directories on each of them.

You can specify any number of sites. You are not restricted by the software to translate the number of sites you have.

The sites need to be specified in the following format :

<FTP_SERVER>,<FTP_USERNAME>,<FTP_PASSWORD>,<SOURCE _DIR>,<DEST_DIR>

Eg:

tkres.com,tkresuser,tkrespass,,lang

In the above example, tkres.com is the FTP server name, tkresuser is the ftp username and tkrespass is the FTP password. These three fields are mandatory for any site. Please consult your site admins if you are not sure about these parameters.

The other two are optional parameters, namely, <SOURCE_SIR> and <DEST_DIR>.
If you do not specify either of them, the default directories, if specified, under the Options tab will be taken. If they too are not specified, the site root (public_html folder) would be taken.
<SOURCE_DIR> is the directory where your source files are present. It is specified relative to the site root, which is the public_html directory. These are the files that will be translated by the software.
<DEST_DIR> is the directory where your translated files would be stored and accessed. It is also specified relative to the site root, which is the public_html directory. The software would, by default, setup separate directories using .htaccess (although these directories will not physically exist), relative to the destination language folder, for each of the languages that you select, like the following:

English - en
French - fr
Spanish - es
German - de
Italian - it
Portugese - po
Arabic - ar
Japanese - ja
Korean - ko
Chinese - cn

5.3 Translation Page

Here you give details as to the source language of your website and the target languages you want to translate to.

Eg:- If your site is in English, you select the Source languages to English and in the Translate To field, check all languages that you want to translate to.

Refer Section 1.3 for the translations that are possible. If an un-supported language conversion is selected, it will be ignored.

5.4 Options Page

Here you specify the various translation options.

Notification Email - A mail is sent to the email address provided here if the translation succeeded.

File Extensions - The page extensions that you want to translate. Basically, the translator translates all kinds of extenions and as it is this field has no effect. This will be deprecated in the coming versions. You can leave it to be default or add some of your extensions just for documentation.

Default Source Folder : This is the default folder that is taken for translation for source file if you haven't specified a source folder per site in the Account Page Site Info Field. It is always specifed relative to the site root which is the public_html directory.
If you leave this blank and specified a per site source folder, then that will be eventually taken as the source folder
If you leave this blank and not specified a per site source folder, then by default, the public_html folder would be taken.
If you specify a folder here, and leave the per site blank, then this directory will be used to get the source files for translation.
If you specify a folder here, and also provide a per site source folder, then the per site folder would take precedence over this.

Default language Folder :

This is the default folder where your translated files can be accessed and cached. if you haven't specified a language folder per site in the Account Page Site Info Field. It is always specifed relative to the site root which is the public_html directory.
If you leave this blank and specified a per site language folder, then that will be eventually taken as the language folder
If you leave this blank and not specified a per site source folder, then by default, the public_html folder would be taken.
If you specify a folder here, and leave the per site blank, then this directory will be used.
If you specify a folder here, and also provide a per site language folder, then the per site folder would take precedence over this.

Source folder is a sub-domain :

When this option is selected, then the source directory given is taken as a sub-domain and the translation is done. So, either the per-site source directory or the default source directory should be given. And also there should be a directory with the same name as the sub-domain relative to the site root (public_html directory).

Create Sub-domains :

When this option is selected, the software creates sub-domains on your server for each of the languages that you have selected for the translation and sets up the re-direction to point to the translated pages.

Eg: If you have selected French and Italian translations, then it will create sub-domains like
fr.abc.com and it.abc.com and they would point to the respective language folders where you can see the translated pages.

5.5 Affiliate Page

You can also become an affiliate for Auto Site Translator and earn affiliate money by setting your affiliate id in this page. You can signup for affiliate at http://www.autositetranslator.com/affiliate.html. AutoSiteTranslator uses PayDotCom affiliate. So, if you are already a member, then you can use your affiliate id directly.

Insert Affiliate ID : Just check this option to insert affiliate code on all the translated pages. Is a very small piece of code at the very bottom.
Affiliate ID : Your pay dot com affiliate id.


[Back to Top]

6. EXECUTING A PROJECT

On clicking the execute link on the options to the right of the project name, you are taken to this page. The following are the fields that you see and their explanations.

Current Site

The site that is currently being translated.

Total Sites

The total number of sites that are configured for this project in the sites info field. All sites should have valid FTP access.

Translation Snippet

You can place this piece of code on your main page to provide links to the translated pages.

Overall Progress

This is the overall progress of the project. Indicates the number of sites completed out of the total number of sites configured.

Next Site

Clicking on this will start the translation for the next site. Please wait until the page is done before clicking on this. This is especially true in the case of creation of subdomains for the languages.

How does progress work ?

Once a site is translated, the progress for the project is immediately updated and shows on the mainscreen against the name of the project.

7. EXAMPLES AND GUIDELINES

1.

 

 

Last Modified: 10/24/2006

[Back to Top]