A very simple module that outputs a widget allowing a visitor to your Processwire website to translate the current page using Google translate.
Note: This module does not utitlise the Google Translate API. It simply redirects the visitor to the online web page translator which is part of Google's publically available online translator service. (https://translate.google.com/)
This module was originally built for a specific project, in response to Google deprecating their embeddable translation widget for most users. (They still allow you to apply for usage if you are in academia and a few other sectors).
Usage and continued operation of this module is at the mercy of Google allowing us to redirect traffic to their translation service in this way.
After you have installed the module to your ProcesWire installation the module will be available in any page template as follows:
<?php $translate = $modules->get('MarkupGoogleTranslate');?>
You can output a simple translation widget in your page template:
<?php echo $translate->displayTranslateWidget();?>
This will display a basic HTML select field so visitors can choose from available languages. On selecting a language the visitor will be redirected to the translated page.
The Google translate toolbar will display at the top of the page from this point forward allowing visitors to select other languages via the default Google UI.
You can also create a language specific translation link using the public buildGoogleTranslateUrl method and supplying it with an ISO language code as. E.g. for a link to a Spanish version of your page:
<?php echo buildGoogleTranslateUrl('es');?>
Available languages and ISO codes for translation based on https://cloud.google.com/translate/docs/languages
| Language | ISO Code |
|---|---|
| Afrikaans | af |
| Albanian | sq |
| Amharic | am |
| Arabic | ar |
| Armenian | hy |
| Azerbaijani | az |
| Basque | eu |
| Belarusian | be |
| Bengali | bn |
| Bosnian | bs |
| Bulgarian | bg |
| Catalan | ca |
| Cebuano | ceb |
| Chinese (Simplified) | zh-CN |
| Chinese (Traditional) | zh-TW |
| Corsican | co |
| Croatian | hr |
| Czech | cs |
| Danish | da |
| Dutch | nl |
| English | en |
| Esperanto | eo |
| Estonian | et |
| Finnish | fi |
| French | fr |
| Frisian | fy |
| Galician | gl |
| Georgian | ka |
| German | de |
| Greek | el |
| Gujarati | gu |
| Haitian Creole | ht |
| Hausa | ha |
| Hawaiian | haw |
| Hebrew | he |
| Hindi | hi |
| Hmong | hmn |
| Hungarian | hu |
| Icelandic | is |
| Igbo | ig |
| Indonesian | id |
| Irish | ga |
| Italian | it |
| Japanese | ja |
| Javanese | jv |
| Kannada | kn |
| Kazakh | kk |
| Khmer | km |
| Kinyarwanda | rw |
| Korean | ko |
| Kurdish | ku |
| Kyrgyz | ky |
| Lao | lo |
| Latin | la |
| Latvian | lv |
| Lithuanian | lt |
| Luxembourgish | lb |
| Macedonian | mk |
| Malagasy | mg |
| Malay | ms |
| Malayalam | ml |
| Maltese | mt |
| Maori | mi |
| Marathi | mr |
| Mongolian | mn |
| Myanmar (Burmese) | my |
| Nepali | ne |
| Norwegian | no |
| Nyanja (Chichewa) | ny |
| Odia (Oriya) | or |
| Pashto | ps |
| Persian | fa |
| Polish | pl |
| Portuguese | pt |
| Punjabi | pa |
| Romanian | ro |
| Russian | ru |
| Samoan | sm |
| Scots Gaelic | gd |
| Serbian | sr |
| Sesotho | st |
| Shona | sn |
| Sindhi | sd |
| Sinhala (Sinhalese) | si |
| Slovak | sk |
| Slovenian | sl |
| Somali | so |
| Spanish | es |
| Sundanese | su |
| Swahili | sw |
| Swedish | sv |
| Tagalog (Filipino) | tl |
| Tajik | tg |
| Tamil | ta |
| Tatar | tt |
| Telugu | te |
| Thai | th |
| Turkish | tr |
| Turkmen | tk |
| Ukrainian | uk |
| Urdu | ur |
| Uyghur | ug |
| Uzbek | uz |
| Vietnamese | vi |
| Welsh | cy |
| Xhosa | xh |
| Yiddish | yi |
| Yoruba | yo |
| Zulu | zu |
Original version by https://github.com/mrjcgoodwin/
Big contributions and improvements by https://github.com/cybermano/ - THANK YOU!
mrjcgoodwin - June 19 2023:
Typos fixed in backend UI. Readme updated to merge Cybermano's version.
From Cybermano fork - May/June 2023:
[V0.1.6] - "Admitted" roles to view the drop down-menu (useful for testing or pre-prod).
Added public function isUserAllowed() to check via API if the user that is viewing the site is admitted to view the drop-down language select (useful for testing).
[V0.1.5] - "Surgical" override for specific starting language.
Added public function isEnabled() to check via API if the module is enabled (useful in conditions for outputting something else in case the module is not enabled, but still installed).
Also solved an issue on checkboxes value/checked data, thanks to this PW thread .
[V0.1.4] - Enable/disable Module and "surgical" override for specific page ids.
[V0.1.3] - Minor updates and little fixes
[V0.1.2] - Minor updates and little fixes
[V0.1.1] - Native names added.
Added new method languageCodeNativeNames() and replaceed availableLanguages() and available_flipped() ones to extract English language names and/or Native language names (list from https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes)
[V0.1.0] - ModuleConfig override template and pages. Added options to override languages by single templates and page ids (single, multiple and ranges)
clearUrl() method must be checked
[V0.0.9] - ModuleConfig override templates. Added options to override languages by templates
[V0.0.8] - ModuleConfig separated from module.
Created a MarkupGoogleTranslateConfig.php to gather config data separated from the module itself (much more readble).
Converted availableLanguages() method from private to public to be used in config module.
[V0.0.7] - Language code passed to Google interface.
Passed $languageIsoCodeto the url chunk hl=XX instead of hl=ento match user required language.
Restored $scheme (https/http) in the url previously removed (ad originally not used in the forked repo)
[V0.0.6] - Restored only https scheme. It seems that Google accepts only SSL certificates, expecially on mobile...
[V0.0.5] - Styling and other stuffs
Configurable options to show Google Translator Product icon, wrap icon and select into a div, styling classes to pass either to the DIV and to the SELECT, customizable first select option label and restored specific translations.
Calling method is now as original module:
<?php $translate = $modules->get('MarkupGoogleTranslate');?>
<?php echo $translate->displayTranslateWidget();?>
or in one code line:
<?php echo $modules->get('MarkupGoogleTranslate')->displayTranslateWidget();?>
Restored the specific language override as public call, passing an array of language codes (for single languages or multiple ones):
<?php echo $modules->get('MarkupGoogleTranslate')->buildGoogleTranslateUrl(['es','fr']);?>
[V0.0.4] - STABLE (Major upgrade)
Added InputfieldAsmSelect to limit by module settings the languages shown in frontend drop-down list. N.B. Workaround: InputfieldAsmSelect won't return $key=>$value in fronend; added private method to return google available languages flipped array.
<?php echo $translate->displayTranslateWidget(['div'=>'d-flex justify-content-between','select'=>'form-control form-control-sm'],TRUE); ?>
[V0.0.3]
Added configurable field in module to override source language code to pass to google tranlation url; after that, simplifyed the method parameters to pass default language code; Also corrected a typo in $translateUrl that previously outputted a double slash in the chunk:
'translate.goog'.$currentPagePath
Inserted the https $scheme in the url, that was probabily missed.
[V0.0.2]
Added two more parameters to better style select options:
<?php echo $translate->buildGoogleTranslateUrl($languages,['div'=>'d-inline-block','select'=>'form-control'],TRUE);?>
[V0.0.1]
Now can pass only custom languages, to shorten dropdown menu for language options:
<?php $languages = ["Deutsch" => "de","English" => "en","Italiano" => "it"]; ?>
<?php echo $translate->buildGoogleTranslateUrl($languages);?>