WordPress-Plugin: A Year Before

With »A Year Before« you can show the tit­les of the arti­cles, which were writ­ten a cer­tain time ago. So you can show in a »his­to­ri­cal cor­ner«, what hap­pend in your blog e.g. 30 days, 6 months or a year before.

Instal­la­tion

Down­load the plu­gin and unzip the fol­der <em>a-year-before</em> in the plugin-folder of your WordPress-installation. Then activate the plugin.

If you use a theme which sup­ports wordpress-widget, then sim­ply go to the widget-administration and pull the wid­get on the sidebar.

If you want to use the plu­gin by php-code, then open your template-file — e.g. the side­bar — where you can insert the fol­lo­wing PHP-code:

<?php if (function_exists("ayb_posts")) { ?>
<div class="box">
<h2>Posts a year ago</h2>
<ul>
<?php ayb_posts(); ?>
</ul>
</div>
<?php } ?>

Con­fi­gu­ra­tion of the php-code

You can pass some para­me­ters in this scheme
parameter1=value1&parameter2=value2&parameter3=value3 ...

You can use the fol­lo­wing parameters

• day : the num­ber of days ago you want to show the articles.
• month : the num­ber of month ago you want to show the articles.
• year : the num­ber of years ago you want to show the articles.
• before : piece of HTML to insert before the title of the arti­cles. Default <li>
• after: piece of HTML to insert after the title of the arti­cles. Default </li>
• show­date: shows the date (showdate=1) before every title or not (showdate=0)
• datefor­mat : datefor­mat as used by PHP. Default ist the ger­man short­form »d.m.y«
• not­found: the text the plu­gin will out­put, if no arti­cle is found on the defined date.
• range: num­ber of days the plu­gin will search back in the future (rela­tive to the values of day, month and year above) for an arti­cle. Meant as a „round about this day”-feature. Default 0
• anni­versary: if set to 1, the plu­gin will dis­play all arti­cles ever blog­ged with the same num­ber of day and month. The para­me­ters „day”, „month”, „year” and „range” will be igno­red if used.

Exam­ples

ayb_posts("day=30&before=&after=&showdate=0");
Shows the tit­les of the arti­cles writ­ten 30 days ago wit­hout showing the date. The arti­cles will not been showed as a HTML-list but sim­ply sepe­ra­ted by a linebreak.

ayb_posts("month=6&day=14&notfound=Nothing blogged on this day.");
The tit­les of the arti­cles writ­ten half a year and two weeks before, also showing the date . If there was no arti­cle writ­ten on that day, the out­put will be »Not­hing blog­ged on this day.«

If you like CSS, you can style the date with the class ayb_date, the link of the arti­cle with the class ayb_link and the notfound-message by using the class ayb_notfound.

Chan­ge­log

0.7.1

• fix: due an issue with the gettext-function in PHP/Apache some ser­ver will out­put an warning/error-message. because of that error, the trans­la­ti­ons of the plu­gin will not lon­ger work, but the plu­gin will.

0.7

• anniversary-mode
• range-parameter
• Timezone-support
• Bug­fi­xes

0.6.1

• Bug­fix for side­bars not named „sidebar”

0.6

• Widget-function added
• Loca­liza­tion

0.5.3

• XHTML-Bugfix (unne­cessary span)
• Bug­fix PHP 5 Error with empty function-parameter

0.5.2

• Bug­fix for more tole­rant date-values (e.g. day > 364). Thanks to Alo­haDan for hin­ting and testing.

0.5.1

• Adjust­ment for MySQL-versions older than MySQL 4.1.1

0.5

• First public beta

Down­load

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