From 2a23bb14557af1a135b94acbcca8349d4fe256c6 Mon Sep 17 00:00:00 2001 From: Thomas Vincent Date: Tue, 17 Nov 2026 20:33:02 -0800 Subject: [PATCH 1/3] docs: align README with source and published releases Signed-off-by: Thomas Vincent --- CHANGELOG.md | 3 +++ README.md | 18 ++++++++++++++++++ 2 files changed, 21 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8de45cd..21775bd 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. + --- develop --- * dev: Adopt the shared Cacti dashboarding Card API across both dashboards: the per-device Host Dashboard and the Fleet (Summary) Dashboard now drive their card grids through the shared `js/cards.js` (`CactiCards`) controller plus a thin shared `js/hmib_dashboard.js` adapter, the card markup uses the shared `.cc*` chrome contract, and the card-body charts (gauge, usage/distribution bars, min/avg/max bullet, stacked bar, stat tiles) use the shared `.cc*` chart-widget primitives. On Cacti 1.2.32+ the chrome and widgets come from core (`include/js/cards.js`, `include/css/cards.css`, `include/css/card-widgets.css`); on older cores hmib bundles its own byte-identical copies, gated by `file_exists`. Card header severity now uses the shared `data-severity` wash. No functional change to the dashboards * dev: Restore missing characters in the unmatched device-type regression test so PHP syntax checks and the test can run diff --git a/README.md b/README.md index f86c9c3..ca8194b 100644 --- a/README.md +++ b/README.md @@ -37,6 +37,24 @@ use the HMIB data for graphing instead of accessing the Cacti Devices directly for that information. This approach reduces Cacti polling times by removing the latency of obtaining the information from the Device. +## Versions and compatibility + +This README describes the `develop` source branch. + +| Code | Plugin version | Minimum Cacti declared in `INFO` | +| --- | --- | --- | +| [Source branch](INFO) | 3.5 | 1.2.25 | +| [Published v3.4](https://github.com/Cacti/plugin_hmib/releases/tag/v3.4) | 3.4 | 1.2.24 | + +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/hmib`**, using the directory +name `hmib` rather than `plugin_hmib`. + +See [CHANGELOG.md](CHANGELOG.md) for the version history. + ## Requirements * Cacti 1.2.25 or later. The plugin's INFO file declares `compat = 1.2.25`, and From 9f791b16354f4c54610050f650ac9805bc116b4e Mon Sep 17 00:00:00 2001 From: Thomas Vincent Date: Tue, 17 Nov 2026 20:56:44 -0800 Subject: [PATCH 2/3] docs: correct remaining setup and compatibility guidance Signed-off-by: Thomas Vincent --- README.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index ca8194b..b71b7bc 100644 --- a/README.md +++ b/README.md @@ -59,13 +59,13 @@ See [CHANGELOG.md](CHANGELOG.md) for the version history. * Cacti 1.2.25 or later. The plugin's INFO file declares `compat = 1.2.25`, and Cacti's Plugin Management page shows it as 'Requires: Cacti >= 1.2.25'. The - plugin was checked on Cacti 1.2.25, 1.2.32 and on the development branch. The - Graphs tab does not work on Cacti 1.2.32, because that release builds the - Graph Template filter with a function it declares only in graph_view.php. The - other tabs work on all three. + current plugin supplies a compatibility helper for the Graphs tab on Cacti + releases whose graph-template filter helper is otherwise loaded only by + `graph_view.php`. This avoids the older undefined-function failure on 1.2.32. * PHP 8.0 or later. setup.php and hmib.php use union types, so they do not - parse on PHP 7.4. The plugin's automated tests run on PHP 8.2, 8.3 and 8.4. + parse on PHP 7.4. Use the higher of the plugin and Cacti PHP requirements. + The integration workflow covers PHP 8.2 through 8.5, with PHP 8.6 experimental. * MariaDB or MySQL, the database Cacti itself uses. The plugin creates its tables itself; see 'Database tables'. @@ -371,7 +371,8 @@ be loaded by the tests and are not measured. GitHub Actions (.github/workflows/plugin-ci-workflow.yml) runs on pushes and pull requests to main and develop. It installs Cacti 1.2.x and the plugin on a -MariaDB 11.8 database with PHP 8.2, 8.3 and 8.4, checks the manifest, runs +MariaDB 11.8 database with PHP 8.2 through 8.5 (plus an experimental PHP 8.6 +job), checks the manifest, runs `php -l` on every PHP file, runs the tests with coverage, and then runs a Cacti poller cycle. On pull requests it also runs the gettext check and the coverage check. From 3cee31abdaba0deb8cc19dc34448d6acef8f04d0 Mon Sep 17 00:00:00 2001 From: Thomas Vincent Date: Wed, 18 Nov 2026 16:51:39 -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 b71b7bc..13c6a33 100644 --- a/README.md +++ b/README.md @@ -43,7 +43,7 @@ This README describes the `develop` source branch. | Code | Plugin version | Minimum Cacti declared in `INFO` | | --- | --- | --- | -| [Source branch](INFO) | 3.5 | 1.2.25 | +| [Source branch](https://github.com/Cacti/plugin_hmib/blob/develop/INFO) | 3.5 | 1.2.25 | | [Published v3.4](https://github.com/Cacti/plugin_hmib/releases/tag/v3.4) | 3.4 | 1.2.24 | Use the published release’s assets and tagged documentation when installing that @@ -53,7 +53,7 @@ matches the release. Cacti’s own PHP and database requirements also apply. Install this plugin in **`/plugins/hmib`**, using the directory name `hmib` rather than `plugin_hmib`. -See [CHANGELOG.md](CHANGELOG.md) for the version history. +See [CHANGELOG.md](https://github.com/Cacti/plugin_hmib/blob/develop/CHANGELOG.md) for the version history. ## Requirements