WPListCal
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.
Important: If you are running WordPress 2.5, you must use WPListCal 1.0.3 or later. If you are running a pre-2.5 version of WordPress, you should use WPListCal 1.0.2 or upgrade your WordPress installation. 1.0.2 will be the last release for pre-2.5 versions of WordPress.
Installation
- Upload
wplistcal.phpto the/wp-content/plugins/directory
- Activate the plugin through the ‘Plugins’ menu in WordPress
Upgrade
- DO NOT DEACTIVATE WPListCal before upgrading.
- Upload
wplistcal.phpto the/wp-content/plugins/directory - 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.
- Example:
<?php echo wplc_show_events('list', '%LINKEDNAME%: %START% - %END%<br />%DESCRIPTION%', 'M j, Y g:ia', -1, false, 30); ?>
- 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.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.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
264 Comments
Jump to comment form | comments rss [?] | trackback uri [?]