English English

SEF Translate

For start use SEF Translate Free you need:

  1. 1. Install SEF Translate package(component and module).
  2. 2. Go to setting SEF Translate module.
  1. 3.1 Select language flags which to need for view on frontend.
  2. 3.2 Select language which to need view on frontend in drop-down menu. If you do not select a language, you will not see the drop down menu.

For start use SEF Translate Pro you need:

  1. 1. Install SEF Translate component.
  2. 2. Install SEF Translate module.
  3. 3. Go to setting SEF Translate module.
    1. 3.1 Please check option "Module position" Now in sefTranslate Pro version - you may set so position: "Default", "Top", "Right", "Left", "Bottom"
    2. 3.2 Set method translate for your site, when user click to flag or check language on select on your site.
      If select Jquery then when user select translate your site automatic translate without redirect.
      If select Redirect then when user select translate start redirect and open your page on select language.
      If select Instant you get fast and high quality Google translation using Ajax technology.
      If you use redirect method translate and cache page that when user is authentication's on Joomla him page not save on cache and method translate switch to Jquery. This functional for security users data.
    3. 3.3 Select language flags which you need for view on frontend.
    4. 3.4 Please check option "SefTranslate images" If you use Joomla Native multi language site, with that you may defined where from we will take flags images for these Native translated languages
    5. 3.5 Please check option "Flag Size" Flag size at module for languages
    6. 3.6 Please check option "Flag Type" - Now you may select flag image type from "shiny" or "flat"
    7. 3.7 Select language which to need view on frontend in drop-down menu. If you do not select a language, you will not see the drop down menu. "Module position" must be "Default"!
    8. 3.8 Please set option "Use SEF" That option need for correct define URL for translate when you use "Redirect". If you use on self site SEF for URLs - please set to YES, if not use - please set to NO
  4. 3.9 Please check option "Hide module sef" If you set it to YES - when user login on your site, Module for Sef translate - will hide for him (That need for safe translate quota)
  • 4. Go to setting SEF Translate component tab General.
    1. 4.1 On tab "General" field "Main site language" select language of your site.
    2. 4.2 Select translate algorithm, by default set 1. You need check what algorithm best for you.".
    3. 4.3 If you want not save to cache some pages, but continue them translate with aJax, please set they urls or url part on tab "General" field "Untranslatable Pages".
    4. 4.4 If you want not translate some page, please set it on tab "General" field "Untranslatable Pages".
    5. 4.5 There are option for set where to you will save cache - to files or to database. In case save cache - you will save inode quota for some hosting, also you will have possibility manual correct page what was translated. Base url use as main page for translate for this URL and this language - without check cookies and post values". Depending on the option what you selected where to save cache - you will see pages in "Page manager"(only commerce version) from files or from DataBase
    6. 4.6 You may select with what Translate API need for translate. For now we support Bing translate Api and Google Translate API. Bing selected as default - because Google last time ask money for use self translate API, but google support more languages". Bing support so languages
    7. 4.7 If you have problems with service google translate. You can help add API key on tab "General" field "Google API Translate"
    8. 4.8 For work with Azure Microsoft Translator API. Subscribe to the Azure.com on Azure Marketplace. Basic subscriptions, up to 2 million characters a month, are free. Translating more than 2 million characters per month requires a payment. You may pick from any of the available subscription offers.
    9. a. Sign up for a Microsoft Azure account (credit card required)
      If you don't already have an Azure account, sign up for a Microsoft Azure account at Azure Marketplace.
    10. b. After you have created an Azure account, subscribe to Azure. You will not be charged for Azure unless you use it. Then sign into the Azure portal.
    11. c. Add a Microsoft Translator API subscription to your Azure account.
      - Select the + New option.
      - Select Intelligence from the list of services.
      - Select Cognitive Services APIs.
      - Select the API Type option.
      - Select Text Translation. In the Pricing Tier section, select the pricing tier that fits your needs.
      - Fill out the rest of the form, and press the Create button
      You are now subscribed to Microsoft Translator!
    12. d. Retrieve your authentication key.
      - Go to All Resources and select the Microsoft Translator API you subscribed to.
      - Go to the Keys option and copy your subscription key to access the service.
    13. 4.9 On tab "General" field "Joomla native multi languages" You need set this option if your site support native translation from Joomla for some languages. Not use this option together with Joomla FaLang multi languages
    14. 4.10 On tab "General" field "Joomla Falang multi languages" You need set this option if your site support FaLang translation from Joomla for some languages. Not use this option together with Joomla native multi languages
    15. 4.11 On tab "General" field "Translate Iframes" You need set this option if no need iFrame translate or have some errors with iFrame translation
    16. 4.12 On tab "General" field "Translate Urls" You need set this option if you wish translate self url address. Any translated url - you may at next manual correct or translate in Url manager(only commerce version)
    17. 4.13 On tab "General" field "Use User IP" select use User IP argument. This argument supplies the IP address of the end-user on whose behalf the request is being made. That option you must set if have some problem with translate from Google. Google limited translation number without that parameter
    18. 4.14 On tab "General" option "Detect language". If on your site original text is multilangual, set this to "Yes"
    19. 4.15 On tab "General" option "Debug " need for error check. If some page after translate show blank page - please set that option to "Yes"
    20. Joomla multi languages
  • 5. Go to setting SEF Translate component tab Cache.
    1. 5.1 On tab "Cache" field "Caching" select use caching for you translate page. When use cache and some module or component show dynamic info it has bad work.
    2. 5.2 On tab "Cache" field "Cache time" insert count time after this cache it has been update.
    3. 5.3 For identification site pages when we create cache, we use POST+COOKIE+URL. If you have page which after reload have different value for some keys in POST or in COOKIE (for example use google analytics), please set these keys for remove from cache page name definationWarning! Only for experienced users. In ours site we remove from cache page define all COOKIES. Remark: We turn off Cache at time redirect mode when User has Login to site. Module work switch to AJAX mode - that do for site security
    4. 5.4 On tab "Cache" button "Clear Cache" give possibility clear cache.

    Important: To ensure correct work the site map is necessary that on the server was installed SOAP client (php extension), and included options that are in the configuration file (php.ini) those options which are responsible for supporting the soap. Also you need enable the CURL php extension.

  • 6. Go to setting SEF Translate component tab Map.
    1. 6.1 On tab "Map" field "Site Map Component" select component used to generate a site map.
      If you set "not use" or set not install component you have generated site map only main menu.
      If set component you have generated site map it this component and additional it will translate to all selected languages
    2. 6.2 On tab "Map" field "Languages sitemap" select languages to which need translate site maps.
    3. 6.3 On tab "Map" field "XML Sitemap URL" that link for XML site map for registration on Search Engines like Google or Yahoo.
    4. 6.4 On tab "Map" field "HTML Sitemap URL" that link for HTML site map for show to yours users.
    5. 6.5 On tab "Map" field "Use cache for Site Map" select use cache for Site map or not.
    6. 6.6 On tab "Map" in field "Clear cache Site map" if click on button "Clear.." you have clear cache site map. If at now is have not cache you see "Cache is clear".
    7. 6.7 If you have very much long site map and when created translate site map you have error. You can take advantage of step by step add one language on your cache site map on tab "Map" field "Add Language to Sitemap". Please click Add. On new page select language and click add language.
    8. 6.8 IMPORTANT!!! For see "map site" on different languages, you need add Bing or Google Translate API keys.
  • 7. For view site map you need add menu on this component(SEF Translate). Important: Please add this page to "Untranslatable Pages"
  • 8. For use redirect you need configure redirect with built-in functions joomla or an additional component such as sh404SEF. Next you must add in .htaccess file after RewriteEngine On and activate the option in the settings of joomla responsible for redirect.
      RewriteRule ^([a-z]{2})/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^([a-z]{2})$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
      RewriteRule ^(zh-CN)/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^(zh-CN)$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
      RewriteRule ^(zh-TW)/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^(zh-TW)$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
      RewriteRule ^(bs-Latn)/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^(bs-Latn)$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
      RewriteRule ^(ceb)/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^(ceb)$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
      RewriteRule ^(hmn)/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^(hmn)$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
      RewriteRule ^(mww)/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^(mww)$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
      RewriteRule ^(yua)/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^(yua)$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
    If you don't have .htaccess file in your website home directory, copy htaccess.txt and rename it to .htaccess

  • 8.1 If you use Joomla Native multi language site or FaLang, important if for redirect you will set exactly for every language what you set in sefTranslate. And not add redirect for Native languages or FaLang what you set in Joomla content. Below language configure for France, Russia and Chine
      RewriteRule ^(fr)/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^(fr)$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
      RewriteRule ^(ru)/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^(ru)$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
      RewriteRule ^(zh-CN)/(.*)$ components/com_seftranslate/translate.php?seflang=$1&sefurl=$2 [L,QSA]
      RewriteRule ^(zh-CN)$ components/com_seftranslate/translate.php?seflang=$1 [L,QSA]
  • 9. For view translated file (if you save translate to files) - for next manual edit. You need go to file:
    {yours site}/components/com_seftranslate/translate.php and rows:
    //$original_t .= "<!-- sef_translate:".$fileName." -->";
    //echo "<!-- sef_translate:".$fileName." -->";
    replace to:
    $original_t .= "<!-- sef_translate:".$fileName." -->";
    echo "<!-- sef_translate:".$fileName." -->";

    And you at end all yours translated pages will see row like:
    <!-- sef_translate:99107586c60db878c4f2430139b387dd.csh -->
    Where 99107586c60db878c4f2430139b387dd.csh - file with translate from folder:
    {yours site}/components/com_seftranslate/cache/
    Now you may correct translated file content with help "Page manager" - if switch option "save cache" - to "files" Important: Please remember - that file will rewrited - when cache time will expire, if you not set file as "manual transtated" or "base page(only commerce version)".
  • 10. Go to setting SEF Translate component tab URLs.(only commerce version)

    1. 10.1 Possibility edit manual translated text with MCE editor or without editor. For use MCE editor in editor options need set: "Functionality" -> "Extended", "Code Clean up on Startup"-> 'OFF', "Entity Encoding"-> "Raw", "Custom plugin"->"fullpage"

    Joomla translate, by ordasoft.com

    © 2021 NicaPro. All Rights Reserved. Designed By BPM Digital