How to set up and use Dokan Kits Vendor Audit Log

When vendors change prices, stock, payout details, or store settings, you need a clear record of who made the change and when—especially if you run disputes, compliance reviews, or a large vendor team.

Dokan Kits Vendor Audit Log is a premium addon for Dokan Kits. It writes marketplace activity to a central log inside WordPress, with filters, CSV export, retention controls, and an optional read-only page for vendors.

This guide covers installation, enabling logging, reading the audit log, exporting data, vendor My Activity, and common fixes.

Suggested docs URL: https://wpintegrity.com/docs/dokan-kits-vendor-audit-log
Suggested KB category: Dokan Kits add-ons · Vendor tools

Prerequisites

• WooCommerce 7.9 or later is active.
• Dokan Lite 3.9 or later is active.
• Dokan Kits 3.1.5 or later is active.
• Dokan Kits Vendor Audit Log 1.0.0 or later is installed, activated, and licensed through Freemius (connected to your Dokan Kits plan).
• Dokan Pro is recommended if you want withdraw submitted and withdraw approved events logged.

How to install Dokan Kits Vendor Audit Log

1. Download dokan-kits-vendor-audit-log-1.0.0.zip from your WPIntegrity account.
2. In WordPress, go to Plugins → Add New → Upload Plugin.
3. Choose the ZIP file and click Install Now.
4. Click Activate Plugin.
5. Complete Freemius license activation when prompted (the addon registers as a Dokan Kits premium addon).

[Screenshot: WordPress plugin upload screen with Dokan Kits Vendor Audit Log ZIP selected]

How to enable vendor audit logging

Dokan Kits settings

1. Go to Dokan Kits → Features.
2. Open the Vendor tab.
3. Scroll to the Vendor Audit Log subsection (badge: Premium Feature).
4. Turn on Enable Vendor Audit Log.
5. Adjust the other toggles and number fields as needed (see Settings reference below).
6. Click Save Changes at the bottom of the page.

The Audit Log item appears under Dokan Kits in the admin menu once the addon is licensed and available.

To stop recording new events, follow the same steps and turn off Enable Vendor Audit Log. Existing rows stay in the database until retention rules remove them.

How to view the marketplace audit log

1. Go to Dokan Kits → Audit Log.
2. Review the summary cards (Total entries, Current page).
3. Use the table columns: Date, User / Role, Action, Subject, Details, IP (when Store IP Address is enabled).
4. Scroll to Tracked activities at the bottom for a reference list of every event type the addon can record.

If logging is off, a notice appears: Logging is disabled. with a link to enable Vendor Audit Log under Vendor → Vendor Audit Log in Features.

How to filter audit log entries

1. On Dokan Kits → Audit Log, find the Filters section.
2. Set any combination of:
   • Date from / Date to
   • Vendor ID (placeholder: All vendors)
   • User ID (placeholder: All users)
   • Action (dropdown; default All actions)
   • Object (dropdown: Product, Order, Vendor, Settings, Withdraw; default All objects)
3. Click Apply filters.
4. Click Reset to clear filters.

Use pagination (Previous / Next) when more than one page of results exists.

How to export the audit log to CSV

1. On Dokan Kits → Audit Log, apply filters if you only need a subset of rows.
2. Click Export CSV in the page header.
3. The browser downloads a file named like vendor-audit-log-YYYY-MM-DD.csv.

Exports are capped at 5,000 rows per download. For larger archives, narrow the date range and export multiple files, or use the REST API (see Developers).

How to show vendors their own activity

[Screenshot: Dokan vendor dashboard with My Activity in the navigation]

1. Go to Dokan Kits → Features → Vendor → Vendor Audit Log.
2. Turn on Vendor “My Activity” Page.
3. Click Save Changes.
4. Vendors see My Activity in the Dokan vendor dashboard navigation.

Each vendor only sees log rows tied to their vendor account. The page is read-only.

To hide the page again, turn off Vendor “My Activity” Page and save.

Settings reference

All settings live under Dokan Kits → Features → Vendor → Vendor Audit Log.

Setting	What it does
Enable Vendor Audit Log	Master switch for recording and viewing new events.
Log Product Price Changes	When off, regular and sale price changes are not logged. Other product events still log.
Log Stock Only Below Threshold	When on, stock changes log only when quantity is at or below Stock Log Threshold.
Stock Log Threshold	Quantity used with threshold-only stock logging (default 5).
Hide Payout Account Numbers in Log	Masks bank, IBAN, PayPal, and similar values in stored details.
Retention (Days)	Deletes entries older than this many days (default 90; minimum 1).
Maximum Log Rows	Caps total rows in the database (default 2000; maximum 2000 per Dokan Kits number fields). Use 0 for unlimited with a daily safety trim.
Vendor “My Activity” Page	Adds the vendor dashboard My Activity endpoint.
Store IP Address	Saves the client IP on each row.
Email Alerts	Emails the site admin for configured alert types.
Price Drop Alert (%)	Alerts when a logged price decrease exceeds this percentage (default 50).
Alert on Payout Method Change	Emails when withdraw/payout method changes are logged.

