USER MANUAL TABLE OF CONTENTS Introduction... 2 Benefits of Language Translator... 2 Pre requisite... 2 Installation... 3 Installation Steps... 3 Extension Activation... 8 Configuration... 9 FAQ... 24 General FAQs... 24 Language Translator Version: 1.0.4 Technical FAQs... 25 Points To Note... 27 Contact Us... 28 Compatibility: Community Edition: 2.1.*
Introduction Language Translator translates important content of Magento 2 ecommerce store to any language supported by Google APIs. Just integrate Google API with Language Translator and one can proceed. One can easily install and configure this extension in e-commerce store. With the use of this extension one can translate the product attributes and Meta details of a specific page from one language to another through CRON processes. It will boost your sales as it will reach wider range of people using their regional language. It helps to manage multi-lingual stores more efficiently. It is a must extension for store owner who runs an e-store supporting multiple languages. Benefits of Language Translator Helps manage stores having multiple audiences to target Helps customers understand your products better as it will be in their regional language 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 Pre requisite Admin needs to add Google API Key to run this extension. www.appjetty.com 2
Installation Installation Steps Manual Installation (Installing Magento 2 extension by copying code) Step 1: For Windows OS: Go to <your Magento install dir>/app/code. Under that, create the folders using following hierarchy: For Linux OS: Biztech Language Translator Enter the following commands keeping their order: cd <your Magento install dir>/app/code mkdir -p Biztech/ Translator After this, find the Download Zip and extract all files and folders in Biztech/Translator. Step 2: After the successful installation you have to run the command on Magento2 root directory- php bin/magento setup:upgrade. If you see blank page or permission error, go to Terminal (Linux)/ Command Prompt (Windows). cd [magento root directory][var] run the following command $ chmod R 777 * www.appjetty.com 3
Step 3: After running the command, log into the admin panel and clear the Cache. Go to SYSTEM -> Tools (section) -> CACHE MANAGEMENT to clear the cache. www.appjetty.com 4
Step 4: After successful installation, you can see the Language Translator under BIZTECH tab inside STORES -> CONFIGURATION. www.appjetty.com 5
Installation via Composer Step 1: Install composer from this link. If you already installed composer, skip this step. Step 2: Go to app -> code -> Biztech -> Language Translator, right click on composer.json and select use composer here. Step 3: After that you can see command prompt where you have to run the following command: composer update www.appjetty.com 6
Step 4: Now go to [magento root directory] and right click on use Composer here. Step 5: You can see the cmd window and run the following command here: Step 6: php bin/magento setup:upgrade After running the command, log into the admin panel and clear the Cache. Go to SYSTEM ->Tools (section) -> CACHE MANAGEMENT to clear the cache. Step 7: After successful installation, you can see the Language Translator under BIZTECH tab inside STORES -> CONFIGURATION. The installation is successful! Scroll down to activate the extension. www.appjetty.com 7
Extension Activation Copy an activation key Copy the activation key from the Order Confirmation Mail. OR Log into your account at www.appjetty.com using the email and password you have provided at checkout process. Go to Downloadable Options and copy the activation key for the Language Translator extension. Activate the extension Log into Magento Admin Panel and go to Stores -> Configuration -> Biztech -> Language Translator and enter the activation key in the ''Activation Key'' field for the Language Translator extension then click the Save Config button. Select Websites When you enter and save the key it will be verified and you can select the websites where you need to use the Language Translator extension. Click on Save Config button after making your selections. Now, Language Translator Extension got activated! You just have to set configurations. www.appjetty.com 8
Configuration Please follow below mentioned steps to configure the Language Translator extension. Go to Stores -> Configuration. General Configuration In the left column under Biztech tab click on Language Translator, you can see its configuration sections. Enabled: Select Yes to enable the Language Translator extension. The extension is disabled by default. 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. 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 specified then it will be translated 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 (Note: If you specified Auto Detected then language will be detect automatically). Translate Button Label: Enter the text to be displayed on Translate button. www.appjetty.com 9
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 10
www.appjetty.com 11
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 12
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. You can also translate the all fields by clicking on single button from the Top right corner. Click on Product Details to translate details of product like Name & Description. www.appjetty.com 13
Click on Search Engine Optimization to translate Meta Title and Meta Description of product. www.appjetty.com 14
Translate CMS page details from one language to another Go to Content -> 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. www.appjetty.com 15
Go to Content -> Blocks and click on Select -> Edit to translate blocks of that page to any other language. Admin can change Block Content based on Store view. www.appjetty.com 16
Translate Store Reviews to Any Language Go to Marketing -> User Content -> Reviews and click on any review to translate it to any other language. www.appjetty.com 17
Search Strings and translate them to any Language Go to Biztech Translator -> Search and enter any string you want to translate in the search box. www.appjetty.com 18
Click on Edit icon of the string you want to Translate and translate into any of the Language that you want. www.appjetty.com 19
Translate Category in a Mass to any of the language Go to Biztech Translator -> Category and select categories that you want to translate. Select the translate language and that category will be translated in all store views. www.appjetty.com 20
Mass Translation of Products, CMS Page Data, Static Blocks and Product Reviews 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 Products (For Mass Translation). By clicking on Translate Selected Products a list of language will appear, select the language in which you want the selected attributes translated. www.appjetty.com 21
Now after selecting the language you will be notified with a message about the CRON Process by which the mass translation will be carried out on the same page. 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 22
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 23
FAQ General FAQs 1. What Magento versions is Language Translator compatible with? Ans: The current Language Translator extension is compatible with: Community Edition: 2.1.*. 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/translate/v2/pricing 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/magento2-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 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. www.appjetty.com 24
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. iii. 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 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. I am not able to use this extension. Ans: Please make sure that My crypt PHP extension is installed on your server. Please review @ https://docs.google.com/file/d/0bz8gi5_ttsiwx2xtmjutmmpcaeu/edit 12. 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. 13. 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. www.appjetty.com 25
14. "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. 15. 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=aizasycqsnecevsjypk9g7hcqkpbbogskekf9k&q=hello%20world&source=en&target=de 16. 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" 17. 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". www.appjetty.com 26
18. Is there a way to translate categories? Ans: Yes. You can translate categories individually as well as by mass update. 1. Mass Update 2. Individually 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". 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" 19. 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. 20. 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 is must be defined to translate the data. When extension is enabled by default for review and CMS block translate button will be added. Mass Translation will be carried through CRON only for Community Edition: 2.1.* www.appjetty.com 27
Contact Us We simplify your business, offer unique business solution in digital web and IT landscapes. Live Chat Get instant support with our Live Chat. Visit our product page at: https://www.appjetty.com/magento2- language-translator.htm and click on the Live Chat button for instant support. Tickets Raise tickets for your specific question! Send an email to support@appjetty.com or you can login to my account www.appjetty.com 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 www.appjetty.com 28