woocommerce/includes/wc-deprecated-functions.php

785 lines
19 KiB
PHP

<?php
/**
* Deprecated functions
*
* Where functions come to die.
*
* @author WooThemes
* @category Core
* @package WooCommerce/Functions
* @version 2.1.0
*/
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly
}
/**
* @deprecated
*/
function woocommerce_show_messages() {
_deprecated_function( 'woocommerce_show_messages', '2.1', 'wc_print_notices' );
wc_print_notices();
}
/**
* @deprecated
*/
function woocommerce_weekend_area_js() {
_deprecated_function( 'woocommerce_weekend_area_js', '2.1', '' );
}
/**
* @deprecated
*/
function woocommerce_tooltip_js() {
_deprecated_function( 'woocommerce_tooltip_js', '2.1', '' );
}
/**
* @deprecated
*/
function woocommerce_datepicker_js() {
_deprecated_function( 'woocommerce_datepicker_js', '2.1', '' );
}
/**
* @deprecated
*/
function woocommerce_admin_scripts() {
_deprecated_function( 'woocommerce_admin_scripts', '2.1', '' );
}
/**
* @deprecated
*/
function woocommerce_create_page( $slug, $option = '', $page_title = '', $page_content = '', $post_parent = 0 ) {
_deprecated_function( 'woocommerce_create_page', '2.1', 'wc_create_page' );
return wc_create_page( $slug, $option, $page_title, $page_content, $post_parent );
}
/**
* @deprecated
*/
function woocommerce_readfile_chunked( $file, $retbytes = true ) {
_deprecated_function( 'woocommerce_readfile_chunked', '2.1', 'WC_Download_Handler::readfile_chunked()' );
return WC_Download_Handler::readfile_chunked( $file );
}
/**
* Formal total costs - format to the number of decimal places for the base currency.
*
* @access public
* @param mixed $number
* @deprecated 2.1
* @return string
*/
function woocommerce_format_total( $number ) {
_deprecated_function( __FUNCTION__, '2.1', 'wc_format_decimal()' );
return wc_format_decimal( $number, wc_get_price_decimals(), false );
}
/**
* Get product name with extra details such as SKU price and attributes. Used within admin.
*
* @access public
* @param WC_Product $product
* @deprecated 2.1
* @return string
*/
function woocommerce_get_formatted_product_name( $product ) {
_deprecated_function( __FUNCTION__, '2.1', 'WC_Product::get_formatted_name()' );
return $product->get_formatted_name();
}
/**
* Handle IPN requests for the legacy paypal gateway by calling gateways manually if needed.
*
* @access public
*/
function woocommerce_legacy_paypal_ipn() {
if ( ! empty( $_GET['paypalListener'] ) && 'paypal_standard_IPN' === $_GET['paypalListener'] ) {
WC()->payment_gateways();
do_action( 'woocommerce_api_wc_gateway_paypal' );
}
}
add_action( 'init', 'woocommerce_legacy_paypal_ipn' );
/**
* get_product soft deprecated for wc_get_product.
*
* @deprecated
*/
function get_product( $the_product = false, $args = array() ) {
return wc_get_product( $the_product, $args );
}
/**
* Cart functions (soft deprecated).
*/
/**
* @deprecated
*/
function woocommerce_protected_product_add_to_cart( $passed, $product_id ) {
return wc_protected_product_add_to_cart( $passed, $product_id );
}
/**
* @deprecated
*/
function woocommerce_empty_cart() {
wc_empty_cart();
}
/**
* @deprecated
*/
function woocommerce_load_persistent_cart( $user_login, $user = 0 ) {
return wc_load_persistent_cart( $user_login, $user );
}
/**
* @deprecated
*/
function woocommerce_add_to_cart_message( $product_id ) {
wc_add_to_cart_message( $product_id );
}
/**
* @deprecated
*/
function woocommerce_clear_cart_after_payment() {
wc_clear_cart_after_payment();
}
/**
* @deprecated
*/
function woocommerce_cart_totals_subtotal_html() {
wc_cart_totals_subtotal_html();
}
/**
* @deprecated
*/
function woocommerce_cart_totals_shipping_html() {
wc_cart_totals_shipping_html();
}
/**
* @deprecated
*/
function woocommerce_cart_totals_coupon_html( $coupon ) {
wc_cart_totals_coupon_html( $coupon );
}
/**
* @deprecated
*/
function woocommerce_cart_totals_order_total_html() {
wc_cart_totals_order_total_html();
}
/**
* @deprecated
*/
function woocommerce_cart_totals_fee_html( $fee ) {
wc_cart_totals_fee_html( $fee );
}
/**
* @deprecated
*/
function woocommerce_cart_totals_shipping_method_label( $method ) {
return wc_cart_totals_shipping_method_label( $method );
}
/**
* Core functions (soft deprecated).
*/
/**
* @deprecated
*/
function woocommerce_get_template_part( $slug, $name = '' ) {
wc_get_template_part( $slug, $name );
}
/**
* @deprecated
*/
function woocommerce_get_template( $template_name, $args = array(), $template_path = '', $default_path = '' ) {
wc_get_template( $template_name, $args, $template_path, $default_path );
}
/**
* @deprecated
*/
function woocommerce_locate_template( $template_name, $template_path = '', $default_path = '' ) {
return wc_locate_template( $template_name, $template_path, $default_path );
}
/**
* @deprecated
*/
function woocommerce_mail( $to, $subject, $message, $headers = "Content-Type: text/html\r\n", $attachments = "" ) {
wc_mail( $to, $subject, $message, $headers, $attachments );
}
/**
* Customer functions (soft deprecated).
*/
/**
* @deprecated
*/
function woocommerce_disable_admin_bar( $show_admin_bar ) {
return wc_disable_admin_bar( $show_admin_bar );
}
/**
* @deprecated
*/
function woocommerce_create_new_customer( $email, $username = '', $password = '' ) {
return wc_create_new_customer( $email, $username, $password );
}
/**
* @deprecated
*/
function woocommerce_set_customer_auth_cookie( $customer_id ) {
wc_set_customer_auth_cookie( $customer_id );
}
/**
* @deprecated
*/
function woocommerce_update_new_customer_past_orders( $customer_id ) {
return wc_update_new_customer_past_orders( $customer_id );
}
/**
* @deprecated
*/
function woocommerce_paying_customer( $order_id ) {
wc_paying_customer( $order_id );
}
/**
* @deprecated
*/
function woocommerce_customer_bought_product( $customer_email, $user_id, $product_id ) {
return wc_customer_bought_product( $customer_email, $user_id, $product_id );
}
/**
* @deprecated
*/
function woocommerce_customer_has_capability( $allcaps, $caps, $args ) {
return wc_customer_has_capability( $allcaps, $caps, $args );
}
/**
* Formatting functions (soft deprecated).
*/
/**
* @deprecated
*/
function woocommerce_sanitize_taxonomy_name( $taxonomy ) {
return wc_sanitize_taxonomy_name( $taxonomy );
}
/**
* @deprecated
*/
function woocommerce_get_filename_from_url( $file_url ) {
return wc_get_filename_from_url( $file_url );
}
/**
* @deprecated
*/
function woocommerce_get_dimension( $dim, $to_unit ) {
return wc_get_dimension( $dim, $to_unit );
}
/**
* @deprecated
*/
function woocommerce_get_weight( $weight, $to_unit ) {
return wc_get_weight( $weight, $to_unit );
}
/**
* @deprecated
*/
function woocommerce_trim_zeros( $price ) {
return wc_trim_zeros( $price );
}
/**
* @deprecated
*/
function woocommerce_round_tax_total( $tax ) {
return wc_round_tax_total( $tax );
}
/**
* @deprecated
*/
function woocommerce_format_decimal( $number, $dp = false, $trim_zeros = false ) {
return wc_format_decimal( $number, $dp, $trim_zeros );
}
/**
* @deprecated
*/
function woocommerce_clean( $var ) {
return wc_clean( $var );
}
/**
* @deprecated
*/
function woocommerce_array_overlay( $a1, $a2 ) {
return wc_array_overlay( $a1, $a2 );
}
/**
* @deprecated
*/
function woocommerce_price( $price, $args = array() ) {
return wc_price( $price, $args );
}
/**
* @deprecated
*/
function woocommerce_let_to_num( $size ) {
return wc_let_to_num( $size );
}
/**
* @return string
*/
/**
* @deprecated
*/
function woocommerce_date_format() {
return wc_date_format();
}
/**
* @deprecated
*/
function woocommerce_time_format() {
return wc_time_format();
}
/**
* @deprecated
*/
function woocommerce_timezone_string() {
return wc_timezone_string();
}
if ( ! function_exists( 'woocommerce_rgb_from_hex' ) ) {
/**
* @deprecated
*/
function woocommerce_rgb_from_hex( $color ) {
return wc_rgb_from_hex( $color );
}
}
if ( ! function_exists( 'woocommerce_hex_darker' ) ) {
/**
* @deprecated
*/
function woocommerce_hex_darker( $color, $factor = 30 ) {
return wc_hex_darker( $color, $factor );
}
}
if ( ! function_exists( 'woocommerce_hex_lighter' ) ) {
/**
* @deprecated
*/
function woocommerce_hex_lighter( $color, $factor = 30 ) {
return wc_hex_lighter( $color, $factor );
}
}
if ( ! function_exists( 'woocommerce_light_or_dark' ) ) {
/**
* @deprecated
*/
function woocommerce_light_or_dark( $color, $dark = '#000000', $light = '#FFFFFF' ) {
return wc_light_or_dark( $color, $dark, $light );
}
}
if ( ! function_exists( 'woocommerce_format_hex' ) ) {
/**
* @deprecated
*/
function woocommerce_format_hex( $hex ) {
return wc_format_hex( $hex );
}
}
/**
* Order functions (soft deprecated).
*/
/**
* @deprecated
*/
function woocommerce_get_order_id_by_order_key( $order_key ) {
return wc_get_order_id_by_order_key( $order_key );
}
/**
* @deprecated
*/
function woocommerce_downloadable_file_permission( $download_id, $product_id, $order ) {
return wc_downloadable_file_permission( $download_id, $product_id, $order );
}
/**
* @deprecated
*/
function woocommerce_downloadable_product_permissions( $order_id ) {
wc_downloadable_product_permissions( $order_id );
}
/**
* @deprecated
*/
function woocommerce_add_order_item( $order_id, $item ) {
return wc_add_order_item( $order_id, $item );
}
/**
* @deprecated
*/
function woocommerce_delete_order_item( $item_id ) {
return wc_delete_order_item( $item_id );
}
/**
* @deprecated
*/
function woocommerce_update_order_item_meta( $item_id, $meta_key, $meta_value, $prev_value = '' ) {
return wc_update_order_item_meta( $item_id, $meta_key, $meta_value, $prev_value );
}
/**
* @deprecated
*/
function woocommerce_add_order_item_meta( $item_id, $meta_key, $meta_value, $unique = false ) {
return wc_add_order_item_meta( $item_id, $meta_key, $meta_value, $unique );
}
/**
* @deprecated
*/
function woocommerce_delete_order_item_meta( $item_id, $meta_key, $meta_value = '', $delete_all = false ) {
return wc_delete_order_item_meta( $item_id, $meta_key, $meta_value, $delete_all );
}
/**
* @deprecated
*/
function woocommerce_get_order_item_meta( $item_id, $key, $single = true ) {
return wc_get_order_item_meta( $item_id, $key, $single );
}
/**
* @deprecated
*/
function woocommerce_cancel_unpaid_orders() {
wc_cancel_unpaid_orders();
}
/**
* @deprecated
*/
function woocommerce_processing_order_count() {
return wc_processing_order_count();
}
/**
* Page functions (soft deprecated).
*/
/**
* @deprecated
*/
function woocommerce_get_page_id( $page ) {
return wc_get_page_id( $page );
}
/**
* @deprecated
*/
function woocommerce_get_endpoint_url( $endpoint, $value = '', $permalink = '' ) {
return wc_get_endpoint_url( $endpoint, $value, $permalink );
}
/**
* @deprecated
*/
function woocommerce_lostpassword_url( $url ) {
return wc_lostpassword_url( $url );
}
/**
* @deprecated
*/
function woocommerce_customer_edit_account_url() {
return wc_customer_edit_account_url();
}
/**
* @deprecated
*/
function woocommerce_nav_menu_items( $items, $args ) {
return wc_nav_menu_items( $items );
}
/**
* @deprecated
*/
function woocommerce_nav_menu_item_classes( $menu_items, $args ) {
return wc_nav_menu_item_classes( $menu_items );
}
/**
* @deprecated
*/
function woocommerce_list_pages( $pages ) {
return wc_list_pages( $pages );
}
/**
* Handle renamed filters.
*/
global $wc_map_deprecated_filters;
$wc_map_deprecated_filters = array(
'woocommerce_structured_data_order' => 'woocommerce_email_order_schema_markup',
'woocommerce_add_to_cart_fragments' => 'add_to_cart_fragments',
'woocommerce_add_to_cart_redirect' => 'add_to_cart_redirect',
'woocommerce_product_get_width' => 'woocommerce_product_width',
'woocommerce_product_get_height' => 'woocommerce_product_height',
'woocommerce_product_get_length' => 'woocommerce_product_length',
'woocommerce_product_get_weight' => 'woocommerce_product_weight',
'woocommerce_product_get_sku' => 'woocommerce_get_sku',
'woocommerce_product_get_price' => 'woocommerce_get_price',
'woocommerce_product_get_regular_price' => 'woocommerce_get_regular_price',
'woocommerce_product_get_sale_price' => 'woocommerce_get_sale_price',
'woocommerce_product_get_tax_class' => 'woocommerce_product_tax_class',
'woocommerce_product_get_stock_quantity' => 'woocommerce_get_stock_quantity',
'woocommerce_product_get_attributes' => 'woocommerce_get_product_attributes',
'woocommerce_product_get_gallery_image_ids' => 'woocommerce_product_gallery_attachment_ids',
);
foreach ( $wc_map_deprecated_filters as $new => $old ) {
add_filter( $new, 'woocommerce_deprecated_filter_mapping' );
}
function woocommerce_deprecated_filter_mapping( $data, $arg_1 = '', $arg_2 = '', $arg_3 = '' ) {
global $wc_map_deprecated_filters;
$filter = current_filter();
if ( isset( $wc_map_deprecated_filters[ $filter ] ) ) {
if ( has_filter( $wc_map_deprecated_filters[ $filter ] ) ) {
$data = apply_filters( $wc_map_deprecated_filters[ $filter ], $data, $arg_1, $arg_2, $arg_3 );
if ( ! is_ajax() ) {
_deprecated_function( 'The ' . $wc_map_deprecated_filters[ $filter ] . ' filter', '', $filter );
}
}
}
return $data;
}
/**
* Alias functions/soft-deprecated function names (moving from woocommerce_ to wc_). These will be deprecated with notices in future updates.
*/
/**
* Attribute functions - soft deprecated.
*/
/**
* @deprecated
*/
function woocommerce_product_dropdown_categories( $args = array(), $deprecated_hierarchical = 1, $deprecated_show_uncategorized = 1, $deprecated_orderby = '' ) {
return wc_product_dropdown_categories( $args, $deprecated_hierarchical, $deprecated_show_uncategorized, $deprecated_orderby );
}
/**
* @deprecated
*/
function woocommerce_walk_category_dropdown_tree( $a1 = '', $a2 = '', $a3 = '' ) {
return wc_walk_category_dropdown_tree( $a1, $a2, $a3 );
}
/**
* @deprecated
*/
function woocommerce_taxonomy_metadata_wpdbfix() {}
/**
* @deprecated
*/
function wc_taxonomy_metadata_wpdbfix() {}
/**
* @deprecated
*/
function woocommerce_order_terms( $the_term, $next_id, $taxonomy, $index = 0, $terms = null ) {
return wc_reorder_terms( $the_term, $next_id, $taxonomy, $index, $terms );
}
/**
* @deprecated
*/
function woocommerce_set_term_order( $term_id, $index, $taxonomy, $recursive = false ) {
return wc_set_term_order( $term_id, $index, $taxonomy, $recursive );
}
/**
* @deprecated
*/
function woocommerce_terms_clauses( $clauses, $taxonomies, $args ) {
return wc_terms_clauses( $clauses, $taxonomies, $args );
}
/**
* @deprecated
*/
function _woocommerce_term_recount( $terms, $taxonomy, $callback, $terms_are_term_taxonomy_ids ) {
return _wc_term_recount( $terms, $taxonomy, $callback, $terms_are_term_taxonomy_ids );
}
/**
* @deprecated
*/
function woocommerce_recount_after_stock_change( $product_id ) {
return wc_recount_after_stock_change( $product_id );
}
/**
* @deprecated
*/
function woocommerce_change_term_counts( $terms, $taxonomies, $args ) {
return wc_change_term_counts( $terms, $taxonomies );
}
/**
* Product functions - soft deprecated.
*/
/**
* @deprecated
*/
function woocommerce_get_product_ids_on_sale() {
return wc_get_product_ids_on_sale();
}
/**
* @deprecated
*/
function woocommerce_get_featured_product_ids() {
return wc_get_featured_product_ids();
}
/**
* @deprecated
*/
function woocommerce_get_product_terms( $object_id, $taxonomy, $fields = 'all' ) {
return wc_get_product_terms( $object_id, $taxonomy, array( 'fields' => $fields ) );
}
/**
* @deprecated
*/
function woocommerce_product_post_type_link( $permalink, $post ) {
return wc_product_post_type_link( $permalink, $post );
}
/**
* @deprecated
*/
function woocommerce_placeholder_img_src() {
return wc_placeholder_img_src();
}
/**
* @deprecated
*/
function woocommerce_placeholder_img( $size = 'shop_thumbnail' ) {
return wc_placeholder_img( $size );
}
/**
* @deprecated
*/
function woocommerce_get_formatted_variation( $variation = '', $flat = false ) {
return wc_get_formatted_variation( $variation, $flat );
}
/**
* @deprecated
*/
function woocommerce_scheduled_sales() {
return wc_scheduled_sales();
}
/**
* @deprecated
*/
function woocommerce_get_attachment_image_attributes( $attr ) {
return wc_get_attachment_image_attributes( $attr );
}
/**
* @deprecated
*/
function woocommerce_prepare_attachment_for_js( $response ) {
return wc_prepare_attachment_for_js( $response );
}
/**
* @deprecated
*/
function woocommerce_track_product_view() {
return wc_track_product_view();
}
/**
* Shop order status.
*
* @since 2.2
* @param WP_Query $q
*/
function wc_shop_order_status_backwards_compatibility( $q ) {
if ( $q->is_main_query() ) {
return;
}
if (
isset( $q->query_vars['post_type'] ) && 'shop_order' == $q->query_vars['post_type']
&& isset( $q->query_vars['post_status'] ) && 'publish' == $q->query_vars['post_status']
) {
$tax_query = isset( $q->query_vars['tax_query'] ) ? $q->query_vars['tax_query'] : array();
$order_status = array();
$tax_key = '';
// Look for shop_order_status taxonomy and get the terms
foreach ( $tax_query as $key => $tax ) {
if ( 'shop_order_status' == $tax['taxonomy'] ) {
$tax_key = $key;
$order_status = $tax['terms'];
break;
}
}
if ( $order_status ) {
// Remove old tax_query
unset( $tax_query[ $tax_key ] );
// Set the new order status
$order_status = is_array( $order_status ) ? 'wc-' . implode( ',wc-', $order_status ) : 'wc-' . $order_status;
$q->set( 'post_status', $order_status );
$q->set( 'tax_query', $tax_query );
_doing_it_wrong( 'WP_Query', sprintf( __( 'The shop_order_status taxonomy is no more in WooCommerce 2.2! You should use the new WooCommerce post_status instead, <a href="%s">read more...</a>', 'woocommerce' ), 'https://woocommerce.wordpress.com/2014/08/wc-2-2-order-statuses-plugin-compatibility/' ), 'WooCommerce 2.2' );
} else {
$q->set( 'post_status', array_keys( wc_get_order_statuses() ) );
_doing_it_wrong( 'WP_Query', sprintf( __( 'The "publish" order status is no more in WooCommerce 2.2! You should use the new WooCommerce post_status instead, <a href="%s">read more...</a>', 'woocommerce' ), 'https://woocommerce.wordpress.com/2014/08/wc-2-2-order-statuses-plugin-compatibility/' ), 'WooCommerce 2.2' );
}
}
}
add_action( 'pre_get_posts', 'wc_shop_order_status_backwards_compatibility' );
/**
* @since 2.3
* @deprecated has no replacement
*/
function woocommerce_compile_less_styles() {
_deprecated_function( 'woocommerce_compile_less_styles', '2.3' );
}
/**
* woocommerce_calc_shipping was an option used to determine if shipping was enabled prior to version 2.6.0. This has since been replaced with wc_shipping_enabled() function and
* the woocommerce_ship_to_countries setting.
* @since 2.6.0
* @return string
*/
function woocommerce_calc_shipping_backwards_compatibility( $value ) {
if ( defined( 'WC_UPDATING' ) ) {
return $value;
}
return 'disabled' === get_option( 'woocommerce_ship_to_countries' ) ? 'no' : 'yes';
}
add_filter( 'pre_option_woocommerce_calc_shipping', 'woocommerce_calc_shipping_backwards_compatibility' );
/**
* @deprecated 2.7.0
* @see WC_Structured_Data class
*
* @return string
*/
function woocommerce_get_product_schema() {
_deprecated_function( 'woocommerce_get_product_schema', '2.7' );
global $product;
$schema = "Product";
// Downloadable product schema handling
if ( $product->is_downloadable() ) {
switch ( $product->download_type ) {
case 'application' :
$schema = "SoftwareApplication";
break;
case 'music' :
$schema = "MusicAlbum";
break;
default :
$schema = "Product";
break;
}
}
return 'http://schema.org/' . $schema;
}