site_tools/modules/site_tools_group_helpers/README.md

Site Tools — Group Helpers

Sub-módulo do Site Tools com utilitários para integração com o módulo contrib 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:

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

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

dependencies:
  - site_tools:site_tools_group_helpers