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.4
  • PHP iconv enabled
  • MySQL 5.6 or newer

Calendar 5.x no longer supports PHP 7.4. If you require PHP 7.4 support, please use Calendar 4.x.

​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. Go to the Add-Ons page and find Calendar in the list, and click Install.

If you had a previous non-Calendar flow setup where you used regular EE fields acting as Start/End Dates and Start/End Times and you're slowly transitioning from that to Calendar, please be sure that any of fields these are not named something like: event_start_date, event_start_time, event_end_date, event_end_time, etc. These are reserved names for Calendar's use, and will cause errors like DateTime::__construct(): Failed to parse time string (0) at position 0 (0): Unexpected character in your templates if you do not rename or remove the other fields.

​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. Within your EE site's ./system/user/addons/ and ./themes/user/ directories, delete the calendar folders.
  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. Go to the Add-Ons page, click on the Updates tab near the top, and find Calendar in the list, and 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