SplitBillController
extends Controller
in package
Storefront split bill controller.
Allows dine-in customers to join a shared order, claim items, make partial payments, and receive receipts.
Tags
Table of Contents
Properties
- $layout : string
Methods
- addCustomer() : void
- Add a customer to a split bill order.
- apiStatus() : void
- API endpoint for real-time bill refresh (polling).
- claimItems() : void
- Claim items for a customer.
- pay() : void
- Process a partial payment for a customer.
- show() : void
- Show the split bill page for an order.
- baseUrl() : string
- Get the base URL for the application.
- buildPagination() : array<string|int, mixed>
- Build pagination metadata for views.
- clearOldInput() : void
- Clear stored old input data.
- flash() : void
- Set a flash message in the session.
- flashOldInput() : void
- Store current POST data as old input for form repopulation.
- getPage() : int
- Get the current page number from the query string.
- json() : void
- Send a JSON response.
- old() : mixed
- Get previous form input after validation failure.
- redirect() : void
- Send an HTTP redirect.
- requirePermission() : void
- Require that the authenticated client user has a specific permission.
- url() : string
- Generate a full URL for a given path.
- view() : void
- Render a view template wrapped in a layout.
- buildReceiptHtml() : string
- Build receipt HTML for email.
- sendReceipt() : void
- Send receipt via email and/or SMS.
- validateOrder() : array<string|int, mixed>|null
- Validate the order belongs to the business.
Properties
$layout
protected
string
$layout
= 'storefront'
Default layout template
Methods
addCustomer()
Add a customer to a split bill order.
public
addCustomer(string $slug, string $orderNumber) : void
Parameters
- $slug : string
-
Business slug
- $orderNumber : string
-
Order number
apiStatus()
API endpoint for real-time bill refresh (polling).
public
apiStatus(string $slug, string $orderNumber) : void
Parameters
- $slug : string
-
Business slug
- $orderNumber : string
-
Order number
claimItems()
Claim items for a customer.
public
claimItems(string $slug, string $orderNumber) : void
Parameters
- $slug : string
-
Business slug
- $orderNumber : string
-
Order number
pay()
Process a partial payment for a customer.
public
pay(string $slug, string $orderNumber) : void
Parameters
- $slug : string
-
Business slug
- $orderNumber : string
-
Order number
show()
Show the split bill page for an order.
public
show(string $slug, string $orderNumber) : void
Parameters
- $slug : string
-
Business slug
- $orderNumber : string
-
Order number
baseUrl()
Get the base URL for the application.
protected
baseUrl() : string
Return values
stringbuildPagination()
Build pagination metadata for views.
protected
buildPagination(int $total, int $page, int $perPage, string $baseUrl) : array<string|int, mixed>
Parameters
- $total : int
-
Total record count
- $page : int
-
Current page number
- $perPage : int
-
Records per page
- $baseUrl : string
-
Base URL path (e.g., "client/orders")
Return values
array<string|int, mixed> —Pagination metadata
clearOldInput()
Clear stored old input data.
protected
clearOldInput() : void
flash()
Set a flash message in the session.
protected
flash(string $key, string $message) : void
Parameters
- $key : string
-
Flash message key (e.g., "success", "error")
- $message : string
-
The message text
flashOldInput()
Store current POST data as old input for form repopulation.
protected
flashOldInput() : void
getPage()
Get the current page number from the query string.
protected
getPage() : int
Return values
int —Page number (minimum 1)
json()
Send a JSON response.
protected
json(mixed $data[, int $status = 200 ]) : void
Parameters
- $data : mixed
-
Data to encode as JSON
- $status : int = 200
-
HTTP status code
old()
Get previous form input after validation failure.
protected
old(string $field[, mixed $default = '' ]) : mixed
Parameters
- $field : string
-
The form field name
- $default : mixed = ''
-
Default value if not found
redirect()
Send an HTTP redirect.
protected
redirect(string $url) : void
Parameters
- $url : string
-
The URL to redirect to
requirePermission()
Require that the authenticated client user has a specific permission.
protected
requirePermission(string $permission) : void
Redirects to the client dashboard with an error flash if denied.
Parameters
- $permission : string
-
Permission key (e.g., 'menu_manage')
url()
Generate a full URL for a given path.
protected
url([string $path = '' ]) : string
Parameters
- $path : string = ''
-
The path to append to the base URL
Return values
stringview()
Render a view template wrapped in a layout.
protected
view(string $template[, array<string|int, mixed> $data = [] ]) : void
Parameters
- $template : string
-
Path to view relative to app/Views/ (e.g., "admin/dashboard")
- $data : array<string|int, mixed> = []
-
Variables to extract into the view scope
buildReceiptHtml()
Build receipt HTML for email.
private
buildReceiptHtml(array<string|int, mixed> $business, array<string|int, mixed> $order, array<string|int, mixed> $customer, array<string|int, mixed> $claims, array<string|int, mixed> $payment) : string
Parameters
- $business : array<string|int, mixed>
- $order : array<string|int, mixed>
- $customer : array<string|int, mixed>
- $claims : array<string|int, mixed>
- $payment : array<string|int, mixed>
Return values
stringsendReceipt()
Send receipt via email and/or SMS.
private
sendReceipt(int $paymentId, int $orderCustomerId, array<string|int, mixed> $order, array<string|int, mixed> $business, string $via) : void
Parameters
- $paymentId : int
- $orderCustomerId : int
- $order : array<string|int, mixed>
- $business : array<string|int, mixed>
- $via : string
-
email|sms|both
validateOrder()
Validate the order belongs to the business.
private
validateOrder(string $slug, string $orderNumber) : array<string|int, mixed>|null
Parameters
- $slug : string
- $orderNumber : string