diff --git a/README.md b/README.md index b813bfdf6208733ce957fd283486762bba2d2233..7a8f323a91398abfcd31d469ed294815b060b1b2 100644 --- a/README.md +++ b/README.md @@ -1,24 +1,29 @@ # Config Filter -[](https://travis-ci.org/nuvoleweb/config_filter) -[](https://scrutinizer-ci.com/g/nuvoleweb/config_filter/?branch=8.x-1.x) - - -## Introduction - Modules such as Config Split want to modify the configuration when it is synchronized between the database and the exported yaml files. This module provides the API to do so but does not influence a sites operation. +For a full description of the module, visit the +[project page](https://www.drupal.org/project/config_filter). + +Submit bug reports and feature suggestions, or track changes in the +[issue queue](https://www.drupal.org/project/issues/config_filter). + + ## How it works -Unlike Config Filter 1.x which swaps the `config.storage.sync` service from Drupal 8 core, -Config Filter 2.x applies the filters when the new Drupal core config storage transformation api is used. -This means that modules that previously used Config Filter now work with the new api. +Config Filter 1.x swaps the `config.storage.sync` service from Drupal 8 core. +Config Filter 2.x applies the filters when the config storage transformation api is used. +This means that modules which use Config Filter work with the API added to Drupal 8.8. Modules depending on Config Filter can depend on both 1.x or 2.x as the Config Filter API is the same. + ## What is a ConfigFilter +The API config filter provides has been superseeded by the config transformation +API in Drupal core, added in Drupal 8.8. Modules should transition to the core API. + A ConfigFilter is a plugin. This module provides the plugin definition, the plugin manager and the storage factory. A ConfigFilter can have the following annotation: @@ -41,6 +46,7 @@ active or inactive, the `ConfigFilterManagerInterface::getFiltersForStorages` will only take active filters into consideration. The weight, status and storages are optional and the above values are the default. + ## Alternative Config Filter Managers Plugins are only available from enabled modules. If you want to provide a @@ -48,3 +54,27 @@ config filter from a php library, all you have to do is implement the `\Drupal\config_filter\ConfigFilterManagerInterface` and add it to the service container with a `config.filter` tag. Services with higher priority will have their filters added first. + + +## Requirements + +This module requires no modules outside of Drupal core. + + +## Installation + +You probably do not need to install Config Filter. +Install as you would normally install a contributed Drupal module. For further +information, see +[Installing Drupal Modules](https://www.drupal.org/docs/extending-drupal/installing-drupal-modules). + + +## Configuration + +The module has no menu or modifiable settings. There is no configuration. +Config Filter is an API-only module. + + +## Maintainers + +- Fabian Bircher - [bircher](https://www.drupal.org/u/bircher)