Settings

Scan targets

All settings are under Keep It Peace → Settings. This page covers the General, Targets and Checks tabs.

General

SettingDescription
Scan frequencyDaily (default) or Weekly. Scheduled scans use WP-Cron.
Keep history forDays to keep scan history and resolved findings (30 by default, up to 365).
File baselineApprove 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

SettingDescription
Enabled checksSwitch each check on or off. Every check is described in the check reference.
Exclude patternsOne 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 analysis2,048 KB by default. Larger files are not analyzed for dangerous code.
Maximum files per target20,000 by default. 0 means no limit.