lukeyouell / craft-updatechecker
Automated update checker that notifies you of any pending updates
Installs: 1 603
Dependents: 0
Suggesters: 0
Security: 0
Stars: 11
Watchers: 0
Forks: 1
Open Issues: 3
Type:craft-plugin
Requires
- craftcms/cms: ^3.0.0
This package is not auto-updated.
Last update: 2019-11-16 17:15:09 UTC
README
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 🍻😊
Requirements
This plugin requires Craft CMS 3.0.0 or later.
Installation
To install the plugin, either install via the plugin store or follow these instructions.
-
Open your terminal and go to your Craft project:
cd /path/to/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.
Notification Methods
You can choose from a combination of the following notification methods:
An email will be sent to a list of comma-separated email addresses.
Slack
Notifications will be sent to a Slack Channel of your choosing.
This requires the creation of a Slack Webhook, which you can do here.
Endpoint
Endpoint URL
You can find your endpoint url located in the plugin settings page, which will look like this:
https://www.yoursite.co.uk/actions/update-checker/check
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 |
---|---|
Access-Key |
access-key-value |
Cron Job
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 |
---|---|---|
Accept |
application/json |
Required |
Access-Key |
access-key-value |
Optional |
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' => 'joe.bloggs@email.co.uk, jane.bloggs@email.co.uk', '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