Frequently Asked Questions

Support for the WordPress Calendar plugin
User avatar
Posts: 2069
Joined: Sat May 26, 2007 1:55 pm
Location: London

Frequently Asked Questions

Unread post by Kieran » Sun Apr 20, 2008 4:35 pm

Q I get 404 errors
A This issue has been fixed in the new version. Please upgrade.
Q I can't add events in the admin panel. I use IE6.
A This issue has been fixed in the new version. Please upgrade.
Q My .htaccess file keeps getting over-written
A .htaccess modifications are not required in the new version. Please upgrade.
Q How do I put upcoming/todays events in my sidebar? I've enabled them in the admin panel but I can't see them.
A This is because you need to ensure they are visible in your theme first.

To do this under WordPress 2.8 there are a pair of widgets that you can add to your side bar in the admin panel. Position them how you want.

Under WordPress 2.0 or where your theme does not support widgets you need to modify the sidebar.php file of your theme to include the following code as appropriate:

Code: Select all

<?php echo todays_events(); ?>
<?php echo upcoming_events(); ?>
Q How do I place an instance of calendar in a post or page?
A You need to place the tag {CALENDAR} someplace in the post or page using the editor. This tag will be replaced with an instance of Calendar when the page is viewed.
Q The calendar doesn't look right with my theme. How can I fix this?
A Unlike the days of version 1.1 you shouldn't find version 1.2 overflows your theme or anything like that, but you might find the font size unsuitable or that the colours aren't appropriate.

If this is the case you can use the Calendar options page to modify the CSS. Every element of Calendar has a CSS class, and different types of table cell (with a day, without etc) have their own CSS class also. These are detailed in the default CSS style sheet.

I cannot help you to make alterations to these yourself, but any online guide concerning CSS should be able to help you with this.
Q I've added the todays events and upcoming events widgets (or functions in the case of WordPress 2.0) to my sidebar and switched on the features in the config screen but still can't see them in my sidebar. What is going wrong?
A Are you sure you have added any events or that ones you have added are in the future or today? The todays events widget only shows if there are events today and the upcoming events widget only shows if there are events in the number of future days as specified in the configuration screen.
Q I've allowed a user group other than admin to manage events but now they can see and modify the events created by admin.
A This is intentional. Many people requested that they wanted users other than admin to be able to manage events and this is what this feature allows. You must of course trust the group of users you grant access to do sensible things. If they are not doing sensible things, you might want to review their ability to access the manage events screen by changing the user group that can do this.
Q I deleted a user but events they had added are still showing but as the admin user.
A This is normal. It was reasoned during development that because events are usually useful to everyone, the deletion of a user doesn't mean that you necessarily want events they added to be deleted also. Because events now have to be associated with a user, deleting a user who added events causes their events to be allocated to the admin user. If you don't want these events anymore then you have to manually delete them. You might find it easier to do this while the user is still active because you will be able to see their events more clearly on the manage events screen.
Q I had nice pretty links on version 1.1 which were easy to navigate. Where have they gone in later versions?
A Over 80% of support questions had to do with users not being able to setup their .htaccess file correctly to enable pretty links. Because only pretty links were allowed this prevented them from using Calendar.

I've taken a step in the opposite direction with the later releases and removed pretty links entirely. This permits a one-click install for users. Those with experience will be able to modify the plugin slightly and add .htaccess rules to re-enable pretty permalinks.

Sadly for those that liked the links but don't know how to re-enable them you are out of luck. I don't code this plugin for profit and so I had to think of the time I was spending on support questions rather than features in this particular case. I like pretty links and use them on all my sites, but they are non-trivial to setup and I don't want to be giving lessons every day on what to do rather than getting on with my own work. Sorry.
Q Can I remove the link to your website from underneath the calendar?
A Yes. Calendar is released under the GPL which permits you to copy, modify and redistribute the plugin as you see fit after you have downloaded it. So long as credit to me, Kieran O'Shea, is maintained within the source then you can remove the link and make any other changes you want.

