WebMasterService N3rds@Work

BoniPress Shortcodes bonips_users_of_rank

PSOURCE – Community’s Dokumente BoniPress Dokumentation BoniPress Shortcodes BoniPress Shortcodes bonips_users_of_rank

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]