Installing & Updating

Requirements

Solspace Calendar mostly meets the same requirements as listed on the Craft Requirements page.

  • Craft 3.0.0 or later
  • PHP 7.0+
  • MySQL 5.5+ (with InnoDB) or PostgreSQL 9.5+
  • Windows and OS X browsers:
    • Chrome 29 or later
    • Firefox 28 or later
    • Safari 9.0 or later
    • Internet Explorer 11 or later
    • Microsoft Edge

Installing Instructions

Install from the Control Panel

  1. Go to the Plugin Store area inside your Craft control panel and search for Calendar.
  2. Choose Calendar by clicking on it.
  3. Click on the Try button to install a trial copy of Calendar.
  4. Try things out and if Calendar is right for your site, purchase a copy of it through the Plugin Store when you're ready!
  5. See quick setup guide below.

Installation

Installing from the Terminal

Calendar can also be installed manually through Composer:

  1. Open your terminal and go to your Craft project: cd /path/to/project
  2. Then tell Composer to require the plugin: composer require solspace/craft3-calendar
  3. In the Craft control panel, go to Settings → Plugins and click the Install button for Calendar.
  4. Try things out and if Calendar is right for your site, purchase a copy of it through the Plugin Store when you're ready!
  5. See quick setup guide below.

Quick Setup

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

  1. Customize and configure Solspace Calendar settings by visiting the Settings page (Calendar > Settings).
  2. Calendar ties into regular Craft User Group Permissions. Simply visit the Craft permissions page for the applicable user group(s) (Settings > Users > User Groups) to grant/edit/remove permissions to Calendar. See Permissions documentation for more information.
  3. Install the Demo Templates (Calendar > Settings > Demo Templates) to get Calendar up and running on the front end with just a couple clicks!

Updating Instructions

Updating is easy. Calendar uses the Craft Updates Service, which means that every time there's an update available, it'll show up in the Updates area (Utilities -> Updates) of the Craft control panel. You can then review the changelog there, or view it here.

Updating from the Control Panel

  1. Go to the Craft Updates area inside the control panel (Utilities -> Updates) and review the changelog for Calendar.
  2. Simply click the Update button and Craft will do the rest.

Craft Updates Service

Craft 3.0.38+ / 3.1.4+ introduced an update command...

  1. Open your terminal and go to your Craft project: cd /path/to/project
  2. To see available updates, run this command: ./craft update
  3. Follow the prompts, or run ./craft update calendar
    • To update to a specific version of Calendar, run ./craft update calendar:2.0.13

Update via Terminal

Updating with Composer from the Terminal

You can also update Calendar more manually if you like, using Composer (composer update). This may also be helpful in certain scenarios where you need to workaround an issue while updating.

  1. Open your Craft site's main composer.json file and adjust the version number for the applicable plugin(s) (see guide below).
  2. Open your terminal and go to your Craft project: cd /path/to/project
  3. To run any available updates for your site, run composer update
  4. Proceed to Craft control panel and click the Finish Updates button if it shows.

Understanding versions and composer update

  • For example, under the "require" area, change "solspace/craft3-calendar": "2.0.5", to "solspace/craft3-calendar": "2.0.15",.
  • You can also use ~ and ^ to somewhat automate your updating process.
    • 1.0.0 - means exactly & only this version
    • ~1.0.0 - means this version & any patch release (up to 1.0.99̅)
    • ^1.0.0 - means this version & any minor release (up to 1.99̅.99̅)
      • Specifying "solspace/craft3-calendar": "^2.0.0", for example, would always get you the latest version of Calendar 2.x (e.g. 2.1.3), but never a next major version of Calendar like 3.x.

Your final composer.json file might have something like this:








 


"require": {
  "php": ">=7.0.0",
  "craftcms/cms": "^3.1.0",
  "vlucas/phpdotenv": "v2.4.0",
  "solspace/craft3-freeform": "^2.5.0",
  "solspace/craft3-freeform-pro": "^2.5.0",
  "solspace/craft3-freeform-payments": "~1.0.0",
  "solspace/craft3-calendar": "^2.0.0",
},
1
2
3
4
5
6
7
8
9

Trialing & Purchasing

Trialing

The great thing about Craft 3 is that it allows you to trial third party plugins to see if they're right for your needs. We recommend trying any commercial plugin first before buying it. You trial any plugin or Craft CMS itself by running your site from any domain that Craft does not consider to be a public domain. Common examples of domains that would work include:

  • localhost
  • 127.0.0.1
  • mysite.test
  • testing.mysite.com
  • mysite.yolo
  • mysite.com:1234
  • mysite.test

