Version 1 (modified by trac, 17 years ago) (diff) |
---|
Existe um pacote de plugins para possibilitar a seleção de usuários e grupos cadastrados no expresso.
São quatro plugins divididos em dois grupos:
1- Seleçao de um único usuário (para obter id) ou vários usuários (para obter e-mail).
Plugin: wf_select_user_init
Descrição: insere código que referencia o arquivo js.
Parâmetros: <nenhum>
Exemplo de utilização: {wf_select_user_init}
plugin: wf_select_user
Descrição: insere os elementos HTML que permitem a seleção de usuários (ids/e-mails)
Parâmetros:
name : o nome do campo que irá receber o id do usuário selecionado (o nome do usuário selecionado estará no campo de formulário de nome "name" seguido do sufixo "_desc"). Quando for configurado para pegar o e-mail, os e-mails estarão no campo com o nome indicado por "name" e, o conteúdo será do tipo: "Usuário Um" , "Usuário Dois" (e assim por diante).
id_value : valor de id de um usuário previamente selecionado.
desc_value : nome de um usuário previamente selecionado (é ineficaz especificar somente o nome e não o id para deixar um usuário previamente selecionado).
get_email : indica se deve ser buscado o e-mail ou o id.
email_as_textarea : indica se o campo que receberá os emails deve ser um textarea (valor true) ou input type text (valor false). Este parâmetro só tem validade se get_email for true.
hide_groups : indica se deve-se omitir os grupos na tela de seleção.
organization : nome da organização que estará previamente selecionada.
title : texto da tooltip que aparecerá quando o usuário colocar o mouse sobre o ícone para adicionar usuário.
Parâmetro obrigatório:
name
Valor padrão:
id_value : ""
desc_value : ""
get_email : false
email_as_textarea : false
hide_groups : true
organization : null (por padrão, será utilizada a organização do usuário que está usando o processo de Workflow)
title : ""
Exemplo de utilização:
- Neste exemplo criamos um objeto de seleção de usuário que armazena o id do usuário no campo "usuario_responsavel" e o nome do usuário no campo "usuario_responsavel_desc".
{wf_select_user name="usuario_responsavel"}
- Neste exemplo criamos um objeto de seleção de usuário que armazena e-mails de um ou mais usuários no campo "contatos".
{wf_select_user name="contatos" get_email=true}
- Neste outro exemplo, criamos um objeto de seleção de usuário/grupo que armazena o id do usuário (ou grupo) no campo "entidade" e o nome do usuário (ou grupo) no campo "entidade_desc". Ainda, definimos o texto que aparece quando o usuário posiciona o cursor do mouse sobre o ícone de adição de usuário.
{wf_select_user name="entidade" hide_groups=false title="Clique aqui para selecionar uma entidade"}
Observação: antes de utilizar "wf_select_user" (seja uma ou mais vezes), deve fazer uma única chamada a "wf_select_user_init".
Exemplo de objeto de seleção criado no exemplo 1:
2- Seleçao de vários usuários e grupos (com os respectivos ids).
Plugin: wf_select_users_init
Descrição: insere código que referencia o arquivo js.
Parâmetros: <nenhum>
Exemplo de utilização: {wf_select_users_init}
plugin: wf_select_users
Descrição: insere os elementos HTML que permitem a seleção de vários usuários e grupos
Parâmetros:
name : o nome do campo que irá receber os usuários e grupos selecionados
value : usuários e grupos previamente selecionados. Deve estar no formato de matriz, seguindo o seguinte padrão: ::$matrizu123?="Nome do usuário 123" ; $matrizg321?="Nome do grupo 321" e, assim por diante.
hide_groups : indica se deve-se omitir os grupos na tela de seleção.
organization : nome da organização que estará previamente selecionada.
Parâmetro obrigatório:
name
Valor padrão:
value : ""
hide_groups : false
organization : null (por padrão, será utilizada a organização do usuário que está usando o processo de Workflow)
Exemplo de utilização:
- Exemplo simples para seleção de usuários e grupos.
{wf_select_users name="usuarios"}
- Exemplo simples para seleção de usuários e grupos com usuários pré-selecionados (indicados pela variável $pre_selecionados).
{wf_select_users name="usuarios" value=$pre_selecionados}
Observação: antes de utilizar "wf_select_users" (seja uma ou mais vezes), deve fazer uma única chamada a "wf_select_users_init".
Exemplo de objeto de seleção de usuários e grupos criado no exemplo 1:
3- Teclas de navegação na janela de seleção de usuários
Quando o usuário clicar no ícone de adição de usuários, será aberta uma janela, como exemplificado abaixo, onde além de selecionar com o mouse, podem ser usadas as seguintes teclas de atalho:
seta para cima / seta para baixo : sobe e desce na lista de usuário;
enter : seleciona a entrada que estiver marcada e transfere os dados para o formulário
esc : fecha a janela
digitação : começe a digitar o nome do usuário e a janela vai posicionando automaticamente
Attachments
- select_user.png (714 bytes) - added by pedroerp 15 years ago.
- select_users.png (7.2 KB) - added by pedroerp 15 years ago.
- select_users_window.png (24.8 KB) - added by pedroerp 15 years ago.
- select_users_window2.jpg (75.6 KB) - added by asaikawa 14 years ago.