Files
unsupervised-scheduler/templates/admin/payment-report.php
T
thatguygriff 553cfafa49
CI / Tests (PHP 8.1) (pull_request) Successful in 51s
CI / Coding Standards (pull_request) Successful in 1m1s
CI / Tests (PHP 8.2) (pull_request) Successful in 58s
CI / No Debug Code (pull_request) Successful in 4s
CI / PHPStan (pull_request) Successful in 1m16s
CI / Tests (PHP 8.3) (pull_request) Successful in 45s
CI / Build Plugin Zip (pull_request) Has been skipped
Add HST/tax support and payment reporting with HST aggregation
Studio Settings gains a default HST rate; the rate is frozen onto each
payment at booking and computed against the pre-tax subtotal, with the
total billed as subtotal + tax. The rate is overridable per booking on
My Lessons while unpaid (recomputing the tax amount), comped
registrations are never taxed, and receipts break out subtotal/HST/total.

Builds the payments report (roadmap #8) from us_payments: a monthly
per-instructor view with subtotal, HST collected, and grand-total
aggregation, plus a nonce-protected CSV export via admin-post. Studio
admins see all instructors and can filter; instructors are scoped to
their own rows. The Payment Report menu is gated on export_payments so
instructors (who lack manage_billing) can reach it.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-08 11:29:48 -03:00

100 lines
4.7 KiB
PHP

<?php
declare(strict_types=1);
if (! defined('ABSPATH')) {
exit;
}
use Unsupervised\Schedular\Payment\PaymentReport;
/**
* @var PaymentReport $report
* @var string $month
* @var int $instructorId
* @var bool $canExport
* @var bool $canFilter
* @var string $exportUrl
* @var list<\WP_User|\stdClass> $instructors
*/
?>
<div class="wrap">
<h1><?php esc_html_e('Payment Report', 'unsupervised-schedular'); ?></h1>
<form method="get" style="margin: 1em 0; display:flex; gap:8px; align-items:flex-end; flex-wrap:wrap;">
<input type="hidden" name="page" value="us-reports">
<label>
<?php esc_html_e('Month', 'unsupervised-schedular'); ?><br>
<input type="month" name="month" value="<?php echo esc_attr($month); ?>">
</label>
<?php if ($canFilter) : ?>
<label>
<?php esc_html_e('Instructor', 'unsupervised-schedular'); ?><br>
<select name="instructor_id">
<option value="0"><?php esc_html_e('All instructors', 'unsupervised-schedular'); ?></option>
<?php foreach ($instructors as $instructor) : ?>
<option value="<?php echo esc_attr((string) $instructor->ID); ?>" <?php selected($instructorId, (int) $instructor->ID); ?>>
<?php echo esc_html($instructor->display_name); ?>
</option>
<?php endforeach; ?>
</select>
</label>
<?php endif; ?>
<button type="submit" class="button"><?php esc_html_e('Filter', 'unsupervised-schedular'); ?></button>
<?php if ($canExport) : ?>
<a class="button button-secondary" href="<?php echo esc_url($exportUrl); ?>"><?php esc_html_e('Export CSV', 'unsupervised-schedular'); ?></a>
<?php endif; ?>
</form>
<p>
<strong><?php esc_html_e('HST collected:', 'unsupervised-schedular'); ?></strong>
<?php echo esc_html(number_format($report->totalTax(), 2)); ?>
&nbsp;|&nbsp;
<strong><?php esc_html_e('Subtotal:', 'unsupervised-schedular'); ?></strong>
<?php echo esc_html(number_format($report->totalAmount(), 2)); ?>
&nbsp;|&nbsp;
<strong><?php esc_html_e('Total collected:', 'unsupervised-schedular'); ?></strong>
<?php echo esc_html(number_format($report->grandTotal(), 2)); ?>
</p>
<?php if (0 === $report->count()) : ?>
<p><?php esc_html_e('No paid payments in this period.', 'unsupervised-schedular'); ?></p>
<?php else : ?>
<table class="wp-list-table widefat fixed striped">
<thead>
<tr>
<th><?php esc_html_e('Date', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('Student', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('Instructor', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('Method', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('Status', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('Subtotal', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('HST', 'unsupervised-schedular'); ?></th>
<th><?php esc_html_e('Total', 'unsupervised-schedular'); ?></th>
</tr>
</thead>
<tbody>
<?php foreach ($report->rows() as $row) : ?>
<tr>
<td><?php echo esc_html($row['date']); ?></td>
<td><?php echo esc_html($row['student']); ?></td>
<td><?php echo esc_html($row['instructor']); ?></td>
<td><?php echo esc_html($row['method']); ?></td>
<td><?php echo esc_html($row['status']); ?></td>
<td><?php echo esc_html(number_format($row['amount'], 2)); ?></td>
<td><?php echo esc_html(number_format($row['tax_amount'], 2) . ' (' . number_format($row['tax_rate'], 2) . '%)'); ?></td>
<td><?php echo esc_html(number_format($row['total'], 2)); ?></td>
</tr>
<?php endforeach; ?>
</tbody>
<tfoot>
<tr>
<th colspan="5"><?php esc_html_e('Totals', 'unsupervised-schedular'); ?></th>
<th><?php echo esc_html(number_format($report->totalAmount(), 2)); ?></th>
<th><?php echo esc_html(number_format($report->totalTax(), 2)); ?></th>
<th><?php echo esc_html(number_format($report->grandTotal(), 2)); ?></th>
</tr>
</tfoot>
</table>
<?php endif; ?>
</div>