Skip to content
This repository was archived by the owner on Nov 16, 2021. It is now read-only.

5.0.0-alpha1

Choose a tag to compare

@phenaproxima phenaproxima released this 01 May 01:32
· 55 commits to 8.x-4.x since this release

Install

For the best developer experience and dependency management, install with Composer using the following command: composer create-project acquia/lightning-project MYPROJECT

Caveats

A few things to note about Lightning 5:

  • This is an early alpha. It is NOT meant for production use! It's for you to test the Drupal 9 waters. As with all alpha releases, we do not guarantee an update path.
  • Lightning 5 drops support for Drupal Console, in favor of Drush. Before we release a stable version, we will port the lightning:subprofile command to Drush.
  • Lightning 5 does NOT include the Libraries API module, because it doesn't appear that it will support Drupal 9. If you are using it, you will need to copy or fork it into your own project directly, or drop your usage of it. (The most common use of Libraries API -- finding the location of an asset library -- has been moved into core. See https://www.drupal.org/node/3099614 for details.)
  • This release effectively deprecates Panelizer support in Lightning. Lightning 5 requires Panelizer 5, which implements a migration to Layout Builder. You can do the migration on your own time; in the interim, existing Panelizer layouts will continue to work, but default layouts will be read-only. More details at http://lightning.acquia.com/blog/how-migrate-panelizer-layout-builder.
  • This release includes a pre-release snapshot of Lightning Media 4, which uses the core Media Library module in place of Entity Browser for certain things (Entity Browser is still used for image fields), and the core oEmbed system instead of Video Embed Field. Video Embed Field is still included to support existing sites, but will be removed as a dependency from Lightning Media 4. (Lightning Media will trigger warnings about this.)
  • You cannot update to Lightning 5 from Lightning 3.3.x, 4.0.x, or earlier. This is a limitation of Drupal core. You must be on Drupal 8.8 or 8.9 before you can upgrade to Drupal 9. So if you are on an old version of Lightning, now is a very good time to update to either 3.4.x or 4.1.x, depending on which major version you are currently using. (Note that you do NOT need to update from 3.4.x to 4.1.x in order to update to Lightning 5.)

Changelog

  • Updated Drupal core to 9.0.0-beta2.
  • Ported the lightning:version command to Drush.

Update steps

Update your codebase:

composer self-update
composer require acquia/lightning:~5.0.0-alpha1 --no-update
composer update

Run database updates (if required - depending on the version from which you are updating):

drush cache:rebuild
drush updatedb

Run Lightning configuration updates (if required - depending on the version from which you are updating):

drush cache:rebuild
drush update:lightning

For general update instructions see https://github.com/acquia/lightning/blob/5.0.x/UPDATE.md.