Help:Growth/Mentorship/Integrating mentorship/id

Pertumbuhan Komunitas

Growth Features

Use the tools

For communities

Updates

Growth Team

Prosedur berikut hanya bisa dilakukan di wiki yang menyediakan perkakas Growth .

This integration is only valid at wikis that turned mentorship on.

Konteks

Beberapa proyek telah memiliki sistem bimbingan aktif. Contoh umumnya adalah bot yang mengirim pesan selamat datang pada halaman pembicaraan pengguna baru, ditandatangani oleh pengguna berpengalaman dari sebuah daftar, atau oleh bot itu sendiri. Fitur Growth juga menugaskan pembimbing acak kepada pengguna baru dari sebuah daftar.

Oleh karena itu, mengaktifkan fitur Growth pada proyek semacam itu dapat menduplikasi bimbingan bagi pengguna baru, melihat bahwa mereka memiliki pembimbing yang berbeda di tempat yang berbeda.

It makes sense to allow such projects to retrieve the Growth Team mentor assigned to each user, so they can integrate it with their own mentorship systems, and give the newcomer the same mentor in all places.

Magic word

This is now possible via a magic word {{#mentor}}, which was introduced in February 2021. The magic word takes one parameter, the username of the mentee, and returns raw username of the mentor. The magic word will return an empty string in case the mentee does not have any mentor assigned (for instance, because they don't have the newcomer homepage enabled).

Usage

For example, to get the mentor of User:Martin Urbanec (WMF), one would write {{#mentor:Martin Urbanec (WMF)}}, which would return the raw username of the mentor.

You can use the magic word together with the {{#if}} parser function, to incorporate a fallback mechanism into your project's templates.

Examples

The examples below assume that the mentee is User:Mentee, who is mentored by User:Mentor.

• {{#mentor:Mentee}} – will output Mentor
• [[User:{{#mentor:Mentee}}]] – will output User:Mentor
• {{#mentor:{{PAGENAME}}}} – used in a welcome message on the mentee's talk page, will output Mentor
• {{#mentor:{{BASEPAGENAME}}}} – used on the mentee's draft page ([[User:Mentee/Draft]]), will output Mentor
• [[User:{{subst:#mentor:Mentee}}|{{subst:#mentor:Mentee}}]] – will ping Mentor. Important: the subst: part is required; pinging will not work without it.

Limitations

Only new accounts who have been created after the deployment of the Growth team features at a wiki, or accounts created after the list of mentors for Growth has been setup, will get a mentor.

If a user has no mentor, and they have not opted-out mentorship in their preferences, they can be claimed by a mentor.