https://github.com/nuvoleweb/config_filter

Config Filter module - https://www.drupal.org/project/config_filter
https://github.com/nuvoleweb/config_filter

configuration drupal

Last synced: 13 days ago
JSON representation

Config Filter module - https://www.drupal.org/project/config_filter

• Host: GitHub
• URL: https://github.com/nuvoleweb/config_filter
• Owner: nuvoleweb
• Created: 2017-02-23T16:33:39.000Z (almost 8 years ago)
• Default Branch: 8.x-2.x
• Last Pushed: 2020-10-28T07:19:32.000Z (over 4 years ago)
• Last Synced: 2024-11-24T06:23:39.060Z (2 months ago)
• Topics: configuration, drupal
• Language: PHP
• Size: 78.1 KB
• Stars: 0
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Config Filter

[![Build Status](https://travis-ci.org/nuvoleweb/config_filter.svg?branch=8.x-1.x)](https://travis-ci.org/nuvoleweb/config_filter)

[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/nuvoleweb/config_filter/badges/quality-score.png?b=8.x-1.x)](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.

## 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.

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

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:

```php

/**

 * @ConfigFilter(

 *   id = "may_plugin_id",

 *   label = @Translation("An example configuration filter"),

 *   weight = 0,

 *   status = TRUE,

 *   storages = {"config.storage.sync"},

 * )

 */

```

See `\Drupal\config_filter\Annotation\ConfigFilter`.

The weight allows the filters to be sorted. The status allows the filter to be

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

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.