diff -r 53cff4b4a802 -r bde1974c263b web/wp-content/plugins/event-calendar/readme.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/web/wp-content/plugins/event-calendar/readme.txt Wed Feb 03 15:37:20 2010 +0000 @@ -0,0 +1,183 @@ +=== Event Calendar 3 === +Tags: calendar, event, events, vcalendar, icalendar, ical, ajax, widget, sidebar +Stable tag: 3.1.4 +Contributors: Alex Tingle +Donate link: http://www.amazon.co.uk/gp/registry/1S44DP6XXOFIN +Requires at least: 1.5 +Tested up to: 2.7 + +Manage future events as an online calendar. Display upcoming events in a dynamic +calendar, on a listings page, or as a list in the sidebar. + + +== Description == + +Manage future events as an online calendar. Display upcoming events in a dynamic +calendar, on a listings page, or as a list in the sidebar. 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. + +EventCalendar works fine with WordPress v2. It should also work with WordPress +v1.5. Reports of successes and failures are most welcome. + + [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: +
  • + +
    • + + Upcoming Events: +
  • Events + +
    • + +If you are using an older template, then you should check that your HTML +header contains the following tag: `` + +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 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) + 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. Post your file to the + [mailing list](http://penguin.firetree.net/eventcalendar) and we'll add it + into the project. + + +== 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. + + +== Planned features == + +Some enhancements haven't made it into this release, but they are planned for +the future. Look in the file TODO.txt for details. + + +== Note: == + +Copyright (c) 2005-2008 Alex Tingle and others. +License: GPL +Some of this code was developed with the financial support of Stephen Hinton.