• Germanized
  • Hooks

DHL

woocommerce_gzd_deutsche_post_label_api_customs_transmit_communication_data Filter

  1. $param_1 string
  2. $param_2 string
add_filter( "woocommerce_gzd_deutsche_post_label_api_customs_transmit_communication_data", function( $param_1, $param_2 ) {
    // Do something
    return $param_1;    
}, 10, 2 );

woocommerce_gzd_deutsche_post_label_api_pdf_accept_header Filter

  1. $param string
add_filter( "woocommerce_gzd_deutsche_post_label_api_pdf_accept_header", function( $param ) {
    // Do something
    return $param;    
}, 10, 1 );

woocommerce_gzd_dhl_loaded Action

add_action( "woocommerce_gzd_dhl_loaded", function(  ) {
    // Do something
        
}, 10 );

woocommerce_gzd_dhl_preferred_service_fields Action

add_action( "woocommerce_gzd_dhl_preferred_service_fields", function(  ) {
    // Do something
        
}, 10 );

woocommerce_gzd_dhl_checkout_parcel_services_data Filter

  1. $param string
add_filter( "woocommerce_gzd_dhl_checkout_parcel_services_data", function( $param ) {
    // Do something
    return $param;    
}, 10, 1 );

woocommerce_gzd_dhl_checkout_get_current_payment_method Filter

  1. $param string
add_filter( "woocommerce_gzd_dhl_checkout_get_current_payment_method", function( $param ) {
    // Do something
    return $param;    
}, 10, 1 );

woocommerce_gzd_dhl_order_supports_email_notification Filter

Filter to adjust whether customer data (email address) should be handed over to DHL to provide with services such as email notification or parcel outlet routing. By default this may only work if the customer has opted-in via checkbox during checkout.

  1. $has_email_notification bool Whether the order supports email notification (handing over customer data to DHL).
  2. $order \Vendidero\Germanized\DHL\Order The order instance.
add_filter( "woocommerce_gzd_dhl_order_supports_email_notification", function( $has_email_notification, $order ) {
    // Do something
    return $has_email_notification;    
}, 10, 2 );

woocommerce_gzd_dhl_order_needs_age_verificaton Filter

Filter to decide whether a DHL order needs age verification or not.

  1. $needs_verification bool Whether the order needs age verification or not.
  2. $order \Vendidero\Germanized\DHL\Order The order instance.
add_filter( "woocommerce_gzd_dhl_order_needs_age_verificaton", function( $needs_verification, $order ) {
    // Do something
    return $needs_verification;    
}, 10, 2 );

woocommerce_gzd_dhl_order_has_cod_payment Filter

Filter to decide whether a DHL order has cash on delivery payment enabled.

  1. $result bool Whether the order has COD payment or not.
  2. $order \Vendidero\Germanized\DHL\Order The order instance.
add_filter( "woocommerce_gzd_dhl_order_has_cod_payment", function( $result, $order ) {
    // Do something
    return $result;    
}, 10, 2 );

woocommerce_gzd_dhl_label_query_args Filter

Filter to adjust query paramaters for a DHL label query.

  1. $query_vars array The query arguments.
add_filter( "woocommerce_gzd_dhl_label_query_args", function( $query_vars ) {
    // Do something
    return $query_vars;    
}, 10, 1 );

woocommerce_gzd_dhl_label_query Filter

Filter to adjust query result data for a DHL label query.

  1. $results \Vendidero\Germanized\DHL\Label\Label[] The results.
  2. $args array The query arguments.
add_filter( "woocommerce_gzd_dhl_label_query", function( $results, $args ) {
    // Do something
    return $results;    
}, 10, 2 );

woocommerce_gzd_dhl_label_search_columns Filter

Filters the columns to search in a DHL LabelQuery search. The default columns depend on the search term, and include ‚label_id‘, ‚label_shipment_id‘, ‚label_path‘ and ‚label_number‘.

  1. $search_columns string[] Array of column names to be searched.
  2. $search string Text being searched.
  3. $this \Vendidero\Germanized\DHL\Legacy\LegacyLabelQuery The current LabelQuery instance.
add_filter( "woocommerce_gzd_dhl_label_search_columns", function( $search_columns, $search, $this ) {
    // Do something
    return $search_columns;    
}, 10, 3 );

woocommerce_gzd_dhl_{$hook_postfix}label_created Action

Action fires when a new DHL label has been created. The dynamic portion of this hook, `$hook_postfix` refers to the label type e.g. return in case it is not a simple label.

  1. $label_id int The label id.
  2. $label \Vendidero\Germanized\DHL\Legacy\DataStores\Label The label instance.

woocommerce_gzd_dhl_{$hook_postfix}label_updated Action

