OIntel v2.0.0

Manual installation

Via WP-CLI

BASHwp plugin install ointel.zip --activate
wp ointel scan

On activation / deactivation / uninstall

Deduction scale

Grade scale

Fix list & score history

The Top Items to Fix panel ranks actionable items (critical + warning) by severity first, then score_impact descending. Up to 5 items shown with estimated gain if resolved.

Every background scan stores the health score with a timestamp. The Dashboard shows a line chart of the last 30 scans for trend tracking.

Environment (15+ checks)

Plugin intelligence

Performance checks

Content checks

Taking snapshots

Diff comparison

Select any two snapshots from the dropdown selectors and click Compare. OIntel performs a field-by-field diff and returns: score delta, changed fields with before/after values, highlighted plugin version changes and active plugin count differences.

Retention

The Keep Last N Snapshots setting (default: 30, max: 100) automatically prunes older snapshots after each new one is taken.

Alert conditions

Channels (6 supported)

Email: Sends an HTML email to the configured alert address with a View Dashboard CTA button. Set alert_email to a comma-separated list.

Slack: Enter an Incoming Webhook URL in slack_webhook. Posts a formatted block message per alert.

Discord: Set discord_webhook to a Discord webhook URL. Posts a richly formatted embed.

Telegram: Set telegram_bot_token and telegram_chat_id to deliver Markdown messages to a chat or channel.

Generic webhook: Set generic_webhook to any HTTPS endpoint to receive a JSON payload (type, severity, message, fingerprint, timestamp).

PagerDuty: Set pagerduty_key (Events API v2 routing key). Critical alerts trigger an incident.

Weekly report: Enable Weekly Summary Report to receive a full HTML report every Monday at 08:00, including health score, all check results, and the fix list.

Alert log, dedupe & testing

All sent alerts are recorded in wp_ointel_alert_log with type, channel, recipient, status, fingerprint, and timestamp. Each alert is fingerprinted from (check_id, message); duplicates within alert_cooldown seconds are skipped to prevent spam. Click Send Test Alert on the Alerts tab to verify configuration without triggering a real scan.

Report contents

• Site name, URL, and report date
• Health score ring with letter grade (A–F)
• Critical / Warning / Info / OK counts
• Top 5 items to fix with estimated score impact
• Full check results grouped by category

Export: Reports → Export HTML Report → preview in iframe → Download HTML or Print / Save PDF via the browser print dialog.

White-label reports

Enable White-Label Reports in Settings to remove OIntel footer branding. Optionally supply a custom logo URL that appears at the top of exported reports. Designed for agencies delivering monthly health reports to clients.

WP-CLI export

BASHwp ointel report --file=/tmp/site-report.html

What the scanner does

Frequency & modes

Lightweight Mode skips TTFB measurement and the WPVulnDB API call. Recommended for resource-constrained hosting environments.

Manual trigger: Dashboard → Run Scan button calls OIntel_Scanner::run_manual() via AJAX.

GET /wp-json/ointel/v1/health-score

Returns the health score from the most recent scan.

JSON{
  "score":   87,
  "grade":   "B",
  "critical": 0,
  "warning":  3,
  "scanned": "2026-04-25 09:14:00"
}

GET /wp-json/ointel/v1/checks

Returns all check results from the last scan. Filter by ?status=critical|warning|info|ok.

JSON{
  "checks": [
    {
      "id":           "ssl",
      "category":     "Environment",
      "label":        "HTTPS / SSL",
      "status":       "ok",
      "message":      "HTTPS active",
      "detail":       "Site is served over HTTPS.",
      "score_impact": 0
    }
  ],
  "total": 28
}

GET /wp-json/ointel/v1/snapshots

Returns snapshot history. Query param: ?limit=10 (max 50).

POST /wp-json/ointel/v1/scan

Triggers a fresh scan. Requires manage_options.

JSON{
  "scan_id":  42,
  "score":    87,
  "critical": 0,
  "warning":  3,
  "duration": 1240,
  "checks":   51
}

v2 endpoints (scoped key auth)

All v2 routes mount under /wp-json/ointel/v2/. Pass X-OIntel-Key: ointel_xxxxx header (or stay logged in as an admin).

• GET /health-score, GET /checks, GET /snapshots (parity with v1)
• GET /cwv?url=&limit= Core Web Vitals readings for a URL
• POST /scan trigger scan, GET /scan-status poll for completion
• GET /fixes list available fixes, POST /fixes/preview, POST /fixes/run
• GET|POST /keys and GET|DELETE /keys/(?P<id>[\d]+) manage scoped API keys

wp ointel scan

Run a full health scan.

BASHwp ointel scan
wp ointel scan --format=json   # also supports: table (default), yaml

OUTPUT+----------+--------+
| Field    | Value  |
+----------+--------+
| Score    | 91/100 |
| Critical | 0      |
| Warnings | 2      |
| Checks   | 51     |
| Duration | 480ms  |
| Scan ID  | 42     |
+----------+--------+

wp ointel status

Print plugin health diagnostics: tables, cron, REST v1/v2, and schema versions.

BASHwp ointel status

wp ointel snapshot

BASHwp ointel snapshot                        # no label
wp ointel snapshot --label="Before plugin update"

wp ointel fix

Preview or run any of the 7 opt-in fixes (clean_transients, optimize_tables, trim_revisions, clean_orphaned_postmeta, clean_orphaned_usermeta, trash_orphaned_media, disable_debug_mode). Pass --dry-run to preview only.

BASHwp ointel fix clean_orphaned_postmeta --dry-run
wp ointel fix optimize_tables

wp ointel report

BASHwp ointel report                          # stdout
wp ointel report --file=/tmp/report.html  # write to file
wp ointel report --since="-7 days" --format=json

wp ointel alerts

BASHwp ointel alerts test               # dispatch a test alert across all configured channels
wp ointel alerts list --limit=20    # recent alerts from alert_log

ointel_checks

Add, remove, or modify checks in the health engine.

PHPadd_filter( 'ointel_checks', function( array $checks ): array {
    $checks[] = [
        'id'           => 'my_custom_check',
        'category'     => 'Environment',
        'label'        => 'My Custom Check',
        'status'       => 'ok',   // critical | warning | info | ok
        'message'      => 'Everything looks good.',
        'detail'       => 'Optional additional detail.',
        'score_impact' => 0,
    ];
    return $checks;
} );

ointel_snapshot_data

Add custom data fields to every snapshot.

PHPadd_filter( 'ointel_snapshot_data', function( array $data ): array {
    $data['woocommerce_product_count'] = wp_count_posts( 'product' )->publish ?? 0;
    return $data;
} );

ointel_alert_conditions

Add custom alert conditions that fire after every scan. The message key is a callable that receives the current checks array and health data.

PHPadd_filter( 'ointel_alert_conditions', function( array $conditions ): array {
    $conditions[] = [
        'type'    => 'my_custom_alert',
        'message' => function( array $checks, array $health ): string {
            return 'My custom alert triggered. Score: ' . $health['score'];
        },
    ];
    return $conditions;
} );

ointel_report_sections

Add custom sections to HTML reports.

PHPadd_filter( 'ointel_report_sections', function( array $sections ): array {
    $sections[] = [
        'title'  => 'WooCommerce Checks',
        'checks' => [
            [
                'label'   => 'Products',
                'status'  => 'ok',
                'message' => '142 published products',
                'detail'  => '',
            ],
        ],
    ];
    return $sections;
} );

ointel_snapshots

ointel_scan_log

ointel_alert_log

ointel_sessions & ointel_activity_log