Please be aware however that I will only provide support to users who's calendar (or site footer) is sporting the link to my website.
Q How can I change the day the week starts on?
A Calendar conforms to the main WordPress setting as to what day the week starts on. If you go to the settings area of the WordPress admin panel and change what day the week starts on in there, Calendar will change also.
Q I've enabled categories but am confused as to how they work. Can you help?
A When you install Calendar you will note that there exists one category, entitled "General" into which all new events are placed. If you enable categories you will notice that events suddenly show up highlighted in the same colour that the "General" category is set to and that a key denoting the name of the category and its colour shows up below the calendar. This means that if you create a new category with a different name and colour and place event(s) into it they will show up in the new colour. This allows you to see easily what type of events are scheduled.
Q Why can't I delete the "General" category?
A Since the introduction of categories each event must be placed in a category. For this reason you are prevented from deleting the "General" event category so that events always have at least one category in which to sit. You can however change the name and colour of the "General" category to suit your site or turn off categories completely. Note that turning off categories will not prevent the display of the category in which an event sits in the admin panel, it will merely obliterate all references to categories on public instances of Calendar.
Q Can I make event titles/mouse-overs links?
A Yes. You simply need to fill in the full URL (including the http:// bit) in the field entitled "Event Link (Optional)". This will then turn the event title into a link to the URL of your choice. Leaving this field blank will disable the feature for the event.
Q Why are categories disabled by default?
A This is mainly for people who are upgrading. Because there is only one category by default, enabling them immediately upon upgrade would result in upgraders suddenly seeing all their events (perhaps hundreds or even thousands) listed under the same type, which would look a bit silly. Disabling it by default allows non-interested parties to keep using Calendar the way they have and interested parties to put events in the right categories before enabling the category system.
Q I'm currently using Event Calendar and wish to change to Calendar. Why, when both plugins are activated (as I migrate), does only one plugin's upcoming events widget display?
A The issue here is that there is a naming conflict between the functions in the two plugins. Due to the fact the aforementioned calendar is no longer developed or supported by the author and users are unlikely to want to use two types of calendar at once, I will not be working around this issue. You should simply be aware that showing both widgets at once while you are migrating is not possible.
Q My theme was designed using Artiseer and the mouse-overs on Calendar are partially hidden in the sidebar. How can I fix this?
A Firstly you should install Atristeer or later as the issue should be fixed in this version. Secondly, if this version fails to fix the issue then you should find the CSS classes named as below (or similar) and remove the z-index attribute from them

Code: Select all

Thirdly, if you found yourself having to implement the above fix then don't ask for support - the problem is still with Atristeer and you should contact them about the issue. An update on their software and my support for it is posted here viewtopic.php?f=13&t=195
Q I see mention of a development version of Calendar. Where can I download this?
A The development version is Calendar as you know it along with ongoing fixes etc. that I've either already implemented and not released or am in the process of implementing. Some users find that a particular bug they have is already fixed in this version and so might wish to install it. It is available for download from WordPress on the following URL
Q I have no time on my events when I view them in the calendar, even though I entered one when I added my events. What is going on?
A Check to make sure that the form field is not blank on WordPress/GeneralSettings/DateFormat if you have set it to custom.
Q I've upgraded Calendar and my mouse-overs have gone all funny. How do I fix this?
A To bring Calendar into full compliance with W3C web standards, some changes were made to the HTML which in turn required some changes to the styles. In order to activate these new styles you will need to tick the box on the Calendar options page to repair the Calendar style. Be warned that if you have made style changes in the box, you will lose them - be sure to back them up so you can edit them back in after the restore.
Q I've authored a custom theme but when I include Calendar on a page the styles are missing and it looks odd.
A You've not called wp_head() in your theme's header and/or wp_footer() in your theme's footer. Add these calls and the Calendar will spring to life.