WordPress-Plugin: A Year Before

In english — or some­thing similar

Wenn ein Blog län­ger besteht, dann ist es ja fast schon ein his­to­ri­sches Doku­ment. Und so kann es inter­es­sant sein, was so vor einem Jahr im Blog pas­siert ist.

Zumin­dest stellte sich die­ses Pro­blem dem Würz­blog. Eine grobe Recher­che brachte mir kein Plu­gin für Word­Press, dass mir diese Funk­tio­na­li­tät bot. (Falls ich es ein­fach nur über­se­hen habe, dann gibt es jetzt ein Zwei­tes. ) Also habe ich mal schnell eines selbst geschrie­ben.

Über­sicht

Mit „A Year Before” kann man Blog­be­träge anzei­gen las­sen, die vor einer bestimm­ten Zeit­spanne im Blog ver­öf­fent­lich wur­den. So kann man in einer „his­to­ri­schen Ecke” zei­gen las­sen, was vor z. B. 30 Tagen, 6 Mona­ten oder einem Jahr im Blog passierte.

Das Plu­gin ist nach wie vor im Beta-Stadium, ich garan­tiere also noch nicht, dass auch alles funk­tio­niert. Aber beim Tes­ten ist noch nichts Schlim­mes pas­siert …

Instal­la­tion

Das Plu­gin aus dem WordPress-Repository her­un­ter­la­den und das Ver­zeich­nis a-year-before mit den dar­in­lie­gen­den Dateien in den Plugin-Ordner von Word­Press schie­ben. Dann A Year Before bei den Plugins in der WordPress-Administration aktivieren.

Als Wid­get

Wenn man die Widget-Funktion von Word­Press nutzt, dann ist der Rest sehr sim­pel. Ein­fach in der Widget-Verwaltung A Year Before auf die Side­bar zie­hen. Bei Bedarf kann man im Popup-Dialog alles Mög­li­che einstellen.

Als PHP-Code

Im Tem­plate — die Side­bar bie­tet sich dafür an — an die Stelle, an der die Bei­trags­liste erschei­nen soll, fol­gen­den PHP-Code ein­fü­gen:

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

Ent­schei­dend ist die Zeile <?php ayb_posts(); ?>, hier wer­den die zurück­lie­gen­den Bei­träge aus­ge­ge­ben. Alles andere ist nur Bei­werk, das auch kurz erwähnt wer­den soll. Die erste und letzte PHP-Zeile sor­gen nur dafür, dass keine Feh­ler auf­tritt, wenn das Plu­gin nicht instal­liert oder akti­viert ist. Das DIV ist ein Con­tai­ner­ele­ment, mit dem man den gan­zen Block mit­tels CSS gestal­ten könnte. Das H2 ist die Über­schrift über der Liste, das UL erzeugt eine Liste — dazu spä­ter mehr.

Wer­den beim Auf­ruf von ayb_posts keine Para­me­ter in den Klam­mern ange­ge­ben, dann gibt das Plu­gin die Bei­träge inklu­sive Datum als Lis­ten­ele­mente aus, die vor einem Jahr geb­loggt wurden.

Kon­fi­gu­ra­tion

Die Optio­nen für das Plu­gin wird in fol­gen­der Form über­ge­ben:
parameter1=wert1&parameter2=wert2&parameter3=wert3 ...

Fol­gende Para­me­ter ste­hen zur Verfügung:

• day gibt die Anzahl der Tage an, vor denen die Bei­träge ange­zeigt wer­den sollen.
• month gibt die Anzahl der Monate an, vor denen die Bei­träge ange­zeigt wer­den sollen.
• year gibt die Anzahl der Jahre an, vor denen die Bei­träge ange­zeigt wer­den sollen.
• before gibt HTML-Code an, der vor jedem alten Bei­trag steht. Stan­dard­mä­ßig das Lis­ten­ele­ment <li>
• after gibt HTML-Code an, der nach jedem alten Bei­trag steht. Stan­dard­mä­ßig das Lis­ten­ele­men­tende </li>
• show­date schal­tet die Anzeige des Datums vor jedem Bei­trag ein (Wert=1, Stan­dard­wert) oder aus (Wert=0)
• datefor­mat ist für die For­ma­tie­rung des ange­zeig­ten Datums vor den Bei­trä­gen. Die For­matan­ga­ben sind ana­log zum PHP-Befehl date. Als Stan­dard dient die deut­sche Datums­kurz­form „d.m.y”, was z. B. zur Aus­gabe 27.12.06 führt.
• not­found ist der Text der aus­ge­ge­ben wird, wenn keine Beträge an dem Tag gefun­den wurden.
• range gibt eine Anzahl von Tagen an, die in Rich­tung Zukunft nach Arti­keln gesucht wird, wenn am gwünsch­ten Tag kein Bei­trag geschrie­ben wurde.
• anni­versary steu­ert den „Jahrestag-Modus”. Wenn auf 1 gesetzt gibt das Plu­gin alle Arti­kel aus, die an die­sem Tag in dem Monat über die Jahre geschrie­ben wur­den. Die Para­me­ters „day”, „month”, „year” und „range” wer­den ignoriert.

