Plugin Directory

Test out the new Plugin Directory and let us know what you think.
!This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.


Text Domain: wplistcal WPListCal allows you to list upcoming events on your blog in a list or table format.

  1. Upload the wplistcal folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' menu in WordPress


  1. 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.
  2. Upload the wplistcal folder to the wp-content/plugins/ directory
  3. Deactivate and then activate the plugin though the 'Plugins' menu in WordPress


  1. Change the default settings on the WPListCal options page
  2. 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)

    Example: [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!"]

  3. If you want to list your events on a page or post, insert the tag <!--wplistcal--> in the body of the page/post

  4. If you want to list your events in your sidebar, activate the WPListCal widget in the widget admin section
  5. 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%, %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.

    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 (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.

    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%} <a href="%EXPORTURL%">(export)</a>', 'M j, Y g:ia', -1, false, 30, 'asc', true, 'g:ia', 'Sorry, no events'); ?>

Dependent Statements (1.2 or later only)

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.

Example 1:

The statement in the curly brackets won't print if %LOCATION% is empty


Example 2:

To print a literal curly bracket, escape it with '^'

%TITLE%{ at %LOCATION} ^{new^}

Example 3:

To 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.

%TITLE%{ hosted by ^%AUTHOR^% at %LOCATION%}

Example 4: (invalid)

This example is invalid. You cannot have nested dependent statements.


Example 5:

However, you can have multiple dependent statements in a format.

%TITLE%{ hosted by %AUTHOR%}{ at %LOCATION} on %START%

Requires: 2.7 or higher
Compatible up to: 3.0-alpha
Last Updated: 7 years ago
Active Installs: 700+


0 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

50,2,1 100,1,1 0,1,0