Event Calendar 3 for PHP 5.3
Manage future events as an online calendar. Display upcoming events in a dynamic calendar widget or list widget.
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 subscribe 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.
- 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 page
|Author||Alex Tingle (PHP 5.3 version by Stig Ulfsby)
|Contributors||Alex Tingle (PHP 5.3 update by Stig Ulfsby)|
|Tags||AJAX, calendar, event, events, ical, icalendar, sidebar, vcalendar, widget|
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.)
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.
- Updated to work with PHP 5.3
- Updated norwegian language
This is the last version of Event Calendar 3 by Alex Tingle.
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 Catalan (by Vicent Cubells) cs_CZ Czech (by Michal Franek) de_DE German (by Marc Schumann) dk_DK Danish (by Simon Bognolo) es_ES Spanish (by Maira Belmonte) fi_FI Finnish (by Ralf Strandell) fr_FR French (by Davy Morel & Jérôme aka Comme une image) hu_HU Hungarian (by Elbandi) it_IT Italian (by Jimmi) mk_MK Macedonian (by Vanco Ordanoski) nb_NO Norwegian (by Realf Ording Helgesen & Stig Ulfsby) nl_NL Dutch (by Gerjan Boer & P. Mathijssen) pt_BR Portuguese (Brazil) (by DJ Spark) ro_RO Romanian (by Sushkov Stanislav) ru_RU Russian (by Ivan Matveyev) sl_SI Slovenian (by Damjan Gerli) sv_SE Swedish (by Anders Laurin) tr_TR Turkish (by Firat Cem Tezer & Roman Neumüller)
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.
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.