WordPress.org

see also the plugin website Troubleshooting

How can I control the output of this plugin?

Simplest: Put [iCal http://yoururl.ics] in your page or post. A Default List Type will be used.

To combine calendars ala Google style, for example including a public holiday calendar, separate the URL's with commas. [iCal http://yoururl.ics http://anotherurl.ics]

To specify another listtype defined in the admin section, add a "listtype=N" where N is the number of the list type that you want. [iCal http://yoururl.ics listtype=2]

To list a series of calendars -eg: a different calendar for different groups or classes in sequence: [iCal http://yoururl.ics] [iCal http://anotherurl.ics] Remember to add css for the extra calendars.

You can of course have content text between the iCal shortcodes.

The admin section (or if wanting to operate standalone - see the Ical_common file.) allows control over many aspects: * the components to include (eg: todo's ) * the component properties, their layout and sequence. Eg select end times, or durations (or both!) * the grouping (we used to just do a monthly grouping, no we allow for many others )

and many more - see the settings page in the wordpress admin section.

What css tags are there?

There is enough css to work out the box, however if you want to style it further, then each iCal field has it's own li class. Plus there are additional derived classes such as * .addtogoogle * .addevent * .icsurl This is not a complete list, please view page source for more. * .alt - alternate rows * .map - to style or hide the map link to google maps * .group - to style any grouping level lists, * .Month, .day etc - if that grouping was chosen * .MonthMMMYY - to style individual groups * .amrcol - to style a subset of event properties * .untimed * .recur - repeating events ...

Why different css tags for widget and page calendars?

Well, if the widget and the calendar happen to occur on the same page then the page will not validate. And Of course allowing for multiple calendars on a page was also tricky!

Can it handle html in the descriptions?

Yes it can - note that google seems to allow you to enter and save html, however if one goes back to edit it, it appears to through the html tags away.

Please check your google file before assuming it is a plugin problem.

How often is the calendar checked for new events?

Specify in the admin menu configuration a refresh period or cache value in hours. Loading calendars too frequently can get your server banned, so use your best judgment when setting this value. The cache will refresh using the same filename. If cached file is older than the cache value on the next request, then it will get the file again. It will also refresh the file if the refresh icon is clicked on the calendar page.

Where can I find iCalendar files?

There are many iCalendar sources, such as:

• Apple's iCal library
• iCalShare
• Google Calendar

My server does not support `fopen` on URLs. Can I still use this plugin?

As of version 1.9, this plugin supports usage of cURL via WordPress' wp_remote_fopen function. Previous versions required the url-cache plugin for cURL support, but this is no longer the case.

Event url's?

The ical spec allows for a event URL. Often there is not one in the ics file. The plugin attempts to provide as much information as possible, as compactly as possible, especially when used as a widget. So for example, it provides the description as link title on a link behind the summary field. (Usually a widget would not show the description field).

So for listtype 4 only, If there is no URL, and NO default url in the admin configuration(eg: full calendar page) has been specified, then the Plugin will generate a dummy bookmark, with info cursor style and event description as hover text/title. The dummy bookmark is to stop the page reloading and to make the link non-active. All code validates.

If you wish the same behaviour for other liststypes, you can enter either a good URL in the default event iurl field in the admin settings, or a dumjmy bookmark like "#noeventurl".

Support for more of Ical?

There is partial support for all the ICAL components and properties.
Allowance has been made to potentially support all features. You will notice this particularly in the Admin section. However since this is a single volunteer effort at this stage, the key areas that may be used have been targeted. If you find that a particular implementation is needed for your website, contact me and we can discuss the possibility of including it.

For example: Change Management Fields are not parsed The PHP timezone definition is used. Any TimeZone definitions component and subcomponents if specified are not parsed and used. However the timezone of your calendar and of any item is noted and the time duly calculated with that timezone.