Prepare Fields
do_action_ref_array( 'vikrestaurants_prepare_fields_save_order', array &$fields, array &$args )
Fires after fetching the custom fields set in request.
Description
Trigger hook to manipulate the custom fields array and the billing information of the customer, extrapolated through the rules of the custom fields.
In case you are using a third-party plugin to collect the details of the customer, it is possible to inject into the $args
array all the information that you wish to register.
Parameters
- &$fields
-
(array) An associative array containing the custom fields entered by the customer. The array keys match the names of the custom fields, the values match the details specified by the customer instead.
- &$args
-
(array) An associative array containing the billing details of the customer.
Example
Assuming that no custom fields are used, the system auto-injects the phone number of the customer into the array holding the billing details.
/**
* Trigger event to manipulate the custom fields array and the
* billing information of the customer, extrapolated from the rules
* of the custom fields.
*
* @param array &$fields The custom fields values.
* @param array &$args The billing array.
*/
add_action('vikrestaurants_prepare_fields_save_order', function(&$fields, &$args) {
// get details of the current user
$user = wp_get_current_user();
if (!$user) {
return false;
}
// assume that the phone number is contained within the details of the currently logged-in user
if (empty($args['purchaser_phone'])) {
$args['purchaser_phone'] = $user->phone;
}
}, 10, 2);
Changelog
Version | Description |
---|---|
1.3 | Introduced. |