Mejorar el sistema de invitaciones

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 Me gusta

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 Me gusta

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 Me gusta

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 Me gusta

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 Me gusta

@dan desplegó una actualización del sistema de invitaciones en las últimas semanas. Háganos saber qué piensa y si tiene sugerencias para futuras mejoras. El objetivo principal de estos últimos cambios es hacerlo lo más simple posible sin dejar de admitir toda la funcionalidad del sistema de invitaciones. Ya no hay una pantalla “avanzada”. Todas las opciones disponibles están en la ventana emergente de invitación al mismo tiempo, según corresponda a la situación y a lo que el usuario tenga acceso.

Los usuarios normales solo tienen unas pocas opciones, por lo que para ellos invitar es muy fácil. Me doy cuenta de que para el personal todavía tenemos una lista de cinco cosas que decidir (todas opcionales) antes de obtener el enlace de invitación o enviarlo por correo electrónico… lo cual es útil pero potencialmente confuso, especialmente para las personas nuevas en Discourse. Estamos buscando formas de mantener toda la funcionalidad pero pasar a una interfaz más simple. Se aceptan sugerencias.

Capturas de pantalla:

Usuario con Nivel de Confianza 2 invitando a alguien por correo electrónico. El mensaje personal opcional solo se abre cuando se empieza a escribir la dirección de correo electrónico.

El mismo usuario invitando a alguien a través del enlace de invitación en el menú del tema. Tenga en cuenta que se muestra “Llegar al tema”, pero no se puede editar.

El administrador obtiene todas las funcionalidades. Aún no he empezado a escribir la dirección de correo electrónico. Se muestra una advertencia si intenta que el invitado llegue a un tema en una categoría segura que requiere membresía de grupo para acceder.

Cuando guardo la invitación, puedo copiar el enlace para compartirlo.

Vaya, eso suena muy complejo. Entiendo el impulso aquí y la idea es interesante, pero no estoy seguro de que queramos añadir más funcionalidad en este momento. ¿Puede conseguir lo que quiere utilizando las opciones de invitar a un tema y a grupos disponibles para el personal? Cada subcomunidad tiene un grupo al que las personas pueden unirse una vez que se han registrado, y los usuarios pueden ayudarse mutu mutuamente y trabajar con los propietarios de los grupos para lograrlo.

Esto es intencional, para mantener el sistema de invitaciones más simple para la mayoría de los usuarios. Como usted dice, los propietarios de grupos siempre pueden añadir personas a sus grupos a través de su página de grupo, o invitarlos y añadirlos inmediatamente a su grupo.

Si nos equivocamos en esto y mucha gente se queja de la forma en que funciona, podemos reconsiderar esta decisión.

4 Me gusta