From cf742ab8196e85507c1d1ce3e8b3983b3f924b5d Mon Sep 17 00:00:00 2001 From: Kiel Date: Thu, 18 May 2023 01:02:05 +0100 Subject: [PATCH] Update Admin Options Documentation --- README.md | 44 +++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 41 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 21865dd..5928785 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,8 @@ ✔️ Email and admin notifications for packages that do not meet your desired integrity rating +✔️ Configure a safe list to reduce the noise generated by the scanner + ✔️ Supports Magento Open Source and Adobe Commerce ✔️ Theme agnostic @@ -28,9 +30,10 @@ composer require element119/module-sansec-composer-integrity-checker php bin/magento setup:upgrade ``` -It is also recommended that you enable the scans and lock the related config value as a post-installation step: +### Post-Installation Steps +It is also recommended that you enable the scans and lock the related config value: ```bash -php bin/magento config:set --lock-env system/sansec_composer_integrity_checker/scan_enable 1 +php bin/magento config:set --lock-config system/sansec_composer_integrity_checker/scan_enable 1 ```
@@ -90,9 +93,44 @@ series of email addresses that should be notified when packages fail to meet the
+### Enable Package Ignore List +Allows specified packages to be removed from various reporting channels. This feature is disabled by default but can +be enabled by setting this option to `Yes`. + +
+ +### Ignored Packages +This option is only considered when the package ignore list is enabled. These dynamic rows allow you to configure a +set of packages that should be ignored for various reporting channels. The values expected here are the Composer +package names in the format `vendor/package-name`. + +
+ +### Remove Ignored Packages from Admin Grid +This option is only considered when the package ignore list is enabled. This feature is disabled by default but can +be enabled by setting this option to `Yes`. When enabled, ignored packages will be removed from the admin grid. + +
+ +### Remove Ignored Packages from Admin Notifications +This option is only considered when the package ignore list is enabled. This feature is disabled by default but can +be enabled by setting this option to `Yes`. When enabled, ignored packages will not be considered when determining +whether to display the admin notification and the number of packages it reports as having failed to meet the +threshold. + +
+ +### Remove Ignored Packages from Email Notifications +This option is only considered when email notifications are enabled **and** when the package ignore list is enabled. +This feature is disabled by default but can be enabled by setting this option to `Yes`. When enabled, ignored +packages will be removed from email notifications. + +
+ ## 📸 Screenshots & GIFs ### Admin Configuration -![admin-config](https://user-images.githubusercontent.com/40261741/234102715-ed9e584e-da61-4a0f-9ae3-9f72bdde5524.png) +![admin-config](https://github.com/element119/module-sansec-composer-integrity-checker/assets/40261741/10f42c1a-adef-44f7-9390-1db9315d3ea7) +