Update Checker plugin for Craft CMS 3
Automated update checker that notifies you of any pending updates.
Support Open Source
This plugin is licensed under an MIT license, which means that it's completely free open source software, and you can use it for whatever and however you wish. If you find this plugin useful, please consider supporting my work by buying me a beer
This plugin requires Craft CMS 3.0.0 or later.
To install the plugin, either install via the plugin store or follow these instructions.
Open your terminal and go to your Craft project:
Then tell Composer to load the plugin:
composer require lukeyouell/craft-updatechecker
In the Control Panel, go to Settings → Plugins and click the “Install” button for Update Checker.
You can choose from a combination of the following notification methods:
An email will be sent to a list of comma-separated email addresses.
Notifications will be sent to a Slack Channel of your choosing.
You can find your endpoint url located in the plugin settings page, which will look like this:
Securing Your Endpoint
You can secure your endpoint with an access key, which is set in the plugin settings.
After defining your access key you will need to include it in your requests in the form of the following header:
|Header Name||Header Value|
Update Checker relies on the endpoint being hit on a regular basis, which will require a cron job. If you aren't familiar with setting up cron jobs I highly recommend using a service such as SetCronJob.
HTTP requests headers:
|Header Name||Header Value||Required|
Feel free to set the cron job to check for updates as often as you like.
Overriding Plugin Settings
If you create a config file in your
config folder called
update-checker.php, you can override the plugin’s settings in the Control Panel. Since that config file is fully multi-environment aware, this is a handy way to have different settings across multiple environments.
Here’s what that config file might look like along with a list of all of the possible values you can override.
<?php return [ 'accessKey' => '6AIXCV7FoF5pvN4BiNE9xANtFUcy3CUr', 'email' => true, 'toEmail' => 'firstname.lastname@example.org, email@example.com', 'slack' => true, 'slackWebhook' => 'https://hooks.slack.com/services/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w', ];
Update Checker Roadmap
Some things to do, and ideas for potential features:
- Ability to define which Slack channel to post updates to
Brought to you by Luke Youell