andersundsehr / geo_redirect
Redirect users based on browser language and ip country to the right language version of the website
Installs: 812
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 1
Type:typo3-cms-extension
Requires
- php: ~8.2.0 || ~8.3.0
- composer-runtime-api: ^2
- ext-json: *
- codezero/browser-locale: ^3.3
- geoip2/geoip2: ^2
- typo3/cms-backend: ^11.5.0 || ^12.4.0
- typo3/cms-core: ^11.5.0 || ^12.4.0
- typo3/cms-redirects: ^11.5.0 || ^12.4.0
Requires (Dev)
- andersundsehr/resource-watcher: dev-master
- phpunit/phpunit: ^10.5.25
- pluswerk/grumphp-config: ^7.0.3
- saschaegerer/phpstan-typo3: ^1.10.1
- spatie/phpunit-watcher: ^1.23.6
- ssch/typo3-rector: ^2.6.2
- typo3/cms-reports: *
README
This extension redirect users based on browser language and ip country to the right language version of the website.
Installation
composer require andersundsehr/geo_redirect
Go to the TYPO3 Extension Settings and configure as you need.
!!!
If you want to use the ip to Country detection with the mmdb file you should add your maxmindLicenseKey
(see Extension Settings).
Get your key here: https://dev.maxmind.com/geoip/geolite2-free-geolocation-data
Features
- Redirect domain root to detected language
- Redirect sys_redirect to detected language
How it works
This extension uses the user's Accept-Language header and the country derived from the IP address to find the correct language version of the site.
For IP to Country there are mutliple Implementatinos.
If you use Cloudflare or Sucuri, the extension will use the header that is set by the service.
If you set a maxmindLicenseKey
in the extension settings, the extension will use the mmdb file from maxmind.com.
Otherwise it will ignore the request origin country. And just use the Accept-Language header.
Options
ipCountryIsMoreImportantThanLanguage
: If it is more important that the user gets the content for his country than that he gets content for his languages, then turn this option on.maxmindLicenseKey
: Maxmind.com License Key: if you want to use the mmdb file you should add the license key (https://dev.maxmind.com/geoip/geolite2-free-geolocation-data)
mmdb file
The mmdb file is downloaded from maxmind.com and is updated every 5 weeks automatically.
If you always want the best performance for your users,
you should add the typo3 geo-redirect:update-up-database
command to run every month (4 weeks).
Debugging
If you request the domain with this path: /geo_redirect/debug
you will be given a detailed explenation what language was detected.
sys_redirect based on siteLanguage
This feature makes it possible to redirect the user to a specific page based on the siteLanguage.
You don't need to configure anything, for this to work.
All sys_redirect records that use a t3://page?uid= link are automatically redirected to the right language version of the page.
(if no _language= is defined in the redirect)
Extending functionality
PHP Api
get the ip country for the current request:
$ipCountryOrNull = GeneralUtility::makeInstance(IpCountryLocatorInterface::class)->getIpCountry();
get the detected language:
$siteLanguage = GeneralUtility::makeInstance(SiteLanguageFinderService::class)->findByRequest($request); // or if you don't have a request object: (in cli the request object is required) $siteLanguage = GeneralUtility::makeInstance(SiteLanguageFinderService::class)->findByRequest(); // the siteLanguage is never null, because it will always return the default language
custom redirect definition
if you want a different redirect definition, you can use the \AUS\GeoRedirect\Dto\BeforeSiteLanguageFinderEvent
to get all relevant Information and set the siteLanguage
and redirectUrl
yourself.
<?php declare(strict_types=1); namespace AUS\GeoRedirect\EventListener; final class BeforeSiteLanguageFinderEventListener { public function __invoke(\AUS\GeoRedirect\Dto\BeforeSiteLanguageFinderEvent $event): void { $languageId = $this->customLanguageIdFinder($event); if ($languageId) { $event->siteLanguage = $event->site->getLanguageById($languageId); } } // ... }
add custom IpCountryLocator
If you want to add a custom IpCountryLocator, you can do so by adding a class that implements the IpCountryLocatorInterface
and add it via the CollectIpCountryLocatorEvent
.
<?php declare(strict_types=1); namespace AUS\GeoRedirect\EventListener; final class BeforeSiteLanguageFinderEventListener { public function __invoke(\AUS\GeoRedirect\Dto\CollectIpCountryLocatorEvent $event): void { $event->addFirst(\AUS\GeoRedirect\IpCountryLocator\MyCustomIpCountryLocator::class); // or $event->addLast(\AUS\GeoRedirect\IpCountryLocator\MyCustomIpCountryLocator::class); // or if you want to add it at a specific position: $list = $event->getLocatorClasses(); // manipulate the list as you like $event->setLocatorClasses($list); } }
with ♥️ from anders und sehr GmbH
If something did not work 😮
or you appreciate this Extension 🥰 let us know.
We are hiring https://www.andersundsehr.com/karriere/