parfaitementweb/statamic-locale-suggester

There is no license information available for the latest version (1.0.2) of this package.

Statamic addon to suggest your visitors to read the page in their preferred language.

Maintainers

Details

github.com/parfaitementweb/statamic-locale-suggester

Source

Issues

Installs: 4 013

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 1

Open Issues: 2

1.0.2 2021-03-23 16:49 UTC

Unknown License 65c76e1203f1e0b31019f8ed1e26a6b18454d643

  • Alexis Serneels

This package is auto-updated.

Last update: 2024-04-23 23:54:23 UTC

README

Statamic 3.0+

Suggest your visitors to read the content in their preferred language. 🌍

Features

  • Displays an alert if the current page is available in the visitor's preferred language.
  • Based on your multi-site configuration.
  • Entirely customizable
  • Entirely translatable
  • Built-in translations in English, French, German, Spanish, Italian, Dutch and Portugese

How does it work?

  1. We detect the preferred language of your visitors based on their browser settings.
  2. If their preferred language matches a locale in your multi-site configuration, the alert box will be shown.
  3. If the visitor dismisses the alert box, we set a cookie and he won't be bothered again.

Getting Started

This addon required PHP PECL intl >= 1.0.0 to be installed on your server.

We have made things easy for you to start. Here are the three steps your need to follow:

  1. Install the addon
    Simply run composer require parfaitementweb/statamic-locale-suggester
    You also can follow the official Statamic help guide

  2. Add these two tags in your layout.

This insert the alert in your layout. By default, its position is fixed so placing this tag at the bottom of your <body> is fine.

{{ locale-suggester:alert }}

Add the scripts in your layout. This handles the dismiss button.

{{ locale-suggester:script }}
  1. Enjoy.

What does the addon look like?

Statamic Locale Suggester Preview in EN

Statamic Locale Suggester Preview in FR

Statamic Locale Suggester Dashboard

Customize the alert, the script and the translations

You can execute the following commands so the views and translations files will be copied to your vendor resources folder.

php artisan vendor:publish --tag=statamic-locale-suggester-views
php artisan vendor:publish --tag=statamic-locale-suggester-translations

Don't be shocked when you'll discover we've used plain and inlined CSS rules in our alert template. This is done to ensure maximum compability without the need to recompile and repurge your stylesheet before being able to use this addon. You can of course customize everything to your needs.

Changelog

V1.0.1
SameSite Cookie value has been set to Lax.
Improved default UI for the alert

V1.0.1
Better to not show the alert for unpublished versions isn't?

V1.0.0
🚀 Would you like to read the initial commit in another language?