Dieser Shortcode gibt eine Liste von Benutzern für jede Rolle in absteigender Reihenfolge zurück. Standardmäßig werden alle Benutzer für jeden Rang zurückgegeben, aber Du kannst dies auf eine beliebige Zahl ändern.
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.
Wenn Du nur Benutzer für eine einzelne Rolle zurückgeben möchtest, solltest Du stattdessen den Shortcode bonipress_users_of_rank verwenden.
Erfordert die Aktivierung des Ränge-Add-Ons.
Shortcode-Attribute
Attribut |
Typ |
Benötigt |
Standard |
Beschreibung |
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 |
STRING |
Nein |
– |
Die Anzahl der anzuzeigenden Ränge. Nicht verwenden, wenn alle Ränge angezeigt werden sollen. |
ctype |
STRING |
Nein |
– |
Option zum Anzeigen von Rängen eines bestimmten Punkttyps. Sollte nicht verwendet werden, wenn Du nur einen Punkttyp installiert hast oder wenn Du Ränge für alle Punkttypen anzeigen möchtest. |
show_logo |
INT |
Nein |
1 |
Option zum Anzeigen des Logos jedes Ranges (1) oder nur des Titels (0). |
logo_size |
STRING |
Nein |
post-thumbnail |
Wenn das Rang-Logo zur Anzeige ausgewählt ist, die Größe jedes Logos. |
wrap |
STRING |
Nein |
div |
Das HTML-Element, das als Wrapper um jeden Rang in der Schleife verwendet werden soll. |
nothing |
STRING |
Nein |
„Keine Benutzer mit diesem Rang gefunden“ |
Die Nachricht, die für Ränge angezeigt werden soll, die keine Benutzer haben. |
CSS Styling
// Wrapper
div.bonips-all-ranks-wrapper {}
// Einzelner Rang-Wrapper
div.bonips-all-ranks-wrapper div.bonips-rank { }
// Rangtitel
div.bonips-all-ranks-wrapper div.bonips-rank h2 { }
// Rang-Logo
div.bonips-all-ranks-wrapper div.bonips-rank h2 img { }
Beispiel
Beispiel 1: Gibt alle Benutzer für alle Ränge zurück und passt die Vorlage an, um eine unorganisierte Liste zu erstellen.
[bonips_users_of_all_ranks wrap="ul"]
<li>%rank_logo% %display_name%</li>
[/bonips_users_of_all_ranks
]