README

Jonnitto.OutdatedBrowser

This package includes a notification for outdated browsers into Neos CMS. You can configure in your Settings.yaml when the warning should be shown.

Installation

Most of the time you have to make small adjustments to a package (e.g. configuration in Settings.yaml). Because of that, it is important to add the corresponding package to the composer from your theme package. Mostly this is the site packages located under Packages/Sites/. To install it correctly go to your theme package (e.g.Packages/Sites/Foo.Bar) and run following command:

composer require jonnitto/outdatedbrowser --no-update

The --no-update command prevent the automatic update of the dependencies. After the package was added to your theme composer.json, go back to the root of the Neos installation and run composer update. Et voilà! Your desired package is now installed correctly.

Configuration

Basicly you need to ajust the setting Jonnitto.OutdatedBrowser.lowerThan. The default value is AccentColor. You can set the setting Jonnitto.OutdatedBrowser.lowerThan to different kind of values:

• Browser based
  • A23 (Android 2.3)
  • IE8
  • IE9
  • IE10
  • IE11
  • Edge
• Feature based
  • Flexbox
  • oldGrid (The old css grid specification)
  • Grid
  • AccentColor
  • AspectRatio
• Property based
  • Any CSS property, e. g. transform

Example:

Jonnitto:
  OutdatedBrowser:
    lowerThan: AspectRatio

If you want to check for multiple features, you can write lowerThan also an array, for example:

Jonnitto:
  OutdatedBrowser:
    lowerThan:
        - Edge
        - grid-auto-flow

To change the link to the website who helps the user to download a new browser, you can do it by alter the setting Jonnitto.OutdatedBrowser.href. {locale} gets replaced with the detected locale. The default value is https://browsehappy.com/?locale={locale}

Jonnitto:
  OutdatedBrowser:
   href: "https://browser-update.org/{locale}/"

Per default, the package checks if the visitor is a crawler or not. If it is a crawler, the warning doesn't get rendered at all. You can disable this behavior like this:

Jonnitto:
  OutdatedBrowser:
    disableForCrawler: false

To add a CSS class the the element you can do it by adding following setting:

Jonnitto:
  OutdatedBrowser:
    class: 'your-custom-css-class`

Credits

This package is based on Dotpulse.OutdatedBrowser, who was also written by me. As dotpulse is not a company with active developers anymore and I have no access to the repository on packagist, I refactored the package and published it here.