README

A Statamic addon that automatically redirects visitors from / to their locale-specific home route based on their browser language preferences.

Features

Detects the visitor's preferred language from the Accept-Language header
Matches it against your Statamic multi-site locales
Redirects from / to the best-matching locale home URL (e.g. /en, /fr, /de)
Preserves query parameters through the redirect
Configurable locale exclusions and restrictions
Zero configuration required for basic usage

Requirements

PHP 8.2+
Statamic 5 or 6

Installation

composer require noordermeer/statamic-locale-redirect

That's it. The addon registers itself automatically via Laravel's package discovery.

How It Works

When a visitor hits your site's root URL (/), the middleware:

Reads the Accept-Language header from the browser
Fetches all configured Statamic site locales and their URLs
Finds the best match between browser preferences and available locales
Issues a 302 redirect to the matched locale's home URL

If no match is found, the visitor is redirected to the default site's URL (or a configured fallback). Query parameters are preserved through the redirect.

Configuration

The addon works out of the box with no configuration. To customize behavior, publish the config file:

php artisan vendor:publish --tag=locale-redirect

This creates config/statamic/locale-redirect.php:

return [
    'exclude' => [],
    'only' => [],
];

Exclude Locales

Prevent specific locales from being redirect targets:

'exclude' => ['de', 'it'],

Restrict to Specific Locales

Only allow redirection to specific locales. When set, only takes precedence over exclude:

'only' => ['en', 'fr'],

Testing

./vendor/bin/phpunit

License

The MIT License (MIT). Please see LICENSE for more information.

jorisnoo / statamic-locale-redirect

Maintainers

Package info

Statistics

Security