mirror of
https://gitlab.unicamp.br/infimecc_drupal11_modules/site_tools.git
synced 2026-05-03 17:00:40 -03:00
Documenta sub-módulo site_tools_group_helpers e atualiza README principal
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
50
modules/site_tools_group_helpers/README.md
Normal file
50
modules/site_tools_group_helpers/README.md
Normal file
@@ -0,0 +1,50 @@
|
||||
# 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
|
||||
```
|
||||
Reference in New Issue
Block a user