Lightning's mission is to enable developers to create great authoring experiences and empower editorial teams.
You'll notice that Lightning appears very sparse out of the box. This is by design. We want to empower editorial teams and enable developers to jump-start their site builds. That means that a developer should never have to undo something that Lightning has done. So we started with a blank slate and justified each addition from there.
The preferred way to install Lightning is using our Composer-based project template. It's easy!
$ composer self-update $ composer create-project acquia/lightning-project MY_PROJECT
If you don't want to use Composer, you can install Lightning the traditional way by downloading a tarball from Lightning's GitHub releases page. (Please note that the tarball generated by Drupal.Org's packager does not include required Composer dependencies and should not be used without following the special instructions found there.)
You can customize your installation by creating a sub-profile which uses
Lightning as its base profile. Lightning includes a
Drupal Console command (
lightning:subprofile) which will generate a
sub-profile for you.
Lightning can be installed from a set of exported configuration (e.g., using the
--existing-config option with
drush site:install). This method of installation
is fully supported and tested.
Through custom, contrib, and core modules plus configuration, Lightning aims to target four functional areas:
The current version of media includes the following functionality:
Drupal community members have contributed several modules which integrate Lightning Media with additional third-party media services. These modules are not packaged with Lightning or maintained by Acquia, but they are stable and you can use them in your Lightning site:
Lightning includes a Landing Page content type which allows editors to create and place discrete blocks of content in any order and layout they wish using an intuitive, accessible interface. Lightning also allows site builders to define default layouts for content types using the same interface - or define multiple layouts and allow editors to choose which one to use for each post.
Lightning includes tools for building organization-specific content workflows. Out of the box, Lightning gives you the ability to manage content in one of four workflow states (draft, needs review, published, and archived). You can create as many additional states as you like and define transitions between them. It's also possible to schedule content to be transitioned between states at a specific future date and time.
Lightning ships with several modules which, together, quickly set up Drupal to deliver data to decoupled applications via a standardized API. By default, Lightning installs the OpenAPI and JSON:API modules, plus the Simple OAuth module, as a toolkit for authentication, authorization, and delivery of data to API consumers. Currently, Lightning includes no default configuration for any of these modules, because it does not make any assumptions about how the API data will be consumed, but we might add support for standard use cases as they present themselves.
If you have PHP's OpenSSL extension enabled, Lightning can automatically create an asymmetric key pair for use with OAuth.
We publish sprint plans for each patch release. You can find a link to the current one in [this meta-issue][meta_releases] on Drupal.org.
Demonstration videos for each of our user stories can be found here.
Please use the Drupal.org issue queue for latest information and to request features or bug fixes.
Drush is not aware of the concept of inherited profiles and as a result, you will be unable to uninstall dependencies of any parent profile using Drush. You can still uninstall these dependencies via the UI at "/admin/modules/uninstall". We have provided patches here for Drush which allow you to uninstall dependencies of parent profiles.
Each Lightning component also has a drupal.org issue queue:
For more information on local development, see CONTRIBUTING.md.
Lightning is an installation profile, so there's no "officially" sanctioned way to remove it. The procedure outlined here is one that you do at your own risk, and in the worst case scenario it has the potential to break your site, so proceed with caution! It highly recommended to first attempt this in a development environment before doing it in production.
drush config:set core.extension profile standard.
composer require --no-update drupal/panelizer:^4.2. This is very important, because your site is likely to break if you remove Lightning before ensuring that all the modules you need are being required by Composer. If you need to continue using a particular Lightning module, you can require it just as you would any other Drupal module; for example,
composer require --no-update drupal/lightning_api:^4.1. (Note that this "à la carte" style only works with Lightning 3 or later.)
acquia/lightningfrom your composer.json file:
composer remove --no-update acquia/lightning.
composer require --no-update drupal/core:~8.7.0. You should specify the same minor version of core that you were using when Lightning was installed.
drush site:install PROFILENAME, or as a configuration parameter for BLT.