Übersicht
=========

Mit »A Year Before« kann man Blogbeträge anzeigen lassen, die vor einer bestimmten Zeitspanne im Blog veröffentlich wurden. So kann man in einer »historischen Ecke« zeigen lassen, was vor z. B. 30 Tagen, 6 Monaten oder einem Jahr im Blog passierte.

Installation
============

Das Plugin herunterladen und die Datei ayb_posts.php in den Plugin-Ordner von Wordpress schieben. Dann das A Year Before bei den Plugins in der Wordpress-Administration aktivieren.

Im Template — die Sidebar bietet sich dafür an — an die Stelle, an der die Beitragsliste erscheinen soll, folgenden PHP-Code einfügen:

<?php if (function_exists("ayb_posts")) { ?>
<div class="einjahr">
<h2>Vor einem Jahr</h2>
  <ul>
     <?php ayb_posts(); ?>
  </ul>
</div>
<?php } ?>

Entscheidend ist die Zeile < ?php ayb_posts(); ?>, hier werden die zurückliegenden Beiträge ausgegeben. Alles andere ist nur Beiwerk, das auch kurz erwähnt werden soll. Die erste und letzte PHP-Zeile sorgen nur dafür, dass keine Fehler auftritt, wenn das Plugin nicht installiert oder aktiviert ist. Das DIV ist ein Containerelement, mit dem man den ganzen Block mittels CSS gestalten könnte. Das H2 ist die Überschrift über der List, das UL erzeugt eine Liste — dazu später mehr.

Werden beim Aufruf von ayb_posts keine Parameter in den Klammern angegeben, dann gibt das Plugin die Beiträge inklusive Datum als Listenelemente aus, die vor einem Jahr gebloggt wurden.
Konfiguration

Die Optionen für das Plugin wird in folgender Form übergeben:
parameter1=wert1&parameter2=wert2&parameter3=wert3 ...

Folgende Parameter stehen zur Verfügung:

    * day gibt die Anzahl der Tage an, vor denen die Beiträge angezeigt werden sollen.
    * month gibt die Anzahl der Monate an, vor denen die Beiträge angezeigt werden sollen.
    * year gibt die Anzahl der Jahre an, vor denen die Beiträge angezeigt werden sollen.
    * before gibt HTML-Code an, der vor jedem alten Beitrag steht. Standardmäßig das Listenelement <li>
    * after gibt HTML-Code an, der nach jedem alten Beitrag steht. Standardmäßig das Listenelementende </li>
    * showdate schaltet die Anzeige des Datums vor jedem Beitrag ein (Wert=1, Standardwert) oder aus (Wert=0)
    * dateformat ist für die Formatierung des angezeigten Datums vor den Beiträgen. Die Formatangaben sind analog zum PHP-Befehl date. Als Standard dient die deutsche Datumskurzform »d.m.y«, was z. B. zur Ausgabe 27.12.06 führt.
    * notfound ist der Text der ausgegeben wird, wenn keine Beträge an dem Tag gefunden wurden.

Beispiele:
ayb_posts("day=30&before=&after=<br />&showdate=0");
Zeigt die Blogbeiträge von vor 30 Tagen an, ohne das Datum anzuzeigen. Die Beiträge werden nicht als Listenelemente ausgegeben, sondern einfach mit einem Zeilenumbruch hinter jedem Beitrag.

ayb_posts("month=6&day=14&notfound=An dem Tag wurde nix gebloggt");
Die Beiträge vor einem halben Jahr und zwei Wochen werden gelistet, inklusive Datum. Wurde an dem Datum kein Artikel geschrieben, dann wird der Text »An dem Tag wurde nix gebloggt« ausgegeben.

Für Freunde des CSS gibt es auch die Möglichkeit, das Datum über die Klasse ayb_date, den Link über ayb_link und die notfound-Nachricht über ayb_notfound gestalten.

Änderungen / Changelog
======================

Betaversionen
-------------

0.5.1
    * Anpassung an MySQL-Versionen älter als MySQL 4.1.1
0.5
    * Erste öffentliche Betaversion
