=== Around this date in the past... ===
Plugin Name: Around this date in the past...
Author: Joan Junyent Tarrida
Author URI: http://junyent.org/
Contributors: jjunyent, Mike Koepke, Cinefilo
Donate link: http://junyent.org/blog/my-code 
Plugin URI: http://junyent.org/blog/2006/05/20/around-this-date-in-the-past-wordpress-plugin/
Version: 0.6.3
Tags: archives
Requires at least: 2.0
Tested up to: 2.1
Stable tag: 0.6.2

It shows entries/posts around today's date in the past (if they exist). It is highly customizable.

== Description ==

[ Notas en castellano en la web ]  [  Notes en catala a la web ]

It shows around this date entries/posts in the past (if they exist). It is highly customizable. By default it retreives a week around the current day 1 year ago.

**IMPORTANT**: If your sidebar supports the new Wordpress Widgets, you might better use the "Around this date in the past... - Widget Edition" plugin.
Check-it here:
[ http://wordpress.org/extend/plugins/plugin/around-this-date-in-the-past-widget-edition/ ]  

	
== Installation ==

1. Once downloaded the file, change the file extension from .phps to .php
2. Upload it through FTP to the server where your Wordpress blog is hosted.
3. Copy it to the folder /wp-content/plugins/ .
4. Activate it through the plugin management screen.
5. Introduce the funtion <?php around_this_date(); ?> (with or without parameters) wherever you want to show the X years ago entries.


== Frequently Asked Questions ==

None yet

== Screenshots ==

1. This screenshot shows the output of <?php around_this_date(); ?> on my blog.

== Usage ==

Place the function <?php around_this_date(); ?> wherever you want to show the links. 

You can call to function with default parameters:

		<?php around_this_date(); ?>

Or configure it:

		<?php around_this_date ($before = 'One year ago... ', $after = '<br />‘, $daysbefore = '3', $daysafter = '3', $mode='1', $yearsago = ‘1′,  $limit = ‘5′); ?>
		or
		<?php around_this_date ($before = 'One year ago... ', $after = '<br />‘, $daysbefore = '3', $daysafter = '3', $mode='2', $lastxyears = ‘2′,  $limit = ‘5′); ?>
		or
		<?php around_this_date ($before = 'One year ago... ', $after = '<br />‘, $daysbefore = '3', $daysafter = '3', $mode='3', $sinceyear = ‘2004′,  $limit = ‘5′); ?>


== Configuration parameters ==

	$before = Code will show before links. Defaults to ‘This week last year…: ‘
	$after = Code will show after links. Defaults to ‘’
	$daysbefore = Days’ posts that will show before one year ago. By default ‘3' (3 days before)
	$daysafter = Days’ posts that will show after one year ago. By default ‘3' (3 days after)
	$mode = Select the mode that you want the widget to work. By default ‘1' (X years ago)
		Mode 1: get posts around this date from X years ago.
		Mode 2: get posts around this date for the last X years.
		Mode 3: get posts around this date since year X.
	$yearsago = It shows “X” years ago posts. By default ‘1' (1 year). ONLY IF MODE 1 IS SELECTED.
	$lastxyears = It shows posts por the last "X" years. By default ‘1' (1 year). ONLY IF MODE 2 IS SELECTED.
	$sinceyear = It shows posts since the year "X". By default ‘2005' (since year 2005). ONLY IF MODE 3 IS SELECTED.
	$limit = Number of posts to retrieve. By default ‘4'. 
	$none = Text shown when there are no posts. By default 'none'. 


== License ==
	
This plugin is released under the GPL license. See license.txt for details.


== Changelog ==

v.0.6.3 = Fixed a bug when calling get_old_posts().
v.0.6.2 = Fixed a bug when having  &amp; in post's title. Isolated repetitive code in its own function. Changes contributed by Mike Koepke. 
v.0.6.1 = Fixed bug when having quotes in post's title. Thanks to Mike Koepke for bug repporting and helping with fixing.
v0.6 = Added 2 new modes, last X years and since year X. 
	Corrected bug in $start_ago and $end_ago.
v0.5.2 = XHTML valid. Thanks to to Luis Pérez
v0.5.1 = Added the $daysbefore and $daysafter parameters.
v0.5.01 = Now the limit option works, for real ;)
v0.5 = First release. I decided to start on version 06 because of preserving version relation with “One year ago” plugin.

== Credits and Acknowledgments ==

This plugin is based on:
- "One year ago" plugin released by Borja Fernandez
[ http://www.lamateporunyogur.net/wp-plugins/one-year-ago/ ]
- "Wayback" plugin realeaased by Chris Goringe
[ http://code.goringe.net/WordPress/ ]
 
Thanks to  Borja Fernandez[  http://www.lamateporunyogur.net  ]  and  Chris Goringe  [  http://tis.goringe.net  ]  for writing those plugins and to Luis Pérez and Mike Koepke for their contributions.

== ToDo ==

Nothing else planed by now.