‘wp_list_bookmarks’-Funktion (Wordpress)
Freitag, der 4. Januar 2008. Geschrieben in Standard, Tutorials, Wordpress |Die “wp_list_bookmarks”-Funktion liest die Links vom Blogroll aus. Dazu gibt es einige Extras zur Auslesung.
Argumente:
$defaults = array(’orderby’ => ‘name’, ‘order’ => ‘ASC’, ‘limit’ => -1, ‘category’ => ”,
‘category_name’ => ”, ‘hide_invisible’ => 1, ’show_updated’ => 0, ‘echo’ => 1,
‘categorize’ => 1, ‘title_li’ => __(’Lesezeichen’), ‘title_before’ => ‘<h2>’, ‘title_after’ => ‘</h2>’,
‘category_orderby’ => ‘name’, ‘category_order’ => ‘ASC’, ‘class’ => ‘linkcat’,
‘category_before’ => ‘<li id=”%id” class=”%class”>’, ‘category_after’ => ‘</li>’);
Dabei gilt:
- Standard = wenn man den Codeohne Veränderungen einfügt, werden alle Links in Kategorien verteilt angezeigt. Code: “<?php wp_list_bookmarks(); ?>” (Zeigt alle Kategorien mit zugehörigen Links an).
- orderby = sortiert die Links nach folgenden Kriterien: id (ID des Linkes), name (Titel des Linkes), target, rating, description, updated (Veröffentlichung), length (Länge des Titels), owner (Ersteller des Linkes), notes, rel. Beispiel: “<?php wp_list_bookmarks(’orderby=id‘); ?>” (Sortiert die Links nach ID, zum Beispiel 1, 6, 9, 10, 11, 36 usw.)
- limit = zeigt pro Kategorie nureine maximale Anzahl von Links an. Beispiel: “<?php wp_list_bookmarks(’limit=5‘); ?>” (Zeigt, falls vorhanden, pro Kategorie maximal 5 Links an).
- category = zeigt nur Links aus einer (oder mehrerer) Kategorien an. Beispiel: “<?php wp_list_bookmarks(’category=5,3‘); ?>” (Zeigt nur Links aus der Kategorie 5 und 3.
- categorize = zeigt entweder alle Links ohne Kategorien an oder in Kategorien sortiert, dabei gilt: 0 = Nein (unsortiert) und 1 = Ja (in Kategorien sortiert). Beispiel: “<?php wp_list_bookmarks(’categorize=0‘); ?>” (Zeigt alle Links unsortiert, bzw. nicht in Kategorien verteilt).
- before = zeigt Text vor einem kompletten Link an, auch (falls vorhanden und aktiviert) deren Beschreibung. Dazu ist aber auch noch der “after“-Tag nötig, siehe Punkt 7. Beispiel: “<?php wp_list_bookmarks(’before=<strong>‘,’after=</strong>‘); ?>” (Gibt die Links fettgedruckt aus).
- after = zeugt Text hinter einem Link, bzw. deren Beschreibung. Dazu ist noch der “before“-Tag nötig, siehe Schritt 6. Beispiel: “<?php wp_list_bookmarks(’before=<strong>‘,’after=</strong>‘); ?>” (Gibt die Links fettgedruckt aus).
Mehrere Argumente:
Die Funktion setzt sich aus einem Anführungszeichen, dem Argument, einem weiteren Anführungszeichen und zur Trennung ein Komma, am Schluß ist aber kein weiteres Komma nötig.
Beispiel: “<?php wp_list_bookmarks(‘before=<strong>‘,’after=</strong>‘,’orderby=id‘); ?>” (Zeigt einen Link mit Beschreibung fettgedruckt und nach Link-ID sortiert an).