site_tools/modules/site_tools_group_helpers/README.md

# Site Tools — Group Helpers

Sub-módulo do [Site Tools](../../README.md) com utilitários para integração com o módulo contrib [Group](https://www.drupal.org/project/group).

## Requisitos

- `site_tools`
- `group` (contrib) ^3.0

## Funcionalidades

### Plugin de seleção: Member groups

Plugin `EntityReferenceSelection` com id `site_tools_group_helpers` que restringe campos de referência à entidade `group` aos grupos dos quais o **usuário atual é membro**, em vez de listar todos os grupos do site.

#### Como usar

No formulário de configuração de um campo `entity_reference` com `target_type: group`, selecione **"Member groups (current user)"** em _Reference type_.

Em YAML de configuração:

```yaml
handler: 'site_tools_group_helpers'
handler_settings:
  target_bundles: null   # null = qualquer tipo de grupo
```

O módulo também remove a obrigatoriedade de selecionar um tipo de grupo no formulário de configuração do campo, para campos que referenciam `group` — tanto neste handler quanto no handler padrão.

### Troca automática de widget

Ao configurar um campo para usar o handler `site_tools_group_helpers`, o módulo atualiza automaticamente todos os form displays daquele campo para o widget **`options_select`** (caixa de seleção), mais adequado quando o número de opções é pequeno.

Ao reverter para outro handler, o widget é restaurado para `entity_reference_autocomplete`.

## Instalação

```bash
drush en site_tools_group_helpers
drush cr
```

Na instalação, o módulo verifica se há campos existentes já configurados com o handler `site_tools_group_helpers` (por exemplo, após importação de configuração) e aplica o widget `options_select` automaticamente.

## Dependência em outros módulos

```yaml
dependencies:
  - site_tools:site_tools_group_helpers
```