Dieser Shortcode gibt eine Liste von Benutzern für eine bestimmte veröffentlichte Rolle zurück, sortiert nach ihrem Kontostand. Standardmäßig werden alle Benutzer für den angegebenen Rang zurückgegeben, aber Du kannst festlegen, wie viele Benutzer zurückgegeben werden sollen.
Wenn Du das Layout jeder Zeile anpassen möchtest, kannst Du Deine eigene Vorlage erstellen und diesen Shortcode darum wickeln. Auf diese Weise wird Deine HTML-Vorlage für jede Benutzerzeile verwendet. Unterstützt die Verwendung von Shortcodes und benutzerbezogenen Template-Tags.
Erfordert die Aktivierung des Ranks-Add-Ons.
Shortcode-Attribute
| Attribut |
Typ |
Benötigt |
Standard |
Beschreibung |
| rank_id |
INT oder STRING |
Ja |
– |
Die Rang-ID oder der Rangtitel (Groß-/Kleinschreibung beachten), für den Benutzer angezeigt werden sollen. |
| login |
STRING |
Nein |
– |
Nachricht, die Besuchern angezeigt wird, wenn sie nicht eingeloggt sind. Sollte leer gelassen werden, wenn Du auch Besuchern die Ränge anzeigen möchtest. |
| number |
INT |
Nein |
10 |
Die Anzahl der Benutzer, die für jeden Rang angezeigt werden sollen. |
| wrap |
STRING |
Nein |
1 |
Das HTML-Element, das jeden Benutzer umschließen soll. |
| col |
INT |
Nein |
1 |
Optionaler colspan zum Festlegen, wenn Du eine Tabelle als Umbruchelement verwendest und keine Benutzer gefunden wurden. |
| nothing |
STRING |
Nein |
„Keine Benutzer mit diesem Rang gefunden“ |
Optionaler Text, der angezeigt wird, wenn keine Benutzer für diesen Rang gefunden wurden. |
| ctype |
STRING |
Nein |
bonips_default |
Option zum Anzeigen von Rängen eines bestimmten Punkttyps. Sollte nicht verwendet werden, wenn Du nur einen Punkttyp installiert hast. |
| order |
STRING |
Nein |
DESC |
Die Rangfolge. Akzeptiert „DESC“ für absteigend und „ASC“ für aufsteigend. |
CSS Styling
// Wrapper div.bonips-users-of-rank-wrapper {} // Standard-Zeilenvorlage div.bonips-users-of-rank-wrapper p.user-row { }
Beispiele
Beispiel 1: Gib die Top 2 Benutzer für den Rang „Neuling“ zurück.
[bonips_users_of_rank rank_id=4 number=2]
Beispiel 2: Benutzer des Ranges mit der ID 4 in einer unorganisierten Liste anzeigen.
[bonips_users_of_rank rank_id=4 wrap="ul"] <li>%rank_logo% %display_name%</li> [/bonips_users_of_rank]