Action fires after a DHL label has been updated in the DB. The dynamic portion of this hook, `$hook_postfix` refers to the label type e.g. return in case it is not a simple label.

  1. $label_id int The label id.
  2. $label \Vendidero\Germanized\DHL\Legacy\DataStores\Label The label instance.
  3. $changed_props array Properties that have been changed.

woocommerce_gzd_dhl_{$hook_postfix}label_deleted Action

Action fires after a DHL label has been deleted from DB. The dynamic portion of this hook, `$hook_postfix` refers to the label type e.g. return in case it is not a simple label.

  1. $label_id int The label id.
  2. $label \Vendidero\Germanized\DHL\Legacy\Label The label object.

woocommerce_gzd_dhl_{$hook_postfix}label_loaded Action

Action fires after reading a DHL label from DB. The dynamic portion of this hook, `$hook_postfix` refers to the label type e.g. return in case it is not a simple label.

  1. $label \Vendidero\Germanized\DHL\Legacy\Label The label object.

woocommerce_gzd_dhl_label_object_updated_props Action

Action fires after DHL label meta properties have been updated.

  1. $label \Vendidero\Germanized\DHL\Legacy\Label The label object.
  2. $updated_props array The updated properties.
add_action( "woocommerce_gzd_dhl_label_object_updated_props", function( $label, $updated_props ) {
    // Do something
        
}, 10, 2 );

woocommerce_gzd_dhl_label_data_store_get_labels_query Filter

Filter to adjust the DHL label query args after parsing them.

  1. $wp_query_args array Parsed query arguments.
  2. $query_vars array Original query arguments.
  3. $data_store \Vendidero\Germanized\DHL\Legacy\DataStores\Label The label data store.
add_filter( "woocommerce_gzd_dhl_label_data_store_get_labels_query", function( $wp_query_args, $query_vars, $data_store ) {
    // Do something
    return $wp_query_args;    
}, 10, 3 );

woocommerce_gzd_dhl_parcel_locator_countries Filter

Filter to enable DHL parcel shop delivery for certain countries.

  1. $country_codes array Array of country codes which support DHL parcel shop delivery.
add_filter( "woocommerce_gzd_dhl_parcel_locator_countries", function( $country_codes ) {
    // Do something
    return $country_codes;    
}, 10, 1 );

woocommerce_gzd_dhl_parcel_locator_excluded_gateways Filter

Filter to disable DHL parcel shop delivery for certain gateways.

  1. $gateways array Array of gateway IDs to exclude.
add_filter( "woocommerce_gzd_dhl_parcel_locator_excluded_gateways", function( $gateways ) {
    // Do something
    return $gateways;    
}, 10, 1 );

woocommerce_gzd_dhl_order_postnumber Filter

Filter to adjust the DHL postnumber for a certain order.

  1. $post_number string The post number.
  2. $order \WC_Order The order object.
add_filter( "woocommerce_gzd_dhl_order_postnumber", function( $post_number, $order ) {
    // Do something
    return $post_number;    
}, 10, 2 );

woocommerce_gzd_dhl_user_postnumber Filter

Filter to adjust the DHL postnumber for a certain user.

  1. $post_number string The post number.
  2. $user \WP_User The user object.
add_filter( "woocommerce_gzd_dhl_user_postnumber", function( $post_number, $user ) {
    // Do something
    return $post_number;    
}, 10, 2 );

woocommerce_gzd_dhl_provider_supports_pickup_location Filter

  1. $param_1 string
  2. $param_2 string
  3. $param_3 string
add_filter( "woocommerce_gzd_dhl_provider_supports_pickup_location", function( $param_1, $param_2, $param_3 ) {
    // Do something
    return $param_1;    
}, 10, 3 );

woocommerce_gzd_dhl_shipment_needs_label Filter

Filter to determine whether a shipment needs a DHL label or not.

  1. $needs_label bool Whether the shipment needs a DHL label or not.
  2. $shipment \Vendidero\Germanized\Shipments\Shipment The shipment object.
add_filter( "woocommerce_gzd_dhl_shipment_needs_label", function( $needs_label, $shipment ) {
    // Do something
    return $needs_label;    
}, 10, 2 );

woocommerce_gzd_dhl_after_create_label Action

Action fires after creating a DHL label. The dynamic portion of this hook, `$hook_prefix` refers to the label type e.g. return. Example hook name: woocommerce_gzd_dhl_after_create_return_label

  1. $label \Vendidero\Germanized\DHL\Label\Label The label object.
add_action( "woocommerce_gzd_dhl_after_create_label", function( $label ) {
    // Do something
        
}, 10, 1 );

woocommerce_gzd_dhl_customs_item_description Filter

Apply legacy filters

  1. $param_1 string
  2. $param_2 string
  3. $param_3 string
  4. $param_4 string
