Skip to main content

Installing & Updating

​Requirements

Solspace Calendar has mostly the same minimum requirements as listed on the ExpressionEngine Requirements page:

  • ExpressionEngine 7.x
  • PHP 8.0-8.3
  • PHP iconv enabled
  • MySQL 5.6 or newer

​Calendar currently only supports PHP 8.0 through 8.3.

  • PHP 8.4+ is not fully supported at this time because adding full compatibility would require dropping support for PHP 8.0 and 8.1.
  • Calendar 5.x no longer supports PHP 7.4. If your site requires PHP 7.4, please use Calendar 4.x instead.

​Installing Instructions

1

Unzip the Download Package

  • Open the EE7 folder.
  • Copy the calendar folder to your EE site's ./system/user/addons/ directory.
  • Within the themes folder, copy the calendar folder to your EE site's ./themes/user/ directory.
2

Install the Add-on

  • Go to the Add-Ons page in the EE control panel.
  • Find Calendar in the list, and click the Install button.

​Reserved Calendar field names

If you previously used regular ExpressionEngine fields for event dates or times before switching to Calendar, make sure those fields are not using names reserved by Calendar.

Avoid field names such as:

  • event_start_date
  • event_start_time
  • event_end_date
  • event_end_time

These names are reserved for Calendar and may cause template errors such as:

DateTime::__construct(): Failed to parse time string (0) at position 0 (0): Unexpected character

To resolve this, rename or remove any custom fields using reserved Calendar field names.

​Updating Instructions

Calendar has its own Update Service built in, which means that every time there's an update available, an Updates Available nav item will show up in the Calendar add-on area of the EE control panel. You can then review the changelog there, or view it here.

To download the update, simply click the Get Latest Version button, and you'll be taken to your account area on the EE Add-ons Store site where you can log in and download the updated package for Calendar. Then follow the steps below:

1

Prepare your Site

  • Inside your EE site's ./system/user/addons/ directory, delete the calendar folder.
  • Inside your EE site's ./themes/user/ directory, delete the calendar folder.
2

Unzip the Download Package

  • Open the EE7 folder.
  • Copy the calendar folder to your EE site's ./system/user/addons/ directory.
  • Within the themes folder, copy the calendar folder to your EE site's ./themes/user/ directory.
3

Update the Add-on

  • Go to the Add-Ons page in the EE control panel.
  • Click on the Updates tab near the top, and find Calendar in the list.
  • Click the Update button.

​Quick Setup

Follow the steps below to quickly get Solspace Calendar set up in minutes.

1

Customize and configure Solspace Calendar settings by visiting the Settings page (Add-Ons → Calendar → Preferences).

2

Create Calendar field(s), calendars, and set some preferences in the Preferences area of the Control Panel.

3

Install the Demo Templates (Add-Ons → Calendar → Preferences → Demo Templates) to get Calendar up and running on the front end with just a couple clicks!

Page Feedback