=== Event Calendar 3 for PHP 5.3 === Contributors: Alex Tingle (PHP 5.

3 update by Stig Ulfsby) Donate link: http://www.amazon.co.uk/gp/registry/1S44DP6XXOFIN Tags: calendar, event, events, vcalendar, icalendar, ical, ajax, widget, sidebar Stable tag: 3.1.5 Requires at least: 1.5 Tested up to: 3.0.4 License: GPL Manage future events as an online calendar. Display upcoming events in a dynamic calendar widget or list widget. == Description == Manage future events as an online calendar. Display upcoming events in a dynamic calendar widget or list widget, or as posts on an event category page. You can s ubscribe to the calendar from iCal (OSX) or Sunbird. Choose one WordPress category as the 'event' category, and then add posts for dates in the future. Add the calendar or event list functions to your template, or just use the 'Event Category' page to list your forthcoming events. This is an update of Event Calendar 3 to work with PHP 5.3. EventCalendar works fine with WordPress v3.0. = Features = * * * * * * e Events are ordinary posts or separate posts not shown on the blog page. Each event can have multiple dates The dates can be shown in a box on the post Widget showing calender with events marked. Widget listing future events Event posts are assigned an event category and can be listed on a category pag

[Full Documentation](http://wpcal.firetree.net) == Installation == Before you start, make sure that you have at least MySQL v4. = 1. Upload to your plugins folder, usually `wp-content/plugins/` = The plugin is in the form of a directory called 'eventcalendar3'. = 2. Activate the plugin on the plugin screen. = Don't try to view your blog yet. First you must... = 3. Change settings on the "Options > Event Calendar" options screen. = You must choose which WordPress category to use for events. (Viewing the options screen for the first time also sets up the database, and upgrades events from older versions of EventCalendar.) [Details](http://wpcal.firetree.net/options)

= 4. Add the Event Calendar or Upcoming Events list to your sidebar. = If you use the WordPress Widgets, then the Event Calendar is available as an easy to install widget. In order to use it you must first activate the 'Event Calendar Widget' plugin. If you use the K2 template then the Event Calendar is available as a sidebar module. Otherwise, you need to make a small adition to your template. Add the following code to your sidebar.php: Event Calendar: <li> <?php ec3_get_calendar(); ?> </li> Upcoming Events: <li>Events <?php ec3_get_events(5); ?> </li> If you are using an older template, then you should check that your HTML header contains the following tag: `<?php wp_head(); ?>` Caution: The Event Calendar must be unique. If you try to show more than one calendar on a page, then only the first will be displayed. [Details](http://wpcal.firetree.net/template-functions) == How to make an Event Post == An event post is a normal blog post, with one or more attached events. On the 'Write Post' page, scroll down and you will see the 'Event Editor'. You might need to click the little '+' in its blue bar, to see the controls. To start with, you will only see the column headings (Start, End and All Day) and the '+' - add event button. Click '+' to add a new event. The event will start and end on the next full hour. To set the start date, click on the '...' button, next to the start time. A popup calendar will appear. Select the new start date by clicking on the calendar. Optionally you can change the time by clicking on the popup's time and dragging. Click on the 'X' to dismiss the popup. You can also edit the date and time in the normal way, by clicking on the numbers and changing them with the keyboard. If you edit the date manually like this, make sure that you keep to the correct format: YEAR-MONTH-DATE 24-HOURS:MINUTES Example: An event is scheduled from 2-4pm on 14th August, 2006. Start: 2006-08-14 14:00:00 End: 2006-08-14 16:00:00 When you change the 'Start' field, the 'End' field updates automatically, so that the event's duration remains the same. If you want to change the duration, then edit the 'End' field, just as you did for the 'Start'.

If you tick the 'All Day' checkbox, then the times are ignored - the event goes on through the whole day. You can make the event span over more than one day if you wish. You can also add more scheduled times for the same post. Just click the '+' button to add more lines. To remove an event, click on the '-' button. When you've finished editing your events, just Save the post in the normal way. == New Features in v3.1 == This is a significant re-write. Event dates are now kept in their own table, so they are separate from the post date. There is a new Ajax interface on the post edit screen that allows you to set the event date. o Event dates are shown in their own little box at the beginning of event posts. o Multi-day events are now supported. o Timezones are properly supported, so eveything works properly for those unforturnate people who don't live in the GMT timezone. o Translations are now available in the following languages: ca_ES cs_CZ de_DE dk_DK es_ES fi_FI fr_FR hu_HU it_IT mk_MK nb_NO nl_NL pt_BR ro_RO ru_RU sl_SI sv_SE tr_TR Catalan (by Vicent Cubells) Czech (by Michal Franek) German (by Marc Schumann) Danish (by Simon Bognolo) Spanish (by Maira Belmonte) Finnish (by Ralf Strandell) French (by Davy Morel & Jrme aka Comme une image) Hungarian (by Elbandi) Italian (by Jimmi) Macedonian (by Vanco Ordanoski) Norwegian (by Realf Ording Helgesen & Stig Ulfsby) Dutch (by Gerjan Boer & P. Mathijssen) Portuguese (Brazil) (by DJ Spark) Romanian (by Sushkov Stanislav) Russian (by Ivan Matveyev) Slovenian (by Damjan Gerli) Swedish (by Anders Laurin) Turkish (by Firat Cem Tezer & Roman Neumller)

If you would like to make a new translation, then just make a copy of the file getttext/ec3.pot, and add your translated text. You can use the existing .po files as an example. == Screenshots == 1. The (AJAX) Event Calendar and Upcoming Events widets. 2. The AJAX Event Calendar has nicely formatted popups. 3. The Event Editor on the Write Post page. 4. Event Calendar options page.

== Changelog == = 3.1.5 (2011-02-05) = * Updated to work with PHP 5.3 * Updated norwegian language = 3.1.4 (2008-11-08) = This is the last version of Event Calendar 3 by Alex Tingle. == Upgrade Notice == If you are using PHP 5.3 or higher, the old Event Calendar 3 will corrupt your s ite. Event Calendar 3 for PHP 5.3 works. Since Alex Tingle no longer developes E vent Calendar 3, I had to make a new name of the plugin. == Note == Copyright (c) 2005-2008 Alex Tingle and others. The plugin can be used and distributed under the GPL licence. Some of this code was developed with the financial support of Stephen Hinton.