Layout Builder Styles: Conditions

A Drupal module that allows you to control access to Layout Builder Styles based on configurable conditions.

Overview

Layout Builder Styles: Conditions provides a flexible way to control what Layout Builder Styles are available on your Drupal site. This module extends Layout Builder Styles to include conditional rules, making it easy to control styles based on various conditions.

But why?

The benefit of this approach is for multi-sites, or shared codebase platforms, that share configuration across multiple sites but want some flexibility in control of what styles are available. For example, if there are two sites sharing the same codebase, Site A and Site B, and only Site B needs a particular Layout Builder Style to be available, we are able to configure availability based on a condition - this could be one provided by core, the contrib space, or something custom. This way both sites can still share the same configuration, as the conditions are stored in config, but are evaluated per-site.

Requirements

- Layout Builder Styles

Installation

1. Download the module:
You can download the module using Composer:

composer require drupal/lb_styles_conditions

2. Enable the module:
After downloading, enable the module using Drush or the Drupal admin interface:

drush en lb_styles_conditions

Or, enable it through the admin interface at /admin/modules.

Configuration

The module offers the ability to specify which conditions can be used to control Layout Builder Styles availability.

Extending the module

Developers can alter the available conditions using the provided hook:

/**
 * Implements hook_lb_styles_conditions_available_conditions_alterr().
 */
function hook_lb_styles_conditions_available_conditions_alter(array &$conditions, ?FormStateInterface $form_state = NULL, ?string $form_id = NULL): void {
  // Remove specific conditions
  $conditions_to_remove = [
    'language',
    'request_path',
  ];
  $conditions = array_diff_key($conditions, array_flip($conditions_to_remove));
}

Contributing

Contributions are welcome! If you would like to contribute to this module, please follow these steps:

1. Open an issue on the issue tracker
2. Create a Merge Request or add a patch
3. Mark your issue as Needs Review.

License

This module is licensed under the GPL-2.0+ license.

Maintainers

- Owen Bush