399 lines
12 KiB
PHP
399 lines
12 KiB
PHP
<?php
|
|
/**
|
|
* WooCommerce Admin Functions
|
|
*
|
|
* @author WooThemes
|
|
* @category Core
|
|
* @package WooCommerce/Admin/Functions
|
|
* @version 2.4.0
|
|
*/
|
|
|
|
if ( ! defined( 'ABSPATH' ) ) {
|
|
exit; // Exit if accessed directly
|
|
}
|
|
|
|
/**
|
|
* Get all WooCommerce screen ids.
|
|
*
|
|
* @return array
|
|
*/
|
|
function wc_get_screen_ids() {
|
|
|
|
$wc_screen_id = sanitize_title( __( 'WooCommerce', 'woocommerce' ) );
|
|
$screen_ids = array(
|
|
'toplevel_page_' . $wc_screen_id,
|
|
$wc_screen_id . '_page_wc-reports',
|
|
$wc_screen_id . '_page_wc-settings',
|
|
$wc_screen_id . '_page_wc-status',
|
|
$wc_screen_id . '_page_wc-addons',
|
|
'toplevel_page_wc-reports',
|
|
'product_page_product_attributes',
|
|
'edit-product',
|
|
'product',
|
|
'edit-shop_coupon',
|
|
'shop_coupon',
|
|
'edit-product_cat',
|
|
'edit-product_tag',
|
|
'edit-product_shipping_class',
|
|
'profile',
|
|
'user-edit'
|
|
);
|
|
|
|
foreach ( wc_get_order_types() as $type ) {
|
|
$screen_ids[] = $type;
|
|
$screen_ids[] = 'edit-' . $type;
|
|
}
|
|
|
|
return apply_filters( 'woocommerce_screen_ids', $screen_ids );
|
|
}
|
|
|
|
/**
|
|
* Create a page and store the ID in an option.
|
|
*
|
|
* @param mixed $slug Slug for the new page
|
|
* @param string $option Option name to store the page's ID
|
|
* @param string $page_title (default: '') Title for the new page
|
|
* @param string $page_content (default: '') Content for the new page
|
|
* @param int $post_parent (default: 0) Parent for the new page
|
|
* @return int page ID
|
|
*/
|
|
function wc_create_page( $slug, $option = '', $page_title = '', $page_content = '', $post_parent = 0 ) {
|
|
global $wpdb;
|
|
|
|
$option_value = get_option( $option );
|
|
|
|
if ( $option_value > 0 ) {
|
|
$page_object = get_post( $option_value );
|
|
|
|
if ( 'page' === $page_object->post_type && ! in_array( $page_object->post_status, array( 'pending', 'trash', 'future', 'auto-draft' ) ) ) {
|
|
// Valid page is already in place
|
|
return $page_object->ID;
|
|
}
|
|
}
|
|
|
|
if ( strlen( $page_content ) > 0 ) {
|
|
// Search for an existing page with the specified page content (typically a shortcode)
|
|
$valid_page_found = $wpdb->get_var( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_type='page' AND post_status NOT IN ( 'pending', 'trash', 'future', 'auto-draft' ) AND post_content LIKE %s LIMIT 1;", "%{$page_content}%" ) );
|
|
} else {
|
|
// Search for an existing page with the specified page slug
|
|
$valid_page_found = $wpdb->get_var( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_type='page' AND post_status NOT IN ( 'pending', 'trash', 'future', 'auto-draft' ) AND post_name = %s LIMIT 1;", $slug ) );
|
|
}
|
|
|
|
$valid_page_found = apply_filters( 'woocommerce_create_page_id', $valid_page_found, $slug, $page_content );
|
|
|
|
if ( $valid_page_found ) {
|
|
if ( $option ) {
|
|
update_option( $option, $valid_page_found );
|
|
}
|
|
return $valid_page_found;
|
|
}
|
|
|
|
// Search for a matching valid trashed page
|
|
if ( strlen( $page_content ) > 0 ) {
|
|
// Search for an existing page with the specified page content (typically a shortcode)
|
|
$trashed_page_found = $wpdb->get_var( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_type='page' AND post_status = 'trash' AND post_content LIKE %s LIMIT 1;", "%{$page_content}%" ) );
|
|
} else {
|
|
// Search for an existing page with the specified page slug
|
|
$trashed_page_found = $wpdb->get_var( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_type='page' AND post_status = 'trash' AND post_name = %s LIMIT 1;", $slug ) );
|
|
}
|
|
|
|
if ( $trashed_page_found ) {
|
|
$page_id = $trashed_page_found;
|
|
$page_data = array(
|
|
'ID' => $page_id,
|
|
'post_status' => 'publish',
|
|
);
|
|
wp_update_post( $page_data );
|
|
} else {
|
|
$page_data = array(
|
|
'post_status' => 'publish',
|
|
'post_type' => 'page',
|
|
'post_author' => 1,
|
|
'post_name' => $slug,
|
|
'post_title' => $page_title,
|
|
'post_content' => $page_content,
|
|
'post_parent' => $post_parent,
|
|
'comment_status' => 'closed'
|
|
);
|
|
$page_id = wp_insert_post( $page_data );
|
|
}
|
|
|
|
if ( $option ) {
|
|
update_option( $option, $page_id );
|
|
}
|
|
|
|
return $page_id;
|
|
}
|
|
|
|
/**
|
|
* Output admin fields.
|
|
*
|
|
* Loops though the woocommerce options array and outputs each field.
|
|
*
|
|
* @param array $options Opens array to output
|
|
*/
|
|
function woocommerce_admin_fields( $options ) {
|
|
|
|
if ( ! class_exists( 'WC_Admin_Settings' ) ) {
|
|
include 'class-wc-admin-settings.php';
|
|
}
|
|
|
|
WC_Admin_Settings::output_fields( $options );
|
|
}
|
|
|
|
/**
|
|
* Update all settings which are passed.
|
|
*
|
|
* @param array $options
|
|
*/
|
|
function woocommerce_update_options( $options ) {
|
|
|
|
if ( ! class_exists( 'WC_Admin_Settings' ) ) {
|
|
include 'class-wc-admin-settings.php';
|
|
}
|
|
|
|
WC_Admin_Settings::save_fields( $options );
|
|
}
|
|
|
|
/**
|
|
* Get a setting from the settings API.
|
|
*
|
|
* @param mixed $option_name
|
|
* @return string
|
|
*/
|
|
function woocommerce_settings_get_option( $option_name, $default = '' ) {
|
|
|
|
if ( ! class_exists( 'WC_Admin_Settings' ) ) {
|
|
include 'class-wc-admin-settings.php';
|
|
}
|
|
|
|
return WC_Admin_Settings::get_option( $option_name, $default );
|
|
}
|
|
|
|
/**
|
|
* Save order items.
|
|
*
|
|
* @since 2.2
|
|
* @param int $order_id Order ID
|
|
* @param array $items Order items to save
|
|
*/
|
|
function wc_save_order_items( $order_id, $items ) {
|
|
global $wpdb;
|
|
|
|
// Order items + fees
|
|
$subtotal = 0;
|
|
$total = 0;
|
|
$subtotal_tax = 0;
|
|
$total_tax = 0;
|
|
$taxes = array( 'items' => array(), 'shipping' => array() );
|
|
|
|
if ( isset( $items['order_item_id'] ) ) {
|
|
$line_total = $line_subtotal = $line_tax = $line_subtotal_tax = array();
|
|
|
|
foreach ( $items['order_item_id'] as $item_id ) {
|
|
|
|
$item_id = absint( $item_id );
|
|
|
|
if ( isset( $items['order_item_name'][ $item_id ] ) ) {
|
|
$wpdb->update(
|
|
$wpdb->prefix . 'woocommerce_order_items',
|
|
array( 'order_item_name' => wc_clean( $items['order_item_name'][ $item_id ] ) ),
|
|
array( 'order_item_id' => $item_id ),
|
|
array( '%s' ),
|
|
array( '%d' )
|
|
);
|
|
}
|
|
|
|
if ( isset( $items['order_item_qty'][ $item_id ] ) ) {
|
|
wc_update_order_item_meta( $item_id, '_qty', wc_stock_amount( $items['order_item_qty'][ $item_id ] ) );
|
|
}
|
|
|
|
if ( isset( $items['order_item_tax_class'][ $item_id ] ) ) {
|
|
wc_update_order_item_meta( $item_id, '_tax_class', wc_clean( $items['order_item_tax_class'][ $item_id ] ) );
|
|
}
|
|
|
|
// Get values. Subtotals might not exist, in which case copy value from total field
|
|
$line_total[ $item_id ] = isset( $items['line_total'][ $item_id ] ) ? $items['line_total'][ $item_id ] : 0;
|
|
$line_subtotal[ $item_id ] = isset( $items['line_subtotal'][ $item_id ] ) ? $items['line_subtotal'][ $item_id ] : $line_total[ $item_id ];
|
|
$line_tax[ $item_id ] = isset( $items['line_tax'][ $item_id ] ) ? $items['line_tax'][ $item_id ] : array();
|
|
$line_subtotal_tax[ $item_id ] = isset( $items['line_subtotal_tax'][ $item_id ] ) ? $items['line_subtotal_tax'][ $item_id ] : $line_tax[ $item_id ];
|
|
|
|
// Format taxes
|
|
$line_taxes = array_map( 'wc_format_decimal', $line_tax[ $item_id ] );
|
|
$line_subtotal_taxes = array_map( 'wc_format_decimal', $line_subtotal_tax[ $item_id ] );
|
|
|
|
// Update values
|
|
wc_update_order_item_meta( $item_id, '_line_subtotal', wc_format_decimal( $line_subtotal[ $item_id ] ) );
|
|
wc_update_order_item_meta( $item_id, '_line_total', wc_format_decimal( $line_total[ $item_id ] ) );
|
|
wc_update_order_item_meta( $item_id, '_line_subtotal_tax', array_sum( $line_subtotal_taxes ) );
|
|
wc_update_order_item_meta( $item_id, '_line_tax', array_sum( $line_taxes ) );
|
|
|
|
// Save line tax data - Since 2.2
|
|
wc_update_order_item_meta( $item_id, '_line_tax_data', array( 'total' => $line_taxes, 'subtotal' => $line_subtotal_taxes ) );
|
|
$taxes['items'][] = $line_taxes;
|
|
|
|
// Total up
|
|
$subtotal += wc_format_decimal( $line_subtotal[ $item_id ] );
|
|
$total += wc_format_decimal( $line_total[ $item_id ] );
|
|
$subtotal_tax += array_sum( $line_subtotal_taxes );
|
|
$total_tax += array_sum( $line_taxes );
|
|
|
|
// Clear meta cache
|
|
wp_cache_delete( $item_id, 'order_item_meta' );
|
|
}
|
|
}
|
|
|
|
// Save meta
|
|
$meta_keys = isset( $items['meta_key'] ) ? $items['meta_key'] : array();
|
|
$meta_values = isset( $items['meta_value'] ) ? $items['meta_value'] : array();
|
|
|
|
foreach ( $meta_keys as $id => $meta_key ) {
|
|
$meta_value = ( empty( $meta_values[ $id ] ) && ! is_numeric( $meta_values[ $id ] ) ) ? '' : $meta_values[ $id ];
|
|
|
|
// Delele blank item meta entries
|
|
if ( $meta_key === '' && $meta_value === '' ) {
|
|
$wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->prefix}woocommerce_order_itemmeta WHERE meta_id = %d", $id ) );
|
|
} else {
|
|
|
|
$wpdb->update(
|
|
$wpdb->prefix . 'woocommerce_order_itemmeta',
|
|
array(
|
|
'meta_key' => wp_unslash( $meta_key ),
|
|
'meta_value' => wp_unslash( $meta_value )
|
|
),
|
|
array( 'meta_id' => $id ),
|
|
array( '%s', '%s' ),
|
|
array( '%d' )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Shipping Rows
|
|
$order_shipping = 0;
|
|
|
|
if ( isset( $items['shipping_method_id'] ) ) {
|
|
|
|
foreach ( $items['shipping_method_id'] as $item_id ) {
|
|
$item_id = absint( $item_id );
|
|
$method_id = isset( $items['shipping_method'][ $item_id ] ) ? wc_clean( $items['shipping_method'][ $item_id ] ) : '';
|
|
$method_title = isset( $items['shipping_method_title'][ $item_id ] ) ? wc_clean( wp_unslash( $items['shipping_method_title'][ $item_id ] ) ) : '';
|
|
$cost = isset( $items['shipping_cost'][ $item_id ] ) ? wc_format_decimal( $items['shipping_cost'][ $item_id ] ) : '';
|
|
$ship_taxes = isset( $items['shipping_taxes'][ $item_id ] ) ? array_map( 'wc_format_decimal', $items['shipping_taxes'][ $item_id ] ) : array();
|
|
|
|
$wpdb->update(
|
|
$wpdb->prefix . 'woocommerce_order_items',
|
|
array( 'order_item_name' => $method_title ),
|
|
array( 'order_item_id' => $item_id ),
|
|
array( '%s' ),
|
|
array( '%d' )
|
|
);
|
|
|
|
wc_update_order_item_meta( $item_id, 'method_id', $method_id );
|
|
wc_update_order_item_meta( $item_id, 'cost', $cost );
|
|
wc_update_order_item_meta( $item_id, 'taxes', $ship_taxes );
|
|
|
|
$taxes['shipping'][] = $ship_taxes;
|
|
|
|
$order_shipping += $cost;
|
|
}
|
|
}
|
|
|
|
// Taxes
|
|
$order_taxes = isset( $items['order_taxes'] ) ? $items['order_taxes'] : array();
|
|
$taxes_items = array();
|
|
$taxes_shipping = array();
|
|
$total_tax = 0;
|
|
$total_shipping_tax = 0;
|
|
|
|
// Sum items taxes
|
|
foreach ( $taxes['items'] as $rates ) {
|
|
|
|
foreach ( $rates as $id => $value ) {
|
|
|
|
if ( isset( $taxes_items[ $id ] ) ) {
|
|
$taxes_items[ $id ] += $value;
|
|
} else {
|
|
$taxes_items[ $id ] = $value;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Sum shipping taxes
|
|
foreach ( $taxes['shipping'] as $rates ) {
|
|
|
|
foreach ( $rates as $id => $value ) {
|
|
|
|
if ( isset( $taxes_shipping[ $id ] ) ) {
|
|
$taxes_shipping[ $id ] += $value;
|
|
} else {
|
|
$taxes_shipping[ $id ] = $value;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Update order taxes
|
|
foreach ( $order_taxes as $item_id => $rate_id ) {
|
|
|
|
if ( isset( $taxes_items[ $rate_id ] ) ) {
|
|
$_total = wc_format_decimal( $taxes_items[ $rate_id ] );
|
|
wc_update_order_item_meta( $item_id, 'tax_amount', $_total );
|
|
|
|
$total_tax += $_total;
|
|
}
|
|
|
|
if ( isset( $taxes_shipping[ $rate_id ] ) ) {
|
|
$_total = wc_format_decimal( $taxes_shipping[ $rate_id ] );
|
|
wc_update_order_item_meta( $item_id, 'shipping_tax_amount', $_total );
|
|
|
|
$total_shipping_tax += $_total;
|
|
}
|
|
}
|
|
|
|
// Update order shipping total
|
|
update_post_meta( $order_id, '_order_shipping', $order_shipping );
|
|
|
|
// Update cart discount from item totals
|
|
update_post_meta( $order_id, '_cart_discount', $subtotal - $total );
|
|
update_post_meta( $order_id, '_cart_discount_tax', $subtotal_tax - $total_tax );
|
|
|
|
// Update totals
|
|
update_post_meta( $order_id, '_order_total', wc_format_decimal( $items['_order_total'] ) );
|
|
|
|
// Update tax
|
|
update_post_meta( $order_id, '_order_tax', wc_format_decimal( $total_tax ) );
|
|
update_post_meta( $order_id, '_order_shipping_tax', wc_format_decimal( $total_shipping_tax ) );
|
|
|
|
// Remove old values
|
|
delete_post_meta( $order_id, '_shipping_method' );
|
|
delete_post_meta( $order_id, '_shipping_method_title' );
|
|
|
|
// Set the currency
|
|
add_post_meta( $order_id, '_order_currency', get_woocommerce_currency(), true );
|
|
|
|
// Update version after saving
|
|
update_post_meta( $order_id, '_order_version', WC_VERSION );
|
|
|
|
// inform other plugins that the items have been saved
|
|
do_action( 'woocommerce_saved_order_items', $order_id, $items );
|
|
}
|
|
|
|
/**
|
|
* Add help tips.
|
|
* Display a WooCommerce help tip.
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @param string $tip Help tip text
|
|
* @param bool $allow_html Allow sanitized HTML if true or escape
|
|
* @return string
|
|
*/
|
|
function wc_help_tip( $tip, $allow_html = false ) {
|
|
if ( $allow_html ) {
|
|
$tip = wc_sanitize_tooltip( $tip );
|
|
} else {
|
|
$tip = esc_attr( $tip );
|
|
}
|
|
|
|
return '<span class="woocommerce-help-tip" data-tip="' . $tip . '"></span>';
|
|
}
|