Melhorar sistema de convites

Targeting version 2.7, we will be making some improvements to the invite system to bring it into line with how platforms like Discord are handling invites these days, with a bias toward quickly generating a link that can be copied and pasted into an email, text or chat. Options like sending an email with personalized message or adding users to groups etc will be provided behind an advanced options :gear:. Invite management will also be improved to enable users to edit their invites after they have been created.

This change has quite a few moving parts and touches on things that staff can do that regular users cannot, so we will want to be mindful to get it right. I’ve indicated the top level todos below as well as proposed copy for the new interfaces. We can update this OP as we move along.

  • remove LINKS tab, restructure PENDING tab on /user/invited/pending page to include link invites
  • add ability to edit existing invites listed on PENDING tab
  • simplify the Invite popup, putting advanced options behind :gear:
  • add ability to specify topic where the invited user will land after accepting invite
  • add interim step to Bulk Invite (for admins) with just in time education on how to prep and upload csv
  • We did not remove it but made it work! remove ability to invite new user via share button on topic menu

Proposed new interfaces:

Structure of new consolidated pending tab
Invitation Groups Topic Created/Last sent Expires
invitedperson@example.fake team, developers Welcome, developers! Nov 15 Dec 15 [Edit] [Delete] [Get link] [Send email]
link (1/5 redeemed) team Oct 5 Dec 15 4pm [Edit] [Delete] [Get link]
anotherinvitedperson@example.fake translators Getting started with translation Nov 2 Dec 20 [Edit] [Delete] [Get link] [Send email]
thirdinvitedperson@example.fake team Nov 25 Dec 25 [Edit] [Delete] [Get link] [Send email]
New invite popup
Heading: Invite people 

Share this link with others to instantly grant access to SITENAME!

[                             ]  [create link/copy]

Your invite link expires next week. :gear:

Note: when CREATE LINK button selected, the link is added to the empty field and the button changes to COPY. When selected, the link is copied to the clipboard to be pasted into an email, chat or text.

New invite popup advanced options
Title: Invite people (advanced options)

Add to groups:

[ Search... ]

Send to topic on first login: 

[ Search... ]

Expire after

[ Select a timeframe  ]

Max number of uses

[ 5 ]

Limit to email address 

[ name@example.com ] 

Send email 

[ Hello, please join our team.


                                                ]

    [                           ] [create link/copy link] [send email]

Note: Expire after is one week after current date by default. Max number of uses is only shown if no email address is provided. Custom message and send email buttons are only shown if email address is provided.

New bulk invite interim step
Title: Bulk invite (admin only)

Invite a list of users to get your community going quickly. Prepare a [csv file](https://en.wikipedia.org/wiki/Comma-separated_values) containing at least one row per email address of users you want to invite. The following comma separated information can be provided if you want to add people to groups or send them to a specific topic the first time they sign in.   

name@example.com,group_1;group_2,topic_id

Every email address in your uploaded csv file will be sent an invitation, and you will be able to manage it later. 

[ upload csv file]

Note: selecting the upload csv file button opens the file system to select the csv to upload.

18 curtidas

As folks on tests-passed may have noticed, @dan has been diligently working on improving the invite system along the lines described in the OP. The improvements are now in and working quite well, so now is a good time to check it out if you have not already! Let us know what you think and if you notice any issues. Some screenshots of new interfaces below.

Invites can now be accessed via a much improved interface on the user menu. Pending link and email invites are now displayed in a combined interface. Redeemed invites are displayed in chronological order, newest first.

The biggest addition is that regular users allowed to invite others can now copy a link to share in addition to sending an email invite. They can also change the max number of times a link can be used, limited by the invite link max redemptions limit users admin setting (default 10). They cannot change how long invites are valid, set in invite expiry days admin setting (default 30 days).

Staff can access advanced options to add invited users to groups, choose a specific topic to send them to upon first login, and change the link expiry timeframe. For email invites, staff can add an optional personal message.

Bulk invite works as previously, except now an interim step is displayed with some just in time info on how to set up your csv file before uploading it.

Pending invites tab with both link and email invites

Create invite link with advanced options open

Create invite email with advanced options open

12 curtidas

13 posts were split to a new topic: API endpoint to create invite links has moved to /invites.json

This looks great - thanks to all those who worked on it :slight_smile:

7 curtidas

7 posts were split to a new topic: Trusted users cannot invite when must approve users admin setting enabled

Just a comment/idea for further improvement:
our Discourse has separate categories linked to groups representing separate community membership. There are multiple communities on the same overall installation. It would be good if

  • either the “user to user inivitation” includes an automatic option so that the invitated person inherits the same group membership as the invitating person (maybe selectable if the inviter has multiple group memberships)
  • or there is some kind of workflow where the admin/moderator approval adds the correct group permissions in a second step
2 curtidas

I’m not sure whether it’s just an overlook during the revamp of the UI, or if there is a rationale for this, but when a user, non staff, owner of some group(s), select invite just one email address, the advanced options does not let him add the invitee to his group(s). The owner still can do it via the UI in /g . Maybe this change could be reminded somewhere, in js.user.invited.invite.restrict_email perhaps?

Thanks so much for all the updates, especially this one. A big improvement on usability of invites.

2 curtidas

@dan implantou uma atualização no sistema de convites nas últimas semanas. Conte-nos o que você acha e se tiver sugestões para melhorias futuras! O principal objetivo com essas últimas alterações é torná-lo o mais simples possível, ainda suportando toda a magia do sistema de convites. Não há mais uma tela “avançada”. Todas as opções disponíveis estão no pop-up de convite ao mesmo tempo, conforme relevante para a situação e o que o usuário tem acesso.

Usuários regulares têm apenas algumas opções e, para eles, convidar é muito fácil. Percebo que, para a equipe, ainda estamos olhando para uma lista de cinco itens para decidir (todos opcionais) antes de obter o link de convite ou enviá-lo por e-mail… o que é útil, mas potencialmente confuso, especialmente para pessoas novas no Discourse. Estamos procurando maneiras de manter toda a magia, mas mudar para uma interface mais simples. Sugestões são bem-vindas.

Capturas de tela:

Usuário com Nível de Confiança 2 convidando alguém por e-mail. A mensagem pessoal opcional é exibida somente quando você começa a digitar o endereço de e-mail.

Mesmo usuário convidando alguém via link de convite no menu do tópico. Observe que “Chegar ao tópico” é exibido, mas não pode ser editado.

O administrador recebe todos os recursos. Ainda não comecei a digitar o endereço de e-mail. Um aviso é exibido se você tentar fazer com que o convidado chegue a um tópico em uma categoria segura que requer associação a um grupo para acesso.

Quando salvo o convite, posso copiar o link para compartilhá-lo.

Uau, isso parece muito complexo. Entendo o impulso aqui e a ideia é interessante, mas não tenho certeza se queremos adicionar ainda mais magia neste momento. Você consegue o que deseja usando as opções de convite para tópico e grupos disponíveis para a equipe? Cada subcomunidade tem um grupo ao qual as pessoas podem se juntar depois de se inscreverem, e os usuários podem ajudar uns aos outros e trabalhar com os proprietários de grupos para que isso aconteça.

Isso é intencional, para manter o sistema de convites mais simples para a maioria dos usuários. Como você disse, os proprietários de grupos sempre podem adicionar pessoas aos seus grupos através de sua página de grupo, ou convidá-los e adicioná-los imediatamente ao seu grupo.

Se estivermos errados sobre isso e muitas pessoas reclamarem da forma como isso funciona, podemos reconsiderar essa decisão.

4 curtidas