Installing & Updating
Requirements
Solspace Calendar 5.x is compatible with EE7 with mostly the same minimum requirements as listed on the ExpressionEngine Requirements page:
- ExpressionEngine 7.x
- PHP 7.4 or newer
- MySQL 5.6 or newer
- Windows and macOS browsers:
- Chrome 21 or newer
- Firefox 28 or newer
- Safari 9.0 or newer
- Microsoft Edge
Installing Instructions
- Unzip the download package:
- Select the EE version you're installing Calendar for (e.g. EE6-7 for EE 7.x).
- Within that EE version directory, copy the calendar folder into your sites ./system/user/addons/ directory.
- Within the themes folder of that EE version directory, copy the calendar folder into your site's ./themes/user/ directory.
- Go to the Add-Ons page and find Calendar in the list, and click Install.
- Setup and configuring:
- Before you start using Calendar, you'll need to create Calendar field(s), calendars, and set some preferences in the Preferences area of the Control Panel.
- If you wish to install the demo templates, click on the Demo Templates navigation item inside the Control Panel area.
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 Solspace site where you can log in and download the updated package for Calendar. Then follow the steps below:
- Within your EE site's ./system/user/addons/ and ./themes/user/ directories, delete the calendar folders.
- Unzip the download package:
- Select the EE version you're updating Calendar for (e.g. EE6-7 for EE 7.x).
- Within that EE version directory, copy the calendar folder into your sites ./system/user/addons/ directory.
- Within the themes folder of that EE version directory, copy the calendar folder into your site's ./themes/user/ directory.
- 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 setup in minutes.
- Customize and configure Solspace Calendar settings by visiting the Settings page (Developer > Add-Ons > Calendar > Settings).