Bei­spiele:
ayb_posts("day=30&before=&after=&showdate=0");
Zeigt die Blog­bei­träge von vor 30 Tagen an, ohne das Datum anzu­zei­gen. Die Bei­träge wer­den nicht als Lis­ten­ele­mente aus­ge­ge­ben, son­dern ein­fach mit einem Zei­len­um­bruch hin­ter jedem Beitrag.

ayb_posts("month=6&day=14&notfound=An dem Tag wurde nix gebloggt");
Die Bei­träge vor einem hal­ben Jahr und zwei Wochen wer­den gelis­tet, inklu­sive Datum. Wurde an dem Datum kein Arti­kel geschrie­ben, dann wird der Text „An dem Tag wurde nix geb­loggt” ausgegeben.

ayb_posts(„range=14&dateformat=y-m-d”);
Schaut ob es vor einem Jahr Arti­kel geschrie­ben wur­den. Wenn nicht, schaut das Plu­gin, ob in den nächs­ten  14 Tagen etwas geschrie­ben wurde und gibt die Bei­träge vom nächs­te­mög­li­chen Tag aus.

ayb_posts(„anniversary=1″);
Zeigt Bei­träge an, die am sel­ben Tag und im sel­ben Monat wie das aktu­elle Datum geschrie­ben wur­den, unab­hän­gig vom Jahr. Also alle Arti­kel, die heute vor einem Jahr, vor zwei Jah­ren, vor drei Jah­ren und so wei­ter geschrie­ben wurden.

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

Ände­run­gen / Changelog

0.8

• Zeige Sei­ten an oder auch nicht
• Ent­we­der öffent­li­che oder pri­vate Arti­kel wer­den ange­zeigt — oder auch beide.
• Die Aus­gabe kann über Mus­ter ange­passt wer­den: %link%, %title%, %date%, %excerpt% (Danke an Mar­cus von themenfreund.de für die excerpt-Idee)
• WordPress-Widget-Klasse wird ver­wen­det (Plu­gin funk­tio­niert nur ab Word­Press 2.8+)
• OOP-Programmierung

0.7.1

• fix: Wegen einem Pro­blem in der gettext-Funktion bei PHP/Apache geben man­che Ser­ver Feh­ler­mel­dun­gen aus. Um die­sen Feh­ler zu ver­mei­den, muss ich lei­der die Über­set­zung­mög­lich­keit des Wid­gets abschal­ten. Die Funk­tio­na­li­tät bleibt voll erhal­ten, nur die Spra­che des Wid­gets ist nur immer Englisch.

0.7

• anniversary-Modus für die Suche an Arti­keln am sel­ben Tag in den letz­ten Jahren
• range-Parameter für Bereichssuche
• Beach­tung von Zeitzonen
• Bug­fi­xes

0.6.1

• Bug­fix für Side­bars, die nicht „side­bar” heißen.

0.6

• Plu­gin kann als WordPress-Widget genutzt werden
• Loka­li­sie­rung

0.5.3

• XHTML-Bugfix (über­flüs­si­ges span
• Bug­fix PHP 5 bei lee­ren Funktionsparameter

0.5.2

• Bug­fix für tole­ran­tere Zeit­an­ga­ben (z.B. day > 364). Danke an Alo­haDan für den Hin­weis und Test.

0.5.1

• Anpas­sung an MySQL-Versionen älter als MySQL 4.1.1

0.5

• Erste öffent­li­che Betaversion

Down­load

a-year-before.zip (Ver­sion 0.7.1)