History

Every import and export is saved in History. You can see what ran, when, how long it took, and what happened.

Page URL: /wp-admin/admin.php?page=wkaie-history

Page title: "Import/Export History" (with a backup icon)

History page — every run with filters, status badges, and actions.

Filter Bar

Five filter controls at the top.

Buttons

• Filter (blue primary button, filter icon) — apply filters
• Reset (gray button) — clear all filters

Summary Line

Above the table, you see: "[X] run(s) found."

History Table

Columns in Exact Order

Status Badge Colors

Records Column Display

For successful runs:

Shows color-coded numbers separated by slashes:

• Created (green)
• Updated (blue)
• Skipped (orange)
• Failed (red)

Example: 850 / 120 / 15 / 0

For failed runs that did not start:

Instead of 0 / 0 / 0 / 0, the column shows the error message in red:

"File could not be opened"

Or: "Run did not start"

Click a Row

Click any row to open the run's detail view. You see:

• Summary card: counts, status, duration
• Phase breakdown (time per phase)
• Source info: file name, size, row count
• Target info: entity, mode, match key
• Column mapping used
• Error details (if failed)
• Log preview (first 100 lines)

Each history row drills into this detailed result view with record counts, timings, and a Rollback button.

Action Buttons Per Row

Rollback Confirmation

Click Rollback shows this dialog:

"Are you sure you want to rollback this import? This cannot be undone."

Click OK to proceed. See Rollback.

Pagination

At the bottom, if there are multiple pages:

• Total count: "[X] item(s)"
• Page nav: « ‹ [current] of [total] › »

Empty State

If no runs match filters:

"No import/export history found matching your filters."

Log Files

Every run writes a log file to wp-content/uploads/wkaie-logs/.

Log Contents

• Timestamp of each phase
• SQL queries run
• Row-level errors (if any)
• Image download results
• Memory usage
• Total timing

Log Levels

Set in Settings → Performance & Advanced → Log Level:

Log Retention

Old logs auto-delete. Default: 30 days.

Change in Settings → Performance & Advanced → Log Retention (Days).

Download Log

Click Download Log on any run row.

You get a .txt file you can open in any text editor. Useful for support tickets.

Deleting Old History

Auto Cleanup

Based on retention setting in Performance & Advanced tab.

Manual via WP-CLI

# All history older than 30 days
wp wkaie history cleanup --older-than=30d

# Specific job
wp wkaie history cleanup --job_id=42

# Successful runs only (keep failed for investigation)
wp wkaie history cleanup --status=success --older-than=7d

Manual via Admin UI

History page → select rows → Bulk action → Delete.

Audit Trail

Every action is logged:

• Who triggered the run (logged-in user, "Schedule", or "API")
• IP address
• Job
• Timestamp

Useful for compliance (GDPR, SOC 2).

Integration With Dashboard

The Recent Activity feed on the Dashboard shows the last 10 runs. Click to jump to full History.

The Failed (Last 24h) card shows failed count. Click to filter History.

Troubleshooting

Related Pages

• Dashboard — Recent activity at a glance
• Rollback — Undo a run
• Troubleshooting — Fix failed runs
• Settings — Log level and retention
• WP-CLI — Clean up history from command line