English (United Kingdom)
Knowledge Base  >  Vik Appointments  >  Hooks  >  Taxes  >  Load Operators

apply_filters_ref_array( 'vikappointments_load_tax_operators', bool $status, array &$operators )

Fires while fetching all the supported taxes operators.


Description

Trigger hook to allow external plugins to support custom operations.

New operations have to be appended to the given associative array. The key of the array is the unique ID of the operation, the value is a readable name to display.

All the registered operators will be reported within the Math Operation dropdown, under the management page of a new tax rule.

Here's a list of operators supported by default:

  • add - sums the tax amount to the total cost (also known as excluded taxes);
  • sub - subtracts the tax amount from the total cost;
  • vat - separates the tax amount from the total cost (also known as inclusive taxes).

Parameters

$status

(bool)  True on success, false otherwise.

&$operators

(array)  An array of operators.


Example

The example below adds support for a new operator that applies the VAT only to European customers that do not have a valid VAT Number.

/** 
 * Trigger hook to allow external plugins to support custom operations.
 * New operations have to be appended to the given associative array.
 * The key of the array is the unique ID of the operation, the value is
 * a readable name to display.
 *
 * @param  boolean  $status      True on success, false otherwise.
 * @param  array    &$operators  An array of supported operators.
 */
add_filter('vikappointments_load_tax_operators', function($status, &$operators)
{
    // the key is the operator alias, the value is the name that appears within the dropdown.
    $operators['euvat'] = 'European VAT';

    return $status;
}, 10, 2);

Changelog

Version Description
1.2 Introduced.
Last Update: 2021-08-18
Helpful?
This site uses cookies. By continuing to browse you accept their use. Further information