USER MANUAL TABLE OF CONTENTS€¦ · TABLE OF CONTENTS Introduction ... This can be done now using Language Translator extension. ... • After step5 you can run the compilation

USER MANUAL

LANGUAGE TRANSLATOR

Version: 1.1.0

Compatibility:

Community Edition: 1.5.x.x to 1.9.x.x

TABLE OF CONTENTS Introduction...................................................... 1

Benefits of Language Translator ..................... 1

Installation ........................................................ 2

Installation Steps .......................................... 2

Extension Activation .................................... 3

Configuration.................................................... 4

FAQ .............................................................. 17

General FAQs .............................................. 17

Technical FAQs ........................................... 18

Points to Note ................................................ 21

Contact Us ...................................................... 21

USER MANUAL – Language Translator

www.appjetty.com 1

Introduction

Are you looking for an extension which allows to translate your content into any regional language and

make your store global? To expand your business in multiple countries you need to exhibit your

products in multiple languages. This can be done now using Language Translator extension.

This extension is quite simple and easy to install and configure. Using this extension you can

automatically translate the product attributes and Meta details of a specific page from one language to

another through CRON processes. It will help you to manage your multi-lingual stores more efficiently. It

is powered by Google API Key, which makes is imperative to purchase API keys to use this extension. It is

a must have extension for store owners who run multi-lingual stores.

Benefits of Language Translator

• Helps to manage multilingual stores.

• Helps customers to better understand your products.

• Convert CMS page details like Page Title, Content Heading, Content and Meta Details in any

language.

• Translate reviews from one language to another.

• Search and translate any string of the store.

• Mass translation for multiple store fields will be carried through CRON.

• Set Daily Character Limit for the translation and Set Safe Limit to be kept during translation.

• Calculate number of characters for product based on the attributes selected.


www.appjetty.com 2

Installation

Installation Steps

Step 1: Check Permissions

• Make sure the ‘‘app’’ directories of your Magento and all directories inside it, have full written

permissions or set permissions on the each directory equal to 777 or 0777.

Important! Change all permissions back after installation.

Read more about permission at

http://www.magentocommerce.com/wiki/magento_filesystem_permissions

Step 2: Disable Compilation

• Log into Magento Admin Panel and go to System → Tools → Compilation and disable the

compilation.

• After step5 you can run the compilation process again.

Step 3: Upload Files

• Upload all folders from the extension package to the installation directory of your Magento

software using an FTP client.

Step 4: Clear cache

• Go to System → Cache Management.

• Clear the store cache.




www.appjetty.com 3

Step 5: Re-login

• Logout and log back into Magento Admin Panel.

Step 6: Use Extension

• Go to System → Configuration.

• In the left column you will see the new tab Biztech Extensions, now select Translator.

Extension Activation

Copy an activation key

• Copy the activation key from the Order Confirmation Mail. OR Login into your account at website

using the e-mail and password that you provided at checkout process.

• Go to Downloadable Options and copy the activation key for the Language Translator extension.

Activate an extension

• Log into Magento Admin Panel and go to System Configuration -> Biztech Extensions/ Language

Translator Extension and enter the activation key in the 'Activation Key' field for the Language

Translator extension then click the ‘Save Config’.

http://store.biztechconsultancy.com/

http://store.biztechconsultancy.com/


www.appjetty.com 4

Select Websites

• When you enter and save the key it will be verified on our server and you can select the websites

where you need to use the Language Translator extension. Click the 'Save Config' button after

making your selections.

• You are now ready to use the Language Translator extension.

• Now, Language Translator got activated! You just have to set configurations.

Configuration

• Please follow the below steps to enable the functionality of Language Translator.

• Go to System -> Configuration. In the left column you will see the tab Biztech Extensions

-> Translator.

▪ Enabled: Select ‘Yes’ to enable the Language Translator extension. The extension is disabled by default.

