396 lines
12 KiB
PHP
396 lines
12 KiB
PHP
<?php
|
|
/**
|
|
* WooCommerce Core Functions
|
|
*
|
|
* General core functions available on both the front-end and admin.
|
|
*
|
|
* @author WooThemes
|
|
* @category Core
|
|
* @package WooCommerce/Functions
|
|
* @version 2.1.0
|
|
*/
|
|
|
|
if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly
|
|
|
|
// Include core functions
|
|
include( 'wc-cart-functions.php' );
|
|
include( 'wc-conditional-functions.php' );
|
|
include( 'wc-coupon-functions.php' );
|
|
include( 'wc-customer-functions.php' );
|
|
include( 'wc-deprecated-functions.php' );
|
|
include( 'wc-formatting-functions.php' );
|
|
include( 'wc-notice-functions.php' );
|
|
include( 'wc-order-functions.php' );
|
|
include( 'wc-page-functions.php' );
|
|
include( 'wc-product-functions.php' );
|
|
include( 'wc-term-functions.php' );
|
|
include( 'wc-attribute-functions.php' );
|
|
|
|
/**
|
|
* Filters on data used in admin and frontend
|
|
*/
|
|
add_filter( 'woocommerce_coupon_code', 'sanitize_text_field' );
|
|
add_filter( 'woocommerce_coupon_code', 'strtolower' ); // Coupons case-insensitive by default
|
|
add_filter( 'woocommerce_stock_amount', 'intval' ); // Stock amounts are integers by default
|
|
|
|
/**
|
|
* Short Description (excerpt)
|
|
*/
|
|
add_filter( 'woocommerce_short_description', 'wptexturize' );
|
|
add_filter( 'woocommerce_short_description', 'convert_smilies' );
|
|
add_filter( 'woocommerce_short_description', 'convert_chars' );
|
|
add_filter( 'woocommerce_short_description', 'wpautop' );
|
|
add_filter( 'woocommerce_short_description', 'shortcode_unautop' );
|
|
add_filter( 'woocommerce_short_description', 'prepend_attachment' );
|
|
add_filter( 'woocommerce_short_description', 'do_shortcode', 11 ); // AFTER wpautop()
|
|
|
|
/**
|
|
* Get template part (for templates like the shop-loop).
|
|
*
|
|
* @access public
|
|
* @param mixed $slug
|
|
* @param string $name (default: '')
|
|
* @return void
|
|
*/
|
|
function wc_get_template_part( $slug, $name = '' ) {
|
|
$template = '';
|
|
|
|
// Look in yourtheme/slug-name.php and yourtheme/woocommerce/slug-name.php
|
|
if ( $name ) {
|
|
$template = locate_template( array( "{$slug}-{$name}.php", WC()->template_path() . "{$slug}-{$name}.php" ) );
|
|
}
|
|
|
|
// Get default slug-name.php
|
|
if ( ! $template && $name && file_exists( WC()->plugin_path() . "/templates/{$slug}-{$name}.php" ) ) {
|
|
$template = WC()->plugin_path() . "/templates/{$slug}-{$name}.php";
|
|
}
|
|
|
|
// If template file doesn't exist, look in yourtheme/slug.php and yourtheme/woocommerce/slug.php
|
|
if ( ! $template ) {
|
|
$template = locate_template( array( "{$slug}.php", WC()->template_path() . "{$slug}.php" ) );
|
|
}
|
|
|
|
// Allow 3rd party plugin filter template file from their plugin
|
|
$template = apply_filters( 'wc_get_template_part', $template, $slug, $name );
|
|
|
|
if ( $template ) {
|
|
load_template( $template, false );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get other templates (e.g. product attributes) passing attributes and including the file.
|
|
*
|
|
* @access public
|
|
* @param mixed $template_name
|
|
* @param array $args (default: array())
|
|
* @param string $template_path (default: '')
|
|
* @param string $default_path (default: '')
|
|
* @return void
|
|
*/
|
|
function wc_get_template( $template_name, $args = array(), $template_path = '', $default_path = '' ) {
|
|
if ( $args && is_array( $args ) ) {
|
|
extract( $args );
|
|
}
|
|
|
|
$located = wc_locate_template( $template_name, $template_path, $default_path );
|
|
|
|
if ( ! file_exists( $located ) ) {
|
|
_doing_it_wrong( __FUNCTION__, sprintf( '<code>%s</code> does not exist.', $located ), '2.1' );
|
|
return;
|
|
}
|
|
|
|
do_action( 'woocommerce_before_template_part', $template_name, $template_path, $located, $args );
|
|
|
|
include( $located );
|
|
|
|
do_action( 'woocommerce_after_template_part', $template_name, $template_path, $located, $args );
|
|
}
|
|
|
|
/**
|
|
* Locate a template and return the path for inclusion.
|
|
*
|
|
* This is the load order:
|
|
*
|
|
* yourtheme / $template_path / $template_name
|
|
* yourtheme / $template_name
|
|
* $default_path / $template_name
|
|
*
|
|
* @access public
|
|
* @param mixed $template_name
|
|
* @param string $template_path (default: '')
|
|
* @param string $default_path (default: '')
|
|
* @return string
|
|
*/
|
|
function wc_locate_template( $template_name, $template_path = '', $default_path = '' ) {
|
|
if ( ! $template_path ) {
|
|
$template_path = WC()->template_path();
|
|
}
|
|
|
|
if ( ! $default_path ) {
|
|
$default_path = WC()->plugin_path() . '/templates/';
|
|
}
|
|
|
|
// Look within passed path within the theme - this is priority
|
|
$template = locate_template(
|
|
array(
|
|
trailingslashit( $template_path ) . $template_name,
|
|
$template_name
|
|
)
|
|
);
|
|
|
|
// Get default template
|
|
if ( ! $template ) {
|
|
$template = $default_path . $template_name;
|
|
}
|
|
|
|
// Return what we found
|
|
return apply_filters('woocommerce_locate_template', $template, $template_name, $template_path);
|
|
}
|
|
|
|
/**
|
|
* Get Base Currency Code.
|
|
* @return string
|
|
*/
|
|
function get_woocommerce_currency() {
|
|
return apply_filters( 'woocommerce_currency', get_option('woocommerce_currency') );
|
|
}
|
|
|
|
/**
|
|
* Get full list of currency codes.
|
|
* @return array
|
|
*/
|
|
function get_woocommerce_currencies() {
|
|
return array_unique(
|
|
apply_filters( 'woocommerce_currencies',
|
|
array(
|
|
'AED' => __( 'United Arab Emirates Dirham', 'woocommerce' ),
|
|
'AUD' => __( 'Australian Dollars', 'woocommerce' ),
|
|
'BDT' => __( 'Bangladeshi Taka', 'woocommerce' ),
|
|
'BRL' => __( 'Brazilian Real', 'woocommerce' ),
|
|
'BGN' => __( 'Bulgarian Lev', 'woocommerce' ),
|
|
'CAD' => __( 'Canadian Dollars', 'woocommerce' ),
|
|
'CLP' => __( 'Chilean Peso', 'woocommerce' ),
|
|
'CNY' => __( 'Chinese Yuan', 'woocommerce' ),
|
|
'COP' => __( 'Colombian Peso', 'woocommerce' ),
|
|
'CZK' => __( 'Czech Koruna', 'woocommerce' ),
|
|
'DKK' => __( 'Danish Krone', 'woocommerce' ),
|
|
'EUR' => __( 'Euros', 'woocommerce' ),
|
|
'HKD' => __( 'Hong Kong Dollar', 'woocommerce' ),
|
|
'HRK' => __( 'Croatia kuna', 'woocommerce' ),
|
|
'HUF' => __( 'Hungarian Forint', 'woocommerce' ),
|
|
'ISK' => __( 'Icelandic krona', 'woocommerce' ),
|
|
'IDR' => __( 'Indonesia Rupiah', 'woocommerce' ),
|
|
'INR' => __( 'Indian Rupee', 'woocommerce' ),
|
|
'ILS' => __( 'Israeli Shekel', 'woocommerce' ),
|
|
'JPY' => __( 'Japanese Yen', 'woocommerce' ),
|
|
'KRW' => __( 'South Korean Won', 'woocommerce' ),
|
|
'MYR' => __( 'Malaysian Ringgits', 'woocommerce' ),
|
|
'MXN' => __( 'Mexican Peso', 'woocommerce' ),
|
|
'NGN' => __( 'Nigerian Naira', 'woocommerce' ),
|
|
'NOK' => __( 'Norwegian Krone', 'woocommerce' ),
|
|
'NZD' => __( 'New Zealand Dollar', 'woocommerce' ),
|
|
'PHP' => __( 'Philippine Pesos', 'woocommerce' ),
|
|
'PLN' => __( 'Polish Zloty', 'woocommerce' ),
|
|
'GBP' => __( 'Pounds Sterling', 'woocommerce' ),
|
|
'RON' => __( 'Romanian Leu', 'woocommerce' ),
|
|
'RUB' => __( 'Russian Ruble', 'woocommerce' ),
|
|
'SGD' => __( 'Singapore Dollar', 'woocommerce' ),
|
|
'ZAR' => __( 'South African rand', 'woocommerce' ),
|
|
'SEK' => __( 'Swedish Krona', 'woocommerce' ),
|
|
'CHF' => __( 'Swiss Franc', 'woocommerce' ),
|
|
'TWD' => __( 'Taiwan New Dollars', 'woocommerce' ),
|
|
'THB' => __( 'Thai Baht', 'woocommerce' ),
|
|
'TRY' => __( 'Turkish Lira', 'woocommerce' ),
|
|
'USD' => __( 'US Dollars', 'woocommerce' ),
|
|
'VND' => __( 'Vietnamese Dong', 'woocommerce' ),
|
|
)
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get Currency symbol.
|
|
* @param string $currency (default: '')
|
|
* @return string
|
|
*/
|
|
function get_woocommerce_currency_symbol( $currency = '' ) {
|
|
if ( ! $currency ) {
|
|
$currency = get_woocommerce_currency();
|
|
}
|
|
|
|
switch ( $currency ) {
|
|
case 'AED' :
|
|
$currency_symbol = 'د.إ';
|
|
break;
|
|
case 'BDT':
|
|
$currency_symbol = '৳ ';
|
|
break;
|
|
case 'BRL' :
|
|
$currency_symbol = 'R$';
|
|
break;
|
|
case 'BGN' :
|
|
$currency_symbol = 'лв.';
|
|
break;
|
|
case 'AUD' :
|
|
case 'CAD' :
|
|
case 'CLP' :
|
|
case 'MXN' :
|
|
case 'NZD' :
|
|
case 'HKD' :
|
|
case 'SGD' :
|
|
case 'USD' :
|
|
$currency_symbol = '$';
|
|
break;
|
|
case 'EUR' :
|
|
$currency_symbol = '€';
|
|
break;
|
|
case 'CNY' :
|
|
case 'RMB' :
|
|
case 'JPY' :
|
|
$currency_symbol = '¥';
|
|
break;
|
|
case 'RUB' :
|
|
$currency_symbol = 'руб.';
|
|
break;
|
|
case 'KRW' : $currency_symbol = '₩'; break;
|
|
case 'TRY' : $currency_symbol = 'TL'; break;
|
|
case 'NOK' : $currency_symbol = 'kr'; break;
|
|
case 'ZAR' : $currency_symbol = 'R'; break;
|
|
case 'CZK' : $currency_symbol = 'Kč'; break;
|
|
case 'MYR' : $currency_symbol = 'RM'; break;
|
|
case 'DKK' : $currency_symbol = 'kr'; break;
|
|
case 'HUF' : $currency_symbol = 'Ft'; break;
|
|
case 'IDR' : $currency_symbol = 'Rp'; break;
|
|
case 'INR' : $currency_symbol = 'Rs.'; break;
|
|
case 'ISK' : $currency_symbol = 'Kr.'; break;
|
|
case 'ILS' : $currency_symbol = '₪'; break;
|
|
case 'PHP' : $currency_symbol = '₱'; break;
|
|
case 'PLN' : $currency_symbol = 'zł'; break;
|
|
case 'SEK' : $currency_symbol = 'kr'; break;
|
|
case 'CHF' : $currency_symbol = 'CHF'; break;
|
|
case 'TWD' : $currency_symbol = 'NT$'; break;
|
|
case 'THB' : $currency_symbol = '฿'; break;
|
|
case 'GBP' : $currency_symbol = '£'; break;
|
|
case 'RON' : $currency_symbol = 'lei'; break;
|
|
case 'VND' : $currency_symbol = '₫'; break;
|
|
case 'NGN' : $currency_symbol = '₦'; break;
|
|
case 'HRK' : $currency_symbol = 'Kn'; break;
|
|
default : $currency_symbol = ''; break;
|
|
}
|
|
|
|
return apply_filters( 'woocommerce_currency_symbol', $currency_symbol, $currency );
|
|
}
|
|
|
|
/**
|
|
* Send HTML emails from WooCommerce
|
|
*
|
|
* @param mixed $to
|
|
* @param mixed $subject
|
|
* @param mixed $message
|
|
* @param string $headers (default: "Content-Type: text/html\r\n")
|
|
* @param string $attachments (default: "")
|
|
*/
|
|
function wc_mail( $to, $subject, $message, $headers = "Content-Type: text/html\r\n", $attachments = "" ) {
|
|
global $woocommerce;
|
|
|
|
$mailer = WC()->mailer();
|
|
|
|
$mailer->send( $to, $subject, $message, $headers, $attachments );
|
|
}
|
|
|
|
/**
|
|
* Get an image size.
|
|
*
|
|
* Variable is filtered by woocommerce_get_image_size_{image_size}
|
|
*
|
|
* @param string $image_size
|
|
* @return array
|
|
*/
|
|
function wc_get_image_size( $image_size ) {
|
|
if ( in_array( $image_size, array( 'shop_thumbnail', 'shop_catalog', 'shop_single' ) ) ) {
|
|
$size = get_option( $image_size . '_image_size', array() );
|
|
$size['width'] = isset( $size['width'] ) ? $size['width'] : '300';
|
|
$size['height'] = isset( $size['height'] ) ? $size['height'] : '300';
|
|
$size['crop'] = isset( $size['crop'] ) ? $size['crop'] : 1;
|
|
} else {
|
|
$size = array(
|
|
'width' => '300',
|
|
'height' => '300',
|
|
'crop' => 1
|
|
);
|
|
}
|
|
|
|
return apply_filters( 'woocommerce_get_image_size_' . $image_size, $size );
|
|
}
|
|
|
|
/**
|
|
* Queue some JavaScript code to be output in the footer.
|
|
*
|
|
* @param string $code
|
|
*/
|
|
function wc_enqueue_js( $code ) {
|
|
global $wc_queued_js;
|
|
|
|
if ( empty( $wc_queued_js ) ) {
|
|
$wc_queued_js = '';
|
|
}
|
|
|
|
$wc_queued_js .= "\n" . $code . "\n";
|
|
}
|
|
|
|
/**
|
|
* Output any queued javascript code in the footer.
|
|
*/
|
|
function wc_print_js() {
|
|
global $wc_queued_js;
|
|
|
|
if ( ! empty( $wc_queued_js ) ) {
|
|
|
|
echo "<!-- WooCommerce JavaScript -->\n<script type=\"text/javascript\">\njQuery(function($) {";
|
|
|
|
// Sanitize
|
|
$wc_queued_js = wp_check_invalid_utf8( $wc_queued_js );
|
|
$wc_queued_js = preg_replace( '/&#(x)?0*(?(1)27|39);?/i', "'", $wc_queued_js );
|
|
$wc_queued_js = str_replace( "\r", '', $wc_queued_js );
|
|
|
|
echo $wc_queued_js . "});\n</script>\n";
|
|
|
|
unset( $wc_queued_js );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set a cookie - wrapper for setcookie using WP constants
|
|
*
|
|
* @param string $name Name of the cookie being set
|
|
* @param string $value Value of the cookie
|
|
* @param integer $expire Expiry of the cookie
|
|
* @param string $secure Whether the cookie should be served only over https
|
|
*/
|
|
function wc_setcookie( $name, $value, $expire = 0, $secure = false ) {
|
|
if ( ! headers_sent() ) {
|
|
setcookie( $name, $value, $expire, COOKIEPATH, COOKIE_DOMAIN, $secure );
|
|
} elseif ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
|
|
trigger_error( "Cookie cannot be set - headers already sent", E_USER_NOTICE );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the URL to the WooCommerce REST API
|
|
*
|
|
* @since 2.1
|
|
* @param string $path an endpoint to include in the URL
|
|
* @return string the URL
|
|
*/
|
|
function get_woocommerce_api_url( $path ) {
|
|
|
|
$url = get_home_url( null, 'wc-api/v' . WC_API::VERSION . '/', is_ssl() ? 'https' : 'http' );
|
|
|
|
if ( ! empty( $path ) && is_string( $path ) ) {
|
|
$url .= ltrim( $path, '/' );
|
|
}
|
|
|
|
return $url;
|
|
}
|