=== Countdown Timer ===
Contributors: fergbrain
Donate link: http://www.andrewferguson.net/2007/03/08/general-note/
Tags: countdown, timer, count, date, event, widget, countup, age, fun, time, international, i18n, countdown timer
Requires at least: 2.7
Tested up to: 3.0-alpha
Stable tag: 2.4

This plugin allows you to setup a series of dates to count to or from in terms of years, months, weeks, days, hours, minutes, and/or seconds.

== Description ==

Countdown Timer allows you to setup one or more dates to count down to or away from.

Events can be inserted into the sidebar, either manually or as a widget, or within posts and pages.

== Translations ==

= Using another language =

You'll need to modify your `wp-config.php` file. Open it up and look for the line: `define ('WPLANG', '');`

You'll want 'WPLANG', 'de_DE';`

Of course, you'll replace de_DE with the language extension that you want to use, unless of course you actually did want the German language translation.

 * Swedish translation: sv_SE
 * Spanish translation: es_ES
 * German translation: de_DE
 * French translation: fr_FR
 * Portuguese [Brazil] translation: pr_BR
 * Turkish translation: tr_TR
 * Czech translation: cs_CZ
 * Dutch translation: nl_NL
 * Chinese translation: zh_CN
 * Polish translation: pl_PL
 * Italian translation: it_IT
 * Bosnian translation: bs_BA
 * Hungarian translation: hu_HU
 * Norwegian translation: nb_NO
 * Latvian translation: lv_LV
 * Romanian translation: ro_RO
 * Russian translation: ru_RU
 * Danish translation: da_DK
 * Lithuanian translation: lt_LT
 * Serbian [Cyrilic] translation: sr_RS


== Installation ==

If you can, use the automatic WordPress installer/upgrader.

Otherwise, delete any previous version of Countdown Timer and associated files.

Download and install the timer into your plugins directory.

Activate the timer and add the widget.

If you don't want to use the widget, you can also add the following code into your sidebar.php file:

`<li id='countdown'><h2>Countdown:</h2>
<ul>
<?php function_exists('fergcorp_countdownTimer')?fergcorp_countdownTimer():NULL; ?>
</ul>
</li>`

= Inserting countdown timers into a page or post =

