WPListCal
WPListCal
Current Stable Version: 1.0.8.2
Current Development Version: 1.1b1
Requires WP Version: 2.5
Tested up to WP Version: 2.6.3
WPListCal allows you to list upcoming events on your Wordpress blog in a list or table format. It plugs straight into the Wordpress admin pages to let you keep track of events just like posts and pages. You can then list events on a page or post using a special tag, or incorporate events into your theme files using a PHP function call.
Version Guide
WordPress 2.7 or later → Use WPListCal 1.1b1 (development release, not yet stable)
WordPress 2.5-2.6.3 → Use WPListCal 1.0.8.2 (current stable release)
WordPress 2.0.3-2.3.3 → Use WPListCal 1.0.2
The Future
Through the comments below, I’ve gotten lots of feature requests and bug reports and I appreciate them. I’ll continue development on WPListCal whenever I have time.
On many occasions, I’ve said that version 1.1 will bring support for categories and some other interesting features. I’ve decided to push those features off to 2.0 since the switch to WordPress 2.7 is becoming more than just a sub-point release. Don’t worry though, you don’t have to wait for 1.2-1.9 before I do 2.0…I’ll probably just skip a bunch. This versioning scheme just made more sense than rev’ing the 1.0 tree over and over
Feature Requests
Here is a list of current feature requests that I’ve gotten (and that I remember). Post comments if you have more.
- RSS of events
- Recurring event support
- Categories
- Tags
- Media upload
- Import/export of events (iCal format, XML, others?)
- All day events
- Group events by day/month/year
- Sidebar Widget support
- Linking events to posts/pages
- Location field
- Calendar popup for entering dates
Installation
- Upload
wplistcal.phpto the/wp-content/plugins/directory
- Activate the plugin through the ‘Plugins’ menu in WordPress
Upgrade
- DO NOT DEACTIVATE THE PREVIOUS VERSION OF THE PLUGIN! Doing so could remove all your events.
- Upload
wplistcal.phpto the/wp-content/plugins/directory or any subdirectory - Deactivate and then activate the plugin in the ‘Plugins’ menu in WordPress
Usage
- Change the default settings on the WPListCal options page
- If you want to list your events on a page or post, insert the tag
<!--wplistcal-->in the body of the page/post - If you want to list your events somewhere in your theme files, insert
<?php echo wplc_show_events(); ?>. You can set special parameters to overwrite the default options if you use the PHP function call. All parameters are optional, but you must preserve the ordering by passing in `null` for options that you want to use defaults for.- Display Mode (string):
'list'or'table' - Event Format (string): The format of the list entries if Display Mode is set to
'list'. You can use the following variables: %NAME%, %LINK%, %LINKEDNAME%, %START%, %END%, %DESCRIPTION%. - Date Format (string): The format to display the start and end date and time. Uses the same date formatting that Wordpress uses.
- Max. Events (int): The maximum number of events to display, -1 for unlimited.
- Show Past Events (boolean): true to show all events, false to show only current and future events
- Maximum Advanced Notice (int): How many days in advance to display events, -1 for unlimited.
- Event Order (string): ‘asc’ to show the closest event first or ‘desc’ to show the furthest event first.
- Hide Same Date (boolean): Format the end date with the format string defined in the next parameter if it is on the same day as the start date.
- Date 2 Time Format (string): If Hide Same Date is enabled, use this format string for the end date.
- No Events Message (string): If there are no events, show this string instead, leave blank for none.
- Example:
<?php echo wplc_show_events('list', '%LINKEDNAME%: %START% - %END%<br />%DESCRIPTION%', 'M j, Y g:ia', -1, false, 30, 'asc', true, 'g:ia', 'Sorry, no events'); ?>
- Display Mode (string):
Frequently Asked Questions
- Where does WPListCal store events?
- On activation time, the plugin adds a table called <prefix>_wplistcal that stores all your events.
- What happens to my events when I deactivate the plugin?
- On deactivation, the events table is dropped, so if you want to save your event data, back up the table before deactivating the plugin.
- As of version 1.0.6, deactivation does nothing to your settings and events.
- Why is WPListCal different from other Wordpress calendar plugins?
- WPListCal is specialized to provide clean list or table based output for you to style or reparse any way you’d like. Other calendar plugins force you to use a gregorian calendar view which may be inappropriate for many applications.
- Does WPListCal work on WordPress 2.7?
- WPListCal 1.1b1 (development release) and later work on WordPress 2.7
- Does WPListCal work on WordPress 2.5?
- WPListCal 1.0.3 and later works on 2.5
- When I try to edit my options, I get an error: “Your attempt to edit your settings has failed.”
- Download WPListCal 1.0.3 or later.
- When I click edit on the manage page, I get the error: “Cannot find wplistcal.php”
- Download WPListCal 1.0.4 or later.
- I love WPListCal, but I’d like it to do _______.
- Great, I’m glad to hear feature requests. Just post a comment below.
- I love WPListCal and I’d like to buy you a beer to thank you.
- Awesome, thanks. Just click the big orange Donate button above
Changelog
1.1b1 (development release)
- Updated all styles and elements for WordPress 2.7
- Menus refactored to fit into the new WordPress 2.7 menu structure
- Dashboard now shows number of events published
- Added a location field
- Added widget support
- Refactored code into separate files
- More to come…
1.0.8.2 (stable)
- Removed a 2.7-only function that caused PHP warnings on 2.6
- Re-enabled media upload buttons since they now work right
1.0.8.1
- Fixed options page warning
1.0.8
- Fixed the visual editor (again)
1.0.7
- Added the option to use a different date format for the end date if the event starts and ends on the same day
- Added the option to display a message if there are no events to show
- Added the option to set rel=’nofollow’ on links in the event listing
- Added the option to display events in reverse order
1.0.6
- Added link field to events
- Description box now has the correct tab index on the new & edit pages
- Table view now uses properly cleaned fields
- Past events option now defaults to “Only show current and future events” if it is not set
- Deactivating the plugin no longer deletes all WPListCal settings and data
- Write section tab now named Event instead of Add Event for consistency with WordPress
1.0.5
- Return of the WPListCal options tab
- Fixed the visual editor
- Fixed htmlspecialchars_decode function error
- Plugin now works on servers with short_open_tag disabled
1.0.4
- Fixed edit & options links to work when wplistcal.php is in a subfolder
- Removed options link from edit & new event pages if the user doesn’t have permissions to view it
- Settings tab no longer appears to users who do not have permissions to it
- Visual editor now works properly (also fixes switcheditors not defined error)
1.0.3
- Fixed options bug introduced by WordPress 2.5
- Restyled admin menus to look like WordPress 2.5
- Localized a few hardcoded strings
- Added 24hr time support for the admin area
- Added advanced notice limit option
- Every other event in both the list and table view has the css class ‘wplc_alt’ applied to it to allow alternating row formatting
- Fixed maximum events setting on wplc_show_events
- Fixed display of event titles containing single quotes
1.0.2
- Fixed a bug with the Maximum Events option that caused it to always default to show all events
1.0.1
- Added definition for
str_ireplace()for servers not running PHP5
1.0
- Initial Release
307 Comments
Jump to comment form | comments rss [?] | trackback uri [?]