Cloudron First Use Instructions Modal

[marcusquinn]

I must explain the same things many times to new users logging in to my.example.com.

It would be a big time-saver, for them and me, if we could have a first-use pop-up modal that contained one page with first-use welcome introductions and explanations.

This could be dismissed, and a (?) icon put in the top-bar for clicking to see it again.

Admins should be able to edit it.

I do something similar with the Rocket Chat Home page - but then I have to get people through the my.example.com login first, so it makes more sense to have the instructions there to get them into all the other apps necessary for their work and communications.

[girish]

Are you thinking of a customizable popup or adding a popup? Any ideas on what this popup might contain?

Possibly related, would it help if the welcome/invite mail had better instructions. There is a plan to make that mail customizable at some point and that of course can have links to some external site for instructions.

[robi]

See what nextcloud does with a new account?

Points out a few things to click through to get an orientation.

It's just some .js overlay bubbles.

[atrilahiji]

@robi Exactly what I was imagining. Yeah this would be nice and fairly straight forward to do (I would think).

More than the technical side of things, the main challenge would be sorting out the "perfect" language to use in this modal to properly onboard people.

One way to avoid having the onus on @staff would be to disable it by default and when enabled, it lets the admin create their own "slides" with html markup to show to new users. This way @girish and @nebulon can avoid the nightmare of constantly fielding requests to adjust parts of the text when people just do it themselves. Considering all that they do this seems like the most sustainable solution.

[jdaviescoates]

I think I'd actually prefer a simple one page pop-up instructions thing like @marcusquinn is proposing rather than the Nextcloud approach (I'm always ever so mildly annoyed but such things), but I can see the value in both approaches.

[atrilahiji]

@jdaviescoates I mean with the generic approach of using a "slides" sort of method covers this by just having a single slide. I think having this flexibility will limit the number of requests @staff get and shift the responsibility to server owners.

[jdaviescoates]

@atrilahiji sure, fair point. I guess I just like the idea of being able to simply write some text somewhere rather than having to do any coding of any type (including html).

But I guess it would also be pretty cool for admins who want to go all out with multiple JS slides or whatever to be able to do so too.

[atrilahiji]

@jdaviescoates true. I guess it could be a WYSWYG editor with an HTML option?

[girish]

@atrilahiji Just clarifying for myself. The pop up instructions are for your users (i.e the local Cloudron users) correct ? As opposed to some sort of onboaring/welcome flow on how to use Cloudron.

[robi]

If someone can provide a nice one page modal example, it will be easy to copy / reimplement.

p.s. it should have dark mode CSS capability..

[atrilahiji]

@girish Correct. It would be for onboarding users that access the dashboard my.domain.tld

[marcusquinn]

Cool - OK, we have interest - I'll do some draft copywriting for this to give you an idea what's currently working for me.

[girish]

@marcusquinn yes, I think for a start if it's just a simple popup with some customizable markdown, I think it's easy to add this.