What the addon logs

Events appear in the log with human-readable action labels such as Product created, Price changed, and Store profile changed.

Products

• Product created
• Product updated
• Product published
• Product trashed
• Price changed (requires Log Product Price Changes)
• Sale price changed (requires Log Product Price Changes)
• Stock changed (respects Log Stock Only Below Threshold when enabled)
• SKU changed
• Product status changed

Vendor profile and payments

• Store profile changed
• Payment details changed
• Withdraw method changed

Withdrawals

• Withdraw submitted
• Withdraw approved

Withdraw events use Dokan Pro hooks. Without Dokan Pro, these rows may not appear.

Administration

• Login as vendor (when your setup fires the dokan_kits_vendor_audit_log_login_as_vendor action)

Data storage and retention

• Log data is stored in the WordPress database table {prefix}dokan_kits_audit_log (for example wp_dokan_kits_audit_log).
• A scheduled cleanup removes rows older than Retention (Days) and enforces Maximum Log Rows when set.
• The addon does not modify Dokan Kits core files; it uses Dokan Kits hooks and the shared settings API.

Developers: REST API

Authenticated requests can read log entries via:

GET /wp-json/dokan-kits/v1/audit-log

Supported query parameters include page, per_page, vendor_id, user_id, action_type, object_type, date_from, and date_to. Permissions follow Dokan Kits REST rules (admins see all rows; vendors see their own scope).

Frequently asked questions

Does Vendor Audit Log change Dokan or Dokan Kits core files?

No. The addon registers through Dokan Kits only. You can deactivate it without leaving core edits behind.

Can I turn off logging temporarily without uninstalling?

Yes. Add this line to wp-config.php:

define( 'DKVAL_DISABLE_LOGGING', true );

New events stop recording; the admin UI and existing rows remain. Remove the line to resume logging.

Can I disable the entire addon?

Yes. Add:

define( 'DKVAL_DISABLE', true );

The addon stops loading its features. Use this only for emergencies or debugging.

Why do I see one row when a vendor creates a product?

The addon deduplicates product create noise: it defers logging to the end of the request and avoids duplicate rows for the same create action.

Where do email alerts go?

Alerts use the WordPress admin email address (Settings → General → Administration Email Address).

Troubleshooting

The Audit Log menu item or settings are missing

Go to Plugins and confirm Dokan Kits Vendor Audit Log is active. Open the Freemius license screen and confirm the addon is connected to your Dokan Kits subscription. Refresh Dokan Kits → Features after activation.

The audit log page says “Logging is disabled.”

Go to Dokan Kits → Features → Vendor, turn on Enable Vendor Audit Log, and click Save Changes. Confirm DKVAL_DISABLE_LOGGING is not set to true in wp-config.php.

No new rows appear after vendor actions

1. Enable Enable Vendor Audit Log and save.
2. Confirm the addon license is active (dkval_is_available requires a valid Freemius or parent Dokan Kits addon connection).
3. For price changes, enable Log Product Price Changes.
4. For stock, if Log Stock Only Below Threshold is on, stock must fall to Stock Log Threshold or below to log.
5. Ensure WooCommerce is loaded (product listeners register on woocommerce_init).

After a test product save, refresh Dokan Kits → Audit Log.

Price changes are not logged

Open Dokan Kits → Features → Vendor → Vendor Audit Log and turn on Log Product Price Changes, then click Save Changes. Create a test price change and refresh the log.

Withdraw events never appear

Install and activate Dokan Pro, then submit or approve a test withdrawal. Without Dokan Pro, withdraw hooks may not run.

Dokan Kits will not save “Maximum Log Rows” above 2000

The field maximum is 2000 (Dokan Kits number field limit). Lower the value to 2000 or below, or use 0 for unlimited with daily trim.

CSV export is smaller than expected

Each export stops at 5,000 rows. Narrow Date from / Date to and export again for the next batch.

Vendors do not see My Activity

Turn on Vendor “My Activity” Page and Enable Vendor Audit Log, save, and ask the vendor to log out and back in. The menu item is My Activity in the Dokan dashboard.