ICS Calendar

ICS Calendar
  • Features
    • ICS Calendar Pro
    • Feature Comparison
    • Sample Calendars
    • Preview Your Calendar
    • More WordPress Plugins
    • Standalone Version (Beta)
  • Help
    • User Guide
      • Getting Started
      • General WordPress Settings
      • Shortcode Overview
      • All Parameters (Reference)
      • FAQs and Tips
      • CSS Guide
      • Developer
    • Shortcode Builder
    • WordPress Support Forums
    • Pro Documentation
      • Calendar Builder
      • Block Editor
      • Manual Calendar Setup
      • Admin Utilities and Settings
      • Customizer
      • All Parameters
    • Pro Support Forums
      • Installation and Configuration
      • Licensing
      • Troubleshooting and Bugs
      • CSS and Design
      • Feature Requests
      • Translations
      • General Support
    • Pro Support Request Form
    • Translation Suggestions
  • Blog
  • Download
  • Buy Now
  • Cart
  • My Account
Search
More...

User Guide

  • Getting Started
  • General WordPress Settings
  • Shortcode Overview
  • All Parameters (Reference)
  • FAQs and Tips
  • CSS Guide
    • Using the Inspector
    • ICS Calendar CSS Classes
    • CSS Tips and Tricks
  • Developer

More Help

  • User Guide
  • Shortcode Builder
  • WordPress Support Forums
  • Pro Documentation
  • Pro Support Forums
  • Pro Support Request Form
  • Translation Suggestions

All Parameters

This page contains a comprehensive list of the configuration parameters you can include in your shortcode. Parameters that require ICS Calendar Pro are indicated with the Pro Only icon.

ICS Calendar Pro users: If you are using the Calendar Builder to configure your calendar, your shortcode only needs to contain the ID of the saved calendar, for example:

[ics_calendar id="123"]

Parameters that are supported by the Calendar Builder can be found under the tab and label indicated to the right of their names in the list below, e.g. "Advanced → AJAX"

Changes in ICS Calendar v.10.6: 11 parameters have new default values in version 10.6. New installations automatically use the new defaults; existing installations have the option to turn on the new defaults or continue using the old ones. Read more on our blog post about the changes.

ajax

Advanced → AJAX

Loads calendar dynamically with AJAX after the page renders. May resolve conflicts with caching plugins or large calendars.

Accepted Values
Value Default Pro Description

true

 

 

Use AJAX to retrieve calendar dynamically after page loads

false

Default

 

Load calendar directly in page HTML

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Introduced in version 10.3.0.

This parameter is intended for sites that are using a caching plugin that is interfering with the regular loading of the calendar.

By default, ICS Calendar loads the entire calendar data directly in the page HTML. This may result in a caching plugin treating its content as static, and updates to your calendar will not be reflected on the page. When you use this parameter, a placeholder element is included in the page HTML, and AJAX is used to dynamically replace the placeholder with the calendar.

This is a beta feature. It is not guaranteed to function properly, and its functionality may change in a future update.

Just as with the standard loading method, the entire calendar data is loaded. This is not an interactive AJAX feature. It is our observation that the user experience is more likely to include unacceptable lag on AJAX interactions, whereas our standard approach of loading all of the calendar data up-front, and allowing the interactions to occur entirely on the client side, provides a much snappier user experience.

What is AJAX?

