All settings are under Keep It Peace → Settings. This page covers the General, Targets and Checks tabs.
General
| Setting | Description |
|---|---|
| Scan frequency | Daily (default) or Weekly. Scheduled scans use WP-Cron. |
| Keep history for | Days to keep scan history and resolved findings (30 by default, up to 365). |
| File baseline | Approve the current files of a target, or of all targets, as the trusted state. See Approving the baseline. |
Targets
Themes to scan
When nothing is selected, the active theme and its parent are scanned.
Plugins to scan
Select plugins you or your client developed. Plugins distributed on WordPress.org are not scanned because they are maintained and checked for vulnerabilities by their authors and WordPress.org. Must-use plugins (mu-plugins) can be selected too. Single-file plugins placed directly in the plugins folder are not listed.
If WordPress has not checked plugin updates yet, plugins from WordPress.org cannot be told apart. Open Dashboard → Updates once and reload the settings page.
Directories outside WordPress
Other programs on the same server, such as a landing page, a form mailer or a legacy application, get the same file checks as themes.
- Path: the absolute path on the server. The directory must be readable by PHP and inside
open_basedir. WordPress itself, themes and plugins cannot be registered here. - Label: the name shown on the screens.
- Public URL (optional): used by the external checks.
- Checks and exclusions: the file checks to run for this directory and additional exclude patterns.
The path, read permission, open_basedir and overlap with WordPress are validated when you save. “Paths on this server (for reference)” helps you enter the path. You can add several directories at once; empty rows are ignored.
Additional URLs for external checks
One URL per line. The site address is always checked. Only URLs on your own domain (including subdomains) are accepted. On shared hosting domains (such as xsrv.jp), other users’ subdomains are never targeted. Other hosts must be allowed with the keepitpeace_allowed_hosts filter.
Checks
| Setting | Description |
|---|---|
| Enabled checks | Switch each check on or off. Every check is described in the check reference. |
| Exclude patterns | One pattern per line. Without “/” a pattern matches any file or folder name (e.g. node_modules, *.min.js). With “/” it matches the path from the target root (e.g. assets/vendor/*). Defaults: node_modules, vendor, .git, .svn, cache. |
| Maximum file size for code analysis | 2,048 KB by default. Larger files are not analyzed for dangerous code. |
| Maximum files per target | 20,000 by default. 0 means no limit. |