add_filter( "woocommerce_gzd_dhl_customs_item_description", function( $param_1, $param_2, $param_3, $param_4 ) {
    // Do something
    return $param_1;    
}, 10, 4 );

woocommerce_gzd_dhl_customs_item_category Filter

  1. $param_1 string
  2. $param_2 string
  3. $param_3 string
  4. $param_4 string
add_filter( "woocommerce_gzd_dhl_customs_item_category", function( $param_1, $param_2, $param_3, $param_4 ) {
    // Do something
    return $param_1;    
}, 10, 4 );

woocommerce_gzd_dhl_customs_item Filter

  1. $param_1 string
  2. $param_2 string
  3. $param_3 string
  4. $param_4 string
add_filter( "woocommerce_gzd_dhl_customs_item", function( $param_1, $param_2, $param_3, $param_4 ) {
    // Do something
    return $param_1;    
}, 10, 4 );

woocommerce_gzd_dhl_customs_data Filter

  1. $param_1 string
  2. $param_2 string
  3. $param_3 string
add_filter( "woocommerce_gzd_dhl_customs_data", function( $param_1, $param_2, $param_3 ) {
    // Do something
    return $param_1;    
}, 10, 3 );

woocommerce_gzd_dhl_label_payment_ref_placeholder Filter

  1. $param array
add_filter( "woocommerce_gzd_dhl_label_payment_ref_placeholder", function( $param ) {
    // Do something
    return $param;    
}, 10, 1 );

woocommerce_gzd_dhl_label_customer_reference Filter

Filter to adjust the customer reference field placed on the DHL label. Maximum characeter length: 35.

  1. $text string The customer reference text.
  2. $label \Vendidero\Germanized\DHL\Label\Label The label instance.
  3. $shipment \Vendidero\Germanized\Shipments\SimpleShipment The shipment instance.
add_filter( "woocommerce_gzd_dhl_label_customer_reference", function( $text, $label, $shipment ) {
    // Do something
    return $text;    
}, 10, 3 );

woocommerce_gzd_dhl_label_endorsement_type Filter

  1. $param_1 string
  2. $param_2 string
  3. $param_3 string
add_filter( "woocommerce_gzd_dhl_label_endorsement_type", function( $param_1, $param_2, $param_3 ) {
    // Do something
    return $param_1;    
}, 10, 3 );

woocommerce_gzd_dhl_return_label_customer_reference Filter

Filter to adjust the customer reference field placed on the DHL return label. Maximum characeter length: 30.

  1. $text string The customer reference text.
  2. $label \Vendidero\Germanized\DHL\Label\Label The label instance.
  3. $shipment \Vendidero\Germanized\Shipments\ReturnShipment The shipment instance.
add_filter( "woocommerce_gzd_dhl_return_label_customer_reference", function( $text, $label, $shipment ) {
    // Do something
    return $text;    
}, 10, 3 );

woocommerce_gzd_dhl_inlay_return_label_reference Filter

Filter to adjust the inlay return reference field placed on the DHL label. Maximum characeter length: 35.

  1. $text string The customer reference text.
  2. $label \Vendidero\Germanized\DHL\Label\Label The label instance.
  3. $shipment \Vendidero\Germanized\Shipments\SimpleShipment The shipment instance.
add_filter( "woocommerce_gzd_dhl_inlay_return_label_reference", function( $text, $label, $shipment ) {
    // Do something
    return $text;    
}, 10, 3 );

woocommerce_gzd_dhl_parcel_outlet_routing_email_address Filter

  1. $param_1 string
  2. $param_2 string
add_filter( "woocommerce_gzd_dhl_parcel_outlet_routing_email_address", function( $param_1, $param_2 ) {
    // Do something
    return $param_1;    
}, 10, 2 );

woocommerce_gzd_dhl_label_shipment_street_number_placeholder Filter

This filter is documented in includes/wc-gzd-dhl-core-functions.php

  1. $param string
add_filter( "woocommerce_gzd_dhl_label_shipment_street_number_placeholder", function( $param ) {
    // Do something
    return $param;    
}, 10, 1 );

woocommerce_gzd_dhl_label_custom_format Filter

This filter allows adjusting the default label format (GUI) to a custom format e.g. 910-300-700. The following formats are available:

  • A4
  • 910-300-700
  • 910-300-700-oZ
  • 910-300-600
  • 910-300-610
  • 910-300-710
  • 100x70mm (Warenpost only)

  1. $format string The label format.
  2. $label \Vendidero\Germanized\DHL\Label\DHL The label instance.
  3. $type string The type e.g. inlay_return.
add_filter( "woocommerce_gzd_dhl_label_custom_format", function( $format, $label, $type ) {
    // Do something
    return $format;    
}, 10, 3 );