WPListCal allows you to list upcoming events on your 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 shortcode, show events in your sidebar with a widget, or incorporate events into your theme files using a PHP function call.<\/p>\n\n
wplistcal<\/code> folder to the \/wp-content\/plugins\/<\/code> directory<\/li>\n- Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<\/ol>\n\n
Upgrade<\/h4>\n\n\n- If you are upgrading from version 1.0.5 or earlier, DO NOT DEACTIVATE THE PREVIOUS VERSION OF THE PLUGIN! Doing so will remove all your events.<\/li>\n
- Upload the
wplistcal<\/code> folder to the wp-content\/plugins\/<\/code> directory<\/li>\n- Deactivate and then activate the plugin though the 'Plugins' menu in WordPress<\/li>\n<\/ol>\n\n
Usage<\/h4>\n\n\n- Change the default settings on the WPListCal options page<\/li>\n
If you want to list your events on a page or post, use the [wplistcal] shortcode. Use the parameters in the example below. Leave out parameters to default to the options defined in the WPListCal settings page. (1.2 or later only)<\/p>\n\n
\n Example:<\/em> [wplistcal display_mode=\"list\", event_format=\"%NAME%\", date_format=\"M j, Y g:ia\", max_events=\"-1\", show_past_events=\"false\", advance_days=\"-1\", event_order=\"asc\", hide_same_date=\"true\", date2_time_format=\"g:ia\", no_events_msg=\"No events!\"]<\/code><\/p>\n<\/blockquote><\/li>\nIf you want to list your events on a page or post, insert the tag <!--wplistcal--><\/code> in the body of the page\/post<\/p><\/li>\n- If you want to list your events in your sidebar, activate the WPListCal widget in the widget admin section<\/li>\n
If you want to list your events somewhere in your theme files, insert <?php echo wplc_show_events(); ?><\/code><\/p>\n\n\n You can set special parameters to overwrite the default options if you use the PHP function call.<\/p>\n \n
All parameters are optional, but you must preserve the ordering by passing in null<\/code> for options that you want to use defaults for.<\/p>\n \n Display Mode<\/strong> (string): 'list'<\/code> or 'table'<\/code><\/p>\n \n Event Format<\/strong> (string): The format of the list entries if Display Mode is set to 'list'<\/code>. You can use the following variables: %NAME%, %LINK%, %LINKEDNAME%, %START%, %END%, %DESCRIPTION%, %AUTHOR%, and %EXPORTURL%. You can also make statements dependent on a variable by wrapping them in curly brackets (ex. {Date: %START%}). See "Dependent Statements" below for more information.<\/p>\n \n Date Format<\/strong> (string): The format to display the start and end date and time. Uses the same date formatting that Wordpress uses<\/a>.<\/p>\n \n Max. Events<\/strong> (int): The maximum number of events to display, -1 for unlimited.<\/p>\n \n Show Past Events<\/strong> (boolean): true to show all events, false to show only current and future events<\/p>\n \n Maximum Advanced Notice<\/strong> (int): How many days in advance to display events, -1 for unlimited.<\/p>\n \n Event Order<\/strong> (string): 'asc'<\/code> to show the closest event first or 'desc'<\/code> to show the furthest event first.<\/p>\n \n Hide Same Date<\/strong> (bool): Format the end date with the format string defined in the next parameter if it is on the same day as the start date.<\/p>\n \n Date 2 Time Format<\/strong> (string): If Hide Same Date is enabled, use this format string for the end date.<\/p>\n \n No Events Message<\/strong> (string): If there are no events, show this string instead, leave blank for none.<\/p>\n \n Example:<\/em> <?php echo wplc_show_events('list', '%LINKEDNAME%: %START% - %END%{<br \/>%DESCRIPTION%} <a href=\"%EXPORTURL%\">(export)<\/a>', 'M j, Y g:ia', -1, false, 30, 'asc', true, 'g:ia', 'Sorry, no events'); ?><\/code><\/p>\n<\/blockquote><\/li>\n<\/ol>\n\nDependent Statements (1.2 or later only)<\/h4>\n\n
You can make a statement dependent on the existence of a variable by wrapping it in curly brackets. By default, the statement will only print if the first variable in the statement is not empty. You cannot have nested dependent statements.<\/p>\n\n
Example 1:<\/strong><\/p>\n\nThe statement in the curly brackets won't print if %LOCATION% is empty<\/p>\n\n
%TITLE%{ at %LOCATION%} on %START%\n<\/code><\/pre>\n\nExample 2:<\/strong><\/p>\n\nTo print a literal curly bracket, escape it with '^'<\/p>\n\n
%TITLE%{ at %LOCATION} ^{new^}\n<\/code><\/pre>\n\nExample 3:<\/strong><\/p>\n\nTo skip a variable when determining the dependent variable, escape its '%' characters with '^'. This method also works to print a literal '%' inside a dependent statement. In this example, the statement in the curly brackets will print if %LOCATION% is not empty. Note that %AUTHOR% will be properly substituted even though it is escaped.<\/p>\n\n
%TITLE%{ hosted by ^%AUTHOR^% at %LOCATION%}\n<\/code><\/pre>\n\nExample 4:<\/strong> (invalid)<\/p>\n\nThis example is invalid. You cannot have nested dependent statements.<\/p>\n\n
%TITLE{ at %LOCATION%{ on %START%}}\n<\/code><\/pre>\n\nExample 5:<\/strong><\/p>\n\nHowever, you can have multiple dependent statements in a format.<\/p>\n\n
%TITLE%{ hosted by %AUTHOR%}{ at %LOCATION} on %START%\n<\/code><\/pre>\n\n\n\n- Where does WPListCal store events?<\/dt>\n
On activation time, the plugin adds a table called <prefix>_wplistcal that stores all your events.<\/p><\/dd>\n
- What happens to my events when I deactivate the plugin?<\/dt>\n
Before version 1.0.6, on deactivation, the events table is dropped<\/strong>, so if you want to save your event data, back up the table before deactivating the plugin.<\/p>\n\nAs of 1.0.6, deactivating the plugin has no effect on your data. When upgrading to 1.0.6, DO NOT deactivate the plugin until you have uploaded the new version of wplistcal.php<\/code><\/p><\/dd>\n- Why is WPListCal different from other Wordpress calendar plugins?<\/dt>\n
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.<\/p><\/dd>\n
- Why do some of my events show N\/A for author and create date?<\/dt>\n
Events created before upgrading to version 1.1 did not have those values set, therefore WPListCal marks them as N\/A.<\/p><\/dd>\n
- I am unable to make events that start or end past January 19, 2038 at 3:14:08am<\/dt>\n