Description
“tcp_get_order_status” allows to add or change completely the list of order status in TheCartPress.
Parameters
- $status_list
- (Array) List of order status with the next format: array( name => array( ‘name’, ‘label’, ‘show_in_dashboard’, ‘valid_for_deleting’, “is_canceled’, ‘is_completed’), ).
name
Identifier of the order status
label
Label of the order status. This value is displayed in the selection lists.
show_in_dashboard
If true, The orders summary panel, in the dashboard, displays the orders with this status.
valid_for_deleting
If true, the order with this status will be able to be deleted.
is_canceled
if true, the status is the canceled status. This value is used by the payment plugins.
is_completed
if true, the status is the completed status. This value is used by the payment plugins.
Examples
Adding more status
<?php function my_tcp_get_order_status( $status_list ) { $status_list['waiting'] = array( 'name' => 'waiting', 'label' => __( 'Waiting', 'tcp' ), 'show_in_dashboard' => true, 'valid_for_deleting' => false, ); return $status_list; } add_filter( 'tcp_get_order_status', 'my_tcp_get_order_status' ); ?>
Changing all states
<?php function my_tcp_get_order_status( $status_list ) { $status_list = array( 'received' => array( 'name' => 'received', 'label' => __( 'Received,', 'tcp' ), 'show_in_dashboard' => true, 'valid_for_deleting' => false, ), 'processing' => array( 'name' => 'processing', 'label' => __( 'Processing', 'tcp' ), 'show_in_dashboard' => true, 'valid_for_deleting' => false, ), 'booked' => array( 'name' => 'booked', 'label' => __( 'Booked', 'tcp' ), 'show_in_dashboard' => true, 'valid_for_deleting' => false, ), 'waiting' => array( 'name' => 'waiting', 'label' => __( 'Waiting for customer callback', 'tcp' ), 'show_in_dashboard' => true, 'valid_for_deleting' => false, ), 'being_edited' => array( 'name' => 'being_edited', 'label' => __( 'Being edited', 'tcp' ), 'show_in_dashboard' => true, 'valid_for_deleting' => false, ), 'canceled' => array( 'name' => 'canceled', 'label' => __( 'Canceled', 'tcp' ), 'show_in_dashboard' => true, 'valid_for_deleting' => true, 'is_canceled' => true, ), 'completed' => array( 'name' => 'completed', 'label' => __( 'Completed', 'tcp' ), 'show_in_dashboard' => true, 'valid_for_deleting' => true, 'is_completed' => true, ), ); return $status_list; } add_filter( 'tcp_get_order_status', 'my_tcp_get_order_status' ); ?>
Change Log
Since 1.1.1
Since 1.1.2: the $status_list is now a hash table.