Papéis e permissões de membros

Imagine que você administra a loja de roupas "Guarda-Roupa Aconchegante". Você quer que os clientes cadastrados escrevam avaliações diretamente nos produtos. Mas quer impedir que um cliente mexa nas avaliações escritas por outras pessoas, mesmo que possa editar ou apagar as suas próprias. Esse conjunto de permissões que define "o que cada membro cadastrado pode ver e o que pode escrever" é o ServiceUserRole (o conjunto de permissões concedido a um membro cadastrado).

O ServiceUserRole se aplica aos membros cadastrados, ou seja, ao ServiceUser (o cliente que se cadastrou diretamente no seu serviço). Em vez de atribuir permissões a cada membro, uma por uma, você cria uma vez um conjunto de permissões como "pode escrever avaliações" e o associa aos membros.

Nesta página, você primeiro vê o que é o ServiceUserRole e como ele se diferencia das permissões da equipe e, em seguida, cria você mesmo, no "Guarda-Roupa Aconchegante", um papel que permite ao membro escrever avaliações e editar apenas as suas próprias.

O papel de membro é diferente do papel da equipe

O WEEGLOO tem dois tipos de conjuntos de permissões. Como é fácil confundi-los, vamos traçar a fronteira primeiro.

• O SpaceRole é a permissão concedida à equipe e à administração. É a permissão das pessoas que cadastram produtos e gerenciam o site, e é tratada em Papéis e permissões.
• O ServiceUserRole é a permissão concedida aos membros cadastrados. Define o que o cliente que se cadastrou diretamente no site da loja de roupas com uma conta social pode ver e escrever.

Em poucas palavras, o SpaceRole é a permissão de "quem administra a loja" e o ServiceUserRole é a permissão de "quem visita a loja como cliente". Os dois são papéis completamente distintos, então um papel criado de um lado não se aplica ao outro. Esta página trata apenas do ServiceUserRole concedido aos membros.

A forma de criar as regras é a mesma do papel da equipe

A tela para criar um papel de membro funciona exatamente da mesma maneira que a tela para criar um papel da equipe. A tela de criação de papel é dividida em abas (Detalhes do Role, Content Type, Content e Media) e, em cada aba de recurso, você adiciona regras, uma linha de cada vez, a uma lista de Permitido e a uma lista de Negado. Uma linha de regra é a combinação que define a qual ação, em qual Content Type, criado por quem e com qual Tag anexada ela se aplica. E tudo o que você não colocar na lista de permitidos é automaticamente negado.

Como o construtor de regras funciona (permitir e negar, os tipos de ação, restringir o escopo) é tratado em detalhe em Papéis e permissões. Esta página se concentra na parte mais importante das permissões de membro, ou seja, em "como fazer com que o membro lide apenas com o que ele mesmo criou".

O essencial é "apenas o que você mesmo criou"

Quando você deixa o membro escrever avaliações, o mais comum é precisar que o membro edite e apague apenas as suas próprias avaliações. Ele não pode editar as avaliações de outras pessoas.

Cada linha de regra tem um campo para escolher o criador. Há três valores que você pode escolher aqui.

Se você escolher O próprio utilizador aqui, a regra se aplica a "o que eu criei" para cada membro individualmente. Mesmo que vários membros tenham o mesmo papel, para cada um o alvo é apenas o que ele próprio criou.

Trazendo para o exemplo da loja de roupas, se você permitir editar (Edit) e apagar (Delete) nas avaliações (Content), mas deixar o criador como O próprio utilizador, o membro só pode editar e apagar as suas próprias avaliações. As avaliações escritas por outras pessoas aparecem na lista, mas ele não pode mexer nelas.

Para sua referência, o membro cadastrado, independentemente do papel, por padrão já pode editar ou apagar apenas o que ele mesmo criou. O papel acrescenta, sobre isso, "o que ele pode criar de novo" e "o que ele pode ler".

Criar o papel "Membro comum"

Agora vamos criar, no "Guarda-Roupa Aconchegante", o papel "Membro comum" para conceder aos membros recém-cadastrados. Esse papel poderá ler todas as avaliações (Content) (Read), escrever novas (Create) e editar as avaliações que ele mesmo escreveu (Edit, autor = ele próprio).

O papel de membro é criado em Roles, dentro do ServiceLogin (a configuração de login que o cliente usa para se cadastrar e usar o serviço diretamente).

1. No menu à esquerda, expanda Serviços e clique em ServiceLogin.
2. Clique em Roles.
3. Clique no botão Criar no canto superior direito para abrir a tela de criação de papel.

Quando a tela de criação de papel ("Criar ServiceUserRole") abrir, primeiro defina o nome.

4. No campo de nome da aba Detalhes do Role, digite Membro comum. Você pode deixar o campo de descrição em branco.

Em seguida, defina as ações que o membro pode realizar nas avaliações (Content). As avaliações precisam ser criadas separadamente como um Content Type (o modelo de formulário da avaliação) para que a regra possa selecionar e aplicar a esse tipo.

5. Vá para a aba Content. Junto com o aviso "Tudo o que não estiver explicitamente permitido é negado.", aparecem as listas de Permitido e de Negado.
6. Com o botão + abaixo de Permitido, adicione uma linha de regra. Defina a ação como Read, escolha "Avaliações" como o Content Type e deixe o criador como Quaisquer utilizadores. Assim, o membro pode ler todas as avaliações.
7. Da mesma forma, adicione mais uma linha de regra. Defina a ação como Create, escolha "Avaliações" como o Content Type e deixe o criador como Quaisquer utilizadores. Assim, o membro pode escrever novas avaliações.
8. Adicione mais uma linha de regra. Defina a ação como Edit, escolha "Avaliações" como o Content Type e, em seguida, mude o criador para O próprio utilizador. Assim, o membro só pode editar as avaliações que ele mesmo escreveu.

9. Clique no botão Guardar no canto superior direito.

Quando Membro comum aparecer na lista, o papel foi criado.

Para também permitir que o membro apague avaliações, basta acrescentar mais uma linha de regra da mesma forma, com a ação Delete, o Content Type "Avaliações" e o criador como O próprio utilizador.

Aplicar aos membros o papel criado

Criar um papel não faz com que ele seja aplicado automaticamente aos membros. O papel criado só passa a ter efeito depois de ser conectado aos membros.

A forma mais comum é definir o Membro comum que você acabou de criar como o Role padrão em Login de membro do serviço. Assim, esse papel é associado automaticamente a todos os membros recém-cadastrados.

Há também momentos em que você quer dar permissões diferentes apenas a um membro específico. Por exemplo, se quiser dar permissões mais amplas a um membro destacado, pode atribuir um papel diferente apenas a esse membro (substituição por membro). Você também pode tornar alguns membros moderadores, que então podem apagar o que outros membros escreveram. Essa permissão de moderador é uma permissão restrita, que se aplica apenas à exclusão.

O que fazer a seguir

• Login de membro do serviço: conecta o papel criado como Role padrão e ativa o login social.
• Papéis e permissões: trata de como definir as permissões da equipe (a administração) com o mesmo construtor de regras.
• API Reference: trata de especificações técnicas, como o formato das requisições, para lidar diretamente, a partir de um programa, com o conteúdo que o membro lê e escreve.