▪ Enter Google API key: It is used to translate the data(Note: Use this link to generate the Google API key (https://developers.google.com/translate/v2/getting_started)

▪ Enter Daily Quota: Enter daily limit specified in your Google Billing Amount.

▪ Enter Safe Limit: Enter a daily safe limit to avoid the errors while translating the content.

Note: It must be less than the value entered in ‘Enter Daily Quota’ field

https://developers.google.com/translate/v2/getting_started


www.appjetty.com 5

▪ Language you want to translate your website to: Translate the product data, category data, CMS page, CMS block, review fields and Meta data in defined language. If language has been not selected then it will be translates in current locale language.

Note: If you select 'Current locale' then by default it will use current locale language.

▪ Translate From: Translate from specific language. If you select ‘Auto Detect ’then it will

automatically detect the language.

▪ Translate Button Label: Enter the text to be displayed on Translate button.

• Admin can choose fields which are to be translated for Products, CMS Pages & Categories.

▪ Translate Fields: Translate specific fields for product module.

▪ CMS Page Translate Fields: Translate specific fields for CMS Page.

▪ Category Translate Fields: Translate specific fields for Category module.


www.appjetty.com 6

• Admin can manage the translations in various ways:

▪ Do you want to translate all products again? : Select ‘Yes’ to translate all the products again.

▪ Batch Size to translate: Enter the number of products to be translated at a particular time.

▪ Calculate Characters: To calculate and view the number of characters based on product configurations selected click on ‘Calculate Characters’ button.


www.appjetty.com 7

Translate Product Details from one language to another

• Go to Catalog -> Manage Products and click on any product to translate it to any other

language.

• Go to General to translate general information. Go to Meta Information to change Meta

Information of Product.

• You can translate all allowed data with global translate button besides save button.


www.appjetty.com 8

Translate CMS Page Details & CMS Block Details from one language to another

• Go to CMS -> Pages and click on any page to translate it to any other language.

• Admin can translate Page Information, Content and Meta Data of the CMS Page.

• If we change the store view then the translate button will change to translate to language for

that Store.


www.appjetty.com 9

• Go to CMS -> Static Block and click on any Block to translate it to any other language.

• Admin can change Block Title and Block Content based on Store view.


that store.


www.appjetty.com 10

Translate Store Reviews to Any Language

• Go to Catalog -> Reviews and Rating -> Customer Reviews -> All Reviews and click on any

review to translate it to any other language.


that store.


www.appjetty.com 11

Search Strings and translate them to any Language

• Go to Biztech Translator -> Manage Translation -> Search String and Translate and enter any

string you want to translate in the search box.

• Click on any string you want to Translate and translate them into any of the Locale language by

selecting from list of predefined locale from admin configuration.


www.appjetty.com 12

Translate Category in a Mass to any of the language

• Go to Biztech Translator -> Manage Translation -> Mass Category Translate and select

categories that you want to translate.

• Select the translate language and the store in which you want translated category.


www.appjetty.com 13

Mass Translation of Products, CMS Page Data, Static Blocks, Product Reviews and Tags

• Go to any of the category page that you want to translate and select multiple items by checking

the checkbox.

• Click on ‘Actions’ dropdown list and select ‘Translate Selected CMS Pages’ (For Mass

Translation).


www.appjetty.com 14

• Select any language in which you want translation by clicking on the ‘Translate To’ button.


www.appjetty.com 15

• Now click on ‘Submit’ button to translate all the selected attributes together. By clicking on

‘Submit’ button you will be notified with a message about the CRON Process by which the mass

translation will be carried out.

Note: The mass translation of the product will be carried out through a CRON and only one CRON can

be registered at a time.


www.appjetty.com 16

Mass Translation Status

• To view the status of the mass translations carried out by CRONs go to Biztech Translator ->

Manage CRON Translations.

• Now you can view a list of CRONs in which the mass translation were carried out along with

CRON statuses and other details.


www.appjetty.com 17

FAQ

General FAQs

1. What Magento versions is Language Translator compatible with?

Ans: The current Language Translator extension is compatible with: Community Edition: 1.5.x.x to 1.9.x.x

2. Is Google API free of charge?

Ans: No, Google Translate API is not free, it does charge as per below URL: https://cloud.google.com/pricing/list 3. I want to enable extension in more than one domain. How can I do so?

Ans: Basically we provide license key for two domains: one live and one for development/testing URL. If you are to use the extension on extra domains then kindly purchase license key for the same. You can review the license key information on our entire product page under section: "I have one Magento Installation with" Please review @ https://www.appjetty.com/magento-language-translator.htm 4. Do you provide demo?

Ans: Yes, demo is worth a thousand words. You can view the demo details and video through the ‘Demo’ button above. 5. Do you provide installation service?

Ans: Yes, we do provide the installation service. You can tick the installation service checkbox while purchasing or can transfer $25 to our PayPal account [email protected] later on. 6. Can I edit the extension?

Ans: All our extensions are 100% open source. You can customize the extension except the file containing our license code. 7. What if I get an error message after the installation of extension or 404 Error Page not found,

after installing extension?

Ans: No need to worry. Just clean the cache, log out of your Magento admin panel and login in again.

8. Can you customize the extension and app as our store needs? Ans: Yes, we do customize the extension and app as per your need. This requires extra effort and estimation.

https://cloud.google.com/pricing/list

https://www.appjetty.com/magento-language-translator.htm

mailto:[email protected]


www.appjetty.com 18

9. Do you have a refund policy?

Ans: Yes, you can refer our refund policy @ https://www.appjetty.com/refund-policy.htm we stand behind the quality of our extensions with a 15 day money back guarantee.

Technical FAQs

10. How can I set up Google API Key for translator? Ans: Please follow below steps to obtain Language Translator Google API Key:

i. Open this URL and the follow the instructions https://cloud.google.com/translate/v2/getting_started

ii. Also if you have not made payment yet, please configure billing address and make payment

as well at https://console.developers.google.com/project/dulcet-outlook 747/settings?authuser=1

iii. Once you are done with payment you will need to generate API Key again.

Note: You do not need to enter anything in setting referral allowed while going through API Key steps in your Google account. Keep that empty. Without making payment and setting up billing information API key will not work.

You will need to take care of below things while you generate API Key from Google.

i. You have not make payment then please configure billing address and make payment as well.

ii. You do not need to enter anything in setting referral allowed while going through API Key steps in your Google account. Keep that empty.

iii. Without making payment and setting up billing information, API key will not work.

11. Will this extension translate all of the different types of attribute? i.e. Drop down, text box etc. Ans: Currently it supports translation of text fields and text area fields only.

12. Extension Shows Error Message Popup while in use. What should I do? Ans: Please try obtaining correct key from Google API and then try to check. It should work fine.

https://www.appjetty.com/refund-policy.htm

https://cloud.google.com/translate/v2/getting_started

https://console.developers.google.com/project/dulcet-outlook%20747/settings?authuser=1%20


www.appjetty.com 19

13. "Access Not Configured. The API is not enabled for your project, or there is a per-IP or per-Referrer restriction configured on your API key and the request does not match these restrictions. Please use the Google Developers Console to update your configuration." What is the solution for this error?

Ans: It seems that you have not configured API details properly in your google account. Once it will be done, API will work for the extension. You will need to set up billing details for this API to have this enabled. 14. Error: Daily Limit Exceeded. How to get rid of this error? Ans: It seems billing process is pending for your google API, so it is returning this type of error. You can check your API key @ https://www.googleapis.com/language/translate/v2?key=API KEY HERE &q=hello%20world&source=en&target=de Note: You have to add your API key and go to the URL to check your daily limit. 15. How to translate CMS pages and static blocks? Ans: The CMS page and static blocks can be translated in two ways: mass update and individually.

1. Mass Update

i. Select the CMS pages to be translated to a particular language from the grid.

ii. Choose "Translate selected CMS page" from actions drop down. A ‘Translate To’ drop down will appear to choose the language.

iii. Select the desired language for translation and click on ‘Submit’.

2. Individually

i. Open any of the CMS page in edit view. The fields will have ‘Translate’ button beneath them.

ii. The language for translation can be changed by changing the store view.

NOTE: The steps described above will only translate the fields selected in the configuration for "CMS page Translate Fields"


www.appjetty.com 20

16. How to use mass update feature for products? Ans: It's a matter of few clicks! Go to Catalog -> Manage Products. You can mass translate the products for all stores or select a specific store view and then proceed. Select the products to be translated and choose "Translate Selected Products" from the actions drop down. Thereafter, choose the desired language for translation and click on ‘Submit’. NOTE: The steps described above will only translate the fields selected in the configuration for "Product Translate Fields". 17. Is there a way to translate categories?

Ans: Yes. You can translate categories individually as well as by mass update.

1. Mass Update i. Go to Biztech Translator -> Manage Translations -> Mass Category Translate.

ii. Select the categories to be translated, choose the language and click on "Bulk

Category Translate".

2. Individually

i. Go to Catalog -> Manage Categories and select the category to be translated.

ii. The fields will have ‘Translate’ button beneath them. The language for translation can be changed by switching the store views.

NOTE: The steps described above will only translate the fields selected in the configuration for "Category Translate Fields" 18. Is it possible to translate any random word from our store?

Ans: Yes, you can translate the strings supported by your store locale settings. Navigate to Biztech Translator -> Manage Translations -> Search String & Translate. You can enter the string, select the options and it will show the search results. You can pick the one to be translated, open in edit view and translate. 19. I am not able to see extension at my product grid. Ans: If you are using any customized grid or third party extension for the same, then this will require further customization and effort estimation. Please contact our sales team at [email protected]



www.appjetty.com 21

Points to Note

• Google API key must be defined to translate the data.

• When extension is enabled by default for review and CMS block translate button will be added.

Contact Us

We simplify your business, offer unique business solution in digital web and IT landscapes.

•

Customization: If you would like to customize or discuss about additional feature for Language Translator, please

write to [email protected]

Tickets

• Raise tickets for your specific question! • Send an email to [email protected]

or you can login to your account @ www.appjetty.com and click on My Sup-port Tickets on your account dashboard, to get answers to your specific questions.

Live Chat

• Get instant support with our Live Chat.

• Visit our product page at: https://www.appjetty.com/magento-language-translator.htm and click on the Live Chat button for instant support.



https://www.appjetty.com/



Documents

USER MANUAL TABLE OF CONTENTS€¦ · TABLE OF CONTENTS Introduction ... This can be done now using Language Translator extension. ... • After step5 you can run the compilation