Go to Plugin Store area of your Craft 3 control panel and browse for any plugins you may need. Take note of how many installs each plugin has and when they were last updated to give you insight into how popular and maintained they are. When you've found the plugin you like, you can either click the Try button in the Plugin Store, or follow the Installing Instructions above.

Users then have the option of purchasing a valid license for plugins either directly through the Craft 3 Control Panel, or via the Craft Plugin Store website.

Purchasing

If this is your first time purchasing a third party plugin, here's an overview of the purchasing process of plugins:

  1. Go to the Plugins section of your Craft 3 control panel (Craft CP -> Settings -> Plugins).
  2. For the plugin(s) that need purchasing, click on the Buy now button to add it to your cart.
  3. Proceed to purchasing the plugin directly inside your Craft 3 control panel. You can optionally pre-purchase renewal years as well if you think you're going to need updates and product support beyond the first year. You can also purchase renewals later on after expiry if you wish.
  4. Once purchased, you'll receive a product license key(s) for the plugin(s). These product keys can also be accessed and managed later on in your Craft ID account by visiting the Plugins area.
  5. Paste your Craft 3 plugin license key (24 digits long, e.g. X1X1-X1X1-X1X1-X1X1-X1X1-X1X1) in the License field for the plugin (under Craft CP -> Settings -> Plugins). As soon as it's pasted, Craft will attempt to validate it (do not click anything else such as the Buy now button).
  6. That's it! If you see any errors, please see Troubleshooting documentation below...

Troubleshooting

Third party plugin licenses are managed and validated entirely by Craft. Some issues may require that you contact the Craft Team directly if issues persist. The following troubleshooting tips account for most common issues we've seen our customers report to us:

Purchasing Troubleshooting

'This license is tied to another Craft install' (Example C)

If you receive the error This license is tied to another Craft install. Visit id.craftcms.com to resolve., it is indicating that the license is tied to another install of Craft CMS. This is likely because either you purchased this under a different domain or subdomain, or something glitched in the process of purchasing the license. Regardless of what happened here, this can likely be resolved by:

  1. Visit your Craft ID account.
  2. Under Licenses -> Plugins, look for the Calendar (or affected plugin) license in the list and confirm it's tied to the correct Craft CMS license. If not, click into the license (e.g. CRZ6) and click on the Detach from this Craft license button. This will release it from being attached to the wrong or orphaned Craft CMS license and allow you to enter it into the Craft install you're using.

If you are moving an existing site to a new non-public domain from a different local host name, you will need to clear your data caches from the Clear Caches tool on the Settings page before Craft will realize that the host name has changed.

'Your license key is invalid' (Example A)

If you receive the error Your license key is invalid., it is indicating that the license you've entered is not valid. It could be that you copy/pasted the license key wrong, or more likely it's that you're attempting to use an old Solspace-generated license of Calendar 1.x for Craft 2.x. These licenses are NOT the same. If you have an old Calendar 1.x for Craft 2.x license on a site you'd like to upgrade to Craft 3, or you accidentally purchased your Calendar 2.x license for Craft 3.x on the Solspace website, you'll need to contact us to request that we transfer your license over to the Craft 3 Plugin Store, where a new and valid Craft 3 license will be generated.

For any Craft 2 licenses you'd like to transfer over to Craft 3, please contact us and let us know the following info:

  • Your Solspace.com account email address
  • Plugin name & Solspace license key (listed together if you have more than 1 to transfer)
  • Your Craft ID account email address

If upgrading from Craft 2 to Craft 3, it's worth reading our "Everything you need to know about Solspace plugins & Craft 3" article.

Plugin shows it's 'Missing' (Example D)

If you have a plugin that shows as Missing, this is because you don't have the plugin installed and/or the plugin files are not in the Craft vendor folder, BUT you have a valid purchased Craft 3 license for the plugin tied to that Craft install. Depending on your scenario, you likely either have the issue of wanting the plugin to be available, or not wanting it to show up there.

If you purchased the plugin and are expecting it to show up for install, what likely happened is that Craft or your server environment glitched and didn't correctly add the plugin dependency (files) to your Craft site's vendor folder (but knows that you have a valid purchase of it). If this is the case, you'll need to follow the Installation Instructions documentation above to install the plugin.

If the above is not the case for you, and you don't want this license showing up in your Craft site, this can likely be resolved by:

  1. Visit your Craft ID account.
  2. Under Licenses -> Plugins, look for the Calendar (or affected plugin) license in the list and confirm it's tied to the correct Craft CMS license. If not, click into the license (e.g. CRZ6) and click on the Detach from this Craft license button. This will release it from being attached to the wrong or orphaned Craft CMS license, and later use it on the correct/different Craft install.
Last Updated: 2/25/2019, 4:26:57 PM