If you want to insert the Countdown Timer into a page or post, you can use the following shortcodes to return all or a limited number of Countdown Timers, respectively:
[fergcorp\_cdt]
[fergcorp\_cdt max=##]

Where ## is maximum number of results to be displayed - ordered by date

If you want to insert individual countdown timers, such as in posts or on pages, you can use the following shortcode:

Time until my birthday:
[fergcorp_cdt_single date="ENTER\_DATE\_HERE"]

Where "ENTER_DATE_HERE" uses PHP's strtotime function and will parse about any English textual datetime description.

= Limiting the number of countdown timers displayed =

If you're using the widget, there is an option to set the maximum number of timers shown. If you are using the PHP code, replace

`fergcorp_countdownTimer()`

with

`fergcorp_countdownTimer(##)`

where ## is the maximum number of events you wish to be displayed.

Events are automatically sorted by date of occurrence.

= Changing the font, size, and style using CSS =

Starting with version 2.4, you can makes changes to the apperance of Countdown Timer display using CSS.

The following CSS classes are availible:

 * `fergcorp_countdownTimer_event_li` styles each List Item, each item encompases one countdown event
 * `fergcorp_countdownTimer_event_title` styles the title of the event
 * `fergcorp_countdownTimer_event_linkTitle` styles the title of an event if it is linked
 * `fergcorp_countdownTimer_event_time` styles the actual countdown timer

== Frequently Asked Questions ==

= Your program is broken! The count down is off by XX days! =

Well, not quite. As it turns out, determining the number of months between two dates is harder than one might think. As you know, all months don't have the same number of days. Thus, some months have 31 days, others have 30 days, and then there's February. It's pretty trivial to figure out the number of complete months between two days (if complete months exist).

However, how many months exist between January 15 and February 20? There are 36 days, which is obviously more than the number of days in any given month we have, so the timer should display 1 month and how many days? Six days (30 days/month)? Five days (31 days/month)? Eight days (28 days/month since the date does end in February)?

I happened to mention my problem to a friend who said that the US military decided that there were 30 days in every month and to prorate the the addition day (or less day(s)) for all the months that have more (or less) than 30 days.

= Wait, so how /do/ you count months? =

Using the above example of January 15 to February 20, there would be one month and five days. February 15 to March 20 would also be one month and five days. Why? January 15 to February 15 is one month. February 15 to February 20 is 5 days. Put them together and you get one month and five days.


= Where I am supposed to set the count down time? =

Log into your WordPress Dashboard. Expand the Tools menu, click on Countdown Timer. Scroll down to One Time Events. In the dates field, type the date you want to count down to. Fill in the event title field with what text you want displayed. Click Update Events.

= There's a foreign (non-English) word that's wrong, what do I do? =

There are two ways to fix this. First, you can always contact me via email, blog comment, support forum, etc and let me know about the error. I don't usually issue bug fix updates just for language errors, but it will make it into the next update cycle.

Second, if you're handy with poEdit or something of the like, you can make the changes yourself and email me the .po and .mo files (although I really only need the .po file).

= How come there are long periods of time when you don't respond or update the plugin? =

I'm an engineer and have to retreat to my cave from time to time. Also, I do this for fun. That means work must come first (unless you want to pay be, then we can talk).


== Screenshots ==
1. Administration Interface
2. Example on Blog

== Changelog ==

= 2.4 =
Release Date: 4/2/2010:

 * Updated file structure, moving language files to the /lang directory and javascript files to the /js directory, also updated associated links
 * Added latches for CSS
 * Rewrote parts of fergcorp_countdownTimer_format to make it less repetitive. Also removed last three variables: displayFormatPrefix, displayFormatSuffix, and displayStyle
 * Completely moved namespace from afdn to fergcorp
 * Changed the way dates are removed. Made it based on the lack of a date, instead of the lack of a title. 
 * Reduced the user access level to Options Manager instead of Administrator
 * Moved the options page from tools to settings in the admin menu
 * Implemented the register_setting function, incidently changing the way options are stored
 * Added option to parse shortcodes in the_excerpt
 * Updated all the lanuages files using Google Translate and http://pepipopum.dixo.net/index.php
 * Use the get_option directly instead of by variable
 * Removed checkUpdate variable because we don't use it anymore.
 * Updated to use _n i18n function
 * Updated depreciated get_settings to get_option

= 2.3.5 =
Release Date: 2/17/2009:

 * Updated calculation routine to ensure that dates are accurate when “Months” are not displayed.
 * Updated languages and added Latvian, Romanian, Russian, Danish, Lithuanian, and Serbian.
 * Updated readme.txt file
 * Fixed small display issue in the administration menu

 = 2.3.1 =
Release Date: 11/20/2008:

 * Fixes a bug. Sorry to everyone who has to redownload.

 = 2.3 =
Release Date: 11/19/2008:

 * Made meta boxes into WP-based functions with AJAX support
 * Renamed $dates to $fergcorp_countdownTimer_dates and made it global
 * Reversed order of afdn_countdownTimer parameters. See documentation for usage
 * Updated meta boxes to work in WP 2.7
 * Removed the option to disable enableTheLoop (i.e. always enabled now)
 * Added shortcodes. See documentation for usage
 * Updated some of the text so that links are not part of the translation. Not that this has been an issue, but it assures that links aren’t tampered with in language translations
 * Updated the widget to use the latest WP functions
 * Widget now has a description
 * Internal versioning is now done automatically
 * Fixed a bug where “No Dates Present” would not display, even though there were no dates present
 * Fixed a bug where an empty array would cause plugin to crash
 * Fixed a problem that caused the timer to only display “in ” if “strip zeros” is enabled
 * Updated a couple function checks to check for the functions that we’re actually using
 * Updated the plugins_dir function call to properly reference the countdown-timer directory (this fixes issues with IIS and Windows)
 * Added a helper function for afdn_countdownTimer so that users can use fergcorp_countdownTimer instead
 * Fixed a potential bug (aka The Furton Fix) for systems running Windows where PHP may barf and give a warning:
Warning: date() [function.date]: Windows does not support dates prior to midnight (00:00:00), January 1, 1970 in afdn_countdownTimer.php on line 612
 * Various bug and security fixes
 * Paypal link doesn’t use a form anymore
 * Added a test to ensure cal_days_in_month function exists. If not, use a drop in replacement.

 = 2.2.5 =
Release Date: 9/23/2008:

 * Added Hungarian and Norwegian translations
 * Fixed small bug on line 426 regarding stripslashes

= 2.2.4 =
Release Date: 9/4/2008:

 * Added Bosnian language translation
 * Fixed mistranslations in German language
 * Output of displayFormatPrefix/displayFormatSuffix are now escaped
 * Fixed a fatal error that was sometimes caused when there were no dates to countdown to
 * Updated the FAQ

= 2.2.3 =
Release Date: 7/9/2008:

 * Fixes language issue with commas
 * Updated internal rev version number

= 2.2.2 =
Release Date: 6/30/2008:

 * Resolves #876 which had <? instead of <?php
 * Resolves #879 which was an incorrectly passed fergcorp_countdownTimer_fuzzyDate function
 * Globalized $fergcorp_countdownTimer_getOptions in the afdn_countdownTimer function
 * Added spaces to the end of all units of time

= 2.2.1 =
Release Date: 6/18/2008:

 * Fixed bug where Countdown Time Display didn’t function properly
 * Added Italian and Polish translations, updated others

= 2.2 =
Release Date: 5/15/2008:

 * Updated some phrases that missed being i18n
 * Updated i18n to use use sprintf’s to assist in proper translation
 * Update the admin page to WordPress 2.5 Look and Feel
 * Users are now able to define the data (text/HTML) that comes after the title and before the actual countdown
 * Implemented a new function, fergcorp_countdownTimer_single($date), that allows users to create a one-off event outside of The Loop. $date should be PHP strtotime parseable string
 * Plugin output is now XHTML 1.0 Strict compliant
 * Scripts are now loaded using wp_enqueue_script
 * Added a new JS file, webtoolkit.sprintf.js, because JS doesn’t have native sprintf support
 * Translators names (and URL, if available) are now displayed/credited within the plugin
 * Tweaked the table for the “Resources” area
 * Tweaked the table for the “One Time Events” area
 * The usual bug fixes

= 2.1.1 =
Release Date: 2/20/2008:

 * Fixed i18n translation issues where mo file would sometimes not be loaded
 * Updated UI (note: Based on UI code from Google XML Sitemaps)
 * Removed code dealing with recurring events (which has not been included for a few versions now)
 * Added js countdown ability to admin example (which doesn’t have wp_footer hook?)
 * Updated the link to the JS file to make it dynamic in case a folder gets renamed
 * Fixed a bug in the JS file that caused dates to be calculated incorrectly
 * Append a letter to the beginning of the unique id (as per XHTML requirement)…who knew?
 * Added two language files: Swedish (thanks to Mattias Tengblad) and Spanish (thanks to Google Translator)
 * Released as 2.1.1 instead of 2.1 due to a technical glitch in the way WordPress recognizes version numbers.

= 2.0.1 =
Release Date: 12/29/2007:

 * Bug in the initial 2.0 version that required the plugin to have PHP5 or greater. This has now been fixed and it works with PHP4 and PHP5. Thanks to Jim Lynch for the bug report.

= 2.0 =
Release Date: 12/29/2007:

 * Updated plugin description line
 * Rearranged text in the installation notes to emphasize using the widget rather then the code
 * Fixed a bug that crashed the plugin if no dates were present (a PHP 5 problem??)
 * Implemented the ‘register_activation_hook’ function rather then the old way
 * Changed the way DB updates are handeled. Instead of having a specific update regimine for each version, the plugin will only update an option field if it doesn’t exist (if it exists, but is blank, it will NOT update…as it shouldn’t).
 * Updated fergcorp_countdownTimer_fuzzyDate with another variable so that the real target date is always known.
 * Removed code dealing with updates since WP 2.3 now does this automatically
 * Bug fix. Widget title isn’t saveable due to a programming error. Thanks to Michael Small for the catch.
 * Renamed some functions from afdn to fergcorp
 * Added JavaScript function for JS countdown
 * Tabbed $afdnOptions array to make it more readable
 * Fixed strtotime typo
 * Brought time display inline with current WordPress practice. This fixes the dreaded timezone glitch.
 * Strip non-sig zeros option added
 * Fixed bug where “No dates present” would _not_ show if the data was returned instead of echo’d
 * Renamed to $getOptions to $fergcorp_countdownTimer_getOptions to avoid clashing

= 1.91 =
Release Date: 12/4/2007:

Fixed error where the widget wasn’t updated correctly.

= 1.9 =
Release Date: 8/7/2007:

 * One-off countdown timers (i.e. standalone timers for posts, etc)
 * Ability to customize timer style
 * Added “week” as a unit of time
 * Even more bug fixes including the one where if the plugin was in a directory other then the plugin directory, it really wouldn’t work.

= 1.8 =
Release Date: 5/7/2007:

 * Note to Existing users: Version 1.8 sees the demise of recurring events.
 * Built in widget! No need to download and activate another plugin!
 * Ability to select any combination of years, days, hours, minutes, and seconds to display
 * Internationalization support
 * Default settings automatically set on activation
 * More accurate countdown mechanism (you wouldn’t think counting could be so hard)
 * Numerous bug fixes
 * Reorganized management page

= 1.7.3 =
Release Date: 4/29/2007:

 * Fixed missing tag
 * Fixed form not submitting in IE, Safari, et all
 * Fixed “pressing return key doesn’t submit form” bug

= 1.7.1 =
Release Date: 3/9/2007:

 * “No Dates Present” bug fix
 * Updated Plugin URI to be correct
 * If updates are checked for, a link to the latest tag is given instead of the trunk (guaranteed to be stable)
 * Added Widget plugin
 * foreach error fixed (Thanks to Johnathan)

= 1.7 =
Release Date: 3/9/2007:

 * Note: You may “lose” your date when you upgrade, so you might want to write them down. If you forget to write them down, just downgrade to 1.6.1 and write them down, then upgrade again.
 * On update, color bar is displayed at top
 * Fixed a bug where HTML characters were not escaped
 * Prefixing and Suffixing of the event
 * Added more information on usage on the plugin page

= 1.6.1 =
 * Fixed the famed unserialze bug!

= 1.4 =
Release date: 03/16/2006

This is the first release using the WordPress SVN. It’s kind of been cool using the SVN because it is easier to see what changes have been made from version to version. In any event, this release has a couple of updates. First, there is an option to include the timer from within the WP Loop, that is you can now display the timer from within a post or page (see instructions for the specifics). The idea came from Ronny a mere four days ago, just to give you an idea of the turn around time on suggestions to release. Because of the way the plugin is implemented, I also had to modify the main function that gets the ball rolling on displaying the timer. It’s designed to be backwards compatible, so you shouldn’t have any problems. I also had to rewrite parts of the version check system to work with the SVN. The format is actually much better and just calls one text file which lists the latest version (i.e. “1.4?). It compares that to the current version and let’s you know if there’s a new version. Simple! As always, you can turn the feature off.

= 1.3 =
Release date: 03/16/2006:

I’ve already received some preliminary feedback on 1.2 (thanks Dave), so I’ve made a couple of updates. First, there are actually instructions for configuring the onHover Time Format option. Second, if you leave onHover Time Format blank, it will remove the dashed underline on the timer so no one is confused. I also fixed a really stupid bug, I never but a stripslashes in. So if you tried using something that needed escaping (such as an apostrophe), you would get a slash. That doesn’t happen anymore. Enjoy!

= 1.2 =
Release date: 03/13/2006: 

Development has been slow. Not really a lot to do. But version 1.2 offers some great things, including a bug fix! Deleting two or more events doesn’t make the plugin freak out anymore (the bug fix). You can also customize how the onHover time is displayed, including not displaying it at all (just leave it blank). Because you can leave it blank, there is no default; but you can use and PHP “date()” format. I recommend “j M Y, G:i:s”. I also added a six month delay before the date on recurring events is reset…although as I’m writing this, I realize there’s a slight bug there, nothing critical though. I welcome any new ideas, just leave a comment down below!

= 1.1 =
Release date: 11/28/2005:

NOTICE: Copyright format changed from MIT to GNU GPL as of version 1.1
Not a whole lot of major thing. Thanks to Benoit Kechid for catching a calculation and syntax error. There was a request for making things linkable, so you can now add a link an event. The time is also has a dashed underlined and if you roll over it with your mouse, the date and time of the event are displayed.
I don’t have anymore ideas for this plugin, so unless I you email me with something that you would like, there probably won’t be any more updates.

= 1.0 =
Release date: 10/05/2005:

You can now set recurring dates, sort of. The plugin can currently handle things that happen on a given day of a given month every year (such as a birthday). The plugin will also now check for updates whenever you are in the admin panel. Download and copy to your plugins directory, then rename it to .php

= 0.95 =
Release date: 09/26/2005:

Fixed a Warning message (thanks to cordney* for the heads up). Also changed a few things: If you have “Automatically delete ‘One Time Events’ on, only events that that do NOT have “Display ‘Time since’” will be deleted. Also, the file is now a PHPS file, not zip file. Download and copy to your plugins directory, then rename it to .php

= 0.92 =
Release date: 09/23/2005:

This version adds the option to automatically delete One Time Events that have all ready occured. If you don’t choose to automatically delete the events, they will be displayed as “Time since” after the event occurs. Small issue I’m still working on: events are only erased when you update timer options.

= 0.8 =
Release date: 07/23/2005:

This is a backend change. The dates.txt file has been replaced with an entry in the WordPress Database. Unfortantly, you’ll have to manually transfer your events into the new form. Once they are in the form, they are automatically sorted, with events ending soonest on the top.

= 0.7.1 =
Release date: 05/23/2005:

Changed an internal function name reference due to a potential conflict with another plugin (Thanks Robert)

= 0.7 =
Release date: 05/20/2005:

Added Admin menu. Allows user to update information via web-interface now.

= 0.6.1 =
Release date: 05/16/2005:

Fixed small math error in cdt_format() on line 47.

= 0.6 =
Release date: 05/15/2005:

Initial public release

== Upgrade Notice ==
= 2.4 =
General updates to increase stability and user experience. Also added CSS hooks.