USER MANUAL LANGUAGE TRANSLATOR TABLE OF CONTENTS. Version: 1.1.6

Transcription

1 USER MANUAL TABLE OF CONTENTS Introduction... 1 Benefits of Language Translator... 1 Installation... 2 Installation Steps... 2 Extension Activation... 3 Configuration... 4 FAQ General FAQs Technical FAQs Points to Note LANGUAGE TRANSLATOR Contact Us Version: Compatibility: Community Edition: 1.5.x.x to 1.9.x.x

2 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 1

3 Installation Installation Steps Step 1: Check Permissions Make sure the app directories of your Magento and all directories inside it, have full written permissionsorsetpermissionsontheeachdirectoryequalto777or0777. Important! Change all permissions back after installation. Read more about permission at 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. 2

4 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 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. 3

5 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 ( 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 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. 4

6 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. 5

7 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. 6

8 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. 7

9 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. 8

10 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. If we change the store view then the translate button will change to translate to language for that store. 9

11 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. If we change the store view then the translate button will change to translate to language for that store. 10

12 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. 11

13 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. 12

14 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). Select any language in which you want translation by clicking on the Translate To button. 13

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. 14

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. 15

17 FAQ General FAQs 1. What Magento versions is Language Translator compatible with? Ans: The current Language Translator extension is compatible with: Community Edition: 2.0.x. 2. Is Google API free of charge? Ans: No, Google Translate API is not free, it does charge as per below URL: 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 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 payments@biztechconsultancy.com 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. 16

18 9. Do you have a refund policy? Ans: Yes, you can refer our refund 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 ii. iii. Also if you have not made payment yet, please configure billing address and make payment as well at 747/settings?authuser=1 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. 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. 17

19 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 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 2. Individually 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. 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" 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". 18

20 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. 2. Individually ii. Select the categories to be translated, choose the language and click on "Bulk Category Translate". 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 sales@appjetty.com 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. 19

21 Contact Us We simplify your business, offer unique business solution in digital web and IT landscapes. Live Chat Tickets Get instant support with our Live Chat. Raise tickets for your specific question! Visit our product page at: and click on the Live Chat button for instant support. Send an to or you can login to your and click on My Support Tickets on your account dashboard, to get answers to your specific questions. Customization: If you would like to customize or discuss about additional feature for Language Translator, please write to sales@appjetty.com 20