PHP Classes

File: README.md

Recommend this page to a friend!
  Classes of Harald Atteneder   Site Language Redirection   README.md   Download  
File: README.md
Role: Documentation
Content type: text/markdown
Description: Documentation
Class: Site Language Redirection
Redirect TYPO3 users to site of their language
Author: By
Last change:
Date: 2 days ago
Size: 2,216 bytes
 

Contents

Class file image Download

TYPO3 Site Language Redirection

PSR-15 middleware to redirect user to correct site language.

  • Language detection is based on HTTP headers (browser language) or IP address.
  • When the user switches the language, a cookie gets set to save the new language as preferred language.

How it works

Example of how the extensions determines the site to redirect to via HTTP headers:

If Accept-Language is en-US,de-AT it looks for sites with an hreflang of en-US. If there is no match it then looks for en. If there is still no match it repeats the same logic with de-AT and so on.

Installation

Install via Extension Manager or composer.

composer require urbantrout/site-language-redirection

Enable IP address based redirects

  1. Update the GeoIP2 database file for IP address based redirects via CLI or Scheduler. CLI* `./vendor/bin/typo3 sitelanguageredirection:updatedb` Scheduler* Create new task of class Excute console commands and set Schedulable Command to sitelanguageredirection:updatedb Settings of new scheduler task Use this option to periodically update your database file.

    This step creates a file under `\TYPO3\CMS\Core\Core\Environment::getVarPath() . '/sitelanguageredirection/'` with all the geolocation information. Note: This does not alter your SQL database.

  2. Update the preferred method in your site configuration in the tab Site Language Redirection. Defaults to HTTP headers.  
    Screenshot of Site Language Redirection tab in site configuration  
    Changing this value to IP address updates `config/sites/<sitename>/config.yaml` and adds the following line of code:  
    SiteLanguageRedirectionMethod: 2
    

Configure Language Fallbacks

This feature adds the possibility to define fallback languages. So for instance, if there's no italian version of the website, redirect to english version, and so on.

Site configuration would look like this with optional SiteLanguageRedirectionFallbacks:

SiteLanguageRedirectionMethod: 1
SiteLanguageRedirectionFallbacks:
  fr: 'en'
  it: 'en'