=== 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.7 Tags: archives Requires at least: 2.0 Tested up to: 2.1 Stable tag: 0.7 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, uncopress it and upload it through FTP to the server where your Wordpress blog is hosted. 2. Copy it to the folder /wp-content/plugins/ . 3. Activate it through the plugin management screen. 4. Introduce the funtion (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 on my blog. == Usage == Place the function wherever you want to show the links. You can call to function with default parameters: Or configure it: ', $daysbefore = '3', $daysafter = '3', $mode='1', $yearsago = '1'′, $limit = '5', $none= 'none', $showdate = '0', $dateformat = 'y', $showexcerpt = '0'); ?> or ', $daysbefore = '3', $daysafter = '3', $mode='2', $lastxyears = '2'′, $limit = '5', $none= 'none', $showdate = '0', $dateformat = 'y', $showexcerpt = '0'); ?> or ', $daysbefore = '3', $daysafter = '3', $mode='3', $sinceyear = '2004'′, $limit = '5', $none= 'none', $showdate = '0', $dateformat = 'y', $showexcerpt = '0'); ?> == 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'. $showdate = Show dates next to the links. ('0' or '1', by default '0', disabled) $dateformat = Format of the date displayed next to the links (if checked). See http://www.php.net/date $showexcerpt = Show the excerpt next to the links. ('0' or '1', by default '0', disabled). == Customize display == In adition to the options avaliable in the function you can highly customize the apearance of the output by using CSS. These are the classes avaliable: ul.atd-list {} // base list container. li.atd-year {} // Yearly headers. atd-yXXXX {} //yearly based class, eg. atd-y2006, atd-y2005 ... ul.atd-yearlylist {} // list container for each year around this date posts. li.atd-entry {} // list items containing each around this date posts. atd-yXXXX {} //yearly based class, eg. atd-y2006, atd-y2005 ... atd-mXX {} //montly based class, eg. atd-m01, atd-m02 ... atd-m12. atd-dXX {} //dayly based class, eg. adt-d01, atd-d02 ... atd-d31. atd-XXXXXXXX {} //date based class, eg. atd-20061205, atd-20050304 ... a.atd-entry-title {} // Link to the post. .atd-entry-date {} // span containing the date, if $showdate enabled. .atd-entry-excerpt {} // span containing the excerpt, if $showexcerpt enabled. == License == This plugin is released under the GPL license. See license.txt for details. == Changelog == v.0.7 = All displayed in a single list with yearly sublists. NEW Feature: display date and/or excerpt. NEW Feature: added CSS markup to allow maximum flexibility on display. v.0.6.3 = Fixed a bug when calling get_old_posts(). v.0.6.2 = Fixed a bug when having & 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 = NEW Feature: 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.