Displays years/months/days since, until, or between events. Great for tracking a pregnancy (with a bar graph!), time until an election, or whatever. U
As of v3.0 of the plugin, you MUST be running PHP 5 or higher. If you are using PHP 4 (or older), you need to use v2.3.4 of the plugin. You can get this older version at the download page.
None, this is a widget. If you are using pre-WP v2.2, you'll need to have WP the sidebar widgets plugin running. You also need to be using a widgetized theme. You can control all options for KB Countdown from the widgets administration menu.
If you want to use this plugin in a post/page or in your template somewhere, look in
kb_countdown.php for instructions.
No. You need to specify only a start date or an end date. But if you want to have a bargraph, you need to specify both.
If your start date hasn't happened yet or your end date has already passed, PERCENT_DONE will return 0 or 100 (respectively) and TIME_SINCE/TIME_UNTIL will say "0 days."
Override the default bargraph colors using the same red-green-blue system employed in CSS files, with one change. Instead of writing in hex (e.g. #ff00ff) write numerals between 0 and 255, separated by commas without spaces (e.g. 255,0,255). Even if you aren't familiar with this system, you can probably find colors that you like by just tinkering with the numbers. The first number gives you more red, the second is green, the third is blue. Red, for example, will be 255,0,0. And for gray, set all three numbers equal (e.g. 100,100,100).
You may override this manually. Look at the top of the kb_countdown.php file for a setting.
Only if you use an iCal file. Read on...
Absolutely, as of version 3.1 of the plugin. You will also need the iCal Events plugin installed and activated, since it does the iCal processing. From the widget's control panel, look for a button that says "multi-date mode."
In iCal mode, you can only count down (using the _UNTIL tags), not up (with the _SINCE tags), and you can't use any bargraphs.
In addition to the counting tags discussed above, you can also use the following event tags: SUMMARY, DESCRIPTION, LOCATION, MONTH, DATE, YEAR. These tags will be replaced with corresponding information from the iCal file. Usually, SUMMARY is the event's title. An example of what you could write in the "message" box:
SUMMARY (MONTH-DATE-YEAR) will happen in TIME_UNTIL.
Which might produce something like this:
Halloween (10-31-2007) will happen in 4 months and 7 days.
Fiddle around with it, you'll figure it out.
Contact the iCal Events plugin people.
You may ask questions by posting a comment to the KB Countdown plugin page.
Be advised: If you post your support questions as comments below, I probably won't see them. If the FAQs don't answer your question, you can post support questions at the KB Countdown plugin page on my site.