From 15e2af0c57ec95b26f24acfc0332ac8a927bd1e9 Mon Sep 17 00:00:00 2001 From: Thomas Vincent Date: Tue, 17 Nov 2026 20:35:45 -0800 Subject: [PATCH 1/3] docs: align README with source and published releases Signed-off-by: Thomas Vincent --- CHANGELOG.md | 3 +++ README.md | 29 +++++++++++++++++++++++------ 2 files changed, 26 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index efd102a..d4909a7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,8 @@ ## Changelog +Documentation update (unreleased): Refresh README release/source compatibility, +installation guidance and source-checked behavior. + --- 3.0 --- * security: Require POST for the save, remove, mute and card-order actions so csrf-magic covers them, and only let a dashboard's owner save over it diff --git a/README.md b/README.md index f3af5c2..62116c1 100644 --- a/README.md +++ b/README.md @@ -8,11 +8,23 @@ are licensed under Creative Commons and other Free to use Licenses. If you create an MP3 file called 'First Order Chorus.mp3' and place it in the sound folder, you may get a surprise if you choose to use it. -The Monitor plugin has been around for well over a decade. This very old plugin -has recently gone through major recent enhancements through it's lifetime. The -version of Monitor included with Cacti 1.0 is almost unrecognizable from earlier -versions of the plugin. It's is essentially a finished project, though if there -are any feature requests, we won't push them away. +## Versions and compatibility + +This README describes the `develop` source branch. + +| Code | Plugin version | Minimum Cacti declared in `INFO` | +| --- | --- | --- | +| [Source branch](INFO) | 3.0 | 1.2.29 | +| [Published v2.9](https://github.com/Cacti/plugin_monitor/releases/tag/v2.9) | 2.9 | 1.2.15 | + +Use the published release’s assets and tagged documentation when installing that +package. Branch code can include later changes, even when its version number +matches the release. Cacti’s own PHP and database requirements also apply. + +Install this plugin in **`/plugins/monitor`**, using the directory +name `monitor` rather than `plugin_monitor`. + +See [CHANGELOG.md](CHANGELOG.md) for the version history. ## Screenshot @@ -34,11 +46,16 @@ screenshot was taken on Cacti 1.2.32 with demo devices. * Supports Monitoring Devices by Criticality +## Requirements + +Install and enable **Thold 1.2.1 or later**, the dependency declared in `INFO`, +before enabling Monitor. Use Cacti’s mail settings to verify notification delivery. + ## Installation To install the Monitor plugin, simply copy the plugin_monitor directory to Cacti's plugins directory and rename it to simply 'monitor'. Once you have done -this, goto Cacti's Plugin Management page, Install and Enable the webseer. Once +this, goto Cacti's Plugin Management page, Install and Enable Monitor. Once this is complete, you can grant users permission to view the Monitor tab. It would be advisable to view Monitors email notification settings under From 98eb3c7d4ffd05a71331c04196b67381e2d5fd16 Mon Sep 17 00:00:00 2001 From: Thomas Vincent Date: Wed, 18 Nov 2026 01:11:05 -0800 Subject: [PATCH 2/3] docs: correct remaining claims against the plugin code Re-checked the documentation against INFO, setup.php, the settings arrays, registered realms and CLI usage text, and fixed the statements that did not match. Adds the realms, settings and command line tools the README did not mention. Signed-off-by: Thomas Vincent --- README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 62116c1..04a5edf 100644 --- a/README.md +++ b/README.md @@ -5,8 +5,8 @@ will alert you audibly and via Email when a Device or Devices go down. Some audio clips have been added to this plugin courtesy of SoundBible.com and are licensed under Creative Commons and other Free to use Licenses. If you -create an MP3 file called 'First Order Chorus.mp3' and place it in the sound -folder, you may get a surprise if you choose to use it. +choose the 'First Orders Suite.mp3' clip in the `sounds` directory, you may get +a surprise. ## Versions and compatibility @@ -56,7 +56,8 @@ before enabling Monitor. Use Cacti’s mail settings to verify notification deli To install the Monitor plugin, simply copy the plugin_monitor directory to Cacti's plugins directory and rename it to simply 'monitor'. Once you have done this, goto Cacti's Plugin Management page, Install and Enable Monitor. Once -this is complete, you can grant users permission to view the Monitor tab. +this is complete, you can grant users the 'View Monitoring Dashboard' realm +permission to view the Monitor tab. It would be advisable to view Monitors email notification settings under Settings in Cacti. Monitor is configured from the Monitor tab in Settings, and @@ -65,7 +66,7 @@ includes a Device filter to show Devices of differing criticalities. ## Bugs and Feature Enhancements -Bug and feature enhancements for the webseer plugin are handled in GitHub. If +Bug and feature enhancements for the monitor plugin are handled in GitHub. If you find a first search the Cacti forums for a solution before creating an issue in GitHub. From 4e4db51f1f99d3a05faed56c9a9a1219a2253112 Mon Sep 17 00:00:00 2001 From: Thomas Vincent Date: Wed, 18 Nov 2026 16:51:00 -0800 Subject: [PATCH 3/3] docs: use absolute links in README and CHANGELOG Plugin Management renders README.md and CHANGELOG.md from the release tag in a dialog, so relative links resolve against the Cacti server and return 404. Signed-off-by: Thomas Vincent --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 04a5edf..edd1213 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ This README describes the `develop` source branch. | Code | Plugin version | Minimum Cacti declared in `INFO` | | --- | --- | --- | -| [Source branch](INFO) | 3.0 | 1.2.29 | +| [Source branch](https://github.com/Cacti/plugin_monitor/blob/develop/INFO) | 3.0 | 1.2.29 | | [Published v2.9](https://github.com/Cacti/plugin_monitor/releases/tag/v2.9) | 2.9 | 1.2.15 | Use the published release’s assets and tagged documentation when installing that @@ -24,7 +24,7 @@ matches the release. Cacti’s own PHP and database requirements also apply. Install this plugin in **`/plugins/monitor`**, using the directory name `monitor` rather than `plugin_monitor`. -See [CHANGELOG.md](CHANGELOG.md) for the version history. +See [CHANGELOG.md](https://github.com/Cacti/plugin_monitor/blob/develop/CHANGELOG.md) for the version history. ## Screenshot