WoltLab Cloud User Onboarding 1.3.5

Looking to increase user engagement and retention for your community? This plugin helps new users get used to your community quickly, efficiently and playful, thereby reducing the likelihood of them bouncing.

Set up custom and weighted tasks that users must complete before their profile is considered complete. A sidebar box is available to show users how close (or far) they are to completing their profile and encourage them to complete the remaining tasks. Incentivize new users to introduce themselves to the forum, add an avatar, and explore other features of your community. This is an effective and engaging way to introduce new users to your community and help them acclimatize quickly.

You can also use this plugin's functionality to create time-limited goals. Vary the required tasks and set different requirements to keep your users active. Don't forget to reward them with a trophy!

This plugin is a real game changer when it comes to community engagement.


The following tasks are currently available:

  • Confirm E-Mail Adress
  • Enable Multi-Factor Authentication
  • Set an avatar
  • Set a cover photo
  • Set a signature
  • Filling out a specific (also custom) profile field
  • Being a member of a specific user group or multiple user groups
  • Give a certain number of reactions
  • Receive a certain number of reactions
  • Receive a certain number of activity points
  • Receive a certain number of trophies (trophy points)

The following tasks are also available when using the official apps:

  • Created a certain number of posts in a specific forum (requires forum in version 5.5.0 or higher)
  • Created a certain number of threads in a specific forum (requires forum in version 5.5.0 or higher)
  • Write a certain number of most helpful answers (requires forum)
  • Created a certain number of blog posts (requires blog)
  • Uploaded a certain number of images to the gallery (requires gallery)
  • Uploaded a certain number of files to the filebase (requires filebase)
  • Created a certain number of events in the calendar (requires calendar)

Additional features

  • Automatically award trophies to users who have completed all tasks
  • Automatically assign users who have completed all tasks to a user group
  • (Developers) Use provided events and extend the plugin with your own task conditions.


By default, the box is only displayed on user profiles, but can also be placed on other pages via the box management. The right and left sidebars are supported as positions.

All options are in the Configuration -> Users -> Onboarding section of the ACP.

The following options are available:

  • Globally disable/enable the box
  • Continue showing box after completion
  • Show box only on own profile
  • Show box for specific user groups (Requirement for displaying the box)

Please refer to the screenshots for detailed descriptions of the options.

A list of all tasks and the option to add more tasks can be found in the Users -> User Onboarding section of the ACP. In the list view, tasks can be sorted using drag-and-drop, activated/deactivated, deleted and edited. To manage tasks, the administrative right "Can manage tasks" is required, which can be found in the user group settings under Administrator Permissions -> Users -> User Onboarding.

A task has the following properties:


The title of a task is not visible to users and is only used as an internal name.


The description is used for the box output and can be created in multiple languages. You can use the placeholders {userID} and {username} to output the userid oder username in the text. Furthermore, the option "Use HTML in the description" is available, for example to use colors or to link several words individually. Use this option with caution.


The position determines the order in which the task appears in the box. The tasks can also be sorted via the list view using drag and drop.

Link / URL

The URL serves to link the description in the box. For example, a task can be linked to a forum or to the user settings. You can use the placeholders {userID} and {username} to, for example, link to the user profile. This property is not functional if "Use HTML in the description" is checked.


The weighting describes the importance of the task among all other tasks. For example, if you have two tasks with the weights 90 and 10, the box will show a progress of 90% when the first task is completed. The progress is always the percentage of all achieved weights in relation to the total of all weights.

Excluded User Groups

Sometimes it is necessary to exclude certain user groups from tasks. For example, an administrator might not be forced to create a thread to introduce themselves in order for their profile to be considered complete. This way, you don't have to completely exclude the group from all tasks, but you can narrow them down further at the task level.

Required User Groups

As a counterpart to excluding user groups, tasks can also require certain user groups. This makes it possible to add additional tasks only for users in these user groups.


