mirror of
https://github.com/Cacti/plugin_monitor.git
synced 2026-10-23 03:26:42 +09:00
TheWitnessandCopilot
66358e0998
* Relocate schema to includes/database.php via plugin table API + db_update_table upgrade * CI: allowlist unmeasured schema bootstrap and web entry points * CI: keep include_once for the settings-page-only lib/reports.php load (uncoverable) * Add manifest.json + upgrade-time file pruning; consolidate themes/ into css/ * database: keep user-owned dashboards table across uninstall api_plugin_db_table_create() records plugin_monitor_dashboards in plugin_db_changes, so api_plugin_db_changes_remove() (run by api_plugin_uninstall() after plugin_monitor_uninstall()) would drop it even though monitor_drop_tables() intentionally leaves it in place. Remove the 'create' ownership record after provisioning (install and upgrade paths) so user dashboards survive an uninstall. Adds a regression test. * Prune phpunit.xml on upgrade and ignore markdown-lint configs phpunit.xml ships in the repo for CI but is a dev-only test artifact, so it is removed from manifest.json 'expected', pruned from installs on upgrade (like tests/), and excluded from the manifest drift check. The retired markdown-lint configs (.mdlrc, .md_style.rb) are deleted, and .md* is now ignored like .git*: protected from pruning and excluded from drift if it reappears. * Move libraries into includes/, flatten css, drop sonar config db_functions.php, monitor_render.php and monitor_controller.php move into includes/ (the latter two lose the monitor_ prefix, becoming render.php and controller.php); monitor.php and the tests load them from there. Each per-theme stylesheet css/<theme>/monitor.css becomes css/<theme>.css so users can drop their own css/<theme>.css into the css base, and plugin_monitor_page_head() looks there, falling back to css/monitor.css. The unreferenced sonar-project.properties is removed. Old paths are tombstoned so existing installs drop the stale copies on upgrade. * Rename includes/db_functions.php to includes/functions.php Follows the fleet convention for the plugin's shared library filename; monitor.php, the measured-source list and the unit test load it from the new name. * Regenerate cacti.pot for the includes/ file relocations Moving the plugin's library files into includes/ changed the source-reference lines in the translation template; regenerate it so the 'Verify translation template' CI check passes. * Harden prune against tampered-manifest path traversal The upgrade-time prune now rejects any tombstone containing '.'/'..' segments (which could escape the plugin directory or resolve to its root) and treats ancestors of whitelist entries as protected, so a tombstone on a parent directory can no longer delete a whitelisted file beneath it. * docs: update and align the Project Structure block Point the structure tree at the relocated files (libraries now under includes/, data files under docs/, stylesheets under css/) and align the trailing '# ...' comments to a single column so they no longer drift right. * docs/tests: standardize test header and correct manifest-contract notes - Use the full license header (from the plugin's own setup.php) in tests/Unit/PruneFilesTest.php instead of the abbreviated copyright banner. - Document that the manifest drift check and the upgrade-time prune also handle phpunit.xml and .md* files, matching the implemented behavior. * refactor: rename prune helpers to the plugin-slug function prefix The repository naming contract reserves the plugin_<name>_ prefix for plugin lifecycle / hook-registration functions; all other functions use the plain <name>_ prefix. Rename the internal upgrade helpers accordingly: plugin_<name>_prune_files() -> <name>_prune_files() plugin_<name>_rmtree() -> <name>_rmtree() The call site, unit tests, and the copilot-instructions.md references are updated to match. No behavioral change. * chore: set the Cacti compatibility floor to 1.2.29 Align the compat metadata (and the contributor-guide references) with the team decision to standardize the minimum supported Cacti version at 1.2.29; the previously proposed 1.2.32 floor was not adopted. * Bump plugin version to 3.0 so the upgrade-time cleanup migration runs Add a 3.0 CHANGELOG section for this cycle's schema/manifest work and set INFO version = 3.0 so existing 2.9 installs detect the version change and run the schema refresh and manifest-based file prune. --------- Co-authored-by: Copilot <copilot@users.noreply.github.com>
59 lines
1.7 KiB
PHP
59 lines
1.7 KiB
PHP
<?php
|
|
/*
|
|
+-------------------------------------------------------------------------+
|
|
| Copyright (C) 2004-2026 The Cacti Group |
|
|
+-------------------------------------------------------------------------+
|
|
*/
|
|
|
|
/*
|
|
* Unit coverage for plugin_monitor_page_head()'s stylesheet selection in
|
|
* setup.php, including the per-theme override loaded from css/<theme>.css.
|
|
*/
|
|
|
|
beforeAll(function () {
|
|
require_once __DIR__ . '/../../setup.php';
|
|
});
|
|
|
|
afterEach(function () {
|
|
unset($GLOBALS['__test_selected_theme']);
|
|
});
|
|
|
|
it('links the per-theme stylesheet from css/ when it exists', function () {
|
|
$restore = $GLOBALS['config']['base_path'];
|
|
$base = sys_get_temp_dir() . '/monitor-ph-' . uniqid();
|
|
mkdir($base . '/plugins/monitor/css', 0777, true);
|
|
file_put_contents($base . '/plugins/monitor/css/modern.css', '');
|
|
$GLOBALS['__test_selected_theme'] = 'modern';
|
|
$GLOBALS['config']['base_path'] = $base;
|
|
|
|
ob_start();
|
|
|
|
try {
|
|
plugin_monitor_page_head();
|
|
} finally {
|
|
$output = ob_get_clean();
|
|
$GLOBALS['config']['base_path'] = $restore;
|
|
}
|
|
|
|
expect($output)->toContain('plugins/monitor/css/modern.css');
|
|
});
|
|
|
|
it('emits only the base stylesheet when no per-theme override exists', function () {
|
|
$restore = $GLOBALS['config']['base_path'];
|
|
$base = sys_get_temp_dir() . '/monitor-ph-' . uniqid();
|
|
mkdir($base . '/plugins/monitor/css', 0777, true);
|
|
$GLOBALS['__test_selected_theme'] = 'no-such-theme';
|
|
$GLOBALS['config']['base_path'] = $base;
|
|
|
|
ob_start();
|
|
|
|
try {
|
|
plugin_monitor_page_head();
|
|
} finally {
|
|
$output = ob_get_clean();
|
|
$GLOBALS['config']['base_path'] = $restore;
|
|
}
|
|
|
|
expect($output)->toContain('plugins/monitor/css/monitor.css');
|
|
});
|