WordPress 2.7: HTML-Struktur der Kommentare ändern

Diese Anleitung bezieht sich ausschließlich auf WordPress 2.7 und die darin enthaltenen neuen erweiterten Kommentarfunktionen. Wie man die Kommentare in seinem eigenen Theme für WordPress 2.7 bereit macht kann man hier und hier (auf deutsch) nachlesen.

Dadurch, dass die Kommentarschleife durch die Funktion wp_list_comments() ersetzt wurde ist man per default auch auf die HTML-Struktur, die WordPress vorgibt, beschränkt. Sicherlich gibt es genug Punkte, um via CSS anzusetzen, dennoch reichen die Möglichkeiten unter Umständen nicht aus. Glücklicherweise kann man ohne Hacks die Ausgabe der Kommentare den eigenen Wünschen anpassen.

Zuerst einmal muss man die Funktion wp_list_comments wie folgt erweitern:

Der Callback Parameter verweist auf eine noch zu erstellende Funktion list_comments die sich um die Aufbereitung jedes einzelnen Kommentars kümmert. Diese sollte man möglichst in der functions.php im Theme-Ordner ablegen. Ist die Datei noch nicht vorhanden kann sie einfach erstellt werden. Um fürs erste die Standardausgabe zu kopieren fügt man folgendes ein:

  <  id="comment-">
  

  

	  < ?php if ($args['avatar_size'] != 0) echo get_avatar( $comment, $args['avatar_size'] ); ?>
	  < ?php printf(__('%s Says:'), get_comment_author_link()) ?>
	

  comment_approved == '0') : ?>
	  
	  
  
< ?php printf(__('%1$s at %2$s'), get_comment_date('F jS, Y'),  get_comment_time()) ?>< ?php edit_comment_link('edit','  ','') ?>

  

	 $add_below, 'depth' => $depth, 'max_depth' => $args['max_depth']))) ?>
  

  
	

  

Viel Code auf einmal, aber der Reihe nach: Durch Zeile 3 wird das aktuelle Kommentar global verfügbar, dadurch können die einzelnen Funktionen von WordPress auch darauf zugreifen. Zeile 5 - 11 formatieren den Anfangs-Tag basierend auf dem Parameter style, den man wp_list_comments mitgeben kann. Danach folgt auch schon die Ausgabe des Kommentars, dem geübten Theme-Entwickler dürften die meisten Funktionen sofort bekannt vorkommen. Neu sind die Funktionen comment_class, die dem Anfangs-Tag (oder jedem anderen Tag, falls gewünscht) die entsprechenden Klassen zuweist, sowie comment_reply_link, der den Link erzeugt, mit dem man eine Antwort zu einem Kommentar verfassen kann.

Ferner interessant ist das Array $args, dass Parameter bereithält, im speziellen $args['avatar_size'] für die Größe des Avatars sowie $args['max_depth'] für die maximale Tiefe der Verschachtelung. Setzt man die Parameter ein lassen sich die Werte im WordPress Backend direkt ändern - wichtig für Themes, die zum Download bereitgestellt werden sollen!

Im folgenden möchte ich kurz die Veränderung am Theme Aeros zeigen, damit die Ausgabe wieder korrekt ist. Die ursprüngliche Struktur eines Kommentars sieht wie folgt aus:

    Kommentarautor
  

Hi, ich bin ein Kommentar!
Kommentar | Datum

Zugegeben, recht simpel, für Anschauungszwecke aber völlig ausreichend. Damit WordPress 2.7 damit etwas anfangen kann muss unsere Funktion list_comments also wie folgt abgeändert werden:

   <  id="comment-">


	    < ?php if ($args['avatar_size'] != 0) echo get_avatar( $comment, $args['avatar_size'] ); ?>
	    < ?php comment_author_link(); ?>
	  

	  
Kommentar | < ?php printf(__('%1$s'), get_comment_date('F jS, Y')); ?>< ?php edit_comment_link('edit','  ','') ?>

	     $add_below, 'depth' => $depth, 'max_depth' => $args['max_depth']))) ?>
	  


}
?>

Der einführende li-Tag wurde durch $tag ersetzt, das ist eigentlich nicht nötig, da im Theme ja ohnehin fest vorgegeben, schaden kann es aber trotzdem nicht. Die Klassen sind nicht zwingend notwendig, können aber bei Anpassungen via CSS nützlich sein. Beim Rest wurden die einzelnen Elemente durch die entsprechenden WordPress-Funktionen ersetzt. Neu hinzukommen ist der div-Container mit der ID div-comment-KommentarID, der das gesamte Kommentar umschließt sowie der div-Container mit der Klasse reply, der wiederum den Antworten-Link beinhaltet. Beide Container müssen (in dieser Struktur) vorhanden sein, damit das Kommentarformular an die korrekte Position (in den reply-Container) verschoben werden kann, wenn man auf den Antworten-Link klickt.

Mit verhältnismäßig wenig Aufwand kann man den Kommentaren also eine eigene HTML-Struktur geben und trotzdem die neuen Funktionen von WordPress 2.7 nutzen.