Example Usage
[ics_calendar ajax="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

arrayonly

Developer

Return the full parsed event data array only, rather than displaying calendar output.

Accepted Values
Value Default Pro Description

true

 

 

Returns parsed calendar data array only, rather than display HTML

false

Default

 

Returns the full display HTML based on the selected view

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

This parameter is intended for use by experienced PHP developers only. It is also used by some features of ICS Calendar Pro currently under development.

When this parameter is present, processing stops as soon as the full calendar data has been parsed, prior to any template rendering. The returned value can then be used in your custom code.

Note: Because this parameter returns a data array rather than echoing any HTML code to the browser, it is useless in the context of a typical shortcode. Instead, you should use the r34ics_get_ics_data() PHP function. (When this function is used, the value of arrayonly is automatically set to true.)

attach

Events → Attachments

Include links for attachments on events.

Accepted Values
Value Default Pro Description

true

 

 

Include attachments in event description

false

Default

 

Do not include attachments in event description

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Use the attach="true" parameter to display attachments with events. Attachments that are browser-friendly images (e.g. JPEG or PNG) will display directly on the page along with the event’s description. Other attachments will display as a clickable download link.

Images shared from Google Drive will be clickable links, rather than displaying inline, due to the structure of Google Drive links and file access permissions.

If a user who does not have permission to access a particular file on your Google Drive clicks the link, you will receive an automated email from Google requesting permission for that user to access the file. For this reason, you may not want to include attachments in your feed if your site is public.

Google does not provide any way around this limitation, nor a way to make event images/attachments directly publicly accessible.

Example Usage
[ics_calendar attach="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

basicauth

Developer

Access a calendar that uses HTTP basic authentication (plain text username and password).

Accepted Values
Value Default Pro Description

true

 

 

Use HTTP basic authentication

false

Default

 

Do not use HTTP basic authentication

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

For calendars that use HTTP basic authentication, this provides a way for you to supply a username and password to allow ICS Calendar to retrieve the calendar data.

Basic authentication is inherently not very secure. But to avoid the added risk of storing the credentials in plain text in the database, the shortcode parameter is a simple boolean: basicauth="true". You must define the R34ICS_FEED_BASICAUTH constant in your site’s wp-config.php file.* Its value should be the username and password, separated by a colon, as such:

define('R34ICS_FEED_BASICAUTH', 'username:password');

* We took this approach because that file also contains the WordPress database credentials in plain text, so anyone who has access to this file implicitly has access to everything anyway.

Limitations:
  1. This configuration only supports one HTTP basic authentication username/password combination per site. Multiple basic auth-protected calendars can be accessed if they all use the same credentials.
  2. If a shortcode contains multiple feeds, the same credentials will be applied to all of the feeds.
  3. Public calendars ignore the credentials, so a shortcode can include a combination of basic auth-protected and public calendars, as long as any and all basic auth-protected calendars use the same credentials.
  4. Because basic auth uses a colon : as a delimiter, neither the username nor the password can contain a colon. (Since this is an inherent limitation, it should not be an issue for any existing credentials.)
  5. This feature currently cannot be used in conjunction with eventdl. If this setting is used, it will force eventdl to false.
Example Usage
[ics_calendar basicauth="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

color

General → Color

Color-code events when your calendar includes multiple feeds.

Accepted Values
Value Default Pro Description

#RRGGBB

 

 

One or more hex color codes, separated by spaces or the pipe character

Description

You can apply a color to events in your feed by using the color parameter. This is especially helpful if you have multiple feeds and you want to use color coding to distinguish the feeds within your calendar. Add hex color values to this parameter and they will be applied to your feeds in the same order as the feeds are entered in the url parameter. For example, if you have three feeds and you want to color them purple, green and orange, you could use color="#800080 #008000 #ffa500". The base color will be used as a left border on each event, and a lighter tint of that color will be used as the background on the events. Use a tool like the HTML Color Picker to select hex values, if necessary. (Note: the color parameter supports either space- or pipe-delimited lists.)

Example Usage
[ics_calendar color="#800080 #008000 #ffa500"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

columnlabels

General → Column Labels

Customize the day-of-week column labels in month and week views.

Accepted Values
Value Default Pro Description

(empty)

Default

 

Default for view (varies by view)

full

 

 

Full day name, e.g. "Monday"

short

 

 

Abbreviated day name, e.g. "Mon"

min

 

 

Initial for day, e.g. "M"

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default the grid’s column labels will be the full names of the days of the week. For tighter layouts you can add columnlabels="short" to use 3-letter abbreviations, or columnlabels="min" to use 1- or 2-letter abbreviations. (The full day names and abbreviations are in the plugin’s translation files for all supported languages.) Applies to month and week views only.

Example Usage
[ics_calendar columnlabels="full"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month
week
month-with-sidebar
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

combinemultiday

Events

Visually combine multi-day events into a block spanning day cells in the calendar table.

Accepted Values
Value Default Pro Description

true

 

 

Visually combine multi-day events

false

Default

 

Show multi-day events as a series of individual all-day events

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

This is an experimental feature. Your feedback is welcomed. Please see this blog post for more information.

This parameter is not yet supported in Calendar Builder. ICS Calendar Pro users can still take advantage of this feature by adding the necessary parameter directly to their shortcode.

Due to template design limitations, the Month, Week and Month with Sidebar views do not display multi-day events as a block spanning across multiple day cells in the calendar table, but as a series of discrete single-day all-day events.

This parameter uses CSS to modify the appearance of these events to simulate the effect of a multi-day span. It should be useful in most scenarios, although calendars with complicated sequences of overlapping multi-day events may have some display issues.

ICS Calendar Pro users are encouraged to try Full view, which has full support for multi-day events spanning table cells.

Example Usage
[ics_calendar combinemultiday="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month
week
month-with-sidebar

compact

Advanced → Compact

Display your calendars in a more compact layout.

Accepted Values
Value Default Pro Description

true

 

 

Display the calendar in a compact layout

false

Default

 

Display the calendar in the normal layout

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Set compact="true" to activate a more compact display of whichever view you are currently using. The exact layout changes will vary by view; not all views are affected. It is recommended that you also use toggle="true" on list view for maximum effect.

Note:This is currently an experimental feature, and we are looking for feedback. Presently the changes are that all text is reduced slightly in size, and the list view is collapsed into a new layout with the times left-aligned next to the event titles.

Example Usage
[ics_calendar compact="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

count

General → Count

Set the number of events to show in list view.

Accepted Values
Value Default Pro Description

INTEGER

 

 

Number of events to display

Description

Number of events to display, e.g. count="5". By default, all upcoming events will be displayed. Applies in list view only.

Example Usage
[ics_calendar count="5"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
list
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

curlopts

Developer

An experimental parameter for sites that are having trouble loading feeds.

Accepted Values
Value Default Pro Description

cookie

 

 

Sets a cookie when making requests

useragent

 

 

Sets a user agent string when making requests (DEPRECATED)

Description

This is an experimental parameter, intended for use on sites that are having trouble loading feeds. It is used to facilitate testing additional request headers when retrieving a feed.

The useragent value is deprecated; ICS Calendar now always sends a user agent string when requesting the feed.

It has come to our attention that some services like Cloudflare (providing load balancing, CDNs, and DDOS mitigation services) may reject requests generated by ICS Calendar due to their superficial similarity to malicious requests. If you are using a service like this and are finding that ICS Calendar is unable to retrieve your feeds, please try adding curlopts="cookie" to your shortcode and let us know if it is helpful.

Example Usage
[ics_calendar curlopts="cookie"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

customoptions

Developer

Create your own custom options. (For developers only.)

Accepted Values
Value Default Pro Description

STRING

 

 

Pipe-delimited list of custom options

Description

If you are writing your own custom code to extend the plugin’s functionality, use customoptions to create your own configuration options for the shortcode. The value passed in this attribute is automatically converted into an array using the pipe character | as a delimiter. This attribute will never be used directly within the core ICS Calendar plugin, but may be used in ICS Calendar Pro or in customizations/add-ons to pass additional data into the shortcode for use within filters.

Notes:

  • If no pipes are present in the value, it will still be converted into an array with one node.
  • The value is converted to a numbered array of values; that is, it does not automatically get converted into an associative array of key/value pairs. You will need to handle the values accordingly in your code.
Example Usage
[ics_calendar customoptions="key1=value1|key2=value2"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

debug

Troubleshooting → Debug Mode

Turn on debug mode for troubleshooting.

Accepted Values
Value Default Pro Description

(empty)

Default

 

Debug mode off

1

 

 

Basic debugging

true

 

 

(Same as 1)

2

 

 

Extended debugging

3

 

 

Full debugging; also turns off ICS Calendar's caching

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Use debug="true" to turn on the debugger. Extended debugging output is available by setting debug="2". Only Administrator-level users will see debugging code. When turned on, a panel will appear at the bottom of the screen with a raw dump of the ICS data array, and possibly additional debugging information. When debugging you may also want to set reload="true" to reload the feed on each page load.

Basic mode includes the fully parsed event array and general details about the request. It uses cached data if available. Extended mode adds the raw data as handled by the ics-parser library (before being processed by ICS Calendar itself), along with additional details about the server connection. Full mode always requests fresh data from the source server, rather than using the cache, and it also outputs the entire raw contents of the ICS feed itself.

Example Usage
[ics_calendar debug="1"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

description

Header & Footer → Description

Set the overall calendar’s description.

Accepted Values
Value Default Pro Description

true

 

 

Automatically displays the description of the calendar from the source feed (if the calendar only contains one feed)

false

Default

 

Hides the source calendar's description; does not display any description above the calendar

STRING

 

 

Displays the text entered, instead of the source calendar's description

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Text string to display as a general description of the calendar. Displays above the calendar, just below title. If omitted, the feed’s description will display (if any). Use "false" to display no description.

Note: This parameter’s default value was changed in ICS Calendar version 10.6

Example Usage
[ics_calendar description="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Customize Title and Description setting(s).

empty_day_description

Pro Only
Advanced → Empty Day Description

Enter a generic description to display on empty days.

This parameter is available in ICS Calendar Pro only.

Description

If Fill Empty Days is on, you can enter a generic description to display on empty days. Event Descriptions must be turned on. HTML is allowed in this field.

Example Usage
[ics_calendar empty_day_description="No events."]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Fill Empty Days setting(s).

empty_day_title

Pro Only
Advanced → Empty Day Title

Enter a generic title to display on empty days.

This parameter is available in ICS Calendar Pro only.

Description

If Fill Empty Days is on, you can enter a generic title to display on empty days.

Example Usage
[ics_calendar empty_day_title="Free"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Fill Empty Days setting(s).

eventdesc

Events → Event Descriptions

Turn on display of individual event descriptions.

Accepted Values
Value Default Pro Description

true

Default

 

Show event descriptions

false

 

 

Do not show event descriptions

INTEGER

 

 

Show an excerpt of the description, INTEGER words long

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Use the eventdesc="true" parameter to display event descriptions. Note: In the month view, descriptions will display on hover; in the list view, descriptions will display in full on the page below the event title (and location/organizer, if shown). In the list view, you can choose to display an excerpt of the description by entering the number of words to show, e.g. eventdesc="12". Hovering over the shortened description will show the full description in a tooltip. Month view always shows the full description.

Note: This parameter’s default value was changed in ICS Calendar version 10.6

Example Usage
[ics_calendar eventdesc="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

eventdesc_length

Pro Only
Events → Description Excerpt

Display excerpts instead of full event descriptions.

This parameter is available in ICS Calendar Pro only.

Description

If your event descriptions are long, enter a number of words to display as an excerpt instead. Full description text will appear if the user clicks the excerpt.

This exists as a separate parameter only to facilicate the Calendar Builder interface in ICS Calendar Pro. To set an excerpt length in ICS Calendar (free), enter an integer value for eventdesc as shown below.

Example Usage
[ics_calendar eventdesc="12"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
list
month-with-sidebar
widget
year-with-sidebar
Calendar Builder (Pro) users: This input displays conditionally, based on the Event Descriptions setting(s).

eventdl

Events → Event Downloads

Add individual event download links.

Accepted Values
Value Default Pro Description

true

 

 

Add an individual .ics download to each event

false

Default

 

Do not add individual .ics downloads

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Add eventdl="true" to your shortcode to add a clickable download link to each event. This will download a customized .ics file containing only the selected event for users to add the event to their personal calendars.

Example Usage
[ics_calendar eventdl="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

extendmultiday

Dates & Times → Extend Multi-day Events

Extend the displayed range for multi-day events.

Accepted Values
Value Default Pro Description

true

 

 

Extend multi-day events to include the end date

false

Default

 

End multi-day events before the end date, per spec

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Per the iCalendar specification, the DTEND value on all-day events is the first free date in the range, i.e. the date after the event finishes. By default, multi-day all-day events are handled this way. If your feed includes multi-day all-day events that should include the date specified by DTEND, add extendmultiday="true" to your shortcode.

Example Usage
[ics_calendar extendmultiday="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

feedlabel

General → Label

Add custom labels for calendars that include multiple feeds.

Accepted Values
Value Default Pro Description

STRING

 

 

Labels for each feed in the legend, pipe-delimited

Description

By default, each calendar in the color key will be labeled using the title provided in that calendar’s feed. You can override the titles by using feedlabel. Note that because feed labels may need to contain spaces, the values for this parameter are pipe-delimited | rather than space-delimited. You can provide custom labels for some feeds and use the default titles as labels for others. For example, if you had three feeds and wanted to keep the default title for the second one, you could use feedlabel="Calendar Label 1||Calendar Label 3". (Note two pipes together; this is leaving the second delimited value empty.)

Example Usage
[ics_calendar feedlabel="Calendar Label 1|Calendar Label 2"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

fill_empty_days

Pro Only
Advanced → Fill Empty Days

Use ICS Calendar Pro to show availability, in addition to booked dates/events.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

true

 

Pro Only

Adds Empty Day Title and Empty Day Description to days with no events

false

Default

Pro Only

Days with no event are left blank

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

If your calendar is intended to show availability, use this option to add a general “available” message to all dates that do not have any events in your feed. You can set the specific title (and/or description) to be displayed using the Empty Day Title and Empty Day Description fields.

Example Usage
[ics_calendar fill_empty_days="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

fixredundantuids

Developer

Fix an issue with duplicated events in iCloud calendars.

Accepted Values
Value Default Pro Description

(empty)

Default

 

No effect

1

 

 

Removes multiple events that have the same UID in the source feed

true

 

 

(Same as 1)

2

 

 

Removes multiple events that start at the same time and have the same SUMMARY, regardless of UID

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Addresses an issue where an iCloud source feed may include multiple past edits of an event as separate, redundant instances of the event in the calendar. If you are experiencing this issue, add fixredundantuids="1" to your shortcode. Note that this will not remove redundant-looking events if they have different UIDs. (For instance, if you’ve deleted a single instance of a recurring event, and then created a new one-off event at the same date and time, or with the same title… those events will have different UIDs and be treated as separate events.)

Setting fixredundantuids="2" wil remove any duplicates that start at the same time and have the same SUMMARY value, regardless of matching UIDs. (This is intended for handling edge cases where an individual instance of a recurring event has been edited.)

We are still testing this feature and it is subject to change or removal. Your feedback is welcomed.

Example Usage
[ics_calendar fixredundantuids="1"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

format

Dates & Times → Date Format

Set the date display format.

Description

By default list view will display dates in the U.S. standard day-month-date format (e.g. “Thursday March 14”). Other views use the format in your general WordPress settings under Settings → General → Date Format.

To use a different date format in your ICS Calendar shortcode, use a value in standard PHP date format with the format parameter.

Example Usage
[ics_calendar format="D n/j"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

formatmonthyear

Dates & Times → Month/Year Format

Set the month/year display format.

Description

In places where the month and year are displayed without the day number (e.g. headers and month selection dropdown menu in month view), the default format is F Y (e.g. “March 2020”). Use the formatmonthyear parameter with PHP date format strings to customize the display. Note: This option only supports month and year characters (F, m, M, n, Y, y), plus spaces, hyphens, periods and slashes. All other formatting characters will be stripped from the output.

Example Usage
[ics_calendar formatmonthyear="F Y"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

grid_max_days

Pro Only
General → Max Days

Set the maximum number of days to display at one time in grid view.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

INTEGER

 

Pro Only

Number of days to show at once in grid view

Description

Use this option to adjust the number of days to display at once in grid view. The default is 5.

Example Usage
[ics_calendar grid_max_days="5"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
grid
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

grid_show_empty

Pro Only
General → Empty Days

Determines whether or not to show empty days in grid view.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

true

 

 

Show empty days in grid

false

Default

 

Show only days with events in grid

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, grid view only shows dates that contain one or more events. Turn on this option to show all dates, regardless of whether or not they contain events.

Example Usage
[ics_calendar grid_show_empty="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
grid
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

guid

Advanced → ID Attribute

Create a custom HTML id for the calendar.

Description

A “GUID” or “globally unique identifier,” can be used to give your calendar’s container element a unique HTML id attribute, making it easy to create an “anchor” link to the calendar within a long page. Must consist of only lowercase letters or numerals. Cannot start with a numeral. Once set, you can use this string as an anchor link or in creating custom CSS specific to this calendar.

The shortcode parameter is guid instead of id to avoid a conflict with the id attribute in the Pro version.

Note: This is not strictly a true “GUID” but the name was chosen for familiarity.

Example Usage
[ics_calendar guid="My Calendar"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

hidealldayindicator

Events → "All Day" Indicator

Hide the “ALL DAY” label that appears above all-day events.

Description

By default, all-day events are grouped at the top of each day’s events list, with an “ALL DAY” header. Use hidealldayindicator="true" to remove this header. (The all-day events will still be grouped together, above any time-specific events.)

Example Usage
[ics_calendar hidealldayindicator="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

hideprivateevents

Events

Hide any events marked as “private” that are included in the ICS feed.

Accepted Values
Value Default Pro Description

true

 

 

Hides events marked PRIVATE or CONFIDENTIAL

false

Default

 

Does not hide any events that are in the feed

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, ICS Calendar displays any events that are included in the feed. In terms of the iCalendar specification, it does not do anything with the CLASS property on events.

This parameter is mainly intended for a specific Google Calendar use case, although it may be useful with other services as well. When your calendar is set to public and you are using what Google calls the Public address in iCal format, it automatically excludes any events in that calendar that are marked “private”. But if you use the Secret address in iCal format, those private events are included in the feed.

Using the hideprivateevents parameter in your shortcode will tell ICS Calendar to exclude any events with CLASS:PRIVATE or CLASS:CONFIDENTIAL from display.

This feature was added in ICS Calendar version 10.8.1 and is not currently available in the Pro Calendar Builder as of version 4.4.5. (It will be added in the next Pro update.)

Example Usage
[ics_calendar hideprivateevents="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

hiderecurrence

Events → Hide Recurrence

Hide recurrence frequency that displays by default on recurring events.

Accepted Values
Value Default Pro Description

true

Default

 

Does not show recurrence frequency

false

 

 

Shows recurrence frequency

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

You can hide recurrence frequency messages using hiderecurrence="true", or you can hide specific frequency types by entering one or more pipe-delimited frequencies to hide, e.g. hiderecurrence="yearly" or hiderecurrence="yearly|monthly".

Note: This parameter’s default value was changed in ICS Calendar version 10.6

Example Usage
[ics_calendar hiderecurrence="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

hidetimes

Dates & Times → Hide Times

Hide event times. Useful if your event descriptions already include the time.

Description

By default, start times are always displayed, and end times are displayed on hover. To hide all times (for instance, if the times are also in your event description), add the hidetimes="true" parameter.

Example Usage
[ics_calendar hidetimes="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

hours

Pro Only
General → Daily Start Time / Daily End Time

When using the Calendar Builder, the start and end times are entered separately in the Daily Start Time and Daily…

This parameter is available in ICS Calendar Pro only.

Description

When using the Calendar Builder, the start and end times are entered separately in the Daily Start Time and Daily End Time fields. If entering directly in the shortcode, the start and end times are handled as a pair of 4-digit values (24-hour time, HHMM) separated by a hyphen.

Example Usage
[ics_calendar hours="0800-1900"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
grid
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

id

Pro Only
Calendar Builder → Shortcode

Simple shortcode format when using the Calendar Builder in ICS Calendar Pro.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

INTEGER

 

Pro Only

The post ID of your saved calendar from Calendar Builder

Description

If you are using ICS Calendar Pro’s Calendar Builder to configure your calendar, you do not need to enter a complicated shortcode in your pages. Instead, the Calendar Builder displays a Shortcode field at the top of the page, containing the unique ID for this particular calendar configuration.

You can edit the calendar configuration at any time, and any instances of the simple shortcode using this ID throughout your site will automatically pick up the changes. (Note: you may need to run the Clear Cached Calendar Data utility on the ICS Calendar admin page, as well as any additional caches generated by third-party caching plugins.)

ICS Calendar shortcodes that are built with this parameter can also include any of the other standard parameters, for example if you want to use a saved Calendar Builder calendar in multiple places on your site, but override one or more of the settings in any individual instance, as such:

[ics_calendar id="123" format="n/d"]
Example Usage
[ics_calendar id="123"]

legacyparser

Developer

Load calendars with the old (pre-ICS Calendar v. 9.0) version of the ics-parser library.

Description

An update to the ics-parser library introduced in ICS Calendar v. 9.0 presented a problem for a small number of users, where the new version of ics-parser strips CSS classes out of HTML-formatted event descriptions. Using this parameter will cause ICS Calendar to continue using the older version of the parser.

This option will be removed when an updated version of ics-parser that resolves this issue is available.

Example Usage
[ics_calendar legacyparser="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

legendposition

Header & Footer → Legend Position

Set whether the legend appears above or below the calendar.

Accepted Values
Value Default Pro Description

above

Default

 

Shows legend above the calendar

below

 

 

Shows legend below the calendar

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Determines where to display the legend (list that identifies the different calendar feeds) relative to the calendar. Valid values are "above" and "below". If omitted or an invalid value, will default to above.

Example Usage
[ics_calendar legendposition="above"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Legend Style setting(s).

legendstyle

Header & Footer → Legend Style

Set whether the legend displays in block or inline format, or is hidden altogether.

Accepted Values
Value Default Pro Description

block

Default

 

Displays items in legend stacked vertically

inline

 

 

Displays items in legend inline in a row

none

 

 

Legend does not display

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Determines how to display the legend. Valid values are "block", "inline" and "none". If omitted or an invalid value, will default to block.

Example Usage
[ics_calendar legendstyle="block"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

limit_in_table

Pro Only
General → Limit in Table

Set the maximum number of events to show per day in the table view.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

INTEGER

 

Pro Only

Number of events to show per day in the month table

Description

By default, Month with Sidebar view shows a maximum of 3 events per day in the month table, followed by a note indicating the number of additional events on that day. Clicking a day displays its full list in the sidebar.

This parameter lets you adjust the number of events to show per day in the table.

Example Usage
[ics_calendar limit_in_table="3"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month-with-sidebar
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

limitdays

Dates & Times → Limit Days

Set the maximum number of days to display in the calendar. Default is 365.

Description

By default, the plugin limits the displayed date range to the farthest future event in your feed. Use limitdays="NUMBER" to override the default limit. Replace NUMBER with your desired number of days. Note: If your calendar has a very large number of events, setting this value above 365 may affect performance.

Microsoft Outlook/Office 365 users: In some cases, Microsoft limits the source feed to 6 months. Please see this note for more information.

Note: This parameter’s default value was changed in ICS Calendar version 10.6

The default value varies depending on the view parameter.

Example Usage
[ics_calendar limitdays="180"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

linebreakfix

Developer

Fix some issues with line breaks within the description if your source feed does not conform to iCalendar spec.

Description

Use this option only if your feed formats event description line breaks in a way that does not conform properly to the iCalendar spec. Has no effect on properly formatted feeds.

Example Usage
[ics_calendar linebreakfix="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

linktitles

Events → Links

If events have a URL, this makes the event title itself a clickable link.

Description

If the event data contains a URL, the URL can be added to the display as a clickable link in one of two ways. Use the linktitles="true" parameter to make the event title into a clickable link to that URL. If linktitles is not used, and eventdesc="true" is used, then the URL will be displayed as a clickable link after the event description. These links will always open in a new tab/window. If you do not wish to have event URL links appear at all, use nolink="true".

Example Usage
[ics_calendar linktitles="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

location

Events → Event Locations

Display event locations.

Accepted Values
Value Default Pro Description

true

Default

 

Displays event locations in the description area

false

 

 

Does not display event locations

maplinks

 

 

Displays event locations and automatically makes them clickable Google Maps links

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Use the location="true" parameter to display event locations (if available). Note: In the month view, locations will display on hover; in the list view, locations will display in full on the page below the event title.

Use location="maplinks" to make event locations automatically convert into a clickable Google Maps link, unless the feed’s LOCATION field data already contains HTML or a URL.

Important: location="maplinks" performs a Google Maps search on the exact text of your events’ LOCATION fields. It does not have a way to verify that the value is a real address, so incomplete locations (e.g. conference room names within your office) may yield nonsensical map results.

Note: This parameter’s default value was changed in ICS Calendar version 10.6

Example Usage
[ics_calendar location="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

mapsource

Events

An experimental parameter for sites that are having trouble loading feeds.

Accepted Values
Value Default Pro Description

google

Default

 

Use Google Maps for automatic map links

bing

 

 

Use Bing Maps for automatic map links

openstreetmap

 

 

Use OpenStreetMap for automatic map links

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

This parameter was introduced in ICS Calendar v.10.9.0. It is not yet included in the Calendar Builder in ICS Calendar Pro, but can be added to your shortcode manually.

If your calendar is set to display event location information with map links, via location="maplinks", the default is to generate Google Maps links. This setting lets you choose one of the available alternate map options, Bing Maps or OpenStreetMap.

Please note: This parameter only works in conjunction with location="maplinks" in your shortcode. If that is not set, mapsource will have no effect.

OpenStreetMap users: OpenStreetMap works best if your feed includes exact longitude and latitude coordinates via the GEO property (which is rare). If your feed does not contain GEO data, ICS Calendar performs a search on the map service using the address in the LOCATION property of the feed. While this generally works well with Google or Bing, OpenStreetMap is a bit more restrictive in its search results, and it may not return a usable match.

Example Usage
[ics_calendar mapsource="bing"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

maskinfo

Advanced → Mask Info

Mask all event details with an arbitrary text string.

Description

In some cases, such as for vacation rental availability, you may not want to show any event details, but simply block out days and times. Use maskinfo="MASK", replacing MASK with the text you wish to display in place of the event title. Event details, location and organizer will also be hidden automatically, regardless of any other settings.

Example Usage
[ics_calendar maskinfo="Booked"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

method

Advanced → ICS Feed Loading Method

Set the method (cURL or open) PHP uses to retrieve the feed.

Accepted Values
Value Default Pro Description

(empty)

Default

 

Tries cURL, then fopen if cURL fails

curl

 

 

Tries cURL only

fopen

 

 

Tries fopen only

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

The method attribute can be used to force the plugin to only try retrieving the ICS feed via either cURL or fopen. By default, the plugin tries cURL first and then falls back on fopen. In cases where cURL fails, but with a long timeout, you can use method="fopen" in the shortcode to bypass cURL. This can significantly improve page load times for calendars that experience this issue with cURL receiving an HTTP 500 error from the calendar server. Conversely, if you only want to load the feed via cURL, and not allow the fopen fallback, use method="curl" in your shortcode.

Example Usage
[ics_calendar method="curl"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

month_list_all

Pro Only
General → List All

Show all events in collapsed mobile list view, rather than one month at a time.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

true

 

Pro Only

Show all months when collapsed to mobile list view

false

Default

Pro Only

Retain month-by-month dropdown in collapsed view

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default (unless the nomobile parameter is set), month view collapses to a list on mobile devices, for usability. This collapsed list view retains the month dropdown menu, showing the events for only one month at a time.

Turn on this option to display all events at once on mobile devices. Has no effect on the desktop view.

Example Usage
[ics_calendar month_list_all="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

month_table_list_toggle

Pro Only
General → Table/List Toggle

Add a Month/List toggle to month view.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

true

 

Pro Only

Adds month/list toggle option to month view

false

Default

Pro Only

Does not add the month/list toggle

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

When this option is turned on, month view adds a Month/List toggle button, allowing users to switch between the default table-based month layout and a simple day-by-day, event-by-event list view. This list view matches the version that month view automatically collapses to on mobile devices.

Example Usage
[ics_calendar month_table_list_toggle="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

monthnav

General → Month Navigation Style

Set the format for month navigation.

Accepted Values
Value Default Pro Description

select

Default

 

Displays a select (dropdown) menu

arrows

 

 

Displays previous/next month arrows

both

 

 

Displays both a select menu and arrows

compact

 

 

Displays both, inline, without the default month/year header

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, the month view shows a dropdown (select) menu to navigate available months. Add monthnav with a value of select, arrows, both or compact (both, inline without header) to change how this is displayed. Applies to month view only.

Example Usage
[ics_calendar monthnav="select"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month
month-with-sidebar
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

nolink

Events → Link

Hide event links.

Description

Suppresses display of event links. Useful if your calendar feed automatically inserts a default link on all events that you do not wish to display along with the event description.

Example Usage
[ics_calendar nolink="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

nomobile

General → Mobile

Turn off the default modifications to month layouts on small mobile devices.

Description

The standard treatment for month and week views on mobile is to stack the display in a list style, because the grid does not work well scaled to the small size of a mobile display. However, if you wish to retain the grid, add nomobile="true" to your shortcode. Note that you will probably need to add your own custom CSS to make this display usable. Be sure to wrap your CSS in @media screen and (max-width: 782px) { } and use .ics-calendar.nomobile .ics-calendar-month-grid in your CSS selectors.

Example Usage
[ics_calendar nomobile="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month
week
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

nomonthheaders

Advanced → No Month Headers

Hide month headers.

Description

Use nomonthheaders="true" on list or month view to prevent month headers from displaying on the page. Reduces overall layout size by removing the month headers. Does not apply to views where month headers are necessary for usability. (Has no effect on week view since there are no month headers in that view anyway.)

Example Usage
[ics_calendar nomonthheaders="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

organizer

Events → Event Organizers

Show event organizers.

Accepted Values
Value Default Pro Description

true

Default

 

Shows the event organizer

false

 

 

Does not show the event organizer

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Use the organizer="true" parameter to display event organizer (if available). Note: In the month view, organizers will display on hover; in the list view, locations will display in full on the page below the event title (and location, if shown).

Note: This parameter’s default value was changed in ICS Calendar version 10.6

Example Usage
[ics_calendar organizer="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

pagination

General → Pagination

This feature is new in ICS Calendar version 10.7.

With this parameter, list view supports pagination. When using pagination, be sure…

Accepted Values
Value Default Pro Description

INTEGER

 

 

Number of events to include per page

Description

This feature is new in ICS Calendar version 10.7.

With this parameter, list view supports pagination. When using pagination, be sure to also include the count parameter. You should use count to set the total number of events you want to display, and pagination to set the number of events to display per “page.”

Note: This value is approximate. The list will always keep events that occur on the same date grouped together on a single page, possibly resulting in some pages containing more than the designated number of events.

Example Usage
[ics_calendar pagination="5"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
list

paginationposition

Header & Footer

Set whether the legend appears above or below the calendar.

Accepted Values
Value Default Pro Description

above

 

 

Shows pagination links above the event list

below

Default

 

Shows pagination links below the event list

both

 

 

Shows pagination links both above and below the event list

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

This setting is only relevant for list view when pagination is set. Determines if the pagination links appear above or below the list, or both. The default is below, but some users may wish to display the links above the list, since varying event description lengths can cause the links to move up or down on the page when clicked.

This parameter was introduced in ICS Calendar v.10.9.1.

Example Usage
[ics_calendar paginationposition="below"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
list

pastdays

Dates & Times → Past Days

Set the number of past days to include in the displayed calendar.

Description

By default, list and month views do not include past dates (before the first of the current month, in month view) unless startdate is used to set an arbitrary start date. You can also set a rolling start by using pastdays="NUMBER" where NUMBER is replaced with the number of days back you wish to begin. For instance, to show 3 previous months you could enter pastdays="90". This option has no effect in week view.

Notes about the pastdays attribute:

1. You may need to make adjustments to the limitdays option when this is used, as it calculates from the first displayed date, not the current date.

2. This attribute has no effect on week view.

Note: This parameter’s default value was changed in ICS Calendar version 10.6

The default value varies depending on the view parameter.

Example Usage
[ics_calendar pastdays="90"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Start On setting(s).

regex

Pro Only
Advanced → Regular Expressions

Turn on Regular Expressions options in the Calendar Builder.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

true

 

Pro Only

Turns on Regular Expressions parsing

false

Default

Pro Only

No Regular Expressions parsing

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Executes the PHP preg_replace() function on event data, allowing you to build complex text replacement logic if you need to customize how your event information is displayed. Requires an understanding of PCRE (Perl-Compatible Regular Expressions).

Important: This option just turns on the Regular Expressions functionality. You will also need to set the Pattern, Replacement and Scope parameters.

Example Usage
[ics_calendar regex="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

regex_pattern

Pro Only
Advanced → Pattern

Define the Regular Expressions pattern.

This parameter is available in ICS Calendar Pro only.

Description

Defines the pattern for the RegEx search. Requires an understanding of PCRE (Perl-Compatible Regular Expressions).

Example Usage
[ics_calendar regex_pattern="/PATTERN/"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Regular Expressions setting(s).

regex_replacement

Pro Only
Advanced → Replacement

Define the Regular Expressions replacement.

This parameter is available in ICS Calendar Pro only.

Description

Defines the replacement for the RegEx search. Requires an understanding of PCRE (Perl-Compatible Regular Expressions).

Example Usage
[ics_calendar regex_replacement="REPLACEMENT"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Regular Expressions setting(s).

regex_scope

Pro Only
Advanced → Scope

Set the scope for the Regular Expressions search (event titles, descriptions, or both).

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

(empty)

Default

 

No scope; search will not be performed

event_label_html

 

 

Searches in event titles only

event_description_html

 

 

Searches in event descriptions only

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Regular Expressions can be applied to either the event titles or event descriptions, or to both. This parameter determines the scope of the search. Note that this parameter is required when applying regular expressions. If you wish to include both titles and descriptions, both values can be entered, pipe-delimited.

Example Usage
[ics_calendar regex_scope="event_label_html|event_description_html"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Regular Expressions setting(s).

reload

Troubleshooting → Reload

Set the duration (in seconds) that retrieved calendar data is cached by ICS Calendar.

Description

Note: This parameter’s functionality has changed as of version 8.5.5.

By default, ICS Calendar caches your parsed feed data for one hour (3600 seconds). Previous versions supported using reload="true" to tell the plugin not to cache the calendar data at all. This is still supported, but now the reload parameter supports any integer value, representing the number of seconds the cache should be retained. For instance, to set the cache to four hours instead of one, use reload="14400". If this parameter is omitted or set to 0, false, or a negative value, the default 3600-second (1-hour) cache will apply.

Example Usage
[ics_calendar reload="1"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

resources

Events

Show event organizers.

Accepted Values
Value Default Pro Description

true

 

 

Shows the event resources

false

Default

 

Does not show the event resources

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

If your calendar feed includes the RESOURCES property (typically used to assign rooms or equipment to an event), use this option to display that information in the event description hover/lightbox. Note: It is uncommon for most feeds to include this information.

Example Usage
[ics_calendar resources="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

reverse

General → Reverse

Show past events in list view in reverse chronological order.

Description

If you want to display a list of past events, use reverse="true" in your shortcode. The list will start from the current date and move backwards from there.

Use in conjunction with pastdays to set the number of days to include in the display.

Notes:

  1. When reverse is used, pastdays and limitdays are automatically set to the same value. If both are set, pastdays takes precedence.
  2. Due to date scope logic in the parser, if both pastdays and limitdays are omitted, only events in the current calendar year will be displayed.
  3. The reverse option applies only to list view. It has no effect on other views, due to a logical incompatibility with other layouts.
  4. Multiple events within a single day are still displayed in “forward” time order.
Example Usage
[ics_calendar reverse="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
list
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

sametab

Advanced

By default, ICS Calendar opens any links contained within the calendar that are offsite (on a different domain than your…

Accepted Values
Value Default Pro Description

true

 

 

Opens offsite links in the calendar in the same tab as the current page

false

Default

 

Opens offsite links in the calendar in a new tab

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, ICS Calendar opens any links contained within the calendar that are offsite (on a different domain than your site) in a new browser tab.

Add sametab="true" to your shortcode to have these links open in the same browser tab as the current page.

This option was introduced in ICS Calendar version 9.9.0. At this time it is not yet included in the Calendar Builder in ICS Calendar Pro; however, as with all parameters, you can add it to your id based Calendar Builder shortcodes as well.

Example Usage
[ics_calendar sametab="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

showendtimes

Dates & Times → Show End Times

Show end times always (default is on hover only).

Accepted Values
Value Default Pro Description

true

Default

 

Event end times are always displayed

false

 

 

Event end times are only displayed when the user hovers over the start time

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, start times are always displayed, and end times are displayed on hover. To always display end times (not just on hover), add the showendtimes="true" parameter.

Note: This parameter’s default value was changed in ICS Calendar version 10.6

Example Usage
[ics_calendar showendtimes="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Hide Times setting(s).

showfilter

Pro Only
Header & Footer → Filter (Event Search)

Add search to your calendar.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

true

 

Pro Only

Adds search filter tool above calendar

false

Default

Pro Only

No search filter

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Adds a simple form above the calendar to filter the events being displayed. Helps users locate specific items on calendars with a large number of events.

Example Usage
[ics_calendar showfilter="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

skip

Miscellaneous

Set number of upcoming events to skip in list view.

Description

Add the skip="NUMBER" parameter in conjunction with the count parameter in list view to split a calendar across multiple shortcodes within a page (e.g. a multi-column layout). This NUMBER of events will be skipped in display. Should match the sum of the count value(s) from previous shortcode(s) on the page for the same feed.

Note: As of ICS Calendar version 10.7, you may wish to use the pagination parameter, rather than using skip with multiple instances of your shortcode.

ICS Calendar Pro users: This parameter is not included in the Calendar Builder because its intended use is inconsistent with the Calendar Builder logic. If you wish to use skip, you should create one single saved calendar, and then reuse its id-based shortcode multiple times, adding the skip parameter directly to each instance of the shortcode, as appropriate.

Example Usage
[ics_calendar skip="5"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
list

skipdomainerrors

Advanced

By default, ICS Calendar tries to load every ICS feed in all ICS Calendar shortcodes contained on a page, regardless…

Accepted Values
Value Default Pro Description

true

 

 

Won't try to load additional feeds from a server that has already returned an empty response or error

false

Default

 

Will try to load every feed included in all shortcodes on the page

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, ICS Calendar tries to load every ICS feed in all ICS Calendar shortcodes contained on a page, regardless of whether or not any of the previous feeds failed to load.

In some cases, a page may contain a large number of feeds, all from the same server. If that server is unresponsive or returning errors, this could result in a page taking several minutes to load, as ICS Calendar futilely attempts to retrieve each additional feed.

By adding skipdomainerrors="true" to your shortcode, ICS Calendar will keep track of the domains (servers) that have failed to return a valid feed already on the same page, and will automatically skip even attempting to connect to them again.

Note: The logic for skipping feeds only applies to a single page load. However, caching (including ICS Calendar’s internal caching mechanism) may cause the empty response to be retained on subsequent page loads by other users. If you are using this option, you may also wish to set a fairly short cache duration, such as reload="300" (5 minutes).

Example Usage
[ics_calendar skipdomainerrors="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

skiprecurrence

Events → Skip Recurrence

Skip calculating and displaying recurring events.

Description

Add the skiprecurrence="true" parameter to skip parsing recurring events. Since this omits all recurrences, it should only be used if the calendar is extremely large (affecting performance), and recurring events are not needed.

Example Usage
[ics_calendar skiprecurrence="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

solidcolors

Advanced → Solid Colors

Changes color-coding style from the default view (bands on the left edge with a light tint behind the text) to…

Description

Include solidcolors="true" in your shortcode to make events in color-coded feeds use the designated color as a solid background behind the text, instead of the default lighter “tint” of the designated color.

Example Usage
[ics_calendar solidcolors="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

startdate

Dates & Times → Start Date

Set an arbitrary start date for the calendar.

Description

By default, the calendar display will start from the current date. To have the calendar start from an arbitrary date (either in the future or the past), use this parameter with the date in an 8-digit "YYYYMMDD" format.

Example Usage
[ics_calendar startdate="20220906"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Start On setting(s).

stickymonths

General → Sticky Months

Adds month dropdown selections to the URL in the address bar, allowing for links to load the page directly to…

Accepted Values
Value Default Pro Description

true

Default

 

The address bar URL changes when the user changes the displayed month, allowing links to a specific month

false

 

 

The address bar URL does not change when the user interacts with the calendar

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Add stickymonths="true" to your shortcode to have the browser’s address bar automatically update with a month code when the user selects a month from the dropdown menu (month view only). Using this URL will open the page with the given month pre-selected.

Note: This parameter’s default value was changed in ICS Calendar version 10.6

Example Usage
[ics_calendar stickymonths="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month
month-with-sidebar
widget
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

subscribelink

Pro Only
Header & Footer → Subscribe Link

Adds a subscribe link below the calendar.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

true

 

Pro Only

Add subscribe links

false

Default

Pro Only

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

This option adds a subscribe link below the calendar. For multi-feed calendars, the subscribe links will be in the color key next to the calendar names. Note: This will make the direct URL of your feed publicly available.

Example Usage
[ics_calendar subscribelink="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

table_cell_contents

Pro Only
General → Table Cell Contents

Choose whether Month with Sidebar view shows a list of events in each table cell, or a dot indicating the…

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

events

 

Pro Only

Shows first few events on each day; exact number set by Limit in Table

dot

 

Pro Only

Shows a dot indicating day has events

Description

Month with Sidebar view is a design that combines a table-based month view with a sidebar showing the full details of events on a selected date. Because this view might need to fit into a variety of page widths, this option lets you control whether the table shows a list of a few of each day’s events, or a simple dot indicating the date has events.

With either option, clicking on a date in the table shows the full list of that day’s events in the sidebar.

Example Usage
[ics_calendar table_cell_contents="events"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month-with-sidebar
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

tablebg

→ ICS Calendar → Colors → Table Background

Set a custom background color on the calendar table. (Applies only to views that use a table.)

Description

Older versions of ICS Calendar automatically applied a transparent background color to the calendar table, taking on whatever background color was on the container element. In version 8.4.0 this was changed so the table by default has a white background. The tablebg parameter was added to allow site admins to set a custom background color.

Note that you can use tablebg="transparent" to restore the old functionality.

Example Usage
[ics_calendar tablebg="#ffffff"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month
week
month-with-sidebar
widget
widget-availability
year-availability
year-with-sidebar

timeformat

Dates & Times → Time Format

Set the date display format.

Description

Note: This parameter was introduced in ICS Calendar v. 9.8.0, and the Calendar Builder option was introduced in ICS Calendar Pro v. 3.17.0.

By default ICS Calendar will display all times in the format in your general WordPress settings under Settings → General → Time Format.

To use a different time format in your ICS Calendar shortcode, use a value in standard PHP date format with the timeformat parameter.

ICS Calendar Pro users: Because ICS Calendar’s custom time formatting function only supports a subset of the PHP options, the Calendar Builder field is a dropdown of valid options rather than a freeform text input.

Why does ICS Calendar have its own custom function for time format? PHP date functions use a DateTime object. This object has special properties to deal with the complexities of timezones, Daylight Saving Time, etc. However, by the point in the process where ICS Calendar is manipulating time formats, these details have already been addressed and we simply need a way to manipulate the format of a text string, ignoring things like timezone logic. Because the DateTime can’t work with a simple text string, we needed to create our own function.

The custom function is really only designed to handle manipulations of 12- and 24-hour time, various ways of presenting “am/pm” labels, and other common time formatting options. Ironically, the function cannot handle any timezone-related parameters such as T, because those do require the timezone data from the DateTime object. But using the object at this point can result in a doubling of any timezone offsets from UTC. We are working on an updated version of the function that will better handle these parameters.

Example Usage
[ics_calendar timeformat="H:i"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

title

Header & Footer → Title

Set the overall title for the calendar display.

Accepted Values
Value Default Pro Description

true

 

 

Automatically displays the title of the calendar from the source feed (if the calendar only contains one feed)

false

Default

 

Hides the source calendar's title; does not display any title above the calendar

(custom text)

 

 

Displays the text entered, instead of the source calendar's title

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

The title parameter is optional. If omitted, the title provided by the calendar feed will be displayed. Use “false” (e.g. title="false") to hide the title altogether.

Note: This parameter’s default value was changed in ICS Calendar version 10.6

Example Usage
[ics_calendar title="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Customize Title and Description setting(s).

toggle

Events → Details Toggle

Set whether event details display in a hover box or toggle open/closed on click.

Accepted Values
Value Default Pro Description

(empty)

Default

 

Event descriptions display in a floating box when user hovers over an event.

true

 

 

Event descriptions display inline. (Option in Calendar Builder is inline.)

lightbox

 

 

Event descriptions display in a pop-up "lightbox."

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Note: This option’s functionality has been modified as of version 8.8.0.

By default, when eventdesc="true" is set, event descriptions display in a floating box when users hover over an event in table-based calendar views. In list view, the descriptions are displayed directly on the page below the event title.

The toggle option lets you change this behavior. Setting toggle="true" will make the event descriptions appear inline when the user clicks on an event’s title. Setting toggle="lightbox" will cause the description to appear in a pop-up “lightbox” when users click the event title. The lightbox option is especially well suited to calendars that tend to have very long event descriptions, as it allows a much larger space for displaying the descriptions.

Example Usage
[ics_calendar toggle="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Event Descriptions, Event Locations & Event Organizers setting(s).

tz

General → Timezone

Set the timezone for the calendar.

Description

By default, the feed will display events with times adjusted for the local timezone configured under Settings > General > Timezone. You can override the site’s timezone for individual feeds by adding the tz="TIMEZONE" parameter. You must use a valid named timezone value or the setting will be ignored and the site’s local timezone setting will be used. If your calendar is displaying multiple feeds, you can assign each a separate timezone override, as with feed labels or colors, by entering multiple values, pipe-delimited, in the same order as the feeds in the url parameter, e.g. tz="America/New_York|Europe/London|Pacific/Auckland". If you have multiple feeds but all are in the same timezone, you only need to enter the timezone once.

Example Usage
[ics_calendar tz="America/Chicago"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

tzinlegend

Pro Only
Header & Footer → Timezones in Legend

Display feed timezones in legend.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

true

 

Pro Only

Shows timezone for each feed in the legend

false

Default

Pro Only

Does not show timezones in the legend

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

If the legend is being used, this option will add the timezone for each feed to the legend. Helpful mainly in situations where the different source calendars have different timezones.

Example Usage
[ics_calendar tzinlegend="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Legend Style setting(s).

url

General → ICS Calendar Feed URL

Set the URL(s) of the source feed(s). This is a required parameter, unless you are using the Pro Calendar Builder.

Description

The ICS subscription URL for your feed.

It must be a subscription URL, not a URL that displays your calendar in a web view. (Loading the URL directly in your browser’s address bar should download an .ics file.) Enter multiple URLs, space- or pipe-delimited, to combine multiple feeds into one calendar display.

This is the only required parameter for the shortcode. (Exception: Calendar Builder-based saved calendars in Pro only need the id parameter.)

Example Usage
[ics_calendar url="https://example.com/calendar.ics"]

view

General → View

Set the display view. Default is month view.

Accepted Values
Value Default Pro Description

month

Default

 

Month table view (default)

list

 

 

Basic day-by-day list

week

 

 

Single week table view

grid

 

Pro Only

Day columns with hourly grid

month-with-sidebar

 

Pro Only

Month view with day list in sidebar

widget

 

Pro Only

Mini month with day list below

widget-availability

 

Pro Only

Mini month optimized for rental bookings

year-with-sidebar

 

Pro Only

Year-at-a-glance with day list in sidebar

year-availability

 

Pro Only

Year view optimized for rental bookings

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Determines which layout to use. View options included in the base plugin are "month", "week" and "list". Month view is the default, and this parameter can be omitted entirely. See Views for more details about each view.

Additional view options are available in the Pro version. While we generally recommend using the Calendar Builder to manage calendar settings in Pro, all Pro features can also be entered manually in a shortcode. The additional views currently available in Pro are: "grid", "month-with-sidebar", "widget", "year-availability" and "year-with-sidebar"

Example Usage
[ics_calendar view="month"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

weeknumbers

General → Week Numbers

Show week numbers in table.

Description

This option adds an extra column at the beginning of each row of the table, indicating the week number within the year.

Example Usage
[ics_calendar weeknumbers="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
month
week
month-with-sidebar
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

whitetext

Advanced → White Text

Invert the overall calendar display from dark-on-light to light-on-dark.

Description

Include whitetext="true" in your shortcode to force all text within the calendar to be white. Useful on pages with dark backgrounds.

Example Usage
[ics_calendar whitetext="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

zoom

Pro Only
General → Zoom

Set relative size of hours in grid view.

This parameter is available in ICS Calendar Pro only.

Accepted Values
Value Default Pro Description

FLOAT

 

Pro Only

Decimal numeric value for scaling the grid relative to a base value

Description

Sets the relative size of hour blocks in grid view. 1.0 is approximately equal to 100 pixels. The default value is 0.6.

Example Usage
[ics_calendar zoom="0.6"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views
grid
Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

No parameters matching your search criteria.

Room 34 Creative Services, LLC

  • Facebook
  • Instagram
  • YouTube
  • Room 34 Creative Services, LLC
  • Minneapolis, Minnesota 55406 USA
  • info@icscalendar.com
  • More WordPress Plugins
  • Privacy Policy
  • Terms & Conditions

Copyright © 2023 Room 34 Creative Services, LLC. All rights reserved.

https://icscalendar.com/icsdocs

This website uses cookies for necessary functions and to enhance your browsing experience. Accept to continue or find out more in our Privacy Policy.

Accept & Continue