A task has exactly one condition, after which the task is considered completed. The available conditions are listed above. Some conditions require additional input. The input fields only become visible when such an option is selected.


If you still have questions, you can ask them in the comments section of the plugin. For support requests, please start a new conversation so I can take care of the problem as soon as possible. I currently do not offer support through any other platform.


  • Version 1.3.5


    • Fixed a bug when counting posts in forums/categories that do not contain any threads
  • Version 1.3.4


    • Fixed a bug that prevented pages not registered via PIP from being accessed under certain circumstances
    • Fixed a bug that prevented error pages such as "Page not found" from being accessed
  • Version 1.3.3


    • Added a missing update instruction related to the new notice condition
    • Placeholders are now properly replaced when viewing another user's onboarding box
  • Version 1.3.2


    • Added a notice condition for (un)completed onboarding tasks
    • Added a user group permission to see other users' onboarding box
      This permission is disabled for all groups by default and only has an effect on user profiles
      Note: The title of the box does not change and may be a bit misleading!
    • Cleanup of the update instructions based on the minor release version
  • Version 1.3.1


    • Trashed entries no longer count toward quest completion
      Affected: Forum posts/topics, blog entries, gallery images, filebase files, calendar events
  • Version 1.3.0


    • Added a task level option to require user groups for certain tasks
      This allows certain user groups to be tasked with additional tasks
    • Dynamically created language variables are now also deleted when the associated task is deleted
      This does not apply retrospectively to orphaned language variables
    • When creating and editing tasks, the show order of the tasks is now recalculated
    • The choices in the show order form field are now always in the correct order
  • Version 1.2.0


    • Added a task level option to exclude user groups from certain tasks
      This allows, for example, a team member to complete all tasks without creating an introduction thread
    • Added a condition that requires filling out a specific profile field
      A profile field is considered set if the value is not an empty string, null, false, 0 ('0'), or '0000-00-00'
    • With the revision of the profile field condition, a bug in the validation of the "Birthday" profile field has been fixed
    • Removed the conditions for filling out the "About me", "Birthday" and "Gender" profile fields
      Existing tasks of these types are automatically converted during the update
    • The performance of SQL queries for certain task types has been slightly optimized
    • (Developers) Added events (pre 5.5) that allow developers to add their own task types.
      Upon request via conversation I will provide a package for demonstration purposes
  • Version 1.1.1


    • Fixed a bug that could cause an error during the automatic assignment of trophies and user groups
    • Added a condition for creating a certain number of threads in specific forums
      This condition requires the forum in version 5.5.0 or higher.
    • Added placeholder variables that allow using the username or userID in the task description and url.
  • Version 1.1.0


    • Fixed a bug related to the "most helpful answers" condition that resulted in an error
    • Added a missing language variable and changed several other language variables
    • A minimum number requirement can now be specified for the conditions regarding reactions
      Tasks of this condition type will have their value set to 1 during the update
    • A minimum number requirement can now be specified for the condition "number of forum posts"
    • Added a condition for creating a certain number of blog posts (requires blog)
    • Added a condition for uploading a certain number of images in the gallery (requires gallery)
    • Added a condition for uploading a certain number of files in the filebase (requires filebase)
    • Added a condition for creating a certain number of events in the calendar (requires calendar)
  • Version 1.0.0

    Initial Release

  • Hello,

    I encountered an "Error Message" when I first entered some choices / selections; when finished I proceeded to go to my Dashboard Page via the ACP.

    I got locked out of my forum, but still could log back into the ACP.

    So I uninstalled your plugin and then Re-installed it.

    The plugin works fine now; but Alexander Ebert thought I should let you know about this.

    Do you want a Copy of the Error Message?

    • Hello, yes please, shoot me a PM with the error message! :)

  • Wen die Box für das onboarding auf "auf allen Seiten darstellen" gesetzt wird, kommt es bei einer Link-Weiterleitung auf externen Link auf der "weiterleitungs-Seite" zu einem Fatalen Fehler: dass ein Array null ist.

    • Vielen Dank für die Meldung. Der Fehler ist in Version 1.3.4 behoben :)

    • perfekt. danke

  • Ich glaube das Plugin ist mit Warly Boxxer nicht kompatibel.

    Wenn ich es installiere bekomme ich eine Fehlermeldung beim Aufruf eines Profils.

    • Hallo. Mir ist kein Fehler im Zusammenhang mit dem genannten Plugin bekannt. Bitte sende mir die vollständige Fehlermeldung per Konversation (nicht hier im Kommentarbereich), damit ich mir diese einmal ansehen kann.

  • Bei mir fehlen Bedingungen betreffend Forum, obwohl das App installiert ist. Woran kann das liegen?

    "Benutzer hat mindestens die folgende Anzahl an Beiträgen erstellt, die als hilfreichste Antwort markiert wurden" ist die einzige Bedingung betreffend Forum. (WoltLab Version 5.4)

    • Hallo. Wie in der Beschreibung angegeben, erfordern die Bedingungen für eine bestimmte Anzahl an Beiträgen/Themen in einem bestimmten Forum den Einsatz der WoltLab Suite 5.5 bzw. dem WoltLab Suite Forum in Version 5.5.0 oder höher.

      Thanks 1
  • Ist es möglich irgendwie über CSS den Fortschrittsbalken bei 100 % eine andere Farbe zugeben?

    • Hallo. Dein Vorhaben lässt sich mit folgendem CSS lösen:

      .userOnboardingBox .userOnboardingProgress[data-label="100%"] .value {
          background-color: #2eb62c;
          background-image: linear-gradient(to bottom, #2eb62c, #57c84d);
      Thanks 1
    • Danke hat geklappt. :thumbup:

  • I have activated (Added a user group permission to see other users' onboarding box) and I use {userID} and {username}

    in some of the menu, and apparently I now go in and look at another user and see what he has done and how many percentages, but it is my nick name that appears in everyone else's menu :?:

    • Thanks for reporting this issue. Placeholders will be properly replaced in the next version :)

      Thanks 1
  • Ich habe die neue Funktion jetzt aktiviert, die On Boarding Box der anderen zu sehen, aber mir wird sie nicht angezeigt, meine eigene dagegen schon auf anderen Profilen. Was mache ich falsch?

    • Hallo. Bist du sicher, dass du der Gruppe das Recht "Kann den Onboarding-Fortschritt anderer Benutzer sehen" gegeben hast? Auf fremden Benutzerprofilen wird immer nur der eigene Fortschritt angezeigt, wenn die Option "Box nur auf eigenem Profil anzeigen" deaktiviert ist und diese Berechtigung fehlt. Bedenke auch, dass sich der Titel der Box nicht ändert, also ggf. der Titel "Vervollständige dein Profil!" etwas irreführend ist, wenn dieser nicht angepasst wird.

    • Ah jetzt hab ich es.

      Der Titel der Box war irreführend.

      Es passte alles und ich war nur auf nem Profil, wo auch 100 % war.

      Wie könnte man den Titel denn noch nennen, habt ihr Ideen? Oder du?

    • Vielleicht ein neutraler Titel wie "Profilvervollständigung". Wenn du den "spielerischen" Gedanken des Titels nicht komplett verwerfen willst und die Box bspw. auch auf dem Dashboard anzeigen möchtest, kannst du auch eine zweite Box erstellen (CSS-Klasse beachten) und nur den Titel der Box auf Benutzerprofilen ändern.

    • Hatte jetzt auch Profilvervollständigung genommen, was anderes war mir nicht eingefallen!

      Danke! :) :thumbup:

      OK 1
  • Wunsch: Ideal wäre es, wenn der User einen globalen Hinweis bekommen könnte, das es noch Aufgaben gibt, die nicht abgeschlossen sind. Diesen Hinweis KANN er ausblenden, kommt aber halt nach einiger Zeit wieder.

    • Hallo. Ich werde demnächst eine Version einreichen, in welcher du die Hinweisfunktion des WSC dafür nutzen kannst. Damit ist lediglich der letzte Part nicht umsetzbar, ohne dass du den Hinweis manuell zurücksetzt.

      Thanks 1
    • DMedia bin ich blind oder wo finde ich diese Option nun?

    • Nein, du bist nicht blind. Ich hatte bei der Überarbeitung der Update-Anweisungen etwas vergessen :)

      OK 1
  • Very good plugin... is it possible that you can get a log in acp so that we can see the different percentages on members

    • There is no information about a user's onboarding completion status by design. It's not even cached. This is because the tasks are evaluated at runtime and their status can change at any time. Adding such a view to the ACP would be very inefficient (either performance-heavy or quickly outdated). What would be feasible, and probably the closest thing to that, is adding a permission to view a user's progress on their user profile, which would at least allow to see a user's current progress.

  • Hab das Plugin jetzt mal gekauft. Gibts irgendwie die Möglichkeit "Hat Thema xy gelesen/aufgerufen" anzulegen?

    Habe einen Thread mit einer Art Bedienungsanleitung + generelle Marschroute und Einstellung fürs Forum und den sollen sich alle bezahlten Mitgliedschaften (möglichst regelmäßig) angucken und nochmal durcharbeiten.

    Kirsche auf der Torte wäre dann dieses "möglichst regelmäßig", also wenn zeitgesteuert dieses Thema irgendwann wieder auf "ungelesen" (für dein Plugin zumindest, nicht fürs Forum generell) gesetzt würde und die Box wieder auftaucht, wenn er nicht zB 1x im Monat das Thema aufruft.

    P.S.: Hab den Thread jetzt zusätzlich als Untermenüpunkt im Hauptmenü (über Interner Link > Thema > Themen-ID), falls es dadurch irgendwie leichter möglich wäre.


    • Hallo. Würde sich das Plugin Pflicht-Thema nicht vielleicht eher für dein Vorhaben eignen? Damit kannst du sicherstellen, dass das Thema gelesen wird, denn der Onboarding-Prozess ist prinzipiell optional. SoftCreatR bietet das Plugin inzwischen ebenfalls an, um das der Fairness halber noch erwähnt zu haben :D

    • Ja, das wäre auch ne Option, über die ich schon mit Softi verhackstückt habe. Noch schöner fänd ichs aber über dein Plugin.

      Kleines Zusatz-Attentat: Habe gesehen, dass die voreingestellten Avatare mit den Initialen leider für dein Plugin als eingestelltes Avatar zählen. Kann man das noch ändern, damit die Leute ein WIRKLICH eigenes reinstellen "müssen"? Wäre sehr geil.

      Super Plugin und diese beiden Funktionen hier würden mein Leben quasi vervollständigen.

    • Ich bin mir nicht sicher, ob sich die Bedingung sinnvoll umsetzen lässt, da Themen generell nur für maximal 7 Tage bzw. ab WSC 5.5 für maximal einen Monat als ungelesen gelten. Für einen neuen Benutzer im Onboarding-Prozess gilt ein entsprechendes Thema im Großteil der Fälle also automatisch als gelesen. Das o.g. Vorhaben ist für dieses Plugin nach ersten Überlegungen zu spezifisch und ließe sich wesentlich flexibler mit dem verlinkten Plugin abbilden.

      Das Problem mit den Avataren kann ich bei mir nicht reproduzieren, da bei der Verwendung der Initialen kein Avatar existiert (avatarID = null) und die Grafik stattdessen zur Laufzeit erstellt wird. Im WSC wird der Avatar auf dieselbe Weise überprüft. Wenn du dir aber sicher bist, dass etwas nicht stimmt, kannst du gerne eine Konversation öffnen :)

    • Avatare hat sich erledigt. Da war ich einfach zu doof und hab was Falsches eingestellt :)

      Rest ist schade aber verständlich. Danke dir, gutes Plugin!

  • Wie wird eigentlich die Prozentanzeige aktualisiert? Habe einige Aufgaben erfüllt, aber sie füllt sich nicht. Super Plugins übrigens, wurde heute gekauft. :)

    • Hallo. Beträgt die Gewichtung der Aufgaben zufällig 0? Der Prozentwert wird aus der Anzahl der erreichten Gewichtungen in Relation zu der Summe aller Gewichtungen berechnet. Aufgaben mit einer Gewichtung von 0 tragen nicht zum (sichtbaren) Fortschritt bei.

      Thanks 1
    • Ah okay, perfekt. Dann bastle ich mal weiter :)

  • Wird immer besser. Freut mich, dass das Plugin so ankommt.

    Super Umsetzung, vielen Dank fuer das neue Update!

    Like 1
  • Ich bin auch super zufrieden.

    Drittanbieter Unterstützung wäre wünschenswert.

    Zum Standard würde mir noch einfallen:

    Hat Profilfeld XY ausgefüllt (Unterstützung von selber erstellten Profilfeldern)

    Hat ein Thema im Forum XY erstellt. (derzeit gibt es die Möglichkeit mit Beitrag in Forum XY, möchte ich aber beispielsweise das der User ein vorstellungsthema erstellt wäre die Option in meinem Verständnis auch erledigt wenn er auf ein anderes Vorstellungsthema antwortet)

    • Freut mich, dass du zufrieden bist :)

      Die Events zur eigenen Erweiterung werde ich in einem der nächsten Updates bereitstellen, habe damit aber bewusst etwas gewartet. Die Unterstützung beliebiger Profilfelder ist ebenfalls für ein zukünftiges Update geplant.

      Die Bedingung für das Erstellen einer bestimmten Anzahl von Themen in bestimmten Foren ist im nächsten, bereits eingereichten Update enthalten. Mir war das Problem im selben Kontext aufgefallen :D

      Like 1
    • Die Erweiterung um benutzerdefinierte Profilfelder fände ich auch prima, dann wird das Plugin sofort gekauft.

      So ließen sich Mitglieder gut motivieren, für das Seitenthema relevante Informationen im Profil auszufüllen, aktuell macht das nur ein Bruchteil der Leute :)

    • Hallo. Ich habe nun die nächste Version eingereicht, mit der es unter anderem möglich sein wird, benutzerdefinierte Profilfelder als Aufgabentyp zu verwenden. Ich habe zwar sämtliche Feld-Typen getestet, bin aber an Feedback interessiert, ob die gewählte Standard-Validierung ihren Zweck für jedes Profilfeld zuverlässig erfüllt.

      Like 2
  • Klasse Plugin, dem ich auf jeden Fall 5 Sterne gebe. Danke für die Umsetzung!

    Thanks 1
  • Wie lautet die URL wenn auf das Profil verlinkt werden soll?

    • Es gibt standardmäßig leider keinen allgemeingültigen Link zum eigenen Benutzerprofil. Mit dem nächsten Update stelle ich Variablen zur Verfügung, sodass du die URL bspw. mit example.com/user/{userID} angeben kannst.

    • Danke!

    • Softcreatr hatte da mal ein kleines Plugin hier im Forum für veröffentlicht.

      Damit leitet der Link deinedomain.tld/me immer auf das eigene Profil des users der draufklickt. Funktioniert sehr gut mit dem Plugin hier. Auch ein weiteres Plugin zum bearbeiten des eigenen Profils wurde hier im Forum von softcreatr veröffentlicht.

      Like 1
  • Schicke Idee. Coole Umsetzung. Interessant wären evtl. Aufgaben für das VieCode Lexikon (Erstelle einen Eintrag, kommentiere einen Eintrag, usw).

    Existieren Events um das Paket um eigene Aufgaben zu erweitern?

    • Ja, Events dafür anzubieten stand bereits von Anfang an auf der To-Do-Liste. Ich hatte mir die Option für den Fall, dass ich noch konzeptionelle Änderungen vornehme, aber noch offen gehalten, damit die Funktionsweise sich nicht sofort ändert. Außerdem wollte ich erstes Feedback abwarten, damit oft gewünschte Aufgaben (ohne Bezug zu Drittanbieter-Plugins) direkt im Plugin ihren Platz finden.

  • Ich hätte da noch eine Frage:

    Kann ich irgendwie einstellen, wann die Box angezeigt wird?

    • Wenn alle Punkte erledigt sind?
    • Wenn man schon eine gewisse zeit registiert ist. (Irgendwann will man das dann auch nicht mehr sehen.)
    • Die Box wird standardmäßig ausgeblendet, wenn alle Aufgaben erfüllt sind. Ist eine Aufgabe nicht mehr erfüllt, wird die Box wieder angezeigt. Andernfalls kannst du festlegen, welche Benutzergruppen die Box sehen sollen und über die Box-Einstellungen kannst du Gruppen auch wie gewohnt komplett ausschließen.

  • Super Plugin.

    Bei mir werden wieder gelöschte Aktion zb. (Avatar gelöscht) nicht als noch auszuführende Aufgabe angezeigt sondern als erledigt. Soll das so ?

    • Die Aufgaben werden zur Laufzeit überprüft. Das heißt, wenn ein Benutzer dessen Avatar über die Avatar-Verwaltung entfernt (avatarID = NULL), ist die Aufgabe nicht mehr erledigt.

  • Richtig gute & originelle Idee.

    Werde ich mir auch (spätestens mit dem Umstieg auf 6.0) installieren.

    Like 1
  • Gute Idee, werde ich mir ggf. mal anschauen! :)

    Like 1
  • Schick :)

    Thanks 1
  • Super Idee, aber warum ist denn "Erstelle ein Titelbild" nicht verlinkt?

    Da könnte man doch das eigene Profl verlinken, wo man es ändern kann.

    "Über mich" könnte man meiner Meinung nach folgende URL verwenden: user/[Id mit Benutzername]/?editOnInit=true#about

    • Die Verlinkung kann für jede Aufgabe individuell festgelegt oder weggelassen werden. Ich habe die Funktion in der Vorschau lediglich etwas spärlich verwendet :)

  • Einmal ein Lob an die richtig coole Idee.

    Thanks 1
  • A truly great Plugin: "Onboarding"

    "Onboarding" is definitely one of my favorite plugins! Best of all, I appreciated the quick reply to my request for "help"! I highly recommend this plugin designer and his products; and I look forward to purchasing more plugins! :)

  • Man bekommt keine Punkte oder Jcoins

    Ich finde für 7€ sollte es schon möglich sein, für jede Aufgabe verschiedene Punkte und Jcoins erhalten können.

  • Danke fuer die konstante Weiterentwicklung des Plugins. Funktioniert bestens!

  • Und wieder sinnvolle Erweiterungen

    Klasse Plugin, welches immer sinnvoll weiter entwickelt wird.

    Vielen Dank!

  • Feine Sache, schneller Support

    Das Plugin tut was es soll. Nach einer Rückmeldung an den Entwickler kam zügige Antwort und danach ein Update. Top!

Customers Who Bought This File Also Bought

  1. JCoins

    This plugin integrates an extensive virtual credit system into the WoltLab Suite with which member can be rewarded for their activities.
    WoltLab Cloud
    EUR 19.99
    • Like 32
    • 560 Purchases
  2. Allows you to create a modern slideshow with teaser as an eye catcher in your dashboard and/or forum.
    WoltLab Cloud
    EUR 12.99
    • Like 85
    • 1.1k Purchases
  3. Community Bot

    The 'Swiss Knife' for your community.
    EUR 19.99
    • Like 38
    • 989 Purchases
  4. This plugin provides a clean and modern shoutbox for your community.
    WoltLab Cloud
    EUR 6.99
    • Like 293
    • 4.9k Purchases