[bearbeiten] Beschreibung

Gibt eine Liste der Kategorien in einer Auswahlbox aus (z.B. einem Kombinationsfeld).

[bearbeiten] Verwendung

<?php dropdown_cats(optionall, 'all', 'sort_column','sort_order', optiondates,
 optioncount, hide_empty, optionnone, selected, hide); ?>

[bearbeiten] Beispiele

[bearbeiten] Auswahl mit 'Senden'-Button

Gibt eine Kategorie-Auswahlliste (Kombintaionsfeld) in einem HTML-Formular mit einem 'Senden'-Button aus. Die Ausgabe erfolgt im WordPress-Sidebar in einer unsortieren liste.

<li id="categories"><?php _e('Categories:'); ?>
   <ul><li>
   <form action="<?php echo $PHP_SELF ?>" method="get">
   <?php dropdown_cats(); ?>
   <input type="submit" name="submit" value="view" />
   </form>
   </li></ul>
</li>

<form name="catform" action="<?php echo $PHP_SELF ?>">
  <select name="cat" onchange="submit(this.form)">
    <option value=''>by section</option>
    <?php dropdown_cats(); ?>
  </select>
</form>

Hinweis zum zweiten Beispiel: Diesen Code zu benutzen wird funktionieren, Ihre Seite wird jedoch vom W3C-Validator nicht mehr als valides XHTML-Coding akzeptiert. Wenn Ihnen die Validität wichtig ist, müssen Sie die Datei /wp-includes/template-functions-category.php Ihrer WordPress-Installation verändern. Kommentieren Sie die Zeilen 208 (echo "<select name ='cat' class='postform'>\n";) und 227 (echo "</select>\n";) aus. Dies verindert, das Sie überflüssige Tags ausgeben.

Dies ist falsch! Es ist nicht nur nicht valide, weil der generierte Code verschachtelte Selects produziert, es funktioniert ganz einfach nicht! Wie auch immer, Sie können die Datei /wp-includes/template-functions-category.php Ihrer WordPress-Installation verändern. Kommentieren Sie die Zeilen 208 (echo "<select name ='cat' class='postform'>\n";) und 227 (echo "</select>\n";) aus. und dann das obige Coding benutzen. Es ist aber generell nicht empfehlenswert die Standard-WordPress-Dateien zu modifizieren.

[bearbeiten] Parameter

optionall 

(boolean) Generiert einen Platzhalter um alle Kategorien auswählen zu können. Gültige Werte:

• TRUE (Default)
• FALSE

all 

(string) Text der für den Platzhalter um alle Kategorien anzuzeigen angezeigt werden soll. Standardwert ist 'All'.

sort_column 

(string) Sortierschlüssel nach dem die Auswahlliste sortiert wird. Gültige Werte:

• 'ID' (Default)
• 'name'

sort_order 

(string) Sortierreihenfolge der Auswahlliste. Gültige Werte:

• 'asc' (Default)
• 'desc'

optiondates 

(boolean) Gibt an ob das Datum des letzten Posts in der jeweiligen Kategorie angezeigt werden soll. Gültige Werte:

• TRUE
• FALSE (Default)

optioncount 

(boolean) Gibt an ob die Anzahl der Beiträge in der jeweiligen Kategorie angegeben werden soll. Gültige Werte:

• TRUE
• FALSE (Default)

hide_empty 

(boolean) Gibt an ob leere Kategorien (ohne Beiträge) versteckt werden sollen. Gültige Werte:

• TRUE (Default)
• FALSE

optionnone 

(boolean) Gibt an ob eine eine Option in die Auswahlliste eingebrachte werden soll, um keine der Kategorien angezeigt werden soll. Gültige Werte:

• TRUE
• FALSE (Default)

selected 

(integer) Gibt die als Standard ausgewählte Kategorie in Form Ihrer ID-Nummer an. Standardwert ist die aktuelle Kategorie.

hide 

(integer) Diese Kategorie wird nicht angezeigt (angegeben durch ihre ID-Nummer). Es gibt keinen Standardwert.

[bearbeiten] Korrekturen

Sollten Sie eine Kategorie auswählen und sich nicht auf der Hauptseite befinden, werden Sie nicht in die entsprechende Kategorie weitergeleitet. Um dies zu korrigieren, finden Sie die folgende Zeile in Ihrem Theme in welchem Sie die Kategorie-Auswahllisten verwenden: <form action="<?php echo $PHP_SELF ?>" method="get"> Ersetzen Sie diese durch : <form action="/index.php" method="get">

Dies ist eine vorläufige Korrektur für dieses Problem. Die endgültige Korrektur wird wahrscheinlich bald erscheinen. Dieses Problem taucht in der Regel auf Blogs auf, in denen Permalinks (Apache-RewriteRules) aktiviert sind.

(Hinzugefügt von Chenu J)

[bearbeiten] Ähnliches

the_category the_category_rss the_category_ID the_category_head single_cat_title category_description dropdown_cats list_cats wp_list_cats in_category get_category_parents get_the_category