Logs WooCommerce order status changes and displays recent activity in the WordPress admin panel.

Description

WooCommerce Order Status Change Log records every WooCommerce order status transition.

Each log includes:

• Order ID
• Previous status
• New status
• Change date and time
• User or process responsible for the change

A dedicated report page is added under the WooCommerce admin menu.

Features

• Logs WooCommerce order status changes
• Stores previous and new statuses
• Records the responsible user or system process
• Supports REST API, webhook, cron, and system changes
• Displays recent logs in the WordPress admin panel
• Filter reports by time period
• Paginated report table
• Direct order and user links
• Compatible with WooCommerce HPOS
• Automatic cleanup of old logs
• Uses a dedicated database table
• Single-file plugin

Requirements

• PHP 7.4+
• WordPress 6.0+
• WooCommerce

Installation

1. Download the repository as a ZIP file.
2. Open Plugins → Add New Plugin → Upload Plugin.
3. Select the downloaded ZIP file.
4. Install and activate the plugin.

Usage

After activation, open:

WooCommerce → Order Status Logs

The report can display status changes from:

• Last 24 hours
• Last 72 hours
• Last 7 days
• Last 30 days

By default, 50 log records are displayed per page.

Data Storage

The plugin creates the following custom database table:

{prefix}wc_order_status_logs

The table stores:

• Log ID
• Order ID
• Previous order status
• New order status
• Change time in UTC
• User ID
• User display name
• Change source type

Automatic Cleanup

Logs older than 180 days are deleted automatically by a daily WordPress cron event.

The retention period can be changed using the wc_oscl_retention_days filter.

Return 0 to disable automatic cleanup.

add_filter(
    'wc_oscl_retention_days',
    static function () {
        return 365;
    }
);

Filters

wc_oscl_required_capability

Changes the capability required to view the report.

add_filter(
    'wc_oscl_required_capability',
    static function () {
        return 'manage_options';
    }
);

wc_oscl_items_per_page

Changes the number of logs displayed per page.

add_filter(
    'wc_oscl_items_per_page',
    static function () {
        return 100;
    }
);

wc_oscl_retention_days

Changes log retention duration.

add_filter(
    'wc_oscl_retention_days',
    static function () {
        return 90;
    }
);

wc_oscl_log_data

Modifies log data before database insertion.

add_filter(
    'wc_oscl_log_data',
    static function ( $data, $order, $old_status, $new_status ) {
        return $data;
    },
    10,
    4
);

HPOS Compatibility

The plugin declares compatibility with WooCommerce High-Performance Order Storage.

Order edit links are generated using WooCommerce utilities whenever available.

License

GPL-3.0

Author

Amirreza Shayesteh Far

• Website: https://amirrezaa.ir/
• GitHub: https://github.com/amirrezashf
• Repository: https://github.com/amirrezashf/WooCommerce-Order-Status-Change-Log

گزارش تغییر وضعیت سفارش‌های ووکامرس

ثبت تغییرات وضعیت سفارش‌های ووکامرس و نمایش آخرین فعالیت‌ها در پنل مدیریت وردپرس.

توضیحات

افزونه WooCommerce Order Status Change Log تمام تغییرات وضعیت سفارش‌های ووکامرس را ثبت می‌کند.

هر لاگ شامل اطلاعات زیر است:

• شناسه سفارش
• وضعیت قبلی
• وضعیت جدید
• تاریخ و ساعت تغییر
• کاربر یا فرایند انجام‌دهنده تغییر

یک صفحه گزارش اختصاصی به منوی ووکامرس اضافه می‌شود.

ویژگی‌ها

• ثبت تغییر وضعیت سفارش‌های ووکامرس
• ذخیره وضعیت قبلی و جدید
• ثبت کاربر یا فرایند عامل تغییر
• تشخیص تغییر توسط REST API، webhook، cron یا سیستم
• نمایش گزارش در پنل مدیریت
• فیلتر بر اساس بازه زمانی
• جدول صفحه‌بندی‌شده
• لینک مستقیم سفارش و کاربر
• سازگار با WooCommerce HPOS
• حذف خودکار لاگ‌های قدیمی
• استفاده از جدول اختصاصی دیتابیس
• معماری تک‌فایلی

نیازمندی‌ها

• PHP 7.4+
• WordPress 6.0+
• WooCommerce

نصب

1. repository را به‌صورت ZIP دانلود کنید.
2. در وردپرس وارد افزونه‌ها ← افزودن افزونه تازه ← بارگذاری افزونه شوید.
3. فایل ZIP را انتخاب کنید.
4. افزونه را نصب و فعال کنید.

نحوه استفاده

پس از فعال‌سازی، وارد مسیر زیر شوید:

ووکامرس ← لاگ وضعیت سفارش‌ها

گزارش را می‌توان برای بازه‌های زیر مشاهده کرد:

• ۲۴ ساعت اخیر
• ۷۲ ساعت اخیر
• ۷ روز اخیر
• ۳۰ روز اخیر

به‌صورت پیش‌فرض، در هر صفحه ۵۰ رکورد نمایش داده می‌شود.

ذخیره‌سازی داده

افزونه جدول اختصاصی زیر را ایجاد می‌کند:

{prefix}wc_order_status_logs

این جدول اطلاعات زیر را ذخیره می‌کند:

• شناسه لاگ
• شناسه سفارش
• وضعیت قبلی سفارش
• وضعیت جدید سفارش
• زمان تغییر به‌صورت UTC
• شناسه کاربر
• نام نمایشی کاربر
• نوع عامل تغییر

پاک‌سازی خودکار

لاگ‌های قدیمی‌تر از ۱۸۰ روز با یک cron روزانه به‌صورت خودکار حذف می‌شوند.

مدت نگهداری را می‌توان با filter زیر تغییر داد:

add_filter(
    'wc_oscl_retention_days',
    static function () {
        return 365;
    }
);

برای غیرفعال کردن پاک‌سازی خودکار، مقدار 0 برگردانید.

سازگاری با HPOS

افزونه سازگاری خود را با WooCommerce High-Performance Order Storage اعلام می‌کند.

برای ساخت لینک صفحه ویرایش سفارش، در صورت موجود بودن از utilityهای رسمی ووکامرس استفاده می‌شود.

مجوز

GPL-3.0

نویسنده

Amirreza Shayesteh Far

• وب‌سایت: https://amirrezaa.ir/
• GitHub: https://github.com/amirrezashf
• Repository: https://github.com/amirrezashf/WooCommerce-Order-Status-Change-Log