[WordPress] 外掛分享： PoPayPOS Reports for WooCommerce

內容簡介

### 總結:
PoPayPOS Reports for WooCommerce是一個WordPress外掛程式，可以生成使用Omni POS應用程式創建的訂單的詳細報告。此外掛程式讓網站管理員查看POS訂單的詳細分析，包括比較POS訂單與常規訂單、每日詳細報告、視覺圖表、將數據匯出為CSV/Excel、詳細統計以及完全兼容性與高性能訂單存儲（HPOS）。

###問題與答案:
1. 這個WordPress外掛程式的功能是什麼？
- 允許生成Omni POS應用程式創建的訂單的詳細報告。
- 可查看POS訂單的詳細分析包括比較POS訂單與常規訂單、每日詳細報告、視覺圖表、將數據匯出為CSV/Excel、詳細統計以及完全兼容性與高性能訂單存儲（HPOS）。

2. 這個外掛程式的系統需求是什麼？
- WordPress 5.0或更高版本
- WooCommerce 5.0或更高版本
- PHP 7.4或更高版本

3. 如何存取報告？
- 登入WordPress管理面板
- 導航至WooCommerce > POS Reports

4. 如何創建一個報告？
- 選擇開始日期和結束日期
- 點擊生成報告
- 在摘要卡、圖表和表格中查看結果

5. 如何匯出數據？
- 生成報告
- 選擇匯出格式（CSV或Excel）
- 點擊匯出報告

6. 這個外掛程式如何識別訂單？
- 外掛程式使用meta字段辨識訂單：
- order_source = pos
- 沒有此字段或不同值的訂單被視為常規訂單

這些問題與答案可以以HTML中的無序清單（bulleted list）方式呈現。

外掛標籤

開發者團隊

📦 歷史版本下載

1.0.31.0.4trunk

原文外掛簡介

PoPayPOS Reports for WooCommerce is a powerful analytics plugin designed specifically for businesses using PopayPOS (Omni POS) systems with WooCommerce. Get comprehensive insights into your point-of-sale transactions with professional reports, visual analytics, and data export capabilities.
Transform your Popay POS data into actionable business intelligence with detailed sales reports, payment method tracking, and employee performance analytics.
Why Choose PoPayPOS Reports?
✅ 100% HPOS Compatible – Future-proof with WooCommerce High-Performance Order Storage
✅ Real-time Analytics – Track sales performance instantly
✅ Professional Reports – Export to CSV/Excel for business analysis
✅ Visual Dashboards – Beautiful charts and graphs
✅ Payment Method Tracking – Monitor all payment types
✅ Employee Performance – Track individual cashier sales
Perfect for Popay users who need detailed reporting and analytics for their POS transactions.
The plugin allows site administrators to view detailed analytics for POS orders, including:
– Comparison between Popay POS orders and regular orders
– Daily detailed reports with visual graphs
– Export data to CSV/Excel formats
– Detailed statistics and performance metrics
– Full compatibility with High-Performance Order Storage (HPOS)
System Requirements

WordPress 5.0 or higher
WooCommerce 5.0 or higher
PHP 7.4 or higher
PopayPOS/Omni POS system integration

Compatibility
This plugin is fully compatible with WooCommerce High-Performance Order Storage (HPOS).
It uses the WooCommerce Data Store API instead of direct SQL queries, ensuring compatibility with future database changes.
Supported features:
– HPOS enabled
– HPOS disabled (traditional database)
– Automatic switching between systems
– Support for WooCommerce 5.0+
Usage
Accessing Reports

Go to the WordPress admin panel
Navigate to WooCommerce > PoPayPOS Reports

Creating a Report

Select a start date and end date
Click Generate Report
View results in summary cards, graphs, and tables

Exporting Data

Generate a report
Select an export format (CSV or Excel)
Click Export Report

Features
Summary Cards

Number of POS orders
Total POS order amount
Number of regular orders
Total regular order amount
Total revenue
Percentage of POS orders from all orders

Graphs

Line chart comparing daily revenue
Bar chart comparing daily order counts

Detailed Tables

List of all POS orders with direct links
Daily breakdown of orders and revenue

Data Export

Export to CSV
Export to Excel (basic)

Data Structure
The plugin identifies orders with the meta field:
order_source = pos
Orders without this field or with a different value are considered regular orders.
Technical Architecture
WooCommerce Data Store API
Instead of direct SQL queries:
php
$orders = wc_get_orders(array(
'limit' => -1,
'status' => array('completed', 'processing', 'on-hold'),
'meta_query' => array(
array(
'key' => 'order_source',
'value' => 'pos',
'compare' => '='
)
)
));
HPOS Detection
`php

if (class_exists(‘Automattic\WooCommerce\Utilities\OrderUtil’)) {
$hpos_enabled = \Automattic\WooCommerce\Utilities\OrderUtil::custom_orders_table_usage_is_enabled();
}
`
Customization
Adding More Fields
Edit the get_orders_by_source function:
php
private function get_orders_by_source($source, $start_date, $end_date) {
$args = array(
'limit' => -1,
'status' => array('completed', 'processing', 'on-hold'),
'date_created' => $start_date . '...' . $end_date,
'orderby' => 'date',
'order' => 'DESC',
'meta_query' => array(
array(
'key' => 'your_custom_field',
'value' => 'your_value',
'compare' => '='
)
)
);
return wc_get_orders($args);
}
Styling
Edit assets/css/admin.css.
Troubleshooting

Plugin not in menu: Ensure WooCommerce is active and you have manage_woocommerce permissions.
No data in reports: Make sure orders contain order_source = pos and check the date range.
JavaScript errors: Verify all assets are loading and check browser console.
HPOS issues: Ensure WooCommerce is updated.

Performance

Uses WooCommerce Data Store API for efficiency
HPOS improves performance
Optimized queries for the active database
Loads orders in small batches to save memory

Support
For questions or support, contact the plugin developer.
License
This plugin is licensed under the GPL v2 or later.